nfsstat Command

Purpose

Displays statistical information about the Network File System (NFS) and Remote Procedure Call (RPC) calls.

Syntax

/usr/sbin/nfsstat [ -@ WparName ] [ -c ] [ -d ] [ -s ] [ -n ] [ -r ] [ -m ] [ -4 ] [ -z ] [ -t] [-b] [ -g ]

Description

The nfsstat command displays statistical information about the NFS and Remote Procedure Call (RPC) interfaces to the kernel. You can also use this command to reinitialize this information. If no flags are given, the default is the nfsstat -csnr command. With this option, the command displays everything, but reinitializes nothing.

RPC Server Information

The server RPC display includes the following fields:

Item Description
calls Total number of RPC calls received. This number includes the NFS version 4 calls if the -4 flag is used. Otherwise, only the version 2 and version 3 total is displayed.
badcalls Total number of calls rejected by the RPC layer. This number includes the NFS version 4 calls if the -4 flag is used. Otherwise, only the version 2 and version 3 total is displayed.
nullrecv Number of times an RPC call was not available when it was thought to be received.
badlen Number of RPC calls with a length shorter than a minimum-sized RPC call.
xdrcall Number of RPC calls whose header could not be XDR decoded.
dupchecks Number of RPC calls that looked up in the duplicate request cache.
dupreqs Number of duplicate RPC calls found.

RPC Client Information

Item Description
calls Total number of RPC calls made
badcalls Total number of calls rejected by the RPC layer
badxid Number of times a reply from a server was received that did not correspond to any outstanding call
timeouts Number of times a call timed out while waiting for a reply from the server
newcreds Number of times authentication information had to be refreshed
badverfs The number of times the call failed due to a bad verifier in the response.
timers The number of times the calculated time-out value was greater than or equal to the minimum specified timed-out value for a call.
cantconn The number of times the call failed due to a failure to make a connection to the server.
nomem The number of times the calls failed due to a failure to allocate memory.
interrupts The number of times the call was interrupted by a signal before completing.
retrans The number of times a call had to be retransmitted due to a time-out while waiting for a reply from the server. This is applicable only to RPC over connection-less transports
dupchecks The number of RPC calls that looked up in the duplicate request cache.
dupreqs The number of duplicate RPC calls found.

NFS Server Information

The NFS server displays the number of NFS calls received (calls) and rejected (badcalls), as well as the counts and percentages for the various kinds of calls made.

NFS Client Information

The NFS client information displayed 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 had no unused entries (clatoomany), and a count of the various kinds of calls and their respective percentages.

NFS Registry Daemon Information

The NFS registry daemon display shows the number of requests from the client and server to translate between UID/GID and string names.

-m Information

The -m flag displays information about mount flags set by mount options, mount flags internal to the system, and other mount information. See the mount command for more information.

The following mount options are set by mount flags:

Item Description
auth Provides one of the following values:
none
No authentication.
unix
UNIX style authentication (UID, GID).
des
des style authentication (encrypted timestamps).
hard Hard mount.
soft Soft mount.
intr Interrupts allowed on hard mount.
nointr No interrupts allowed on hard mount.
noac Client is not caching attributes.
rsize Read buffer size in bytes.
wsize Write buffer size in bytes.
retrans NFS retransmissions.
nocto No close-to-open consistency.
llock Local locking being used (no lock manager.
grpid Group ID inheritance.
vers NFS version.
proto Protocol.

The following mount options are internal to the system:

Item Description
printed Not responding message printed.
down Server is down.
dynamic Dynamic transfer size adjustment.
link Server supports links.
symlink Server supports symbolic links.
readdir Use readdir instead of readdirplus.

-t Information

The -t flag displays information relating to translation requests of the NFS identity mapping subsystem.
Item Description
ids_to_strings The number of id-to-string translation requests.
strings_to_ids The number of string-to-id translation requests.
resolve_errors The number of failed translation requests due to missing data.
badowners The number of failed translation requests due to invalid inputs.
cache_hits The number of translation requests handled by the translation cache.
cache_misses The number of translation requests not handled by the translation cache.
cache_entries The number of entries in the translation cache.
cache_recycles The number of entries in the translation cache that have expired.

Flags

Item Description
-@ WparName Displays statistics for the specified workload partition. The -@ flag can only be used when the nfsstat command is executed in the global partition. If the -@ flag is not used when the nfsstat command is executed from a workload partition, the statistics for the current workload partition are displayed. If the -@ flag is not used when the nfsstat command is executed from the global partition, the sum statistics of all active workload partitions (and the global partition) are displayed.
Note: If you use the -@ WparName flag together with the -m flag, the nfsstat command displays statistics for the global partition instead of the specified workload partition.
-b Displays additional statistics for the NFS version 4 server.
-c Displays client information. Only the client side NFS and RPC information is printed. Allows the user to limit the report to client data only. The nfsstat command provides information about the number of RPC and NFS calls sent and rejected by the client. To print client NFS or RPC information only, combine this flag with the -n or -r option.
-d Displays information related to NFS version 4 delegations.
-g Displays RPCSEC_GSS information. The RPCSEC_GSS information sections contain:
activegss
Active RPCSEC_GSS contexts
discardgss
Discarded RPCSEC_GSS messages
krb5est
Established krb5 contexts
krb5iest
Established krb5i contexts
krb5pest
Established krb5p contexts
expgss
Expired RPCSEC_GSS contexts
badaccept
gss_accept_sec_context failures
badverify
gss_verify_mic failures
badgetmic
gss_get_mic failures
badwrap
gss_wrap failures
badunwrap
gss_unwrap failures
-m Displays statistics for each NFS file system mounted along with the server name and address, mount flags, current read and write sizes, retransmission count, and the timers used for dynamic retransmission. This flag only applies to AIX® 4.2.1 or later.
Note: If you provide the -m option when you use the nfsstat command, you always get statistics for the global partition.
-n Displays NFS information . Prints NFS information for both the client and server. To print only the NFS client or server information, combine this flag with the -c and -s options.
-r Displays RPC information.
-s Displays server information.
-t Displays statistics related to translation requests of the NFS identity mapping subsystem. To print only the NFS client or server information, combine with the -c and -s options.
-4 When combined with the -c, -n, -s, or -z flags, includes information for the NFS version 4 client or server, in addition to the existing NFS version 2 and version 3 data. Without this option, output will be identical to output from the nfsstat command in AIX versions prior to version 5.3.
-z Re-initializes statistics. This flag is for use by the root user only and can be combined with any of the above flags to zero particular sets of statistics after printing them.

Examples

  1. To display information about the number of RPC and NFS calls sent and rejected by the client, enter:
    nfsstat -c
  2. To display and print the client NFS call-related information, enter:
    nfsstat -cn
  3. To display statistics for each NFS mounted file system in AIX 4.2.1 or later, enter:
    nfsstat -m
  4. To display and print RPC call-related information for the client and server, enter:
    nfsstat -r
  5. To display information about the number of RPC and NFS calls received and rejected by the server, enter:
    nfsstat -s
  6. To reset all call-related information to zero on the client and server, enter:
    nfsstat -z
    Note: You must have root user authority to use the -z flag.
  7. To display information about the NFS client statistics for workload partition abc, enter:
    nfsstat -@ abc -cn