xref: /openbsd-src/share/man/man4/msk.4 (revision 2b0358df1d88d06ef4139321dd05bd5e05d91eaf)
1.\"	$OpenBSD: msk.4,v 1.11 2009/03/22 22:08:34 kettenis Exp $
2.\"
3.\" Copyright (c) 1997, 1998, 1999
4.\"	Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Bill Paul.
17.\" 4. Neither the name of the author nor the names of any co-contributors
18.\"    may be used to endorse or promote products derived from this software
19.\"   without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31.\" THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\" $FreeBSD: src/share/man/man4/man4.i386/sk.4,v 1.3 1999/08/28 00:20:29 peter Exp $
34.\"
35.Dd $Mdocdate: March 22 2009 $
36.Dt MSK 4
37.Os
38.Sh NAME
39.Nm msk ,
40.Nm mskc
41.Nd "Marvell Yukon-2 10/100/Gigabit Ethernet device"
42.Sh SYNOPSIS
43.Cd "mskc* at pci?"
44.Cd "msk* at mskc?"
45.Cd "eephy* at mii?"
46.Sh DESCRIPTION
47The
48.Nm
49driver provides support for Marvell Yukon-2 88E802x, 88E805x, 88E806x,
50and 88E807x based Gigabit Ethernet adapters and 88E803x/88E804x based
51Fast Ethernet adapters, including the following:
52.Pp
53.Bl -bullet -offset indent -compact
54.It
55D-Link DGE-550SX, multimode fiber adapter
56.It
57D-Link DGE-560SX, multimode fiber adapter
58.It
59D-Link DGE-550T B1, copper adapter
60.It
61D-Link DGE-560T, copper adapter
62.It
63SysKonnect SK-9E21 single port, copper adapter
64.It
65SysKonnect SK-9E22 dual port, copper adapter
66.It
67SysKonnect SK-9E81 single port, multimode fiber adapter
68.It
69SysKonnect SK-9E82 dual port, multimode fiber adapter
70.It
71SysKonnect SK-9E91 single port, single mode fiber adapter
72.It
73SysKonnect SK-9E92 dual port, single mode fiber adapter
74.It
75SysKonnect SK-9S21 single port, copper adapter
76.It
77SysKonnect SK-9S22 dual port, copper adapter
78.It
79SysKonnect SK-9S81 single port, multimode fiber adapter
80.It
81SysKonnect SK-9S82 dual port, multimode fiber adapter
82.It
83SysKonnect SK-9S91 single port, single mode fiber adapter
84.It
85SysKonnect SK-9S92 dual port, single mode fiber adapter
86.It
87SysKonnect SK-9E21D single port, copper adapter
88.El
89.Pp
90The Yukon-2 88E802x, 88E805x, 88E806x, and 88E807x also support a
91frame size of up to 9000 bytes.
92Support for Jumbo frames is provided via the interface MTU setting.
93Selecting an MTU larger than 1500 bytes with the
94.Xr ifconfig 8
95utility configures the adapter to transmit Jumbo frames.
96Using Jumbo frames can greatly improve performance for certain tasks,
97such as file transfers and data streaming.
98.Pp
99The
100.Nm
101driver supports the following media types:
102.Bl -tag -width 1000baseSX
103.It Cm autoselect
104Enable autoselection of the media type and options.
105The user can manually override
106the autoselected mode by adding media options to the appropriate
107.Xr hostname.if 5
108file.
109.It Cm 10baseT
110Set 10Mbps operation.
111The
112.Xr ifconfig 8
113.Ic mediaopt
114option can also be used to select either
115.Cm full-duplex
116or
117.Cm half-duplex
118modes.
119.It Cm 100baseTX
120Set 100Mbps (Fast Ethernet) operation.
121The
122.Xr ifconfig 8
123.Ic mediaopt
124option can also be used to select either
125.Cm full-duplex
126or
127.Cm half-duplex
128modes.
129.It Cm 1000baseT
130Set 1000baseT (Gigabit Ethernet) operation over twisted pair.
131Both
132.Cm full-duplex
133and
134.Cm half-duplex
135modes are supported.
136.It Cm 1000baseSX
137Set 1000Mbps (Gigabit Ethernet) operation.
138Both
139.Cm full-duplex
140and
141.Cm half-duplex
142modes are supported.
143.El
144.Pp
145The
146.Nm
147driver supports the following media options:
148.Bl -tag -width full-duplex
149.It Cm full-duplex
150Force full duplex operation.
151.It Cm half-duplex
152Force half duplex operation.
153.El
154.Pp
155For more information on configuring this device, see
156.Xr ifconfig 8 .
157To view a list of media types and options supported by the card, try
158.Ic ifconfig <device> media .
159For example,
160.Ic ifconfig msk0 media .
161.Sh SEE ALSO
162.Xr arp 4 ,
163.Xr eephy 4 ,
164.Xr ifmedia 4 ,
165.Xr intro 4 ,
166.Xr netintro 4 ,
167.Xr pci 4 ,
168.Xr hostname.if 5 ,
169.Xr ifconfig 8
170.Sh HISTORY
171The
172.Nm
173driver first appeared in
174.Ox 4.0 .
175.Sh AUTHORS
176.An -nosplit
177The
178.Nm
179driver was written by
180.An Mark Kettenis Aq kettenis@openbsd.org .
181.Sh BUGS
182The
183.Nm
184driver does not support hardware receive IP checksum offload yet.
185