2 .\" Copyright (c) 2007 The DragonFly Project. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in
12 .\" the documentation and/or other materials provided with the
14 .\" 3. Neither the name of The DragonFly Project nor the names of its
15 .\" contributors may be used to endorse or promote products derived
16 .\" from this software without specific, prior written permission.
18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 .Nd "Agere ET1310 10/100/Gigabit Ethernet driver"
40 To compile this driver into the kernel,
41 place the following lines in your
42 kernel configuration file:
43 .Bd -ragged -offset indent
48 Alternatively, to load the driver as a
49 module at boot time, place the following line in
51 .Bd -literal -offset indent
57 driver supports PCI Express Ethernet adapters based on the Agere ET1310 chip.
59 .\"Support for Jumbo Frames is provided via the interface MTU setting.
60 .\"Selecting an MTU larger than 1500 bytes with the
62 .\"utility configures the adapter to receive and transmit Jumbo Frames.
63 .\"The maximum MTU setting for Jumbo Frames is 15572.
64 .\"This value coincides with the maximum Jumbo Frames size of 15594.
68 driver supports the following media types:
70 .Bl -tag -width 10baseT/UTP -compact
72 Enable autoselection of the media types and options.
73 The user can manually override
74 the autoselected mode by adding media options to the
82 option can also be used to select either
89 Set 100Mbps (Fast Ethernet) operation.
92 option can also be used to select either
99 Set 1000Mbps (Gigabit Ethernet) operation.
102 option can only be set to
109 driver supports the following
113 .Bl -tag -width full-duplex -compact
115 Force full-duplex operation.
118 Force half-duplex operation.
121 Note that the 1000baseT media type is only available
122 if it is supported by the adapter.
123 For more information on configuring this device, see
128 driver supports Agere ET1310 10/100/Gigabit
131 .Bl -tag -width ".Va hw.et.rx_intr_npkts"
132 .It Va hw.et.rx_intr_npkts
133 This value controls how many packets should be received
134 before a receive interrupt is generated.
135 The default value is 32.
136 It is recommended to set this value above 38 to prevent the host from being
137 livelocked under a high degree of stress.
138 .It Va hw.et.rx_intr_delay
139 This value delays the generation of receive interrupts
140 in units of ~4 microseconds.
141 It is used together with
142 .Va hw.et.rx_intr_npkts
143 to achieve RX interrupt moderation.
144 The default value is 20.
145 .It Va hw.et.tx_intr_nsegs
146 This value controls how many segments (not packets) should be transmitted
147 before a transmit interrupt is generated.
148 The default value is 126.
149 It is recommended to set this value below 280 to prevent
150 the TX ring from underflowing.
152 This value controls how often a timer interrupt should be generated.
153 It is used together with
154 .Va hw.et.tx_intr_nsegs
155 to achieve TX interrupt moderation.
156 The default value is 1000000000 (nanoseconds).
169 device driver first appeared in
173 release to include it was
179 driver was written by
180 .An Sepherosa Ziehau Aq sepherosa@gmail.com
186 .An Xin LI Aq delphij@FreeBSD.org .