From 94e027cd6f4fe897bf595bdea1071b2dde6eb4aa Mon Sep 17 00:00:00 2001 From: "coredns-auto-go-mod-tidy[bot]" Date: Mon, 8 Mar 2021 11:15:45 +0000 Subject: [PATCH] auto make -f Makefile.doc --- man/coredns-acl.7 | 2 +- man/coredns-any.7 | 2 +- man/coredns-auto.7 | 2 +- man/coredns-autopath.7 | 2 +- man/coredns-azure.7 | 2 +- man/coredns-bind.7 | 2 +- man/coredns-bufsize.7 | 2 +- man/coredns-cache.7 | 2 +- man/coredns-cancel.7 | 2 +- man/coredns-chaos.7 | 2 +- man/coredns-clouddns.7 | 2 +- man/coredns-debug.7 | 2 +- man/coredns-dns64.7 | 2 +- man/coredns-dnssec.7 | 2 +- man/coredns-dnstap.7 | 2 +- man/coredns-erratic.7 | 2 +- man/coredns-errors.7 | 2 +- man/coredns-etcd.7 | 2 +- man/coredns-file.7 | 39 +++++++++++++++++++++++++++++++------- man/coredns-forward.7 | 2 +- man/coredns-grpc.7 | 2 +- man/coredns-health.7 | 2 +- man/coredns-hosts.7 | 2 +- man/coredns-import.7 | 2 +- man/coredns-k8s_external.7 | 2 +- man/coredns-kubernetes.7 | 2 +- man/coredns-loadbalance.7 | 2 +- man/coredns-local.7 | 2 +- man/coredns-log.7 | 2 +- man/coredns-loop.7 | 2 +- man/coredns-metadata.7 | 2 +- man/coredns-metrics.7 | 2 +- man/coredns-nsid.7 | 2 +- man/coredns-pprof.7 | 2 +- man/coredns-ready.7 | 2 +- man/coredns-reload.7 | 2 +- man/coredns-rewrite.7 | 21 ++++++++++++++++---- man/coredns-root.7 | 2 +- man/coredns-route53.7 | 2 +- man/coredns-secondary.7 | 2 +- man/coredns-sign.7 | 19 ++++++++++++++----- man/coredns-template.7 | 2 +- man/coredns-tls.7 | 2 +- man/coredns-trace.7 | 2 +- man/coredns-transfer.7 | 2 +- man/coredns-whoami.7 | 2 +- man/coredns.1 | 4 ++-- man/corefile.5 | 2 +- 48 files changed, 109 insertions(+), 62 deletions(-) diff --git a/man/coredns-acl.7 b/man/coredns-acl.7 index f3400fe04..f03731cc9 100644 --- a/man/coredns-acl.7 +++ b/man/coredns-acl.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ACL" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ACL" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-any.7 b/man/coredns-any.7 index 1e620692f..c17b34ca5 100644 --- a/man/coredns-any.7 +++ b/man/coredns-any.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ANY" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ANY" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-auto.7 b/man/coredns-auto.7 index 1afb7f6e3..2362129d5 100644 --- a/man/coredns-auto.7 +++ b/man/coredns-auto.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-AUTO" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-AUTO" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-autopath.7 b/man/coredns-autopath.7 index 9b0c2458c..4840b8ab8 100644 --- a/man/coredns-autopath.7 +++ b/man/coredns-autopath.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-AUTOPATH" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-AUTOPATH" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-azure.7 b/man/coredns-azure.7 index cea8ae21d..dc92154fa 100644 --- a/man/coredns-azure.7 +++ b/man/coredns-azure.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-AZURE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-AZURE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-bind.7 b/man/coredns-bind.7 index a0bd92f33..608268d88 100644 --- a/man/coredns-bind.7 +++ b/man/coredns-bind.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-BIND" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-BIND" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-bufsize.7 b/man/coredns-bufsize.7 index 11a5c1d8c..e5303e363 100644 --- a/man/coredns-bufsize.7 +++ b/man/coredns-bufsize.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-BUFSIZE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-BUFSIZE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-cache.7 b/man/coredns-cache.7 index 393196538..b05eeae3f 100644 --- a/man/coredns-cache.7 +++ b/man/coredns-cache.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-CACHE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CACHE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-cancel.7 b/man/coredns-cancel.7 index bba8bae69..a0c83865b 100644 --- a/man/coredns-cancel.7 +++ b/man/coredns-cancel.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-CANCEL" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CANCEL" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-chaos.7 b/man/coredns-chaos.7 index 6c30956c4..a873d694b 100644 --- a/man/coredns-chaos.7 +++ b/man/coredns-chaos.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-CHAOS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CHAOS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-clouddns.7 b/man/coredns-clouddns.7 index ff71f0b22..3b83a3a59 100644 --- a/man/coredns-clouddns.7 +++ b/man/coredns-clouddns.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-CLOUDDNS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CLOUDDNS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-debug.7 b/man/coredns-debug.7 index 2b14e4be1..90ee34961 100644 --- a/man/coredns-debug.7 +++ b/man/coredns-debug.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-DEBUG" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-DEBUG" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-dns64.7 b/man/coredns-dns64.7 index 932cb1111..7a5274cb2 100644 --- a/man/coredns-dns64.7 +++ b/man/coredns-dns64.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-DNS64" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-DNS64" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-dnssec.7 b/man/coredns-dnssec.7 index ce68acace..7376e6b03 100644 --- a/man/coredns-dnssec.7 +++ b/man/coredns-dnssec.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-DNSSEC" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-DNSSEC" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-dnstap.7 b/man/coredns-dnstap.7 index ca50930e1..3dbb0f958 100644 --- a/man/coredns-dnstap.7 +++ b/man/coredns-dnstap.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-DNSTAP" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-DNSTAP" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-erratic.7 b/man/coredns-erratic.7 index ce6d1f6a9..c85153658 100644 --- a/man/coredns-erratic.7 +++ b/man/coredns-erratic.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ERRATIC" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ERRATIC" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-errors.7 b/man/coredns-errors.7 index 51e960497..b296fa324 100644 --- a/man/coredns-errors.7 +++ b/man/coredns-errors.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ERRORS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ERRORS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-etcd.7 b/man/coredns-etcd.7 index bfd910fca..371f81f2b 100644 --- a/man/coredns-etcd.7 +++ b/man/coredns-etcd.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ETCD" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ETCD" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP 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 } @@ -72,6 +72,26 @@ example.org { .fi .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: @@ -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. diff --git a/man/coredns-forward.7 b/man/coredns-forward.7 index a7527ebdd..9f182e25f 100644 --- a/man/coredns-forward.7 +++ b/man/coredns-forward.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-FORWARD" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-FORWARD" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-grpc.7 b/man/coredns-grpc.7 index 774a845c6..d286cda0e 100644 --- a/man/coredns-grpc.7 +++ b/man/coredns-grpc.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-GRPC" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-GRPC" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-health.7 b/man/coredns-health.7 index 4355f6786..388d4e96c 100644 --- a/man/coredns-health.7 +++ b/man/coredns-health.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-HEALTH" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-HEALTH" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-hosts.7 b/man/coredns-hosts.7 index d4167b083..72bf9a908 100644 --- a/man/coredns-hosts.7 +++ b/man/coredns-hosts.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-HOSTS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-HOSTS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-import.7 b/man/coredns-import.7 index e896d0653..dda17a022 100644 --- a/man/coredns-import.7 +++ b/man/coredns-import.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-IMPORT" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-IMPORT" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-k8s_external.7 b/man/coredns-k8s_external.7 index 9583f0bf6..f0b902e49 100644 --- a/man/coredns-k8s_external.7 +++ b/man/coredns-k8s_external.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-K8S_EXTERNAL" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-K8S_EXTERNAL" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7 index df90e4a97..078c73d60 100644 --- a/man/coredns-kubernetes.7 +++ b/man/coredns-kubernetes.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-KUBERNETES" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-KUBERNETES" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-loadbalance.7 b/man/coredns-loadbalance.7 index 150caeba7..d3095cb03 100644 --- a/man/coredns-loadbalance.7 +++ b/man/coredns-loadbalance.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-LOADBALANCE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-LOADBALANCE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-local.7 b/man/coredns-local.7 index a7279c096..6869a5bce 100644 --- a/man/coredns-local.7 +++ b/man/coredns-local.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-LOCAL" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-LOCAL" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-log.7 b/man/coredns-log.7 index 8687fe77a..1d2ee95a6 100644 --- a/man/coredns-log.7 +++ b/man/coredns-log.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-LOG" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-LOG" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-loop.7 b/man/coredns-loop.7 index b802c0cca..2450ddabd 100644 --- a/man/coredns-loop.7 +++ b/man/coredns-loop.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-LOOP" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-LOOP" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-metadata.7 b/man/coredns-metadata.7 index 0fe551522..9a295ac23 100644 --- a/man/coredns-metadata.7 +++ b/man/coredns-metadata.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-METADATA" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-METADATA" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-metrics.7 b/man/coredns-metrics.7 index 812ea489f..565af3445 100644 --- a/man/coredns-metrics.7 +++ b/man/coredns-metrics.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-METRICS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-METRICS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-nsid.7 b/man/coredns-nsid.7 index c7a74922a..a0892300a 100644 --- a/man/coredns-nsid.7 +++ b/man/coredns-nsid.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-NSID" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-NSID" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-pprof.7 b/man/coredns-pprof.7 index 5dfa9859d..7948bee68 100644 --- a/man/coredns-pprof.7 +++ b/man/coredns-pprof.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-PPROF" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-PPROF" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-ready.7 b/man/coredns-ready.7 index 855b05e20..082142281 100644 --- a/man/coredns-ready.7 +++ b/man/coredns-ready.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-READY" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-READY" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-reload.7 b/man/coredns-reload.7 index 39d924168..6ff0e4928 100644 --- a/man/coredns-reload.7 +++ b/man/coredns-reload.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-RELOAD" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-RELOAD" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-rewrite.7 b/man/coredns-rewrite.7 index 8e22ee0d9..417aca79c 100644 --- a/man/coredns-rewrite.7 +++ b/man/coredns-rewrite.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-REWRITE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-REWRITE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -238,6 +238,19 @@ ftp\-us\-west\-1.coredns.rocks. 0 IN A 10.30.30.30 .fi .RE +.PP +It is also possible to rewrite other values returned in the DNS response records +(e.g. the server names returned in \fB\fCSRV\fR and \fB\fCMX\fR records). This can be enabled by adding +the \fB\fCanswer value\fR to a name regex rule as specified below. \fB\fCanswer value\fR takes a +regular expression and a rewrite name as parameters and works in the same way as the +\fB\fCanswer name\fR rule. + +.PP +Note that names in the \fB\fCAUTHORITY SECTION\fR and \fB\fCADDITIONAL SECTION\fR will also be +rewritten following the specified rules. The names returned by the following +record types: \fB\fCCNAME\fR, \fB\fCDNAME\fR, \fB\fCSOA\fR, \fB\fCSRV\fR, \fB\fCMX\fR, \fB\fCNAPTR\fR, \fB\fCNS\fR will be rewritten +if the \fB\fCanswer value\fR rule is specified. + .PP The syntax for the rewrite of DNS request and response is as follows: @@ -248,6 +261,7 @@ The syntax for the rewrite of DNS request and response is as follows: rewrite [continue|stop] { name regex STRING STRING answer name STRING STRING + [answer value STRING STRING] } .fi @@ -257,8 +271,7 @@ rewrite [continue|stop] { Note that the above syntax is strict. For response rewrites, only \fB\fCname\fR rules are allowed to match the question section, and only by match type \fB\fCregex\fR. The answer rewrite must be after the name, as in the -syntax example. There must only be two lines (a \fB\fCname\fR followed by an -\fB\fCanswer\fR) in the brackets; additional rules are not supported. +syntax example. .PP An alternate syntax for rewriting a DNS request and response is as @@ -268,7 +281,7 @@ follows: .RS .nf -rewrite [continue|stop] name regex STRING STRING answer name STRING STRING +rewrite [continue|stop] name regex STRING STRING answer name STRING STRING [answer value STRING STRING] .fi .RE diff --git a/man/coredns-root.7 b/man/coredns-root.7 index d68c252a4..1a0c1aec6 100644 --- a/man/coredns-root.7 +++ b/man/coredns-root.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ROOT" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ROOT" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-route53.7 b/man/coredns-route53.7 index 0aeb4f259..6e571b484 100644 --- a/man/coredns-route53.7 +++ b/man/coredns-route53.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-ROUTE53" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ROUTE53" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-secondary.7 b/man/coredns-secondary.7 index 23aeded42..018046e8c 100644 --- a/man/coredns-secondary.7 +++ b/man/coredns-secondary.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-SECONDARY" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-SECONDARY" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-sign.7 b/man/coredns-sign.7 index da6f3e620..7a9127c5b 100644 --- a/man/coredns-sign.7 +++ b/man/coredns-sign.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-SIGN" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-SIGN" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -8,9 +8,9 @@ .SH "DESCRIPTION" .PP The \fIsign\fP plugin is used to sign (see RFC 6781) zones. In this process DNSSEC resource records are -added. The signatures that sign the resource records sets have an expiration date, this means the -signing process must be repeated before this expiration data is reached. Otherwise the zone's data -will go BAD (RFC 4035, Section 5.5). The \fIsign\fP plugin takes care of this. +added to the zone. The signatures that sign the resource records sets have an expiration date. This +means the signing process must be repeated before this expiration data is reached. Otherwise the +zone's data will go BAD (RFC 4035, Section 5.5). The \fIsign\fP plugin takes care of this. .PP Only NSEC is supported, \fIsign\fP does \fInot\fP support NSEC3. @@ -40,7 +40,16 @@ the signature only has 14 days left before expiring. .RE -Both these dates are only checked on the SOA's signature(s). +Both these dates are only checked on the SOA's signature(s). This concerns the DNSSEC data, the +\fIsign\fP plugin will also take into account and resign if: + +.RS +.IP \(en 4 +the \fBmtime\fP of the zone file has changed, since the last time it was checked. +.IP \(en 4 +the signed zone file doesn't exist on disk. + +.RE .IP \(bu 4 Create RRSIGs that have an inception of -3 hours (minus a jitter between 0 and 18 hours) and a expiration of +32 (plus a jitter between 0 and 5 days) days for every given DNSKEY. diff --git a/man/coredns-template.7 b/man/coredns-template.7 index c8a4d6342..e13354c69 100644 --- a/man/coredns-template.7 +++ b/man/coredns-template.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-TEMPLATE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-TEMPLATE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-tls.7 b/man/coredns-tls.7 index 12852a91f..9021fb94f 100644 --- a/man/coredns-tls.7 +++ b/man/coredns-tls.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-TLS" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-TLS" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-trace.7 b/man/coredns-trace.7 index e4303d7c1..caf6854ed 100644 --- a/man/coredns-trace.7 +++ b/man/coredns-trace.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-TRACE" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-TRACE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-transfer.7 b/man/coredns-transfer.7 index f697db859..c7af5224a 100644 --- a/man/coredns-transfer.7 +++ b/man/coredns-transfer.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-TRANSFER" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-TRANSFER" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-whoami.7 b/man/coredns-whoami.7 index 3ff12c99d..24694e7d8 100644 --- a/man/coredns-whoami.7 +++ b/man/coredns-whoami.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-WHOAMI" 7 "February 2021" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-WHOAMI" 7 "March 2021" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns.1 b/man/coredns.1 index e597fd425..99054011f 100644 --- a/man/coredns.1 +++ b/man/coredns.1 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS" 1 "February 2021" "CoreDNS" "CoreDNS" +.TH "COREDNS" 1 "March 2021" "CoreDNS" "CoreDNS" .SH "COREDNS" .PP @@ -58,5 +58,5 @@ Apache License 2.0 .SH "SEE ALSO" .PP -Corefile(5) coredns-k8s_external(7) coredns-erratic(7) coredns-any(7) coredns-debug(7) coredns-reload(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-local(7) coredns-nsid(7) coredns-auto(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-root(7) coredns-whoami(7) coredns-loop(7) coredns-import(7) coredns-hosts(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-log(7) coredns-cache(7) coredns-forward(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-file(7) coredns-errors(7) coredns-kubernetes(7) coredns-ready(7) coredns-metadata(7) coredns-rewrite(7) coredns-bind(7) coredns-tls(7) coredns-metrics(7) coredns-dns64(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7). +Corefile(5) coredns-k8s_external(7) coredns-any(7) coredns-hosts(7) coredns-reload(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-log(7) coredns-tls(7) coredns-file(7) coredns-root(7) coredns-loop(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-cache(7) coredns-whoami(7) coredns-bind(7) coredns-erratic(7) coredns-auto(7) coredns-import(7) coredns-debug(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-kubernetes(7) coredns-forward(7) coredns-nsid(7) coredns-secondary(7) coredns-route53(7) coredns-local(7) coredns-errors(7) coredns-transfer(7) coredns-ready(7) coredns-metadata(7) coredns-rewrite(7) coredns-metrics(7) coredns-dns64(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7). diff --git a/man/corefile.5 b/man/corefile.5 index af5140fb6..d24a35ee4 100644 --- a/man/corefile.5 +++ b/man/corefile.5 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREFILE" 5 "February 2021" "CoreDNS" "CoreDNS" +.TH "COREFILE" 5 "March 2021" "CoreDNS" "CoreDNS" .SH "NAME" .PP