UMAD_GET_ISSM_PATH(3)

💖 UMAD_GET_ISSM_PATH(3) 💖

ok so bestie, we're in the OpenIB Programmer's Manual today and the vibe is issm device paths ✨ stay with me, it's literally so simple.

🌸 NAME 🌸

umad_get_issm_path — get path of issm device 🦋

✨ SYNOPSIS ✨

#include <infiniband/umad.h>

int umad_get_issm_path(char *ca_name, int portnum,char*path,intmax);

🎀 DESCRIPTION 🎀

okay so umad_get_issm_path() resolves the path to the issm device — and that's the device you use for setting/clearing the PortInfo:CapMask IsSM bit, iykyk 💅 — for the portnum of the IB device ca_name.

It stashes that resolved path into the path array, and path cannot exceed max bytes in length (that includes the NULL terminator, bestie, don't forget it 😭).

And here's the tea: opening the issm device sets the PortInfo:CapMask IsSM bit, and closing it clears it. periodt. 👑

🔥 RETURN VALUE 🔥

umad_open_port() returns 0 on success and a negative value on error, like this:

• -ENODEV — the IB device can't be resolved, it's giving nothing to work with 💀
• -EINVAL — the port is not valid (bad portnum or no umad device) 🙈

🌈 SEE ALSO 🌈

• umad_open_port(3)
• umad_get_port(3)

👑 AUTHOR 👑

Sasha Khapyorsky <sashak@voltaire.com> 🫶

OpenIB · Oct 18, 2007 — that's the whole page bestie, slay, go open that issm device and clear that bit, no cap 💖✨🎀