diff options
Diffstat (limited to '')
| -rw-r--r-- | term-utils/scriptlive.1 | 121 | ||||
| -rw-r--r-- | term-utils/scriptlive.1.adoc | 86 |
2 files changed, 207 insertions, 0 deletions
diff --git a/term-utils/scriptlive.1 b/term-utils/scriptlive.1 new file mode 100644 index 0000000..74f2829 --- /dev/null +++ b/term-utils/scriptlive.1 @@ -0,0 +1,121 @@ +'\" t +.\" Title: scriptlive +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.15 +.\" Date: 2022-05-11 +.\" Manual: User Commands +.\" Source: util-linux 2.38.1 +.\" Language: English +.\" +.TH "SCRIPTLIVE" "1" "2022-05-11" "util\-linux 2.38.1" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.ss \n[.ss] 0 +.nh +.ad l +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} +.SH "NAME" +scriptlive \- re\-run session typescripts, using timing information +.SH "SYNOPSIS" +.sp +\fBscriptlive\fP [options] [\fB\-t\fP] \fItimingfile\fP [\fB\-I\fP|\fB\-B\fP] \fItypescript\fP +.SH "DESCRIPTION" +.sp +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. +.sp +The \fBsession is executed\fP in a newly created pseudoterminal with the user\(cqs $SHELL (or defaults to \fI/bin/bash\fP). +.sp +\fBBe careful!\fP Do not forget that the typescript may contains arbitrary commands. It is recommended to use \fB"scriptreplay \-\-stream in \-\-log\-in typescript"\fP (or with \fB\-\-log\-io\fP instead of \fB\-\-log\-in\fP) to verify the typescript before it is executed by \fBscriptlive\fP. +.sp +The timing information is what \fBscript\fP(1) outputs to file specified by \fB\-\-log\-timing\fP. The typescript has to contain stdin information and it is what script1 outputs to file specified by \fB\-\-log\-in\fP or \fB\-\-log\-io\fP. +.SH "OPTIONS" +.sp +\fB\-I\fP, \fB\-\-log\-in\fP \fIfile\fP +.RS 4 +File containing \fBscript\fP\(aqs terminal input. +.RE +.sp +\fB\-B\fP, \fB\-\-log\-io\fP \fIfile\fP +.RS 4 +File containing \fBscript\fP\(aqs terminal output and input. +.RE +.sp +\fB\-t\fP, \fB\-\-timing\fP \fIfile\fP +.RS 4 +File containing \fBscript\fP\(aqs timing output. This option overrides old\-style arguments. +.RE +.sp +\fB\-T\fP, \fB\-\-log\-timing\fP \fIfile\fP +.RS 4 +Aliased to \fB\-t\fP, maintained for compatibility with \fBscript\fP(1) command\-line options. +.RE +.sp +\fB\-d\fP, \fB\-\-divisor\fP \fInumber\fP +.RS 4 +Speed up the replay displaying this \fInumber\fP of times. The argument is a floating\-point number. It\(cqs called divisor because it divides the timings by this factor. This option overrides old\-style arguments. +.RE +.sp +\fB\-m\fP, \fB\-\-maxdelay\fP \fInumber\fP +.RS 4 +Set the maximum delay between updates to \fInumber\fP of seconds. The argument is a floating\-point number. This can be used to avoid long pauses in the typescript replay. +.RE +.sp +\fB\-h\fP, \fB\-\-help\fP +.RS 4 +Display help text and exit. +.RE +.sp +\fB\-V\fP, \fB\-\-version\fP +.RS 4 +Print version and exit. +.RE +.SH "EXAMPLES" +.sp +.if n .RS 4 +.nf +.fam C +% 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 +.fam +.fi +.if n .RE +.SH "AUTHORS" +.sp +.MTO "kzak\(atredhat.com" "Karel Zak" "" +.SH "COPYRIGHT" +.sp +Copyright © 2019 Karel Zak +.sp +This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.sp +Released under the GNU General Public License version 2 or later. +.SH "SEE ALSO" +.sp +\fBscript\fP(1), +\fBscriptreplay\fP(1) +.SH "REPORTING BUGS" +.sp +For bug reports, use the issue tracker at \c +.URL "https://github.com/util\-linux/util\-linux/issues" "" "." +.SH "AVAILABILITY" +.sp +The \fBscriptlive\fP command is part of the util\-linux package which can be downloaded from \c +.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file diff --git a/term-utils/scriptlive.1.adoc b/term-utils/scriptlive.1.adoc new file mode 100644 index 0000000..73e8faf --- /dev/null +++ b/term-utils/scriptlive.1.adoc @@ -0,0 +1,86 @@ +//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] [*-t*] _timingfile_ [*-I*|*-B*] _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!* Do not forget that the typescript may contains 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 by *scriptlive*. + +The timing information is what *script*(1) outputs to file specified by *--log-timing*. The typescript has to contain stdin information and it is what script1 outputs to 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. + +*-t*, *--timing* _file_:: +File containing *script*'s timing output. This option overrides old-style arguments. + +*-T*, *--log-timing* _file_:: +Aliased to *-t*, maintained for compatibility with *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::[] |