xref: /openbsd-src/share/man/man4/em.4 (revision d13be5d47e4149db2549a9828e244d59dbc43f15)
1.\" $OpenBSD: em.4,v 1.45 2009/12/13 21:55:39 sthen Exp $
2.\" Copyright (c) 2002 Intel Corporation
3.\" All rights reserved.
4.\" Redistribution and use in source and binary forms of the Software, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code of the Software may retain the above
8.\" copyright notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form of the Software may reproduce the
10.\" above copyright notice, this list of conditions and the following
11.\" disclaimer in the documentation and/or other materials provided with the
12.\" distribution.
13.\" 3. Neither the name of the Intel Corporation nor the names of its contributors
14.\" shall be used to endorse or promote products derived from this Software
15.\" without specific prior written permission.
16.\"
17.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INTEL OR ITS CONTRIBUTORS BE LIABLE
21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
23.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
24.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
26.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27.\"
28.\" * Other names and brands may be claimed as the property of others.
29.\"
30.\" $FreeBSD: em.4,v 1.18 2005/01/30 12:29:06 yar Exp $
31.Dd $Mdocdate: December 13 2009 $
32.Dt EM 4
33.Os
34.Sh NAME
35.Nm em
36.Nd Intel PRO/1000 10/100/Gigabit Ethernet device
37.Sh SYNOPSIS
38.Cd "em* at pci?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for PCI, PCI-X and PCI Express Gigabit Ethernet adapters
43based on the Intel 82540EM, 82540EP, 82541EI, 82541ER, 82541GI, 82541PI, 82542,
4482543GC, 82544EI, 82544GC, 82545EM, 82545GM, 82546EB, 82546GB, 82547EI, 82547GI,
4582562V, 82563EB, 82564EB, 82566DC, 82566DM, 82571EB, 82571GB, 82572EI, 82572GI,
4682573E, 82573L, 82573V, 82574L, 82575EB, 82575GB, 82576EB Ethernet controller
47chips and the embedded chips found on EP80579 platform, including the following:
48.Pp
49.Bl -item -offset indent -compact
50.It
51Axiomtek NA-200 EP80579 based board
52.It
53HP ProLiant NC110T PCI Express Gigabit NIC
54.It
55HP ProLiant NC112T PCI Express Gigabit NIC
56.It
57HP ProLiant NC310F PCI-X Gigabit NIC (SX Fiber)
58.It
59HP ProLiant NC340T PCI-X Quad Port Gigabit NIC
60.It
61HP ProLiant NC360T PCI Express Dual Port Gigabit NIC
62.It
63HP ProLiant NC364T PCI Express Quad Port Gigabit NIC
64.It
65HP ProLiant NC6132 Upgrade Module (SX Fiber)
66.It
67HP ProLiant NC6133 Upgrade Module (LX Fiber)
68.It
69HP ProLiant NC6134 PCI Gigabit NIC (SX Fiber)
70.It
71HP ProLiant NC6136 PCI Gigabit NIC (SX Fiber)
72.It
73HP ProLiant NC6170 PCI-X Gigabit NIC (SX Fiber)
74.It
75HP ProLiant NC7131 PCI Gigabit NIC
76.It
77HP ProLiant NC7132 Upgrade Module
78.It
79HP ProLiant NC7170 PCI-X Dual Port Gigabit NIC
80.It
81HP ProLiant NC7170LP PCI-X Dual Port Gigabit NIC
82.It
83Intel PRO/1000 Gigabit Server Adapter (SX Fiber) (PWLA8490)
84.It
85Intel PRO/1000F Gigabit Server Adapter (SX Fiber) (PWLA8490SX)
86.It
87Intel PRO/1000T Server Adapter (PWLA8490T)
88.It
89Intel PRO/1000XT Server Adapter (PWLA8490XT)
90.It
91Intel PRO/1000XS Server Adapter (SX Fiber) (PWLA8490XF)
92.It
93Intel PRO/1000T Desktop Adapter (PWLA8390T)
94.It
95Intel PRO/1000XTL Low Profile PCI Server (PWLA8490XTL)
96.It
97Intel PRO/1000MT Desktop Adapter (PWLA8390MT)
98.It
99Intel PRO/1000MT Server Adapter (PWLA8490MT)
100.It
101Intel PRO/1000MT Dual Port Server Adapter (PWLA8492MT)
102.It
103Intel PRO/1000MF Server Adapter (SX Fiber) (PWLA8490MF)
104.It
105Intel PRO/1000MF Dual Port Server Adapter (SX Fiber) (PWLA8492MF)
106.It
107Intel PRO/1000MF Server Adapter (LX Fiber) (PWLA8490LX)
108.It
109Intel PRO/1000MT Quad PCI-X Adapter (PWLA8494MT)
110.It
111Intel PRO/1000GT Quad PCI-X Adapter (PWLA8494GT)
112.It
113Intel PRO/1000PT Desktop Adapter
114.It
115Intel PRO/1000PT Server Adapter
116.It
117Intel PRO/1000PT Dual Port Server Adapter
118.It
119Intel PRO/1000PT Quad Port Server Adapter
120.It
121Intel PRO/1000PF Server Adapter (SX Fiber)
122.It
123Intel PRO/1000PF Dual Port Server Adapter (SX Fiber)
124.It
125Intel PRO/1000ET Dual Port Server Adapter
126.It
127Intel PRO/1000ET Quad Port Server Adapter
128.It
129Intel PRO/1000EF Quad Port Server Adapter (SX Fiber)
130.It
131Sun PCI-E Dual Gigabit Ethernet LP UTP Adapter
132.It
133Sun PCI-E Dual Gigabit Ethernet LP MMF Adapter
134.It
135Sun PCI-E Dual Gigabit Ethernet EM UTP Adapter
136.It
137Sun PCI-E Dual Gigabit Ethernet EM MMF Adapter
138.It
139Sun PCI-E Dual Gigabit Ethernet ExpressModule
140.It
141Sun x4 PCI-E Quad Gigabit Ethernet LP UTP Adapter
142.It
143Sun x4 PCI-E Quad Gigabit Ethernet ExpressModule
144.It
145Sun x8 PCI-E Quad Gigabit Ethernet ExpressModule
146.It
147Supermicro AOC-SG-i2 Dual Port Server Adapter
148.It
149Supermicro AOC-PG-I2+ Dual Port Server Adapter
150.El
151.Pp
152The
153.Nm
154driver supports IPv4 receive IP/TCP/UDP checksum offload on all but
15582542-based adapters, VLAN tag insertion and stripping, and Jumbo
156frames on all but 82562V, 82566DC/82566DM and 82573E/82573L/82573V-based
157adapters.
158The 82562V Ethernet controller chip only supports 10/100 media types.
159.Pp
160The
161.Nm
162driver supports the following media types:
163.Bl -tag -width autoselect -offset indent
164.It autoselect
165Enables auto-negotiation for speed and duplex.
166.It 10baseT Cm mediaopt No full-duplex
167Sets 10Mbps operation.
168.It 100baseTX Cm mediaopt No full-duplex
169Sets 100Mbps operation.
170.It 1000baseLX
171Sets 1000Mbps operation.
172Only full-duplex mode is supported at this speed.
173.It 1000baseSX
174Sets 1000Mbps operation.
175Only full-duplex mode is supported at this speed.
176.It 1000baseT
177Sets 1000Mbps operation.
178Only full-duplex mode is supported at this speed.
179.El
180.Pp
181For more information on configuring this device, see
182.Xr ifconfig 8 .
183.Sh SEE ALSO
184.Xr arp 4 ,
185.Xr gcu 4 ,
186.Xr ifmedia 4 ,
187.Xr intro 4 ,
188.Xr netintro 4 ,
189.Xr pci 4 ,
190.Xr hostname.if 5 ,
191.Xr ifconfig 8
192.Sh HISTORY
193The
194.Nm
195device driver first appeared in
196.Ox 3.2 .
197.Sh AUTHORS
198The
199.Nm
200driver was written by
201.An Intel Corporation .
202.Sh BUGS
203There are known performance issues with this driver when running UDP traffic
204with Jumbo frames.
205.Pp
206There is a known compatibility issue where time to link is slow or link is not
207established between 82541/82547 controllers and some switches.
208Known switches include:
209.Pp
210.Bl -item -offset indent -compact
211.It
212I-O Data ETG-SH8
213.It
214Planex FXG-08TE
215.El
216