named.docbook revision 1753d3c4d74241a847794f7e7cfd94cc79be6600
689023771c563d8660e45d439a207e06e96de28fMark Andrews<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
b05106c7e68077d805893fbae006fae125494fd6Automatic Updater "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein [<!ENTITY mdash "—">]>
689023771c563d8660e45d439a207e06e96de28fMark Andrews - Copyright (C) 2004-2009, 2011, 2013, 2014 Internet Systems Consortium, Inc. ("ISC")
689023771c563d8660e45d439a207e06e96de28fMark Andrews - Copyright (C) 2000, 2001, 2003 Internet Software Consortium.
689023771c563d8660e45d439a207e06e96de28fMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
689023771c563d8660e45d439a207e06e96de28fMark Andrews - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
689023771c563d8660e45d439a207e06e96de28fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
689023771c563d8660e45d439a207e06e96de28fMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
689023771c563d8660e45d439a207e06e96de28fMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
689023771c563d8660e45d439a207e06e96de28fMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentryinfo>
4abdfc917e6635a7c81d1f931a0c79227e72d025Mark Andrews </refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle><application>named</application></refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refname><application>named</application></refname>
b05106c7e68077d805893fbae006fae125494fd6Automatic Updater <refpurpose>Internet domain name server</refpurpose>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </copyright>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </copyright>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-c <replaceable class="parameter">config-file</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-d <replaceable class="parameter">debug-level</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-D <replaceable class="parameter">string</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-E <replaceable class="parameter">engine-name</replaceable></option></arg>
b05106c7e68077d805893fbae006fae125494fd6Automatic Updater <arg><option>-m <replaceable class="parameter">flag</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-n <replaceable class="parameter">#cpus</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-p <replaceable class="parameter">port</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-S <replaceable class="parameter">#max-socks</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-U <replaceable class="parameter">#listeners</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-u <replaceable class="parameter">user</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-x <replaceable class="parameter">cache-file</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is a Domain Name System (DNS) server,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein part of the BIND 9 distribution from ISC. For more
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein information on the DNS, see RFCs 1033, 1034, and 1035.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When invoked without arguments, <command>named</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein read the default configuration file
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <filename>/etc/named.conf</filename>, read any initial
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein data, and listen for queries.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use IPv4 only even if the host machine is capable of IPv6.
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater <option>-4</option> and <option>-6</option> are mutually
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater </varlistentry>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use IPv6 only even if the host machine is capable of IPv4.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <option>-4</option> and <option>-6</option> are mutually
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-c <replaceable class="parameter">config-file</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use <replaceable class="parameter">config-file</replaceable> as the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein configuration file instead of the default,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ensure that reloading the configuration file continues
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to work after the server has changed its working
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews directory due to to a possible
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews <option>directory</option> option in the configuration
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein file, <replaceable class="parameter">config-file</replaceable> should be
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein an absolute pathname.
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-d <replaceable class="parameter">debug-level</replaceable></term>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater Set the daemon's debug level to <replaceable class="parameter">debug-level</replaceable>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Debugging traces from <command>named</command> become
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein more verbose as the debug level increases.
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-D <replaceable class="parameter">string</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specifies a string that is used to identify a instance of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> in a process listing. The contents
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater of <replaceable class="parameter">string</replaceable> are
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein not examined.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-E <replaceable class="parameter">engine-name</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When applicable, specifies the hardware to use for
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein cryptographic operations, such as a secure key store used
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein for signing.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When BIND is built with OpenSSL PKCS#11 support, this defaults
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to the string "pkcs11", which identifies an OpenSSL engine
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein that can drive a cryptographic accelerator or hardware service
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein module. When BIND is built with native PKCS#11 cryptography
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (--enable-native-pkcs11), it defaults to the path of the PKCS#11
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein provider library specified via "--with-pkcs11".
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Run the server in the foreground (i.e. do not daemonize).
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Run the server in the foreground and force all logging
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-m <replaceable class="parameter">flag</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn on memory usage debugging flags. Possible flags are
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">usage</replaceable>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">trace</replaceable>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">record</replaceable>,
689023771c563d8660e45d439a207e06e96de28fMark Andrews <replaceable class="parameter">size</replaceable>, and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">mctx</replaceable>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein These correspond to the ISC_MEM_DEBUGXXXX flags described in
47012ae6dbf18a2503d7b33c1c9583dc38625cb7Mark Andrews </varlistentry>
89bc48260b64a8859ae717e9e5bae380e275fef4Mark Andrews <varlistentry>
89bc48260b64a8859ae717e9e5bae380e275fef4Mark Andrews <term>-n <replaceable class="parameter">#cpus</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Create <replaceable class="parameter">#cpus</replaceable> worker threads
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to take advantage of multiple CPUs. If not specified,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> will try to determine the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein number of CPUs present and create one thread per CPU.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If it is unable to determine the number of CPUs, a
276e28f813ffef042d5a6e9f3373ef4e2ad37996Mark Andrews single worker thread will be created.
538a83db7509d598da95a93bd7b74ef3112123a4Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews <term>-p <replaceable class="parameter">port</replaceable></term>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews Listen for queries on port <replaceable class="parameter">port</replaceable>. If not
22c71c7b86fa57a19f7df0da4222eb8593e6ad12Mark Andrews specified, the default is port 53.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews Write memory usage statistics to <filename>stdout</filename> on exit.
f051d76c87e055c6ea3879e0c97a76609df915ccMark Andrews This option is mainly of interest to BIND 9 developers
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and may be removed or changed in a future release.
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews </varlistentry>
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews <varlistentry>
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews <term>-S <replaceable class="parameter">#max-socks</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">#max-socks</replaceable> sockets.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default value is 4096 on systems built with default
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein configuration options, and 21000 on systems built with
68b30890ebd441a6a1ae3fdf71744d07d02cd030Mark Andrews "configure --with-tuning=large".
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option should be unnecessary for the vast majority
083a5588a3488b6335ee7bafa505d00644c7c58dMark Andrews The use of this option could even be harmful because the
8de0d8a6905e397ed0a26054815420685f9b435eAutomatic Updater specified value may exceed the limitation of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein underlying system API.
763a2f8ca55318aedb0dc0e5b1d35b53fe28c7d5Mark Andrews It is therefore set only when the default configuration
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein causes exhaustion of file descriptors and the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein operational environment is known to support the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified number of sockets.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Note also that the actual maximum number is normally a little
7526edc7677371c366232de5f39a678b7dcda747Mark Andrews fewer than the specified value because
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> reserves some file descriptors
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein for its internal use.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
689023771c563d8660e45d439a207e06e96de28fMark Andrews <varlistentry>
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>Chroot
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to <replaceable class="parameter">directory</replaceable> after
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein processing the command line arguments, but before
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein reading the configuration file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option should be used in conjunction with the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <option>-u</option> option, as chrooting a process
aeb7938001b22e811a910e1b36cdf452f9193865Automatic Updater running as root doesn't enhance security on most
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein systems; the way <function>chroot(2)</function> is
aeb7938001b22e811a910e1b36cdf452f9193865Automatic Updater defined allows a process with root privileges to
aeb7938001b22e811a910e1b36cdf452f9193865Automatic Updater escape a chroot jail.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-U <replaceable class="parameter">#listeners</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use <replaceable class="parameter">#listeners</replaceable>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein worker threads to listen for incoming UDP packets on each
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein address. If not specified, <command>named</command> will
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein calculate a default value based on the number of detected
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein CPUs: 1 for 1 CPU, 2 for 2-4 CPUs, and the number of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein detected CPUs divided by 2 for values higher than 4.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If <option>-n</option> has been set to a higher value than
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater the number of detected CPUs, then <option>-U</option> may
6bf6622b7b9053dc52527478473b572f042c4b5bMark Andrews be increased as high as that value, but no higher.
b05106c7e68077d805893fbae006fae125494fd6Automatic Updater </varlistentry>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater <varlistentry>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater <term>-u <replaceable class="parameter">user</replaceable></term>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater to <replaceable class="parameter">user</replaceable> after completing
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater privileged operations, such as creating sockets that
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater listen on privileged ports.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein On Linux, <command>named</command> uses the kernel's
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein capability mechanism to drop all root privileges
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein except the ability to <function>bind(2)</function> to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein privileged port and set process resource limits.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Unfortunately, this means that the <option>-u</option>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein option only works when <command>named</command> is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein later, since previous kernels did not allow privileges
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to be retained after <function>setuid(2)</function>.
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Report the version number and exit.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews <varlistentry>
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews Report the version number and build options, and exit.
689023771c563d8660e45d439a207e06e96de28fMark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
d060d8669f5558690e7faf4a1c12fe5c02a7c60dAutomatic Updater <term>-x <replaceable class="parameter">cache-file</replaceable></term>
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews Load data from <replaceable class="parameter">cache-file</replaceable> into the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein cache of the default view.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option must not be used. It is only of interest
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to BIND 9 developers and may be removed or changed in a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein future release.
689023771c563d8660e45d439a207e06e96de28fMark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
89bc48260b64a8859ae717e9e5bae380e275fef4Mark Andrews In routine operation, signals should not be used to control
89bc48260b64a8859ae717e9e5bae380e275fef4Mark Andrews the nameserver; <command>rndc</command> should be used
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
538a83db7509d598da95a93bd7b74ef3112123a4Mark Andrews Force a reload of the server.
3a3705ef7747327df182bf8d009333d2472253d5Mark Andrews </varlistentry>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Shut down the server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
689023771c563d8660e45d439a207e06e96de28fMark Andrews </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The result of sending any other signals to the server is undefined.
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews The <command>named</command> configuration file is too complex
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews to describe in detail here. A complete description is provided
1586d8cbac5d73031716561386f60758c6c332d5Mark Andrews <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> inherits the <function>umask</function>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (file creation mode mask) from the parent process. If files
68b30890ebd441a6a1ae3fdf71744d07d02cd030Mark Andrews created by <command>named</command>, such as journal files,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein need to have custom permissions, the <function>umask</function>
68b30890ebd441a6a1ae3fdf71744d07d02cd030Mark Andrews should be set explicitly in the script used to start the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
7526edc7677371c366232de5f39a678b7dcda747Mark Andrews <term><filename>/etc/named.conf</filename></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default configuration file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
689023771c563d8660e45d439a207e06e96de28fMark Andrews <varlistentry>
4f6469885c3d66367e3f8fb94e1f3c66115990b0Mark Andrews <term><filename>/var/run/named/named.pid</filename></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default process-id file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
6bf6622b7b9053dc52527478473b572f042c4b5bMark Andrews <citerefentry>
3b4098640dd85040270f39b9a5ee5e22de99d3d6Mark Andrews </citerefentry>,
b05106c7e68077d805893fbae006fae125494fd6Automatic Updater <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para><corpauthor>Internet Systems Consortium</corpauthor>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Local variables:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - mode: sgml