NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | FILES | EXIT STATUS | BUGS | RESOURCES | AUTHORS | COPYRIGHT | SEE ALSO | COLOPHON

BABELTRACE-LOG(1)             Babeltrace manual            BABELTRACE-LOG(1)

NAME         top

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

SYNOPSIS         top

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

DESCRIPTION         top

       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.

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.

ENVIRONMENT VARIABLES         top

       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.

FILES         top

       $HOME/.local/lib/babeltrace/plugins
           User plugin directory.

       /usr/local/lib/babeltrace/plugins
           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
       <https://bugs.linuxfoundation.org/buglist.cgi?product=Diamon&component=Babeltrace>).

RESOURCES         top

       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

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
       <mailto:jeremie.galarneau@efficios.com>.

COPYRIGHT         top

       This program is part of the Babeltrace project.

       Babeltrace is distributed under the MIT license (see
       <https://opensource.org/licenses/MIT>).

SEE ALSO         top

       babeltrace-intro(7), babeltrace-source.text.dmesg(7),
       babeltrace-filter.utils.muxer(7), babeltrace-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 ⟨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-04-30.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-03-26.)  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)