named.docbook revision 6ea2385360e9e2167e65f9286447da9eea189457
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder [<!ENTITY mdash "—">]>
2fbe4699ac5d2a8bafe8c0c8aa41e6717d36d5ceChristian Maeder - Copyright (C) 2004-2009, 2011, 2013, 2014 Internet Systems Consortium, Inc. ("ISC")
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder - Copyright (C) 2000, 2001, 2003 Internet Software Consortium.
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder - Permission to use, copy, modify, and/or distribute this software for any
395efaeb5bf61bc2bf355c1c029dffa09bc1d1edChristian Maeder - purpose with or without fee is hereby granted, provided that the above
b603f34b79bc0992e5d74f484e5bdc9f9c2346c6Christian Maeder - copyright notice and this permission notice appear in all copies.
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
341d00318de2d0ea9b6f0ab43f7e4d10ee4fb454Christian Maeder - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
341d00318de2d0ea9b6f0ab43f7e4d10ee4fb454Christian Maeder - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b603f34b79bc0992e5d74f484e5bdc9f9c2346c6Christian Maeder - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder - PERFORMANCE OF THIS SOFTWARE.
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder<!-- $Id: named.docbook,v 1.28 2011/11/09 23:46:23 tbox Exp $ -->
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <refentryinfo>
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder </refentryinfo>
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder <refentrytitle><application>named</application></refentrytitle>
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder <refname><application>named</application></refname>
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder <refpurpose>Internet domain name server</refpurpose>
a59f2017dfc311ece7afcea3e8a3ceceac77ba5aChristian Maeder </refnamediv>
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
0a907ffb1de8958ba48d229e5f5039141d4499ccChristian Maeder <holder>Internet Software Consortium.</holder>
0a907ffb1de8958ba48d229e5f5039141d4499ccChristian Maeder <refsynopsisdiv>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <cmdsynopsis>
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder <arg><option>-c <replaceable class="parameter">config-file</replaceable></option></arg>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <arg><option>-d <replaceable class="parameter">debug-level</replaceable></option></arg>
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder <arg><option>-D <replaceable class="parameter">string</replaceable></option></arg>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <arg><option>-E <replaceable class="parameter">engine-name</replaceable></option></arg>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <arg><option>-m <replaceable class="parameter">flag</replaceable></option></arg>
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder <arg><option>-n <replaceable class="parameter">#cpus</replaceable></option></arg>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <arg><option>-p <replaceable class="parameter">port</replaceable></option></arg>
395efaeb5bf61bc2bf355c1c029dffa09bc1d1edChristian Maeder <arg><option>-S <replaceable class="parameter">#max-socks</replaceable></option></arg>
749074bf849727439f584139415f6a985a8aa875Christian Maeder <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
32a2f5f00ff72c095b39629101043db4407974f9Christian Maeder <arg><option>-U <replaceable class="parameter">#listeners</replaceable></option></arg>
32a2f5f00ff72c095b39629101043db4407974f9Christian Maeder <arg><option>-u <replaceable class="parameter">user</replaceable></option></arg>
32a2f5f00ff72c095b39629101043db4407974f9Christian Maeder <arg><option>-x <replaceable class="parameter">cache-file</replaceable></option></arg>
32a2f5f00ff72c095b39629101043db4407974f9Christian Maeder </cmdsynopsis>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder </refsynopsisdiv>
eab576044505ba1fbc64610323053490fbd9e82cChristian Maeder is a Domain Name System (DNS) server,
32a2f5f00ff72c095b39629101043db4407974f9Christian Maeder part of the BIND 9 distribution from ISC. For more
b06572b54fcf9d6976cfff57da22672f996b4748Christian Maeder information on the DNS, see RFCs 1033, 1034, and 1035.
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder When invoked without arguments, <command>named</command>
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder read the default configuration file
f8a1ab8012a1f36060d6ce9b63399fa4a8a2981cChristian Maeder <filename>/etc/named.conf</filename>, read any initial
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder data, and listen for queries.
90b6ddcd41d089246d50ab17bc2e00cd8d57fb1eChristian Maeder <variablelist>
2fbe4699ac5d2a8bafe8c0c8aa41e6717d36d5ceChristian Maeder <varlistentry>
2fbe4699ac5d2a8bafe8c0c8aa41e6717d36d5ceChristian Maeder Use IPv4 only even if the host machine is capable of IPv6.
5581c4644d91dcb9b7e2e7f6052f7cbf5f97b6deChristian Maeder <option>-4</option> and <option>-6</option> are mutually
a5527685b1e16295384fe03b50f24f54f5859c6bChristian Maeder </varlistentry>
34b317241b7401a4b0a90472e73d769d64d69a2aChristian Maeder <varlistentry>
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder Use IPv6 only even if the host machine is capable of IPv4.
6f031207ab25d41ae4740a4151d5946faff4768bChristian Maeder <option>-4</option> and <option>-6</option> are mutually
5214cf3742dc626a7efc5ec851db09bf0ff1f579Christian Maeder </varlistentry>
0a320bc4cdbf38f480b75ac15a54db1c4885b497Christian Maeder <varlistentry>
946f62de1b188898dde0c472f2a8a6fb86f4d2f5Christian Maeder <term>-c <replaceable class="parameter">config-file</replaceable></term>
946f62de1b188898dde0c472f2a8a6fb86f4d2f5Christian Maeder Use <replaceable class="parameter">config-file</replaceable> as the
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder configuration file instead of the default,
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder ensure that reloading the configuration file continues
f85f722d95f8a5f928aa34b38894e9a4f60dfe84Christian Maeder to work after the server has changed its working
f85f722d95f8a5f928aa34b38894e9a4f60dfe84Christian Maeder directory due to to a possible
f85f722d95f8a5f928aa34b38894e9a4f60dfe84Christian Maeder <option>directory</option> option in the configuration
f85f722d95f8a5f928aa34b38894e9a4f60dfe84Christian Maeder file, <replaceable class="parameter">config-file</replaceable> should be
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder an absolute pathname.
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder </varlistentry>
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder <varlistentry>
f55c7ffbcd378316d8547132be02b10c5eb4dfb2Christian Maeder <term>-d <replaceable class="parameter">debug-level</replaceable></term>
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder Set the daemon's debug level to <replaceable class="parameter">debug-level</replaceable>.
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder Debugging traces from <command>named</command> become
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder more verbose as the debug level increases.
f55c7ffbcd378316d8547132be02b10c5eb4dfb2Christian Maeder </varlistentry>
e4f3c121d197ca18cd8f67deaabdddf7f6bdb7e9Christian Maeder <varlistentry>
e4f3c121d197ca18cd8f67deaabdddf7f6bdb7e9Christian Maeder <term>-D <replaceable class="parameter">string</replaceable></term>
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder Specifies a string that is used to identify a instance of
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder <command>named</command> in a process listing. The contents
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder of <replaceable class="parameter">string</replaceable> are
6cb518d88084543c13aa7e56db767c14ee97ab77Christian Maeder not examined.
1090553a9231ceb536cb8007219c08be0c8c313dChristian Maeder </varlistentry>
e4f3c121d197ca18cd8f67deaabdddf7f6bdb7e9Christian Maeder <varlistentry>
e4f3c121d197ca18cd8f67deaabdddf7f6bdb7e9Christian Maeder <term>-E <replaceable class="parameter">engine-name</replaceable></term>
f55c7ffbcd378316d8547132be02b10c5eb4dfb2Christian Maeder When applicable, specifies the hardware to use for
e13ee09381f136f5eadaabdb9699773c0052cf3dChristian Maeder cryptographic operations, such as a secure key store used
1090553a9231ceb536cb8007219c08be0c8c313dChristian Maeder When BIND is built with OpenSSL PKCS#11 support, this defaults
e13ee09381f136f5eadaabdb9699773c0052cf3dChristian Maeder to the string "pkcs11", which identifies an OpenSSL engine
e13ee09381f136f5eadaabdb9699773c0052cf3dChristian Maeder that can drive a cryptographic accelerator or hardware service
c4280f2006756af8b2c102e390e5c46c9c1a612fChristian Maeder module. When BIND is built with native PKCS#11 cryptography
e4f3c121d197ca18cd8f67deaabdddf7f6bdb7e9Christian Maeder (--enable-native-pkcs11), it defaults to the path of the PKCS#11
f454c20b6c126bea7d31d400cc8824b9ee8cc6eaChristian Maeder provider library specified via "--with-pkcs11".
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder </varlistentry>
d48085f765fca838c1d972d2123601997174583dChristian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Run the server in the foreground (i.e. do not daemonize).
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Run the server in the foreground and force all logging
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </varlistentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <varlistentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <term>-m <replaceable class="parameter">flag</replaceable></term>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder Turn on memory usage debugging flags. Possible flags are
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <replaceable class="parameter">usage</replaceable>,
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <replaceable class="parameter">trace</replaceable>,
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder <replaceable class="parameter">record</replaceable>,
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder <replaceable class="parameter">size</replaceable>, and
d48085f765fca838c1d972d2123601997174583dChristian Maeder <replaceable class="parameter">mctx</replaceable>.
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder These correspond to the ISC_MEM_DEBUGXXXX flags described in
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
7cc20c86207c658cba9369fe0afa5204868ab90fChristian Maeder <term>-n <replaceable class="parameter">#cpus</replaceable></term>
dd2ee1725c1ac8a919f62846a07ad7fee77fa610Christian Maeder Create <replaceable class="parameter">#cpus</replaceable> worker threads
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder to take advantage of multiple CPUs. If not specified,
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <command>named</command> will try to determine the
5a13581acc5a76d392c1dec01657bb3efd4dcf2dChristian Maeder number of CPUs present and create one thread per CPU.
5a13581acc5a76d392c1dec01657bb3efd4dcf2dChristian Maeder If it is unable to determine the number of CPUs, a
cf30d3de6f9d875af714651287352b46a66f376dChristian Maeder single worker thread will be created.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder <varlistentry>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder <term>-p <replaceable class="parameter">port</replaceable></term>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Listen for queries on port <replaceable class="parameter">port</replaceable>. If not
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder specified, the default is port 53.
5a13581acc5a76d392c1dec01657bb3efd4dcf2dChristian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
d48085f765fca838c1d972d2123601997174583dChristian Maeder Write memory usage statistics to <filename>stdout</filename> on exit.
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder This option is mainly of interest to BIND 9 developers
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder and may be removed or changed in a future release.
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder </varlistentry>
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder <varlistentry>
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder <term>-S <replaceable class="parameter">#max-socks</replaceable></term>
79eaeb6fdc2e2ba993a405b7ec4346df0f03af58Christian Maeder Allow <command>named</command> to use up to
d27877901128f04518461d25b96d2d93a13f01e4Christian Maeder <replaceable class="parameter">#max-socks</replaceable> sockets.
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder This option should be unnecessary for the vast majority
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder The use of this option could even be harmful because the
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder specified value may exceed the limitation of the
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder underlying system API.
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder It is therefore set only when the default configuration
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder causes exhaustion of file descriptors and the
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder operational environment is known to support the
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder specified number of sockets.
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder Note also that the actual maximum number is normally a little
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder fewer than the specified value because
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder <command>named</command> reserves some file descriptors
cdb141ee48c3a96e620186de94316c562037a2e0Christian Maeder for its internal use.
aca00d341fb4baec0fdd0dc05094618ba87be268Christian Maeder </varlistentry>
a39a820684c1974350f46593025e0bb279f41bc6Christian Maeder <varlistentry>
793945d4ac7c0f22760589c87af8e71427c76118Christian Maeder <term>-t <replaceable class="parameter">directory</replaceable></term>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder to <replaceable class="parameter">directory</replaceable> after
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder processing the command line arguments, but before
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder reading the configuration file.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder This option should be used in conjunction with the
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <option>-u</option> option, as chrooting a process
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder running as root doesn't enhance security on most
7cc20c86207c658cba9369fe0afa5204868ab90fChristian Maeder systems; the way <function>chroot(2)</function> is
7cc20c86207c658cba9369fe0afa5204868ab90fChristian Maeder defined allows a process with root privileges to
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder escape a chroot jail.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder <varlistentry>
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder <term>-U <replaceable class="parameter">#listeners</replaceable></term>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Use <replaceable class="parameter">#listeners</replaceable>
aca00d341fb4baec0fdd0dc05094618ba87be268Christian Maeder worker threads to listen for incoming UDP packets on each
aca00d341fb4baec0fdd0dc05094618ba87be268Christian Maeder address. If not specified, <command>named</command> will
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder use the number of detected CPUs. If <option>-n</option>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder has been set to a higher value than the number of CPUs,
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder then <option>-U</option> may be increased as high as that
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder value, but no higher.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <term>-u <replaceable class="parameter">user</replaceable></term>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder to <replaceable class="parameter">user</replaceable> after completing
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder privileged operations, such as creating sockets that
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder listen on privileged ports.
d50ea352472823a62196db3cf11fae2af6866ab6Christian Maeder On Linux, <command>named</command> uses the kernel's
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder capability mechanism to drop all root privileges
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder except the ability to <function>bind(2)</function> to
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder privileged port and set process resource limits.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Unfortunately, this means that the <option>-u</option>
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder option only works when <command>named</command> is
d645eac2b9bf2e1a458b25982051276232670f09Christian Maeder on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder later, since previous kernels did not allow privileges
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder to be retained after <function>setuid(2)</function>.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Report the version number and exit.
0a907ffb1de8958ba48d229e5f5039141d4499ccChristian Maeder </varlistentry>
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder <varlistentry>
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder Report the version number and build options, and exit.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <term>-x <replaceable class="parameter">cache-file</replaceable></term>
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder Load data from <replaceable class="parameter">cache-file</replaceable> into the
d645eac2b9bf2e1a458b25982051276232670f09Christian Maeder cache of the default view.
d1528af34f6b81fe99d0b7a01e1f733ee78f1750Christian Maeder This option must not be used. It is only of interest
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder to BIND 9 developers and may be removed or changed in a
19f89aecd7d4de32f84b79b4d7041efb8937d4e0Christian Maeder future release.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </varlistentry>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder </variablelist>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder In routine operation, signals should not be used to control
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder the nameserver; <command>rndc</command> should be used
d645eac2b9bf2e1a458b25982051276232670f09Christian Maeder <variablelist>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder Force a reload of the server.
68485f7bfab1b4c6f963ce6837cba5fb148ed625Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
2f2237571ed7885b0f1ccb2c17996e8922f3d12dChristian Maeder Shut down the server.
962036a37b92afb04ac0725cde9f20e599c04c5fChristian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder </variablelist>
c5405de80ca35c8ded23b93a1649602d6bb5aac5Christian Maeder The result of sending any other signals to the server is undefined.
90b6ddcd41d089246d50ab17bc2e00cd8d57fb1eChristian Maeder The <command>named</command> configuration file is too complex
90b6ddcd41d089246d50ab17bc2e00cd8d57fb1eChristian Maeder to describe in detail here. A complete description is provided
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <command>named</command> inherits the <function>umask</function>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder (file creation mode mask) from the parent process. If files
5a13581acc5a76d392c1dec01657bb3efd4dcf2dChristian Maeder created by <command>named</command>, such as journal files,
5a13581acc5a76d392c1dec01657bb3efd4dcf2dChristian Maeder need to have custom permissions, the <function>umask</function>
cf30d3de6f9d875af714651287352b46a66f376dChristian Maeder should be set explicitly in the script used to start the
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <variablelist>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <varlistentry>
962036a37b92afb04ac0725cde9f20e599c04c5fChristian Maeder <term><filename>/etc/named.conf</filename></term>
59a2f25e7d71b91b4eda6fa4da753473ad629619Christian Maeder The default configuration file.
59a2f25e7d71b91b4eda6fa4da753473ad629619Christian Maeder </varlistentry>
98b443335df9c77328edb9dbf3ed565535317249Christian Maeder <varlistentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <term><filename>/var/run/named/named.pid</filename></term>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder The default process-id file.
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </varlistentry>
47c41955ec7273be5a90285e0458f580e36cbc3fChristian Maeder </variablelist>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citerefentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <refentrytitle>named-checkconf</refentrytitle>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder </citerefentry>,
c5405de80ca35c8ded23b93a1649602d6bb5aac5Christian Maeder <citerefentry>
5dca8f36562463e6f691d4d50efe5716d5299801Christian Maeder <refentrytitle>named-checkzone</refentrytitle>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </citerefentry>,
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citerefentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </citerefentry>,
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citerefentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </citerefentry>,
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citerefentry>
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder </citerefentry>,
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
17889a13fbcd155040fa0323ffe82393d53051fcChristian Maeder <para><corpauthor>Internet Systems Consortium</corpauthor>