~ubuntu-branches/ubuntu/precise/maradns/precise

« back to all changes in this revision

Viewing changes to doc/en/man/maradns.8

  • Committer: Bazaar Package Importer
  • Author(s): Kai Hendry
  • Date: 2007-05-19 22:00:19 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20070519220019-5sfo6wjbeqecn6lb
Tags: 1.2.12.06-1
* New upstream release
* A couple of memory leaks fixed
* Upstream considers these bugs important, hence medium urgency

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
.\" Process this file with the following
5
5
.\" nroff -man -Tutf8 maradns.8 | tr '\020' ' '
6
6
.\"
7
 
.\" Last updated Sat Feb 17 19:48:50 2007
 
7
.\" Last updated Wed May 16 23:01:45 2007
8
8
.\"
9
9
.TH MARADNS 8 "January 2002" MARADNS "MaraDNS reference"
10
10
.\" We don't want hyphenation (it's too ugly)
219
219
.PP
220
220
32. I am transferring a zone from another
221
221
server, but the NS records are these strange "synth-ip" records.
 
222
.PP
222
223
33. Where is the root.hints file?
 
224
.PP
223
225
34. Are there any plans to use autoconf to build
224
226
MaraDNS?
 
227
.PP
225
228
35. How do I change the compiler or compile-time flags
226
229
with MaraDNS\(aq build process?
 
230
.PP
227
231
36. Will you make a package for the particular Linux
228
232
distribution I am using?
 
233
.PP
 
234
37. I am using the native Windows port of MaraDNS,
 
235
and some features are not working.
 
236
.PP
 
237
38. MaraDNS isn\(aqt starting up
 
238
.PP
 
239
39. You make a lot of releases of MaraDNS; at our
 
240
ISP/IT department, updating software is non-trivial.
229
241
.RE
230
242
.PP
231
243
.PP
236
248
.in -3
237
249
\fB1. I\(aqm still using version 1.0 of MaraDNS\fR
238
250
.PP
239
 
MaraDNS 1.0 will continue to be fully supported until December 21,
240
 
2007; this
241
 
means that MaraDNS 1.0 questions will still be answered and bug fixes
242
 
will
 
251
MaraDNS 1.0 will continue to be supported until December 21, 2007; this
 
252
means that MaraDNS 1.0 bug fixes will
243
253
still be applied. After 2007/12/21, MaraDNS 1.0 will no longer be fully
244
254
supported; the only updates, at that point, would be bugtraq-worthy
245
255
critical
281
291
.in -3
282
292
\fB3. What license is MaraDNS released under?\fR
283
293
.PP
284
 
MaraDNS 1.2 is released with the following two-clause BSD license:
 
294
MaraDNS 1.2 is released with the following two-clause
285
295
BSD-type license:
286
296
.PP
287
297
.RS 4
288
 
Copyright (c) 2002-2005 Sam Trenholme
 
298
Copyright (c) 2002-2007 Sam Trenholme
289
299
.PP
290
300
TERMS
291
301
.PP
310
320
\fB4. How do I report bugs in MaraDNS?\fR
311
321
.PP
312
322
Please contact me; my email address is at
313
 
http://www.maradns.org/contact.html
 
323
http://www.maradns.org/contact.html.
 
324
Please be sure to include all information requested there, including
 
325
the operating system you are using, the version of MaraDNS you are
 
326
using,
 
327
your mararc configuration file, and all relevant zone files.
314
328
.PP
315
329
.in -3
316
330
\fB5. Some of the postings to the mailing list do not talk about
359
373
.RE
360
374
.PP
361
375
.PP
362
 
It is also possible, on MaraDNS 1.2.05 and more recent releases, to
 
376
It is also possible, with MaraDNS 1.2.05 and more recent releases, to
363
377
use a special "FQDN4" which automatically sets up the reverse
364
378
mapping of a given record:
365
379
.PP
456
470
pdnsd, and
457
471
BIND 9 all use the multi-threaded model.
458
472
.PP
 
473
I am planning on improving MaraDNS\(aq threaded model to not spawn a
 
474
thread
 
475
for each and every uncached request.
 
476
.PP
459
477
.in -3
460
478
\fB13. I feel that XXX feature should be added to MaraDNS\fR
461
479
.PP
475
493
djbdns)
476
494
are no longer being actively worked on by the primary developer.
477
495
.PP
478
 
I plan on someday adding standards-compliant BIND zone file support.
479
 
After that, I may even add real DNS slave support.
 
496
My current plans for MaraDNS are visible on the
 
497
roadmap page for MaraDNS.
480
498
.PP
481
499
If I see a large
482
500
MaraDNS community and a strong demand for new features from that
614
632
\fB20. Is MaraDNS portable?\fR
615
633
.PP
616
634
.PP
617
 
MaraDNS will only compile on FreeBSD, Mac OS X, Cygwin, Linux, and
618
 
partially on MinGW32 systems. If you are interested in porting MaraDNS
619
 
to another system, please let me know.
 
635
MaraDNS is developed on a CentOS 3 and Windows XP dual boot laptop.
 
636
MaraDNS may compile or run on other systems--there are official MaraDNS
 
637
ports for Debian/Ubuntu, Slackware, FreeBSD, and NetBSD. Note that
 
638
MaraDNS
 
639
needs a system with a robust threading library, which some systems do
 
640
not
 
641
have.
620
642
.PP
621
643
.in -3
622
644
\fB21. Can I use MaraDNS in Windows?\fR
1087
1109
is needed in the Linux compile or MaraDNS will have problems with
1088
1110
freezing up.
1089
1111
.PP
1090
 
<h2>Will you make a package for the particular Linux
1091
 
distribution I am using?
 
1112
.PP
 
1113
.in -3
 
1114
\fBWill you make a package for the particular Linux distribution I am
 
1115
using?\fR
 
1116
.PP
1092
1117
No. OK, let me qualify that: I won\(aqt do it unless you pay
1093
1118
me enough money.
1094
1119
.PP
1095
1120
There are MaraDNS packages for a number of different distributions of
1096
 
Linux and other operating systems. On there MaraDNS site, there is
 
1121
Linux and other operating systems. On the MaraDNS site, there is
1097
1122
a MaraDNS package for CentOS/Red Hat Enterprise Linux available. There
1098
1123
is also usually an up-to-date Slackware package available. In addition,
1099
1124
there is a Debian package in the Debian packages collection, a FreeBSD
1115
1140
internet
1116
1141
are out of date. Please make sure, that if you get a third-party
1117
1142
package
1118
 
from the internet, the package is for either MaraDNS 1.0.39, MaraDNS
1119
 
1.2.12.05, or MaraDNS 1.3.03. Older versions of MaraDNS are not
 
1143
from the internet, the package is for either MaraDNS 1.0.40, MaraDNS
 
1144
1.2.12.05, or MaraDNS 1.3.04. Older versions of MaraDNS are not
1120
1145
supported.
1121
1146
.PP
 
1147
.in -3
 
1148
\fBI am using the native Windows port of MaraDNS, and some features are
 
1149
not working.\fR
 
1150
.PP
 
1151
Since Windows 32 does not have some features that *NIX OSes have, the
 
1152
native
 
1153
Windows port does not have all of the features of the *NIX version of
 
1154
MaraDNS. In particular, the following features are disabled:
 
1155
.TP 2
 
1156
*
 
1157
ipv6 (this is actually a mingw32, not a Windows deficiency)
 
1158
.TP 2
 
1159
*
 
1160
The chroot_dir mararc variable
 
1161
.TP 2
 
1162
*
 
1163
The maradns_gid and maradns_uid mararc variables
 
1164
.TP 2
 
1165
*
 
1166
The maxprocs mararc variable
 
1167
.TP 2
 
1168
*
 
1169
The synth_soa_serial variable can not have a value of 2
 
1170
.PP
 
1171
If any of the above features are desired, try compiling MaraDNS using
 
1172
Cygwin. Note that the Cygwin port of MaraDNS does not have ipv6
 
1173
support,
 
1174
and that while chroot_dir works in Cygwin, it does not have
 
1175
the security that the *NIX chroot() call has.
 
1176
.PP
 
1177
.in -3
 
1178
\fBMaraDNS isn\(aqt starting up\fR
 
1179
.PP
 
1180
This is usually caused by a syntax error in one\(aqs mararc file, or by
 
1181
another MaraDNS process already running. To see what is happening, look
 
1182
at your system log (/var/log/messages in Centos 3) to see what
 
1183
errors MaraDNS reports. If you do not know how to look at a system
 
1184
log, you can also invoke MaraDNS from the command line as root; any
 
1185
errors
 
1186
will be visible when starting MaraDNS.
 
1187
.PP
 
1188
.in -3
 
1189
\fBYou make a lot of releases of MaraDNS; at our ISP/IT department,
 
1190
updating software is non-trivial.\fR
 
1191
.PP
 
1192
The number of releases seen in the changelog
 
1193
is not an accurate reflection of how often someone using a stable
 
1194
branch of MaraDNS will need to update.
 
1195
.PP
 
1196
There were only three updates to the 1.0 legacy branch in 2006. The 1.2
 
1197
branch
 
1198
was updated frequently in the first half of 2006, since I felt MaraDNS
 
1199
1.2
 
1200
needed some features that didn\(aqt make it in to 1.2.00. During this
 
1201
update
 
1202
cycle, there was always a stable bugfix-only branch of MaraDNS.
 
1203
.PP
 
1204
In August of 2006, I stabilized the 1.2 branch and only three updates
 
1205
have been done since then. Unless there is a critical bug, I only
 
1206
update
 
1207
the 1.2 branch approximately once every three months or so.
 
1208
.PP
 
1209
I go to a great deal of effort to make sure MaraDNS releases are as
 
1210
painless to update as possible. I ensure configuration file format
 
1211
compatibility, even between major versions of MaraDNS. With the
 
1212
exception
 
1213
of configuration file parser bugfixes, MaraDNS 1.0 configuration files
 
1214
are compatible with MaraDNS 1.2 and 1.3.
 
1215
.PP
 
1216
It is impossible to make code that is bug-free or without security
 
1217
problems. This is especially true with code that runs on the public
 
1218
internet.<sup><font size=-2>1</font></sup> Code has to be updated from
 
1219
time to time. What I do in order to minimize the disruption caused by
 
1220
an
 
1221
update is to always have a stable bugfix-only branch of MaraDNS (right
 
1222
now I
 
1223
have
 
1224
.I "two"
 
1225
bugfix-only branches), and to, as much as possible, evenly
 
1226
space out the bugfix updates.
 
1227
.PP
 
1228
Footnote 1: Even DJB\(aqs code has security problems. Both Qmail and
 
1229
DjbDNS
 
1230
have known security problems, and need to be patched before put on a
 
1231
public
 
1232
internet server.
 
1233
.PP
1122
1234
.SH "BUGS"
1123
1235
.PP
1124
1236
In the unusual case of having a csv2 zone file with Macintosh-style