Blame
Date:
Sat Nov 8 20:28:31 2014 UTC
Message:
0.9.0 is the last version of Wildcarddnsd, the succeeding project is called Delphinusdnsd and will have its first release around November 15th, 2015. The new project page is at http://delphinusdns.centroid.eu.
001
2014-09-27
pjp
.\" Copyright (c) 2014 Peter J. Philipp
002
2014-09-27
pjp
.\" All rights reserved.
003
2014-09-27
pjp
.\"
004
2014-09-27
pjp
.\" Redistribution and use in source and binary forms, with or without
005
2014-09-27
pjp
.\" modification, are permitted provided that the following conditions
006
2014-09-27
pjp
.\" are met:
007
2014-09-27
pjp
.\" 1. Redistributions of source code must retain the above copyright
008
2014-09-27
pjp
.\" notice, this list of conditions and the following disclaimer.
009
2014-09-27
pjp
.\" 2. Redistributions in binary form must reproduce the above copyright
010
2014-09-27
pjp
.\" notice, this list of conditions and the following disclaimer in the
011
2014-09-27
pjp
.\" documentation and/or other materials provided with the distribution.
012
2014-09-27
pjp
.\" 3. The name of the author may not be used to endorse or promote products
013
2014-09-27
pjp
.\" derived from this software without specific prior written permission
014
2014-09-27
pjp
.\"
015
2014-09-27
pjp
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
016
2014-09-27
pjp
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
017
2014-09-27
pjp
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
018
2014-09-27
pjp
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
019
2014-09-27
pjp
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
020
2014-09-27
pjp
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
021
2014-09-27
pjp
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
022
2014-09-27
pjp
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
023
2014-09-27
pjp
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
024
2014-09-27
pjp
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
025
2014-09-27
pjp
.\"
026
2014-09-27
pjp
.Dd September 27, 2014
027
2014-09-27
pjp
.Dt WILDCARDDNS.CONF 5
028
2014-09-27
pjp
.Os
029
2014-09-27
pjp
.Sh NAME
030
2014-09-27
pjp
.Nm wildcarddns.conf
031
2014-09-27
pjp
.Nd the Wildcard DNS daemon configuration file
032
2014-09-27
pjp
.Sh DESCRIPTION
033
2014-09-27
pjp
The
034
2014-09-27
pjp
.Xr wildcarddnsd 8
035
2014-09-27
pjp
has a default configfile it is called
036
2014-09-27
pjp
.Nm
037
2014-09-27
pjp
and it is found in /etc. You may wonder why there is a missing d, so I ask
038
2014-09-27
pjp
you to look up
039
2014-09-27
pjp
.Xr syslogd 8
040
2014-09-27
pjp
and
041
2014-09-27
pjp
.Xr syslog.conf 5
042
2014-09-27
pjp
which also drop the d in the config file. This follows that name convention.
043
2014-09-27
pjp
.Sh EXAMPLES
044
2014-09-27
pjp
Here is a sample
045
2014-09-27
pjp
.Nm
046
2014-09-27
pjp
file:
047
2014-09-27
pjp
.Bd -literal
048
2014-09-27
pjp
; sample config file that is in production.
049
2014-09-27
pjp
;
050
2014-09-27
pjp
version "6";
051
2014-09-27
pjp
options "cool stuff" {
052
2014-09-27
pjp
interface "lo0";
053
2014-09-27
pjp
interface "em0";
054
2014-09-27
pjp
055
2014-09-27
pjp
;bind 127.0.0.1;
056
2014-09-27
pjp
;bind 192.168.34.4;
057
2014-09-27
pjp
058
2014-09-27
pjp
ratelimit-pps 6;
059
2014-09-27
pjp
060
2014-09-27
pjp
port 53;
061
2014-09-27
pjp
062
2014-09-27
pjp
;fork 2;
063
2014-09-27
pjp
log;
064
2014-09-27
pjp
}
065
2014-09-27
pjp
066
2014-09-27
pjp
axfrport "10053";
067
2014-09-27
pjp
068
2014-09-27
pjp
axfr-for "these hosts" {
069
2014-09-27
pjp
127.0.0.1;
070
2014-09-27
pjp
::1;
071
2014-09-27
pjp
192.168.0.0/16;
072
2014-09-27
pjp
}
073
2014-09-27
pjp
074
2014-09-27
pjp
notify "these hosts" {
075
2014-09-27
pjp
192.168.34.1;
076
2014-09-27
pjp
192.168.35.1;
077
2014-09-27
pjp
::1;
078
2014-09-27
pjp
}
079
2014-09-27
pjp
080
2014-09-27
pjp
081
2014-09-27
pjp
zone "centroid.eu" {
082
2014-09-27
pjp
centroid.eu,soa,3600,uranus.centroid.eu.,pjp.solarscale.de.,2014051701,3600,1800,7200,3600
083
2014-09-27
pjp
centroid.eu,ns,3600,proteus.solarscale.de.
084
2014-09-27
pjp
centroid.eu,ns,3600,uranus.centroid.eu.
085
2014-09-27
pjp
centroid.eu,ns,3600,dione.solarscale.de.
086
2014-09-27
pjp
;
087
2014-09-27
pjp
centroid.eu,a,3600,200.46.208.61
088
2014-09-27
pjp
centroid.eu,a,3600,62.75.160.180
089
2014-09-27
pjp
;
090
2014-09-27
pjp
centroid.eu,SSHFP,3600,1,1,"9b3624f96a6766e73dc88505f945a564dee82e59"
091
2014-09-27
pjp
centroid.eu,SSHFP,3600,1,2,"03310030886404f8f61d2e4dc445412788284ab04d0858bfa375eb80fc0d34f6"
092
2014-09-27
pjp
centroid.eu,SSHFP,3600,2,1,"3de1bbae4de5ebd3571a169a50d6a5a4145dd7a9"
093
2014-09-27
pjp
centroid.eu,SSHFP,3600,2,2,"bbd96ff7e7f629377d655d7fa9662502837b66cf9a2d24590df77acef66fe405"
094
2014-09-27
pjp
centroid.eu,SSHFP,3600,3,1,"0ca455de4800c0f6c681e805e7bd86e511efb1fc"
095
2014-09-27
pjp
centroid.eu,SSHFP,3600,3,2,"b330fd2288cf9e13c9ef68b1b0c0b20a10c16cc55f03cd3869cf1a49f06bed43"
096
2014-09-27
pjp
;
097
2014-09-27
pjp
centroid.eu,mx,3600,10,proteus.solarscale.de.
098
2014-09-27
pjp
centroid.eu,aaaa,3600,2001:a60:f074::8
099
2014-09-27
pjp
;
100
2014-09-27
pjp
centroid.eu,spf,3600,"v=spf1 ip4:200.46.208.61 ~all"
101
2014-09-27
pjp
;
102
2014-09-27
pjp
;
103
2014-09-27
pjp
; NAPTR trial
104
2014-09-27
pjp
centroid.eu,naptr,3600,10,10,"u","E2U+sip","!^.*$!sip:1234@sip.example.com!",centroid.eu
105
2014-09-27
pjp
centroid.eu,naptr,3600,10,20,"u","E2U+sip","!^.*$!sip:1234@sip.example.com!",.
106
2014-09-27
pjp
107
2014-09-27
pjp
;
108
2014-09-27
pjp
www.centroid.eu,a,3600,62.75.160.180
109
2014-09-27
pjp
www.centroid.eu,a,3600,200.46.208.61
110
2014-09-27
pjp
;
111
2014-09-27
pjp
www.centroid.eu,aaaa,3600,2001:a60:f074::8
112
2014-09-27
pjp
uranus.centroid.eu,a,3600,212.114.251.91
113
2014-09-27
pjp
uranus.centroid.eu,aaaa,3600,2001:a60:f000:99::2
114
2014-09-27
pjp
proteus.centroid.eu,a,3600,62.75.160.180
115
2014-09-27
pjp
dione.centroid.eu,a,3600,200.46.208.61
116
2014-09-27
pjp
rosalind.centroid.eu,aaaa,3600,2001:a60:f074::8
117
2014-09-27
pjp
irc.centroid.eu,a,3600,212.114.251.91
118
2014-09-27
pjp
irc.centroid.eu,aaaa,3600,2001:a60:f074::24
119
2014-09-27
pjp
irc2.centroid.eu,a,3600,200.46.208.61
120
2014-09-27
pjp
localhost.centroid.eu,a,3600,127.0.0.1
121
2014-09-27
pjp
localhost.centroid.eu,aaaa,3600,::1
122
2014-09-27
pjp
; the below are new delegations (NS) records
123
2014-09-27
pjp
;delegation.centroid.eu,delegate,3600,ns1.server.com.
124
2014-09-27
pjp
; glue record
125
2014-09-27
pjp
;ns1.server.com.,a,3600,10.0.0.1
126
2014-09-27
pjp
;delegation.centroid.eu,delegate,3600,ns2.server.com.
127
2014-09-27
pjp
; glue record
128
2014-09-27
pjp
;ns2.server.com.,a,3600,10.0.0.2
129
2014-09-27
pjp
}
130
2014-09-27
pjp
zone "ipv6.centroid.eu" {
131
2014-09-27
pjp
ipv6.centroid.eu,soa,3600,uranus.centroid.eu.,pjp.solarscale.de.,1244725285,3600,1800,7200,3600
132
2014-09-27
pjp
ipv6.centroid.eu,aaaa,3600,2001:a60:f074::8
133
2014-09-27
pjp
www.ipv6.centroid.eu,aaaa,3600,2001:a60:f074::8
134
2014-09-27
pjp
}
135
2014-09-27
pjp
zone "ipv6.solarscale.de" {
136
2014-09-27
pjp
ipv6.solarscale.de,soa,3600,proteus.solarscale.de.,pjp.solarscale.de.,1234896563,3600,1800,7200,3600
137
2014-09-27
pjp
ipv6.solarscale.de,ns,3600,proteus.solarscale.de.
138
2014-09-27
pjp
ipv6.solarscale.de,ns,3600,uranus.centroid.eu.
139
2014-09-27
pjp
ipv6.solarscale.de,aaaa,3600,2001:a60:f074::8
140
2014-09-27
pjp
www.ipv6.solarscale.de,aaaa,3600,2001:a60:f074::8
141
2014-09-27
pjp
}
142
2014-09-27
pjp
zone "reverse dns" {
143
2014-09-27
pjp
0.4.7.0.f.0.6.a.0.1.0.0.2.ip6.arpa.,soa,3600,proteus.solarscale.de.,pjp.solarscale.de.,1234896562,3600,1800,7200,3600
144
2014-09-27
pjp
1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.4.7.0.f.0.6.a.0.1.0.0.2.ip6.arpa.,ptr,3600,uranus.centroid.eu.
145
2014-09-27
pjp
2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.4.7.0.f.0.6.a.0.1.0.0.2.ip6.arpa.,ptr,3600,setebos.centroid.eu.
146
2014-09-27
pjp
}
147
2014-09-27
pjp
148
2014-09-27
pjp
zone "root hints" {
149
2014-09-27
pjp
.,hint,3600000,A.ROOT-SERVERS.NET.
150
2014-09-27
pjp
A.ROOT-SERVERS.NET.,a,3600000,198.41.0.4
151
2014-09-27
pjp
A.ROOT-SERVERS.NET.,aaaa,3600000,2001:503:BA3E::2:30
152
2014-09-27
pjp
.,hint,3600000,B.ROOT-SERVERS.NET.
153
2014-09-27
pjp
B.ROOT-SERVERS.NET.,a,3600000,192.228.79.201
154
2014-09-27
pjp
.,hint,3600000,C.ROOT-SERVERS.NET.
155
2014-09-27
pjp
C.ROOT-SERVERS.NET.,a,3600000,192.33.4.12
156
2014-09-27
pjp
.,hint,3600000,D.ROOT-SERVERS.NET.
157
2014-09-27
pjp
D.ROOT-SERVERS.NET.,a,3600000,199.7.91.13
158
2014-09-27
pjp
D.ROOT-SERVERS.NET.,aaaa,3600000,2001:500:2D::D
159
2014-09-27
pjp
.,hint,3600000,E.ROOT-SERVERS.NET.
160
2014-09-27
pjp
E.ROOT-SERVERS.NET.,a,3600000,192.203.230.10
161
2014-09-27
pjp
.,hint,3600000,F.ROOT-SERVERS.NET.
162
2014-09-27
pjp
F.ROOT-SERVERS.NET.,a,3600000,192.5.5.241
163
2014-09-27
pjp
F.ROOT-SERVERS.NET.,aaaa,3600000,2001:500:2f::f
164
2014-09-27
pjp
.,hint,3600000,G.ROOT-SERVERS.NET.
165
2014-09-27
pjp
G.ROOT-SERVERS.NET.,a,3600000,192.112.36.4
166
2014-09-27
pjp
.,hint,3600000,H.ROOT-SERVERS.NET.
167
2014-09-27
pjp
H.ROOT-SERVERS.NET.,a,3600000,128.63.2.53
168
2014-09-27
pjp
H.ROOT-SERVERS.NET.,aaaa,3600000,2001:500:1::803f:235
169
2014-09-27
pjp
.,hint,3600000,I.ROOT-SERVERS.NET.
170
2014-09-27
pjp
I.ROOT-SERVERS.NET.,a,3600000,192.36.148.17
171
2014-09-27
pjp
.,hint,3600000,J.ROOT-SERVERS.NET.
172
2014-09-27
pjp
J.ROOT-SERVERS.NET.,a,3600000,192.58.128.30
173
2014-09-27
pjp
J.ROOT-SERVERS.NET.,aaaa,3600000,2001:503:C27::2:30
174
2014-09-27
pjp
.,hint,3600000,K.ROOT-SERVERS.NET.
175
2014-09-27
pjp
K.ROOT-SERVERS.NET.,a,3600000,193.0.14.129
176
2014-09-27
pjp
K.ROOT-SERVERS.NET.,aaaa,3600000,2001:7fd::1
177
2014-09-27
pjp
.,hint,3600000,L.ROOT-SERVERS.NET.
178
2014-09-27
pjp
L.ROOT-SERVERS.NET.,a,3600000,199.7.83.42
179
2014-09-27
pjp
L.ROOT-SERVERS.NET.,aaaa,3600000,2001:500:3::42
180
2014-09-27
pjp
.,hint,3600000,M.ROOT-SERVERS.NET.
181
2014-09-27
pjp
M.ROOT-SERVERS.NET.,a,3600000,202.12.27.33
182
2014-09-27
pjp
M.ROOT-SERVERS.NET.,aaaa,3600000,2001:dc3::35
183
2014-09-27
pjp
}
184
2014-09-27
pjp
185
2014-09-27
pjp
.Ed
186
2014-09-27
pjp
.Sh GRAMMAR
187
2014-09-27
pjp
Syntax for
188
2014-09-27
pjp
.Nm
189
2014-09-27
pjp
in BNF:
190
2014-09-27
pjp
.Bd -literal
191
2014-09-27
pjp
line = ( version | axfrport | include | zone | region |
192
2014-09-27
pjp
wof | axfr | notify | whitelist | filter | recurse | logging
193
2014-09-27
pjp
| comment | options )
194
2014-09-27
pjp
195
2014-09-27
pjp
version = "version" ("number") semicolon
196
2014-09-27
pjp
197
2014-09-27
pjp
axfrport = "axfrport" ("port number") semicolon
198
2014-09-27
pjp
199
2014-09-27
pjp
include = "include" ("filename") semicolon
200
2014-09-27
pjp
201
2014-09-27
pjp
zone = "zone" ("string") [ "{" zonedata "}" ]
202
2014-09-27
pjp
zonedata = { [hostname] [ "," dnstype] [ "," ttl ] ["," variablednsdata] }
203
2014-09-27
pjp
hostname = string
204
2014-09-27
pjp
dnstype = ( "a" | "aaaa" | "ptr" | "mx" | "soa" | "ns" | "sshfp" | "spf" |
205
2014-09-27
pjp
"naptr" | "txt" | "delegate" | "hint" )
206
2014-09-27
pjp
ttl = number
207
2014-09-27
pjp
208
2014-09-27
pjp
region = "region" ("string") [ "{" cidrlist "}"
209
2014-09-27
pjp
210
2014-09-27
pjp
cidrlist = { [ cidr-address ] semicolon ... }
211
2014-09-27
pjp
212
2014-09-27
pjp
wof = "wildcard-only-for" ("string") [ "{" cidrlist "}" ]
213
2014-09-27
pjp
214
2014-09-27
pjp
axfr = "axfr-for" ("string") [ "{" cidrlist "}" ]
215
2014-09-27
pjp
216
2014-09-27
pjp
notify = "notify" ("string") [ "{" cidrlist "}" ]
217
2014-09-27
pjp
218
2014-09-27
pjp
whitelist = "whitelist" ("string") [ "{" cidrlist "}" ]
219
2014-09-27
pjp
220
2014-09-27
pjp
filter = "filter" ("string") [ "{" cidrlist "}" ]
221
2014-09-27
pjp
222
2014-09-27
pjp
recurse = "recurse-for" ("string") [ "{" cidrlist "}" ]
223
2014-09-27
pjp
224
2014-09-27
pjp
logging = "logging" ("string") [ "{" logstatements "}" ]
225
2014-09-27
pjp
logstatements = ( "logbind" | "logpasswd" | "logport" | "loghost" )
226
2014-09-27
pjp
logbind = "logbind" ("string") semicolon
227
2014-09-27
pjp
logpasswd = "logpasswd" ("string") semicolon
228
2014-09-27
pjp
logport = "logport" number semicolon
229
2014-09-27
pjp
loghost = "loghost" cidr-address semicolon
230
2014-09-27
pjp
231
2014-09-27
pjp
comment = ( semicolon | pound ) line
232
2014-09-27
pjp
233
2014-09-27
pjp
options = "options" ("string") [ "{" optionlist "}" ]
234
2014-09-27
pjp
optionlist = ( optrecurse | optinterface | optfork | optport |
235
2014-09-27
pjp
optratelimit | optbind )
236
2014-09-27
pjp
optrecurse = "recurse" semicolon
237
2014-09-27
pjp
optinterface = "interface" ("string") semicolon
238
2014-09-27
pjp
optfork = "fork" number semicolon
239
2014-09-27
pjp
optratelimit = "ratelimit-pps" number semicolon
240
2014-09-27
pjp
optbind = "bind" cidr-address semicolon
241
2014-09-27
pjp
.Ed
242
2014-09-27
pjp
.Sh FILES
243
2014-09-27
pjp
.Pa /etc/wildcarddns.conf
244
2014-09-27
pjp
.Sh SEE ALSO
245
2014-09-27
pjp
.Xr wildcarddnsd 8
246
2014-09-27
pjp
.Sh AUTHORS
247
2014-09-27
pjp
This software and manual was written by
248
2014-09-27
pjp
.An Peter J. Philipp Aq pjp@centroid.eu
249
2014-09-27
pjp
repomaster@centroid.eu