Provided by: termdebug_2.2+dfsg-1build3_amd64 
NAME
tdreplay - replay input to a terminal program
SYNOPSIS
tdreplay [OPTIONS] RECORDING
DESCRIPTION
tdreplay replays the input from a recording to the terminal program named in the recording. This allows
verification that the program behaviour has not changed, or confirmation that it has.
OPTIONS
tdreplay accepts the following options:
-h, --help
Display a short help message.
-V, --version
Print version and copyright information.
-a cmd, --alert=cmd
Execute cmd when a difference is detected between the recorded output and the output generated by
replaying the input back to the program. The environment variable REASON contains a message about
what sort of difference was detected. A useful command is 'xmessage "$REASON"'.
-d, --display
Show the output of the running program on the current terminal. The default is to only verify that
the program behaves as recorded without showing the output.
-e action, --on-error=action
Set the action to take when a difference is detected between the recorded and the actual output.
Possible values for action are interact, continue and abort. When the action is interact, tdreplay
will allow the user to interact with the program. When the action is continue, tdreplay will
continue as if no difference was detected. This can be dangerous as the input is no longer in sync
with the output. Depending on the possible actions of the program being run this can cause data
corruption.
-k delay, --key-delay=delay
Set the delay for sending a the next keys to delay. Delay may be either a fixed number of
miliseconds, or it may be specified as / (slash) followed by a divisor. When a divisor is
specified, all key delays specified in the recording will be divided by the divisor.
-l log, --log=log
Write a log of the events to log. This may be useful in figuring out what the difference between
the recorded and the actual output is.
-R, --no-resize
Do not try to resize the output terminal by sending a resize command sequence.
-v, --visual-compare
Check for visual equality, rather than exact input/output behaviour. (Requires a build with
ncurses support.)
-D, --describe
Write a description of the first visual difference encountered. Only useful with
-v/--visual-compare. (Requires a build with ncurses support.)
-p name, --picture=name
Write a picture of the difference to name. Only useful with -v/--visual-compare. (Requires a build
with ncurses and Cairo support.)
-f font, --font=font
Use font to show text in generated pictures. Only useful with -p/--picture or -P/--picture-series.
(Requires a build with ncurses and Cairo support.)
-W width, --cell-width=width
Use cells of width pixels wide in generated pictures. Only useful with -p/--picture or
-P/--picture-series. (Requires a build with ncurses and Cairo support.)
-H height, --cell-height=height
Use cells of height pixels wide in generated pictures. Only useful with -p/--picture or
-P/--picture-series. (Requires a build with ncurses and Cairo support.)
-P name, --picture-series=name
Create a series of pictures, representing the different visual steps in the client interface,
using name as the file name template. name is a printf(3) format string, where a single d-type
conversion is required. (Requires a build with ncurses, Cairo and Pthread support.)
To stop tdreplay from interpreting file names that start with a dash as options, one can specify a double
dash (--) after which tdreplay will interpret any following arguments as files to read.
BUGS
If you think you have found a bug, please check that you are using the latest version of termdebug
<http://os.ghalkes.nl/termdebug>. When reporting bugs, please include a minimal example that demonstrates
the problem.
AUTHOR
G.P. Halkes <termdebug@ghalkes.nl>
COPYRIGHT
Copyright © 2010,2012-2013 G.P. Halkes
termdebug is licensed under the GNU General Public License version 3.
For more details on the license, see the file COPYING in the documentation directory. On Un*x systems
this is usually /usr/share/doc/termdebug.
SEE ALSO
termdebug(1), tdrecord(1), tdrerecord(1), tdview(1), tdcompare(1)