RDMA-SYSTEM(8)

📦
version 7.3.0 · 4 versions
, in alpine 3.24, arch rolling, centos-stream 10, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 RDMA-SYSTEM(8) — the rdma-system girlies' guide 💖

okay so bestie, welcome to the RDMA-SYSTEM(8) manual page, she's a Linux one, and she's literally all about RDMA subsystem configuration 👑 no cap.

✨ NAME ✨

rdma-system — RDMA subsystem configuration. that's it, that's the whole vibe 🦋

🌸 SYNOPSIS 🌸

rdma [ OPTIONS ] sys  { COMMAND | help }

OPTIONS := { -V[ersion] | -d[etails] }

rdma system show

rdma system set netns NEWMODE

rdma system set privileged-qkey NEWSTATE

rdma system help

🎀 DESCRIPTION 🎀

💅 rdma system set — set RDMA subsystem network namespace mode or privileged qkey mode

🌈 rdma system show — display RDMA subsystem network namespace mode, privileged qkey state and whether RDMA monitoring is supported

okay so now the details, because this is the part where you actually need to pay attention, bestie 🫶

NEWMODE — this one specifies the RDMA subsystem mode. it's either exclusive or shared. when a user wants to assign a dedicated RDMA device to a particular network namespace, exclusive mode should be set before creating any network namespace. and here's the tea ☕: if there are active network namespaces and if one or more RDMA devices exist, changing mode from shared to exclusive returns error code EBUSY. so yeah, that's gonna fail on you, plan accordingly 😭

when the RDMA subsystem is in shared mode, the RDMA device is accessible in all network namespaces. so when you don't need RDMA device isolation among multiple network namespaces, shared mode can be used. it's giving "we all share, we're all besties" energy ✨

it is preferred to not change the subsystem mode when there is active RDMA traffic running, even though it is supported. like, you can, but... girl. don't. 🙈

NEWSTATE — specifies the new state of the privileged-qkey parameter, either on or off. this parameter determines whether a non-privileged user is allowed to specify a controlled QKEY or not. periodt. 💅

🔥 EXAMPLES 🔥

  • rdma system show shows the state of RDMA subsystem network namespace mode on the system, the state of the privileged qkey parameter and whether RDMA monitor is supported. the whole status check, one command, iconic ⭐
  • rdma system set netns exclusive sets the RDMA subsystem in network namespace exclusive mode. in this mode RDMA devices are visible only in single network namespace. it's giving main character only, no sharing 👑
  • rdma system set netns shared sets the RDMA subsystem in network namespace shared mode. in this mode RDMA devices are shared among network namespaces. communal slay 💖
  • rdma system set privileged-qkey on sets the privileged-qkey parameter to on. in this state non-privileged user is allowed to specify a controlled QKEY 🎉
  • rdma system set privileged-qkey off sets the privileged-qkey parameter to off. in this state non-privileged user is not allowed to specify a controlled QKEY. sorry babe, locked down 🔒

💜 SEE ALSO 💜

rdma(8), rdma-link(8), rdma-resource(8), rdma-monitor(8), network_namespaces(7), namespaces(7), — go read those next, bestie, they're all part of the same little friend group 🧚

👑 AUTHOR 👑

Parav Pandit <parav@mellanox.com> — thank you for your service, king 🫡

and that's the whole page, bestie!! this one came from iproute2, dated 06 Jul 2017, and it lives in the RDMA-SYSTEM(8) section of the manual. go forth and configure those RDMA subsystems responsibly, mwah 💋🌸

📦 where this page comes from