Common Commandline Options¶
See also
- Common RSB commandline options
- Additional, more generic commandline options accepted by all RSB-related programs.
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
.- When the value should be parsed as a timestamp, the syntax
-
--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
.- When the value should be parsed as a timestamp, the syntax
-
--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 ifNUMBER-OF-TIMES-OR-T
is a positive integer or indefinitely ifNUMBER-OF-TIMES-OR-T
ist
.
-
--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)
See also
- Interactive Playback
- For a detailed explanation of the interactive replay strategy
- Remote-controlled Playback
- For a detailed explanation of the remote-controlled replay strategy.