[deployment-guide/comm-rel: 93/727] Updated the /etc/sysconfig/named section.

[Jaromir Hradilek]

commit d3a58cd3ef520c3435141f5e7f3007209ada65e9
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Jul 21 16:07:08 2010 +0200

    Updated the /etc/sysconfig/named section.

 en-US/The_sysconfig_Directory.xml |   56 +++++++++++++++++++++++++------------
 1 files changed, 38 insertions(+), 18 deletions(-)
---
diff --git a/en-US/The_sysconfig_Directory.xml b/en-US/The_sysconfig_Directory.xml
index 9fb718a..61c81a7 100644
--- a/en-US/The_sysconfig_Directory.xml
+++ b/en-US/The_sysconfig_Directory.xml
@@ -600,25 +600,45 @@
         <secondary><filename>/etc/sysconfig/named</filename></secondary>
       </indexterm>
       <para>
-        The <filename>/etc/sysconfig/named</filename> file is used to pass arguments to the <command>named</command> daemon at boot time. The <command>named</command> daemon is a <firstterm>Domain Name System</firstterm> (<firstterm>DNS</firstterm>) server which implements the <firstterm>Berkeley Internet Name Domain</firstterm> (<firstterm>BIND</firstterm>) version 9 distribution. This server maintains a table of which hostnames are associated with IP addresses on the network.
+        The <filename>/etc/sysconfig/named</filename> file is used to pass arguments to the <command>named</command> daemon at boot time. By default, it contains the following options:
       </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>ROOTDIR=<replaceable>value</replaceable></option></term>
+          <listitem>
+            <para>
+              The chroot environment under which the <command>named</command> daemon runs. The <replaceable>value</replaceable> has to be a full directory path. For example:
+            </para>
+            <screen>ROOTDIR="/var/named/chroot"</screen>
+            <para>
+              Note that the chroot environment has to be configured first (type <command>info chroot</command> at a shell prompt for more information).
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>OPTIONS=<replaceable>value</replaceable></option></term>
+          <listitem>
+            <para>
+              Additional options to be passed to <command>named</command>. For example:
+            </para>
+            <screen>OPTIONS="-6"</screen>
+            <para>
+              Note that you should not use the <option>-t</option> option. Instead, use <option>ROOTDIR</option> as described above.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>KEYTAB_FILE=<replaceable>value</replaceable></option></term>
+          <listitem>
+            <para>
+              The keytab filename. For example:
+            </para>
+            <screen>KEYTAB_FILE="/etc/named.keytab"</screen>
+          </listitem>
+        </varlistentry>
+      </variablelist>
       <para>
-        Currently, only the following values may be used:
-      </para>
-      <itemizedlist>
-        <listitem>
-          <para>
-            <command>ROOTDIR=<replaceable>"&lt;/some/where&gt;"</replaceable></command>, where <command><replaceable>&lt;/some/where&gt;</replaceable></command> refers to the full directory path of a configured chroot environment under which <command>named</command> runs. This chroot environment must first be configured. Type <command>info chroot</command> for more information.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            <command>OPTIONS=<replaceable>"&lt;value&gt;"</replaceable></command>, where <command><replaceable>&lt;value&gt;</replaceable></command> is any option listed in the man page for <command>named</command> except <option>-t</option>. In place of <option>-t</option>, use the <command>ROOTDIR</command> line above.
-          </para>
-        </listitem>
-      </itemizedlist>
-      <para>
-        For more information about available parameters for this file, refer to the <command>named</command> man page. For detailed information on how to configure a BIND DNS server, refer to <xref linkend="ch-The_BIND_DNS_Server" />. By default, the file contains no parameters.
+        Refer to <xref linkend="ch-The_BIND_DNS_Server" /> for more information on the BIND DNS server and its configuration.
       </para>
     </section>
     <section id="s2-sysconfig-network">
@@ -965,7 +985,7 @@
           <term><option>EXTRAOPTIONS=<replaceable>value</replaceable></option></term>
           <listitem>
             <para>
-              The additional options to be passed to <command>xinetd</command>. For example:
+              Additional options to be passed to <command>xinetd</command>. For example:
             </para>
             <screen>EXTRAOPTIONS=""</screen>
           </listitem>