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 3bb7612eb33db7169c36fe83f1fc1b8d5071267d..624dcfa6a9cf101988f243a1d8614c44ca4850a4 100644 (file)
--- 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 309554b5a5f8069ea6f2fbb8689ffde7b113b5a6..74f1312074598a190424588dfe358cbcdecc4889 100644 (file)
--- 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