ethtool


SYNOPSIS
       ethtool ethX

       ethtool -h|--help

       ethtool -a|--show-pause ethX

       ethtool -A|--pause ethX [autoneg on|off] [rx on|off] [tx on|off]

       ethtool -c|--show-coalesce ethX

       ethtool  -C|--coalesce  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|--show-ring ethX

       ethtool -G|--set-ring ethX [rx N] [rx-mini N] [rx-jumbo N] [tx N]

       ethtool -i|--driver ethX

       ethtool -d|--register-dump ethX [raw on|off] [hex on|off] [file name]

       ethtool -e|--eeprom-dump ethX [raw on|off] [offset N] [length N]

       ethtool -E|--change-eeprom ethX [magic N] [offset N] [length N]  [value
       N]

       ethtool -k|--show-offload ethX

       ethtool   -K|--offload   ethX   [rx on|off]   [tx on|off]   [sg on|off]
       [tso on|off] [ufo on|off] [gso on|off] [gro on|off] [lro on|off]

       ethtool -p|--identify ethX [N]

       ethtool -r|--negotiate ethX

       ethtool -S|--statistics ethX

       ethtool -t|--test ethX [offline|online]

       ethtool  -s  ethX  speed N   [duplex half|full]   [port tp|aui|bnc|mii]
       [autoneg on|off]   [advertise  N]  [phyad  N]  [xcvr internal|external]
       [wol p|u|m|b|a|g|s|d...]  [sopass xx:yy:zz:aa:bb:cc] [msglvl N]

       ethtool -n ethX [rx-flow-hash tcp4|udp4|ah4|sctp4|tcp6|udp6|ah6|sctp6]

       ethtool -N  ethX  [rx-flow-hash tcp4|udp4|ah4|sctp4|tcp6|udp6|ah6|sctp6
        p||v|t|s|d|f|n|r...]

       rent settings of the specified device.

       -h --help
              Shows a short help message.

       -a --show-pause
              Queries the specified ethernet device for pause parameter infor-
              mation.

       -A --pause
              Changes the pause parameters of the specified ethernet device.

       autoneg on|off
              Specifies whether pause autonegotiation should be enabled.

       rx on|off
              Specifies whether RX pause should be enabled.

       tx on|off
              Specifies whether TX pause should be enabled.

       -c --show-coalesce
              Queries  the  specified  ethernet device for coalescing informa-
              tion.

       -C --coalesce
              Changes  the  coalescing  settings  of  the  specified  ethernet
              device.

       -g --show-ring
              Queries  the  specified ethernet device for rx/tx ring parameter
              information.

       -G --set-ring
              Changes the rx/tx ring  parameters  of  the  specified  ethernet
              device.

       rx N   Changes the number of ring entries for the Rx ring.

       rx-mini N
              Changes the number of ring entries for the Rx Mini ring.

       rx-jumbo N
              Changes the number of ring entries for the Rx Jumbo ring.

       tx N   Changes the number of ring entries for the Tx ring.

       -i --driver
              Queries  the  specified  ethernet  device  for associated driver
              information.

       -d --register-dump
              Retrieves and prints a register dump for the specified  ethernet
              device.   The  register  format  for  some  devices is known and

       -E --change-eeprom
              If  value  is  specified,  changes EEPROM byte for the specified
              ethernet device.  offset and value specify which byte  and  it's
              new  value. If value is not specified, stdin is read and written
              to the EEPROM. The length and offset parameters allow writing to
              certain  portions  of  the  EEPROM.   Because  of the persistent
              nature of writing to the EEPROM,  a  device-specific  magic  key
              must  be specified to prevent the accidental writing to the EEP-
              ROM.

       -k --show-offload
              Queries the specified ethernet device for offload information.

       -K --offload
              Changes the offload parameters of the specified ethernet device.

       rx on|off
              Specifies whether RX checksumming should be enabled.

       tx on|off
              Specifies whether TX checksumming should be enabled.

       sg on|off
              Specifies whether scatter-gather should be enabled.

       tso on|off
              Specifies whether TCP segmentation offload should be enabled.

       ufo on|off
              Specifies whether UDP fragmentation offload should be enabled

       gso on|off
              Specifies whether generic segmentation offload should be enabled

       gro on|off
              Specifies whether generic receive offload should be enabled

       lro on|off
              Specifies whether large receive offload should be enabled

       -p --identify
              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 --negotiate
              Restarts  auto-negotiation  on the specified ethernet device, if
              auto-negotiation is enabled.

       -S --statistics

       -s --change
              Allows  changing  some or all settings of the specified ethernet
              device.  All following options only apply if -s was specified.

       speed N
              Set speed in Mb/s.  ethtool with just  the  device  name  as  an
              argument will show you the supported device speeds.

       duplex half|full
              Sets full or half duplex mode.

       port tp|aui|bnc|mii
              Selects device port.

       autoneg on|off
              Specifies whether autonegotiation should be enabled. Autonegoti-
              ation is enabled by deafult, but in  some  network  devices  may
              have trouble with it, so you can disable it if really necessary.

       advertise N
              Sets  the  speed  and duplex advertised by autonegotiation.  The
              argument is a hexidecimal value using one or  a  combination  of
              the following values:
              0x001    10 Half
              0x002    10 Full
              0x004    100 Half
              0x008    100 Full
              0x010    1000 Half(not supported by IEEE standards)
              0x020    1000 Full
              0x8000   2500 Full(not supported by IEEE standards)
              0x1000   10000 Full
              0x03F    Auto

       phyad N
              PHY address.

       xcvr internal|external
              Selects  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...
              Sets 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.

       rx-flow-hash tcp4|udp4|ah4|sctp4|tcp6|udp6|ah6|sctp6
              Retrieves  the  hash  options  for the specified network traffic
              type.
              tcp4    TCP over IPv4
              udp4    UDP over IPv4
              ah4     IPSEC AH/ESP over IPv4
              sctp4   SCTP over IPv4
              tcp6    TCP over IPv6
              udp6    UDP over IPv6
              ah6     IPSEC AH/ESP over IPv6
              sctp6   SCTP over IPv6

       -N --config-nfc
              Configures the receive network flow classification.

       rx-flow-
       hash tcp4|udp4|ah4|sctp4|tcp6|udp6|ah6|sctp6 p||v|t|s|d|f|n|r...
              Configures  the  hash  options for the specified network traffic
              type.
              m  Hash on the Layer 2 destination address of the rx packet.
              v  Hash on the VLAN tag of the rx packet.
              t  Hash on the Layer 3 protocol field of the rx packet.
              s  Hash on the IP source address of the rx packet.
              d  Hash on the IP destination address of the rx packet.
              f  Hash on bytes 0 and 1 of the Layer 4 header of the rx packet.
              n  Hash on bytes 2 and 3 of the Layer 4 header of the rx packet.
              r  Discard all packets of this flow type. When  this  option  is
                 set, all other options are ignored.

       -f --flash  FILE
              Flash  firmware image from the specified file to a region on the
              adapter.  By default this will flash  all  the  regions  on  the
              adapter.

       N      A  number  to  identify  flash  region where the image should be
              flashed.  Default region is 0 which denotes all regions  in  the
              flash.

BUGS
       Not supported (in part or whole) on all ethernet drivers.

AUTHOR
       ethtool was written by David Miller.

       Modifications by Jeff Garzik, Tim Hockin, Jakub Jelinek, Andre Majorel,
       Eli Kupermann, Scott Feldman, Andi Kleen.

AVAILABILITY
       ethtool  is  available  over  the  Web  on  the  SourceForge  site   at
       http://sourceforge.net/projects/gkernel/
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2012 Hurricane Electric. All Rights Reserved.