1radamsa(1) General Commands Manual radamsa(1)
2
6 radamsa - a general purpose fuzzer
7
9 radamsa [options] [sample-path] ...
10
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
18 This program follows the usual GNU command line syntax, with long op‐
19 tions starting with two dashes (`-'). A summary of options is included
20 below.
21 -h, --help
23 Show a shorter summary of options.
24 -V, --version
26 Show program version.
27 -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 -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 -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 -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 -l, --list
53 Show all available mutations, patterns and generators along with
54 their descriptions.
55 -r, --recursive
57 Include samples from directories recursively.
58 -v, --verbose
60 Print what is being done.
61 -m, --mutations string
63 Request the initial mutation probabilities manually. This is
64 generally not recommended and the options will change in the fu‐
65 ture versions.
66 -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 -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
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
84 zzuf(1)
85
87 Bugs in radamsa can be filed to https://gitlab.com/akihe/radamsa or
88 sent to aki.helin@iki.fi. Bugs outside of radamsa should be filed to
89 their respective bug trackers.
90
92 Radamsa and this manual page were written by Aki Helin <aki.he‐
93 lin@iki.fi> at OUSPG.
94 March 28, 2012 radamsa(1)