nfsstat(1) [freebsd man page]
NFSSTAT(1) BSD General Commands Manual NFSSTAT(1) NAME
nfsstat -- display NFS statistics SYNOPSIS
nfsstat [-cemoszW] [-M core] [-N system] [-w wait] DESCRIPTION
The nfsstat command displays statistics kept about NFS client and server activity. For the NFSv4 server, the statistics are for operations within the Compound RPCs and not the count of RPCs. If you wish to compare RPC counts between NFSv3 and NFSv4, you must use statistics in the client(s). The options are as follows: -c Only display client side statistics. -e Report the extra statistics collected by the new NFS client and server for NFSv4. This option is incompatible with -o. -M Extract values associated with the name list from the specified core instead of the default /dev/kmem. -m Report the mount options for all new NFS client mounts. This option overrides all others and nfsstat will exit after completing the report. This option is only supported by the new NFS client. -N Extract the name list from the specified system instead of the default /boot/kernel/kernel. -o Report statistics for the old NFS client and/or server. Without this option statistics for the new NFS client and/or server will be reported. -s Only display server side statistics. -W Use wide format with interval short summary. This option is especially useful when combined with -c or -s and a time delay. -w Display a shorter summary of NFS activity for both the client and server at wait second intervals. -z Reset statistics after displaying them. FILES
/boot/kernel/kernel default kernel namelist /dev/kmem default memory file SEE ALSO
fstat(1), netstat(1), ps(1), systat(1), sysctl(3), iostat(8), nfsdumpstate(8), pstat(8), vmstat(8) HISTORY
The nfsstat command appeared in 4.4BSD. BSD
May 1, 2013 BSD
Check Out this Related Man Page
nfsstat(8nfs) nfsstat(8nfs) Name nfsstat - 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 sta- tistics 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 directory 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 out- standing 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)