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