1.\" $NetBSD: pcl.4,v 1.12 2004/10/04 19:08:19 rumble Exp $ 2.\" 3.\" Copyright (c) 1983, 1991, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. Neither the name of the University nor the names of its contributors 15.\" may be used to endorse or promote products derived from this software 16.\" without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.\" from: @(#)pcl.4 8.1 (Berkeley) 6/5/93 31.\" 32.Dd June 5, 1993 33.Dt PCL 4 vax 34.Os 35.Sh NAME 36.Nm pcl 37.Nd 38.Tn DEC CSS 39.Tn PCL-11 B 40Network Interface 41.Sh SYNOPSIS 42.Cd "pcl0 at uba? csr 164200 vector pclxint pclrint" 43.Sh DESCRIPTION 44NOTE: This driver has not been ported from 45.Bx 4.4 46yet. 47.Pp 48The 49.Nm pcl 50device provides an 51.Tn IP Ns -only 52interface to the 53.Tn DEC CSS 54.Tn PCL-11 55time division multiplexed network bus. 56The controller itself is not accessible to users. 57.Pp 58The host's address is specified with the 59.Dv SIOCSIFADDR 60.Xr ioctl 2 . 61The interface will not transmit or receive any data before 62its address is defined. 63.Pp 64As the 65.Tn PCL-11 66hardware is only capable of having 15 interfaces per network, 67a single-byte host-on-network number is used, with range [1..15] to match 68the 69.Tn TDM 70bus addresses of the interfaces. 71.Pp 72The interface currently only supports the Internet protocol family 73and only provides 74.Dq natural 75(header) encapsulation. 76.Sh DIAGNOSTICS 77.Bl -diag 78.It pcl%d: can't init. 79Insufficient 80.Tn UNIBUS 81resources existed to initialize the device. 82This is likely to occur when the device is run on a buffered 83data path on an 11/750 and other network interfaces are also 84configured to use buffered data paths, or when it is configured 85to use buffered data paths on an 11/730 (which has none). 86.Pp 87.It pcl%d: can't handle af%d. 88The interface was handed a message with addresses formatted in an 89unsuitable address family; the packet was dropped. 90.Pp 91.It pcl%d: stray xmit interrupt. 92An interrupt occurred when no output had previously been started. 93.Pp 94.It pcl%d: master. 95The 96.Tn TDM 97bus had no station providing ``bus master'' timing signals, 98so this interface has assumed the ``master'' role. This message should 99only appear at most once per 100.Tn UNIBUS INIT 101on a single system. 102Unless there is a hardware failure, only one station may be master at a time. 103.Pp 104.It pcl%d: send error, tcr=%b, tsr=%b. 105The device indicated a problem sending data on output. 106If a ``receiver offline'' error is detected, it is not normally logged 107unless the option 108.Dv PCL_TESTING 109has been selected, as this causes a lot 110of console chatter when sending to a down machine. However, this option 111is quite useful when debugging problems with the 112.Tn PCL 113interfaces. 114.Pp 115.It pcl%d: rcv error, rcr=%b rsr=%b. 116The device indicated a problem receiving data on input. 117.Pp 118.It pcl%d: bad len=%d. 119An input operation resulted in a data transfer of less than 1200 or more than 1008 bytes of 121data into memory (according to the word count register). 122This should never happen as the maximum size of a 123.Tn PCL 124message 125has been agreed upon to be 1008 bytes (same as ARPANET message). 126.El 127.Sh SEE ALSO 128.Xr inet 4 , 129.Xr intro 4 130.Sh HISTORY 131The 132.Nm 133interface appeared in 134.Bx 4.2 . 135