UMAD_REGISTER(3)

💖 UMAD_REGISTER 💖

okay bestie, welcome to the umad_register page from the OpenIB Programmer's Manual — yes, that OpenIB, the one that lives in your 3 section and is about to make your whole MAD game make sense ✨

🌸 NAME 🌸

umad_register — registering the specified management class and version for a port, periodt 💅

🦋 SYNOPSIS 🦋

#include <infiniband/umad.h>

int umad_register(int portid, int mgmt_class, int mgmt_version , uint8_t rmpp_version, long method_mask[16/sizeof(long)]);

like. look at that signature. she's giving exactly what she needs to give 🫶

✨ DESCRIPTION ✨

so here's the tea, bestie 🍓

umad_register() registers the management class you picked, the management version you picked, and whether RMPP is being used — all for the port that the portid parameter is pointing at. literally all in one call, we love a multitasker 👑

now, the method_mask array is where the plot thickens:

• if you do pass in a method_mask array, you get registered as a replier (server) for every method that has its corresponding bit turned on in that method_mask. iconic. main character energy.
• if method_mask is NULL, you get registered as a MAD client instead, which means the only MADs you'll ever receive are replies to the MADs you sent — aka solicited MADs. no unsolicited drop-ins in your DMs, ngl 🙈

💀 RETURN VALUE 💀

on success, umad_register() hands you back a non-negative agent id number 🎀 (yes, an actual id, she came through).

on error, you get a negative value, and it means one of these:

• -EINVAL — invalid port handle 😭
• -EPERM — registration failed 💔

fr fr, check your return value. a negative number here is not a vibe.

👑 SEE ALSO 👑

• umad_register_oui(3)
• umad_unregister(3)

iykyk, go read them next 💜

🌈 AUTHOR 🌈

Hal Rosenstock <halr@voltaire.com> — we stan a legend 🫶✨

and that's the whole page, bestie!! this one came straight outta the OpenIB crew, dated May 11, 2007, and it's filed under UMAD_REGISTER(3) in your manual — go forth and register responsibly 💅🌸💖