====== ethtool ====== ===== NAME ===== ethtool - Display or change ethernet card settings ===== SYNOPSIS ===== **ethtool** //ethX// **ethtool -h** **ethtool -a** //ethX// **ethtool -A** //ethX//[**autoneg****on** |**off** ] [**rx****on** |**off** ] [**tx****on** |**off** ] **ethtool -c** //ethX// **ethtool -C** //ethX//[**adaptive-rx****on** |**off** ] [**adaptive-tx****on** |**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//[**rx****on** |**off** ] [**tx****on** |**off** ] [**sg****on** |**off** ] **ethtool -p** //ethX////[//N _]// **ethtool -r** //ethX// **ethtool -S** //ethX// **ethtool -t** //ethX//[**offline** |**online** ] **ethtool -s** //ethX//[**speed****10** |**100** |**1000** ] [**duplex****half** |**full** ] [**port****tp** |**aui** |**bnc** |**mii** ] [**autoneg****on** |**off** ] [**phyad** //N//] [**xcvr****internal** |**external** ] [**wol****p** |**u** |**m** |**b** |**a** |**g** |**s** |**d**...] [**sopass** _xx//**:** _yy//**:** _zz//**:** _aa//**:** _bb//**:** _cc//] [**msglvl** //N//] ===== DESCRIPTION ===== **ethtool** is used for querying settings of an ethernet device and changing them. //ethX//is the name of the ethernet device to work on. ===== 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. $ **autoneg****on** |**off** : Specify if pause autonegotiation is enabled. $ **rx****on** |**off** : Specify if RX pause is enabled. $ **tx****on** |**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. $ **rx****on** |**off** : Specify if RX checksumming is enabled. $ **tx****on** |**off** : Specify if TX checksumming is enabled. $ **sg****on** |**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. $ **speed****10** |**100** |**1000** : Set speed in Mb/s.**ethtool** with single argument will show you the supported device speeds. $ **duplex****half** |**full** : Set full or half duplex mode. $ **port****tp** |**aui** |**bnc** |**mii** : Select device port. $ **autoneg****on** |**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. $ **xcvr****internal** |**external** : Select transceiver type. Currently only internal and external can be specified, in the future further types might be added. $**wol****p** |**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. $
: $**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(tm) $**s** : Enable SecureOn(tm) password for MagicPacket(tm) $**d** : Disable (wake on nothing). This option clears all previous options. $**sopass _xx//**:** _yy//**:** _zz//**:** _aa//**:** _bb//**:** _cc_**: Set the SecureOn(tm) 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. --- **Important:** Use the _man//command ( _% man_) to see how a command is used on your particular computer. -- FredPettis - 04 May 2009