scriptlive1

Usage

Overview

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

-c, --command command

Execute command instead of an interactive shell. The command is passed as argument to the -c option of the execution shell. The used shell is either $SHELL, the shell defined in the user’s passwd(5) database or _PATH_BSHELL, selected in respective order.

-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