xref: /netbsd-src/share/man/man4/wm.4 (revision b1c86f5f087524e68db12794ee9c3e3da1ab17a0)
1.\"	$NetBSD: wm.4,v 1.20 2009/05/04 20:48:06 wiz 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 August 28, 2007
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 i82546EB 1000BASE-T Ethernet
97.Pq dual-port
98.It
99Intel i82546EB 1000BASE-X Ethernet
100.Pq dual-port
101.It
102Intel i82546GB 1000BASE-T Ethernet
103.Pq dual-port
104.It
105Intel i82546GB 1000BASE-X Ethernet
106.Pq dual-port
107.It
108Intel i82547EI 1000BASE-T Ethernet
109.Pq CSA
110.It
111Intel i82547GI 1000BASE-T Ethernet
112.Pq CSA
113.It
114Intel i82571 1000BASE-T Ethernet
115.Pq dual-port
116.It
117Intel i82572 1000BASE-T Ethernet
118.It
119Intel i82573 1000BASE-T Ethernet
120.It
121Intel i82801H (ICH8 LAN) 1000BASE-T Ethernet
122.It
123Intel i82801I (ICH9 LAN) 1000BASE-T Ethernet
124.It
125Intel i80003 1000BASE-T Ethernet
126.El
127.Pp
128In addition to Intel's own
129.Dq PRO/1000
130line of Gigabit Ethernet interfaces, these chips also appear on
131some server systems, processor evaluation boards, and in embedded
132systems.
133.Pp
134The i8254x supports IPv4/TCP/UDP checksumming and TCP segmentation
135in hardware.
136The
137.Nm
138driver supports these features of the chip.
139See
140.Xr ifconfig 8
141for information on how to enable this feature.
142.\" .Sh DIAGNOSTICS
143.\" XXX to be done.
144.Sh SEE ALSO
145.Xr arp 4 ,
146.Xr ifmedia 4 ,
147.Xr mii 4 ,
148.Xr netintro 4 ,
149.Xr pci 4 ,
150.Xr ifconfig 8
151.Sh HISTORY
152The
153.Nm
154driver first appeared in
155.Nx 1.6 .
156.Sh AUTHORS
157The
158.Nm
159driver was written by
160.An Jason R. Thorpe Aq thorpej@wasabisystems.com .
161.Sh BUGS
162The Intel i82545GM and i82546GB controllers with internal SERDES are
163not currently supported.
164