Lines Matching +full:nested +full:- +full:attributes
13 requests and replies is passed using netlink attributes.
26 unprivileged users have attributes with sensitive information (e.g.
27 wake-on-lan password) omitted.
33 Attributes which represent a boolean value usually use NLA_U8 type so that we
36 in "set" requests). For these attributes, the "true" value should be passed as
37 number 1 but any non-zero value should be understood as "true" by recipient.
38 In the tables below, "bool" denotes NLA_U8 attributes interpreted in this way.
41 with "+", parent nest can contain multiple attributes of the same type. This
44 Attributes that need to be filled-in by device drivers and that are dumped to
53 Each request or reply message contains a nested attribute with common header.
89 type is used. For arbitrary length bitmaps, ethtool netlink uses a nested
91 representing bit values and mask of affected bits) and bit-by-bit (list of
94 Verbose (bit-by-bit) bitsets allow sending symbolic names for bits together
109 Compact form: nested (bitset) attribute contents:
119 rounded up to a multiple of 32 bits. They consist of 32-bit words in host byte
134 Bit-by-bit form: nested (bitset) attribute contents:
136 +------------------------------------+--------+-----------------------------+
138 +------------------------------------+--------+-----------------------------+
140 +------------------------------------+--------+-----------------------------+
141 | ``ETHTOOL_A_BITSET_BITS`` | nested | array of bits |
142 +-+----------------------------------+--------+-----------------------------+
143 | | ``ETHTOOL_A_BITSET_BITS_BIT+`` | nested | one bit |
144 +-+-+--------------------------------+--------+-----------------------------+
146 +-+-+--------------------------------+--------+-----------------------------+
148 +-+-+--------------------------------+--------+-----------------------------+
150 +-+-+--------------------------------+--------+-----------------------------+
152 Bit size is optional for bit-by-bit form. ``ETHTOOL_A_BITSET_BITS`` nest can
153 only contain ``ETHTOOL_A_BITSET_BITS_BIT`` attributes but there can be an
160 a simple bitmap. ``ETHTOOL_A_BITSET_BIT_VALUE`` attributes are not used in
196 ``ETHTOOL_MSG_WOL_GET`` get wake-on-lan settings
197 ``ETHTOOL_MSG_WOL_SET`` set wake-on-lan settings
244 ``ETHTOOL_MSG_WOL_GET_REPLY`` wake-on-lan settings
245 ``ETHTOOL_MSG_WOL_NTF`` wake-on-lan settings notification
280 information. They usually do not contain any message specific attributes.
287 attributes where a change is requested are included in such request (also, not
288 all attributes may be changed). Replies to most ``SET`` request consist only
294 These usually bear only a subset of attributes which was affected by the
322 +---------------------------------------+--------+------------------------+
323 | ``ETHTOOL_A_STRSET_HEADER`` | nested | request header |
324 +---------------------------------------+--------+------------------------+
325 | ``ETHTOOL_A_STRSET_STRINGSETS`` | nested | string set to request |
326 +-+-------------------------------------+--------+------------------------+
327 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set |
328 +-+-+-----------------------------------+--------+------------------------+
330 +-+-+-----------------------------------+--------+------------------------+
334 +---------------------------------------+--------+-----------------------+
335 | ``ETHTOOL_A_STRSET_HEADER`` | nested | reply header |
336 +---------------------------------------+--------+-----------------------+
337 | ``ETHTOOL_A_STRSET_STRINGSETS`` | nested | array of string sets |
338 +-+-------------------------------------+--------+-----------------------+
339 | | ``ETHTOOL_A_STRINGSETS_STRINGSET+`` | nested | one string set |
340 +-+-+-----------------------------------+--------+-----------------------+
342 +-+-+-----------------------------------+--------+-----------------------+
344 +-+-+-----------------------------------+--------+-----------------------+
345 | | | ``ETHTOOL_A_STRINGSET_STRINGS`` | nested | array of strings |
346 +-+-+-+---------------------------------+--------+-----------------------+
347 | | | | ``ETHTOOL_A_STRINGS_STRING+`` | nested | one string |
348 +-+-+-+-+-------------------------------+--------+-----------------------+
350 +-+-+-+-+-------------------------------+--------+-----------------------+
352 +-+-+-+-+-------------------------------+--------+-----------------------+
354 +---------------------------------------+--------+-----------------------+
359 - no ``NLM_F_DUMP,`` no device: get "global" stringsets
360 - no ``NLM_F_DUMP``, with device: get string sets related to the device
361 - ``NLM_F_DUMP``, no device: get device related string sets for all devices
374 any attributes.
379 ``ETHTOOL_A_LINKINFO_HEADER`` nested request header
385 ``ETHTOOL_A_LINKINFO_HEADER`` nested reply header
388 ``ETHTOOL_A_LINKINFO_TP_MDIX`` u8 MDI(-X) status
389 ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL`` u8 MDI(-X) control
393 Attributes and their values have the same meaning as matching members of the
403 ``LINKINFO_SET`` request allows setting some of the attributes reported by
409 ``ETHTOOL_A_LINKINFO_HEADER`` nested request header
412 ``ETHTOOL_A_LINKINFO_TP_MDIX_CTRL`` u8 MDI(-X) control
415 MDI(-X) status and transceiver cannot be set, request with the corresponding
416 attributes is rejected.
424 ``ETHTOOL_GLINKSETTINGS``. The request does not use any attributes.
429 ``ETHTOOL_A_LINKMODES_HEADER`` nested request header
435 ``ETHTOOL_A_LINKMODES_HEADER`` nested reply header
460 ``ETHTOOL_A_LINKMODES_HEADER`` nested request header
487 is down, or why it operates in some non-obvious mode. This request does not have
488 any attributes.
493 ``ETHTOOL_A_LINKSTATE_HEADER`` nested request header
499 ``ETHTOOL_A_LINKSTATE_HEADER`` nested reply header
597 not locked in first phase -
601 not locked in second phase -
660 ``ETHTOOL_A_DEBUG_HEADER`` nested request header
666 ``ETHTOOL_A_DEBUG_HEADER`` nested reply header
690 ``ETHTOOL_A_DEBUG_HEADER`` nested request header
701 Query device wake-on-lan settings. Unlike most "GET" type requests,
708 ``ETHTOOL_A_WOL_HEADER`` nested request header
714 ``ETHTOOL_A_WOL_HEADER`` nested reply header
727 Set or update wake-on-lan settings.
732 ``ETHTOOL_A_WOL_HEADER`` nested request header
749 ``ETHTOOL_A_FEATURES_HEADER`` nested request header
755 ``ETHTOOL_A_FEATURES_HEADER`` nested reply header
756 ``ETHTOOL_A_FEATURES_HW`` bitset dev->hw_features
757 ``ETHTOOL_A_FEATURES_WANTED`` bitset dev->wanted_features
758 ``ETHTOOL_A_FEATURES_ACTIVE`` bitset dev->features
780 ``ETHTOOL_A_FEATURES_HEADER`` nested request header
787 ``ETHTOOL_A_FEATURES_HEADER`` nested reply header
800 of bits which differ between requested features and result (dev->features
803 reports the difference between old and new dev->features: mask consists of
804 bits which have changed, values are their values in new dev->features (after
821 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested request header
827 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested reply header
848 ``ETHTOOL_A_PRIVFLAGS_HEADER`` nested request header
864 ``ETHTOOL_A_RINGS_HEADER`` nested request header
870 ``ETHTOOL_A_RINGS_HEADER`` nested reply header
889 page-flipping TCP zero-copy receive (``getsockopt(TCP_ZEROCOPY_RECEIVE)``).
893 HW-GRO.
899 may increase the CPU cost. Drivers may enforce additional per-packet
909 This is similar to the "tx-copybreak" parameter, which copies the packet to a
911 tx-push-buff parameter copies the packet directly to the device to allow the
922 ``ETHTOOL_A_RINGS_HEADER`` nested reply header
936 attributes.
956 ``ETHTOOL_A_CHANNELS_HEADER`` nested request header
962 ``ETHTOOL_A_CHANNELS_HEADER`` nested reply header
982 ``ETHTOOL_A_CHANNELS_HEADER`` nested request header
991 attributes.
1002 ``ETHTOOL_A_COALESCE_HEADER`` nested request header
1008 ``ETHTOOL_A_COALESCE_HEADER`` nested reply header
1038 Attributes are only included in reply if their value is not zero or the
1063 well with frequent small-sized URBs transmissions.
1073 ``ETHTOOL_A_COALESCE_HEADER`` nested request header
1103 Request is rejected if it attributes declared as unsupported by driver (i.e.
1121 ``ETHTOOL_A_PAUSE_HEADER`` nested request header
1127 .. kernel-doc:: include/uapi/linux/ethtool.h
1137 ``ETHTOOL_A_PAUSE_HEADER`` nested request header
1141 ``ETHTOOL_A_PAUSE_STATS`` nested pause statistics
1149 .. kernel-doc:: include/linux/ethtool.h
1162 ``ETHTOOL_A_PAUSE_HEADER`` nested request header
1177 ``ETHTOOL_A_EEE_HEADER`` nested request header
1183 ``ETHTOOL_A_EEE_HEADER`` nested request header
1207 ``ETHTOOL_A_EEE_HEADER`` nested request header
1229 ``ETHTOOL_A_TSINFO_HEADER`` nested request header
1235 ``ETHTOOL_A_TSINFO_HEADER`` nested request header
1243 is no special value for this case). The bitset attributes are omitted if they
1254 ``ETHTOOL_A_CABLE_TEST_HEADER`` nested request header
1263 message are mostly optional. The attributes can be repeated an
1272 +---------------------------------------------+--------+---------------------+
1273 | ``ETHTOOL_A_CABLE_TEST_HEADER`` | nested | reply header |
1274 +---------------------------------------------+--------+---------------------+
1276 +---------------------------------------------+--------+---------------------+
1277 | ``ETHTOOL_A_CABLE_TEST_NTF_NEST`` | nested | all the results |
1278 +-+-------------------------------------------+--------+---------------------+
1279 | | ``ETHTOOL_A_CABLE_NEST_RESULT`` | nested | cable test result |
1280 +-+-+-----------------------------------------+--------+---------------------+
1282 +-+-+-----------------------------------------+--------+---------------------+
1284 +-+-+-----------------------------------------+--------+---------------------+
1285 | | ``ETHTOOL_A_CABLE_NEST_RESULT`` | nested | cable test results |
1286 +-+-+-----------------------------------------+--------+---------------------+
1288 +-+-+-----------------------------------------+--------+---------------------+
1290 +-+-+-----------------------------------------+--------+---------------------+
1291 | | ``ETHTOOL_A_CABLE_NEST_FAULT_LENGTH`` | nested | cable length |
1292 +-+-+-----------------------------------------+--------+---------------------+
1294 +-+-+-----------------------------------------+--------+---------------------+
1296 +-+-+-----------------------------------------+--------+---------------------+
1305 +--------------------------------------------+--------+-----------------------+
1306 | ``ETHTOOL_A_CABLE_TEST_TDR_HEADER`` | nested | reply header |
1307 +--------------------------------------------+--------+-----------------------+
1308 | ``ETHTOOL_A_CABLE_TEST_TDR_CFG`` | nested | test configuration |
1309 +-+------------------------------------------+--------+-----------------------+
1311 +-+-+----------------------------------------+--------+-----------------------+
1313 +-+-+----------------------------------------+--------+-----------------------+
1315 +-+-+----------------------------------------+--------+-----------------------+
1317 +-+-+----------------------------------------+--------+-----------------------+
1354 +---------------------------------------------+--------+----------------------+
1355 | ``ETHTOOL_A_CABLE_TEST_TDR_HEADER`` | nested | reply header |
1356 +---------------------------------------------+--------+----------------------+
1358 +---------------------------------------------+--------+----------------------+
1359 | ``ETHTOOL_A_CABLE_TEST_TDR_NTF_NEST`` | nested | all the results |
1360 +-+-------------------------------------------+--------+----------------------+
1361 | | ``ETHTOOL_A_CABLE_TDR_NEST_PULSE`` | nested | TX Pulse amplitude |
1362 +-+-+-----------------------------------------+--------+----------------------+
1364 +-+-+-----------------------------------------+--------+----------------------+
1365 | | ``ETHTOOL_A_CABLE_NEST_STEP`` | nested | TDR step info |
1366 +-+-+-----------------------------------------+--------+----------------------+
1368 +-+-+-----------------------------------------+--------+----------------------+
1370 +-+-+-----------------------------------------+--------+----------------------+
1372 +-+-+-----------------------------------------+--------+----------------------+
1373 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude |
1374 +-+-+-----------------------------------------+--------+----------------------+
1376 +-+-+-----------------------------------------+--------+----------------------+
1378 +-+-+-----------------------------------------+--------+----------------------+
1379 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude |
1380 +-+-+-----------------------------------------+--------+----------------------+
1382 +-+-+-----------------------------------------+--------+----------------------+
1384 +-+-+-----------------------------------------+--------+----------------------+
1385 | | ``ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE`` | nested | Reflection amplitude |
1386 +-+-+-----------------------------------------+--------+----------------------+
1388 +-+-+-----------------------------------------+--------+----------------------+
1390 +-+-+-----------------------------------------+--------+----------------------+
1400 ``ETHTOOL_A_TUNNEL_INFO_HEADER`` nested request header
1405 +---------------------------------------------+--------+---------------------+
1406 | ``ETHTOOL_A_TUNNEL_INFO_HEADER`` | nested | reply header |
1407 +---------------------------------------------+--------+---------------------+
1408 | ``ETHTOOL_A_TUNNEL_INFO_UDP_PORTS`` | nested | all UDP port tables |
1409 +-+-------------------------------------------+--------+---------------------+
1410 | | ``ETHTOOL_A_TUNNEL_UDP_TABLE`` | nested | one UDP port table |
1411 +-+-+-----------------------------------------+--------+---------------------+
1414 +-+-+-----------------------------------------+--------+---------------------+
1417 +-+-+-----------------------------------------+--------+---------------------+
1418 | | | ``ETHTOOL_A_TUNNEL_UDP_TABLE_ENTRY`` | nested | offloaded UDP port |
1419 +-+-+-+---------------------------------------+--------+---------------------+
1421 +-+-+-+---------------------------------------+--------+---------------------+
1423 +-+-+-+---------------------------------------+--------+---------------------+
1426 the table contains static entries, hard-coded by the NIC.
1436 ``ETHTOOL_A_FEC_HEADER`` nested request header
1442 ``ETHTOOL_A_FEC_HEADER`` nested request header
1446 ``ETHTOOL_A_FEC_STATS`` nested FEC statistics
1454 autonegotiation is disabled. If ``ETHTOOL_A_FEC_AUTO`` is non-zero driver will
1467 +--------------+---------------------------------------------+
1469 +--------------+---------------------------------------------+
1470 | `1` | device does not support per-lane break down |
1471 +--------------+---------------------------------------------+
1473 +--------------+---------------------------------------------+
1477 .. kernel-doc:: include/linux/ethtool.h
1488 ``ETHTOOL_A_FEC_HEADER`` nested request header
1515 ``ETHTOOL_A_MODULE_EEPROM_HEADER`` nested request header
1527 +---------------------------------------------+--------+---------------------+
1528 | ``ETHTOOL_A_MODULE_EEPROM_HEADER`` | nested | reply header |
1529 +---------------------------------------------+--------+---------------------+
1532 +---------------------------------------------+--------+---------------------+
1541 a re-implementation of ``ETHTOOL_GSTATS`` which exposed driver-defined
1547 ``ETHTOOL_A_STATS_HEADER`` nested request header
1554 +-----------------------------------+--------+--------------------------------+
1555 | ``ETHTOOL_A_STATS_HEADER`` | nested | reply header |
1556 +-----------------------------------+--------+--------------------------------+
1558 +-----------------------------------+--------+--------------------------------+
1559 | ``ETHTOOL_A_STATS_GRP`` | nested | one or more group of stats |
1560 +-+---------------------------------+--------+--------------------------------+
1561 | | ``ETHTOOL_A_STATS_GRP_ID`` | u32 | group ID - ``ETHTOOL_STATS_*`` |
1562 +-+---------------------------------+--------+--------------------------------+
1564 +-+---------------------------------+--------+--------------------------------+
1565 | | ``ETHTOOL_A_STATS_GRP_STAT`` | nested | nest containing a statistic |
1566 +-+---------------------------------+--------+--------------------------------+
1567 | | ``ETHTOOL_A_STATS_GRP_HIST_RX`` | nested | histogram statistic (Rx) |
1568 +-+---------------------------------+--------+--------------------------------+
1569 | | ``ETHTOOL_A_STATS_GRP_HIST_TX`` | nested | histogram statistic (Tx) |
1570 +-+---------------------------------+--------+--------------------------------+
1576 ETHTOOL_STATS_ETH_MAC eth-mac Basic IEEE 802.3 MAC statistics (30.3.1.1.*)
1577 ETHTOOL_STATS_ETH_PHY eth-phy Basic IEEE 802.3 PHY statistics (30.3.2.1.*)
1578 ETHTOOL_STATS_ETH_CTRL eth-ctrl Basic IEEE 802.3 MAC Ctrl statistics (30.3.3.*)
1589 single 8 byte (u64) attribute inside - the type of that attribute is
1603 contain the following attributes:
1633 ``ETHTOOL_A_PHC_VCLOCKS_HEADER`` nested request header
1639 ``ETHTOOL_A_PHC_VCLOCKS_HEADER`` nested reply header
1652 ``ETHTOOL_A_MODULE_HEADER`` nested request header
1658 ``ETHTOOL_A_MODULE_HEADER`` nested reply header
1665 is driver-dependent, but "auto" is the recommended default and it should be
1671 is plugged-in. Possible values are:
1673 .. kernel-doc:: include/uapi/linux/ethtool.h
1684 ``ETHTOOL_A_MODULE_HEADER`` nested request header
1692 .. kernel-doc:: include/uapi/linux/ethtool.h
1695 For SFF-8636 modules, low power mode is forced by the host according to table
1696 6-10 in revision 2.10a of the specification.
1698 For CMIS modules, low power mode is forced by the host according to table 6-12
1704 Gets PSE attributes.
1709 ``ETHTOOL_A_PSE_HEADER`` nested request header
1715 ``ETHTOOL_A_PSE_HEADER`` nested reply header
1725 action. This option is corresponding to ``IEEE 802.3-2018`` 30.15.1.1.2
1728 .. kernel-doc:: include/uapi/linux/ethtool.h
1734 corresponding to ``IEEE 802.3-2018`` 30.15.1.1.3 aPoDLPSEPowerDetectionStatus.
1737 .. kernel-doc:: include/uapi/linux/ethtool.h
1748 ``ETHTOOL_A_PSE_HEADER`` nested request header
1754 ``IEEE 802.3-2018`` 30.15.1.2.1 acPoDLPSEAdminControl. See
1766 ``ETHTOOL_A_RSS_HEADER`` nested request header
1773 ``ETHTOOL_A_RSS_HEADER`` nested reply header
1786 hfunc. Current supported option is symmetric-xor.
1791 Gets the IEEE 802.3cg-2019 Clause 148 Physical Layer Collision Avoidance
1792 (PLCA) Reconciliation Sublayer (RS) attributes.
1797 ``ETHTOOL_A_PLCA_HEADER`` nested request header
1803 ``ETHTOOL_A_PLCA_HEADER`` nested reply header
1812 value in bit-times (BT)
1823 the interface is vendor-specific and (possibly) supplied by the driver.
1824 The OPEN Alliance SIG specifies a standard register map for 10BASE-T1S PHYs
1825 embedding the PLCA Reconcialiation Sublayer. See "10BASE-T1S PLCA Management
1830 CSMA/CD mode. This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.1
1836 corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.4 aPLCALocalNodeID. The valid
1840 configured maximum number of PLCA nodes on the mixing-segment. This number
1844 This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.3
1848 configured value of the transmit opportunity timer in bit-times. This value
1850 correctly. This option is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.5
1862 ``IEEE 802.3cg-2019`` 30.16.1.1.6 aPLCAMaxBurstCount. The valid range for this
1866 many bit-times the PLCA RS waits for the MAC to initiate a new transmission
1870 is corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.7 aPLCABurstTimer. The
1872 set greater than the Inter-Frame-Gap (IFG) time of the MAC (plus some margin)
1883 ``ETHTOOL_A_PLCA_HEADER`` nested request header
1890 value in bit-times (BT)
1909 ``ETHTOOL_A_PLCA_HEADER`` nested request header
1915 ``ETHTOOL_A_PLCA_HEADER`` nested reply header
1921 corresponding to ``IEEE 802.3cg-2019`` 30.16.1.1.2 aPLCAStatus.
1931 ``ETHTOOL_A_MM_HEADER`` nested request header
1937 ``ETHTOOL_A_MM_HEADER`` nested request header
1938 ``ETHTOOL_A_MM_PMAC_ENABLED`` bool set if RX of preemptible and SMD-V
1946 non-final fragments, in octets
1947 ``ETHTOOL_A_MM_RX_MIN_FRAG_SIZE`` u32 minimum size of received non-final
1949 ``ETHTOOL_A_MM_VERIFY_ENABLED`` bool set if TX of SMD-V frames is
1955 ``ETHTOOL_A_MM_STATS`` nested IEEE 802.3-2018 subclause 30.14.1
1959 The attributes are populated by the device driver through the following
1962 .. kernel-doc:: include/linux/ethtool.h
1967 .. kernel-doc:: include/uapi/linux/ethtool.h
1984 .. kernel-doc:: include/linux/ethtool.h
2002 The attributes are propagated to the driver through the following structure:
2004 .. kernel-doc:: include/linux/ethtool.h