Debian Codegraph @

upstream/debian-unstable/man8/nfsiostat.8

raw
1 .\"
2 .\" nfsiostat(8)
3 .\"
4 .TH nfsiostat 8 "15 Apr 2010"
5 .SH NAME
6 nfsiostat \- Emulate iostat for NFS mount points using /proc/self/mountstats
7 .SH SYNOPSIS
8 .BI "nfsiostat [[" <interval> "] [" <count> "]] [" <options> "]["<mount_point> "]
9 .SH DESCRIPTION
10 The
11 .B nfsiostat
12 command displays NFS client per-mount statistics.
13 .TP
14 <interval>
15 specifies the amount of time in seconds between each report.
16 The first report contains statistics for the time since each file
17 system was mounted. Each subsequent report contains statistics collected
18 during the interval since the previous report.
19 .TP
20 <count>
21 If the
22 .I <count>
23 parameter is
24 specified, the value of
25 .I <count>
26 determines the number of reports generated at
27 .I <interval>
28 seconds apart. if the interval parameter is
29 specified without the
30 .I <count>
31 parameter, the command generates reports continuously.
32 .TP
33 <options>
34 Define below
35 .TP
36 <mount_point>
37 If one or more
38 .I <mount point>
39 names are specified, statistics for only these mount points will
40 be displayed. Otherwise, all NFS mount points on the client are listed.
41 .TP
42 The meaning of each column of \fBnfsiostat\fR's output is the following:
43 .RS 8
44 - \fBop/s\fR
45 .RS
46 This is the number of operations per second.
47 .RS
48 .RE
49 .RE
50 .RE
51 .RS 8
52 - \fBrpc bklog\fR
53 .RS
54 This is the length of the backlog queue.
55 .RE
56 .RE
57 .RE
58 .RS 8
59 - \fBkB/s\fR
60 .RS
61 This is the number of kB written/read per second.
62 .RE
63 .RE
64 .RE
65 .RS 8
66 - \fBkB/op\fR
67 .RS
68 This is the number of kB written/read per each operation.
69 .RE
70 .RE
71 .RE
72 .RS 8
73 - \fBretrans\fR
74 .RS
75 This is the number of retransmissions.
76 .RE
77 .RE
78 .RE
79 .RS 8
80 - \fBavg RTT (ms)\fR
81 .RS
82 This is the duration from the time that client's kernel sends the RPC request until the time it receives the reply.
83 .RE
84 .RE
85 .RE
86 .RS 8
87 - \fBavg exe (ms)\fR
88 .RS
89 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.
90 .RE
91 .RE
92 .RE
93 .RS 8
94 - \fBavg queue (ms)\fR
95 .RS
96 This is the duration from the time the NFS client created the RPC request task to the time the request is transmitted.
97 .RE
98 .RE
99 .RE
100 .RS 8
101 - \fBerrors\fR
102 .RS
103 This is the number of operations that completed with an error status (status < 0). This count is only available on kernels with RPC iostats version 1.1 or above.
104 .RS
105 .RE
106 .RE
107 .RE
108 .TP
109 Note that if an interval is used as argument to \fBnfsiostat\fR, then the difference from previous interval will be displayed, otherwise the results will be from the time that the share was mounted.
110
111 .SH OPTIONS
112 .TP
113 .B \-a " or " \-\-attr
114 displays statistics related to the attribute cache
115 .TP
116 .B \-d " or " \-\-dir
117 displays statistics related to directory operations
118 .TP
119 .B \-h " or " \-\-help
120 shows help message and exit
121 .TP
122 .B \-l LIST or " \-\-list=LIST
123 only print stats for first LIST mount points
124 .TP
125 .B \-p " or " \-\-page
126 displays statistics related to the page cache
127 .TP
128 .B \-s " or " \-\-sort
129 Sort NFS mount points by ops/second
130 .TP
131 .B \-\-version
132 show program's version number and exit
133 .SH FILES
134 .TP
135 .B /proc/self/mountstats
136 .SH SEE ALSO
137 .BR iostat (8),
138 .BR mountstats (8),
139 .BR nfsstat(8)
140 .SH AUTHOR
141 Chuck Lever <[email protected]>