diff options
| author |  Ben Kochie <superq@gmail.com>
| 2020-03-26 08:42:23 +0100 |
|---|---|---|
| committer |  GitHub <noreply@github.com>
| 2020-03-26 08:42:23 +0100 |
| commit | 4eeaef29eae0c42695d2f6b17ccb6d0362fcb798 (patch) | |
| tree | 2d1f34019c3a4b324fdb61dcc16c7b8df1c32cfe /man | |
| parent | 1dba31ee7d7ea5d4d02f3f2f519f25e5c9a3c379 (diff) | |
| download | coredns-4eeaef29eae0c42695d2f6b17ccb6d0362fcb798.tar.gz coredns-4eeaef29eae0c42695d2f6b17ccb6d0362fcb798.tar.zst coredns-4eeaef29eae0c42695d2f6b17ccb6d0362fcb798.zip | |
Add dns64 plugin (#3534)
* Add dns64 plugin
Add external plugin to core in-tree.
* Pull code from upstream: https://github.com/serverwentdown/dns64
* Update docs.
Signed-off-by: Ben Kochie <superq@gmail.com>
* Make dns64 consistent.
Signed-off-by: Ben Kochie <superq@gmail.com>
* Cleanup README
Signed-off-by: Ben Kochie <superq@gmail.com>
* Cleanup minor issues.
Signed-off-by: Ben Kochie <superq@gmail.com>
* Remove proxy method.
Signed-off-by: Ben Kochie <superq@gmail.com>
* dns64: big cleanup
* Make the code a bit more idiomatic
* Add tests
* use proper Upstream API
Signed-off-by: Casey Callendrello <c1@caseyc.net>
Signed-off-by: Ben Kochie <superq@gmail.com>
* A little more clenaup
* Fix some docs.
* Use the correct plugin register method.
* Cleanup some review items.
Signed-off-by: Ben Kochie <superq@gmail.com>
* Add metrics counter for DNS64 translations
Add a basic counter of how many DNS64 translations have been completed.
Signed-off-by: Ben Kochie <superq@gmail.com>
* Add DNSSEC bug link
Signed-off-by: Ben Kochie <superq@gmail.com>
* Test cleanup
Signed-off-by: Ben Kochie <superq@gmail.com>
* dns64: more test cleanup
Signed-off-by: Casey Callendrello <c1@caseyc.net>
Co-authored-by: Casey Callendrello <c1@caseyc.net>
Diffstat (limited to 'man')
| -rw-r--r-- | man/coredns-dns64.7 | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/man/coredns-dns64.7 b/man/coredns-dns64.7 new file mode 100644 index 000000000..0454ba8a3 --- /dev/null +++ b/man/coredns-dns64.7 @@ -0,0 +1,105 @@ +.\" Generated by Mmark Markdown Processer - mmark.miek.nl +.TH "COREDNS-DNS64" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" + +.SH "NAME" +.PP +\fIdns64\fP - enables DNS64 IPv6 transition mechanism. + +.SH "DESCRIPTION" +.PP +From Wikipedia: + +.PP +.RS + +.PP +DNS64 describes a DNS server that when asked for a domain's AAAA records, but only finds +A records, synthesizes the AAAA records from the A records. + +.RE + +.PP +The synthesis in only performed if the query came in via IPv6. + +.PP +See RFC 6147 +\[la]https://tools.ietf.org/html/rfc6147\[ra] for more information. + +.SH "SYNTAX" +.PP +.RS + +.nf +dns64 [PREFIX] { + [translate\\\_all] +} + +.fi +.RE + +.IP \(bu 4 +[PREFIX] defines a custom prefix instead of the default \fB\fC64:ff9b::/96\fR +.IP \(bu 4 +\fB\fCtranslate_all\fR translates all queries, including respones that have AAAA results. + + +.SH "EXAMPLES" +.PP +Translate with the default well known prefix. Applies to all queries + +.PP +.RS + +.nf +dns64 + +.fi +.RE + +.PP +Use a custom prefix + +.PP +.RS + +.nf +dns64 64:1337::/96 +dns64 { + prefix 64:1337::/96 +} + +.fi +.RE + +.PP +Enable translation even if an existing AAAA record is present + +.PP +.RS + +.nf +dns64 { + translate\_all +} + +.fi +.RE + +.IP \(bu 4 +\fB\fCprefix\fR specifies any local IPv6 prefix to use, instead of the well known prefix (64:ff9b::/96) + + +.SH "BUGS" +.PP +Not all features required by DNS64 are implemented, only basic AAAA synthesis. + +.IP \(bu 4 +Support "mapping of separate IPv4 ranges to separate IPv6 prefixes" +.IP \(bu 4 +Resolve PTR records +.IP \(bu 4 +Follow CNAME records +.IP \(bu 4 +Make resolver DNSSEC aware + + |