Common Commandline Options¶

Replay-related Options¶

--channel REGEX, -c REGEX¶

Select the channels matching the regular expression REGEXP for replay. This option can be specified multiple times.

By default, REGEXP can match any substring of the channel name. to match the whole name instead, ^REGEXP$ can used.

Again by default, channel names are of the form SCOPE:TYPE-NAME. To only match the scope or type, the regular expressions ^SCOPE-REGEXP: or :TYPE-REGEXP$ can be used respectively.

--start-time TIMESTAMP-OR-SECONDS, -s TIMESTAMP-OR-SECONDS¶

Start replaying events at the point in time indicated by TIMESTAMP-OR-SECONDS.

When the value should be parsed as a timestamp, the syntax @[YYYY-MM-DDT]HH:MM:SS has to be used.
A single non-negative real number is interpreted as time in seconds relative to the beginning of the recording.
A single negative real number is interpreted as time in seconds relative to the end of the recording.

Mutually exclusive with --start-index.

--start-index INDEX, -S INDEX¶

Index of the event at which the replay should start. A negative value is interpreted as an offset from the end of the recording.

Mutually exclusive with --start-time.

--end-time TIMESTAMP-OR-SECONDS, -e TIMESTAMP-OR-SECONDS¶

Stop replaying events at the point in time indicated by TIMESTAMP-OR-SECONDS.

When the value should be parsed as a timestamp, the syntax @[YYYY-MM-DDT]HH:MM:SS has to be used.
A single non-negative real number is interpreted as time in seconds relative to the beginning of the recording.
A single negative real number is interpreted as time in seconds relative to the end of the recording.

Mutually exclusive with --end-index.

--end-index INDEX, -E INDEX¶

Index of the event at which the replay should end. A negative value is interpreted as an offset from the end of the recording.

Mutually exclusive with --end-time.

--loop NUMBER-OF-TIMES-OR-T, -n NUMBER-OF-TIMES-OR-T¶: Repeat the whole replay NUMBER-OF-TIMES-OR-T times if NUMBER-OF-TIMES-OR-T is a positive integer or indefinitely if NUMBER-OF-TIMES-OR-T is t.

--filter SPEC, -f SPEC¶

Specify a filter that events have to match in order to be processed rather than discarded. This option can be supplied multiple times in which case events have to match all specified filters. Each SPEC has to be of one of the forms:

KIND
KIND SINGLE-VALUE
KIND KEY1 VALUE1 KEY2 VALUE2 ...

where keys and values depend on KIND and may be mandatory in some cases. Examples (note that the single quotes have to be included only when used within a shell)

--filter 'origin "EAEE2B00-AF4B-11E0-8930-001AA0342D7D"'
--filter 'regex ".*foo[0-9]+"'
--filter 'regex :regex ".*foo[0-9]+"' (equivalent)
-f 'xpath :xpath "node()/@foo" :fallback-policy :do-not-match'

Tip

Use the common --help-for filter or common --help-for all options to display the full help text for this item.

--replay-strategy SPEC, -r SPEC¶

Replay events from the log file according to SPEC which has to be of the form:

KIND KEY1 VALUE1 KEY2 VALUE2 ...

where keys and values depend on KIND and are optional in most cases.

Examples:

--replay-strategy recorded-timing
-r as-fast-as-possible
--replay-strategy 'fixed-rate :rate 10'
-r 'remote-controlled :uri "spread://localhost:4803/myplayback/control"'

Note

The single quotes have to be included only when used within a shell)

Common Commandline Options¶

Table Of Contents

Related Documentation

This Page