man.named.html revision 9a5087bf58f651bfff841192aba5afd06760d6ce
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - Copyright (C) 2000-2003 Internet Software Consortium.
bdd36cfdba3ff66d25570a9ff568d69e1eb543cfTimo Sirainen - Permission to use, copy, modify, and/or distribute this software for any
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - purpose with or without fee is hereby granted, provided that the above
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - copyright notice and this permission notice appear in all copies.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
9522aa5f33cc37fe8ccd0d647cc51dd3ba6a9b55Timo Sirainen - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen - PERFORMANCE OF THIS SOFTWARE.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
f158d9a303bb15a6848ca276c9391c7ca52e452bTimo Sirainen<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
f158d9a303bb15a6848ca276c9391c7ca52e452bTimo Sirainen<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<link rel="prev" href="man.named-checkzone.html" title="named-checkzone">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<link rel="next" href="man.named.conf.html" title="named.conf">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<table width="100%" summary="Navigation header">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<tr><th colspan="3" align="center"><span class="application">named</span></th></tr>
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td>
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<th width="60%" align="center">Manual pages</th>
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<td width="20%" align="right">�<a accesskey="n" href="man.named.conf.html">Next</a>
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<a name="man.named"></a><div class="titlepage"></div>
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<p><span class="application">named</span> — Internet domain name server</p>
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen<div class="cmdsynopsis"><p><code class="command">named</code> [<code class="option">-4</code>] [<code class="option">-6</code>] [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>] [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>] [<code class="option">-D <em class="replaceable"><code>string</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine-name</code></em></code>] [<code class="option">-f</code>] [<code class="option">-g</code>] [<code class="option">-L <em class="replaceable"><code>logfile</code></em></code>] [<code class="option">-M <em class="replaceable"><code>option</code></em></code>] [<code class="option">-m <em class="replaceable"><code>flag</code></em></code>] [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-s</code>] [<code class="option">-S <em class="replaceable"><code>#max-socks</code></em></code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-U <em class="replaceable"><code>#listeners</code></em></code>] [<code class="option">-u <em class="replaceable"><code>user</code></em></code>] [<code class="option">-v</code>] [<code class="option">-V</code>] [<code class="option">-X <em class="replaceable"><code>lock-file</code></em></code>] [<code class="option">-x <em class="replaceable"><code>cache-file</code></em></code>]</p></div>
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen<p><span><strong class="command">named</strong></span>
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen is a Domain Name System (DNS) server,
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen part of the BIND 9 distribution from ISC. For more
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen information on the DNS, see RFCs 1033, 1034, and 1035.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen When invoked without arguments, <span><strong class="command">named</strong></span>
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen read the default configuration file
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen <code class="filename">/etc/named.conf</code>, read any initial
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen data, and listen for queries.
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen Use IPv4 only even if the host machine is capable of IPv6.
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen <code class="option">-4</code> and <code class="option">-6</code> are mutually
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen Use IPv6 only even if the host machine is capable of IPv4.
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen <code class="option">-4</code> and <code class="option">-6</code> are mutually
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen Use <em class="replaceable"><code>config-file</code></em> as the
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen configuration file instead of the default,
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen <code class="filename">/etc/named.conf</code>. To
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen ensure that reloading the configuration file continues
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen to work after the server has changed its working
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen directory due to to a possible
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen <code class="option">directory</code> option in the configuration
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen file, <em class="replaceable"><code>config-file</code></em> should be
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen an absolute pathname.
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen Debugging traces from <span><strong class="command">named</strong></span> become
8b16d3b00f051401c97568697ccdbba48663759aTimo Sirainen more verbose as the debug level increases.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-D <em class="replaceable"><code>string</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Specifies a string that is used to identify a instance of
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <span><strong class="command">named</strong></span> in a process listing. The contents
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen of <em class="replaceable"><code>string</code></em> are
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen not examined.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen When applicable, specifies the hardware to use for
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen cryptographic operations, such as a secure key store used
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen When BIND is built with OpenSSL PKCS#11 support, this defaults
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen to the string "pkcs11", which identifies an OpenSSL engine
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen that can drive a cryptographic accelerator or hardware service
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen module. When BIND is built with native PKCS#11 cryptography
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen (--enable-native-pkcs11), it defaults to the path of the PKCS#11
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen provider library specified via "--with-pkcs11".
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Run the server in the foreground (i.e. do not daemonize).
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Run the server in the foreground and force all logging
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-L <em class="replaceable"><code>logfile</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Log to the file <code class="option">logfile</code> by default
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen instead of the system log.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-M <em class="replaceable"><code>option</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Sets the default memory context options. Currently
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen the only supported option is
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>external</code></em>,
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen which causes the internal memory manager to be bypassed
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen in favor of system-provided memory allocation functions.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Turn on memory usage debugging flags. Possible flags are
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>usage</code></em>,
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>trace</code></em>,
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>record</code></em>,
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>size</code></em>, and
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>mctx</code></em>.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen These correspond to the ISC_MEM_DEBUGXXXX flags described in
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen <code class="filename"><isc/mem.h></code>.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt>
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen Create <em class="replaceable"><code>#cpus</code></em> worker threads
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen to take advantage of multiple CPUs. If not specified,
8c2b4a45f17a5cb13bb01058ca37798cf48d91baTimo Sirainen <span><strong class="command">named</strong></span> will try to determine the
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen number of CPUs present and create one thread per CPU.
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen If it is unable to determine the number of CPUs, a
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen single worker thread will be created.
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen Listen for queries on port <em class="replaceable"><code>port</code></em>. If not
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen specified, the default is port 53.
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen Write memory usage statistics to <code class="filename">stdout</code> on exit.
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen This option is mainly of interest to BIND 9 developers
4fda77c9e9fc68feb292c4dacae1fac49dd08165Timo Sirainen and may be removed or changed in a future release.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen<dt><span class="term">-S <em class="replaceable"><code>#max-socks</code></em></span></dt>
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen Allow <span><strong class="command">named</strong></span> to use up to
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen <em class="replaceable"><code>#max-socks</code></em> sockets.
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen The default value is 4096 on systems built with default
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen configuration options, and 21000 on systems built with
ad404d294fedf792619aed432ed8de5174e9ce7cTimo Sirainen "configure --with-tuning=large".
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen This option should be unnecessary for the vast majority
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen The use of this option could even be harmful because the
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen specified value may exceed the limitation of the
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen underlying system API.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen It is therefore set only when the default configuration
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen causes exhaustion of file descriptors and the
009217abb57a24a4076092e8e4e165545747839eStephan Bosch operational environment is known to support the
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen specified number of sockets.
7a60e1dc9e93ef3f7c7fe1af6385a0bfa1e31bc3Timo Sirainen Note also that the actual maximum number is normally a little
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen fewer than the specified value because
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen <span><strong class="command">named</strong></span> reserves some file descriptors
009217abb57a24a4076092e8e4e165545747839eStephan Bosch for its internal use.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen to <em class="replaceable"><code>directory</code></em> after
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen processing the command line arguments, but before
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen reading the configuration file.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen This option should be used in conjunction with the
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen <code class="option">-u</code> option, as chrooting a process
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen running as root doesn't enhance security on most
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen systems; the way <code class="function">chroot(2)</code> is
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen defined allows a process with root privileges to
009217abb57a24a4076092e8e4e165545747839eStephan Bosch escape a chroot jail.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen<dt><span class="term">-U <em class="replaceable"><code>#listeners</code></em></span></dt>
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen Use <em class="replaceable"><code>#listeners</code></em>
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen worker threads to listen for incoming UDP packets on each
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen address. If not specified, <span><strong class="command">named</strong></span> will
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen calculate a default value based on the number of detected
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen CPUs: 1 for 1 CPU, 2 for 2-4 CPUs, and the number of
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen detected CPUs divided by 2 for values higher than 4.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen If <code class="option">-n</code> has been set to a higher value than
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen the number of detected CPUs, then <code class="option">-U</code> may
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen be increased as high as that value, but no higher.
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen<dt><span class="term">-u <em class="replaceable"><code>user</code></em></span></dt>
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen to <em class="replaceable"><code>user</code></em> after completing
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen privileged operations, such as creating sockets that
e4194f4703eeec32b432371ae30fc8f25ab720d8Timo Sirainen listen on privileged ports.
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
cf9d67e4a9bfee31cf3be05244555d51a3d1b9feTimo Sirainen On Linux, <span><strong class="command">named</strong></span> uses the kernel's
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen capability mechanism to drop all root privileges
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen except the ability to <code class="function">bind(2)</code> to
8ae72ad7d0c69e972cfa65d1e2ce4e3e9a8b765cTimo Sirainen privileged port and set process resource limits.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen Unfortunately, this means that the <code class="option">-u</code>
7a60e1dc9e93ef3f7c7fe1af6385a0bfa1e31bc3Timo Sirainen option only works when <span><strong class="command">named</strong></span> is
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen later, since previous kernels did not allow privileges
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen to be retained after <code class="function">setuid(2)</code>.
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen Report the version number and exit.
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen Report the version number and build options, and exit.
8ae72ad7d0c69e972cfa65d1e2ce4e3e9a8b765cTimo Sirainen<dt><span class="term">-X <em class="replaceable"><code>lock-file</code></em></span></dt>
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen Acquire a lock on the specified file at runtime; this
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen helps to prevent duplicate <span><strong class="command">named</strong></span> instances
cf9d67e4a9bfee31cf3be05244555d51a3d1b9feTimo Sirainen from running simultaneously.
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen Use of this option overrides the <span><strong class="command">lock-file</strong></span>
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen option in <code class="filename">named.conf</code>.
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen If set to <code class="literal">none</code>, the lock file check
09060303d565e15d54e42b4ef722f9d3c26f5336Timo Sirainen<dt><span class="term">-x <em class="replaceable"><code>cache-file</code></em></span></dt>
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen Load data from <em class="replaceable"><code>cache-file</code></em> into the
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen cache of the default view.
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
8ae72ad7d0c69e972cfa65d1e2ce4e3e9a8b765cTimo Sirainen This option must not be used. It is only of interest
87842f621233257b7a7945d994ba931508b34877Timo Sirainen to BIND 9 developers and may be removed or changed in a
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen future release.
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen In routine operation, signals should not be used to control
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen the nameserver; <span><strong class="command">rndc</strong></span> should be used
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen Force a reload of the server.
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen<dt><span class="term">SIGINT, SIGTERM</span></dt>
a4502a71879d6018bd2c64f13614bb619911dd9fTimo Sirainen Shut down the server.
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen The result of sending any other signals to the server is undefined.
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen The <span><strong class="command">named</strong></span> configuration file is too complex
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen to describe in detail here. A complete description is provided
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen <span><strong class="command">named</strong></span> inherits the <code class="function">umask</code>
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen (file creation mode mask) from the parent process. If files
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen created by <span><strong class="command">named</strong></span>, such as journal files,
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen need to have custom permissions, the <code class="function">umask</code>
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen should be set explicitly in the script used to start the
28789c7ce1aa66ab21798bfb73ec64308b9a4de8Timo Sirainen <span><strong class="command">named</strong></span> process.
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen<dt><span class="term"><code class="filename">/etc/named.conf</code></span></dt>
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen The default configuration file.
a5ddfd7a8b473f73135b93d5e081e470a87f0f7eTimo Sirainen<dt><span class="term"><code class="filename">/var/run/named/named.pid</code></span></dt>
3c3001681da75afc68578a180ec8f8b2d6dfacfaTimo Sirainen The default process-id file.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
cf9d67e4a9bfee31cf3be05244555d51a3d1b9feTimo Sirainen <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>,
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen <span class="citerefentry"><span class="refentrytitle">lwresd</span>(8)</span>,
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>,
0a53eb0283d7ec28c6105f61e118b96fce8ecb95Timo Sirainen <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
2670cd577aa57eb9f915a4f4220ae48c9b4fc5fbTimo Sirainen<p><span class="corpauthor">Internet Systems Consortium</span>
9ffd3c8ca82bd2af8ca4f7e167339820ddcf1fe3Timo Sirainen<table width="100%" summary="Navigation footer">
9ffd3c8ca82bd2af8ca4f7e167339820ddcf1fe3Timo Sirainen<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td>
0a53eb0283d7ec28c6105f61e118b96fce8ecb95Timo Sirainen<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
0a53eb0283d7ec28c6105f61e118b96fce8ecb95Timo Sirainen<td width="40%" align="right">�<a accesskey="n" href="man.named.conf.html">Next</a>
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen<span class="application">named-checkzone</span>�</td>
5e9bb72de1209cd39fdf3e95bdb26e047cc5594eTimo Sirainen<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
5e9bb72de1209cd39fdf3e95bdb26e047cc5594eTimo Sirainen<td width="40%" align="right" valign="top">�<code class="filename">named.conf</code>
5e9bb72de1209cd39fdf3e95bdb26e047cc5594eTimo Sirainen<p style="text-align: center;">BIND 9.11.0pre-alpha</p>