Diff for /embedaddon/sudo/doc/sudoreplay.mdoc.in between versions 1.1.1.2 and 1.1.1.3

version 1.1.1.2, 2013/07/22 10:46:12 version 1.1.1.3, 2013/10/14 07:56:34
Line 1 Line 1
 .\"  .\"
.\" Copyright (c) 2009-2012 Todd C. Miller <Todd.Miller@courtesan.com>.\" Copyright (c) 2009-2013 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 September 11, 2013
 .Dt SUDOREPLAY @mansectsu@  .Dt SUDOREPLAY @mansectsu@
 .Os Sudo @PACKAGE_VERSION@  .Os Sudo @PACKAGE_VERSION@
 .Sh NAME  .Sh NAME
Line 24 Line 24
 .Nm sudoreplay  .Nm sudoreplay
 .Op Fl h  .Op Fl h
 .Bk -words  .Bk -words
.Op Fl d Ar directory.Op Fl d Ar dir
 .Ek  .Ek
 .Bk -words  .Bk -words
 .Op Fl f Ar filter  .Op Fl f Ar filter
 .Ek  .Ek
 .Bk -words  .Bk -words
.Op Fl m Ar max_wait.Op Fl m Ar num
 .Ek  .Ek
 .Bk -words  .Bk -words
.Op Fl s Ar speed_factor.Op Fl s Ar num
 .Ek  .Ek
 ID  ID
 .Pp  .Pp
 .Nm sudoreplay  .Nm sudoreplay
 .Op Fl h  .Op Fl h
 .Bk -words  .Bk -words
.Op Fl d Ar directory.Op Fl d Ar dir
 .Ek  .Ek
 .Fl l  .Fl l
 .Op search expression  .Op search expression
Line 98  Double the playback speed. Line 98  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 No = 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 No = 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 209  operator is optional, adjacent predicates have an impl Line 203  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 218  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 233  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 270  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 291  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.2  
changed lines
  Added in v.1.1.1.3


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