diff options
Diffstat (limited to 'share/man')
| -rw-r--r-- | share/man/man4/re.4 | 87 | ||||
| -rw-r--r-- | share/man/man4/rgephy.4 | 5 |
2 files changed, 43 insertions, 49 deletions
diff --git a/share/man/man4/re.4 b/share/man/man4/re.4 index 7e187757123..3ee12da5212 100644 --- a/share/man/man4/re.4 +++ b/share/man/man4/re.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: re.4,v 1.1 2004/06/05 06:30:23 pvalchev Exp $ +.\" $OpenBSD: re.4,v 1.2 2004/06/05 15:07:06 miod Exp $ .\" Copyright (c) 2003 .\" Bill Paul <wpaul@windriver.com>. All rights reserved. .\" @@ -72,9 +72,10 @@ cable. NICs based on the 8169, 8169S and 8110S are capable of 10, 100 and 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. +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. @@ -86,42 +87,43 @@ The .Nm driver supports the following media types: .Bl -tag -width 10baseTXUTP -.It Cm autoselect +.It 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 +The user can manually override the autoselected mode by adding media options +to the appropriate +.Xr hostname.if 5 +file. +.It 10baseT/UTP Set 10Mbps operation. The .Xr ifconfig 8 .Ic mediaopt option can also be used to select either -.Cm full-duplex +.Ar full-duplex or -.Cm half-duplex +.Ar half-duplex modes. -.It Cm 100baseTX +.It 100baseTX Set 100Mbps (fast ethernet) operation. The .Xr ifconfig 8 .Ic mediaopt option can also be used to select either -.Cm full-duplex +.Ar full-duplex or -.Cm half-duplex +.Ar half-duplex modes. -.It Cm 1000baseTX +.It 1000baseTX Set 1000baseTX operation over twisted pair. The RealTek gigE chips support 1000Mbps in -.Cm full-duplex +.Ar full-duplex mode only. -.\" .It Cm 1000baseSX +.\" .It 1000baseSX .\" Set 1000Mbps (gigabit ethernet) operation. .\" Both -.\" .Cm full-duplex +.\" .Ar full-duplex .\" and -.\" .Cm half-duplex +.\" .Ar half-duplex .\" modes are supported. .El .Pp @@ -129,9 +131,9 @@ The .Nm driver supports the following media options: .Bl -tag -width full-duplex -.It Cm full-duplex +.It full-duplex Force full duplex operation. -.It Cm half-duplex +.It half-duplex Force half duplex operation. .El .Pp @@ -139,33 +141,23 @@ For more information on configuring this device, see .Xr ifconfig 8 . .Sh DIAGNOSTICS .Bl -diag -.It "re%d: couldn't map memory" +.It "re%d: can't map mem space" A fatal initialization error has occurred. -.It "re%d: couldn't map ports" +.It "re%d: can't map i/o space" 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 rgephy 4 , .Xr ifmedia 4 , .Xr intro 4 , .Xr netintro 4 , .Xr pci 4 , +.Xr rgephy 4 , .Xr vlan 4 , .Xr hostname.if 5 , .Xr ifconfig 8 @@ -190,23 +182,26 @@ by .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. +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 +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. +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. diff --git a/share/man/man4/rgephy.4 b/share/man/man4/rgephy.4 index 508b3ecedd4..e0ebce13c31 100644 --- a/share/man/man4/rgephy.4 +++ b/share/man/man4/rgephy.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rgephy.4,v 1.1 2004/06/05 06:39:51 pvalchev Exp $ +.\" $OpenBSD: rgephy.4,v 1.2 2004/06/05 15:07:06 miod Exp $ .\" .\" Copyright (c) 2004 Peter Valchev <pvalchev@openbsd.org> .\" @@ -26,8 +26,7 @@ The .Nm driver supports the internal PHY found on Realtek 8169S/8110S -devices (see -.Xr re 4 ) . +Ethernet adapters. .Sh SEE ALSO .Xr ifmedia 4 , .Xr intro 4 , |