ath5k_hw_set...word_tx_desc(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ath5k_hw_set...word_tx_desc(9) — like, the Kernel API Manual, bestie ✨

okay so picture this: it's a Kernel API Manual page, the title up top is ath5k_hw_set...word_tx_desc(9), and it's all about one very specific little function. stay with me, it's honestly iconic once you get it 🫶

✨ NAME ✨

ath5k_hw_setup_2word_tx_desc — Initialize a 2-word tx control descriptor. that's it, that's the whole vibe 🎀

🌸 SYNOPSIS 🌸

int ath5k_hw_setup_2word_tx_desc (struct ath5k_hw *ah , struct
ath5k_desc *desc , unsigned int pkt_len , unsigned int hdr_len , int
padsize , enum ath5k_pkt_type type , unsigned int tx_power , unsigned
int tx_rate0 , unsigned int tx_tries0 , unsigned int key_index ,
unsigned int antenna_mode , unsigned int flags , unsigned int rtscts_rate ,
unsigned int rtscts_duration );

like, yes, that's a lot of parameters. she's high-maintenance but she's worth it 💅

🦋 ARGUMENTS 🦋

  • ah — The struct ath5k_hw. your main character struct, fr.
  • desc — The struct ath5k_desc. the descriptor we're literally about to bless with data.
  • pkt_len — Frame length in bytes. how big is the frame, bestie.
  • hdr_len — Header length in bytes. ⚠️ only used on AR5210, no cap.
  • padsize — Any padding we've added to the frame length. yes, we padded it, and yes, we're telling you about it.
  • type — One of enum ath5k_pkt_type. pick your fighter.
  • tx_power — Tx power in 0.5dB steps. half-dB precision, she's that girl.
  • tx_rate0 — HW idx for transmission rate. the hardware index, not a guess, okay?
  • tx_tries0 — Max number of retransmissions. how many times we're willing to try again (relatable 😭).
  • key_index — Index on key table to use for encryption. 🔐
  • antenna_mode — Which antenna to use (0 for auto). honestly, letting it choose is such a mood.
  • flags — One of AR5K_TXDESC_* flags (see desc.h). iykyk.
  • rtscts_rate — HW idx for RTS/CTS transmission rate.
  • rtscts_duration — What to put on duration field on the header of RTS/CTS.

💖 DESCRIPTION 💖

So this is an internal function — like, not for you to call from your little userspace app, it's backstage crew energy — and what it does is initialize a 2-Word TX control descriptor, which is the descriptor flavo(u)r found on AR5210 and AR5211 MACs chips. periodt. 👑

Returns 0 on success or -EINVAL on false input. so like, check your inputs, bestie, or she WILL hand you an -EINVAL and walk away 🚶‍♀️

🌈 SEE ALSO 🌈

the whole friend group, together at last 🫶✨

and that's the page, bestie!! courtesy of ./drivers/net/wireless/ath/ath5k, dated October 2026, and yeah — this is ath5k_hw_set...word_tx_desc(9) signing off. slay, read the source, hydrate, bye 💜🌸⭐

📦 where this page comes from