Man Pages (1M): Maintenance and Administration Commands

nfsstat(1M)

NAME

nfsstat- NFS statistics

SYNOPSIS

nfsstat

-cmnrsz

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

nfsstat -cnrs

That is, display everything, but reinitialize nothing.

To succeed with no option or with any option other than -z, nfsstat requires MAC and DAC read access to /dev/mem. To succeed with the -z option, nfsstat requires MAC and DAC write access to /dev/mem and the sys_config privilege.

OPTIONS

-c: Display client information. Only the client side NFS and RPC information will be printed. Can be combined with the -n and -r options to print client NFS or client RPC information only.
-m: Display statistics for each NFS mounted file system. This includes the server name and address, mount flags, current read and write sizes, the retransmission count, and the timers used for dynamic retransmission. The srtt value contains the smoothed round trip time, the dev value contains the estimated deviation, and the cur value is the current backed-off retransmission value.
-n: Display NFS information. NFS information for both the client and server side will be 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.
-z: Zero (reinitialize) statistics. This option requires the sys_config privilege and can be combined with any of the above options to zero particular sets of statistics after printing them.

DISPLAYS

The server RPC display includes the following fields:

calls: The total number of RPC calls received.
badcalls: The total number of calls rejected by the RPC layer (the sum of badlen and xdrcall as defined below).
nullrecv: The number of times an RPC call was not available when it was thought to be received.
badlen: The number of RPC calls with a length shorter than a minimum-sized RPC call.
xdrcall: The number of RPC calls whose header could not be XDR decoded.
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.

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 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.
badxids: The number of times a reply from a server was received which did not correspond to any outstanding call.
timeouts: The number of times a call timed out while waiting for a reply from the server.
newcreds: The 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 time-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 call 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 timeout while waiting for a reply from the server. Applicable only to RPC over connection-less transports.

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 respective percentages.

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

The following fields provide failover information:

noresponse: How many times servers have failed to respond.
failover: How many times a new server has been selected.
remap: How may times files have been re-evaluated to the new server.
currserver: Which server is currently providing NFS service. See the NFS Administration Guide for additional details.

The following mount flags are set by mount options:

auth

auth has one of the following values:

none

No authentication.

unix

UNIX style authentication (UID, GID).

short

Shorthand UNIX style authentication.

des

des style authentication (encrypted timestamps).

krb4

kerberos style authentication.

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

System V group id inheritance.

rpctimesync

RPC time sync.

The following mount flags 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.
acl: Server supports NFS_ACL. The following flags relate to additional mount information:
vers: NFS version.
proto: Protocol.

EXIT STATUS

The following exit values are returned:

0: Successful completion.
>0: An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SUMMARY OF TRUSTED SOLARIS CHANGES

Trusted Solaris 7 Reference Manual

mount_nfs(1M)

SunOS 5.7 Reference Manual

attributes(5)

Solaris Advanced Installation Guide

NFS Administration Guide

Trusted Solaris 7 Last Revised 18 May 1998