BTRACE(8)                                                          BTRACE(8)

NAME         top

       btrace - perform live tracing for block devices

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

       -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

       -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         top

       Simply running

           % btrace /dev/sda

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

AUTHORS         top

       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         top

       Report bugs to <>

COPYRIGHT         top

       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
       <>.  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         top

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

COLOPHON         top

       This page is part of the blktrace (Linux block layer I/O tracer)
       project.  Information about the project can be found at [unknown --
       if you know, please contact] It is not known how
       to report bugs for this man page; if you know, please send a mail to  This page was obtained from the project's
       upstream Git repository
       ⟨⟩ on
       2018-10-29.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-08-31.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

blktrace git-20070306202522    March  6, 2007                      BTRACE(8)