named.html revision 2eeb74d1cf5355dd98f6d507a10086e16bb08c4b
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User - Copyright (C) 2004-2009, 2011, 2013-2015 Internet Systems Consortium, Inc. ("ISC")
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2000, 2001, 2003 Internet Software Consortium.
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and/or distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 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<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="named">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="man.named"></a><div class="titlepage"></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein — Internet domain name server
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-D <em class="replaceable"><code>string</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-E <em class="replaceable"><code>engine-name</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-L <em class="replaceable"><code>logfile</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-M <em class="replaceable"><code>option</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-m <em class="replaceable"><code>flag</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-p <em class="replaceable"><code>port</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-S <em class="replaceable"><code>#max-socks</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein [<code class="option">-U <em class="replaceable"><code>#listeners</code></em></code>]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [<code class="option">-u <em class="replaceable"><code>user</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-X <em class="replaceable"><code>lock-file</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-x <em class="replaceable"><code>cache-file</code></em></code>]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="idp61065936"></a><h2>DESCRIPTION</h2>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <p><span class="command"><strong>named</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt is a Domain Name System (DNS) server,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User part of the BIND 9 distribution from ISC. For more
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt information on the DNS, see RFCs 1033, 1034, and 1035.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt When invoked without arguments, <span class="command"><strong>named</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt read the default configuration file
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <code class="filename">/etc/named.conf</code>, read any initial
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User data, and listen for queries.
2ba8603ca962450068fe45f04c5caf8219b0d5f1Tinderbox User Use IPv4 only even if the host machine is capable of IPv6.
2ba8603ca962450068fe45f04c5caf8219b0d5f1Tinderbox User <code class="option">-4</code> and <code class="option">-6</code> are mutually
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Use IPv6 only even if the host machine is capable of IPv4.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <code class="option">-4</code> and <code class="option">-6</code> are mutually
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use <em class="replaceable"><code>config-file</code></em> as the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt configuration file instead of the default,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <code class="filename">/etc/named.conf</code>. To
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt ensure that reloading the configuration file continues
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to work after the server has changed its working
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt directory due to to a possible
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <code class="option">directory</code> option in the configuration
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt file, <em class="replaceable"><code>config-file</code></em> should be
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User an absolute pathname.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Debugging traces from <span class="command"><strong>named</strong></span> become
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt more verbose as the debug level increases.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">-D <em class="replaceable"><code>string</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Specifies a string that is used to identify a instance of
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="command"><strong>named</strong></span> in a process listing. The contents
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt of <em class="replaceable"><code>string</code></em> are
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User not examined.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt When applicable, specifies the hardware to use for
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt cryptographic operations, such as a secure key store used
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt for signing.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt When BIND is built with OpenSSL PKCS#11 support, this defaults
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt to the string "pkcs11", which identifies an OpenSSL engine
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User that can drive a cryptographic accelerator or hardware service
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt module. When BIND is built with native PKCS#11 cryptography
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (--enable-native-pkcs11), it defaults to the path of the PKCS#11
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt provider library specified via "--with-pkcs11".
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Run the server in the foreground (i.e. do not daemonize).
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Run the server in the foreground and force all logging
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-L <em class="replaceable"><code>logfile</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Log to the file <code class="option">logfile</code> by default
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt instead of the system log.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-M <em class="replaceable"><code>option</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Sets the default memory context options. Currently
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt the only supported option is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <em class="replaceable"><code>external</code></em>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt which causes the internal memory manager to be bypassed
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt in favor of system-provided memory allocation functions.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Turn on memory usage debugging flags. Possible flags are
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <em class="replaceable"><code>record</code></em>,
58d970a2b48b9186ca79b1506c0c736dd7b5daebTinderbox User <em class="replaceable"><code>size</code></em>, and
4206bb139c83dae2a8b59b7782031ccd40439aaaTinderbox User <em class="replaceable"><code>mctx</code></em>.
4206bb139c83dae2a8b59b7782031ccd40439aaaTinderbox User These correspond to the ISC_MEM_DEBUGXXXX flags described in
4206bb139c83dae2a8b59b7782031ccd40439aaaTinderbox User <code class="filename"><isc/mem.h></code>.
4206bb139c83dae2a8b59b7782031ccd40439aaaTinderbox User<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt>
4206bb139c83dae2a8b59b7782031ccd40439aaaTinderbox User Create <em class="replaceable"><code>#cpus</code></em> worker threads
742cb92338832aeaf4d5abb81b27c5e13541ca99Tinderbox User to take advantage of multiple CPUs. If not specified,
58d970a2b48b9186ca79b1506c0c736dd7b5daebTinderbox User <span class="command"><strong>named</strong></span> will try to determine the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt number of CPUs present and create one thread per CPU.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User If it is unable to determine the number of CPUs, a
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User single worker thread will be created.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Listen for queries on port <em class="replaceable"><code>port</code></em>. If not
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt specified, the default is port 53.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Write memory usage statistics to <code class="filename">stdout</code> on exit.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This option is mainly of interest to BIND 9 developers
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User and may be removed or changed in a future release.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-S <em class="replaceable"><code>#max-socks</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Allow <span class="command"><strong>named</strong></span> to use up to
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <em class="replaceable"><code>#max-socks</code></em> sockets.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The default value is 4096 on systems built with default
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt configuration options, and 21000 on systems built with
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt "configure --with-tuning=large".
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This option should be unnecessary for the vast majority
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The use of this option could even be harmful because the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User specified value may exceed the limitation of the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt underlying system API.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt It is therefore set only when the default configuration
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt causes exhaustion of file descriptors and the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt operational environment is known to support the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt specified number of sockets.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Note also that the actual maximum number is normally a little
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt fewer than the specified value because
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="command"><strong>named</strong></span> reserves some file descriptors
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User for its internal use.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to <em class="replaceable"><code>directory</code></em> after
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt processing the command line arguments, but before
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt reading the configuration file.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This option should be used in conjunction with the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <code class="option">-u</code> option, as chrooting a process
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt running as root doesn't enhance security on most
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt systems; the way <code class="function">chroot(2)</code> is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt defined allows a process with root privileges to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User escape a chroot jail.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-U <em class="replaceable"><code>#listeners</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use <em class="replaceable"><code>#listeners</code></em>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt worker threads to listen for incoming UDP packets on each
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt address. If not specified, <span class="command"><strong>named</strong></span> will
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt calculate a default value based on the number of detected
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User CPUs: 1 for 1 CPU, and the number of detected CPUs
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt minus one for machines with more than 1 CPU. This cannot
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User be increased to a value higher than the number of CPUs.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt If <code class="option">-n</code> has been set to a higher value than
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User the number of detected CPUs, then <code class="option">-U</code> may
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User be increased as high as that value, but no higher.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt On Windows, the number of UDP listeners is hardwired to 1
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt and this option has no effect.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-u <em class="replaceable"><code>user</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to <em class="replaceable"><code>user</code></em> after completing
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt privileged operations, such as creating sockets that
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User listen on privileged ports.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt On Linux, <span class="command"><strong>named</strong></span> uses the kernel's
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt capability mechanism to drop all root privileges
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt except the ability to <code class="function">bind(2)</code> to
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt privileged port and set process resource limits.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Unfortunately, this means that the <code class="option">-u</code>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User option only works when <span class="command"><strong>named</strong></span> is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt later, since previous kernels did not allow privileges
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt to be retained after <code class="function">setuid(2)</code>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Report the version number and exit.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Report the version number and build options, and exit.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-X <em class="replaceable"><code>lock-file</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Acquire a lock on the specified file at runtime; this
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt helps to prevent duplicate <span class="command"><strong>named</strong></span> instances
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt from running simultaneously.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use of this option overrides the <span class="command"><strong>lock-file</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt option in <code class="filename">named.conf</code>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt If set to <code class="literal">none</code>, the lock file check
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt is disabled.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-x <em class="replaceable"><code>cache-file</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Load data from <em class="replaceable"><code>cache-file</code></em> into the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User cache of the default view.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This option must not be used. It is only of interest
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to BIND 9 developers and may be removed or changed in a
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User future release.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User In routine operation, signals should not be used to control
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt the nameserver; <span class="command"><strong>rndc</strong></span> should be used
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Force a reload of the server.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">SIGINT, SIGTERM</span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Shut down the server.
0226754d9e537fd56b690d5890cfe215a6c59f89Tinderbox User The result of sending any other signals to the server is undefined.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <div class="refsection" title="CONFIGURATION">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="idp61026384"></a><h2>CONFIGURATION</h2>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The <span class="command"><strong>named</strong></span> configuration file is too complex
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to describe in detail here. A complete description is provided
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span class="command"><strong>named</strong></span> inherits the <code class="function">umask</code>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (file creation mode mask) from the parent process. If files
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt created by <span class="command"><strong>named</strong></span>, such as journal files,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt need to have custom permissions, the <code class="function">umask</code>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt should be set explicitly in the script used to start the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span class="command"><strong>named</strong></span> process.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term"><code class="filename">/etc/named.conf</code></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The default configuration file.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term"><code class="filename">/var/run/named/named.pid</code></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt The default process-id file.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span class="refentrytitle">named-checkconf</span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span class="refentrytitle">named-checkzone</span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="refentrytitle">named.conf</span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <em class="citetitle">BIND 9 Administrator Reference Manual</em>.