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