Commit | Line | Data |
---|---|---|
63eba147 JA |
1 | blktrace Timeline |
2 | ----------------- | |
3 | ||
4 | Alan D. Brunelle (initial version) | |
5 | ||
6 | Usage | |
7 | ----- | |
8 | ||
80c27cbe ADB |
9 | Usage: btt |
10 | [ -d <seconds> | --range-delta=<seconds> ] | |
11 | [ -D <dev;...> | --devices=<dev;...> ] | |
12 | [ -e <exe,...> | --exes=<exe,...> ] | |
13 | [ -h | --help ] | |
14 | [ -i <input name> | --input-file=<input name> ] | |
15 | [ -I <output name> | --iostat=<output name> ] | |
b2ecdd0f | 16 | [ -l <output name> | --d2c-latencies=<output name> ] |
80c27cbe ADB |
17 | [ -M <dev map> | --dev-maps=<dev map> |
18 | [ -o <output name> | --output-file=<output name> ] | |
095181f2 | 19 | [ -p <output name> | --per-io-dump=<output name> ] |
b2ecdd0f | 20 | [ -q <output name> | --q2c-latencies=<output name> ] |
80c27cbe ADB |
21 | [ -s <output name> | --seeks=<output name> ] |
22 | [ -S <interval> | --iostat-interval=<interval> ] | |
23 | [ -V | --version ] | |
24 | [ -v | --verbose ] | |
63eba147 | 25 | |
80c27cbe | 26 | You are required to specify an input file (-i) |
63eba147 | 27 | |
80c27cbe | 28 | The -d option allows you to specify the granularity which determines |
63eba147 JA |
29 | "activity" with regard to the .dat files -- this specific the time |
30 | (in seconds) that must elapse without a particular event occuring to | |
31 | signify inactivity. The larger the number, the fewer ranges output -- | |
32 | the default is 0.1 seconds. | |
33 | ||
80c27cbe | 34 | The -D option supplies the devices which should be looked at when |
63eba147 JA |
35 | analyzing the input. This is a ":" separated list of devices, devices are |
36 | specified by a mjr,mnr tuple (e.g.: -D "8,0:8,8" specifies two devices | |
37 | with major 8 and minor 0 and 8 respectively). | |
38 | ||
80c27cbe | 39 | The -e option supplies the list of executables that will have I/Os |
63eba147 JA |
40 | analyzed. |
41 | ||
80c27cbe ADB |
42 | The -I option directs btt to output iostat-like data to the specified |
43 | file. Refer to the iostat (sysstat) documentation for details on the | |
44 | data columns. The -S option specifies the interval to use between data | |
45 | output, it defaults to once per second. | |
46 | ||
b2ecdd0f ADB |
47 | The -l and -q options allow one to output per-IO D2C and Q2C latencies |
48 | respectively. The supplied argument provides the basis for the output | |
49 | name for each device. | |
50 | ||
80c27cbe | 51 | The -M option takes in a file generated by the provided script |
63eba147 JA |
52 | (gen_disk_info.py), and allows for better output of device names. |
53 | ||
095181f2 JA |
54 | The -p option will generate a file that contains a list of all IO |
55 | "sequences" - showing the parts of each IO (Q, A, I/M, D, & C). | |
56 | ||
80c27cbe ADB |
57 | The -s option instructs btt to output seek data, the argument provided |
58 | is the basis for file names output. There are two files per device, | |
59 | read seeks and write seeks. | |
60 | ||
63eba147 JA |
61 | Overview |
62 | -------- | |
63 | ||
64 | btt will take in binary dump data from blkparse, and analyze the events, | |
65 | producing a series of output from the analysis. It will also build .dat | |
66 | files containing "range data" -- showing things like Q activity (periods | |
67 | of time while Q events are being produced), C activity (likewise for | |
68 | command completions), and etc. | |
69 | ||
70 | Resources | |
71 | --------- | |
72 | ||
73 | vger hosts a mailing list dedicated to btrace discussion and development. | |
74 | The list is called linux-btrace@vger.kernel.org, subscribe by sending | |
75 | a mail to majordomo@vger.kernel.org with 'subscribe linux-btrace' in | |
76 | the mail body. | |
77 | ||
80c27cbe | 78 | 2006-09_18, Alan D. Brunelle <alan.brunelle@hp.com> |