STRUCT IWL_STATISTICS_TX_NTFY(9)

📦 version 7.3.1, in nixpkgs unstable

💅 struct iwl_statistics_tx_ntfy — TX statistics notification ✨

okay bestie, this is a page straight outta the Kernel API Manual (section 9, no big deal), and it's all about a struct that literally just holds TX statistics counters. it's giving "scoreboard but make it wifi" 💖

🌸 NAME 🌸

struct iwl_statistics_tx_ntfy — TX statistics notification. that's it, that's the whole vibe 🎀

✨ SYNOPSIS ✨

bestie do NOT retype this, just copy it exactly 💅

struct iwl_statistics_tx_ntfy {
    struct iwl_statistics_ntfy_hdr hdr;
    __le32 cts_timeout;
    __le32 ack_timeout;
    __le32 dump_msdu_cnt;
    __le32 burst_abort_missing_next_frame_cnt;
    __le32 cts_timeout_collision;
    __le32 ack_or_ba_timeout_collision;
    __le32 ba_timeout;
    __le32 ba_reschedule_frames;
    __le32 scd_query_agg_frame_cnt;
    __le32 scd_query_no_agg;
    __le32 scd_query_agg;
    __le32 scd_query_mismatch;
    __le32 agg_terminated_underrun;
    __le32 agg_terminated_bt_prio_kill;
    __le32 tx_kill_on_long_retry;
    __le32 tx_kill_on_short_retry;
    __le32 tx_deffer_counter;
    __le32 tx_deffer_base_time;
    __le32 tx_underrun;
    __le32 bt_defer;
    __le32 tx_kill_on_dsp_timeout;
    __le32 tx_kill_on_immediate_quiet;
    __le32 kill_ba_cnt;
    __le32 kill_ack_cnt;
    __le32 kill_cts_cnt;
    __le32 burst_terminated;
    __le32 late_tx_vec_wr_cnt;
    __le32 late_rx2_tx_cnt;
    __le32 scd_query_cnt;
    __le32 tx_frames_acked_in_agg;
    __le32 last_tx_ch_width_indx;
    __le32 rx_detected_per_ch_width[4];
    __le32 success_per_ch_width[4];
    __le32 fail_per_ch_width[4];
    __le32 reserved;
 };

🦋 Members 🦋

