1 .TH BLKIOMON 8 "July 17, 2008" "" ""
5 blkiomon \- monitor block device I/O based o blktrace data
9 .B blkiomon \-I \fIinterval\fR [ \-h \fIfile\fR ] [ \-b \fIfile\fR ]
10 [ \-D \fIfile\fR ] [ \-Q \fIpath_name\fR
11 \-q \fImsg_queue_id\fR \-m \fImsg_id\fR ] [ \-V ]
16 blkiomon is a block device I/O monitor. It periodically generates per device
17 request size and request latency statistics from blktrace data. It provides
18 histograms as well as data that can be used to calculate min, max, average
19 and variance. For this purpose, it consumes D and C traces read from stdin.
21 There are options for binary output and human-readable output to files and
22 stdout. Output to a message queue is supported as well.
24 There is no need to use blkparse with blkiomon. blkiomon is capable of
25 consuming binary output written to stdout by blktrace.
32 \-\-interval=\fIinterval\fR
39 \-\-human\-readable=\fIfile\fR
41 Human-readable output file. Use '\-' for stdout.
48 Binary output file. Use '\-' for stdout.
55 Output file for debugging data. Use '\-' for stdout.
60 \-\-msg\-queue\-name=\fIpath_name\fR
62 Sets \fIpath_name\fR as path name for existing message queue to be used
66 \-q \fImsg_queue_id\fR
68 \-\-msg\-queue\-id=\fImsg_queue_id\fR
70 Sets \fImsg_queue_id\fR as ID for an existing message queue to be used
76 \-\-msg\-id=\fImsg_id\fR
78 Sets \fImsg_id\fR as message identifier to be used for binary output
79 messages written to an existing message queue.
86 Print program version.
91 To get I/O statistics for /dev/sdw every 10 seconds for a period of one hour,
92 use the following command:
94 % blktrace /dev/sdw -a issue -a complete -w 3600 -o - | blkiomon -I 10 -h -
98 blkiomon and this man page were written by Martin Peschke.
102 Report bugs to <linux\-btrace@vger.kernel.org>
106 Copyright \(co 2008 IBM Corp.
108 This is free software. You may redistribute copies of it under the terms of
109 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
110 There is NO WARRANTY, to the extent permitted by law.
114 btrace (8), blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1),