ethtool - Display or change ethernet card settings <a name''“lbAC” />
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” />
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 _man//command ( _% man_) to see how a command is used on your particular computer. </font>
– FredPettis - 04 May 2009