git.gag.com Git - debian/sudo/blob - sudoreplay.cat

   1
   2
   3
   4 SUDOREPLAY(1m)         MAINTENANCE COMMANDS        SUDOREPLAY(1m)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        sudoreplay - replay sudo session logs
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by [-\b-d\bd _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by] [-\b-f\bf _\bf_\bi_\bl_\bt_\be_\br] [-\b-m\bm _\bm_\ba_\bx_\b__\bw_\ba_\bi_\bt] [-\b-s\bs _\bs_\bp_\be_\be_\bd_\b__\bf_\ba_\bc_\bt_\bo_\br]
  12        ID
  13
  14        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by [-\b-d\bd _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by] -l [search expression]
  15
  16 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  17        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by plays back or lists the session logs created by s\bsu\bud\bdo\bo.  When
  18        replaying, s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by can play the session back in real-time, or the
  19        playback speed may be adjusted (faster or slower) based on the command
  20        line options.  The _\bI_\bD should be a six character sequence of digits and
  21        upper case letters, e.g.  0100A5, which is logged by s\bsu\bud\bdo\bo when a
  22        command is run with session logging enabled.
  23
  24        In list mode, s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by can be used to find the ID of a session based
  25        on a number of criteria such as the user, tty or command run.
  26
  27        In replay mode, if the standard output has not been redirected,
  28        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by will act on the following keys:
  29
  30        ' ' (space)
  31                Pause output; press any key to resume.
  32
  33        '<'     Reduce the playback speed by one half.
  34
  35        '>'     Double the playback speed.
  36
  37 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  38        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by accepts the following command line options:
  39
  40        -d _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by
  41                    Use _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by to for the session logs instead of the
  42                    default, _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo.
  43
  44        -f _\bf_\bi_\bl_\bt_\be_\br   By default, s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by will play back the command's
  45                    standard output, standard error and tty output.  The _\b-_\bf
  46                    option can be used to select which of these to output.  The
  47                    _\bf_\bi_\bl_\bt_\be_\br argument is a comma-separated list, consisting of
  48                    one or more of following: _\bs_\bt_\bd_\bo_\bu_\bt, _\bs_\bt_\bd_\be_\br_\br, and _\bt_\bt_\by_\bo_\bu_\bt.
  49
  50        -l          Enable "list mode".  In this mode, s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by will list
  51                    available session IDs.  If a _\bs_\be_\ba_\br_\bc_\bh _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn is
  52                    specified, it will be used to restrict the IDs that are
  53                    displayed.  An expression is composed of the following
  54                    predicates:
  55
  56                    command _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bp_\ba_\bt_\bt_\be_\br_\bn
  57                            Evaluates to true if the command run matches
  58                            _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bp_\ba_\bt_\bt_\be_\br_\bn.  On systems with POSIX regular
  59                            expression support, the pattern may be an extended
  60                            regular expression.  On systems without POSIX
  61
  62
  63
  64 1.7.4                     July 12, 2010                         1
  65
  66
  67
  68
  69
  70 SUDOREPLAY(1m)         MAINTENANCE COMMANDS        SUDOREPLAY(1m)
  71
  72
  73                            regular expression support, a simple substring
  74                            match is performed instead.
  75
  76                    cwd _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by
  77                            Evaluates to true if the command was run with the
  78                            specified current working directory.
  79
  80                    fromdate _\bd_\ba_\bt_\be
  81                            Evaluates to true if the command was run on or
  82                            after _\bd_\ba_\bt_\be.  See "Date and time format" for a
  83                            description of supported date and time formats.
  84
  85                    group _\br_\bu_\bn_\ba_\bs_\b__\bg_\br_\bo_\bu_\bp
  86                            Evaluates to true if the command was run with the
  87                            specified _\br_\bu_\bn_\ba_\bs_\b__\bg_\br_\bo_\bu_\bp.  Note that unless a
  88                            _\br_\bu_\bn_\ba_\bs_\b__\bg_\br_\bo_\bu_\bp was explicitly specified when s\bsu\bud\bdo\bo was
  89                            run this field will be empty in the log.
  90
  91                    runas _\br_\bu_\bn_\ba_\bs_\b__\bu_\bs_\be_\br
  92                            Evaluates to true if the command was run as the
  93                            specified _\br_\bu_\bn_\ba_\bs_\b__\bu_\bs_\be_\br.  Note that s\bsu\bud\bdo\bo runs commands
  94                            as user _\br_\bo_\bo_\bt by default.
  95
  96                    todate _\bd_\ba_\bt_\be
  97                            Evaluates to true if the command was run on or
  98                            prior to _\bd_\ba_\bt_\be.  See "Date and time format" for a
  99                            description of supported date and time formats.
 100
 101                    tty _\bt_\bt_\by Evaluates to true if the command was run on the
 102                            specified terminal device.  The _\bt_\bt_\by should be
 103                            specified without the _\b/_\bd_\be_\bv_\b/ prefix, e.g.  _\bt_\bt_\by_\b0_\b1
 104                            instead of _\b/_\bd_\be_\bv_\b/_\bt_\bt_\by_\b0_\b1.
 105
 106                    user _\bu_\bs_\be_\br _\bn_\ba_\bm_\be
 107                            Evaluates to true if the ID matches a command run
 108                            by _\bu_\bs_\be_\br _\bn_\ba_\bm_\be.
 109
 110                    Predicates may be abbreviated to the shortest unique string
 111                    (currently all predicates may be shortened to a single
 112                    character).
 113
 114                    Predicates may be combined using _\ba_\bn_\bd, _\bo_\br and _\b! operators as
 115                    well as '(' and ')' for grouping (note that parentheses
 116                    must generally be escaped from the shell).  The _\ba_\bn_\bd
 117                    operator is optional, adjacent predicates have an implied
 118                    _\ba_\bn_\bd unless separated by an _\bo_\br.
 119
 120        -m _\bm_\ba_\bx_\b__\bw_\ba_\bi_\bt Specify an upper bound on how long to wait between key
 121                    presses or output data.  By default, s\bsu\bud\bdo\bo_\b_r\bre\bep\bpl\bla\bay\by will
 122                    accurately reproduce the delays between key presses or
 123                    program output.  However, this can be tedious when the
 124                    session includes long pauses.  When the _\b-_\bm option is
 125                    specified, s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by will limit these pauses to at most
 126                    _\bm_\ba_\bx_\b__\bw_\ba_\bi_\bt seconds.  The value may be specified as a floating
 127
 128
 129
 130 1.7.4                     July 12, 2010                         2
 131
 132
 133
 134
 135
 136 SUDOREPLAY(1m)         MAINTENANCE COMMANDS        SUDOREPLAY(1m)
 137
 138
 139                    point number, .e.g. _\b2_\b._\b5.
 140
 141        -s _\bs_\bp_\be_\be_\bd_\b__\bf_\ba_\bc_\bt_\bo_\br
 142                    This option causes s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by to adjust the number of
 143                    seconds it will wait between key presses or program output.
 144                    This can be used to slow down or speed up the display.  For
 145                    example, a _\bs_\bp_\be_\be_\bd_\b__\bf_\ba_\bc_\bt_\bo_\br of _\b2 would make the output twice as
 146                    fast whereas a _\bs_\bp_\be_\be_\bd_\b__\bf_\ba_\bc_\bt_\bo_\br of <.5> would make the output
 147                    twice as slow.
 148
 149        -V          The -\b-V\bV (version) option causes s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by to print its
 150                    version number and exit.
 151
 152    D\bDa\bat\bte\be a\ban\bnd\bd t\bti\bim\bme\be f\bfo\bor\brm\bma\bat\bt
 153        The time and date may be specified multiple ways, common formats
 154        include:
 155
 156        HH:MM:SS am MM/DD/CCYY timezone
 157                24 hour time may be used in place of am/pm.
 158
 159        HH:MM:SS am Month, Day Year timezone
 160                24 hour time may be used in place of am/pm, and month and day
 161                names may be abbreviated.  Note that month and day of the week
 162                names must be specified in English.
 163
 164        CCYY-MM-DD HH:MM:SS
 165                ISO time format
 166
 167        DD Month CCYY HH:MM:SS
 168                The month name may be abbreviated.
 169
 170        Either time or date may be omitted, the am/pm and timezone are
 171        optional.  If no date is specified, the current day is assumed; if no
 172        time is specified, the first second of the specified date is used.  The
 173        less significant parts of both time and date may also be omitted, in
 174        which case zero is assumed.  For example, the following are all valid:
 175
 176        The following are all valid time and date specifications:
 177
 178        now     The current time and date.
 179
 180        tomorrow
 181                Exactly one day from now.
 182
 183        yesterday
 184                24 hours ago.
 185
 186        2 hours ago
 187                2 hours ago.
 188
 189        next Friday
 190                The first second of the next Friday.
 191
 192
 193
 194
 195
 196 1.7.4                     July 12, 2010                         3
 197
 198
 199
 200
 201
 202 SUDOREPLAY(1m)         MAINTENANCE COMMANDS        SUDOREPLAY(1m)
 203
 204
 205        this week
 206                The current time but the first day of the coming week.
 207
 208        a fortnight ago
 209                The current time but 14 days ago.
 210
 211        10:01 am 9/17/2009
 212                10:01 am, September 17, 2009.
 213
 214        10:01 am
 215                10:01 am on the current day.
 216
 217        10      10:00 am on the current day.
 218
 219        9/17/2009
 220                00:00 am, September 17, 2009.
 221
 222        10:01 am Sep 17, 2009
 223                10:01 am, September 17, 2009.
 224
 225 F\bFI\bIL\bLE\bES\bS
 226        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo        The default I/O log directory.
 227
 228        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bl_\bo_\bg
 229                                Example session log info.
 230
 231        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bs_\bt_\bd_\bi_\bn
 232                                Example session standard input log.
 233
 234        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bs_\bt_\bd_\bo_\bu_\bt
 235                                Example session standard output log.
 236
 237        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bs_\bt_\bd_\be_\br_\br
 238                                Example session standard error log.
 239
 240        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bt_\bt_\by_\bi_\bn
 241                                Example session tty input file.
 242
 243        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bt_\bt_\by_\bo_\bu_\bt
 244                                Example session tty output file.
 245
 246        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo_\b/_\b0_\b0_\b/_\b0_\b0_\b/_\b0_\b1_\b/_\bt_\bi_\bm_\bi_\bn_\bg
 247                                Example session timing file.
 248
 249        Note that the _\bs_\bt_\bd_\bi_\bn, _\bs_\bt_\bd_\bo_\bu_\bt and _\bs_\bt_\bd_\be_\br_\br files will be empty unless s\bsu\bud\bdo\bo
 250        was used as part of a pipeline for a particular command.
 251
 252 E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
 253        List sessions run by user _\bm_\bi_\bl_\bl_\be_\br_\bt:
 254
 255         sudoreplay -l user millert
 256
 257        List sessions run by user _\bb_\bo_\bb with a command containing the string vi:
 258
 259
 260
 261
 262 1.7.4                     July 12, 2010                         4
 263
 264
 265
 266
 267
 268 SUDOREPLAY(1m)         MAINTENANCE COMMANDS        SUDOREPLAY(1m)
 269
 270
 271         sudoreplay -l user bob command vi
 272
 273        List sessions run by user _\bj_\be_\bf_\bf that match a regular expression:
 274
 275         sudoreplay -l user jeff command '/bin/[a-z]*sh'
 276
 277        List sessions run by jeff or bob on the console:
 278
 279         sudoreplay -l ( user jeff or user bob ) tty console
 280
 281 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 282        _\bs_\bu_\bd_\bo(1m), _\bs_\bc_\br_\bi_\bp_\bt(1)
 283
 284 A\bAU\bUT\bTH\bHO\bOR\bR
 285        Todd C. Miller
 286
 287 B\bBU\bUG\bGS\bS
 288        If you feel you have found a bug in s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by, please submit a bug
 289        report at http://www.sudo.ws/sudo/bugs/
 290
 291 S\bSU\bUP\bPP\bPO\bOR\bRT\bT
 292        Limited free support is available via the sudo-users mailing list, see
 293        http://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or search
 294        the archives.
 295
 296 D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
 297        s\bsu\bud\bdo\bor\bre\bep\bpl\bla\bay\by is provided ``AS IS'' and any express or implied warranties,
 298        including, but not limited to, the implied warranties of
 299        merchantability and fitness for a particular purpose are disclaimed.
 300        See the LICENSE file distributed with s\bsu\bud\bdo\bo or
 301        http://www.sudo.ws/sudo/license.html for complete details.
 302
 303
 304
 305
 306
 307
 308
 309
 310
 311
 312
 313
 314
 315
 316
 317
 318
 319
 320
 321
 322
 323
 324
 325
 326
 327
 328 1.7.4                     July 12, 2010                         5
 329
 330