| blob | 007b2bdb97a7b3254b2430859881b18d2c449a23 |
1 .\" $NetBSD: ex.4,v 1.11 2003/04/06 19:33:58 wiz Exp $
2 .\"
3 .\" Copyright (c) 1986, 1991, 1993
4 .\" The Regents of the University of California. All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the University nor the names of its contributors
15 .\" may be used to endorse or promote products derived from this software
16 .\" without specific prior written permission.
17 .\"
18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" SUCH DAMAGE.
29 .\"
30 .\" from: @(#)ex.4 8.1 (Berkeley) 6/5/93
31 .\"
32 .Dd June 5, 1993
33 .Dt EX 4 vax
34 .Os
35 .Sh NAME
36 .Nm ex
37 .Nd Excelan 10 Mb/s Ethernet interface
38 .Sh SYNOPSIS
39 .Cd "ex0 at uba0 csr 164000 vector excdint"
40 .Sh DESCRIPTION
41 NOTE: This driver has not been ported from
42 .Bx 4.4
43 yet.
44 .Pp
45 The
46 .Nm ex
47 interface provides access to a 10 Mb/s Ethernet network through
48 an Excelan controller used as a link-layer interface.
49 .Pp
50 Each of the host's network addresses
51 is specified at boot time with an
52 .Dv SIOCSIFADDR
53 .Xr ioctl 2 .
54 The
55 .Nm ex
56 interface employs the address resolution protocol described in
57 .Xr arp 4
58 to dynamically map between Internet and Ethernet addresses on the local
59 network.
60 .Pp
61 The interface normally tries to use a
62 .Dq trailer
63 encapsulation
64 to minimize copying data on input and output.
65 The use of trailers is negotiated with
66 .Tn ARP .
67 This negotiation may be disabled, on a per-interface basis,
68 by setting the
69 .Dv IFF_NOTRAILERS
70 flag with an
71 .Dv SIOCSIFFLAGS
72 .Xr ioctl 2 .
73 .Sh DIAGNOSTICS
74 .Bl -diag
75 .It "ex%d: HW %c.%c, NX %c.%c, hardware address %s."
76 This provides firmware revisions levels, and is expected during
77 autoconfiguration.
78 .Pp
79 .It ex%d: can't initialize.
80 There was a failure in allocating UNIBUS resources for the device.
81 .Pp
82 .It "ex%d: configuration failed; cc = %x."
83 The hardware indicated an error when trying to initialize itself.
84 The error code returned is described at length in the device
85 Reference Manual.
86 .Pp
87 .It ex%d: receive error %b.
88 The hardware indicated an error
89 in reading a packet from the cable.
90 Specific Error bits are provided
91 .Pp
92 .It ex%d: transmit error %b.
93 The hardware indicated an error
94 in transmitting a packet to the cable or an illegally sized packet.
95 Specific Error bits are provided
96 .Pp
97 .It ex%d: can't handle af%d.
98 The interface was handed
99 a message with addresses formatted in an unsuitable address
100 family; the packet was dropped.
101 .El
102 .Sh SEE ALSO
103 .Xr arp 4 ,
104 .Xr inet 4 ,
105 .Xr netintro 4
106 .Sh HISTORY
107 The
108 .Nm
109 driver appeared in
110 .Bx 4.3 .