MI ep man page

5 files changed, 155 insertions, 8 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 76f941aef01..bdedddc7cbf 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,8 +1,8 @@
-#	$OpenBSD: Makefile,v 1.44 1998/09/21 17:11:06 jason Exp $
+#	$OpenBSD: Makefile,v 1.45 1998/09/22 21:55:11 deraadt Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
-	de.4 drum.4 eap.4 esis.4 fd.4 ffs_softupdates.4 fpa.4 fxp.4 icmp.4 \
+	de.4 drum.4 eap.4 ep.4 esis.4 fd.4 ffs_softupdates.4 fpa.4 fxp.4 icmp.4 \
 	idp.4 ifmedia.4 imp.4 inet.4 ip.4 ipl.4 ipsec.4 isapnp.4 iso.4 isp.4 \
 	ksyms.4 lkm.4 lo.4 mtio.4 ncr.4 netintro.4 ns.4 \
 	nsip.4 null.4 options.4 pty.4 random.4 route.4 scsi.4 sd.4 sl.4 \
diff --git a/share/man/man4/ep.4 b/share/man/man4/ep.4
new file mode 100644
index 00000000000..6dc6b709076
--- /dev/null
+++ b/share/man/man4/ep.4
@@ -0,0 +1,147 @@
+.\"	$OpenBSD: ep.4,v 1.1 1998/09/22 21:55:11 deraadt Exp $
+.\"
+.\" Copyright (c) 1994 Herb Peyerl
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Herb Peyerl
+.\" 3. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd July 12, 1998
+.Dt EP 4 i386
+.Os
+.Sh NAME
+.Nm ep
+.Nd Ethernet driver for 3Com Etherlink III (3c5x9)
+.Sh SYNOPSIS
+.Cd "ep? at eisa? slot ?"
+.Cd "ep? at isa? port ? irq ?"
+.Cd "ep? at pci? dev ? function ?"
+.Cd "ep? at pcmcia? port 0x300 size 0x10 irq 10 slot ?"
+.Cd "ep* at isapnp?"
+.Sh DESCRIPTION
+The
+.Nm ep
+device driver supports the 3Com Etherlink III family of ethernet cards.
+This includes, among others,
+the 3c509 (ISA), 3c579 (EISA), 3c589 (PCMCIA), and 3c590, 3c595,
+3c900, and 3c905 (all PCI).
+Various models of these cards come with a different assortment of
+connectors:
+.Pp
+.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
+.It AUI/DIX
+Standard 15 pin connector
+.It 10Base2
+BNC, also known as thin-net
+.It 10BaseT
+10 Mbps UTP, also known as twisted pair
+.It MII
+UTP, switchable between 10 and 100 Mbps
+.El
+.Pp
+Various models of the
+.Nm
+support different media types or connectors.
+The supported media types are:
+.Bl -tag -width xxxxxxxxxxxxxx -offset indent
+.It media autoselect
+Attempt to autoselect the media type
+.It media 100baseTX mediaopt full-duplex
+Use 100baseTX, full duplex
+.It media 100baseTX Op mediaopt half-duplex
+Use 100baseTX, half duplex
+.It media 10baseT mediaopt full-duplex
+Use 10baseT, full duplex
+.It media 10baseT Op mediaopt half-duplex
+Use 10baseT (UTP), half duplex
+.It media 10base5 Op mediaopt half-duplex
+Use 10base5 (Thin-net), half duplex
+.It media 10base2 Op mediaopt half-duplex
+Use 10base2 (Thick-net), half duplex
+.El
+The default media type varies based on the model of card.
+.Pp
+If there are multiple cards in the computer, they are searched for
+in the following order:
+The PCI cards are found first based on PCI function# order.
+The EISA cards are found next based on EISA slot# order.
+Next, the 3c509 ISA cards are found based on in increasing ethernet
+address order.
+Finally, the 3c509 ISA cards in Plug-and-Play mode will be probed
+for and matched in Plug-and-Play order.
+This is an example of how these will probe:
+.Pp
+ep0 at isa0 port 0x300-0x30f irq 3: 3Com 3C509 Ethernet: address 00:a0:24:29:a3:6b, utp (default utp)
+.Pp
+ep0 at pci0 dev 12 function 0 "3Com 3c905 100Base-TX" rev 0x00: address 00:60:97:dd:fc:eb, mii default mii/autoselect isa irq 9
+.Pp
+You may specify the port and irq numbers that the cards are expected
+to be found at, but it is not necessary.
+The cards are sufficiently intelligent to tell us where they
+actually live on the ISA bus.
+.Pp
+.Sh NOTES
+The 3c509 card has no jumpers to set the address.
+3Com supplies software to set the address of the card in software.
+To find the card on the ISA bus, the kernel performs a complex
+scan operation at IO address 0x100.
+Beware!
+Avoid placing other cards at that address!
+.Pp
+Some models of 3c5x9 have all three connectors on them.
+In the case of these cards; you must configure the transceiver type
+with the 3Com supplied DOS configuration disk before the link0/link1
+flags will operate correctly.
+.Pp
+Plug and Play mode must currently be disabled on these cards.
+.Pp
+Do not specify link flags for the 3c905.
+If you can not get this card to work, try running the 3Com supplied DOS
+configuration program (available from their web site) and tell it to
+autoselect the connector type.
+.Pp
+.Sh DIAGNOSTICS
+ep0: reset (status: %x)
+.in +4
+the driver has encountered a FIFO underrun or overrun. The driver will reset
+the card and the packet will be lost. This is not fatal.
+.in -4
+ep0: eeprom failed to come ready
+.in +4
+The eeprom failed to come ready.  This probably means the card is wedged.
+.in -4
+ep0: 3c509 in test mode. Erase pencil mark!
+.in +4
+This means that someone has scribbled with pencil in the test area on the
+card.  Erase the pencil mark and reboot.  (This is not a joke).
+.in -4
+.Sh SEE ALSO
+.Xr ifconfig 8 ,
+.Xr intro 4 ,
+.Xr ed 4 ,
+.Xr eg 4 ,
+.Xr el 4 ,
+.Xr ie 4 ,
+.Xr le 4
diff --git a/share/man/man4/man4.alpha/Makefile b/share/man/man4/man4.alpha/Makefile
index bbf098c0ccc..9c8e630c4a4 100644
--- a/share/man/man4/man4.alpha/Makefile
+++ b/share/man/man4/man4.alpha/Makefile
@@ -1,6 +1,6 @@
-#	$OpenBSD: Makefile,v 1.5 1998/04/25 04:46:50 millert Exp $
+#	$OpenBSD: Makefile,v 1.6 1998/09/22 21:55:11 deraadt Exp $
 
