STRUCT NITROX_CMDQ(9)

💖 struct nitrox_cmdq(9) 💖

okay bestie, welcome to the Kernel API Manual ✨ — today's main character is struct nitrox_cmdq, aka the NITROX command queue. she's got locks, she's got DMA addresses, she's got a whole little backlog situation going on. let's get into it 🎀

---

🌸 NAME 🌸

struct nitrox_cmdq — the NITROX command queue, no cap 💅

---

✨ SYNOPSIS ✨

struct nitrox_cmdq {
    spinlock_t cmd_qlock;
    spinlock_t resp_qlock;
    spinlock_t backlog_qlock;
    struct nitrox_device *ndev;
    struct list_head response_head;
    struct list_head backlog_head;
    u8 __iomem *dbell_csr_addr;
    u8 __iomem *compl_cnt_csr_addr;
    u8 *base;
    dma_addr_t dma;
    struct work_struct backlog_qflush;
    atomic_t pending_count;
    atomic_t backlog_count;
    int write_idx;
    u8 instr_size;
    u8 qno;
    u32 qsize;
    u8 *unalign_base;
    dma_addr_t unalign_dma;
};

like, look at her. every field is doing something. we love a structured queen 👑

---

🦋 Members 🦋

okay so here's the member-by-member vibe check, and yes, we're doing all of them 💖

• cmd_qlock — the command queue lock. she's holding it down 🔒
• resp_qlock — the response queue lock. separate lock, separate energy ✨
• backlog_qlock — the backlog queue lock. the third lock, because three locks is iconic 💅
• ndev — the NITROX device. the parent, the icon, the moment 🫶
• response_head — the submitted request list. everything that's been sent out lives here 📋
• backlog_head — the backlog queue. the waiting room, lowkey 😭
• dbell_csr_addr — doorbell register address for this queue. ding dong, the queue is calling 🔔
• compl_cnt_csr_addr — completion count register address of the slc port. counting completions, fr fr 🔥
• base — command queue base address. home base, literally 🏠
• dma — dma address of the base. her mailing address in DMA-land 📬
• pending_count — request pending at device. the "still cooking" counter ⏳
• backlog_count — backlog request count. how much is piled up in the waiting room 🙈
• write_idx — next write index for the command. know where you're writing, bestie ✍️
• instr_size — command size. size matters (for commands) 📏
• qno — command queue number. her little ID badge 🎫
• qsize — command queue size. big queue energy 🌈
• unalign_base — unaligned base address. not aligned, still thriving 💀
• unalign_dma — unaligned dma address. the unaligned one's DMA twin, matching outfits 👯

not me listing all eighteen members with full commitment 💅 but also like... you gotta know your fields, bestie.

---

👑 SEE ALSO 👑

Kernel file ./drivers/crypto/cavium/nitrox/nitrox_dev.h struct nitrox_hw(9), struct nitrox_iov(9), struct nitrox_device(9), nitrox_read_csr(9), nitrox_write_csr(9)

go read those next, iykyk 📚✨

---

aaaand that's the page 🎀 this came to you from ./drivers/crypto/cavium/nitrox, dated October 2026, titled struct nitrox_cmdq(9) — mwah, slay, periodt 💋💖