|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
nfsiostat(8) System Manager's Manual nfsiostat(8)
nfsiostat - Emulate iostat for NFS mount points using
/proc/self/mountstats
nfsiostat [[<interval>] [<count>]] [<options>][<mount_point>]
The nfsiostat command displays NFS client per-mount statisitics.
<interval>
specifies the amount of time in seconds between each
report. The first report contains statistics for the time
since each file system was mounted. Each subsequent report
contains statistics collected during the interval since the
previous report.
<count>
If the <count> parameter is specified, the value of <count>
determines the number of reports generated at <interval>
seconds apart. if the interval parameter is specified
without the <count> parameter, the command generates
reports continuously.
<options>
Define below
<mount_point>
If one or more <mount point> names are specified,
statistics for only these mount points will be displayed.
Otherwise, all NFS mount points on the client are listed.
The meaning of each column of nfsiostat's output is the following:
- op/s
This is the number of operations per second.
- rpc bklog
This is the length of the backlog queue.
- kB/s
This is the number of kB written/read per second.
- kB/op
This is the number of kB written/read per each
operation.
- retrans
This is the number of retransmissions.
- avg RTT (ms)
This is the duration from the time that client's
kernel sends the RPC request until the time it
receives the reply.
- avg exe (ms)
This is the duration from the time that NFS client
does the RPC request to its kernel until the RPC
request is completed, this includes the RTT time
above.
- avg queue (ms)
This is the duration from the time the NFS client
created the RPC request task to the time the
request is transmitted.
- errors
This is the number of operations that completed
with an error status (status < 0). This count is
only available on kernels with RPC iostats version
1.1 or above.
Note that if an interval is used as argument to nfsiostat, then
the diffrence from previous interval will be displayed, otherwise
the results will be from the time that the share was mounted.
-a or --attr
displays statistics related to the attribute cache
-d or --dir
displays statistics related to directory operations
-h or --help
shows help message and exit
-l LIST or --list=LIST
only print stats for first LIST mount points
-p or --page
displays statistics related to the page cache
-s or --sort
Sort NFS mount points by ops/second
--version
show program's version number and exit
/proc/self/mountstats
iostat(8), mountstats(8), nfsstat(8)
Chuck Lever <chuck.lever@oracle.com>
This page is part of the nfs-utils (NFS utilities) project.
Information about the project can be found at
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. If you have a bug
report for this manual page, see
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. This page was
obtained from the project's upstream Git repository
⟨git://git.linux-nfs.org/projects/steved/nfs-utils.git⟩ on
2025-08-11. (At that time, the date of the most recent commit
that was found in the repository was 2025-06-27.) If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page,
or you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a
mail to man-pages@man7.org
15 Apr 2010 nfsiostat(8)
Pages that refer to this page: mountstats(8)