1SCRIPTREPLAY(1)                  User Commands                 SCRIPTREPLAY(1)
2
3
4

NAME

6       scriptreplay - play back typescripts, using timing information
7

SYNOPSIS

9       scriptreplay [options] [-t] timingfile [typescript [divisor]]
10

DESCRIPTION

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 file specified by
25       --log-timing.
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 --log-out.
30
31       If the third parameter or --divisor is  specified,  it  is  used  as  a
32       speed-up  multiplier.   For example, a speed-up of 2 makes scriptreplay
33       go twice as fast, and a speed-up of 0.1 makes it go  ten  times  slower
34       than the original session.
35

OPTIONS

37       -I, --log-in file
38              File containing script's terminal input.
39
40       -O, --log-out file
41              File containing script's terminal output.
42
43       -B, --log-io file
44              File containing script's terminal output and input.
45
46       -t, --timing file
47              File  containing  script's timing output.  This option overrides
48              old-style arguments.
49
50       -T, --log-timing file
51              This is an alias  for  -t,  maintained  for  compatibility  with
52              script(1) command-line options.
53
54       -s, --typescript file
55              File  containing  script's terminal output.  Deprecated alias to
56              --log-out.  This option overrides old-style arguments.
57
58       -c, --cr-mode mode
59              Specifies how to use the CR (0x0D,  carriage  return)  character
60              from  log  files.   The default mode is auto, in this case CR is
61              replaced with line break for stdin log, because otherwise scrip‐
62              treplay  would  overwrite  the  same  line.  The other modes are
63              never and always.
64
65       -d, --divisor number
66              Speed up the replay displaying this number of times.  The  argu‐
67              ment is a floating-point number.  It's called divisor because it
68              divides the timings by this factor.  This option overrides  old-
69              style arguments.
70
71       -m, --maxdelay number
72              Set the maximum delay between updates to number of seconds.  The
73              argument is a floating-point number.  This can be used to  avoid
74              long pauses in the typescript replay.
75
76       --summary
77              Display details about the session recorded in the specified tim‐
78              ing file and  exit.   The  session  has  to  be  recorded  using
79              advanced format (see script(1)) option --logging-format for more
80              details).
81
82       -x, --stream type
83              Forces scriptreplay to print only  the  specified  stream.   The
84              supported  stream  types  are  in,  out,  signal, or info.  This
85              option is recommended for multi-stream logs (e.g., --log-io)  in
86              order to print only specified data.
87
88       -V, --version
89              Display version information and exit.
90
91       -h, --help
92              Display help text and exit.
93

EXAMPLES

95       % script --log-timing file.tm --log-out script.out
96       Script started, file is script.out
97       % ls
98       <etc, etc>
99       % exit
100       Script done, file is script.out
101       % scriptreplay --log-timing file.tm --log-out script.out
102

AUTHORS

104       The  original  scriptreplay  program  was  written  by Joey Hess ⟨joey@
105       kitenet.net⟩.  The program was re-written in C by James Youngman  ⟨jay@
106       gnu.org⟩ and Karel Zak ⟨kzak@redhat.com⟩.
107
109       Copyright © 2008 James Youngman
110       Copyright © 2008-2019 Karel Zak
111
112       This is free software; see the source for copying conditions.  There is
113       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
114       PURPOSE.
115
116       Released under the GNU General Public License version 2 or later.
117

SEE ALSO

119       script(1), scriptlive(1)
120

AVAILABILITY

122       The  scriptreplay  command  is  part  of  the util-linux package and is
123       available from Linux Kernel  Archive  ⟨https://www.kernel.org/pub/linux
124       /utils/util-linux/⟩.
125
126
127
128util-linux                       October 2019                  SCRIPTREPLAY(1)
Impressum