]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
Isn't "make install" supposed to generate a default named.conf?
authorMark Andrews <marka@isc.org>
Mon, 5 Feb 2007 05:24:11 +0000 (05:24 +0000)
committerMark Andrews <marka@isc.org>
Mon, 5 Feb 2007 05:24:11 +0000 (05:24 +0000)
FAQ
FAQ.xml

diff --git a/FAQ b/FAQ
index cb0a956a6f83da3c7eb3d5850e2f1f7a520ea7b2..af6c89a4349237d3b440d561cf779e1d38f81166 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -75,12 +75,12 @@ Q: Why do I get errors like "dns_zone_load: zone foo/IN: loading master file bar
 A: This is often caused by TXT records with missing close quotes. Check that all
    TXT records containing quoted strings have both open and close quotes.
 
-Q: How do I produce a usable core file from a multithreaded named on Linux?
+Q: How do I produce a usable core file from a multi-threaded named on Linux?
 
-A: If the Linux kernel is 2.4.7 or newer, multithreaded core dumps are usable
+A: If the Linux kernel is 2.4.7 or newer, multi-threaded core dumps are usable
    (that is, the correct thread is dumped). Otherwise, if using a 2.2 kernel,
    apply the kernel patch found in contrib/linux/coredump-patch and rebuild the
-   kernel. This patch will cause multithreaded programs to dump the correct
+   kernel. This patch will cause multi-threaded programs to dump the correct
    thread.
 
 Q: How do I restrict people from looking up the server version?
@@ -310,7 +310,7 @@ A: These indicate a malformed master zone. You can identify the exact records
    named-checkzone example.com tmp
 
    A CNAME record cannot exist with the same name as another record except for the
-   DNSSEC records which prove its existance (NSEC).
+   DNSSEC records which prove its existence (NSEC).
 
    RFC 1034, Section 3.6.2: "If a CNAME RR is present at a node, no other data
    should be present; this ensures that the data for a canonical name and its
@@ -385,11 +385,11 @@ Q: I get a error message like "zone wireless.ietf56.ietf.org/IN: loading master
 A: This error is produced when a line in the master file contains leading white
    space (tab/space) but the is no current record owner name to inherit the name
    from. Usually this is the result of putting white space before a comment.
-   Forgeting the "@" for the SOA record or indenting the master file.
+   Forgetting the "@" for the SOA record or indenting the master file.
 
 Q: Why are my logs in GMT (UTC).
 
-A: You are running chrooted (-t) and have not supplied local timzone information
+A: You are running chrooted (-t) and have not supplied local timezone information
    in the chroot area.
 
    FreeBSD: /etc/localtime
@@ -474,7 +474,7 @@ A: These indicate a filesystem permission error preventing named creating /
            masters { 192.168.4.12; };
    };
 
-Q: How do I intergrate BIND 9 and Solaris SMF
+Q: How do I integrate BIND 9 and Solaris SMF
 
 A: Sun has a blog entry describing how to do this.
 
@@ -487,7 +487,7 @@ A: No. The rules for glue (copies of the *address* records in the parent zones)
 
    You would have to add both the CNAME and address records (A/AAAA) as glue to
    the parent zone and have CNAMEs be followed when doing additional section
-   processing to make it work. No namesever implementation supports either of
+   processing to make it work. No nameserver implementation supports either of
    these requirements.
 
 Q: What does "RFC 1918 response from Internet for 0.0.0.10.IN-ADDR.ARPA" mean?
@@ -495,7 +495,7 @@ Q: What does "RFC 1918 response from Internet for 0.0.0.10.IN-ADDR.ARPA" mean?
 A: If the IN-ADDR.ARPA name covered refers to a internal address space you are
    using then you have failed to follow RFC 1918 usage rules and are leaking
    queries to the Internet. You should establish your own zones for these
-   addresses to prevent you quering the Internet's name servers for these
+   addresses to prevent you querying the Internet's name servers for these
    addresses. Please see http://as112.net/ for details of the problems you are
    causing and the counter measures that have had to be deployed.
 
@@ -549,7 +549,7 @@ A: Red Hat Security Enhanced Linux (SELinux) policy security protections :
    Red Hat have adopted the National Security Agency's SELinux security policy (
    see http://www.nsa.gov/selinux ) and recommendations for BIND security , which
    are more secure than running named in a chroot and make use of the bind-chroot
-   environment unecessary .
+   environment unnecessary .
 
    By default, named is not allowed by the SELinux policy to write, create or
    delete any files EXCEPT in these directories:
@@ -614,19 +614,19 @@ A: Red Hat Security Enhanced Linux (SELinux) policy security protections :
    in different locations, you can do so by changing the context of the custom
    file locations .
 
-   To create a custom configuration file location, eg. '/root/named.conf', to use
+   To create a custom configuration file location, e.g. '/root/named.conf', to use
    with the 'named -c' option, do:
 
    # chcon system_u:object_r:named_conf_t /root/named.conf
 
 
-   To create a custom modifiable named data location, eg. '/var/log/named' for a
+   To create a custom modifiable named data location, e.g. '/var/log/named' for a
    log file, do:
 
    # chcon system_u:object_r:named_cache_t /var/log/named
 
 
