nfsstat(1M)
NAME
nfsstat - NFS statistics
SYNOPSIS
nfsstat [-cnrsmza]
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 -csnra
That is, display everything, but reinitialize nothing.
OPTIONS
-a Display NFS_ACL information.
-c Display client information. Only the client side NFS,
RPC, and NFS_ACL information is printed. Can be com-
bined with the -n, -r, and -a options to print client
side NFS, RPC, and NFS_ACL 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 retransmis-
sion count, the attribute cache timeout values, fail-
over information, and the timers used for dynamic
retransmission. Note that the dynamic retransmission
timers are displayed only where dynamic retransmission
is in use. By default, NFS mounts over the TCP proto-
cols and NFS Version 3 mounts over either TCP or UDP
do not use dynamic retransmission.
If you specify the -m option, this is the only option
nfsstat uses. Any options specified in addition to -m
are checked for validity, then ignored.
-n Display NFS information. NFS information for both the
client and server side will be printed. Can be com-
bined 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 is for use
by the super user only, 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 dupli-
cate request cache.
dupreqs
The number of RPC calls that were found to be dupli-
cates.
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 server NFS_ACL display shows 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 sig-
nal 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.
cantsend
The number of times a client was unable to send an RPC
request over a connectionless transport when it tried
to do so.
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 client NFS_ACL display shows the counts and percentages
for the various calls that were made.
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 mount flags are set by mount options:
sec sec has one of the following values:
none No authentication.
sys UNIX-style authentication (UID, GID).
short Short hand UNIX-style authentication.
dh des-style authentication (encrypted times-
tamps).
krb5 kerberos v5-style authentication.
krb5i kerberos v5-style authentication with
integrity.
krb5p kerberos v5-style authentication with
privacy.
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.
timeo Initial NFS timeout, in tenths of a second.
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.
The -m option also provides attribute cache timeout values.
The following fields in -m ouput provide timeout values for
attribute cache:
acregmin
Minimum seconds to hold cached file attributes.
acregmax
Maximum seconds to hold cached file attributes.
acdirmin
Minimum seconds to hold cached directory attributes.
acdirmax
Maximum seconds to hold cached directory attributes.
The following fields in -m output provide failover informa-
tion:
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 System Administration Guide: IP Services
for additional details.
The fields in -m output shown below provide information on
dynamic retransmissions. Note that these items are displayed
only where dynamic retransmission is in use.
srtt The value for the smoothed round-trip time, in mil-
liseconds.
dev Estimated deviation, in milliseconds.
cur Current backed-off retransmission value, in mil-
liseconds.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWnfscu |
|_____________________________|_____________________________|
SEE ALSO
mount_nfs(1M), attributes(5)
Solaris 9 9/04 Installation Guide
System Administration Guide: IP Services
Man(1) output converted with
man2html