1.\" $OpenBSD: ep.4,v 1.26 2003/06/06 10:29:41 jmc Exp $ 2.\" 3.\" Copyright (c) 1994 Herb Peyerl 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Herb Peyerl 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd July 12, 1998 32.Dt EP 4 33.Os 34.Sh NAME 35.Nm ep 36.Nd 3Com EtherLink III and Fast EtherLink III Ethernet driver 37.Sh SYNOPSIS 38.Cd "ep* at eisa? slot ?" 39.Cd "ep* at isa? port ? irq ?" 40.Cd "ep* at pci? dev ? function ?" 41.Cd "ep* at pcmcia? function ?" 42.Cd "ep* at isapnp?" 43.Sh DESCRIPTION 44The 45.Nm 46device driver supports the 3Com EtherLink III and Fast EtherLink III family 47of Ethernet cards. 48This includes, among others, the following models: 49.Pp 50.Bl -tag -width 3CXXXX -offset indent -compact 51.It 3C509 52EtherLink III ISA 53.It 3C509B 54EtherLink III ISA (Plug-and-Play) 55.It 3C556 56EtherLink III LAN+Modem PC Card (PCMCIA) 57.It 3C562 58EtherLink III LAN+33.6K Modem PC Card (PCMCIA) 59.It 3C574 60Fast EtherLink III 10/100 LAN PC Card (PCMCIA) 61.It 3C579 62EtherLink III EISA 63.It 3C589 64EtherLink III LAN PC Card (PCMCIA) 65.It 3C590 66Fast EtherLink III PCI 67.It 3C592 68EtherLink III EISA Bus Master 69.It 3C595 70Fast EtherLink III PCI 10/100 71.It 3C597 72Fast EtherLink III EISA 10/100 73.El 74.Pp 75Other models of 3Com network cards are supported by the 76.Xr ec 4 , 77.Xr ef 4 , 78.Xr eg 4 , 79.Xr el 4 , 80.Xr ie 4 , 81and 82.Xr xl 4 83drivers. 84.Pp 85Category 3, 4 or 5 unshielded twisted-pair (UTP) cable should be used for 86RJ-45 (10baseT), thick Ethernet coaxial (RG59 B/U, 50 ohm) for AUI/DIX, and 87thin Ethernet coaxial (RG58 A/U or C/U, 50 ohm +/- 4) for BNC (10base2). 88Some 3Com NICs also support MII connectors (switchable 10/100Mbps UTP). 89.Pp 90The following media types and options (as given to 91.Xr ifconfig 8 ) 92are supported: 93.Pp 94.Bl -tag -width xxx -offset indent 95.It Cm media No autoselect 96Enable autoselection of media type and options. 97.It Cm media No 100baseTX Cm mediaopt No full-duplex 98Set 100Mbps (Fast Ethernet) operation and force full-duplex mode. 99.It Cm media No 100baseTX Cm mediaopt No half-duplex 100Set 100Mbps (Fast Ethernet) operation and force half-duplex mode. 101.It Cm media No 10baseT Cm mediaopt No full-duplex 102Set 10baseT (UTP) operation and force full-duplex mode. 103.It Cm media No 10baseT Cm mediaopt No half-duplex 104Set 10baseT (UTP) operation and force half-duplex mode. 105.It Cm media No 10base5 106Set 10base5 (thick-net) operation (half-duplex only). 107.It Cm media No 10base2 108Set 10base2 (thin-net) operation (half-duplex only). 109.El 110.Pp 111Note that the 100baseTX media type is only available if supported by the 112adapter. 113For more information on configuring this device, see 114.Xr ifconfig 8 . 115To view a list of media types and options supported by your card try 116.Dq ifconfig -m <device> . 117For example, 118.Dq ifconfig -m ep0 . 119.Pp 120If more than one of the supported cards is installed, they are probed for 121in the following order: 122.Pp 123.Bl -item -offset indent -compact 124.It 1251. PCI cards based on PCI function number order. 126.It 1272. EISA cards based on EISA slot number order. 128.It 1293. ISA cards based on increasing Ethernet address order. 130.It 1314. Any ISA cards in Plug-and-Play mode, in Plug-and-Play order. 132.El 133.Pp 134You may specify the port and IRQ numbers where the cards are expected to 135be found, but it is not necessary. 136The cards are intelligent enough to let us know where they live on the bus. 137.Sh DIAGNOSTICS 138.Bl -diag 139.It ep0: reset (status: %x) 140The driver has encountered a FIFO underrun or overrun. 141The driver will reset the card and the packet will be lost. 142This is not fatal. 143.It ep0: eeprom failed to come ready 144The EEPROM failed to come ready. 145This probably means the card is wedged. 146.It ep0: erase pencil mark, or disable PnP mode! 147This means that someone has scribbled with pencil in the test area on the 148card. 149Erase the pencil mark and reboot. 150(This is not a joke). 151.El 152.Sh SEE ALSO 153.Xr ec 4 , 154.Xr ef 4 , 155.Xr eg 4 , 156.Xr eisa 4 , 157.Xr el 4 , 158.Xr ie 4 , 159.Xr ifmedia 4 , 160.Xr intro 4 , 161.Xr isa 4 , 162.Xr isapnp 4 , 163.Xr pci 4 , 164.Xr pcmcia 4 , 165.Xr xl 4 , 166.Xr hostname.if 5 , 167.Xr ifconfig 8 168