doc/btrace.8

   1 .TH BTRACE 8 "March  6, 2007" "blktrace git\-20070306202522" ""
   2
   3
   4 .SH NAME
   5 btrace \- perform live tracing for block devices
   6
   7
   8 .SH SYNOPSIS
   9 .B btrace [\-s] [\-t] [\-w \fIN\fN] [\-n \fIN\fR] [\-b \fIN\fR] [\-r \fI<dbg mnt>\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 do live tracing of
  16 block devices.  It calls \fIblktrace\fR on the specified devices
  17 and pipes the 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 Displays 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 \-r \fI<dbg mnt>\fR
  45 Specifies the debugfs mountpoint.
  46
  47 .HP 4
  48 .B \-a <\fItrace\fR>...
  49 Adds mask to current filter (see \fIblktrace\fR (8)).
  50
  51 .HP 4
  52 .B <\fIdev\fR>
  53 Specifies the device to trace.
  54
  55
  56 .SH EXAMPLE
  57 Simply running
  58
  59     % btrace /dev/sda
  60
  61 will show a trace of the device \fI/dev/sda\fR.
  62
  63
  64 .SH AUTHORS
  65 \fIblkparse\fR was written by Jens Axboe, Alan D. Brunelle and Nathan Scott.  This
  66 man page was created from the \fIblktrace\fR documentation by Bas Zoetekouw.
  67
  68
  69 .SH "REPORTING BUGS"
  70 Report bugs to <linux\-btrace@vger.kernel.org>
  71
  72 .SH COPYRIGHT
  73 Copyright \(co 2006 Jens Axboe, Alan D. Brunelle and Nathan Scott.
  74 .br
  75 This is free software.  You may redistribute copies of it under the terms of
  76 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  77 There is NO WARRANTY, to the extent permitted by law.
  78 .br
  79 This manual page was created for Debian by Bas Zoetekouw.  It was derived from
  80 the documentation provided by the authors and it may be used, distributed and
  81 modified under the terms of the GNU General Public License, version 2.
  82 .br
  83 On Debian systems, the text of the GNU General Public License can be found in
  84 /usr/share/common\-licenses/GPL\-2.
  85
  86 .SH "SEE ALSO"
  87 blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1), btt (1)
  88