rpcctl(8)

📦
version 3.1.1 · 3 versions
, in arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💅 rpcctl(8) — the SunRPC connection info page, bestie edition ✨

okay so you found yourself at rpcctl(8) from the System Manager's Manual section — congrats, you're in the right place, this is literally the whole vibe 🦋

✨ NAME ✨

rpcctl — Displays SunRPC connection information 💖

🌸 SYNOPSIS 🌸

rpcctl [ -h | --help ] { client | switch | xprt }

rpcctl client [ -h | --help ] { show }
rpcctl client show [ -h  --help ] [ XPRT ]

rpcctl switch [ -h | --help ] { set | show }
rpcctl switch add-xprt [ -h | --help ] [ SWITCH ]
rpcctl switch set [ -h | --help ] SWITCH dstaddr NEWADDR
rpcctl switch show [ -h | --help ] [ SWITCH ]

rpcctl xprt [ -h | --help ] { remove | set | show }
rpcctl xprt remove [ -h | --help ] XPRT
rpcctl xprt set [ -h | --help ] XPRT { dstaddr NEWADDR | offline | online }
rpcctl xprt show [ -h | --help ] [ XPRT ]

🎀 DESCRIPTION 🎀

The rpcctl command displays information collected in the SunRPC sysfs files about the system's SunRPC objects. it's giving "your kernel has receipts and we're reading them" 💅

🦋 rpcctl client — Commands operating on RPC clients

  • show [ CLIENT ] (default) — Show detailed information about the RPC clients on this system. If CLIENT was provided, then only show information about a single RPC client. one at a time? obsessed with the focus ✨

💜 rpcctl switch — Commands operating on groups of transports

  • add-xprt SWITCH — Add an additional transport to the SWITCH. Note that the new transport will take its values from the "main" transport. it's literally copying the main character's whole fit, no cap 🫶
  • set SWITCH dstaddr NEWADDR — Change the destination address of all transports in the SWITCH to NEWADDR. NEWADDR can be an IP address, DNS name, or anything else resolvable by gethostbyname(3).
  • show [ SWITCH ] (default) — Show detailed information about groups of transports on this system. If SWITCH was provided, then only show information about a single transport group.

🌈 rpcctl xprt — Commands operating on individual transports

  • remove XPRT — Removes the specified XPRT from the system. Note that "main" transports cannot be removed. like, main transports are not getting voted off the island, periodt 💀
  • set XPRT dstaddr NEWADDR — Change the destination address of the specified XPRT to NEWADDR. NEWADDR can be an IP address, DNS name, or anything else resolvable by gethostbyname(3).
  • set XPRT offline — Sets the specified XPRT's state to offline. bestie is taking a nap 😴
  • set XPRT online — Sets the specified XPRT's state to online. she's back and she ate 🔥
  • show [ XPRT ] (default) — Show detailed information about this system's transports. If XPRT was provided, then only show information about a single transport.

🍓 EXAMPLES 🍓

real ones need examples, so here you go, no gatekeeping 💖

rpcctl switch show switch-2

Show details about the RPC switch named "switch-2".

rpcctl xprt remove xprt-4

Remove the xprt named "xprt-4" from the system.

rpcctl xprt set xprt-3 dstaddr https://linux-nfs.org

Change the dstaddr of the xprt named "xprt-3" to point to linux-nfs.org. glow up via DNS, we love to see it 🌈

🧚 DIRECTORY 🧚

/sys/kernel/sunrpc/

that's the spot. that's where the lore lives 🎀

👑 AUTHOR 👑

Anna Schumaker <Anna.Schumaker@Netapp.com> 💜

⭐ heads up bestie: this page is from the System Manager's Manual, so it's the 8 section — admin territory, main character energy only 💅

15 Feb 2022 — rpcctl(8). that's the whole page, dated and titled and everything. go forth and inspect your transports, you absolute icon 🦋✨

📦 where this page comes from