1SCRIPTREPLAY(1) User Commands SCRIPTREPLAY(1)
2
3
4
6 scriptreplay - play back typescripts, using timing information
7
9 scriptreplay [options] [-t] timingfile [typescript [divisor]]
10
12 This program replays a typescript, using timing information to ensure
13 that output happens in the same rhythm as it originally appeared when
14 the script was recorded.
15
16 The replay simply displays the information again; the programs that
17 were run when the typescript was being recorded are not run again.
18 Since the same information is simply being displayed, scriptreplay is
19 only guaranteed to work properly if run on the same type of terminal
20 the typescript was recorded on. Otherwise, any escape characters in
21 the typescript may be interpreted differently by the terminal to which
22 scriptreplay is sending its output.
23
24 The timing information is what script(1) outputs to standard error if
25 it is run with the -t parameter.
26
27 By default, the typescript to display is assumed to be named type‐
28 script, but other filenames may be specified, as the second parameter
29 or with option -s.
30
31 If the third parameter is specified, it is used as a speed-up multi‐
32 plier. For example, a speed-up of 2 makes scriptreplay go twice as
33 fast, and a speed-up of 0.1 makes it go ten times slower than the orig‐
34 inal session.
35
37 The first three options will override old-style arguments.
38
39 -t, --timing file
40 File containing script's timing output.
41
42 -s, --typescript file
43 File containing script's terminal output.
44
45 -d, --divisor number
46 Speed up the replay displaying this number of times. The argu‐
47 ment is a floating point number. It's called divisor because it
48 divides the timings by this factor.
49
50 -m, --maxdelay number
51 Set the maximum delay between transcript updates to number of
52 seconds. The argument is a floating point number. This can be
53 used to avoid long pauses in the transcript replay.
54
55 -V, --version
56 Display version information and exit.
57
58 -h, --help
59 Display help text and exit.
60
62 % script --timing=file.tm script.out
63 Script started, file is script.out
64 % ls
65 <etc, etc>
66 % exit
67 Script done, file is script.out
68 % scriptreplay --timing file.tm --typescript script.out
69
71 script(1)
72
74 Copyright © 2008 James Youngman
75 Copyright © 2008 Karel Zak
76
77 This is free software; see the source for copying conditions. There is
78 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
79 PURPOSE.
80
81 Released under the GNU General Public License version 2 or later.
82
84 The original scriptreplay program was written by Joey Hess ⟨joey@
85 kitenet.net⟩. The program was re-written in C by James Youngman ⟨jay@
86 gnu.org⟩ and Karel Zak ⟨kzak@redhat.com⟩.
87
89 The scriptreplay command is part of the util-linux package and is
90 available from Linux Kernel Archive ⟨https://www.kernel.org/pub/linux
91 /utils/util-linux/⟩.
92
93
94
95util-linux September 2011 SCRIPTREPLAY(1)