UMAD_POLL(3)

✨ UMAD_POLL(3) ✨

okay so bestie, welcome to the OpenIB Programmer's Manual 💖 this one's called umad_poll and it's literally just about waiting for packets like a patient little icon. let's go 🦋

🌸 NAME 🌸

umad_poll — poll umad. that's it, that's the whole vibe 💅

🎀 SYNOPSIS 🎀

#include <infiniband/umad.h>

int umad_poll(int portid, int timeout_ms);

💜 DESCRIPTION 💜

so umad_poll() sits there and waits up to timeout_ms milliseconds for a packet to be received from the port specified by portid. the way it just... chills there waiting? main character energy fr fr 🫶

once a packet is ready to be read, the function returns 0. and after that? you can read the packet using umad_recv(). slay ✨

otherwise, you get -ETIMEDOUT back. sad but fair 😭

⚠️ okay this is important so listen up: successfully polling a port does not guarantee that the subsequent umad_recv() will be non blocking when several threads are using the same port. like, don't count on it bestie, that's not how it works 🙈 instead, use a timeout_ms parameter of zero to umad_recv() to ensure a non-blocking read. periodt 💅

🔥 RETURN VALUE 🔥

umad_poll() returns 0 on success, and a negative value on error as follows:

• -EINVAL — invalid port handle or agentid. not a real one, bestie 💀
• -ETIMEDOUT — poll operation timed out. you waited, it didn't come, it's giving ghosting 👻
• -EIO — poll operation failed. it's giving chaos 😭

🌈 SEE ALSO 🌈

umad_recv(3)

👑 AUTHOR 👑

Hal Rosenstock <halr@voltaire.com> — an actual legend, no cap 🫡

and that's the whole page, bestie!! go forth and poll responsibly 💖✨🦋🌸🎀💅

this was brought to you by the OpenIB crew, from the October 23, 2007 era — yes she's vintage and yes she still eats 🎀✨