Commit 4831e7f9 authored by Miek Gieben's avatar Miek Gieben Committed by Yong Tang

bufsize: go gen and docs (#3449)

Run 'go generate' and 'make -f Makefile.doc' to generate the chaos
plugin author list and update the manual pages.
Signed-off-by: default avatarMiek Gieben <miek@miek.nl>
parent 1e3330c1
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-BUFSIZE" 7 "November 2019" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
\fIbufsize\fP - sizes EDNS0 buffer size to prevent IP fragmentation.
.SH "DESCRIPTION"
.PP
\fIbufsize\fP limits a requester's UDP payload size.
It prevents IP fragmentation so that to deal with DNS vulnerability.
.SH "SYNTAX"
.PP
.RS
.nf
bufsize [SIZE]
.fi
.RE
.PP
\fB[SIZE]\fP is an int value for setting the buffer size.
The default value is 512, and the value must be within 512 - 4096.
Only one argument is acceptable, and it covers both IPv4 and IPv6.
.SH "EXAMPLES"
.PP
Enable limiting the buffer size of outgoing query to the resolver (172.31.0.10):
.PP
.RS
.nf
\&. {
bufsize 512
forward . 172.31.0.10
log
}
.fi
.RE
.PP
Enable limiting the buffer size as an authoritative nameserver:
.PP
.RS
.nf
\&. {
bufsize 512
file db.example.org
log
}
.fi
.RE
.SH "CONSIDERATIONS"
.IP \(bu 4
Setting 1232 bytes to bufsize may avoid fragmentation on the majority of networks in use today, but it depends on the MTU of the physical network links.
.IP \(bu 4
For now, if a client does not use EDNS, this plugin adds OPT RR.
.\" Generated by Mmark Markdown Processer - mmark.miek.nl .\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-RELOAD" 7 "October 2019" "CoreDNS" "CoreDNS Plugins" .TH "COREDNS-RELOAD" 7 "November 2019" "CoreDNS" "CoreDNS Plugins"
.SH "NAME" .SH "NAME"
.PP .PP
...@@ -52,8 +52,8 @@ reload [INTERVAL] [JITTER] ...@@ -52,8 +52,8 @@ reload [INTERVAL] [JITTER]
The plugin will check for changes every \fBINTERVAL\fP, subject to +/- the \fBJITTER\fP duration. The plugin will check for changes every \fBINTERVAL\fP, subject to +/- the \fBJITTER\fP duration.
.IP \(bu 4 .IP \(bu 4
\fBINTERVAL\fP and \fBJITTER\fP are Golang (durations)[https://golang.org/pkg/time/#ParseDuration \fBINTERVAL\fP and \fBJITTER\fP are Golang durations
\[la]https://golang.org/pkg/time/#ParseDuration\[ra]]. \[la]https://golang.org/pkg/time/#ParseDuration\[ra].
The default \fBINTERVAL\fP is 30s, default \fBJITTER\fP is 15s, the minimal value for \fBINTERVAL\fP The default \fBINTERVAL\fP is 30s, default \fBJITTER\fP is 15s, the minimal value for \fBINTERVAL\fP
is 2s, and for \fBJITTER\fP it is 1s. If \fBJITTER\fP is more than half of \fBINTERVAL\fP, it will be is 2s, and for \fBJITTER\fP it is 1s. If \fBJITTER\fP is more than half of \fBINTERVAL\fP, it will be
set to half of \fBINTERVAL\fP set to half of \fBINTERVAL\fP
......
...@@ -3,8 +3,7 @@ ...@@ -3,8 +3,7 @@
.SH "NAME" .SH "NAME"
.PP .PP
\fItransfer\fP - answer zone transfers requests for compatible authoritative \fItransfer\fP - perform zone transfers for other plugins.
plugins.
.SH "DESCRIPTION" .SH "DESCRIPTION"
.PP .PP
...@@ -12,8 +11,8 @@ This plugin answers zone transfers for authoritative plugins that implement ...@@ -12,8 +11,8 @@ This plugin answers zone transfers for authoritative plugins that implement
\fB\fCtransfer.Transferer\fR. \fB\fCtransfer.Transferer\fR.
.PP .PP
Transfer answers AXFR requests and IXFR requests with AXFR fallback if the Transfer answers full zone transfer (AXFR) requests and incremental zone transfer (IXFR) requests
zone has changed. with AXFR fallback if the zone has changed.
.PP .PP
Notifies are not currently supported. Notifies are not currently supported.
......
package chaos package chaos
// Owners are all GitHub handlers of all maintainers. // Owners are all GitHub handlers of all maintainers.
var Owners = []string{"bradbeam", "chrisohaver", "darshanime", "dilyevsky", "ekleiner", "fastest963", "greenpau", "grobie", "ihac", "inigohu", "isolus", "johnbelamaric", "miekg", "nchrisdk", "nitisht", "pmoroney", "rajansandeep", "rdrozhdzh", "rtreffer", "stp-ip", "superq", "varyoo", "yongtang"} var Owners = []string{"bradbeam", "chrisohaver", "darshanime", "dilyevsky", "ekleiner", "fastest963", "greenpau", "grobie", "ihac", "inigohu", "isolus", "johnbelamaric", "miekg", "nchrisdk", "nitisht", "pmoroney", "rajansandeep", "rdrozhdzh", "rtreffer", "stp-ip", "superq", "varyoo", "ykhr53", "yongtang"}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment