xref: /linux/Documentation/networking/ethtool-netlink.rst (revision 7bb377107c72a40ab7505341f8626c8eb79a0cb7)
1=============================
2Netlink interface for ethtool
3=============================
4
5
6Basic information
7=================
8
9Netlink interface for ethtool uses generic netlink family ``ethtool``
10(userspace application should use macros ``ETHTOOL_GENL_NAME`` and
11``ETHTOOL_GENL_VERSION`` defined in ``<linux/ethtool_netlink.h>`` uapi
12header). This family does not use a specific header, all information in
13requests and replies is passed using netlink attributes.
14
15The ethtool netlink interface uses extended ACK for error and warning
16reporting, userspace application developers are encouraged to make these
17messages available to user in a suitable way.
18
19Requests can be divided into three categories: "get" (retrieving information),
20"set" (setting parameters) and "action" (invoking an action).
21
22All "set" and "action" type requests require admin privileges
23(``CAP_NET_ADMIN`` in the namespace). Most "get" type requests are allowed for
24anyone but there are exceptions (where the response contains sensitive
25information). In some cases, the request as such is allowed for anyone but
26unprivileged users have attributes with sensitive information (e.g.
27wake-on-lan password) omitted.
28
29
30Conventions
31===========
32
33Attributes which represent a boolean value usually use NLA_U8 type so that we
34can distinguish three states: "on", "off" and "not present" (meaning the
35information is not available in "get" requests or value is not to be changed
36in "set" requests). For these attributes, the "true" value should be passed as
37number 1 but any non-zero value should be understood as "true" by recipient.
38In the tables below, "bool" denotes NLA_U8 attributes interpreted in this way.
39
40In the message structure descriptions below, if an attribute name is suffixed
41with "+", parent nest can contain multiple attributes of the same type. This
42implements an array of entries.
43
44
45Request header
46==============
47
48Each request or reply message contains a nested attribute with common header.
49Structure of this header is
50
51  ==============================  ======  =============================
52  ``ETHTOOL_A_HEADER_DEV_INDEX``  u32     device ifindex
53  ``ETHTOOL_A_HEADER_DEV_NAME``   string  device name
54  ``ETHTOOL_A_HEADER_FLAGS``      u32     flags common for all requests
55  ==============================  ======  =============================
56
57``ETHTOOL_A_HEADER_DEV_INDEX`` and ``ETHTOOL_A_HEADER_DEV_NAME`` identify the
58device message relates to. One of them is sufficient in requests, if both are
59used, they must identify the same device. Some requests, e.g. global string
60sets, do not require device identification. Most ``GET`` requests also allow
61dump requests without device identification to query the same information for
62all devices providing it (each device in a separate message).
63
64``ETHTOOL_A_HEADER_FLAGS`` is a bitmap of request flags common for all request
65types. The interpretation of these flags is the same for all request types but
66the flags may not apply to requests. Recognized flags are:
67
68  =================================  ===================================
69  ``ETHTOOL_FLAG_COMPACT_BITSETS``   use compact format bitsets in reply
70  ``ETHTOOL_FLAG_OMIT_REPLY``        omit optional reply (_SET and _ACT)
71  =================================  ===================================
72
73New request flags should follow the general idea that if the flag is not set,
74the behaviour is backward compatible, i.e. requests from old clients not aware
75of the flag should be interpreted the way the client expects. A client must
76not set flags it does not understand.
77
78
79Bit sets
80========
81
82For short bitmaps of (reasonably) fixed length, standard ``NLA_BITFIELD32``
83type is used. For arbitrary length bitmaps, ethtool netlink uses a nested
84attribute with contents of one of two forms: compact (two binary bitmaps
85representing bit values and mask of affected bits) and bit-by-bit (list of
86bits identified by either index or name).
87
88Verbose (bit-by-bit) bitsets allow sending symbolic names for bits together
89with their values which saves a round trip (when the bitset is passed in a
90request) or at least a second request (when the bitset is in a reply). This is
91useful for one shot applications like traditional ethtool command. On the
92other hand, long running applications like ethtool monitor (displaying
93notifications) or network management daemons may prefer fetching the names
94only once and using compact form to save message size. Notifications from
95ethtool netlink interface always use compact form for bitsets.
96
97A bitset can represent either a value/mask pair (``ETHTOOL_A_BITSET_NOMASK``
98not set) or a single bitmap (``ETHTOOL_A_BITSET_NOMASK`` set). In requests
99modifying a bitmap, the former changes the bit set in mask to values set in
100value and preserves the rest; the latter sets the bits set in the bitmap and
101clears the rest.
102
103Compact form: nested (bitset) atrribute contents:
104
105  ============================  ======  ============================
106  ``ETHTOOL_A_BITSET_NOMASK``   flag    no mask, only a list
107  ``ETHTOOL_A_BITSET_SIZE``     u32     number of significant bits
108  ``ETHTOOL_A_BITSET_VALUE``    binary  bitmap of bit values
109  ``ETHTOOL_A_BITSET_MASK``     binary  bitmap of valid bits
110  ============================  ======  ============================
111
112Value and mask must have length at least ``ETHTOOL_A_BITSET_SIZE`` bits
113rounded up to a multiple of 32 bits. They consist of 32-bit words in host byte
114order, words ordered from least significant to most significant (i.e. the same
115way as bitmaps are passed with ioctl interface).
116
117For compact form, ``ETHTOOL_A_BITSET_SIZE`` and ``ETHTOOL_A_BITSET_VALUE`` are
118mandatory. ``ETHTOOL_A_BITSET_MASK`` attribute is mandatory if
119``ETHTOOL_A_BITSET_NOMASK`` is not set (bitset represents a value/mask pair);
120if ``ETHTOOL_A_BITSET_NOMASK`` is not set, ``ETHTOOL_A_BITSET_MASK`` is not
121allowed (bitset represents a single bitmap.
122
123Kernel bit set length may differ from userspace length if older application is
124used on newer kernel or vice versa. If userspace bitmap is longer, an error is
125issued only if the request actually tries to set values of some bits not
126recognized by kernel.
127
128Bit-by-bit form: nested (bitset) attribute contents:
129
130 +------------------------------------+--------+-----------------------------+
131 | ``ETHTOOL_A_BITSET_NOMASK``        | flag   | no mask, only a list        |
132 +------------------------------------+--------+-----------------------------+
133 | ``ETHTOOL_A_BITSET_SIZE``          | u32    | number of significant bits  |
134 +------------------------------------+--------+-----------------------------+
135 | ``ETHTOOL_A_BITSET_BITS``          | nested | array of bits               |
136 +-+----------------------------------+--------+-----------------------------+
137 | | ``ETHTOOL_A_BITSET_BITS_BIT+``   | nested | one bit                     |
138 +-+-+--------------------------------+--------+-----------------------------+
139 | | | ``ETHTOOL_A_BITSET_BIT_INDEX`` | u32    | bit index (0 for LSB)       |
140 +-+-+--------------------------------+--------+-----------------------------+
141 | | | ``ETHTOOL_A_BITSET_BIT_NAME``  | string | bit name                    |
142 +-+-+--------------------------------+--------+-----------------------------+
143 | | | ``ETHTOOL_A_BITSET_BIT_VALUE`` | flag   | present if bit is set       |
144 +-+-+--------------------------------+--------+-----------------------------+
145
146Bit size is optional for bit-by-bit form. ``ETHTOOL_A_BITSET_BITS`` nest can
147only contain ``ETHTOOL_A_BITSET_BITS_BIT`` attributes but there can be an
148arbitrary number of them.  A bit may be identified by its index or by its
149name. When used in requests, listed bits are set to 0 or 1 according to
150``ETHTOOL_A_BITSET_BIT_VALUE``, the rest is preserved. A request fails if
151index exceeds kernel bit length or if name is not recognized.
152
153When ``ETHTOOL_A_BITSET_NOMASK`` flag is present, bitset is interpreted as
154a simple bitmap. ``ETHTOOL_A_BITSET_BIT_VALUE`` attributes are not used in
155such case. Such bitset represents a bitmap with listed bits set and the rest
156zero.
157
158In requests, application can use either form. Form used by kernel in reply is
159determined by ``ETHTOOL_FLAG_COMPACT_BITSETS`` flag in flags field of request
160header. Semantics of value and mask depends on the attribute.
161
162
163List of message types
164=====================
165
166All constants identifying message types use ``ETHTOOL_CMD_`` prefix and suffix
167according to message purpose:
168
169  ==============    ======================================
170  ``_GET``          userspace request to retrieve data
171  ``_SET``          userspace request to set data
172  ``_ACT``          userspace request to perform an action
173  ``_GET_REPLY``    kernel reply to a ``GET`` request
174  ``_SET_REPLY``    kernel reply to a ``SET`` request
175  ``_ACT_REPLY``    kernel reply to an ``ACT`` request
176  ``_NTF``          kernel notification
177  ==============    ======================================
178
179Userspace to kernel:
180
181  ===================================== ================================
182  ``ETHTOOL_MSG_STRSET_GET``            get string set
183  ``ETHTOOL_MSG_LINKINFO_GET``          get link settings
184  ``ETHTOOL_MSG_LINKINFO_SET``          set link settings
185  ``ETHTOOL_MSG_LINKMODES_GET``         get link modes info
186  ``ETHTOOL_MSG_LINKMODES_SET``         set link modes info
187  ``ETHTOOL_MSG_LINKSTATE_GET``         get link state
188  ``ETHTOOL_MSG_DEBUG_GET``             get debugging settings
189  ``ETHTOOL_MSG_DEBUG_SET``             set debugging settings
190  ``ETHTOOL_MSG_WOL_GET``               get wake-on-lan settings
191  ``ETHTOOL_MSG_WOL_SET``               set wake-on-lan settings
192  ``ETHTOOL_MSG_FEATURES_GET``          get device features
193  ``ETHTOOL_MSG_FEATURES_SET``          set device features
194  ``ETHTOOL_MSG_PRIVFLAGS_GET``         get private flags
195  ``ETHTOOL_MSG_PRIVFLAGS_SET``         set private flags
196  ``ETHTOOL_MSG_RINGS_GET``             get ring sizes
197  ``ETHTOOL_MSG_RINGS_SET``             set ring sizes
198  ``ETHTOOL_MSG_CHANNELS_GET``          get channel counts
199  ``ETHTOOL_MSG_CHANNELS_SET``          set channel counts
200  ``ETHTOOL_MSG_COALESCE_GET``          get coalescing parameters
201  ``ETHTOOL_MSG_COALESCE_SET``          set coalescing parameters
202  ``ETHTOOL_MSG_PAUSE_GET``             get pause parameters
203  ``ETHTOOL_MSG_PAUSE_SET``             set pause parameters
204  ``ETHTOOL_MSG_EEE_GET``               get EEE settings
205  ``ETHTOOL_MSG_EEE_SET``               set EEE settings
206  ``ETHTOOL_MSG_TSINFO_GET``		get timestamping info
207  ===================================== ================================
208
209Kernel to userspace:
210
211  ===================================== =================================
212  ``ETHTOOL_MSG_STRSET_GET_REPLY``      string set contents
213  ``ETHTOOL_MSG_LINKINFO_GET_REPLY``    link settings
214  ``ETHTOOL_MSG_LINKINFO_NTF``          link settings notification
215  ``ETHTOOL_MSG_LINKMODES_GET_REPLY``   link modes info
216  ``ETHTOOL_MSG_LINKMODES_NTF``         link modes notification
217  ``ETHTOOL_MSG_LINKSTATE_GET_REPLY``   link state info
218  ``ETHTOOL_MSG_DEBUG_GET_REPLY``       debugging settings
219  ``ETHTOOL_MSG_DEBUG_NTF``             debugging settings notification
220  ``ETHTOOL_MSG_WOL_GET_REPLY``         wake-on-lan settings
221  ``ETHTOOL_MSG_WOL_NTF``               wake-on-lan settings notification
222  ``ETHTOOL_MSG_FEATURES_GET_REPLY``    device features
223  ``ETHTOOL_MSG_FEATURES_SET_REPLY``    optional reply to FEATURES_SET
224  ``ETHTOOL_MSG_FEATURES_NTF``          netdev features notification
225  ``ETHTOOL_MSG_PRIVFLAGS_GET_REPLY``   private flags
226  ``ETHTOOL_MSG_PRIVFLAGS_NTF``         private flags
227  ``ETHTOOL_MSG_RINGS_GET_REPLY``       ring sizes
228  ``ETHTOOL_MSG_RINGS_NTF``             ring sizes
229  ``ETHTOOL_MSG_CHANNELS_GET_REPLY``    channel counts
230  ``ETHTOOL_MSG_CHANNELS_NTF``          channel counts
231  ``ETHTOOL_MSG_COALESCE_GET_REPLY``    coalescing parameters
232  ``ETHTOOL_MSG_COALESCE_NTF``          coalescing parameters
233  ``ETHTOOL_MSG_PAUSE_GET_REPLY``       pause parameters
234  ``ETHTOOL_MSG_PAUSE_NTF``             pause parameters
235  ``ETHTOOL_MSG_EEE_GET_REPLY``         EEE settings
236  ``ETHTOOL_MSG_EEE_NTF``               EEE settings
237  ``ETHTOOL_MSG_TSINFO_GET_REPLY``	timestamping info
238  ===================================== =================================
239
240``GET`` requests are sent by userspace applications to retrieve device
241information. They usually do not contain any message specific attributes.
242Kernel replies with corresponding "GET_REPLY" message. For most types, ``GET``
243request with ``NLM_F_DUMP`` and no device identification can be used to query
244the information for all devices supporting the request.
245
246If the data can be also modified, corresponding ``SET`` message with the same
247layout as corresponding ``GET_REPLY`` is used to request changes. Only
248attributes where a change is requested are included in such request (also, not
249all attributes may be changed). Replies to most ``SET`` request consist only
250of error code and extack; if kernel provides additional data, it is sent in
251the form of corresponding ``SET_REPLY`` message which can be suppressed by
252setting ``ETHTOOL_FLAG_OMIT_REPLY`` flag in request header.
253
254Data modification also triggers sending a ``NTF`` message with a notification.
255These usually bear only a subset of attributes which was affected by the
256change. The same notification is issued if the data is modified using other
257means (mostly ioctl ethtool interface). Unlike notifications from ethtool
258netlink code which are only sent if something actually changed, notifications
259triggered by ioctl interface may be sent even if the request did not actually
260change any data.
261
262``ACT`` messages request kernel (driver) to perform a specific action. If some
263information is reported by kernel (which can be suppressed by setting
264``ETHTOOL_FLAG_OMIT_REPLY`` flag in request header), the reply takes form of
265an ``ACT_REPLY`` message. Performing an action also triggers a notification
266(``NTF`` message).
267
268Later sections describe the format and semantics of these messages.
269
270
271STRSET_GET
272==========
273
274Requests contents of a string set as provided by ioctl commands
275``ETHTOOL_GSSET_INFO`` and ``ETHTOOL_GSTRINGS.`` String sets are not user
276writeable so that the corresponding ``STRSET_SET`` message is only used in
277kernel replies. There are two types of string sets: global (independent of
278a device, e.g. device feature names) and device specific (e.g. device private
279flags).
280
281Request contents:
282
283 +---------------------------------------+--------+------------------------+
284 | ``ETHTOOL_A_STRSET_HEADER``           | nested | request header         |
285 +---------------------------------------+--------+------------------------+
286 | ``ETHTOOL_A_STRSET_STRINGSETS``       | nested | string set to request  |
287 +-+-------------------------------------+--------+------------------------+
288 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set         |
289 +-+-+-----------------------------------+--------+------------------------+
290 | | | ``ETHTOOL_A_STRINGSET_ID``        | u32    | set id                 |
291 +-+-+-----------------------------------+--------+------------------------+
292
293Kernel response contents:
294
295 +---------------------------------------+--------+-----------------------+
296 | ``ETHTOOL_A_STRSET_HEADER``           | nested | reply header          |
297 +---------------------------------------+--------+-----------------------+
298 | ``ETHTOOL_A_STRSET_STRINGSETS``       | nested | array of string sets  |
299 +-+-------------------------------------+--------+-----------------------+
300 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set        |
301 +-+-+-----------------------------------+--------+-----------------------+
302 | | | ``ETHTOOL_A_STRINGSET_ID``        | u32    | set id                |
303 +-+-+-----------------------------------+--------+-----------------------+
304 | | | ``ETHTOOL_A_STRINGSET_COUNT``     | u32    | number of strings     |
305 +-+-+-----------------------------------+--------+-----------------------+
306 | | | ``ETHTOOL_A_STRINGSET_STRINGS``   | nested | array of strings      |
307 +-+-+-+---------------------------------+--------+-----------------------+
308 | | | | ``ETHTOOL_A_STRINGS_STRING+``   | nested | one string            |
309 +-+-+-+-+-------------------------------+--------+-----------------------+
310 | | | | | ``ETHTOOL_A_STRING_INDEX``    | u32    | string index          |
311 +-+-+-+-+-------------------------------+--------+-----------------------+
312 | | | | | ``ETHTOOL_A_STRING_VALUE``    | string | string value          |
313 +-+-+-+-+-------------------------------+--------+-----------------------+
314 | ``ETHTOOL_A_STRSET_COUNTS_ONLY``      | flag   | return only counts    |
315 +---------------------------------------+--------+-----------------------+
316
317Device identification in request header is optional. Depending on its presence
318a and ``NLM_F_DUMP`` flag, there are three type of ``STRSET_GET`` requests:
319
320 - no ``NLM_F_DUMP,`` no device: get "global" stringsets
321 - no ``NLM_F_DUMP``, with device: get string sets related to the device
322 - ``NLM_F_DUMP``, no device: get device related string sets for all devices
323
324If there is no ``ETHTOOL_A_STRSET_STRINGSETS`` array, all string sets of
325requested type are returned, otherwise only those specified in the request.
326Flag ``ETHTOOL_A_STRSET_COUNTS_ONLY`` tells kernel to only return string
327counts of the sets, not the actual strings.
328
329
330LINKINFO_GET
331============
332
333Requests link settings as provided by ``ETHTOOL_GLINKSETTINGS`` except for
334link modes and autonegotiation related information. The request does not use
335any attributes.
336
337Request contents:
338
339  ====================================  ======  ==========================
340  ``ETHTOOL_A_LINKINFO_HEADER``         nested  request header
341  ====================================  ======  ==========================
342
343Kernel response contents:
344
345  ====================================  ======  ==========================
346  ``ETHTOOL_A_LINKINFO_HEADER``         nested  reply header
347  ``ETHTOOL_A_LINKINFO_PORT``           u8      physical port
348  ``ETHTOOL_A_LINKINFO_PHYADDR``        u8      phy MDIO address
349  ``ETHTOOL_A_LINKINFO_TP_MDIX``        u8      MDI(-X) status
350  ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL``   u8      MDI(-X) control
351  ``ETHTOOL_A_LINKINFO_TRANSCEIVER``    u8      transceiver
352  ====================================  ======  ==========================
353
354Attributes and their values have the same meaning as matching members of the
355corresponding ioctl structures.
356
357``LINKINFO_GET`` allows dump requests (kernel returns reply message for all
358devices supporting the request).
359
360
361LINKINFO_SET
362============
363
364``LINKINFO_SET`` request allows setting some of the attributes reported by
365``LINKINFO_GET``.
366
367Request contents:
368
369  ====================================  ======  ==========================
370  ``ETHTOOL_A_LINKINFO_HEADER``         nested  request header
371  ``ETHTOOL_A_LINKINFO_PORT``           u8      physical port
372  ``ETHTOOL_A_LINKINFO_PHYADDR``        u8      phy MDIO address
373  ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL``   u8      MDI(-X) control
374  ====================================  ======  ==========================
375
376MDI(-X) status and transceiver cannot be set, request with the corresponding
377attributes is rejected.
378
379
380LINKMODES_GET
381=============
382
383Requests link modes (supported, advertised and peer advertised) and related
384information (autonegotiation status, link speed and duplex) as provided by
385``ETHTOOL_GLINKSETTINGS``. The request does not use any attributes.
386
387Request contents:
388
389  ====================================  ======  ==========================
390  ``ETHTOOL_A_LINKMODES_HEADER``        nested  request header
391  ====================================  ======  ==========================
392
393Kernel response contents:
394
395  ==========================================  ======  ==========================
396  ``ETHTOOL_A_LINKMODES_HEADER``              nested  reply header
397  ``ETHTOOL_A_LINKMODES_AUTONEG``             u8      autonegotiation status
398  ``ETHTOOL_A_LINKMODES_OURS``                bitset  advertised link modes
399  ``ETHTOOL_A_LINKMODES_PEER``                bitset  partner link modes
400  ``ETHTOOL_A_LINKMODES_SPEED``               u32     link speed (Mb/s)
401  ``ETHTOOL_A_LINKMODES_DUPLEX``              u8      duplex mode
402  ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_CFG``    u8      Master/slave port mode
403  ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_STATE``  u8      Master/slave port state
404  ==========================================  ======  ==========================
405
406For ``ETHTOOL_A_LINKMODES_OURS``, value represents advertised modes and mask
407represents supported modes. ``ETHTOOL_A_LINKMODES_PEER`` in the reply is a bit
408list.
409
410``LINKMODES_GET`` allows dump requests (kernel returns reply messages for all
411devices supporting the request).
412
413
414LINKMODES_SET
415=============
416
417Request contents:
418
419  ==========================================  ======  ==========================
420  ``ETHTOOL_A_LINKMODES_HEADER``              nested  request header
421  ``ETHTOOL_A_LINKMODES_AUTONEG``             u8      autonegotiation status
422  ``ETHTOOL_A_LINKMODES_OURS``                bitset  advertised link modes
423  ``ETHTOOL_A_LINKMODES_PEER``                bitset  partner link modes
424  ``ETHTOOL_A_LINKMODES_SPEED``               u32     link speed (Mb/s)
425  ``ETHTOOL_A_LINKMODES_DUPLEX``              u8      duplex mode
426  ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_CFG``    u8      Master/slave port mode
427  ==========================================  ======  ==========================
428
429``ETHTOOL_A_LINKMODES_OURS`` bit set allows setting advertised link modes. If
430autonegotiation is on (either set now or kept from before), advertised modes
431are not changed (no ``ETHTOOL_A_LINKMODES_OURS`` attribute) and at least one
432of speed and duplex is specified, kernel adjusts advertised modes to all
433supported modes matching speed, duplex or both (whatever is specified). This
434autoselection is done on ethtool side with ioctl interface, netlink interface
435is supposed to allow requesting changes without knowing what exactly kernel
436supports.
437
438
439LINKSTATE_GET
440=============
441
442Requests link state information. At the moment, only link up/down flag (as
443provided by ``ETHTOOL_GLINK`` ioctl command) is provided but some future
444extensions are planned (e.g. link down reason). This request does not have any
445attributes.
446
447Request contents:
448
449  ====================================  ======  ==========================
450  ``ETHTOOL_A_LINKSTATE_HEADER``        nested  request header
451  ====================================  ======  ==========================
452
453Kernel response contents:
454
455  ====================================  ======  ==========================
456  ``ETHTOOL_A_LINKSTATE_HEADER``        nested  reply header
457  ``ETHTOOL_A_LINKSTATE_LINK``          bool    link state (up/down)
458  ====================================  ======  ==========================
459
460For most NIC drivers, the value of ``ETHTOOL_A_LINKSTATE_LINK`` returns
461carrier flag provided by ``netif_carrier_ok()`` but there are drivers which
462define their own handler.
463
464``LINKSTATE_GET`` allows dump requests (kernel returns reply messages for all
465devices supporting the request).
466
467
468DEBUG_GET
469=========
470
471Requests debugging settings of a device. At the moment, only message mask is
472provided.
473
474Request contents:
475
476  ====================================  ======  ==========================
477  ``ETHTOOL_A_DEBUG_HEADER``            nested  request header
478  ====================================  ======  ==========================
479
480Kernel response contents:
481
482  ====================================  ======  ==========================
483  ``ETHTOOL_A_DEBUG_HEADER``            nested  reply header
484  ``ETHTOOL_A_DEBUG_MSGMASK``           bitset  message mask
485  ====================================  ======  ==========================
486
487The message mask (``ETHTOOL_A_DEBUG_MSGMASK``) is equal to message level as
488provided by ``ETHTOOL_GMSGLVL`` and set by ``ETHTOOL_SMSGLVL`` in ioctl
489interface. While it is called message level there for historical reasons, most
490drivers and almost all newer drivers use it as a mask of enabled message
491classes (represented by ``NETIF_MSG_*`` constants); therefore netlink
492interface follows its actual use in practice.
493
494``DEBUG_GET`` allows dump requests (kernel returns reply messages for all
495devices supporting the request).
496
497
498DEBUG_SET
499=========
500
501Set or update debugging settings of a device. At the moment, only message mask
502is supported.
503
504Request contents:
505
506  ====================================  ======  ==========================
507  ``ETHTOOL_A_DEBUG_HEADER``            nested  request header
508  ``ETHTOOL_A_DEBUG_MSGMASK``           bitset  message mask
509  ====================================  ======  ==========================
510
511``ETHTOOL_A_DEBUG_MSGMASK`` bit set allows setting or modifying mask of
512enabled debugging message types for the device.
513
514
515WOL_GET
516=======
517
518Query device wake-on-lan settings. Unlike most "GET" type requests,
519``ETHTOOL_MSG_WOL_GET`` requires (netns) ``CAP_NET_ADMIN`` privileges as it
520(potentially) provides SecureOn(tm) password which is confidential.
521
522Request contents:
523
524  ====================================  ======  ==========================
525  ``ETHTOOL_A_WOL_HEADER``              nested  request header
526  ====================================  ======  ==========================
527
528Kernel response contents:
529
530  ====================================  ======  ==========================
531  ``ETHTOOL_A_WOL_HEADER``              nested  reply header
532  ``ETHTOOL_A_WOL_MODES``               bitset  mask of enabled WoL modes
533  ``ETHTOOL_A_WOL_SOPASS``              binary  SecureOn(tm) password
534  ====================================  ======  ==========================
535
536In reply, ``ETHTOOL_A_WOL_MODES`` mask consists of modes supported by the
537device, value of modes which are enabled. ``ETHTOOL_A_WOL_SOPASS`` is only
538included in reply if ``WAKE_MAGICSECURE`` mode is supported.
539
540
541WOL_SET
542=======
543
544Set or update wake-on-lan settings.
545
546Request contents:
547
548  ====================================  ======  ==========================
549  ``ETHTOOL_A_WOL_HEADER``              nested  request header
550  ``ETHTOOL_A_WOL_MODES``               bitset  enabled WoL modes
551  ``ETHTOOL_A_WOL_SOPASS``              binary  SecureOn(tm) password
552  ====================================  ======  ==========================
553
554``ETHTOOL_A_WOL_SOPASS`` is only allowed for devices supporting
555``WAKE_MAGICSECURE`` mode.
556
557
558FEATURES_GET
559============
560
561Gets netdev features like ``ETHTOOL_GFEATURES`` ioctl request.
562
563Request contents:
564
565  ====================================  ======  ==========================
566  ``ETHTOOL_A_FEATURES_HEADER``         nested  request header
567  ====================================  ======  ==========================
568
569Kernel response contents:
570
571  ====================================  ======  ==========================
572  ``ETHTOOL_A_FEATURES_HEADER``         nested  reply header
573  ``ETHTOOL_A_FEATURES_HW``             bitset  dev->hw_features
574  ``ETHTOOL_A_FEATURES_WANTED``         bitset  dev->wanted_features
575  ``ETHTOOL_A_FEATURES_ACTIVE``         bitset  dev->features
576  ``ETHTOOL_A_FEATURES_NOCHANGE``       bitset  NETIF_F_NEVER_CHANGE
577  ====================================  ======  ==========================
578
579Bitmaps in kernel response have the same meaning as bitmaps used in ioctl
580interference but attribute names are different (they are based on
581corresponding members of struct net_device). Legacy "flags" are not provided,
582if userspace needs them (most likely only ethtool for backward compatibility),
583it can calculate their values from related feature bits itself.
584ETHA_FEATURES_HW uses mask consisting of all features recognized by kernel (to
585provide all names when using verbose bitmap format), the other three use no
586mask (simple bit lists).
587
588
589FEATURES_SET
590============
591
592Request to set netdev features like ``ETHTOOL_SFEATURES`` ioctl request.
593
594Request contents:
595
596  ====================================  ======  ==========================
597  ``ETHTOOL_A_FEATURES_HEADER``         nested  request header
598  ``ETHTOOL_A_FEATURES_WANTED``         bitset  requested features
599  ====================================  ======  ==========================
600
601Kernel response contents:
602
603  ====================================  ======  ==========================
604  ``ETHTOOL_A_FEATURES_HEADER``         nested  reply header
605  ``ETHTOOL_A_FEATURES_WANTED``         bitset  diff wanted vs. result
606  ``ETHTOOL_A_FEATURES_ACTIVE``         bitset  diff old vs. new active
607  ====================================  ======  ==========================
608
609Request constains only one bitset which can be either value/mask pair (request
610to change specific feature bits and leave the rest) or only a value (request
611to set all features to specified set).
612
613As request is subject to netdev_change_features() sanity checks, optional
614kernel reply (can be suppressed by ``ETHTOOL_FLAG_OMIT_REPLY`` flag in request
615header) informs client about the actual result. ``ETHTOOL_A_FEATURES_WANTED``
616reports the difference between client request and actual result: mask consists
617of bits which differ between requested features and result (dev->features
618after the operation), value consists of values of these bits in the request
619(i.e. negated values from resulting features). ``ETHTOOL_A_FEATURES_ACTIVE``
620reports the difference between old and new dev->features: mask consists of
621bits which have changed, values are their values in new dev->features (after
622the operation).
623
624``ETHTOOL_MSG_FEATURES_NTF`` notification is sent not only if device features
625are modified using ``ETHTOOL_MSG_FEATURES_SET`` request or on of ethtool ioctl
626request but also each time features are modified with netdev_update_features()
627or netdev_change_features().
628
629
630PRIVFLAGS_GET
631=============
632
633Gets private flags like ``ETHTOOL_GPFLAGS`` ioctl request.
634
635Request contents:
636
637  ====================================  ======  ==========================
638  ``ETHTOOL_A_PRIVFLAGS_HEADER``        nested  request header
639  ====================================  ======  ==========================
640
641Kernel response contents:
642
643  ====================================  ======  ==========================
644  ``ETHTOOL_A_PRIVFLAGS_HEADER``        nested  reply header
645  ``ETHTOOL_A_PRIVFLAGS_FLAGS``         bitset  private flags
646  ====================================  ======  ==========================
647
648``ETHTOOL_A_PRIVFLAGS_FLAGS`` is a bitset with values of device private flags.
649These flags are defined by driver, their number and names (and also meaning)
650are device dependent. For compact bitset format, names can be retrieved as
651``ETH_SS_PRIV_FLAGS`` string set. If verbose bitset format is requested,
652response uses all private flags supported by the device as mask so that client
653gets the full information without having to fetch the string set with names.
654
655
656PRIVFLAGS_SET
657=============
658
659Sets or modifies values of device private flags like ``ETHTOOL_SPFLAGS``
660ioctl request.
661
662Request contents:
663
664  ====================================  ======  ==========================
665  ``ETHTOOL_A_PRIVFLAGS_HEADER``        nested  request header
666  ``ETHTOOL_A_PRIVFLAGS_FLAGS``         bitset  private flags
667  ====================================  ======  ==========================
668
669``ETHTOOL_A_PRIVFLAGS_FLAGS`` can either set the whole set of private flags or
670modify only values of some of them.
671
672
673RINGS_GET
674=========
675
676Gets ring sizes like ``ETHTOOL_GRINGPARAM`` ioctl request.
677
678Request contents:
679
680  ====================================  ======  ==========================
681  ``ETHTOOL_A_RINGS_HEADER``            nested  request header
682  ====================================  ======  ==========================
683
684Kernel response contents:
685
686  ====================================  ======  ==========================
687  ``ETHTOOL_A_RINGS_HEADER``            nested  reply header
688  ``ETHTOOL_A_RINGS_RX_MAX``            u32     max size of RX ring
689  ``ETHTOOL_A_RINGS_RX_MINI_MAX``       u32     max size of RX mini ring
690  ``ETHTOOL_A_RINGS_RX_JUMBO_MAX``      u32     max size of RX jumbo ring
691  ``ETHTOOL_A_RINGS_TX_MAX``            u32     max size of TX ring
692  ``ETHTOOL_A_RINGS_RX``                u32     size of RX ring
693  ``ETHTOOL_A_RINGS_RX_MINI``           u32     size of RX mini ring
694  ``ETHTOOL_A_RINGS_RX_JUMBO``          u32     size of RX jumbo ring
695  ``ETHTOOL_A_RINGS_TX``                u32     size of TX ring
696  ====================================  ======  ==========================
697
698
699RINGS_SET
700=========
701
702Sets ring sizes like ``ETHTOOL_SRINGPARAM`` ioctl request.
703
704Request contents:
705
706  ====================================  ======  ==========================
707  ``ETHTOOL_A_RINGS_HEADER``            nested  reply header
708  ``ETHTOOL_A_RINGS_RX``                u32     size of RX ring
709  ``ETHTOOL_A_RINGS_RX_MINI``           u32     size of RX mini ring
710  ``ETHTOOL_A_RINGS_RX_JUMBO``          u32     size of RX jumbo ring
711  ``ETHTOOL_A_RINGS_TX``                u32     size of TX ring
712  ====================================  ======  ==========================
713
714Kernel checks that requested ring sizes do not exceed limits reported by
715driver. Driver may impose additional constraints and may not suspport all
716attributes.
717
718
719CHANNELS_GET
720============
721
722Gets channel counts like ``ETHTOOL_GCHANNELS`` ioctl request.
723
724Request contents:
725
726  ====================================  ======  ==========================
727  ``ETHTOOL_A_CHANNELS_HEADER``         nested  request header
728  ====================================  ======  ==========================
729
730Kernel response contents:
731
732  =====================================  ======  ==========================
733  ``ETHTOOL_A_CHANNELS_HEADER``          nested  reply header
734  ``ETHTOOL_A_CHANNELS_RX_MAX``          u32     max receive channels
735  ``ETHTOOL_A_CHANNELS_TX_MAX``          u32     max transmit channels
736  ``ETHTOOL_A_CHANNELS_OTHER_MAX``       u32     max other channels
737  ``ETHTOOL_A_CHANNELS_COMBINED_MAX``    u32     max combined channels
738  ``ETHTOOL_A_CHANNELS_RX_COUNT``        u32     receive channel count
739  ``ETHTOOL_A_CHANNELS_TX_COUNT``        u32     transmit channel count
740  ``ETHTOOL_A_CHANNELS_OTHER_COUNT``     u32     other channel count
741  ``ETHTOOL_A_CHANNELS_COMBINED_COUNT``  u32     combined channel count
742  =====================================  ======  ==========================
743
744
745CHANNELS_SET
746============
747
748Sets channel counts like ``ETHTOOL_SCHANNELS`` ioctl request.
749
750Request contents:
751
752  =====================================  ======  ==========================
753  ``ETHTOOL_A_CHANNELS_HEADER``          nested  request header
754  ``ETHTOOL_A_CHANNELS_RX_COUNT``        u32     receive channel count
755  ``ETHTOOL_A_CHANNELS_TX_COUNT``        u32     transmit channel count
756  ``ETHTOOL_A_CHANNELS_OTHER_COUNT``     u32     other channel count
757  ``ETHTOOL_A_CHANNELS_COMBINED_COUNT``  u32     combined channel count
758  =====================================  ======  ==========================
759
760Kernel checks that requested channel counts do not exceed limits reported by
761driver. Driver may impose additional constraints and may not suspport all
762attributes.
763
764
765COALESCE_GET
766============
767
768Gets coalescing parameters like ``ETHTOOL_GCOALESCE`` ioctl request.
769
770Request contents:
771
772  ====================================  ======  ==========================
773  ``ETHTOOL_A_COALESCE_HEADER``         nested  request header
774  ====================================  ======  ==========================
775
776Kernel response contents:
777
778  ===========================================  ======  =======================
779  ``ETHTOOL_A_COALESCE_HEADER``                nested  reply header
780  ``ETHTOOL_A_COALESCE_RX_USECS``              u32     delay (us), normal Rx
781  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES``         u32     max packets, normal Rx
782  ``ETHTOOL_A_COALESCE_RX_USECS_IRQ``          u32     delay (us), Rx in IRQ
783  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_IRQ``     u32     max packets, Rx in IRQ
784  ``ETHTOOL_A_COALESCE_TX_USECS``              u32     delay (us), normal Tx
785  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES``         u32     max packets, normal Tx
786  ``ETHTOOL_A_COALESCE_TX_USECS_IRQ``          u32     delay (us), Tx in IRQ
787  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_IRQ``     u32     IRQ packets, Tx in IRQ
788  ``ETHTOOL_A_COALESCE_STATS_BLOCK_USECS``     u32     delay of stats update
789  ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_RX``       bool    adaptive Rx coalesce
790  ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_TX``       bool    adaptive Tx coalesce
791  ``ETHTOOL_A_COALESCE_PKT_RATE_LOW``          u32     threshold for low rate
792  ``ETHTOOL_A_COALESCE_RX_USECS_LOW``          u32     delay (us), low Rx
793  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_LOW``     u32     max packets, low Rx
794  ``ETHTOOL_A_COALESCE_TX_USECS_LOW``          u32     delay (us), low Tx
795  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_LOW``     u32     max packets, low Tx
796  ``ETHTOOL_A_COALESCE_PKT_RATE_HIGH``         u32     threshold for high rate
797  ``ETHTOOL_A_COALESCE_RX_USECS_HIGH``         u32     delay (us), high Rx
798  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_HIGH``    u32     max packets, high Rx
799  ``ETHTOOL_A_COALESCE_TX_USECS_HIGH``         u32     delay (us), high Tx
800  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_HIGH``    u32     max packets, high Tx
801  ``ETHTOOL_A_COALESCE_RATE_SAMPLE_INTERVAL``  u32     rate sampling interval
802  ===========================================  ======  =======================
803
804Attributes are only included in reply if their value is not zero or the
805corresponding bit in ``ethtool_ops::supported_coalesce_params`` is set (i.e.
806they are declared as supported by driver).
807
808
809COALESCE_SET
810============
811
812Sets coalescing parameters like ``ETHTOOL_SCOALESCE`` ioctl request.
813
814Request contents:
815
816  ===========================================  ======  =======================
817  ``ETHTOOL_A_COALESCE_HEADER``                nested  request header
818  ``ETHTOOL_A_COALESCE_RX_USECS``              u32     delay (us), normal Rx
819  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES``         u32     max packets, normal Rx
820  ``ETHTOOL_A_COALESCE_RX_USECS_IRQ``          u32     delay (us), Rx in IRQ
821  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_IRQ``     u32     max packets, Rx in IRQ
822  ``ETHTOOL_A_COALESCE_TX_USECS``              u32     delay (us), normal Tx
823  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES``         u32     max packets, normal Tx
824  ``ETHTOOL_A_COALESCE_TX_USECS_IRQ``          u32     delay (us), Tx in IRQ
825  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_IRQ``     u32     IRQ packets, Tx in IRQ
826  ``ETHTOOL_A_COALESCE_STATS_BLOCK_USECS``     u32     delay of stats update
827  ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_RX``       bool    adaptive Rx coalesce
828  ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_TX``       bool    adaptive Tx coalesce
829  ``ETHTOOL_A_COALESCE_PKT_RATE_LOW``          u32     threshold for low rate
830  ``ETHTOOL_A_COALESCE_RX_USECS_LOW``          u32     delay (us), low Rx
831  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_LOW``     u32     max packets, low Rx
832  ``ETHTOOL_A_COALESCE_TX_USECS_LOW``          u32     delay (us), low Tx
833  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_LOW``     u32     max packets, low Tx
834  ``ETHTOOL_A_COALESCE_PKT_RATE_HIGH``         u32     threshold for high rate
835  ``ETHTOOL_A_COALESCE_RX_USECS_HIGH``         u32     delay (us), high Rx
836  ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_HIGH``    u32     max packets, high Rx
837  ``ETHTOOL_A_COALESCE_TX_USECS_HIGH``         u32     delay (us), high Tx
838  ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_HIGH``    u32     max packets, high Tx
839  ``ETHTOOL_A_COALESCE_RATE_SAMPLE_INTERVAL``  u32     rate sampling interval
840  ===========================================  ======  =======================
841
842Request is rejected if it attributes declared as unsupported by driver (i.e.
843such that the corresponding bit in ``ethtool_ops::supported_coalesce_params``
844is not set), regardless of their values. Driver may impose additional
845constraints on coalescing parameters and their values.
846
847
848PAUSE_GET
849============
850
851Gets channel counts like ``ETHTOOL_GPAUSE`` ioctl request.
852
853Request contents:
854
855  =====================================  ======  ==========================
856  ``ETHTOOL_A_PAUSE_HEADER``             nested  request header
857  =====================================  ======  ==========================
858
859Kernel response contents:
860
861  =====================================  ======  ==========================
862  ``ETHTOOL_A_PAUSE_HEADER``             nested  request header
863  ``ETHTOOL_A_PAUSE_AUTONEG``            bool    pause autonegotiation
864  ``ETHTOOL_A_PAUSE_RX``                 bool    receive pause frames
865  ``ETHTOOL_A_PAUSE_TX``                 bool    transmit pause frames
866  =====================================  ======  ==========================
867
868
869PAUSE_SET
870============
871
872Sets pause parameters like ``ETHTOOL_GPAUSEPARAM`` ioctl request.
873
874Request contents:
875
876  =====================================  ======  ==========================
877  ``ETHTOOL_A_PAUSE_HEADER``             nested  request header
878  ``ETHTOOL_A_PAUSE_AUTONEG``            bool    pause autonegotiation
879  ``ETHTOOL_A_PAUSE_RX``                 bool    receive pause frames
880  ``ETHTOOL_A_PAUSE_TX``                 bool    transmit pause frames
881  =====================================  ======  ==========================
882
883
884EEE_GET
885=======
886
887Gets channel counts like ``ETHTOOL_GEEE`` ioctl request.
888
889Request contents:
890
891  =====================================  ======  ==========================
892  ``ETHTOOL_A_EEE_HEADER``               nested  request header
893  =====================================  ======  ==========================
894
895Kernel response contents:
896
897  =====================================  ======  ==========================
898  ``ETHTOOL_A_EEE_HEADER``               nested  request header
899  ``ETHTOOL_A_EEE_MODES_OURS``           bool    supported/advertised modes
900  ``ETHTOOL_A_EEE_MODES_PEER``           bool    peer advertised link modes
901  ``ETHTOOL_A_EEE_ACTIVE``               bool    EEE is actively used
902  ``ETHTOOL_A_EEE_ENABLED``              bool    EEE is enabled
903  ``ETHTOOL_A_EEE_TX_LPI_ENABLED``       bool    Tx lpi enabled
904  ``ETHTOOL_A_EEE_TX_LPI_TIMER``         u32     Tx lpi timeout (in us)
905  =====================================  ======  ==========================
906
907In ``ETHTOOL_A_EEE_MODES_OURS``, mask consists of link modes for which EEE is
908enabled, value of link modes for which EEE is advertised. Link modes for which
909peer advertises EEE are listed in ``ETHTOOL_A_EEE_MODES_PEER`` (no mask). The
910netlink interface allows reporting EEE status for all link modes but only
911first 32 are provided by the ``ethtool_ops`` callback.
912
913
914EEE_SET
915=======
916
917Sets pause parameters like ``ETHTOOL_GEEEPARAM`` ioctl request.
918
919Request contents:
920
921  =====================================  ======  ==========================
922  ``ETHTOOL_A_EEE_HEADER``               nested  request header
923  ``ETHTOOL_A_EEE_MODES_OURS``           bool    advertised modes
924  ``ETHTOOL_A_EEE_ENABLED``              bool    EEE is enabled
925  ``ETHTOOL_A_EEE_TX_LPI_ENABLED``       bool    Tx lpi enabled
926  ``ETHTOOL_A_EEE_TX_LPI_TIMER``         u32     Tx lpi timeout (in us)
927  =====================================  ======  ==========================
928
929``ETHTOOL_A_EEE_MODES_OURS`` is used to either list link modes to advertise
930EEE for (if there is no mask) or specify changes to the list (if there is
931a mask). The netlink interface allows reporting EEE status for all link modes
932but only first 32 can be set at the moment as that is what the ``ethtool_ops``
933callback supports.
934
935
936TSINFO_GET
937==========
938
939Gets timestamping information like ``ETHTOOL_GET_TS_INFO`` ioctl request.
940
941Request contents:
942
943  =====================================  ======  ==========================
944  ``ETHTOOL_A_TSINFO_HEADER``            nested  request header
945  =====================================  ======  ==========================
946
947Kernel response contents:
948
949  =====================================  ======  ==========================
950  ``ETHTOOL_A_TSINFO_HEADER``            nested  request header
951  ``ETHTOOL_A_TSINFO_TIMESTAMPING``      bitset  SO_TIMESTAMPING flags
952  ``ETHTOOL_A_TSINFO_TX_TYPES``          bitset  supported Tx types
953  ``ETHTOOL_A_TSINFO_RX_FILTERS``        bitset  supported Rx filters
954  ``ETHTOOL_A_TSINFO_PHC_INDEX``         u32     PTP hw clock index
955  =====================================  ======  ==========================
956
957``ETHTOOL_A_TSINFO_PHC_INDEX`` is absent if there is no associated PHC (there
958is no special value for this case). The bitset attributes are omitted if they
959would be empty (no bit set).
960
961
962Request translation
963===================
964
965The following table maps ioctl commands to netlink commands providing their
966functionality. Entries with "n/a" in right column are commands which do not
967have their netlink replacement yet.
968
969  =================================== =====================================
970  ioctl command                       netlink command
971  =================================== =====================================
972  ``ETHTOOL_GSET``                    ``ETHTOOL_MSG_LINKINFO_GET``
973                                      ``ETHTOOL_MSG_LINKMODES_GET``
974  ``ETHTOOL_SSET``                    ``ETHTOOL_MSG_LINKINFO_SET``
975                                      ``ETHTOOL_MSG_LINKMODES_SET``
976  ``ETHTOOL_GDRVINFO``                n/a
977  ``ETHTOOL_GREGS``                   n/a
978  ``ETHTOOL_GWOL``                    ``ETHTOOL_MSG_WOL_GET``
979  ``ETHTOOL_SWOL``                    ``ETHTOOL_MSG_WOL_SET``
980  ``ETHTOOL_GMSGLVL``                 ``ETHTOOL_MSG_DEBUG_GET``
981  ``ETHTOOL_SMSGLVL``                 ``ETHTOOL_MSG_DEBUG_SET``
982  ``ETHTOOL_NWAY_RST``                n/a
983  ``ETHTOOL_GLINK``                   ``ETHTOOL_MSG_LINKSTATE_GET``
984  ``ETHTOOL_GEEPROM``                 n/a
985  ``ETHTOOL_SEEPROM``                 n/a
986  ``ETHTOOL_GCOALESCE``               ``ETHTOOL_MSG_COALESCE_GET``
987  ``ETHTOOL_SCOALESCE``               ``ETHTOOL_MSG_COALESCE_SET``
988  ``ETHTOOL_GRINGPARAM``              ``ETHTOOL_MSG_RINGS_GET``
989  ``ETHTOOL_SRINGPARAM``              ``ETHTOOL_MSG_RINGS_SET``
990  ``ETHTOOL_GPAUSEPARAM``             ``ETHTOOL_MSG_PAUSE_GET``
991  ``ETHTOOL_SPAUSEPARAM``             ``ETHTOOL_MSG_PAUSE_SET``
992  ``ETHTOOL_GRXCSUM``                 ``ETHTOOL_MSG_FEATURES_GET``
993  ``ETHTOOL_SRXCSUM``                 ``ETHTOOL_MSG_FEATURES_SET``
994  ``ETHTOOL_GTXCSUM``                 ``ETHTOOL_MSG_FEATURES_GET``
995  ``ETHTOOL_STXCSUM``                 ``ETHTOOL_MSG_FEATURES_SET``
996  ``ETHTOOL_GSG``                     ``ETHTOOL_MSG_FEATURES_GET``
997  ``ETHTOOL_SSG``                     ``ETHTOOL_MSG_FEATURES_SET``
998  ``ETHTOOL_TEST``                    n/a
999  ``ETHTOOL_GSTRINGS``                ``ETHTOOL_MSG_STRSET_GET``
1000  ``ETHTOOL_PHYS_ID``                 n/a
1001  ``ETHTOOL_GSTATS``                  n/a
1002  ``ETHTOOL_GTSO``                    ``ETHTOOL_MSG_FEATURES_GET``
1003  ``ETHTOOL_STSO``                    ``ETHTOOL_MSG_FEATURES_SET``
1004  ``ETHTOOL_GPERMADDR``               rtnetlink ``RTM_GETLINK``
1005  ``ETHTOOL_GUFO``                    ``ETHTOOL_MSG_FEATURES_GET``
1006  ``ETHTOOL_SUFO``                    ``ETHTOOL_MSG_FEATURES_SET``
1007  ``ETHTOOL_GGSO``                    ``ETHTOOL_MSG_FEATURES_GET``
1008  ``ETHTOOL_SGSO``                    ``ETHTOOL_MSG_FEATURES_SET``
1009  ``ETHTOOL_GFLAGS``                  ``ETHTOOL_MSG_FEATURES_GET``
1010  ``ETHTOOL_SFLAGS``                  ``ETHTOOL_MSG_FEATURES_SET``
1011  ``ETHTOOL_GPFLAGS``                 ``ETHTOOL_MSG_PRIVFLAGS_GET``
1012  ``ETHTOOL_SPFLAGS``                 ``ETHTOOL_MSG_PRIVFLAGS_SET``
1013  ``ETHTOOL_GRXFH``                   n/a
1014  ``ETHTOOL_SRXFH``                   n/a
1015  ``ETHTOOL_GGRO``                    ``ETHTOOL_MSG_FEATURES_GET``
1016  ``ETHTOOL_SGRO``                    ``ETHTOOL_MSG_FEATURES_SET``
1017  ``ETHTOOL_GRXRINGS``                n/a
1018  ``ETHTOOL_GRXCLSRLCNT``             n/a
1019  ``ETHTOOL_GRXCLSRULE``              n/a
1020  ``ETHTOOL_GRXCLSRLALL``             n/a
1021  ``ETHTOOL_SRXCLSRLDEL``             n/a
1022  ``ETHTOOL_SRXCLSRLINS``             n/a
1023  ``ETHTOOL_FLASHDEV``                n/a
1024  ``ETHTOOL_RESET``                   n/a
1025  ``ETHTOOL_SRXNTUPLE``               n/a
1026  ``ETHTOOL_GRXNTUPLE``               n/a
1027  ``ETHTOOL_GSSET_INFO``              ``ETHTOOL_MSG_STRSET_GET``
1028  ``ETHTOOL_GRXFHINDIR``              n/a
1029  ``ETHTOOL_SRXFHINDIR``              n/a
1030  ``ETHTOOL_GFEATURES``               ``ETHTOOL_MSG_FEATURES_GET``
1031  ``ETHTOOL_SFEATURES``               ``ETHTOOL_MSG_FEATURES_SET``
1032  ``ETHTOOL_GCHANNELS``               ``ETHTOOL_MSG_CHANNELS_GET``
1033  ``ETHTOOL_SCHANNELS``               ``ETHTOOL_MSG_CHANNELS_SET``
1034  ``ETHTOOL_SET_DUMP``                n/a
1035  ``ETHTOOL_GET_DUMP_FLAG``           n/a
1036  ``ETHTOOL_GET_DUMP_DATA``           n/a
1037  ``ETHTOOL_GET_TS_INFO``             ``ETHTOOL_MSG_TSINFO_GET``
1038  ``ETHTOOL_GMODULEINFO``             n/a
1039  ``ETHTOOL_GMODULEEEPROM``           n/a
1040  ``ETHTOOL_GEEE``                    ``ETHTOOL_MSG_EEE_GET``
1041  ``ETHTOOL_SEEE``                    ``ETHTOOL_MSG_EEE_SET``
1042  ``ETHTOOL_GRSSH``                   n/a
1043  ``ETHTOOL_SRSSH``                   n/a
1044  ``ETHTOOL_GTUNABLE``                n/a
1045  ``ETHTOOL_STUNABLE``                n/a
1046  ``ETHTOOL_GPHYSTATS``               n/a
1047  ``ETHTOOL_PERQUEUE``                n/a
1048  ``ETHTOOL_GLINKSETTINGS``           ``ETHTOOL_MSG_LINKINFO_GET``
1049                                      ``ETHTOOL_MSG_LINKMODES_GET``
1050  ``ETHTOOL_SLINKSETTINGS``           ``ETHTOOL_MSG_LINKINFO_SET``
1051                                      ``ETHTOOL_MSG_LINKMODES_SET``
1052  ``ETHTOOL_PHY_GTUNABLE``            n/a
1053  ``ETHTOOL_PHY_STUNABLE``            n/a
1054  ``ETHTOOL_GFECPARAM``               n/a
1055  ``ETHTOOL_SFECPARAM``               n/a
1056  =================================== =====================================
1057