Man Linux: Main Page and Category List

NAME

       btrace - perform live tracing for block devices

SYNOPSIS

       btrace  [-s]  [-t]  [-w N] [-n N] [-b N] [-r <dbg mnt>] [-a <trace>...]
       <dev>...

DESCRIPTION

       The btrace script provides a quick and easy way to do live  tracing  of
       block  devices.   It  calls blktrace on the specified devices and pipes
       the output through blkparse for formatting.  See blktrace (8) for  more
       in-depth information about how blktrace works.

OPTIONS

       -s Displays data sorted by program (see blkparse (1)).

       -t Displays time deltas per IO (see blkparse (1)).

       -w  N  Sets  run  time to the number of seconds specified (see blktrace
           (8)).

       -n N Specifies the number of buffers to use (see blktrace (8)).

       -b N Specifies buffer size for event extraction (scaled by  1024)  (see
           blktrace (8)).

       -r <dbg mnt> Specifies the debugfs mountpoint.

       -a <trace>...  Adds mask to current filter (see blktrace (8)).

       <dev> Specifies the device to trace.

EXAMPLE

       Simply running

           % btrace /dev/sda

       will show a trace of the device /dev/sda.

AUTHORS

       blkparse  was written by Jens Axboe, Alan D. Brunelle and Nathan Scott.
       This man page was  created  from  the  blktrace  documentation  by  Bas
       Zoetekouw.

REPORTING BUGS

       Report bugs to <linux-btrace@vger.kernel.org>

COPYRIGHT

       Copyright © 2006 Jens Axboe, Alan D. Brunelle and Nathan Scott.
       This  is  free  software.   You may redistribute copies of it under the
       terms      of      the      GNU      General       Public       License
       <http://www.gnu.org/licenses/gpl.html>.   There  is NO WARRANTY, to the
       extent permitted by law.
       This manual page was created for  Debian  by  Bas  Zoetekouw.   It  was
       derived  from  the  documentation provided by the authors and it may be
       used, distributed and modified under  the  terms  of  the  GNU  General
       Public License, version 2.
       On  Debian  systems,  the text of the GNU General Public License can be
       found in /usr/share/common-licenses/GPL-2.

SEE ALSO

       blktrace (8), blkparse (1), verify_blkparse (1), blkrawverify (1),  btt
       (1)