1.\" Copyright (c) 1986, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)ix.4 8.1 (Berkeley) 06/05/93 7.\" 8.Dd 9.Dt IX 4 vax 10.Os BSD 4.2 11.Sh NAME 12.Nm ix 13.Nd Interlan Np100 10 Mb/s Ethernet interface 14.Sh SYNOPSIS 15.Cd "device np0 at uba0 csr 166000 vector npintr" 16.Sh DESCRIPTION 17The 18.Nm ix 19interface provides access to a 10 Mb/s Ethernet network through 20an Interlan Np100 controller used as a link-layer interface. 21.Pp 22This interface is unusual in that it requires loading firmware 23into the controller before it may be used as a network interface. 24This is accomplished by opening a character special device, 25and writing data to it. 26A program to load the image is provided in 27.Pa /usr/src/new/np100 . 28The sequence of commands would be: 29.Bd -literal -offset indent 30# ./npload np.image [/dev/np<board #> if other than np00] 31# sleep 10 32# ifconfig ix0 ... 33.Ed 34.Pp 35Each of the host's network addresses 36is specified at boot time with an 37.Dv SIOCSIFADDR 38.Xr ioctl 2 . 39The 40.Nm ix 41interface employs the address resolution protocol described in 42.Xr arp 4 43to dynamically map between Internet and Ethernet addresses on the local 44network. 45.Pp 46The interface normally tries to use a 47.Dq trailer 48encapsulation 49to minimize copying data on input and output. 50The use of trailers is negotiated with 51.Tn ARP . 52This negotiation may be disabled, on a per-interface basis, 53by setting the 54.Dv IFF_NOTRAILERS 55flag with an 56.Dv SIOCSIFFLAGS 57.Xr ioctl . 58.Sh DIAGNOSTICS 59.Bl -diag 60.It "ix%d: Req failed, cmd %x, stat %x, ust error %x,%x." 61The firmware in the controller refused to honor a request from 62.Tn UNIX 63in initializing packet level communications. 64The board may need to be reset and reloaded. 65Or, you may not have allowed enough time between loading the board 66and issuing the request to begin unix network operation. 67.Pp 68.It ix%d: can't initialize. 69The interface was unable to obtain unibus resources required for operation. 70.Pp 71.It ix%d: failed to reinitialize DLA module. 72The interface got sick after attempting to reprogram its physical 73ethernet address. Try reloading the firmware. 74The attempt is made only when this interfaces is not the first 75one configured for 76.Tn XNS . 77.Pp 78.It ix%d: can't handle af%d. 79The interface was handed 80a message with addresses formatted in an unsuitable address 81family; the packet was dropped. 82.Pp 83.It ix%d: stray xmit interrupt, npreq=%x. 84This may happen if the board is reloaded while network processes are still 85running. 86.Pp 87.It ixrint: cqe error %x, %x, %x. 88This will result if an 89.Xr ifconfig 8 90request is made at an inopportune time, such as not allowing 91enough time after loading the firmware. 92After 100 such errors are logged, the unix network driver will 93shut itself down, saying: 94.Pp 95.It ixrint: shutting down unix dla. 96The recourse is to reload the firmware and allow more time. 97.El 98.Sh SEE ALSO 99.Xr netintro 4 , 100.Xr inet 4 , 101.Xr arp 4 , 102.Xr np 4 . 103.Sh HISTORY 104The 105.Nm 106driver appeared in 107.Bx 4.3 . 108