xref: /csrg-svn/share/man/man4/man4.vax/ix.4 (revision 61599)
1*61599Sbostic.\" Copyright (c) 1986, 1991, 1993
2*61599Sbostic.\"	The Regents of the University of California.  All rights reserved.
326209Ssklower.\"
443582Strent.\" %sccs.include.redist.man%
526209Ssklower.\"
6*61599Sbostic.\"     @(#)ix.4	8.1 (Berkeley) 06/05/93
736756Sbostic.\"
847674Scael.Dd
947674Scael.Dt IX 4 vax
1047674Scael.Os BSD 4.2
1147674Scael.Sh NAME
1247674Scael.Nm ix
1347674Scael.Nd Interlan Np100 10 Mb/s Ethernet interface
1447674Scael.Sh SYNOPSIS
1547674Scael.Cd "device np0 at uba0 csr 166000 vector npintr"
1647674Scael.Sh DESCRIPTION
1726209SsklowerThe
1847674Scael.Nm ix
1926209Ssklowerinterface provides access to a 10 Mb/s Ethernet network through
2028251Skarelsan Interlan Np100 controller used as a link-layer interface.
2147674Scael.Pp
2226209SsklowerThis interface is unusual in that it requires loading firmware
2326209Ssklowerinto the controller before it may be used as a network interface.
2426209SsklowerThis is accomplished by opening a character special device,
2526209Ssklowerand writing data to it.
2647674ScaelA program to load the image is provided in
2747674Scael.Pa /usr/src/new/np100 .
2826209SsklowerThe sequence of commands would be:
2947674Scael.Bd -literal -offset indent
3047674Scael# ./npload np.image [/dev/np<board #> if other than np00]
3147674Scael# sleep 10
3247674Scael# ifconfig ix0 ...
3347674Scael.Ed
3447674Scael.Pp
3528251SkarelsEach of the host's network addresses
3647674Scaelis specified at boot time with an
3747674Scael.Dv SIOCSIFADDR
3847674Scael.Xr ioctl 2 .
3947674ScaelThe
4047674Scael.Nm ix
4126209Ssklowerinterface employs the address resolution protocol described in
4247674Scael.Xr arp 4
4326209Ssklowerto dynamically map between Internet and Ethernet addresses on the local
4426209Ssklowernetwork.
4547674Scael.Pp
4647674ScaelThe interface normally tries to use a
4747674Scael.Dq trailer
4847674Scaelencapsulation
4928251Skarelsto minimize copying data on input and output.
5047674ScaelThe use of trailers is negotiated with
5147674Scael.Tn ARP .
5228251SkarelsThis negotiation may be disabled, on a per-interface basis,
5347674Scaelby setting the
5447674Scael.Dv IFF_NOTRAILERS
5547674Scaelflag with an
5647674Scael.Dv SIOCSIFFLAGS
5747674Scael.Xr ioctl .
5847674Scael.Sh DIAGNOSTICS
5947674Scael.Bl -diag
6047674Scael.It "ix%d: Req failed, cmd %x, stat %x, ust error %x,%x."
6126209SsklowerThe firmware in the controller refused to honor a request from
6247674Scael.Tn UNIX
6326209Ssklowerin initializing packet level communications.
6426209SsklowerThe board may need to be reset and reloaded.
6526209SsklowerOr, you may not have allowed enough time between loading the board
6626209Ssklowerand issuing the request to begin unix network operation.
6747674Scael.Pp
6847674Scael.It ix%d: can't initialize.
6926209SsklowerThe interface was unable to obtain unibus resources required for operation.
7047674Scael.Pp
7147674Scael.It ix%d: failed to reinitialize DLA module.
7226209SsklowerThe interface got sick after attempting to reprogram its physical
7326209Ssklowerethernet address.  Try reloading the firmware.
7426209SsklowerThe attempt is made only when this interfaces is not the first
7547674Scaelone configured for
7647674Scael.Tn XNS .
7747674Scael.Pp
7847674Scael.It ix%d: can't handle af%d.
7947674ScaelThe interface was handed
8026209Ssklowera message with addresses formatted in an unsuitable address
8126209Ssklowerfamily; the packet was dropped.
8247674Scael.Pp
8347674Scael.It ix%d: stray xmit interrupt, npreq=%x.
8426209SsklowerThis may happen if the board is reloaded while network processes are still
8526209Ssklowerrunning.
8647674Scael.Pp
8747674Scael.It ixrint: cqe error %x, %x, %x.
8826209SsklowerThis will result if an
8947674Scael.Xr ifconfig 8
9026209Ssklowerrequest is made at an inopportune time, such as not allowing
9126209Ssklowerenough time after loading the firmware.
9226209SsklowerAfter 100 such errors are logged, the unix network driver will
9326209Ssklowershut itself down, saying:
9447674Scael.Pp
9547674Scael.It ixrint: shutting down unix dla.
9626209SsklowerThe recourse is to reload the firmware and allow more time.
9747674Scael.El
9847674Scael.Sh SEE ALSO
9947674Scael.Xr netintro 4 ,
10047674Scael.Xr inet 4 ,
10147674Scael.Xr arp 4 ,
10247674Scael.Xr np 4 .
10347674Scael.Sh HISTORY
10447674ScaelThe
10547674Scael.Nm
10647674Scaeldriver appeared in
10747674Scael.Bx 4.3 .
108