-   To create a custom zone file location, eg. /root/zones/, do:
+   To create a custom zone file location, e.g. /root/zones/, do:
 
    # chcon system_u:object_r:named_zone_t /root/zones/{.,*}
 
@@ -667,10 +667,10 @@ A: No, so long as the machines internal clock (as reported by "date -u") remains
    (which sets the default timezone for the machine) and possibly a directory
    which has all the conversion rules for the world (e.g. /usr/share/zoneinfo).
    When updating the OS do not forget to update any chroot areas as well. See your
-   OS's documetation for more details.
+   OS's documentation for more details.
 
    The local timezone conversion rules can also be done on a individual basis by
-   setting the TZ envirionment variable appropriately. See your OS's documentation
+   setting the TZ environment variable appropriately. See your OS's documentation
    for more details.
 
 Q: Why do we get the following warning at run time:
@@ -686,10 +686,10 @@ A: The early Linux kernels broke sendto() by having it return that a ICMP
    Rather than fix sendto() to just have BSD behaviour they added SO_BSDCOMPAT to
    turn BSD behaviour on/off on a per socket basis.
 
-   Later they decided to make BSD behaviour the default and to aggressively
-   trackdown application that used SO_BSDCOMPAT by issuing a warning. This is the
-   sort of things vendors do in alpha/beta stages of a release so that their code
-   is clean. They then turn the warning *off* for release code.
+   Later they decided to make BSD behaviour the default and to aggressively track
+   down applications that used SO_BSDCOMPAT by issuing a warning. This is the sort
+   of things vendors do in alpha/beta stages of a release so that their code is
+   clean. They then turn the warning *off* for release code.
 
    We still have customers that have kernels that require SO_BSDCOMPAT to operate.
    We therefore cannot remove the setsockopt(SO_BSDCOMPAT) call.
@@ -701,3 +701,21 @@ A: The early Linux kernels broke sendto() by having it return that a ICMP
    In short, the Linux developers should either, remove the #define for
    SO_BSDCOMPAT, and/or remove the warning.
 
+Q: Isn't "make install" supposed to generate a default named.conf?
+
+A: Short Answer: No.
+
+   Long Answer: There really isn't a default configuration which fits any site
+   perfectly. There are lots of decisions that need to be made and there is no
+   consensus on what the defaults should be. For example FreeBSD uses /etc/namedb
+   as the location where the configuration files for named are stored. Others use
+   /var/named.
+
+   What addresses to listen on? For a laptop on the move a lot you may only want
+   to listen on the loop back interfaces.
+
+   Who do you offer recursive service to? Is there are firewall to consider? If so
+   is it stateless or stateful. Are you directly on the Internet? Are you on a
+   private network? Are you on a NAT'd network? The answers to all these questions
+   change how you configure even a caching name server.
+
diff --git a/FAQ.xml b/FAQ.xml
index ff07ae7c8992f0956569c8d8774eb420f8b49fd4..77c9e6034ad290a69c8362423045eeb50ec89dcd 100644 (file)
--- a/FAQ.xml
+++ b/FAQ.xml
@@ -1,3 +1,4 @@
+<?xml-stylesheet href="common.css" type="text/css"?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" []>
 <!--
@@ -17,7 +18,7 @@
  - PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- $Id: FAQ.xml,v 1.4.8.7 2007/01/31 23:54:15 marka Exp $ -->
+<!-- $Id: FAQ.xml,v 1.4.8.8 2007/02/05 05:24:11 marka Exp $ -->
 
 <article class="faq">
   <title>Frequently Asked Questions about BIND 9</title>
@@ -186,17 +187,17 @@ example.com. 86400 IN SOA ns hostmaster ( 1 3600 1800 1814400 3600 )</programlis
     <qandaentry>
       <question>
        <para>
-       How do I produce a usable core file from a multithreaded
+       How do I produce a usable core file from a multi-threaded
        named on Linux?
        </para>
       </question>
       <answer>
        <para>
-       If the Linux kernel is 2.4.7 or newer, multithreaded core
+       If the Linux kernel is 2.4.7 or newer, multi-threaded core
        dumps are usable (that is, the correct thread is dumped).
        Otherwise, if using a 2.2 kernel, apply the kernel patch
        found in contrib/linux/coredump-patch and rebuild the kernel.
-       This patch will cause multithreaded programs to dump the
+       This patch will cause multi-threaded programs to dump the
        correct thread.
        </para>
       </answer>
@@ -644,7 +645,7 @@ named-checkzone example.com tmp</programlisting>
        </informalexample>
        <para>
          A CNAME record cannot exist with the same name as another record
-         except for the DNSSEC records which prove its existance (NSEC).
+         except for the DNSSEC records which prove its existence (NSEC).
        </para>
        <para>
          RFC 1034, Section 3.6.2: <quote>If a CNAME RR is present at a node,
@@ -768,7 +769,7 @@ Master 10.0.1.1:
          contains leading white space (tab/space) but the is no
          current record owner name to inherit the name from.  Usually
          this is the result of putting white space before a comment.
