System Administration Commands nfsstat(1M)
NAME
nfsstat - NFS statistics
SYNOPSIS
nfsstat [-cnrsza] [-v version] [interval [count]]
nfsstat -m [pathname...]
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 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 com-
bined 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 pathname.
This includes the server name and
address, mount flags, current read
and write sizes, the retransmission
count, the attribute cache timeout
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 mes-
sage alerting that the -m flag can-
not be combined with other options.
-n Display NFS information. NFS infor-
mation for both the client and
server side are printed. Can be com-
bined with the -c and -s options to
print client or server NFS informa-
tion 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 version 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 combined with any
of the above options to zero partic-
ular sets of statistics after print-
ing 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 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 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 informa-
tion 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.
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 authentica-
tion.
dh des-style authentication (encrypted
timestamps).
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 many times files have been re-evaluated
to the new server.
currserver Which server is currently providing NFS ser-
vice. See the System Administration Guide:
IP Services for additional details.
The fields in -m output shown below provide information on
dynamic retransmissions. These items are displayed only
where dynamic retransmission is in use.
srtt The value for the smoothed round-trip time,
in milliseconds.
dev Estimated deviation, in milliseconds.
cur Current backed-off retransmission value, in
milliseconds.
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 10 Installation Guide: Basic Installations
System Administration Guide: IP Services
|
|
