ethtool

NAME

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