HARDWARE DESCRIPTOR FUNCTIONS(9)

💖 Hardware descriptor functions 💖

okay bestie so this is from the Kernel API Manual, section 9 — pull up a chair 🫶

🌸 the whole vibe (what's actually going down here)

so like, this is where we handle the processing of the low-level hw descriptors that hw reads and writes via DMA for each TX and RX attempt — and yes, that literally means we can also have descriptors for failed TX/RX tries too 😭💀 the hw doesn't ghost us just because the packet flopped, the descriptor still shows up.

we have two kind of descriptors for RX and TX:

• control descriptors — these tell the hw how to send or receive a packet, where to read/write it from/to, etc. like the little instruction card for the hw 📋✨
• status descriptors — these contain information about how the packet was sent or received, errors included. like the receipts, quite literally 🧾👑

and here's the thing: descriptor format is not exactly the same for each MAC chip version 🫠 so we have function pointers on struct ath5k_hw that we initialize at runtime based on the chip used. iykyk 💅

✨ SEE ALSO ✨

go read these, bestie, no cap:

• Kernel file ./drivers/net/wireless/ath/ath5k/desc.c
• ath5k_hw_setup_2word_tx_desc(9)
• ath5k_hw_setup_4word_tx_desc(9)
• ath5k_hw_setup_mrr_tx_desc(9)
• ath5k_hw_proc_2word_tx_status(9)
• ath5k_hw_proc_4word_tx_status(9)
• ath5k_hw_setup_rx_desc(9)
• ath5k_hw_proc_5210_rx_status(9)
• ath5k_hw_proc_5212_rx_status(9)
• ath5k_hw_init_desc_functions(9)

okay that's the whole page, mwah 💋 this lil beauty lives at ./drivers/net/wireless/ath/ath5k and it's dated October 2026 — iconic, timestamped, done. periodt 🌈⭐