STRUCT IWL_RB_STATUS(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

✨ struct iwl_rb_status ✨

okay bestie, welcome to the struct iwl_rb_status page from the Kernel API Manual (section 9, kernel-space, very demure, very mindful). it's a struct. it's in a header. it's giving "reserve buffer status host memory mapped FH registers" and honestly? iconic.


🌸 NAME 🌸

struct iwl_rb_status β€” the reserve buffer status host memory mapped FH registers, fr fr. that's the whole vibe. it's literally the struct that tells you what's up with your RBs and FRs. πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

here's the whole thing, copy it exactly or don't come to me crying:

struct iwl_rb_status {
    __le16 closed_rb_num;
    __le16 closed_fr_num;
    __le16 finished_rb_num;
    __le16 finished_fr_num;
    __le32 __spare;
 };

the way that this is just five fields of pure main character energy πŸ¦‹


πŸ’– Members πŸ’–

one bullet per member, no skips, no shortcuts, we don't do that here:

  • closed_rb_num β€” [0:11] tells you the index of the RB which was closed. that's it. that's the field. ✨
  • closed_fr_num β€” [0:11] tells you the index of the RX Frame which was closed. the closed one. not the finished one. keep up bestie 🫢
  • finished_rb_num β€” [0:11] tells you the index of the current RB in which the last frame was written to. yes, "in which". we're quoting, don't @ me 🌸
  • finished_fr_num β€” [0:11] tells you the index of the RX Frame which was transferred. transferred! not closed! different field, different vibe πŸ”₯
  • __spare β€” reserved. that's literally all the manpage says. it's reserved. leave it alone. don't touch it. it's resting πŸ’€
notice how four of these are [0:11]? that's the bit range, bestie, not a suggestion. __spare doesn't get one. it's built different. it's __le32 and it's not doing bits β€” it's doing nothing, on purpose πŸ™ˆ

πŸ‘‘ SEE ALSO πŸ‘‘

go read these next, i'm obsessed with the cross-referencing:

  • Kernel file ./drivers/net/wireless/intel/iwlwifi/iwl-fh.h
  • enum iwl_tfd_tb_hi_n_len(9)
  • struct iwl_tfd_tb(9)
  • struct iwl_tfh_tb(9)
  • struct iwl_tfd(9)
  • struct iwl_tfh_tfd(9)
  • struct iwl_bc_tbl_entry(9)

like, the whole iwlwifi family tree is right there. it's a family reunion and everyone showed up πŸ’œπŸŒˆ


<div>mwah πŸ’‹</div>

so yeah, that's the page! it came from ./drivers/net/wireless/intel/i... (the footer truncated it, not me, i would never 😭), the date on it is October 2026, and it's filed under struct iwl_rb_status(9). go forth and check your buffer statuses. slay β­πŸ‘‘πŸŽ€

πŸ“¦ where this page comes from