version 1.1.1.4, 2013/07/22 10:46:12
|
version 1.1.1.6, 2014/06/15 16:12:54
|
Line 1
|
Line 1
|
.\" DO NOT EDIT THIS FILE, IT IS NOT THE MASTER! |
.\" DO NOT EDIT THIS FILE, IT IS NOT THE MASTER! |
.\" IT IS GENERATED AUTOMATICALLY FROM sudoreplay.mdoc.in |
.\" IT IS GENERATED AUTOMATICALLY FROM sudoreplay.mdoc.in |
.\" |
.\" |
.\" Copyright (c) 2009-2012 Todd C. Miller <Todd.Miller@courtesan.com> | .\" Copyright (c) 2009-2014 Todd C. Miller <Todd.Miller@courtesan.com> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
Line 16
|
Line 16
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
.\" |
.\" |
.TH "SUDOREPLAY" "@mansectsu@" "February 5, 2013" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" | .TH "SUDOREPLAY" "@mansectsu@" "February 15, 2014" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" |
.nh |
.nh |
.if n .ad l |
.if n .ad l |
.SH "NAME" |
.SH "NAME" |
Line 26
|
Line 26
|
.HP 11n |
.HP 11n |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
[\fB\-h\fR] |
[\fB\-h\fR] |
[\fB\-d\fR\ \fIdirectory\fR] | [\fB\-d\fR\ \fIdir\fR] |
[\fB\-f\fR\ \fIfilter\fR] |
[\fB\-f\fR\ \fIfilter\fR] |
[\fB\-m\fR\ \fImax_wait\fR] | [\fB\-m\fR\ \fInum\fR] |
[\fB\-s\fR\ \fIspeed_factor\fR] | [\fB\-s\fR\ \fInum\fR] |
ID |
ID |
.HP 11n |
.HP 11n |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
[\fB\-h\fR] |
[\fB\-h\fR] |
[\fB\-d\fR\ \fIdirectory\fR] | [\fB\-d\fR\ \fIdir\fR] |
\fB\-l\fR |
\fB\-l\fR |
[search expression] | [search\ expression] |
.SH "DESCRIPTION" |
.SH "DESCRIPTION" |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
plays back or lists the output logs created by |
plays back or lists the output logs created by |
Line 82 In replay mode, if the standard output has not been re
|
Line 82 In replay mode, if the standard output has not been re
|
\fBsudoreplay\fR |
\fBsudoreplay\fR |
will act on the following keys: |
will act on the following keys: |
.TP 14n |
.TP 14n |
`\fR\ \fR' (space) | \(oq\fR\en\fR\(cq or \(oq\fR\er\fR\(cq |
| Skip to the next replay event; useful for long pauses. |
| .TP 14n |
| \(oq\fR\ \fR\(cq (space) |
Pause output; press any key to resume. |
Pause output; press any key to resume. |
.TP 14n |
.TP 14n |
`<' | \(oq<\(cq |
Reduce the playback speed by one half. |
Reduce the playback speed by one half. |
.TP 14n |
.TP 14n |
`>' | \(oq>\(cq |
Double the playback speed. |
Double the playback speed. |
.PP |
.PP |
The options are as follows: |
The options are as follows: |
.TP 14n | .TP 12n |
\fB\-d\fR \fIdirectory\fR | \fB\-d\fR \fIdir\fR, \fB\--directory\fR=\fIdir\fR |
.br | Store session logs in |
Use | \fIdir\fR |
\fIdirectory\fR | instead of the default, |
to for the session logs instead of the default, | |
\fI@iolog_dir@\fR. |
\fI@iolog_dir@\fR. |
.TP 14n | .TP 12n |
\fB\-f\fR \fIfilter\fR | \fB\-f\fR \fIfilter\fR, \fB\--filter\fR=\fIfilter\fR |
| Select which I/O type(s) to display. |
By default, |
By default, |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
will play back the command's standard output, standard error and tty output. | will display the command's standard output, standard error and tty output. |
The |
The |
\fB\-f\fR |
|
option can be used to select which of these to output. |
|
The |
|
\fIfilter\fR |
\fIfilter\fR |
argument is a comma-separated list, consisting of one or more of following: |
argument is a comma-separated list, consisting of one or more of following: |
\fIstdout\fR, |
\fIstdout\fR, |
\fIstderr\fR, |
\fIstderr\fR, |
and |
and |
\fIttyout\fR. |
\fIttyout\fR. |
.TP 14n | .TP 12n |
\fB\-h\fR | \fB\-h\fR, \fB\--help\fR |
The | Display a short help message to the standard output and exit. |
\fB\-h\fR (\fIhelp\fR) | .TP 12n |
option causes | \fB\-l\fR, \fB\--list\fR [\fIsearch expression\fR] |
\fBsudoreplay\fR | |
to print a short help message to the standard output and exit. | |
.TP 14n | |
\fB\-l\fR [\fIsearch expression\fR] | |
Enable |
Enable |
``list mode''. | \(lqlist mode\(rq. |
In this mode, |
In this mode, |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
will list available sessions in a format similar to the |
will list available sessions in a format similar to the |
Line 134 If a
|
Line 130 If a
|
\fIsearch expression\fR |
\fIsearch expression\fR |
is specified, it will be used to restrict the IDs that are displayed. |
is specified, it will be used to restrict the IDs that are displayed. |
An expression is composed of the following predicates: |
An expression is composed of the following predicates: |
.RS | .PP |
| .RS 12n |
| .PD 0 |
.TP 8n |
.TP 8n |
command \fIpattern\fR |
command \fIpattern\fR |
Evaluates to true if the command run matches |
Evaluates to true if the command run matches |
Line 143 On systems with POSIX regular expression support, the
|
Line 141 On systems with POSIX regular expression support, the
|
be an extended regular expression. |
be an extended regular expression. |
On systems without POSIX regular expression support, a simple sub-string |
On systems without POSIX regular expression support, a simple sub-string |
match is performed instead. |
match is performed instead. |
|
.PD |
.TP 8n |
.TP 8n |
cwd \fIdirectory\fR |
cwd \fIdirectory\fR |
Evaluates to true if the command was run with the specified current |
Evaluates to true if the command was run with the specified current |
Line 204 Predicates may be combined using
|
Line 203 Predicates may be combined using
|
and |
and |
\fI\&!\fR |
\fI\&!\fR |
operators as well as |
operators as well as |
`\&(' | \(oq\&(\(cq |
and |
and |
`\&)' | \(oq\&)\(cq |
grouping (note that parentheses must generally be escaped from the shell). |
grouping (note that parentheses must generally be escaped from the shell). |
The |
The |
\fIand\fR |
\fIand\fR |
Line 214 operator is optional, adjacent predicates have an impl
|
Line 213 operator is optional, adjacent predicates have an impl
|
\fIand\fR |
\fIand\fR |
unless separated by an |
unless separated by an |
\fIor\fR. |
\fIor\fR. |
.PP |
|
.RE |
.RE |
.PD 0 | .TP 12n |
.TP 14n | \fB\-m\fR, \fB\--max-wait\fR \fImax_wait\fR |
\fB\-m\fR \fImax_wait\fR | |
Specify an upper bound on how long to wait between key presses or output data. |
Specify an upper bound on how long to wait between key presses or output data. |
By default, |
By default, |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
Line 233 will limit these pauses to at most
|
Line 230 will limit these pauses to at most
|
seconds. |
seconds. |
The value may be specified as a floating point number, e.g.\& |
The value may be specified as a floating point number, e.g.\& |
\fI2.5\fR. |
\fI2.5\fR. |
.PD | .TP 12n |
.TP 14n | \fB\-s\fR, \fB\--speed\fR \fIspeed_factor\fR |
\fB\-s\fR \fIspeed_factor\fR | |
This option causes |
This option causes |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
to adjust the number of seconds it will wait between key presses or |
to adjust the number of seconds it will wait between key presses or |
Line 250 would make the output twice as fast whereas a
|
Line 246 would make the output twice as fast whereas a
|
of |
of |
\fI.5\fR |
\fI.5\fR |
would make the output twice as slow. |
would make the output twice as slow. |
.TP 14n | .TP 12n |
\fB\-V\fR | \fB\-V\fR, \fB\--version\fR |
The | Print the |
\fB\-V\fR (\fIversion\fR) | |
option causes | |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
to print its version number | versions version number and exit. |
and exit. | |
.SS "Date and time format" |
.SS "Date and time format" |
The time and date may be specified multiple ways, common formats include: |
The time and date may be specified multiple ways, common formats include: |
.TP 8n |
.TP 8n |
Line 296 yesterday
|
Line 289 yesterday
|
2 hours ago. |
2 hours ago. |
.TP 8n |
.TP 8n |
next Friday |
next Friday |
The first second of the next Friday. | The first second of the Friday in the next (upcoming) week. |
| Not to be confused with |
| \(lqthis friday\(rq |
| which would match the friday of the current week. |
.TP 8n |
.TP 8n |
this week | last week |
The current time but the first day of the coming week. | The current time but 7 days ago. |
| This is equivalent to |
| \(lqa week ago\(rq. |
.TP 8n |
.TP 8n |
a fortnight ago |
a fortnight ago |
The current time but 14 days ago. |
The current time but 14 days ago. |
Line 318 The current time but 14 days ago.
|
Line 316 The current time but 14 days ago.
|
.TP 8n |
.TP 8n |
10:01 am Sep 17, 2009 |
10:01 am Sep 17, 2009 |
10:01 am, September 17, 2009. |
10:01 am, September 17, 2009. |
|
.PP |
|
Note that relative time specifications do not always work as expected. |
|
For example, the |
|
\(lqnext\(rq |
|
qualifier is intended to be used in conjunction with a day such as |
|
\(lqnext Monday\(rq. |
|
When used with units of weeks, months, years, etc |
|
the result will be one more than expected. |
|
For example, |
|
\(lqnext week\(rq |
|
will result in a time exactly two weeks from now, which is probably |
|
not what was intended. |
|
This will be addressed in a future version of |
|
\fBsudoreplay\fR. |
.SH "FILES" |
.SH "FILES" |
.TP 26n |
.TP 26n |
\fI@iolog_dir@\fR |
\fI@iolog_dir@\fR |
Line 405 search the archives.
|
Line 417 search the archives.
|
.SH "DISCLAIMER" |
.SH "DISCLAIMER" |
\fBsudoreplay\fR |
\fBsudoreplay\fR |
is provided |
is provided |
``AS IS'' | \(lqAS IS\(rq |
and any express or implied warranties, including, but not limited |
and any express or implied warranties, including, but not limited |
to, the implied warranties of merchantability and fitness for a |
to, the implied warranties of merchantability and fitness for a |
particular purpose are disclaimed. |
particular purpose are disclaimed. |