add msk(4), tweak sk(4) and pci(4) accordingly

okay kettenis@, from brad@

1 files changed, 81 insertions, 99 deletions

diff --git a/share/man/man4/sk.4 b/share/man/man4/sk.4
index 1db94d4291d..de74cd360e3 100644
--- a/share/man/man4/sk.4
+++ b/share/man/man4/sk.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sk.4,v 1.47 2006/12/12 20:51:15 mk Exp $
+.\"	$OpenBSD: sk.4,v 1.48 2006/12/12 23:54:44 pedro Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\"	Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
@@ -38,20 +38,16 @@
 .Sh NAME
 .Nm sk ,
 .Nm skc ,
-.Nm msk ,
-.Nm mskc
 .Nd "SysKonnect XMAC II and Marvell Yukon based Gigabit Ethernet device"
 .Sh SYNOPSIS
 .Cd "skc* at pci?"
 .Cd "sk* at skc?"
-.Cd "mskc* at pci?"
-.Cd "msk* at mskc?"
 .Cd "brgphy* at mii?"
 .Cd "eephy* at mii?"
 .Cd "xmphy* at mii?"
 .Sh DESCRIPTION
 The
-.Nm sk
+.Nm
 driver provides support for SysKonnect based Gigabit Ethernet adapters
 and Marvell based Gigabit Ethernet adapters, including the following:
 .Pp
@@ -71,67 +67,27 @@ Linksys EG1032v2, copper adapter
 .It
 Linksys EG1064v2, copper adapter
 .It
-SK-9821 SK-NET GE-T single port, copper adapter
+SysKonnect SK-9821 single port, copper adapter
 .It
-SK-9822 SK-NET GE-T dual port, copper adapter
+SysKonnect SK-9822 dual port, copper adapter
 .It
-SK-9841 SK-NET GE-LX single port, single mode fiber adapter
+SysKonnect SK-9841 single port, single mode fiber adapter
 .It
-SK-9842 SK-NET GE-LX dual port, single mode fiber adapter
+SysKonnect SK-9842 dual port, single mode fiber adapter
 .It
-SK-9843 SK-NET GE-SX single port, multimode fiber adapter
+SysKonnect SK-9843 single port, multimode fiber adapter
 .It
-SK-9844 SK-NET GE-SX dual port, multimode fiber adapter
+SysKonnect SK-9844 dual port, multimode fiber adapter
 .It
-SK-9521 V2.0 single port, copper adapter (32-bit)
+SysKonnect SK-9521 V2.0 single port, copper adapter
 .It
-SK-9821 V2.0 single port, copper adapter
+SysKonnect SK-9821 V2.0 single port, copper adapter
 .It
-SK-9843 V2.0 single port, copper adapter
+SysKonnect SK-9843 V2.0 single port, copper adapter
 .It
 SMC 9452TX, copper adapter
 .El
 .Pp
-The
-.Nm msk
-driver provides support for the Marvell Yukon-2 based Gigabit Ethernet
-adapters, including the following:
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-D-Link DGE-550SX, multimode fiber adapter
-.It
-D-Link DGE-560SX, multimode fiber adapter
-.It
-D-Link DGE-560T, copper adapter
-.It
-SK-9E21 1000Base-T single port, copper adapter
-.It
-SK-9E22 1000Base-T dual port, copper adapter
-.It
-SK-9E81 1000Base-SX single port, multimode fiber adapter
-.It
-SK-9E82 1000Base-SX dual port, multimode fiber adapter
-.It
-SK-9E91 1000Base-LX single port, single mode fiber adapter
-.It
-SK-9E92 1000Base-LX dual port, single mode fiber adapter
-.It
-SK-9S21 1000Base-T single port, copper adapter
-.It
-SK-9S22 1000Base-T dual port, copper adapter
-.It
-SK-9S81 1000Base-SX single port, multimode fiber adapter
-.It
-SK-9S82 1000Base-SX dual port, multimode fiber adapter
-.It
-SK-9S91 1000Base-LX single port, single mode fiber adapter
-.It
-SK-9S92 1000Base-LX dual port, single mode fiber adapter
-.It
-SK-9E21D 1000Base-T single port, copper adapter
-.El
-.Pp
 The SysKonnect based adapters consist of two main components: the
 XaQti Corp.\&
 XMAC II Gigabit MAC (sk) and the SysKonnect GEnesis controller ASIC (skc).
