NFSSTAT(1)

πŸ“¦
version 15.1 Β· 2 versions
, in freebsd 15.1

πŸ’… nfsstat(1) β€” the NFS tea-spiller

Okay bestie, so this is a page from the General Commands Manual (section 1, commands, you know the vibe) and it's all about nfsstat, the little icon that spills the stats. Buckle up πŸŽ€


✨ NAME ✨

nfsstat β€” display NFS statistics πŸ’– like, it literally shows you the NFS numbers


πŸ¦‹ SYNOPSIS πŸ¦‹

nfsstat [--libxo] [-cdEemqszW] [-w wait]

That's it. That's the whole summoning ritual. ✨


🌸 DESCRIPTION 🌸

The nfsstat command displays statistics kept about NFS client and server activity. No cap, that's the whole job and it does it well πŸ’…

Okay but here's a detail that matters, bestie β€” for the NFSv4 server, the statistics are for operations within the Compound RPCs, not the count of RPCs. So if you ever wanna compare RPC counts between NFSv3 and NFSv4, you gotta use statistics in the client(s). That's the rule, iykyk πŸ”₯

The options are as follows:

  • -c β€” Only display client side statistics. Client girlies only πŸ™ˆ
  • -d β€” Display statistics for the NFS server that are similar to those displayed by iostat(8). This includes kilobytes per transfer, transfers per second, and megabytes per second for read, write, and all operations. It also includes the current queue depth, the busy percentage, and latency for all operations. And if you add the -W flag, commits per second, commit latency, read latency, and write latency are also added to the display. ✨
🚨 Real talk: the busy percentage shown can exceed 100 at times. This is because of the way busy percentages are calculated. The busy time is calculated by adding the elapsed time between the last time an operation started or finished, and the current time. If there is only one operation outstanding, the "busy time" time will get updated with the total time of that operation. That means that the difference in the busy time between the two measurement intervals (often 1 second) will increase by more than the measurement interval. So yeah, >100% is a feature not a bug, don't come for it πŸ’€
  • -e β€” Report the extra statistics collected by the NFS client and server for NFSv4. Extra! ✨
  • -E β€” Similar to -e except that the statistics include NFSv4.1 and NFSv4.2 and the numbers aren't clipped at one billion. Glow-up version fr fr. Only one of -e or -E can be specified β€” pick one, bestie, you can't have both πŸ‘‘
  • -M β€” Deprecated and ignored. It's giving ghost of options past πŸ‘»
  • -m β€” Report the mount options for all NFS client mounts. This option overrides all others and nfsstat will exit after completing the report. Main character energy β€” it does NOT share the spotlight πŸŽ€
  • -N β€” Deprecated and ignored. Also a ghostie πŸ‘»
  • -s β€” Only display server side statistics. Server girlies rise πŸ™Œ
  • -W β€” Use wide format with interval short summary. This option is especially useful when combined with -c, -d, or -s and a time delay. Wide format is the lewk πŸ’…
  • -w wait β€” Display a shorter summary of NFS activity for both the client and server at wait second intervals. It's a lil loop, a lil rhythm 🩰
  • -z β€” Reset statistics after displaying them. Clean slate era ✨
  • -q β€” Do not print headers. Minimalist. Quiet luxury πŸŽ€
  • --libxo β€” Generate output via libxo(3) in a selection of different human and machine readable formats. See xo_options(7) for details on command line arguments. Machine readable?? Obsessed πŸ€–πŸ’–

🌈 SEE ALSO 🌈

fstat(1), netstat(1), ps(1), systat(1), sysctl(3), iostat(8), nfsdumpstate(8), pstat(8), vmstat(8)

The whole squad, fr fr 🫢


πŸ‘‘ HISTORY πŸ‘‘

The nfsstat command appeared in 4.4BSD. Vintage. Iconic. A legend that simply never left 🧚


That's the whole page, bestie β€” mwah πŸ’‹ this one came from the Debian build, dated July 16, 2025. Go forth and stat your NFS πŸ’œπŸ“

πŸ“¦ where this page comes from
  • freebsd 15.1: base 15.1
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms