From 21d3bfd023c0462b6aeb176c0093b82f3267cbd7 Mon Sep 17 00:00:00 2001 From: toshii Date: Mon, 31 May 2004 13:46:29 +0000 Subject: [PATCH] Add re(4) manpage, from FreeBSD. --- share/man/man4/Makefile | 4 +- share/man/man4/re.4 | 206 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 208 insertions(+), 2 deletions(-) create mode 100644 share/man/man4/re.4 diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 257e6e1f333b..dda3482c77ca 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.322 2004/05/25 00:18:13 tsarna Exp $ +# $NetBSD: Makefile,v 1.323 2004/05/31 13:46:29 toshii Exp $ # @(#)Makefile 8.1 (Berkeley) 6/18/93 MAN= aac.4 acardide.4 aceride.4 acphy.4 adc.4 adv.4 \ @@ -30,7 +30,7 @@ MAN= aac.4 acardide.4 aceride.4 acphy.4 adc.4 adv.4 \ pdcide.4 piixide.4 pckbc.4 pckbd.4 pcn.4 \ pcppi.4 pcscp.4 pcweasel.4 plip.4 pms.4 pnaphy.4 ppbus.4 ppp.4 \ pppoe.4 pty.4 puc.4 px.4 pxg.4 qe.4 qec.4 qsphy.4 \ - raid.4 ray.4 rcons.4 rnd.4 route.4 rtk.4 satalink.4 \ + raid.4 ray.4 rcons.4 re.4 rnd.4 route.4 rtk.4 satalink.4 \ sbus.4 scc.4 scsi.4 sd.4 se.4 ses.4 sf.4 sfb.4 shb.4 \ siop.4 sip.4 siside.4 sk.4 sl.4 slide.4 \ stpcide.4 sm.4 spc.4 speaker.4 spp.4 sqphy.4 \ diff --git a/share/man/man4/re.4 b/share/man/man4/re.4 new file mode 100644 index 000000000000..40e7edf243a8 --- /dev/null +++ b/share/man/man4/re.4 @@ -0,0 +1,206 @@ +.\" $NetBSD: re.4,v 1.1 2004/05/31 13:46:29 toshii Exp $ +.\" +.\" Copyright (c) 2003 +.\" Bill Paul . 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 Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD +.\" 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. +.\" +.\" $FreeBSD: src/share/man/man4/re.4,v 1.4 2004/03/04 06:42:46 sanpei Exp $ +.\" +.Dd September 4, 2003 +.Dt RE 4 +.Os +.Sh NAME +.Nm re +.Nd "RealTek 8139C+/8169/8169S/8110S PCI ethernet adapter driver" +.Sh SYNOPSIS +.Cd "re* at pci? dev ? function ?" +.Sh DESCRIPTION +The +.Nm +driver provides support for various NICs based on the RealTek RTL8139C+, +RTL8169, RTL8169S and RTL8110S PCI ethernet controllers, including +the following: +.Pp +.Bl -bullet -compact +.It +Alloy Computer Products EtherGOLD 1439E 10/100 (8139C+) +.It +Compaq Evo N1015v Integrated Ethernet (8139C+) +.It +Gigabyte 7N400 Pro2 Integrated Gigabit Ethernet (8110S) +.It +PLANEX COMMUNICATIONS Inc. GN-1200TC (8169S) +.It +Xterasys XN-152 10/100/1000 NIC (8169) +.El +.Pp +NICs based on the 8139C+ are capable of 10 and 100Mbps speeds over CAT5 +cable. NICs based on the 8169, 8169S and 8110S are capable of 10, 100 and +1000Mbps operation. +.Pp +All NICs supported by the +.Nm +driver have TCP/IP checksum offload and hardware VLAN tagging/insertion +features, and use a descriptor-based DMA mechanism. They are also +capable of TCP large send (TCP segmentation offload). +.Pp +The 8139C+ is a single-chip solution combining both a 10/100 MAC and PHY. +The 8169 is a 10/100/1000 MAC only, requiring a GMII or TBI external PHY. +The 8169S and 8110S are single-chip devices containing both a 10/100/1000 +MAC and 10/100/1000 copper PHY. Standalone 10/100/1000 cards are available +in both 32-bit PCI and 64-bit PCI models. The 8110S is designed for +embedded LAN-on-motherboard applications. +.Pp +The 8169, 8169S and 8110S also support jumbo frames, which can be configured +via the interface MTU setting. +Selecting an MTU larger than 1500 bytes with the +.Xr ifconfig 8 +utility configures the adapter to receive and transmit jumbo frames. +.Pp +The +.Nm +driver supports the following media types: +.Bl -tag -width 10baseTXUTP +.It Cm autoselect +Enable autoselection of the media type and options. +The user can manually override +the autoselected mode by adding media options to +.Xr rc.conf 5 . +.It Cm 10baseT/UTP +Set 10Mbps operation. +The +.Xr ifconfig 8 +.Ic mediaopt +option can also be used to select either +.Cm full-duplex +or +.Cm half-duplex +modes. +.It Cm 100baseTX +Set 100Mbps (fast ethernet) operation. +The +.Xr ifconfig 8 +.Ic mediaopt +option can also be used to select either +.Cm full-duplex +or +.Cm half-duplex +modes. +.It Cm 1000baseTX +Set 1000baseTX operation over twisted pair. +The RealTek gigE chips support 1000Mbps in +.Cm full-duplex +mode only. +.\" .It Cm 1000baseSX +.\" Set 1000Mbps (gigabit ethernet) operation. +.\" Both +.\" .Cm full-duplex +.\" and +.\" .Cm half-duplex +.\" modes are supported. +.El +.Pp +The +.Nm +driver supports the following media options: +.Bl -tag -width full-duplex +.It Cm full-duplex +Force full duplex operation. +.It Cm half-duplex +Force half duplex operation. +.El +.Pp +For more information on configuring this device, see +.Xr ifconfig 8 . +.Sh DIAGNOSTICS +.Bl -diag +.It "re%d: couldn't map memory" +A fatal initialization error has occurred. +.It "re%d: couldn't map ports" +A fatal initialization error has occurred. +.It "re%d: couldn't map interrupt" +A fatal initialization error has occurred. +.It "re%d: no memory for softc struct!" +The driver failed to allocate memory for per-device instance information +during initialization. +.It "re%d: failed to enable memory mapping!" +The driver failed to initialize PCI shared memory mapping. +This might +happen if the card is not in a bus-master slot. +.It "re%d: no memory for jumbo buffers!" +The driver failed to allocate memory for jumbo frames during +initialization. +.It "re%d: watchdog timeout" +The device has stopped responding to the network, or there is a problem with +the network connection (cable). +.El +.Sh SEE ALSO +.Xr arp 4 , +.Xr mii 4 , +.Xr netintro 4 , +.Xr pci 4 , +.Xr ifconfig 8 +.Rs +.%T RealTek Semiconductor RTL8139C+, RTL8169, RTL8169S and RTL8110S datasheets +.%O http://www.realtek.com.tw +.Re +.Sh HISTORY +The +.Nm +device driver first appeared in +.Fx 5.2 , and in +.Nx 3.0 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Bill Paul Aq wpaul@windriver.com . +.Sh BUGS +The Xterasys XN-152 32-bit PCI NIC, which uses the RTL8169 MAC and +Marvell 88E1000 PHY, has a defect that causes DMA corruption +if the board is plugged into a 64-bit PCI slot. The defect +lies in the board design, not the chip itself: the PCI REQ64# and ACK64# +lines should be pulled high, but they are not. The result is that the +8169 chip is tricked into performing 64-bit DMA transfers even though +a 64-bit data path between the NIC and the bus does not actually exist. +.Pp +Unfortunately, it is not possible to correct this problem in software, +however it is possible to detect it. When the +.Nm +driver is loaded, it will run a diagnostic routine designed to +validate DMA operation by placing the chip in digital loopback mode +and initiating a packet transmission. If the card functions properly, +the transmitted data will +be echoed back unmodified. If the echoed data is corrupt, the driver +will print an error message on the console and abort the device attach. The +user should insure the NIC is installed in a 32-bit PCI slot to +avoid this problem. +.Pp +The RealTek 8169, 8169S and 8110S chips appear to only be capable of +transmitting jumbo frames up to 7.5K in size.