TARGET -> HOST EXTENDED STATISTICS UPLOAD(9)

💅 TARGET -> HOST EXTENDED STATISTICS UPLOAD(9) 💅

okay so this is a page straight outta the Kernel API Manual, and we're about to get into the nitty-gritty of the HTT target → host extended statistics upload confirmation message 🎀

---

🌸 the actual name of this thing 🌸

target -> host extended statistics upload — yeah that's a mouthful bestie, but we move ✨

---

✨ DESCRIPTION ✨

so. the following field definitions describe the format of the HTT target to host stats upload confirmation message. literally what it says on the tin 💅

this message contains a cookie echoed from the HTT host→target stats upload request, which identifies which request the confirmation is for 👑 and heads up: a single stats can span over multiple HTT stats indication due to the HTT message size limitation 📏 so every HTT ext stats indication will have tag-length-value stats information elements 🦋

the tag-length header for each HTT stats IND message also includes a status field, to indicate whether the request for the stat type in question was fully met, partially met, unable to be met, or invalid (if the stat type in question is disabled in the target) 🙈

and a Done bit 1's indicate the end of the of stats info elements 🏁 — that's right, the D bit at 1 means we're wrapping up, periodt.

|31                         16|15    12|11|10 8|7   5|4       0|
|--------------------------------------------------------------| |
reserved                   |    msg type   |
|--------------------------------------------------------------| |
cookie LSBs                          |
|--------------------------------------------------------------| |
cookie MSBs                          |
|--------------------------------------------------------------| |
stats entry length     | rsvd   | D|  S |   stat type   |
|--------------------------------------------------------------| |
type-specific stats info                   | |                      (see
debugfs_htt_stats.h)               |
|--------------------------------------------------------------| Header
fields:

---

🧚 HEADER FIELDS 🧚

• MSG_TYPE — Bits 7:0. Purpose: identifies this is a extended statistics upload confirmation message. Value: 0x1c ⭐
• COOKIE_LSBS — Bits 31:0. Purpose: provide a mechanism to match a target→host stats confirmation message with its preceding host→target stats request message. Value: MSBs of the opaque cookie specified by the host-side requestor 🍓
• COOKIE_MSBS — Bits 31:0. Purpose: provide a mechanism to match a target→host stats confirmation message with its preceding host→target stats request message. Value: MSBs of the opaque cookie specified by the host-side requestor 🍓

ngl bestie, the LSBs one says "Value: MSBs" in the original and I'm not about to gaslight you by "fixing" it — that's literally what it says 😭

---

🎀 STATS INFORMATION ELEMENT TAG-LENGTH HEADER FIELDS 🎀

• STAT_TYPE — Bits 7:0. Purpose: identifies the type of statistics info held in the following information element. Value: ath12k_dbg_htt_ext_stats_type 👑
• STATUS — Bits 10:8. Purpose: indicate whether the requested stats are present. Value:
  • 0 → the requested stats have been delivered in full ✅
  • 1 → the requested stats have been delivered in part 🌗
  • 2 → the requested stats could not be delivered (error case) 💀
  • 3 → the requested stat type is either not recognized (invalid) 🚫
• DONE — Bits 11. Purpose: indicates the completion of the stats entry, this will be the last stats conf HTT segment for the requested stats type. Value:
  • 0 → the stats retrieval is ongoing 🔄
  • 1 → the stats retrieval is complete 🎉
• LENGTH — Bits 31:16. Purpose: indicate the stats information size. Value: this field specifies the number of bytes of stats information that follows the element tag-length header. It is expected but not required that this length is a multiple of 4 bytes 🔢

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/net/wireless/ath/ath12k/debugfs_htt_stats.h 👀

---

and that's the whole vibe check, bestie 🫶 this page came from ./drivers/net/wireless/ath/ath12k, dated October 2026 — so like, future energy but make it kernel 💜✨💅