path: root/doc
diff options
authorBas Zoetekouw <>2008-02-22 11:25:51 +0100
committerJens Axboe <>2008-02-22 15:23:38 +0100
commitbf46286a9e537ee177f795195bf059a09d1f4089 (patch)
tree3bd915111fab038e193876756a7ed35117d141a7 /doc
parent8b10aae0cd4137f1cc9848181e4f45a9fa20de24 (diff)
Added man page for bno_plot and updated btt man page to refer to bno_plot
Signed-off-by: Jens Axboe <>
Diffstat (limited to 'doc')
1 files changed, 64 insertions, 0 deletions
diff --git a/doc/bno_plot.1 b/doc/bno_plot.1
new file mode 100644
index 0000000..565c2ba
--- /dev/null
+++ b/doc/bno_plot.1
@@ -0,0 +1,64 @@
+.TH BTT 1 "February 22, 2007" "blktrace git\-20080213182518" ""
+bno_plot \- generate interactive 3D plot of IO blocks and sizes
+.B bno_plot
+[ \-h | \-\-help ]
+ [ \-v | \-\-verbose ]
+ [ \-K | \-\-keys-below ]
+ [ <file...> ]
+bno_plot is a visualization tool for the block layer IO tracing tool called
+blktrace(8). As noted in its documentation, blktrace
+is a block layer IO tracing mechanism which provides detailed
+information about request queue operations up to user space.
+bno_plot utilizes gnuplot to generate a 3D plot of the block number output from
+btt. If no \fI<files>\fR are specified, it will utilize all files generated after
+btt was run with \fI-B blknos\fR (meaning: all files of the form \fIblknos*[rw].dat\fR).
+The \fI-K\fR option forces bno_plot to put the keys below the graph. If it is
+not specified, all keys for input files are put in the upper right corner of the
+graph. If the number of devices exceed 10, then bno_plot will automatically
+push the keys under the graph.
+To use this utility, the gnuplot package needs to be installed.
+To exit the plotter, enter 'quit' or ^D at the 'gnuplot> ' prompt.
+\fIbno_plot\fR was written by Alan D. Brunelle. This man page was created
+from the \fIblktrace\fR documentation by Bas Zoetekouw.
+Report bugs to <linux\>
+Copyright \(co 2008 Hewlett-Packard Development Company, L.P.
+This is free software. You may redistribute copies of it under the terms of
+the GNU General Public License <>.
+There is NO WARRANTY, to the extent permitted by law.
+This manual page was created for Debian by Bas Zoetekouw. It was derived from
+the documentation provided by the authors and it may be used, distributed and
+modified under the terms of the GNU General Public License, version 2.
+On Debian systems, the text of the GNU General Public License can be found in
+btt (1), gnuplot (1), blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1)