il_queue_dec_wrap(9)

💅 il_queue_dec_wrap — the lil countdown fairy 🧚

okay so bestie, you're reading a page from the Kernel API Manual and honestly? it's giving niche-but-iconic. this is il_queue_dec_wrap(9) and it does exactly one (1) thing, but it does it flawlessly. periodt. 💖

✨ SYNOPSIS ✨

int il_queue_dec_wrap (int idx , int n_bd );

that's it. that's the whole vibe. two ints in, one int out, no drama. 🎀

🌸 DESCRIPTION 🌸

so basically: decrement queue idx, wrap back to end. that's the whole job, no cap. you hand it a position in the queue, it steps you back one, and if you've wandered off the front it wraps you right around to the back like a little ring-buffer carousel — main character energy only. 🦋

here's the parameter lore, verbatim-ish, because we do not gatekeep:

• @idx — current idx
• @n_bd — total number of entries in queue (must be power of 2)

bestie. MUST be power of 2. this is not a suggestion, this is not a vibe, this is a requirement. the wrap math depends on it and if you ignore it you will simply have a bad time. 😭

no more details in the source, so no more details from me — I'm not out here inventing behaviour, that's not the brand. 🙈

🎀 ARGUMENTS 🎀

• idx — literally marked -- undescribed -- in the original iykyk. it's the current idx, girl, we been over this. 💅
• n_bd — also -- undescribed -- up in the docs, but from the NAME section we know it's the total number of entries in the queue, and yes, power of 2, always, forever, no exceptions. ⭐

lowkey iconic that the arguments section is just two shrugs. the docs said "you figure it out" and honestly? relatable. 🫶

🦋 SEE ALSO 🦋

okay this part is a whole group chat of friends, get comfy:

• the Kernel file ./drivers/net/wireless/intel/iwlegacy/common.h — the mothership 🌈
• struct il_device_cmd(9)
• struct il_device_cmd_huge(9)
• struct il_rx_queue(9)
• struct il_ht_agg(9)
• struct il_vif_priv(9)
• struct il_hw_params(9)
• struct il_cfg(9)
• il_clear_driver_stations(9)
• il_sta_id_or_broadcast(9)
• il_queue_inc_wrap(9) — the sibling!! goes the other direction, obsessed with the symmetry 💜
• il_beacon_time_mask_low(9)
• il_beacon_time_mask_high(9)
• struct il_rb_status(9)
• struct il_tfd_tb(9)
• struct il_tfd(9)
• struct il_rate_scale_data(9)
• struct il_scale_tbl_info(9)
• struct il_lq_sta(9)
• il3945_rate_scale_init(9)

like, go read them, they're literally right there, slay. 🔥

---

k bye bestie, this page came straight from ./drivers/net/wireless/intel/i... and was dated October 2026, so if you cite me, cite that. mwah. 💋 🎀✨