Changeset 1531 for zzuf/trunk/doc


Ignore:
Timestamp:
Jan 1, 2007, 8:49:57 PM (14 years ago)
Author:
Sam Hocevar
Message:
  • Alphabetise flags in help output and manpage.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • zzuf/trunk/doc/zzuf.1

    r1530 r1531  
    6262.SH OPTIONS
    6363.TP
    64 .B \-r, \-\-ratio <ratio>
    65 Specify the amount of bits that will be randomly fuzzed. A value of 0
    66 will not fuzz anything. A value of 0.05 will fuzz 5% of the open files'
    67 bits. A value of 1.0 or more will fuzz all the bytes, theoretically making
    68 the input files undiscernible from random data. The default fuzzing ratio
    69 is 0.004 (fuzz 0.4% of the files' bits).
    70 .TP
    71 .B \-s, \-\-seed <seed>
    72 .PD 0
    73 .TP
    74 .B \-s, \-\-seed <start:stop>
    75 .PD
    76 Specify the random seed to use for fuzzing, or an interval of random seeds.
    77 Running
    78 .B zzuf
    79 twice with the same random seed will fuzz the files exactly the same way,
    80 even with a different target application. The purpose of this is to use
    81 simple utilities such as
    82 .B cat
    83 or
    84 .B cp
    85 to generate a file that causes the target application to crash.
    86 
    87 If an interval is specified,
    88 .B zzuf
    89 will run the application several times, each time with a different seed, and
    90 report the behaviour of each run.
    91 .TP
    92 .B \-F, \-\-fork <children>
    93 Specify the number of simultaneous children that can be run. This option is
    94 only useful if the
    95 .B \-s
    96 flag is used with an interval argument.
    97 .TP
    9864.B \-B, \-\-max\-bytes <n>
    9965Automatically terminate child processes that output more than
     
    10167bytes on the standard output and standard error channels. This is useful to
    10268detect infinite loops.
    103 .TP
    104 .B \-T, \-\-max\-time <n>
    105 Automatically terminate child processes that run for more than
    106 .B <n>
    107 seconds. This is useful to detect infinite loops or processes stuck in other
    108 situations.
    109 .TP
    110 .B \-q, \-\-quiet
    111 Hide the output of the fuzzed application. This is useful if the application
    112 is very verbose but only its exit code is really useful to you.
    113 .TP
    114 .B \-i, \-\-stdin
    115 Fuzz the application's standard input. By default
    116 .B zzuf
    117 only fuzzes files.
    118 .TP
    119 .B \-I, \-\-include <regex>
    120 Only fuzz files whose name matches the
    121 .B <regex>
    122 regular expression. Use this for instance if your application reads
    123 configuration files at startup and you only want specific files to be fuzzed.
    124 
    125 Multiple
    126 .B \-I
    127 flags can be specified, in which case files matching any one of the regular
    128 expressions will be fuzzed.
    12969.TP
    13070.B \-c, \-\-cmdline
     
    13979flag for more information.
    14080.TP
     81.B \-d, \-\-debug
     82Activate the display of debug messages.
     83.TP
    14184.B \-E, \-\-exclude <regex>
    14285Do not fuzz files whose name matches the
     
    15497expressions will be ignored.
    15598.TP
    156 .B \-d, \-\-debug
    157 Activate the display of debug messages.
     99.B \-F, \-\-fork <children>
     100Specify the number of simultaneous children that can be run. This option is
     101only useful if the
     102.B \-s
     103flag is used with an interval argument.
    158104.TP
    159105.B \-h, \-\-help
    160106Display a short help message and exit.
     107.TP
     108.B \-i, \-\-stdin
     109Fuzz the application's standard input. By default
     110.B zzuf
     111only fuzzes files.
     112.TP
     113.B \-I, \-\-include <regex>
     114Only fuzz files whose name matches the
     115.B <regex>
     116regular expression. Use this for instance if your application reads
     117configuration files at startup and you only want specific files to be fuzzed.
     118
     119Multiple
     120.B \-I
     121flags can be specified, in which case files matching any one of the regular
     122expressions will be fuzzed.
     123.TP
     124.B \-q, \-\-quiet
     125Hide the output of the fuzzed application. This is useful if the application
     126is very verbose but only its exit code is really useful to you.
     127.TP
     128.B \-r, \-\-ratio <ratio>
     129Specify the amount of bits that will be randomly fuzzed. A value of 0
     130will not fuzz anything. A value of 0.05 will fuzz 5% of the open files'
     131bits. A value of 1.0 or more will fuzz all the bytes, theoretically making
     132the input files undiscernible from random data. The default fuzzing ratio
     133is 0.004 (fuzz 0.4% of the files' bits).
     134.TP
     135.B \-s, \-\-seed <seed>
     136.PD 0
     137.TP
     138.B \-s, \-\-seed <start:stop>
     139.PD
     140Specify the random seed to use for fuzzing, or an interval of random seeds.
     141Running
     142.B zzuf
     143twice with the same random seed will fuzz the files exactly the same way,
     144even with a different target application. The purpose of this is to use
     145simple utilities such as
     146.B cat
     147or
     148.B cp
     149to generate a file that causes the target application to crash.
     150
     151If an interval is specified,
     152.B zzuf
     153will run the application several times, each time with a different seed, and
     154report the behaviour of each run.
     155.TP
     156.B \-T, \-\-max\-time <n>
     157Automatically terminate child processes that run for more than
     158.B <n>
     159seconds. This is useful to detect infinite loops or processes stuck in other
     160situations.
    161161.TP
    162162.B \-v, \-\-version
Note: See TracChangeset for help on using the changeset viewer.