From: Wouter Wijngaards <wouter@nlnetlabs.nl>
Date: Thu, 24 May 2007 13:57:52 +0000 (+0000)
Subject: docs for config options for stub zones.
X-Git-Tag: release-0.4~128
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6a08bfbb30bbf1444e4ae0740675d77cbd075c1d;p=thirdparty%2Funbound.git

docs for config options for stub zones.


git-svn-id: file:///svn/unbound/trunk@338 be551aaa-1e26-0410-a405-d3ace91eadb9
---

diff --git a/doc/example.conf b/doc/example.conf
index 3bb7612eb..624dcfa6a 100644
--- a/doc/example.conf
+++ b/doc/example.conf
@@ -118,3 +118,15 @@ server:
 
 	# the pid file.
 	# pidfile: "unbound.pid"
+
+# Stub zones.
+# Create entries like below, to make all queries for 'example.com' and 
+# subdomains go to the given list of nameservers. list zero or more 
+# nameservers by hostname or by ipaddress.
+# stub-zone:
+#	name: "example.com"
+#	stub-addr: 192.0.2.68
+# stub-zone:
+#	name: "example.org"
+#	stub-host: ns.example.com.
+
diff --git a/doc/unbound.conf.5 b/doc/unbound.conf.5
index 309554b5a..74f131207 100644
--- a/doc/unbound.conf.5
+++ b/doc/unbound.conf.5
@@ -123,6 +123,21 @@ The logfile is appended to, in the following format:
 The process id is written to the file. Default is "unbound.pid". So,
 kill -HUP `cat /etc/unbound/unbound.pid` will trigger a reload,
 kill -QUIT `cat /etc/unbound/unbound.pid` will gracefully terminate.
+.El
+
+.Ss Stub Zone Options
+There may be multiple
+.Ic stub-zone:
+clauses. Each with a name: and zero or more hostnames or IP addresses.
+For the stub zone this list of nameservers is used. Class IN is assumed.
+.Bl -tag -width indent
+.It \fBname:\fR <domain name>
+Name of the stub zone.
+.It \fBstub-host:\fR <domain name>
+Name of stub zone nameserver. Will need to be resolved before it can be used.
+.It \fBstub-addr:\fR <IP address>
+IP address of stub zone nameserver. Can be IP 4 or IP 6.
+.El
 
 .Sh FILES
 .Bl -tag -width indent