.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-fuzzer-fuzz 1 "2022-01-01" Ronin Fuzzer "User Manuals"
.SH NAME
.PP
ronin\-fuzzer\-fuzz \- Performs basic fuzzing of files
.SH SYNOPSIS
.PP
\fBronin\-fuzzer fuzz\fR \[lB]\fIoptions\fP\[rB] \[lB]\fITEMPLATE\fP\[rB]
.SH DESCRIPTION
.PP
Fuzzes data read from a \fIFILE\fP or from \fBSTDIN\fR\. The fuzzed data can be written
to output files, run in commands or sent to TCP\[sl]UDP services\.
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-\[lB]no\-\[rB]verbose\fR
Enable verbose output\.
.TP
\fB\-q\fR, \fB\-\-\[lB]no\-\[rB]quiet\fR
Disable verbose output\.
.TP
\fB\-\-\[lB]no\-\[rB]silent\fR
Silence all output\.
.TP
\fB\-i\fR, \fB\-\-input\fR \fIFILE\fP
The input text FILE to parse\. Data will be read from \fBSTDIN\fR by default\.
.TP
\fB\-r\fR, \fB\-\-rule\fR \[lB]\fIPATTERN\fP\[or]\fI\[sl]REGEXP\[sl]\fP\[or]STRING\[rB]:\[lB]\fIMETHOD\fP\[or]\fISTRING\fP\fI*N\fP\[lB]\-\fIM\fP\[rB]\[rB]
The rule to apply to the \fIINPUT\fP\. Fuzzer rules consist of a pattern and
substitution\. Patterns may be one of the following:
.RS
.RS
.IP \(bu 2
A name of a Ronin Regular Expression (ex: \fBunix\[ru]path\fR)
.IP \(bu 2
A custom Regular Expression (ex: \fB\[sl]\ed\[pl]\[sl]\fR)
.IP \(bu 2
A plain String (ex: \fBexample\.com\fR)\.
.IP \( 2
Substitutions may be one of the following:
.IP \(bu 2
A method from \fBRonin::Fuzzer\fR (ex: \fBbad\[ru]strings\fR)
.IP \(bu 2
A \fISTRING\fP, repeated \fIN\fP or \fIM\fP times (ex: \fBA*100\-200\fR)\.
.RE
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fIPATH\fP
The output PATH to write the fuzzer to\.
.TP
\fB\-c\fR, \fB\-\-command\fR \fICOMMAND\fP
The command to run with the fuzzed data\. All occurrences of \fB\[sh]string\[sh]\fR
will be replaced with the fuzzed data, and occurrences of \fB\[sh]path\[sh]\fR will
be replaced with the path to the fuzzed data\.
.TP
\fB\-t\fR, \fB\-\-tcp\fR \fIHOST\fP:\fIPORT\fP
The TCP service to send the fuzzed data to\.
.TP
\fB\-u\fR, \fB\-\-udp\fR \fIHOST\fP:\fIPORT\fP
The UDP service to send the fuzzed data to\.
.TP
\fB\-p\fR, \fB\-\-pause\fR \fISECONDS\fP
Pause in between mutations\.
.SH EXAMPLES
.TP
\fBronin\-fuzzer fuzz \-i http\[ru]request\.txt \-o bad\.txt \-r unix\[ru]path:bad\[ru]strings\fR
Fuzzes a HTTP request, replacing every occurrence of a UNIX path, with
strings from the \fBbad\[ru]strings\fR method\.
.SH LINKS
.TP
Ronin Regular Expressions
https:\[sl]\[sl]ronin\-rb\.dev\[sl]docs\[sl]ronin\-support\[sl]Regexp\.html
.TP
\fBRonin::Fuzzer\fR
https:\[sl]\[sl]ronin\-rb\.dev\[sl]docs\[sl]ronin\-fuzzer\[sl]Ronin\[sl]Fuzzer\.html
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME