xref: /csrg-svn/share/man/man4/man4.vax/vv.4 (revision 47674)
1*47674Scael.\" Copyright (c) 1983, 1991 The Regents of the University of California.
236756Sbostic.\" All rights reserved.
320752Smckusick.\"
443582Strent.\" %sccs.include.redist.man%
520752Smckusick.\"
6*47674Scael.\"     @(#)vv.4	6.5 (Berkeley) 03/27/91
736756Sbostic.\"
8*47674Scael.Dd
9*47674Scael.Dt VV 4 vax
10*47674Scael.Os BSD 4.2
11*47674Scael.Sh NAME
12*47674Scael.Nm vv
13*47674Scael.Nd Proteon proNET 10 Megabit ring
14*47674Scael.Sh SYNOPSIS
15*47674Scael.Cd "device vv0 at uba0 csr 0161000 vector vvrint vvxint"
16*47674Scael.Sh DESCRIPTION
1720752SmckusickThe
18*47674Scael.Nm vv
19*47674Scaelinterface provides access to a 10 Mb/s Proteon
20*47674Scael.Tn proNET
21*47674Scaelring network.
22*47674Scael.Pp
2320753SmckusickThe network address of the interface must be specified with an
24*47674Scaelan
25*47674Scael.Dv SIOCSIFADDR
26*47674Scael.Xr ioctl 2
27*47674Scaelbefore data can be transmitted or received.
2820753SmckusickIt is only permissible to change the network address while the
29*47674Scaelinterface is marked
30*47674Scael.Dq down .
31*47674Scael.Pp
3220753SmckusickThe host's hardware address is discovered by putting the interface in
3320753Smckusickdigital loopback mode (not joining the ring) and sending a broadcast
3420753Smckusickpacket from which the hardware address is extracted.
35*47674Scael.Pp
3620753SmckusickTransmit timeouts are detected through use of a watchdog routine.
3720753SmckusickLost input interrupts are checked for when packets are sent out.
38*47674Scael.Pp
39*47674ScaelIf the installation is running
40*47674Scael.Tn CTL
41*47674Scaelboards which use the old broadcast
42*47674Scaeladdress of
43*47674Scael.Ql 0
44*47674Scaelinstead of the new address of
45*47674Scael.Ql 0xff ,
46*47674Scaelthe define
47*47674Scael.Dv OLD_BROADCAST
4820752Smckusickshould be specified in the driver.
49*47674Scael.Pp
50*47674ScaelThe driver can use
51*47674Scael.Dq trailer
52*47674Scaelencapsulation to minimize copying
5320753Smckusickdata on input and output.
5420753SmckusickThis may be disabled, on a per-interface basis,
55*47674Scaelby setting the
56*47674Scael.Dv IFF_NOTRAILERS
57*47674Scaelflag with an
58*47674Scael.Dv SIOCSIFFLAGS
59*47674Scael.Xr ioctl .
60*47674Scael.Sh DIAGNOSTICS
61*47674Scael.Bl -diag
62*47674Scael.It vv%d: host %d.
63*47674ScaelThe software announces the host
6420752Smckusickaddress discovered during autoconfiguration.
65*47674Scael.Pp
66*47674Scael.It vv%d: can't initialize.
67*47674ScaelThe software was unable to
6820752Smckusickdiscover the address of this interface, so it deemed
6920752Smckusick"dead" will not be enabled.
70*47674Scael.Pp
71*47674Scael.It vv%d: error vvocsr=%b.
72*47674ScaelThe hardware indicated an error on
7320752Smckusickthe previous transmission.
74*47674Scael.Pp
75*47674Scael.It vv%d: output timeout.
76*47674ScaelThe token timer has fired and the
7720752Smckusicktoken will be recreated.
78*47674Scael.Pp
79*47674Scael.It vv%d: error vvicsr=%b.
80*47674ScaelThe hardware indicated an error
8120752Smckusickin reading a packet off the ring.
82*47674Scael.Pp
83*47674Scael.It en%d: can't handle af%d.
84*47674ScaelThe interface was handed
8520752Smckusicka message with addresses formatted in an unsuitable address
8620752Smckusickfamily; the packet was dropped.
87*47674Scael.Pp
88*47674Scael.It vv%d: vs_olen=%d.
89*47674ScaelThe ring output routine has been
9020752Smckusickhanded a message with a preposterous length.  This results in
9120752Smckusickan immediate
92*47674Scael.Em panic: vs_olen .
93*47674Scael.El
94*47674Scael.Sh SEE ALSO
95*47674Scael.Xr netintro 4 ,
96*47674Scael.Xr inet 4
97*47674Scael.Sh HISTORY
98*47674ScaelThe
99*47674Scael.Nm
100*47674Scaeldriver appeared in
101*47674Scael.Bx 4.2 .
102*47674Scael.Sh BUGS
103*47674ScaelThe encapsulation of trailer packets in the
104*47674Scael.Bx 4.2
105*47674Scaelversion of this driver
106*47674Scaelwas incorrect (the packet type was in
107*47674Scael.Tn VAX
108*47674Scaelbyte order).
10928256SkarelsAs a result, the trailer encapsulation in this version is not compatible
110*47674Scaelwith the
111*47674Scael.Bx 4.2
112*47674Scael.Tn VAX
113*47674Scaelversion.
114