4 :revdate: 5 October 2017
9 babeltrace - Convert or process one or more traces, and more
15 *babeltrace* [opt:--debug | opt:--verbose | opt:--log-level='LVL'] ['<<commands,CMD>>'] ['CMD ARGS']
20 `babeltrace` is an open-source trace converter and processor. The tool
21 can convert from one trace format to another, possibly with one or more
22 filters in the conversion path, and perform other operations depending
25 See man:babeltrace-intro(7) to learn more about the Babeltrace
26 project and its core concepts.
28 Most of the `babeltrace` commands load Babeltrace plugins to perform
29 their operation. The search path for Babeltrace plugins is, in this
32 . The colon-separated list of directories in the
33 `BABELTRACE_PLUGIN_PATH` environment variable.
35 . The colon-separated list of directories in the specific command's
36 nlopt:--plugin-path option.
38 . `$HOME/.local/lib/babeltrace/plugins`
40 . +{system_plugin_path}+
42 You can use the man:babeltrace-list-plugins(1) command to dynamically
43 list the available plugins and what they offer. See <<plugins,PLUGINS>>
44 for a list of plugins shipped with Babeltrace.
50 Turn the debugging mode on.
52 This is equivalent to opt:--log-level=`VERBOSE`.
54 opt:-l 'LVL', opt:--log-level='LVL'::
55 Set the log level of all known Babeltrace loggers to 'LVL'. You
56 can override the level of a specific logger with a dedicated
57 log level environment variable. If you don't specify this option,
58 it is equivalent to nlopt:--log-level=`WARNING`.
60 The available values for 'LVL' are:
69 Severe errors that lead the execution to abort immediately. This
70 level should be enabled in production.
74 Errors that might still allow the execution to continue. Usually,
75 once one or more errors are reported at this level, the application,
76 plugin, or library won't perform any more useful task, but it should
77 still exit cleanly. This level should be enabled in production.
82 Potentially harmful situations which still allow the execution
83 to continue. This level should be enabled in production.
87 Informational messages that highlight progress or important states
88 of the application, plugin, or library. This level can be enabled in
93 Debugging information, with a higher level of details than the
94 `VERBOSE` level. This level should :not: be enabled in production.
98 Low-level debugging context information. This level should :not: be
99 enabled in production.
102 opt:-v, opt:--verbose::
103 Turn the verbose mode on.
105 This is equivalent to opt:--log-level=`INFO`.
110 opt:-V, opt:--version::
111 Show version and quit.
117 The following commands also have their own nlopt:--help option.
119 man:babeltrace-convert(1)::
120 Build a trace conversion graph and run it.
122 This is the default command: you don't need to explicitly
123 specify this command name to use it.
125 man:babeltrace-help(1)::
126 Get help for a specific plugin or plugin's component class.
128 man:babeltrace-list-plugins(1)::
129 List the available Babeltrace plugins and their component classes.
131 man:babeltrace-query(1)::
132 Query an object from a component class.
134 man:babeltrace-run(1)::
135 Build a trace processing graph and run it.
141 The following plugins are provided by the Babeltrace project itself:
143 man:babeltrace-plugin-ctf(7)::
144 CTF trace input (from the file system and from the LTTng-live
145 protocol) and output to the file system.
147 * man:babeltrace-sink.ctf.fs(7)
148 * man:babeltrace-source.ctf.fs(7)
149 * man:babeltrace-source.ctf.lttng-live(7)
151 ifeval::[{enable_debug_info} == 1]
152 man:babeltrace-plugin-lttng-utils(7)::
153 Processing graph utilities for LTTng traces.
155 * man:babeltrace-filter.lttng-utils.debug-info(7)
158 man:babeltrace-plugin-text(7)::
159 Text input and output.
161 * man:babeltrace-sink.text.pretty(7)
162 * man:babeltrace-source.text.dmesg(7)
164 man:babeltrace-plugin-utils(7)::
165 Processing graph utilities.
167 * man:babeltrace-filter.utils.muxer(7)
168 * man:babeltrace-filter.utils.trimmer(7)
169 * man:babeltrace-sink.utils.counter(7)
170 * man:babeltrace-sink.utils.dummy(7)
173 include::common-cli-env.txt[]
175 include::common-cli-files.txt[]
177 include::common-cmd-footer.txt[]
182 man:babeltrace-convert(1),
183 man:babeltrace-help(1),
184 man:babeltrace-list-plugins(1),
185 man:babeltrace-query(1),
186 man:babeltrace-run(1),
187 man:babeltrace-intro(7)