man-pages/man8/nfsiostat.8.html
2021-03-31 01:06:50 +01:00

198 lines
4.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of nfsiostat</TITLE>
</HEAD><BODY>
<H1>nfsiostat</H1>
Section: Maintenance Commands (8)<BR>Updated: 15 Apr 2010<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
nfsiostat - Emulate iostat for NFS mount points using /proc/self/mountstats
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>nfsiostat [[</B><I>&lt;interval&gt;</I><B>] [</B><I>&lt;count&gt;</I><B>]] [</B><I>&lt;options&gt;</I><B>][&lt;mount_point&gt;</B><I>]</I>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B>nfsiostat</B>
command displays NFS client per-mount statisitics.
<DL COMPACT>
<DT id="1">&lt;interval&gt;<DD>
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.
<DT id="2">&lt;count&gt;<DD>
If the
<I>&lt;count&gt;</I>
parameter is
specified, the value of
<I>&lt;count&gt; </I>
determines the number of reports generated at
<I>&lt;interval&gt; </I>
seconds apart. if the interval parameter is
specified without the
<I>&lt;count&gt; </I>
parameter, the command generates reports continuously.
<DT id="3">&lt;options&gt;<DD>
Define below
<DT id="4">&lt;mount_point&gt;<DD>
If one or more
<I>&lt;mount point&gt; </I>
names are specified, statistics for only these mount points will
be displayed. Otherwise, all NFS mount points on the client are listed.
<DT id="5">The meaning of each column of <B>nfsiostat</B>'s output is the following:<DD>
<DL COMPACT><DT id="6"><DD>
- <B>op/s</B>
<DL COMPACT><DT id="7"><DD>
This is the number of operations per second.
<DL COMPACT><DT id="8"><DD>
</DL>
</DL>
</DL>
<DL COMPACT><DT id="9"><DD>
- <B>rpc bklog</B>
<DL COMPACT><DT id="10"><DD>
This is the length of the backlog queue.
</DL>
</DL>
<DL COMPACT><DT id="11"><DD>
- <B>kB/s</B>
<DL COMPACT><DT id="12"><DD>
This is the number of kB written/read per second.
</DL>
</DL>
<DL COMPACT><DT id="13"><DD>
- <B>kB/op</B>
<DL COMPACT><DT id="14"><DD>
This is the number of kB written/read per each operation.
</DL>
</DL>
<DL COMPACT><DT id="15"><DD>
- <B>retrans</B>
<DL COMPACT><DT id="16"><DD>
This is the number of retransmissions.
</DL>
</DL>
<DL COMPACT><DT id="17"><DD>
- <B>avg RTT (ms)</B>
<DL COMPACT><DT id="18"><DD>
This is the duration from the time that client's kernel sends the RPC request until the time it receives the reply.
</DL>
</DL>
<DL COMPACT><DT id="19"><DD>
- <B>avg exe (ms)</B>
<DL COMPACT><DT id="20"><DD>
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.
</DL>
</DL>
<DT id="21">Note that if an interval is used as argument to <B>nfsiostat</B>, then the diffrence from previous interval will be displayed, otherwise the results will be from the time that the share was mounted.<DD>
<P>
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="22"><B>-a or --attr</B>
<DD>
displays statistics related to the attribute cache
<DT id="23"><B>-d or --dir </B>
<DD>
displays statistics related to directory operations
<DT id="24"><B>-h or --help </B>
<DD>
shows help message and exit
<DT id="25"><B>-l LIST or --list=LIST </B>
<DD>
only print stats for first LIST mount points
<DT id="26"><B>-p or --page</B>
<DD>
displays statistics related to the page cache
<DT id="27"><B>-s or --sort</B>
<DD>
Sort NFS mount points by ops/second
<DT id="28"><B>--version</B>
<DD>
show program's version number and exit
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="29"><B>/proc/self/mountstats</B>
<DD>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+iostat">iostat</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+mountstats">mountstats</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+nfsstat">nfsstat</A>(8)</B>
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
Chuck Lever &lt;<A HREF="mailto:chuck.lever@oracle.com">chuck.lever@oracle.com</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="30"><A HREF="#lbAB">NAME</A><DD>
<DT id="31"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="32"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="33"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="34"><A HREF="#lbAF">FILES</A><DD>
<DT id="35"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="36"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:14 GMT, March 31, 2021
</BODY>
</HTML>