UMAD_REGISTER_OUI(3)

💖 umad_register_oui — bestie's guide to the OpenIB Programmer's Manual ✨

okay so like, welcome to umad_register_oui(3) from the OpenIB Programmer's Manual 🎀 — this is the one where you slide into vendor range 2 and claim your class for a port. let's get into it fr fr 💅

✨ NAME ✨

umad_register_oui — register the specified class in vendor range 2 for port 🦋

🌸 SYNOPSIS 🌸

#include <infiniband/umad.h>

int umad_register_oui(int portid, int mgmt_class, uint8_t rmpp_version, uint8_t oui[3], uint32_t method_mask[4]);

💜 DESCRIPTION 💜

okay bestie, here's the vibe: umad_register_oui() registers the specified class in vendor range 2, plus the specified oui, plus whether RMPP is being used — all for the port that the portid handle points at. it's giving "this port is MINE and here's my paperwork" 📋✨

now here's the part you actually need to clock:

• if the method_mask array is provided, the caller gets registered as a replier (aka a server 👑) for the methods whose corresponding bit is turned on in the method_mask.
• if method_mask is NULL, the caller gets registered as a MAD client instead — which lowkey means it can only receive replies on MADs that it sent itself, aka the solicited MADs 🙈

so like, server mode or client mode, pick your fighter 🥊

⭐ RETURN VALUE ⭐

umad_register() returns a non-negative agent id number on success 🎉 and a negative value on error, like this:

• -EINVAL — invalid port handle, or the class is not in the vendor class 2 range 💀
• -EPERM — registration failed 😭

🦋 SEE ALSO 🦋

• umad_register(3)
• umad_unregister(3)

👑 AUTHOR 👑

Hal Rosenstock <halr@voltaire.com>

and that's the whole page, bestie!! this lil icon was brought to you by the OpenIB crew, dated May 17, 2007 — so yes, it's an elder but it still ate 💅✨ go register something slay, and remember: method_mask on = server energy, method_mask NULL = client energy, no cap 🫶