SCRIPTREPLAY(1)



SCRIPTREPLAY(1)                  User Commands                 SCRIPTREPLAY(1)

NAME
       scriptreplay - play back typescripts, using timing information

SYNOPSIS
       scriptreplay [options] [-t] timingfile [typescript [divisor]]

DESCRIPTION
       This  program  replays a typescript, using timing information to ensure
       that output happens in the same rhythm as it originally  appeared  when
       the script was recorded.

       The  replay  simply  displays  the information again; the programs that
       were run when the typescript was being  recorded  are  not  run  again.
       Since  the  same information is simply being displayed, scriptreplay is
       only guaranteed to work properly if run on the same  type  of  terminal
       the  typescript  was  recorded on.  Otherwise, any escape characters in
       the typescript may be interpreted differently by the terminal to  which
       scriptreplay is sending its output.

       The  timing  information is what script(1) outputs to file specified by
       --log-timing.

       By default, the typescript to display is  assumed  to  be  named  type-
       script,  but  other filenames may be specified, as the second parameter
       or with option --log-out.

       If the third parameter or --divisor is  specified,  it  is  used  as  a
       speed-up  multiplier.   For example, a speed-up of 2 makes scriptreplay
       go twice as fast, and a speed-up of 0.1 makes it go  ten  times  slower
       than the original session.

OPTIONS
       -I, --log-in file
              File containing script's terminal input.

       -O, --log-out file
              File containing script's terminal output.

       -B, --log-io file
              File containing script's terminal output and input.

       -t, --timing file
              File  containing  script's timing output.  This option overrides
              old-style arguments.

       -T, --log-timing file
              aliast to -t, maintained for compatibility with script (1)  com-
              mand line options.

       -s, --typescript file
              File  containing  script's terminal output.  Deprecated alias to
              --log-out.  This option overrides old-style arguments.

       -c, --cr-mode mode
              Specifies how to use CR (0x0D, carriage return)  character  from
              log  files.   The  default  mode is auto, in this case CR is re-
              placed with line break for stdin log, because  otherwise  scrip-
              treplay  will  overwrite  the  same line.  The another modes are
              never and always.

       -d, --divisor number
              Speed up the replay displaying this number of times.  The  argu-
              ment 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 transcript updates to number of
              seconds.  The argument is a floating point number.  This can  be
              used to avoid long pauses in the transcript replay.

       --summary
              Display  details  about session recorded in the specified timing
              file and exit.  The session has to be recorded by advanced  for-
              mat (see script(1)) option --logging-format for more details).

       -x, --stream type
              Forces  scriptreplay  to  print only specified stream.  The sup-
              ported stream types are in, out, signal, or info.   This  option
              is  recommended  for multi-stream logs (e.g., --log-io) to print
              only specified data.

       -V, --version
              Display version information and exit.

       -h, --help
              Display help text and exit.

EXAMPLE
       % script --log-timing file.tm --log-out script.out
       Script started, file is script.out
       % ls
       <etc, etc>
       % exit
       Script done, file is script.out
       % scriptreplay --log-timing file.tm --log-out script.out

SEE ALSO
       script(1), scriptlive(1)

COPYRIGHT
       Copyright (C) 2008 James Youngman
       Copyright (C) 2008-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.

AUTHOR
       The original scriptreplay program  was  written  by  Joey  Hess  <joey@
       kitenet.net>.   The program was re-written in C by James Youngman <jay@
       gnu.org> and Karel Zak <kzak@redhat.com>.

AVAILABILITY
       The scriptreplay command is part  of  the  util-linux  package  and  is
       available  from  Linux Kernel Archive <https://www.kernel.org/pub/linux
       /utils/util-linux/>.

util-linux                       October 2019                  SCRIPTREPLAY(1)

Man(1) output converted with man2html
list of all man pages