1BABELTRACE2-QUERY-(7)         Babeltrace 2 manual        BABELTRACE2-QUERY-(7)
2
3
4

NAME

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

DESCRIPTION

10       The babeltrace.trace-infos Babeltrace 2 query object indicates time
11       range information about specific traces and their streams, and which
12       output ports of an eventual source component will serve the messages
13       for a given stream.
14
15       The babeltrace2-convert(1) command queries this object from all the
16       source component classes to support the --stream-intersection feature.
17

PARAMETERS

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

RESULT OBJECT

24       The result object is an array of trace info maps (see “Trace info
25       map”).
26
27   Trace info map
28       A trace info map contains:
29
30       stream-infos=STREAM-INFOS [array of stream info maps]
31           Stream info maps (see “Stream info map”) for this trace.
32
33   Stream info map
34       A stream info map contains:
35
36       range-ns=RANGE [range map]
37           The time range of this stream, a map containing:
38
39           begin=NS [signed integer]
40               Beginning time of this stream (nanoseconds since the stream
41               class’s default clock class’s origin).
42
43           end=NS [signed integer]
44               End time of this stream (nanoseconds since the stream class’s
45               default clock class’s origin).
46
47       port-name=PORT-NAME [string]
48           For an eventual source component initialized with the same
49           parameters: name of the output port which serves the messages of
50           this stream.
51

EXAMPLES

53   Result object
54       Example 1. Two trace infos: one with three stream infos, one with two
55       stream infos.
56
57           - stream-infos:
58             - range-ns:
59                 begin: 1509556764975082000
60                 end: 1509557102181554400
61               port-name: trace0-cpu0
62             - range-ns:
63                 begin: 1509556764947050800
64                 end: 1509557102182771000
65               port-name: trace0-cpu1
66             - range-ns:
67                 begin: 1509556764956409300
68                 end: 1509557102182770400
69               port-name: trace0-cpu2
70           - stream-infos:
71             - range-ns:
72                 begin: 1509556764918082000
73                 end: 1509557103849928400
74               port-name: trace1-cpu0
75             - range-ns:
76                 begin: 1509556761888820000
77                 end: 1509557109928100400
78               port-name: trace1-cpu1
79

BUGS

81       If you encounter any issue or usability problem, please report it on
82       the Babeltrace bug tracker (see
83       <https://bugs.lttng.org/projects/babeltrace>).
84

RESOURCES

86       The Babeltrace project shares some communication channels with the
87       LTTng project (see <https://lttng.org/>).
88
89       •   Babeltrace website (see <https://babeltrace.org/>)
90
91       •   Mailing list (see <https://lists.lttng.org>) for support and
92           development: lttng-dev@lists.lttng.org
93
94       •   IRC channel (see <irc://irc.oftc.net/lttng>): #lttng on
95           irc.oftc.net
96
97       •   Bug tracker (see <https://bugs.lttng.org/projects/babeltrace>)
98
99       •   Git repository (see <https://git.efficios.com/?p=babeltrace.git>)
100
101       •   GitHub project (see <https://github.com/efficios/babeltrace>)
102
103       •   Continuous integration (see
104           <https://ci.lttng.org/view/Babeltrace/>)
105
106       •   Code review (see <https://review.lttng.org/q/project:babeltrace>)
107

AUTHORS

109       The Babeltrace 2 project is the result of hard work by many regular
110       developers and occasional contributors.
111
112       The current project maintainer is Jérémie Galarneau
113       <mailto:jeremie.galarneau@efficios.com>.
114

116       This query object is part of the Babeltrace 2 project.
117
118       Babeltrace is distributed under the MIT license (see
119       <https://opensource.org/licenses/MIT>).
120

SEE ALSO

122       babeltrace2-intro(7), babeltrace2-query(1), babeltrace2-convert(1)
123
124
125
126Babeltrace 2.0.5               14 September 2019         BABELTRACE2-QUERY-(7)
Impressum