ath5k_hw_setup_mrr_tx_desc(9)

💅 ath5k_hw_setup_mrr_tx_desc(9) 💅

okay so you found the ath5k_hw_setup_mrr_tx_desc(9) page in the Kernel API Manual, and honestly? iconic. this is the function that initializes an MRR tx control descriptor, and we're gonna keep every single detail intact. no cap. 🫶

💖 NAME 💖

ath5k_hw_setup_mrr_tx_desc — initialize an MRR tx control descriptor. that's the whole vibe, but the details are below, bestie. ✨

✨ SYNOPSIS ✨

int ath5k_hw_setup_mrr_tx_desc (struct ath5k_hw *ah , struct ath5k_desc
*desc , u_int tx_rate1 , u_int tx_tries1 , u_int tx_rate2 , u_int
tx_tries2 , u_int tx_rate3 , u_int tx_tries3 );

lowkey a whole lineup of arguments, but we're handling them one by one. 💅

🎀 ARGUMENTS 🎀

• ah — the struct ath5k_hw. yes, that one. 💖
• desc — the struct ath5k_desc. the descriptor cutie in question.
• tx_rate1 — HW idx for rate used on transmission series 1. literally the first series' rate index. ⭐
• tx_tries1 — max number of retransmissions for transmission series 1. periodt.
• tx_rate2 — HW idx for rate used on transmission series 2.
• tx_tries2 — max number of retransmissions for transmission series 2.
• tx_rate3 — HW idx for rate used on transmission series 3.
• tx_tries3 — max number of retransmissions for transmission series 3. and that's the full set, bestie. 🦋

🦋 DESCRIPTION 🦋

okay so Multi rate retry (MRR) tx control descriptors are available only on AR5212 MACs. not everywhere, bestie — only those. they are part of the normal 4-word tx control descriptor (see above), but we handle them through a separate function for better abstraction. it's giving clean-little-abstraction energy, and we respect it. ✨

it returns 0 on success or -EINVAL on invalid input. that's the whole return situation. 💀

🌈 SEE ALSO 🌈

• Kernel file ./drivers/net/wireless/ath/ath5k/desc.c
• Hardware descriptor functions(9)
• ath5k_hw_setup_2word_tx_desc(9)
• ath5k_hw_setup_4word_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)

all the related function besties are right there. iykyk. 👑

mwah 💋 this page comes from source/version ./drivers/net/wireless/ath/ath5k, dated October 2026, and it's the ath5k_hw_setup_mrr_tx_desc(9) page. bye bestie, go initialize those MRR tx control descriptors responsibly. 🫶🎀