Return to ix.4 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / man / man4 / man4.vax

Annotation of 43BSDReno/share/man/man4/man4.vax/ix.4, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1986 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"    @(#)ix.4        6.4 (Berkeley) 6/23/90
                     19: .\"
                     20: .TH IX 4 "June 23, 1990"
                     21: .UC 5
                     22: .SH NAME
                     23: ix \- Interlan Np100 10 Mb/s Ethernet interface
                     24: .SH SYNOPSIS
                     25: .B "device np0 at uba0 csr 166000 vector npintr"
                     26: .SH DESCRIPTION
                     27: The
                     28: .I ix
                     29: interface provides access to a 10 Mb/s Ethernet network through
                     30: an Interlan Np100 controller used as a link-layer interface.
                     31: .PP
                     32: This interface is unusual in that it requires loading firmware
                     33: into the controller before it may be used as a network interface.
                     34: This is accomplished by opening a character special device,
                     35: and writing data to it.
                     36: A program to load the image is provided in /usr/src/new/np100.
                     37: The sequence of commands would be:
                     38: .nf
                     39: 
                     40:        # ./npload np.image [/dev/np<board #> if other than np00]
                     41:        # sleep 10
                     42:        # ifconfig ix0 ...
                     43: .fi
                     44: .PP
                     45: Each of the host's network addresses
                     46: is specified at boot time with an SIOCSIFADDR
                     47: ioctl.  The
                     48: .I ix
                     49: interface employs the address resolution protocol described in
                     50: .IR arp (4)
                     51: to dynamically map between Internet and Ethernet addresses on the local
                     52: network.
                     53: .PP
                     54: The interface normally tries to use a ``trailer'' encapsulation
                     55: to minimize copying data on input and output.
                     56: The use of trailers is negotiated with ARP.
                     57: This negotiation may be disabled, on a per-interface basis,
                     58: by setting the IFF_NOTRAILERS
                     59: flag with an SIOCSIFFLAGS ioctl.
                     60: .SH DIAGNOSTICS
                     61: \fBix%d: Req failed, cmd %x, stat %x, ust error %x,%x\fP.
                     62: The firmware in the controller refused to honor a request from
                     63: .UX
                     64: in initializing packet level communications.
                     65: The board may need to be reset and reloaded.
                     66: Or, you may not have allowed enough time between loading the board
                     67: and issuing the request to begin unix network operation.
                     68: .PP
                     69: \fBix%d: can't initialize\fP.
                     70: The interface was unable to obtain unibus resources required for operation.
                     71: .PP
                     72: \fBix%d: failed to reinitialize DLA module\fP.
                     73: The interface got sick after attempting to reprogram its physical
                     74: ethernet address.  Try reloading the firmware.
                     75: The attempt is made only when this interfaces is not the first
                     76: one configured for XNS.
                     77: .PP
                     78: \fBix%d: can't handle af%d\fP.  The interface was handed
                     79: a message with addresses formatted in an unsuitable address
                     80: family; the packet was dropped.
                     81: .PP
                     82: \fBix%d: stray xmit interrupt, npreq=%x\fP.
                     83: This may happen if the board is reloaded while network processes are still
                     84: running.
                     85: .PP
                     86: \fBixrint: cqe error %x, %x, %x\fP.
                     87: This will result if an 
                     88: .IR ifconfig (8c)
                     89: request is made at an inopportune time, such as not allowing
                     90: enough time after loading the firmware.
                     91: After 100 such errors are logged, the unix network driver will
                     92: shut itself down, saying:
                     93: .PP
                     94: \fBixrint: shutting down unix dla\fP.
                     95: The recourse is to reload the firmware and allow more time.
                     96: .SH SEE ALSO
                     97: netintro(4), inet(4), arp(4), np(4).

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.