If PARAMS contains a key which exists in the current component’s initialization parameters, replace the parameter.

$ babeltrace2 /path/to/trace

For a given implicit component, if PARAMS contains a key which exists in this component’s initialization parameters, replace the parameter.

$ babeltrace2 /path/to/chunk1 /path/to/chunk2

$ babeltrace2 /path/to/chunk1 --params=clock-class-offset-s=450 \


              /path/to/chunk2 --params=clock-class-offset-ns=98 \


              --log-level=INFO

Examples:

$ babeltrace2 /path/to/trace --begin=22:14:38 --end=22:15:07

$ babeltrace2 /path/to/trace --timerange=22:14:38,22:15:07

$ babeltrace2 /path/to/trace --end=12:31:04.882928015

Examples:

$ babeltrace2 /path/to/trace --debug-info

$ babeltrace2 /path/to/trace \


              --debug-info-target-prefix=/tmp/tgt-root

$ babeltrace2 /path/to/trace --debug-info-full-path

The implicit sink.text.pretty component exists by default. If any other explicit or implicit sink component exists, the convert command does not automatically create the implicit sink.text.pretty component.

The --clock-cycles, --clock-date, --clock-gmt, --clock-seconds, --color, --fields, --names, and --no-delta options all apply to the implicit sink.text.pretty component.

The --output option without --output-format=ctf makes the implicit sink.text.pretty component write its content to a file, except the warnings for backward compatibility with the babeltrace(1) program.

Examples:

$ babeltrace2 /path/to/trace

$ babeltrace2 /path/to/trace --no-delta

$ babeltrace2 /path/to/trace --output=/tmp/pretty-out

Example:

$ babeltrace2 /path/to/trace --output-format=dummy

Example:

$ babeltrace2 /path/to/input/trace --output-format=ctf \


              --output=my-traces

$ babeltrace2 /path/to/input/trace --timerange=22:14:38,22:15:07 \


              --debug-info --output-format=ctf --output=out-dir

$ babeltrace2 run --component=auto-disc-source-ctf-fs:source.ctf.fs \


                  --params='inputs=["/path/to/input/trace"]' \


                  --component=sink-ctf-fs:sink.ctf.fs \


                  --params='path="out-dir"' \


                  --component=muxer:filter.utils.muxer \


                  --component=trimmer:filter.utils.trimmer \


                  --params='begin="22:14:38"' \


                  --params='end="22:15:07"' \


                  --component=debug-info:filter.lttng-utils.debug-info \


                  --connect=auto-disc-source-ctf-fs:muxer \


                  --connect=muxer:trimmer \


                  --connect=trimmer:debug-info \


                  --connect=debug-info:sink-ctf-fs

The available values for COMP-CLS-TYPE are:

source, src

filter, flt

sink

The available values for LVL are:

NONE, N

FATAL, F

ERROR, E

WARN, WARNING, W

INFO, I

DEBUG, D

TRACE, T

If PARAMS contains a key which exists in the initialization parameters of the current component(s), replace the parameter.

The format of PARAMS is a comma-separated list of NAME=VALUE assignments:

NAME=VALUE[,NAME=VALUE]...

NAME

VALUE

Example:

--params='many=null, fresh=yes, condition=false, squirrel=-782329,


          play=+23, observe=3.14, simple=beef,


          needs-quotes="some string",


          escape.chars-are:allowed="a \" quote",


          things=[1, "hello", 2.71828],


          frog={slow=2, bath=[bike, 23], blind=NO}'

The available values for FORMAT are:

ctf

lttng-live

You can specify at most one --input-format option.

The available values for FORMAT are:

text

ctf

dummy

ctf-metadata

You can specify at most one --output-format option.

The force-clock-class-origin-unix-epoch initialization parameter makes all the created clock classes have a Unix epoch origin. This is useful to force the clock classes of multiple traces to be compatible even if they are not inherently.

The clock-class-offset-s initialization parameter adds SEC seconds to the offsets of all the clock classes that the component creates.

You can combine this option with --clock-offset-ns.

