STRUCT IONIC_QUEUE(9)

💅 struct ionic_queue(9) — Kernel API Manual 💅

okay so welcome to the struct ionic_queue(9) page, bestie. This is the Kernel API Manual entry, and it’s literally the ring buffer used between device and driver. no cap. ✨

🌸 NAME 🌸

struct ionic_queue — ring buffer used between device and driver. periodt. 💖

✨ SYNOPSIS ✨

Here’s the whole struct, copied exactly, no cap:

struct ionic_queue {
    size_t size;
    dma_addr_t dma;
    void *ptr;
    u16 prod;
    u16 cons;
    u16 mask;
    u8 depth_log2;
    u8 stride_log2;
    u64 dbell;
 };

🧚 Members 🧚

Every field is doing main-character work. let’s go 🫶

• size — size of the buffer, in bytes. lowkey just the byte count 💅
• dma — DMA address of the buffer. yes bestie, the dma address 🎀
• ptr — buffer virtual address. the virtual-address bestie ✨
• prod — driver position in the queue. driver’s spot, periodt 🔥
• cons — device position in the queue. device’s spot, iykyk 🦋
• mask — capacity of the queue, subtracting the hole. this value is equal to ((1 << depth_log2) - 1) 💀
• depth_log2 — log base two size depth of the queue. math girlie behavior 🌸
• stride_log2 — log base two size of an element in the queue. element-size log magic 🧚
• dbell — doorbell identifying bits. doorbell bits, iconic 👑

🔍 SEE ALSO 🔍

Kernel file: ./drivers/infiniband/hw/ionic/ionic_queue.h 📁

• ionic_queue_init(9)
• ionic_queue_destroy(9)
• ionic_queue_empty(9)
• ionic_queue_length(9)
• ionic_queue_length_remaining(9)
• ionic_queue_full(9)
• ionic_color_wrap(9)
• ionic_queue_at(9)
• ionic_queue_at_prod(9)
• ionic_queue_at_cons(9)
• ionic_queue_next(9)
• ionic_queue_produce(9)
• ionic_queue_consume(9)
• ionic_queue_consume_entries(9)
• ionic_queue_dbell_init(9)
• ionic_queue_dbell_val(9)

mwah 💋 from ./drivers/infiniband/hw/ionic, October 2026, struct ionic_queue(9) bestie forever 🫶