UMAD_GET_PKEY(3)

πŸ“¦
version 65.0 Β· 2 versions
  • 65.0 Β· alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.3.10.2 Β· nixos 26.05, nixpkgs unstable
, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– UMAD_GET_PKEY πŸ’–

okay bestie, welcome to section 3 of the OpenIB Programmer's Manual β€” yes the OpenIB one, we're fancy here πŸ’… this is the page for umad_get_pkey, and it is so much shorter than you're expecting. a little snack. a lil treat. let's go πŸ¦‹


✨ NAME ✨

umad_get_pkey β€” grab the pkey index out of a umad buffer πŸŽ€


🌸 SYNOPSIS 🌸

#include <infiniband/umad.h>

int umad_get_pkey(void *umad);

like. that's the whole thing. no cap. 🌈


πŸ’œ DESCRIPTION πŸ’œ

so umad_get_pkey() does exactly one (1) job and it does it flawlessly, as it should: it gets the pkey index out of the umad buffer you hand it. that's it. that's the function. main character energy with zero side quests πŸ‘‘

you pass in umad β€” that's your void pointer to the buffer, bestie β€” and it goes and finds the pkey index for you. obsessed. ✨


⭐ RETURN VALUE ⭐

  • umad_get_pkey() returns the value of the pkey index πŸ’–
  • ...or it returns zero if the pkey index isn't supported by the user_mad interface 🫢
heads up girlypop: zero is doing double duty here. it's a legit return value and the "not supported" signal. so don't go assuming zero always means zero, iykyk 😭

πŸ‘‘ AUTHOR πŸ‘‘

this icon was written by Sasha Khapyorsky <sashak@voltaire.com> β€” say thank you πŸ’


and that's the whole page, fr fr. short, sweet, slays. 🌸

OpenIB Β· Jan 15, 2008 β€” yeah she's been iconic since 2008 and she's still serving πŸ’…πŸ’– bye bestie!! πŸ¦‹βœ¨

πŸ“¦ where this page comes from