share/man/man4/man4.vax/vv.4

   1 .\"     $NetBSD: vv.4,v 1.11 2003/08/07 10:31:14 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: @(#)vv.4  8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt VV 4 vax
  34 .Os
  35 .Sh NAME
  36 .Nm vv
  37 .Nd Proteon proNET 10 Megabit ring network
  38 .Sh SYNOPSIS
  39 .Cd "vv0 at uba0 csr 0161000 vector vvrint vvxint"
  40 .Sh DESCRIPTION
  41 NOTE: This driver has not been ported from
  42 .Bx 4.4
  43 yet.
  44 .Pp
  45 The
  46 .Nm vv
  47 interface provides access to a 10 Mb/s Proteon
  48 .Tn proNET
  49 ring network.
  50 .Pp
  51 The network address of the interface must be specified with an
  52 .Dv SIOCSIFADDR
  53 .Xr ioctl 2
  54 before data can be transmitted or received.
  55 It is only permissible to change the network address while the
  56 interface is marked
  57 .Dq down .
  58 .Pp
  59 The host's hardware address is discovered by putting the interface in
  60 digital loopback mode (not joining the ring) and sending a broadcast
  61 packet from which the hardware address is extracted.
  62 .Pp
  63 Transmit timeouts are detected through use of a watchdog routine.
  64 Lost input interrupts are checked for when packets are sent out.
  65 .Pp
  66 If the installation is running
  67 .Tn CTL
  68 boards which use the old broadcast
  69 address of
  70 .Ql 0
  71 instead of the new address of
  72 .Ql 0xff ,
  73 the define
  74 .Dv OLD_BROADCAST
  75 should be specified in the driver.
  76 .Pp
  77 The driver can use
  78 .Dq trailer
  79 encapsulation to minimize copying
  80 data on input and output.
  81 This may be disabled, on a per-interface basis,
  82 by setting the
  83 .Dv IFF_NOTRAILERS
  84 flag with an
  85 .Dv SIOCSIFFLAGS
  86 .Xr ioctl 2 .
  87 .Sh DIAGNOSTICS
  88 .Bl -diag
  89 .It vv%d: host %d.
  90 The software announces the host
  91 address discovered during autoconfiguration.
  92 .Pp
  93 .It vv%d: can't initialize.
  94 The software was unable to
  95 discover the address of this interface, so it deemed
  96 "dead" will not be enabled.
  97 .Pp
  98 .It vv%d: error vvocsr=%b.
  99 The hardware indicated an error on
 100 the previous transmission.
 101 .Pp
 102 .It vv%d: output timeout.
 103 The token timer has fired and the
 104 token will be recreated.
 105 .Pp
 106 .It vv%d: error vvicsr=%b.
 107 The hardware indicated an error
 108 in reading a packet off the ring.
 109 .Pp
 110 .It vv%d: can't handle af%d.
 111 The interface was handed
 112 a message with addresses formatted in an unsuitable address
 113 family; the packet was dropped.
 114 .Pp
 115 .It vv%d: vs_olen=%d.
 116 The ring output routine has been
 117 handed a message with a preposterous length.  This results in
 118 an immediate
 119 .Em panic: vs_olen .
 120 .El
 121 .Sh SEE ALSO
 122 .Xr inet 4 ,
 123 .Xr netintro 4
 124 .Sh HISTORY
 125 The
 126 .Nm
 127 driver appeared in
 128 .Bx 4.2 .
 129 .Sh BUGS
 130 The encapsulation of trailer packets in the
 131 .Bx 4.2
 132 version of this driver
 133 was incorrect (the packet type was in
 134 .Tn VAX
 135 byte order).
 136 As a result, the trailer encapsulation in this version is not compatible
 137 with the
 138 .Bx 4.2
 139 .Tn VAX
 140 version.