doc/btrace.8

   1 .TH BTRACE 8 "March  6, 2007" "blktrace git\-20070306202522" ""
   2
   3
   4 .SH NAME
   5 btrace \- verifies an output file produced by blkparse
   6
   7
   8 .SH SYNOPSIS
   9 .B Usage: btrace [\-s] [\-t] [\-w \fIN\fN] [\-n \fIN\fR] [\-b \fIN\fR]  [\-a <\fItrace\fR>...] <\fIdev\fR>...
  10 .br
  11
  12
  13 .SH DESCRIPTION
  14
  15 The \fIbtrace\fR script provides a quick and easy way to to live tracing of
  16 block devices.  All it does is calling \fIblktrace\fR on the specified devices
  17 and piping its output through \fIblkparse\fR for formatting.  See blktrace (8)
  18 for more in-depth information about how \fIblktrace\fR works.
  19
  20 .SH OPTIONS
  21
  22 .HP 4
  23 .B \-s
  24 Displays data sorted by program (see \fIblkparse\fR (1)).
  25
  26 .HP 4
  27 .B \-t
  28 Display time deltas per IO (see \fIblkparse\fR (1)).
  29
  30 .HP 4
  31 .B \-w \fIN\fR
  32 Sets run time to the number of seconds specified (see \fIblktrace\fR (8)).
  33
  34 .HP 4
  35 .B \-n \fIN\fR
  36 Specifies the number of buffers to use (see \fIblktrace\fR (8)).
  37
  38 .HP 4
  39 .B \-b \fIN\fR
  40 Specifies buffer size for event extraction (scaled by 1024) (see
  41 \fIblktrace\fR (8)).
  42
  43 .HP 4
  44 .B \-a <\fItrace\fR>...
  45 Add mask to current filter (see \fIblktrace\fR (8)).
  46
  47 .HP 4
  48 .B <\fIdev\fR>
  49 Specifies the device to trace.
  50
  51
  52 .SH EXAMPLE
  53 Simply running
  54
  55     % blktrace /dev/sda
  56
  57 will show a trace of the device \fI/dev/sda\fR.
  58
  59
  60 .SH AUTHORS
  61 \fIblkparse\fR was written by Jens Axboe, Alan D. Brunelle and Nathan Scott.  This
  62 man page was created from the \fIblktrace\fR documentation by Bas Zoetekouw.
  63
  64
  65 .SH "REPORTING BUGS"
  66 Report bugs to <linux\-btrace@vger.kernel.org>
  67
  68 .SH COPYRIGHT
  69 Copyright \(co 2006 Jens Axboe, Alan D. Brunelle and Nathan Scott.
  70 .br
  71 This is free software.  You may redistribute copies of it under the terms of
  72 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  73 There is NO WARRANTY, to the extent permitted by law.
  74 .br
  75 This manual page was created for Debian by Bas Zoetekouw.  It was derived from
  76 the documentation provided by the authors and it may be used, distributed and
  77 modified under the terms of the GNU General Public License, version 2.
  78 .br
  79 On Debian systems, the text of the GNU General Public License can be found in
  80 /usr/share/common\-licenses/GPL\-2.
  81
  82 .SH "SEE ALSO"
  83 blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1), btt (1)
  84