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. These are often known
  36 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.  Some devices
  40 support legacy media such as 10BASE-15, 10BASE-2, and even 10BASE-FL.
  41 .
  42 Where applicable, the devices support auto-negotiation, both full and
  43 half duplex, etc.  They also support full size MTUs (1500 bytes),
  44 even when used with VLANs.
  45 .
  46 .Lp
  47 The device driver supports the
  48 .Xr ieee802.3 5
  49 properties, which can be configured with
  50 .Xr dladm 1M .
  51 .Lp
  52 In addition, for devices with multiple external media ports, the driver
  53 supports a driver-specific
  54 .Xr dladm 1M
  55 property called
  56 .Sy media ,
  57 which can take one of the following values, depending on the available
  58 media options on the device:
  59 .Lp
  60 .Bl -tag -compact -offset indent -width Sy
  61 .It Sy mii
  62 Media Indendent Interface (MII), also 100BASE-TX
  63 .It Sy tp-hdx
  64 10 Mbps twisted pair, half-duplex
  65 .It Sy tp-fdx
  66 10 Mbps twisted pair full-duplex
  67 .It Sy fx-hdx
  68 100BASE-FX (fiber), half-duplex
  69 .It Sy fx-hdx
  70 100BASE-FX (fiber), full-duplex
  71 .It Sy bnc
  72 10BASE-2
  73 .Pq BNC, aka Dq thin-net
  74 .It Sy aui
  75 10BASE-15
  76 .Pq aka Dq thick-net
  77 .It Sy fl-hdx
  78 10BASE-FL (fiber), half-duplex
  79 .It Sy fl-fdx
  80 10BASE-FL (fiber), full-duplex
  81 .El
  82 .Lp
  83 The specific media options available can be queried with the
  84 device-specific
  85 .Sy available_media
  86 .Xr dladm 1M
  87 property.
  88 .Sh FILES
  89 .Bl -tag -width /dev/elxl
  90 .It Pa /dev/elxl
  91 Special 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