mountstats(8)

πŸ’– mountstats β€” the manual, but make it make sense πŸ’–

okay so bestie, you know how your NFS mounts are just... there? living their lives? doing RPCs?? this page is literally the mountstats(8) manual from the System Manager's Manual and i'm about to make it delicious. πŸ¦‹


✨ NAME ✨

mountstats β€” displays various NFS client per-mount statistics πŸ’…


🌸 SYNOPSIS 🌸

mountstats [-h|--help] [-v|--version] [-f|--file infile] [-S|--since
sincefile] [ [-n|--nfs] | [-r|--rpc] | [-R|--raw] | [-x|--xprt] ]
[mountpoint]...

mountstats iostat [-h|--help] [-v|--version] [-f|--file infile]
[-S|--since sincefile] [interval] [count] [mountpoint]...

mountstats nfsstat [-h|--help] [-v|--version] [-f|--file infile]
[-S|--since sincefile] [-3] [-4] [mountpoint]...

πŸ‘‘ DESCRIPTION πŸ‘‘

The mountstats command displays various NFS client statistics for each given mountpoint. πŸ“

And if you don't hand it a mountpoint at all? No stress. It'll show stats for all the NFS mountpoints on the client. every single one. it's giving overachiever. 😌✨

🧚 Sub-commands

Valid mountstats(8) subcommands are, bestie:

  • mountstats β€” Displays a combination of per-op RPC statistics, NFS event counts, and NFS byte counts. This is the default sub-command that gets executed if you don't give a sub-command. the main character, honestly. πŸ’…
  • iostat β€” Displays iostat-like statistics. ✨
  • nfsstat β€” Displays nfsstat-like statistics. ✨

πŸŽ€ OPTIONS πŸŽ€

πŸ’œ Options valid for all sub-commands

  • -h, --help β€” show the help message and exit 🫢
  • -v, --version β€” show program's version number and exit 🌈
  • -f infile, --file infile β€” Read stats from infile instead of /proc/self/mountstats. infile must be in the same format as /proc/self/mountstats. This may be used with the -S|--since options to display the delta between two different points in time. This may not be used with the interval or count options of the iostat sub-command. 🚫
  • -S sincefile, --since sincefile β€” Show difference between current stats and those in sincefile. sincefile must be in the same format as /proc/self/mountstats. This may be used with the -f|--file options to display the delta between two different points in time. This may not be used with the interval or count options of the iostat sub-command. 🚫

πŸ”₯ Options specific to the mountstats sub-command

  • -n, --nfs β€” Display only the NFS statistics πŸ‘‘
  • -r, --rpc β€” Display only the RPC statistics πŸ‘‘
  • -R, --raw β€” Display only the raw statistics. This is intended for use with the -f|--file and -S|--since options. 🫢
  • -x, --xprt β€” Display only the transport statistics πŸ‘‘

⭐ Options specific to the iostat sub-command

  • interval β€” Specifies the amount of time in seconds between each report. The first report contains statistics for the time since each file system was mounted. Each subsequent report contains statistics collected during the interval since the previous report. This may not be used with the -f|--file or -S|--since options. 🚫
  • count β€” Determines the number of reports generated at interval seconds apart. If the interval parameter is specified without the count parameter, the command generates reports continuously. This may not be used with the -f|--file or -S|--since options. 🚫
heads up bestie: interval and count are lowkey incompatible with -f|--file and -S|--since. like they literally cannot coexist. pick a lane. πŸ’€

🌈 Options specific to the nfsstat sub-command

  • -3 β€” Show only NFS version 3 statistics. The default is to show both version 3 and version 4 statistics. πŸ“
  • -4 β€” Show only NFS version 4 statistics. The default is to show both version 3 and version 4 statistics. πŸ“

πŸ¦‹ FILES πŸ¦‹

  • /proc/self/mountstats

πŸ’– SEE ALSO πŸ’–

iostat(8), nfsiostat(8), nfsstat(8) β€” go read those too, iykyk πŸ“šβœ¨


🌸 AUTHOR 🌸

Chuck Lever <chuck.lever@oracle.com> β€” the icon who wrote this. respect. πŸ‘‘


and that's the whole page bestie!! no cap, every single flag and caveat is right there. πŸŽ€

this was the mountstats(8) page from the System Manager's Manual, dated 12 Dec 2014 β€” yes, 2014, it's vintage, it's iconic, we stan a classic. πŸ«Άβœ¨πŸ’…

πŸ“¦ where this page comes from