]>
Commit | Line | Data |
---|---|---|
1aa1fbae | 1 | .TH SCRIPTREPLAY 1 "September 2011" "util-linux" "User Commands" |
e8f26419 | 2 | .SH "NAME" |
c129767e | 3 | scriptreplay \- play back typescripts, using timing information |
e8f26419 | 4 | .SH "SYNOPSIS" |
fc6b5e0d | 5 | .B scriptreplay |
557db9cd BS |
6 | .RI [ options ] |
7 | .RB [ \-t ] | |
fc6b5e0d PB |
8 | .I timingfile |
9 | .RI [ typescript | |
10 | .RI [ divisor ]] | |
e8f26419 | 11 | .SH "DESCRIPTION" |
e8f26419 KZ |
12 | This program replays a typescript, using timing information to ensure that |
13 | output happens at the same speed as it originally appeared when the script | |
18a706bd KZ |
14 | was recorded. |
15 | .PP | |
16 | The replay simply displays the information again; the programs | |
17 | that were run when the typescript was being recorded are not run again. | |
18 | Since the same information is simply being displayed, | |
19 | .B scriptreplay | |
20 | is only guaranteed to work properly if run on the same type of | |
21 | terminal the typescript was recorded on. Otherwise, any escape characters | |
22 | in the typescript may be interpreted differently by the terminal to | |
23 | which | |
24 | .B scriptreplay | |
25 | is sending its output. | |
e8f26419 | 26 | .PP |
557db9cd | 27 | The timing information is what |
fc6b5e0d PB |
28 | .BR script (1) |
29 | outputs to standard error if it is | |
30 | run with the | |
31 | .B \-t | |
32 | parameter. | |
e8f26419 | 33 | .PP |
1aa1fbae SK |
34 | By default, the typescript to display is assumed to be named |
35 | .BR typescript , | |
557db9cd BS |
36 | but other filenames may be specified, as the second parameter or with option |
37 | .BR \-s . | |
e8f26419 | 38 | .PP |
557db9cd BS |
39 | If the third parameter is specified, it is used as a speed-up multiplier. |
40 | For example, a speed-up of 2 makes | |
18a706bd | 41 | .B scriptreplay |
557db9cd | 42 | go twice as fast, and a speed-up of 0.1 makes it go ten times slower |
18a706bd | 43 | than the original session. |
178365ef | 44 | .SH OPTIONS |
557db9cd | 45 | The first three options will overide old-style arguments. |
ed66f515 | 46 | .TP |
557db9cd | 47 | .BR \-t , " \-\-timing " \fIfile\fR |
ed66f515 SK |
48 | File containing script timing output. |
49 | .TP | |
557db9cd BS |
50 | .BR \-s , " \-\-typescript " \fIfile\fR |
51 | File containing the script terminal output. | |
ed66f515 | 52 | .TP |
557db9cd | 53 | .BR \-d , " \-\-divisor " \fInumber\fR |
1aa1fbae SK |
54 | Speed up the replay displaying this |
55 | .I number | |
56 | of times. The argument is a floating point number. It's called divisor | |
557db9cd | 57 | because it divides the timings by this factor. |
178365ef SK |
58 | .TP |
59 | .BR \-V , " \-\-version" | |
557db9cd | 60 | Display version information and exit. |
178365ef SK |
61 | .TP |
62 | .BR \-h , " \-\-help" | |
b4362b6f | 63 | Display help text and exit. |
e8f26419 | 64 | .SH "EXAMPLE" |
1aa1fbae SK |
65 | .nf |
66 | % script --timing=file.tm script.out | |
67 | Script started, file is script.out | |
68 | % ls | |
69 | <etc, etc> | |
70 | % exit | |
71 | Script done, file is script.out | |
72 | % scriptreplay --timing file.tm --typescript script.out | |
73 | .nf | |
ffc43748 | 74 | .SH "SEE ALSO" |
ffc43748 | 75 | .BR script (1) |
e8f26419 | 76 | .SH "COPYRIGHT" |
18a706bd | 77 | Copyright \(co 2008 James Youngman |
1aa1fbae | 78 | .br |
18a706bd KZ |
79 | Copyright \(co 2008 Karel Zak |
80 | .PP | |
81 | This is free software; see the source for copying conditions. There is NO | |
82 | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR | |
83 | PURPOSE. | |
84 | .PP | |
85 | Released under the GNU General Public License version 2 or later. | |
e8f26419 | 86 | .SH "AUTHOR" |
18a706bd KZ |
87 | The original |
88 | .B scriptreplay | |
1aa1fbae | 89 | program was written by |
79f84818 | 90 | .MT joey@\:kitenet.net |
1aa1fbae | 91 | Joey Hess |
79f84818 | 92 | .ME . |
1aa1fbae | 93 | The program was re-written in C by |
79f84818 | 94 | .MT jay@\:gnu.org |
1aa1fbae | 95 | James Youngman |
79f84818 | 96 | .ME |
1aa1fbae | 97 | and |
79f84818 | 98 | .MT kzak@\:redhat.com |
1aa1fbae | 99 | Karel Zak |
79f84818 | 100 | .ME . |
86d62711 | 101 | .SH AVAILABILITY |
9c91fc03 | 102 | The scriptreplay command is part of the util-linux package and is available from |
1aa1fbae SK |
103 | .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
104 | Linux Kernel Archive | |
105 | .UE . |