1*47674Scael.\" Copyright (c) 1986, 1991 The Regents of the University of California. 236756Sbostic.\" All rights reserved. 326209Ssklower.\" 443582Strent.\" %sccs.include.redist.man% 526209Ssklower.\" 6*47674Scael.\" @(#)ix.4 6.5 (Berkeley) 03/27/91 736756Sbostic.\" 8*47674Scael.Dd 9*47674Scael.Dt IX 4 vax 10*47674Scael.Os BSD 4.2 11*47674Scael.Sh NAME 12*47674Scael.Nm ix 13*47674Scael.Nd Interlan Np100 10 Mb/s Ethernet interface 14*47674Scael.Sh SYNOPSIS 15*47674Scael.Cd "device np0 at uba0 csr 166000 vector npintr" 16*47674Scael.Sh DESCRIPTION 1726209SsklowerThe 18*47674Scael.Nm ix 1926209Ssklowerinterface provides access to a 10 Mb/s Ethernet network through 2028251Skarelsan Interlan Np100 controller used as a link-layer interface. 21*47674Scael.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. 26*47674ScaelA program to load the image is provided in 27*47674Scael.Pa /usr/src/new/np100 . 2826209SsklowerThe sequence of commands would be: 29*47674Scael.Bd -literal -offset indent 30*47674Scael# ./npload np.image [/dev/np<board #> if other than np00] 31*47674Scael# sleep 10 32*47674Scael# ifconfig ix0 ... 33*47674Scael.Ed 34*47674Scael.Pp 3528251SkarelsEach of the host's network addresses 36*47674Scaelis specified at boot time with an 37*47674Scael.Dv SIOCSIFADDR 38*47674Scael.Xr ioctl 2 . 39*47674ScaelThe 40*47674Scael.Nm ix 4126209Ssklowerinterface employs the address resolution protocol described in 42*47674Scael.Xr arp 4 4326209Ssklowerto dynamically map between Internet and Ethernet addresses on the local 4426209Ssklowernetwork. 45*47674Scael.Pp 46*47674ScaelThe interface normally tries to use a 47*47674Scael.Dq trailer 48*47674Scaelencapsulation 4928251Skarelsto minimize copying data on input and output. 50*47674ScaelThe use of trailers is negotiated with 51*47674Scael.Tn ARP . 5228251SkarelsThis negotiation may be disabled, on a per-interface basis, 53*47674Scaelby setting the 54*47674Scael.Dv IFF_NOTRAILERS 55*47674Scaelflag with an 56*47674Scael.Dv SIOCSIFFLAGS 57*47674Scael.Xr ioctl . 58*47674Scael.Sh DIAGNOSTICS 59*47674Scael.Bl -diag 60*47674Scael.It "ix%d: Req failed, cmd %x, stat %x, ust error %x,%x." 6126209SsklowerThe firmware in the controller refused to honor a request from 62*47674Scael.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. 67*47674Scael.Pp 68*47674Scael.It ix%d: can't initialize. 6926209SsklowerThe interface was unable to obtain unibus resources required for operation. 70*47674Scael.Pp 71*47674Scael.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 75*47674Scaelone configured for 76*47674Scael.Tn XNS . 77*47674Scael.Pp 78*47674Scael.It ix%d: can't handle af%d. 79*47674ScaelThe interface was handed 8026209Ssklowera message with addresses formatted in an unsuitable address 8126209Ssklowerfamily; the packet was dropped. 82*47674Scael.Pp 83*47674Scael.It ix%d: stray xmit interrupt, npreq=%x. 8426209SsklowerThis may happen if the board is reloaded while network processes are still 8526209Ssklowerrunning. 86*47674Scael.Pp 87*47674Scael.It ixrint: cqe error %x, %x, %x. 8826209SsklowerThis will result if an 89*47674Scael.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: 94*47674Scael.Pp 95*47674Scael.It ixrint: shutting down unix dla. 9626209SsklowerThe recourse is to reload the firmware and allow more time. 97*47674Scael.El 98*47674Scael.Sh SEE ALSO 99*47674Scael.Xr netintro 4 , 100*47674Scael.Xr inet 4 , 101*47674Scael.Xr arp 4 , 102*47674Scael.Xr np 4 . 103*47674Scael.Sh HISTORY 104*47674ScaelThe 105*47674Scael.Nm 106*47674Scaeldriver appeared in 107*47674Scael.Bx 4.3 . 108