BABELTRACE2-LOG(1)            Babeltrace manual           BABELTRACE2-LOG(1)

NAME         top

       babeltrace2-log - Convert a Linux kernel ring buffer to a CTF trace

SYNOPSIS         top

       babeltrace2-log [--with-timestamps] OUTPUT-PATH

DESCRIPTION         top

       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 <>)
       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         top

       -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 babeltrace2-source.text.dmesg(7),
       babeltrace2-filter.utils.muxer(7), and babeltrace2-sink.ctf.fs(7).

   Babeltrace library
           Common functions’s log level. The available values are the same
           as for the --log-level option of babeltrace2(1).

           Compatibility functions’s log level. The available values are the
           same as for the --log-level option of babeltrace2(1).

           Force the terminal color support. The available values are:

               Only emit terminal color codes when the standard output and
               error streams are connected to a color-capable terminal.

               Never emit terminal color codes.

               Always emit terminal color codes.

           Set to 1 to disable the loading of any Babeltrace Python plugin.

           Babeltrace library’s global log level. The available values are
           the same as for the --log-level option of babeltrace2(1)

           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.

           Colon-separated list of directories, in order, in which dynamic
           plugins can be found before other directories are considered.

FILES         top

           User plugin directory.

           System plugin directory.

EXIT STATUS         top

       0 on success, 1 otherwise.

BUGS         top

       If you encounter any issue or usability problem, please report it on
       the Babeltrace bug tracker (see

RESOURCES         top

       The Babeltrace project shares some communication channels with the
       LTTng project (see <>).

       ·   Babeltrace website (see <>)

       ·   Git repository (see

       ·   EfficiOS GitHub organization (see <>)

       ·   Continuous integration (see

       ·   Mailing list (see <>) for support and

       ·   IRC channel (see <irc://>): #lttng on

AUTHORS         top

       The Babeltrace project is the result of efforts by many regular
       developers and occasional contributors.

       The current project maintainer is Jérémie Galarneau

COPYRIGHT         top

       This program is part of the Babeltrace project.

       Babeltrace is distributed under the MIT license (see

SEE ALSO         top

       babeltrace2-intro(7), babeltrace2-source.text.dmesg(7),
       babeltrace2-filter.utils.muxer(7), babeltrace2-sink.ctf.fs(7)

COLOPHON         top

       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 ⟨⟩.  If you have a bug
       report for this manual page, send it to
       This page was obtained from the project's upstream Git repository
       ⟨git://⟩ on 2020-05-27.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-04-22.)  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

Babeltrace 2.0.0-pre6          5 October 2017             BABELTRACE2-LOG(1)