table of contents
| BABELTRACE2-QUERY-(7) | Babeltrace 2 manual | BABELTRACE2-QUERY-(7) |
NAME¶
babeltrace2-query-babeltrace.support-info - Babeltrace 2's 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 source component class’s query method 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) command queries this object from specific source component classes to find the most appropriate for a given non-option argument.
PARAMETERS¶
input=INPUT [string]
Depending on the type parameter, this is a simple string, a file path, or a directory path.
type=(string | file | directory) [string]
string
file
directory
It is expected that the query method does not 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 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.
When it’s a map, the expected entries are:
group=GROUP-NAME [optional string]
If this entry is missing, then the given input gets its own, unique group.
weight=WEIGHT [real]
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/>).
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-query(1), babeltrace2-convert(1)
| 14 September 2019 | Babeltrace 2.0.5 |