BSD 4_3_Net_2 release

[unix-history] / usr / src / share / man / man4 / man4.vax / np.4

diff --git a/usr/src/share/man/man4/man4.vax/np.4 b/usr/src/share/man/man4/man4.vax/np.4
index ce51a41..abba78a 100644 (file)
--- a/usr/src/share/man/man4/man4.vax/np.4
+++ b/usr/src/share/man/man4/man4.vax/np.4
@@ -1,108 +1,135 @@
-.\" Copyright (c) 1986 The Regents of the University of California.
+.\" Copyright (c) 1986, 1991 The Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" All rights reserved.
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"    @(#)np.4        6.5 (Berkeley) 6/23/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.TH NP 4 "June 23, 1990"
-.UC 5
-.SH NAME
-np \- Interlan Np100 10 Mb/s Ethernet interface
-.SH SYNOPSIS
-.B "device np0 at uba0 csr 166000 vector npintr"
-.SH DESCRIPTION
+.\"     @(#)np.4       6.6 (Berkeley) 3/27/91
+.\"
+.Dd March 27, 1991
+.Dt NP 4 vax
+.Os BSD 4.2
+.Sh NAME
+.Nm np
+.Nd Interlan Np100 10 Mb/s Ethernet interface
+.Sh SYNOPSIS
+.Cd "device np0 at uba0 csr 166000 vector npintr"
+.Sh DESCRIPTION

 The
 The

-.I NP
+.Nm np

 device provides access to an Interlan Np100 Ethernet interface
 for control functions.
 device provides access to an Interlan Np100 Ethernet interface
 for control functions.

-.PP
+.Pp

 This interface is unusual in that it requires loading firmware
 into the controller before it may be used as a network link-level interface.
 This is accomplished by opening a character special device,
 and writing data to it.
 It is also possible to do post-mortem debugging of firmware failures
 by reading the local memory of the device.
 This interface is unusual in that it requires loading firmware
 into the controller before it may be used as a network link-level interface.
 This is accomplished by opening a character special device,
 and writing data to it.
 It is also possible to do post-mortem debugging of firmware failures
 by reading the local memory of the device.

-.PP
-A program to load the image is provided in /usr/src/new/np100.
-The sequence of commands would be:
-.nf
-
-       # ./npload np.image [/dev/np00]
-       # sleep 10
-       # ifconfig ix0 ...
-.fi
-.PP
+.\" .Pp
+.\" A program to load the image is provided in
+.\" .Pa /usr/src/new/np100 .
+.\" The sequence of commands would be:
+.\" .Bd -literal -offset indent
+.\" # ./npload np.image [/dev/np00]
+.\" # sleep 10
+.\" # ifconfig ix0 ...
+.\" .Ed
+.Pp

 Multiple control processes are allowed by opening separate
 minor devices; secondary interfaces are specified by shifting
 the interface number by 4 bits.
 Multiple control processes are allowed by opening separate
 minor devices; secondary interfaces are specified by shifting
 the interface number by 4 bits.

-.PP
+.Pp

 The device also responds to commands passed through the driver
 The device also responds to commands passed through the driver

-by the following ioctls:
-.TP
-NPRESET
-.br
+by the following
+.Xr ioctl 2 Ns s :
+.Bl -tag -width NPNETBOOT
+.It Dv NPRESET

 kills off all active network processes.
 kills off all active network processes.

-.TP
-NPSTART
-.br
-begins execution of the board at the specified address (usually 0x400).
-.TP
-NPNETBOOT
-.br
+.It Dv NPSTART
+begins execution of the board at the specified address (usually
+.Li 0x400 ) .
+.It Dv NPNETBOOT

 downloads the image from a server on the network.
 downloads the image from a server on the network.

-[Contact MICOM-INTERLAN for details.]
-.SH DIAGNOSTICS
-\fBnp%d: Bad Maintenance command: %x!\fP.
-An invalid ioctl was passed to the np driver.
-.PP
-\fBnp%d: Panic NP100 bad buffer chain\fP.
+[Contact
+.Tn MICOM-INTERLAN
+for details.]
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It np%d: Bad Maintenance command: %x!
+An invalid
+.Xr ioctl
+was passed to the np driver.
+.Pp
+.It np%d: Panic NP100 bad buffer chain.

 An error occurred in an read or write operation causing it to
 run out of buffers before it finished the operation.
 This indicates a kernel failure rather than a device failure.
 An error occurred in an read or write operation causing it to
 run out of buffers before it finished the operation.
 This indicates a kernel failure rather than a device failure.

-.PP
-\fBNP100 unit %d not found!\fP.
+.Pp
+.It NP100 unit %d not found!

 A failure occurred during initialization, such that the unibus
 address expected for the board was found to be bad.
 Probably indicates hardware problems with the board, as do the following:
 A failure occurred during initialization, such that the unibus
 address expected for the board was found to be bad.
 Probably indicates hardware problems with the board, as do the following:

-\fB
-.nf
-
-NP100 Unit %d timed out!
-
-NP100 Unit %d Failed diagnostics!
-Status from CSR0: %x.\fP
-.fi
-.PP
-\fBPanic from NP100 unit %d!\\nPanic Message: %s\fP.
+.Pp
+.Bd -filled -offset indent -compact
+.It NP100 Unit %d timed out!
+.It NP100 Unit %d Failed diagnostics!
+.It Status from CSR0: %x.
+.Ed
+.Pp
+.It "Panic from NP100 unit %d!"
+.It "Panic Message: %s."

 An occurrence on the board was deemed serious enough
 to have the vax print it out.  
 An occurrence on the board was deemed serious enough
 to have the vax print it out.  

-.PP
-\fBNP100 unit #%d available!\fP.
+.Pp
+.It NP100 unit #%d available!

 The board was successfully loaded and started.
 The board was successfully loaded and started.

-.PP
-\fBnp%d: Bad Req: %x.\fP.
+.Pp
+.It np%d: Bad Req: %x.

 The board made a maintenance request to the vax that it did not
 understand.
 The board made a maintenance request to the vax that it did not
 understand.

-.PP
-\fBnp%d: No more room on Command Queue!\fP.
+.Pp
+.It np%d: No more room on Command Queue!

 The np driver allowed an internal resource to be exhausted.
 This should never happen.
 The np driver allowed an internal resource to be exhausted.
 This should never happen.

-.PP
+.El
+.Pp

 There are 110 other diagnostic messages that can be enabled
 by setting bits in a debugging mask.
 Consult the driver for details.
 There are 110 other diagnostic messages that can be enabled
 by setting bits in a debugging mask.
 Consult the driver for details.

-.SH SEE ALSO
-netintro(4), inet(4), arp(4), ix(4)
+.Sh SEE ALSO
+.Xr netintro 4 ,
+.Xr inet 4 ,
+.Xr arp 4 ,
+.Xr ix 4
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Bx 4.3 .