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|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|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 d Disable (wake on nothing). This option
402 clears all previous options.
403
404 sopass xx:yy:zz:aa:bb:cc
405 Sets the SecureOn™ password. The argument to this option
406 must be 6 bytes in Ethernet MAC hex format
407 (xx:yy:zz:aa:bb:cc).
408
409 msglvl N
410 msglvl type on|off ...
411 Sets the driver message type flags by name or number. type
412 names the type of message to enable or disable; N specifies
413 the new flags numerically. The defined type names and num‐
414 bers are:
415
416 drv 0x0001 General driver status
417 probe 0x0002 Hardware probing
418 link 0x0004 Link state
419 timer 0x0008 Periodic status check
420 ifdown 0x0010 Interface being brought down
421 ifup 0x0020 Interface being brought up
422 rx_err 0x0040 Receive error
423 tx_err 0x0080 Transmit error
424 tx_queued 0x0100 Transmit queueing
425 intr 0x0200 Interrupt handling
426 tx_done 0x0400 Transmit completion
427 rx_status 0x0800 Receive completion
428 pktdata 0x1000 Packet contents
429 hw 0x2000 Hardware status
430 wol 0x4000 Wake-on-LAN status
431
432 The precise meanings of these type flags differ between
433 drivers.
434
435 -n -u --show-nfc --show-ntuple
436 Retrieves receive network flow classification options or rules.
437
438 rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
439 Retrieves the hash options for the specified flow type.
440
441 tcp4 TCP over IPv4
442 udp4 UDP over IPv4
443 ah4 IPSEC AH over IPv4
444 esp4 IPSEC ESP over IPv4
445 sctp4 SCTP over IPv4
446 tcp6 TCP over IPv6
447 udp6 UDP over IPv6
448 ah6 IPSEC AH over IPv6
449 esp6 IPSEC ESP over IPv6
450 sctp6 SCTP over IPv6
451
452 rule N Retrieves the RX classification rule with the given ID.
453
454 -N -U --config-nfc --config-ntuple
455 Configures receive network flow classification options or rules.
456
457 rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
458 m|v|t|s|d|f|n|r...
459 Configures the hash options for the specified flow type.
460
461 m Hash on the Layer 2 destination address of the rx packet.
462 v Hash on the VLAN tag of the rx packet.
463 t Hash on the Layer 3 protocol field of the rx packet.
464 s Hash on the IP source address of the rx packet.
465 d Hash on the IP destination address of the rx packet.
466 f Hash on bytes 0 and 1 of the Layer 4 header of the rx packet.
467 n Hash on bytes 2 and 3 of the Layer 4 header of the rx packet.
468 r Discard all packets of this flow type. When this option is
469 set, all other options are ignored.
470
471 flow-type
472 ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
473 Inserts or updates a classification rule for the specified
474 flow type.
475
476 ether Ethernet
477 ip4 Raw IPv4
478 tcp4 TCP over IPv4
479 udp4 UDP over IPv4
480 sctp4 SCTP over IPv4
481 ah4 IPSEC AH over IPv4
482 esp4 IPSEC ESP over IPv4
483 ip6 Raw IPv6
484 tcp6 TCP over IPv6
485 udp6 UDP over IPv6
486 sctp6 SCTP over IPv6
487 ah6 IPSEC AH over IPv6
488 esp6 IPSEC ESP over IPv6
489
490 For all fields that allow both a value and a mask to be specified,
491 the mask may be specified immediately after the value using the m
492 keyword, or separately using the field name keyword with -mask ap‐
493 pended, e.g. src-mask.
494
495 src xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
496 Includes the source MAC address, specified as 6 bytes in
497 hexadecimal separated by colons, along with an optional
498 mask. Valid only for flow-type ether.
499
500 dst xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
501 Includes the destination MAC address, specified as 6 bytes
502 in hexadecimal separated by colons, along with an optional
503 mask. Valid only for flow-type ether.
504
505 proto N [m N]
506 Includes the Ethernet protocol number (ethertype) and an op‐
507 tional mask. Valid only for flow-type ether.
508
509 src-ip ip-address [m ip-address]
510 Specify the source IP address of the incoming packet to
511 match along with an optional mask. Valid for all IP based
512 flow-types.
513
514 dst-ip ip-address [m ip-address]
515 Specify the destination IP address of the incoming packet to
516 match along with an optional mask. Valid for all IP based
517 flow-types.
518
519 tos N [m N]
520 Specify the value of the Type of Service field in the incom‐
521 ing packet to match along with an optional mask. Applies to
522 all IPv4 based flow-types.
523
524 tclass N [m N]
525 Specify the value of the Traffic Class field in the incoming
526 packet to match along with an optional mask. Applies to all
527 IPv6 based flow-types.
528
529 l4proto N [m N]
530 Includes the layer 4 protocol number and optional mask.
531 Valid only for flow-types ip4 and ip6.
532
533 src-port N [m N]
534 Specify the value of the source port field (applicable to
535 TCP/UDP packets) in the incoming packet to match along with
536 an optional mask. Valid for flow-types ip4, tcp4, udp4, and
537 sctp4 and their IPv6 equivalents.
538
539 dst-port N [m N]
540 Specify the value of the destination port field (applicable
541 to TCP/UDP packets)in the incoming packet to match along
542 with an optional mask. Valid for flow-types ip4, tcp4,
543 udp4, and sctp4 and their IPv6 equivalents.
544
545 spi N [m N]
546 Specify the value of the security parameter index field (ap‐
547 plicable to AH/ESP packets)in the incoming packet to match
548 along with an optional mask. Valid for flow-types ip4, ah4,
549 and esp4 and their IPv6 equivalents.
550
551 l4data N [m N]
552 Specify the value of the first 4 Bytes of Layer 4 in the in‐
553 coming packet to match along with an optional mask. Valid
554 for ip4 and ip6 flow-types.
555
556 vlan-etype N [m N]
557 Includes the VLAN tag Ethertype and an optional mask.
558
559 vlan N [m N]
560 Includes the VLAN tag and an optional mask.
561
562 user-def N [m N]
563 Includes 64-bits of user-specific data and an optional mask.
564
565 dst-mac xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
566 Includes the destination MAC address, specified as 6 bytes
567 in hexadecimal separated by colons, along with an optional
568 mask. Valid for all IP based flow-types.
569
570 action N
571 Specifies the Rx queue to send packets to, or some other ac‐
572 tion.
573
574 -1 Drop the matched flow
575 0 or higher Rx queue to route the flow
576
577 context N
578 Specifies the RSS context to spread packets over multiple
579 queues; either 0 for the default RSS context, or a value re‐
580 turned by ethtool -X ... context new.
581
582 vf N Specifies the Virtual Function the filter applies to. Not
583 compatible with action.
584
585 queue N
586 Specifies the Rx queue to send packets to. Not compatible
587 with action.
588
589 loc N Specify the location/ID to insert the rule. This will over‐
590 write any rule present in that location and will not go
591 through any of the rule ordering process.
592
593 delete N
594 Deletes the RX classification rule with the given ID.
595
596 -w --get-dump
597 Retrieves and prints firmware dump for the specified network de‐
598 vice. By default, it prints out the dump flag, version and
599 length of the dump data. When data is indicated, then ethtool
600 fetches the dump data and directs it to a file.
601
602 -W --set-dump
603 Sets the dump flag for the device.
604
605 -T --show-time-stamping
606 Show the device's time stamping capabilities and associated PTP
607 hardware clock.
608
609 -x --show-rxfh-indir --show-rxfh
610 Retrieves the receive flow hash indirection table and/or RSS
611 hash key.
612
613 -X --set-rxfh-indir --rxfh
614 Configures the receive flow hash indirection table and/or RSS
615 hash key.
616
617 hkey Sets RSS hash key of the specified network device. RSS hash
618 key should be of device supported length. Hash key format
619 must be in xx:yy:zz:aa:bb:cc format meaning both the nibbles
620 of a byte should be mentioned even if a nibble is zero.
621
622 hfunc Sets RSS hash function of the specified network device.
623 List of RSS hash functions which kernel supports is shown as
624 a part of the --show-rxfh command output.
625
626 equal N
627 Sets the receive flow hash indirection table to spread flows
628 evenly between the first N receive queues.
629
630 weight W0 W1 ...
631 Sets the receive flow hash indirection table to spread flows
632 between receive queues according to the given weights. The
633 sum of the weights must be non-zero and must not exceed the
634 size of the indirection table.
635
636 default
637 Sets the receive flow hash indirection table to its default
638 value.
639
640 context CTX | new
641 Specifies an RSS context to act on; either new to allocate a
642 new RSS context, or CTX, a value returned by a previous
643 ... context new.
644
645 delete Delete the specified RSS context. May only be used in con‐
646 junction with context and a non-zero CTX value.
647
648 -f --flash
649 Write a firmware image to flash or other non-volatile memory on
650 the device.
651
652 file Specifies the filename of the firmware image. The firmware
653 must first be installed in one of the directories where the
654 kernel firmware loader or firmware agent will look, such as
655 /lib/firmware.
656
657 N If the device stores multiple firmware images in separate
658 regions of non-volatile memory, this parameter may be used
659 to specify which region is to be written. The default is 0,
660 requesting that all regions are written. All other values
661 are driver-dependent.
662
663 -l --show-channels
664 Queries the specified network device for the numbers of channels
665 it has. A channel is an IRQ and the set of queues that can
666 trigger that IRQ.
667
668 -L --set-channels
669 Changes the numbers of channels of the specified network device.
670
671 rx N Changes the number of channels with only receive queues.
672
673 tx N Changes the number of channels with only transmit queues.
674
675 other N
676 Changes the number of channels used only for other purposes
677 e.g. link interrupts or SR-IOV co-ordination.
678
679 combined N
680 Changes the number of multi-purpose channels.
681
682 -m --dump-module-eeprom --module-info
683 Retrieves and if possible decodes the EEPROM from plugin mod‐
684 ules, e.g SFP+, QSFP. If the driver and module support it, the
685 optical diagnostic information is also read and decoded.
686
687 --show-priv-flags
688 Queries the specified network device for its private flags. The
689 names and meanings of private flags (if any) are defined by each
690 network device driver.
691
692 --set-priv-flags
693 Sets the device's private flags as specified.
694
695 flag on|off Sets the state of the named private flag.
696
697 --show-eee
698 Queries the specified network device for its support of Energy-
699 Efficient Ethernet (according to the IEEE 802.3az specifica‐
700 tions)
701
702 --set-eee
703 Sets the device EEE behaviour.
704
705 eee on|off
706 Enables/disables the device support of EEE.
707
708 tx-lpi on|off
709 Determines whether the device should assert its Tx LPI.
710
711 advertise N
712 Sets the speeds for which the device should advertise EEE
713 capabilities. Values are as for --change advertise
714
715 tx-timer N
716 Sets the amount of time the device should stay in idle mode
717 prior to asserting its Tx LPI (in microseconds). This has
718 meaning only when Tx LPI is enabled.
719
720 --set-phy-tunable
721 Sets the PHY tunable parameters.
722
723 downshift on|off
724 Specifies whether downshift should be enabled
725
726 count N
727 Sets the PHY downshift re-tries count.
728
729 --get-phy-tunable
730 Gets the PHY tunable parameters.
731
732 downshift
733 For operation in cabling environments that are incompatible
734 with 1000BASE-T, PHY device provides an automatic link speed
735 downshift operation. Link speed downshift after N failed
736 1000BASE-T auto-negotiation attempts. Downshift is useful
737 where cable does not have the 4 pairs instance.
738
739 Gets the PHY downshift count/status.
740
741 --reset
742 Reset hardware components specified by flags and components
743 listed below
744
745 flags N
746 Resets the components based on direct flags mask
747
748 mgmt Management processor
749
750 irq Interrupt requester
751
752 dma DMA engine
753
754 filter Filtering/flow direction
755
756 offload
757 Protocol offload
758
759 mac Media access controller
760
761 phy Transceiver/PHY
762
763 ram RAM shared between multiple components ap Application Pro‐
764 cessor
765
766 dedicated
767 All components dedicated to this interface
768
769 all All components used by this interface, even if shared
770
771 --show-fec
772 Queries the specified network device for its support of Forward
773 Error Correction.
774
775 --set-fec
776 Configures Forward Error Correction for the specified network
777 device.
778
779 Forward Error Correction modes selected by a user are expected
780 to be persisted after any hotplug events. If a module is swapped
781 that does not support the current FEC mode, the driver or
782 firmware must take the link down administratively and report the
783 problem in the system logs for users to correct.
784
785 encoding auto|off|rs|baser
786 Sets the FEC encoding for the device.
787
788 auto Use the driver's default encoding
789 off Turn off FEC
790 RS Force RS-FEC encoding
791 BaseR Force BaseR encoding
792
794 Not supported (in part or whole) on all network drivers.
795
797 ethtool was written by David Miller.
798
799 Modifications by Jeff Garzik, Tim Hockin, Jakub Jelinek, Andre Majorel,
800 Eli Kupermann, Scott Feldman, Andi Kleen, Alexander Duyck, Sucheta
801 Chakraborty, Jesse Brandeburg, Ben Hutchings, Scott Branden.
802
804 ethtool is available from
805 ⟨http://www.kernel.org/pub/software/network/ethtool/⟩
806
807
808
809Ethtool version 4.16 April 2018 ETHTOOL(8)