IBV_MODIFY_WQ(3)

💖 IBV_MODIFY_WQ 💖

okay bestie, we're in the Libibverbs Programmer's Manual and today's main character is ibv_modify_wq — the girl who changes up a Work Queue (WQ) when you ask her nicely. let's get into it 🎀

✨ NAME ✨

ibv_modify_wq — Modify a Work Queue (WQ).

🌸 SYNOPSIS 🌸

#include <infiniband/verbs.h>

struct int ibv_modify_wq(struct ibv_wq *wq,
                             struct ibv_wq_attr *wq_attr);

🦋 DESCRIPTION 🦋

so ibv_modify_wq() modifys a WQ wq. yes. modifys. that's the word. we're keeping it 💅

the argument wq_attr is an ibv_wq_attr struct, as defined in <infiniband/verbs.h>, and she looks like this:

struct ibv_wq_attr {
        uint32_t                attr_mask;     /* Use enum ibv_wq_attr_mask */
        enum ibv_wq_state       wq_state;      /* Move to this state */
        enum ibv_wq_state       curr_wq_state; /* Assume this is the current state */
        uint32_t                flags;         /* Flags values to modify, use enum ibv_wq_flags */
        uint32_t                flags_mask;    /* Which flags to modify, use enum ibv_wq_flags */
};

the function ibv_modify_wq() will modify the WQ based on the given wq_attr->attr_mask. that's it, that's the whole vibe. the mask is literally the blueprint — she does what the mask says and nothing else. no cap 🔥

💅 RETURN VALUE 💅

returns 0 on success, or the value of errno on failure (which indicates the failure reason). so if it's not 0, the universe is telling you why via errno. read her. she's not being mysterious on purpose 😭

👑 SEE ALSO 👑

• ibv_create_wq(3)
• ibv_destroy_wq(3)

🌈 AUTHORS 🌈

Yishai Hadas <yishaih@mellanox.com>

and that's the whole page, bestie 🫶 this lil icon of a manpage came to you courtesy of libibverbs, dated 2016-07-27 — old enough to be vintage, still slaying ✨ go modify some work queues, you've got this 💖