IBV_SET_ECE(3)

💅 IBV_SET_ECE — bestie, let's talk ECE

okay so real quick, this whole page is from the Libibverbs Programmer's Manual and it's literally about ibv_set_ece — the little verb that sets your ECE options and then actually uses them at the QP configuration stage. it's giving "set it and let the QP cook" ✨

✨ NAME ✨

ibv_set_ece — set ECE options and use them for QP configuration stage.

periodt, that's the whole vibe.

🦋 SYNOPSIS 🦋

#include <infiniband/verbs.h>

int ibv_set_ece(struct ibv_qp *qp, struct ibv_ece *ece);

🌸 DESCRIPTION 🌸

so ibv_set_ece() sets ECE options and uses them for the QP configuration stage. no cap, that's the job 💖

the desired ECE options get used during various modify QP stages, based on which options are supported in the relevant QP state. iykyk — it's state-dependent, bestie.

🎀 ARGUMENTS 🎀

• qp — the queue pair (QP) that's associated with the ECE options.

💜 ece Argument 💜

the requested ECE values. this is an IN/OUT field, which means the accepted options get returned right back in this same field. slay, bidirectional communication 🫶

struct ibv_ece {
    uint32_t vendor_id;
    uint32_t options;
    uint32_t comp_mask;
};

• vendor_id — unique identifier of the provider vendor on the network. providers set the IEEE OUI here so they can distinguish themselves in a non-homogenius network. iconic self-identification moment 👑
• options — provider specific attributes which are supported or needed to be enabled by ECE users.
• comp_mask — bitmask specifying what fields in the structure are valid.

🔥 RETURN VALUE 🔥

ibv_set_ece() returns 0 when the call was successful, or the errno value which indicates the failure reason. so 0 = we ate, anything else = something went sideways 😭

• EOPNOTSUPP — libibverbs or the provider driver doesn't support the ibv_set_ece() verb. literally not supported, don't come for it 💀
• EINVAL — in one of the following:
  • the QP is invalid.
  • the ECE options are invalid.

fr fr, check both before you blame the driver.

🌈 SEE ALSO 🌈

ibv_query_ece(3),

(yes, there's a trailing comma in the original, i don't make the rules 🎀)

👑 AUTHOR 👑

Leon Romanovsky <leonro@mellanox.com>

---

okay bestie that's the whole page, go forth and configure your QPs 💅✨

sign-off from the libibverbs era, dated 2020-01-22 — this manpage is literally a whole vibe, main character energy from start to finish 🦋💖