- PERFORMANCE OF THIS SOFTWARE.
-->
-<!-- File: $Id: Bv9ARM-book.xml,v 1.241.18.58 2006/05/16 06:43:06 marka Exp $ -->
+<!-- File: $Id: Bv9ARM-book.xml,v 1.241.18.59 2006/05/17 01:33:29 marka Exp $ -->
<book xmlns:xi="http://www.w3.org/2001/XInclude">
<title>BIND 9 Administrator Reference Manual</title>
the TSIG extended error code set to BADTIME, and the time values
will be adjusted so that the response can be successfully
verified. In any of these cases, the message's rcode is set to
- NOTAUTH (not authoritative).
+ NOTAUTH (not authenticated).
</para>
</sect2>
special
property that it only produces output when the server's debug
level is
- nonzero. It normally writes to a file <filename>named.run</filename>
+ nonzero. It normally writes to a file called <filename>named.run</filename>
in the server's working directory.
</para>
If not specified, the default is <filename>named.stats</filename> in the
server's current directory. The format of the file is
described
- in <xref linkend="statsfile"/>
+ in <xref linkend="statsfile"/>.
</para>
</listitem>
</varlistentry>
<para>
See the description of
<command>provide-ixfr</command> in
- <xref linkend="server_statement_definition_and_usage"/>
+ <xref linkend="server_statement_definition_and_usage"/>.
</para>
</listitem>
</varlistentry>
<para>
See the description of
<command>request-ixfr</command> in
- <xref linkend="server_statement_definition_and_usage"/>
+ <xref linkend="server_statement_definition_and_usage"/>.
</para>
</listitem>
</varlistentry>
<para>
When returning authoritative negative responses to
SOA queries set the TTL of the SOA recored returned in
- the authority section to zero. Default yes.
+ the authority section to zero.
+ The default is <command>yes</command>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
When caching a negative response to a SOA query
- set the TTL to zero. Default no.
+ set the TTL to zero.
+ The default is <command>no</command>.
</para>
</listitem>
</varlistentry>
the DNSKEY RR to determine if this key should be
used to generate the RRSIG. This flag is ignored
if there are not DNSKEY RRs both with and without
- a KSK. Default yes.
+ a KSK.
+ The default is <command>yes</command>.
</para>
</listitem>
</varlistentry>
only supported by relatively new slave servers,
such as <acronym>BIND</acronym> 9, <acronym>BIND</acronym>
8.x and <acronym>BIND</acronym> 4.9.5 onwards.
- The <command>many-answers</command> format also supported by
+ The <command>many-answers</command> format is also supported by
recent Microsoft Windows nameservers.
The default is <command>many-answers</command>.
<command>transfer-format</command> may be overridden on a
uses the limit
that was in force when the server was started. See the description
of
- <command>size_spec</command> in <xref linkend="configuration_file_elements"/>.
+ <command> issize_spec</command> in <xref linkend="configuration_file_elements"/>.
</para>
<para>
<varlistentry>
<term><command>max-cache-ttl</command></term>
<listitem>
- <para><command>max-cache-ttl</command>
- sets the maximum time for which the server will
+ <para>
+ Sets the maximum time for which the server will
cache ordinary (positive) answers. The default is
one week (7 days).
</para>
</para>
<note>
<simpara>
- Not implemented in <acronym>BIND</acronym>9.
+ Not implemented in <acronym>BIND</acronym> 9.
</simpara>
</note>
</listitem>
<varlistentry>
<term><command>masterfile-format</command></term>
<listitem>
- <para><command>masterfile-format</command> specifies
+ <para>Specifies
the file format of zone files (see
<xref linkend="zonefile_format"/>).
The default value is <constant>text</constant>, which is the
<term><command>clients-per-query</command></term>
<term><command>max-clients-per-query</command></term>
<listitem>
- <para><command>clients-per-query</command>
- and <command>max-clients-per-query</command> set the
+ <para>These set the
initial value (minimum) and maximum number of recursive
simultanious clients for any given query
(<qname,qtype,qclass>) that the server will accept
<para>
If <command>max-clients-per-query</command> is set to zero
then there is no upper bound other than imposed by
- <command>recurive-clients</command>.
+ <command>recursive-clients</command>.
</para>
</listitem>
</varlistentry>
with type <command>TXT</command>, class <command>CHAOS</command>.
This defaults to the hostname of the machine hosting the
name server as
- found by gethostname(). The primary purpose of such queries
+ found by the gethostname() function. The primary purpose of such queries
is to
identify which of a group of anycast servers is actually
answering your queries. Specifying <command>hostname none;</command>
answering your queries. Specifying <command>server-id none;</command>
disables processing of the queries.
Specifying <command>server-id hostname;</command> will cause named to
- use the hostname as found by gethostname().
+ use the hostname as found by the gethostname() function.
The default <command>server-id</command> is <command>none</command>.
</para>
</listitem>
views of class IN. Disabled empty zones are only inherited
from options if there are no disabled empty zones specified
at the view level. To override the options list of disabled
- zones you can disable the root zone at the view level
- (disable-empty-zone ".";).
+ zones you can disable the root zone at the view level, for example:
+<programlisting>
+ disable-empty-zone ".";
+</programlisting>
</para>
<para>
If you are using the address ranges covered here you should
generated by <acronym>BIND</acronym> 8.
</para>
<para>
- The statistics dump begins with the line <command>+++ Statistics Dump
-+++ (973798949)</command>, where the number in parentheses is a standard
+ The statistics dump begins with a line, like:
+ </para>
+ <para>
+ <command>+++ Statistics Dump +++ (973798949)</command>
+ </para>
+ <para>
+ The number in parentheses is a standard
Unix-style timestamp, measured as seconds since January 1, 1970.
Following
that line are a series of lines containing a counter type, the
the entire server.
Lines with a zone and view name for the given view and zone (the
view name is
- omitted for the default view). The statistics dump ends
- with the line <command>--- Statistics Dump --- (973798949)</command>, where the
- number is identical to the number in the beginning line.
+ omitted for the default view).
+ </para>
+ <para>
+ The statistics dump ends with the line where the
+ number is identical to the number in the beginning line; for example:
+ </para>
+ <para>
+ <command>--- Statistics Dump --- (973798949)</command>
</para>
<para>
The following statistics counters are maintained:
<variablelist>
- <varlistentry>
- <term><command>journal</command></term>
- <listitem>
- <para>
- Allow the default journal's file name to be overridden.
- The default is the zone's file with "<filename>.jnl</filename>" appended.
- This is applicable to <command>master</command> and <command>slave</command> zones.
- </para>
- </listitem>
- </varlistentry>
-
<varlistentry>
<term><command>allow-notify</command></term>
<listitem>
<para>
See the description of
- <command>allow-notify</command> in <xref linkend="access_control"/>
+ <command>allow-notify</command> in <xref linkend="access_control"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>allow-query</command> in <xref linkend="access_control"/>
+ <command>allow-query</command> in <xref linkend="access_control"/>.
</para>
</listitem>
</varlistentry>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><command>journal</command></term>
+ <listitem>
+ <para>
+ Allow the default journal's file name to be overridden.
+ The default is the zone's file with "<filename>.jnl</filename>" appended.
+ This is applicable to <command>master</command> and <command>slave</command> zones.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><command>max-transfer-time-in</command></term>
<listitem>
<listitem>
<para>
See the description of
- <command>transfer-source</command> in <xref linkend="zone_transfers"/>
+ <command>transfer-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>transfer-source-v6</command> in <xref linkend="zone_transfers"/>
+ <command>transfer-source-v6</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>alt-transfer-source</command> in <xref linkend="zone_transfers"/>
+ <command>alt-transfer-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>alt-transfer-source-v6</command> in <xref linkend="zone_transfers"/>
+ <command>alt-transfer-source-v6</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>use-alt-transfer-source</command> in <xref linkend="zone_transfers"/>
+ <command>use-alt-transfer-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>notify-source</command> in <xref linkend="zone_transfers"/>
+ <command>notify-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
See the description of
- <command>key-directory</command> in <xref linkend="options"/>
+ <command>key-directory</command> in <xref linkend="options"/>.
</para>
</listitem>
</varlistentry>
<command>{</command> immediately following the
<command>$</command> as
<command>${offset[,width[,base]]}</command>.
- e.g. <command>${-20,3,d}</command> which
+ For example, <command>${-20,3,d}</command>
subtracts 20 from the current value, prints the
result as a decimal in a zero padded field of
- with 3.
+ width 3.
Available output forms are decimal
(<command>d</command>), octal
</para>
<para>
For compatibility with earlier versions <command>$$</command> is still
- recognized a indicating a literal $ in the output.
+ recognized as indicating a literal $ in the output.
</para>
</entry>
</row>
<para><command>ttl</command></para>
</entry>
<entry colname="2">
- <para><command>ttl</command>
- specifies the ttl of the generated records. If
+ <para>
+ Specifies the time-to-live of the generated records. If
not specified this will be inherited using the
normal ttl inheritance rules.
</para>
<para><command>class</command></para>
</entry>
<entry colname="2">
- <para><command>class</command>
- specifies the class of the generated records.
+ <para>
+ Specifies the class of the generated records.
This must match the zone class if it is
specified.
</para>
</entry>
<entry colname="2">
<para>
- rhs is a domain name. It is processed
+ A domain name. It is processed
similarly to lhs.
</para>
</entry>
0.0.0.0/8; 1.0.0.0/8; 2.0.0.0/8; 192.0.2.0/24; 224.0.0.0/3;
10.0.0.0/8; 172.16.0.0/12; 192.168.0.0/16;
};
+
// Set up an ACL called our-nets. Replace this with the real IP numbers.
acl our-nets { x.x.x.x/24; x.x.x.x/21; };
options {
blackhole { bogusnets; };
...
};
+
zone "example.com" {
type master;
file "m/example.com";
<title>The <command>chroot</command> Environment</title>
<para>
- In order for a <command>chroot()</command> environment
+ In order for a <command>chroot</command> environment
to
work properly in a particular directory
(for example, <filename>/var/named</filename>),
to set up things like
<filename>/dev/zero</filename>,
<filename>/dev/random</filename>,
- <filename>/dev/log</filename>, and/or
+ <filename>/dev/log</filename>, and
<filename>/etc/localtime</filename>.
</para>
</sect2>
under
a grant from the US Defense Advanced Research Projects
Administration
- (DARPA). Versions of <acronym>BIND</acronym> through
+ (DARPA).
+ </para>
+ <para>
+ Versions of <acronym>BIND</acronym> through
4.8.3 were maintained by the Computer
Systems Research Group (CSRG) at UC Berkeley. Douglas Terry, Mark
Painter, David Riggle and Songnian Zhou made up the initial <acronym>BIND</acronym>
</biblioentry>
<biblioentry>
<abbrev>RFC2671</abbrev>
- <title>Extension Mechanisms for DNS (EDNS0)</title>
<authorgroup>
<author>
<firstname>P.</firstname>
<surname>Vixie</surname>
</author>
</authorgroup>
+ <title>Extension Mechanisms for DNS (EDNS0)</title>
<pubdate>August 1997</pubdate>
</biblioentry>
<biblioentry>
<xi:include href="../../bin/check/named-checkconf.docbook"/>
<xi:include href="../../bin/check/named-checkzone.docbook"/>
<xi:include href="../../bin/named/named.docbook"/>
+ <!-- named.conf.docbook and others? -->
<!-- nsupdate gives db2latex indigestion, markup problems? -->
<xi:include href="../../bin/rndc/rndc.docbook"/>
<xi:include href="../../bin/rndc/rndc.conf.docbook"/>
projects / thirdparty / bind9.git / commitdiff
