Commit | Line | Data |
---|---|---|
fbdf23ec | 1 | .TH BNO_PLOT 1 "February 22, 2007" "blktrace git\-20080213182518" "" |
bf46286a BZ |
2 | |
3 | ||
4 | .SH NAME | |
5 | bno_plot \- generate interactive 3D plot of IO blocks and sizes | |
6 | ||
7 | ||
8 | .SH SYNOPSIS | |
9 | .B bno_plot | |
10 | [ \-h | \-\-help ] | |
11 | .br | |
12 | [ \-v | \-\-verbose ] | |
13 | .br | |
14 | [ \-K | \-\-keys-below ] | |
15 | .br | |
16 | [ <file...> ] | |
17 | .br | |
18 | ||
19 | ||
20 | .SH DESCRIPTION | |
21 | ||
22 | bno_plot is a visualization tool for the block layer IO tracing tool called | |
23 | blktrace(8). As noted in its documentation, blktrace | |
24 | is a block layer IO tracing mechanism which provides detailed | |
25 | information about request queue operations up to user space. | |
26 | ||
27 | bno_plot utilizes gnuplot to generate a 3D plot of the block number output from | |
28 | btt. If no \fI<files>\fR are specified, it will utilize all files generated after | |
29 | btt was run with \fI-B blknos\fR (meaning: all files of the form \fIblknos*[rw].dat\fR). | |
30 | ||
31 | The \fI-K\fR option forces bno_plot to put the keys below the graph. If it is | |
32 | not specified, all keys for input files are put in the upper right corner of the | |
33 | graph. If the number of devices exceed 10, then bno_plot will automatically | |
34 | push the keys under the graph. | |
35 | ||
36 | To use this utility, the gnuplot package needs to be installed. | |
37 | ||
38 | To exit the plotter, enter 'quit' or ^D at the 'gnuplot> ' prompt. | |
39 | ||
40 | .SH AUTHORS | |
41 | \fIbno_plot\fR was written by Alan D. Brunelle. This man page was created | |
42 | from the \fIblktrace\fR documentation by Bas Zoetekouw. | |
43 | ||
44 | ||
45 | .SH "REPORTING BUGS" | |
46 | Report bugs to <linux\-btrace@vger.kernel.org> | |
47 | ||
48 | .SH COPYRIGHT | |
49 | Copyright \(co 2008 Hewlett-Packard Development Company, L.P. | |
50 | .br | |
51 | This is free software. You may redistribute copies of it under the terms of | |
52 | the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. | |
53 | There is NO WARRANTY, to the extent permitted by law. | |
54 | .br | |
55 | This manual page was created for Debian by Bas Zoetekouw. It was derived from | |
56 | the documentation provided by the authors and it may be used, distributed and | |
57 | modified under the terms of the GNU General Public License, version 2. | |
58 | .br | |
59 | On Debian systems, the text of the GNU General Public License can be found in | |
60 | /usr/share/common\-licenses/GPL\-2. | |
61 | ||
62 | .SH "SEE ALSO" | |
63 | btt (1), gnuplot (1), blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1) | |
64 |