aboutsummaryrefslogtreecommitdiff
path: root/share/man/man4/re.4
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man4/re.4')
-rw-r--r--share/man/man4/re.432
1 files changed, 21 insertions, 11 deletions
diff --git a/share/man/man4/re.4 b/share/man/man4/re.4
index 2aab010c554d..f1632730b1c4 100644
--- a/share/man/man4/re.4
+++ b/share/man/man4/re.4
@@ -54,26 +54,30 @@ Compaq Evo N1015v Integrated Ethernet (8139C+)
.It
Gigabyte 7N400 Pro2 Integrated Gigabit Ethernet (8110S)
.It
-PLANEX COMMUNICATIONS Inc. GN-1200TC (8169S)
+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
+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
+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
+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
@@ -183,21 +187,27 @@ driver was written 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
+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
+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,
+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
+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