1
--- maradns-1.2.12.05/doc/en/source/faq.embed 2007-02-17 21:48:42.000000000 -0600
2
+++ maradns-1.2.12.06/doc/en/source/faq.embed 2007-03-24 16:32:11.000000000 -0600
6
32. <A href="#synthns">I am transferring a zone from another
7
- server, but the NS records are these strange "synth-ip" records.</A>
8
+ server, but the NS records are these strange "synth-ip" records.</A><p>
10
-33. <A href="#roothints">Where is the root.hints file?</A>
11
+33. <A href="#roothints">Where is the root.hints file?</A><p>
13
34. <A href="#autoconf">Are there any plans to use autoconf to build
17
35. <A href="#flags">How do I change the compiler or compile-time flags
18
- with MaraDNS' build process?</A>
19
+ with MaraDNS' build process?</A><p>
21
36. <A href="#makepkg">Will you make a package for the particular Linux
22
- distribution I am using?</A>
23
+ distribution I am using?</A><p>
25
+37. <A href="#wincrippled">I am using the native Windows port of MaraDNS,
26
+ and some features are not working.</A><p>
28
+38. <A href="#startupfail">MaraDNS isn't starting up</A><p>
30
+39. <A href="#releases">You make a lot of releases of MaraDNS; at our
31
+ ISP/IT department, updating software is non-trivial.</A>
37
<H2>1. I'm still using version 1.0 of MaraDNS</H2>
39
-MaraDNS 1.0 will continue to be fully supported until December 21, 2007; this
40
-means that MaraDNS 1.0 questions will still be answered and bug fixes will
41
+MaraDNS 1.0 will continue to be supported until December 21, 2007; this
42
+means that MaraDNS 1.0 bug fixes will
43
still be applied. After 2007/12/21, MaraDNS 1.0 will no longer be fully
44
supported; the only updates, at that point, would be bugtraq-worthy critical
45
security fixes. Not even these security updates will be applied after
48
<H2>3. What license is MaraDNS released under?</H2>
50
-MaraDNS 1.2 is released with the following two-clause BSD license:
51
+MaraDNS 1.2 is released with the following two-clause
54
-Copyright (c) 2002-2005 Sam Trenholme
55
+Copyright (c) 2002-2007 Sam Trenholme
61
Please contact me; my email address is at
63
-href="http://www.maradns.org/contact.html">http://www.maradns.org/contact.html</A>
64
+href="http://www.maradns.org/contact.html">http://www.maradns.org/contact.html</A>.
65
+Please be sure to include all information requested there, including
66
+the operating system you are using, the version of MaraDNS you are using,
67
+your <tt>mararc</tt> configuration file, and all relevant zone files.
75
-It is also possible, on MaraDNS 1.2.05 and more recent releases, to
76
+It is also possible, with MaraDNS 1.2.05 and more recent releases, to
77
use a special "FQDN4" which automatically sets up the reverse
78
mapping of a given record:
81
a functioning recursive DNS server. There is a reason why MaraDNS, pdnsd, and
82
BIND 9 all use the multi-threaded model.
84
+<p>I am planning on improving MaraDNS' threaded model to not spawn a thread
85
+for each and every uncached request.
89
<H2>13. I feel that XXX feature should be added to MaraDNS</H2>
91
which have been developed as hobbyist projects (Posadis, Pdnsd, and djbdns)
92
are no longer being actively worked on by the primary developer.
94
-I plan on someday adding standards-compliant BIND zone file support.
95
-After that, I may even add real DNS slave support.
97
+My current plans for MaraDNS are visible on the
98
+<A href=roadmap.html>roadmap page</A> for MaraDNS.
102
MaraDNS community and a strong demand for new features from that community,
105
A recursive DNS server is a DNS server that is able to contact other DNS
106
servers in order to resolve a given domain name label. This is the kind
107
-of DNS server one points to in /etc/resolve.conf
108
+of DNS server one points to in <tt>/etc/resolve.conf</tt>
112
@@ -467,10 +483,11 @@
114
<H2>20. Is MaraDNS portable?</H2>
116
-<p>MaraDNS will only compile on FreeBSD, Mac OS X, Cygwin, Linux, and
117
-partially on MinGW32 systems. If you are interested in porting MaraDNS
118
-to another system, please <A
119
-href="http://www.maradns.org/contact.html">let me know</A>.
120
+<p>MaraDNS is developed on a CentOS 3 and Windows XP dual boot laptop.
121
+MaraDNS may compile or run on other systems--there are official MaraDNS
122
+ports for Debian/Ubuntu, Slackware, FreeBSD, and NetBSD. Note that MaraDNS
123
+needs a system with a robust threading library, which some systems do not
128
@@ -918,14 +935,14 @@
130
<A name=makepkg> </A>
131
<h2>Will you make a package for the particular Linux
132
- distribution I am using?</A>
133
+ distribution I am using?</h2>
135
No. OK, let me qualify that: I won't do it unless you pay
139
There are MaraDNS packages for a number of different distributions of
140
-Linux and other operating systems. On there MaraDNS site, there is
141
+Linux and other operating systems. On the MaraDNS site, there is
142
a MaraDNS package for CentOS/Red Hat Enterprise Linux available. There
143
is also usually an up-to-date Slackware package available. In addition,
144
there is a Debian package in the Debian packages collection, a FreeBSD
147
As an aside, some of the MaraDNS packages floating around on the internet
148
are out of date. Please make sure, that if you get a third-party package
149
-from the internet, the package is for either MaraDNS 1.0.39, MaraDNS
150
-1.2.12.05, or MaraDNS 1.3.03. Older versions of MaraDNS are not
151
+from the internet, the package is for either MaraDNS 1.0.40, MaraDNS
152
+1.2.12.05, or MaraDNS 1.3.04. Older versions of MaraDNS are not
155
+<A name=wincrippled> </A>
156
+<h2>I am using the native Windows port of MaraDNS,
157
+ and some features are not working.</h2>
159
+Since Windows 32 does not have some features that *NIX OSes have, the native
160
+Windows port does not have all of the features of the *NIX version of
161
+MaraDNS. In particular, the following features are disabled:
163
+<li>ipv6 (this is actually a mingw32, not a Windows deficiency)
164
+<li>The <tt>chroot_dir</tt> mararc variable
165
+<li>The <tt>maradns_gid</tt> and <tt>maradns_uid</tt> mararc variables
166
+<li>The <tt>maxprocs</tt> mararc variable
167
+<li>The <tt>synth_soa_serial</tt> variable can not have a value of 2
170
+If any of the above features are desired, try compiling MaraDNS using
171
+Cygwin. Note that the Cygwin port of MaraDNS does not have ipv6 support,
172
+and that while <tt>chroot_dir</tt> works in Cygwin, it does not have
173
+the security that the *NIX chroot() call has.
175
+<A name=startupfail> </A>
177
+<h2>MaraDNS isn't starting up</h2>
179
+This is usually caused by a syntax error in one's mararc file, or by
180
+another MaraDNS process already running. To see what is happening, look
181
+at your system log (<tt>/var/log/messages</tt> in Centos 3) to see what
182
+errors MaraDNS reports. If you do not know how to look at a system
183
+log, you can also invoke MaraDNS from the command line as root; any errors
184
+will be visible when starting MaraDNS.
186
+<A name=releases> </A>
188
+<h2>You make a lot of releases of MaraDNS; at our
189
+ ISP/IT department, updating software is non-trivial.</h2>
191
+The number of releases seen in the <A href=changelog.html>changelog</A>
192
+is not an accurate reflection of how often someone using a stable
193
+branch of MaraDNS will need to update.
197
+There were only three updates to the 1.0 legacy branch in 2006. The 1.2 branch
198
+was updated frequently in the first half of 2006, since I felt MaraDNS 1.2
199
+needed some features that didn't make it in to 1.2.00. During this update
200
+cycle, there was always a stable bugfix-only branch of MaraDNS.
204
+In August of 2006, I stabilized the 1.2 branch and only three updates
205
+have been done since then. Unless there is a critical bug, I only update
206
+the 1.2 branch approximately once every three months or so.
210
+I go to a great deal of effort to make sure MaraDNS releases are as
211
+painless to update as possible. I ensure configuration file format
212
+compatibility, even between major versions of MaraDNS. With the exception
213
+of configuration file parser bugfixes, MaraDNS 1.0 configuration files
214
+are compatible with MaraDNS 1.2 and 1.3.
218
+It is impossible to make code that is bug-free or without security
219
+problems. This is especially true with code that runs on the public
220
+internet.<sup><font size=-2>1</font></sup> Code has to be updated from
221
+time to time. What I do in order to minimize the disruption caused by an
222
+update is to always have a stable bugfix-only branch of MaraDNS (right now I
223
+have <i>two</i> bugfix-only branches), and to, as much as possible, evenly
224
+space out the bugfix updates.
228
+Footnote 1: Even DJB's code has security problems. Both Qmail and DjbDNS
229
+have known security problems, and need to be patched before put on a public