BSD 4_3_Net_2 release

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

diff --git a/usr/src/share/man/man4/man4.vax/pcl.4 b/usr/src/share/man/man4/man4.vax/pcl.4
index 5879116..20e4805 100644 (file)
--- a/usr/src/share/man/man4/man4.vax/pcl.4
+++ b/usr/src/share/man/man4/man4.vax/pcl.4
@@ -1,68 +1,132 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)pcl.4       6.2 (Berkeley) 5/21/86
+.\" 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.

 .\"
 .\"

-.TH PCL 4 "May 21, 1986"
-.UC 5
-.SH NAME
-pcl \- DEC CSS PCL-11 B Network Interface
-.SH SYNOPSIS
-.B "device pcl0 at uba? csr 164200 vector pclxint pclrint"
-.SH DESCRIPTION
+.\" 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.
+.\"
+.\"     @(#)pcl.4      6.3 (Berkeley) 3/27/91
+.\"
+.Dd March 27, 1991
+.Dt PCL 4 vax
+.Os BSD 4.2
+.Sh NAME
+.Nm pcl
+.Nd
+.Tn DEC CSS
+.Tn PCL-11 B
+Network Interface
+.Sh SYNOPSIS
+.Cd "device pcl0 at uba? csr 164200 vector pclxint pclrint"
+.Sh DESCRIPTION

 The 
 The 

-.I pcl
-device provides an IP-only interface to the DEC CSS PCL-11
+.Nm pcl
+device provides an
+.Tn IP Ns -only
+interface to the
+.Tn DEC CSS
+.Tn PCL-11

 time division multiplexed network bus.
 The controller itself is not accessible to users.
 time division multiplexed network bus.
 The controller itself is not accessible to users.

-.PP
-The hosts's address is specified with the SIOCSIFADDR ioctl.
+.Pp
+The hosts's address is specified with the
+.Dv SIOCSIFADDR
+.Xr ioctl 2 .

 The interface will not transmit or receive any data before
 its address is defined.
 The interface will not transmit or receive any data before
 its address is defined.

-.PP
-As the PCL-11 hardware is only capable of having 15 interfaces per network,
+.Pp
+As the
+.Tn PCL-11
+hardware is only capable of having 15 interfaces per network,

 a single-byte host-on-network number is used, with range [1..15] to match
 a single-byte host-on-network number is used, with range [1..15] to match

-the TDM bus addresses of the interfaces.
-.PP
+the
+.Tn TDM
+bus addresses of the interfaces.
+.Pp

 The interface currently only supports the Internet protocol family
 The interface currently only supports the Internet protocol family

-and only provides ``natural'' (header) encapsulation.
-.SH DIAGNOSTICS
-.BR "pcl%d: can't init" .
-Insufficient UNIBUS resources existed to initialize the device.
+and only provides
+.Dq natural
+(header) encapsulation.
+.Sh DIAGNOSTICS
+.Bl -diag
+.It pcl%d: can't init.
+Insufficient
+.Tn UNIBUS
+resources existed to initialize the device.

 This is likely to occur when the device is run on a buffered
 data path on an 11/750 and other network interfaces are also
 configured to use buffered data paths, or when it is configured
 to use buffered data paths on an 11/730 (which has none).
 This is likely to occur when the device is run on a buffered
 data path on an 11/750 and other network interfaces are also
 configured to use buffered data paths, or when it is configured
 to use buffered data paths on an 11/730 (which has none).

-.PP
-.BR "pcl%d: can't handle af%d" .
+.Pp
+.It pcl%d: can't handle af%d.

 The interface was handed a message with addresses formatted in an
 unsuitable address family;  the packet was dropped.
 The interface was handed a message with addresses formatted in an
 unsuitable address family;  the packet was dropped.

-.PP
-.BR "pcl%d: stray xmit interrupt" .
+.Pp
+.It pcl%d: stray xmit interrupt.

 An interrupt occurred when no output had previously been started.
 An interrupt occurred when no output had previously been started.

-.PP
-.BR "pcl%d: master" .
-The TDM bus had no station providing ``bus master'' timing signals,
+.Pp
+.It pcl%d: master.
+The
+.Tn TDM
+bus had no station providing ``bus master'' timing signals,

 so this interface has assumed the ``master'' role.  This message should
 so this interface has assumed the ``master'' role.  This message should

-only appear at most once per UNIBUS INIT on a single system.
+only appear at most once per
+.Tn UNIBUS INIT
+on a single system.

 Unless there is a hardware failure, only one station may be master at at time.
 Unless there is a hardware failure, only one station may be master at at time.

-.PP
-.BR "pcl%d: send error, tcr=%b, tsr=%b" .
+.Pp
+.It pcl%d: send error, tcr=%b, tsr=%b.

 The device indicated a problem sending data on output.
 If a ``receiver offline'' error is detected, it is not normally logged
 The device indicated a problem sending data on output.
 If a ``receiver offline'' error is detected, it is not normally logged

-unless the option PCL_TESTING has been selected, as this causes a lot
+unless the option
+.Dv PCL_TESTING
+has been selected, as this causes a lot

 of console chatter when sending to a down machine.  However, this option
 of console chatter when sending to a down machine.  However, this option

-is quite useful when debugging problems with the PCL interfaces.
-.PP
-.BR "pcl%d: rcv error, rcr=%b rsr=%b" .
+is quite useful when debugging problems with the
+.Tn PCL
+interfaces.
+.Pp
+.It pcl%d: rcv error, rcr=%b rsr=%b.

 The device indicated a problem receiving data on input.
 The device indicated a problem receiving data on input.

-.PP
-.BR "pcl%d: bad len=%d" .
+.Pp
+.It pcl%d: bad len=%d.

 An input operation resulted in a data transfer of less than
 0 or more than 1008 bytes of
 data into memory (according to the word count register).
 An input operation resulted in a data transfer of less than
 0 or more than 1008 bytes of
 data into memory (according to the word count register).

-This should never happen as the maximum size of a PCL message
+This should never happen as the maximum size of a
+.Tn PCL
+message

 has been agreed upon to be 1008 bytes (same as ArpaNet message).
 has been agreed upon to be 1008 bytes (same as ArpaNet message).

-.SH "SEE ALSO"
-intro(4N), inet(4F)
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr inet 4
+.Sh HISTORY
+The
+.Nm
+interface appeared in
+.Bx 4.2 .