Debian Codegraph @

upstream/debian-unstable/man8/nfsstat.8

raw
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]>