Changeset 1672 for zzuf/trunk/doc


Ignore:
Timestamp:
Jan 15, 2007, 12:41:03 AM (14 years ago)
Author:
Sam Hocevar
Message:
  • Support ranges with the -r flag.
File:
1 edited

Legend:

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

    r1670 r1672  
    33zzuf \- multiple purpose fuzzer
    44.SH SYNOPSIS
    5 \fBzzuf\fR [\fB\-AcdiMnqSvx\fR] [\fB\-r\fR \fIratio\fR] [\fB\-s\fR \fIseed\fR|\fB\-s\fR \fIstart:stop\fR]
     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 \fIstart:stop\fR]
    66.br
    77                   [\fB\-D\fR \fIdelay\fR] [\fB\-F\fR \fIforks\fR] [\fB\-C\fR \fIcrashes\fR] [\fB\-B\fR \fIbytes\fR]
     
    4141\fB\-A\fR, \fB\-\-autoinc\fR
    4242Increment random seed each time a new file is opened. This is only required
    43 if the same application is expected to open the same file several times and
    44 you want to test a different seed each time.
     43if one instance of the application is expected to open the same file several
     44times and you want to test a different seed each time.
    4545.TP
    4646\fB\-B\fR, \fB\-\-max\-bytes\fR=\fIn\fR
     
    166166.TP
    167167\fB\-r\fR, \fB\-\-ratio\fR=\fIratio\fR
     168.PD 0
     169.TP
     170\fB\-r\fR, \fB\-\-ratio\fR=\fIstart:stop\fR
     171.PD
    168172Specify the proportion of bits that will be randomly fuzzed. A value of 0
    169173will not fuzz anything. A value of 0.05 will fuzz 5% of the open files'
     
    171175the input files undiscernible from random data. The default fuzzing ratio
    172176is 0.004 (fuzz 0.4% of the files' bits).
     177
     178An interval can be specified. When doing so, \fBzzuf\fR will pick ratio
     179values from the interval. This is only meaningful if an interval is also
     180specified with the \fB\-s\fR flag.
    173181.TP
    174182\fB\-R\fR, \fB\-\-refuse\fR=\fIlist\fR
     
    259267\fB    vlc fuzzy\-movie.avi\fR
    260268.PP
    261 Fuzz 2% of \fBMPlayer\fR's input bits (\fB\-r\ 0.02\fR) with seeds 0 to 9999
    262 (\fB\-s\ 0:10000\fR), disabling its standard output messages (\fB\-q\fR),
    263 launching up to five simultaneous child processes (\fB\-F\ 5\fR) but wait at
    264 least half a second between launches (\fB\-D\ 0.5\fR), killing \fBMPlayer\fR
    265 if it takes more than one minute to read the file (\fB\-T\ 60\fR) and
    266 disabling its \fBSIGSEGV\fR signal handler (\fB\-S\fR):
    267 .PP
    268 \fB    zzuf \-c \-r 0.02 \-q \-s 0:10000 \-F 5 \-D 0.5 \-T 60 \-S \\\fR
     269Fuzz between 0.1% and 2% of \fBMPlayer\fR's input bits (\fB\-r\ 0.001:0.02\fR)
     270with seeds 0 to 9999 (\fB\-s\ 0:10000\fR), disabling its standard output
     271messages (\fB\-q\fR), launching up to five simultaneous child processes
     272(\fB\-F\ 5\fR) but wait at least half a second between launches
     273(\fB\-D\ 0.5\fR), killing \fBMPlayer\fR if it takes more than one minute to
     274read the file (\fB\-T\ 60\fR) and disabling its \fBSIGSEGV\fR signal handler
     275(\fB\-S\fR):
     276.PP
     277\fB    zzuf \-c \-r 0.001:0.02 \-q \-s 0:10000 \-F 5 \-D 0.5 \-T 60 \-S \\\fR
    269278.br
    270279\fB      mplayer \-\- \-benchmark \-vo null \-fps 1000 movie.avi\fR
Note: See TracChangeset for help on using the changeset viewer.