Commit | Line | Data |
---|---|---|
98eee4e4 JA |
1 | .TH BTRACE 8 "March 6, 2007" "blktrace git\-20070306202522" "" |
2 | ||
3 | ||
4 | .SH NAME | |
5 | btrace \- verifies an output file produced by blkparse | |
6 | ||
7 | ||
8 | .SH SYNOPSIS | |
9 | .B Usage: btrace [\-s] [\-t] [\-w \fIN\fN] [\-n \fIN\fR] [\-b \fIN\fR] [\-a <\fItrace\fR>...] <\fIdev\fR>... | |
10 | .br | |
11 | ||
12 | ||
13 | .SH DESCRIPTION | |
14 | ||
15 | The \fIbtrace\fR script provides a quick and easy way to to live tracing of | |
16 | block devices. All it does is calling \fIblktrace\fR on the specified devices | |
17 | and piping its output through \fIblkparse\fR for formatting. See blktrace (8) | |
18 | for more in-depth information about how \fIblktrace\fR works. | |
19 | ||
20 | .SH OPTIONS | |
21 | ||
22 | .HP 4 | |
23 | .B \-s | |
24 | Displays data sorted by program (see \fIblkparse\fR (1)). | |
25 | ||
26 | .HP 4 | |
27 | .B \-t | |
28 | Display time deltas per IO (see \fIblkparse\fR (1)). | |
29 | ||
30 | .HP 4 | |
31 | .B \-w \fIN\fR | |
32 | Sets run time to the number of seconds specified (see \fIblktrace\fR (8)). | |
33 | ||
34 | .HP 4 | |
35 | .B \-n \fIN\fR | |
36 | Specifies the number of buffers to use (see \fIblktrace\fR (8)). | |
37 | ||
38 | .HP 4 | |
39 | .B \-b \fIN\fR | |
40 | Specifies buffer size for event extraction (scaled by 1024) (see | |
41 | \fIblktrace\fR (8)). | |
42 | ||
43 | .HP 4 | |
44 | .B \-a <\fItrace\fR>... | |
45 | Add mask to current filter (see \fIblktrace\fR (8)). | |
46 | ||
47 | .HP 4 | |
48 | .B <\fIdev\fR> | |
49 | Specifies the device to trace. | |
50 | ||
51 | ||
52 | .SH EXAMPLE | |
53 | Simply running | |
54 | ||
55 | % blktrace /dev/sda | |
56 | ||
57 | will show a trace of the device \fI/dev/sda\fR. | |
58 | ||
59 | ||
60 | .SH AUTHORS | |
61 | \fIblkparse\fR was written by Jens Axboe, Alan D. Brunelle and Nathan Scott. This | |
62 | man page was created from the \fIblktrace\fR documentation by Bas Zoetekouw. | |
63 | ||
64 | ||
65 | .SH "REPORTING BUGS" | |
66 | Report bugs to <linux\-btrace@vger.kernel.org> | |
67 | ||
68 | .SH COPYRIGHT | |
69 | Copyright \(co 2006 Jens Axboe, Alan D. Brunelle and Nathan Scott. | |
70 | .br | |
71 | This is free software. You may redistribute copies of it under the terms of | |
72 | the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. | |
73 | There is NO WARRANTY, to the extent permitted by law. | |
74 | .br | |
75 | This manual page was created for Debian by Bas Zoetekouw. It was derived from | |
76 | the documentation provided by the authors and it may be used, distributed and | |
77 | modified under the terms of the GNU General Public License, version 2. | |
78 | .br | |
79 | On Debian systems, the text of the GNU General Public License can be found in | |
80 | /usr/share/common\-licenses/GPL\-2. | |
81 | ||
82 | .SH "SEE ALSO" | |
83 | blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1), btt (1) | |
84 |