STRUCT ATH_TX_STATS(9)

💅 struct ath_tx_stats(9)

okay so this is a page from the Kernel API Manual bestie, and it's literally about struct ath_tx_stats — the stats struct that keeps receipts on all your TX. it's giving "who's counting?" and the answer is: this struct. she's counting. 🎀

---

✨ NAME ✨

struct ath_tx_stats — Statistics about TX 📊

---

🌸 SYNOPSIS 🌸

like, here's the whole glow-up, one field at a time, no cap:

struct ath_tx_stats {
    u32 tx_pkts_all;
    u32 tx_bytes_all;
    u32 queued;
    u32 completed;
    u32 xretries;
    u32 a_aggr;
    u32 a_queued_hw;
    u32 a_completed;
    u32 a_retries;
    u32 a_xretries;
    u32 txerr_filtered;
    u32 fifo_underrun;
    u32 xtxop;
    u32 timer_exp;
    u32 desc_cfg_err;
    u32 data_underrun;
    u32 delim_underrun;
    u32 puttxbuf;
    u32 txstart;
    u32 txprocdesc;
    u32 txfailed;
 };

---

🦋 Members 🦋

okay bestie, field-by-field tour, let's go 💖

• tx_pkts_all — No. of total frames transmitted, including ones that may have had errors. she counts everything, messy or not 🙈
• tx_bytes_all — No. of total bytes transmitted, including ones that may have had errors. same energy, but in bytes 💀
• queued — Total MPDUs (non-aggr) queued
• completed — Total MPDUs (non-aggr) completed ✨
• xretries — Total MPDUs with xretries
• a_aggr — Total no. of aggregates queued
• a_queued_hw — Total AMPDUs queued to hardware
• a_completed — Total AMPDUs completed 🫶
• a_retries — No. of AMPDUs retried (SW)
• a_xretries — No. of AMPDUs dropped due to xretries 😭
• txerr_filtered — No. of frames with TXERR_FILT flag set.
• fifo_underrun — FIFO underrun occurrences. Valid only for:
  • non-aggregate condition.
  • first packet of aggregate.
• xtxop — No. of frames filtered because of TXOP limit
• timer_exp — Transmit timer expiry ⏰
• desc_cfg_err — Descriptor configuration errors
• data_underrun — TX data underrun errors
• delim_underrun — TX delimiter underrun errors
• puttxbuf — Number of times hardware was given txbuf to write.
• txstart — Number of times hardware was told to start tx. 🏁
• txprocdesc — Number of times tx descriptor was processed
• txfailed — Out-of-memory or other errors in xmit path. the sad one fr fr 😔

ngl, note the fifo_underrun caveat — those occurrences are only valid for the two cases listed above. don't come for her about it, she told you upfront 🫶

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/net/wireless/ath/ath9k/debug.h
• struct ath_interrupt_stats(9) — her sister page, go give her a read too 👑

---

and that's the whole page, bestie — slay 💅✨

shoutout to the source, ./drivers/net/wireless/ath/ath9k, dated October 2026 — iconic of them to keep the receipts, periodt 🌈🍓