1.\"
2.\" Copyright (c) 1996, Fred Gray
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\" must display the following acknowledgement:
15.\" This product includes software developed by David Greenman.
16.\" 4. The name of the author may not be used to endorse or promote products
17.\" derived from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29.\" SUCH DAMAGE.
30.\"
| 1.\"
2.\" Copyright (c) 1996, Fred Gray
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\" must display the following acknowledgement:
15.\" This product includes software developed by David Greenman.
16.\" 4. The name of the author may not be used to endorse or promote products
17.\" derived from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29.\" SUCH DAMAGE.
30.\"
|
32.\"
33.Dd January 15, 1996
34.Dt VX 4 i386
35.Os
36.Sh NAME
37.Nm vx
38.Nd
39PCI Ethernet device driver
40.Sh SYNOPSIS
41.Cd "device vx"
42.Sh DESCRIPTION
43The
44.Nm
45driver provides support for the 3Com 3c590 and 3c595 EtherLink III and Fast
46EtherLink III PCI Ethernet cards in 10 Mbps mode. The medium selection
47can be influenced by the following link flags to the
48.Xr ifconfig 8
49command:
50.Pp
51.Bl -tag -width LINK0X -compact
52.It Em link0
53Use the AUI port.
54.It Em link1
55Use the BNC port.
56.It Em link2
57Use the UTP port.
58.El
59.Sh DIAGNOSTICS
60.Bl -diag
61.It "vx%d: not configured; kernel is built for only %d devices."
62There are not enough devices in the kernel configuration file for the number
63of adapters present in the system. Add devices to the configuration file,
64rebuild the kernel, and reboot.
| 32.\"
33.Dd January 15, 1996
34.Dt VX 4 i386
35.Os
36.Sh NAME
37.Nm vx
38.Nd
39PCI Ethernet device driver
40.Sh SYNOPSIS
41.Cd "device vx"
42.Sh DESCRIPTION
43The
44.Nm
45driver provides support for the 3Com 3c590 and 3c595 EtherLink III and Fast
46EtherLink III PCI Ethernet cards in 10 Mbps mode. The medium selection
47can be influenced by the following link flags to the
48.Xr ifconfig 8
49command:
50.Pp
51.Bl -tag -width LINK0X -compact
52.It Em link0
53Use the AUI port.
54.It Em link1
55Use the BNC port.
56.It Em link2
57Use the UTP port.
58.El
59.Sh DIAGNOSTICS
60.Bl -diag
61.It "vx%d: not configured; kernel is built for only %d devices."
62There are not enough devices in the kernel configuration file for the number
63of adapters present in the system. Add devices to the configuration file,
64rebuild the kernel, and reboot.
|
65.Pp
66All other diagnostics indicate either a hardware problem or a bug in the
67driver.
68.Sh CAVEATS
69Some early-revision 3c590 cards are defective and suffer from many receive
70overruns, which cause lost packets. The author has attempted to implement
71a test for it based on the information supplied by 3Com, but the test resulted
72mostly in spurious warnings.
73.Pp
74The performance of this driver is somewhat limited by the fact that it uses
75only polled-mode I/O and does not make use of the bus-mastering capability
76of the cards.
77.Sh BUGS
78The
79.Nm
80driver is known not to reset the adapter correctly following a warm boot
81on some systems.
82.Pp
83The
84.Nm
85driver has not been exhaustively tested with all the models of cards that it
86claims to support.
87.Sh SEE ALSO
88.Xr arp 4 ,
89.Xr netintro 4 ,
90.Xr ng_ether 4 ,
91.Xr ifconfig 8
92.Sh HISTORY
93The
94.Nm
95device driver first appeared in
96.Fx 2.1 .
97It was derived from the
98.Nm ep
99driver, from which it inherits most of its limitations.
100.Sh AUTHORS
101.An -nosplit
102The
103.Nm
104device driver and this manual page were written by
105.An Fred Gray Aq fgray@rice.edu ,
106based on the work of
107.An Herb Peyerl
108and with the assistance of numerous others.
| 66.Pp
67All other diagnostics indicate either a hardware problem or a bug in the
68driver.
69.Sh CAVEATS
70Some early-revision 3c590 cards are defective and suffer from many receive
71overruns, which cause lost packets. The author has attempted to implement
72a test for it based on the information supplied by 3Com, but the test resulted
73mostly in spurious warnings.
74.Pp
75The performance of this driver is somewhat limited by the fact that it uses
76only polled-mode I/O and does not make use of the bus-mastering capability
77of the cards.
78.Sh BUGS
79The
80.Nm
81driver is known not to reset the adapter correctly following a warm boot
82on some systems.
83.Pp
84The
85.Nm
86driver has not been exhaustively tested with all the models of cards that it
87claims to support.
88.Sh SEE ALSO
89.Xr arp 4 ,
90.Xr netintro 4 ,
91.Xr ng_ether 4 ,
92.Xr ifconfig 8
93.Sh HISTORY
94The
95.Nm
96device driver first appeared in
97.Fx 2.1 .
98It was derived from the
99.Nm ep
100driver, from which it inherits most of its limitations.
101.Sh AUTHORS
102.An -nosplit
103The
104.Nm
105device driver and this manual page were written by
106.An Fred Gray Aq fgray@rice.edu ,
107based on the work of
108.An Herb Peyerl
109and with the assistance of numerous others.
|