| 1 |
.\" |
| 2 |
.\" nfsstat(8) |
| 3 |
.\" |
| 4 |
.\" Copyright (C) 1996-2005 Olaf Kirch <[email protected]> |
| 5 |
.TH nfsstat 8 "7 Aug 2007" |
| 6 |
.SH NAME |
| 7 |
nfsstat \- list NFS statistics |
| 8 |
.SH SYNOPSIS |
| 9 |
.B nfsstat |
| 10 |
[\fIOPTION\fR]... |
| 11 |
.SH DESCRIPTION |
| 12 |
The |
| 13 |
.B nfsstat |
| 14 |
displays statistics kept about NFS client and server activity. |
| 15 |
.SH OPTIONS |
| 16 |
.TP |
| 17 |
.B \-s, \-\-server |
| 18 |
Print only server-side statistics. The default is to print both server and |
| 19 |
client statistics. |
| 20 |
.TP |
| 21 |
.B \-c, \-\-client |
| 22 |
Print only client-side statistics. |
| 23 |
.TP |
| 24 |
.B \-n, \-\-nfs |
| 25 |
Print only NFS statistics. The default is to print both NFS and RPC |
| 26 |
information. |
| 27 |
.TP |
| 28 |
.B \-2 |
| 29 |
Print only NFS v2 statistics. The default is to only print information |
| 30 |
about the versions of \fBNFS\fR that have non-zero counts. |
| 31 |
.TP |
| 32 |
.B \-3 |
| 33 |
Print only NFS v3 statistics. The default is to only print information |
| 34 |
about the versions of \fBNFS\fR that have non-zero counts. |
| 35 |
.TP |
| 36 |
.B \-4 |
| 37 |
Print only NFS v4 statistics. The default is to only print information |
| 38 |
about the versions of \fBNFS\fR that have non-zero counts. |
| 39 |
.TP |
| 40 |
.B \-m, \-\-mounts |
| 41 |
Print information about each of the mounted \fBNFS\fR file systems. |
| 42 |
|
| 43 |
If this option is used, all other options are ignored. |
| 44 |
.TP |
| 45 |
.B \-r, \-\-rpc |
| 46 |
Print only RPC statistics. |
| 47 |
.TP |
| 48 |
.BI \-o " facility |
| 49 |
Display statistics for the specified facility, which must be one of: |
| 50 |
.RS |
| 51 |
.TP |
| 52 |
.B nfs |
| 53 |
NFS protocol information, split up by RPC call. |
| 54 |
.TP |
| 55 |
.B rpc |
| 56 |
General RPC information. |
| 57 |
.TP |
| 58 |
.B net |
| 59 |
Network layer statistics, such as the number of received packets, number |
| 60 |
of TCP connections, etc. |
| 61 |
.TP |
| 62 |
.B fh |
| 63 |
Usage information on the server's file handle cache, including the |
| 64 |
total number of lookups, and the number of hits and misses. |
| 65 |
.TP |
| 66 |
.B rc |
| 67 |
Usage information on the server's request reply cache, including the |
| 68 |
total number of lookups, and the number of hits and misses. |
| 69 |
.TP |
| 70 |
.B io |
| 71 |
Usage information on the server's io statistics; bytes read and |
| 72 |
written. |
| 73 |
.TP |
| 74 |
.B ra |
| 75 |
Usage information on the server's read ahead cache, including the |
| 76 |
ra cache size, the depth of ra cache hits, and ra cache misses. |
| 77 |
.TP |
| 78 |
.B all |
| 79 |
Display all of the above facilities. |
| 80 |
.RE |
| 81 |
.TP |
| 82 |
.B \-v, \-\-verbose |
| 83 |
This is equivalent to \fB\-o all\fR. |
| 84 |
.TP |
| 85 |
.B \-l, \-\-list |
| 86 |
Print information in list form. |
| 87 |
.TP |
| 88 |
.BI "\-S, \-\-since " file |
| 89 |
Instead of printing current statistics, |
| 90 |
.B nfsstat |
| 91 |
imports statistics from |
| 92 |
.I file |
| 93 |
and displays the difference between those and the current statistics. |
| 94 |
Valid input |
| 95 |
.IR file "s may be in the form of " |
| 96 |
.B /proc/net/rpc/nfs |
| 97 |
(raw client stats), |
| 98 |
.B /proc/net/rpc/nfsd |
| 99 |
(raw server stats), or saved output from |
| 100 |
.B nfsstat |
| 101 |
itself (client and/or server stats). Any statistics missing from a saved |
| 102 |
.B nfsstat |
| 103 |
output |
| 104 |
.I file |
| 105 |
are treated as zeroes. |
| 106 |
.TP |
| 107 |
.B \-Z[interval], \-\-sleep=[interval] |
| 108 |
Instead of printing current statistics and immediately exiting, |
| 109 |
.B nfsstat |
| 110 |
takes a snapshot of the current statistics and pauses until it receives |
| 111 |
.B SIGINT |
| 112 |
(typically from |
| 113 |
.BR Ctrl-C ), |
| 114 |
at which point it takes another snapshot and displays the difference |
| 115 |
between the two. |
| 116 |
If \fIinterval\fR is specified, |
| 117 |
.B nfsstat |
| 118 |
will print the number of \fBNFS\fR calls made since the previous report. |
| 119 |
Stats will be printed repeatedly every \fIinterval\fR seconds. |
| 120 |
.\" --------------------- EXAMPLES ------------------------------- |
| 121 |
.SH EXAMPLES |
| 122 |
.TP |
| 123 |
.B nfsstat \-o all \-234 |
| 124 |
Show all information about all versions of \fBNFS\fR. |
| 125 |
.TP |
| 126 |
.B nfsstat \-\-verbose \-234 |
| 127 |
Same as above. |
| 128 |
.TP |
| 129 |
.B nfsstat \-o all |
| 130 |
Show all information about active versions of \fBNFS\fR. |
| 131 |
.TP |
| 132 |
.B nfsstat \-\-nfs \-\-server \-3 |
| 133 |
Show statistics for \fBNFS\fR version 3 server. |
| 134 |
.TP |
| 135 |
.B nfsstat \-m |
| 136 |
Show information about mounted \fBNFS\fR filesystems. |
| 137 |
.\" --------------------- DISPLAY -------------------------------- |
| 138 |
.SH DISPLAY |
| 139 |
The \fBFlags\fR output from the \fB\-m\fR option is the same as the |
| 140 |
flags give to the \fBmount\fR command. |
| 141 |
.\" --------------------- FILES ---------------------------------- |
| 142 |
.SH FILES |
| 143 |
.TP |
| 144 |
.B /proc/net/rpc/nfsd |
| 145 |
.BR procfs -based |
| 146 |
interface to kernel NFS server statistics. |
| 147 |
.TP |
| 148 |
.B /proc/net/rpc/nfs |
| 149 |
.BR procfs -based |
| 150 |
interface to kernel NFS client statistics. |
| 151 |
.TP |
| 152 |
.B /proc/mounts |
| 153 |
.BR procfs -based |
| 154 |
interface to the mounted filesystems. |
| 155 |
.\" -------------------- SEE ALSO -------------------------------- |
| 156 |
.SH SEE ALSO |
| 157 |
.BR rpc.nfsd (8). |
| 158 |
.BR nfs (5). |
| 159 |
.\" ---------------------- BUGS ---------------------------------- |
| 160 |
.SH BUGS |
| 161 |
The default output has been changed. To get the old default output you must run \fBnfsstat \-\-auto \-2\fR. |
| 162 |
.P |
| 163 |
The function of the \fB\-v\fR and \fB\-a\fR options have changed. The \fB\-a\fR option |
| 164 |
is now reserved for future use. The \fB\-v\fR does what the \fB\-a\fR option used to do, |
| 165 |
and the new \fB\-[234]\fR options replace the \fB\-v\fR option. |
| 166 |
.P |
| 167 |
The \fBDisplay\fR section should be more complete. |
| 168 |
.P |
| 169 |
Further bugs can be found or reported at |
| 170 |
.BR http://nfs.sf.net/ . |
| 171 |
.\" -------------------- AUTHOR ---------------------------------- |
| 172 |
.SH AUTHOR |
| 173 |
Olaf Kirch, <[email protected]> |