nfsstat(8nfs)nfsstat(8nfs)Namenfsstat - display Network File System (NFS) statistics
Syntax
/usr/etc/nfsstat [ -cnrsz ] [ vmunix.n ] [ core.n ]
Description
The command displays statistical information about the Network File
System (NFS) and Remote Procedure Call (RPC) interfaces in the kernel.
It can also be used to reinitialize this information. If you do not
specify any options, displays the information as though all the options
were specified, but
The statistics are reinitialized to zero each time the system reboots.
Options-c Display the client information. The client side NFS and RPC
information is displayed. You can combine this option with
the and options to print client NFS or client RPC information
only.
-s Display the server information. The server side NFS and RPC
information is displayed.
-n Display the NFS information. The NFS information for both
the client and server side is displayed. You can combine
this option with the and options to print client or server
NFS information only.
-r Display the RPC information. The RPC information for both
the client and server side is displayed. You can combine the
option with the and options to print client or server RPC
information only.
-z Reinitialize the statistics to zero. You can combine this
option with any of the above options to reset particular sets
of statistics to zero after printing them. You must have
write permission on to use this option.
core.n This is the core image, which is usually stored in the direc‐
tory If no is specified, the default is
vmunix.n This is the kernel image, which is usually stored in the
directory If no is specified, the default is
Here is a sample of output with no options specified:
# nfsstat
Server rpc:
calls badcalls nullrecv badlen xdrcall
1312142 0 0 0 0
Server nfs:
calls badcalls
1312142 0
null getattr setattr root lookup readlink read
0 0% 319612 24% 1220 0% 0 0% 795544 60% 5857 0% 163962 12%
wrcache write create remove rename link symlink
0 0% 7294 0% 165 0% 239 0% 75 0% 74 0% 0 0%
mkdir rmdir readdir fsstat
0 0% 0 0% 17612 1% 334 0%
Client rpc:
calls badcalls retrans badxid timeout wait newcred
30156 40 256 0 296 0 0
Client nfs:
calls badcalls nclget nclsleep
30143 40 30156 0
null getattr setattr root lookup readlink read
0 0% 5833 19% 21 0% 0 0% 17630 58% 420 1% 3455 11%
wrcache write create remove rename link symlink
0 0% 475 1% 84 0% 10 0% 4 0% 0 0% 0 0%
mkdir rmdir readdir fsstat
2 0% 0 0% 1423 4% 786 2%
Of the client RPC statistics, each field is as follows:
calls The total number of client RPC calls successfully begun.
badcalls The total number of unsuccessful (badly formed) RPC calls.
retrans The number of times that RPC calls were transmitted.
badxid The number of times a reply transaction ID did not match the
request transaction ID.
timeout The number of times a request was made but not answered.
wait The number of times the client system had to sleep because
the client structure was busy.
newcred This field is never used, and is therefore always 0.
Of the client NFS statistics, each field is as follows:
calls The total number of client NFS calls successfully begun.
badcalls The total number of unsuccessful (badly formed) NFS calls.
nclget The number of times a client structure was successfully
acquired. The client structure is where clients keep track
of an outstanding RPC call.
nclsleep The number of times all client structures were busy. Since
there are six client structures, is the number of times that
there were six operations in progress when a seventh one
arrived and had to wait until one of the client structures
was freed.
Of the server RPC statistics, each field is as follows:
calls The total number of RPC calls received by NFS daemons.
badcalls The number of badly formed RPC calls.
nullrecv The number of empty RPC calls.
badlen The number of RPC calls with too small of a body.
xdrcall The number of RPC calls that failed to decode in XDR.
Of the server NFS statistics, each field is as follows:
calls The total number of NFS calls dispatched by an NFS daemon.
badcalls The number of badly formed NFS requests.
The remaining fields provide counts of the completed NFS operations.
Here are their descriptions:
null This is the number of null operations. If the software is
working properly, this field should be zero.
getattr This is the number of file attributes that were retrieved.
In the example above, there were 319,612, or 24% on the
server.
setattr This is the number of file attributes that were stored.
root This field is not used and should always be zero.
lookup This is the number of times that a directory pathname was
looked up.
readlink This is the number of times a symbolic link was read.
read This is the number of times data was read from a file.
wrcache This field is not used and should always be zero.
write This is the number of times data was written to a file.
create This is the number of times a new file was created.
remove This is the number of times a file was removed.
rename This is the number of times a file was renamed.
link This is the number of times a hard link was created.
symlink This is the number of times a symbolic link was created.
mkdir This is the number of times a directory was created.
rmdir This is the number of times a directory was removed.
readdir This is the number of times a directory was read.
fsstat This is the number of times that file system attributes and
statistics were retrieved.
Files
System namelist
kernel memory
nfsstat(8nfs)
