Lines Matching +full:- +full:- +full:output
1 .TH BTT 1 "September 29, 2007" "blktrace git\-20070910192508" ""
5 btt \- analyse block i/o traces produces by blktrace
11 [ \-a | \-\-seek\-absolute ]
13 [ \-A | \-\-all\-data ]
15 [ \-B <\fIoutput name\fR> | \-\-dump\-blocknos=<\fIoutput name\fR> ]
17 [ \-d <\fIseconds\fR> | \-\-range\-delta=<\fIseconds\fR> ]
19 [ \-D <\fIdev;...\fR> | \-\-devices=<\fIdev;...\fR> ]
21 [ \-e <\fIexe,...\fR> | \-\-exes=<\fIexe,...\fR> ]
23 [ \-h | \-\-help ]
25 [ \-i <\fIinput name\fR> | \-\-input\-file=<\fIinput name\fR> ]
27 [ \-I <\fIoutput name\fR> | \-\-iostat=<\fIoutput name\fR> ]
29 [ \-l <\fIoutput name\fR> | \-\-d2c\-latencies=<\fIoutput name\fR> ]
31 [ \-L <\fIfreq\fR> | \-\-periodic\-latencies=<\fIfreq\fR> ]
33 [ \-m <\fIoutput name\fR> | \-\-seeks\-per\-second=<\fIoutput name\fR> ]
35 [ \-M <\fIdev map\fR> | \-\-dev\-maps=<\fIdev map\fR>
37 [ \-o <\fIoutput name\fR> | \-\-output\-file=<\fIoutput name\fR> ]
39 [ \-p <\fIoutput name\fR> | \-\-per\-io\-dump=<\fIoutput name\fR> ]
41 [ \-P <\fIoutput name\fR> | \-\-per\-io\-trees=<\fIoutput name\fR> ]
43 [ \-q <\fIoutput name\fR> | \-\-q2c\-latencies=<\fIoutput name\fR> ]
45 [ \-Q <\fIoutput name\fR> | \-\-active\-queue\-depth=<\fIoutput name\fR> ]
47 [ \-r | \-\-no\-remaps ]
49 [ \-s <\fIoutput name\fR> | \-\-seeks=<\fIoutput name\fR> ]
51 [ \-S <\fIinterval\fR> | \-\-iostat\-interval=<\fIinterval\fR> ]
53 [ \-t <\fIsec\fR> | \-\-time\-start=<\fIsec\fR> ]
55 [ \-T <\fIsec\fR> | \-\-time\-end=<\fIsec\fR> ]
57 [ \-u <\fIoutput name\fR> | \-\-unplug\-hist=<\fIoutput name\fR> ]
59 [ \-v | \-\-verbose ]
61 [ \-V | \-\-version ]
63 [ \-X | \-\-easy\-parse\-avgs ]
65 [ \-z <\fIoutput name\fR> | \-\-q2d\-latencies=<\fIoutput name\fR> ]
67 [ \-Z | \-\-do\-active ]
72 btt is a post\-processing tool for the block layer IO tracing tool called
78 producing a series of output from the analysis. It will also build .dat
79 files containing "range data" \-\- showing things like Q activity (periods
84 \fIbno_plot\fR, which can plot the block numbers btt outputs if the \fI-B\fR
86 (seconds) along the X-axis, the block number (start) along the Y-axis and the
87 number of blocks transferred in the IO represented along the Z-axis.
92 .B \-a
94 .B \-\-seek\-absolute
103 .B \-A
105 .B \-\-all\-data
108 per-process and per-device data. If you desire that level of detail you can
112 .B \-B <\fIoutput name\fR>
114 .B \-\-dump\-blocknos=<\fIoutput name\fR>
116 This option will output absolute block numbers to three files prefixed
117 by the specified output name:
121 All read block numbers are output, first column is time (seconds), second is
126 All write block numbers are output, first column is time (seconds), second is
131 All block numbers (read and write) are output, first column is time (seconds),
135 .B \-d <\fIseconds\fR>
137 .B \-\-range\-delta=<\fIseconds\fR>
146 .B \-D <\fIdev;...\fR>
148 .B \-\-devices=<\fIdev;...\fR>
158 .B \-e <\fIexe,...\fR>
160 .B \-\-exes=<\fIexe,...\fR>
162 The \-e option supplies the list of executables that will have I/Os
166 .B \-h
168 .B \-\-help
173 .B \-i <\fIinput name\fR>
175 .B \-\-input\-file <\fIinput file\fR>
181 .B \-I <\fIoutput name\fR>
183 .B \-\-iostat=<\fIoutput name\fR>
185 The \-I option directs btt to output iostat\-like data to the specified
190 .B \-l <\fIoutput name\fR>
192 .B \-\-d2c\-latencies=<\fIoutput name\fR>
194 The \-l option allows one to output per\-IO D2C latencies
195 respectively. The supplied argument provides the basis for the output
199 .B \-L <\fIfreq\fR>
201 .B \-\-periodic\-latencies=<\fIfreq\fR>
203 The \-L option allows one to output periodic latency information for both
205 an average latency is output -- a floating point value expressing seconds.
208 .B \-m <\fIoutput name\fR>
210 .B \-\-seeks\-per\-second=<\fIoutput name\fR>
212 Trigger btt to output seeks-per-second information. The first column will
217 .B \-M <\fIdev map\fR>
219 .B \-\-dev\-maps=<\fIdev map\fR>
221 The \-M option takes in a file generated by the provided script
222 (gen_disk_info.py), and allows for better output of device names.
225 .B \-o <\fIoutput name\fR>
227 .B \-\-output\-file=<\fIoutput name\fR>
229 Specifies the output file name.
232 .B \-p <\fIoutput name\fR>
234 .B \-\-per\-io\-dump=<\fIoutput name\fR>
236 The \-p option will generate a file that contains a list of all IO
237 "sequences" \- showing the parts of each IO (Q, A, I/M, D, & C).
240 .B \-P <\fIoutput name\fR>
242 .B \-\-per\-io\-trees=<\fIoutput name\fR>
244 The \-P option will generate a file that contains a list of all IO
245 "sequences" \- showing only the Q, D & C operation times. The D & C
249 .B \-q <\fIoutput name\fR>
251 .B \-\-q2c\-latencies=<\fIoutput name\fR>
253 The \-q option allows one to output per\-IO Q2C latencies
254 respectively. The supplied argument provides the basis for the output
258 .B \-Q <\fIoutput name\fR>
260 .B \-\-active\-queue\-depth=<\fIoutput name\fR>
262 The \-Q option allows one to output data files showing the time stamp
266 .B \-r
268 .B \-\-no\-remaps
274 .B \-s <\fIoutput name\fR>
276 .B \-\-seeks=<\fIoutput name\fR>
278 The \-s option instructs btt to output seek data, the argument provided
279 is the basis for file names output. There are two files per device,
283 .B \-S <\fIinterval\fR>
285 .B \-\-iostat\-interval=<\fIinterval\fR>
287 The \-S option specifies the interval to use between data
288 output, it defaults to once per second.
291 .B \-t <\fIsec\fR>
293 .B \-\-time\-start=<\fIsec\fR>
295 .B \-T <\fIsec\fR>
297 .B \-\-time\-end=<\fIsec\fR>
299 The \-t/\-T options allow one to set a start and/or end time for analysing
300 \- analysing will only be done for traces after \-t's argument and before
301 \-T's argument. (\-t and \-T are optional, so if you specify just \-t,
303 if only \-T is specified, analysis stops after \-T's seconds.)
306 .B \-u <\fIoutput name\fR>
308 .B \-\-unplug\-hist=<\fIoutput name\fR>
313 output values into the file, as follows:
330 form, with a \fI.dat\fR extension. For example, with \fI\-u
334 .B \-V
336 .B \-\-version
341 .B \-v
343 .B \-\-verbose
345 Requests a more verbose output.
348 .B \-X
350 .B \-\-easy\-parse\-avgs
352 Provide data in an easy-to-parse form and write it to a file
356 .B \-z <\fIoutput name\fR>
358 .B \-\-q2d\-latencies=<\fIoutput name\fR>
360 The \-z option allows one to output per\-IO Q2D latencies
361 respectively. The supplied argument provides the basis for the output
365 .B \-Z
367 .B \-\-do\-active
369 The \-Z will output files containing data which can be plotted showing
370 per\-device (and total system) I/O activity.
380 Report bugs to <linux\-btrace@vger.kernel.org>
394 /usr/share/common\-licenses/GPL\-2.