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
  32 The
  33 .Nm
  34 driver provides support for the 3Com Etherlink XL
  35 family of Ethernet and Fast Ethernet PCI controllers.
  36 These are often known by their part numbers, most often 3c905 or 3c900 variants.
  37 .Lp
  38 The 3c905 devices generally support some form of 100 Mbps Ethernet,
  39 whereas the 3c900 devices usually only support 10 Mbps.
  40 Some devices support legacy media such as 10BASE-15, 10BASE-2, and even
  41 10BASE-FL.
  42 .
  43 Where applicable, the devices support auto-negotiation, both full and
  44 half duplex, etc.
  45 They also support full size MTUs (1500 bytes), even when used with VLANs.
  46 .
  47 .Lp
  48 The device driver supports the
  49 .Xr ieee802.3 5
  50 properties, which can be configured with
  51 .Xr dladm 1M .
  52 .Lp
  53 In addition, for devices with multiple external media ports, the driver
  54 supports a driver-specific
  55 .Xr dladm 1M
  56 property called
  57 .Sy media ,
  58 which can take one of the following values, depending on the available
  59 media options on the device:
  60 .Lp
  61 .Bl -tag -compact -offset indent -width Sy
  62 .It Sy mii
  63 Media Indendent Interface (MII), also 100BASE-TX
  64 .It Sy tp-hdx
  65 10 Mbps twisted pair, half-duplex
  66 .It Sy tp-fdx
  67 10 Mbps twisted pair full-duplex
  68 .It Sy fx-hdx
  69 100BASE-FX (fiber), half-duplex
  70 .It Sy fx-hdx
  71 100BASE-FX (fiber), full-duplex
  72 .It Sy bnc
  73 10BASE-2
  74 .Pq BNC, aka Dq thin-net
  75 .It Sy aui
  76 10BASE-15
  77 .Pq aka Dq thick-net
  78 .It Sy fl-hdx
  79 10BASE-FL (fiber), half-duplex
  80 .It Sy fl-fdx
  81 10BASE-FL (fiber), full-duplex
  82 .El
  83 .Lp
  84 The specific media options available can be queried with the
  85 device-specific
  86 .Sy available_media
  87 .Xr dladm 1M
  88 property.
  89 .Sh FILES
  90 .Bl -tag -width /dev/elxl
  91 .It Pa /dev/elxl
  92 Special character device.
  93 .El
  94 .Sh SEE ALSO
  95 .Xr dladm 1M ,
  96 .Xr ifconfig 1M ,
  97 .Xr pci 4 ,
  98 .Xr ieee802.3 5 ,
  99 .Xr dlpi 7P
 100 .Rs
 101 .%T IEEE 802.3: Ethernet
 102 .%Q IEEE Standards Association
 103 .Re