File: scriptlive.1.adoc

package info (click to toggle)
util-linux 2.41-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 95,208 kB
  • sloc: ansic: 179,016; sh: 22,689; yacc: 1,284; makefile: 528; xml: 422; python: 316; lex: 89; ruby: 75; csh: 37; exp: 19; sed: 16; perl: 15; sql: 9
file content (100 lines) | stat: -rw-r--r-- 3,039 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
//po4a: entry man manual
= scriptlive(1)
:doctype: manpage
:man manual: User Commands
:man source: util-linux {release-version}
:page-layout: base
:command: scriptlive
:copyright: ©

== NAME

scriptlive - re-run session typescripts, using timing information

== SYNOPSIS

*scriptlive* [options] _timingfile_ _typescript_

== DESCRIPTION

This program re-runs a typescript, using stdin typescript and timing information to ensure that input happens in the same rhythm as it originally appeared when the script was recorded.

The *session is executed* in a newly created pseudoterminal with the user's $SHELL (or defaults to _/bin/bash_).

*Be careful!* The typescript may contain arbitrary commands. It is
recommended to use *"scriptreplay --stream in --log-in typescript"*
(or with *--log-io* instead of *--log-in*) to verify the typescript
before it is executed with *scriptlive*.

The timing information is what *script*(1) outputs to the file specified by
*--log-timing*. The typescript has to contain stdin information, and is what
*script*(1) outputs to the file specified by *--log-in* or *--log-io*.

== OPTIONS

*-I*, *--log-in* _file_::
File containing *script*'s terminal input.

*-B*, *--log-io* _file_::
File containing *script*'s terminal output and input.

*-E*, *--echo* _when_::
This option controls the *ECHO* flag for the slave end of the session's
pseudoterminal. The supported modes are *always*, *never*, and *auto*.
+
The default is *auto* -- in which case *ECHO* is enabled. This default
behavior is subject to change.

*-t*, *--timing* _file_::
File containing *script*'s timing output.
This option replaces the _timingfile_ positional argument.

*-T*, *--log-timing* _file_::
An alias for *-t*; maintained for compatibility with the *script*(1)
command-line options.

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

include::man-common/help-version.adoc[]

== EXAMPLES

....
% script --log-timing file.tm --log-in script.in
Script started, file is script.out
% date
<etc, etc>
% exit
Script done, file is script.out
% scriptlive --log-timing file.tm --log-in script.in
....

== AUTHORS

mailto:kzak@redhat.com[Karel Zak]

== COPYRIGHT

//TRANSLATORS: Keep {copyright} untranslated.
Copyright {copyright} 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.

== SEE ALSO

*script*(1),
*scriptreplay*(1)

include::man-common/bugreports.adoc[]

include::man-common/footer.adoc[]

ifdef::translation[]
include::man-common/translation.adoc[]
endif::[]