Ignore:
Timestamp:
Jan 13, 2010, 2:09:30 AM (10 years ago)
Author:
Sam Hocevar
Message:

Rename -t/--max-time to -U/--max-usertime, and add -t/--max-time to
roughly mean "maximum zzuf run time". Fixes bug #45.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • zzuf/trunk/doc/zzuf.1.in

    r4253 r4264  
    33zzuf \- multiple purpose fuzzer
    44.SH SYNOPSIS
    5 \fBzzuf\fR [\fB\-AcdimnqSvx\fR] [\fB\-s\fR \fIseed\fR|\fB\-s\fR \fIstart:stop\fR] [\fB\-r\fR \fIratio\fR|\fB\-r\fR \fImin:max\fR]
    6 .br
    7        [\fB\-f\fR \fIfuzzing\fR] [\fB\-D\fR \fIdelay\fR] [\fB\-j\fR \fIjobs\fR] [\fB\-C\fR \fIcrashes\fR] [\fB\-B\fR \fIbytes\fR]
    8 .br
    9        [\fB\-t\fR \fIseconds\fR] [\fB\-T\fR \fIseconds\fR] [\fB\-M\fR \fImebibytes\fR] [\fB\-b\fR \fIranges\fR] [\fB\-p\fR \fIports\fR]
    10 .br
    11        [\fB\-P\fR \fIprotect\fR] [\fB\-R\fR \fIrefuse\fR] [\fB\-l\fR \fIlist\fR] [\fB\-I\fR \fIinclude\fR] [\fB\-E\fR \fIexclude\fR]
    12 .br
    13       [\fIPROGRAM\fR [\fIARGS\fR]...]
     5\fBzzuf\fR [\fB\-AcdimnqSvx\fR]
     6[\fB\-s\fR \fIseed\fR|\fB\-s\fR \fIstart:stop\fR]
     7[\fB\-r\fR \fIratio\fR|\fB\-r\fR \fImin:max\fR]
     8[\fB\-f\fR \fIfuzzing\fR] [\fB\-D\fR \fIdelay\fR] [\fB\-j\fR \fIjobs\fR]
     9[\fB\-C\fR \fIcrashes\fR] [\fB\-B\fR \fIbytes\fR] [\fB\-t\fR \fIseconds\fR]
     10[\fB\-T\fR \fIseconds\fR] [\fB\-U\fR \fIseconds\fR] [\fB\-M\fR \fImebibytes\fR]
     11[\fB\-b\fR \fIranges\fR] [\fB\-p\fR \fIports\fR] [\fB\-P\fR \fIprotect\fR]
     12[\fB\-R\fR \fIrefuse\fR] [\fB\-l\fR \fIlist\fR] [\fB\-I\fR \fIinclude\fR]
     13[\fB\-E\fR \fIexclude\fR] [\fIPROGRAM\fR [\fIARGS\fR]...]
    1414.br
    1515\fBzzuf \-h\fR | \fB\-\-help\fR
     
    6464standard input if no program is being fuzzed.
    6565
    66 This is useful to detect infinite loops. See also the \fB\-t\fR and \fB\-T\fR
     66This is useful to detect infinite loops. See also the \fB\-U\fR and \fB\-T\fR
    6767flags.
    6868.TP
     
    8585of 0 tells \fBzzuf\fR to never stop.
    8686
     87Note that \fBzzuf\fR will not kill any remaining children once \fIn\fR is
     88reached. To ensure that processes do not last forever, see the \fB\-U\fR
     89flag.
     90
    8791A process is considered to have crashed if any signal (such as, but not limited
    8892to, \fBSIGSEGV\fR) caused it to exit. If the \fB\-x\fR flag is used, this will
     
    9094
    9195This option is only relevant if the \fB\-s\fR flag is used with a range
    92 argument.
     96argument. See also the \fB\-t\fR flag.
    9397.TP
    9498\fB\-d\fR, \fB\-\-debug\fR
     
    288292.TP
    289293\fB\-t\fR, \fB\-\-max\-time\fR=\fIn\fR
    290 Automatically terminate child processes that run for more than \fIn\fR
    291 seconds. This is useful to detect infinite loops or processes stuck in other
    292 situations. See also the \fB\-B\fR and \fB\-T\fR flags.
     294Stop forking after \fIn\fR seconds. By default, \fBzzuf\fR runs until the
     295end of the seed range is reached.
     296
     297Note that \fBzzuf\fR will not kill any remaining children once \fIn\fR is
     298reached. To ensure that processes do not last forever, see the \fB\-U\fR
     299flag.
     300
     301This option is only relevant if the \fB\-s\fR flag is used with a range
     302argument. See also the \fB\-C\fR flag.
    293303.TP
    294304\fB\-T\fR, \fB\-\-max\-cputime\fR=\fIn\fR
     
    301311it will receive a \fBSIGKILL\fR signal after 5 seconds.
    302312
    303 This is more accurate than \fB\-t\fR because the behaviour should be
     313This is more accurate than \fB\-U\fR because the behaviour should be
    304314independent from the system load, but it does not detect processes stuck into
    305315infinite \fBselect\fR() calls because they use very little CPU time. See also
    306 the \fB\-B\fR and \fB\-t\fR flags.
     316the \fB\-B\fR and \fB\-U\fR flags.
     317.TP
     318\fB\-U\fR, \fB\-\-max\-usertime\fR=\fIn\fR
     319Automatically terminate child processes that run for more than \fIn\fR
     320seconds. This is useful to detect infinite loops or processes stuck in other
     321situations. See also the \fB\-B\fR and \fB\-T\fR flags.
    307322.TP
    308323\fB\-v\fR, \fB\-\-verbose\fR
Note: See TracChangeset for help on using the changeset viewer.