nfsstat man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

NFSSTAT(1M)							   NFSSTAT(1M)

NAME
       nfsstat - NFS statistics

SYNOPSIS
       nfsstat [-cnrsza] [-T u | d ] [-v version] [interval [count]]

       nfsstat -m [pathname]...

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

       nfsstat -csnra

       The default displays everything, but reinitializes nothing.

OPTIONS
       -a

	   Display NFS_ACL information.

       -c

	   Display client information. Only the	 client	 side  NFS,  RPC,  and
	   NFS_ACL  information	 is  printed. Can be combined with the -n, -r,
	   and -a options to print client side NFS, RPC, and NFS_ACL  informa‐
	   tion only.

       -m [pathname...]

	   Display statistics for each NFS mounted file system. If pathname is
	   not specified, displays statistics for all NFS  mounted  file  sys‐
	   tems.  If  pathname	is  specified, displays statistics for the NFS
	   mounted file systems indicated by pathname.

	   This includes the server name and  address,	mount  flags,  current
	   read and write sizes, the retransmission count, the attribute cache
	   timeout values, failover  information,  and	the  timers  used  for
	   dynamic  retransmission. The dynamic retransmission timers are dis‐
	   played only where dynamic retransmission is in use. By default, NFS
	   mounts  over the TCP protocols and NFS Version 3 mounts over either
	   TCP or UDP do not use dynamic retransmission.

	   If you specify the -m option, this is the only option that  nfsstat
	   uses.  If  you  specify other options with -m, you receive an error
	   message alerting that the -m flag cannot  be	 combined  with	 other
	   options.

       -n

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

       -r

	   Display RPC information.

       -s

	   Display server information.

       -T u | d

	   Display a time stamp.

	   Specify  u for a printed representation of the internal representa‐
	   tion of time. See time(2). Specify d for standard date format.  See
	   date(1).

       -v version

	   Specify  which NFS version for which to print statistics. When fol‐
	   lowed by the optional version argument, (2|3|4), specifies  statis‐
	   tics	 for  that version. By default, prints statistics for all ver‐
	   sions.

       -z

	   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.

OPERANDS
       The following operands are supported:

       count

	   Display only count reports

       interval

	   Report once each interval seconds.

       pathname

	   Specify the pathname of a file in an NFS mounted  file  system  for
	   which statistics are to be displayed.

DISPLAYS
       The server RPC display includes the following fields:

       badcalls

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

       badlen

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

       calls

	   The total number of RPC calls received.

       dupchecks

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

       dupreqs

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

       nullrecv

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

       xdrcall

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

       The  server  NFS display shows the number of NFS calls received (calls)
       and rejected (badcalls), 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:

       calls

	   The total number of RPC calls made.

       badcalls

	   The total number of calls rejected by the RPC layer.

       badverfs

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

       badxids

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

       cantconn

	   The number of times the call failed due to a failure to make a con‐
	   nection to the server.

       cantsend

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

       interrupts

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

       newcreds

	   The number of times authentication information had to be refreshed.

       nomem

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

       retrans

	   The number of times a call had to be retransmitted due to a timeout
	   while  waiting  for a reply from the server. Applicable only to RPC
	   over connection-less transports.

       timeouts

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

       timers

	   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 client NFS display shows the number of calls sent and rejected,  as
       well  as the number of times a CLIENT handle was received (clgets), the
       number  of  times  the  CLIENT  handle  cache  had  no  unused  entries
       (cltoomany),  as well as a count of the various calls and their respec‐
       tive percentages.

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

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

       The following mount flags are set by mount options:

       grpid

	   System V group id inheritance.

       hard

	   Hard mount.

       intr

	   Interrupts allowed on hard mount.

       llock

	   Local locking being used (no lock manager).

       noac

	   Client is not caching attributes.

       nointr

	   No interrupts allowed on hard mount.

       nocto

	   No close-to-open consistency.

       retrans

	   NFS retransmissions.

       rpctimesync

	   RPC time sync.

       rsize

	   Read buffer size in bytes.

       sec

	   sec has one of the following values:

	   dh

	       des-style authentication (encrypted timestamps).

	   krb5

	       kerberos v5-style authentication.

	   krb5i

	       kerberos v5-style authentication with integrity.

	   krb5p

	       kerberos v5-style authentication with privacy.

	   none

	       No authentication.

	   short

	       Short hand UNIX-style authentication.

	   sys

	       UNIX-style authentication (UID, GID).

       soft

	   Soft mount.

       timeo

	   Initial NFS timeout, in tenths of a second.

       wsize

	   Write buffer size in bytes.

       The following mount flags are internal to the system:

       acl

	   Server supports NFS_ACL.

       down

	   Server is down.

       dynamic

	   Dynamic transfer size adjustment.

       link

	   Server supports links.

       mirrormount

	   Mounted automatically by means of the mirrormount mechanism.

       printed

	   "Not responding" message printed.

       readdir

	   Use readdir instead of readdirplus.

       symlink

	   Server supports symbolic links.

       The following flags relate to additional mount information:

       proto

	   Protocol.

       vers

	   NFS version.

       The -m option also provides attribute cache timeout values. The follow‐
       ing fields in -m ouput provide timeout values for attribute cache:

       acdirmax

	   Maximum seconds to hold cached directory attributes.

       acdirmin

	   Minimum seconds to hold cached directory attributes.

       acregmax

	   Maximum seconds to hold cached file attributes.

       acregmin

	   Minimum seconds to hold cached file attributes.

       The following fields in -m output provide failover information:

       currserver

	   Which server is currently providing NFS service. See the  for addi‐
	   tional details.

       failover

	   How many times a new server has been selected.

       noresponse

	   How many times servers have failed to respond.

       remap

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

       The  fields  in	-m  output  shown below provide information on dynamic
       retransmissions. These items are displayed only where dynamic  retrans‐
       mission is in use.

       cur

	   Current backed-off retransmission value, in milliseconds.

       dev

	   Estimated deviation, in milliseconds.

       srtt

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

EXIT STATUS
       The following exit values are returned:

       0

	   Successful completion.

       >0

	   An error occurred.

SEE ALSO
       mount_nfs(1M), attributes(5)

				 Jun 16, 2009			   NFSSTAT(1M)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net