xref: /original-bsd/share/man/man4/man4.vax/pcl.4 (revision c3e32dec)
1.\" Copyright (c) 1983, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)pcl.4	8.1 (Berkeley) 06/05/93
7.\"
8.Dd
9.Dt PCL 4 vax
10.Os BSD 4.2
11.Sh NAME
12.Nm pcl
13.Nd
14.Tn DEC CSS
15.Tn PCL-11 B
16Network Interface
17.Sh SYNOPSIS
18.Cd "device pcl0 at uba? csr 164200 vector pclxint pclrint"
19.Sh DESCRIPTION
20The
21.Nm pcl
22device provides an
23.Tn IP Ns -only
24interface to the
25.Tn DEC CSS
26.Tn PCL-11
27time division multiplexed network bus.
28The controller itself is not accessible to users.
29.Pp
30The hosts's address is specified with the
31.Dv SIOCSIFADDR
32.Xr ioctl 2 .
33The interface will not transmit or receive any data before
34its address is defined.
35.Pp
36As the
37.Tn PCL-11
38hardware is only capable of having 15 interfaces per network,
39a single-byte host-on-network number is used, with range [1..15] to match
40the
41.Tn TDM
42bus addresses of the interfaces.
43.Pp
44The interface currently only supports the Internet protocol family
45and only provides
46.Dq natural
47(header) encapsulation.
48.Sh DIAGNOSTICS
49.Bl -diag
50.It pcl%d: can't init.
51Insufficient
52.Tn UNIBUS
53resources existed to initialize the device.
54This is likely to occur when the device is run on a buffered
55data path on an 11/750 and other network interfaces are also
56configured to use buffered data paths, or when it is configured
57to use buffered data paths on an 11/730 (which has none).
58.Pp
59.It pcl%d: can't handle af%d.
60The interface was handed a message with addresses formatted in an
61unsuitable address family;  the packet was dropped.
62.Pp
63.It pcl%d: stray xmit interrupt.
64An interrupt occurred when no output had previously been started.
65.Pp
66.It pcl%d: master.
67The
68.Tn TDM
69bus had no station providing ``bus master'' timing signals,
70so this interface has assumed the ``master'' role.  This message should
71only appear at most once per
72.Tn UNIBUS INIT
73on a single system.
74Unless there is a hardware failure, only one station may be master at at time.
75.Pp
76.It pcl%d: send error, tcr=%b, tsr=%b.
77The device indicated a problem sending data on output.
78If a ``receiver offline'' error is detected, it is not normally logged
79unless the option
80.Dv PCL_TESTING
81has been selected, as this causes a lot
82of console chatter when sending to a down machine.  However, this option
83is quite useful when debugging problems with the
84.Tn PCL
85interfaces.
86.Pp
87.It pcl%d: rcv error, rcr=%b rsr=%b.
88The device indicated a problem receiving data on input.
89.Pp
90.It pcl%d: bad len=%d.
91An input operation resulted in a data transfer of less than
920 or more than 1008 bytes of
93data into memory (according to the word count register).
94This should never happen as the maximum size of a
95.Tn PCL
96message
97has been agreed upon to be 1008 bytes (same as ArpaNet message).
98.El
99.Sh SEE ALSO
100.Xr intro 4 ,
101.Xr inet 4
102.Sh HISTORY
103The
104.Nm
105interface appeared in
106.Bx 4.2 .
107