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 44Attributes that need to be filled-in by device drivers and that are dumped to 45user space based on whether they are valid or not should not use zero as a 46valid value. This avoids the need to explicitly signal the validity of the 47attribute in the device driver API. 48 49 50Request header 51============== 52 53Each request or reply message contains a nested attribute with common header. 54Structure of this header is 55 56 ============================== ====== ============================= 57 ``ETHTOOL_A_HEADER_DEV_INDEX`` u32 device ifindex 58 ``ETHTOOL_A_HEADER_DEV_NAME`` string device name 59 ``ETHTOOL_A_HEADER_FLAGS`` u32 flags common for all requests 60 ``ETHTOOL_A_HEADER_PHY_INDEX`` u32 phy device index 61 ============================== ====== ============================= 62 63``ETHTOOL_A_HEADER_DEV_INDEX`` and ``ETHTOOL_A_HEADER_DEV_NAME`` identify the 64device message relates to. One of them is sufficient in requests, if both are 65used, they must identify the same device. Some requests, e.g. global string 66sets, do not require device identification. Most ``GET`` requests also allow 67dump requests without device identification to query the same information for 68all devices providing it (each device in a separate message). 69 70``ETHTOOL_A_HEADER_FLAGS`` is a bitmap of request flags common for all request 71types. The interpretation of these flags is the same for all request types but 72the flags may not apply to requests. Recognized flags are: 73 74 ================================= =================================== 75 ``ETHTOOL_FLAG_COMPACT_BITSETS`` use compact format bitsets in reply 76 ``ETHTOOL_FLAG_OMIT_REPLY`` omit optional reply (_SET and _ACT) 77 ``ETHTOOL_FLAG_STATS`` include optional device statistics 78 ================================= =================================== 79 80New request flags should follow the general idea that if the flag is not set, 81the behaviour is backward compatible, i.e. requests from old clients not aware 82of the flag should be interpreted the way the client expects. A client must 83not set flags it does not understand. 84 85``ETHTOOL_A_HEADER_PHY_INDEX`` identifies the Ethernet PHY the message relates to. 86As there are numerous commands that are related to PHY configuration, and because 87there may be more than one PHY on the link, the PHY index can be passed in the 88request for the commands that needs it. It is, however, not mandatory, and if it 89is not passed for commands that target a PHY, the net_device.phydev pointer 90is used. 91 92Bit sets 93======== 94 95For short bitmaps of (reasonably) fixed length, standard ``NLA_BITFIELD32`` 96type is used. For arbitrary length bitmaps, ethtool netlink uses a nested 97attribute with contents of one of two forms: compact (two binary bitmaps 98representing bit values and mask of affected bits) and bit-by-bit (list of 99bits identified by either index or name). 100 101Verbose (bit-by-bit) bitsets allow sending symbolic names for bits together 102with their values which saves a round trip (when the bitset is passed in a 103request) or at least a second request (when the bitset is in a reply). This is 104useful for one shot applications like traditional ethtool command. On the 105other hand, long running applications like ethtool monitor (displaying 106notifications) or network management daemons may prefer fetching the names 107only once and using compact form to save message size. Notifications from 108ethtool netlink interface always use compact form for bitsets. 109 110A bitset can represent either a value/mask pair (``ETHTOOL_A_BITSET_NOMASK`` 111not set) or a single bitmap (``ETHTOOL_A_BITSET_NOMASK`` set). In requests 112modifying a bitmap, the former changes the bit set in mask to values set in 113value and preserves the rest; the latter sets the bits set in the bitmap and 114clears the rest. 115 116Compact form: nested (bitset) attribute contents: 117 118 ============================ ====== ============================ 119 ``ETHTOOL_A_BITSET_NOMASK`` flag no mask, only a list 120 ``ETHTOOL_A_BITSET_SIZE`` u32 number of significant bits 121 ``ETHTOOL_A_BITSET_VALUE`` binary bitmap of bit values 122 ``ETHTOOL_A_BITSET_MASK`` binary bitmap of valid bits 123 ============================ ====== ============================ 124 125Value and mask must have length at least ``ETHTOOL_A_BITSET_SIZE`` bits 126rounded up to a multiple of 32 bits. They consist of 32-bit words in host byte 127order, words ordered from least significant to most significant (i.e. the same 128way as bitmaps are passed with ioctl interface). 129 130For compact form, ``ETHTOOL_A_BITSET_SIZE`` and ``ETHTOOL_A_BITSET_VALUE`` are 131mandatory. ``ETHTOOL_A_BITSET_MASK`` attribute is mandatory if 132``ETHTOOL_A_BITSET_NOMASK`` is not set (bitset represents a value/mask pair); 133if ``ETHTOOL_A_BITSET_NOMASK`` is not set, ``ETHTOOL_A_BITSET_MASK`` is not 134allowed (bitset represents a single bitmap. 135 136Kernel bit set length may differ from userspace length if older application is 137used on newer kernel or vice versa. If userspace bitmap is longer, an error is 138issued only if the request actually tries to set values of some bits not 139recognized by kernel. 140 141Bit-by-bit form: nested (bitset) attribute contents: 142 143 +------------------------------------+--------+-----------------------------+ 144 | ``ETHTOOL_A_BITSET_NOMASK`` | flag | no mask, only a list | 145 +------------------------------------+--------+-----------------------------+ 146 | ``ETHTOOL_A_BITSET_SIZE`` | u32 | number of significant bits | 147 +------------------------------------+--------+-----------------------------+ 148 | ``ETHTOOL_A_BITSET_BITS`` | nested | array of bits | 149 +-+----------------------------------+--------+-----------------------------+ 150 | | ``ETHTOOL_A_BITSET_BITS_BIT+`` | nested | one bit | 151 +-+-+--------------------------------+--------+-----------------------------+ 152 | | | ``ETHTOOL_A_BITSET_BIT_INDEX`` | u32 | bit index (0 for LSB) | 153 +-+-+--------------------------------+--------+-----------------------------+ 154 | | | ``ETHTOOL_A_BITSET_BIT_NAME`` | string | bit name | 155 +-+-+--------------------------------+--------+-----------------------------+ 156 | | | ``ETHTOOL_A_BITSET_BIT_VALUE`` | flag | present if bit is set | 157 +-+-+--------------------------------+--------+-----------------------------+ 158 159Bit size is optional for bit-by-bit form. ``ETHTOOL_A_BITSET_BITS`` nest can 160only contain ``ETHTOOL_A_BITSET_BITS_BIT`` attributes but there can be an 161arbitrary number of them. A bit may be identified by its index or by its 162name. When used in requests, listed bits are set to 0 or 1 according to 163``ETHTOOL_A_BITSET_BIT_VALUE``, the rest is preserved. A request fails if 164index exceeds kernel bit length or if name is not recognized. 165 166When ``ETHTOOL_A_BITSET_NOMASK`` flag is present, bitset is interpreted as 167a simple bitmap. ``ETHTOOL_A_BITSET_BIT_VALUE`` attributes are not used in 168such case. Such bitset represents a bitmap with listed bits set and the rest 169zero. 170 171In requests, application can use either form. Form used by kernel in reply is 172determined by ``ETHTOOL_FLAG_COMPACT_BITSETS`` flag in flags field of request 173header. Semantics of value and mask depends on the attribute. 174 175 176List of message types 177===================== 178 179All constants identifying message types use ``ETHTOOL_CMD_`` prefix and suffix 180according to message purpose: 181 182 ============== ====================================== 183 ``_GET`` userspace request to retrieve data 184 ``_SET`` userspace request to set data 185 ``_ACT`` userspace request to perform an action 186 ``_GET_REPLY`` kernel reply to a ``GET`` request 187 ``_SET_REPLY`` kernel reply to a ``SET`` request 188 ``_ACT_REPLY`` kernel reply to an ``ACT`` request 189 ``_NTF`` kernel notification 190 ============== ====================================== 191 192Userspace to kernel: 193 194 ===================================== ================================= 195 ``ETHTOOL_MSG_STRSET_GET`` get string set 196 ``ETHTOOL_MSG_LINKINFO_GET`` get link settings 197 ``ETHTOOL_MSG_LINKINFO_SET`` set link settings 198 ``ETHTOOL_MSG_LINKMODES_GET`` get link modes info 199 ``ETHTOOL_MSG_LINKMODES_SET`` set link modes info 200 ``ETHTOOL_MSG_LINKSTATE_GET`` get link state 201 ``ETHTOOL_MSG_DEBUG_GET`` get debugging settings 202 ``ETHTOOL_MSG_DEBUG_SET`` set debugging settings 203 ``ETHTOOL_MSG_WOL_GET`` get wake-on-lan settings 204 ``ETHTOOL_MSG_WOL_SET`` set wake-on-lan settings 205 ``ETHTOOL_MSG_FEATURES_GET`` get device features 206 ``ETHTOOL_MSG_FEATURES_SET`` set device features 207 ``ETHTOOL_MSG_PRIVFLAGS_GET`` get private flags 208 ``ETHTOOL_MSG_PRIVFLAGS_SET`` set private flags 209 ``ETHTOOL_MSG_RINGS_GET`` get ring sizes 210 ``ETHTOOL_MSG_RINGS_SET`` set ring sizes 211 ``ETHTOOL_MSG_CHANNELS_GET`` get channel counts 212 ``ETHTOOL_MSG_CHANNELS_SET`` set channel counts 213 ``ETHTOOL_MSG_COALESCE_GET`` get coalescing parameters 214 ``ETHTOOL_MSG_COALESCE_SET`` set coalescing parameters 215 ``ETHTOOL_MSG_PAUSE_GET`` get pause parameters 216 ``ETHTOOL_MSG_PAUSE_SET`` set pause parameters 217 ``ETHTOOL_MSG_EEE_GET`` get EEE settings 218 ``ETHTOOL_MSG_EEE_SET`` set EEE settings 219 ``ETHTOOL_MSG_TSINFO_GET`` get timestamping info 220 ``ETHTOOL_MSG_CABLE_TEST_ACT`` action start cable test 221 ``ETHTOOL_MSG_CABLE_TEST_TDR_ACT`` action start raw TDR cable test 222 ``ETHTOOL_MSG_TUNNEL_INFO_GET`` get tunnel offload info 223 ``ETHTOOL_MSG_FEC_GET`` get FEC settings 224 ``ETHTOOL_MSG_FEC_SET`` set FEC settings 225 ``ETHTOOL_MSG_MODULE_EEPROM_GET`` read SFP module EEPROM 226 ``ETHTOOL_MSG_STATS_GET`` get standard statistics 227 ``ETHTOOL_MSG_PHC_VCLOCKS_GET`` get PHC virtual clocks info 228 ``ETHTOOL_MSG_MODULE_SET`` set transceiver module parameters 229 ``ETHTOOL_MSG_MODULE_GET`` get transceiver module parameters 230 ``ETHTOOL_MSG_PSE_SET`` set PSE parameters 231 ``ETHTOOL_MSG_PSE_GET`` get PSE parameters 232 ``ETHTOOL_MSG_RSS_GET`` get RSS settings 233 ``ETHTOOL_MSG_PLCA_GET_CFG`` get PLCA RS parameters 234 ``ETHTOOL_MSG_PLCA_SET_CFG`` set PLCA RS parameters 235 ``ETHTOOL_MSG_PLCA_GET_STATUS`` get PLCA RS status 236 ``ETHTOOL_MSG_MM_GET`` get MAC merge layer state 237 ``ETHTOOL_MSG_MM_SET`` set MAC merge layer parameters 238 ``ETHTOOL_MSG_MODULE_FW_FLASH_ACT`` flash transceiver module firmware 239 ``ETHTOOL_MSG_PHY_GET`` get Ethernet PHY information 240 ===================================== ================================= 241 242Kernel to userspace: 243 244 ======================================== ================================= 245 ``ETHTOOL_MSG_STRSET_GET_REPLY`` string set contents 246 ``ETHTOOL_MSG_LINKINFO_GET_REPLY`` link settings 247 ``ETHTOOL_MSG_LINKINFO_NTF`` link settings notification 248 ``ETHTOOL_MSG_LINKMODES_GET_REPLY`` link modes info 249 ``ETHTOOL_MSG_LINKMODES_NTF`` link modes notification 250 ``ETHTOOL_MSG_LINKSTATE_GET_REPLY`` link state info 251 ``ETHTOOL_MSG_DEBUG_GET_REPLY`` debugging settings 252 ``ETHTOOL_MSG_DEBUG_NTF`` debugging settings notification 253 ``ETHTOOL_MSG_WOL_GET_REPLY`` wake-on-lan settings 254 ``ETHTOOL_MSG_WOL_NTF`` wake-on-lan settings notification 255 ``ETHTOOL_MSG_FEATURES_GET_REPLY`` device features 256 ``ETHTOOL_MSG_FEATURES_SET_REPLY`` optional reply to FEATURES_SET 257 ``ETHTOOL_MSG_FEATURES_NTF`` netdev features notification 258 ``ETHTOOL_MSG_PRIVFLAGS_GET_REPLY`` private flags 259 ``ETHTOOL_MSG_PRIVFLAGS_NTF`` private flags 260 ``ETHTOOL_MSG_RINGS_GET_REPLY`` ring sizes 261 ``ETHTOOL_MSG_RINGS_NTF`` ring sizes 262 ``ETHTOOL_MSG_CHANNELS_GET_REPLY`` channel counts 263 ``ETHTOOL_MSG_CHANNELS_NTF`` channel counts 264 ``ETHTOOL_MSG_COALESCE_GET_REPLY`` coalescing parameters 265 ``ETHTOOL_MSG_COALESCE_NTF`` coalescing parameters 266 ``ETHTOOL_MSG_PAUSE_GET_REPLY`` pause parameters 267 ``ETHTOOL_MSG_PAUSE_NTF`` pause parameters 268 ``ETHTOOL_MSG_EEE_GET_REPLY`` EEE settings 269 ``ETHTOOL_MSG_EEE_NTF`` EEE settings 270 ``ETHTOOL_MSG_TSINFO_GET_REPLY`` timestamping info 271 ``ETHTOOL_MSG_CABLE_TEST_NTF`` Cable test results 272 ``ETHTOOL_MSG_CABLE_TEST_TDR_NTF`` Cable test TDR results 273 ``ETHTOOL_MSG_TUNNEL_INFO_GET_REPLY`` tunnel offload info 274 ``ETHTOOL_MSG_FEC_GET_REPLY`` FEC settings 275 ``ETHTOOL_MSG_FEC_NTF`` FEC settings 276 ``ETHTOOL_MSG_MODULE_EEPROM_GET_REPLY`` read SFP module EEPROM 277 ``ETHTOOL_MSG_STATS_GET_REPLY`` standard statistics 278 ``ETHTOOL_MSG_PHC_VCLOCKS_GET_REPLY`` PHC virtual clocks info 279 ``ETHTOOL_MSG_MODULE_GET_REPLY`` transceiver module parameters 280 ``ETHTOOL_MSG_PSE_GET_REPLY`` PSE parameters 281 ``ETHTOOL_MSG_RSS_GET_REPLY`` RSS settings 282 ``ETHTOOL_MSG_PLCA_GET_CFG_REPLY`` PLCA RS parameters 283 ``ETHTOOL_MSG_PLCA_GET_STATUS_REPLY`` PLCA RS status 284 ``ETHTOOL_MSG_PLCA_NTF`` PLCA RS parameters 285 ``ETHTOOL_MSG_MM_GET_REPLY`` MAC merge layer status 286 ``ETHTOOL_MSG_MODULE_FW_FLASH_NTF`` transceiver module flash updates 287 ``ETHTOOL_MSG_PHY_GET_REPLY`` Ethernet PHY information 288 ``ETHTOOL_MSG_PHY_NTF`` Ethernet PHY information change 289 ======================================== ================================= 290 291``GET`` requests are sent by userspace applications to retrieve device 292information. They usually do not contain any message specific attributes. 293Kernel replies with corresponding "GET_REPLY" message. For most types, ``GET`` 294request with ``NLM_F_DUMP`` and no device identification can be used to query 295the information for all devices supporting the request. 296 297If the data can be also modified, corresponding ``SET`` message with the same 298layout as corresponding ``GET_REPLY`` is used to request changes. Only 299attributes where a change is requested are included in such request (also, not 300all attributes may be changed). Replies to most ``SET`` request consist only 301of error code and extack; if kernel provides additional data, it is sent in 302the form of corresponding ``SET_REPLY`` message which can be suppressed by 303setting ``ETHTOOL_FLAG_OMIT_REPLY`` flag in request header. 304 305Data modification also triggers sending a ``NTF`` message with a notification. 306These usually bear only a subset of attributes which was affected by the 307change. The same notification is issued if the data is modified using other 308means (mostly ioctl ethtool interface). Unlike notifications from ethtool 309netlink code which are only sent if something actually changed, notifications 310triggered by ioctl interface may be sent even if the request did not actually 311change any data. 312 313``ACT`` messages request kernel (driver) to perform a specific action. If some 314information is reported by kernel (which can be suppressed by setting 315``ETHTOOL_FLAG_OMIT_REPLY`` flag in request header), the reply takes form of 316an ``ACT_REPLY`` message. Performing an action also triggers a notification 317(``NTF`` message). 318 319Later sections describe the format and semantics of these messages. 320 321 322STRSET_GET 323========== 324 325Requests contents of a string set as provided by ioctl commands 326``ETHTOOL_GSSET_INFO`` and ``ETHTOOL_GSTRINGS.`` String sets are not user 327writeable so that the corresponding ``STRSET_SET`` message is only used in 328kernel replies. There are two types of string sets: global (independent of 329a device, e.g. device feature names) and device specific (e.g. device private 330flags). 331 332Request contents: 333 334 +---------------------------------------+--------+------------------------+ 335 | ``ETHTOOL_A_STRSET_HEADER`` | nested | request header | 336 +---------------------------------------+--------+------------------------+ 337 | ``ETHTOOL_A_STRSET_STRINGSETS`` | nested | string set to request | 338 +-+-------------------------------------+--------+------------------------+ 339 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set | 340 +-+-+-----------------------------------+--------+------------------------+ 341 | | | ``ETHTOOL_A_STRINGSET_ID`` | u32 | set id | 342 +-+-+-----------------------------------+--------+------------------------+ 343 344Kernel response contents: 345 346 +---------------------------------------+--------+-----------------------+ 347 | ``ETHTOOL_A_STRSET_HEADER`` | nested | reply header | 348 +---------------------------------------+--------+-----------------------+ 349 | ``ETHTOOL_A_STRSET_STRINGSETS`` | nested | array of string sets | 350 +-+-------------------------------------+--------+-----------------------+ 351 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set | 352 +-+-+-----------------------------------+--------+-----------------------+ 353 | | | ``ETHTOOL_A_STRINGSET_ID`` | u32 | set id | 354 +-+-+-----------------------------------+--------+-----------------------+ 355 | | | ``ETHTOOL_A_STRINGSET_COUNT`` | u32 | number of strings | 356 +-+-+-----------------------------------+--------+-----------------------+ 357 | | | ``ETHTOOL_A_STRINGSET_STRINGS`` | nested | array of strings | 358 +-+-+-+---------------------------------+--------+-----------------------+ 359 | | | | ``ETHTOOL_A_STRINGS_STRING+`` | nested | one string | 360 +-+-+-+-+-------------------------------+--------+-----------------------+ 361 | | | | | ``ETHTOOL_A_STRING_INDEX`` | u32 | string index | 362 +-+-+-+-+-------------------------------+--------+-----------------------+ 363 | | | | | ``ETHTOOL_A_STRING_VALUE`` | string | string value | 364 +-+-+-+-+-------------------------------+--------+-----------------------+ 365 | ``ETHTOOL_A_STRSET_COUNTS_ONLY`` | flag | return only counts | 366 +---------------------------------------+--------+-----------------------+ 367 368Device identification in request header is optional. Depending on its presence 369a and ``NLM_F_DUMP`` flag, there are three type of ``STRSET_GET`` requests: 370 371 - no ``NLM_F_DUMP,`` no device: get "global" stringsets 372 - no ``NLM_F_DUMP``, with device: get string sets related to the device 373 - ``NLM_F_DUMP``, no device: get device related string sets for all devices 374 375If there is no ``ETHTOOL_A_STRSET_STRINGSETS`` array, all string sets of 376requested type are returned, otherwise only those specified in the request. 377Flag ``ETHTOOL_A_STRSET_COUNTS_ONLY`` tells kernel to only return string 378counts of the sets, not the actual strings. 379 380 381LINKINFO_GET 382============ 383 384Requests link settings as provided by ``ETHTOOL_GLINKSETTINGS`` except for 385link modes and autonegotiation related information. The request does not use 386any attributes. 387 388Request contents: 389 390 ==================================== ====== ========================== 391 ``ETHTOOL_A_LINKINFO_HEADER`` nested request header 392 ==================================== ====== ========================== 393 394Kernel response contents: 395 396 ==================================== ====== ========================== 397 ``ETHTOOL_A_LINKINFO_HEADER`` nested reply header 398 ``ETHTOOL_A_LINKINFO_PORT`` u8 physical port 399 ``ETHTOOL_A_LINKINFO_PHYADDR`` u8 phy MDIO address 400 ``ETHTOOL_A_LINKINFO_TP_MDIX`` u8 MDI(-X) status 401 ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL`` u8 MDI(-X) control 402 ``ETHTOOL_A_LINKINFO_TRANSCEIVER`` u8 transceiver 403 ==================================== ====== ========================== 404 405Attributes and their values have the same meaning as matching members of the 406corresponding ioctl structures. 407 408``LINKINFO_GET`` allows dump requests (kernel returns reply message for all 409devices supporting the request). 410 411 412LINKINFO_SET 413============ 414 415``LINKINFO_SET`` request allows setting some of the attributes reported by 416``LINKINFO_GET``. 417 418Request contents: 419 420 ==================================== ====== ========================== 421 ``ETHTOOL_A_LINKINFO_HEADER`` nested request header 422 ``ETHTOOL_A_LINKINFO_PORT`` u8 physical port 423 ``ETHTOOL_A_LINKINFO_PHYADDR`` u8 phy MDIO address 424 ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL`` u8 MDI(-X) control 425 ==================================== ====== ========================== 426 427MDI(-X) status and transceiver cannot be set, request with the corresponding 428attributes is rejected. 429 430 431LINKMODES_GET 432============= 433 434Requests link modes (supported, advertised and peer advertised) and related 435information (autonegotiation status, link speed and duplex) as provided by 436``ETHTOOL_GLINKSETTINGS``. The request does not use any attributes. 437 438Request contents: 439 440 ==================================== ====== ========================== 441 ``ETHTOOL_A_LINKMODES_HEADER`` nested request header 442 ==================================== ====== ========================== 443 444Kernel response contents: 445 446 ========================================== ====== ========================== 447 ``ETHTOOL_A_LINKMODES_HEADER`` nested reply header 448 ``ETHTOOL_A_LINKMODES_AUTONEG`` u8 autonegotiation status 449 ``ETHTOOL_A_LINKMODES_OURS`` bitset advertised link modes 450 ``ETHTOOL_A_LINKMODES_PEER`` bitset partner link modes 451 ``ETHTOOL_A_LINKMODES_SPEED`` u32 link speed (Mb/s) 452 ``ETHTOOL_A_LINKMODES_DUPLEX`` u8 duplex mode 453 ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_CFG`` u8 Master/slave port mode 454 ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_STATE`` u8 Master/slave port state 455 ``ETHTOOL_A_LINKMODES_RATE_MATCHING`` u8 PHY rate matching 456 ========================================== ====== ========================== 457 458For ``ETHTOOL_A_LINKMODES_OURS``, value represents advertised modes and mask 459represents supported modes. ``ETHTOOL_A_LINKMODES_PEER`` in the reply is a bit 460list. 461 462``LINKMODES_GET`` allows dump requests (kernel returns reply messages for all 463devices supporting the request). 464 465 466LINKMODES_SET 467============= 468 469Request contents: 470 471 ========================================== ====== ========================== 472 ``ETHTOOL_A_LINKMODES_HEADER`` nested request header 473 ``ETHTOOL_A_LINKMODES_AUTONEG`` u8 autonegotiation status 474 ``ETHTOOL_A_LINKMODES_OURS`` bitset advertised link modes 475 ``ETHTOOL_A_LINKMODES_PEER`` bitset partner link modes 476 ``ETHTOOL_A_LINKMODES_SPEED`` u32 link speed (Mb/s) 477 ``ETHTOOL_A_LINKMODES_DUPLEX`` u8 duplex mode 478 ``ETHTOOL_A_LINKMODES_MASTER_SLAVE_CFG`` u8 Master/slave port mode 479 ``ETHTOOL_A_LINKMODES_RATE_MATCHING`` u8 PHY rate matching 480 ``ETHTOOL_A_LINKMODES_LANES`` u32 lanes 481 ========================================== ====== ========================== 482 483``ETHTOOL_A_LINKMODES_OURS`` bit set allows setting advertised link modes. If 484autonegotiation is on (either set now or kept from before), advertised modes 485are not changed (no ``ETHTOOL_A_LINKMODES_OURS`` attribute) and at least one 486of speed, duplex and lanes is specified, kernel adjusts advertised modes to all 487supported modes matching speed, duplex, lanes or all (whatever is specified). 488This autoselection is done on ethtool side with ioctl interface, netlink 489interface is supposed to allow requesting changes without knowing what exactly 490kernel supports. 491 492 493LINKSTATE_GET 494============= 495 496Requests link state information. Link up/down flag (as provided by 497``ETHTOOL_GLINK`` ioctl command) is provided. Optionally, extended state might 498be provided as well. In general, extended state describes reasons for why a port 499is down, or why it operates in some non-obvious mode. This request does not have 500any attributes. 501 502Request contents: 503 504 ==================================== ====== ========================== 505 ``ETHTOOL_A_LINKSTATE_HEADER`` nested request header 506 ==================================== ====== ========================== 507 508Kernel response contents: 509 510 ==================================== ====== ============================ 511 ``ETHTOOL_A_LINKSTATE_HEADER`` nested reply header 512 ``ETHTOOL_A_LINKSTATE_LINK`` bool link state (up/down) 513 ``ETHTOOL_A_LINKSTATE_SQI`` u32 Current Signal Quality Index 514 ``ETHTOOL_A_LINKSTATE_SQI_MAX`` u32 Max support SQI value 515 ``ETHTOOL_A_LINKSTATE_EXT_STATE`` u8 link extended state 516 ``ETHTOOL_A_LINKSTATE_EXT_SUBSTATE`` u8 link extended substate 517 ``ETHTOOL_A_LINKSTATE_EXT_DOWN_CNT`` u32 count of link down events 518 ==================================== ====== ============================ 519 520For most NIC drivers, the value of ``ETHTOOL_A_LINKSTATE_LINK`` returns 521carrier flag provided by ``netif_carrier_ok()`` but there are drivers which 522define their own handler. 523 524``ETHTOOL_A_LINKSTATE_EXT_STATE`` and ``ETHTOOL_A_LINKSTATE_EXT_SUBSTATE`` are 525optional values. ethtool core can provide either both 526``ETHTOOL_A_LINKSTATE_EXT_STATE`` and ``ETHTOOL_A_LINKSTATE_EXT_SUBSTATE``, 527or only ``ETHTOOL_A_LINKSTATE_EXT_STATE``, or none of them. 528 529``LINKSTATE_GET`` allows dump requests (kernel returns reply messages for all 530devices supporting the request). 531 532 533Link extended states: 534 535 ================================================ ============================================ 536 ``ETHTOOL_LINK_EXT_STATE_AUTONEG`` States relating to the autonegotiation or 537 issues therein 538 539 ``ETHTOOL_LINK_EXT_STATE_LINK_TRAINING_FAILURE`` Failure during link training 540 541 ``ETHTOOL_LINK_EXT_STATE_LINK_LOGICAL_MISMATCH`` Logical mismatch in physical coding sublayer 542 or forward error correction sublayer 543 544 ``ETHTOOL_LINK_EXT_STATE_BAD_SIGNAL_INTEGRITY`` Signal integrity issues 545 546 ``ETHTOOL_LINK_EXT_STATE_NO_CABLE`` No cable connected 547 548 ``ETHTOOL_LINK_EXT_STATE_CABLE_ISSUE`` Failure is related to cable, 549 e.g., unsupported cable 550 551 ``ETHTOOL_LINK_EXT_STATE_EEPROM_ISSUE`` Failure is related to EEPROM, e.g., failure 552 during reading or parsing the data 553 554 ``ETHTOOL_LINK_EXT_STATE_CALIBRATION_FAILURE`` Failure during calibration algorithm 555 556 ``ETHTOOL_LINK_EXT_STATE_POWER_BUDGET_EXCEEDED`` The hardware is not able to provide the 557 power required from cable or module 558 559 ``ETHTOOL_LINK_EXT_STATE_OVERHEAT`` The module is overheated 560 561 ``ETHTOOL_LINK_EXT_STATE_MODULE`` Transceiver module issue 562 ================================================ ============================================ 563 564Link extended substates: 565 566 Autoneg substates: 567 568 =============================================================== ================================ 569 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_NO_PARTNER_DETECTED`` Peer side is down 570 571 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_ACK_NOT_RECEIVED`` Ack not received from peer side 572 573 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_NEXT_PAGE_EXCHANGE_FAILED`` Next page exchange failed 574 575 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_NO_PARTNER_DETECTED_FORCE_MODE`` Peer side is down during force 576 mode or there is no agreement of 577 speed 578 579 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_FEC_MISMATCH_DURING_OVERRIDE`` Forward error correction modes 580 in both sides are mismatched 581 582 ``ETHTOOL_LINK_EXT_SUBSTATE_AN_NO_HCD`` No Highest Common Denominator 583 =============================================================== ================================ 584 585 Link training substates: 586 587 =========================================================================== ==================== 588 ``ETHTOOL_LINK_EXT_SUBSTATE_LT_KR_FRAME_LOCK_NOT_ACQUIRED`` Frames were not 589 recognized, the 590 lock failed 591 592 ``ETHTOOL_LINK_EXT_SUBSTATE_LT_KR_LINK_INHIBIT_TIMEOUT`` The lock did not 593 occur before 594 timeout 595 596 ``ETHTOOL_LINK_EXT_SUBSTATE_LT_KR_LINK_PARTNER_DID_NOT_SET_RECEIVER_READY`` Peer side did not 597 send ready signal 598 after training 599 process 600 601 ``ETHTOOL_LINK_EXT_SUBSTATE_LT_REMOTE_FAULT`` Remote side is not 602 ready yet 603 =========================================================================== ==================== 604 605 Link logical mismatch substates: 606 607 ================================================================ =============================== 608 ``ETHTOOL_LINK_EXT_SUBSTATE_LLM_PCS_DID_NOT_ACQUIRE_BLOCK_LOCK`` Physical coding sublayer was 609 not locked in first phase - 610 block lock 611 612 ``ETHTOOL_LINK_EXT_SUBSTATE_LLM_PCS_DID_NOT_ACQUIRE_AM_LOCK`` Physical coding sublayer was 613 not locked in second phase - 614 alignment markers lock 615 616 ``ETHTOOL_LINK_EXT_SUBSTATE_LLM_PCS_DID_NOT_GET_ALIGN_STATUS`` Physical coding sublayer did 617 not get align status 618 619 ``ETHTOOL_LINK_EXT_SUBSTATE_LLM_FC_FEC_IS_NOT_LOCKED`` FC forward error correction is 620 not locked 621 622 ``ETHTOOL_LINK_EXT_SUBSTATE_LLM_RS_FEC_IS_NOT_LOCKED`` RS forward error correction is 623 not locked 624 ================================================================ =============================== 625 626 Bad signal integrity substates: 627 628 ================================================================= ============================= 629 ``ETHTOOL_LINK_EXT_SUBSTATE_BSI_LARGE_NUMBER_OF_PHYSICAL_ERRORS`` Large number of physical 630 errors 631 632 ``ETHTOOL_LINK_EXT_SUBSTATE_BSI_UNSUPPORTED_RATE`` The system attempted to 633 operate the cable at a rate 634 that is not formally 635 supported, which led to 636 signal integrity issues 637 638 ``ETHTOOL_LINK_EXT_SUBSTATE_BSI_SERDES_REFERENCE_CLOCK_LOST`` The external clock signal for 639 SerDes is too weak or 640 unavailable. 641 642 ``ETHTOOL_LINK_EXT_SUBSTATE_BSI_SERDES_ALOS`` The received signal for 643 SerDes is too weak because 644 analog loss of signal. 645 ================================================================= ============================= 646 647 Cable issue substates: 648 649 =================================================== ============================================ 650 ``ETHTOOL_LINK_EXT_SUBSTATE_CI_UNSUPPORTED_CABLE`` Unsupported cable 651 652 ``ETHTOOL_LINK_EXT_SUBSTATE_CI_CABLE_TEST_FAILURE`` Cable test failure 653 =================================================== ============================================ 654 655 Transceiver module issue substates: 656 657 =================================================== ============================================ 658 ``ETHTOOL_LINK_EXT_SUBSTATE_MODULE_CMIS_NOT_READY`` The CMIS Module State Machine did not reach 659 the ModuleReady state. For example, if the 660 module is stuck at ModuleFault state 661 =================================================== ============================================ 662 663DEBUG_GET 664========= 665 666Requests debugging settings of a device. At the moment, only message mask is 667provided. 668 669Request contents: 670 671 ==================================== ====== ========================== 672 ``ETHTOOL_A_DEBUG_HEADER`` nested request header 673 ==================================== ====== ========================== 674 675Kernel response contents: 676 677 ==================================== ====== ========================== 678 ``ETHTOOL_A_DEBUG_HEADER`` nested reply header 679 ``ETHTOOL_A_DEBUG_MSGMASK`` bitset message mask 680 ==================================== ====== ========================== 681 682The message mask (``ETHTOOL_A_DEBUG_MSGMASK``) is equal to message level as 683provided by ``ETHTOOL_GMSGLVL`` and set by ``ETHTOOL_SMSGLVL`` in ioctl 684interface. While it is called message level there for historical reasons, most 685drivers and almost all newer drivers use it as a mask of enabled message 686classes (represented by ``NETIF_MSG_*`` constants); therefore netlink 687interface follows its actual use in practice. 688 689``DEBUG_GET`` allows dump requests (kernel returns reply messages for all 690devices supporting the request). 691 692 693DEBUG_SET 694========= 695 696Set or update debugging settings of a device. At the moment, only message mask 697is supported. 698 699Request contents: 700 701 ==================================== ====== ========================== 702 ``ETHTOOL_A_DEBUG_HEADER`` nested request header 703 ``ETHTOOL_A_DEBUG_MSGMASK`` bitset message mask 704 ==================================== ====== ========================== 705 706``ETHTOOL_A_DEBUG_MSGMASK`` bit set allows setting or modifying mask of 707enabled debugging message types for the device. 708 709 710WOL_GET 711======= 712 713Query device wake-on-lan settings. Unlike most "GET" type requests, 714``ETHTOOL_MSG_WOL_GET`` requires (netns) ``CAP_NET_ADMIN`` privileges as it 715(potentially) provides SecureOn(tm) password which is confidential. 716 717Request contents: 718 719 ==================================== ====== ========================== 720 ``ETHTOOL_A_WOL_HEADER`` nested request header 721 ==================================== ====== ========================== 722 723Kernel response contents: 724 725 ==================================== ====== ========================== 726 ``ETHTOOL_A_WOL_HEADER`` nested reply header 727 ``ETHTOOL_A_WOL_MODES`` bitset mask of enabled WoL modes 728 ``ETHTOOL_A_WOL_SOPASS`` binary SecureOn(tm) password 729 ==================================== ====== ========================== 730 731In reply, ``ETHTOOL_A_WOL_MODES`` mask consists of modes supported by the 732device, value of modes which are enabled. ``ETHTOOL_A_WOL_SOPASS`` is only 733included in reply if ``WAKE_MAGICSECURE`` mode is supported. 734 735 736WOL_SET 737======= 738 739Set or update wake-on-lan settings. 740 741Request contents: 742 743 ==================================== ====== ========================== 744 ``ETHTOOL_A_WOL_HEADER`` nested request header 745 ``ETHTOOL_A_WOL_MODES`` bitset enabled WoL modes 746 ``ETHTOOL_A_WOL_SOPASS`` binary SecureOn(tm) password 747 ==================================== ====== ========================== 748 749``ETHTOOL_A_WOL_SOPASS`` is only allowed for devices supporting 750``WAKE_MAGICSECURE`` mode. 751 752 753FEATURES_GET 754============ 755 756Gets netdev features like ``ETHTOOL_GFEATURES`` ioctl request. 757 758Request contents: 759 760 ==================================== ====== ========================== 761 ``ETHTOOL_A_FEATURES_HEADER`` nested request header 762 ==================================== ====== ========================== 763 764Kernel response contents: 765 766 ==================================== ====== ========================== 767 ``ETHTOOL_A_FEATURES_HEADER`` nested reply header 768 ``ETHTOOL_A_FEATURES_HW`` bitset dev->hw_features 769 ``ETHTOOL_A_FEATURES_WANTED`` bitset dev->wanted_features 770 ``ETHTOOL_A_FEATURES_ACTIVE`` bitset dev->features 771 ``ETHTOOL_A_FEATURES_NOCHANGE`` bitset NETIF_F_NEVER_CHANGE 772 ==================================== ====== ========================== 773 774Bitmaps in kernel response have the same meaning as bitmaps used in ioctl 775interference but attribute names are different (they are based on 776corresponding members of struct net_device). Legacy "flags" are not provided, 777if userspace needs them (most likely only ethtool for backward compatibility), 778it can calculate their values from related feature bits itself. 779ETHA_FEATURES_HW uses mask consisting of all features recognized by kernel (to 780provide all names when using verbose bitmap format), the other three use no 781mask (simple bit lists). 782 783 784FEATURES_SET 785============ 786 787Request to set netdev features like ``ETHTOOL_SFEATURES`` ioctl request. 788 789Request contents: 790 791 ==================================== ====== ========================== 792 ``ETHTOOL_A_FEATURES_HEADER`` nested request header 793 ``ETHTOOL_A_FEATURES_WANTED`` bitset requested features 794 ==================================== ====== ========================== 795 796Kernel response contents: 797 798 ==================================== ====== ========================== 799 ``ETHTOOL_A_FEATURES_HEADER`` nested reply header 800 ``ETHTOOL_A_FEATURES_WANTED`` bitset diff wanted vs. result 801 ``ETHTOOL_A_FEATURES_ACTIVE`` bitset diff old vs. new active 802 ==================================== ====== ========================== 803 804Request contains only one bitset which can be either value/mask pair (request 805to change specific feature bits and leave the rest) or only a value (request 806to set all features to specified set). 807 808As request is subject to netdev_change_features() sanity checks, optional 809kernel reply (can be suppressed by ``ETHTOOL_FLAG_OMIT_REPLY`` flag in request 810header) informs client about the actual result. ``ETHTOOL_A_FEATURES_WANTED`` 811reports the difference between client request and actual result: mask consists 812of bits which differ between requested features and result (dev->features 813after the operation), value consists of values of these bits in the request 814(i.e. negated values from resulting features). ``ETHTOOL_A_FEATURES_ACTIVE`` 815reports the difference between old and new dev->features: mask consists of 816bits which have changed, values are their values in new dev->features (after 817the operation). 818 819``ETHTOOL_MSG_FEATURES_NTF`` notification is sent not only if device features 820are modified using ``ETHTOOL_MSG_FEATURES_SET`` request or on of ethtool ioctl 821request but also each time features are modified with netdev_update_features() 822or netdev_change_features(). 823 824 825PRIVFLAGS_GET 826============= 827 828Gets private flags like ``ETHTOOL_GPFLAGS`` ioctl request. 829 830Request contents: 831 832 ==================================== ====== ========================== 833 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested request header 834 ==================================== ====== ========================== 835 836Kernel response contents: 837 838 ==================================== ====== ========================== 839 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested reply header 840 ``ETHTOOL_A_PRIVFLAGS_FLAGS`` bitset private flags 841 ==================================== ====== ========================== 842 843``ETHTOOL_A_PRIVFLAGS_FLAGS`` is a bitset with values of device private flags. 844These flags are defined by driver, their number and names (and also meaning) 845are device dependent. For compact bitset format, names can be retrieved as 846``ETH_SS_PRIV_FLAGS`` string set. If verbose bitset format is requested, 847response uses all private flags supported by the device as mask so that client 848gets the full information without having to fetch the string set with names. 849 850 851PRIVFLAGS_SET 852============= 853 854Sets or modifies values of device private flags like ``ETHTOOL_SPFLAGS`` 855ioctl request. 856 857Request contents: 858 859 ==================================== ====== ========================== 860 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested request header 861 ``ETHTOOL_A_PRIVFLAGS_FLAGS`` bitset private flags 862 ==================================== ====== ========================== 863 864``ETHTOOL_A_PRIVFLAGS_FLAGS`` can either set the whole set of private flags or 865modify only values of some of them. 866 867 868RINGS_GET 869========= 870 871Gets ring sizes like ``ETHTOOL_GRINGPARAM`` ioctl request. 872 873Request contents: 874 875 ==================================== ====== ========================== 876 ``ETHTOOL_A_RINGS_HEADER`` nested request header 877 ==================================== ====== ========================== 878 879Kernel response contents: 880 881 ======================================= ====== =========================== 882 ``ETHTOOL_A_RINGS_HEADER`` nested reply header 883 ``ETHTOOL_A_RINGS_RX_MAX`` u32 max size of RX ring 884 ``ETHTOOL_A_RINGS_RX_MINI_MAX`` u32 max size of RX mini ring 885 ``ETHTOOL_A_RINGS_RX_JUMBO_MAX`` u32 max size of RX jumbo ring 886 ``ETHTOOL_A_RINGS_TX_MAX`` u32 max size of TX ring 887 ``ETHTOOL_A_RINGS_RX`` u32 size of RX ring 888 ``ETHTOOL_A_RINGS_RX_MINI`` u32 size of RX mini ring 889 ``ETHTOOL_A_RINGS_RX_JUMBO`` u32 size of RX jumbo ring 890 ``ETHTOOL_A_RINGS_TX`` u32 size of TX ring 891 ``ETHTOOL_A_RINGS_RX_BUF_LEN`` u32 size of buffers on the ring 892 ``ETHTOOL_A_RINGS_TCP_DATA_SPLIT`` u8 TCP header / data split 893 ``ETHTOOL_A_RINGS_CQE_SIZE`` u32 Size of TX/RX CQE 894 ``ETHTOOL_A_RINGS_TX_PUSH`` u8 flag of TX Push mode 895 ``ETHTOOL_A_RINGS_RX_PUSH`` u8 flag of RX Push mode 896 ``ETHTOOL_A_RINGS_TX_PUSH_BUF_LEN`` u32 size of TX push buffer 897 ``ETHTOOL_A_RINGS_TX_PUSH_BUF_LEN_MAX`` u32 max size of TX push buffer 898 ======================================= ====== =========================== 899 900``ETHTOOL_A_RINGS_TCP_DATA_SPLIT`` indicates whether the device is usable with 901page-flipping TCP zero-copy receive (``getsockopt(TCP_ZEROCOPY_RECEIVE)``). 902If enabled the device is configured to place frame headers and data into 903separate buffers. The device configuration must make it possible to receive 904full memory pages of data, for example because MTU is high enough or through 905HW-GRO. 906 907``ETHTOOL_A_RINGS_[RX|TX]_PUSH`` flag is used to enable descriptor fast 908path to send or receive packets. In ordinary path, driver fills descriptors in DRAM and 909notifies NIC hardware. In fast path, driver pushes descriptors to the device 910through MMIO writes, thus reducing the latency. However, enabling this feature 911may increase the CPU cost. Drivers may enforce additional per-packet 912eligibility checks (e.g. on packet size). 913 914``ETHTOOL_A_RINGS_TX_PUSH_BUF_LEN`` specifies the maximum number of bytes of a 915transmitted packet a driver can push directly to the underlying device 916('push' mode). Pushing some of the payload bytes to the device has the 917advantages of reducing latency for small packets by avoiding DMA mapping (same 918as ``ETHTOOL_A_RINGS_TX_PUSH`` parameter) as well as allowing the underlying 919device to process packet headers ahead of fetching its payload. 920This can help the device to make fast actions based on the packet's headers. 921This is similar to the "tx-copybreak" parameter, which copies the packet to a 922preallocated DMA memory area instead of mapping new memory. However, 923tx-push-buff parameter copies the packet directly to the device to allow the 924device to take faster actions on the packet. 925 926RINGS_SET 927========= 928 929Sets ring sizes like ``ETHTOOL_SRINGPARAM`` ioctl request. 930 931Request contents: 932 933 ==================================== ====== =========================== 934 ``ETHTOOL_A_RINGS_HEADER`` nested reply header 935 ``ETHTOOL_A_RINGS_RX`` u32 size of RX ring 936 ``ETHTOOL_A_RINGS_RX_MINI`` u32 size of RX mini ring 937 ``ETHTOOL_A_RINGS_RX_JUMBO`` u32 size of RX jumbo ring 938 ``ETHTOOL_A_RINGS_TX`` u32 size of TX ring 939 ``ETHTOOL_A_RINGS_RX_BUF_LEN`` u32 size of buffers on the ring 940 ``ETHTOOL_A_RINGS_CQE_SIZE`` u32 Size of TX/RX CQE 941 ``ETHTOOL_A_RINGS_TX_PUSH`` u8 flag of TX Push mode 942 ``ETHTOOL_A_RINGS_RX_PUSH`` u8 flag of RX Push mode 943 ``ETHTOOL_A_RINGS_TX_PUSH_BUF_LEN`` u32 size of TX push buffer 944 ==================================== ====== =========================== 945 946Kernel checks that requested ring sizes do not exceed limits reported by 947driver. Driver may impose additional constraints and may not support all 948attributes. 949 950 951``ETHTOOL_A_RINGS_CQE_SIZE`` specifies the completion queue event size. 952Completion queue events (CQE) are the events posted by NIC to indicate the 953completion status of a packet when the packet is sent (like send success or 954error) or received (like pointers to packet fragments). The CQE size parameter 955enables to modify the CQE size other than default size if NIC supports it. 956A bigger CQE can have more receive buffer pointers, and in turn the NIC can 957transfer a bigger frame from wire. Based on the NIC hardware, the overall 958completion queue size can be adjusted in the driver if CQE size is modified. 959 960CHANNELS_GET 961============ 962 963Gets channel counts like ``ETHTOOL_GCHANNELS`` ioctl request. 964 965Request contents: 966 967 ==================================== ====== ========================== 968 ``ETHTOOL_A_CHANNELS_HEADER`` nested request header 969 ==================================== ====== ========================== 970 971Kernel response contents: 972 973 ===================================== ====== ========================== 974 ``ETHTOOL_A_CHANNELS_HEADER`` nested reply header 975 ``ETHTOOL_A_CHANNELS_RX_MAX`` u32 max receive channels 976 ``ETHTOOL_A_CHANNELS_TX_MAX`` u32 max transmit channels 977 ``ETHTOOL_A_CHANNELS_OTHER_MAX`` u32 max other channels 978 ``ETHTOOL_A_CHANNELS_COMBINED_MAX`` u32 max combined channels 979 ``ETHTOOL_A_CHANNELS_RX_COUNT`` u32 receive channel count 980 ``ETHTOOL_A_CHANNELS_TX_COUNT`` u32 transmit channel count 981 ``ETHTOOL_A_CHANNELS_OTHER_COUNT`` u32 other channel count 982 ``ETHTOOL_A_CHANNELS_COMBINED_COUNT`` u32 combined channel count 983 ===================================== ====== ========================== 984 985 986CHANNELS_SET 987============ 988 989Sets channel counts like ``ETHTOOL_SCHANNELS`` ioctl request. 990 991Request contents: 992 993 ===================================== ====== ========================== 994 ``ETHTOOL_A_CHANNELS_HEADER`` nested request header 995 ``ETHTOOL_A_CHANNELS_RX_COUNT`` u32 receive channel count 996 ``ETHTOOL_A_CHANNELS_TX_COUNT`` u32 transmit channel count 997 ``ETHTOOL_A_CHANNELS_OTHER_COUNT`` u32 other channel count 998 ``ETHTOOL_A_CHANNELS_COMBINED_COUNT`` u32 combined channel count 999 ===================================== ====== ========================== 1000 1001Kernel checks that requested channel counts do not exceed limits reported by 1002driver. Driver may impose additional constraints and may not support all 1003attributes. 1004 1005 1006COALESCE_GET 1007============ 1008 1009Gets coalescing parameters like ``ETHTOOL_GCOALESCE`` ioctl request. 1010 1011Request contents: 1012 1013 ==================================== ====== ========================== 1014 ``ETHTOOL_A_COALESCE_HEADER`` nested request header 1015 ==================================== ====== ========================== 1016 1017Kernel response contents: 1018 1019 =========================================== ====== ======================= 1020 ``ETHTOOL_A_COALESCE_HEADER`` nested reply header 1021 ``ETHTOOL_A_COALESCE_RX_USECS`` u32 delay (us), normal Rx 1022 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES`` u32 max packets, normal Rx 1023 ``ETHTOOL_A_COALESCE_RX_USECS_IRQ`` u32 delay (us), Rx in IRQ 1024 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_IRQ`` u32 max packets, Rx in IRQ 1025 ``ETHTOOL_A_COALESCE_TX_USECS`` u32 delay (us), normal Tx 1026 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES`` u32 max packets, normal Tx 1027 ``ETHTOOL_A_COALESCE_TX_USECS_IRQ`` u32 delay (us), Tx in IRQ 1028 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_IRQ`` u32 IRQ packets, Tx in IRQ 1029 ``ETHTOOL_A_COALESCE_STATS_BLOCK_USECS`` u32 delay of stats update 1030 ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_RX`` bool adaptive Rx coalesce 1031 ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_TX`` bool adaptive Tx coalesce 1032 ``ETHTOOL_A_COALESCE_PKT_RATE_LOW`` u32 threshold for low rate 1033 ``ETHTOOL_A_COALESCE_RX_USECS_LOW`` u32 delay (us), low Rx 1034 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_LOW`` u32 max packets, low Rx 1035 ``ETHTOOL_A_COALESCE_TX_USECS_LOW`` u32 delay (us), low Tx 1036 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_LOW`` u32 max packets, low Tx 1037 ``ETHTOOL_A_COALESCE_PKT_RATE_HIGH`` u32 threshold for high rate 1038 ``ETHTOOL_A_COALESCE_RX_USECS_HIGH`` u32 delay (us), high Rx 1039 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_HIGH`` u32 max packets, high Rx 1040 ``ETHTOOL_A_COALESCE_TX_USECS_HIGH`` u32 delay (us), high Tx 1041 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_HIGH`` u32 max packets, high Tx 1042 ``ETHTOOL_A_COALESCE_RATE_SAMPLE_INTERVAL`` u32 rate sampling interval 1043 ``ETHTOOL_A_COALESCE_USE_CQE_TX`` bool timer reset mode, Tx 1044 ``ETHTOOL_A_COALESCE_USE_CQE_RX`` bool timer reset mode, Rx 1045 ``ETHTOOL_A_COALESCE_TX_AGGR_MAX_BYTES`` u32 max aggr size, Tx 1046 ``ETHTOOL_A_COALESCE_TX_AGGR_MAX_FRAMES`` u32 max aggr packets, Tx 1047 ``ETHTOOL_A_COALESCE_TX_AGGR_TIME_USECS`` u32 time (us), aggr, Tx 1048 ``ETHTOOL_A_COALESCE_RX_PROFILE`` nested profile of DIM, Rx 1049 ``ETHTOOL_A_COALESCE_TX_PROFILE`` nested profile of DIM, Tx 1050 =========================================== ====== ======================= 1051 1052Attributes are only included in reply if their value is not zero or the 1053corresponding bit in ``ethtool_ops::supported_coalesce_params`` is set (i.e. 1054they are declared as supported by driver). 1055 1056Timer reset mode (``ETHTOOL_A_COALESCE_USE_CQE_TX`` and 1057``ETHTOOL_A_COALESCE_USE_CQE_RX``) controls the interaction between packet 1058arrival and the various time based delay parameters. By default timers are 1059expected to limit the max delay between any packet arrival/departure and a 1060corresponding interrupt. In this mode timer should be started by packet 1061arrival (sometimes delivery of previous interrupt) and reset when interrupt 1062is delivered. 1063Setting the appropriate attribute to 1 will enable ``CQE`` mode, where 1064each packet event resets the timer. In this mode timer is used to force 1065the interrupt if queue goes idle, while busy queues depend on the packet 1066limit to trigger interrupts. 1067 1068Tx aggregation consists of copying frames into a contiguous buffer so that they 1069can be submitted as a single IO operation. ``ETHTOOL_A_COALESCE_TX_AGGR_MAX_BYTES`` 1070describes the maximum size in bytes for the submitted buffer. 1071``ETHTOOL_A_COALESCE_TX_AGGR_MAX_FRAMES`` describes the maximum number of frames 1072that can be aggregated into a single buffer. 1073``ETHTOOL_A_COALESCE_TX_AGGR_TIME_USECS`` describes the amount of time in usecs, 1074counted since the first packet arrival in an aggregated block, after which the 1075block should be sent. 1076This feature is mainly of interest for specific USB devices which does not cope 1077well with frequent small-sized URBs transmissions. 1078 1079``ETHTOOL_A_COALESCE_RX_PROFILE`` and ``ETHTOOL_A_COALESCE_TX_PROFILE`` refer 1080to DIM parameters, see `Generic Network Dynamic Interrupt Moderation (Net DIM) 1081<https://www.kernel.org/doc/Documentation/networking/net_dim.rst>`_. 1082 1083COALESCE_SET 1084============ 1085 1086Sets coalescing parameters like ``ETHTOOL_SCOALESCE`` ioctl request. 1087 1088Request contents: 1089 1090 =========================================== ====== ======================= 1091 ``ETHTOOL_A_COALESCE_HEADER`` nested request header 1092 ``ETHTOOL_A_COALESCE_RX_USECS`` u32 delay (us), normal Rx 1093 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES`` u32 max packets, normal Rx 1094 ``ETHTOOL_A_COALESCE_RX_USECS_IRQ`` u32 delay (us), Rx in IRQ 1095 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_IRQ`` u32 max packets, Rx in IRQ 1096 ``ETHTOOL_A_COALESCE_TX_USECS`` u32 delay (us), normal Tx 1097 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES`` u32 max packets, normal Tx 1098 ``ETHTOOL_A_COALESCE_TX_USECS_IRQ`` u32 delay (us), Tx in IRQ 1099 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_IRQ`` u32 IRQ packets, Tx in IRQ 1100 ``ETHTOOL_A_COALESCE_STATS_BLOCK_USECS`` u32 delay of stats update 1101 ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_RX`` bool adaptive Rx coalesce 1102 ``ETHTOOL_A_COALESCE_USE_ADAPTIVE_TX`` bool adaptive Tx coalesce 1103 ``ETHTOOL_A_COALESCE_PKT_RATE_LOW`` u32 threshold for low rate 1104 ``ETHTOOL_A_COALESCE_RX_USECS_LOW`` u32 delay (us), low Rx 1105 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_LOW`` u32 max packets, low Rx 1106 ``ETHTOOL_A_COALESCE_TX_USECS_LOW`` u32 delay (us), low Tx 1107 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_LOW`` u32 max packets, low Tx 1108 ``ETHTOOL_A_COALESCE_PKT_RATE_HIGH`` u32 threshold for high rate 1109 ``ETHTOOL_A_COALESCE_RX_USECS_HIGH`` u32 delay (us), high Rx 1110 ``ETHTOOL_A_COALESCE_RX_MAX_FRAMES_HIGH`` u32 max packets, high Rx 1111 ``ETHTOOL_A_COALESCE_TX_USECS_HIGH`` u32 delay (us), high Tx 1112 ``ETHTOOL_A_COALESCE_TX_MAX_FRAMES_HIGH`` u32 max packets, high Tx 1113 ``ETHTOOL_A_COALESCE_RATE_SAMPLE_INTERVAL`` u32 rate sampling interval 1114 ``ETHTOOL_A_COALESCE_USE_CQE_TX`` bool timer reset mode, Tx 1115 ``ETHTOOL_A_COALESCE_USE_CQE_RX`` bool timer reset mode, Rx 1116 ``ETHTOOL_A_COALESCE_TX_AGGR_MAX_BYTES`` u32 max aggr size, Tx 1117 ``ETHTOOL_A_COALESCE_TX_AGGR_MAX_FRAMES`` u32 max aggr packets, Tx 1118 ``ETHTOOL_A_COALESCE_TX_AGGR_TIME_USECS`` u32 time (us), aggr, Tx 1119 ``ETHTOOL_A_COALESCE_RX_PROFILE`` nested profile of DIM, Rx 1120 ``ETHTOOL_A_COALESCE_TX_PROFILE`` nested profile of DIM, Tx 1121 =========================================== ====== ======================= 1122 1123Request is rejected if it attributes declared as unsupported by driver (i.e. 1124such that the corresponding bit in ``ethtool_ops::supported_coalesce_params`` 1125is not set), regardless of their values. Driver may impose additional 1126constraints on coalescing parameters and their values. 1127 1128Compared to requests issued via the ``ioctl()`` netlink version of this request 1129will try harder to make sure that values specified by the user have been applied 1130and may call the driver twice. 1131 1132 1133PAUSE_GET 1134========= 1135 1136Gets pause frame settings like ``ETHTOOL_GPAUSEPARAM`` ioctl request. 1137 1138Request contents: 1139 1140 ===================================== ====== ========================== 1141 ``ETHTOOL_A_PAUSE_HEADER`` nested request header 1142 ``ETHTOOL_A_PAUSE_STATS_SRC`` u32 source of statistics 1143 ===================================== ====== ========================== 1144 1145``ETHTOOL_A_PAUSE_STATS_SRC`` is optional. It takes values from: 1146 1147.. kernel-doc:: include/uapi/linux/ethtool.h 1148 :identifiers: ethtool_mac_stats_src 1149 1150If absent from the request, stats will be provided with 1151an ``ETHTOOL_A_PAUSE_STATS_SRC`` attribute in the response equal to 1152``ETHTOOL_MAC_STATS_SRC_AGGREGATE``. 1153 1154Kernel response contents: 1155 1156 ===================================== ====== ========================== 1157 ``ETHTOOL_A_PAUSE_HEADER`` nested request header 1158 ``ETHTOOL_A_PAUSE_AUTONEG`` bool pause autonegotiation 1159 ``ETHTOOL_A_PAUSE_RX`` bool receive pause frames 1160 ``ETHTOOL_A_PAUSE_TX`` bool transmit pause frames 1161 ``ETHTOOL_A_PAUSE_STATS`` nested pause statistics 1162 ===================================== ====== ========================== 1163 1164``ETHTOOL_A_PAUSE_STATS`` are reported if ``ETHTOOL_FLAG_STATS`` was set 1165in ``ETHTOOL_A_HEADER_FLAGS``. 1166It will be empty if driver did not report any statistics. Drivers fill in 1167the statistics in the following structure: 1168 1169.. kernel-doc:: include/linux/ethtool.h 1170 :identifiers: ethtool_pause_stats 1171 1172Each member has a corresponding attribute defined. 1173 1174PAUSE_SET 1175========= 1176 1177Sets pause parameters like ``ETHTOOL_GPAUSEPARAM`` ioctl request. 1178 1179Request contents: 1180 1181 ===================================== ====== ========================== 1182 ``ETHTOOL_A_PAUSE_HEADER`` nested request header 1183 ``ETHTOOL_A_PAUSE_AUTONEG`` bool pause autonegotiation 1184 ``ETHTOOL_A_PAUSE_RX`` bool receive pause frames 1185 ``ETHTOOL_A_PAUSE_TX`` bool transmit pause frames 1186 ===================================== ====== ========================== 1187 1188 1189EEE_GET 1190======= 1191 1192Gets Energy Efficient Ethernet settings like ``ETHTOOL_GEEE`` ioctl request. 1193 1194Request contents: 1195 1196 ===================================== ====== ========================== 1197 ``ETHTOOL_A_EEE_HEADER`` nested request header 1198 ===================================== ====== ========================== 1199 1200Kernel response contents: 1201 1202 ===================================== ====== ========================== 1203 ``ETHTOOL_A_EEE_HEADER`` nested request header 1204 ``ETHTOOL_A_EEE_MODES_OURS`` bool supported/advertised modes 1205 ``ETHTOOL_A_EEE_MODES_PEER`` bool peer advertised link modes 1206 ``ETHTOOL_A_EEE_ACTIVE`` bool EEE is actively used 1207 ``ETHTOOL_A_EEE_ENABLED`` bool EEE is enabled 1208 ``ETHTOOL_A_EEE_TX_LPI_ENABLED`` bool Tx lpi enabled 1209 ``ETHTOOL_A_EEE_TX_LPI_TIMER`` u32 Tx lpi timeout (in us) 1210 ===================================== ====== ========================== 1211 1212In ``ETHTOOL_A_EEE_MODES_OURS``, mask consists of link modes for which EEE is 1213enabled, value of link modes for which EEE is advertised. Link modes for which 1214peer advertises EEE are listed in ``ETHTOOL_A_EEE_MODES_PEER`` (no mask). The 1215netlink interface allows reporting EEE status for all link modes but only 1216first 32 are provided by the ``ethtool_ops`` callback. 1217 1218 1219EEE_SET 1220======= 1221 1222Sets Energy Efficient Ethernet parameters like ``ETHTOOL_SEEE`` ioctl request. 1223 1224Request contents: 1225 1226 ===================================== ====== ========================== 1227 ``ETHTOOL_A_EEE_HEADER`` nested request header 1228 ``ETHTOOL_A_EEE_MODES_OURS`` bool advertised modes 1229 ``ETHTOOL_A_EEE_ENABLED`` bool EEE is enabled 1230 ``ETHTOOL_A_EEE_TX_LPI_ENABLED`` bool Tx lpi enabled 1231 ``ETHTOOL_A_EEE_TX_LPI_TIMER`` u32 Tx lpi timeout (in us) 1232 ===================================== ====== ========================== 1233 1234``ETHTOOL_A_EEE_MODES_OURS`` is used to either list link modes to advertise 1235EEE for (if there is no mask) or specify changes to the list (if there is 1236a mask). The netlink interface allows reporting EEE status for all link modes 1237but only first 32 can be set at the moment as that is what the ``ethtool_ops`` 1238callback supports. 1239 1240 1241TSINFO_GET 1242========== 1243 1244Gets timestamping information like ``ETHTOOL_GET_TS_INFO`` ioctl request. 1245 1246Request contents: 1247 1248 ======================================== ====== ============================ 1249 ``ETHTOOL_A_TSINFO_HEADER`` nested request header 1250 ``ETHTOOL_A_TSINFO_HWTSTAMP_PROVIDER`` nested PTP hw clock provider 1251 ======================================== ====== ============================ 1252 1253Kernel response contents: 1254 1255 ===================================== ====== ========================== 1256 ``ETHTOOL_A_TSINFO_HEADER`` nested request header 1257 ``ETHTOOL_A_TSINFO_TIMESTAMPING`` bitset SO_TIMESTAMPING flags 1258 ``ETHTOOL_A_TSINFO_TX_TYPES`` bitset supported Tx types 1259 ``ETHTOOL_A_TSINFO_RX_FILTERS`` bitset supported Rx filters 1260 ``ETHTOOL_A_TSINFO_PHC_INDEX`` u32 PTP hw clock index 1261 ``ETHTOOL_A_TSINFO_STATS`` nested HW timestamping statistics 1262 ===================================== ====== ========================== 1263 1264``ETHTOOL_A_TSINFO_PHC_INDEX`` is absent if there is no associated PHC (there 1265is no special value for this case). The bitset attributes are omitted if they 1266would be empty (no bit set). 1267 1268Additional hardware timestamping statistics response contents: 1269 1270 ===================================== ====== =================================== 1271 ``ETHTOOL_A_TS_STAT_TX_PKTS`` uint Packets with Tx HW timestamps 1272 ``ETHTOOL_A_TS_STAT_TX_LOST`` uint Tx HW timestamp not arrived count 1273 ``ETHTOOL_A_TS_STAT_TX_ERR`` uint HW error request Tx timestamp count 1274 ===================================== ====== =================================== 1275 1276CABLE_TEST 1277========== 1278 1279Start a cable test. 1280 1281Request contents: 1282 1283 ==================================== ====== ========================== 1284 ``ETHTOOL_A_CABLE_TEST_HEADER`` nested request header 1285 ==================================== ====== ========================== 1286 1287Notification contents: 1288 1289An Ethernet cable typically contains 1, 2 or 4 pairs. The length of 1290the pair can only be measured when there is a fault in the pair and 1291hence a reflection. Information about the fault may not be available, 1292depending on the specific hardware. Hence the contents of the notify 1293message are mostly optional. The attributes can be repeated an 1294arbitrary number of times, in an arbitrary order, for an arbitrary 1295number of pairs. 1296 1297The example shows the notification sent when the test is completed for 1298a T2 cable, i.e. two pairs. One pair is OK and hence has no length 1299information. The second pair has a fault and does have length 1300information. 1301 1302 +---------------------------------------------+--------+---------------------+ 1303 | ``ETHTOOL_A_CABLE_TEST_HEADER`` | nested | reply header | 1304 +---------------------------------------------+--------+---------------------+ 1305 | ``ETHTOOL_A_CABLE_TEST_STATUS`` | u8 | completed | 1306 +---------------------------------------------+--------+---------------------+ 1307 | ``ETHTOOL_A_CABLE_TEST_NTF_NEST`` | nested | all the results | 1308 +-+-------------------------------------------+--------+---------------------+ 1309 | | ``ETHTOOL_A_CABLE_NEST_RESULT`` | nested | cable test result | 1310 +-+-+-----------------------------------------+--------+---------------------+ 1311 | | | ``ETHTOOL_A_CABLE_RESULTS_PAIR`` | u8 | pair number | 1312 +-+-+-----------------------------------------+--------+---------------------+ 1313 | | | ``ETHTOOL_A_CABLE_RESULTS_CODE`` | u8 | result code | 1314 +-+-+-----------------------------------------+--------+---------------------+ 1315 | | ``ETHTOOL_A_CABLE_NEST_RESULT`` | nested | cable test results | 1316 +-+-+-----------------------------------------+--------+---------------------+ 1317 | | | ``ETHTOOL_A_CABLE_RESULTS_PAIR`` | u8 | pair number | 1318 +-+-+-----------------------------------------+--------+---------------------+ 1319 | | | ``ETHTOOL_A_CABLE_RESULTS_CODE`` | u8 | result code | 1320 +-+-+-----------------------------------------+--------+---------------------+ 1321 | | | ``ETHTOOL_A_CABLE_RESULT_SRC`` | u32 | information source | 1322 +-+-+-----------------------------------------+--------+---------------------+ 1323 | | ``ETHTOOL_A_CABLE_NEST_FAULT_LENGTH`` | nested | cable length | 1324 +-+-+-----------------------------------------+--------+---------------------+ 1325 | | | ``ETHTOOL_A_CABLE_FAULT_LENGTH_PAIR`` | u8 | pair number | 1326 +-+-+-----------------------------------------+--------+---------------------+ 1327 | | | ``ETHTOOL_A_CABLE_FAULT_LENGTH_CM`` | u32 | length in cm | 1328 +-+-+-----------------------------------------+--------+---------------------+ 1329 | | | ``ETHTOOL_A_CABLE_FAULT_LENGTH_SRC`` | u32 | information source | 1330 +-+-+-----------------------------------------+--------+---------------------+ 1331 1332 1333CABLE_TEST TDR 1334============== 1335 1336Start a cable test and report raw TDR data 1337 1338Request contents: 1339 1340 +--------------------------------------------+--------+-----------------------+ 1341 | ``ETHTOOL_A_CABLE_TEST_TDR_HEADER`` | nested | reply header | 1342 +--------------------------------------------+--------+-----------------------+ 1343 | ``ETHTOOL_A_CABLE_TEST_TDR_CFG`` | nested | test configuration | 1344 +-+------------------------------------------+--------+-----------------------+ 1345 | | ``ETHTOOL_A_CABLE_STEP_FIRST_DISTANCE`` | u32 | first data distance | 1346 +-+-+----------------------------------------+--------+-----------------------+ 1347 | | ``ETHTOOL_A_CABLE_STEP_LAST_DISTANCE`` | u32 | last data distance | 1348 +-+-+----------------------------------------+--------+-----------------------+ 1349 | | ``ETHTOOL_A_CABLE_STEP_STEP_DISTANCE`` | u32 | distance of each step | 1350 +-+-+----------------------------------------+--------+-----------------------+ 1351 | | ``ETHTOOL_A_CABLE_TEST_TDR_CFG_PAIR`` | u8 | pair to test | 1352 +-+-+----------------------------------------+--------+-----------------------+ 1353 1354The ETHTOOL_A_CABLE_TEST_TDR_CFG is optional, as well as all members 1355of the nest. All distances are expressed in centimeters. The PHY takes 1356the distances as a guide, and rounds to the nearest distance it 1357actually supports. If a pair is passed, only that one pair will be 1358tested. Otherwise all pairs are tested. 1359 1360Notification contents: 1361 1362Raw TDR data is gathered by sending a pulse down the cable and 1363recording the amplitude of the reflected pulse for a given distance. 1364 1365It can take a number of seconds to collect TDR data, especial if the 1366full 100 meters is probed at 1 meter intervals. When the test is 1367started a notification will be sent containing just 1368ETHTOOL_A_CABLE_TEST_TDR_STATUS with the value 1369ETHTOOL_A_CABLE_TEST_NTF_STATUS_STARTED. 1370 1371When the test has completed a second notification will be sent 1372containing ETHTOOL_A_CABLE_TEST_TDR_STATUS with the value 1373ETHTOOL_A_CABLE_TEST_NTF_STATUS_COMPLETED and the TDR data. 1374 1375The message may optionally contain the amplitude of the pulse send 1376down the cable. This is measured in mV. A reflection should not be 1377bigger than transmitted pulse. 1378 1379Before the raw TDR data should be an ETHTOOL_A_CABLE_TDR_NEST_STEP 1380nest containing information about the distance along the cable for the 1381first reading, the last reading, and the step between each 1382reading. Distances are measured in centimeters. These should be the 1383exact values the PHY used. These may be different to what the user 1384requested, if the native measurement resolution is greater than 1 cm. 1385 1386For each step along the cable, a ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE is 1387used to report the amplitude of the reflection for a given pair. 1388 1389 +---------------------------------------------+--------+----------------------+ 1390 | ``ETHTOOL_A_CABLE_TEST_TDR_HEADER`` | nested | reply header | 1391 +---------------------------------------------+--------+----------------------+ 1392 | ``ETHTOOL_A_CABLE_TEST_TDR_STATUS`` | u8 | completed | 1393 +---------------------------------------------+--------+----------------------+ 1394 | ``ETHTOOL_A_CABLE_TEST_TDR_NTF_NEST`` | nested | all the results | 1395 +-+-------------------------------------------+--------+----------------------+ 1396 | | ``ETHTOOL_A_CABLE_TDR_NEST_PULSE`` | nested | TX Pulse amplitude | 1397 +-+-+-----------------------------------------+--------+----------------------+ 1398 | | | ``ETHTOOL_A_CABLE_PULSE_mV`` | s16 | Pulse amplitude | 1399 +-+-+-----------------------------------------+--------+----------------------+ 1400 | | ``ETHTOOL_A_CABLE_NEST_STEP`` | nested | TDR step info | 1401 +-+-+-----------------------------------------+--------+----------------------+ 1402 | | | ``ETHTOOL_A_CABLE_STEP_FIRST_DISTANCE`` | u32 | First data distance | 1403 +-+-+-----------------------------------------+--------+----------------------+ 1404 | | | ``ETHTOOL_A_CABLE_STEP_LAST_DISTANCE`` | u32 | Last data distance | 1405 +-+-+-----------------------------------------+--------+----------------------+ 1406 | | | ``ETHTOOL_A_CABLE_STEP_STEP_DISTANCE`` | u32 | distance of each step| 1407 +-+-+-----------------------------------------+--------+----------------------+ 1408 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude | 1409 +-+-+-----------------------------------------+--------+----------------------+ 1410 | | | ``ETHTOOL_A_CABLE_RESULTS_PAIR`` | u8 | pair number | 1411 +-+-+-----------------------------------------+--------+----------------------+ 1412 | | | ``ETHTOOL_A_CABLE_AMPLITUDE_mV`` | s16 | Reflection amplitude | 1413 +-+-+-----------------------------------------+--------+----------------------+ 1414 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude | 1415 +-+-+-----------------------------------------+--------+----------------------+ 1416 | | | ``ETHTOOL_A_CABLE_RESULTS_PAIR`` | u8 | pair number | 1417 +-+-+-----------------------------------------+--------+----------------------+ 1418 | | | ``ETHTOOL_A_CABLE_AMPLITUDE_mV`` | s16 | Reflection amplitude | 1419 +-+-+-----------------------------------------+--------+----------------------+ 1420 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude | 1421 +-+-+-----------------------------------------+--------+----------------------+ 1422 | | | ``ETHTOOL_A_CABLE_RESULTS_PAIR`` | u8 | pair number | 1423 +-+-+-----------------------------------------+--------+----------------------+ 1424 | | | ``ETHTOOL_A_CABLE_AMPLITUDE_mV`` | s16 | Reflection amplitude | 1425 +-+-+-----------------------------------------+--------+----------------------+ 1426 1427TUNNEL_INFO 1428=========== 1429 1430Gets information about the tunnel state NIC is aware of. 1431 1432Request contents: 1433 1434 ===================================== ====== ========================== 1435 ``ETHTOOL_A_TUNNEL_INFO_HEADER`` nested request header 1436 ===================================== ====== ========================== 1437 1438Kernel response contents: 1439 1440 +---------------------------------------------+--------+---------------------+ 1441 | ``ETHTOOL_A_TUNNEL_INFO_HEADER`` | nested | reply header | 1442 +---------------------------------------------+--------+---------------------+ 1443 | ``ETHTOOL_A_TUNNEL_INFO_UDP_PORTS`` | nested | all UDP port tables | 1444 +-+-------------------------------------------+--------+---------------------+ 1445 | | ``ETHTOOL_A_TUNNEL_UDP_TABLE`` | nested | one UDP port table | 1446 +-+-+-----------------------------------------+--------+---------------------+ 1447 | | | ``ETHTOOL_A_TUNNEL_UDP_TABLE_SIZE`` | u32 | max size of the | 1448 | | | | | table | 1449 +-+-+-----------------------------------------+--------+---------------------+ 1450 | | | ``ETHTOOL_A_TUNNEL_UDP_TABLE_TYPES`` | bitset | tunnel types which | 1451 | | | | | table can hold | 1452 +-+-+-----------------------------------------+--------+---------------------+ 1453 | | | ``ETHTOOL_A_TUNNEL_UDP_TABLE_ENTRY`` | nested | offloaded UDP port | 1454 +-+-+-+---------------------------------------+--------+---------------------+ 1455 | | | | ``ETHTOOL_A_TUNNEL_UDP_ENTRY_PORT`` | be16 | UDP port | 1456 +-+-+-+---------------------------------------+--------+---------------------+ 1457 | | | | ``ETHTOOL_A_TUNNEL_UDP_ENTRY_TYPE`` | u32 | tunnel type | 1458 +-+-+-+---------------------------------------+--------+---------------------+ 1459 1460For UDP tunnel table empty ``ETHTOOL_A_TUNNEL_UDP_TABLE_TYPES`` indicates that 1461the table contains static entries, hard-coded by the NIC. 1462 1463FEC_GET 1464======= 1465 1466Gets FEC configuration and state like ``ETHTOOL_GFECPARAM`` ioctl request. 1467 1468Request contents: 1469 1470 ===================================== ====== ========================== 1471 ``ETHTOOL_A_FEC_HEADER`` nested request header 1472 ===================================== ====== ========================== 1473 1474Kernel response contents: 1475 1476 ===================================== ====== ========================== 1477 ``ETHTOOL_A_FEC_HEADER`` nested request header 1478 ``ETHTOOL_A_FEC_MODES`` bitset configured modes 1479 ``ETHTOOL_A_FEC_AUTO`` bool FEC mode auto selection 1480 ``ETHTOOL_A_FEC_ACTIVE`` u32 index of active FEC mode 1481 ``ETHTOOL_A_FEC_STATS`` nested FEC statistics 1482 ===================================== ====== ========================== 1483 1484``ETHTOOL_A_FEC_ACTIVE`` is the bit index of the FEC link mode currently 1485active on the interface. This attribute may not be present if device does 1486not support FEC. 1487 1488``ETHTOOL_A_FEC_MODES`` and ``ETHTOOL_A_FEC_AUTO`` are only meaningful when 1489autonegotiation is disabled. If ``ETHTOOL_A_FEC_AUTO`` is non-zero driver will 1490select the FEC mode automatically based on the parameters of the SFP module. 1491This is equivalent to the ``ETHTOOL_FEC_AUTO`` bit of the ioctl interface. 1492``ETHTOOL_A_FEC_MODES`` carry the current FEC configuration using link mode 1493bits (rather than old ``ETHTOOL_FEC_*`` bits). 1494 1495``ETHTOOL_A_FEC_STATS`` are reported if ``ETHTOOL_FLAG_STATS`` was set in 1496``ETHTOOL_A_HEADER_FLAGS``. 1497Each attribute carries an array of 64bit statistics. First entry in the array 1498contains the total number of events on the port, while the following entries 1499are counters corresponding to lanes/PCS instances. The number of entries in 1500the array will be: 1501 1502+--------------+---------------------------------------------+ 1503| `0` | device does not support FEC statistics | 1504+--------------+---------------------------------------------+ 1505| `1` | device does not support per-lane break down | 1506+--------------+---------------------------------------------+ 1507| `1 + #lanes` | device has full support for FEC stats | 1508+--------------+---------------------------------------------+ 1509 1510Drivers fill in the statistics in the following structure: 1511 1512.. kernel-doc:: include/linux/ethtool.h 1513 :identifiers: ethtool_fec_stats 1514 1515FEC_SET 1516======= 1517 1518Sets FEC parameters like ``ETHTOOL_SFECPARAM`` ioctl request. 1519 1520Request contents: 1521 1522 ===================================== ====== ========================== 1523 ``ETHTOOL_A_FEC_HEADER`` nested request header 1524 ``ETHTOOL_A_FEC_MODES`` bitset configured modes 1525 ``ETHTOOL_A_FEC_AUTO`` bool FEC mode auto selection 1526 ===================================== ====== ========================== 1527 1528``FEC_SET`` is only meaningful when autonegotiation is disabled. Otherwise 1529FEC mode is selected as part of autonegotiation. 1530 1531``ETHTOOL_A_FEC_MODES`` selects which FEC mode should be used. It's recommended 1532to set only one bit, if multiple bits are set driver may choose between them 1533in an implementation specific way. 1534 1535``ETHTOOL_A_FEC_AUTO`` requests the driver to choose FEC mode based on SFP 1536module parameters. This does not mean autonegotiation. 1537 1538MODULE_EEPROM_GET 1539================= 1540 1541Fetch module EEPROM data dump. 1542This interface is designed to allow dumps of at most 1/2 page at once. This 1543means only dumps of 128 (or less) bytes are allowed, without crossing half page 1544boundary located at offset 128. For pages other than 0 only high 128 bytes are 1545accessible. 1546 1547Request contents: 1548 1549 ======================================= ====== ========================== 1550 ``ETHTOOL_A_MODULE_EEPROM_HEADER`` nested request header 1551 ``ETHTOOL_A_MODULE_EEPROM_OFFSET`` u32 offset within a page 1552 ``ETHTOOL_A_MODULE_EEPROM_LENGTH`` u32 amount of bytes to read 1553 ``ETHTOOL_A_MODULE_EEPROM_PAGE`` u8 page number 1554 ``ETHTOOL_A_MODULE_EEPROM_BANK`` u8 bank number 1555 ``ETHTOOL_A_MODULE_EEPROM_I2C_ADDRESS`` u8 page I2C address 1556 ======================================= ====== ========================== 1557 1558If ``ETHTOOL_A_MODULE_EEPROM_BANK`` is not specified, bank 0 is assumed. 1559 1560Kernel response contents: 1561 1562 +---------------------------------------------+--------+---------------------+ 1563 | ``ETHTOOL_A_MODULE_EEPROM_HEADER`` | nested | reply header | 1564 +---------------------------------------------+--------+---------------------+ 1565 | ``ETHTOOL_A_MODULE_EEPROM_DATA`` | binary | array of bytes from | 1566 | | | module EEPROM | 1567 +---------------------------------------------+--------+---------------------+ 1568 1569``ETHTOOL_A_MODULE_EEPROM_DATA`` has an attribute length equal to the amount of 1570bytes driver actually read. 1571 1572STATS_GET 1573========= 1574 1575Get standard statistics for the interface. Note that this is not 1576a re-implementation of ``ETHTOOL_GSTATS`` which exposed driver-defined 1577stats. 1578 1579Request contents: 1580 1581 ======================================= ====== ========================== 1582 ``ETHTOOL_A_STATS_HEADER`` nested request header 1583 ``ETHTOOL_A_STATS_SRC`` u32 source of statistics 1584 ``ETHTOOL_A_STATS_GROUPS`` bitset requested groups of stats 1585 ======================================= ====== ========================== 1586 1587Kernel response contents: 1588 1589 +-----------------------------------+--------+--------------------------------+ 1590 | ``ETHTOOL_A_STATS_HEADER`` | nested | reply header | 1591 +-----------------------------------+--------+--------------------------------+ 1592 | ``ETHTOOL_A_STATS_SRC`` | u32 | source of statistics | 1593 +-----------------------------------+--------+--------------------------------+ 1594 | ``ETHTOOL_A_STATS_GRP`` | nested | one or more group of stats | 1595 +-+---------------------------------+--------+--------------------------------+ 1596 | | ``ETHTOOL_A_STATS_GRP_ID`` | u32 | group ID - ``ETHTOOL_STATS_*`` | 1597 +-+---------------------------------+--------+--------------------------------+ 1598 | | ``ETHTOOL_A_STATS_GRP_SS_ID`` | u32 | string set ID for names | 1599 +-+---------------------------------+--------+--------------------------------+ 1600 | | ``ETHTOOL_A_STATS_GRP_STAT`` | nested | nest containing a statistic | 1601 +-+---------------------------------+--------+--------------------------------+ 1602 | | ``ETHTOOL_A_STATS_GRP_HIST_RX`` | nested | histogram statistic (Rx) | 1603 +-+---------------------------------+--------+--------------------------------+ 1604 | | ``ETHTOOL_A_STATS_GRP_HIST_TX`` | nested | histogram statistic (Tx) | 1605 +-+---------------------------------+--------+--------------------------------+ 1606 1607Users specify which groups of statistics they are requesting via 1608the ``ETHTOOL_A_STATS_GROUPS`` bitset. Currently defined values are: 1609 1610 ====================== ======== =============================================== 1611 ETHTOOL_STATS_ETH_MAC eth-mac Basic IEEE 802.3 MAC statistics (30.3.1.1.*) 1612 ETHTOOL_STATS_ETH_PHY eth-phy Basic IEEE 802.3 PHY statistics (30.3.2.1.*) 1613 ETHTOOL_STATS_ETH_CTRL eth-ctrl Basic IEEE 802.3 MAC Ctrl statistics (30.3.3.*) 1614 ETHTOOL_STATS_RMON rmon RMON (RFC 2819) statistics 1615 ====================== ======== =============================================== 1616 1617Each group should have a corresponding ``ETHTOOL_A_STATS_GRP`` in the reply. 1618``ETHTOOL_A_STATS_GRP_ID`` identifies which group's statistics nest contains. 1619``ETHTOOL_A_STATS_GRP_SS_ID`` identifies the string set ID for the names of 1620the statistics in the group, if available. 1621 1622Statistics are added to the ``ETHTOOL_A_STATS_GRP`` nest under 1623``ETHTOOL_A_STATS_GRP_STAT``. ``ETHTOOL_A_STATS_GRP_STAT`` should contain 1624single 8 byte (u64) attribute inside - the type of that attribute is 1625the statistic ID and the value is the value of the statistic. 1626Each group has its own interpretation of statistic IDs. 1627Attribute IDs correspond to strings from the string set identified 1628by ``ETHTOOL_A_STATS_GRP_SS_ID``. Complex statistics (such as RMON histogram 1629entries) are also listed inside ``ETHTOOL_A_STATS_GRP`` and do not have 1630a string defined in the string set. 1631 1632RMON "histogram" counters count number of packets within given size range. 1633Because RFC does not specify the ranges beyond the standard 1518 MTU devices 1634differ in definition of buckets. For this reason the definition of packet ranges 1635is left to each driver. 1636 1637``ETHTOOL_A_STATS_GRP_HIST_RX`` and ``ETHTOOL_A_STATS_GRP_HIST_TX`` nests 1638contain the following attributes: 1639 1640 ================================= ====== =================================== 1641 ETHTOOL_A_STATS_RMON_HIST_BKT_LOW u32 low bound of the packet size bucket 1642 ETHTOOL_A_STATS_RMON_HIST_BKT_HI u32 high bound of the bucket 1643 ETHTOOL_A_STATS_RMON_HIST_VAL u64 packet counter 1644 ================================= ====== =================================== 1645 1646Low and high bounds are inclusive, for example: 1647 1648 ============================= ==== ==== 1649 RFC statistic low high 1650 ============================= ==== ==== 1651 etherStatsPkts64Octets 0 64 1652 etherStatsPkts512to1023Octets 512 1023 1653 ============================= ==== ==== 1654 1655``ETHTOOL_A_STATS_SRC`` is optional. Similar to ``PAUSE_GET``, it takes values 1656from ``enum ethtool_mac_stats_src``. If absent from the request, stats will be 1657provided with an ``ETHTOOL_A_STATS_SRC`` attribute in the response equal to 1658``ETHTOOL_MAC_STATS_SRC_AGGREGATE``. 1659 1660PHC_VCLOCKS_GET 1661=============== 1662 1663Query device PHC virtual clocks information. 1664 1665Request contents: 1666 1667 ==================================== ====== ========================== 1668 ``ETHTOOL_A_PHC_VCLOCKS_HEADER`` nested request header 1669 ==================================== ====== ========================== 1670 1671Kernel response contents: 1672 1673 ==================================== ====== ========================== 1674 ``ETHTOOL_A_PHC_VCLOCKS_HEADER`` nested reply header 1675 ``ETHTOOL_A_PHC_VCLOCKS_NUM`` u32 PHC virtual clocks number 1676 ``ETHTOOL_A_PHC_VCLOCKS_INDEX`` s32 PHC index array 1677 ==================================== ====== ========================== 1678 1679MODULE_GET 1680========== 1681 1682Gets transceiver module parameters. 1683 1684Request contents: 1685 1686 ===================================== ====== ========================== 1687 ``ETHTOOL_A_MODULE_HEADER`` nested request header 1688 ===================================== ====== ========================== 1689 1690Kernel response contents: 1691 1692 ====================================== ====== ========================== 1693 ``ETHTOOL_A_MODULE_HEADER`` nested reply header 1694 ``ETHTOOL_A_MODULE_POWER_MODE_POLICY`` u8 power mode policy 1695 ``ETHTOOL_A_MODULE_POWER_MODE`` u8 operational power mode 1696 ====================================== ====== ========================== 1697 1698The optional ``ETHTOOL_A_MODULE_POWER_MODE_POLICY`` attribute encodes the 1699transceiver module power mode policy enforced by the host. The default policy 1700is driver-dependent, but "auto" is the recommended default and it should be 1701implemented by new drivers and drivers where conformance to a legacy behavior 1702is not critical. 1703 1704The optional ``ETHTHOOL_A_MODULE_POWER_MODE`` attribute encodes the operational 1705power mode policy of the transceiver module. It is only reported when a module 1706is plugged-in. Possible values are: 1707 1708.. kernel-doc:: include/uapi/linux/ethtool.h 1709 :identifiers: ethtool_module_power_mode 1710 1711MODULE_SET 1712========== 1713 1714Sets transceiver module parameters. 1715 1716Request contents: 1717 1718 ====================================== ====== ========================== 1719 ``ETHTOOL_A_MODULE_HEADER`` nested request header 1720 ``ETHTOOL_A_MODULE_POWER_MODE_POLICY`` u8 power mode policy 1721 ====================================== ====== ========================== 1722 1723When set, the optional ``ETHTOOL_A_MODULE_POWER_MODE_POLICY`` attribute is used 1724to set the transceiver module power policy enforced by the host. Possible 1725values are: 1726 1727.. kernel-doc:: include/uapi/linux/ethtool.h 1728 :identifiers: ethtool_module_power_mode_policy 1729 1730For SFF-8636 modules, low power mode is forced by the host according to table 17316-10 in revision 2.10a of the specification. 1732 1733For CMIS modules, low power mode is forced by the host according to table 6-12 1734in revision 5.0 of the specification. 1735 1736PSE_GET 1737======= 1738 1739Gets PSE attributes. 1740 1741Request contents: 1742 1743 ===================================== ====== ========================== 1744 ``ETHTOOL_A_PSE_HEADER`` nested request header 1745 ===================================== ====== ========================== 1746 1747Kernel response contents: 1748 1749 ========================================== ====== ============================= 1750 ``ETHTOOL_A_PSE_HEADER`` nested reply header 1751 ``ETHTOOL_A_PODL_PSE_ADMIN_STATE`` u32 Operational state of the PoDL 1752 PSE functions 1753 ``ETHTOOL_A_PODL_PSE_PW_D_STATUS`` u32 power detection status of the 1754 PoDL PSE. 1755 ``ETHTOOL_A_C33_PSE_ADMIN_STATE`` u32 Operational state of the PoE 1756 PSE functions. 1757 ``ETHTOOL_A_C33_PSE_PW_D_STATUS`` u32 power detection status of the 1758 PoE PSE. 1759 ``ETHTOOL_A_C33_PSE_PW_CLASS`` u32 power class of the PoE PSE. 1760 ``ETHTOOL_A_C33_PSE_ACTUAL_PW`` u32 actual power drawn on the 1761 PoE PSE. 1762 ``ETHTOOL_A_C33_PSE_EXT_STATE`` u32 power extended state of the 1763 PoE PSE. 1764 ``ETHTOOL_A_C33_PSE_EXT_SUBSTATE`` u32 power extended substatus of 1765 the PoE PSE. 1766 ``ETHTOOL_A_C33_PSE_AVAIL_PW_LIMIT`` u32 currently configured power 1767 limit of the PoE PSE. 1768 ``ETHTOOL_A_C33_PSE_PW_LIMIT_RANGES`` nested Supported power limit 1769 configuration ranges. 1770 ========================================== ====== ============================= 1771 1772When set, the optional ``ETHTOOL_A_PODL_PSE_ADMIN_STATE`` attribute identifies 1773the operational state of the PoDL PSE functions. The operational state of the 1774PSE function can be changed using the ``ETHTOOL_A_PODL_PSE_ADMIN_CONTROL`` 1775action. This attribute corresponds to ``IEEE 802.3-2018`` 30.15.1.1.2 1776aPoDLPSEAdminState. Possible values are: 1777 1778.. kernel-doc:: include/uapi/linux/ethtool.h 1779 :identifiers: ethtool_podl_pse_admin_state 1780 1781The same goes for ``ETHTOOL_A_C33_PSE_ADMIN_STATE`` implementing 1782``IEEE 802.3-2022`` 30.9.1.1.2 aPSEAdminState. 1783 1784.. kernel-doc:: include/uapi/linux/ethtool.h 1785 :identifiers: ethtool_c33_pse_admin_state 1786 1787When set, the optional ``ETHTOOL_A_PODL_PSE_PW_D_STATUS`` attribute identifies 1788the power detection status of the PoDL PSE. The status depend on internal PSE 1789state machine and automatic PD classification support. This attribute 1790corresponds to ``IEEE 802.3-2018`` 30.15.1.1.3 aPoDLPSEPowerDetectionStatus. 1791Possible values are: 1792 1793.. kernel-doc:: include/uapi/linux/ethtool.h 1794 :identifiers: ethtool_podl_pse_pw_d_status 1795 1796The same goes for ``ETHTOOL_A_C33_PSE_ADMIN_PW_D_STATUS`` implementing 1797``IEEE 802.3-2022`` 30.9.1.1.5 aPSEPowerDetectionStatus. 1798 1799.. kernel-doc:: include/uapi/linux/ethtool.h 1800 :identifiers: ethtool_c33_pse_pw_d_status 1801 1802When set, the optional ``ETHTOOL_A_C33_PSE_PW_CLASS`` attribute identifies 1803the power class of the C33 PSE. It depends on the class negotiated between 1804the PSE and the PD. This attribute corresponds to ``IEEE 802.3-2022`` 180530.9.1.1.8 aPSEPowerClassification. 1806 1807When set, the optional ``ETHTOOL_A_C33_PSE_ACTUAL_PW`` attribute identifies 1808the actual power drawn by the C33 PSE. This attribute corresponds to 1809``IEEE 802.3-2022`` 30.9.1.1.23 aPSEActualPower. Actual power is reported 1810in mW. 1811 1812When set, the optional ``ETHTOOL_A_C33_PSE_EXT_STATE`` attribute identifies 1813the extended error state of the C33 PSE. Possible values are: 1814 1815.. kernel-doc:: include/uapi/linux/ethtool.h 1816 :identifiers: ethtool_c33_pse_ext_state 1817 1818When set, the optional ``ETHTOOL_A_C33_PSE_EXT_SUBSTATE`` attribute identifies 1819the extended error state of the C33 PSE. Possible values are: 1820Possible values are: 1821 1822.. kernel-doc:: include/uapi/linux/ethtool.h 1823 :identifiers: ethtool_c33_pse_ext_substate_class_num_events 1824 ethtool_c33_pse_ext_substate_error_condition 1825 ethtool_c33_pse_ext_substate_mr_pse_enable 1826 ethtool_c33_pse_ext_substate_option_detect_ted 1827 ethtool_c33_pse_ext_substate_option_vport_lim 1828 ethtool_c33_pse_ext_substate_ovld_detected 1829 ethtool_c33_pse_ext_substate_pd_dll_power_type 1830 ethtool_c33_pse_ext_substate_power_not_available 1831 ethtool_c33_pse_ext_substate_short_detected 1832 1833When set, the optional ``ETHTOOL_A_C33_PSE_AVAIL_PW_LIMIT`` attribute 1834identifies the C33 PSE power limit in mW. 1835 1836When set the optional ``ETHTOOL_A_C33_PSE_PW_LIMIT_RANGES`` nested attribute 1837identifies the C33 PSE power limit ranges through 1838``ETHTOOL_A_C33_PSE_PWR_VAL_LIMIT_RANGE_MIN`` and 1839``ETHTOOL_A_C33_PSE_PWR_VAL_LIMIT_RANGE_MAX``. 1840If the controller works with fixed classes, the min and max values will be 1841equal. 1842 1843PSE_SET 1844======= 1845 1846Sets PSE parameters. 1847 1848Request contents: 1849 1850 ====================================== ====== ============================= 1851 ``ETHTOOL_A_PSE_HEADER`` nested request header 1852 ``ETHTOOL_A_PODL_PSE_ADMIN_CONTROL`` u32 Control PoDL PSE Admin state 1853 ``ETHTOOL_A_C33_PSE_ADMIN_CONTROL`` u32 Control PSE Admin state 1854 ``ETHTOOL_A_C33_PSE_AVAIL_PWR_LIMIT`` u32 Control PoE PSE available 1855 power limit 1856 ====================================== ====== ============================= 1857 1858When set, the optional ``ETHTOOL_A_PODL_PSE_ADMIN_CONTROL`` attribute is used 1859to control PoDL PSE Admin functions. This option implements 1860``IEEE 802.3-2018`` 30.15.1.2.1 acPoDLPSEAdminControl. See 1861``ETHTOOL_A_PODL_PSE_ADMIN_STATE`` for supported values. 1862 1863The same goes for ``ETHTOOL_A_C33_PSE_ADMIN_CONTROL`` implementing 1864``IEEE 802.3-2022`` 30.9.1.2.1 acPSEAdminControl. 1865 1866When set, the optional ``ETHTOOL_A_C33_PSE_AVAIL_PWR_LIMIT`` attribute is 1867used to control the available power value limit for C33 PSE in milliwatts. 1868This attribute corresponds to the `pse_available_power` variable described in 1869``IEEE 802.3-2022`` 33.2.4.4 Variables and `pse_avail_pwr` in 145.2.5.4 1870Variables, which are described in power classes. 1871 1872It was decided to use milliwatts for this interface to unify it with other 1873power monitoring interfaces, which also use milliwatts, and to align with 1874various existing products that document power consumption in watts rather than 1875classes. If power limit configuration based on classes is needed, the 1876conversion can be done in user space, for example by ethtool. 1877 1878RSS_GET 1879======= 1880 1881Get indirection table, hash key and hash function info associated with a 1882RSS context of an interface similar to ``ETHTOOL_GRSSH`` ioctl request. 1883 1884Request contents: 1885 1886===================================== ====== ============================ 1887 ``ETHTOOL_A_RSS_HEADER`` nested request header 1888 ``ETHTOOL_A_RSS_CONTEXT`` u32 context number 1889 ``ETHTOOL_A_RSS_START_CONTEXT`` u32 start context number (dumps) 1890===================================== ====== ============================ 1891 1892``ETHTOOL_A_RSS_CONTEXT`` specifies which RSS context number to query, 1893if not set context 0 (the main context) is queried. Dumps can be filtered 1894by device (only listing contexts of a given netdev). Filtering single 1895context number is not supported but ``ETHTOOL_A_RSS_START_CONTEXT`` 1896can be used to start dumping context from the given number (primarily 1897used to ignore context 0s and only dump additional contexts). 1898 1899Kernel response contents: 1900 1901===================================== ====== ========================== 1902 ``ETHTOOL_A_RSS_HEADER`` nested reply header 1903 ``ETHTOOL_A_RSS_CONTEXT`` u32 context number 1904 ``ETHTOOL_A_RSS_HFUNC`` u32 RSS hash func 1905 ``ETHTOOL_A_RSS_INDIR`` binary Indir table bytes 1906 ``ETHTOOL_A_RSS_HKEY`` binary Hash key bytes 1907 ``ETHTOOL_A_RSS_INPUT_XFRM`` u32 RSS input data transformation 1908===================================== ====== ========================== 1909 1910ETHTOOL_A_RSS_HFUNC attribute is bitmap indicating the hash function 1911being used. Current supported options are toeplitz, xor or crc32. 1912ETHTOOL_A_RSS_INDIR attribute returns RSS indirection table where each byte 1913indicates queue number. 1914ETHTOOL_A_RSS_INPUT_XFRM attribute is a bitmap indicating the type of 1915transformation applied to the input protocol fields before given to the RSS 1916hfunc. Current supported option is symmetric-xor. 1917 1918PLCA_GET_CFG 1919============ 1920 1921Gets the IEEE 802.3cg-2019 Clause 148 Physical Layer Collision Avoidance 1922(PLCA) Reconciliation Sublayer (RS) attributes. 1923 1924Request contents: 1925 1926 ===================================== ====== ========================== 1927 ``ETHTOOL_A_PLCA_HEADER`` nested request header 1928 ===================================== ====== ========================== 1929 1930Kernel response contents: 1931 1932 ====================================== ====== ============================= 1933 ``ETHTOOL_A_PLCA_HEADER`` nested reply header 1934 ``ETHTOOL_A_PLCA_VERSION`` u16 Supported PLCA management 1935 interface standard/version 1936 ``ETHTOOL_A_PLCA_ENABLED`` u8 PLCA Admin State 1937 ``ETHTOOL_A_PLCA_NODE_ID`` u32 PLCA unique local node ID 1938 ``ETHTOOL_A_PLCA_NODE_CNT`` u32 Number of PLCA nodes on the 1939 network, including the 1940 coordinator 1941 ``ETHTOOL_A_PLCA_TO_TMR`` u32 Transmit Opportunity Timer 1942 value in bit-times (BT) 1943 ``ETHTOOL_A_PLCA_BURST_CNT`` u32 Number of additional packets 1944 the node is allowed to send 1945 within a single TO 1946 ``ETHTOOL_A_PLCA_BURST_TMR`` u32 Time to wait for the MAC to 1947 transmit a new frame before 1948 terminating the burst 1949 ====================================== ====== ============================= 1950 1951When set, the optional ``ETHTOOL_A_PLCA_VERSION`` attribute indicates which 1952standard and version the PLCA management interface complies to. When not set, 1953the interface is vendor-specific and (possibly) supplied by the driver. 1954The OPEN Alliance SIG specifies a standard register map for 10BASE-T1S PHYs 1955embedding the PLCA Reconciliation Sublayer. See "10BASE-T1S PLCA Management 1956Registers" at https://www.opensig.org/about/specifications/. 1957 1958When set, the optional ``ETHTOOL_A_PLCA_ENABLED`` attribute indicates the 1959administrative state of the PLCA RS. When not set, the node operates in "plain" 1960CSMA/CD mode. This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.1 1961aPLCAAdminState / 30.16.1.2.1 acPLCAAdminControl. 1962 1963When set, the optional ``ETHTOOL_A_PLCA_NODE_ID`` attribute indicates the 1964configured local node ID of the PHY. This ID determines which transmit 1965opportunity (TO) is reserved for the node to transmit into. This option is 1966corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.4 aPLCALocalNodeID. The valid 1967range for this attribute is [0 .. 255] where 255 means "not configured". 1968 1969When set, the optional ``ETHTOOL_A_PLCA_NODE_CNT`` attribute indicates the 1970configured maximum number of PLCA nodes on the mixing-segment. This number 1971determines the total number of transmit opportunities generated during a 1972PLCA cycle. This attribute is relevant only for the PLCA coordinator, which is 1973the node with aPLCALocalNodeID set to 0. Follower nodes ignore this setting. 1974This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.3 1975aPLCANodeCount. The valid range for this attribute is [1 .. 255]. 1976 1977When set, the optional ``ETHTOOL_A_PLCA_TO_TMR`` attribute indicates the 1978configured value of the transmit opportunity timer in bit-times. This value 1979must be set equal across all nodes sharing the medium for PLCA to work 1980correctly. This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.5 1981aPLCATransmitOpportunityTimer. The valid range for this attribute is 1982[0 .. 255]. 1983 1984When set, the optional ``ETHTOOL_A_PLCA_BURST_CNT`` attribute indicates the 1985configured number of extra packets that the node is allowed to send during a 1986single transmit opportunity. By default, this attribute is 0, meaning that 1987the node can only send a single frame per TO. When greater than 0, the PLCA RS 1988keeps the TO after any transmission, waiting for the MAC to send a new frame 1989for up to aPLCABurstTimer BTs. This can only happen a number of times per PLCA 1990cycle up to the value of this parameter. After that, the burst is over and the 1991normal counting of TOs resumes. This option is corresponding to 1992``IEEE 802.3cg-2019`` 30.16.1.1.6 aPLCAMaxBurstCount. The valid range for this 1993attribute is [0 .. 255]. 1994 1995When set, the optional ``ETHTOOL_A_PLCA_BURST_TMR`` attribute indicates how 1996many bit-times the PLCA RS waits for the MAC to initiate a new transmission 1997when aPLCAMaxBurstCount is greater than 0. If the MAC fails to send a new 1998frame within this time, the burst ends and the counting of TOs resumes. 1999Otherwise, the new frame is sent as part of the current burst. This option 2000is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.7 aPLCABurstTimer. The 2001valid range for this attribute is [0 .. 255]. Although, the value should be 2002set greater than the Inter-Frame-Gap (IFG) time of the MAC (plus some margin) 2003for PLCA burst mode to work as intended. 2004 2005PLCA_SET_CFG 2006============ 2007 2008Sets PLCA RS parameters. 2009 2010Request contents: 2011 2012 ====================================== ====== ============================= 2013 ``ETHTOOL_A_PLCA_HEADER`` nested request header 2014 ``ETHTOOL_A_PLCA_ENABLED`` u8 PLCA Admin State 2015 ``ETHTOOL_A_PLCA_NODE_ID`` u8 PLCA unique local node ID 2016 ``ETHTOOL_A_PLCA_NODE_CNT`` u8 Number of PLCA nodes on the 2017 network, including the 2018 coordinator 2019 ``ETHTOOL_A_PLCA_TO_TMR`` u8 Transmit Opportunity Timer 2020 value in bit-times (BT) 2021 ``ETHTOOL_A_PLCA_BURST_CNT`` u8 Number of additional packets 2022 the node is allowed to send 2023 within a single TO 2024 ``ETHTOOL_A_PLCA_BURST_TMR`` u8 Time to wait for the MAC to 2025 transmit a new frame before 2026 terminating the burst 2027 ====================================== ====== ============================= 2028 2029For a description of each attribute, see ``PLCA_GET_CFG``. 2030 2031PLCA_GET_STATUS 2032=============== 2033 2034Gets PLCA RS status information. 2035 2036Request contents: 2037 2038 ===================================== ====== ========================== 2039 ``ETHTOOL_A_PLCA_HEADER`` nested request header 2040 ===================================== ====== ========================== 2041 2042Kernel response contents: 2043 2044 ====================================== ====== ============================= 2045 ``ETHTOOL_A_PLCA_HEADER`` nested reply header 2046 ``ETHTOOL_A_PLCA_STATUS`` u8 PLCA RS operational status 2047 ====================================== ====== ============================= 2048 2049When set, the ``ETHTOOL_A_PLCA_STATUS`` attribute indicates whether the node is 2050detecting the presence of the BEACON on the network. This flag is 2051corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.2 aPLCAStatus. 2052 2053MM_GET 2054====== 2055 2056Retrieve 802.3 MAC Merge parameters. 2057 2058Request contents: 2059 2060 ==================================== ====== ========================== 2061 ``ETHTOOL_A_MM_HEADER`` nested request header 2062 ==================================== ====== ========================== 2063 2064Kernel response contents: 2065 2066 ================================= ====== =================================== 2067 ``ETHTOOL_A_MM_HEADER`` nested request header 2068 ``ETHTOOL_A_MM_PMAC_ENABLED`` bool set if RX of preemptible and SMD-V 2069 frames is enabled 2070 ``ETHTOOL_A_MM_TX_ENABLED`` bool set if TX of preemptible frames is 2071 administratively enabled (might be 2072 inactive if verification failed) 2073 ``ETHTOOL_A_MM_TX_ACTIVE`` bool set if TX of preemptible frames is 2074 operationally enabled 2075 ``ETHTOOL_A_MM_TX_MIN_FRAG_SIZE`` u32 minimum size of transmitted 2076 non-final fragments, in octets 2077 ``ETHTOOL_A_MM_RX_MIN_FRAG_SIZE`` u32 minimum size of received non-final 2078 fragments, in octets 2079 ``ETHTOOL_A_MM_VERIFY_ENABLED`` bool set if TX of SMD-V frames is 2080 administratively enabled 2081 ``ETHTOOL_A_MM_VERIFY_STATUS`` u8 state of the verification function 2082 ``ETHTOOL_A_MM_VERIFY_TIME`` u32 delay between verification attempts 2083 ``ETHTOOL_A_MM_MAX_VERIFY_TIME``` u32 maximum verification interval 2084 supported by device 2085 ``ETHTOOL_A_MM_STATS`` nested IEEE 802.3-2018 subclause 30.14.1 2086 oMACMergeEntity statistics counters 2087 ================================= ====== =================================== 2088 2089The attributes are populated by the device driver through the following 2090structure: 2091 2092.. kernel-doc:: include/linux/ethtool.h 2093 :identifiers: ethtool_mm_state 2094 2095The ``ETHTOOL_A_MM_VERIFY_STATUS`` will report one of the values from 2096 2097.. kernel-doc:: include/uapi/linux/ethtool.h 2098 :identifiers: ethtool_mm_verify_status 2099 2100If ``ETHTOOL_A_MM_VERIFY_ENABLED`` was passed as false in the ``MM_SET`` 2101command, ``ETHTOOL_A_MM_VERIFY_STATUS`` will report either 2102``ETHTOOL_MM_VERIFY_STATUS_INITIAL`` or ``ETHTOOL_MM_VERIFY_STATUS_DISABLED``, 2103otherwise it should report one of the other states. 2104 2105It is recommended that drivers start with the pMAC disabled, and enable it upon 2106user space request. It is also recommended that user space does not depend upon 2107the default values from ``ETHTOOL_MSG_MM_GET`` requests. 2108 2109``ETHTOOL_A_MM_STATS`` are reported if ``ETHTOOL_FLAG_STATS`` was set in 2110``ETHTOOL_A_HEADER_FLAGS``. The attribute will be empty if driver did not 2111report any statistics. Drivers fill in the statistics in the following 2112structure: 2113 2114.. kernel-doc:: include/linux/ethtool.h 2115 :identifiers: ethtool_mm_stats 2116 2117MM_SET 2118====== 2119 2120Modifies the configuration of the 802.3 MAC Merge layer. 2121 2122Request contents: 2123 2124 ================================= ====== ========================== 2125 ``ETHTOOL_A_MM_VERIFY_TIME`` u32 see MM_GET description 2126 ``ETHTOOL_A_MM_VERIFY_ENABLED`` bool see MM_GET description 2127 ``ETHTOOL_A_MM_TX_ENABLED`` bool see MM_GET description 2128 ``ETHTOOL_A_MM_PMAC_ENABLED`` bool see MM_GET description 2129 ``ETHTOOL_A_MM_TX_MIN_FRAG_SIZE`` u32 see MM_GET description 2130 ================================= ====== ========================== 2131 2132The attributes are propagated to the driver through the following structure: 2133 2134.. kernel-doc:: include/linux/ethtool.h 2135 :identifiers: ethtool_mm_cfg 2136 2137MODULE_FW_FLASH_ACT 2138=================== 2139 2140Flashes transceiver module firmware. 2141 2142Request contents: 2143 2144 ======================================= ====== =========================== 2145 ``ETHTOOL_A_MODULE_FW_FLASH_HEADER`` nested request header 2146 ``ETHTOOL_A_MODULE_FW_FLASH_FILE_NAME`` string firmware image file name 2147 ``ETHTOOL_A_MODULE_FW_FLASH_PASSWORD`` u32 transceiver module password 2148 ======================================= ====== =========================== 2149 2150The firmware update process consists of three logical steps: 2151 21521. Downloading a firmware image to the transceiver module and validating it. 21532. Running the firmware image. 21543. Committing the firmware image so that it is run upon reset. 2155 2156When flash command is given, those three steps are taken in that order. 2157 2158This message merely schedules the update process and returns immediately 2159without blocking. The process then runs asynchronously. 2160Since it can take several minutes to complete, during the update process 2161notifications are emitted from the kernel to user space updating it about 2162the status and progress. 2163 2164The ``ETHTOOL_A_MODULE_FW_FLASH_FILE_NAME`` attribute encodes the firmware 2165image file name. The firmware image is downloaded to the transceiver module, 2166validated, run and committed. 2167 2168The optional ``ETHTOOL_A_MODULE_FW_FLASH_PASSWORD`` attribute encodes a password 2169that might be required as part of the transceiver module firmware update 2170process. 2171 2172The firmware update process can take several minutes to complete. Therefore, 2173during the update process notifications are emitted from the kernel to user 2174space updating it about the status and progress. 2175 2176 2177 2178Notification contents: 2179 2180 +---------------------------------------------------+--------+----------------+ 2181 | ``ETHTOOL_A_MODULE_FW_FLASH_HEADER`` | nested | reply header | 2182 +---------------------------------------------------+--------+----------------+ 2183 | ``ETHTOOL_A_MODULE_FW_FLASH_STATUS`` | u32 | status | 2184 +---------------------------------------------------+--------+----------------+ 2185 | ``ETHTOOL_A_MODULE_FW_FLASH_STATUS_MSG`` | string | status message | 2186 +---------------------------------------------------+--------+----------------+ 2187 | ``ETHTOOL_A_MODULE_FW_FLASH_DONE`` | uint | progress | 2188 +---------------------------------------------------+--------+----------------+ 2189 | ``ETHTOOL_A_MODULE_FW_FLASH_TOTAL`` | uint | total | 2190 +---------------------------------------------------+--------+----------------+ 2191 2192The ``ETHTOOL_A_MODULE_FW_FLASH_STATUS`` attribute encodes the current status 2193of the firmware update process. Possible values are: 2194 2195.. kernel-doc:: include/uapi/linux/ethtool.h 2196 :identifiers: ethtool_module_fw_flash_status 2197 2198The ``ETHTOOL_A_MODULE_FW_FLASH_STATUS_MSG`` attribute encodes a status message 2199string. 2200 2201The ``ETHTOOL_A_MODULE_FW_FLASH_DONE`` and ``ETHTOOL_A_MODULE_FW_FLASH_TOTAL`` 2202attributes encode the completed and total amount of work, respectively. 2203 2204PHY_GET 2205======= 2206 2207Retrieve information about a given Ethernet PHY sitting on the link. The DO 2208operation returns all available information about dev->phydev. User can also 2209specify a PHY_INDEX, in which case the DO request returns information about that 2210specific PHY. 2211 2212As there can be more than one PHY, the DUMP operation can be used to list the PHYs 2213present on a given interface, by passing an interface index or name in 2214the dump request. 2215 2216For more information, refer to :ref:`phy_link_topology` 2217 2218Request contents: 2219 2220 ==================================== ====== ========================== 2221 ``ETHTOOL_A_PHY_HEADER`` nested request header 2222 ==================================== ====== ========================== 2223 2224Kernel response contents: 2225 2226 ===================================== ====== =============================== 2227 ``ETHTOOL_A_PHY_HEADER`` nested request header 2228 ``ETHTOOL_A_PHY_INDEX`` u32 the phy's unique index, that can 2229 be used for phy-specific 2230 requests 2231 ``ETHTOOL_A_PHY_DRVNAME`` string the phy driver name 2232 ``ETHTOOL_A_PHY_NAME`` string the phy device name 2233 ``ETHTOOL_A_PHY_UPSTREAM_TYPE`` u32 the type of device this phy is 2234 connected to 2235 ``ETHTOOL_A_PHY_UPSTREAM_INDEX`` u32 the PHY index of the upstream 2236 PHY 2237 ``ETHTOOL_A_PHY_UPSTREAM_SFP_NAME`` string if this PHY is connected to 2238 its parent PHY through an SFP 2239 bus, the name of this sfp bus 2240 ``ETHTOOL_A_PHY_DOWNSTREAM_SFP_NAME`` string if the phy controls an sfp bus, 2241 the name of the sfp bus 2242 ===================================== ====== =============================== 2243 2244When ``ETHTOOL_A_PHY_UPSTREAM_TYPE`` is PHY_UPSTREAM_PHY, the PHY's parent is 2245another PHY. 2246 2247Request translation 2248=================== 2249 2250The following table maps ioctl commands to netlink commands providing their 2251functionality. Entries with "n/a" in right column are commands which do not 2252have their netlink replacement yet. Entries which "n/a" in the left column 2253are netlink only. 2254 2255 =================================== ===================================== 2256 ioctl command netlink command 2257 =================================== ===================================== 2258 ``ETHTOOL_GSET`` ``ETHTOOL_MSG_LINKINFO_GET`` 2259 ``ETHTOOL_MSG_LINKMODES_GET`` 2260 ``ETHTOOL_SSET`` ``ETHTOOL_MSG_LINKINFO_SET`` 2261 ``ETHTOOL_MSG_LINKMODES_SET`` 2262 ``ETHTOOL_GDRVINFO`` n/a 2263 ``ETHTOOL_GREGS`` n/a 2264 ``ETHTOOL_GWOL`` ``ETHTOOL_MSG_WOL_GET`` 2265 ``ETHTOOL_SWOL`` ``ETHTOOL_MSG_WOL_SET`` 2266 ``ETHTOOL_GMSGLVL`` ``ETHTOOL_MSG_DEBUG_GET`` 2267 ``ETHTOOL_SMSGLVL`` ``ETHTOOL_MSG_DEBUG_SET`` 2268 ``ETHTOOL_NWAY_RST`` n/a 2269 ``ETHTOOL_GLINK`` ``ETHTOOL_MSG_LINKSTATE_GET`` 2270 ``ETHTOOL_GEEPROM`` n/a 2271 ``ETHTOOL_SEEPROM`` n/a 2272 ``ETHTOOL_GCOALESCE`` ``ETHTOOL_MSG_COALESCE_GET`` 2273 ``ETHTOOL_SCOALESCE`` ``ETHTOOL_MSG_COALESCE_SET`` 2274 ``ETHTOOL_GRINGPARAM`` ``ETHTOOL_MSG_RINGS_GET`` 2275 ``ETHTOOL_SRINGPARAM`` ``ETHTOOL_MSG_RINGS_SET`` 2276 ``ETHTOOL_GPAUSEPARAM`` ``ETHTOOL_MSG_PAUSE_GET`` 2277 ``ETHTOOL_SPAUSEPARAM`` ``ETHTOOL_MSG_PAUSE_SET`` 2278 ``ETHTOOL_GRXCSUM`` ``ETHTOOL_MSG_FEATURES_GET`` 2279 ``ETHTOOL_SRXCSUM`` ``ETHTOOL_MSG_FEATURES_SET`` 2280 ``ETHTOOL_GTXCSUM`` ``ETHTOOL_MSG_FEATURES_GET`` 2281 ``ETHTOOL_STXCSUM`` ``ETHTOOL_MSG_FEATURES_SET`` 2282 ``ETHTOOL_GSG`` ``ETHTOOL_MSG_FEATURES_GET`` 2283 ``ETHTOOL_SSG`` ``ETHTOOL_MSG_FEATURES_SET`` 2284 ``ETHTOOL_TEST`` n/a 2285 ``ETHTOOL_GSTRINGS`` ``ETHTOOL_MSG_STRSET_GET`` 2286 ``ETHTOOL_PHYS_ID`` n/a 2287 ``ETHTOOL_GSTATS`` n/a 2288 ``ETHTOOL_GTSO`` ``ETHTOOL_MSG_FEATURES_GET`` 2289 ``ETHTOOL_STSO`` ``ETHTOOL_MSG_FEATURES_SET`` 2290 ``ETHTOOL_GPERMADDR`` rtnetlink ``RTM_GETLINK`` 2291 ``ETHTOOL_GUFO`` ``ETHTOOL_MSG_FEATURES_GET`` 2292 ``ETHTOOL_SUFO`` ``ETHTOOL_MSG_FEATURES_SET`` 2293 ``ETHTOOL_GGSO`` ``ETHTOOL_MSG_FEATURES_GET`` 2294 ``ETHTOOL_SGSO`` ``ETHTOOL_MSG_FEATURES_SET`` 2295 ``ETHTOOL_GFLAGS`` ``ETHTOOL_MSG_FEATURES_GET`` 2296 ``ETHTOOL_SFLAGS`` ``ETHTOOL_MSG_FEATURES_SET`` 2297 ``ETHTOOL_GPFLAGS`` ``ETHTOOL_MSG_PRIVFLAGS_GET`` 2298 ``ETHTOOL_SPFLAGS`` ``ETHTOOL_MSG_PRIVFLAGS_SET`` 2299 ``ETHTOOL_GRXFH`` n/a 2300 ``ETHTOOL_SRXFH`` n/a 2301 ``ETHTOOL_GGRO`` ``ETHTOOL_MSG_FEATURES_GET`` 2302 ``ETHTOOL_SGRO`` ``ETHTOOL_MSG_FEATURES_SET`` 2303 ``ETHTOOL_GRXRINGS`` n/a 2304 ``ETHTOOL_GRXCLSRLCNT`` n/a 2305 ``ETHTOOL_GRXCLSRULE`` n/a 2306 ``ETHTOOL_GRXCLSRLALL`` n/a 2307 ``ETHTOOL_SRXCLSRLDEL`` n/a 2308 ``ETHTOOL_SRXCLSRLINS`` n/a 2309 ``ETHTOOL_FLASHDEV`` n/a 2310 ``ETHTOOL_RESET`` n/a 2311 ``ETHTOOL_SRXNTUPLE`` n/a 2312 ``ETHTOOL_GRXNTUPLE`` n/a 2313 ``ETHTOOL_GSSET_INFO`` ``ETHTOOL_MSG_STRSET_GET`` 2314 ``ETHTOOL_GRXFHINDIR`` n/a 2315 ``ETHTOOL_SRXFHINDIR`` n/a 2316 ``ETHTOOL_GFEATURES`` ``ETHTOOL_MSG_FEATURES_GET`` 2317 ``ETHTOOL_SFEATURES`` ``ETHTOOL_MSG_FEATURES_SET`` 2318 ``ETHTOOL_GCHANNELS`` ``ETHTOOL_MSG_CHANNELS_GET`` 2319 ``ETHTOOL_SCHANNELS`` ``ETHTOOL_MSG_CHANNELS_SET`` 2320 ``ETHTOOL_SET_DUMP`` n/a 2321 ``ETHTOOL_GET_DUMP_FLAG`` n/a 2322 ``ETHTOOL_GET_DUMP_DATA`` n/a 2323 ``ETHTOOL_GET_TS_INFO`` ``ETHTOOL_MSG_TSINFO_GET`` 2324 ``ETHTOOL_GMODULEINFO`` ``ETHTOOL_MSG_MODULE_EEPROM_GET`` 2325 ``ETHTOOL_GMODULEEEPROM`` ``ETHTOOL_MSG_MODULE_EEPROM_GET`` 2326 ``ETHTOOL_GEEE`` ``ETHTOOL_MSG_EEE_GET`` 2327 ``ETHTOOL_SEEE`` ``ETHTOOL_MSG_EEE_SET`` 2328 ``ETHTOOL_GRSSH`` ``ETHTOOL_MSG_RSS_GET`` 2329 ``ETHTOOL_SRSSH`` n/a 2330 ``ETHTOOL_GTUNABLE`` n/a 2331 ``ETHTOOL_STUNABLE`` n/a 2332 ``ETHTOOL_GPHYSTATS`` n/a 2333 ``ETHTOOL_PERQUEUE`` n/a 2334 ``ETHTOOL_GLINKSETTINGS`` ``ETHTOOL_MSG_LINKINFO_GET`` 2335 ``ETHTOOL_MSG_LINKMODES_GET`` 2336 ``ETHTOOL_SLINKSETTINGS`` ``ETHTOOL_MSG_LINKINFO_SET`` 2337 ``ETHTOOL_MSG_LINKMODES_SET`` 2338 ``ETHTOOL_PHY_GTUNABLE`` n/a 2339 ``ETHTOOL_PHY_STUNABLE`` n/a 2340 ``ETHTOOL_GFECPARAM`` ``ETHTOOL_MSG_FEC_GET`` 2341 ``ETHTOOL_SFECPARAM`` ``ETHTOOL_MSG_FEC_SET`` 2342 n/a ``ETHTOOL_MSG_CABLE_TEST_ACT`` 2343 n/a ``ETHTOOL_MSG_CABLE_TEST_TDR_ACT`` 2344 n/a ``ETHTOOL_MSG_TUNNEL_INFO_GET`` 2345 n/a ``ETHTOOL_MSG_PHC_VCLOCKS_GET`` 2346 n/a ``ETHTOOL_MSG_MODULE_GET`` 2347 n/a ``ETHTOOL_MSG_MODULE_SET`` 2348 n/a ``ETHTOOL_MSG_PLCA_GET_CFG`` 2349 n/a ``ETHTOOL_MSG_PLCA_SET_CFG`` 2350 n/a ``ETHTOOL_MSG_PLCA_GET_STATUS`` 2351 n/a ``ETHTOOL_MSG_MM_GET`` 2352 n/a ``ETHTOOL_MSG_MM_SET`` 2353 n/a ``ETHTOOL_MSG_MODULE_FW_FLASH_ACT`` 2354 n/a ``ETHTOOL_MSG_PHY_GET`` 2355 =================================== ===================================== 2356