Changeset 2328Tweet

Timestamp:

May 17, 2008, 3:40:45 PM (15 years ago)

Author:

Sam Hocevar

Message:

• Document the new command line parsing behaviour.

File:

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

zzuf/trunk/doc/zzuf.1

@@ -11 +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]
 .br
-       [\fIPROGRAM\fR [\fB\-\-\fR] [\fIARGS\fR]...]
+       [\fIPROGRAM\fR [\fIARGS\fR]...]
 .br
 \fBzzuf \-h\fR | \fB\-\-help\fR
@@ -29 +29 @@
 \fB    zzuf cat /dev/zero\fR
 .PP
-If you want to specify flags for your application, put a \(oq\fB\-\-\fR\(cq
-marker before them on the command line (otherwise \fBzzuf\fR will try to
-interpret them as arguments for itself), eg:
-.PP
-\fB    zzuf \-B 1000 cat \-\- \-v /dev/zero\fR
+Flags found after the application name are considered arguments for the
+application, not for \fBzzuf\fR. For instance, \fB\-v\fR below is an
+argument for \fBcat\fR:
+.PP
+\fB    zzuf \-B 1000 cat \-v /dev/zero\fR
 .PP
 When no program is specified, \fBzzuf\fR simply fuzzes the standard input, as
@@ -118 +118 @@
 .TP
 \fB\-F\fR, \fB\-\-max\-forks\fR=\fIforks\fR
-Specify the number of simultaneous children that can be run.
+Specify the number of simultaneous children that can be run. By default,
+\fBzzuf\fR only launches one process at a time.
 
 This option is only relevant if the \fB\-s\fR flag is used with a range
@@ -138 +139 @@
 will really be fuzzed only if N is in \fIlist\fR.
 
-Values start at one and ranges are inclusive. Use dashes between values and
+Values start at 1 and ranges are inclusive. Use dashes between values and
 commas between ranges. If the right-hand part of a range is ommited, it means
 all subsequent file descriptors. For instance, to restrict fuzzing to the
@@ -328 +329 @@
 want \fBzzuf\fR to fuzz them):
 .PP
-\fB    zzuf \-E \(aq\\.xml$\(aq convert \-\- foo.jpeg \-format tga /dev/null\fR
+\fB    zzuf \-E \(aq\\.xml$\(aq convert foo.jpeg \-format tga /dev/null\fR
 .PP
 Fuzz the input of VLC, using file \fBmovie.avi\fR as the original input
@@ -353 +354 @@
 \fB    zzuf \-c \-r0.001:0.02 \-s0:10000 \-b4\- \-q \-F5 \-D0.5 \-T60 \-S \\\fR
 .br
-\fB      mplayer \-\- \-benchmark \-vo null \-fps 1000 movie.avi\fR
+\fB      mplayer \-benchmark \-vo null \-fps 1000 movie.avi\fR
 .PP
 Create an HTML-like file that loads 200 times the same \fBhello.jpg\fR image