babeltrace2-query-babeltrace.trace-infos(7) — Linux manual page


BABELTRACE2-QUERY-(7)      Babeltrace 2 manual     BABELTRACE2-QUERY-(7)

NAME         top

       babeltrace2-query-babeltrace.trace-infos - Babeltrace 2's trace
       infos query object

DESCRIPTION         top

       The babeltrace.trace-infos Babeltrace 2 query object indicates
       time range information about specific traces and their streams,
       and which output ports of an eventual source component will serve
       the messages for a given stream.

       The babeltrace2-convert(1) command queries this object from all
       the source component classes to support the --stream-intersection

PARAMETERS         top

       The parameters for this query operation are exactly the same as
       you would pass as the initialization parameters of a component
       created from the queried component class.

RESULT OBJECT         top

       The result object is an array of trace info maps (see “Trace info

   Trace info map
       A trace info map contains:

       stream-infos=STREAM-INFOS [array of stream info maps]
           Stream info maps (see “Stream info map”) for this trace.

   Stream info map
       A stream info map contains:

       range-ns=RANGE [range map]
           The time range of this stream, a map containing:

           begin=NS [signed integer]
               Beginning time of this stream (nanoseconds since the
               stream class’s default clock class’s origin).

           end=NS [signed integer]
               End time of this stream (nanoseconds since the stream
               class’s default clock class’s origin).

       port-name=PORT-NAME [string]
           For an eventual source component initialized with the same
           parameters: name of the output port which serves the messages
           of this stream.

EXAMPLES         top

   Result object
       Example 1. Two trace infos: one with three stream infos, one with
       two stream infos.

           - stream-infos:
             - range-ns:
                 begin: 1509556764975082000
                 end: 1509557102181554400
               port-name: trace0-cpu0
             - range-ns:
                 begin: 1509556764947050800
                 end: 1509557102182771000
               port-name: trace0-cpu1
             - range-ns:
                 begin: 1509556764956409300
                 end: 1509557102182770400
               port-name: trace0-cpu2
           - stream-infos:
             - range-ns:
                 begin: 1509556764918082000
                 end: 1509557103849928400
               port-name: trace1-cpu0
             - range-ns:
                 begin: 1509556761888820000
                 end: 1509557109928100400
               port-name: trace1-cpu1

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

       •   Mailing list (see <>) for support and

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

       •   Bug tracker (see

       •   Git repository (see

       •   GitHub project (see <>)

       •   Continuous integration (see

       •   Code review (see

AUTHORS         top

       The Babeltrace 2 project is the result of hard work by many
       regular developers and occasional contributors.

       The current project maintainer is Jérémie Galarneau

COPYRIGHT         top

       This query object is part of the Babeltrace 2 project.

       Babeltrace is distributed under the MIT license (see

SEE ALSO         top

       babeltrace2-intro(7), babeltrace2-query(1),

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 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-05-31.)  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.1.0-rc1        14 September 2019      BABELTRACE2-QUERY-(7)

Pages that refer to this page: babeltrace2-convert(1)babeltrace2-source.ctf.fs(7)