ethtool - Display or change ethernet card settings
<a name“lbAC” />
===== SYNOPSIS =====
ethtool
ethX
ethtool -h
ethtool -a
ethX
ethtool -A
ethX[autonegon |off ]
[rxon |off ]
[txon |off ]
ethtool -c
ethX
ethtool -C
ethX[adaptive-rxon |off ]
[adaptive-txon |off ]
[rx-usecs
N]
[rx-frames
N]
[rx-usecs-irq
N]
[rx-frames-irq
N]
[tx-usecs
N]
[tx-frames
N]
[tx-usecs-irq
N]
[tx-frames-irq
N]
[stats-block-usecs
N]
[pkt-rate-low
N]
[rx-usecs-low
N]
[rx-frames-low
N]
[tx-usecs-low
N]
[tx-frames-low
N]
[pkt-rate-high
N]
[rx-usecs-high
N]
[rx-frames-high
N]
[tx-usecs-high
N]
[tx-frames-high
N]
[sample-interval
N]
ethtool -g
ethX
ethtool -G
ethX[rx
N]
[rx-mini
N]
[rx-jumbo
N]
[tx
N]
ethtool -i
ethX
ethtool -d
ethX
ethtool -e
ethX
ethtool -k
ethX
ethtool -K
ethX[rxon |off ]
[txon |off ]
[sgon |off ]
ethtool -p
ethX[N _]
ethtool -r
ethX
ethtool -S
ethX
ethtool -t
ethX[offline |online ]
ethtool -s
ethX[speed10 |100 |1000 ]
[duplexhalf |full ]
[porttp |aui |bnc |mii ]
[autonegon |off ]
[phyad
N]
[xcvrinternal |external ]
[wolp |u |m |b |a |g |s |d…]
[sopass _xx: _yy: _zz: _aa: _bb: _cc]
[msglvl
N]
<a name“lbAD” />
===== DESCRIPTION =====
ethtool
is used for querying settings of an ethernet device and changing them.
ethXis the name of the ethernet device to work on.
<a name“lbAE” />
===== OPTIONS =====
ethtool
with a single argument specifying the device name prints current
setting of the specified device.
$-h : shows a short help message.
$-a : queries the specified ethernet device for pause parameter information.
$-A : change the pause parameters of the specified ethernet device.
$ autonegon |off : Specify if pause autonegotiation is enabled.
$ rxon |off : Specify if RX pause is enabled.
$ txon |off : Specify if TX pause is enabled.
$-c : queries the specified ethernet device for coalescing information.
$-C : change the coalescing settings of the specified ethernet device.
$-g : queries the specified ethernet device for rx/tx ring parameter information.
$-G : change the rx/tx ring parameters of the specified ethernet device.
$rx _N : Change number of ring entries for the Rx ring.
$rx-mini _N : Change number of ring entries for the Rx Mini ring.
$rx-jumbo _N : Change number of ring entries for the Rx Jumbo ring.
$tx _N : Change number of ring entries for the Tx ring.
$-i : queries the specified ethernet device for associated driver information.
$-d : retrieves and prints a register dump for the specified ethernet device.
$-e : retrieves and prints an EEPROM dump for the specified ethernet device.
$-k : queries the specified ethernet device for checksumming information.
$-K : change the checksumming parameters of the specified ethernet device.
$ rxon |off : Specify if RX checksumming is enabled.
$ txon |off : Specify if TX checksumming is enabled.
$ sgon |off : Specify if scatter-gather is enabled.
$-p : initiates adapter-specific action intended to enable an operator to easily identify the adapter by sight. typically this involves blinking one or more LEDs on the specific ethernet port.
$N : Length of time to perform phys-id, in seconds.
$-r : restarts auto-negotiation on the specified ethernet device, if auto-negotiation is enabled.
$-S : queries the specified ethernet device for NIC- and driver-specific statistics.
$-t : executes adapter selftest on the specified ethernet device. Possible test modes are:
$ offline |online : defines test type: offline (default) means to perform full set of tests possibly causing normal operation interruption during the tests,online means to perform limited set of tests do not interrupting normal adapter operation.
$-s : option allows changing some or all settings of the specified ethernet device. All following options only apply if-s was specified.
$ speed10 |100 |1000 : Set speed in Mb/s.ethtool with single argument will show you the supported device speeds.
$ duplexhalf |full : Set full or half duplex mode.
$ porttp |aui |bnc |mii : Select device port.
$ autonegon |off : Specify if autonegotiation is enabled. In the usual case it is, but might cause some problems with some network devices, so you can turn it off.
$phyad _N : PHY address.
$ xcvrinternal |external : Select transceiver type. Currently only internal and external can be specified, in the future further types might be added.
$wolp |u |m |b |a |g |s |d… : Set Wake-on-LAN options. Not all devices support this. The argument to this option is a string of characters specifying which options to enable.
$ <br />:
$p : Wake on phy activity
$u : Wake on unicast messages
$m : Wake on multicast messages
$b : Wake on broadcast messages
$a : Wake on ARP
$g : Wake on MagicPacket™
$s : Enable SecureOn™ password for MagicPacket™
$d : Disable (wake on nothing). This option clears all previous options.
$sopass _xx: _yy: _zz: _aa: _bb: _cc_: Set the SecureOn™ password. The argument to this option must be 6 bytes in ethernet MAC hex format ( _xx: _yy: _zz: _aa: _bb: _cc_).
$msglvl _N : Set the driver message level. Meanings differ per driver.
<a name“lbAF” />
—
<font face“Verdana, Arial, Helvetica, sans-serif” size''“2”>Important:**
Use the _mancommand ( _% man_) to see how a command is used on your
particular computer. </font>
– FredPettis - 04 May 2009