Changeset 2365


Ignore:
Timestamp:
Jun 13, 2008, 11:31:17 AM (12 years ago)
Author:
Sam Hocevar
Message:
  • Finished the libzzuf manual page.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • zzuf/trunk/doc/libzzuf.3

    r2353 r2365  
    55.PP
    66\fBlibzzuf\fR is a helper library automatically preloaded by \fBzzuf\fR when
    7 fuzzing applications, but it can also be used alone for very specific cases.
     7fuzzing applications, but it can also be used alone for debugging purposes or
     8specific cases that cannot be covered by \fBzzuf\fR.
    89.SH USAGE
    910.PP
     
    1516.PP
    1617\fBlibzzuf\fR's initial setup is done through environment variables. After
    17 they are read, no further communication is done with the fuzzed process. All
    18 environment variables are optional.
     18they are read, no further information can be sent to the fuzzed process.
     19
     20All environment variables are optional.
    1921.TP
    2022\fBZZUF_DEBUG\fR
    2123This environment variable is set to a file descriptor where \fBlibzzuf\fR will
    22 send debugging information.
     24send debugging information. This is used to send data to the main \fBzzuf\fR
     25controlling binary.
    2326.TP
    2427\fBZZUF_SEED\fR
    25 This variable is set to the initial seed.
     28This variable is set to the initial random seed. Corresponding \fBzzuf\fR flag:
     29\fB\-\-seed\fR.
    2630.TP
    2731\fBZZUF_MINRATIO\fR, \fBZZUF_MAXRATIO\fR
    28 These variables are set to the minimal and maximal seed ratios.
     32These variables are set to the minimal and maximal fuzzing ratios.
     33Corresponding \fBzzuf\fR flag: \fB\-\-ratio\fR.
    2934.TP
    3035\fBZZUF_AUTOINC\fR
    31 To do.
     36If this variable is set, the random seed is incremented each time a new
     37file is opened. Corresponding \fBzzuf\fR flag: \fB\-\-autoinc\fR.
    3238.TP
    3339\fBZZUF_BYTES\fR
    34 To do.
     40This variable contains byte ranges to which fuzzing should be restricted.
     41Corresponding \fBzzuf\fR flag: \fB\-\-bytes\fR.
    3542.TP
    3643\fBZZUF_LIST\fR
    37 To do.
     44This variable contains file descriptor ranges to which fuzzing should be
     45restricted. Corresponding \fBzzuf\fR flag: \fB\-\-list\fR.
     46.TP
     47\fBZZUF_NETWORK\fR
     48If this variable is set, network mode is activated. Corresponding \fBzzuf\fR
     49flag: \fB\-\-network\fR.
    3850.TP
    3951\fBZZUF_PORTS\fR
    40 To do.
     52This variable contains port ranges to which fuzzing should be restricted.
     53Corresponding \fBzzuf\fR flag: \fB\-\-port\fR.
    4154.TP
    42 \fBZZUF_PROTECT\fR
    43 To do.
     55\fBZZUF_PROTECT\fR, \fBZZUF_REFUSE\fR
     56These variables contain character ranges to protect or refuse. Corresponding
     57\fBzzuf\fR flags: \fB\-\-protect\fR, \fB\-\-refuse\fR.
    4458.TP
    45 \fBZZUF_REFUSE\fR
    46 To do.
    47 .TP
    48 \fBZZUF_INCLUDE\fR
    49 To do.
    50 .TP
    51 \fBZZUF_EXCLUDE\fR
    52 To do.
     59\fBZZUF_INCLUDE\fR, \fBZZUF_EXCLUDE\fR
     60These variables contain regular expressions to indicate which files should be
     61included or excluded from the list of fuzzed files. Corresponding \fBzzuf\fR
     62flags: \fB\-\-include\fR, \fB\-\-exclude\fR.
    5363.TP
    5464\fBZZUF_SIGNAL\fR
    55 To do.
     65If this variable is set, the fuzzed process will be prevented from installing
     66signal handlers that usually cause coredumps. Corresponding \fBzzuf\fR flag:
     67\fB\-\-signal\fR.
    5668.TP
    5769\fBZZUF_MEMORY\fR
    58 To do.
    59 .TP
    60 \fBZZUF_NETWORK\fR
    61 To do.
     70This variable contains the maximum amount of memory that the fuzzed process
     71is allowed to allocate. Corresponding \fBzzuf\fR flag: \fB\-\-max-memory\fR.
    6272.TP
    6373\fBZZUF_STDIN\fR
    64 To do.
     74If this variable is set, standard input will be fuzzed, too. Corresponding
     75\fBzzuf\fR flag: \fB\-\-stdin\fR.
    6576.SH NOTES
    6677In order to intercept file and network operations, signal handlers and memory
     
    110121.SH SEE ALSO
    111122.PP
    112 \fBzzuf(1)\fR
     123\fBzzuf(1)\fR, \fBld.so(8)\fR
    113124.SH AUTHOR
    114125.PP
Note: See TracChangeset for help on using the changeset viewer.