From: Alan D. Brunelle Date: Mon, 16 Apr 2007 17:16:55 +0000 (+0200) Subject: Cleaned out the btt/README file. X-Git-Tag: blktrace-0.99.3~17 X-Git-Url: https://git.kernel.dk/?a=commitdiff_plain;h=77ed842eb4ee96f0e7a69ec58bb63eb99469a087;p=blktrace.git Cleaned out the btt/README file. The documentation under btt/doc/btt.tex is current, while this is woefully out of date. Signed-off-by: Alan D. Brunelle Signed-off-by: Jens Axboe --- diff --git a/btt/README b/btt/README index 3ae7779..c395a67 100644 --- a/btt/README +++ b/btt/README @@ -3,77 +3,7 @@ blktrace Timeline Alan D. Brunelle (initial version) -Usage ------ - -Usage: btt - [ -d | --range-delta= ] - [ -D | --devices= ] - [ -e | --exes= ] - [ -h | --help ] - [ -i | --input-file= ] - [ -I | --iostat= ] - [ -l | --d2c-latencies= ] - [ -M | --dev-maps= - [ -o | --output-file= ] - [ -p | --per-io-dump= ] - [ -q | --q2c-latencies= ] - [ -s | --seeks= ] - [ -S | --iostat-interval= ] - [ -t | --time-start= ] - [ -T | --time-end= ] - [ -V | --version ] - [ -v | --verbose ] - -You are required to specify an input file (-i) - -The -d option allows you to specify the granularity which determines -"activity" with regard to the .dat files -- this specific the time -(in seconds) that must elapse without a particular event occuring to -signify inactivity. The larger the number, the fewer ranges output -- -the default is 0.1 seconds. - -The -D option supplies the devices which should be looked at when -analyzing the input. This is a ":" separated list of devices, devices are -specified by a mjr,mnr tuple (e.g.: -D "8,0:8,8" specifies two devices -with major 8 and minor 0 and 8 respectively). - -The -e option supplies the list of executables that will have I/Os -analyzed. - -The -I option directs btt to output iostat-like data to the specified -file. Refer to the iostat (sysstat) documentation for details on the -data columns. The -S option specifies the interval to use between data -output, it defaults to once per second. - -The -l and -q options allow one to output per-IO D2C and Q2C latencies -respectively. The supplied argument provides the basis for the output -name for each device. - -The -M option takes in a file generated by the provided script -(gen_disk_info.py), and allows for better output of device names. - -The -p option will generate a file that contains a list of all IO -"sequences" - showing the parts of each IO (Q, A, I/M, D, & C). - -The -s option instructs btt to output seek data, the argument provided -is the basis for file names output. There are two files per device, -read seeks and write seeks. - -The -t/-T options allow one to set a start and/or end time for analyzing -- analyzing will only be done for traces after -t's argument and before --T's argument. (-t and -T are optional, so if you specify just -t, -analysis will occur for all traces after the time specified. Similarly, -if only -T is specified, analysis stops after -T's seconds.) - -Overview --------- - -btt will take in binary dump data from blkparse, and analyze the events, -producing a series of output from the analysis. It will also build .dat -files containing "range data" -- showing things like Q activity (periods -of time while Q events are being produced), C activity (likewise for -command completions), and etc. +Please refer to the documentation for details. Resources --------- @@ -83,4 +13,5 @@ The list is called linux-btrace@vger.kernel.org, subscribe by sending a mail to majordomo@vger.kernel.org with 'subscribe linux-btrace' in the mail body. -2006-09_18, Alan D. Brunelle +2006-04-16, Alan D. Brunelle +