1BABELTRACE(1) BABELTRACE(1)
2
3
4
6 babeltrace — Babeltrace Trace Viewer and Converter
7
8
10 babeltrace [OPTIONS] FILE...
11
13 Babeltrace is a trace viewer and converter reading and writing the Com‐
14 mon Trace Format (CTF). Its main use is to pretty-print CTF traces into
15 a human-readable text output ordered by time.
16
17
18 This program follow the usual GNU command line syntax with long options
19 starting with two dashes. Below is a summary of the available options.
20
21 FILE Input trace FILE(s) or directory(ies)
22
23 -w, --output OUTPUT
24 Output trace path (default: stdout)
25
26 -i, --input-format FORMAT
27 Input trace format (default: ctf). CTF is currently the only
28 supported input format.
29
30 -o, --output-format FORMAT
31 Output trace format (default: text)
32
33 -h, --help
34 This help message
35
36 -l, --list
37 List available formats
38
39 -v, --verbose
40 Verbose mode (or set BABELTRACE_VERBOSE environment variable)
41
42 -d, --debug
43 Debug mode (or set BABELTRACE_DEBUG environment variable)
44
45 --no-delta
46 Do not print time delta between consecutive events
47
48 -n, --names name1<,name2,...>
49 Print field names: (payload OR args OR arg), none, all, scope,
50 header, (context OR ctx), (default: payload,context).
51
52 -f, --fields name1<,name2,...>
53 Print additional fields: all, trace, trace:hostname,
54 trace:domain, trace:procname, trace:vpid, loglevel.
55
56 --clock-cycles
57 Disregard internal clock offset (use raw value)
58
59 --clock-offset seconds
60 Clock offset in seconds
61
62 --clock-seconds
63 Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns])
64
65 --clock-date
66 Print clock date
67
68 --clock-gmt
69 Print clock in GMT time zone (default: local time zone)
70
71 --stream-intersection
72 Only print events when all streams are active
73
74 --debug-info-dir
75 Directory in which to look for debugging information files
76 (default: /usr/lib/debug/)
77
78 --debug-info-target-prefix
79 Directory to use as a prefix for executable lookup
80
81 --debug-info-full-path
82 Show full debug info source and binary paths (if available)
83
84
85 Formats available: ctf, dummy, text.
86
87
89 Note that all command line options will override environmenal vari‐
90 ables.
91
92 BABELTRACE_VERBOSE
93 Activate verbose Babeltrace output.
94
95 BABELTRACE_DEBUG
96 Activate debug Babeltrace output.
97
98
100 babeltrace-log(1), lttng(1), lttng-ust(3), lttng-sessiond(8)
101
103 The lttng-live plugin does not honor the the "--output" command line
104 option.
105
106 If you encounter any issues or usability problem, please report it on
107 our mailing list <lttng-dev@lists.lttng.org> to help improve this
108 project.
109
111 Babeltrace and the babeltrace library are distributed under the MIT
112 license. See the files LICENSE and mit-license.txt for details.
113
114 A Web site is available at http://www.efficios.com/babeltrace for more
115 information on Babeltrace and the Common Trace Format. See
116 http://lttng.org for more information on the LTTng project.
117
118 Mailing list for support and development: <lttng-dev@lists.lttng.org>.
119
120 You can find us on IRC server irc.oftc.net (OFTC) in #lttng.
121
123 Thanks to the Linux Foundation and Ericsson for funding part of this
124 work. Thanks to the Multicore Association Tool Infrastructure Working
125 Group for their active role in the creation of the Common Trace Format.
126
128 Babeltrace was originally written by Mathieu Desnoyers, with additional
129 contributions from various other people. It is currently maintained by
130 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.
131
132 February 6, 2012 BABELTRACE(1)