nfsstat

NFSSTAT(1)                   General Commands Manual                  NFSSTAT(1)

NAME
     nfsstat – display NFS statistics

SYNOPSIS
     nfsstat [-cseuv] [-w wait] [-n net|user] [-m [mountpath]]

DESCRIPTION
     nfsstat displays statistics kept about NFS client and server activity,
     active user activity, exported directories, and mount information.  In the
     absence of any options, nfsstat displays NFS client and server statistics.

     The options are as follows:

     -c      Show NFS client statistics.

     -e      Show NFS server exported directory statistics.

     -m [mountpath]
             Show NFS mount information.

     -s      Show NFS server statistics.

     -3      Print only NFS v3 statistics.

     -4      Print only NFS v4 statistics.

     -u      Show NFS server active user statistics.

     -f JSON
             Print output as JSON format.

     -w wait
             Display a shorter summary at wait second intervals.

     -n net|user
             Show network addresses as numbers, or show users as uid numbers.
             This option can appear multiple times.

     -z      Zero NFS client and server statistics.

     -v      Show additional information (if available).

OUTPUT
     The data fields that nfsstat displays for each set of statistics are:

     NFSv3 Client Information:
         Statistics for NFSv3 file system mounts.

         RPC Counts
             Counts of the RPC calls made to each of the NFSv3 protocol
             procedures.

     NFSv4 Client Information:
         Statistics for NFSv4 file system mounts.

         RPC Counts
             Counts of the RPC calls made to each of the NFSv4 protocol
             procedures.

         Operations Counts
             Counts of the operations calls made by the client within the
             compound procedure.

     Common Client Information:
         Common statistics for NFS file system mounts.

         RPC Info
             Statistics for NFS RPC calls:

             TimedOut
                  RPC calls that timed out, perhaps to a slow or dead server.

             Invalid
                  Invalid RPC replies.

             X Replies
                  RPC replies received that did not have calls pending.

             Retries
                  RPC calls that were retried.

             Requests
                  Total number of RPC calls made.

         Cache Info
             Statistics on NFS client-side cache performance:

             Attr Hits/Misses
                  Performance of the NFS file attribute cache.

             Lkup Hits/Misses
                  Performance of the directory name lookup cache.

             BioR Hits/Misses
                  Performance of block cache for reads.

             BioW Hits/Misses
                  Performance of block cache for writes.

             BioRL Hits/Misses
                  Performance of symbolic link cache.

             BioD Hits/Misses
                  Performance of directory cache.

             DirE Hits/Misses
                  Performance of directory offset cache.

         Paging Info
             Counts both pagein and pageout operations.

     NFSv3 Server Information:
         Statistics for the NFSv3 server.

         RPC Counts
             Counts of RPC calls on each of the NFS server's procedures are
             recorded here.

         Server Ret-Failed
             RPC errors returned by the server.

         Server Faults
             Errors in the NFS server.

         Server Cache Stats
             Statistics from the NFS server's RPC duplicate request cache:

             Inprog
                  Calls already in progress.

             Idem
                  Cache hits for idempotent procedures.

             Non-idem
                  Cache hits for non-idempotent procedures.

             Misses
                  Cache Misses.

         Server Write Gathering
             These statistics describe the efficiency of the NFS server's write
             gathering feature.

             WriteOps
                  Write operations to disk.

             WriteRPC
                  Write operations received by the server.

             Opsaved
                  Write operations that were gathered (WriteRPC - WriteOps)

     NFS Server Exported Directory Information:
         Statistics for each exported directory on the NFS server.

         NFS Requests
              Count of NFS requests processed by an exported directory.

         Bytes Read
              Count of bytes read from an exported directory.

         Bytes Written
              Count of bytes written to an exported directory.

     NFS Server Active User Information:
         List of active NFS users and statistics on the NFS server.

         NFS Requests
              Count of NFS requests received from an active user.

         Bytes Read
              Count of bytes read by an active user.

         Bytes Written
              Count of bytes written by an active user.

         Idle
              Amount of time an active user has been idle.

         User
              Name (or uid if -n user was given) of active user.

         IP Address
              Host name (or network address if -n net was given) of client
              machine.

     NFS Mount Information:
         Information about the given NFS mount (or all NFS mounts).

         The path mounted on and the server:/path that is mounted.

         Mount arguments originally passed in to the mount.

         Current mount parameter values and status information.

SEE ALSO
     netstat(1), iostat(8), mount_nfs(8), nfsd(8)

HISTORY
     The nfsstat command appears in 4.4BSD.

BSD 4.4                         January 11, 2011                         BSD 4.4