xref: /freebsd/share/man/man4/em.4 (revision ee2ea5ceafed78a5bd9810beb9e3ca927180c226)
1.\" Copyright (c) 2002 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.\" * Other names and brands may be claimed as the property of others.
28.\"
29.\" $FreeBSD$
30.Dd April 5, 2002
31.Dt EM 4
32.Os
33.Sh NAME
34.Nm em
35.Nd "Intel(R) PRO/1000 gigabit Ethernet driver for the FreeBSD operating system"
36.Sh SYNOPSIS
37.Cd "device em"
38.Sh DESCRIPTION
39The
40.Nm
41driver provides support for PCI gigabit Ethernet adapters based on
42the Intel 82540, 82542, 82543 and 82544 Ethernet controller chip.
43The driver supports Transmit/Receive checksum offload
44and Jumbo Frames only on 82540, 82543 and 82544-based adapters.
45For a list of supported adapters, see the
46.Pa README
47included with the driver.
48.Pp
49For questions related to hardware requirements,
50refer to the documentation supplied with your Intel PRO/1000 adapter.
51All hardware requirements listed apply to use with
52.Fx .
53.Pp
54Support for Jumbo Frames is provided via the interface MTU setting.
55Selecting an MTU larger than 1500 bytes with the
56.Xr ifconfig 8
57utility configures the adapter to receive and transmit Jumbo Frames.
58The maximum MTU size for Jumbo Frames is 16114.
59.Pp
60The
61.Nm
62driver supports the following media types:
63.Bl -tag -width ".Cm 10baseT/UTP"
64.It Cm autoselect
65Enables auto-negotiation for speed and duplex.
66.It Cm 10baseT/UTP
67Sets 10Mbps operation.
68Use the
69.Cm mediaopt
70option to select
71.Cm full-duplex
72mode.
73.It Cm 100baseTX
74Sets 100Mbps operation.
75Use the
76.Cm mediaopt
77option to select
78.Cm full-duplex
79mode.
80.It Cm 1000baseSX
81Sets 1000Mbps operation.
82Only
83.Cm full-duplex
84mode is supported at this speed.
85.It Cm 1000baseTX
86Sets 1000Mbps operation.
87Only
88.Cm full-duplex
89mode is supported at this speed.
90.El
91.Pp
92The
93.Nm
94driver supports the following media options:
95.Bl -tag -width ".Cm full-duplex"
96.It Cm full-duplex
97Forces full-duplex operation
98.It Cm half-duplex
99Forces half-duplex operation.
100.El
101.Pp
102Only use
103.Cm mediaopt
104to set the driver to
105.Cm full-duplex .
106If
107.Cm mediaopt
108is not specified, the driver defaults to
109.Cm half-duplex .
110.Pp
111For more information on configuring this device, see
112.Xr ifconfig 8 .
113.Sh DIAGNOSTICS
114.Bl -diag
115.It "em%d: Unable to allocate bus resource: memory"
116A fatal initialization error has occurred.
117.It "em%d: Unable to allocate bus resource: interrupt"
118A fatal initialization error has occurred.
119.It "em%d: watchdog timeout -- resetting"
120The device has stopped responding to the network, or there is a problem with
121the network connection (cable).
122.El
123.Sh SUPPORT
124For additional information regarding building and installation,
125see the
126.Pa README
127included with the driver.
128For general information and support,
129go to the Intel support website at:
130.Pa http://support.intel.com.
131.Pp
132If an issue is identified with the released source code on the supported kernel
133with a supported adapter, email the specific information related to the
134issue to
135.Aq freebsdnic@mailbox.intel.com.
136.Sh SEE ALSO
137.Xr arp 4 ,
138.Xr netintro 4 ,
139.Xr vlan 4 ,
140.Xr ng_ether 4 ,
141.Xr ifconfig 8
142.Sh HISTORY
143The
144.Nm
145device driver first appeared in
146.Fx 4.4 .
147.Sh AUTHORS
148The
149.Nm
150driver was written by
151.An Intel Corporation Aq freebsdnic@mailbox.intel.com .
152