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