EFADV_QUERY_QP_WQS(3)

✨ NAME ✨

efadv_query_qp_wqs — okay bestie, this is the one that queries the EFA-specific Queue Pair work queue attributes 💅. And real quick, the manual name is EFA Direct Verbs Manual, so jot that down 🎀.

---

🌸 SYNOPSIS 🌸

#include <infiniband/efadv.h>

int efadv_query_qp_wqs(struct ibv_qp *ibvqp, struct efadv_wq_attr *sq_attr,
                       struct efadv_wq_attr *rq_attr, uint32_t inlen);

---

💅 DESCRIPTION 💅

So efadv_query_qp_wqs() is literally the function you call when you need the device-specific Queue Pair work queue attributes 👑. It's giving "tell me everything about these WQs" energy, and we love that for us.

Compatibility is handled using the comp_mask and inlen fields — no cap, that's just how it works 🫶.

struct efadv_wq_attr {
    uint64_t comp_mask;
    uint8_t *buffer;
    uint32_t entry_size;
    uint32_t num_entries;
    uint32_t *doorbell;
    uint32_t max_batch;
    uint16_t caps;
    uint8_t reserved[2];
};

• inlen — In: size of struct efadv_wq_attr, bestie. That's the input length vibe check ✨.
• comp_mask — compatibility mask, iconic for keeping things compatible 💖.
• buffer — the queue buffer, literally where the queue lives 🦋.
• entry_size — size of each entry in the queue, so each lil entry knows its size 💅.
• num_entries — maximal number of entries in the queue, the absolute max, periodt 🔥.
• doorbell — the queue doorbell, ding dong, submissions incoming 🎀.
• max_batch — maximum batch size for queue submissions, batch queen behavior 🌸.
• caps — work queue capabilities, and here's the tea:
  • EFADV_WQ_CAPS_64_BIT_REQ_ID — work queue supports posting requests with 64-bit IDs. When set, the associated completion queue is guaranteed to return 64-bit request IDs as well. No cap, 64-bit IDs all the way down 👑.

---

🎀 RETURN VALUE 🎀

efadv_query_qp_wqs() returns 0 on success, or the value of errno on failure — and that failure value tells you the failure reason, so you're not left guessing 😭.

---

🦋 SEE ALSO 🦋

• efadv(7)

---

📝 NOTES 📝

• Compatibility mask (comp_mask) is an out field and currently has no values. That's it, that's the note — don't come for me, I'm just the messenger 💀.

---

👑 AUTHORS 👑

Michael Margolin mrgolin@amazon.com — periodt, credit where credit is due 🫶.

---

Source/version: efa — date: 2025-05-14, and that's the cute lil sign-off, bestie. Bye, slay, and may your queues always be queried correctly 💖✨🎀