Changeset 1803 for zzufTweet

Timestamp:

Jul 10, 2007, 5:42:37 PM (16 years ago)

Author:

Sam Hocevar

Message:

• Documented the new -T / --max-cpu flag.

File:

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

zzuf/trunk/doc/zzuf.1

@@ -7 +7 @@
        [\fB\-f\fR \fIfuzzing\fR] [\fB\-D\fR \fIdelay\fR] [\fB\-F\fR \fIforks\fR] [\fB\-C\fR \fIcrashes\fR] [\fB\-B\fR \fIbytes\fR]
 .br
-       [\fB\-t\fR \fIseconds\fR] [\fB\-M\fR \fImegabytes\fR] [\fB\-P\fR \fIprotect\fR] [\fB\-R\fR \fIrefuse\fR]
-.br
-       [\fB\-p\fR \fIpick\fR] [\fB\-b\fR \fIranges\fR] [\fB\-I\fR \fIinclude\fR] [\fB\-E\fR \fIexclude\fR]
+       [\fB\-t\fR \fIseconds\fR] [\fB\-T\fR \fIseconds\fR] [\fB\-M\fR \fImegabytes\fR] [\fB\-b\fR \fIranges\fR]
+.br
+       [\fB\-P\fR \fIprotect\fR] [\fB\-R\fR \fIrefuse\fR] [\fB\-p\fR \fIpick\fR] [\fB\-I\fR \fIinclude\fR] [\fB\-E\fR \fIexclude\fR]
 .br
        [\fIPROGRAM\fR [\fB\-\-\fR] [\fIARGS\fR]...]
@@ -60 +60 @@
 Automatically terminate child processes that output more than \fIn\fR bytes
 on the standard output and standard error channels. This is useful to detect
-infinite loops. See also the \fB\-t\fR flag.
+infinite loops. See also the \fB\-t\fR and \fB\-T\fR flags.
 .TP
 \fB\-c\fR, \fB\-\-cmdline\fR
@@ -259 +259 @@
 Automatically terminate child processes that run for more than \fIn\fR
 seconds. This is useful to detect infinite loops or processes stuck in other
-situations. See also the \fB\-B\fR flag.
+situations. See also the \fB\-B\fR and \fB\-T\fR flags.
+.TP
+\fB\-T\fR, \fB\-\-max\-cpu\fR=\fIn\fR
+Automatically terminate child processes that use more than \fIn\fR seconds
+of CPU time.
+
+\fBzzuf\fR uses the \fBsetrlimit\fR() call to set CPU usage limitations and
+relies on the operating system's ability to enforce such limitations. If the
+system sends \fBSIGXCPU\fR signals and the application catches that signal,
+it will receive a \fBSIGKILL\fR signal after 5 seconds.
+
+This is more accurate than \fB\-t\fR because the behaviour should be
+independent from the system load, but it does not detect processes stuck into
+infinite \fBselect\fR() calls because they use very little CPU time. See also
+the \fB\-B\fR and \fB\-t\fR flags.
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR