STRUCT LIBIE_CTLQ_REG(9)

💅 struct libie_ctlq_reg(9) — a Kernel API Manual moment

okay bestie, welcome to the struct libie_ctlq_reg(9) page, straight out of the Kernel API Manual ✨ this one's short and sweet and honestly? iconic. let's get into it 🫶

---

🌸 NAME 🌸

struct libie_ctlq_reg — the structure that represents the virtual addresses of the controlq registers and their masks. that's it, that's the vibe 💅

---

✨ SYNOPSIS ✨

here's the whole shape of her, no cap, copy it exactly:

struct libie_ctlq_reg {
    void __iomem    *head;
    void __iomem    *tail;
    void __iomem    *len;
    void __iomem    *addr_high;
    void __iomem    *addr_low;
    u32 len_mask;
    u32 len_ena_mask;
    u32 head_mask;
 };

look at that alignment. the little }; at the end doing its own thing. we love a consistent queen 🎀

---

🦋 Members 🦋

okay so let's meet the cast, one by one, main character energy only:

• head — the controlq head register address ✨
• tail — the controlq tail register address 🎀
• len — the register address where you write the controlq length and the enable bit. two jobs, one register, she's booked and busy 💅
• addr_high — the register address to write the upper 32b of the ring physical address 👑
• addr_low — the register address to write the lower 32b of the ring physical address 🫶
• len_mask — the mask to read the controlq length 🔍
• len_ena_mask — the mask to write the controlq enable bit ⚡
• head_mask — the mask to read the head value 👀

note the pattern bestie: len_mask and head_mask are for reading, len_ena_mask is for writing. don't mix them up, that's the whole point of having them 😭

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr — go read these next:

• Kernel file ./include/linux/net/intel/libie/controlq.h enum
• libie_ctlq_type(9)
• struct libie_ctlq_ctx(9)
• struct libie_cp_dma_mem(9)
• struct libie_ctlq_msg(9)
• struct libie_ctlq_create_info(9)
• struct libie_ctlq_info(9)
• struct libie_ctlq_desc(9)
• struct libie_ctlq_clean_params(9)
• libie_ctlq_release_rx_buf(9)
• enum libie_ctlq_xn_state(9)
• struct libie_ctlq_xn(9)
• struct libie_ctlq_xn_manager(9)
• struct libie_ctlq_xn_send_params(9)
• libie_cp_can_send_onstack(9)
• struct libie_ctlq_xn_recv_params(9)
• struct libie_ctlq_xn_init_params(9)

that's a long list and every single one of them is a baddie, iykyk 💖

---

💜 sign-off 💜

and that's the page!! sourced from ./include/linux/net/intel/libie, dated October 2026, and yes the footer still says struct libie_ctlq_reg(9) because she knows exactly who she is 👑✨ go forth and register responsibly, bestie 🦋💖