.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-proxy 1 "2023-02-01" Ronin "User Manuals"
.SH NAME
.PP
ronin\-proxy \- Starts a TCP\[sl]UDP\[sl]SSL\[sl]TLS intercept proxy server
.SH SYNOPSIS
.PP
\fBronin proxy\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIPROXY\[ru]HOST\fP:\[rB]\fIPROXY\[ru]PORT\fP \fIUPSTREAM\[ru]HOST\fP:\fIUPSTREAM\[ru]PORT\fP
.SH DESCRIPTION
.PP
Starts a TCP\[sl]UDP\[sl]SSL\[sl]TLS proxy server\.
.SH ARGUMENTS
.TP
\fIPROXY\[ru]HOST\fP
The local host to listen on\.
.TP
\fIPROXY\[ru]PORT\fP
The local port to bind to\.
.TP
\fIUPSTREAM\[ru]HOST\fP
The upstream host to proxy data to\.
.TP
\fIUPSTREAM\[ru]PORT\fP
The upstream port to proxy data to\.
.SH OPTIONS
.TP
\fB\-t\fR, \fB\-\-tcp\fR
Enables or disables TCP mode\.
.TP
\fB\-S\fR, \fB\-\-ssl\fR
Enables or disables SSL mode\.
.TP
\fB\-T\fR, \fB\-\-tls\fR
Enables or disables TLS mode\.
.TP
\fB\-u\fR, \fB\-\-udp\fR
Enables or disables UDP mode\.
.TP
\fB\-x\fR, \fB\-\-\[lB]no\-\[rB]hexdump\fR
Enables or disables hexdump mode\.
.TP
\fB\-r\fR, \fB\-\-rewrite\fR \fI\[sl]REGEXP\[sl]:STRING\fP
Replace REGEXP with STRING in every message\.
.TP
\fB\-\-rewrite\-client\fR \fI\[sl]REGEXP\[sl]:STRING\fP
Replace REGEXP with STRING in every client message\.
.TP
\fB\-\-rewrite\-server\fR \fI\[sl]REGEXP\[sl]:STRING\fP
Replace REGEXP with STRING in every server message\.
.TP
\fB\-i\fR, \fB\-\-ignore\fR \fI\[sl]REGEXP\[sl]\fP
Ignore messages matching the REGEXP\.
.TP
\fB\-\-ignore\-client\fR \fI\[sl]REGEXP\[sl]\fP
Ignore messages from the client matching the REGEXP\.
.TP
\fB\-\-ignore\-server\fR \fI\[sl]REGEXP\[sl]\fP
Ignore messages from the server matching the REGEXP\.
.TP
\fB\-C\fR, \fB\-\-close\fR \fI\[sl]REGEXP\[sl]\fP
Closes the connection if the client or server sends a message matching
the REGEXP\.
.TP
\fB\-\-close\-client\fR \fI\[sl]REGEXP\[sl]\fP
Closes the connection if the client sends a message matching the REGEXP\.
.TP
\fB\-\-close\-server\fR \fI\[sl]REGEXP\[sl]\fP
Closes the connection if the server sends a message matching the REGEXP\.
.TP
\fB\-R\fR, \fB\-\-reset\fR \fI\[sl]REGEXP\[sl]\fP
Reset the connection if the client or server sends a message matching
the REGEXP\.
.TP
\fB\-\-reset\-client\fR \fI\[sl]REGEXP\[sl]\fP
Reset the connection if the client sends a message matching the REGEXP\.
.TP
\fB\-\-reset\-server\fR \fI\[sl]REGEXP\[sl]\fP
Reset the connection if the server sends a message matching the REGEXP\.
.SH EXAMPLES
.PP
Starts a TCP proxy listening on \fBlocalhost\fR port 8080 that forwards all data
to \fBgoogle\.com\fR port 80:
.PP
.RS 4
.EX
\[Do] ronin proxy 8080 google\.com:80
.EE
.RE
.PP
Starts a UDP proxy listening on \fB0\.8\.0\.0\fR port 53 that forwards all data to
\fB8\.8\.8\.8\fR port 53:
.PP
.RS 4
.EX
\[Do] sudo ronin proxy \-\-udp \-\-hexdump 0\.0\.0\.0:53 8\.8\.8\.8:53
.EE
.RE
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME