Debian Codegraph @

upstream/debian-unstable/man8/mountstats.8

raw
1 .\"
2 .\" mountstats(8)
3 .\"
4 .TH mountstats 8 "12 Dec 2014"
5 .SH NAME
6 mountstats \- Displays various NFS client per-mount statistics
7 .SH SYNOPSIS
8 .B mountstats
9 .RB [ \-h | \-\-help ]
10 .RB [ \-v | \-\-version ]
11 .RB [ \-f | \-\-file
12 .IR infile ]
13 .RB [ \-S | \-\-since
14 .IR sincefile ]
15 .\" .RB [ \-n | \-\-nfs | \-r | \-\-rpc | \-R | \-\-raw ]
16 [
17 .RB [ \-n | \-\-nfs ]
18 |
19 .RB [ \-r | \-\-rpc ]
20 |
21 .RB [ \-R | \-\-raw ]
22 |
23 .RB [ \-x | \-\-xprt ]
24 ]
25 .RI [ mountpoint ] ...
26 .P
27 .B mountstats iostat
28 .RB [ \-h | \-\-help ]
29 .RB [ \-v | \-\-version ]
30 .RB [ \-f | \-\-file
31 .IR infile ]
32 .RB [ \-S | \-\-since
33 .IR sincefile ]
34 .RI [ interval ]
35 .RI [ count ]
36 .RI [ mountpoint ] ...
37 .P
38 .B mountstats nfsstat
39 .RB [ \-h | \-\-help ]
40 .RB [ \-v | \-\-version ]
41 .RB [ \-f | \-\-file
42 .IR infile ]
43 .RB [ \-S | \-\-since
44 .IR sincefile ]
45 .RB [ \-3 ]
46 .RB [ \-4 ]
47 .RI [ mountpoint ] ...
48 .P
49 .SH DESCRIPTION
50 .RB "The " mountstats " command displays various NFS client statistics for each given"
51 .IR mountpoint .
52 .P
53 .RI "If no " mountpoint " is given, statistics will be displayed for all NFS mountpoints on the client."
54 .SS Sub-commands
55 Valid
56 .BR mountstats (8)
57 subcommands are:
58 .IP "\fBmountstats\fP"
59 Display a combination of per-op RPC statistics, NFS event counts, and NFS byte counts. This is the default sub-command that will be executed if no sub-command is given.
60 .IP "\fBiostat\fP"
61 Display iostat-like statistics.
62 .IP "\fBnfsstat\fP"
63 Display nfsstat-like statistics.
64 .SH OPTIONS
65 .SS Options valid for all sub-commands
66 .TP
67 .B \-h, \-\-help
68 show the help message and exit
69 .TP
70 .B \-v, \-\-version
71 show program's version number and exit
72 .TP
73 \fB\-f \fIinfile\fR, \fB\-\-file \fIinfile
74 Read stats from
75 .I infile
76 instead of
77 .IR /proc/self/mountstats ". " infile
78 must be in the same format as
79 .IR /proc/self/mountstats .
80 This may be used with the
81 .BR \-S | \-\-since
82 options to display the delta between two different points in time.
83 This may not be used with the
84 .IR interval " or " count
85 options of the
86 .B iostat
87 sub-command.
88 .TP
89 \fB\-S \fIsincefile\fR, \fB\-\-since \fIsincefile
90 Show difference between current stats and those in
91 .IR sincefile ". " sincefile
92 must be in the same format as
93 .IR /proc/self/mountstats .
94 This may be used with the
95 .BR \-f | \-\-file
96 options to display the delta between two different points in time.
97 This may not be used with the
98 .IR interval " or " count
99 options of the
100 .B iostat
101 sub-command.
102 .SS Options specific to the mountstats sub-command
103 .B \-n, \-\-nfs
104 Display only the NFS statistics
105 .TP
106 .B \-r, \-\-rpc
107 Display only the RPC statistics
108 .TP
109 .B \-R, \-\-raw
110 Display only the raw statistics. This is intended for use with the
111 .BR \-f | \-\-file
112 and
113 .BR \-S | \-\-since
114 options.
115 .TP
116 .B \-x, \-\-xprt
117 Display only the transport statistics
118 .SS Options specific to the iostat sub-command
119 .IP "\fIinterval\fP"
120 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. This may not be used with the
121 .BR \-f | \-\-file
122 or
123 .BR \-S | \-\-since
124 options.
125 .P
126 .IP "\fIcount\fP"
127 Determines the number of reports generated at
128 .I interval
129 seconds apart. If the
130 .I interval
131 parameter is specified without the
132 .I count
133 parameter, the command generates reports continuously. This may not be used with the
134 .BR \-f | \-\-file
135 or
136 .BR \-S | \-\-since
137 options.
138 .SS Options specific to the nfsstat sub-command
139 .IP "\fB\-3\fP"
140 Show only NFS version 3 statistics. The default is to show both version 3 and version 4 statistics.
141 .IP "\fB\-4\fP"
142 Show only NFS version 4 statistics. The default is to show both version 3 and version 4 statistics.
143 .SH FILES
144 .TP
145 .B /proc/self/mountstats
146 .SH SEE ALSO
147 .BR iostat (8),
148 .BR nfsiostat (8),
149 .BR nfsstat (8)
150 .SH AUTHOR
151 Chuck Lever <[email protected]>