nfsstat(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | DISPLAY | FILES | SEE ALSO | BUGS | AUTHOR | COLOPHON

nfsstat(8)               System Manager's Manual              nfsstat(8)

NAME         top

       nfsstat - list NFS statistics

SYNOPSIS         top

       nfsstat [OPTION]...

DESCRIPTION         top

       The nfsstat displays statistics kept about NFS client and server
       activity.

OPTIONS         top

       -s, --server
              Print only server-side statistics. The default is to print
              both server and client statistics.

       -c, --client
              Print only client-side statistics.

       -n, --nfs
              Print only NFS statistics. The default is to print both
              NFS and RPC information.

       -2     Print only NFS v2 statistics. The default is to only print
              information about the versions of NFS that have non-zero
              counts.

       -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.

       -m, --mounts
              Print information about each of the mounted NFS file
              systems.

              If this option is used, all other options are ignored.

       -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.

       -v, --verbose
              This is equivalent to -o all.

       -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.

       -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.

EXAMPLES         top

       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         top

       The Flags output from the -m option is the same as the flags give
       to the mount command.

FILES         top

       /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         top

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

BUGS         top

       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.

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

AUTHOR         top

       Olaf Kirch, <okir@suse.de>

COLOPHON         top

       This page is part of the nfs-utils (NFS utilities) project.
       Information about the project can be found at 
       ⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩.  If you have a
       bug report for this manual page, see
       ⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨git://git.linux-nfs.org/projects/steved/nfs-utils.git⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-12-05.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

                               7 Aug 2007                     nfsstat(8)

Pages that refer to this page: nfsd(7)mountstats(8)nfsd(8)nfsiostat(8)