1.\" 2.\" Copyright (c) 2007 The DragonFly Project. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 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 13.\" distribution. 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. 17.\" 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 29.\" SUCH DAMAGE. 30.\" 31.\" $DragonFly: src/share/man/man4/et.4,v 1.2 2007/10/23 14:28:42 sephe Exp $ 32.\" 33.Dd October 11, 2007 34.Dt ET 4 35.Os 36.Sh NAME 37.Nm et 38.Nd "Agere ET1310 10/100/Gigabit Ethernet device" 39.Sh SYNOPSIS 40.Cd "device miibus" 41.Cd "device et" 42.Pp 43Alternatively, to load the driver as a module at boot time, place the 44following line in 45.Pa /boot/loader.conf : 46.Bd -literal -offset indent 47if_et_load="YES" 48.Ed 49.Sh DESCRIPTION 50The 51.Nm 52driver supports the PCIe Ethernet adapters based on Agere ET1310. 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 setting for Jumbo Frames is 15572. 59This value coincides with the maximum Jumbo Frames size of 15594. 60.Pp 61The 62.Nm 63driver supports the following 64.Ar media 65types: 66.Pp 67.Bl -tag -width 10baseT/UTP -compact 68.It Cm autoselect 69Enable autoselection of the media types and options 70.Pp 71.It Cm 10baseT/UTP 72Set 10Mbps operation. 73The 74.Ar mediaopt 75option can also be used to select either 76.Ar full-duplex 77or 78.Ar half-duplex 79modes. 80.Pp 81.It Cm 100baseTX 82Set 100Mbps (Fast Ethernet) operation. 83The 84.Ar mediaopt 85option can also be used to select either 86.Ar full-duplex 87or 88.Ar half-duplex 89modes. 90.Pp 91.It Cm 1000baseT 92Set 1000Mbps (Gigabit Ethernet) operation. 93The 94.Ar mediaopt 95option can only be set 96.Ar full-duplex 97mode. 98.El 99.Pp 100The 101.Nm 102driver supports the following 103.Ar media 104options: 105.Pp 106.Bl -tag -width full-duplex -compact 107.It Cm full-duplex 108Force full duplex operation. 109.Pp 110.It Cm half-duplex 111Force half duplex operation. 112.El 113.Pp 114Note that the 1000baseT media type is only available 115if it is supported by the adapter. 116For more information on configuring this device, 117see 118.Xr ifconfig 8 . 119.Sh TUNABLES 120.Bl -tag -width ".Va hw.et.rx_intr_npkts" 121.It Va hw.et.rx_intr_npkts 122This value controls how many packets should be recevied 123before a receive interrupt is generated. 124The default value is 32. 125.It Va hw.et.rx_intr_delay 126This value delays the generation of receive interrupts 127in units of 10 microseconds (I guess). 128It is used together with 129.Va hw.et.rx_intr_npkts 130to achieve RX interrupt moderation. 131The default value is 20. 132.It Va hw.et.tx_intr_nsegs 133This value controls how many segments (not packets) should be transmitted 134before a transmit interrupt is generated. 135The default value is 126. 136.It Va hw.et.timer 137This value controls how often the a timer interrupt should be generated. 138It is used together with 139.Va hw.et.tx_intr_nsegs 140to achieve TX interrupt moderation. 141The default value is 1000000000 (nanoseconds). 142.El 143.Sh SEE ALSO 144.Xr arp 4 , 145.Xr ifmedia 4 , 146.Xr miibus 4 , 147.Xr netintro 4 , 148.Xr ng_ether 4 , 149.Xr vlan 4 , 150.Xr ifconfig 8 151.Sh HISTORY 152The 153.Nm 154device driver first appeared in 155.Dx 1.11 . 156.Sh AUTHORS 157.An -nosplit 158The 159.Nm 160driver was written by 161.An Sepherosa Ziehau 162.Aq sepherosa@gmail.com . 163