1ETHTOOL(8)                  System Manager's Manual                 ETHTOOL(8)
2
3
4

NAME

6       ethtool - query or control network driver and hardware settings
7

SYNOPSIS

9       ethtool devname
10
11       ethtool -h|--help
12
13       ethtool --version
14
15       ethtool -a|--show-pause devname
16
17       ethtool -A|--pause devname [autoneg on|off] [rx on|off] [tx on|off]
18
19       ethtool -c|--show-coalesce devname
20
21       ethtool -C|--coalesce devname [adaptive-rx on|off] [adaptive-tx on|off]
22              [rx-usecs N] [rx-frames N] [rx-usecs-irq N] [rx-frames-irq N]
23              [tx-usecs N] [tx-frames N] [tx-usecs-irq N] [tx-frames-irq N]
24              [stats-block-usecs N] [pkt-rate-low N] [rx-usecs-low N]
25              [rx-frames-low N] [tx-usecs-low N] [tx-frames-low N]
26              [pkt-rate-high N] [rx-usecs-high N] [rx-frames-high N]
27              [tx-usecs-high N] [tx-frames-high N] [sample-interval N]
28
29       ethtool -g|--show-ring devname
30
31       ethtool -G|--set-ring devname [rx N] [rx-mini N] [rx-jumbo N] [tx N]
32
33       ethtool -i|--driver devname
34
35       ethtool -d|--register-dump devname [raw on|off] [hex on|off] [file
36              name]
37
38       ethtool -e|--eeprom-dump devname [raw on|off] [offset N] [length N]
39
40       ethtool -E|--change-eeprom devname [magic N] [offset N] [length N]
41              [value N]
42
43       ethtool -k|--show-features|--show-offload devname
44
45       ethtool -K|--features|--offload devname feature on|off ...
46
47       ethtool -p|--identify devname [N]
48
49       ethtool -P|--show-permaddr devname
50
51       ethtool -r|--negotiate devname
52
53       ethtool -S|--statistics devname
54
55       ethtool --phy-statistics devname
56
57       ethtool -t|--test devname [offline|online|external_lb]
58
59       ethtool -s devname [speed N] [duplex half|full] [port tp|aui|bnc|mii]
60              [mdix auto|on|off] [autoneg on|off] [advertise N] [phyad N]
61              [xcvr internal|external] [wol p|u|m|b|a|g|s|d...]
62              [sopass xx:yy:zz:aa:bb:cc] [msglvl N | msglvl type on|off ...]
63
64       ethtool -n|-u|--show-nfc|--show-ntuple devname
65              [ rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6 |
66              rule N ]
67
68       ethtool -N|-U|--config-nfc|--config-ntuple devname
69              rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
70              m|v|t|s|d|f|n|r... |
71              flow-type
72              ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
73              [src xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]]
74              [dst xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]] [proto N [m N]]
75              [src-ip ip-address [m ip-address]] [dst-ip ip-address [m ip-
76              address]] [tos N [m N]] [tclass N [m N]] [l4proto N [m N]]
77              [src-port N [m N]] [dst-port N [m N]] [spi N [m N]]
78              [l4data N [m N]] [vlan-etype N [m N]] [vlan N [m N]]
79              [user-def N [m N]] [dst-
80              mac xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]] [action N]
81              [context N] [loc N] |
82              delete N
83
84       ethtool -w|--get-dump devname [data filename]
85
86       ethtool -W|--set-dump devname N
87
88       ethtool -T|--show-time-stamping devname
89
90       ethtool -x|--show-rxfh-indir|--show-rxfh devname
91
92       ethtool -X|--set-rxfh-indir|--rxfh devname [hkey xx:yy:zz:aa:bb:cc:...]
93              [ equal N | weight W0 W1 ... | default ] [hfunc FUNC] [context
94              CTX | new] [delete]
95
96       ethtool -f|--flash devname file [N]
97
98       ethtool -l|--show-channels devname
99
100       ethtool -L|--set-channels devname [rx N] [tx N] [other N] [combined N]
101
102       ethtool -m|--dump-module-eeprom|--module-info devname [raw on|off]
103              [hex on|off] [offset N] [length N]
104
105       ethtool --show-priv-flags devname
106
107       ethtool --set-priv-flags devname flag on|off ...
108
109       ethtool --show-eee devname
110
111       ethtool --set-eee devname [eee on|off] [tx-lpi on|off] [tx-timer N]
112              [advertise N]
113
114       ethtool --show-fec devname
115
116       ethtool --set-fec devname [encoding auto|off|rs|baser]
117
118

