nfsstat(8)

💖 nfsstat(8) — like, your NFS receipts, bestie 💖

okay so this is nfsstat, a lil system manager's manual situation (that's the manual name btw, section 8, we stan a sysadmin classic) 🎀

✨ NAME ✨

nfsstat — list NFS statistics 🦋

✨ SYNOPSIS ✨

nfsstat [OPTION]...

✨ DESCRIPTION ✨

so basically, nfsstat displays statistics kept about NFS client and server activity. it's giving ✨receipts✨. no cap, it just shows you the numbers. 💅

✨ OPTIONS ✨

• -s, --server — print only server-side statistics. the default is to print both server and client statistics. you're picking a side, periodt. 👑
• -c, --client — print only client-side statistics. the other side of the situationship. 🫶
• -n, --nfs — print only NFS statistics. the default is to print both NFS and RPC information. keep it NFS-only, mind your business, slay. ✨
• -2 — print only NFS v2 statistics. the default is to only print information about the versions of NFS that have non-zero counts. v2 is so vintage of it, lowkey iconic. 🎀
• -3 — print only NFS v3 statistics. the default is to only print information about the versions of NFS that have non-zero counts. 🔥
• -4 — print only NFS v4 statistics. the default is to only print information about the versions of NFS that have non-zero counts. the main character version fr fr. 💅
• -m, --mounts — print information about each of the mounted NFS file systems.

⚠️ heads up bestie: if this option is used, all other options are ignored. she does NOT share the spotlight. 🚨

• -r, --rpc — print only RPC statistics. 🌸
• -o facility — display statistics for the specified facility, which must be one of:
  • nfs — NFS protocol information, split up by RPC call. 🦋
  • rpc — general RPC information.
  • net — network layer statistics, such as the number of received packets, number of TCP connections, etc. 🌈
  • fh — usage information on the server's file handle cache, including the total number of lookups, and the number of hits and misses. ✨
  • rc — usage information on the server's request reply cache, including the total number of lookups, and the number of hits and misses.
  • io — usage information on the server's io statistics; bytes read and written. 📖
  • ra — usage information on the server's read ahead cache, including the ra cache size, the depth of ra cache hits, and ra cache misses. 🧚
  • all — display all of the above facilities. the whole buffet, eat up. 🍓
• -v, --verbose — this is equivalent to -o all. same vibe, shorter name. 💜
• -l, --list — print information in list form. 📝
• -S, --since file — instead of printing current statistics, nfsstat imports statistics from file and displays the difference between those and the current statistics. valid input files may be in the form of /proc/net/rpc/nfs (raw client stats), /proc/net/rpc/nfsd (raw server stats), or saved output from nfsstat itself (client and/or server stats). any statistics missing from a saved nfsstat output file are treated as zeroes. it's giving "compare me to my past self" energy. 🪞
• -Z[interval], --sleep=[interval] — instead of printing current statistics and immediately exiting, nfsstat takes a snapshot of the current statistics and pauses until it receives SIGINT (typically from Ctrl-C), at which point it takes another snapshot and displays the difference between the two. if interval is specified, nfsstat will print the number of NFS calls made since the previous report. stats will be printed repeatedly every interval seconds. literally the "wait for it… wait for it… ok now" option. 😭

✨ EXAMPLES ✨

nfsstat -o all -234

show all information about all versions of NFS. 💅

nfsstat --verbose -234

same as above. 🫶

nfsstat -o all

show all information about active versions of NFS. ✨

nfsstat --nfs --server -3

show statistics for NFS version 3 server. 👑

nfsstat -m

show information about mounted NFS filesystems. 🦋

✨ DISPLAY ✨

the Flags output from the -m option is the same as the flags give to the mount command. (yes, "give", that's what the page says, we don't edit the source material bestie, we just vibe with it 💀)

✨ FILES ✨

• /proc/net/rpc/nfsd — procfs-based interface to kernel NFS server statistics. 🌸
• /proc/net/rpc/nfs — procfs-based interface to kernel NFS client statistics. 🌸
• /proc/mounts — procfs-based interface to the mounted filesystems. 🌸

✨ SEE ALSO ✨

rpc.nfsd(8). nfs(5). go read those too, iykyk 🎀

✨ BUGS ✨

🚨 bug alert, bestie, read carefully:

the default output has been changed. to get the old default output you must run nfsstat --auto -2.

the function of the -v and -a options have changed. the -a option is now reserved for future use. the -v does what the -a option used to do, and the new -[234] options replace the -v option.

the Display section should be more complete. (they said it, not me 😭)

further bugs can be found or reported at http://nfs.sf.net/. 📮

✨ AUTHOR ✨

Olaf Kirch, <okir@suse.de> — legend behavior, we love to see it. 👑

okay that's the whole thing, bestie, you're officially nfsstat-literate 💖 this manual page is nfsstat(8) from the System Manager's Manual, dated 7 Aug 2007 — and that's the whole footer, so consider this your cute sign-off. mwah. 💅✨🎀