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 standard error if
       it is run with the -t parameter.

       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 -s.

       If the third parameter is specified, it is used as  a  speed-up  multi-
       plier.   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 orig-
       inal session.

OPTIONS
       The first three options will overide old-style arguments.

       -t, --timing file
              File containing script's timing output.

       -s, --typescript file
              File containing script's terminal output.

       -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.

       -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.

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

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

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

SEE ALSO
       script(1)

COPYRIGHT
       Copyright (C) 2008 James Youngman
       Copyright (C) 2008 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  <ftp://ftp.kernel.org/pub/linux
       /utils/util-linux/>.



util-linux                      September 2011                 SCRIPTREPLAY(1)
