UMAD_UNREGISTER(3)

💖 UMAD_UNREGISTER — bestie edition 💖

okay so this is umad_unregister, from the OpenIB Programmer's Manual, section 3. it's the lil cleanup babe of the umad world. we're unregistering an agent. that's the whole vibe. ✨

✨ NAME ✨

umad_unregister — unregister a umad agent, aka the goodbye girl 💅

🌸 SYNOPSIS 🌸

#include <infiniband/umad.h>

int umad_unregister(int portid, int agentid);

like. two ints. in. one int out. so demure. 🎀

🦋 DESCRIPTION 🦋

so umad_unregister() unregisters the agent you specify with agentid, and bestie, that agentid has to be one you previously registered — either with umad_register() or with umad_register_oui(). no drive-by unregistering. it has to be YOUR agent. main character only. 👑

think of it as closing the tab. you opened it, you get to close it. no cap. 🫶

🔥 RETURN VALUE 🔥

umad_unregister() returns 0 on success — iconic, we love a clean exit — and a negative value on error, like this:

• -EINVAL — invalid port handle or agentid 😭 the vibes were off, something you passed in wasn't it
• * — (kernel error codes) 👀 yeah, the kernel has OPINIONS and it will let you know

ngl if you get a negative number back, that's your sign. check your portid and your agentid before you blame anyone else. fr fr. 💀

💜 SEE ALSO 💜

• umad_register(3)
• umad_register_oui(3)

the whole friend group. go read them. iykyk. 🌈

👑 AUTHOR 👑

Hal Rosenstock <halr@voltaire.com> — the legend, the blueprint, the origin story. 💖

and that's the tea, bestie 🍓 this page is from the OpenIB crew, dated May 21, 2007, and it's literally a classic. now go unregister something responsibly. slay. ✨💅🦋