Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



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

объект запроса информации о поддержке Babeltrace 2 (Babeltrace 2's support info query object)

Имя (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]
           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).


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