[BACK]Return to sudoreplay.mdoc.in CVS log [TXT] [DIR] Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / sudo / doc

Diff for /embedaddon/sudo/doc/sudoreplay.mdoc.in between versions 1.1.1.1 and 1.1.1.4

version 1.1.1.1, 2012/10/09 09:29:52 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 July 12, 2012.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
UseStore 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
TheDisplay 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 142  Evaluates to true if the command run matches Line 128  Evaluates to true if the command run matches
 .Ar pattern .  .Ar pattern .
 On systems with POSIX regular expression support, the pattern may  On systems with POSIX regular expression support, the pattern may
 be an extended regular expression.  be an extended regular expression.
On systems without POSIX regular expression support, a simple substringOn systems without POSIX regular expression support, a simple sub-string
 match is performed instead.  match is performed instead.
 .It cwd Ar directory  .It cwd Ar directory
 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 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
ThePrint the
.Fl V No ( Em version Ns No ) 
option causes 
 .Nm sudoreplay  .Nm sudoreplay
to print its version numberversions 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 weekNot 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@
Removed from v.1.1.1.1  
changed lines
  Added in v.1.1.1.4

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>