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

NAME | DESCRIPTION | PARAMETERS | RESULT OBJECT | EXAMPLES | BUGS | RESOURCES | AUTHORS | COPYRIGHT | SEE ALSO | COLOPHON

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
       feature.

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
       map”).

   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
       <https://bugs.lttng.org/projects/babeltrace>).

RESOURCES top

       The Babeltrace project shares some communication channels with the
       LTTng project (see <https://lttng.org/>).

       ·   Babeltrace website (see <https://babeltrace.org/>)

       ·   Mailing list (see <https://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

       ·   Bug tracker (see <https://bugs.lttng.org/projects/babeltrace>)

       ·   Git repository (see <https://git.efficios.com/?p=babeltrace.git>)

       ·   GitHub project (see <https://github.com/efficios/babeltrace>)

       ·   Continuous integration (see
           <https://ci.lttng.org/view/Babeltrace/>)

       ·   Code review (see <https://review.lttng.org/q/project:babeltrace>)

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

COPYRIGHT top

       This query object is part of the Babeltrace 2 project.

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

SEE ALSO top

       babeltrace2-intro(7), babeltrace2-query(1), babeltrace2-convert(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 ⟨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 2020-08-13.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-08-11.)  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.1.0-rc1          14 September 2019        BABELTRACE2-QUERY-(7)

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