DESCRIPTION

120       ethtool is used to query and control network device driver and hardware
121       settings, particularly for wired Ethernet devices.
122
123       devname is the name of the network device on which ethtool should oper‐
124       ate.
125
126

OPTIONS

128       ethtool with a single argument specifying the device name  prints  cur‐
129       rent settings of the specified device.
130
131       -h --help
132              Shows a short help message.
133
134       --version
135              Shows the ethtool version number.
136
137       -a --show-pause
138              Queries the specified Ethernet device for pause parameter infor‐
139              mation.
140
141       -A --pause
142              Changes the pause parameters of the specified Ethernet device.
143
144           autoneg on|off
145                  Specifies whether pause autonegotiation should be enabled.
146
147           rx on|off
148                  Specifies whether RX pause should be enabled.
149
150           tx on|off
151                  Specifies whether TX pause should be enabled.
152
153       -c --show-coalesce
154              Queries the specified network device for coalescing information.
155
156       -C --coalesce
157              Changes the coalescing settings of the specified network device.
158
159       -g --show-ring
160              Queries the specified network device for  rx/tx  ring  parameter
161              information.
162
163       -G --set-ring
164              Changes  the  rx/tx ring parameters of the specified network de‐
165              vice.
166
167           rx N   Changes the number of ring entries for the Rx ring.
168
169           rx-mini N
170                  Changes the number of ring entries for the Rx Mini ring.
171
172           rx-jumbo N
173                  Changes the number of ring entries for the Rx Jumbo ring.
174
175           tx N   Changes the number of ring entries for the Tx ring.
176
177       -i --driver
178              Queries the specified network device for associated  driver  in‐
179              formation.
180
181       -d --register-dump
182              Retrieves  and  prints a register dump for the specified network
183              device.  The register format for some devices is known  and  de‐
184              coded others are printed in hex.  When raw is enabled, then eth‐
185              tool dumps the raw register data to stdout.  If file  is  speci‐
186              fied,  then  use  contents of previous raw register dump, rather
187              than reading from the device.
188
189       -e --eeprom-dump
190              Retrieves and prints an EEPROM dump for  the  specified  network
191              device.   When raw is enabled, then it dumps the raw EEPROM data
192              to stdout. The length and offset parameters allow  dumping  cer‐
193              tain portions of the EEPROM.  Default is to dump the entire EEP‐
194              ROM.
195
196           raw on|off
197
198           offset N
199
200           length N
201
202       -E --change-eeprom
203              If value is specified, changes EEPROM  byte  for  the  specified
204              network  device.   offset  and value specify which byte and it's
205              new value. If value is not specified, stdin is read and  written
206              to the EEPROM. The length and offset parameters allow writing to
207              certain portions of the EEPROM.  Because of the  persistent  na‐
208              ture  of writing to the EEPROM, a device-specific magic key must
209              be specified to prevent the accidental writing to the EEPROM.
210
211       -k --show-features --show-offload
212              Queries the specified network device for the state  of  protocol
213              offload and other features.
214
215       -K --features --offload
216              Changes  the offload parameters and other features of the speci‐
217              fied network device.  The following feature names  are  built-in
218              and others may be defined by the kernel.
219
220           rx on|off
221                  Specifies whether RX checksumming should be enabled.
222
223           tx on|off
224                  Specifies whether TX checksumming should be enabled.
225
226           sg on|off
227                  Specifies whether scatter-gather should be enabled.
228
229           tso on|off
230                  Specifies  whether  TCP  segmentation  offload should be en‐
231                  abled.
232
233           ufo on|off
234                  Specifies whether UDP fragmentation offload  should  be  en‐
235                  abled
236
237           gso on|off
238                  Specifies whether generic segmentation offload should be en‐
239                  abled
240
241           gro on|off
242                  Specifies whether generic receive offload should be enabled
243
244           lro on|off
245                  Specifies whether large receive offload should be enabled
246
247           rxvlan on|off
248                  Specifies whether RX VLAN acceleration should be enabled
249
250           txvlan on|off
251                  Specifies whether TX VLAN acceleration should be enabled
252
253           ntuple on|off
254                  Specifies whether Rx ntuple filters and  actions  should  be
255                  enabled
256
257           rxhash on|off
258                  Specifies whether receive hashing offload should be enabled
259
260       -p --identify
261              Initiates adapter-specific action intended to enable an operator
262              to easily identify the adapter by  sight.   Typically  this  in‐
263              volves blinking one or more LEDs on the specific network port.
264
265           [ N]   Length of time to perform phys-id, in seconds.
266
267       -P --show-permaddr
268              Queries  the specified network device for permanent hardware ad‐
269              dress.
270
271       -r --negotiate
272              Restarts auto-negotiation on the specified Ethernet  device,  if
273              auto-negotiation is enabled.
274
275       -S --statistics
276              Queries the specified network device for NIC- and driver-specif‐
277              ic statistics.
278
279       --phy-statistics
280              Queries the specified network device for  PHY  specific  statis‐
281              tics.
282
283       -t --test
284              Executes  adapter selftest on the specified network device. Pos‐
285              sible test modes are:
286
287           offline
288                  Perform full set of tests, possibly interrupting normal  op‐
289                  eration during the tests,
290
291           online Perform limited set of tests, not interrupting normal opera‐
292                  tion,
293
294           external_lb
295                  Perform full set of tests, as for offline, and  additionally
296                  an external-loopback test.
297
298       -s --change
299              Allows  changing  some  or all settings of the specified network
300              device.  All following options only apply if -s was specified.
301
302           speed N
303                  Set speed in Mb/s.  ethtool with just the device name as  an
304                  argument will show you the supported device speeds.
305
306           duplex half|full
307                  Sets full or half duplex mode.
308
309           port tp|aui|bnc|mii
310                  Selects device port.
311
312           mdix auto|on|off
313                  Selects MDI-X mode for port. May be used to override the au‐
314                  tomatic detection feature of most adapters. An  argument  of
315                  auto means automatic detection of MDI status, on forces MDI-
316                  X (crossover) mode, while off means MDI  (straight  through)
317                  mode.   The  driver should guarantee that this command takes
318                  effect immediately, and if necessary may reset the  link  to
319                  cause the change to take effect.
320
321           autoneg on|off
322                  Specifies whether autonegotiation should be enabled. Autone‐
323                  gotiation is enabled by default, but in some network devices
324                  may  have  trouble  with it, so you can disable it if really
325                  necessary.
326
327           advertise N
328                  Sets the speed and  duplex  advertised  by  autonegotiation.
329                  The  argument is a hexadecimal value using one or a combina‐
330                  tion of the following values:
331
332                  0x001             10baseT Half
333                  0x002             10baseT Full
334                  0x004             100baseT Half
335                  0x008             100baseT Full
336                  0x010             1000baseT Half           (not supported by IEEE standards)
337                  0x020             1000baseT Full
338                  0x20000           1000baseKX Full
339                  0x20000000000     1000baseX Full
340                  0x800000000000    2500baseT Full
341                  0x8000            2500baseX Full           (not supported by IEEE standards)
342                  0x1000000000000   5000baseT Full
343                  0x1000            10000baseT Full
344                  0x40000           10000baseKX4 Full
345                  0x80000           10000baseKR Full
346                  0x40000000000     10000baseCR  Full
347                  0x80000000000     10000baseSR  Full
348                  0x100000000000    10000baseLR  Full
349                  0x200000000000    10000baseLRM Full
350                  0x400000000000    10000baseER  Full
351                  0x200000          20000baseMLD2 Full       (not supported by IEEE standards)
352                  0x400000          20000baseKR2 Full        (not supported by IEEE standards)
353                  0x80000000        25000baseCR Full
354                  0x100000000       25000baseKR Full
355                  0x200000000       25000baseSR Full
356                  0x800000          40000baseKR4 Full
357                  0x1000000         40000baseCR4 Full
358                  0x2000000         40000baseSR4 Full
359                  0x4000000         40000baseLR4 Full
360                  0x400000000       50000baseCR2 Full
361                  0x800000000       50000baseKR2 Full
362                  0x10000000000     50000baseSR2 Full
363                  0x8000000         56000baseKR4 Full
364                  0x10000000        56000baseCR4 Full
365                  0x20000000        56000baseSR4 Full
366                  0x40000000        56000baseLR4 Full
367                  0x1000000000      100000baseKR4 Full
368                  0x2000000000      100000baseSR4 Full
369                  0x4000000000      100000baseCR4 Full
370                  0x8000000000      100000baseLR4_ER4 Full
371
372           phyad N
373                  PHY address.
374
375           xcvr internal|external
376                  Selects transceiver type. Currently only internal and exter‐
377                  nal  can  be specified, in the future further types might be
378                  added.
379
380           wol p|u|m|b|a|g|s|d...
381                  Sets Wake-on-LAN options.  Not  all  devices  support  this.
382                  The argument to this option is a string of characters speci‐
383                  fying which options to enable.
384
385                  p   Wake on PHY activity
386                  u   Wake on unicast messages
387                  m   Wake on multicast messages
388                  b   Wake on broadcast messages
389                  a   Wake on ARP
390                  g   Wake on MagicPacket™
391                  s   Enable SecureOn™ password for MagicPacket™
392                  d   Disable (wake on  nothing).   This  option
393                      clears all previous options.
394
395           sopass xx:yy:zz:aa:bb:cc
396                  Sets  the  SecureOn™  password.  The argument to this option
397                  must   be   6   bytes   in   Ethernet   MAC    hex    format
398                  (xx:yy:zz:aa:bb:cc).
399
400           msglvl N
401           msglvl type on|off ...
402                  Sets  the  driver message type flags by name or number. type
403                  names the type of message to enable or disable; N  specifies
404                  the  new  flags numerically. The defined type names and num‐
405                  bers are:
406
407                  drv         0x0001  General driver status
408                  probe       0x0002  Hardware probing
409                  link        0x0004  Link state
410                  timer       0x0008  Periodic status check
411                  ifdown      0x0010  Interface being brought down
412                  ifup        0x0020  Interface being brought up
413                  rx_err      0x0040  Receive error
414                  tx_err      0x0080  Transmit error
415                  tx_queued   0x0100  Transmit queueing
416                  intr        0x0200  Interrupt handling
417                  tx_done     0x0400  Transmit completion
418                  rx_status   0x0800  Receive completion
419                  pktdata     0x1000  Packet contents
420                  hw          0x2000  Hardware status
421                  wol         0x4000  Wake-on-LAN status
422
423                  The precise meanings of  these  type  flags  differ  between
424                  drivers.
425
426       -n -u --show-nfc --show-ntuple
427              Retrieves receive network flow classification options or rules.
428
429           rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
430                  Retrieves the hash options for the specified flow type.
431
432                  tcp4    TCP over IPv4
433                  udp4    UDP over IPv4
434                  ah4     IPSEC AH over IPv4
435                  esp4    IPSEC ESP over IPv4
436                  sctp4   SCTP over IPv4
437                  tcp6    TCP over IPv6
438                  udp6    UDP over IPv6
439                  ah6     IPSEC AH over IPv6
440                  esp6    IPSEC ESP over IPv6
441                  sctp6   SCTP over IPv6
442
443           rule N Retrieves the RX classification rule with the given ID.
444
445       -N -U --config-nfc --config-ntuple
446              Configures receive network flow classification options or rules.
447
448           rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
449           m|v|t|s|d|f|n|r...
450                  Configures the hash options for the specified flow type.
451
452                  m   Hash on the Layer 2 destination address of the rx packet.
453                  v   Hash on the VLAN tag of the rx packet.
454                  t   Hash on the Layer 3 protocol field of the rx packet.
455                  s   Hash on the IP source address of the rx packet.
456                  d   Hash on the IP destination address of the rx packet.
457                  f   Hash on bytes 0 and 1 of the Layer 4 header of the rx packet.
458                  n   Hash on bytes 2 and 3 of the Layer 4 header of the rx packet.
459                  r   Discard all packets of this flow type. When  this  option  is
460                      set, all other options are ignored.
461
462           flow-type
463           ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
464                  Inserts or updates a classification rule for  the  specified
465                  flow type.
466
467                  ether   Ethernet
468                  ip4     Raw IPv4
469                  tcp4    TCP over IPv4
470                  udp4    UDP over IPv4
471                  sctp4   SCTP over IPv4
472                  ah4     IPSEC AH over IPv4
473                  esp4    IPSEC ESP over IPv4
474                  ip6     Raw IPv6
475                  tcp6    TCP over IPv6
476                  udp6    UDP over IPv6
477                  sctp6   SCTP over IPv6
478                  ah6     IPSEC AH over IPv6
479                  esp6    IPSEC ESP over IPv6
480
481           For  all fields that allow both a value and a mask to be specified,
482           the mask may be specified immediately after the value using  the  m
483           keyword,  or separately using the field name keyword with -mask ap‐
484           pended, e.g. src-mask.
485
486           src xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
487                  Includes the source MAC address, specified  as  6  bytes  in
488                  hexadecimal  separated  by  colons,  along  with an optional
489                  mask.  Valid only for flow-type ether.
490
491           dst xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
492                  Includes the destination MAC address, specified as  6  bytes
493                  in  hexadecimal  separated by colons, along with an optional
494                  mask.  Valid only for flow-type ether.
495
496           proto N [m N]
497                  Includes the Ethernet protocol number (ethertype) and an op‐
498                  tional mask.  Valid only for flow-type ether.
499
500           src-ip ip-address [m ip-address]
501                  Specify  the  source  IP  address  of the incoming packet to
502                  match along with an optional mask.  Valid for all  IP  based
503                  flow-types.
504
505           dst-ip ip-address [m ip-address]
506                  Specify the destination IP address of the incoming packet to
507                  match along with an optional mask.  Valid for all  IP  based
508                  flow-types.
509
510           tos N [m N]
511                  Specify the value of the Type of Service field in the incom‐
512                  ing packet to match along with an optional mask.  Applies to
513                  all IPv4 based flow-types.
514
515           tclass N [m N]
516                  Specify the value of the Traffic Class field in the incoming
517                  packet to match along with an optional mask.  Applies to all
518                  IPv6 based flow-types.
519
520           l4proto N [m N]
521                  Includes  the  layer  4  protocol  number and optional mask.
522                  Valid only for flow-types ip4 and ip6.
523
524           src-port N [m N]
525                  Specify the value of the source port  field  (applicable  to
526                  TCP/UDP  packets) in the incoming packet to match along with
527                  an optional mask.  Valid for flow-types ip4, tcp4, udp4, and
528                  sctp4 and their IPv6 equivalents.
529
530           dst-port N [m N]
531                  Specify  the value of the destination port field (applicable
532                  to TCP/UDP packets)in the incoming  packet  to  match  along
533                  with  an  optional  mask.   Valid  for flow-types ip4, tcp4,
534                  udp4, and sctp4 and their IPv6 equivalents.
535
536           spi N [m N]
537                  Specify the value of the security parameter index field (ap‐
538                  plicable  to  AH/ESP packets)in the incoming packet to match
539                  along with an optional mask.  Valid for flow-types ip4, ah4,
540                  and esp4 and their IPv6 equivalents.
541
542           l4data N [m N]
543                  Specify the value of the first 4 Bytes of Layer 4 in the in‐
544                  coming packet to match along with an optional  mask.   Valid
545                  for ip4 and ip6 flow-types.
546
547           vlan-etype N [m N]
548                  Includes the VLAN tag Ethertype and an optional mask.
549
550           vlan N [m N]
551                  Includes the VLAN tag and an optional mask.
552
553           user-def N [m N]
554                  Includes 64-bits of user-specific data and an optional mask.
555
556           dst-mac xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
557                  Includes  the  destination MAC address, specified as 6 bytes
558                  in hexadecimal separated by colons, along with  an  optional
559                  mask.  Valid for all IP based flow-types.
560
561           action N
562                  Specifies the Rx queue to send packets to, or some other ac‐
563                  tion.
564
565                  -1            Drop the matched flow
566                  0 or higher   Rx queue to route the flow
567
568           context N
569                  Specifies the RSS context to spread  packets  over  multiple
570                  queues; either 0 for the default RSS context, or a value re‐
571                  turned by ethtool -X ... context new.
572
573           loc N  Specify the location/ID to insert the rule. This will  over‐
574                  write  any  rule  present  in  that location and will not go
575                  through any of the rule ordering process.
576
577           delete N
578                  Deletes the RX classification rule with the given ID.
579
580       -w --get-dump
581              Retrieves and prints firmware dump for the specified network de‐
582              vice.   By  default,  it  prints  out the dump flag, version and
583              length of the dump data.  When data is indicated,  then  ethtool
584              fetches the dump data and directs it to a file.
585
586       -W --set-dump
587              Sets the dump flag for the device.
588
589       -T --show-time-stamping
590              Show  the device's time stamping capabilities and associated PTP
591              hardware clock.
592
593       -x --show-rxfh-indir --show-rxfh
594              Retrieves the receive flow hash  indirection  table  and/or  RSS
595              hash key.
596
597       -X --set-rxfh-indir --rxfh
598              Configures  the  receive  flow hash indirection table and/or RSS
599              hash key.
600
601           hkey   Sets RSS hash key of the specified network device. RSS  hash
602                  key  should  be of device supported length.  Hash key format
603                  must be in xx:yy:zz:aa:bb:cc format meaning both the nibbles
604                  of a byte should be mentioned even if a nibble is zero.
605
606           hfunc  Sets  RSS  hash  function  of  the specified network device.
607                  List of RSS hash functions which kernel supports is shown as
608                  a part of the --show-rxfh command output.
609
610           equal N
611                  Sets the receive flow hash indirection table to spread flows
612                  evenly between the first N receive queues.
613
614           weight W0 W1 ...
615                  Sets the receive flow hash indirection table to spread flows
616                  between  receive queues according to the given weights.  The
617                  sum of the weights must be non-zero and must not exceed  the
618                  size of the indirection table.
619
620           default
621                  Sets  the receive flow hash indirection table to its default
622                  value.
623
624           context CTX | new
625                  Specifies an RSS context to act on; either new to allocate a
626                  new  RSS  context,  or  CTX,  a value returned by a previous
627                  ... context new.
628
629           delete Delete the specified RSS context.  May only be used in  con‐
630                  junction with context and a non-zero CTX value.
631
632       -f --flash
633              Write  a firmware image to flash or other non-volatile memory on
634              the device.
635
636           file   Specifies the filename of the firmware image.  The  firmware
637                  must  first be installed in one of the directories where the
638                  kernel firmware loader or firmware agent will look, such  as
639                  /lib/firmware.
640
641           N      If  the  device  stores multiple firmware images in separate
642                  regions of non-volatile memory, this parameter may  be  used
643                  to specify which region is to be written.  The default is 0,
644                  requesting that all regions are written.  All  other  values
645                  are driver-dependent.
646
647       -l --show-channels
648              Queries the specified network device for the numbers of channels
649              it has.  A channel is an IRQ and the  set  of  queues  that  can
650              trigger that IRQ.
651
652       -L --set-channels
653              Changes the numbers of channels of the specified network device.
654
655           rx N   Changes the number of channels with only receive queues.
656
657           tx N   Changes the number of channels with only transmit queues.
658
659           other N
660                  Changes  the number of channels used only for other purposes
661                  e.g. link interrupts or SR-IOV co-ordination.
662
663           combined N
664                  Changes the number of multi-purpose channels.
665
666       -m --dump-module-eeprom --module-info
667              Retrieves and if possible decodes the EEPROM  from  plugin  mod‐
668              ules,  e.g SFP+, QSFP.  If the driver and module support it, the
669              optical diagnostic information is also read and decoded.
670
671       --show-priv-flags
672              Queries the specified network device for its private flags.  The
673              names and meanings of private flags (if any) are defined by each
674              network device driver.
675
676       --set-priv-flags
677              Sets the device's private flags as specified.
678
679           flag on|off Sets the state of the named private flag.
680
681       --show-eee
682              Queries the specified network device for its support of  Energy-
683              Efficient  Ethernet  (according  to  the IEEE 802.3az specifica‐
684              tions)
685
686       --set-eee
687              Sets the device EEE behaviour.
688
689           eee on|off
690                  Enables/disables the device support of EEE.
691
692           tx-lpi on|off
693                  Determines whether the device should assert its Tx LPI.
694
695           advertise N
696                  Sets the speeds for which the device  should  advertise  EEE
697                  capabilities.  Values are as for --change advertise
698
699           tx-timer N
700                  Sets  the amount of time the device should stay in idle mode
701                  prior to asserting its Tx LPI (in  microseconds).  This  has
702                  meaning only when Tx LPI is enabled.
703
704       --show-fec
705              Queries  the specified network device for its support of Forward
706              Error Correction.
707
708       --set-fec
709              Configures Forward Error Correction for  the  specified  network
710              device.
711
712              Forward  Error  Correction modes selected by a user are expected
713              to be persisted after any hotplug events. If a module is swapped
714              that  does  not  support  the  current  FEC  mode, the driver or
715              firmware must take the link down administratively and report the
716              problem in the system logs for users to correct.
717
718           encoding auto|off|rs|baser
719                  Sets the FEC encoding for the device.
720
721                  auto    Use the driver's default encoding
722                  off     Turn off FEC
723                  RS      Force RS-FEC encoding
724                  BaseR   Force BaseR encoding
725

BUGS

727       Not supported (in part or whole) on all network drivers.
728

AUTHOR

730       ethtool was written by David Miller.
731
732       Modifications by Jeff Garzik, Tim Hockin, Jakub Jelinek, Andre Majorel,
733       Eli Kupermann, Scott Feldman,  Andi  Kleen,  Alexander  Duyck,  Sucheta
734       Chakraborty, Jesse Brandeburg, Ben Hutchings.
735

AVAILABILITY

737       ethtool                 is                available                from
738http://www.kernel.org/pub/software/network/ethtool/
739
740
741
742Ethtool version 4.8              October 2016                       ETHTOOL(8)
Impressum