simple man page for 3c515 (ef)

7 files changed, 111 insertions, 7 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 0ce5183ce90..09d559f043a 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,8 +1,8 @@
-#	$OpenBSD: Makefile,v 1.68 1999/07/30 19:06:36 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.69 1999/08/04 14:33:47 jason Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	atalk.4 atapiscsi.4 audio.4 adv.4 ahc.4 bpf.4 bridge.4 ccd.4 \
-	cd.4 ch.4 clnp.4 cltp.4 ddb.4 de.4 drum.4 eap.4 ec.4 ep.4 esis.4 \
+	cd.4 ch.4 clnp.4 cltp.4 ddb.4 de.4 drum.4 eap.4 ec.4 ef.4 ep.4 esis.4 \
 	exphy.4 fd.4 ffs_softupdates.4 fpa.4 fxp.4 icmp.4 icsphy.4 idp.4 \
 	ifmedia.4 imp.4 inet.4 inphy.4 ip.4 ipl.4 ipsec.4 isapnp.4 iso.4 \
 	isp.4 ksyms.4 lkm.4 lmc.4 lo.4 lxtphy.4 \
diff --git a/share/man/man4/ec.4 b/share/man/man4/ec.4
index fcb853eaec1..cf8c4986e03 100644
--- a/share/man/man4/ec.4
+++ b/share/man/man4/ec.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ec.4,v 1.4 1999/05/26 02:34:12 aaron Exp $
+.\"	$OpenBSD: ec.4,v 1.5 1999/08/04 14:33:47 jason Exp $
 .\"     $NetBSD: ec.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
@@ -49,6 +49,7 @@ The
 .Nm ec
 device driver supports 3Com EtherLink II (3C503) Ethernet cards.
 Other models of 3Com network cards are supported by the
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
@@ -93,6 +94,7 @@ region.  This often indicates that the card is configured at a conflicting
 .Em iomem
 address.
 .Sh SEE ALSO
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
diff --git a/share/man/man4/ef.4 b/share/man/man4/ef.4
new file mode 100644
index 00000000000..aba665472df
--- /dev/null
+++ b/share/man/man4/ef.4
@@ -0,0 +1,94 @@
+.\"	$OpenBSD: ef.4,v 1.1 1999/08/04 14:33:47 jason Exp $
+.\"
+.\" Copyright (c) 1998 Jason L. Wright (jason@thought.net)
+.\" 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 Jason L. Wright
+.\" 4. 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 August 3, 1999
+.Dt EF 4
+.Os
+.Sh NAME
+.Nm ef
+.Nd "3Com Fast EtherLink ISA"
+.Sh SYNOPSIS
+.Cd "ef* at isapnp?"
+.Sh DESCRIPTION
+The
+.Nm ef
+device driver supports the 3Com Fast EtherLink ISA family
+of Ethernet cards, and embedded controllers based on the 3Com
+.Dq corkscrew
+EtherLink chips.
+This includes the 3C515 adapter(s).
+Other models of 3Com network cards are supported by the
+.Xr ec 4 ,
+.Xr eg 4 ,
+.Xr el 4 ,
+.Xr ep 4 ,
+.Xr ie 4
+and
+.Xr xl 4
+drivers.
+.Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "ef%d: adapter failure (%x)"
+A fatal error during receive or transmit has occured.
+.It "ef%d: fifo underrunr (%x) @%d"
+The cpu was not able to send bytes fast enough for the card to transmit.
+The transmit start threshold is raised to compensate for this.
+.It "ef%d: eeprom failed to come ready"
+When reading/writing the EEPROM, the busy bit failed to clear.
+This may indicate a hardware problem.
+.It "ef%d: device timeout"
+The device has stopped responding to the network, or there is a problem with
+the network connection (cable).
+.El
+.Sh SEE ALSO
+.Xr ec 4 ,
+.Xr eg 4 ,
+.Xr el 4 ,
+.Xr ep 4 ,
+.Xr ie 4 ,
+.Xr ifmedia 4 ,
+.Xr ifconfig 8
+.Sh HISTORY
+The
+.Nm
+device driver first appeared in
+.Ox 2.6 .
+.Sh AUTHOR
+The
+.Nm
+driver was written by
+.An Jason L. Wright Aq jason@thought.net .
+.Sh BUGS
+The media handling assumes that there an external physical layer device (PHY),
+and that it will autonegotiate correctly.
diff --git a/share/man/man4/ep.4 b/share/man/man4/ep.4
index c9fd9422e26..2105c3d9429 100644
--- a/share/man/man4/ep.4
+++ b/share/man/man4/ep.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ep.4,v 1.11 1999/05/26 02:34:12 aaron Exp $
+.\"	$OpenBSD: ep.4,v 1.12 1999/08/04 14:33:47 jason Exp $
 .\"
 .\" Copyright (c) 1994 Herb Peyerl
 .\" All rights reserved.