@@ -144,15 +100,6 @@ allowing dual-port NIC configurations.
 The Marvell based adapters are a single integrated circuit, but are
 still presented as a separate MAC (sk) and controller ASIC (skc).
 .Pp
-The
-.Nm
-driver configures dual port SysKonnect adapters such that each XMAC
-is treated as a separate logical network interface.
-Both ports can operate independently of each other and can be connected
-to separate networks.
-.Pp
-The XaQti XMAC II supports full and half duplex operation with
-autonegotiation.
 The XMAC also supports a frame size of up to 9000 bytes.
 Support for Jumbo frames is provided via the interface MTU setting.
 Selecting an MTU larger than 1500 bytes with the
@@ -163,22 +110,81 @@ such as file transfers and data streaming.
 .Pp
 Hardware receive IP checksum offload for IPv4 is supported.
 .Pp
-The following media types and options (as given to
-.Xr ifconfig 8 )
-are supported:
-.Bl -tag -width xxx -offset indent
-.It Cm media No autoselect
+The
+.Nm
+driver supports the following media types:
+.Bl -tag -width 1000baseSX
+.It Cm autoselect
 Enable autoselection of the media type and options.
 The user can manually override
 the autoselected mode by adding media options to the appropriate
 .Xr hostname.if 5
 file.
-.It Cm media No 1000baseSX Cm mediaopt No full-duplex
-Set 1000Mbps (Gigabit Ethernet) operation on fiber and force full-duplex mode.
-.It Cm media No 1000baseSX Cm mediaopt No half-duplex
-Set 1000Mbps (Gigabit Ethernet) operation on fiber and force half-duplex mode.
-.It Cm media No 1000baseT Cm mediaopt No full-duplex
-Set 1000Mbps (Gigabit Ethernet) operation and force full-duplex mode.
+.It Cm 10baseT
+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 1000baseT
+Set 1000baseT (Gigabit Ethernet) operation over twisted pair.
+Both
+.Cm full-duplex
+and
+.Cm half-duplex
+modes are supported.
+.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
+The
+.Nm
+driver also supports one special link option for 1000baseT cards:
+.Bl -tag -width link0
+.It Cm link0
+With 1000baseT cards, establishing a link between two ports requires
+that one port be configured as a master and the other a slave.
+With autonegotiation,
+the master/slave settings will be chosen automatically.
+However when manually selecting the link state, it is necessary to
+force one side of the link to be a master and the other a slave.
+The
+.Nm
+driver configures the ports as slaves by default.
+Setting the
+.Cm link0
+flag with
+.Xr ifconfig 8
+will set a port as a master instead.
 .El
 .Pp
 For more information on configuring this device, see
@@ -187,19 +193,6 @@ To view a list of media types and options supported by the card, try
 .Ic ifconfig -m <device> .
 For example,
 .Ic ifconfig -m sk0 .
-.Sh DIAGNOSTICS
-.Bl -diag
-.It "sk%d: can't map mem space"
-A fatal initialization error has occurred.
-.It "sk%d: couldn't map interrupt"
-A fatal initialization error has occurred.
-.It "sk%d: no memory for jumbo buffer queue!"
-The driver failed to allocate memory for jumbo frames during
-initialization.
-.It "sk%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 brgphy 4 ,
@@ -228,20 +221,9 @@ and
 .Ox
 support was added in
 .Ox 2.6 .
-.Pp
-The
-.Nm msk
-driver first appeared in
-.Ox 4.0 .
 .Sh AUTHORS
 .An -nosplit
 The
 .Nm
 driver was written by
 .An Bill Paul Aq wpaul@ctr.columbia.edu .
-Support for the Marvell Yukon-2 was added by
-.An Mark Kettenis Aq kettenis@openbsd.org .
-.Sh BUGS
-The
-.Nm msk
-driver does not support hardware receive IP checksum offload yet.