diff --git a/man/coredns-bind.7 b/man/coredns-bind.7 index 60b878d0b..50ac5215a 100644 --- a/man/coredns-bind.7 +++ b/man/coredns-bind.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-BIND" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-BIND" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIbind\fR \- overrides the host to which the server should bind\. diff --git a/man/coredns-cache.7 b/man/coredns-cache.7 index b70c44415..35063b880 100644 --- a/man/coredns-cache.7 +++ b/man/coredns-cache.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-CACHE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-CACHE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIcache\fR \- enables a frontend cache\. @@ -9,6 +9,9 @@ .SH "DESCRIPTION" With \fIcache\fR enabled, all records except zone transfers and metadata records will be cached for up to 3600s\. Caching is mostly useful in a scenario when fetching data from the backend (upstream, database, etc\.) is expensive\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-chaos.7 b/man/coredns-chaos.7 index 6a323d039..0619e769d 100644 --- a/man/coredns-chaos.7 +++ b/man/coredns-chaos.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-CHAOS" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-CHAOS" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIchaos\fR \- allows for responding to TXT queries in the CH class\. diff --git a/man/coredns-debug.7 b/man/coredns-debug.7 index 41585343e..44162ebbc 100644 --- a/man/coredns-debug.7 +++ b/man/coredns-debug.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-DEBUG" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-DEBUG" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIdebug\fR \- disables the automatic recovery upon a crash so that you\'ll get a nice stack trace\. diff --git a/man/coredns-dnssec.7 b/man/coredns-dnssec.7 index db2b522d8..37818dfea 100644 --- a/man/coredns-dnssec.7 +++ b/man/coredns-dnssec.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-DNSSEC" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-DNSSEC" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIdnssec\fR \- enable on\-the\-fly DNSSEC signing of served data\. @@ -9,6 +9,9 @@ .SH "DESCRIPTION" With \fIdnssec\fR any reply that doesn\'t (or can\'t) do DNSSEC will get signed on the fly\. Authenticated denial of existence is implemented with NSEC black lies\. Using ECDSA as an algorithm is preferred as this leads to smaller signatures (compared to RSA)\. NSEC3 is \fInot\fR supported\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf @@ -101,25 +104,4 @@ cluster\.local { .fi . .IP "" 0 -. -.SH "BUGS" -Multiple \fIdnssec\fR plugins inside one server stanza will silently overwrite earlier ones, here \fBexample\.org\fR will overwrite the one for \fBcluster\.local\fR\. -. -.IP "" 4 -. -.nf - -\&\. { - kubernetes cluster\.local - dnssec cluster\.local { - key file Kcluster\.local+013+45129 - } - dnssec example\.org { - key file Kexample\.org\.+013+45330 - } -} -. -.fi -. -.IP "" 0 diff --git a/man/coredns-dnstap.7 b/man/coredns-dnstap.7 index d87042078..7856c5d57 100644 --- a/man/coredns-dnstap.7 +++ b/man/coredns-dnstap.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-DNSTAP" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-DNSTAP" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIdnstap\fR \- enable logging to dnstap @@ -77,7 +77,7 @@ The following command listens on the given socket and decodes messages to stdout . .nf -% dnstap \-u /tmp/dnstap\.sock +$ dnstap \-u /tmp/dnstap\.sock . .fi . @@ -90,7 +90,7 @@ The following command listens on the given socket and saves message payloads to . .nf -% dnstap \-u /tmp/dnstap\.sock \-w /tmp/test\.dnstap +$ dnstap \-u /tmp/dnstap\.sock \-w /tmp/test\.dnstap . .fi . @@ -103,11 +103,37 @@ Listen for dnstap messages on port 6000\. . .nf -% dnstap \-l 127\.0\.0\.1:6000 +$ dnstap \-l 127\.0\.0\.1:6000 . .fi . .IP "" 0 . +.SH "USING DNSTAP IN YOUR PLUGIN" +. +.nf + +import ( + "github\.com/coredns/coredns/plugin/dnstap" + "github\.com/coredns/coredns/plugin/dnstap/msg" +) + +func (h Dnstap) ServeDNS(ctx context\.Context, w dns\.ResponseWriter, r *dns\.Msg) (int, error) { + // log client query to Dnstap + if t := dnstap\.TapperFromContext(ctx); t != nil { + b := msg\.New()\.Time(time\.Now())\.Addr(w\.RemoteAddr()) + if t\.Pack() { + b\.Msg(r) + } + if m, err := b\.ToClientQuery(); err == nil { + t\.TapMessage(m) + } + } + + // \.\.\. +} +. +.fi +. .SH "SEE ALSO" dnstap\.info \fIhttp://dnstap\.info\fR\. diff --git a/man/coredns-erratic.7 b/man/coredns-erratic.7 index b5238f34e..e84b8adb7 100644 --- a/man/coredns-erratic.7 +++ b/man/coredns-erratic.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-ERRATIC" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-ERRATIC" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIerratic\fR \- a plugin useful for testing client behavior\. diff --git a/man/coredns-errors.7 b/man/coredns-errors.7 index 5ed14c754..2cbcb42aa 100644 --- a/man/coredns-errors.7 +++ b/man/coredns-errors.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-ERRORS" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-ERRORS" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIerrors\fR \- enable error logging\. @@ -9,6 +9,9 @@ .SH "DESCRIPTION" Any errors encountered during the query processing will be printed to standard output\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-etcd.7 b/man/coredns-etcd.7 index d43bc4666..d1d8a626d 100644 --- a/man/coredns-etcd.7 +++ b/man/coredns-etcd.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-ETCD" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-ETCD" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIetcd\fR \- enables reading zone data from an etcd instance\. diff --git a/man/coredns-federation.7 b/man/coredns-federation.7 index 9a74d05d7..d6a2f523a 100644 --- a/man/coredns-federation.7 +++ b/man/coredns-federation.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-FEDERATION" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-FEDERATION" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIfederation\fR \- enables federated queries to be resolved via the kubernetes plugin\. diff --git a/man/coredns-file.7 b/man/coredns-file.7 index 074411486..d3df8dcfa 100644 --- a/man/coredns-file.7 +++ b/man/coredns-file.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-FILE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-FILE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIfile\fR \- enables serving zone data from an RFC 1035\-style master file\. diff --git a/man/coredns-forward.7 b/man/coredns-forward.7 index 431b4cbd5..e5e4c6503 100644 --- a/man/coredns-forward.7 +++ b/man/coredns-forward.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-FORWARD" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-FORWARD" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIforward\fR \- facilitates proxying DNS messages to upstream resolvers\. @@ -15,6 +15,9 @@ When it detects an error a health check is performed\. This checks runs in a loo .P When \fIall\fR upstreams are down it assumes health checking as a mechanism has failed and will try to connect to a random upstream (which may or may not work)\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" In its most basic form, a simple forwarder uses this syntax: . @@ -54,7 +57,7 @@ forward FROM TO\.\.\. { tls CERT KEY CA tls_servername NAME policy random|round_robin - health_checks DURATION + health_check DURATION } . .fi @@ -86,7 +89,7 @@ forward FROM TO\.\.\. { \fBpolicy\fR specifies the policy to use for selecting upstream servers\. The default is \fBrandom\fR\. . .IP "\(bu" 4 -\fBhealth_checks\fR, use a different \fBDURATION\fR for health checking, the default duration is 0\.5s\. +\fBhealth_check\fR, use a different \fBDURATION\fR for health checking, the default duration is 0\.5s\. . .IP "" 0 . diff --git a/man/coredns-health.7 b/man/coredns-health.7 index 548dcfe5d..9459273b9 100644 --- a/man/coredns-health.7 +++ b/man/coredns-health.7 @@ -1,13 +1,13 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-HEALTH" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-HEALTH" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIhealth\fR \- enables a health check endpoint\. . .SH "DESCRIPTION" -By enabling \fIhealth\fR any plugin that implements it will be queried for it\'s health\. The combined health is exported, by default, on port 8080/health \. +By enabling \fIhealth\fR any plugin that implements healt\.Healther interface \fIhttps://godoc\.org/github\.com/coredns/coredns/plugin/health#Healther\fR will be queried for it\'s health\. The combined health is exported, by default, on port 8080/health \. . .SH "SYNTAX" . @@ -40,6 +40,27 @@ Where \fBlameduck\fR will make the process unhealthy then \fIwait\fR for \fBDURA . .IP "" 0 . +.P +If you have multiple Server Block and need to export health for each of the plugins, you must run health endpoints on different ports: +. +.IP "" 4 +. +.nf + +com { + whoami + health :8080 +} + +net { + erratic + health :8081 +} +. +.fi +. +.IP "" 0 +. .SH "PLUGINS" Any plugin that implements the Healther interface will be used to report health\. . @@ -47,7 +68,7 @@ Any plugin that implements the Healther interface will be used to report health\ If monitoring is enabled (via the \fIprometheus\fR directive) then the following metric is exported: . .IP "\(bu" 4 -\fBcoredns_health_request_duration_seconds{}\fR \- duration to process a /health query\. As this should be a local operation it should be fast\. A (large) increases in this duration indicates the CoreDNS process is having trouble keeping up\. +\fBcoredns_health_request_duration_seconds{}\fR \- duration to process a /health query\. As this should be a local operation it should be fast\. A (large) increases in this duration indicates the CoreDNS process is having trouble keeping up with its query load\. . .IP "" 0 . @@ -74,7 +95,7 @@ Set a lameduck duration of 1 second: .nf \&\. { - health localhost:8091 { + health localhost:8092 { lameduck 1s } } diff --git a/man/coredns-hosts.7 b/man/coredns-hosts.7 index aa722f1fe..6268a3467 100644 --- a/man/coredns-hosts.7 +++ b/man/coredns-hosts.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-HOSTS" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-HOSTS" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIhosts\fR \- enables serving zone data from a \fB/etc/hosts\fR style file\. @@ -9,6 +9,9 @@ .SH "DESCRIPTION" The hosts plugin is useful for serving zones from a /etc/hosts file\. It serves from a preloaded file that exists on disk\. It checks the file for changes and updates the zones accordingly\. This plugin only supports A, AAAA, and PTR records\. The hosts plugin can be used with readily available hosts files that block access to advertising servers\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7 index 0b6e11e99..92996d37f 100644 --- a/man/coredns-kubernetes.7 +++ b/man/coredns-kubernetes.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-KUBERNETES" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-KUBERNETES" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIkubernetes\fR \- enables the reading zone data from a Kubernetes cluster\. @@ -15,6 +15,9 @@ CoreDNS running the kubernetes plugin can be used as a replacement of kube\-dns .P stubDomains and upstreamNameservers \fIhttp://blog\.kubernetes\.io/2017/04/configuring\-private\-dns\-zones\-upstream\-nameservers\-kubernetes\.html\fR are implemented via the \fIproxy\fR plugin and kubernetes \fIupstream\fR\. See example below\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-loadbalance.7 b/man/coredns-loadbalance.7 index 9726dc7d0..1c4f41f92 100644 --- a/man/coredns-loadbalance.7 +++ b/man/coredns-loadbalance.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-LOADBALANCE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-LOADBALANCE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIloadbalance\fR \- acts as a round\-robin DNS loadbalancer by randomizing the order of A and AAAA records in the answer\. diff --git a/man/coredns-log.7 b/man/coredns-log.7 index d6f8c29e6..06a4b6fcd 100644 --- a/man/coredns-log.7 +++ b/man/coredns-log.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-LOG" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-LOG" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIlog\fR \- enables query logging to standard output\. @@ -103,7 +103,7 @@ The following place holders are supported: \fB{when}\fR: time of the query . .IP "\(bu" 4 -\fB{remote}\fR: client\'s IP address +\fB{remote}\fR: client\'s IP address, for IPv6 addresses these are enclosed in brackets: \fB[::1]\fR . .IP "\(bu" 4 \fB{size}\fR: request size in bytes @@ -144,7 +144,7 @@ The default Common Log Format is: . .nf -`{remote} \- [{when}] {>id} "{type} {class} {name} {proto} {size} {>do} {>bufsize}" {rcode} {>rflags} {rsize} {duration}` +`{remote}:{port} \- [{when}] {>id} "{type} {class} {name} {proto} {size} {>do} {>bufsize}" {rcode} {>rflags} {rsize} {duration}` . .fi . diff --git a/man/coredns-metrics.7 b/man/coredns-metrics.7 index 184c2b9e2..f89cbc3c1 100644 --- a/man/coredns-metrics.7 +++ b/man/coredns-metrics.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-METRICS" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-METRICS" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIprometheus\fR \- enables Prometheus \fIhttps://prometheus\.io/\fR metrics\. @@ -58,6 +58,9 @@ The \fBresponse_rcode_count_total\fR has an extra label \fBrcode\fR which holds .P If monitoring is enabled, queries that do not enter the plugin chain are exported under the fake name "dropped" (without a closing dot \- this is never a valid domain name)\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-nsid.7 b/man/coredns-nsid.7 index c41e2ac98..77c0c942f 100644 --- a/man/coredns-nsid.7 +++ b/man/coredns-nsid.7 @@ -1,13 +1,16 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-NSID" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-NSID" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fInsid\fR \- adds an identifier of this server to each reply\. . .SH "DESCRIPTION" -This plugin implements RFC 5001 and adds an EDNS0 OPT resource record to replies that uniquely identify the server\. This is useful in anycast setups to see which server was responsible for generating the reply and for debugging\. +This plugin implements RFC 5001 \fIhttps://tools\.ietf\.org/html/rfc5001\fR and adds an EDNS0 OPT resource record to replies that uniquely identify the server\. This is useful in anycast setups to see which server was responsible for generating the reply and for debugging\. +. +.P +This plugin can only be used once per Server Block\. . .SH "SYNTAX" . @@ -63,4 +66,6 @@ And now a client with NSID support will see an OPT record with the NSID option: .fi . .IP "" 0 - +. +.SH "ALSO SEE" +RFC 5001 \fIhttps://tools\.ietf\.org/html/rfc5001\fR diff --git a/man/coredns-pprof.7 b/man/coredns-pprof.7 index 377573b82..c49972c38 100644 --- a/man/coredns-pprof.7 +++ b/man/coredns-pprof.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-PPROF" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-PPROF" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIpprof\fR \- publishes runtime profiling data at endpoints under \fB/debug/pprof\fR\. @@ -12,6 +12,9 @@ You can visit \fB/debug/pprof\fR on your site for an index of the available endp .P For more information, please see Go\'s pprof documentation \fIhttps://golang\.org/pkg/net/http/pprof/\fR and read Profiling Go Programs \fIhttps://blog\.golang\.org/profiling\-go\-programs\fR\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-proxy.7 b/man/coredns-proxy.7 index 478916cac..c222d2cf0 100644 --- a/man/coredns-proxy.7 +++ b/man/coredns-proxy.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-PROXY" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-PROXY" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIproxy\fR \- facilitates both a basic reverse proxy and a robust load balancer\. diff --git a/man/coredns-reload.7 b/man/coredns-reload.7 index ed5b4ba92..688e836f2 100644 --- a/man/coredns-reload.7 +++ b/man/coredns-reload.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-RELOAD" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-RELOAD" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIreload\fR \- allows automatic reload of a changed Corefile @@ -18,6 +18,9 @@ In some environments (for example, Kubernetes), there may be many CoreDNS instan .P Jitter is re\-calculated whenever the Corefile is reloaded\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-reverse.7 b/man/coredns-reverse.7 index bb6e480ac..1f0dc3521 100644 --- a/man/coredns-reverse.7 +++ b/man/coredns-reverse.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-REVERSE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-REVERSE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIreverse\fR \- allows for dynamic responses to PTR and the related A/AAAA requests\. diff --git a/man/coredns-rewrite.7 b/man/coredns-rewrite.7 index e174ebc50..0b6f59b60 100644 --- a/man/coredns-rewrite.7 +++ b/man/coredns-rewrite.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-REWRITE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-REWRITE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIrewrite\fR \- performs internal message rewriting\. diff --git a/man/coredns-root.7 b/man/coredns-root.7 index 7dcb9c5ab..15bfaa817 100644 --- a/man/coredns-root.7 +++ b/man/coredns-root.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-ROOT" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-ROOT" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIroot\fR \- simply specifies the root of where to find (zone) files\. @@ -9,6 +9,9 @@ .SH "DESCRIPTION" The default root is the current working directory of CoreDNS\. The \fIroot\fR plugin allows you to change this\. A relative root path is relative to the current working directory\. . +.P +This plugin can only be used once per Server Block\. +. .SH "SYNTAX" . .nf diff --git a/man/coredns-route53.7 b/man/coredns-route53.7 index e30b9c0bd..310ab7c1c 100644 --- a/man/coredns-route53.7 +++ b/man/coredns-route53.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-ROUTE53" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-ROUTE53" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIroute53\fR \- enables serving zone data from AWS route53\. diff --git a/man/coredns-secondary.7 b/man/coredns-secondary.7 index 5ff4deb25..126e569ba 100644 --- a/man/coredns-secondary.7 +++ b/man/coredns-secondary.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-SECONDARY" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-SECONDARY" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIsecondary\fR \- enables serving a zone retrieved from a primary server\. diff --git a/man/coredns-template.7 b/man/coredns-template.7 index befcebb91..e8248d23a 100644 --- a/man/coredns-template.7 +++ b/man/coredns-template.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-TEMPLATE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-TEMPLATE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fItemplate\fR \- allows for dynamic responses based on the incoming query\. diff --git a/man/coredns-tls.7 b/man/coredns-tls.7 index d232ed30b..5ac113213 100644 --- a/man/coredns-tls.7 +++ b/man/coredns-tls.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-TLS" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-TLS" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fItls\fR \- allows you to configure the server certificates for the TLS and gRPC servers\. diff --git a/man/coredns-trace.7 b/man/coredns-trace.7 index 97ca9645d..2ba4be743 100644 --- a/man/coredns-trace.7 +++ b/man/coredns-trace.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-TRACE" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-TRACE" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fItrace\fR \- enables OpenTracing\-based tracing of DNS requests as they go through the plugin chain\. diff --git a/man/coredns-whoami.7 b/man/coredns-whoami.7 index 175e80a9b..6732cb288 100644 --- a/man/coredns-whoami.7 +++ b/man/coredns-whoami.7 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "COREDNS\-WHOAMI" "7" "February 2018" "CoreDNS" "CoreDNS plugins" +.TH "COREDNS\-WHOAMI" "7" "March 2018" "CoreDNS" "CoreDNS plugins" . .SH "NAME" \fIwhoami\fR \- returns your resolver\'s local IP address, port and transport\.