xref: /netbsd-src/share/man/man4/wm.4 (revision b7b7574d3bf8eeb51a1fa3977b59142ec6434a55)
1.\"	$NetBSD: wm.4,v 1.29 2013/12/29 21:28:41 msaitoh Exp $
2.\"
3.\" Copyright 2002, 2003 Wasabi Systems, Inc.
4.\" All rights reserved.
5.\"
6.\" Written by Jason R. Thorpe for Wasabi Systems, Inc.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions
10.\" are met:
11.\" 1. Redistributions of source code must retain the above copyright
12.\"    notice, this list of conditions and the following disclaimer.
13.\" 2. Redistributions in binary form must reproduce the above copyright
14.\"    notice, this list of conditions and the following disclaimer in the
15.\"    documentation and/or other materials provided with the distribution.
16.\" 3. All advertising materials mentioning features or use of this software
17.\"    must display the following acknowledgement:
18.\"	This product includes software developed for the NetBSD Project by
19.\"	Wasabi Systems, Inc.
20.\" 4. The name of Wasabi Systems, Inc. may not be used to endorse
21.\"    or promote products derived from this software without specific prior
22.\"    written permission.
23.\"
24.\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
25.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
26.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
28.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34.\" POSSIBILITY OF SUCH DAMAGE.
35.\"
36.Dd December 30, 2013
37.Dt WM 4
38.Os
39.Sh NAME
40.Nm wm
41.Nd Intel i8254x Gigabit Ethernet driver
42.Sh SYNOPSIS
43.Cd "wm* at pci? dev ? function ?"
44.Pp
45Configuration of PHYs may also be necessary.
46See
47.Xr mii 4 .
48.Sh DESCRIPTION
49The
50.Nm
51device driver supports Gigabit Ethernet interfaces based on the Intel
52i8254x family of Gigabit Ethernet chips.
53The interfaces supported by the
54.Nm
55driver include:
56.Bl -bullet
57.It
58Intel i82542 1000BASE-X Ethernet
59.It
60Intel i82543GC 1000BASE-X Ethernet
61.It
62Intel i82543GC 1000BASE-T Ethernet
63.It
64Intel i82544EI 1000BASE-T Ethernet
65.It
66Intel i82544EI 1000BASE-X Ethernet
67.It
68Intel i82544GC 1000BASE-T Ethernet
69.It
70Intel i82544GC (LOM) 1000BASE-T Ethernet
71.It
72Intel i82540EM 1000BASE-T Ethernet
73.It
74Intel i82540EM (LOM) 1000BASE-T Ethernet
75.It
76Intel i82540EP 1000BASE-T Ethernet
77.It
78Intel i82541EI 1000BASE-T Ethernet
79.It
80Intel i82541EI (Mobile) 1000BASE-T Ethernet
81.It
82Intel i82541ER 1000BASE-T Ethernet
83.It
84Intel i82541GI 1000BASE-T Ethernet
85.It
86Intel i82541PI 1000BASE-T Ethernet
87.It
88Intel i82545EM 1000BASE-T Ethernet
89.It
90Intel i82545EM 1000BASE-X Ethernet
91.It
92Intel i82545GB 1000BASE-T Ethernet
93.It
94Intel i82545GB 1000BASE-X Ethernet
95.It
96Intel i82545GM 1000BASE-T Ethernet
97.It
98Intel i82546EB 1000BASE-T Ethernet
99.Pq dual-port
100.It
101Intel i82546EB 1000BASE-X Ethernet
102.Pq dual-port
103.It
104Intel i82546GB 1000BASE-T Ethernet
105.Pq dual-port
106.It
107Intel i82546GB 1000BASE-X Ethernet
108.Pq dual-port
109.It
110Intel i82547EI 1000BASE-T Ethernet
111.Pq CSA
112.It
113Intel i82547GI 1000BASE-T Ethernet
114.Pq CSA
115.It
116Intel i82571 1000BASE-T Ethernet
117.Pq dual-port
118.It
119Intel i82572 1000BASE-T Ethernet
120.It
121Intel i82573 1000BASE-T Ethernet
122.It
123Intel i82575 1000BASE-T Ethernet
124.It
125Intel i82576 Ethernet (Copper, Fiber)
126.It
127Intel i80003 Ethernet (Copper, Fiber)
128.It
129Intel i82801H (ICH8 LAN) 1000BASE-T Ethernet
130.It
131Intel i82801I (ICH9 LAN) 1000BASE-T Ethernet
132.It
133Intel i82801J (ICH10 LAN) 1000BASE-T Ethernet
134.It
135Intel 82578 with Intel 5 series chipset (PCH)
136.It
137Intel 82579 with Intel 6 or 7 series chipset (PCH2)
138.It
139Intel 82580 Ethernet (Copper, Fiber)
140.It
141Intel 82583 1000BASE-T Ethernet
142.It
143Intel I350 Ethernet (Copper, Fiber)
144.It
145Intel I354 (C2000 Internal) Ethernet (Copper, Fiber)
146.It
147Intel I210 Ethernet (Copper, Fiber)
148.It
149Intel I211 Ethernet
150.It
151Intel I217 and I218 Ethernet
152.El
153.Pp
154In addition to Intel's own
155.Dq PRO/1000
156line of Gigabit Ethernet interfaces, these chips also appear on
157some server systems, processor evaluation boards, and in embedded
158systems.
159.Pp
160The i8254x supports IPv4/TCP/UDP checksumming and TCP segmentation
161in hardware.
162The
163.Nm
164driver supports these features of the chip.
165See
166.Xr ifconfig 8
167for information on how to enable this feature.
168.\" .Sh DIAGNOSTICS
169.\" XXX to be done.
170.Sh SEE ALSO
171.Xr arp 4 ,
172.Xr ifmedia 4 ,
173.Xr mii 4 ,
174.Xr netintro 4 ,
175.Xr pci 4 ,
176.Xr ifconfig 8
177.Sh HISTORY
178The
179.Nm
180driver first appeared in
181.Nx 1.6 .
182.Sh AUTHORS
183The
184.Nm
185driver was written by
186.An Jason R. Thorpe Aq Mt thorpej@wasabisystems.com .
187.Sh BUGS
188The Intel i82545GM and i82546GB controllers with internal SERDES are
189not currently supported.
190