The clock-class-offset-ns initialization parameter adds NS nanoseconds to the offsets of all the clock classes that the component creates.

You can combine this option with --clock-offset-s.

You cannot use this option with the --timerange option.

The format of TIME is one of:

YYYY-MM-DD HH:II[:SS[.NANO]]
HH:II[:SS[.NANO]]
[-]SEC[.NANO]

YYYY

MM

DD

HH

II

SS

NANO

SEC

You cannot use this option with the --timerange option.

See the --begin option for the format of TIME.

You can also surround the whole argument with [ and ].

This option is useless if you specify any of the options below.

The debug-info-dir parameter indicates where the component should find the debugging information it needs if it’s not found in the actual executable files.

When the full-path parameter is true, the component writes the full (absolute) paths to files in its debugging information fields instead of just the short names.

The target-prefix parameter is a path to prepend to the paths to executables recorded in the trace. For example, if a trace contains the executable path /usr/bin/ls in its state dump events, and you specify --debug-info-target-prefix=/home/user/boards/xyz/root, then the component opens the /home/user/boards/xyz/root/usr/bin/ls file to find debugging information.

The clock-cycles parameter makes the component print the event time in clock cycles.

The clock-date parameter makes the component print the date and the time of events.

The clock-gmt parameter makes the component not apply the local timezone to the printed times.

The clock-seconds parameter makes the component print the event times in seconds since the Unix epoch.

The available values for WHEN are:

auto

never

always

The auto and always values have no effect if the BABELTRACE_TERM_COLOR environment variable is set to NEVER.

For example, --fields=trace,loglevel,emf sets the field-trace, field-loglevel, and field-emf initialization parameters to true.

The available value for FIELD are:

For example, --names=payload,scope sets the name-payload and name-scope initialization parameters to true.

The available value for NAME are:

When the no-delta parameter is true, the component does not print the duration since the last event on the line.

When you specify --output-format=ctf, set the path initialization parameter of the implicit sink.ctf.fs component to PATH.

Without any specified sink component, explicit or implicit, force the convert command’s sink component to be an implicit sink.text.pretty component and set its path initialization parameter to PATH.

See babeltrace2-sink.ctf.fs(7) and babeltrace2-sink.text.pretty(7) to learn more about those component classes.

The printed arguments are space-separated and individually escaped for safe shell input.

You cannot use this option with the --run-args-0 or --stream-intersection option.

The printed arguments are separated with a null character and NOT escaped for safe shell input.

You cannot use this option with the --run-args or --stream-intersection option.

Default: 100000 (100 ms).

In this mode, for each trace, the convert command filters out the events and other messages which are not in the time range where all the trace’s streams are active.

To use this option, all the source components, explicit and implicit, must have classes which support the babeltrace.trace-infos query object (see babeltrace2-query-babeltrace.trace-infos(7)). The only Babeltrace 2 project’s component class which supports this query object is source.ctf.fs.

You cannot use this option with the --run-args or --run-args-0 option.

This option also sets the verbose parameter of the implicit sink.text.pretty component (see babeltrace2-sink.text.pretty(7)) to true.

The application only aborts when the executed command returns, ignoring its exit status.

This environment variable is ignored when the application has the setuid or the setgid access right flag set.

The available values are:

AUTO

NEVER

ALWAYS

If this environment variable is set, it overrides the log level set by the --log-level option for the Babeltrace 2 library logger.

The available values for LVL are:

NONE, N

FATAL, F

ERROR, E

WARN, WARNING, W

INFO, I

DEBUG, D

TRACE, T

If this environment variable is set, it overrides the default plugin provider directory.

If this environment variable is set, it overrides the log level set by the --log-level option for the Python bindings logger.

The available values for LVL are:

NONE, N

FATAL, F

ERROR, E

WARN, WARNING, W

INFO, I

DEBUG, D

TRACE, T

If this environment variable is set, it overrides the log level set by the --log-level option for the CLI logger.

The available values for LVL are:

NONE, N

FATAL, F

ERROR, E

WARN, WARNING, W

INFO, I

DEBUG, D

TRACE, T