преобразование кольцевого буфера ядра Linux в трассировку CTF (Convert a Linux kernel ring buffer to a CTF trace)
Имя (Name)
babeltrace2-log - Convert a Linux kernel ring buffer to a CTF
trace
Синопсис (Synopsis)
babeltrace2-log [--with-timestamps] OUTPUT-PATH
Описание (Description)
The babeltrace2-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 | babeltrace2-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, babeltrace2-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 babeltrace2-log extract
timestamps from lines with the --with-timestamps option.
Параметры (Options)
-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.
Переменные окружения (Environment variables)
See the environment variables of
babeltrace2-source.text.dmesg(7),
babeltrace2-filter.utils.muxer(7), and
babeltrace2-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 babeltrace2(1).
BABELTRACE_COMPAT_LOG_LEVEL
Compatibility functions's log level. The available values are
the same as for the --log-level option of babeltrace2(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 babeltrace2(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.
Файлы (Files)
$HOME/.local/lib/babeltrace2/plugins
User plugin directory.
/usr/local/lib/babeltrace2/plugins
System plugin directory.
Статус выхода (Exit)
0 on success, 1 otherwise.
Ошибки (баги) (Bugs)
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>).
Ресурсы (Resources)
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
