ethtool version 7.2
Usage:
ethtool [ FLAGS ] DEVNAME Display standard information about device
ethtool [ FLAGS ] -s|--change DEVNAME Change generic options
[ speed %d ]
[ lanes %d ]
[ duplex half|full ]
[ port tp|aui|bnc|mii|fibre|da ]
[ mdix auto|on|off ]
[ autoneg on|off ]
[ advertise %x[/%x] | mode on|off ... [--] ]
[ phyad %d ]
[ xcvr internal|external ]
[ wol %d[/%d] | p|u|m|b|a|g|s|f|d... ]
[ sopass %x:%x:%x:%x:%x:%x ]
[ msglvl %d[/%d] | type on|off ... [--] ]
[ master-slave preferred-master|preferred-slave|forced-master|forced-slave ]
ethtool [ FLAGS ] -a|--show-pause DEVNAME Show pause options
[ --src aggregate | emac | pmac ]
ethtool [ FLAGS ] -A|--pause DEVNAME Set pause options
[ autoneg on|off ]
[ rx on|off ]
[ tx on|off ]
ethtool [ FLAGS ] -c|--show-coalesce DEVNAME Show coalesce options
ethtool [ FLAGS ] -C|--coalesce DEVNAME Set coalesce options
[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]
[cqe-mode-rx on|off]
[cqe-mode-tx on|off]
[tx-aggr-max-bytes N]
[tx-aggr-max-frames N]
[tx-aggr-time-usecs N]
[rx-cqe-frames N]
[rx-cqe-nsecs N]
ethtool [ FLAGS ] -g|--show-ring DEVNAME Query RX/TX ring parameters
ethtool [ FLAGS ] -G|--set-ring DEVNAME Set RX/TX ring parameters
[ rx N ]
[ rx-mini N ]
[ rx-jumbo N ]
[ tx N ]
[ rx-buf-len N ]
[ tcp-data-split auto|on|off ]
[ cqe-size N ]
[ tx-push on|off ]
[ rx-push on|off ]
[ tx-push-buf-len N]
[ hds-thresh N ]
ethtool [ FLAGS ] -k|--show-features|--show-offload DEVNAME Get state of protocol offload and other features
ethtool [ FLAGS ] -K|--features|--offload DEVNAME Set protocol offload and other features
FEATURE on|off ...
ethtool [ FLAGS ] -i|--driver DEVNAME Show driver information
ethtool [ FLAGS ] -d|--register-dump DEVNAME Do a register dump
[ raw on|off ]
[ file FILENAME ]
ethtool [ FLAGS ] -e|--eeprom-dump DEVNAME Do a EEPROM dump
[ raw on|off ]
[ offset N ]
[ length N ]
ethtool [ FLAGS ] -E|--change-eeprom DEVNAME Change bytes in device EEPROM
[ magic N ]
[ offset N ]
[ length N ]
[ value N ]
ethtool [ FLAGS ] -r|--negotiate DEVNAME Restart N-WAY negotiation
ethtool [ FLAGS ] -p|--identify DEVNAME Show visible port identification (e.g. blinking)
[ TIME-IN-SECONDS ]
ethtool [ FLAGS ] -t|--test DEVNAME Execute adapter self test
[ online | offline | external_lb ]
ethtool [ FLAGS ] -S|--statistics DEVNAME Show adapter statistics
[ --all-groups | --groups [eth-phy] [eth-mac] [eth-ctrl] [rmon] ]
[ --src aggregate | emac | pmac ]
ethtool [ FLAGS ] --phy-statistics DEVNAME Show phy statistics
ethtool [ FLAGS ] -n|-u|--show-nfc|--show-ntuple DEVNAME Show Rx network flow classification options or rules
[ rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|gtpc4|gtpc4t|gtpu4|gtpu4e|gtpu4u|gtpu4d|tcp6|udp6|ah6|esp6|sctp6|gtpc6|gtpc6t|gtpu6|gtpu6e|gtpu6u|gtpu6d [context %d] |
rule %d ]
ethtool [ FLAGS ] -N|-U|--config-nfc|--config-ntuple DEVNAME Configure Rx network flow classification options or rules
rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|gtpc4|gtpc4t|gtpu4|gtpu4e|gtpu4u|gtpu4d|tcp6|udp6|ah6|esp6|sctp6|gtpc6|gtpc6t|gtpu6|gtpu6e|gtpu6u|gtpu6d m|v|t|s|d|f|n|r|e|l... [context %d] |
flow-type ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
[ src %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
[ dst %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
[ proto %d [m %x] ]
[ src-ip IP-ADDRESS [m IP-ADDRESS] ]
[ dst-ip IP-ADDRESS [m IP-ADDRESS] ]
[ tos %d [m %x] ]
[ tclass %d [m %x] ]
[ l4proto %d [m %x] ]
[ src-port %d [m %x] ]
[ dst-port %d [m %x] ]
[ spi %d [m %x] ]
[ vlan-etype %x [m %x] ]
[ vlan %x [m %x] ]
[ user-def %x [m %x] ]
[ dst-mac %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
[ action %d ] | [ vf %d queue %d ]
[ context %d ]
[ loc %d ] |
delete %d
ethtool [ FLAGS ] -T|--show-time-stamping DEVNAME Show time stamping capabilities
[ index N qualifier precise|approx ]
ethtool [ FLAGS ] --get-hwtimestamp-cfg DEVNAME Get selected hardware time stamping
ethtool [ FLAGS ] --set-hwtimestamp-cfg DEVNAME Select hardware time stamping
[ index N qualifier precise|approx ]
[ tx TX-TYPE ] [ rx-filter RX-FILTER ]
ethtool [ FLAGS ] -x|--show-rxfh-indir|--show-rxfh DEVNAME Show Rx flow hash indirection table and/or RSS hash key
[ context %d ]
ethtool [ FLAGS ] -X|--set-rxfh-indir|--rxfh DEVNAME Set Rx flow hash indirection table and/or RSS hash key
[ context %d|new ]
[ equal N | weight W0 W1 ... | default ]
[ hkey %x:%x:%x:%x:%x:.... ]
[ hfunc FUNC ]
[ xfrm symmetric-xor | symmetric-or-xor | none ]
[ delete ]
ethtool [ FLAGS ] -f|--flash DEVNAME Flash firmware image from the specified file to a region on the device
FILENAME [ REGION-NUMBER-TO-FLASH ]
ethtool [ FLAGS ] -P|--show-permaddr DEVNAME Show permanent hardware address
ethtool [ FLAGS ] -w|--get-dump DEVNAME Get dump flag, data
[ data FILENAME ]
ethtool [ FLAGS ] -W|--set-dump DEVNAME Set dump flag of the device
N
ethtool [ FLAGS ] -l|--show-channels DEVNAME Query Channels
ethtool [ FLAGS ] -L|--set-channels DEVNAME Set Channels
[ rx N ]
[ tx N ]
[ other N ]
[ combined N ]
ethtool [ FLAGS ] --show-priv-flags DEVNAME Query private flags
ethtool [ FLAGS ] --set-priv-flags DEVNAME Set private flags
FLAG on|off ...
ethtool [ FLAGS ] -m|--dump-module-eeprom|--module-info DEVNAME Query/Decode Module EEPROM information and optical diagnostics if available
[ raw on|off ]
[ hex on|off ]
[ pages on|off ]
[ offset N ]
[ length N ]
[ page N ]
[ bank N ]
[ i2c N ]
ethtool [ FLAGS ] --show-eee DEVNAME Show EEE settings
ethtool [ FLAGS ] --set-eee DEVNAME Set EEE settings
[ eee on|off ]
[ advertise %x ]
[ tx-lpi on|off ]
[ tx-timer %d ]
ethtool [ FLAGS ] --set-phy-tunable DEVNAME Set PHY tunable
[ downshift on|off [count N] ]
[ fast-link-down on|off [msecs N] ]
[ energy-detect-power-down on|off [msecs N] ]
[ short-cable-preset on|off ]
[ lpf-bandwidth N ]
[ dsp-eq-init-value N ]
ethtool [ FLAGS ] --get-phy-tunable DEVNAME Get PHY tunable
[ downshift ]
[ fast-link-down ]
[ energy-detect-power-down ]
[ short-cable-preset ]
[ lpf-bandwidth ]
[ dsp-eq-init-value ]
ethtool [ FLAGS ] --get-tunable DEVNAME Get tunable
[ rx-copybreak ]
[ tx-copybreak ]
[ tx-buf-size ]
[ pfc-prevention-tout ]
ethtool [ FLAGS ] --set-tunable DEVNAME Set tunable
[ rx-copybreak N ]
[ tx-copybreak N ]
[ tx-buf-size N ]
[ pfc-prevention-tout N ]
ethtool [ FLAGS ] --reset DEVNAME Reset components
[ flags %x ]
[ mgmt ]
[ mgmt-shared ]
[ irq ]
[ irq-shared ]
[ dma ]
[ dma-shared ]
[ filter ]
[ filter-shared ]
[ offload ]
[ offload-shared ]
[ mac ]
[ mac-shared ]
[ phy ]
[ phy-shared ]
[ ram ]
[ ram-shared ]
[ ap ]
[ ap-shared ]
[ dedicated ]
[ all ]
ethtool [ FLAGS ] --show-fec DEVNAME Show FEC settings
ethtool [ FLAGS ] --set-fec DEVNAME Set FEC settings
[ encoding auto|off|rs|baser|llrs [...] ]
ethtool [ FLAGS ] -Q|--per-queue DEVNAME Apply per-queue command.
The supported sub commands include --show-coalesce, --coalesce [queue_mask %x] SUB_COMMAND
ethtool [ FLAGS ] [ --phy PHY ] --cable-test DEVNAME Perform a cable test
ethtool [ FLAGS ] [ --phy PHY ] --cable-test-tdr DEVNAME Print cable test time domain reflectrometery data
[ first N ]
[ last N ]
[ step N ]
[ pair N ]
ethtool [ FLAGS ] --show-tunnels DEVNAME Show NIC tunnel offload information
ethtool [ FLAGS ] --show-module DEVNAME Show transceiver module settings
ethtool [ FLAGS ] --set-module DEVNAME Set transceiver module settings
[ power-mode-policy high|auto ]
ethtool [ FLAGS ] [ --phy PHY ] --get-plca-cfg DEVNAME Get PLCA configuration
ethtool [ FLAGS ] [ --phy PHY ] --set-plca-cfg DEVNAME Set PLCA configuration
[ enable on|off ]
[ node-id N ]
[ node-cnt N ]
[ to-tmr N ]
[ burst-cnt N ]
[ burst-tmr N ]
ethtool [ FLAGS ] [ --phy PHY ] --get-plca-status DEVNAME Get PLCA status information
ethtool [ FLAGS ] --show-mm DEVNAME Show MAC merge layer state
ethtool [ FLAGS ] --set-mm DEVNAME Set MAC merge layer parameters
[ verify-enabled on|off ]
[ verify-time N ]
[ tx-enabled on|off ]
[ pmac-enabled on|off ]
[ tx-min-frag-size 60-252 ]
ethtool [ FLAGS ] [ --phy PHY ] --show-pse DEVNAME Show settings for Power Sourcing Equipment
ethtool [ FLAGS ] [ --phy PHY ] --set-pse DEVNAME Set Power Sourcing Equipment settings
[ podl-pse-admin-control enable|disable ]
[ c33-pse-admin-control enable|disable ]
[ c33-pse-avail-pw-limit N ]
[ prio N ]
ethtool [ FLAGS ] --flash-module-firmware DEVNAME Flash transceiver module firmware
file FILE
[ pass PASS ]
ethtool [ FLAGS ] --show-phys DEVNAME List PHYs
ethtool [ FLAGS ] [ --phy PHY ] --show-mse DEVNAME Show Mean Square Error (MSE) diagnostics
ethtool [ FLAGS ] -h|--help Show this help
ethtool [ FLAGS ] --version Show version number
ethtool --monitor Show kernel notifications
( [ --all ]
| -s | --change
| -k | --show-features | --show-offload | -K | --features | --offload
| --show-priv-flags | --set-priv-flags
| -g | --show-ring | -G | --set-ring
| -l | --show-channels | -L | --set-channels
| -c | --show-coalesce | -C | --coalesce
| -a | --show-pause | -A | --pause
| --show-eee | --set-eee
| --cable-test
| --cable-test-tdr
| --show-module | --set-module
| --get-plca-cfg | --set-plca-cfg
| --pse-event )
[ DEVNAME | * ]
FLAGS:
--debug MASK turn on debugging messages
--disable-netlink do not use netlink, fall back to ioctl interface
-j|--json enable JSON output format (not supported by all commands)
-I|--include-statistics request device statistics related to the command (not supported by all commands)
Options (67)
| Option | Description | Source |
|---|---|---|
--debug MASK | turn on debugging messages | help |
--disable-netlink | Do not use netlink and fall back to the ioctl interface if possible. | help + man |
-h --help | Shows a short help message. (in the manual page but not in --help) | man |
--version | Shows the ethtool version number. (in the manual page but not in --help) | man |
--json | Output results in JavaScript Object Notation (JSON). (in the manual page but not in --help) | man |
-I --include-statistics | Include command-related statistics in the output. (in the manual page but not in --help) | man |
--cable-test --cable-test-tdr | (in the manual page but not in --help) | man |
-a --show-pause | Queries the specified Ethernet device for pause parameter information. (in the manual page but not in --help) | man |
-A --pause | Changes the pause parameters of the specified Ethernet device. (in the manual page but not in --help) | man |
-c --show-coalesce | Queries the specified network device for coalescing information. (in the manual page but not in --help) | man |
-C --coalesce | Changes the coalescing settings of the specified network device. (in the manual page but not in --help) | man |
-g --show-ring | Queries the specified network device for rx/tx ring parameter information. (in the manual page but not in --help) | man |
-G --set-ring | Changes the rx/tx ring parameters of the specified network device. (in the manual page but not in --help) | man |
-i --driver | Queries the specified network device for associated driver information. (in the manual page but not in --help) | man |
-d --register-dump | Retrieves and prints a register dump for the specified network device. (in the manual page but not in --help) | man |
-e --eeprom-dump | Retrieves and prints an EEPROM dump for the specified network device. (in the manual page but not in --help) | man |
-E --change-eeprom | If value is specified, changes EEPROM byte for the specified network device. (in the manual page but not in --help) | man |
-k --show-features | Queries the specified network device for the state of protocol offload and other features. (in the manual page but not in --help) | man |
-K --features | Changes the offload parameters and other features of the specified network device. (in the manual page but not in --help) | man |
-p --identify | Initiates adapter-specific action intended to enable an operator to easily identify the adapter by sight. (in the manual page but not in --help) | man |
-P --show-permaddr | Queries the specified network device for permanent hardware address. (in the manual page but not in --help) | man |
-r --negotiate | Restarts auto-negotiation on the specified Ethernet device, if auto-negotiation is enabled. (in the manual page but not in --help) | man |
-S --statistics | Queries the specified network device for standard (IEEE, IETF, etc.), or NIC- and driver-specific statistics. (in the manual page but not in --help) | man |
--all-groups | [--groups [eth-phy] [eth-mac] [eth-ctrl] [rmon]](#groups) (in the manual page but not in --help) | man |
--phy-statistics | Queries the specified network device for PHY specific statistics. (in the manual page but not in --help) | man |
-t --test | Executes adapter selftest on the specified network device. (in the manual page but not in --help) | man |
-s --change | Allows changing some or all settings of the specified network device. (in the manual page but not in --help) | man |
-n -u | Retrieves receive network flow classification options or rules. (in the manual page but not in --help) | man |
-N -U | Configures receive network flow classification options or rules. (in the manual page but not in --help) | man |
-1 Drop | context N (in the manual page but not in --help) | man |
-w --get-dump | Retrieves and prints firmware dump for the specified network device. (in the manual page but not in --help) | man |
-W --set-dump | Sets the dump flag for the device. (in the manual page but not in --help) | man |
-T --show-time-stamping | Show the device's time stamping capabilities and associated PTP hardware clock. (in the manual page but not in --help) | man |
--get-hwtimestamp-cfg | Show the selected time stamping PTP hardware clock configuration. (in the manual page but not in --help) | man |
--set-hwtimestamp-cfg | Sets the device's time stamping PTP hardware clock configuration. (in the manual page but not in --help) | man |
-x --show-rxfh-indir | Retrieves the receive flow hash indirection table and/or RSS hash key. (in the manual page but not in --help) | man |
-X --set-rxfh-indir | Configures the receive flow hash indirection table and/or RSS hash key. (in the manual page but not in --help) | man |
-f --flash | Write a firmware image to flash or other non-volatile memory on the device. (in the manual page but not in --help) | man |
-l --show-channels | Queries the specified network device for the numbers of channels it has. (in the manual page but not in --help) | man |
-L --set-channels | Changes the numbers of channels of the specified network device. (in the manual page but not in --help) | man |
-m --dump-module-eeprom | Retrieves and if possible decodes the EEPROM from plugin modules, e.g SFP+, QSFP. (in the manual page but not in --help) | man |
--show-priv-flags | Queries the specified network device for its private flags. (in the manual page but not in --help) | man |
--set-priv-flags | Sets the device's private flags as specified. (in the manual page but not in --help) | man |
--show-eee | Queries the specified network device for its support of Energy-Efficient Ethernet (according to the IEEE 802.3az specifications) (in the manual page but not in --help) | man |
--set-eee | Sets the device EEE behaviour. (in the manual page but not in --help) | man |
--set-phy-tunable | Sets the PHY tunable parameters. (in the manual page but not in --help) | man |
--get-phy-tunable | Gets the PHY tunable parameters. (in the manual page but not in --help) | man |
--get-tunable | Get the tunable parameters. (in the manual page but not in --help) | man |
--set-tunable | Set driver's tunable parameters. (in the manual page but not in --help) | man |
--reset | Reset hardware components specified by flags and components listed below (in the manual page but not in --help) | man |
--show-fec | Queries the specified network device for its support of Forward Error Correction. (in the manual page but not in --help) | man |
--set-fec | Configures Forward Error Correction for the specified network device. (in the manual page but not in --help) | man |
--cable-test-tdr | Perform a cable test and report the raw Time Domain Reflectometer data. (in the manual page but not in --help) | man |
--monitor | Listens to netlink notification and displays them. (in the manual page but not in --help) | man |
--show-tunnels | Show tunnel-related device capabilities and state. (in the manual page but not in --help) | man |
--show-module | Show the transceiver module's parameters. (in the manual page but not in --help) | man |
--set-module | Set the transceiver module's parameters. (in the manual page but not in --help) | man |
--get-plca-cfg | Show the current PLCA parameters for the given interface. (in the manual page but not in --help) | man |
--set-plca-cfg | Change the PLCA settings for the given interface. (in the manual page but not in --help) | man |
--get-plca-status | Show the current PLCA status for the given interface. (in the manual page but not in --help) | man |
--show-mm | Show the MAC Merge layer state. (in the manual page but not in --help) | man |
--set-mm | Set the MAC Merge layer parameters. (in the manual page but not in --help) | man |
--show-pse | Show the current Power Sourcing Equipment (PSE) status for the given interface. (in the manual page but not in --help) | man |
--set-pse | Set Power Sourcing Equipment (PSE) parameters. (in the manual page but not in --help) | man |
--show-mse | Show PHY Mean Square Error (MSE) diagnostics. (in the manual page but not in --help) | man |
--flash-module-firmware | Flash the transceiver module's firmware. (in the manual page but not in --help) | man |
--show-phys | Show the PHY devices attached to an interface, and the way they link together. (in the manual page but not in --help) | man |