diff options
Diffstat (limited to 'man/coredns-file.7')
| -rw-r--r-- | man/coredns-file.7 | 39 |
1 files changed, 32 insertions, 7 deletions
diff --git a/man/coredns-file.7 b/man/coredns-file.7 index a6a6d0e7d..9ba8a7e64 100644 --- a/man/coredns-file.7 +++ b/man/coredns-file.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-FILE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-FILE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -8,9 +8,9 @@ .SH "DESCRIPTION" .PP The \fIfile\fP plugin is used for an "old-style" DNS server. It serves from a preloaded file that exists -on disk. If the zone file contains signatures (i.e., is signed using DNSSEC), correct DNSSEC answers -are returned. Only NSEC is supported! If you use this setup \fIyou\fP are responsible for re-signing the -zonefile. +on disk contained RFC 1035 styled data. If the zone file contains signatures (i.e., is signed using +DNSSEC), correct DNSSEC answers are returned. Only NSEC is supported! If you use this setup \fIyou\fP +are responsible for re-signing the zonefile. .SH "SYNTAX" .PP @@ -55,7 +55,7 @@ If you need outgoing zone transfers, take a look at the \fItransfer\fP plugin. .SH "EXAMPLES" .PP -Load the \fB\fCexample.org\fR zone from \fB\fCexample.org.signed\fR and allow transfers to the internet, but send +Load the \fB\fCexample.org\fR zone from \fB\fCdb.example.org\fR and allow transfers to the internet, but send notifies to 10.240.1.1 .PP @@ -63,7 +63,7 @@ notifies to 10.240.1.1 .nf example.org { - file example.org.signed + file db.example.org transfer { to * 10.240.1.1 } @@ -73,6 +73,26 @@ example.org { .RE .PP +Where \fB\fCdb.example.org\fR would contain RRSets (https://tools.ietf.org/html/rfc7719#section-4 +\[la]https://tools.ietf.org/html/rfc7719#section-4\[ra]) in the +(text) presentation format from RFC 1035: + +.PP +.RS + +.nf +$ORIGIN example.org. +@ 3600 IN SOA sns.dns.icann.org. noc.dns.icann.org. 2017042745 7200 3600 1209600 3600 + 3600 IN NS a.iana\-servers.net. + 3600 IN NS b.iana\-servers.net. + +www IN A 127.0.0.1 + IN AAAA ::1 + +.fi +.RE + +.PP Or use a single zone file for multiple zones: .PP @@ -138,5 +158,10 @@ example.org { .SH "SEE ALSO" .PP See the \fIloadbalance\fP plugin if you need simple record shuffling. And the \fItransfer\fP plugin for zone -transfers. Lastly the \fIroot\fP plugin can help you specificy the location of the zone files. +transfers. Lastly the \fIroot\fP plugin can help you specify the location of the zone files. + +.PP +See RFC 1035 +\[la]https://www.rfc-editor.org/rfc/rfc1035.txt\[ra] for more info on how to structure zone +files. |