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 Currently, the kernel support patch isn't merged yet. The last posted patch
  12 is:
  13
  14 http://marc.theaimsgroup.com/?l=linux-kernel&m=112487579802074&w=2
  15
  16 and applies against 2.6.13-rc6-mm2. The patch is also included in the git
  17 repository you pulled to get this file:
  18
  19 rsync://rsync.kernel.org/pub/scm/linux/kernel/git/axboe/blktrace.git
  20
  21 Additionally, you need to apply the relayfs-read update patch also located
  22 in the kernel/ directory.
  23
  24
  25 Usage
  26 -----
  27
  28 To run:
  29         % blktrace <dev>
  30         --- run task to generate load to be traced ---
  31         <SIGINT to kill>
  32         --- Generates:
  33                 <dev>_dat.[0..ncpus] : Contains binary pdu data
  34                 <dev>_out.[0..ncpus] : Contains binary trace data
  35
  36         % blkparse <dev>
  37         --- Generates:
  38                 <dev>_log.[0..ncpus] : Contains formatted trace data
  39                 Merged formatted trace data to stdout
  40
  41
  42 20050826, Jens Axboe <axboe@suse.de>
  43