Commands Reference, Volume 4

nfsstat Command

Purpose

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

Syntax

/usr/sbin/nfsstat [ -c ] [ -s ] [ -n ] [ -r ] [ -z ] [ -m ]

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:

`calls`	Total number of RPC calls received
`badcalls`	Total number of calls rejected by the RPC layer
`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

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

-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:

`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 catching 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:

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

Flags

-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.
-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.
-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.
-z	Reinitializes 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.

Related Information

Network File System (NFS) Overview for System Management in AIX 5L Version 5.2 System Management Guide: Communications and Networks.

List of NFS Commands in AIX 5L Version 5.2 System Management Guide: Communications and Networks.

Monitoring and Tuning NFS Use in AIX 5L Version 5.2 Performance Management Guide.