BABELTRACE2-QUERY-(7) Babeltrace 2 manual BABELTRACE2-QUERY-(7)
babeltrace2-query-babeltrace.support-info - Babeltrace 2's support info query object
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.
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 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).
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.
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
If you encounter any issue or usability problem, please report it on the Babeltrace bug tracker (see <https://bugs.lttng.org/projects/babeltrace>).
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: firstname.lastname@example.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>)
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:email@example.com>.
This query object is part of the Babeltrace 2 project. Babeltrace is distributed under the MIT license (see <https://opensource.org/licenses/MIT>).
babeltrace2-intro(7), babeltrace2-query(1), babeltrace2-convert(1)
This page is part of the babeltrace (trace read and write libraries and a trace converter) project. Information about the project can be found at ⟨http://www.efficios.com/babeltrace⟩. If you have a bug report for this manual page, send it to firstname.lastname@example.org. This page was obtained from the project's upstream Git repository ⟨git://git.efficios.com/babeltrace.git⟩ on 2023-06-23. (At that time, the date of the most recent commit that was found in the repository was 2023-06-19.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which is not part of the original manual page), send a mail to email@example.com Babeltrace 2.1.0-rc1 14 September 2019 BABELTRACE2-QUERY-(7)
Pages that refer to this page: babeltrace2-convert(1), babeltrace2-source.ctf.fs(7), babeltrace2-source.ctf.lttng-live(7)