← Back to branch summary

~ubuntu-branches/ubuntu/raring/maradns/raring

« back to all changes in this revision

Viewing changes to update/1.3.03/maradns-1.3.02-recurse_doc.patch

  • Committer: Bazaar Package Importer
  • Author(s): Kai Hendry
  • Date: 2010-01-24 12:17:40 UTC
  • mfrom: (1.1.13 upstream) (10.1.4 sid)
  • Revision ID: james.westby@ubuntu.com-20100124121740-a4e1fjobwaouz443
Tags: 1.4.02-1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
update/1.3.03/maradns-1.3.02-recurse_doc.patch
1
 
--- maradns-1.3.02/doc/en/source/recursive.ej   2006-11-24 03:44:29.000000000 -0800
2
 
+++ maradns-1.3.03/doc/en/source/recursive.ej   2007-01-18 22:39:02.000000000 -0800
3
 
@@ -4,7 +4,7 @@
4
 
 
5
 
 </HEAD><BODY>
6
 
 
7
 
-<!-- Copyright 2005-2006 Sam Trenholme
8
 
+<!-- Copyright 2005-2007 Sam Trenholme
9
 
 
10
 
     TERMS
11
 
 
12
 
@@ -35,6 +35,8 @@
13
 
 <li><A href=#upstream>Using other recursive DNS servers</A>
14
 
 <li><A href=#otherroot>Using different root servers</A>
15
 
 <li><A href=#private>Having private host names</A>
16
 
+<li><A href=#privateauth>Using authoritative records for private names</A>
17
 
+<li><A href=#privateroot>Private names with custom root servers</A>
18
 
 <li><A href=#custom>Customizing the resolution of some names</A>
19
 
 </ul>
20
 
 
21
 
@@ -286,12 +288,23 @@
22
 
 One may wish to have private host names when running MaraDNS as a recursive
23
 
 name server.  These are names that are not attached to the root servers,
24
 
 but will resolve on the recursive name server.  For example, it might make
25
 
-sense to have "router.example.com." resolve to the IP of a router in an
26
 
+sense to have "router.office." resolve to the IP of a router in an
27
 
 office.
28
 
 
29
 
 <p>
30
 
 
31
 
-This is done by taking advantage of the fact that MaraDNS 
32
 
+There are two ways to do this with MaraDNS: By using a custom
33
 
+root server for only names that end in "office", or by having the
34
 
+authoritative half of MaraDNS handle custom name resolutions.
35
 
+
36
 
+<p>
37
 
+
38
 
+<A name="privateauth">
39
 
+<h2>Using authoritative records for private names</h2>
40
 
+</A>
41
 
+
42
 
+We can have local names by taking advantage of the fact that
43
 
+MaraDNS 
44
 
 can act as both a recursive and authoritative name server on the same IP.
45
 
 MaraDNS first looks up authoritative names before performing recursion.
46
 
 For example, if <tt>www.google.com</tt> is defined in a MaraDNS zone
47
 
@@ -323,7 +336,7 @@
48
 
 chroot_dir = "/etc/maradns"
49
 
 recursive_acl = "192.168.0.0/24"
50
 
 csv2 = {}
51
 
-csv2["example.com."] = "db.example.com"
52
 
+csv2["office."] = "db.office"
53
 
 </pre>
54
 
 
55
 
 Replace 192.168.0.1 with the IP of the machine running the recursive MaraDNS;
56
 
@@ -347,6 +360,39 @@
57
 
 in the <A href="authoritative.html#network">network section of the
58
 
 authoritative document</A>.
59
 
 
60
 
+<A name="privateroot"> 
61
 
+<h2>Private names with custom root servers</h2>
62
 
+</A>
63
 
+
64
 
+MaraDNS, starting with version 1.3.02, can have custom root name servers
65
 
+that only resolve names in a subtree of the DNS space.  In other words,
66
 
+we can tell MaraDNS to have 192.168.0.7 resolve all names ending in 
67
 
+<tt>office</tt> by having a line like this in one's mararc file:
68
 
+
69
 
+<pre>
70
 
+root_servers["office."] = "192.168.0.7"
71
 
+</pre>
72
 
+
73
 
+Here is how a configuration may look on 192.168.0.1, the recursive
74
 
+server:
75
 
+
76
 
+<pre>
77
 
+ipv4_bind_addresses = "192.168.0.1"
78
 
+chroot_dir = "/etc/maradns"
79
 
+recursive_acl = "192.168.0.0/24"
80
 
+root_servers = {}
81
 
+root_servers["office."] = "192.168.0.7"
82
 
+</pre>
83
 
+
84
 
+And the configuration on 192.168.0.7, the authoritative server:
85
 
+
86
 
+<pre>
87
 
+ipv4_bind_addresses = "192.168.0.7"
88
 
+chroot_dir = "/etc/maradns"
89
 
+csv2 = {}
90
 
+csv2["office."] = "db.office"
91
 
+</pre>
92
 
+
93
 
 <A name=custom>
94
 
 <h2>Customizing the resolution of some names</h2>
95
 
 </A>