new 3Com NIC man pages (aka, work no one else wants to do) :-)

3 files changed, 142 insertions, 62 deletions

diff --git a/share/man/man4/man4.i386/eg.4 b/share/man/man4/man4.i386/eg.4
index 4424c81f347..18e9ae7f9a3 100644
--- a/share/man/man4/man4.i386/eg.4
+++ b/share/man/man4/man4.i386/eg.4
@@ -1,53 +1,82 @@
-.\"	$OpenBSD: eg.4,v 1.6 1999/05/16 19:57:03 alex Exp $
+.\"	$OpenBSD: eg.4,v 1.7 1999/05/26 02:34:13 aaron Exp $
+.\"     $NetBSD: ec.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $
 .\"
-.\" Copyright (c) 1994 James A. Jegers
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
+.\" NASA Ames Research Center.
+.\"
 .\" 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. 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.
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 10, 1995
+.Dd September 22, 1998
 .Dt EG 4 i386
 .Os
 .Sh NAME
 .Nm eg
-.Nd Ethernet driver for 3Com 3c505 (Etherlink Plus) Ethernet boards
+.Nd "3Com EtherLink Plus (3C505) Ethernet device driver"
 .Sh SYNOPSIS
 .Cd "eg0 at isa? port 0x310 irq 5"
 .Sh DESCRIPTION
 The
 .Nm
-interface provides access to a 10 Mb/s Ethernet network via the
-3Com 3c505 Ethernet board. 
-.Pp
-Other models of 3Com hardware are supported by the
-.Xr xl 4 ,
+device driver supports 3Com EtherLink Plus (3C505) Ethernet cards.
+Other models of 3Com network cards are supported by the
+.Xr ec 4 ,
+.Xr el 4 ,
 .Xr ep 4 ,
+.Xr ie 4 ,
 and
-.Xr ec 4
+.Xr xl 4
 drivers.
 .Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+To view a list of media types and options supported by your card try
+.Dq ifconfig -m <device> .
+For example,
+.Dq ifconfig -m eg0 .
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "eg%d: device timeout"
+The device has stopped responding to the network, or there is a problem with
+the network connection (cable).
+.It "eg%d: invalid packet size %d; dropping"
+A packet of an invalid length (less than size of Ethernet header or greater
+than maximum size of Ethernet frame) was received and dropped.
+.El
 .Sh SEE ALSO
-.Xr ed 4 ,
+.Xr ec 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
-.Xr intro 4 ,
-.Xr le 4 ,
-.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr xl 4 ,
+.Xr ifconfig 8
diff --git a/share/man/man4/man4.i386/el.4 b/share/man/man4/man4.i386/el.4
index 9e9c6e80c68..1b268159ef8 100644
--- a/share/man/man4/man4.i386/el.4
+++ b/share/man/man4/man4.i386/el.4
@@ -1,45 +1,82 @@
-.\"	$OpenBSD: el.4,v 1.4 1999/05/16 19:57:03 alex Exp $
+.\"	$OpenBSD: el.4,v 1.5 1999/05/26 02:34:13 aaron Exp $
+.\"     $NetBSD: ec.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $
 .\"
-.\" Copyright (c) 1994 James A. Jegers
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
+.\" NASA Ames Research Center.
+.\"
 .\" 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. 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.
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 10, 1995
+.Dd September 22, 1998
 .Dt EL 4 i386
 .Os
 .Sh NAME
 .Nm el
-.Nd Ethernet driver for 3Com 3C501 (Etherlink) device driver
+.Nd "3Com EtherLink (3C501) Ethernet device driver"
 .Sh SYNOPSIS
 .Cd "el0 at isa? port 0x300 irq 9"
 .Sh DESCRIPTION
 The
 .Nm
-interface provides access to a 10 Mb/s Ethernet network via the
-3Com 3c501 Ethernet cards.
+device driver supports 3Com EtherLink (3C501) Ethernet cards.
+Other models of 3Com network cards are supported by the
+.Xr ec 4 ,
+.Xr eg 4 ,
+.Xr ep 4 ,
+.Xr ie 4 ,
+and
+.Xr xl 4
+drivers.
+.Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+To view a list of media types and options supported by your card try
+.Dq ifconfig -m <device> .
+For example,
+.Dq ifconfig -m el0 .
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "el%d: device timeout"
+The device has stopped responding to the network, or there is a problem with
+the network connection (cable).
+.It "el%d: invalid packet size %d; dropping"
+A packet of an invalid length (less than size of Ethernet header or greater
+than maximum size of Ethernet frame) was received and dropped.
+.El
 .Sh SEE ALSO
-.Xr ed 4 ,
+.Xr ec 4 ,
 .Xr eg 4 ,
 .Xr ep 4 ,
 .Xr ie 4 ,
-.Xr intro 4 ,
-.Xr le 4 ,
-.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr xl 4 ,
+.Xr ifconfig 8
diff --git a/share/man/man4/man4.i386/ie.4 b/share/man/man4/man4.i386/ie.4
index 3e3b51a5858..29eb4391d0b 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.3 1999/05/16 19:57:04 alex Exp $
+.\"	$OpenBSD: ie.4,v 1.4 1999/05/26 02:34:13 aaron Exp $
 .\"
 .\" Copyright (c) 1994 James A. Jegers
 .\" All rights reserved.
@@ -27,28 +27,42 @@
 .Os
 .Sh NAME
 .Nm ie 
-.Nd Ethernet driver for Intel 82586 Ethernet chip
+.Nd Intel 82586 chip Ethernet device driver
 .Sh SYNOPSIS
 .Cd "ie0 at isa? port 0x360 irq 7 iomem 0xd0000"
 .Sh DESCRIPTION
 The
 .Nm
-interface provides access to a 10 Mb/s Ethernet network via the
-Intel 82586 chips.  The Ethernet cards supported by the
-.Nm
-interface are:
+device driver supports Intel 82586-based Ethernet cards. This includes the
+following network adapters:
 .Pp
-.Bl -tag -width -offset indet -compact
+.Bl -tag -width -offset indent -compact
 .It AT&T StarLAN 10
 .It AT&T EN100
 .It AT&T StarLan Fiber
-.It 3Com 3c507
+.It 3Com 3C507
 .El
+.Pp
+Other models of 3Com network cards are supported by the
+.Xr ec 4 ,
+.Xr eg 4 ,
+.Xr el 4 ,
+.Xr ep 4 ,
+and
+.Xr xl 4
+drivers.
+.Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+To view a list of media types and options supported by your card try
+.Dq ifconfig -m <device> .
+For example,
+.Dq ifconfig -m ie0 .
 .Sh SEE ALSO
-.Xr ed 4 ,
+.Xr ec 4 ,
 .Xr eg 4 ,
 .Xr el 4 ,
 .Xr ep 4 ,
-.Xr intro 4 ,
-.Xr le 4 ,
-.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr xl 4 ,
+.Xr ifconfig 8