-MAN=	com.4 cy.4 ed.4 ep.4 esp.4 intro.4 le.4 lpt.4 pms.4 scc.4 wd.4
+MAN=	com.4 cy.4 ed.4 esp.4 intro.4 le.4 lpt.4 pms.4 scc.4 wd.4
 MANSUBDIR=/alpha
 
 .include <bsd.prog.mk>
diff --git a/share/man/man4/man4.arc/Makefile b/share/man/man4/man4.arc/Makefile
index 2319c30e3d7..57f2625dcff 100644
--- a/share/man/man4/man4.arc/Makefile
+++ b/share/man/man4/man4.arc/Makefile
@@ -1,6 +1,6 @@
-#	$OpenBSD: Makefile,v 1.2 1998/05/05 06:15:11 imp Exp $
+#	$OpenBSD: Makefile,v 1.3 1998/09/22 21:55:11 deraadt Exp $
 
-MAN=	autoconf.4 com.4 ed.4 ep.4 intro.4 le.4 lpt.4 pms.4 wd.4
+MAN=	autoconf.4 com.4 ed.4 intro.4 le.4 lpt.4 pms.4 wd.4
 MANSUBDIR=/alpha
 
 .include <bsd.prog.mk>
diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile
index f51fc493f36..e02a334e115 100644
--- a/share/man/man4/man4.i386/Makefile
+++ b/share/man/man4/man4.i386/Makefile
@@ -1,9 +1,9 @@
-#	$OpenBSD: Makefile,v 1.21 1998/09/09 22:10:58 jason Exp $
+#	$OpenBSD: Makefile,v 1.22 1998/09/22 21:55:12 deraadt Exp $
 #	from: @(#)Makefile	5.1 (Berkeley) 2/12/91
 #	Id: Makefile,v 1.4 1995/12/14 05:41:38 deraadt Exp $
 
 MAN=	intro.4 aha.4 ahb.4 aic.4 apm.4 aria.4 ast.4 autoconf.4 boca.4 bt.4
-MAN+=	com.4 cy.4 ed.4 ep.4 fdc.4 iy.4 lms.4 lpt.4 mcd.4 mem.4 mms.4
+MAN+=	com.4 cy.4 ed.4 fdc.4 iy.4 lms.4 lpt.4 mcd.4 mem.4 mms.4
 MAN+=	npx.4 pctr.4 pms.4 rtfps.4 scd.4 sea.4 speaker.4 uha.4 wdc.4
 MAN+=	eg.4 el.4 ie.4 joy.4 le.4 wt.4
 MAN+=	gus.4 pss.4 sb.4 wss.4