rpcdebug(8)

💅 rpcdebug — set and clear NFS and RPC kernel debug flags ✨

okay bestie, welcome to rpcdebug, the <pink>System Manager's Manual</pink> girlie who lives in section 8 of your man pages. she's a whole vibe and she's here to turn your Linux kernel's NFS debug chatter on and off. 🎀

🌸 SYNOPSIS 🌸

rpcdebug -vh
rpcdebug -m module
rpcdebug -m module -s flags...
rpcdebug -m module -c flags...

✨ DESCRIPTION ✨

so like. rpcdebug is the command that lets an administrator <purple>set and clear</purple> the Linux kernel's NFS client and server debug flags. when you set these flags, the kernel starts <hotpink>emitting messages to the system log</hotpink> every time NFS activity happens. and that is literally so useful when you're out here debugging NFS problems, no cap. 💖

now let's vibe check the four forms in the synopsis, because they each do a different thing:

1. the first form lists out <mint>all the available debug flags</mint>. every single one. she's showing you the menu. 👑
2. the second form shows you the debug flags that are <cyan>currently set</cyan> for the module you picked. like, what's already turned on rn.
3. the third form <green>sets</green> one or more flags. turning things ON, we love to see it.
4. the fourth form <red>clears</red> one or more flags. turning things OFF. also valid.

and bestie, quick note: the value all can be used to set or clear <rainbow>all the flags</rainbow> for whatever module you're working with. one word, all the flags. iconic. periodt. 🦋

💅 OPTIONS 💅

• -c — Clear the given debug flags. bye bye flags 💀
• -h — Print a help message and exit. and if you pair it with the -v option, it also prints out the available debug flags. so -vh is a little combo meal 🍓
• -m module — Specify which module's flags to set or clear. the available modules are:
  • nfsd — The NFS server.
  • nfs — The NFS client.
  • nlm — The Network Lock Manager, in either an NFS client or server.
  • rpc — The Remote Procedure Call module, in either an NFS client or server.
• -s — Set the given debug flags. turning it UP 🔥
• -v — Increase the verbosity of rpcdebug's output. she talks more. we love a chatty queen 💜

🎀 FILES 🎀

• /proc/sys/sunrpc/{rpc,nfs,nfsd,nlm}_debug — procfs-based interface to kernel debug flags. this is where the magic actually lives, iykyk 🌈

👑 SEE ALSO 👑

rpc.nfsd(8), nfs(5), syslogd(8).

😭 BUGS 😭

Bugs can be found or reported at http://nfs.sf.net/. if you find one, tell the girlies, don't suffer in silence fr fr 🙈

🫶 AUTHOR 🫶

Program by Olaf Kirch <okir@suse.de> and <frederic.jolly@bull.ext.net>. Manpage by Greg Banks <gnb@melbourne.sgi.com>. absolute legends, all three of them ⭐

and that's the whole page bestie!! this little cutie came straight out of the <lavender>System Manager's Manual</lavender> as rpcdebug(8), dated <peach>5 Jul 2006</peach>. old but gold, and she still slays. mwah 💖✨