xref: /titanic_44/usr/src/man/man7d/elxl.7d (revision 5fd03bc0f2e00e7ba02316c2e08f45d52aab15db)
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 "Aug 7, 2014"
24.Dt ELXL 7D
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. These are often known
36by 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.  Some devices
40support legacy media such as 10BASE-15, 10BASE-2, and even 10BASE-FL.
41.
42Where applicable, the devices support auto-negotiation, both full and
43half duplex, etc.  They also support full size MTUs (1500 bytes),
44even when used with VLANs.
45.
46.Lp
47The device driver supports the
48.Xr ieee802.3 5
49properties, which can be configured with
50.Xr dladm 1M .
51.Lp
52In addition, for devices with multiple external media ports, the driver
53supports a driver-specific
54.Xr dladm 1M
55property called
56.Sy media ,
57which can take one of the following values, depending on the available
58media options on the device:
59.Lp
60.Bl -tag -compact -offset indent -width Sy
61.It Sy mii
62Media Indendent Interface (MII), also 100BASE-TX
63.It Sy tp-hdx
6410 Mbps twisted pair, half-duplex
65.It Sy tp-fdx
6610 Mbps twisted pair full-duplex
67.It Sy fx-hdx
68100BASE-FX (fiber), half-duplex
69.It Sy fx-hdx
70100BASE-FX (fiber), full-duplex
71.It Sy bnc
7210BASE-2
73.Pq BNC, aka Dq thin-net
74.It Sy aui
7510BASE-15
76.Pq aka Dq thick-net
77.It Sy fl-hdx
7810BASE-FL (fiber), half-duplex
79.It Sy fl-fdx
8010BASE-FL (fiber), full-duplex
81.El
82.Lp
83The specific media options available can be queried with the
84device-specific
85.Sy available_media
86.Xr dladm 1M
87property.
88.Sh FILES
89.Bl -tag -width /dev/elxl
90.It Pa /dev/elxl
91Special character device.
92.El
93.Sh SEE ALSO
94.Xr dladm 1M ,
95.Xr ifconfig 1M ,
96.Xr pci 4 ,
97.Xr ieee802.3 5 ,
98.Xr dlpi 7P
99.Rs
100.%T IEEE 802.3: Ethernet
101.%Q IEEE Standards Association
102.Re
103