[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

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

  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.

Related Information

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

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

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


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]