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

Timestamp:

Jan 4, 2007, 9:59:05 AM (14 years ago)

Author:

Sam Hocevar

Message:

• Implemented -R / --refuse.

File:

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

zzuf/trunk/doc/zzuf.1

@@ -6 +6 @@
 .br
               [\fB\-F\fR \fIchildren\fR] [\fB\-B\fR \fIbytes\fR] [\fB\-T\fR \fIseconds\fR]
+.br
+              [\fB\-P\fR \fIlist\fR] [\fB\-R\fR \fIlist\fR]
 .br
               [\fB\-I\fR \fIinclude\fR] [\fB\-E\fR \fIexclude\fR] \fICOMMAND\fR [\fIARGS\fR]...
@@ -96 +98 @@
 You can use '\fB-\fR' to specify ranges. For instance, to protect all bytes
 from '\fB\\x01\fR' to ' ', use \fB\-P \(dq\\x01- \(dq\fR.
+
+See also the \fB\-R\fR flag.
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
@@ -108 +112 @@
 the input files undiscernible from random data. The default fuzzing ratio
 is 0.004 (fuzz 0.4% of the files' bits).
+.TP
+\fB\-R\fR, \fB\-\-refuse\fR=\fIlist\fR
+Refuse a list of characters by not fuzzing bytes that would otherwise be
+changed to a character that is in \fIlist\fR. If the original byte is already
+in \fIlist\fR, it is left unchanged.
+
+See the \fB\-P\fR option for a description of \fIlist\fR.
 .TP
 \fB\-s\fR, \fB\-\-seed\fR=\fIseed\fR
@@ -161 +172 @@
 .RE
 .PP
+Fuzz the input of the \fBcat\fR program but do not fuzz the newline character
+and prevent non-ASCII characters from appearing in the output:
+.PP
+.RS
+.nf
+\fB# zzuf -P \(dq\\n\(dq -R \(dq\\0-\\x1f\\x7f-\\xff\(dq cat /etc/motd\fR
+.fi
+.RE
+.PP
 Fuzz the input of the \fBconvert\fR program, using file \fBfoo.jpeg\fR as the
 original input and excluding \fB.xml\fR files from fuzzing (because