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-11-08
pjp
$Id: README,v 1.36 2014/11/08 20:28:31 pjp Exp $
002
2005-11-29
pbug
003
2008-04-15
pbug
1. README
004
2008-04-15
pbug
2. WHY WILDCARDNS?
005
2008-04-15
pbug
3. INSTALL HINTS
006
2014-04-13
pjp
3.1 Linux
007
2014-04-13
pjp
3.2 FreeBSD
008
2014-04-13
pjp
3.3 OpenBSD
009
2014-04-13
pjp
3.4 NetBSD
010
2014-04-13
pjp
3.5 Mac OS X
011
2008-04-15
pbug
4. COMPATIBILITY
012
2008-04-15
pbug
5. EXAMPLES
013
2009-11-03
pbug
6. WHAT IT CAN'T DO
014
2009-11-07
pbug
7. WARNING
015
2014-11-08
pjp
8. This is the last version of WILDCARDDNSD
016
2005-11-29
pbug
017
2008-04-15
pbug
1. README
018
2008-04-15
pbug
---------
019
2008-04-10
pbug
020
2010-03-28
pbug
Wildcarddns is a small authoritative nameserver. It does not recurse nor
021
2010-03-28
pbug
search. This program is written to a BSD Style License. Sleepycat's
022
2010-03-28
pbug
BerkeleyDB is also used for the main in-memory database.
023
2008-04-15
pbug
024
2008-04-15
pbug
2. WHY WILDCARDDNS?
025
2008-04-15
pbug
-------------------
026
2008-04-15
pbug
027
2010-03-28
pbug
DNS is simple. Yet implementation of DNS servers is not so simple.
028
2009-11-15
pbug
Wildcarddns is written for research into the DNS system so that perhaps one
029
2009-11-15
pbug
day the author has a better understanding of it. Comparing wildcarddns to
030
2009-11-15
pbug
other DNS implementations is not fair since many of those implementation
031
2009-11-15
pbug
fix Wildcarddns's faults on the Internet. It is recommended that if this
032
2009-11-15
pbug
daemon is used on the Internet that logging be turned on to learn from it
033
2010-04-05
pbug
and the DNS system.
034
2010-04-05
pbug
035
2010-04-05
pbug
Use the tool "dig" that comes with bind9 to debug Wildcarddns. If you like to
036
2009-11-15
pbug
program, then you can fork Wildcarddns and make your own creation, or you
037
2009-11-15
pbug
can send patches to the author who may implement them into the code.
038
2008-04-15
pbug
039
2008-04-15
pbug
040
2009-11-15
pbug
3. INSTALL HINTS
041
2009-11-15
pbug
----------------
042
2008-04-15
pbug
043
2010-03-28
pbug
To install, type sh ./configure on BSD and just ./configure on Linux. This
044
2010-03-28
pbug
will copy the proper Makefile to ./Makefile. Then you would type make,
045
2010-03-28
pbug
followed by su'ing and make install. Wildcarddnsd installs to /usr/local/sbin.
046
2008-04-15
pbug
047
2009-11-15
pbug
By default installation the configuration file is not installed you need to
048
2009-11-15
pbug
do this manually. Also by default the config file is specified as
049
2009-11-15
pbug
/etc/wildcarddns.conf this can be changed by adding the -f option to
050
2009-11-15
pbug
wildcarddnsd.
051
2005-11-29
pbug
052
2010-03-28
pbug
A sample config file exists with the sources. example7.conf was a real life
053
2010-04-05
pbug
config once.
054
2005-11-29
pbug
055
2014-04-13
pjp
3.1 Linux
056
2014-04-13
pjp
---------
057
2005-11-29
pbug
058
2014-11-07
pjp
In Linux we rely on LibreSSL 2.1.1, you must download it (configure will
059
2014-11-07
pjp
tell you from where in ./configure) and place it in the directory besides
060
2014-11-07
pjp
wildcarddnsd root directory. You do not have to install it but you have
061
2014-11-07
pjp
to ./configure && make check at least.
062
2014-09-27
pjp
063
2014-10-08
pjp
In Linux MINT you need to apt-get install build-essential.
064
2014-10-08
pjp
065
2014-04-13
pjp
## configure the platform
066
2014-04-13
pjp
$ ./configure
067
2014-04-13
pjp
## this will install the development programs you'll need (as root)
068
2014-04-13
pjp
$ apt-get install bison cvs gcc libdb5.3-dev libssl-dev
069
2014-04-13
pjp
## add a privsep user with a chroot directory (option -m) (as root)
070
2014-04-13
pjp
$ useradd -m wdnsd
071
2014-04-13
pjp
## create the db directory (as root)
072
2014-04-13
pjp
$ mkdir -p /var/db/wdns
073
2014-04-13
pjp
## make the program
074
2014-04-13
pjp
$ make
075
2014-04-13
pjp
## install the binary (as root)
076
2014-04-13
pjp
$ make install
077
2014-04-13
pjp
## done, create a config file and start wildcarddnsd
078
2014-04-13
pjp
079
2014-04-13
pjp
080
2014-04-13
pjp
3.2 FreeBSD
081
2014-04-13
pjp
-----------
082
2014-04-13
pjp
083
2014-04-13
pjp
## configure the platform
084
2014-04-13
pjp
$ sh configure
085
2014-04-13
pjp
## this will install the development programs you'll need (as root)
086
2014-04-13
pjp
$ cd /usr/ports/databases/db5 && make install clean
087
2014-04-13
pjp
## add a privsep user with a chroot directory (as root)
088
2014-04-13
pjp
$ vipw
089
2014-04-13
pjp
## or
090
2014-04-13
pjp
$ adduser
091
2014-04-13
pjp
## create the db directory (as root)
092
2014-04-13
pjp
$ mkdir -p /var/db/wdns
093
2014-04-13
pjp
## make the program
094
2014-04-13
pjp
$ make
095
2014-04-13
pjp
## install the binary (as root)
096
2014-04-13
pjp
$ make install
097
2014-04-13
pjp
## done, create a config file and start wildcarddnsd
098
2014-04-13
pjp
099
2014-08-18
pjp
Jail users, if you get a:
100
2014-08-18
pjp
101
2014-08-18
pjp
Aug 18 13:43:47 io wildcarddnsd[54350]: starting up
102
2014-08-18
pjp
Aug 18 13:43:47 io wildcarddnsd[54350]: dbenv->open failed: Function not implemented
103
2014-08-18
pjp
104
2014-08-18
pjp
Similar message, that's probably because your jail must be allowing sysvipc.
105
2014-08-18
pjp
Set this:
106
2014-08-18
pjp
107
2014-08-18
pjp
jail_example_parameters="allow.sysvipc=1"
108
2014-08-18
pjp
109
2014-08-18
pjp
in your /etc/rc.conf and reboot the jail.
110
2014-08-18
pjp
111
2014-08-18
pjp
112
2014-04-13
pjp
3.3 OpenBSD
113
2014-04-13
pjp
-----------
114
2014-04-13
pjp
115
2014-04-13
pjp
## configure the platform
116
2014-04-13
pjp
$ sh configure
117
2014-04-13
pjp
## this will install the development programs you'll need (as root)
118
2014-04-13
pjp
$ pkg_add db-4.6.21p0v0
119
2014-04-13
pjp
## add a privsep user with a chroot directory (as root)
120
2014-04-13
pjp
$ vipw
121
2014-04-13
pjp
## or
122
2014-04-13
pjp
$ adduser
123
2014-04-13
pjp
## create the db directory (as root)
124
2014-04-13
pjp
$ mkdir -p /var/db/wdns
125
2014-04-13
pjp
## make the program
126
2014-04-13
pjp
$ make
127
2014-04-13
pjp
## install the binary (as root)
128
2014-04-13
pjp
$ make install
129
2014-04-13
pjp
## done, create a config file and start wildcarddnsd
130
2014-04-13
pjp
131
2014-04-13
pjp
3.4 NetBSD
132
2014-04-13
pjp
----------
133
2014-04-13
pjp
134
2014-11-07
pjp
The tests for this were done on NetBSD 6.1.5
135
2014-04-13
pjp
136
2014-11-07
pjp
## configure the platform
137
2014-11-07
pjp
$ sh configure
138
2014-11-07
pjp
## the following will install the development programs you'll need (as root)
139
2014-11-07
pjp
$ cd /usr/pkgsrc/databases/db5 && make install
140
2014-11-07
pjp
## add a privsep user with a chroot directory (as root)
141
2014-11-07
pjp
$ useradd -m wdnsd
142
2014-11-07
pjp
## create the db directory (as root)
143
2014-11-07
pjp
$ mkdir -p /var/db/wdns
144
2014-11-07
pjp
## make the program
145
2014-11-07
pjp
$ make
146
2014-11-07
pjp
## install the binary (as root)
147
2014-11-07
pjp
$ make install
148
2014-11-07
pjp
## done, create a config file and start wildcarddnsd
149
2014-11-07
pjp
150
2014-04-13
pjp
3.5 Mac OS X
151
2014-04-13
pjp
------------
152
2014-04-13
pjp
153
2014-11-08
pjp
## configure for Mac OS X
154
2014-11-08
pjp
$ sh configure
155
2014-11-08
pjp
## Installed berkeley db 4.8 through Mac Ports.
156
2014-11-08
pjp
$ sudo port install db48
157
2014-11-08
pjp
## The binary is made with nobody as the unprivileged user
158
2014-11-08
pjp
$ make
159
2014-11-08
pjp
## cp the binary into /usr/local/sbin/
160
2014-11-08
pjp
$ sudo cp wildcarddnsd /usr/local/sbin/
161
2014-11-08
pjp
## make the /var/db/wdns directory
162
2014-11-08
pjp
$ mkdir -p /var/db/wdns
163
2014-11-08
pjp
## done, create config file and start wildcarddnsd
164
2014-04-13
pjp
165
2014-04-13
pjp
166
2008-04-15
pbug
4. COMPATIBILITY
167
2008-04-15
pbug
----------------
168
2008-04-15
pbug
169
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
170
2014-04-13
pjp
Operating System**| makes and compiles | responds to queries | Berkeley DB |
171
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
172
2014-04-13
pjp
FreeBSD 10 | yes | yes | version 5 |
173
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
174
2014-11-07
pjp
NetBSD 6.1.5 | yes* | yes | version 5 |
175
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
176
2014-11-07
pjp
OpenBSD 5.6 | yes | yes | version 4.6 |
177
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
178
2014-04-13
pjp
Linux | yes | yes | version 5 |
179
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
180
2014-11-08
pjp
Mac OS X Yosemite | yes | yes | version 4.8 |
181
2014-11-08
pjp
with MacPorts | | | |
182
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
183
2014-04-13
pjp
Rasbian OS | yes *** | yes | version 5 |
184
2014-04-13
pjp
------------------+--------------------+---------------------+-------------+
185
2008-04-15
pbug
186
2010-03-28
pbug
* there was a period in time that NetBSD didn't compile
187
2011-09-19
pbug
** All Operating Systems require Berkeley DB 4.6 or higher.
188
2013-10-30
pjp
*** Raspbian OS (Raspberry Pi) only has support for Berkeley DB 5.0 or higher
189
2008-04-15
pbug
190
2008-04-15
pbug
5. EXAMPLES
191
2008-04-15
pbug
-----------
192
2008-04-15
pbug
193
2008-04-15
pbug
in the directory "examples" are a few examples from working configs.
194
2009-11-03
pbug
195
2009-11-03
pbug
196
2009-11-03
pbug
6. WHAT IT CAN'T DO
197
2009-11-03
pbug
-------------------
198
2009-11-03
pbug
199
2011-04-12
pbug
* CNAME recursion. When you look up www.yahoo.com you see this:
200
2009-11-03
pbug
201
2011-04-12
pbug
;; ANSWER SECTION:
202
2011-04-12
pbug
www.yahoo.com. 58 IN CNAME fp.wg1.b.yahoo.com.
203
2011-04-12
pbug
fp.wg1.b.yahoo.com. 2802 IN CNAME eu-fp.wa1.b.yahoo.com.
204
2011-04-12
pbug
eu-fp.wa1.b.yahoo.com. 8 IN A 87.248.122.122
205
2011-04-12
pbug
eu-fp.wa1.b.yahoo.com. 8 IN A 87.248.112.181
206
2011-04-12
pbug
207
2011-04-12
pbug
The recursive part of wildcarddnsd isn't able to recurse CNAME's and it
208
2011-04-12
pbug
also doesn't have loop detection of CNAME's. This means that some lookups
209
2011-04-12
pbug
will fail on a UNIX host using wildcarddnsd recursively, so it's useless
210
2011-04-12
pbug
this needs fixing and the fix isn't simple.
211
2011-04-12
pbug
212
2011-04-12
pbug
* DNSSEC. Signed zones are becoming more and more common on the Internet.
213
2011-04-12
pbug
Wildcarddnsd can't do DNSSEC yet, unfortunately.
214
2011-04-12
pbug
215
2011-04-12
pbug
* Solaris. Unless you port some functions to solaris it won't compile on
216
2011-04-12
pbug
there.
217
2011-04-12
pbug
218
2011-04-12
pbug
* Recursive nameserver. The recursive nameserver is broken. It will work for
219
2011-04-12
pbug
a little bit perhaps and then out of nowhere will try to flood some poor
220
2011-04-12
pbug
nameserver. There is a safety catch from that happening but it kills the
221
2011-04-12
pbug
server. This part will likely need to be rewritten and I don't have the
222
2011-04-12
pbug
time to do that. The design is weak and I made it work with little planning.
223
2011-04-12
pbug
So in wildcarddnsd beta 6 the functionality for recursivenes is there but
224
2011-04-12
pbug
it doesn't work consistently.
225
2011-04-12
pbug
226
2011-04-12
pbug
227
2009-11-07
pbug
7. WARNING
228
2009-11-07
pbug
----------
229
2009-11-07
pbug
230
2009-11-07
pbug
Please read the following two hyperlinks:
231
2009-11-07
pbug
232
2009-11-07
pbug
http://queue.acm.org/detail.cfm?id=1647302
233
2009-11-07
pbug
234
2009-11-07
pbug
and
235
2009-11-07
pbug
236
2009-11-07
pbug
http://news.zdnet.co.uk/itmanagement/0,1000000308,39760362,00.htm?s_cid=260
237
2009-11-07
pbug
238
2009-11-07
pbug
Warning: WildcardDNS is research material and could cause problems when on
239
2009-11-07
pbug
the Internet. Understand the licensing if you plan to use it despite, I'm
240
2009-11-07
pbug
not liable and you've been warned.
241
2009-11-07
pbug
242
2011-04-12
pbug
Try not to use the recursive nameserver as released with BETA 6. It doesn't
243
2011-04-12
pbug
work.
244
2014-11-08
pjp
245
2014-11-08
pjp
246
2014-11-08
pjp
247
2014-11-08
pjp
8. This is the last version of WILDCARDDNSD
248
2014-11-08
pjp
-------------------------------------------
249
2014-11-08
pjp
250
2014-11-08
pjp
Wildcarddnsd project has been renamed. After the 0.9.0 beta release I won't
251
2014-11-08
pjp
release any more wildcarddnsd's. The new name was picked to avoid confusion
252
2014-11-08
pjp
with wildcard dns records. The new project name is called delphinusdnsd and
253
2014-11-08
pjp
is found online at http://delphinusdns.centroid.eu.
repomaster@centroid.eu