auto make -f Makefile.doc

man/coredns-acl.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ACL" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ACL" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-any.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ANY" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ANY" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-auto.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-AUTO" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-AUTO" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-autopath.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-AUTOPATH" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-AUTOPATH" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-azure.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-AZURE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-AZURE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-bind.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-BIND" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-BIND" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-bufsize.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-BUFSIZE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-BUFSIZE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-cache.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-CACHE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-CACHE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-cancel.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-CANCEL" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-CANCEL" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-chaos.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-CHAOS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-CHAOS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-clouddns.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-CLOUDDNS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-CLOUDDNS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-debug.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-DEBUG" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-DEBUG" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-dns64.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-DNS64" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-DNS64" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-dnssec.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-DNSSEC" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-DNSSEC" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-dnstap.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-DNSTAP" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-DNSTAP" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP
@@ -111,27 +111,44 @@ $ dnstap \-l 127.0.0.1:6000
 .RE
 
 .SH "USING DNSTAP IN YOUR PLUGIN"
+.PP
+In your setup function, check to see if the \fIdnstap\fP plugin is loaded:
+
 .PP
 .RS
 
 .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)
+c.OnStartup(func() error {
+    if taph := dnsserver.GetConfig(c).Handler("dnstap"); taph != nil {
+        if tapPlugin, ok := taph.(dnstap.Dnstap); ok {
+            f.tapPlugin = \&tapPlugin
         }
     }
+    return nil
+})
+
+.fi
+.RE
+
+.PP
+And then in your plugin:
+
+.PP
+.RS
 
+.nf
+func (x RandomPlugin) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error) {
+    if tapPlugin != nil {
+        q := new(msg.Msg)
+        msg.SetQueryTime(q, time.Now())
+        msg.SetQueryAddress(q, w.RemoteAddr())
+        if tapPlugin.IncludeRawMessage {
+            buf, \_ := r.Pack() // r has been seen packed/unpacked before, this should not fail
+            q.QueryMessage = buf
+        }
+        msg.SetType(q, tap.Message\_CLIENT\_QUERY)
+        tapPlugin.TapMessage(q)
+    }
     // ...
 }
 
@@ -140,6 +157,7 @@ func (h Dnstap) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg)
 
 .SH "SEE ALSO"
 .PP
-dnstap.info
-\[la]https://dnstap.info\[ra].
+The website dnstap.info
+\[la]https://dnstap.info\[ra] has info on the dnstap protocol.
+The \fIforward\fP plugin's \fB\fCdnstap.go\fR uses dnstap to tap messages sent to an upstream.
 

man/coredns-erratic.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ERRATIC" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ERRATIC" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-errors.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ERRORS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ERRORS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-etcd.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ETCD" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ETCD" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-file.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-FILE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-FILE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-forward.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-FORWARD" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-FORWARD" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-grpc.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-GRPC" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-GRPC" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-health.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-HEALTH" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-HEALTH" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP
@@ -39,8 +39,8 @@ health [ADDRESS] {
 .RE
 
 .IP \(bu 4
-Where \fB\fClameduck\fR will make the process unhealthy then \fIwait\fP for \fBDURATION\fP before the process
-shuts down.
+Where \fB\fClameduck\fR will delay shutdown for \fBDURATION\fP. /health will still answer 200 OK.
+Note: The \fIready\fP plugin will not answer OK while CoreDNS is in lameduck mode prior to shutdown.
 
 
 .PP

man/coredns-hosts.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-HOSTS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-HOSTS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-import.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-IMPORT" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-IMPORT" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-k8s_external.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-K8S_EXTERNAL" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-K8S_EXTERNAL" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-kubernetes.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-KUBERNETES" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-KUBERNETES" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-loadbalance.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-LOADBALANCE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-LOADBALANCE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-log.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-LOG" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-LOG" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-loop.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-LOOP" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-LOOP" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-metadata.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-METADATA" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-METADATA" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-metrics.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-METRICS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-METRICS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-nsid.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-NSID" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-NSID" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-pprof.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-PPROF" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-PPROF" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-ready.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-READY" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-READY" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-reload.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-RELOAD" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-RELOAD" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-rewrite.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-REWRITE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-REWRITE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-root.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ROOT" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ROOT" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-route53.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-ROUTE53" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ROUTE53" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-secondary.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-SECONDARY" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-SECONDARY" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-sign.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-SIGN" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-SIGN" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-template.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-TEMPLATE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-TEMPLATE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-tls.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-TLS" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-TLS" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-trace.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-TRACE" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-TRACE" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-transfer.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-TRANSFER" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-TRANSFER" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns-whoami.7

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-WHOAMI" 7 "September 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-WHOAMI" 7 "October 2020" "CoreDNS" "CoreDNS Plugins"
 
 .SH "NAME"
 .PP

man/coredns.1

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS" 1 "September 2020" "CoreDNS" "CoreDNS"
+.TH "COREDNS" 1 "October 2020" "CoreDNS" "CoreDNS"
 
 .SH "COREDNS"
 .PP
@@ -58,5 +58,5 @@ Apache License 2.0
 
 .SH "SEE ALSO"
 .PP
-Corefile(5) coredns-k8s_external(7) coredns-nsid(7) coredns-any(7) coredns-debug(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-tls(7) coredns-file(7) coredns-root(7) coredns-auto(7) coredns-erratic(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-log(7) coredns-cache(7) coredns-whoami(7) coredns-dns64(7) coredns-loop(7) coredns-import(7) coredns-chaos(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-kubernetes(7) coredns-forward(7) coredns-hosts(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-bind(7) coredns-errors(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-metrics(7) coredns-metadata(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7).
+Corefile(5) coredns-k8s_external(7) coredns-any(7) coredns-hosts(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-file(7) coredns-root(7) coredns-loop(7) coredns-erratic(7) coredns-pprof(7) coredns-dnstap(7) coredns-clouddns(7) coredns-bufsize(7) coredns-tls(7) coredns-loadbalance(7) coredns-dns64(7) coredns-cache(7) coredns-whoami(7) coredns-bind(7) coredns-auto(7) coredns-import(7) coredns-chaos(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-log(7) coredns-kubernetes(7) coredns-forward(7) coredns-debug(7) coredns-nsid(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-errors(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-metrics(7) coredns-metadata(7) coredns-etcd(7) coredns-sign(7) coredns-cancel(7) coredns-trace(7).
 

man/corefile.5

 .\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREFILE" 5 "September 2020" "CoreDNS" "CoreDNS"
+.TH "COREFILE" 5 "October 2020" "CoreDNS" "CoreDNS"
 
 .SH "NAME"
 .PP