xref: /freebsd/share/man/man4/age.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1bbb1ae83SPyun YongHyeon.\" Copyright (c) 2008 Pyun YongHyeon
2bbb1ae83SPyun YongHyeon.\" All rights reserved.
3bbb1ae83SPyun YongHyeon.\"
4bbb1ae83SPyun YongHyeon.\" Redistribution and use in source and binary forms, with or without
5bbb1ae83SPyun YongHyeon.\" modification, are permitted provided that the following conditions
6bbb1ae83SPyun YongHyeon.\" are met:
7bbb1ae83SPyun YongHyeon.\" 1. Redistributions of source code must retain the above copyright
8bbb1ae83SPyun YongHyeon.\"    notice, this list of conditions and the following disclaimer.
9bbb1ae83SPyun YongHyeon.\" 2. Redistributions in binary form must reproduce the above copyright
10bbb1ae83SPyun YongHyeon.\"    notice, this list of conditions and the following disclaimer in the
11bbb1ae83SPyun YongHyeon.\"    documentation and/or other materials provided with the distribution.
12bbb1ae83SPyun YongHyeon.\"
13bbb1ae83SPyun YongHyeon.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14bbb1ae83SPyun YongHyeon.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15bbb1ae83SPyun YongHyeon.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16bbb1ae83SPyun YongHyeon.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17bbb1ae83SPyun YongHyeon.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18bbb1ae83SPyun YongHyeon.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19bbb1ae83SPyun YongHyeon.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20bbb1ae83SPyun YongHyeon.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21bbb1ae83SPyun YongHyeon.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22bbb1ae83SPyun YongHyeon.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23bbb1ae83SPyun YongHyeon.\" SUCH DAMAGE.
24bbb1ae83SPyun YongHyeon.\"
2552144a3eSPyun YongHyeon.Dd September 18, 2008
26bbb1ae83SPyun YongHyeon.Dt AGE 4
27bbb1ae83SPyun YongHyeon.Os
28bbb1ae83SPyun YongHyeon.Sh NAME
29bbb1ae83SPyun YongHyeon.Nm age
30bbb1ae83SPyun YongHyeon.Nd Attansic/Atheros L1 Gigabit Ethernet driver
31bbb1ae83SPyun YongHyeon.Sh SYNOPSIS
32bbb1ae83SPyun YongHyeonTo compile this driver into the kernel,
33bbb1ae83SPyun YongHyeonplace the following lines in your
34bbb1ae83SPyun YongHyeonkernel configuration file:
35bbb1ae83SPyun YongHyeon.Bd -ragged -offset indent
36bbb1ae83SPyun YongHyeon.Cd "device miibus"
37bbb1ae83SPyun YongHyeon.Cd "device age"
38bbb1ae83SPyun YongHyeon.Ed
39bbb1ae83SPyun YongHyeon.Pp
40bbb1ae83SPyun YongHyeonAlternatively, to load the driver as a
41bbb1ae83SPyun YongHyeonmodule at boot time, place the following line in
42bbb1ae83SPyun YongHyeon.Xr loader.conf 5 :
43bbb1ae83SPyun YongHyeon.Bd -literal -offset indent
44bbb1ae83SPyun YongHyeonif_age_load="YES"
45bbb1ae83SPyun YongHyeon.Ed
46bbb1ae83SPyun YongHyeon.Sh DESCRIPTION
47bbb1ae83SPyun YongHyeonThe
48bbb1ae83SPyun YongHyeon.Nm
49bbb1ae83SPyun YongHyeondevice driver provides support for Attansic/Atheros L1 PCI Express
50bbb1ae83SPyun YongHyeonGigabit Ethernet controllers.
51bbb1ae83SPyun YongHyeon.Pp
52bbb1ae83SPyun YongHyeonAll LOMs supported by the
53bbb1ae83SPyun YongHyeon.Nm
54bbb1ae83SPyun YongHyeondriver have TCP/UDP/IP checksum offload for both transmit and
55bbb1ae83SPyun YongHyeonreceive, TCP segmentation offload (TSO), hardware VLAN tag
56bbb1ae83SPyun YongHyeonstripping/insertion features and an interrupt moderation mechanism
57bbb1ae83SPyun YongHyeonas well as a 64-bit multicast hash filter.
58bbb1ae83SPyun YongHyeon.Pp
59bbb1ae83SPyun YongHyeonThe L1 also supports Jumbo Frames (up to 10240 bytes), which can be
60bbb1ae83SPyun YongHyeonconfigured via the interface MTU setting.
61bbb1ae83SPyun YongHyeonSelecting an MTU larger than 1500 bytes with the
62bbb1ae83SPyun YongHyeon.Xr ifconfig 8
63bbb1ae83SPyun YongHyeonutility configures the adapter to receive and transmit Jumbo Frames.
64bbb1ae83SPyun YongHyeon.Pp
65bbb1ae83SPyun YongHyeonThe
66bbb1ae83SPyun YongHyeon.Nm
67bbb1ae83SPyun YongHyeondriver supports the following media types:
68bbb1ae83SPyun YongHyeon.Bl -tag -width ".Cm 10baseT/UTP"
69bbb1ae83SPyun YongHyeon.It Cm autoselect
70bbb1ae83SPyun YongHyeonEnable autoselection of the media type and options.
71bbb1ae83SPyun YongHyeonThe user can manually override
72bbb1ae83SPyun YongHyeonthe autoselected mode by adding media options to
73bbb1ae83SPyun YongHyeon.Xr rc.conf 5 .
74bbb1ae83SPyun YongHyeon.It Cm 10baseT/UTP
75bbb1ae83SPyun YongHyeonSet 10Mbps operation.
76bbb1ae83SPyun YongHyeon.It Cm 100baseTX
77bbb1ae83SPyun YongHyeonSet 100Mbps (Fast Ethernet) operation.
78bbb1ae83SPyun YongHyeon.It Cm 1000baseTX
79bbb1ae83SPyun YongHyeonSet 1000baseTX operation over twisted pair.
80bbb1ae83SPyun YongHyeon.El
81bbb1ae83SPyun YongHyeon.Pp
82bbb1ae83SPyun YongHyeonThe
83bbb1ae83SPyun YongHyeon.Nm
84bbb1ae83SPyun YongHyeondriver supports the following media options:
85bbb1ae83SPyun YongHyeon.Bl -tag -width ".Cm full-duplex"
86bbb1ae83SPyun YongHyeon.It Cm full-duplex
87bbb1ae83SPyun YongHyeonForce full duplex operation.
88bbb1ae83SPyun YongHyeon.It Cm half-duplex
89bbb1ae83SPyun YongHyeonForce half duplex operation.
90bbb1ae83SPyun YongHyeon.El
91bbb1ae83SPyun YongHyeon.Pp
92bbb1ae83SPyun YongHyeonFor more information on configuring this device, see
93bbb1ae83SPyun YongHyeon.Xr ifconfig 8 .
94bbb1ae83SPyun YongHyeon.Sh HARDWARE
95bbb1ae83SPyun YongHyeonThe
96bbb1ae83SPyun YongHyeon.Nm
97bbb1ae83SPyun YongHyeondriver provides support for LOMs based on
98bbb1ae83SPyun YongHyeonAttansic/Atheros L1 Gigabit Ethernet controller chips, including:
99bbb1ae83SPyun YongHyeon.Pp
100bbb1ae83SPyun YongHyeon.Bl -bullet -compact
101bbb1ae83SPyun YongHyeon.It
102bbb1ae83SPyun YongHyeonASUS M2N8-VMX
103bbb1ae83SPyun YongHyeon.It
104bbb1ae83SPyun YongHyeonASUS M2V
105bbb1ae83SPyun YongHyeon.It
106bbb1ae83SPyun YongHyeonASUS M3A
107bbb1ae83SPyun YongHyeon.It
108bbb1ae83SPyun YongHyeonASUS P2-M2A590G
109bbb1ae83SPyun YongHyeon.It
110bbb1ae83SPyun YongHyeonASUS P5B-E
111bbb1ae83SPyun YongHyeon.It
112bbb1ae83SPyun YongHyeonASUS P5B-MX/WIFI-AP
113bbb1ae83SPyun YongHyeon.It
114bbb1ae83SPyun YongHyeonASUS P5B-VMSE
115bbb1ae83SPyun YongHyeon.It
116bbb1ae83SPyun YongHyeonASUS P5K
117bbb1ae83SPyun YongHyeon.It
118bbb1ae83SPyun YongHyeonASUS P5KC
119bbb1ae83SPyun YongHyeon.It
12052144a3eSPyun YongHyeonASUS P5KPL-C
12152144a3eSPyun YongHyeon.It
122bbb1ae83SPyun YongHyeonASUS P5KPL-VM
123bbb1ae83SPyun YongHyeon.It
124bbb1ae83SPyun YongHyeonASUS P5K-SE
125bbb1ae83SPyun YongHyeon.It
126bbb1ae83SPyun YongHyeonASUS P5K-V
127bbb1ae83SPyun YongHyeon.It
128bbb1ae83SPyun YongHyeonASUS P5L-MX
129bbb1ae83SPyun YongHyeon.It
130bbb1ae83SPyun YongHyeonASUS P5DL2-VM
131bbb1ae83SPyun YongHyeon.It
132bbb1ae83SPyun YongHyeonASUS P5L-VM 1394
1332af07c4eSPyun YongHyeon.It
1342af07c4eSPyun YongHyeonASUS G2S
135bbb1ae83SPyun YongHyeon.El
136bbb1ae83SPyun YongHyeon.Sh LOADER TUNABLES
137bbb1ae83SPyun YongHyeonTunables can be set at the
138bbb1ae83SPyun YongHyeon.Xr loader 8
139bbb1ae83SPyun YongHyeonprompt before booting the kernel or stored in
140bbb1ae83SPyun YongHyeon.Xr loader.conf 5 .
141bbb1ae83SPyun YongHyeon.Bl -tag -width "xxxxxx"
142bbb1ae83SPyun YongHyeon.It Va hw.age.msi_disable
143bbb1ae83SPyun YongHyeonThis tunable disables MSI support on the Ethernet hardware.
144bbb1ae83SPyun YongHyeonThe default value is 0.
145bbb1ae83SPyun YongHyeon.It Va hw.age.msix_disable
146bbb1ae83SPyun YongHyeonThis tunable disables MSI-X support on the Ethernet hardware.
147bbb1ae83SPyun YongHyeonThe default value is 0.
148bbb1ae83SPyun YongHyeon.El
149bbb1ae83SPyun YongHyeon.Sh SYSCTL VARIABLES
150bbb1ae83SPyun YongHyeonThe following variables are available as both
151bbb1ae83SPyun YongHyeon.Xr sysctl 8
152bbb1ae83SPyun YongHyeonvariables and
153bbb1ae83SPyun YongHyeon.Xr loader 8
154bbb1ae83SPyun YongHyeontunables:
155bbb1ae83SPyun YongHyeon.Bl -tag -width "xxxxxx"
156bbb1ae83SPyun YongHyeon.It Va dev.age.%d.int_mod
157bbb1ae83SPyun YongHyeonMaximum amount of time to delay interrupt processing in units of
158bbb1ae83SPyun YongHyeon2us.
159bbb1ae83SPyun YongHyeonThe accepted range is 0 to 65000, the default is 50 (100us).
160bbb1ae83SPyun YongHyeonValue 0 completely disables the interrupt moderation.
161bbb1ae83SPyun YongHyeon.It Va dev.age.%d.process_limit
162bbb1ae83SPyun YongHyeonMaximum amount of Rx events to be processed in the event loop before
163bbb1ae83SPyun YongHyeonrescheduling a taskqueue.
164bbb1ae83SPyun YongHyeonThe accepted range is 30 to 255, the default value is 128 events.
165bbb1ae83SPyun YongHyeonThe interface does not need to be brought down and up again before
166bbb1ae83SPyun YongHyeona change takes effect.
167bbb1ae83SPyun YongHyeon.It Va dev.age.%d.stats
168bbb1ae83SPyun YongHyeonDisplay lots of useful MAC counters maintained in the driver.
169bbb1ae83SPyun YongHyeon.El
170bbb1ae83SPyun YongHyeon.Sh SEE ALSO
171bbb1ae83SPyun YongHyeon.Xr altq 4 ,
172bbb1ae83SPyun YongHyeon.Xr arp 4 ,
173bbb1ae83SPyun YongHyeon.Xr miibus 4 ,
174bbb1ae83SPyun YongHyeon.Xr netintro 4 ,
175bbb1ae83SPyun YongHyeon.Xr ng_ether 4 ,
176bbb1ae83SPyun YongHyeon.Xr vlan 4 ,
177bbb1ae83SPyun YongHyeon.Xr ifconfig 8
178bbb1ae83SPyun YongHyeon.Sh HISTORY
179bbb1ae83SPyun YongHyeonThe
180bbb1ae83SPyun YongHyeon.Nm
181bbb1ae83SPyun YongHyeondriver was written by
182*6c899950SBaptiste Daroussin.An Pyun YongHyeon Aq Mt yongari@FreeBSD.org .
183bbb1ae83SPyun YongHyeonIt first appeared in
184bbb1ae83SPyun YongHyeon.Fx 7.1 .
185