---
name: "babeltrace2-query-babeltrace.support-info"
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.support-info"
---

# babeltrace2-query-babeltrace.support-info(7)

Babeltrace 2: Support info query object

## NAME

babeltrace2-query-babeltrace.support-info - Babeltrace 2: Support info query object

## DESCRIPTION

The **babeltrace.support-info** Babeltrace 2 query object indicates, for a given source component class, whether or not its instance can handle a given input, and if so, what’s the confidence of this support.

Said input can be a simple string, an existing file path, or an existing directory path. Components which expect some form of URI can handle a string input, while components which expect an existing file or directory can handle a file/directory path input.

When the query method of the source component class replies that its component can handle a given input, it can also specify the name of a group in which to put that input. All the inputs of a given group, for a given component class, should be passed when instantiating the component class as its **inputs** initialization parameter (array of strings).

The [**babeltrace2-convert**(1)](/babeltrace2-convert/1.md) command queries this object from specific source component classes to find the most appropriate for a given non-option argument.

## PARAMETERS

**input**=*INPUT* \[string\]

Check input *INPUT*.

Depending on the **type** parameter, this is a simple string, a file path, or a directory path.

**type**=(**string** \| **file** \| **directory**) \[string\]

Input type, one of:

**string**

**input** parameter is a simple string.

**file**

**input** parameter is a file path.

**directory**

**input** parameter is a directory path.

It’s expected that the query method don’t recurse into this directory: the result object indicates whether or not the component class supports this specific directory (**input**).

## RESULT OBJECT

The result object can be one of:

• A simple real value which is the weight, between 0 and 1, of the support by the component class for the given input.

A weight of 0 means the input is unsupported while a weight of 1 means it’s fully supported. Any value in between shows how confident the component class is about the support of the given input.

• A map with a weight and an optional group name.

When it’s a map, the expected entries are:

**group**=*GROUP-NAME* \[optional string\]

Put the given input into a group named *GROUP-NAME* for this component class.

If this entry is missing, then the given input gets its own, unique group.

**weight**=*WEIGHT* \[real\]

Weight, between 0 and 1, of the support by the component class for the given input.

The semantics are the same as when the result object is a simple real value.

## EXAMPLES

### Query parameters

**Example 1. String input.**

```
input: net://relayd177/host/node23/active
type: string
```

**Example 2. File path input.**

```
input: /home/user/traces/2019-08-26/quad.tr
type: file
```

### Result object

**Example 3. Simple weight (unique group).**

```
0.5
```

**Example 4. Weight and specific group.**

```
group: 63a4b7e5-37f0-4254-a048-a0cff9e5b761
weight: 0.75
```

**Example 5. Weight within a map (unique group).**

```
weight: 0.6
```

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