.TH ronin\-fuzzer 1 "April 2012" Ronin "User Manuals"
.SH SYNOPSIS
.PP
\fB\fCronin fuzzer\fR [\fIoptions\fP] [\fITEMPLATE\fP]
.SH DESCRIPTION
.PP
Fuzzes data read from a \fIFILE\fP or from \fB\fCSTDIN\fR. The fuzzed data can be written
to output files, run in commands or sent to TCP/UDP services.
.SH OPTIONS
.TP
\fB\fC-v\fR, \fB\fC--[no-]verbose\fR
Enable verbose output.
.TP
\fB\fC-q\fR, \fB\fC--[no-]quiet\fR
Disable verbose output.
.TP
\fB\fC--[no-]silent\fR
Silence all output.
.TP
\fB\fC--[no-]color\fR
Enables color output.
.TP
\fB\fC-i\fR, \fB\fC--input\fR \fIFILE\fP
The input text FILE to parse. Data will be read from \fB\fCSTDIN\fR by default.
.TP
\fB\fC-r\fR, \fB\fC--rule\fR [\fIPATTERN\fP|\fI/REGEXP/\fP|STRING]:[\fIMETHOD\fP|\fISTRING\fP*\fIN\fP[\-\fIM\fP]]
The rule to apply to the \fIINPUT\fP. Fuzzer rules consist of a pattern and 
substitution. Patterns may be one of the following:
.RS
.IP \(bu 2
A name of a Ronin Regular Expression (ex: \fB\fCunix_path\fR)
.IP \(bu 2
A custom Regular Expression (ex: \fB\fC/\d+/\fR)
.IP \(bu 2
A plain String (ex: \fB\fCexample.com\fR).
.PP
Substitutions may be one of the following:
.IP \(bu 2
A method from \fB\fCRonin::Fuzzing\fR (ex: \fB\fCbad_strings\fR)
.IP \(bu 2
A \fISTRING\fP, repeated \fIN\fP or \fIM\fP times (ex: \fB\fCA*100-200\fR).
.RE
.TP
\fB\fC-o\fR, \fB\fC--output\fR \fIPATH\fP
The output PATH to write the fuzzer to.
.TP
\fB\fC-c\fR, \fB\fC--command\fR \fICOMMAND\fP
The command to run with the fuzzed data. All ocurrences of \fB\fC#string#\fR will be
replaced with the fuzzed data, and ocurrences of \fB\fC#path#\fR will be replaced
with the path to the fuzzed data.
.TP
\fB\fC-t\fR, \fB\fC--tcp\fR \fIHOST\fP:\fIPORT\fP
The TCP service to send the fuzzed data to.
.TP
\fB\fC-u\fR, \fB\fC--udp\fR \fIHOST\fP:\fIPORT\fP
The UDP service to send the fuzzed data to.
.SH EXAMPLES
.TP
\fB\fCronin fuzzer -i http_request.txt -o bad.txt -r unix_path:bad_strings\fR
Fuzzes a HTTP request, replacing every occurrence of a UNIX path, with
strings from the \fB\fCbad_strings\fR method.
.SH LINKS
.TP
Ronin Regular Expressions
http://ronin\-ruby.github.com/docs/ronin\-support/Regexp.html
.TP
\fB\fCRonin::Fuzzing\fR
http://ronin\-ruby.github.com/docs/ronin\-support/Ronin/Fuzzing.html
.SH AUTHOR
.PP
Postmodern 
.MT postmodern.mod3@gmail.com
.ME