1radamsa(1)                  General Commands Manual                 radamsa(1)
2
3
4

NAME

6       radamsa - a general purpose fuzzer
7

SYNOPSIS

9       radamsa [options] [sample-path] ...
10

DESCRIPTION

12       Radamsa is a general purpose data fuzzer. It reads data from given sam‐
13       ple files, or standard input if none are given,  and  outputs  modified
14       data.  It  is  usually used to generate malformed data for testing pro‐
15       grams.
16

OPTIONS

18       This program follows the usual  GNU  command  line  syntax,  with  long
19       options  starting  with  two  dashes  (`-').   A  summary of options is
20       included below.
21
22       -h, --help
23              Show a shorter summary of options.
24
25       -V, --version
26              Show program version.
27
28       -o, --output pattern
29              Specify where to write the modified data. By default the data is
30              written  to standard output. The pattern can be a path, in which
31              %n is filled to be the test case number if present, :n  to  have
32              the  data  sent  to  TCP  clients connecting to local port n, or
33              a.b.c.d:n to have radamsa connect to  port  n  of  IPv4  address
34              a.b.c.d to send each output.
35
36       -n, --count n
37              How  many  outputs to generate based on the sample(s). Giving -1
38              or inf causes data to be generated forever. The default is 1.
39
40       -s, --seed n
41              Start from random state n, which is a decimal  number.  Starting
42              from  the same random state with the same command line arguments
43              and samples causes the same outputs to be generated. If no  seed
44              is given explicitly radamsa reads a random one from /dev/urandom
45              or takes the current time in milliseconds.
46
47       -M, --meta path
48              Write metadata about generated data to given path. - can be used
49              to  have  the  metadata written to standard output. The metadata
50              contains the seed followed by one line per testcase.
51
52       -l, --list
53              Show all available mutations, patterns and generators along with
54              their descriptions.
55
56       -r, --recursive
57              Include samples from directories recursively.
58
59       -v, --verbose
60              Print what is being done.
61
62       -m, --mutations string
63              Request  the  initial  mutation  probabilities manually. This is
64              generally not recommended and the options  will  change  in  the
65              future versions.
66
67       -p, --patterns string
68              Request  the  mutation  patterns manually. This is generally not
69              recommended and the options will change in the future versions.
70
71       -g, --generators string
72              Request the data stream generator probabilities  manually.  This
73              is  generally not recommended and the options will change in the
74              future versions.
75

EXAMPLES

77        $ cat file | radamsa | program -
78        $ radamsa samples/*.foo | program -
79        $ radamsa -o test-%n.foo -n 100 samples/*.foo
80        $ radamsa -o :80 -n inf samples/*.resp
81        $ radamsa -o 127.0.0.1:80 -n inf samples/*.req
82

SEE ALSO

84       zzuf(1)
85

BUGS

87       Bugs in radamsa can be filed to http://code.google.com/p/ouspg/ or sent
88       to  ouspg@ee.oulu.fi.  Bugs outside of radamsa should be filed to their
89       respective bug trackers.
90

AUTHOR

92       Radamsa  and   this   manual   page   were   written   by   Aki   Helin
93       <aki.helin@iki.fi> at OUSPG.
94
95
96
97                                March 28, 2012                      radamsa(1)
Impressum