|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | FILES | EXIT STATUS | BUGS | RESOURCES | AUTHORS | COPYRIGHT | SEE ALSO | COLOPHON |
|
BABELTRACE-LOG(1) Babeltrace manual BABELTRACE-LOG(1)
babeltrace-log - Convert a Linux kernel ring buffer to a CTF trace
babeltrace-log [--with-timestamps] OUTPUT-PATH
The babeltrace-log tool reads the lines of a Linux kernel ring
buffer, as printed by the dmesg(1) tool, from the standard input
stream and converts them to a CTF (see <http://diamon.org/ctf/>)
trace written to the OUTPUT-PATH directory.
Usage example:
$ dmesg | babeltrace-log --with-timestamps my-trace
The events of the generated CTF trace are named string and contain a
single payload string field named str which contains the
corresponding ring buffer line.
By default, babeltrace-log does not try to extract the timestamps of
the kernel ring buffer lines to use them as the created events’s
timestamps. A typical dmesg(1) line looks like this:
[87166.510937] PM: Finishing wakeup.
In the last example, the [87166.510937] part is a timestamp which
could be extracted. You can make babeltrace-log extract timestamps
from lines with the --with-timestamps option.
-t, --with-timestamps
Extract timestamps from the kernel ring buffer lines: set the
created event’s payload’s str field to the rest of the line,
excluding any timestamp prefix.
See the environment variables of babeltrace-source.text.dmesg(7),
babeltrace-filter.utils.muxer(7), and babeltrace-sink.ctf.fs(7).
Babeltrace library
BABELTRACE_COMMON_LOG_LEVEL
Common functions’s log level. The available values are the same
as for the --log-level option of babeltrace(1).
BABELTRACE_COMPAT_LOG_LEVEL
Compatibility functions’s log level. The available values are the
same as for the --log-level option of babeltrace(1).
BABELTRACE_TERM_COLOR
Force the terminal color support. The available values are:
AUTO
Only emit terminal color codes when the standard output and
error streams are connected to a color-capable terminal.
NEVER
Never emit terminal color codes.
ALWAYS
Always emit terminal color codes.
BABELTRACE_DISABLE_PYTHON_PLUGINS
Set to 1 to disable the loading of any Babeltrace Python plugin.
BABELTRACE_LOGGING_GLOBAL_LEVEL
Babeltrace library’s global log level. The available values are
the same as for the --log-level option of babeltrace(1)
BABELTRACE_NO_DLCLOSE
Set to 1 to make the Babeltrace library leave any dynamically
loaded modules (plugins and Python plugin provider) open at exit.
This can be useful for debugging purposes.
BABELTRACE_PLUGIN_PATH
Colon-separated list of directories, in order, in which dynamic
plugins can be found before other directories are considered.
$HOME/.local/lib/babeltrace/plugins
User plugin directory.
/usr/local/lib/babeltrace/plugins
System plugin directory.
0 on success, 1 otherwise.
If you encounter any issue or usability problem, please report it on
the Babeltrace bug tracker (see
<https://bugs.linuxfoundation.org/buglist.cgi?product=Diamon&component=Babeltrace>).
The Babeltrace project shares some communication channels with the
LTTng project (see <http://lttng.org/>).
· Babeltrace website (see <http://diamon.org/babeltrace>)
· Git repository (see
<http://git.linuxfoundation.org/?p=diamon/babeltrace.git>)
· EfficiOS GitHub organization (see <http://github.com/efficios/>)
· Continuous integration (see
<https://ci.lttng.org/job/babeltrace_master_build/>)
· Mailing list (see <http://lists.lttng.org>) for support and
development: lttng-dev@lists.lttng.org
· IRC channel (see <irc://irc.oftc.net/lttng>): #lttng on
irc.oftc.net
The Babeltrace project is the result of efforts by many regular
developers and occasional contributors.
The current project maintainer is Jérémie Galarneau
<mailto:jeremie.galarneau@efficios.com>.
This program is part of the Babeltrace project.
Babeltrace is distributed under the MIT license (see
<https://opensource.org/licenses/MIT>).
babeltrace-intro(7), babeltrace-source.text.dmesg(7),
babeltrace-filter.utils.muxer(7), babeltrace-sink.ctf.fs(7)
This page is part of the babeltrace (trace read and write libraries
and a trace converter) project. Information about the project can be
found at ⟨http://www.efficios.com/babeltrace⟩. If you have a bug
report for this manual page, send it to lttng-dev@lists.lttng.org.
This page was obtained from the project's upstream Git repository
⟨git://git.efficios.com/babeltrace.git⟩ on 2018-02-02. (At that
time, the date of the most recent commit that was found in the repos‐
itory was 2018-01-30.) If you discover any rendering problems in
this HTML version of the page, or you believe there is a better or
more up-to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not part
of the original manual page), send a mail to man-pages@man7.org
Babeltrace 2.0.0-pre4 5 October 2017 BABELTRACE-LOG(1)
|
HTML rendering created 2018-02-02 by Michael Kerrisk, author of The Linux Programming Interface, maintainer of the Linux man-pages project. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.
|
|