Contents

.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-dns-proxy 1 "2024-01-01" Ronin "User Manuals"
.SH NAME
.PP
ronin\-dns\-proxy \- Starts a DNS proxy
.SH SYNOPSIS
.PP
\fBronin dns\-proxy\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIHOST\fP\[rB] \fIPORT\fP
.SH DESCRIPTION
.PP
Starts a DNS proxy that can intercept DNS queries and forward other queries to
upstream DNS nameservers\.
.SH ARGUMENTS
.TP
\fIHOST\fP
The optional IP address to listen on\.
.TP
\fIPORT\fP
The port number to listen on\.
.SH OPTIONS
.TP
\fB\-n\fR, \fB\-\-nameserver\fR \fIIP\fP
A nameserver IP address to foreward DNS queries to\.
.TP
\fB\-r\fR, \fB\-\-rule\fR \fIRECORD\[ru]TYPE\fP\fB:\fR\fINAME\fP\fB:\fR\fIRESULT\fP\[or]\fIRECORD\[ru]TYPE\fP\fB:\[sl]\fR\fIREGEXP\fP\fB\[sl]:\fR\fIRESULT\fP
Adds a rule to the DNS proxy\. Each rule consists of a \fIRECORD\[ru]TYPE\fP, \fINAME\fP,
and a \fIRESULT\fP\.
.RS
.PP
The \fIRECORD\[ru]TYPE\fP is a DNS record type:
.RE
.RS
.RS
.IP \(bu 2
\fBA\fR
.IP \(bu 2
\fBAAAA\fR
.IP \(bu 2
\fBANY\fR
.IP \(bu 2
\fBCNAME\fR
.IP \(bu 2
\fBHINFO\fR
.IP \(bu 2
\fBLOC\fR
.IP \(bu 2
\fBMINFO\fR
.IP \(bu 2
\fBMX\fR
.IP \(bu 2
\fBNS\fR
.IP \(bu 2
\fBPTR\fR
.IP \(bu 2
\fBSOA\fR
.IP \(bu 2
\fBSRV\fR
.IP \(bu 2
\fBTXT\fR
.IP \(bu 2
\fBWKS\fR
.RE
.RE
.RS
.PP
The \fINAME\fP is the host name of the record\.
If the \fINAME\fP starts with a \fB\[sl]\fR and ends with a \fB\[sl]\fR, then it will be treated
as a Regex\.
.RE
.RS
.PP
The \fIRESULT\fP is either the result value or an DNS error code:
.RE
.RS
.RS
.IP \(bu 2
\fBNoError\fR
.IP \(bu 2
\fBFormErr\fR
.IP \(bu 2
\fBServFail\fR
.IP \(bu 2
\fBNXDomain\fR
.IP \(bu 2
\fBNotImp\fR
.IP \(bu 2
\fBRefused\fR
.IP \(bu 2
\fBNotAuth\fR
.RE
.RE
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME
.SH SEE ALSO
.PP
.BR ronin\-dns (1)

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
ronin-2.1.0	man/ronin-dns-proxy.1