-         Forgeting the "@" for the SOA record or indenting the master
+         Forgetting the "@" for the SOA record or indenting the master
          file.
        </para>
       </answer>
@@ -782,7 +783,7 @@ Master 10.0.1.1:
       </question>
       <answer>
        <para>
-         You are running chrooted (-t) and have not supplied local timzone
+         You are running chrooted (-t) and have not supplied local timezone
          information in the chroot area.
        </para>
        <simplelist>
@@ -945,7 +946,7 @@ zone "example.net" {
     <qandaentry>
       <question>
        <para>
-         How do I intergrate BIND 9 and Solaris SMF
+         How do I integrate BIND 9 and Solaris SMF
        </para>
       </question>
       <answer>
@@ -977,7 +978,7 @@ zone "example.net" {
          You would have to add both the CNAME and address records
          (A/AAAA) as glue to the parent zone and have CNAMEs be
          followed when doing additional section processing to make
-         it work.  No namesever implementation supports either of
+         it work.  No nameserver implementation supports either of
          these requirements.
        </para>
       </answer>
@@ -996,7 +997,7 @@ zone "example.net" {
          space you are using then you have failed to follow RFC 1918
          usage rules and are leaking queries to the Internet.  You
          should establish your own zones for these addresses to prevent
-         you quering the Internet's name servers for these addresses.
+         you querying the Internet's name servers for these addresses.
          Please see <ulink url="http://as112.net/">http://as112.net/</ulink>
          for details of the problems you are causing and the counter
          measures that have had to be deployed.
@@ -1073,7 +1074,7 @@ empty:
           SELinux security policy ( see http://www.nsa.gov/selinux
           ) and recommendations for BIND security , which are more
           secure than running named in a chroot and make use of
-          the bind-chroot environment unecessary .
+          the bind-chroot environment unnecessary .
        </para>
 
        <para>
@@ -1174,7 +1175,7 @@ named_cache_t: for files modifiable by named - $ROOTDIR/var/{tmp,named/{slaves,d
        </para>
 
        <para>
-         To create a custom configuration file location, eg.
+         To create a custom configuration file location, e.g.
          '/root/named.conf', to use with the 'named -c' option,
          do:
          <informalexample>
@@ -1185,7 +1186,7 @@ named_cache_t: for files modifiable by named - $ROOTDIR/var/{tmp,named/{slaves,d
        </para>
   
        <para>
-         To create a custom modifiable named data location, eg.
+         To create a custom modifiable named data location, e.g.
          '/var/log/named' for a log file, do:
          <informalexample>
            <programlisting>
@@ -1195,7 +1196,7 @@ named_cache_t: for files modifiable by named - $ROOTDIR/var/{tmp,named/{slaves,d
        </para>
    
        <para>
-   To create a custom zone file location, eg. /root/zones/, do:
+   To create a custom zone file location, e.g. /root/zones/, do:
          <informalexample>
            <programlisting>
 # chcon system_u:object_r:named_zone_t /root/zones/{.,*}
@@ -1264,11 +1265,11 @@ zone "list.dsbl.org" {
          a directory which has all the conversion rules for the
          world (e.g. /usr/share/zoneinfo).  When updating the OS
          do not forget to update any chroot areas as well.
-         See your OS's documetation for more details.
+         See your OS's documentation for more details.
        </para>
        <para>
          The local timezone conversion rules can also be done on
-         a individual basis by setting the TZ envirionment variable
+         a individual basis by setting the TZ environment variable
          appropriately.  See your OS's documentation for more
          details.
        </para>
@@ -1297,7 +1298,7 @@ zone "list.dsbl.org" {
        </para>
        <para>
           Later they decided to make BSD behaviour the default and
-          to aggressively trackdown application that used SO_BSDCOMPAT
+          to aggressively track down applications that used SO_BSDCOMPAT
           by issuing a warning.  This is the sort of things vendors
           do in alpha/beta stages of a release so that their code is
           clean.  They then turn the warning *off* for release code.
@@ -1320,5 +1321,37 @@ zone "list.dsbl.org" {
       </answer>
     </qandaentry>
 
+    <qandaentry>
+      <question>
+       <para>
+         Isn't "make install"  supposed to generate a default named.conf?
+       </para>
+      </question>
+      <answer>
+       <para>
+         Short Answer: No. 
+       </para>
+       <para>
+         Long Answer: There really isn't a default configuration which fits
+         any site perfectly.  There are lots of decisions that need to
+         be made and there is no consensus on what the defaults should be.
+         For example FreeBSD uses /etc/namedb as the location where the
+         configuration files for named are stored.  Others use /var/named.
+       </para>
+       <para>
+         What addresses to listen on?  For a laptop on the move a lot
+         you may only want to listen on the loop back interfaces.
+       </para>
+       <para>
+         Who do you offer recursive service to?  Is there are firewall
+         to consider?  If so is it stateless or stateful.  Are you
+         directly on the Internet?  Are you on a private network? Are
+         you on a NAT'd network? The answers
+         to all these questions change how you configure even a
+         caching name server.
+       </para>
+      </answer>
+    </qandaentry>
+
   </qandaset>
 </article>