nfsstat(1M)															       nfsstat(1M)

NAME

       nfsstat - NFS statistics

SYNOPSIS

DESCRIPTION

       displays  statistical  information  about the NFS and RPC (Remote Procedure Call), interfaces to the kernel.  It can also be used to reini-
       tialize this information.  If no options are given the default is:

       That is, display everything, but reinitialize nothing.

   Options
	      Display
		    NFS_ACL information.

	      Display client information.
		    Only the client side NFS, RPC, and NFS_ACL information is printed.	Can be combined with the and options to print client  side
		    NFS, RPC, and NFS_ACL information only.

	      Display statistics for each NFS
		    mounted  file system.  This includes the server name, mount flags, current read and write sizes, the retransmission count, the
		    attribute cache timeout values, failover information, and the timers used for dynamic retransmission.  Note that  the  dynamic
		    retransmission  timers  are displayed only where dynamic retransmission is in use.	By default, NFS mounts over the TCP proto-
		    cols and NFS Version 3 mounts over either TCP or UDP do not use dynamic retransmission.

		    If you specify the option, this is the only option uses.  Any options specified in addition to are checked for validity,  then
		    ignored.

	      Display NFS information.
		    NFS  information for both the client and server side will be printed.  Can be combined with the and options to print client or
		    server  NFS information only.

	      Display RPC information.
		    Can be combined with the and options to print client or server  RPC information only.

	      Display server information.
		    Only the server side NFS, RPC, and NFS_ACL information is printed.	Can be combined with the and options to print server  side
		    NFS, RPC, and NFS_ACL information only.

	      Zero (reinitialize) statistics.
		    This  option  is  for use by the super user only, and can be combined with any of the above options to zero particular sets of
		    statistics after printing them.

   Displays
       The server RPC display includes the following fields:

	      The total number of RPC calls received.

	      The total number of calls rejected by the RPC layer (the sum of
			     and as defined below).

	      The number of times an RPC
			     call was not available when it was thought to be received.

	      The number of RPC calls with a length shorter than a minimum-sized RPC
			     call.

	      The number of  RPC calls whose header could not be XDR decoded.

	      The number of RPC calls that looked up in the duplicate request cache.

	      The number of RPC calls that were found to be duplicates.

       The server NFS display shows the number of NFS calls received and rejected and the counts and percentages for the various calls	that  were
       made.

       The server NFS_ACL display shows the counts and percentages for the various calls that were made.

       The client RPC display includes the following fields:

	      The total number of RPC calls made.

	      The total number of calls rejected by the RPC layer.

	      The number of times a reply from a server was received which did
			     not correspond to any outstanding call.

	      The number of times a call timed out while waiting for a reply from the
			     server.

	      The number of times authentication information had to be refreshed.

	      The number of times the call failed due to a bad verifier in the
			     response.

	      The number of times the calculated time-out value was greater than
			     or equal to the minimum specified time-out value for a call.

	      The number of times the call failed due to a failure to make a
			     connection to the server.

	      The number of times the call failed due to a failure to allocate
			     memory.

	      The number of times the call was interrupted by a signal before
			     completing.

	      The number of times a call had to be retransmitted
			     due to a timeout while waiting for a reply from the server.

	      The number of times a client was unable to send an RPC request over a
			     connectionless transport when it tried to do so.

       The  client  NFS  display  shows  the number of calls sent and rejected, as well as the number of times a handle was received the number of
       times the handle cache had no unused entries as well as a count of the various calls and their respective percentages.

       The client NFS_ACL display shows the counts and percentages for the various calls that were made.

       The option includes information about mount flags set by mount options, mount flags internal to the system, and	other  mount  information.
       See mount_nfs(1M).

       The following mount flags are set by mount options:

	      has one of the following values:

			     No authentication.

			     UNIX-style authentication (UID, GID).

			     authentication (encrypted timestamps).

			     authentication.

			     authentication with integrity.

			     authentication with privacy.

	      Hard mount.

	      Soft mount.

	      Interrupts allowed on hard mount.

	      No interrupts allowed on hard mount.

	      Forced direct I/O being used for the duration of the mount.

	      Client is not caching attributes.

	      Read buffer size in bytes.

	      Write buffer size in bytes.

	      NFS retransmissions.

	      Initial NFS timeout, in tenths of a second.

	      No close-to-open consistency.

	      Local locking being used (no lock manager).

	      Public handle being used.

	      System V group id inheritance.

	      RPC time sync.

	      Allow access to local devices.

	      Do not allow access to local devices.

       The following mount flags are internal to the system:

	      "Not responding" message printed.

	      Server is down.

	      Dynamic transfer size adjustment.

	      Server supports links.

	      Server supports symbolic links.

	      Use	     instead of

	      Server supports NFS_ACL.

	      A private option used by the HP CIFS Client product only.

       The following flags relate to additional mount information:

	      NFS version.

	      Protocol.

       The option also provides attribute cache timeout values.  The following fields in ouput provide timeout values for attribute cache:

	      Minimum seconds to hold cached file attributes.

	      Maximum seconds to hold cached file attributes.

	      Minimum seconds to hold cached directory attributes.

	      Maximum seconds to hold cached directory attributes.

       The following fields in output provide failover information:

	      How many times servers have failed to respond.

	      How many times a new server has been selected.

	      How may times files have been re-evaluated to the new server.

	      Which server is currently providing NFS service.

       The  fields  in	output shown below provide information on dynamic retransmissions.  Note that these items are displayed only where dynamic
       retransmission is in use.

	      The value for the smoothed round-trip time, in milliseconds.

	      Estimated deviation, in milliseconds.

	      Current backed-off retransmission value, in milliseconds.

EXIT STATUS

       The following exit values are returned:

       Successful completion.
       An error occurred.

AUTHOR

       was developed by Sun Microsystems, Inc.

SEE ALSO

       mount_nfs(1M).

																       nfsstat(1M)