1.\" $NetBSD: pcl.4,v 1.16 2017/08/01 11:11:17 wiz 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 February 17, 2017 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.It pcl%d: can't handle af%d. 87The interface was handed a message with addresses formatted in an 88unsuitable address family; the packet was dropped. 89.It pcl%d: stray xmit interrupt. 90An interrupt occurred when no output had previously been started. 91.It pcl%d: master. 92The 93.Tn TDM 94bus had no station providing ``bus master'' timing signals, 95so this interface has assumed the ``master'' role. 96This message should only appear at most once per 97.Tn UNIBUS INIT 98on a single system. 99Unless there is a hardware failure, only one station may be master at a time. 100.It pcl%d: send error, tcr=%b, tsr=%b. 101The device indicated a problem sending data on output. 102If a ``receiver offline'' error is detected, it is not normally logged 103unless the option 104.Dv PCL_TESTING 105has been selected, as this causes a lot 106of console chatter when sending to a down machine. 107However, this option 108is quite useful when debugging problems with the 109.Tn PCL 110interfaces. 111.It pcl%d: rcv error, rcr=%b rsr=%b. 112The device indicated a problem receiving data on input. 113.It pcl%d: bad len=%d. 114An input operation resulted in a data transfer of less than 1150 or more than 1008 bytes of 116data into memory (according to the word count register). 117This should never happen as the maximum size of a 118.Tn PCL 119message 120has been agreed upon to be 1008 bytes (same as ARPANET message). 121.El 122.Sh SEE ALSO 123.Xr inet 4 , 124.Xr vax/intro 4 125.Sh HISTORY 126The 127.Nm 128interface appeared in 129.Bx 4.2 . 130