scriptlive - Man Page
re-run session typescripts, using timing information
Examples (TL;DR)
- Execute a typescript in real-time:
scriptlive path/to/timing_file path/to/typescript
- Execute a typescript at double the original speed:
scriptlive path/to/timing_file path/to/typescript --divisor 2
- Execute a typescript created using
--log-in
option ofscript
:scriptlive --log-in path/to/stdin_log_file path/to/typescript
- Execute a typescript waiting at most 2 seconds between each command:
scriptlive path/to/timing_file path/to/typescript --maxdelay 2
Synopsis
scriptlive [options] timingfile typescript
Description
This program re-runs a typescript, using stdin typescript and timing information to ensure that input happens in the same rhythm as it originally appeared when the script was recorded.
The session is executed in a newly created pseudoterminal with the user’s $SHELL (or defaults to /bin/bash).
Be careful! The typescript may contain arbitrary commands. It is recommended to use "scriptreplay --stream in --log-in typescript" (or with --log-io instead of --log-in) to verify the typescript before it is executed with scriptlive.
The timing information is what script(1) outputs to the file specified by --log-timing. The typescript has to contain stdin information, and is what script(1) outputs to the file specified by --log-in or --log-io.
Options
- -I, --log-in file
File containing script's terminal input.
- -B, --log-io file
File containing script's terminal output and input.
- -E, --echo when
This option controls the ECHO flag for the slave end of the session’s pseudoterminal. The supported modes are always, never, and auto.
The default is auto — in which case ECHO is enabled. This default behavior is subject to change.
- -t, --timing file
File containing script's timing output. This option replaces the timingfile positional argument.
- -T, --log-timing file
An alias for -t; maintained for compatibility with the script(1) command-line options.
- -d, --divisor number
Speed up the replay displaying this number of times. The argument is a floating-point number. It’s called divisor because it divides the timings by this factor. This option overrides old-style arguments.
- -m, --maxdelay number
Set the maximum delay between updates to number of seconds. The argument is a floating-point number. This can be used to avoid long pauses in the typescript replay.
- -h, --help
Display help text and exit.
- -V, --version
Display version and exit.
Examples
% script --log-timing file.tm --log-in script.in Script started, file is script.out % date <etc, etc> % exit Script done, file is script.out % scriptlive --log-timing file.tm --log-in script.in
Authors
Copyright
Copyright © 2019 Karel Zak
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Released under the GNU General Public License version 2 or later.
See Also
Reporting Bugs
For bug reports, use the issue tracker.
Availability
The scriptlive command is part of the util-linux package which can be downloaded from Linux Kernel Archive.