[src/trunk]: src/share/man/man4 Merged le.4 man pages from amiga, hp300, i386...

[fair <fair%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a039880ea278
branches:  trunk
changeset: 479777:a039880ea278
user:      fair <fair%NetBSD.org@localhost>
date:      Tue Dec 21 07:48:11 1999 +0000

description:
Merged le.4 man pages from amiga, hp300, i386, pmax, sparc, and sun3.
This solves PR 7142

Added configuration information from other GENERIC kernels, including
news68k, newsmips, atari, alpha, and vax.

Added text explaining "dropping chained buffer" diagnostic in more detail;
this solves PR 6230 and partially deals with PR 6475

diffstat:

 share/man/man4/Makefile |    4 +-
 share/man/man4/le.4     |  363 +++++++++++++++++++++++++++++++++++++++--------
 2 files changed, 301 insertions(+), 66 deletions(-)

diffs (truncated from 431 to 300 lines):

diff -r 580bc8f696cf -r a039880ea278 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Tue Dec 21 06:33:00 1999 +0000
+++ b/share/man/man4/Makefile   Tue Dec 21 07:48:11 1999 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.119 1999/12/20 05:50:48 itojun Exp $
+#      $NetBSD: Makefile,v 1.120 1999/12/21 07:48:11 fair Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   ahb.4 ahc.4 aria.4 atalk.4 audio.4 awi.4 bha.4 bpf.4 cardbus.4 ccd.4 \
@@ -25,7 +25,7 @@
 
 # machine-independent ISA devices
 MAN+=  aha.4 aic.4 ast.4 boca.4 cy.4 ec.4 eg.4 el.4 esp.4 ess.4 \
-       gus.4 guspnp.4 iy.4 mcd.4 pss.4 rtfps.4 sb.4 sea.4 tcom.4 \
+       gus.4 guspnp.4 iy.4 le.4 mcd.4 pss.4 rtfps.4 sb.4 sea.4 tcom.4 \
        wds.4 we.4 wss.4 wt.4
 
 # machine-independent ISA devices
diff -r 580bc8f696cf -r a039880ea278 share/man/man4/le.4
--- a/share/man/man4/le.4       Tue Dec 21 06:33:00 1999 +0000
+++ b/share/man/man4/le.4       Tue Dec 21 07:48:11 1999 +0000
@@ -35,17 +35,52 @@
 .\"
 .\"    from: Header: le.4,v 1.2 92/10/13 05:31:33 leres Exp
 .\"    from: @(#)le.4  8.1 (Berkeley) 6/9/93
-.\"    $NetBSD: le.4,v 1.7 1999/12/21 05:10:25 fair Exp $
+.\"    $NetBSD: le.4,v 1.8 1999/12/21 07:48:11 fair Exp $
 .\"
 .Dd June 9, 1993
-.Dt LE 4 sun3
+.Dt LE 4
 .Os
 .Sh NAME
 .Nm le
-.Nd AMD 7990 LANCE Ethernet interface driver
+.Nd AMD 7990, 79C90, 79C960, 79C970 LANCE Ethernet interface driver
 .Sh SYNOPSIS
-.Cd "le* at obio0 addr ? level ?"
+.Ss alpha
+.Cd "le* at ioasic? offset ?"
+.Cd "le* at tc? slot ? offset ?"
+.Cd "le* at pci? dev ? function ?"
+.Cd "le* at depca?"
+.Ss amiga
+.Cd "le* at zbus0"
+.Ss atari
+.Cd "le0 at vme0 irq 4  # BVME410"
+.Cd "le0 at vme0 irq 5  # Riebl/PAM"
+.Ss hp300
+.Cd "le* at dio? scode ?"
+.Ss i386
+.Cd "le* at pci? dev? function ?            # PCI boards"
+.Cd "nele0 at isa? port 0x320 irq 9 drq 7   # NE2100"
+.Cd "le* at nele?"
+.Cd "bicc0 at isa? port 0x320 irq 10 drq 7  # BICC IsoLan"
+.Cd "le* at bicc?"
+.Ss mvme68k
+.Cd "le0 at pcc? ipl 3  # MVME147"
+.Ss news68k
+.Cd "le0 at hb0 addr 0xe0f00000 ipl 4"
+.Ss newsmips
+.Cd "le0 at hb0 addr 0xbff80000 level 1"
+.Ss pmax
+.Cd "le* at ioasic? offset ?"
+.Cd "le* at tc? slot ? offset ?  # PMAD-A LANCE"
+.Cd "le* at ibus0 addr ?"
+.Ss sparc and sparc64
+.Cd "le* at sbus? slot ? offset ?"
+.Cd "le* at ledma0 slot ? offset ?"
+.Cd "le* at lebuffer? slot ? offset ?"
+.Ss sun3
+.Cd "le0 at obio0 addr 0x120000 ipl 3"
 .Cd "options LANCE_REVC_BUG"
+.Ss vax
+.Cd "le0 at vsbus0 csr 0x200e0000"
 .Sh DESCRIPTION
 The 
 .Nm
@@ -57,6 +92,16 @@
 .Tn LANCE
 (Local Area Network Controller - Ethernet) chip set.
 .Pp
+The
+.Nm
+driver also supports PCnet-PCI cards based on the
+.Tn AMD 79c970
+chipset, which is a single-chip implementation of a
+.Tn LANCE 
+chip and
+.Tn PCI
+bus interface.
+.Pp
 Each of the host's network addresses
 is specified at boot time with an
 .Dv SIOCSIFADDR
@@ -68,6 +113,207 @@
 to dynamically map between Internet and
 .Tn Ethernet
 addresses on the local network.
+.Pp
+Selective reception of multicast Ethernet frames is provided
+by a 64-bit mask; multicast destination addresses are hashed to a
+bit entry using the Ethernet CRC function.
+.Pp
+The use of
+.Qq trailer
+encapsulation to minimize copying data on input and output is
+supported by the interface but offers no advantage on systems with
+large page sizes.
+The use of trailers is automatically negotiated with
+.Tn ARP .
+This negotiation may be disabled, on a per-interface basis, with
+.Xr ifconfig 8 .
+.Sh HARDWARE
+.Ss amiga
+The
+.Nm
+interface supports the following Zorro II expansion cards:
+.Bl -tag -width "AMERISTAR" -offset indent
+.It Em A2065
+Commodore's Ethernet card, manufacturer\ 514, product\ 112
+.It Em AMERISTAR
+Ameristar's Ethernet card, manufacturer\ 1053, product\ 1
+.It Em ARIADNE
+Village Tronic's Ethernet card, manufacturer\ 2167, product\ 201
+.El
+.Pp
+The A2065 and Ameristar Ethernet cards supports only manual media selection.
+.Pp
+The Ariadne card supports a software media selection for it's two
+different connectors:
+.Pp
+.Bl -tag -width xxxxxxxxxxxxxx
+.It 10Base2/BNC
+also known as thinwire-Ethernet
+.It 10BaseT/UTP
+also known as twisted pair
+.El
+.Pp
+The Ariadne card uses an autoselect between UTP and BNC, so it uses
+UTP when an active UTP line is connected or otherwise BNC.
+See
+.Xr ifmedia 4
+for media selection options for 
+.Xr ifconfig 8 .
+.Ss ISA
+The ISA-bus Ethernet cards supported by the
+.Nm
+interface are:
+.Pp
+.Bl -tag -width -offset indent -compact
+.It BICC Isolan 
+.It Novell NE2100
+.It Digital DEPCA
+.El
+.Ss pmax
+All
+.Tn LANCE
+interfaces on
+.Tn DECstations
+are supported, as are interfaces on
+.Tn "Alpha AXP"
+machines with a
+.Tn TurboChannel
+bus.
+.Pp
+No support is provided for switching between media ports.
+The
+.Tn DECstation
+3100 provides both AUI and BNC (thinwire or 10base2) connectors.
+Port selection is via a manual switch and is not software configurable.
+.Pp
+The
+.Tn DECstation
+model 5000/200
+.Tn PMAD-AA
+baseboard device provides only a BNC connector.
+.Pp
+The
+.Nm ioasic
+baseboard devices and the 
+.Tn PMAD-AA
+.Tn TurboChannel
+option card provide only an AUI port.
+.Ss sparc
+The
+.Tn Sbus
+.Tn Ethernet
+cards supported by the
+.Nm
+interface include:
+.Bl -tag -width -offset indent -compact
+.It SBE/S
+.Tn SCSI
+and Buffered
+.Tn Ethernet
+(sun part 501-1860)
+.It FSBE/S
+Fast
+.Tn SCSI
+and Buffered
+.Tn Ethernet
+(sun part 501-2015)
+.El
+.Pp
+Interfaces attached to an
+.Sy ledma0
+on SPARC systems typically have have two types of connectors:
+.Pp
+.Bl -tag -offset indent -width xxxxxxxxxxxxxxxxxx
+.It AUI/DIX
+Standard 15 pin connector
+.It 10BaseT
+UTP, also known as twisted pair
+.El
+.Pp
+The appropriate connector can be selected by supplying a
+.Cm media
+parameter to
+.Xr ifconfig 8 .
+The supported arguments for
+.Cm media
+are:
+.Bl -tag -offset indent -width xxxxxxxxxxxxxxxxxx
+.It Sy 10base5/AUI
+to select the AUI connector, or
+.It Sy 10baseT/UTP
+to select the UTP connector.
+.El
+.Pp
+If a
+.Cm media
+parameter is not specified, a default connector is selected for
+use by examining all media types for carrier.
+The first connector on which a carrier is detected will be selected.
+Additionally, if carrier is dropped on a port, the driver will
+switch between the possible ports until one with carrier is found.
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "le%d: overflow"
+More packets came in from the Ethernet than there was space in the
+receive buffers.
+Packets were missed.
+.It "le%d: receive buffer error"
+Ran out of buffer space, packet dropped.
+.It "le%d: lost carrier"
+The Ethernet carrier disappeared during an attempt to transmit.
+It will finish transmitting the current packet,
+but will not automatically retry transmission if there is a collision.
+.It "le%d: excessive collisions, tdr %d"
+Ethernet extremely busy or jammed,
+outbound packets dropped after 16 attempts to retransmit.
+.Pp
+.Sy TDR
+is
+.Qq Time Domain Reflectometry .
+The
+.Tn LANCE
+TDR value is an internal counter of the interval between the start
+of a transmission, and the occurrence of a collision.
+This value can be used to determine the distance from the Ethernet
+tap to the point on the Ethernet cable that is shorted or open
+(unterminated).
+.It "le%d: dropping chained buffer"
+Packet didn't fit into a single receive buffer, packet dropped.
+Since the
+.Nm
+driver allocates buffers large enough to receive the maximum size
+.Tn Ethernet
+packet, this means some other station on the LAN transmitted a
+packet larger than allowed by the
+.Tn Ethernet
+standard.
+.It "le%d: transmit buffer error"
+.Tn LANCE
+ran out of buffer before finishing the transmission of a packet.
+If this error occurrs, the driver software has a bug.
+.It "le%d: underflow"
+.Tn LANCE
+ran out of buffer before finishing the transmission of a packet.
+If this error occurrs, the driver software has a bug.
+.It "le%d: controller failed to initialize"
+Driver failed to start the AM7990
+.Tn LANCE .
+This is potentially a hardware failure.
+.It "le%d: memory error"
+.Tn RAM
+failed to respond within the timeout when the
+.Tn LANCE
+wanted to read or write it.
+This is potentially a hardware failure.
+.It "le%d: receiver disabled"
+The
+.Tn LANCE
+receiver was turned off due to an error.
+.It "le%d: transmitter disabled"
+The
+.Tn LANCE
+transmitter was turned off due to an error.
+.El