1 .TH "BABELTRACE" "1" "February 6, 2012" "" ""
4 babeltrace \(em Babeltrace Trace Viewer and Converter
10 babeltrace [OPTIONS] INPUT <OUTPUT>
15 Babeltrace is a trace viewer and converter reading and writing the
16 Common Trace Format (CTF). Its main use is to pretty-print CTF traces
17 into a human-readable text output.
20 This program follow the usual GNU command line syntax with long options
21 starting with two dashes. Below is a summary of the available options.
29 Output trace path (default: stdout)
31 .BR "-i, --input-format FORMAT"
32 Input trace format (default: ctf)
34 .BR "-o, --output-format FORMAT"
35 Output trace format (default: text)
41 List available formats
44 Verbose mode (or set BABELTRACE_VERBOSE environment variable)
47 Debug mode (or set BABELTRACE_DEBUG environment variable)
50 Do not print time delta between consecutive events
52 .BR "-n, --names name1<,name2,...>"
53 Print field names: (payload OR args OR arg), all, scope, header,
54 (context OR ctx), (payload active by default).
56 .BR "-f, --fields name1<,name2,...>"
57 Print additional fields: all, trace, trace:domain, trace:procname,
61 Disregard internal clock offset (use raw value)
63 .BR "--clock-offset seconds"
64 Clock offset in seconds
67 Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns])
73 Print clock in GMT time zone (default: local time zone)
77 Formats available: ctf, dummy, text.
79 .SH "ENVIRONMENT VARIABLES"
82 Note that all command line options will override environmenal variables.
86 .IP "BABELTRACE_VERBOSE"
87 Activate verbose Babeltrace output.
89 .IP "BABELTRACE_DEBUG"
90 Activate debug Babeltrace output.
95 babeltrace-log(1), lttng(1), lttng-ust(3), lttng-sessiond(8)
100 No knows bugs at this point.
102 If you encounter any issues or usability problem, please report it on
103 our mailing list <lttng-dev@lists.lttng.org> to help improve this
107 Babeltrace and the babeltrace library are distributed under the MIT
108 license. See the files LICENSE and mit-license.txt for details.
110 A Web site is available at http://www.efficios.com/babeltrace for more
111 information on Babeltrace and the Common Trace Format. See
112 http://lttng.org for more information on the LTTng project.
114 Mailing list for support and development: <lttng-dev@lists.lttng.org>.
116 You can find us on IRC server irc.oftc.net (OFTC) in #lttng.
120 Thanks to the Linux Foundation and Ericsson for funding part of this
121 work. Thanks to the Multicore Association Tool Infrastructure Working
122 Group for their active role in the creation of the Common Trace Format.
127 Babeltrace was originally written by Mathieu Desnoyers, with additional
128 contributions from various other people. It is currently maintained by
129 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.