version 1.1.1.2, 2013/07/22 10:46:12
|
version 1.1.1.4, 2014/06/15 16:12:54
|
Line 1
|
Line 1
|
.\" |
.\" |
.\" 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 14
|
Line 14
|
.\" 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. |
.\" |
.\" |
.Dd February 5, 2013 | .Dd February 15, 2014 |
.Dt SUDOREPLAY @mansectsu@ |
.Dt SUDOREPLAY @mansectsu@ |
.Os Sudo @PACKAGE_VERSION@ |
.Os Sudo @PACKAGE_VERSION@ |
.Sh NAME |
.Sh NAME |
Line 23
|
Line 23
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm sudoreplay |
.Nm sudoreplay |
.Op Fl h |
.Op Fl h |
.Bk -words | .Op Fl d Ar dir |
.Op Fl d Ar directory | |
.Ek | |
.Bk -words | |
.Op Fl f Ar filter |
.Op Fl f Ar filter |
.Ek | .Op Fl m Ar num |
.Bk -words | .Op Fl s Ar num |
.Op Fl m Ar max_wait | |
.Ek | |
.Bk -words | |
.Op Fl s Ar speed_factor | |
.Ek | |
ID |
ID |
.Pp |
.Pp |
.Nm sudoreplay |
.Nm sudoreplay |
.Op Fl h |
.Op Fl h |
.Bk -words | .Op Fl d Ar dir |
.Op Fl d Ar directory | |
.Ek | |
.Fl l |
.Fl l |
.Op search expression |
.Op search expression |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
Line 77 log file.
|
Line 67 log file.
|
The |
The |
.Em ID |
.Em ID |
may also be determined using |
may also be determined using |
.Nm sudoreplay Ns No 's | .Nm sudoreplay Ns 's |
list mode. |
list mode. |
.Pp |
.Pp |
In list mode, |
In list mode, |
Line 89 In replay mode, if the standard output has not been re
|
Line 79 In replay mode, if the standard output has not been re
|
.Nm sudoreplay |
.Nm sudoreplay |
will act on the following keys: |
will act on the following keys: |
.Bl -tag -width 12n |
.Bl -tag -width 12n |
.It So Li \ Sc No (space) | .It So Li \en Sc No or So Li \er Sc |
| Skip to the next replay event; useful for long pauses. |
| .It So Li \ Sc Pq space |
Pause output; press any key to resume. |
Pause output; press any key to resume. |
.It Ql < |
.It Ql < |
Reduce the playback speed by one half. |
Reduce the playback speed by one half. |
Line 98 Double the playback speed.
|
Line 90 Double the playback speed.
|
.El |
.El |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width 12n | .Bl -tag -width Fl |
.It Fl d Ar directory | .It Fl d Ar dir , Fl -directory Ns = Ns Ar dir |
Use | Store session logs in |
.Ar directory | .Ar dir |
to for the session logs instead of the default, | instead of the default, |
.Pa @iolog_dir@ . |
.Pa @iolog_dir@ . |
.It Fl f Ar filter | .It Fl f Ar filter , Fl -filter Ns = Ns Ar filter |
| Select which I/O type(s) to display. |
By default, |
By default, |
.Nm sudoreplay |
.Nm sudoreplay |
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 |
.Fl f |
|
option can be used to select which of these to output. |
|
The |
|
.Ar filter |
.Ar filter |
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: |
.Em stdout , |
.Em stdout , |
.Em stderr , |
.Em stderr , |
and |
and |
.Em ttyout . |
.Em ttyout . |
.It Fl h | .It Fl h , -help |
The | Display a short help message to the standard output and exit. |
.Fl h No ( Em help Ns No ) | .It Fl l , -list Op Ar search expression |
option causes | |
.Nm sudoreplay | |
to print a short help message to the standard output and exit. | |
.It Fl l Op Ar search expression | |
Enable |
Enable |
.Dq list mode . |
.Dq list mode . |
In this mode, |
In this mode, |
Line 209 operator is optional, adjacent predicates have an impl
|
Line 195 operator is optional, adjacent predicates have an impl
|
.Em and |
.Em and |
unless separated by an |
unless separated by an |
.Em or . |
.Em or . |
.It Fl m Ar max_wait | .It Fl m , -max-wait Ar max_wait |
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, |
.Nm sudoreplay |
.Nm sudoreplay |
Line 224 will limit these pauses to at most
|
Line 210 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.\& |
.Em 2.5 . |
.Em 2.5 . |
.It Fl s Ar speed_factor | .It Fl s , -speed Ar speed_factor |
This option causes |
This option causes |
.Nm sudoreplay |
.Nm sudoreplay |
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 239 would make the output twice as fast whereas a
|
Line 225 would make the output twice as fast whereas a
|
of |
of |
.Em .5 |
.Em .5 |
would make the output twice as slow. |
would make the output twice as slow. |
.It Fl V | .It Fl V , -version |
The | Print the |
.Fl V No ( Em version Ns No ) | |
option causes | |
.Nm sudoreplay |
.Nm sudoreplay |
to print its version number | versions version number and exit. |
and exit. | |
.El |
.El |
.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: |
Line 279 Exactly one day from now.
|
Line 262 Exactly one day from now.
|
.It 2 hours ago |
.It 2 hours ago |
2 hours ago. |
2 hours ago. |
.It next Friday |
.It next Friday |
The first second of the next Friday. | The first second of the Friday in the next (upcoming) week. |
.It this week | Not to be confused with |
The current time but the first day of the coming week. | .Dq this friday |
| which would match the friday of the current week. |
| .It last week |
| The current time but 7 days ago. |
| This is equivalent to |
| .Dq a week ago . |
.It a fortnight ago |
.It a fortnight ago |
The current time but 14 days ago. |
The current time but 14 days ago. |
.It 10:01 am 9/17/2009 |
.It 10:01 am 9/17/2009 |
Line 295 The current time but 14 days ago.
|
Line 283 The current time but 14 days ago.
|
.It 10:01 am Sep 17, 2009 |
.It 10:01 am Sep 17, 2009 |
10:01 am, September 17, 2009. |
10:01 am, September 17, 2009. |
.El |
.El |
|
.Pp |
|
Note that relative time specifications do not always work as expected. |
|
For example, the |
|
.Dq next |
|
qualifier is intended to be used in conjunction with a day such as |
|
.Dq next Monday . |
|
When used with units of weeks, months, years, etc |
|
the result will be one more than expected. |
|
For example, |
|
.Dq next week |
|
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 |
|
.Nm sudoreplay . |
.Sh FILES |
.Sh FILES |
.Bl -tag -width 24n |
.Bl -tag -width 24n |
.It Pa @iolog_dir@ |
.It Pa @iolog_dir@ |