xref: /freebsd/share/man/man4/em.4 (revision 9207b4cff7b8d483f4dd3c62266c2b58819eb7f9)
1.\" Copyright (c) 2001 Intel Corporation
2.\" All rights reserved.
3.\" Redistribution and use in source and binary forms of the Software, with or without
4.\" modification, are permitted provided that the following conditions
5.\" are met:
6.\" 1. Redistributions of source code of the Software may retain the above
7.\" copyright notice, this list of conditions and the following disclaimer.
8.\" 2. Redistributions in binary form of the Software may reproduce the
9.\" above copyright notice, this list of conditions and the following
10.\" disclaimer in the documentation and/or other materials provided with the
11.\" distribution.
12.\" 3. Neither the name of the Intel Corporation nor the names of its contributors
13.\" shall be used to endorse or promote products derived from this Software
14.\" without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INTEL OR ITS CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
22.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
23.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
25.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd December 8, 2001
30.Dt EM 4
31.Os
32.Sh NAME
33.Nm em
34.Nd Intel(R) PRO/1000 gigabit ethernet driver for the FreeBSD operating system
35.Sh SYNOPSIS
36.Cd "device em"
37.Sh DESCRIPTION
38The
39.Nm
40driver provides support for PCI gigabit ethernet adapters based on
41the Intel 82542, 82543 and 82544 ethernet controller chip.
42The driver supports Transmit/Receive checksum offload
43and jumbo frames only on 82543 and 82544-based adapters.
44For a list of supported adapters, see the
45.Pa README
46included with the driver.
47.Pp
48For questions related to hardware requirements,
49refer to the documentation supplied with your Intel PRO/1000 adapter.
50All hardware requirements listed apply to use with
51.Fx .
52.Pp
53Support for jumbo frames is provided via the interface MTU setting.
54Selecting an MTU larger than 1500 bytes with the
55.Xr ifconfig 8
56utility configures the adapter to receive and transmit jumbo frames.
57The maximum MTU size for jumbo frames is 9000.
58.Pp
59The
60.Nm
61driver supports the following media types:
62.Bl -tag -width ".Cm 10baseT/UTP"
63.It Cm autoselect
64Enables auto-negotiation for speed and duplex.
65.It Cm 10baseT/UTP
66Sets 10Mbps operation.
67The
68.Cm mediaopt
69option can also be used to select either
70.Cm full-duplex
71or
72.Cm half-duplex
73modes.
74.It Cm 100baseTX
75Sets 100Mbps operation.
76The
77.Cm mediaopt
78option can also be used to select either
79.Cm full-duplex
80or
81.Cm half-duplex
82modes.
83.It Cm 1000baseSX
84Sets 1000Mbps operation.
85Only
86.Cm full-duplex
87mode is supported at this speed.
88.It Cm 1000baseTX
89Sets 1000Mbps operation.
90Only
91.Cm full-duplex
92mode is supported at this speed.
93.El
94.Pp
95The
96.Nm
97driver supports the following media options:
98.Bl -tag -width ".Cm full-duplex"
99.It Cm full-duplex
100Forces full duplex operation
101.It Cm half-duplex
102Forces half duplex operation.
103.El
104.Pp
105For more information on configuring this device, see
106.Xr ifconfig 8 .
107.Sh DIAGNOSTICS
108.Bl -diag
109.It "em%d: Unable to allocate bus resource: memory"
110A fatal initialization error has occurred.
111.It "em%d: Unable to allocate bus resource: interrupt"
112A fatal initialization error has occurred.
113.It "em%d: No memory for jumbo buffers!"
114The driver failed to allocate memory for jumbo frames during
115initialization.
116.It "em%d: watchdog timeout -- resetting"
117The device has stopped responding to the network, or there is a problem with
118the network connection (cable).
119.El
120.Sh SUPPORT
121For additional information regarding building and installation,
122see the
123.Pa README
124included with the driver.
125For general information and support,
126go to the Intel support Website at
127.Pa http://support.intel.com .
128.Pp
129If an issue is identified with the released source code on the supported kernel
130with a supported adapter, email the specific information related to the
131issue to
132.Aq freebsdnic@mailbox.intel.com .
133.Sh SEE ALSO
134.Xr arp 4 ,
135.Xr netintro 4 ,
136.Xr ng_ether 4 ,
137.Xr vlan 4 ,
138.Xr ifconfig 8
139.Sh HISTORY
140The
141.Nm
142device driver first appeared in
143.Fx 4.5 .
144.Sh AUTHORS
145The
146.Nm
147driver was written by
148.An Intel Corporation Aq freebsdnic@mailbox.intel.com .
149