[src/trunk]: src/share/man/man4 Add man page for realtek and rhine ethernet d...

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

details:   https://anonhg.NetBSD.org/src/rev/e3ba0c53e225
branches:  trunk
changeset: 481840:e3ba0c53e225
user:      bouyer <bouyer%NetBSD.org@localhost>
date:      Mon Feb 07 18:00:10 2000 +0000

description:
Add man page for realtek and rhine ethernet drivers, update the thunderlan
one to current reality.

diffstat:

 share/man/man4/Makefile |   6 ++--
 share/man/man4/rl.4     |  60 ++++++++++++++++++++++++++++++++++++++++++++
 share/man/man4/tl.4     |  52 ++++++++++++++------------------------
 share/man/man4/vr.4     |  66 +++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 148 insertions(+), 36 deletions(-)

diffs (242 lines):

diff -r 06d714f13148 -r e3ba0c53e225 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Mon Feb 07 17:48:52 2000 +0000
+++ b/share/man/man4/Makefile   Mon Feb 07 18:00:10 2000 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.127 2000/02/03 21:04:30 dante Exp $
+#      $NetBSD: Makefile,v 1.128 2000/02/07 18:00:10 bouyer Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   adw.4 ahb.4 ahc.4 aria.4 atalk.4 audio.4 awi.4 bha.4 bpf.4 cardbus.4 \
@@ -9,11 +9,11 @@
        mbe.4 md.4 mhzc.4 midi.4 mii.4 mpu.4 mtio.4 ncr.4 ne.4 netintro.4 \
        ns.4 nsip.4 nsphy.4 ntwoc.4 null.4 opl.4 options.4 pcdisplay.4 \
        pciide.4 pckbc.4 pckbd.4 pcppi.4 pcscp.4 pms.4 ppp.4 \
-       pty.4 puc.4 qsphy.4 raid.4 ray.4 rnd.4 route.4 scsi.4 sd.4 \
+       pty.4 puc.4 qsphy.4 raid.4 ray.4 rl.4 rnd.4 route.4 scsi.4 sd.4 \
        sl.4 sm.4 speaker.4 spp.4 sqphy.4 ss.4 st.4 sv.4 strip.4 \
        tb.4 tcp.4 termios.4 tl.4 tlp.4 tlphy.4 tp.4 tr.4 tty.4 \
        tun.4 tqphy.4 udp.4 uha.4 uk.4 ukphy.4 unix.4 vga.4 \
-       vnd.4 wd.4 wdc.4 wi.4 wscons.4 wsdisplay.4 wskbd.4 \
+       vnd.4 vr.4 wd.4 wdc.4 wi.4 wscons.4 wsdisplay.4 wskbd.4 \
        wsmouse.4 wsmux.4 ym.4 zero.4 zstty.4
 
 # USB devices
diff -r 06d714f13148 -r e3ba0c53e225 share/man/man4/rl.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/rl.4       Mon Feb 07 18:00:10 2000 +0000
@@ -0,0 +1,60 @@
+.\"    $NetBSD: rl.4,v 1.1 2000/02/07 18:00:11 bouyer Exp $
+.\"
+.\" Copyright (c) 2000 Manuel Bouyer
+.\" 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 acknowledgements:
+.\"      This product includes software developed by Manuel Bouyer
+.\" 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 February 6, 2000
+.Dt RL 4
+.Os
+.Sh NAME
+.Nm rl
+.Nd Ethernet driver for RealTek 8129/8139 based ethernet boards
+.Sh SYNOPSIS
+.Cd "rl* at pci? dev ? function ?"
+.Pp
+Configuration of PHYs are necessary.  See
+.Xr mii 4 .
+.Sh DESCRIPTION
+The
+.Nm vr
+device driver supports network adapters based on
+the RealTek 8129/8139 chips.
+.Pp
+.Sh MEDIA SELECTION
+Media selection is done using
+.Xr ifconfig 8
+using the standard
+.Xr ifmedia 4
+mechanism.  Refer to those manual pages for more information.
+.Pp
+.Sh SEE ALSO
+.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr netintro 4 ,
+.Xr pci 4 ,
+.Xr mii 4
diff -r 06d714f13148 -r e3ba0c53e225 share/man/man4/tl.4
--- a/share/man/man4/tl.4       Mon Feb 07 17:48:52 2000 +0000
+++ b/share/man/man4/tl.4       Mon Feb 07 18:00:10 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: tl.4,v 1.9 1999/12/17 16:23:21 abs Exp $
+.\"    $NetBSD: tl.4,v 1.10 2000/02/07 18:00:11 bouyer Exp $
 .\"
 .\" Copyright (c) 1997 Manuel Bouyer
 .\" All rights reserved.
