STRUCT IAVF_STATS(9)

🦋 struct iavf_stats(9) — Kernel API Manual 🦋

okay bestie, so this is a page from the Kernel API Manual and it's literally all about struct iavf_stats — the little glow-up blueprint for, and I quote, "definition for an ethtool statistic" ✨ yes ma'am, that's the whole vibe.

---

🌸 NAME 🌸

struct iavf_stats — the definition for an ethtool statistic. that's it, that's the name, she's simple but she's iconic 💅

---

✨ SYNOPSIS ✨

struct iavf_stats {
    char stat_string[ETH_GSTRING_LEN];
    int sizeof_stat;
    int stat_offset;
 };

look at her. three little fields, zero drama, all business 🫶

---

🎀 Members 🎀

• stat_string — the statistic name that gets displayed in the ethtool -S output. it's the label bestie, the little nametag 👑
• sizeof_stat — literally the sizeof the stat itself. rule of the house: it must be no greater than sizeof(u64). don't push it 🙈
• stat_offset — the offsetof of the stat from a base pointer. it's giving "where am I relative to home" 🧭

---

💖 Description 💖

so this structure is what defines a statistic that gets added to the ethtool stats buffer. it defines a statistic as an offset from a common base pointer — that's the whole trick, iykyk 💫

stats should be defined in constant arrays using the IAVF_STAT macro, and listen: every single element of that array has to use the same _type for calculating sizeof_stat and stat_offset. no mixing, no chaos, we're consistent in this household periodt 🎀

the sizeof_stat is expected to be sizeof(u8), sizeof(u16), sizeof(u32) or sizeof(u64). those four, that's the squad. other sizes are not expected, and if you try it you will produce a WARN_ONCE from the iavf_add_ethtool_stat helper function 😭 so like... don't. fr fr.

⚠️ heads up bestie — the stat_string is interpreted as a format string, which means formatted values can get inserted while looping over multiple structures for a given statistics array. so every statistic string in an array should have the same type and number of format specifiers, to be formatted by variadic arguments to the iavf_add_stat_string helper function. same type, same count, no exceptions 🫶

---

🌈 SEE ALSO 🌈

kernel file ./drivers/net/ethernet/intel/iavf/iavf_ethtool.c — go read the source, she's right there 💜

and the whole friend group, in order, no cap:

• iavf_add_one_ethtool_stat(9)
• __iavf_add_ethtool_stats(9)
• iavf_add_ethtool_stats(9)
• iavf_add_queue_stats(9)
• __iavf_add_stat_strings(9)
• iavf_add_stat_strings(9)
• iavf_get_link_ksettings(9)
• iavf_get_sset_count(9)
• iavf_get_ethtool_stats(9)
• iavf_get_stat_strings(9)
• iavf_get_strings(9)
• iavf_get_msglevel(9)
• iavf_set_msglevel(9)
• iavf_get_drvinfo(9)
• iavf_get_ringparam(9)
• iavf_set_ringparam(9)
• __iavf_get_coalesce(9)
• iavf_get_coalesce(9)
• iavf_get_per_queue_coalesce(9)
• iavf_set_itr_per_queue(9)
• __iavf_set_coalesce(9)
• iavf_set_coalesce(9)
• iavf_set_per_queue_coalesce(9)
• iavf_fltr_to_ethtool_flow(9)
• iavf_ethtool_flow_to_fltr(9)
• iavf_is_mask_valid(9)
• iavf_parse_rx_flow_user_data(9)
• iavf_fill_rx_flow_ext_data(9)
• iavf_get_ethtool_fdir_entry(9)
• iavf_get_fdir_fltr_ids(9)
• iavf_add_fdir_fltr_info(9)
• iavf_add_fdir_ethtool(9)
• iavf_del_fdir_ethtool(9)
• iavf_set_rxnfc(9)
• iavf_get_rx_ring_count(9)
• iavf_get_rxnfc(9)
• iavf_get_channels(9)
• iavf_set_channels(9)
• iavf_get_rxfh_key_size(9)
• iavf_get_rxfh_indir_size(9)
• iavf_get_rxfh(9)
• iavf_set_rxfh(9)
• iavf_set_ethtool_ops(9)

---

and that's the whole page bestie, go forth and offset responsibly 💅

✧･ﾟ: * sign-off time * :ﾟ･✧ this lil masterpiece lives in ./drivers/net/ethernet/intel/iavf and it's dated October 2026 — struct iavf_stats(9), out 🦋💖