blob: 25b6a66855d97ea2fc4787d0cf0c2285487ecbbe (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
<table class="head">
<tr>
<td class="head-ltitle">ET(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">ET(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">et</code> — <span class="Nd">Agere ET1310
10/100/Gigabit Ethernet driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device miibus</code>
<br/>
<code class="Cd">device et</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>if_et_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">et</code> driver supports PCI Express
Ethernet adapters based on the Agere ET1310 chip.</p>
<p class="Pp">The <code class="Nm">et</code> driver supports the following media
types:</p>
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt>autoselect</dt>
<dd>Enable autoselection of the media types and options. The user can manually
override the autoselected mode by adding media options to the
<span class="Pa">/etc/rc.conf</span> file.
<p class="Pp"></p>
</dd>
<dt>10baseT/UTP</dt>
<dd>Set 10Mbps operation. The <var class="Ar">mediaopt</var> option can also
be used to select either <var class="Ar">full-duplex</var> or
<var class="Ar">half-duplex</var> modes.
<p class="Pp"></p>
</dd>
<dt>100baseTX</dt>
<dd>Set 100Mbps (Fast Ethernet) operation. The <var class="Ar">mediaopt</var>
option can also be used to select either <var class="Ar">full-duplex</var>
or <var class="Ar">half-duplex</var> modes.
<p class="Pp"></p>
</dd>
<dt>1000baseT</dt>
<dd>Set 1000Mbps (Gigabit Ethernet) operation. The
<var class="Ar">mediaopt</var> option can only be set to
<var class="Ar">full-duplex</var> mode.</dd>
</dl>
<p class="Pp">The <code class="Nm">et</code> driver supports the following
<var class="Ar">media</var> options:</p>
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt>full-duplex</dt>
<dd>Force full-duplex operation.
<p class="Pp"></p>
</dd>
<dt>half-duplex</dt>
<dd>Force half-duplex operation.</dd>
</dl>
<p class="Pp">Note that the 1000baseT media type is only available if it is
supported by the adapter. For more information on configuring this device,
see <a class="Xr">ifconfig(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">et</code> driver supports Agere ET1310
10/100/Gigabit Ethernet adapters.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="TUNABLES"><a class="permalink" href="#TUNABLES">TUNABLES</a></h1>
<dl class="Bl-tag">
<dt id="hw.et.rx_intr_npkts"><var class="Va">hw.et.rx_intr_npkts</var></dt>
<dd>This value controls how many packets should be received before a receive
interrupt is generated. The default value is 32. It is recommended to set
this value above 38 to prevent the host from being livelocked under a high
degree of stress.</dd>
<dt id="hw.et.rx_intr_delay"><var class="Va">hw.et.rx_intr_delay</var></dt>
<dd>This value delays the generation of receive interrupts in units of ~4
microseconds. It is used together with
<var class="Va">hw.et.rx_intr_npkts</var> to achieve RX interrupt
moderation. The default value is 20.</dd>
<dt id="hw.et.tx_intr_nsegs"><var class="Va">hw.et.tx_intr_nsegs</var></dt>
<dd>This value controls how many segments (not packets) should be transmitted
before a transmit interrupt is generated. The default value is 126. It is
recommended to set this value below 280 to prevent the TX ring from
underflowing.</dd>
<dt id="hw.et.timer"><var class="Va">hw.et.timer</var></dt>
<dd>This value controls how often a timer interrupt should be generated. It is
used together with <var class="Va">hw.et.tx_intr_nsegs</var> to achieve TX
interrupt moderation. The default value is 1000000000 (nanoseconds).</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">altq(4)</a>, <a class="Xr">arp(4)</a>,
<a class="Xr">miibus(4)</a>, <a class="Xr">netintro(4)</a>,
<a class="Xr">ng_ether(4)</a>, <a class="Xr">vlan(4)</a>,
<a class="Xr">ifconfig(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">et</code> device driver first appeared in
<span class="Ux">DragonFly 1.11</span>. The first
<span class="Ux">FreeBSD</span> release to include it was
<span class="Ux">FreeBSD 8.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">et</code> driver was written by
<span class="An">Sepherosa Ziehau</span>
<<a class="Mt" href="mailto:sepherosa@gmail.com">sepherosa@gmail.com</a>>
for <span class="Ux">DragonFly</span>. It was ported to
<span class="Ux">FreeBSD</span> by <span class="An">Xin LI</span>
<<a class="Mt" href="mailto:delphij@FreeBSD.org">delphij@FreeBSD.org</a>>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">December 9, 2011</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
