Debian Codegraph @

testsuite/systemtap.examples/lwtools/bitesize-nd.8

raw
1 .TH bitesize-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 bitesize-nd \- Measure block I/O size distribution. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B bitesize-nd.stp
6 .SH DESCRIPTION
7 This uses the kernel tracepoint block_rq_insert to read the size of I/O. The
8 output includes the name of the process or thread that was on-CPU when the I/O
9 request was inserted on the issue queue.
10 .SH REQUIREMENTS
11 SystemTap.
12 .SH EXAMPLES
13 .TP
14 Measure block I/O sizes, and show a distribution histogram for each process name on Ctrl-C:
15 #
16 .B bitesize-nd.stp
17 .SH FIELDS
18 .TP
19 value
20 The minimum size, in bytes, for this histogram bucket. Read this value
21 as "I/O size was at least xxx".
22 .TP
23 count
24 How many I/O fell into this size range.
25 .SH OVERHEAD
26 Should be low, relative to the rate of disk I/O. Test first.
27 .SH SOURCE
28 This is from the SystemTap lwtools collection.
29 .IP
30 https://github.com/brendangregg/systemtap-lwtools
31 .PP
32 Also look under the examples directory for a text file containing example
33 usage, output, and commentary for this tool.
34 .SH OS
35 Linux
36 .SH STABILITY
37 Unstable - in development.
38 .SH AUTHOR
39 Brendan Gregg
40 .SH SEE ALSO
41 biolatency-nd.stp(8), iostat(1)