IBV_QUERY_ECE(3)

💅 IBV_QUERY_ECE(3) 💅

ok so this is a page from the Libibverbs Programmer's Manual, and honestly? it's a lil cutie. let's get into it bestie 🫶

✨ NAME ✨

ibv_query_ece — query ECE options. that's it, that's the vibe 💅

✨ SYNOPSIS ✨

#include <infiniband/verbs.h>

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

✨ DESCRIPTION ✨

okay so ibv_query_ece() queries the ECE options. simple as that, no cap 🌸

what it does is hand you back the current ECE state for the QP. like, right now, as it stands. current. present tense. main character energy ✨

✨ ARGUMENTS ✨

• qp — the queue pair (QP) that's associated with these ECE options. the QP in question, if you will 💖

🎀 ece Argument 🎀

this one is the ECE values themselves. the actual data. the goods 📦

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

• vendor_id — the unique identifier of the provider vendor on the network. the providers will set the IEEE OUI here so they can distinguish themselves in a non-homogenius network. yep, that's the whole point of it 🦋 (heads up: the original page really does spell it "non-ho‐mogenius", so that's the word we're going with, iykyk)
• options — provider specific attributes which are supported. every provider's got their own lil set of extras and this is where they live 🌈
• comp_mask — bitmask specifying what fields in the structure are valid. basically the "which of these actually mean something rn" flag 🔥

✨ RETURN VALUE ✨

ibv_query_ece() returns 0 when the call was successful 😌🎀 or, if things went sideways, the errno value which indicates the failure reason 😭

• EOPNOTSUPP — libibverbs or the provider driver doesn't support the ibv_set_ece() verb. not supported, not happening, not today 💀
• EINVAL — happens in one of the following cases:
  • the QP is invalid 🙈
  • the ECE options are invalid 🙈

✨ SEE ALSO ✨

ibv_set_ece(3)

✨ AUTHOR ✨

Leon Romanovsky <leonro@mellanox.com> 👑

---

and that's the whole page babes 💜 this one's from libibverbs, dated 2020-01-22 — go forth and query those ECE options, you absolute icon 🌟