Blame
Date:
Sat Aug 1 09:01:52 2020 UTC
Message:
move extended RCODE's out of the RCODE section those are only 0x00 through 0x0F make a section that shows extended RCODE's that are added to a EDNS0 tag.
001
2020-04-23
pjp
.\" Copyright (c) 2014-2020 Peter J. Philipp
002
2014-11-14
pjp
.\" All rights reserved.
003
2014-11-14
pjp
.\"
004
2014-11-14
pjp
.\" Redistribution and use in source and binary forms, with or without
005
2014-11-14
pjp
.\" modification, are permitted provided that the following conditions
006
2014-11-14
pjp
.\" are met:
007
2014-11-14
pjp
.\" 1. Redistributions of source code must retain the above copyright
008
2014-11-14
pjp
.\" notice, this list of conditions and the following disclaimer.
009
2014-11-14
pjp
.\" 2. Redistributions in binary form must reproduce the above copyright
010
2014-11-14
pjp
.\" notice, this list of conditions and the following disclaimer in the
011
2014-11-14
pjp
.\" documentation and/or other materials provided with the distribution.
012
2014-11-14
pjp
.\" 3. The name of the author may not be used to endorse or promote products
013
2014-11-14
pjp
.\" derived from this software without specific prior written permission
014
2014-11-14
pjp
.\"
015
2014-11-14
pjp
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
016
2014-11-14
pjp
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
017
2014-11-14
pjp
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
018
2014-11-14
pjp
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
019
2014-11-14
pjp
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
020
2014-11-14
pjp
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
021
2014-11-14
pjp
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
022
2014-11-14
pjp
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
023
2014-11-14
pjp
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
024
2014-11-14
pjp
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
025
2014-11-14
pjp
.\"
026
2020-07-17
pjp
.Dd July 17, 2020
027
2014-11-14
pjp
.Dt DELPHINUSDNS.CONF 5
028
2014-11-14
pjp
.Os
029
2014-11-14
pjp
.Sh NAME
030
2014-11-14
pjp
.Nm delphinusdns.conf
031
2014-11-14
pjp
.Nd the delphinus DNS daemon configuration file
032
2014-11-14
pjp
.Sh DESCRIPTION
033
2014-11-14
pjp
The
034
2014-11-14
pjp
.Xr delphinusdnsd 8
035
2014-11-14
pjp
has a default configfile it is called
036
2014-11-14
pjp
.Nm
037
2019-10-04
pjp
and it is found in /etc/delphinusdns/. You may wonder why there is a missing
038
2019-10-04
pjp
d, so I ask you to look up
039
2014-11-14
pjp
.Xr syslogd 8
040
2014-11-14
pjp
and
041
2014-11-14
pjp
.Xr syslog.conf 5
042
2014-11-14
pjp
which also drop the d in the config file. This follows that name convention.
043
2014-11-14
pjp
.Sh EXAMPLES
044
2014-11-14
pjp
Here is a sample
045
2014-11-14
pjp
.Nm
046
2014-11-14
pjp
file:
047
2014-11-14
pjp
.Bd -literal
048
2020-07-15
pjp
version "1";
049
2014-11-14
pjp
options "cool stuff" {
050
2014-11-14
pjp
interface "lo0";
051
2014-11-14
pjp
interface "em0";
052
2014-11-14
pjp
053
2014-11-14
pjp
;bind 127.0.0.1;
054
2014-11-14
pjp
;bind 192.168.34.4;
055
2014-11-14
pjp
056
2014-11-14
pjp
ratelimit-pps 6;
057
2014-11-14
pjp
058
2014-11-14
pjp
port 53;
059
2014-11-14
pjp
060
2014-11-14
pjp
;fork 2;
061
2014-11-14
pjp
log;
062
2015-12-19
pjp
;dnssec;
063
2020-04-23
pjp
;tcp-on-any-only;
064
2014-11-14
pjp
}
065
2014-11-14
pjp
066
2014-11-14
pjp
axfrport "10053";
067
2014-11-14
pjp
068
2014-11-14
pjp
axfr-for "these hosts" {
069
2014-11-14
pjp
127.0.0.1;
070
2014-11-14
pjp
::1;
071
2014-11-14
pjp
192.168.0.0/16;
072
2014-11-14
pjp
}
073
2014-11-14
pjp
074
2019-07-09
pjp
mzone "centroid.eu" {
075
2019-07-09
pjp
zonename "centroid.eu";
076
2019-07-09
pjp
notifydest 192.168.34.1 NOKEY;
077
2019-07-09
pjp
notifydest ::1 port 8053 NOKEY;
078
2014-11-14
pjp
}
079
2014-11-14
pjp
080
2014-11-14
pjp
zone "centroid.eu" {
081
2019-11-19
pjp
centroid.eu,soa,3600,ns1.centroid.eu.,hostmaster.centroid.eu.,2019111901,3600,1800,7200,3600
082
2019-11-19
pjp
centroid.eu,ns,3600,somenameserver.delphinusdns.org.
083
2019-11-19
pjp
centroid.eu,ns,3600,anothernameserver.delphinusdns.org.
084
2019-11-19
pjp
; all lines in zone start with domainname, RR Type, RR TTL, RDATA
085
2019-11-19
pjp
centroid.eu,a,3600,127.0.0.1
086
2019-11-19
pjp
centroid.eu,a,3600,10.0.0.10
087
2017-01-06
pjp
}
088
2017-01-06
pjp
.Ed
089
2017-01-06
pjp
Here is a sample
090
2017-01-06
pjp
.Nm
091
2017-01-06
pjp
file suited for DNSSEC:
092
2017-01-06
pjp
.Bd -literal
093
2020-07-15
pjp
version "1";
094
2017-01-06
pjp
options "some options" {
095
2017-01-06
pjp
ratelimit-pps 12;
096
2017-01-06
pjp
bind 127.0.0.1;
097
2017-01-06
pjp
bind ::1;
098
2017-01-06
pjp
bind 10.110.99.87;
099
2017-01-06
pjp
port 32253;
100
2017-01-06
pjp
log;
101
2017-01-06
pjp
dnssec;
102
2020-07-15
pjp
versionstring "delphinusdnsd 1.5.0";
103
2017-01-06
pjp
}
104
2017-01-06
pjp
axfr-for "these hosts" {
105
2017-01-06
pjp
::1/128;
106
2017-01-06
pjp
127.0.0.1/32;
107
2017-01-06
pjp
10.110.99.88/32;
108
2017-01-06
pjp
}
109
2014-11-14
pjp
110
2017-01-06
pjp
axfrport "10053";
111
2017-01-06
pjp
112
2019-07-09
pjp
mzone "centroid.eu" {
113
2019-07-09
pjp
zonename "centroid.eu";
114
2019-07-09
pjp
notifydest 10.1110.99.88 NOKEY;
115
2019-07-09
pjp
notifydest ::1 port 8053 NOKEY;
116
2014-11-14
pjp
}
117
2019-07-09
pjp
118
2017-01-06
pjp
119
2018-07-11
pjp
zinclude "/etc/delphinusdns/centroid.eu.signed";
120
2017-01-06
pjp
121
2017-01-06
pjp
.Ed
122
2017-01-06
pjp
Then the included files are output of
123
2018-07-11
pjp
.Xr dddctl 8
124
2019-11-14
pjp
.Pp
125
2020-07-17
pjp
A forwarding-only config may look like this:
126
2020-07-17
pjp
.Bd -literal
127
2020-07-17
pjp
version "1";
128
2020-07-17
pjp
129
2020-07-17
pjp
options "this mess" {
130
2020-07-17
pjp
interface "em0";
131
2020-07-17
pjp
interface "lo0";
132
2020-07-17
pjp
port 8053;
133
2020-07-17
pjp
versionstring "";
134
2020-07-17
pjp
dnssec;
135
2020-07-17
pjp
}
136
2020-07-17
pjp
137
2020-07-17
pjp
tsig-auth secret "9qD4Qi4ghqFR1xm0fIwGF9t0aLx+SZWVEPAqEvysZFg=";
138
2020-07-17
pjp
tsig "these hosts" {
139
2020-07-17
pjp
0.0.0.0/0;
140
2020-07-17
pjp
}
141
2020-07-17
pjp
142
2020-07-17
pjp
forward "to these hosts" {
143
2020-07-17
pjp
incoming-tsig yes;
144
2020-07-17
pjp
destination 127.0.0.1 port 5353 key NOKEY;
145
2020-07-17
pjp
}
146
2020-07-17
pjp
.Ed
147
2020-07-17
pjp
.Pp
148
2019-11-14
pjp
Finally below is a sample replicant
149
2019-11-14
pjp
.Nm
150
2019-11-14
pjp
as taken from a
151
2019-11-14
pjp
.Xr delphinusdnsd
152
2019-11-14
pjp
with only one zone:
153
2019-11-14
pjp
.Bd -literal
154
2020-07-15
pjp
version "1";
155
2019-11-14
pjp
156
2019-11-14
pjp
options "arrowhead" {
157
2019-11-14
pjp
ratelimit-pps 12;
158
2019-11-14
pjp
interface "lo0";
159
2019-11-14
pjp
interface "vio0";
160
2019-11-14
pjp
port 53;
161
2019-11-14
pjp
log;
162
2019-11-14
pjp
dnssec;
163
2019-11-14
pjp
versionstring "delphinusdnsd-20191103";
164
2019-11-14
pjp
}
165
2019-11-14
pjp
166
2019-11-14
pjp
include "/etc/delphinusdns/delphinusdns.tsig";
167
2019-11-14
pjp
168
2019-11-14
pjp
rzone "ip6.centroid.eu." {
169
2020-07-27
pjp
constraints 600, 600, 600;
170
2019-11-19
pjp
; do make sure you have a tsig "" {} for this
171
2019-11-14
pjp
tsigkey "pass";
172
2019-11-14
pjp
masterport 10053;
173
2019-11-14
pjp
master 2a01:4f8:162:e700:881c:fe60:3582:f49c;
174
2019-11-14
pjp
zonename "ip6.centroid.eu.";
175
2019-11-14
pjp
filename "/etc/delphinusdns/replicant/ip6.centroid.eu.repl";
176
2019-11-14
pjp
}
177
2019-11-14
pjp
178
2019-11-14
pjp
.Ed
179
2019-11-14
pjp
Notice the /etc/delphinusdns/replicant/ directory, this is a hardcoded path.
180
2014-11-14
pjp
.Sh GRAMMAR
181
2014-11-14
pjp
Syntax for
182
2014-11-14
pjp
.Nm
183
2014-11-14
pjp
in BNF:
184
2014-11-14
pjp
.Bd -literal
185
2018-07-11
pjp
line = ( version | axfrport | include | zinclude | zone | region |
186
2020-07-16
pjp
axfr | mzone | passlist | filter | recurse | comment |
187
2020-07-27
pjp
options | forward | rzone )
188
2014-11-14
pjp
189
2016-11-29
pjp
version = "version" ("number") ;
190
2014-11-14
pjp
191
2016-11-29
pjp
axfrport = "axfrport" ("port number") ;
192
2014-11-14
pjp
193
2016-11-29
pjp
include = "include" ("filename") ;
194
2014-11-14
pjp
195
2018-07-11
pjp
zinclude = "zinclude" ("filename") ;
196
2018-07-11
pjp
197
2014-11-14
pjp
zone = "zone" ("string") [ "{" zonedata "}" ]
198
2014-11-14
pjp
zonedata = { [hostname] [ "," dnstype] [ "," ttl ] ["," variablednsdata] }
199
2014-11-14
pjp
hostname = string
200
2015-12-19
pjp
dnstype = ( "a" | "aaaa" | "cname" | "dnskey" | "ds" | "mx" | "naptr" |
201
2019-11-14
pjp
"ns" | "nsec3" | "nsec3param" | "ptr" | "rrsig" |
202
2019-11-14
pjp
"soa" | "srv" | "sshfp" | "tlsa" | "txt" | "hint" )
203
2015-12-19
pjp
204
2014-11-14
pjp
ttl = number
205
2014-11-14
pjp
206
2014-11-14
pjp
region = "region" ("string") [ "{" cidrlist "}"
207
2014-11-14
pjp
208
2019-02-26
pjp
209
2016-11-29
pjp
cidrlist = { [ cidr-address ] ; ... }
210
2016-11-29
pjp
211
2014-11-14
pjp
axfr = "axfr-for" ("string") [ "{" cidrlist "}" ]
212
2014-11-14
pjp
213
2019-07-09
pjp
mzonelist = ( optzonename | optnotifydest | optnotifybind )
214
2019-07-09
pjp
optzonename = "zonename" ("string") ;
215
2019-07-09
pjp
optnotifydest = "notifydest" cidr-address ["port number"] "tsigkey" ;
216
2019-07-09
pjp
optnotifybind = "notifybind" cidr-address ;
217
2014-11-14
pjp
218
2019-07-09
pjp
mzone = "mzone" ("string") [ "{" mzonelist "}" ]
219
2014-11-14
pjp
220
2020-07-16
pjp
passlist = "passlist" ("string") [ "{" cidrlist "}" ]
221
2019-02-26
pjp
222
2014-11-14
pjp
filter = "filter" ("string") [ "{" cidrlist "}" ]
223
2014-11-14
pjp
224
2014-11-14
pjp
recurse = "recurse-for" ("string") [ "{" cidrlist "}" ]
225
2014-11-14
pjp
226
2019-11-14
pjp
base64-string = (string)
227
2019-11-14
pjp
tsig-auth = "tsig-auth" (string) ("base64-string") ;
228
2019-11-14
pjp
tsig = "tsig" ("string") [ "{" cidrlist "}" ]
229
2014-11-14
pjp
230
2020-07-17
pjp
rzone = "rzone" ("string") [ "{" rzonelist "}" ]
231
2020-07-27
pjp
rzonelist = ( opttsig | optmaster | optmasterport | optrzonename |
232
2020-07-27
pjp
optfilename | optconstraints )
233
2020-07-17
pjp
234
2019-11-14
pjp
opttsig = "tsigkey" ("string") ;
235
2019-11-14
pjp
optmaster = "master" ("cidr-address") ;
236
2019-11-14
pjp
optmasterport = "masterport" (number) ;
237
2019-11-14
pjp
optrzonename = "zonename" ("string") ;
238
2019-11-14
pjp
optfilename = "filename" ("string") ;
239
2020-07-27
pjp
optconstraints = "constraints" (number), (number), (number) ;
240
2019-11-14
pjp
241
2020-07-17
pjp
242
2020-07-17
pjp
forward = "forward" ("string") [ "{" forwardlist "}" ]
243
2020-07-17
pjp
forwardlist = ( optdestination | optstrictx20 | optcache | optincomingtsig )
244
2020-07-17
pjp
245
2020-07-17
pjp
optdestination = "destination" ("cidr-address") "port" ("integer") "key"
246
2020-07-17
pjp
(string | "NOKEY") ;
247
2020-07-17
pjp
optstrictx20 = "strictx20" ("yes" | "no") ;
248
2020-07-17
pjp
optcache = "cache" ("yes" | "no") ;
249
2020-07-17
pjp
optincomingtsig = "incoming-tsig" ("yes" | "no") ;
250
2020-04-23
pjp
251
2016-11-29
pjp
comment = ( ; | pound ) line
252
2016-11-29
pjp
253
2014-11-14
pjp
options = "options" ("string") [ "{" optionlist "}" ]
254
2014-11-14
pjp
optionlist = ( optrecurse | optinterface | optfork | optport |
255
2020-04-23
pjp
optratelimit | optbind | optdnssec | opttcponanyonly)
256
2016-11-29
pjp
optrecurse = "recurse" ;
257
2016-11-29
pjp
optinterface = "interface" ("string") ;
258
2016-11-29
pjp
optfork = "fork" number ;
259
2016-11-29
pjp
optratelimit = "ratelimit-pps" number ;
260
2016-11-29
pjp
optbind = "bind" cidr-address ;
261
2016-11-29
pjp
optdnssec = "dnssec" ;
262
2020-04-23
pjp
opttcponanyonly = "tcp-on-any-only" ;
263
2019-11-14
pjp
264
2014-11-14
pjp
.Ed
265
2014-11-14
pjp
.Sh FILES
266
2019-09-20
pjp
.Pa /etc/delphinusdns/delphinusdns.conf
267
2014-11-14
pjp
.Sh SEE ALSO
268
2018-07-11
pjp
.Xr dddctl 8 ,
269
2014-11-14
pjp
.Xr delphinusdnsd 8
270
2014-11-14
pjp
.Sh AUTHORS
271
2014-11-14
pjp
This software and manual was written by
272
2017-12-27
pjp
.An Peter J. Philipp Aq petphi@delphinusdns.org
273
2014-11-14
pjp
repomaster@centroid.eu