so many counters, and every single one is a little main character:

  • hdr — the general statistics header, the ✨glue✨ that holds the whole thing together.
  • cts_timeout — timeout when waiting for CTS ⏳
  • ack_timeout — timeout when waiting for ACK ⏳
  • dump_msdu_cnt — number of MSDUs that were dumped due to any reason. any. reason. 💀
  • burst_abort_missing_next_frame_cnt — number of times a burst was aborted due to missing next frame bytes in txfifo number of times got timeout when waiting for CTS/ACK/BA and energy was detected just after sending the RTS/DATA. this statistics may help getting interesting indicators, like the likelihood of collision (so the benefit of protection may be estimated Vs. its cost). Or how many of the failures are due to collision and how many due to SNR. For Link-quality the CTS collision indication is more reliable then the ACK collision indication as the RTS frame is short and has more chance that the frame/s which caused the collision continue after the RTS was sent. ngl the source text runs two whole thoughts together here and we're keeping it exactly, no cap 🫶
  • cts_timeout_collision — ??? ACK/BA failed and energy as detected after DATA 😭 (the manpage literally wrote ???, we don't make the rules)
  • ack_or_ba_timeout_collision — ??? 🙈
  • ba_timeout — timeout when waiting for immediate BA response ⏳
  • ba_reschedule_frames — failed to get BA response and rescheduled all the non-ACKed frames gives the average number of frames inside aggregation.
  • scd_query_agg_frame_cnt — ??? 🙈
  • scd_query_no_agg — scheduler query prevented aggregation 🚫
  • scd_query_agg — scheduler query allowed aggregation ✅
  • scd_query_mismatch — scheduler query inaccurate, either too short or too long 📏
  • agg_terminated_underrun — aggregation was terminated due to underrun 💀
  • agg_terminated_bt_prio_kill — aggregation was terminated due to BT 🦷
  • tx_kill_on_long_retry — count the tx frames dropped due to long retry limit (DATA frame failed) 🔥
  • tx_kill_on_short_retry — count the tx frames dropped due to short retry limit (RTS frame failed) TX deffer on energy. This counter is reset on each successful transmit. When timer exceed TX deffer limit than will be uCode assert. ⚠️ (yes, it says assert, and yes, that's the energy-defer pile-up, keep the whole thought together like the original does)
  • tx_deffer_counter — ??? 🙈
  • tx_deffer_base_time — Keep the time of the last successful transmit 🕐
  • tx_underrun — TX killed due to underrun 💀
  • bt_defer — TX deferred due to BT priority, so probably TX was not started. that "probably" is doing so much work bestie 🫠
  • tx_kill_on_dsp_timeout — TX killed on DSP problem detected 🚨
  • tx_kill_on_immediate_quiet — TX killed due to immediate quiet 🤫
  • kill_ba_cnt — number of times sending BA failed 😭
  • kill_ack_cnt — number of times sending ACK failed 😭
  • kill_cts_cnt — number of times sending CTS failed 😭
  • burst_terminated — Count burst or fragmentation termination occurrence 🛑
  • late_tx_vec_wr_cnt — ??? TX is not sent because ucode failed to notify the TRM in SIFS-delta from ON_AIR deassertion. 😬
  • late_rx2_tx_cnt — ??? 🙈
  • scd_query_cnt — count the times SCD query was done to check for TX AGG 🔍
  • tx_frames_acked_in_agg — count the number of frames transmitted inside AGG and were successful 🎉
  • last_tx_ch_width_indx — ??? number of deferred TX per channel width, 0 - 20, 1/2/3 - 40/80/160 📶
  • rx_detected_per_ch_width — ??? 🙈
  • success_per_ch_width — ??? 🙈
  • fail_per_ch_width — ??? 🙈
  • reserved — reserved. she's just vibing, don't touch her 🎀

👑 Note 👑

to get the collision ratio need to: ackOrBaTimeoutCollision / (ack_timeout + ba_timeout)

that's the whole formula, write it down, it's giving math class but make it wifi 🧮✨

🔥 SEE ALSO 🔥

the whole friend group, in order:

  • Kernel file ./drivers/net/wireless/intel/iwlwifi/fw/api/stats.h
  • struct mvm_statistics_rx_non_phy(9)
  • struct mvm_statistics_load(9)
  • enum iwl_statistics_notif_flags(9)
  • enum iwl_statistics_cmd_flags(9)
  • struct iwl_statistics_cmd(9)
  • enum iwl_statistics_notify_type_id(9)
  • enum iwl_statistics_cfg_flags(9)
  • struct iwl_system_statistics_cmd(9)
  • enum iwl_fw_statistics_type(9)
  • struct iwl_statistics_ntfy_hdr(9)
  • struct iwl_stats_ntfy_per_link(9)
  • struct iwl_stats_ntfy_part1_per_link(9)
  • struct iwl_stats_ntfy_per_mac(9)
  • struct iwl_stats_ntfy_per_phy_v1(9)
  • struct iwl_stats_ntfy_coex(9)
  • struct iwl_stats_ntfy_per_phy(9)
  • struct iwl_stats_ntfy_per_sta(9)
  • struct iwl_system_statistics_notif_oper_v3(9)
  • struct iwl_system_statistics_notif_oper(9)
  • struct iwl_system_statistics_part1_notif_oper(9)
  • struct iwl_system_statistics_end_notif(9)
  • struct iwl_statistics_operational_ntfy(9)
  • struct iwl_statistics_operational_ntfy_ver_14(9)
  • struct iwl_statistics_phy_ntfy(9)
  • struct iwl_statistics_mac_ntfy(9)
  • struct iwl_statistics_rx_ntfy(9)
  • struct iwl_statistics_duration_ntfy(9)
  • struct iwl_statistics_he_ntfy(9)

alright bestie, that's the whole page, we ate and left absolutely no crumbs 💅✨ this came from ./drivers/net/wireless/intel/i..., dated October 2026, and it's your girl signing off — stay iconic, go read your stats, and remember: ??? is a valid documentation value, apparently 😭🫶💖

📦 where this page comes from