Provided by: nfs-common_2.6.1-2ubuntu4_amd64 bug

NAME

       nfsstat - list NFS statistics

SYNOPSIS

       nfsstat [OPTION]...

DESCRIPTION

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

OPTIONS

       -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

       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.

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

BUGS

       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

       Olaf Kirch, <okir@suse.de>

                                            7 Aug 2007                                 nfsstat(8)