btrace(8) — Linux manual page


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>...] <dev>...

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

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 (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         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),

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 2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-12.)  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)

Pages that refer to this page: blkparse(1)blkrawverify(1)verify_blkparse(1)blkiomon(8)blktrace(8)