Changeset 1554 for zzuf/trunk/doc/zzuf.1

Timestamp:

01/04/07 02:09:04 (6 years ago)

Author:

sam

Message:

• Implement -P / --protect.

File:

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

zzuf/trunk/doc/zzuf.1

@@ -56 +56 @@
 only useful if the \fB\-s\fR flag is used with an interval argument.
 .TP
-\fB\-h\fR, \fB\-\-help\fR
-Display a short help message and exit.
-.TP
 \fB\-i\fR, \fB\-\-stdin\fR
 Fuzz the application's standard input. By default \fBzzuf\fR only fuzzes files.
@@ -69 +66 @@
 Multiple \fB\-I\fR flags can be specified, in which case files matching any one
 of the regular expressions will be fuzzed. See also the \fB\-c\fR flag.
+.TP
+\fB\-P\fR, \fB\-\-protect\fR=\fIlist\fR
+Protect a list of characters so that if they appear in input data that would
+normally be fuzzed, they are left unmodified instead.
+
+Characters in \fIlist\fR can be expressed verbatim or through escape sequences.
+The sequences interpreted by \fBzzuf\fR are:
+.RS
+.TP
+\fB\\n\fR
+new line
+.TP
+\fB\\r\fR
+return
+.TP
+\fB\\t\fR
+tabulation
+.TP
+\fB\\0\fR
+the null character
+.TP
+\fB\\x\fR\fINN\fR
+the byte whose hexadecimal value is \fINN\fR
+.TP
+\fB\\\\\fR
+backslash ('\\')
+.RE
+.IP
+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.
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
@@ -111 +138 @@
 situations. See also the \fB\-B\fR flag.
 .TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a short help message and exit.
+.TP
 \fB\-v\fR, \fB\-\-version\fR
 Output version information and exit.
@@ -180 +210 @@
 fail in the presence of any mechanism that disables preloading. For instance
 setuid root binaries will not be fuzzed when run as an unprivileged user.
+.PP
+As of now, \fBzzuf\fR does not really support multithreaded applications. The
+behaviour with multithreaded applications where more than one thread do file
+descriptor operations is undefined.
 .SH AUTHOR
 .PP