BABELTRACE-SINK.C(7)          Babeltrace manual         BABELTRACE-SINK.C(7)

NAME         top

       babeltrace-sink.ctf.fs - Babeltrace's file system CTF sink component

DESCRIPTION         top

       The Babeltrace sink.ctf.fs component class, provided by the
       babeltrace-plugin-ctf(7) plugin, once instantiated, writes the events
       it receives to one or more CTF (see <>) traces
       on the file system.

       A sink.ctf.fs component does not merge traces, in that it writes the
       notifications of different input traces to different output traces.

       This component guarantees that the output traces are semantically
       equivalent to the input traces. This means that a given output CTF
       trace contains:

       ·   The original trace environment.

       ·   The original clock classes.

       ·   The original event class names, log levels, and other static
           attributes, except for the numeric IDs.

       ·   The original field values, except for:

           ·   Timestamp fields, but the equivalent clock value remains the

           ·   Numeric ID fields.

       The component does not guarantee to keep:

       ·   The original field type attributes (for example, the sizes of the
           integer field types).

       ·   The original stream class and event class numeric IDs.

   Output path
       The path of a CTF trace is the directory which directly contains the
       metadata and data stream files as children.

       The rules to determine the path of a generated CTF trace are:

       ·   If the single-trace parameter is true, use the value of the path


           ·   If the input trace has a name, use
               OUTPUTPATH/TRACENAME[SUFFIX], where OUTPUTPATH is the value
               of the path parameter, TRACENAME is the input trace’s name,
               and SUFFIX is an optional numeric suffix if
               OUTPUTPATH/TRACENAME already exists.

               Note that the name of a trace that a source.ctf.fs component
               creates includes its hostname and its relative path while
               making sure to avoid conflicts.

               Otherwise, use OUTPUTPATH/trace[SUFFIX], where OUTPUTPATH and
               SUFFIX are defined above.


       path=PATH (string, mandatory)
           Depending on the value of the single-trace parameter, prefix of
           output trace paths or full output trace path.

       single-trace=yes (boolean, optional)
           Assume that the component only receives notifications related to
           a single source trace.

PORTS         top

           Single input port from which the component receives the

QUERY OBJECTS         top

       This component class has no objects to query.


   ctf plugin
           Binary type reader’s log level. The available values are the same
           as for the --log-level option of babeltrace(1).

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

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

   Component class
           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.

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

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-ctf(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-SINK.C(7)

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