nfsstat(1M) System Administration Commands nfsstat(1M)NAMEnfsstat - NFS statistics
SYNOPSISnfsstat [-cnrsza] [-v version] [interval [count]]
nfsstat-m [pathname...]
DESCRIPTIONnfsstat 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
as follows:
nfsstat-csnra
The default displays everything, but reinitializes 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 combined with the -n, -r, and
-a options to print client side NFS, RPC, and
NFS_ACL information only.
-m [pathname...] Display statistics for each NFS mounted file
system. If pathname is not specified, displays
statistics for all NFS mounted file systems. If
pathname is specified, displays statistics for
the NFS mounted file systems indicated by path‐
name.
This includes the server name and address,
mount flags, current read and write sizes, the
retransmission count, the attribute cache time‐
out values, failover information, and the
timers used for dynamic retransmission. The
dynamic retransmission timers are displayed
only where dynamic retransmission is in use. By
default, NFS mounts over the TCP protocols 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 that nfsstat uses. If you specify other
options with -m, you receive an error message
alerting that the -m flag cannot be combined
with other options.
-n Display NFS information. NFS information for
both the client and server side are 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.
-v version Specify which NFS version for which to print
statistics. When followed by the optional ver‐
sion argument, (2|3|4), specifies statistics
for that version. By default, prints statistics
for all versions.
-z Zero (reinitialize) statistics. This option is
for use by the super user only, and can be com‐
bined with any of the above options to zero
particular sets of statistics after printing
them.
OPERANDS
The following operands are supported:
count Display only count reports
interval Report once each interval seconds.
pathname Specify the pathname of a file in an NFS
mounted file system for which statistics are to
be displayed.
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 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 veri‐
fier 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 respec‐
tive 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 informa‐
tion. 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 time‐
stamps).
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 follow‐
ing 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 information:
noresponse How many times servers have failed to respond.
failover How many times a new server has been selected.
remap How many 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 addi‐
tional details.
The fields in -m output shown below provide information on dynamic
retransmissions. These items are displayed only where dynamic retrans‐
mission 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 millisec‐
onds.
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 │SUNWnfscu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmount_nfs(1M), attributes(5)
Solaris 10 Installation Guide: Basic Installations
System Administration Guide: IP Services
SunOS 5.10 25 Jul 2004 nfsstat(1M)
