diff options
Diffstat (limited to 'static/freebsd/man4/ae.4 3.html')
| -rw-r--r-- | static/freebsd/man4/ae.4 3.html | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/static/freebsd/man4/ae.4 3.html b/static/freebsd/man4/ae.4 3.html new file mode 100644 index 00000000..71d58eed --- /dev/null +++ b/static/freebsd/man4/ae.4 3.html @@ -0,0 +1,134 @@ +<table class="head"> + <tr> + <td class="head-ltitle">AE(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">AE(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">ae</code> — + <span class="Nd">Attansic/Atheros L2 FastEthernet controller + 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 ae</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_ae_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">ae</code> device driver provides support for + Attansic/Atheros L2 PCIe FastEthernet controllers.</p> +<p class="Pp">The controller supports hardware Ethernet checksum processing, + hardware VLAN tag stripping/insertion and an interrupt moderation mechanism. + Attansic L2 also features a 64-bit multicast hash filter.</p> +<p class="Pp">The <code class="Nm">ae</code> driver supports the following media + types:</p> +<dl class="Bl-tag"> + <dt id="autoselect"><a class="permalink" href="#autoselect"><code class="Cm">autoselect</code></a></dt> + <dd>Enable autoselection of the media type and options. The user can manually + override the autoselected mode by adding media options to + <a class="Xr">rc.conf(5)</a>.</dd> + <dt id="10baseT/UTP"><a class="permalink" href="#10baseT/UTP"><code class="Cm">10baseT/UTP</code></a></dt> + <dd>Select 10Mbps operation.</dd> + <dt id="100baseTX"><a class="permalink" href="#100baseTX"><code class="Cm">100baseTX</code></a></dt> + <dd>Set 100Mbps (FastEthernet) operation.</dd> +</dl> +<p class="Pp">The <code class="Nm">ae</code> driver provides support for the + following media options:</p> +<dl class="Bl-tag"> + <dt id="full-duplex"><a class="permalink" href="#full-duplex"><code class="Cm">full-duplex</code></a></dt> + <dd>Force full duplex operation.</dd> + <dt id="half-duplex"><a class="permalink" href="#half-duplex"><code class="Cm">half-duplex</code></a></dt> + <dd>Force half duplex operation.</dd> +</dl> +<p class="Pp">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">ae</code> driver supports Attansic/Atheros L2 + PCIe FastEthernet controllers, and is known to support the following + hardware:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bl-compact"> + <li>ASUS EeePC 701</li> + <li>ASUS EeePC 900</li> +</ul> +<p class="Pp">Other hardware may or may not work with this driver.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="LOADER_TUNABLES"><a class="permalink" href="#LOADER_TUNABLES">LOADER + TUNABLES</a></h1> +<p class="Pp">Tunables can be set at the <a class="Xr">loader(8)</a> prompt + before booting the kernel or stored in <a class="Xr">loader.conf(5)</a>.</p> +<dl class="Bl-tag"> + <dt id="hw.ae.msi_disable"><var class="Va">hw.ae.msi_disable</var></dt> + <dd>This tunable disables MSI support on the Ethernet hardware. The default + value is 0.</dd> +</dl> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL + VARIABLES</a></h1> +<p class="Pp">The <code class="Nm">ae</code> driver collects a number of useful + MAC counter during the work. The statistics is available via the + <var class="Va">dev.ae.%d.stats</var> <a class="Xr">sysctl(8)</a> tree, + where %d corresponds to the controller number.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1> +<dl class="Bl-diag"> + <dt>ae%d: watchdog timeout.</dt> + <dd>The device has stopped responding to the network, or there is a problem + with the network connection (cable).</dd> + <dt>ae%d: reset timeout.</dt> + <dd>The card reset operation has been timed out.</dd> + <dt>ae%d: Generating random ethernet address.</dt> + <dd>No valid Ethernet address was found in the controller NVRAM and registers. + Random locally administered address with ASUS OUI identifier will be used + instead.</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">ae</code> driver and this manual page was + written by <span class="An">Stanislav Sedov</span> + <<a class="Mt" href="mailto:stas@FreeBSD.org">stas@FreeBSD.org</a>>. + It first appeared in <span class="Ux">FreeBSD 7.1</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp">The Attansic L2 FastEthernet controller supports DMA but does not + use a descriptor based transfer mechanism via scatter-gather DMA. Thus the + data should be copied to/from the controller memory on each + transmit/receive. Furthermore, a lot of data alignment restrictions apply. + This may introduce a high CPU load on systems with heavy network activity. + Luckily enough this should not be a problem on modern hardware as L2 does + not support speeds faster than 100Mbps.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">May 17, 2019</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |