User Tools

Site Tools


ethtool
no way to compare when less than two revisions

Differences

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


ethtool [2013/01/28 04:29] (current) – created - external edit 127.0.0.1
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/28 04:29 by 127.0.0.1