IEEE 802.3ck-2022 defines counters for FEC bins and 802.3df-2024
clarifies it a bit further. Implement reporting interface through as
addition to FEC stats available in ethtool. NetDevSim driver has simple
implementation as an example while mlx5 has much more complex solution.
The example query is the same as usual FEC statistics while the answer
is a bit more verbose:
[vmuser@archvm9 linux]$ ./tools/net/ynl/pyynl/cli.py --spec
Documentation/netlink/specs/ethtool.yaml --do fec-get --json
'{"header":{"dev-index": 10, "flags": 4}}'
{'auto': 0,
'header': {'dev-index': 10, 'dev-name': 'eni10np1'},
'modes': {'bits': {}, 'nomask': True, 'size': 121},
'stats': {'corr-bits': [],
'corrected': [123],
'hist': [{'bin-high': 0,
'bin-low': 0,
'bin-val': 445,
'bin-val-per-lane': [125, 120, 100, 100]},
{'bin-high': 3, 'bin-low': 1, 'bin-val': 12},
{'bin-high': 7,
'bin-low': 4,
'bin-val': 2,
'bin-val-per-lane': [2, 0, 0, 0]}],
'uncorr': [4]}}
v5 -> v6:
* adjust yaml spec to have padding field within fec-hist namespace
* mlx5: adjust max histogram entries check to match the size of array of
mapped registers
v4 -> v5:
* fix selftests error path
v3 -> v4:
* update spec to avoid using underscores
* make core accumulate per-lane errors into bin error counter
* adjust wording in Documentation
* improve FEC type check in mlx5
* add selftest to do sanity check of reported histogram
* partially carry-over Rb tags from Aleksandr because of logical changes
v3 Link -
https://lore.kernel.org/netdev/[email protected]/
v2 -> v3:
* fix yaml spec to use binary array for histogram per-lane values
* fix spelling
v1 -> v2:
* fix memset size of FEC histogram bins in mlx5
* adjust fbnic driver FEC stats callback
Links to RFC discussions:
v1 - https://lore.kernel.org/netdev/[email protected]/
v2 - https://lore.kernel.org/netdev/[email protected]/
v3 - https://lore.kernel.org/netdev/[email protected]/
v4 - https://lore.kernel.org/netdev/[email protected]/
v5 - https://lore.kernel.org/netdev/[email protected]/
Carolina Jubran (3):
net/mlx5e: Don't query FEC statistics when FEC is disabled
net/mlx5e: Add logic to read RS-FEC histogram bin ranges from PPHCR
net/mlx5e: Report RS-FEC histogram statistics via ethtool
Vadim Fedorenko (2):
ethtool: add FEC bins histogram report
selftests: net-drv: stats: sanity check FEC histogram
Documentation/netlink/specs/ethtool.yaml | 29 ++++
Documentation/networking/ethtool-netlink.rst | 5 +
.../net/ethernet/broadcom/bnxt/bnxt_ethtool.c | 3 +-
.../ethernet/fungible/funeth/funeth_ethtool.c | 3 +-
.../ethernet/hisilicon/hns3/hns3_ethtool.c | 3 +-
drivers/net/ethernet/intel/ice/ice_ethtool.c | 4 +-
.../marvell/octeontx2/nic/otx2_ethtool.c | 3 +-
drivers/net/ethernet/mellanox/mlx5/core/en.h | 1 +
.../ethernet/mellanox/mlx5/core/en_ethtool.c | 5 +-
.../net/ethernet/mellanox/mlx5/core/en_main.c | 8 ++
.../ethernet/mellanox/mlx5/core/en_stats.c | 127 +++++++++++++++++-
.../ethernet/mellanox/mlx5/core/en_stats.h | 3 +-
.../net/ethernet/meta/fbnic/fbnic_ethtool.c | 3 +-
drivers/net/ethernet/sfc/ethtool.c | 3 +-
drivers/net/ethernet/sfc/siena/ethtool.c | 3 +-
drivers/net/netdevsim/ethtool.c | 25 +++-
include/linux/ethtool.h | 25 +++-
.../uapi/linux/ethtool_netlink_generated.h | 12 ++
net/ethtool/fec.c | 75 ++++++++++-
tools/testing/selftests/drivers/net/stats.py | 35 ++++-
20 files changed, 351 insertions(+), 24 deletions(-)
--
2.47.3