UMAD_SET_ADDR_NET(3)

✨ UMAD_SET_ADDR_NET(3) ✨

okay so bestie, we're in the OpenIB Programmer's Manual, section 3 — the library functions section, iykyk 💅 this one's called umad_set_addr_net and it's lowkey the network-order sibling of umad_set_addr. let's get into it 🫶

🌸 NAME 🌸

umad_set_addr_net — set MAD address fields within a umad buffer using network ordering 🦋

✨ SYNOPSIS ✨

#include <infiniband/umad.h>

int umad_set_addr_net(void *umad, __be16 dlid, __be32 dqp, int sl, __be32 qkey);

like, one function, five args, no drama 💖

💜 DESCRIPTION 💜

so umad_set_addr_net() goes into the umad buffer you hand it (that's the umad pointer, void *, very mysterious of it) and sets the MAD address fields, using the network ordered fields you pass in. no cap. 🌈

here's the tea on the arguments, bestie, don't skip this part:

• dlid — the destination LID. it's a __be16, so network ordering, keep up ✨
• dqp — the destination QP (queue pair). __be32, again network ordered 🎀
• sl — the SL (service level). just a plain int, she's built different 💅
• qkey — the Q_Key (queue key). __be32 💖

and yeah the whole point is that the fields are given in network ordering already — the _net in the name is literally telling you that. it's giving "I did the byte-swapping homework for you" energy 👑

🫶 RETURN VALUE 🫶

umad_set_addr_net() returns 0 on success 🎉 and a negative value on errors.

heads up: right now there are literally no errors indicated. like, currently none. so if you get a negative back… that's a whole situation, but the docs say there's nothing there yet 🙈

👑 SEE ALSO 👑

• umad_set_addr(3) — the host-ordering version, go say hi 💖

🧚 AUTHOR 🧚

Hal Rosenstock <halr@voltaire.com> — thank you for your service, legend 🌟

okay that's the whole page, bestie, you ate that 💅 this was the OpenIB manual page for UMAD_SET_ADDR_NET(3), dated May 21, 2007, and we're officially done. mwah 🎀💖✨