From: Jeremy C. Reed <jreed@ISC.org>
Date: Wed, 28 Mar 2012 13:09:39 +0000 (-0500)
Subject: [trac1732] start of the documenting in-memory data source use
X-Git-Tag: trac2351_base~226^2~116^2~94^2~13
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=da214e3e13d2ee898a409df35cff9f208654503b;p=thirdparty%2Fkea.git

[trac1732] start of the documenting in-memory data source use

from jinmei's guide.diff from ticket #1732
---

diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 3599e259ec..c9dd566890 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -1317,6 +1317,13 @@ This may be a temporary setting until then.
             </listitem>
           </varlistentry>
 
+          <varlistentry>
+            <term>datasources</term>
+            <listitem>
+              <simpara>TBD</simpara>
+            </listitem>
+          </varlistentry>
+
         </variablelist>
 
       </para>
@@ -1362,10 +1369,29 @@ This may be a temporary setting until then.
         (The full path is what was defined at build configure time for
         <option>--localstatedir</option>.
         The default is <filename>/usr/local/var/</filename>.)
-  This data file location may be changed by defining the
-  <quote>database_file</quote> configuration.
+	This data file location may be changed by defining the
+	<quote>database_file</quote> configuration.
       </para>
 
+      <section>
+	<title>In-memory Data Source</title>
+
+	<para>
+	  How to configure it.
+	  For example, the following command to bindctl
+	  will configure an in-memory data source containing the "example.com"
+	  zone with the zone file named "example.com.zone":
+
+	  <screen>&gt; <userinput> config set Auth/datasources/ [{"type": "memory", "zones": [{"origin": "example.com", "file": "example.com.zone"}]}]</userinput></screen>
+	</para>
+	By default, the memory data source is disabled; it must be
+	configured explicitly.  To disable it again, specify a null list
+	for Auth/datasources:
+
+	Notes: it's currently for class IN only.
+
+      </section>
+
     </section>
 
     <section>
@@ -1373,7 +1399,7 @@ This may be a temporary setting until then.
 
       <para>
         RFC 1035 style DNS master zone files may imported
-        into a BIND 10 data source by using the
+        into a BIND 10 SQLite3 data source by using the
         <command>b10-loadzone</command> utility.
       </para>