UMAD_OPEN_PORT(3)

💖 UMAD_OPEN_PORT(3) — the OpenIB Programmer's Manual, but make it cute 💖

okay bestie, so this one's a little chaotic because the page is literally titled UMAD_OPEN_PORT(3) but the actual star of the show is umad_close_port()?? iconic mismatch energy, we love a plot twist 🫶 anyway it lives in the OpenIB Programmer's Manual and it's all about saying bye-bye to an InfiniBand device port. let's get into it ✨

🌸 NAME 🌸

umad_close_port — close an InfiniBand device port so it's no longer open for umad access. it's giving "closing time, you don't gotta go home but you gotta get out of here" 💅

✨ SYNOPSIS ✨

#include <infiniband/umad.h>

int umad_close_port(int portid);

🦋 DESCRIPTION 🦋

so like, umad_close_port() closes the port that the handle portid is pointing at. that's it. that's the whole vibe. you hand it a portid, it closes that port, no cap 💖

🎀 RETURN VALUE 🎀

umad_close_port() returns 0 when everything slays, and a negative value when it does not 😭

specifically, -EINVAL gets returned if portid is not a handle to a valid (open) port. so basically if you're passing it something that isn't an actually-open port handle, it's gonna look at you like ??? and hand you that error. check your handles, bestie, fr fr 🙈

👑 SEE ALSO 👑

• umad_open_port(3) — yes, the one you probably wanted, the ✨ opening ✨ counterpart. yin and yang. balance. main character energy.

💜 AUTHOR 💜

Hal Rosenstock <halr@voltaire.com> — the legend who wrote this 🫶

and that's the whole page, bestie!! this cutie came from the OpenIB crew, dated May 11, 2007, and it's filed under UMAD_OPEN_PORT(3) (yes, still that name, we're not gonna talk about it 💀). go forth and close your ports responsibly 💅✨🌈