Add man page for realtek and rhine ethernet drivers, update the thunderlan

one to current reality.

share/man/man4/Makefile

@@ -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 @@ MAN=	adw.4 ahb.4 ahc.4 aria.4 atalk.4 audio.4 awi.4 bha.4 bpf.4 cardbus.4 \
 	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

share/man/man4/rl.4

@@ -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

share/man/man4/tl.4

@@ -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?"
+.Pp
-.Cd "nsphy* at mii?"
+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 @@ in baseboard variant only (the PCI variant doesn't use the same chip !).
 .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:
+BNC and AUI connectors.  Media selection is done using
-.Pp
+.Xr ifconfig 8
-.Bl -tag -width xxxxxxxxxx -offset indent
+using the standard
-.It AUI/DIX
+.Xr ifmedia 4
-Standard 15 pin connector
+mechanism.  Refer to those manual pages for more information.
-.It 10Base2
-BNC, also known as thin-net
-.It 10BaseT
-UTP, also known as twisted pair
-.It 100baseTX
-100Mbit over cat-5 UTP
-.El
 .Pp
 The
 .Nm 
-driver don't have automatic media selection, and there is no media selected
+driver don't have full automatic media selection. By default it will do an NWay
-by default. An explicit medium must be specified to
+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
+or in your /etc/ifconfig.tl? file.
-.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.
 .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 ifmedia 4 ,
-.Xr pci 4
+.Xr netintro 4 ,
+.Xr pci 4 ,
+.Xr mii 4

share/man/man4/vr.4

@@ -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