From f5259c1b076d046f55be987adad67e1e2644a009 Mon Sep 17 00:00:00 2001 From: Ben Hutchings Date: Mon, 10 Jan 2011 15:29:58 +0000 Subject: ethtool.8: Substitute version at configure time Rename ethtool.8 to ethtool.8.in and let autoconf set the version. Signed-off-by: Ben Hutchings --- configure.ac | 2 +- ethtool.8 | 819 ----------------------------------------------------------- ethtool.8.in | 819 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 820 insertions(+), 820 deletions(-) delete mode 100644 ethtool.8 create mode 100644 ethtool.8.in diff --git a/configure.ac b/configure.ac index 9bc8c26..a96fd4d 100644 --- a/configure.ac +++ b/configure.ac @@ -29,5 +29,5 @@ dnl Checks for library functions. AC_HEADER_STDC AC_CHECK_FUNCS(socket strtol) -AC_CONFIG_FILES([Makefile ethtool.spec]) +AC_CONFIG_FILES([Makefile ethtool.spec ethtool.8]) AC_OUTPUT diff --git a/ethtool.8 b/ethtool.8 deleted file mode 100644 index 8c2137b..0000000 --- a/ethtool.8 +++ /dev/null @@ -1,819 +0,0 @@ -.\" -*- nroff -*- -.\" Copyright 1999 by David S. Miller. All Rights Reserved. -.\" Portions Copyright 2001 Sun Microsystems -.\" Portions Copyright 2007, 2009 Free Software Foundation, Inc. -.\" This file may be copied under the terms of the GNU Public License. -.\" -.\" .An - list of n alternative values as in "flav vanilla|strawberry" -.\" -.de A1 -\\fB\\$1\\fP|\\fB\\$2\\fP -.. -.de A2 -\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP -.. -.de A3 -\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP -.. -.de A4 -\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP -.. -.\" -.\" .Bn - same as above but framed by square brackets -.\" -.de B1 -[\\fB\\$1\\fP|\\fB\\$2\\fP] -.. -.de B2 -[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP] -.. -.de B3 -[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP] -.. -.de B4 -[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP] -.. -.\" -.\" \(*MA - mac address -.\" -.ds MA \fIxx\fP\fB:\fP\fIyy\fP\fB:\fP\fIzz\fP\fB:\fP\fIaa\fP\fB:\fP\fIbb\fP\fB:\fP\fIcc\fP -.\" -.\" \(*WO - wol flags -.\" -.ds WO \fBp\fP|\fBu\fP|\fBm\fP|\fBb\fP|\fBa\fP|\fBg\fP|\fBs\fP|\fBd\fP... -.\" -.\" \(*FL - flow type values -.\" -.ds FL \fBtcp4\fP|\fBudp4\fP|\fBah4\fP|\fBsctp4\fP|\fBtcp6\fP|\fBudp6\fP|\fBah6\fP|\fBsctp6\fP -.\" -.\" \(*HO - hash options -.\" -.ds HO \fBm\fP|\fBv\fP|\fBt\fP|\fBs\fP|\fBd\fP|\fBf\fP|\fBn\fP|\fBr\fP... -.\" Start URL. -.de UR -. ds m1 \\$1\" -. nh -. if \\n(mH \{\ -. \" Start diversion in a new environment. -. do ev URL-div -. do di URL-div -. \} -.. -.\" End URL. -.de UE -. ie \\n(mH \{\ -. br -. di -. ev -. -. \" Has there been one or more input lines for the link text? -. ie \\n(dn \{\ -. do HTML-NS "" -. \" Yes, strip off final newline of diversion and emit it. -. do chop URL-div -. do URL-div -\c -. do HTML-NS -. \} -. el \ -. do HTML-NS "\\*(m1" -\&\\$*\" -. \} -. el \ -\\*(la\\*(m1\\*(ra\\$*\" -. -. hy \\n(HY -.. - -.TH ETHTOOL 8 "January 2011" "Ethtool version 2.6.37" -.SH NAME -ethtool \- Display or change ethernet card settings -.SH SYNOPSIS -.B ethtool -.I ethX - -.B ethtool \-h|\-\-help - -.B ethtool \-a|\-\-show\-pause -.I ethX - -.B ethtool \-A|\-\-pause -.I ethX -.B2 autoneg on off -.B2 rx on off -.B2 tx on off - -.B ethtool \-c|\-\-show\-coalesce -.I ethX - -.B ethtool \-C|\-\-coalesce -.I ethX -.B2 adaptive-rx on off -.B2 adaptive-tx on off -.RB [ rx-usecs -.IR N ] -.RB [ rx-frames -.IR N ] -.RB [ rx-usecs-irq -.IR N ] -.RB [ rx-frames-irq -.IR N ] -.RB [ tx-usecs -.IR N ] -.RB [ tx-frames -.IR N ] -.RB [ tx-usecs-irq -.IR N ] -.RB [ tx-frames-irq -.IR N ] -.RB [ stats-block-usecs -.IR N ] -.RB [ pkt-rate-low -.IR N ] -.RB [ rx-usecs-low -.IR N ] -.RB [ rx-frames-low -.IR N ] -.RB [ tx-usecs-low -.IR N ] -.RB [ tx-frames-low -.IR N ] -.RB [ pkt-rate-high -.IR N ] -.RB [ rx-usecs-high -.IR N ] -.RB [ rx-frames-high -.IR N ] -.RB [ tx-usecs-high -.IR N ] -.RB [ tx-frames-high -.IR N ] -.RB [ sample-interval -.IR N ] - -.B ethtool \-g|\-\-show\-ring -.I ethX - -.B ethtool \-G|\-\-set\-ring -.I ethX -.RB [ rx -.IR N ] -.RB [ rx-mini -.IR N ] -.RB [ rx-jumbo -.IR N ] -.RB [ tx -.IR N ] - -.B ethtool \-i|\-\-driver -.I ethX - -.B ethtool \-d|\-\-register\-dump -.I ethX -.B2 raw on off -.B2 hex on off -.RB [ file -.IR name ] - -.B ethtool \-e|\-\-eeprom\-dump -.I ethX -.B2 raw on off -.RB [ offset -.IR N ] -.RB [ length -.IR N ] - -.B ethtool \-E|\-\-change\-eeprom -.I ethX -.RB [ magic -.IR N ] -.RB [ offset -.IR N ] -.RB [ length -.IR N ] -.RB [ value -.IR N ] - -.B ethtool \-k|\-\-show\-offload -.I ethX - -.B ethtool \-K|\-\-offload -.I ethX -.B2 rx on off -.B2 tx on off -.B2 sg on off -.B2 tso on off -.B2 ufo on off -.B2 gso on off -.B2 gro on off -.B2 lro on off -.B2 rxvlan on off -.B2 txvlan on off -.B2 rxhash on off - -.B ethtool \-p|\-\-identify -.I ethX -.RI [ N ] - -.B ethtool \-P|\-\-show-permaddr -.I ethX - -.B ethtool \-r|\-\-negotiate -.I ethX - -.B ethtool \-S|\-\-statistics -.I ethX - -.B ethtool \-t|\-\-test -.I ethX -.B1 offline online - -.B ethtool \-s -.I ethX -.BI speed \ N -.B2 duplex half full -.B4 port tp aui bnc mii fibre -.B2 autoneg on off -.RB [ advertise -.IR N ] -.RB [ phyad -.IR N ] -.B2 xcvr internal external -.RB [ wol \ \*(WO] -.RB [ sopass \ \*(MA] -.RB [ msglvl -.IR N \ | -.BI msglvl \ type -.A1 on off -.RB ...] - -.B ethtool \-n -.I ethX -.RB [ rx-flow-hash \ \*(FL] - -.B ethtool \-N -.I ethX -.RB [ rx-flow-hash \ \*(FL -.RB \ \*(HO] - -.B ethtool \-x|\-\-show\-rxfh\-indir -.I ethX - -.B ethtool \-X|\-\-set\-rxfh\-indir -.I ethX -.RB [\ equal -.IR N \ | -.BI weight\ W0 -.IR W1 -.RB ...\ ] - -.B ethtool \-f|\-\-flash -.I ethX -.RI FILE -.RI [ N ] - -.B ethtool \-u|\-\-show\-ntuple -.I ethX - -.TP -.BI ethtool\ \-U|\-\-config\-ntuple \ ethX -.RB { -.A3 flow-type tcp4 udp4 sctp4 -.RB [ src-ip -.IR addr -.RB [ src-ip-mask -.IR mask ]] -.RB [ dst-ip -.IR addr -.RB [ dst-ip-mask -.IR mask ]] -.RB [ src-port -.IR port -.RB [ src-port-mask -.IR mask ]] -.RB [ dst-port -.IR port -.RB [ dst-port-mask -.IR mask ]] -.br -.RB | \ flow-type\ ether -.RB [ src -.IR mac-addr -.RB [ src-mask -.IR mask ]] -.RB [ dst -.IR mac-addr -.RB [ dst-mask -.IR mask ]] -.RB [ proto -.IR N -.RB [ proto-mask -.IR mask ]]\ } -.br -.RB [ vlan -.IR VLAN-tag -.RB [ vlan-mask -.IR mask ]] -.RB [ user-def -.IR data -.RB [ user-def-mask -.IR mask ]] -.RI action \ N - -.SH DESCRIPTION -.BI ethtool -is used for querying settings of an ethernet device and changing them. - -.I ethX -is the name of the ethernet device on which ethtool should operate. - -.SH OPTIONS -.B ethtool -with a single argument specifying the device name prints current -settings of the specified device. -.TP -.B \-h \-\-help -Shows a short help message. -.TP -.B \-a \-\-show\-pause -Queries the specified ethernet device for pause parameter information. -.TP -.B \-A \-\-pause -Changes the pause parameters of the specified ethernet device. -.TP -.A2 autoneg on off -Specifies whether pause autonegotiation should be enabled. -.TP -.A2 rx on off -Specifies whether RX pause should be enabled. -.TP -.A2 tx on off -Specifies whether TX pause should be enabled. -.TP -.B \-c \-\-show\-coalesce -Queries the specified ethernet device for coalescing information. -.TP -.B \-C \-\-coalesce -Changes the coalescing settings of the specified ethernet device. -.TP -.B \-g \-\-show\-ring -Queries the specified ethernet device for rx/tx ring parameter information. -.TP -.B \-G \-\-set\-ring -Changes the rx/tx ring parameters of the specified ethernet device. -.TP -.BI rx \ N -Changes the number of ring entries for the Rx ring. -.TP -.BI rx-mini \ N -Changes the number of ring entries for the Rx Mini ring. -.TP -.BI rx-jumbo \ N -Changes the number of ring entries for the Rx Jumbo ring. -.TP -.BI tx \ N -Changes the number of ring entries for the Tx ring. -.TP -.B \-i \-\-driver -Queries the specified ethernet device for associated driver information. -.TP -.B \-d \-\-register\-dump -Retrieves and prints a register dump for the specified ethernet device. -The register format for some devices is known and decoded others -are printed in hex. -When -.I raw -is enabled, then ethtool dumps the raw register data to stdout. -If -.I file -is specified, then use contents of previous raw register dump, rather -than reading from the device. - -.TP -.B \-e \-\-eeprom\-dump -Retrieves and prints an EEPROM dump for the specified ethernet device. -When raw is enabled, then it dumps the raw EEPROM data to stdout. The -length and offset parameters allow dumping certain portions of the EEPROM. -Default is to dump the entire EEPROM. -.TP -.B \-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 EEPROM. -.TP -.B \-k \-\-show\-offload -Queries the specified ethernet device for offload information. -.TP -.B \-K \-\-offload -Changes the offload parameters of the specified ethernet device. -.TP -.A2 rx on off -Specifies whether RX checksumming should be enabled. -.TP -.A2 tx on off -Specifies whether TX checksumming should be enabled. -.TP -.A2 sg on off -Specifies whether scatter-gather should be enabled. -.TP -.A2 tso on off -Specifies whether TCP segmentation offload should be enabled. -.TP -.A2 ufo on off -Specifies whether UDP fragmentation offload should be enabled -.TP -.A2 gso on off -Specifies whether generic segmentation offload should be enabled -.TP -.A2 gro on off -Specifies whether generic receive offload should be enabled -.TP -.A2 lro on off -Specifies whether large receive offload should be enabled -.TP -.A2 rxvlan on off -Specifies whether RX VLAN acceleration should be enabled -.TP -.A2 txvlan on off -Specifies whether TX VLAN acceleration should be enabled -.TP -.A2 rxhash on off -Specifies whether receive hashing offload should be enabled -.TP -.B \-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. -.TP -.B N -Length of time to perform phys-id, in seconds. -.TP -.B \-P \-\-show-permaddr -Queries the specified ethernet device for permanent hardware address. -.TP -.B \-r \-\-negotiate -Restarts auto-negotiation on the specified ethernet device, if -auto-negotiation is enabled. -.TP -.B \-S \-\-statistics -Queries the specified ethernet device for NIC- and driver-specific -statistics. -.TP -.B \-t \-\-test -Executes adapter selftest on the specified ethernet device. Possible test modes are: -.TP -.A1 offline online -defines test type: -.B offline -(default) means to perform full set of tests possibly causing normal operation interruption during the tests, -.B online -means to perform limited set of tests do not interrupting normal adapter operation. -.TP -.B \-s \-\-change -Allows changing some or all settings of the specified ethernet device. -All following options only apply if -.B \-s -was specified. -.TP -.BI speed \ N -Set speed in Mb/s. -.B ethtool -with just the device name as an argument will show you the supported device speeds. -.TP -.A2 duplex half full -Sets full or half duplex mode. -.TP -.A4 port tp aui bnc mii fibre -Selects device port. -.TP -.A2 autoneg on off -Specifies whether autonegotiation should be enabled. Autonegotiation -is enabled by deafult, but in some network devices may have trouble -with it, so you can disable it if really necessary. -.TP -.BI 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: -.RS -.PD 0 -.TP 3 -.BR "0x001" " 10 Half" -.TP 3 -.BR "0x002" " 10 Full" -.TP 3 -.BR "0x004" " 100 Half" -.TP 3 -.BR "0x008" " 100 Full" -.TP 3 -.BR "0x010" " 1000 Half" "(not supported by IEEE standards)" -.TP 3 -.BR "0x020" " 1000 Full" -.TP 3 -.BR "0x8000" " 2500 Full" "(not supported by IEEE standards)" -.TP 3 -.BR "0x1000" " 10000 Full" -.TP 3 -.BR "0x03F" " Auto" -.PD -.RE -.TP -.BI phyad \ N -PHY address. -.TP -.A2 xcvr internal external -Selects transceiver type. Currently only internal and external can be -specified, in the future further types might be added. -.TP -.BR wol \ \*(WO -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. -.RS -.PD 0 -.TP 3 -.B p -Wake on phy activity -.TP 3 -.B u -Wake on unicast messages -.TP 3 -.B m -Wake on multicast messages -.TP 3 -.B b -Wake on broadcast messages -.TP 3 -.B a -Wake on ARP -.TP 3 -.B g -Wake on MagicPacket(tm) -.TP 3 -.B s -Enable SecureOn(tm) password for MagicPacket(tm) -.TP 3 -.B d -Disable (wake on nothing). This option clears all previous options. -.PD -.RE -.TP -.B sopass \*(MA\c -Sets the SecureOn(tm) password. The argument to this option must be 6 -bytes in ethernet MAC hex format (\*(MA). -.PP -.BI msglvl \ N -.br -.BI msglvl \ type -.A1 on off -.RB ... -.RS -Sets the driver message type flags by name or number. \fItype\fR -names the type of message to enable or disable; \fIN\fR specifies the -new flags numerically. The defined type names and numbers are: -.PD 0 -.TP 12 -.B drv -0x0001 General driver status -.TP 12 -.B probe -0x0002 Hardware probing -.TP 12 -.B link -0x0004 Link state -.TP 12 -.B timer -0x0008 Periodic status check -.TP 12 -.B ifdown -0x0010 Interface being brought down -.TP 12 -.B ifup -0x0020 Interface being brought up -.TP 12 -.B rx_err -0x0040 Receive error -.TP 12 -.B tx_err -0x0080 Transmit error -.TP 12 -.B tx_queued -0x0100 Transmit queueing -.TP 12 -.B intr -0x0200 Interrupt handling -.TP 12 -.B tx_done -0x0400 Transmit completion -.TP 12 -.B rx_status -0x0800 Receive completion -.TP 12 -.B pktdata -0x1000 Packet contents -.TP 12 -.B hw -0x2000 Hardware status -.TP 12 -.B wol -0x4000 Wake-on-LAN status -.PP -The precise meanings of these type flags differ between drivers. -.PD -.RE -.TP -.B \-n \-\-show-nfc -Retrieves the receive network flow classification configurations. -.TP -.BR rx-flow-hash \ \*(FL -Retrieves the hash options for the specified network traffic type. -.RS -.PD 0 -.TP 3 -.BR "tcp4" " TCP over IPv4" -.TP 3 -.BR "udp4" " UDP over IPv4" -.TP 3 -.BR "ah4" " IPSEC AH/ESP over IPv4" -.TP 3 -.BR "sctp4" " SCTP over IPv4" -.TP 3 -.BR "tcp6" " TCP over IPv6" -.TP 3 -.BR "udp6" " UDP over IPv6" -.TP 3 -.BR "ah6" " IPSEC AH/ESP over IPv6" -.TP 3 -.BR "sctp6" " SCTP over IPv6" -.PD -.RE -.TP -.B \-N \-\-config-nfc -Configures the receive network flow classification. -.TP -.BR rx-flow-hash \ \*(FL \ \*(HO -Configures the hash options for the specified network traffic type. -.RS -.PD 0 -.TP 3 -.B m -Hash on the Layer 2 destination address of the rx packet. -.TP 3 -.B v -Hash on the VLAN tag of the rx packet. -.TP 3 -.B t -Hash on the Layer 3 protocol field of the rx packet. -.TP 3 -.B s -Hash on the IP source address of the rx packet. -.TP 3 -.B d -Hash on the IP destination address of the rx packet. -.TP 3 -.B f -Hash on bytes 0 and 1 of the Layer 4 header of the rx packet. -.TP 3 -.B n -Hash on bytes 2 and 3 of the Layer 4 header of the rx packet. -.TP 3 -.B r -Discard all packets of this flow type. When this option is set, all other options are ignored. -.PD -.RE -.TP -.B \-x \-\-show\-rxfh\-indir -Retrieves the receive flow hash indirection table. -.TP -.B \-X \-\-set\-rxfh\-indir -Configures the receive flow hash indirection table. -.TP -.BI equal\ N -Sets the receive flow hash indirection table to spread flows evenly -between the first \fIN\fR receive queues. -.TP -\fBweight\fR \fIW0 W1\fR ... -Sets the receive flow hash indirection table to spread flows between -receive queues according to the given weights. The sum of the weights -must be non-zero and must not exceed the size of the indirection table. -.TP -.B \-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. -.TP -.B N -A number to identify flash region where the image should be flashed. -Default region is 0 which denotes all regions in the flash. -.PD -.RE -.TP -.B \-u \-\-show-ntuple -Get Rx ntuple filters and actions, then display them to the user. -.PD -.RE -.TP -.B \-U \-\-config-ntuple -Configure Rx ntuple filters and actions -.TP -.B flow-type tcp4|udp4|sctp4|ether -.RS -.PD 0 -.TP 3 -.BR "tcp4" " TCP over IPv4" -.TP 3 -.BR "udp4" " UDP over IPv4" -.TP 3 -.BR "sctp4" " SCTP over IPv4" -.TP 3 -.BR "ether" " Ethernet" -.PD -.RE -.TP -.BI src-ip \ addr -Includes the source IP address, specified using dotted-quad notation -or as a single 32-bit number. -.TP -.BI src-ip-mask \ mask -Specify a mask for the source IP address. -.TP -.BI dst-ip \ addr -Includes the destination IP address. -.TP -.BI dst-ip-mask \ mask -Specify a mask for the destination IP address. -.TP -.BI src-port \ port -Includes the source port. -.TP -.BI src-port-mask \ mask -Specify a mask for the source port. -.TP -.BI dst-port \ port -Includes the destination port. -.TP -.BI dst-port-mask \ mask -Specify a mask for the destination port. -.TP -.BI src \ mac-addr -Includes the source MAC address, specified as 6 bytes in hexadecimal -separated by colons. -.TP -.BI src-mask \ mask -Specify a mask for the source MAC address. -.TP -.BI dst \ mac-addr -Includes the destination MAC address. -.TP -.BI dst-mask \ mask -Specify a mask for the destination MAC address. -.TP -.BI proto \ N -Includes the Ethernet protocol number (ethertype). -.TP -.BI proto-mask \ mask -Specify a mask for the Ethernet protocol number. -.TP -.BI vlan \ VLAN-tag -Includes the VLAN tag. -.TP -.BI vlan-mask \ mask -Specify a mask for the VLAN tag. -.TP -.BI user-def \ data -Includes 64-bits of user-specific data. -.TP -.BI user-def-mask \ mask -Specify a mask for the user-specific data. -.TP -.BI action \ N -Specifies the Rx queue to send packets to, or some other action. -.RS -.PD 0 -.TP 3 -.BR "-2" " Clear the filter" -.TP 3 -.BR "-1" " Drop the matched flow" -.TP 3 -.BR "0 or higher" " Rx queue to route the flow" -.PD -.RE -.SH BUGS -Not supported (in part or whole) on all ethernet drivers. -.SH AUTHOR -.B ethtool -was written by David Miller. - -Modifications by -Jeff Garzik, -Tim Hockin, -Jakub Jelinek, -Andre Majorel, -Eli Kupermann, -Scott Feldman, -Andi Kleen. -.SH AVAILABILITY -.B ethtool -is available from -.UR http://www.kernel.org/pub/software/network/ethtool/ -.UE diff --git a/ethtool.8.in b/ethtool.8.in new file mode 100644 index 0000000..75f63ba --- /dev/null +++ b/ethtool.8.in @@ -0,0 +1,819 @@ +.\" -*- nroff -*- +.\" Copyright 1999 by David S. Miller. All Rights Reserved. +.\" Portions Copyright 2001 Sun Microsystems +.\" Portions Copyright 2007, 2009 Free Software Foundation, Inc. +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" .An - list of n alternative values as in "flav vanilla|strawberry" +.\" +.de A1 +\\fB\\$1\\fP|\\fB\\$2\\fP +.. +.de A2 +\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP +.. +.de A3 +\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP +.. +.de A4 +\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP +.. +.\" +.\" .Bn - same as above but framed by square brackets +.\" +.de B1 +[\\fB\\$1\\fP|\\fB\\$2\\fP] +.. +.de B2 +[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP] +.. +.de B3 +[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP] +.. +.de B4 +[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP] +.. +.\" +.\" \(*MA - mac address +.\" +.ds MA \fIxx\fP\fB:\fP\fIyy\fP\fB:\fP\fIzz\fP\fB:\fP\fIaa\fP\fB:\fP\fIbb\fP\fB:\fP\fIcc\fP +.\" +.\" \(*WO - wol flags +.\" +.ds WO \fBp\fP|\fBu\fP|\fBm\fP|\fBb\fP|\fBa\fP|\fBg\fP|\fBs\fP|\fBd\fP... +.\" +.\" \(*FL - flow type values +.\" +.ds FL \fBtcp4\fP|\fBudp4\fP|\fBah4\fP|\fBsctp4\fP|\fBtcp6\fP|\fBudp6\fP|\fBah6\fP|\fBsctp6\fP +.\" +.\" \(*HO - hash options +.\" +.ds HO \fBm\fP|\fBv\fP|\fBt\fP|\fBs\fP|\fBd\fP|\fBf\fP|\fBn\fP|\fBr\fP... +.\" Start URL. +.de UR +. ds m1 \\$1\" +. nh +. if \\n(mH \{\ +. \" Start diversion in a new environment. +. do ev URL-div +. do di URL-div +. \} +.. +.\" End URL. +.de UE +. ie \\n(mH \{\ +. br +. di +. ev +. +. \" Has there been one or more input lines for the link text? +. ie \\n(dn \{\ +. do HTML-NS "" +. \" Yes, strip off final newline of diversion and emit it. +. do chop URL-div +. do URL-div +\c +. do HTML-NS +. \} +. el \ +. do HTML-NS "\\*(m1" +\&\\$*\" +. \} +. el \ +\\*(la\\*(m1\\*(ra\\$*\" +. +. hy \\n(HY +.. + +.TH ETHTOOL 8 "January 2011" "Ethtool version @VERSION@" +.SH NAME +ethtool \- Display or change ethernet card settings +.SH SYNOPSIS +.B ethtool +.I ethX + +.B ethtool \-h|\-\-help + +.B ethtool \-a|\-\-show\-pause +.I ethX + +.B ethtool \-A|\-\-pause +.I ethX +.B2 autoneg on off +.B2 rx on off +.B2 tx on off + +.B ethtool \-c|\-\-show\-coalesce +.I ethX + +.B ethtool \-C|\-\-coalesce +.I ethX +.B2 adaptive-rx on off +.B2 adaptive-tx on off +.RB [ rx-usecs +.IR N ] +.RB [ rx-frames +.IR N ] +.RB [ rx-usecs-irq +.IR N ] +.RB [ rx-frames-irq +.IR N ] +.RB [ tx-usecs +.IR N ] +.RB [ tx-frames +.IR N ] +.RB [ tx-usecs-irq +.IR N ] +.RB [ tx-frames-irq +.IR N ] +.RB [ stats-block-usecs +.IR N ] +.RB [ pkt-rate-low +.IR N ] +.RB [ rx-usecs-low +.IR N ] +.RB [ rx-frames-low +.IR N ] +.RB [ tx-usecs-low +.IR N ] +.RB [ tx-frames-low +.IR N ] +.RB [ pkt-rate-high +.IR N ] +.RB [ rx-usecs-high +.IR N ] +.RB [ rx-frames-high +.IR N ] +.RB [ tx-usecs-high +.IR N ] +.RB [ tx-frames-high +.IR N ] +.RB [ sample-interval +.IR N ] + +.B ethtool \-g|\-\-show\-ring +.I ethX + +.B ethtool \-G|\-\-set\-ring +.I ethX +.RB [ rx +.IR N ] +.RB [ rx-mini +.IR N ] +.RB [ rx-jumbo +.IR N ] +.RB [ tx +.IR N ] + +.B ethtool \-i|\-\-driver +.I ethX + +.B ethtool \-d|\-\-register\-dump +.I ethX +.B2 raw on off +.B2 hex on off +.RB [ file +.IR name ] + +.B ethtool \-e|\-\-eeprom\-dump +.I ethX +.B2 raw on off +.RB [ offset +.IR N ] +.RB [ length +.IR N ] + +.B ethtool \-E|\-\-change\-eeprom +.I ethX +.RB [ magic +.IR N ] +.RB [ offset +.IR N ] +.RB [ length +.IR N ] +.RB [ value +.IR N ] + +.B ethtool \-k|\-\-show\-offload +.I ethX + +.B ethtool \-K|\-\-offload +.I ethX +.B2 rx on off +.B2 tx on off +.B2 sg on off +.B2 tso on off +.B2 ufo on off +.B2 gso on off +.B2 gro on off +.B2 lro on off +.B2 rxvlan on off +.B2 txvlan on off +.B2 rxhash on off + +.B ethtool \-p|\-\-identify +.I ethX +.RI [ N ] + +.B ethtool \-P|\-\-show-permaddr +.I ethX + +.B ethtool \-r|\-\-negotiate +.I ethX + +.B ethtool \-S|\-\-statistics +.I ethX + +.B ethtool \-t|\-\-test +.I ethX +.B1 offline online + +.B ethtool \-s +.I ethX +.BI speed \ N +.B2 duplex half full +.B4 port tp aui bnc mii fibre +.B2 autoneg on off +.RB [ advertise +.IR N ] +.RB [ phyad +.IR N ] +.B2 xcvr internal external +.RB [ wol \ \*(WO] +.RB [ sopass \ \*(MA] +.RB [ msglvl +.IR N \ | +.BI msglvl \ type +.A1 on off +.RB ...] + +.B ethtool \-n +.I ethX +.RB [ rx-flow-hash \ \*(FL] + +.B ethtool \-N +.I ethX +.RB [ rx-flow-hash \ \*(FL +.RB \ \*(HO] + +.B ethtool \-x|\-\-show\-rxfh\-indir +.I ethX + +.B ethtool \-X|\-\-set\-rxfh\-indir +.I ethX +.RB [\ equal +.IR N \ | +.BI weight\ W0 +.IR W1 +.RB ...\ ] + +.B ethtool \-f|\-\-flash +.I ethX +.RI FILE +.RI [ N ] + +.B ethtool \-u|\-\-show\-ntuple +.I ethX + +.TP +.BI ethtool\ \-U|\-\-config\-ntuple \ ethX +.RB { +.A3 flow-type tcp4 udp4 sctp4 +.RB [ src-ip +.IR addr +.RB [ src-ip-mask +.IR mask ]] +.RB [ dst-ip +.IR addr +.RB [ dst-ip-mask +.IR mask ]] +.RB [ src-port +.IR port +.RB [ src-port-mask +.IR mask ]] +.RB [ dst-port +.IR port +.RB [ dst-port-mask +.IR mask ]] +.br +.RB | \ flow-type\ ether +.RB [ src +.IR mac-addr +.RB [ src-mask +.IR mask ]] +.RB [ dst +.IR mac-addr +.RB [ dst-mask +.IR mask ]] +.RB [ proto +.IR N +.RB [ proto-mask +.IR mask ]]\ } +.br +.RB [ vlan +.IR VLAN-tag +.RB [ vlan-mask +.IR mask ]] +.RB [ user-def +.IR data +.RB [ user-def-mask +.IR mask ]] +.RI action \ N + +.SH DESCRIPTION +.BI ethtool +is used for querying settings of an ethernet device and changing them. + +.I ethX +is the name of the ethernet device on which ethtool should operate. + +.SH OPTIONS +.B ethtool +with a single argument specifying the device name prints current +settings of the specified device. +.TP +.B \-h \-\-help +Shows a short help message. +.TP +.B \-a \-\-show\-pause +Queries the specified ethernet device for pause parameter information. +.TP +.B \-A \-\-pause +Changes the pause parameters of the specified ethernet device. +.TP +.A2 autoneg on off +Specifies whether pause autonegotiation should be enabled. +.TP +.A2 rx on off +Specifies whether RX pause should be enabled. +.TP +.A2 tx on off +Specifies whether TX pause should be enabled. +.TP +.B \-c \-\-show\-coalesce +Queries the specified ethernet device for coalescing information. +.TP +.B \-C \-\-coalesce +Changes the coalescing settings of the specified ethernet device. +.TP +.B \-g \-\-show\-ring +Queries the specified ethernet device for rx/tx ring parameter information. +.TP +.B \-G \-\-set\-ring +Changes the rx/tx ring parameters of the specified ethernet device. +.TP +.BI rx \ N +Changes the number of ring entries for the Rx ring. +.TP +.BI rx-mini \ N +Changes the number of ring entries for the Rx Mini ring. +.TP +.BI rx-jumbo \ N +Changes the number of ring entries for the Rx Jumbo ring. +.TP +.BI tx \ N +Changes the number of ring entries for the Tx ring. +.TP +.B \-i \-\-driver +Queries the specified ethernet device for associated driver information. +.TP +.B \-d \-\-register\-dump +Retrieves and prints a register dump for the specified ethernet device. +The register format for some devices is known and decoded others +are printed in hex. +When +.I raw +is enabled, then ethtool dumps the raw register data to stdout. +If +.I file +is specified, then use contents of previous raw register dump, rather +than reading from the device. + +.TP +.B \-e \-\-eeprom\-dump +Retrieves and prints an EEPROM dump for the specified ethernet device. +When raw is enabled, then it dumps the raw EEPROM data to stdout. The +length and offset parameters allow dumping certain portions of the EEPROM. +Default is to dump the entire EEPROM. +.TP +.B \-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 EEPROM. +.TP +.B \-k \-\-show\-offload +Queries the specified ethernet device for offload information. +.TP +.B \-K \-\-offload +Changes the offload parameters of the specified ethernet device. +.TP +.A2 rx on off +Specifies whether RX checksumming should be enabled. +.TP +.A2 tx on off +Specifies whether TX checksumming should be enabled. +.TP +.A2 sg on off +Specifies whether scatter-gather should be enabled. +.TP +.A2 tso on off +Specifies whether TCP segmentation offload should be enabled. +.TP +.A2 ufo on off +Specifies whether UDP fragmentation offload should be enabled +.TP +.A2 gso on off +Specifies whether generic segmentation offload should be enabled +.TP +.A2 gro on off +Specifies whether generic receive offload should be enabled +.TP +.A2 lro on off +Specifies whether large receive offload should be enabled +.TP +.A2 rxvlan on off +Specifies whether RX VLAN acceleration should be enabled +.TP +.A2 txvlan on off +Specifies whether TX VLAN acceleration should be enabled +.TP +.A2 rxhash on off +Specifies whether receive hashing offload should be enabled +.TP +.B \-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. +.TP +.B N +Length of time to perform phys-id, in seconds. +.TP +.B \-P \-\-show-permaddr +Queries the specified ethernet device for permanent hardware address. +.TP +.B \-r \-\-negotiate +Restarts auto-negotiation on the specified ethernet device, if +auto-negotiation is enabled. +.TP +.B \-S \-\-statistics +Queries the specified ethernet device for NIC- and driver-specific +statistics. +.TP +.B \-t \-\-test +Executes adapter selftest on the specified ethernet device. Possible test modes are: +.TP +.A1 offline online +defines test type: +.B offline +(default) means to perform full set of tests possibly causing normal operation interruption during the tests, +.B online +means to perform limited set of tests do not interrupting normal adapter operation. +.TP +.B \-s \-\-change +Allows changing some or all settings of the specified ethernet device. +All following options only apply if +.B \-s +was specified. +.TP +.BI speed \ N +Set speed in Mb/s. +.B ethtool +with just the device name as an argument will show you the supported device speeds. +.TP +.A2 duplex half full +Sets full or half duplex mode. +.TP +.A4 port tp aui bnc mii fibre +Selects device port. +.TP +.A2 autoneg on off +Specifies whether autonegotiation should be enabled. Autonegotiation +is enabled by deafult, but in some network devices may have trouble +with it, so you can disable it if really necessary. +.TP +.BI 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: +.RS +.PD 0 +.TP 3 +.BR "0x001" " 10 Half" +.TP 3 +.BR "0x002" " 10 Full" +.TP 3 +.BR "0x004" " 100 Half" +.TP 3 +.BR "0x008" " 100 Full" +.TP 3 +.BR "0x010" " 1000 Half" "(not supported by IEEE standards)" +.TP 3 +.BR "0x020" " 1000 Full" +.TP 3 +.BR "0x8000" " 2500 Full" "(not supported by IEEE standards)" +.TP 3 +.BR "0x1000" " 10000 Full" +.TP 3 +.BR "0x03F" " Auto" +.PD +.RE +.TP +.BI phyad \ N +PHY address. +.TP +.A2 xcvr internal external +Selects transceiver type. Currently only internal and external can be +specified, in the future further types might be added. +.TP +.BR wol \ \*(WO +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. +.RS +.PD 0 +.TP 3 +.B p +Wake on phy activity +.TP 3 +.B u +Wake on unicast messages +.TP 3 +.B m +Wake on multicast messages +.TP 3 +.B b +Wake on broadcast messages +.TP 3 +.B a +Wake on ARP +.TP 3 +.B g +Wake on MagicPacket(tm) +.TP 3 +.B s +Enable SecureOn(tm) password for MagicPacket(tm) +.TP 3 +.B d +Disable (wake on nothing). This option clears all previous options. +.PD +.RE +.TP +.B sopass \*(MA\c +Sets the SecureOn(tm) password. The argument to this option must be 6 +bytes in ethernet MAC hex format (\*(MA). +.PP +.BI msglvl \ N +.br +.BI msglvl \ type +.A1 on off +.RB ... +.RS +Sets the driver message type flags by name or number. \fItype\fR +names the type of message to enable or disable; \fIN\fR specifies the +new flags numerically. The defined type names and numbers are: +.PD 0 +.TP 12 +.B drv +0x0001 General driver status +.TP 12 +.B probe +0x0002 Hardware probing +.TP 12 +.B link +0x0004 Link state +.TP 12 +.B timer +0x0008 Periodic status check +.TP 12 +.B ifdown +0x0010 Interface being brought down +.TP 12 +.B ifup +0x0020 Interface being brought up +.TP 12 +.B rx_err +0x0040 Receive error +.TP 12 +.B tx_err +0x0080 Transmit error +.TP 12 +.B tx_queued +0x0100 Transmit queueing +.TP 12 +.B intr +0x0200 Interrupt handling +.TP 12 +.B tx_done +0x0400 Transmit completion +.TP 12 +.B rx_status +0x0800 Receive completion +.TP 12 +.B pktdata +0x1000 Packet contents +.TP 12 +.B hw +0x2000 Hardware status +.TP 12 +.B wol +0x4000 Wake-on-LAN status +.PP +The precise meanings of these type flags differ between drivers. +.PD +.RE +.TP +.B \-n \-\-show-nfc +Retrieves the receive network flow classification configurations. +.TP +.BR rx-flow-hash \ \*(FL +Retrieves the hash options for the specified network traffic type. +.RS +.PD 0 +.TP 3 +.BR "tcp4" " TCP over IPv4" +.TP 3 +.BR "udp4" " UDP over IPv4" +.TP 3 +.BR "ah4" " IPSEC AH/ESP over IPv4" +.TP 3 +.BR "sctp4" " SCTP over IPv4" +.TP 3 +.BR "tcp6" " TCP over IPv6" +.TP 3 +.BR "udp6" " UDP over IPv6" +.TP 3 +.BR "ah6" " IPSEC AH/ESP over IPv6" +.TP 3 +.BR "sctp6" " SCTP over IPv6" +.PD +.RE +.TP +.B \-N \-\-config-nfc +Configures the receive network flow classification. +.TP +.BR rx-flow-hash \ \*(FL \ \*(HO +Configures the hash options for the specified network traffic type. +.RS +.PD 0 +.TP 3 +.B m +Hash on the Layer 2 destination address of the rx packet. +.TP 3 +.B v +Hash on the VLAN tag of the rx packet. +.TP 3 +.B t +Hash on the Layer 3 protocol field of the rx packet. +.TP 3 +.B s +Hash on the IP source address of the rx packet. +.TP 3 +.B d +Hash on the IP destination address of the rx packet. +.TP 3 +.B f +Hash on bytes 0 and 1 of the Layer 4 header of the rx packet. +.TP 3 +.B n +Hash on bytes 2 and 3 of the Layer 4 header of the rx packet. +.TP 3 +.B r +Discard all packets of this flow type. When this option is set, all other options are ignored. +.PD +.RE +.TP +.B \-x \-\-show\-rxfh\-indir +Retrieves the receive flow hash indirection table. +.TP +.B \-X \-\-set\-rxfh\-indir +Configures the receive flow hash indirection table. +.TP +.BI equal\ N +Sets the receive flow hash indirection table to spread flows evenly +between the first \fIN\fR receive queues. +.TP +\fBweight\fR \fIW0 W1\fR ... +Sets the receive flow hash indirection table to spread flows between +receive queues according to the given weights. The sum of the weights +must be non-zero and must not exceed the size of the indirection table. +.TP +.B \-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. +.TP +.B N +A number to identify flash region where the image should be flashed. +Default region is 0 which denotes all regions in the flash. +.PD +.RE +.TP +.B \-u \-\-show-ntuple +Get Rx ntuple filters and actions, then display them to the user. +.PD +.RE +.TP +.B \-U \-\-config-ntuple +Configure Rx ntuple filters and actions +.TP +.B flow-type tcp4|udp4|sctp4|ether +.RS +.PD 0 +.TP 3 +.BR "tcp4" " TCP over IPv4" +.TP 3 +.BR "udp4" " UDP over IPv4" +.TP 3 +.BR "sctp4" " SCTP over IPv4" +.TP 3 +.BR "ether" " Ethernet" +.PD +.RE +.TP +.BI src-ip \ addr +Includes the source IP address, specified using dotted-quad notation +or as a single 32-bit number. +.TP +.BI src-ip-mask \ mask +Specify a mask for the source IP address. +.TP +.BI dst-ip \ addr +Includes the destination IP address. +.TP +.BI dst-ip-mask \ mask +Specify a mask for the destination IP address. +.TP +.BI src-port \ port +Includes the source port. +.TP +.BI src-port-mask \ mask +Specify a mask for the source port. +.TP +.BI dst-port \ port +Includes the destination port. +.TP +.BI dst-port-mask \ mask +Specify a mask for the destination port. +.TP +.BI src \ mac-addr +Includes the source MAC address, specified as 6 bytes in hexadecimal +separated by colons. +.TP +.BI src-mask \ mask +Specify a mask for the source MAC address. +.TP +.BI dst \ mac-addr +Includes the destination MAC address. +.TP +.BI dst-mask \ mask +Specify a mask for the destination MAC address. +.TP +.BI proto \ N +Includes the Ethernet protocol number (ethertype). +.TP +.BI proto-mask \ mask +Specify a mask for the Ethernet protocol number. +.TP +.BI vlan \ VLAN-tag +Includes the VLAN tag. +.TP +.BI vlan-mask \ mask +Specify a mask for the VLAN tag. +.TP +.BI user-def \ data +Includes 64-bits of user-specific data. +.TP +.BI user-def-mask \ mask +Specify a mask for the user-specific data. +.TP +.BI action \ N +Specifies the Rx queue to send packets to, or some other action. +.RS +.PD 0 +.TP 3 +.BR "-2" " Clear the filter" +.TP 3 +.BR "-1" " Drop the matched flow" +.TP 3 +.BR "0 or higher" " Rx queue to route the flow" +.PD +.RE +.SH BUGS +Not supported (in part or whole) on all ethernet drivers. +.SH AUTHOR +.B ethtool +was written by David Miller. + +Modifications by +Jeff Garzik, +Tim Hockin, +Jakub Jelinek, +Andre Majorel, +Eli Kupermann, +Scott Feldman, +Andi Kleen. +.SH AVAILABILITY +.B ethtool +is available from +.UR http://www.kernel.org/pub/software/network/ethtool/ +.UE -- cgit v1.2.1