User Tools

Site Tools


ethtool

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

ethtool [2013/01/27 21:29] (current)
Line 1: Line 1:
 +
 +====== ethtool ​ ======
 +
 +===== NAME =====
 +ethtool - Display or change ethernet card settings
 +<a name''"​lbAC"​ />
 +===== 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//]
 +<a name''"​lbAD"​ />
 +===== 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.
 +
 +<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.
 +   $ **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.
 +      $ <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(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.
 +<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
  
ethtool.txt ยท Last modified: 2013/01/27 21:29 (external edit)