From cb4631fc52af4d0e0a67f06c4cd6fd2fc5e85b12 Mon Sep 17 00:00:00 2001
From: Karel Zak <kzak@redhat.com>
Date: Wed, 2 Oct 2019 16:55:15 +0200
Subject: [PATCH] scriptlive: add man page

Signed-off-by: Karel Zak <kzak@redhat.com>
---
 term-utils/script.1       |  3 +-
 term-utils/scriptlive.1   | 97 +++++++++++++++++++++++++++++++++++++++
 term-utils/scriptreplay.1 |  5 +-
 3 files changed, 102 insertions(+), 3 deletions(-)
 create mode 100644 term-utils/scriptlive.1

diff --git a/term-utils/script.1 b/term-utils/script.1
index b73420267b..e7195d65ff 100644
--- a/term-utils/script.1
+++ b/term-utils/script.1
@@ -236,7 +236,8 @@ automatically).
 (for the
 .I history
 mechanism),
-.BR scriptreplay (1)
+.BR scriptreplay (1),
+.BR scriptlive (1),
 .SH HISTORY
 The
 .B script
diff --git a/term-utils/scriptlive.1 b/term-utils/scriptlive.1
new file mode 100644
index 0000000000..d41c319d52
--- /dev/null
+++ b/term-utils/scriptlive.1
@@ -0,0 +1,97 @@
+.TH SCRIPTLIVE 1 "October 2019" "util-linux" "User Commands"
+.SH "NAME"
+scriptlive \- re-run session typescripts, using timing information
+.SH "SYNOPSIS"
+.B scriptlive
+[options]
+.RB [ \-t ]
+.RI timingfile
+.RB [ \-I|\-B ]
+.RI typescript
+.SH "DESCRIPTION"
+This program re-run 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.
+.PP
+The \fBsession is executed\fR in newly created pseudo terminal with user's $SHELL
+(or defaults to /bin/bash).
+.PP
+.B Be careful!
+Do not forget that the typescript may contains arbitrary commands.
+It is recommended to use \fB"scriptreplay \-\-stream in \-\-log\-in typescript"\fR
+(or with --log-io instead of --log-in) to verify the typescript before it is executed by
+.BR scriptlive (1).
+.PP
+The timing information is what
+.BR script (1)
+outputs to file specified by
+.BR \-\-log\-timing .
+The typescript has to contain stdin information and it is what
+.BR script (1) 
+outputs to file specified by
+.BR \-\-log-in
+or
+.BR \-\-log\-io .
+
+.SH OPTIONS
+.TP
+.BR \-I , " \-\-log-in " \fIfile\fR
+File containing \fBscript\fR's terminal input.
+.TP
+.BR \-B , " \-\-log-io " \fIfile\fR
+File containing \fBscript\fR's terminal output and input.
+.TP
+.BR \-t , " \-\-timing " \fIfile\fR
+File containing \fBscript\fR's timing output.  This option overrides old-style arguments.
+.TP
+.BR \-T , " \-\-log\-timing " \fIfile\fR
+aliast to \fB\-t\fR, maintained for compatibility with
+.B script (1)
+command line options.
+.BR \-d , " \-\-divisor " \fInumber\fR
+Speed up the replay displaying this
+.I 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.
+.TP
+.BR \-m , " \-\-maxdelay " \fInumber\fR
+Set the maximum delay between transcript updates to
+.I number
+of seconds.  The argument is a floating point number.  This can be used to
+avoid long pauses in the transcript replay.
+.TP
+.BR \-V , " \-\-version"
+Display version information and exit.
+.TP
+.BR \-h , " \-\-help"
+Display help text and exit.
+.SH "EXAMPLE"
+.nf
+% 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
+.nf
+.SH "SEE ALSO"
+.BR script (1),
+.BR scriptreplay (1)
+.SH "COPYRIGHT"
+Copyright \(co 2019 Karel Zak
+.PP
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
+PURPOSE.
+.PP
+Released under the GNU General Public License version 2 or later.
+.SH "AUTHOR"
+.MT kzak@\:redhat.com
+Karel Zak
+.ME .
+.SH AVAILABILITY
+The scriptlive command is part of the util-linux package and is available from
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+Linux Kernel Archive
+.UE .
diff --git a/term-utils/scriptreplay.1 b/term-utils/scriptreplay.1
index a63b46c4d6..9bacb0b203 100644
--- a/term-utils/scriptreplay.1
+++ b/term-utils/scriptreplay.1
@@ -106,10 +106,11 @@ Script started, file is script.out
 <etc, etc>
 % exit
 Script done, file is script.out
-% scriptreplay --timing file.tm --log-out script.out
+% scriptreplay --log-timing file.tm --log-out script.out
 .nf
 .SH "SEE ALSO"
-.BR script (1)
+.BR script (1),
+.BR scriptlive (1)
 .SH "COPYRIGHT"
 Copyright \(co 2008 James Youngman
 .br
-- 
2.39.2