---
name: "babeltrace2-query-babeltrace.trace-infos"
section: "7"
platform: "linux"
package: "babeltrace2"
version: "2.1.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/babeltrace2-query-babeltrace.trace-infos"
---

# babeltrace2-query-babeltrace.trace-infos(7)

Babeltrace 2: Trace infos query object

## NAME

babeltrace2-query-babeltrace.trace-infos - Babeltrace 2: Trace infos query object

## DESCRIPTION

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)](/babeltrace2-convert/1.md) command queries this object from all the source component classes to support the **--stream-intersection** feature.

## PARAMETERS

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

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 origin of the default clock class of the stream class).

**end**=*NS* \[signed integer\]

End time of this stream (nanoseconds since the origin of the default clock class of the stream class).

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

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

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

## RESOURCES

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

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

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

[**babeltrace2-intro**(7)](/babeltrace2-intro/7.md), [**babeltrace2-query**(1)](/babeltrace2-query/1.md), [**babeltrace2-convert**(1)](/babeltrace2-convert/1.md)