docs: net: statistics: fix kernel-internal stats list

Update the kernel-internal ethtool stats list to match current code:

- spell the entries as "struct ethtool_*_stats", not as functions
- list the full set of structures, not only pause and fec
- mention that fields are pre-initialized to ETHTOOL_STAT_NOT_SET by
  ethtool_stats_init() and drivers should leave unsupported fields at
  that value rather than zeroing them

Link: https://patch.msgid.link/20260526160151.2793354-4-kuba@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
Jakub Kicinski 2026-05-26 09:01:44 -07:00
parent c801a20779
commit 73ac86c584

View File

@ -231,8 +231,19 @@ Kernel-internal data structures
-------------------------------
The following structures are internal to the kernel, their members are
translated to netlink attributes when dumped. Drivers must not overwrite
the statistics they don't report with 0.
translated to netlink attributes when dumped. Fields are pre-initialized
to ``ETHTOOL_STAT_NOT_SET`` (by ``ethtool_stats_init()``); drivers must
leave fields they do not report at that value rather than overwriting
them with 0.
- ethtool_pause_stats()
- ethtool_fec_stats()
- ``struct ethtool_eth_ctrl_stats``
- ``struct ethtool_eth_mac_stats``
- ``struct ethtool_eth_phy_stats``
- ``struct ethtool_fec_hist``
- ``struct ethtool_fec_stats``
- ``struct ethtool_link_ext_stats``
- ``struct ethtool_mm_stats``
- ``struct ethtool_pause_stats``
- ``struct ethtool_phy_stats``
- ``struct ethtool_rmon_stats``
- ``struct ethtool_ts_stats``