@@ -36,13 +36,14 @@
 .Nd Ethernet driver for Texas Instruments ThunderLAN based board
 .Sh SYNOPSIS
 .Cd "tl* at pci? dev ? function ?"
-.Cd "tlphy* at mii?"
-.Cd "nsphy* at mii?"
+.Pp
+Configuration of PHYs are necessary.  See
+.Xr mii 4 .
 .Sh DESCRIPTION
 The
 .Nm tl
 device driver supports network adapters based on
-the Texas Instruments ThunderLAN chip on i386 CPUs.
+the Texas Instruments ThunderLAN chip.
 .Sh HARDWARE
 Supported cards include:
 .Pp
@@ -56,43 +57,28 @@
 .El
 .Sh MEDIA SELECTION
 The different models of the supported boards come with some subset of RJ-45,
-BNC and AUI connectors.   Supported media include:
-.Pp
-.Bl -tag -width xxxxxxxxxx -offset indent
-.It AUI/DIX
-Standard 15 pin connector
-.It 10Base2
-BNC, also known as thin-net
-.It 10BaseT
-UTP, also known as twisted pair
-.It 100baseTX
-100Mbit over cat-5 UTP
-.El
+BNC and AUI connectors.  Media selection is done using
+.Xr ifconfig 8
+using the standard
+.Xr ifmedia 4
+mechanism.  Refer to those manual pages for more information.
 .Pp
 The
 .Nm 
-driver don't have automatic media selection, and there is no media selected
-by default. An explicit medium must be specified to
+driver don't have full automatic media selection. By default it will do an NWay
+on the UTP port for negotiation of the speed and duplex mode with the
+link partner. If the AUI or BNC port is used, an explicit medium must be
+specified to
 .Xr ifconfig 8
-or in your /etc/ifconfig.tl? file. The media option
-.Em full-duplex
-can be used to switch the UTP port in full-duplex mode.
-.Sh DIAGNOSTICS
-.Dl "tl0: no carrier"
-.Dl "nsphy0: 10baseT: no carrier"
-.in +4
-means that the driver detected a carrier loss. This usually indicates a bad
-link.
+or in your /etc/ifconfig.tl? file.
 .in -4
 .Sh BUGS
 The board marked as untested will always claim having an AUI connector, where
 it may be a BNC one.
 .Pp
-The driver really should have a media autosensing function.
-.Pp
-On AUI and BNC ports, false carrier loss may be detected on heavily-loaded
-networks.
 .Sh SEE ALSO
 .Xr ifconfig 8 ,
-.Xr intro 4 ,
-.Xr pci 4
+.Xr ifmedia 4 ,
+.Xr netintro 4 ,
+.Xr pci 4 ,
+.Xr mii 4
diff -r 06d714f13148 -r e3ba0c53e225 share/man/man4/vr.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/vr.4       Mon Feb 07 18:00:10 2000 +0000
@@ -0,0 +1,66 @@
+.\"    $NetBSD: vr.4,v 1.1 2000/02/07 18:00:12 bouyer Exp $
+.\"
+.\" Copyright (c) 2000 Manuel Bouyer
+.\" 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 acknowledgements:
+.\"      This product includes software developed by Manuel Bouyer
+.\" 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 February 6, 2000
+.Dt VR 4
+.Os
+.Sh NAME
+.Nm vr
+.Nd Ethernet driver for VIA VT3043(Rhine) and VT86C100A(Rhine-II) based
+ethernet boards
+.Sh SYNOPSIS
+.Cd "vr* at pci? dev ? function ?"
+.Pp
+Configuration of PHYs are necessary.  See
+.Xr mii 4 .
+.Sh DESCRIPTION
+The
+.Nm vr
+device driver supports network adapters based on
+the VIA VT3043(Rhine) and VT86C100A(Rhine-II) chips.
+.Sh HARDWARE
+Supported cards include:
+.Pp
+.Bl -tag -width xxxxxx -offset indent
+.It D-Link DFE530TX
+.El
+.Sh MEDIA SELECTION
+Media selection is done using
+.Xr ifconfig 8
+using the standard
+.Xr ifmedia 4
+mechanism.  Refer to those manual pages for more information.
+.Pp
+.Sh SEE ALSO
+.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr netintro 4 ,
+.Xr pci 4 ,
+.Xr mii 4