TrueCloudLab/coredns
16
0
Fork 2
Code Issues Pull requests 4 Projects Releases Packages Wiki Activity Actions

auto make -f Makefile.doc

Browse source
This commit is contained in:
coredns-auto-go-mod-tidy[bot] 2020-10-12 17:10:58 +00:00
parent b3b8a7e4b7
commit 5f5cc3188f
47 changed files with 84 additions and 66 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
man/coredns-acl.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-any.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-auto.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-autopath.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-azure.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-bind.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-bufsize.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-cache.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-cancel.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-chaos.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-clouddns.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-debug.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-dns64.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-dnssec.7
View file

@ -1,5 +1,5 @@
.\" 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

52
man/coredns-dnstap.7
View file

@ -1,5 +1,5 @@
.\" 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.

2
man/coredns-erratic.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-errors.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-etcd.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-file.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-forward.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-grpc.7
View file

@ -1,5 +1,5 @@
.\" 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

6
man/coredns-health.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-hosts.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-import.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-k8s_external.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-kubernetes.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-loadbalance.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-log.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-loop.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-metadata.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-metrics.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-nsid.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-pprof.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-ready.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-reload.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-rewrite.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-root.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-route53.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-secondary.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-sign.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-template.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-tls.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-trace.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-transfer.7
View file

@ -1,5 +1,5 @@
.\" 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

2
man/coredns-whoami.7
View file

@ -1,5 +1,5 @@
.\" 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

4
man/coredns.1
View file

@ -1,5 +1,5 @@
.\" 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).

2
man/corefile.5
View file

@ -1,5 +1,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