share/man/man4/man4.vax/pcl.4

   1 .\"     $NetBSD: pcl.4,v 1.11 2003/08/07 10:31:13 agc 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
  40 Network Interface
  41 .Sh SYNOPSIS
  42 .Cd "pcl0 at uba? csr 164200 vector pclxint pclrint"
  43 .Sh DESCRIPTION
  44 NOTE: This driver has not been ported from
  45 .Bx 4.4
  46 yet.
  47 .Pp
  48 The
  49 .Nm pcl
  50 device provides an
  51 .Tn IP Ns -only
  52 interface to the
  53 .Tn DEC CSS
  54 .Tn PCL-11
  55 time division multiplexed network bus.
  56 The controller itself is not accessible to users.
  57 .Pp
  58 The host's address is specified with the
  59 .Dv SIOCSIFADDR
  60 .Xr ioctl 2 .
  61 The interface will not transmit or receive any data before
  62 its address is defined.
  63 .Pp
  64 As the
  65 .Tn PCL-11
  66 hardware is only capable of having 15 interfaces per network,
  67 a single-byte host-on-network number is used, with range [1..15] to match
  68 the
  69 .Tn TDM
  70 bus addresses of the interfaces.
  71 .Pp
  72 The interface currently only supports the Internet protocol family
  73 and only provides
  74 .Dq natural
  75 (header) encapsulation.
  76 .Sh DIAGNOSTICS
  77 .Bl -diag
  78 .It pcl%d: can't init.
  79 Insufficient
  80 .Tn UNIBUS
  81 resources existed to initialize the device.
  82 This is likely to occur when the device is run on a buffered
  83 data path on an 11/750 and other network interfaces are also
  84 configured to use buffered data paths, or when it is configured
  85 to use buffered data paths on an 11/730 (which has none).
  86 .Pp
  87 .It pcl%d: can't handle af%d.
  88 The interface was handed a message with addresses formatted in an
  89 unsuitable address family;  the packet was dropped.
  90 .Pp
  91 .It pcl%d: stray xmit interrupt.
  92 An interrupt occurred when no output had previously been started.
  93 .Pp
  94 .It pcl%d: master.
  95 The
  96 .Tn TDM
  97 bus had no station providing ``bus master'' timing signals,
  98 so this interface has assumed the ``master'' role.  This message should
  99 only appear at most once per
 100 .Tn UNIBUS INIT
 101 on a single system.
 102 Unless 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.
 105 The device indicated a problem sending data on output.
 106 If a ``receiver offline'' error is detected, it is not normally logged
 107 unless the option
 108 .Dv PCL_TESTING
 109 has been selected, as this causes a lot
 110 of console chatter when sending to a down machine.  However, this option
 111 is quite useful when debugging problems with the
 112 .Tn PCL
 113 interfaces.
 114 .Pp
 115 .It pcl%d: rcv error, rcr=%b rsr=%b.
 116 The device indicated a problem receiving data on input.
 117 .Pp
 118 .It pcl%d: bad len=%d.
 119 An input operation resulted in a data transfer of less than
 120 0 or more than 1008 bytes of
 121 data into memory (according to the word count register).
 122 This should never happen as the maximum size of a
 123 .Tn PCL
 124 message
 125 has 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
 131 The
 132 .Nm
 133 interface appeared in
 134 .Bx 4.2 .