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-07-23 07:40:36 +00:00
parent c86be3428a
commit 5b09d62f86
47 changed files with 61 additions and 58 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ACL" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ANY" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-AUTO" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-AUTOPATH" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-AZURE" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-BIND" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-BUFSIZE" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

4
man/coredns-cache.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-CACHE" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-CACHE" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
@ -100,7 +100,7 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me
.IP \(bu 4
\fB\fCcoredns_cache_misses_total{server}\fR - Counter of cache misses.
.IP \(bu 4
\fB\fCcoredns_cache_prefetch_total{server}\fR - Counter of cache has prefetched a cached item.
\fB\fCcoredns_cache_prefetch_total{server}\fR - Counter of times the cache has prefetched a cached item.
.IP \(bu 4
\fB\fCcoredns_cache_drops_total{server}\fR - Counter of responses excluded from the cache due to request/response question name mismatch.
.IP \(bu 4

2
man/coredns-cancel.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-CANCEL" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-CANCEL" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-CHAOS" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-CLOUDDNS" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-DEBUG" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-DNS64" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-DNSSEC" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

2
man/coredns-dnstap.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-DNSTAP" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-DNSTAP" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

2
man/coredns-erratic.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-ERRATIC" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ERRATIC" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ERRORS" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ETCD" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-FILE" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

18
man/coredns-forward.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-FORWARD" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-FORWARD" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
@ -11,14 +11,12 @@ The \fIforward\fP plugin re-uses already opened sockets to the upstreams. It sup
DNS-over-TLS and uses in band health checking.
.PP
When it detects an error a health check is performed. This checks runs in a loop, starting with
a \fI0.5s\fP interval and exponentially backing off with randomized intervals up to \fI15s\fP for as long
as the upstream reports unhealthy. The exponential backoff will reset to \fI0.5s\fP after 2 minutes.
Once healthy we stop health checking (until the next error). The health checks use a recursive
DNS query (\fB\fC. IN NS\fR) to get upstream health. Any response that is not a network error (REFUSED,
NOTIMPL, SERVFAIL, etc) is taken as a healthy upstream. The health check uses the same protocol as
specified in \fBTO\fP. If \fB\fCmax_fails\fR is set to 0, no checking is performed and upstreams will always
be considered healthy.
When it detects an error a health check is performed. This checks runs in a loop, performing each
check at a \fI0.5s\fP interval for as long as the upstream reports unhealthy. Once healthy we stop
health checking (until the next error). The health checks use a recursive DNS query (\fB\fC. IN NS\fR)
to get upstream health. Any response that is not a network error (REFUSED, NOTIMPL, SERVFAIL, etc)
is taken as a healthy upstream. The health check uses the same protocol as specified in \fBTO\fP. If
\fB\fCmax_fails\fR is set to 0, no checking is performed and upstreams will always be considered healthy.
.PP
When \fIall\fP upstreams are down it assumes health checking as a mechanism has failed and will try to
@ -165,7 +163,7 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me
.IP \(bu 4
\fB\fCcoredns_forward_requests_total{to}\fR - query count per upstream.
.IP \(bu 4
\fB\fCcoredns_forward_responses_total{to}\fR - Counter of responses made per upstream.
\fB\fCcoredns_forward_responses_total{to}\fR - Counter of responses received per upstream.
.IP \(bu 4
\fB\fCcoredns_forward_request_duration_seconds{to}\fR - duration per upstream interaction.
.IP \(bu 4

2
man/coredns-grpc.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-GRPC" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-GRPC" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

2
man/coredns-health.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-HEALTH" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-HEALTH" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

2
man/coredns-hosts.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-HOSTS" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-HOSTS" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-IMPORT" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-K8S_EXTERNAL" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-KUBERNETES" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-LOADBALANCE" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-LOG" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-LOOP" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-METADATA" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-METRICS" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-NSID" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-PPROF" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-READY" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-RELOAD" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-REWRITE" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ROOT" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ROUTE53" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-SECONDARY" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-SIGN" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-TEMPLATE" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-TLS" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP

7
man/coredns-trace.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-TRACE" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-TRACE" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
@ -8,6 +8,7 @@
.SH "DESCRIPTION"
.PP
With \fItrace\fP you enable OpenTracing of how a request flows through CoreDNS.
Enable \fIdebug\fP plugin to get logs from the trace plugin.
.SH "SYNTAX"
.PP
@ -140,3 +141,7 @@ trace tracinghost:9411 {
.fi
.RE
.SH "ALSO SEE"
.PP
See the \fIdebug\fP plugin for more information about debug logging.

2
man/coredns-transfer.7
View file

@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-TRANSFER" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-TRANSFER" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-WHOAMI" 7 "July 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 "June 2020" "CoreDNS" "CoreDNS"
.TH "COREDNS" 1 "July 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-any(7) coredns-debug(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-tls(7) coredns-file(7) coredns-nsid(7) coredns-loop(7) coredns-erratic(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-log(7) coredns-cache(7) coredns-root(7) coredns-whoami(7) coredns-bind(7) coredns-auto(7) coredns-import(7) coredns-hosts(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-kubernetes(7) coredns-forward(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-metadata(7) coredns-errors(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-metrics(7) coredns-dns64(7) coredns-etcd(7) coredns-sign(7) coredns-cancel(7) coredns-trace(7).
Corefile(5) coredns-k8s_external(7) coredns-nsid(7) coredns-any(7) coredns-hosts(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-file(7) coredns-root(7) coredns-loop(7) coredns-erratic(7) coredns-pprof(7) coredns-chaos(7) coredns-dnstap(7) coredns-dns64(7) coredns-clouddns(7) coredns-bufsize(7) coredns-tls(7) coredns-loadbalance(7) coredns-log(7) coredns-cache(7) coredns-whoami(7) coredns-bind(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-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-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 "June 2020" "CoreDNS" "CoreDNS"
.TH "COREFILE" 5 "July 2020" "CoreDNS" "CoreDNS"
.SH "NAME"
.PP