1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)vv.4 8.1 (Berkeley) 6/5/93 33.\" 34.Dd June 5, 1993 35.Dt VV 4 vax 36.Os BSD 4.2 37.Sh NAME 38.Nm vv 39.Nd Proteon proNET 10 Megabit ring 40.Sh SYNOPSIS 41.Cd "device vv0 at uba0 csr 0161000 vector vvrint vvxint" 42.Sh DESCRIPTION 43The 44.Nm vv 45interface provides access to a 10 Mb/s Proteon 46.Tn proNET 47ring network. 48.Pp 49The network address of the interface must be specified with an 50an 51.Dv SIOCSIFADDR 52.Xr ioctl 2 53before data can be transmitted or received. 54It is only permissible to change the network address while the 55interface is marked 56.Dq down . 57.Pp 58The host's hardware address is discovered by putting the interface in 59digital loopback mode (not joining the ring) and sending a broadcast 60packet from which the hardware address is extracted. 61.Pp 62Transmit timeouts are detected through use of a watchdog routine. 63Lost input interrupts are checked for when packets are sent out. 64.Pp 65If the installation is running 66.Tn CTL 67boards which use the old broadcast 68address of 69.Ql 0 70instead of the new address of 71.Ql 0xff , 72the define 73.Dv OLD_BROADCAST 74should be specified in the driver. 75.Pp 76The driver can use 77.Dq trailer 78encapsulation to minimize copying 79data on input and output. 80This may be disabled, on a per-interface basis, 81by setting the 82.Dv IFF_NOTRAILERS 83flag with an 84.Dv SIOCSIFFLAGS 85.Xr ioctl . 86.Sh DIAGNOSTICS 87.Bl -diag 88.It vv%d: host %d. 89The software announces the host 90address discovered during autoconfiguration. 91.Pp 92.It vv%d: can't initialize. 93The software was unable to 94discover the address of this interface, so it deemed 95"dead" will not be enabled. 96.Pp 97.It vv%d: error vvocsr=%b. 98The hardware indicated an error on 99the previous transmission. 100.Pp 101.It vv%d: output timeout. 102The token timer has fired and the 103token will be recreated. 104.Pp 105.It vv%d: error vvicsr=%b. 106The hardware indicated an error 107in reading a packet off the ring. 108.Pp 109.It en%d: can't handle af%d. 110The interface was handed 111a message with addresses formatted in an unsuitable address 112family; the packet was dropped. 113.Pp 114.It vv%d: vs_olen=%d. 115The ring output routine has been 116handed a message with a preposterous length. This results in 117an immediate 118.Em panic: vs_olen . 119.El 120.Sh SEE ALSO 121.Xr netintro 4 , 122.Xr inet 4 123.Sh HISTORY 124The 125.Nm 126driver appeared in 127.Bx 4.2 . 128.Sh BUGS 129The encapsulation of trailer packets in the 130.Bx 4.2 131version of this driver 132was incorrect (the packet type was in 133.Tn VAX 134byte order). 135As a result, the trailer encapsulation in this version is not compatible 136with the 137.Bx 4.2 138.Tn VAX 139version. 140