1 = babeltrace2-query-babeltrace.trace-infos(7)
2 :manpagetype: query object
3 :revdate: 14 September 2019
8 babeltrace2-query-babeltrace.trace-infos - Babeltrace 2's trace infos
14 The `babeltrace.trace-infos` Babeltrace~2 query object indicates
15 time range information about specific traces and their streams, and
16 which output ports of an eventual source component will serve the
17 messages for a given stream.
19 The man:babeltrace2-convert(1) command queries this object from all the
20 source component classes to support the
21 manopt:babeltrace2-convert(1):--stream-intersection feature.
26 The parameters for this query operation are exactly the same as you
27 would pass as the initialization parameters of a component created from
28 the queried component class.
33 The result object is an array of trace info maps (see
34 <<trace-info-map,``Trace info map''>>).
40 A trace info map contains:
42 nlqres:stream-infos='STREAM-INFOS' vtype:[array of stream info maps]::
43 Stream info maps (see <<stream-info-map,``Stream info map''>>) for
50 A stream info map contains:
52 nlqres:range-ns='RANGE' vtype:[range map]::
53 The time range of this stream, a map containing:
56 nlqres:begin='NS' vtype:[signed integer]::
57 Beginning time of this stream (nanoseconds since the stream
58 class's default clock class's origin).
60 nlqres:end='NS' vtype:[signed integer]::
61 End time of this stream (nanoseconds since the stream class's
62 default clock class's origin).
65 nlqres:port-name='PORT-NAME' vtype:[string]::
66 For an eventual source component initialized with the same
67 parameters: name of the output port which serves the messages of
75 .Two trace infos: one with three stream infos, one with two stream infos.
81 begin: 1509556764975082000
82 end: 1509557102181554400
83 port-name: trace0-cpu0
85 begin: 1509556764947050800
86 end: 1509557102182771000
87 port-name: trace0-cpu1
89 begin: 1509556764956409300
90 end: 1509557102182770400
91 port-name: trace0-cpu2
94 begin: 1509556764918082000
95 end: 1509557103849928400
96 port-name: trace1-cpu0
98 begin: 1509556761888820000
99 end: 1509557109928100400
100 port-name: trace1-cpu1
106 include::common-footer.txt[]
111 man:babeltrace2-intro(7),
112 man:babeltrace2-query(1),
113 man:babeltrace2-convert(1)