btrace(8)

1BTRACE(8)                                                            BTRACE(8)
2
3
4

NAME

6       btrace - perform live tracing for block devices
7
8
9

SYNOPSIS

11       btrace  [-s]  [-t]  [-w N] [-n N] [-b N] [-r <dbg mnt>] [-a <trace>...]
12       <dev>...
13
14
15

DESCRIPTION

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

OPTIONS

24       -s Displays data sorted by program (see blkparse (1)).
25
26
27       -t Displays time deltas per IO (see blkparse (1)).
28
29
30       -w  N  Sets  run  time to the number of seconds specified (see blktrace
31           (8)).
32
33
34       -n N Specifies the number of buffers to use (see blktrace (8)).
35
36
37       -b N Specifies buffer size for event extraction (scaled by  1024)  (see
38           blktrace (8)).
39
40
41       -r <dbg mnt> Specifies the debugfs mountpoint.
42
43
44       -a <trace>...  Adds mask to current filter (see blktrace (8)).
45
46
47       <dev> Specifies the device to trace.
48
49
50

EXAMPLE

52       Simply running
53
54           % btrace /dev/sda
55
56       will show a trace of the device /dev/sda.
57
58
59

AUTHORS

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

REPORTING BUGS

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

COPYRIGHT

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