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

281 lines
6.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of nfsstat</TITLE>
</HEAD><BODY>
<H1>nfsstat</H1>
Section: Maintenance Commands (8)<BR>Updated: 7 Aug 2007<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>
nfsstat - list NFS statistics
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>nfsstat</B>
[<I>OPTION</I>]...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B>nfsstat</B>
displays statistics kept about NFS client and server activity.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-s, --server</B>
<DD>
Print only server-side statistics. The default is to print both server and
client statistics.
<DT id="2"><B>-c, --client</B>
<DD>
Print only client-side statistics.
<DT id="3"><B>-n, --nfs</B>
<DD>
Print only NFS statistics. The default is to print both NFS and RPC
information.
<DT id="4"><B>-2</B>
<DD>
Print only NFS v2 statistics. The default is to only print information
about the versions of <B>NFS</B> that have non-zero counts.
<DT id="5"><B>-3</B>
<DD>
Print only NFS v3 statistics. The default is to only print information
about the versions of <B>NFS</B> that have non-zero counts.
<DT id="6"><B>-4</B>
<DD>
Print only NFS v4 statistics. The default is to only print information
about the versions of <B>NFS</B> that have non-zero counts.
<DT id="7"><B>-m, --mounts</B>
<DD>
Print information about each of the mounted <B>NFS</B> file systems.
<P>
If this option is used, all other options are ignored.
<DT id="8"><B>-r, --rpc</B>
<DD>
Print only RPC statistics.
<DT id="9"><B>-o</B><I> facility</I>
<DD>
Display statistics for the specified facility, which must be one of:
<DL COMPACT><DT id="10"><DD>
<DL COMPACT>
<DT id="11"><B>nfs</B>
<DD>
NFS protocol information, split up by RPC call.
<DT id="12"><B>rpc</B>
<DD>
General RPC information.
<DT id="13"><B>net</B>
<DD>
Network layer statistics, such as the number of received packets, number
of TCP connections, etc.
<DT id="14"><B>fh</B>
<DD>
Usage information on the server's file handle cache, including the
total number of lookups, and the number of hits and misses.
<DT id="15"><B>rc</B>
<DD>
Usage information on the server's request reply cache, including the
total number of lookups, and the number of hits and misses.
<DT id="16"><B>io</B>
<DD>
Usage information on the server's io statistics; bytes read and
written.
<DT id="17"><B>ra</B>
<DD>
Usage information on the server's read ahead cache, including the
ra cache size, the depth of ra cache hits, and ra cache misses.
<DT id="18"><B>all</B>
<DD>
Display all of the above facilities.
</DL>
</DL>
<DT id="19"><B>-v, --verbose</B>
<DD>
This is equivalent to <B>-o all</B>.
<DT id="20"><B>-l, --list</B>
<DD>
Print information in list form.
<DT id="21"><B>-S, --since </B><I>file</I>
<DD>
Instead of printing current statistics,
<B>nfsstat</B>
imports statistics from
<I>file</I>
and displays the difference between those and the current statistics.
Valid input
<I>file</I>s may be in the form of
<B>/proc/net/rpc/nfs</B>
(raw client stats),
<B>/proc/net/rpc/nfsd</B>
(raw server stats), or saved output from
<B>nfsstat</B>
itself (client and/or server stats). Any statistics missing from a saved
<B>nfsstat</B>
output
<I>file</I>
are treated as zeroes.
<DT id="22"><B>-Z[interval], --sleep=[interval]</B>
<DD>
Instead of printing current statistics and immediately exiting,
<B>nfsstat</B>
takes a snapshot of the current statistics and pauses until it receives
<B>SIGINT</B>
(typically from
<B>Ctrl-C</B>),
at which point it takes another snapshot and displays the difference
between the two.
If <I>interval</I> is specified,
<B>nfsstat</B>
will print the number of <B>NFS</B> calls made since the previous report.
Stats will be printed repeatedly every <I>interval</I> seconds.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLES</H2>
<DL COMPACT>
<DT id="23"><B>nfsstat -o all -234</B>
<DD>
Show all information about all versions of <B>NFS</B>.
<DT id="24"><B>nfsstat --verbose -234</B>
<DD>
Same as above.
<DT id="25"><B>nfsstat -o all</B>
<DD>
Show all information about active versions of <B>NFS</B>.
<DT id="26"><B>nfsstat --nfs --server -3</B>
<DD>
Show statistics for <B>NFS</B> version 3 server.
<DT id="27"><B>nfsstat -m</B>
<DD>
Show information about mounted <B>NFS</B> filesystems.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>DISPLAY</H2>
The <B>Flags</B> output from the <B>-m</B> option is the same as the
flags give to the <B>mount</B> command.
<A NAME="lbAH">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="28"><B>/proc/net/rpc/nfsd</B>
<DD>
<B>procfs</B>-based
interface to kernel NFS server statistics.
<DT id="29"><B>/proc/net/rpc/nfs</B>
<DD>
<B>procfs</B>-based
interface to kernel NFS client statistics.
<DT id="30"><B>/proc/mounts</B>
<DD>
<B>procfs</B>-based
interface to the mounted filesystems.
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+rpc.nfsd">rpc.nfsd</A></B>(8).
<B><A HREF="/cgi-bin/man/man2html?5+nfs">nfs</A></B>(5).
<A NAME="lbAJ">&nbsp;</A>
<H2>BUGS</H2>
The default output has been changed. To get the old default output you must run <B>nfsstat --auto -2</B>.
<P>
The function of the <B>-v</B> and <B>-a</B> options have changed. The <B>-a</B> option
is now reserved for future use. The <B>-v</B> does what the <B>-a</B> option used to do,
and the new <B>-[234]</B> options replace the <B>-v</B> option.
<P>
The <B>Display</B> section should be more complete.
<P>
Further bugs can be found or reported at
<B><A HREF="http://nfs.sf.net/">http://nfs.sf.net/</A></B>.
<A NAME="lbAK">&nbsp;</A>
<H2>AUTHOR</H2>
Olaf Kirch, &lt;<A HREF="mailto:okir@suse.de">okir@suse.de</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="31"><A HREF="#lbAB">NAME</A><DD>
<DT id="32"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="33"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="34"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="35"><A HREF="#lbAF">EXAMPLES</A><DD>
<DT id="36"><A HREF="#lbAG">DISPLAY</A><DD>
<DT id="37"><A HREF="#lbAH">FILES</A><DD>
<DT id="38"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="39"><A HREF="#lbAJ">BUGS</A><DD>
<DT id="40"><A HREF="#lbAK">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>