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.
s`trings_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

To display information about the number of RPC and NFS calls sent and rejected by the client, enter:
```
nfsstat -c
```
To display and print the client NFS call-related information, enter:
```
nfsstat -cn
```
To display statistics for each NFS mounted file system in AIX 4.2.1 or later, enter:
```
nfsstat -m
```
To display and print RPC call-related information for the client and server, enter:
```
nfsstat -r
```
To display information about the number of RPC and NFS calls received and rejected by the server, enter:
```
nfsstat -s
```
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.
To display information about the NFS client statistics for workload partition abc, enter:
```
nfsstat -@ abc -cn
```