@@ -61,6 +61,7 @@ Fast EtherLink III 10/100 PCI
 .Pp
 Other models of 3Com network cards are supported by the
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ie 4 ,
@@ -130,6 +131,7 @@ card. Erase the pencil mark and reboot. (This is not a joke).
 .El
 .Sh SEE ALSO
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ie 4 ,
diff --git a/share/man/man4/man4.i386/eg.4 b/share/man/man4/man4.i386/eg.4
index 18e9ae7f9a3..b0963a9005e 100644
--- a/share/man/man4/man4.i386/eg.4
+++ b/share/man/man4/man4.i386/eg.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: eg.4,v 1.7 1999/05/26 02:34:13 aaron Exp $
+.\"	$OpenBSD: eg.4,v 1.8 1999/08/04 14:33:47 jason Exp $
 .\"     $NetBSD: ec.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
@@ -50,6 +50,7 @@ The
 device driver supports 3Com EtherLink Plus (3C505) Ethernet cards.
 Other models of 3Com network cards are supported by the
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
@@ -74,6 +75,7 @@ than maximum size of Ethernet frame) was received and dropped.
 .El
 .Sh SEE ALSO
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
diff --git a/share/man/man4/man4.i386/el.4 b/share/man/man4/man4.i386/el.4
index 1b268159ef8..fb94257bf87 100644
--- a/share/man/man4/man4.i386/el.4
+++ b/share/man/man4/man4.i386/el.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: el.4,v 1.5 1999/05/26 02:34:13 aaron Exp $
+.\"	$OpenBSD: el.4,v 1.6 1999/08/04 14:33:47 jason Exp $
 .\"     $NetBSD: ec.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
@@ -50,6 +50,7 @@ The
 device driver supports 3Com EtherLink (3C501) Ethernet cards.
 Other models of 3Com network cards are supported by the
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
@@ -74,6 +75,7 @@ than maximum size of Ethernet frame) was received and dropped.
 .El
 .Sh SEE ALSO
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
diff --git a/share/man/man4/man4.i386/ie.4 b/share/man/man4/man4.i386/ie.4
index a70a89777db..e84238da4b9 100644
--- a/share/man/man4/man4.i386/ie.4
+++ b/share/man/man4/man4.i386/ie.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ie.4,v 1.6 1999/07/09 13:35:43 aaron Exp $
+.\"	$OpenBSD: ie.4,v 1.7 1999/08/04 14:33:47 jason Exp $
 .\"
 .\" Copyright (c) 1994 James A. Jegers
 .\" All rights reserved.
@@ -46,6 +46,7 @@ following network adapters:
 .Pp
 Other models of 3Com network cards are supported by the
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
@@ -66,6 +67,7 @@ For example,
 .Dq ifconfig -m ie0 .
 .Sh SEE ALSO
 .Xr ec 4 ,
+.Xr ef 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,