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