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