Changeset 1672 for zzuf/trunk/doc/zzuf.1Tweet

Timestamp:

Jan 15, 2007, 12:41:03 AM (14 years ago)

Author:

Sam Hocevar

Message:

• Support ranges with the -r flag.

File:

• zzuf/trunk/doc/zzuf.1 (modified) (5 diffs)

zzuf/trunk/doc/zzuf.1

@@ -3 +3 @@
 zzuf \- multiple purpose fuzzer
 .SH SYNOPSIS
-\fBzzuf\fR [\fB\-AcdiMnqSvx\fR] [\fB\-r\fR \fIratio\fR] [\fB\-s\fR \fIseed\fR|\fB\-s\fR \fIstart:stop\fR]
+\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]
 .br
                    [\fB\-D\fR \fIdelay\fR] [\fB\-F\fR \fIforks\fR] [\fB\-C\fR \fIcrashes\fR] [\fB\-B\fR \fIbytes\fR]
@@ -41 +41 @@
 \fB\-A\fR, \fB\-\-autoinc\fR
 Increment random seed each time a new file is opened. This is only required
-if the same application is expected to open the same file several times and
-you want to test a different seed each time.
+if one instance of the application is expected to open the same file several
+times and you want to test a different seed each time.
 .TP
 \fB\-B\fR, \fB\-\-max\-bytes\fR=\fIn\fR
@@ -166 +166 @@
 .TP
 \fB\-r\fR, \fB\-\-ratio\fR=\fIratio\fR
+.PD 0
+.TP
+\fB\-r\fR, \fB\-\-ratio\fR=\fIstart:stop\fR
+.PD
 Specify the proportion of bits that will be randomly fuzzed. A value of 0
 will not fuzz anything. A value of 0.05 will fuzz 5% of the open files'
@@ -171 +175 @@
 the input files undiscernible from random data. The default fuzzing ratio
 is 0.004 (fuzz 0.4% of the files' bits).
+
+An interval can be specified. When doing so, \fBzzuf\fR will pick ratio
+values from the interval. This is only meaningful if an interval is also
+specified with the \fB\-s\fR flag.
 .TP
 \fB\-R\fR, \fB\-\-refuse\fR=\fIlist\fR
@@ -259 +267 @@
 \fB    vlc fuzzy\-movie.avi\fR
 .PP
-Fuzz 2% of \fBMPlayer\fR's input bits (\fB\-r\ 0.02\fR) with seeds 0 to 9999
-(\fB\-s\ 0:10000\fR), disabling its standard output messages (\fB\-q\fR),
-launching up to five simultaneous child processes (\fB\-F\ 5\fR) but wait at
-least half a second between launches (\fB\-D\ 0.5\fR), killing \fBMPlayer\fR
-if it takes more than one minute to read the file (\fB\-T\ 60\fR) and
-disabling its \fBSIGSEGV\fR signal handler (\fB\-S\fR):
-.PP
-\fB    zzuf \-c \-r 0.02 \-q \-s 0:10000 \-F 5 \-D 0.5 \-T 60 \-S \\\fR
+Fuzz between 0.1% and 2% of \fBMPlayer\fR's input bits (\fB\-r\ 0.001:0.02\fR)
+with seeds 0 to 9999 (\fB\-s\ 0:10000\fR), disabling its standard output
+messages (\fB\-q\fR), launching up to five simultaneous child processes
+(\fB\-F\ 5\fR) but wait at least half a second between launches
+(\fB\-D\ 0.5\fR), killing \fBMPlayer\fR if it takes more than one minute to
+read the file (\fB\-T\ 60\fR) and disabling its \fBSIGSEGV\fR signal handler
+(\fB\-S\fR):
+.PP
+\fB    zzuf \-c \-r 0.001:0.02 \-q \-s 0:10000 \-F 5 \-D 0.5 \-T 60 \-S \\\fR
 .br
 \fB      mplayer \-\- \-benchmark \-vo null \-fps 1000 movie.avi\fR