BABELTRACE-SOURCE(7)          Babeltrace manual         BABELTRACE-SOURCE(7)

NAME         top

       babeltrace-source.text.dmesg - Babeltrace's Linux kernel ring buffer
       source component class

DESCRIPTION         top

       The Babeltrace source.text.dmesg component class, provided by the
       babeltrace-plugin-text(7) plugin, once instantiated, reads the lines
       of a Linux kernel ring buffer, as printed by the dmesg(1) tool, and
       emits corresponding event notifications on its output port.

       The events created by a source.text.dmesg component are named string
       and contain a single payload string field named str which contains
       the corresponding ring buffer line.

       By default, a source.text.dmesg component reads the lines of the
       standard input stream. You can make the component read the lines of a
       text file instead with the path parameter.

       By default, the component tries to extract the timestamps of the
       kernel ring buffer lines and 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 the timestamp to
       extract. You can make the component not extract timestamps from lines
       with the no-extract-timestamp parameter.


       The following parameters are optional.

       no-extract-timestamp=yes (boolean)
           Do NOT extract timestamps from the kernel ring buffer lines: set
           the created event’s payload’s str field to the whole line,
           including any timestamp prefix.

       path=PATH (string)
           Read the kernel ring buffer lines from the file PATH instead of
           the standard input stream.

PORTS         top

           Single output port to which the component sends the created

QUERY OBJECTS         top

       This component class has no objects to query.


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

           Compatibility functions’s log level. The available values are the
           same as for the --log-level option of babeltrace(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.

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 component class is part of the Babeltrace project.

       Babeltrace is distributed under the MIT license (see

SEE ALSO         top

       babeltrace-plugin-text(7), babeltrace-intro(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 2018-10-29.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-09-12.)  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-pre4          5 October 2017           BABELTRACE-SOURCE(7)

Pages that refer to this page: babeltrace(1)babeltrace-log(1)babeltrace-plugin-text(7)