]>
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 |
6e72fa59 | 6 | [options] |
557db9cd | 7 | .RB [ \-t ] |
fc6b5e0d PB |
8 | .I timingfile |
9 | .RI [ typescript | |
10 | .RI [ divisor ]] | |
e8f26419 | 11 | .SH "DESCRIPTION" |
e8f26419 | 12 | This program replays a typescript, using timing information to ensure that |
6e72fa59 | 13 | output happens in the same rhythm as it originally appeared when the script |
18a706bd KZ |
14 | was recorded. |
15 | .PP | |
16 | The replay simply displays the information again; the programs | |
cf0609a3 | 17 | that were run when the typescript was being recorded are \fBnot run again\fR. |
18a706bd KZ |
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 | 28 | .BR script (1) |
cf0609a3 KZ |
29 | outputs to file specified by |
30 | .BR \-\-log-timing . | |
e8f26419 | 31 | .PP |
1aa1fbae SK |
32 | By default, the typescript to display is assumed to be named |
33 | .BR typescript , | |
557db9cd | 34 | but other filenames may be specified, as the second parameter or with option |
cf0609a3 | 35 | .BR \-\-log\-out . |
e8f26419 | 36 | .PP |
cf0609a3 KZ |
37 | If the third parameter or |
38 | .BR \-\-divisor | |
39 | is specified, it is used as a speed-up multiplier. | |
557db9cd | 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 |
cf0609a3 KZ |
45 | .TP |
46 | .BR \-I , " \-\-log-in " \fIfile\fR | |
47 | File containing \fBscript\fR's terminal input. | |
48 | .TP | |
49 | .BR \-O , " \-\-log-out " \fIfile\fR | |
50 | File containing \fBscript\fR's terminal output. | |
51 | .TP | |
52 | .BR \-B , " \-\-log-io " \fIfile\fR | |
53 | File containing \fBscript\fR's terminal output and input. | |
ed66f515 | 54 | .TP |
557db9cd | 55 | .BR \-t , " \-\-timing " \fIfile\fR |
cf0609a3 | 56 | File containing \fBscript\fR's timing output. This option overrides old-style arguments. |
ed66f515 | 57 | .TP |
557db9cd | 58 | .BR \-s , " \-\-typescript " \fIfile\fR |
cf0609a3 KZ |
59 | File containing \fBscript\fR's terminal output. Deprecated alias to \fB\-\-log-out\fR. |
60 | This option overrides old-style arguments. | |
ed66f515 | 61 | .TP |
88b8e9bf KZ |
62 | .BR \-c , " \-\-cr\-mode " \fImode\fR |
63 | Specifies how to use CR (0x0D, carriage return) character from log files. | |
64 | The default mode is "auto", in this case CR is replaced with line break for | |
65 | stdin log, because otherwise scriptreplay will overwrite the same line. | |
66 | The another modes are "never" and "always". | |
67 | .TP | |
557db9cd | 68 | .BR \-d , " \-\-divisor " \fInumber\fR |
1aa1fbae SK |
69 | Speed up the replay displaying this |
70 | .I number | |
71 | of times. The argument is a floating point number. It's called divisor | |
cf0609a3 | 72 | because it divides the timings by this factor. This option overrides old-style arguments. |
178365ef | 73 | .TP |
7f1d4836 | 74 | .BR \-m , " \-\-maxdelay " \fInumber\fR |
6e72fa59 | 75 | Set the maximum delay between transcript updates to |
7f1d4836 | 76 | .I number |
6e72fa59 | 77 | of seconds. The argument is a floating point number. This can be used to |
7f1d4836 JDN |
78 | avoid long pauses in the transcript replay. |
79 | .TP | |
70315772 KZ |
80 | .BR \-x , " \-\-stream " \fItype\fR |
81 | Forces scriptreplay to print only specified stream. The supported stream types | |
82 | are 'in' or 'out'. This option is recommended for multi-stream logs (e.g. --log-io) | |
83 | to print only specified data. | |
84 | .TP | |
178365ef | 85 | .BR \-V , " \-\-version" |
557db9cd | 86 | Display version information and exit. |
178365ef SK |
87 | .TP |
88 | .BR \-h , " \-\-help" | |
b4362b6f | 89 | Display help text and exit. |
e8f26419 | 90 | .SH "EXAMPLE" |
1aa1fbae | 91 | .nf |
cf0609a3 | 92 | % script --log-timing file.tm --log-out script.out |
1aa1fbae SK |
93 | Script started, file is script.out |
94 | % ls | |
95 | <etc, etc> | |
96 | % exit | |
97 | Script done, file is script.out | |
cf0609a3 | 98 | % scriptreplay --timing file.tm --log-out script.out |
1aa1fbae | 99 | .nf |
ffc43748 | 100 | .SH "SEE ALSO" |
ffc43748 | 101 | .BR script (1) |
e8f26419 | 102 | .SH "COPYRIGHT" |
18a706bd | 103 | Copyright \(co 2008 James Youngman |
1aa1fbae | 104 | .br |
cf0609a3 | 105 | Copyright \(co 2008-2019 Karel Zak |
18a706bd KZ |
106 | .PP |
107 | This is free software; see the source for copying conditions. There is NO | |
108 | warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR | |
109 | PURPOSE. | |
110 | .PP | |
111 | Released under the GNU General Public License version 2 or later. | |
e8f26419 | 112 | .SH "AUTHOR" |
18a706bd KZ |
113 | The original |
114 | .B scriptreplay | |
1aa1fbae | 115 | program was written by |
79f84818 | 116 | .MT joey@\:kitenet.net |
1aa1fbae | 117 | Joey Hess |
79f84818 | 118 | .ME . |
1aa1fbae | 119 | The program was re-written in C by |
79f84818 | 120 | .MT jay@\:gnu.org |
1aa1fbae | 121 | James Youngman |
79f84818 | 122 | .ME |
1aa1fbae | 123 | and |
79f84818 | 124 | .MT kzak@\:redhat.com |
1aa1fbae | 125 | Karel Zak |
79f84818 | 126 | .ME . |
86d62711 | 127 | .SH AVAILABILITY |
9c91fc03 | 128 | The scriptreplay command is part of the util-linux package and is available from |
d673b74e | 129 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
1aa1fbae SK |
130 | Linux Kernel Archive |
131 | .UE . |