xref: /illumos-gate/usr/src/man/man4d/elxl.4d (revision dd72704bd9e794056c558153663c739e2012d721)
1.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
2.\" Redistribution and use in source and binary forms, with or without
3.\" modification, are permitted provided that the following conditions
4.\" are met:
5.\" 1. Redistributions of source code must retain the above copyright
6.\"    notice, this list of conditions and the following disclaimer.
7.\" 2. Redistributions in binary form must reproduce the above copyright
8.\"    notice, this list of conditions and the following disclaimer in the
9.\"    documentation and/or other materials provided with the distribution.
10.\"
11.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS
12.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
13.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
14.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
15.\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
16.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
17.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
18.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
19.\" ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
20.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
21.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
22.\"
23.Dd "Jan 10, 2020"
24.Dt ELXL 4D
25.Os
26.Sh NAME
27.Nm elxl
28.Nd 3Com Etherlink XL device driver
29.Sh SYNOPSIS
30.Pa /dev/elxl
31.Sh DESCRIPTION
32The
33.Nm
34driver provides support for the 3Com Etherlink XL
35family of Ethernet and Fast Ethernet PCI controllers.
36These are often known by their part numbers, most often 3c905 or 3c900 variants.
37.Lp
38The 3c905 devices generally support some form of 100 Mbps Ethernet,
39whereas the 3c900 devices usually only support 10 Mbps.
40Some devices support legacy media such as 10BASE-15, 10BASE-2, and even
4110BASE-FL.
42.
43Where applicable, the devices support auto-negotiation, both full and
44half duplex, etc.
45They also support full size MTUs (1500 bytes), even when used with VLANs.
46.
47.Lp
48The device driver supports the
49.Xr ieee802.3 7
50properties, which can be configured with
51.Xr dladm 8 .
52.Lp
53In addition, for devices with multiple external media ports, the driver
54supports a driver-specific
55.Xr dladm 8
56property called
57.Sy media ,
58which can take one of the following values, depending on the available
59media options on the device:
60.Lp
61.Bl -tag -compact -offset indent -width Sy
62.It Sy mii
63Media Independent Interface (MII), also 100BASE-TX
64.It Sy tp-hdx
6510 Mbps twisted pair, half-duplex
66.It Sy tp-fdx
6710 Mbps twisted pair full-duplex
68.It Sy fx-hdx
69100BASE-FX (fiber), half-duplex
70.It Sy fx-hdx
71100BASE-FX (fiber), full-duplex
72.It Sy bnc
7310BASE-2
74.Pq BNC, aka Dq thin-net
75.It Sy aui
7610BASE-15
77.Pq aka Dq thick-net
78.It Sy fl-hdx
7910BASE-FL (fiber), half-duplex
80.It Sy fl-fdx
8110BASE-FL (fiber), full-duplex
82.El
83.Lp
84The specific media options available can be queried with the
85device-specific
86.Sy available_media
87.Xr dladm 8
88property.
89.Sh FILES
90.Bl -tag -width /dev/elxl
91.It Pa /dev/elxl
92Special character device.
93.El
94.Sh SEE ALSO
95.Xr dlpi 4P ,
96.Xr pci 5 ,
97.Xr ieee802.3 7 ,
98.Xr dladm 8 ,
99.Xr ifconfig 8
100.Rs
101.%T IEEE 802.3: Ethernet
102.%Q IEEE Standards Association
103.Re
104