chore(docs): regenerate man pages (#7971)

This commit is contained in:
Ville Vesilehto
2026-03-27 05:35:09 +02:00
committed by GitHub
parent 49b18b8af6
commit 0132ad86b5
60 changed files with 2110 additions and 280 deletions

View File

@@ -1,14 +1,24 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-ROOT" 7 "March 2021" "CoreDNS" "CoreDNS Plugins"
.TH "COREDNS-ROOT" 7 "March 2026" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
\fIroot\fP - simply specifies the root of where to find (zone) files.
\fIroot\fP - simply specifies the root of where to find files.
.SH "DESCRIPTION"
.PP
The default root is the current working directory of CoreDNS. The \fIroot\fP plugin allows you to change
this. A relative root path is relative to the current working directory.
\fBNOTE: The \fIroot\fP directory is NOT currently supported by all plugins.\fP
Currently the following plugins respect the \fIroot\fP plugin configuration:
.IP \(bu 4
\fIfile\fP
.IP \(bu 4
\fItls\fP
.IP \(bu 4
\fIdnssec\fP
.PP
This plugin can only be used once per Server Block.
@@ -41,3 +51,33 @@ Serve zone data (when the \fIfile\fP plugin is used) from \fB\fC/etc/coredns/zon
.fi
.RE
.PP
When you use the \fIroot\fP and \fItls\fP plugin together, your cert and key should also be placed in the \fIroot\fP directory.
The example below will look for \fB\fC/config/cert.pem\fR and \fB\fC/config/key.pem\fR
.PP
.RS
.nf
tls://example.com:853 {
root /config
tls cert.pem key.pem
whoami
}
.fi
.RE
.SH "BUGS"
.PP
\fBNOTE: The \fIroot\fP directory is NOT currently supported by all plugins.\fP
Currently the following plugins respect the \fIroot\fP plugin configuration:
.IP \(bu 4
\fIfile\fP
.IP \(bu 4
\fItls\fP
.IP \(bu 4
\fIdnssec\fP