README

   1 Block IO Tracing
   2 ----------------
   3
   4 Written by Jens Axboe <axboe@suse.de> (initial version and kernel support) and
   5 Alan D. Brunelle (threading and splitup into two seperate programs).
   6
   7
   8 Requirements
   9 ------------
  10
  11 You need to be running a 2.6.13-mm1 kernel with the blk-trace patch
  12 included in this repository. If you forgot where you got it, the url is:
  13
  14 rsync://rsync.kernel.org/pub/scm/linux/kernel/git/axboe/blktrace.git
  15
  16 If you don't have git, you can get hourly snapshots from:
  17
  18 http://www.kernel.org/pub/linux/kernel/people/axboe/blktrace/
  19
  20 The snapshots include the full git object database as well.
  21
  22
  23 Usage
  24 -----
  25
  26 % blktrace -d <dev> [-o <output> -a <trace> [-a <trace>]]
  27         -a <trace> is one of: (use multiple -a options to get more)
  28                 READ
  29                 WRITE
  30                 BARRIER
  31                 SYNC
  32                 QUEUE
  33                 REQUEUE
  34                 ISSUE
  35                 COMPLETE
  36                 FS
  37                 PC
  38         --- run task to generate load to be traced ---
  39         <SIGINT to kill>
  40         --- Generates:
  41                 <output>_out.[0..ncpus] : Contains binary trace data
  42
  43         % blkparse -i <input> [-o <output>]
  44         --- Generates:
  45                 <output>_log.[0..ncpus] : Contains formatted trace data, if
  46                 output logging is added with the -o option.
  47                 Merged formatted trace data to stdout
  48
  49
  50 If you want to do live tracing, you can pipe the data between blktrace
  51 and blkparse:
  52
  53 % blktrace -d <device> -o - | blkparse -i -
  54
  55 This has a small risk of displaying some traces a little out of sync, since
  56 it will do batch sorts of input events. Similarly, you can do traces over
  57 the network with eg netcat:
  58
  59 % blktrace -d /dev/sda -o - | netcat parsehost portno
  60 % netcat -l -p portno tracehost | blkparse -i -
  61
  62 Which will send the traces from tracehost to parsehost over the network on
  63 the defined port number.
  64
  65
  66 20050906, Jens Axboe <axboe@suse.de>
  67