man.named.html revision 0b89eee6167201843c9a46b7e7c63cb1e4e09ba3
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<!--
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC")
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra -
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra - This Source Code Form is subject to the terms of the Mozilla Public
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra - License, v. 2.0. If a copy of the MPL was not distributed with this
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra - file, You can obtain one at http://mozilla.org/MPL/2.0/.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra-->
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<html lang="en">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<head>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<title>named</title>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<link rel="prev" href="man.lwresd.html" title="lwresd">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<link rel="next" href="man.named.conf.html" title="named.conf">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra</head>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<div class="navheader">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<table width="100%" summary="Navigation header">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<tr><th colspan="3" align="center"><span class="application">named</span></th></tr>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<tr>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<td width="20%" align="left">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<a accesskey="p" href="man.lwresd.html">Prev</a>�</td>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<th width="60%" align="center">Manual pages</th>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<td width="20%" align="right">�<a accesskey="n" href="man.named.conf.html">Next</a>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra</td>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra</tr>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra</table>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<hr>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra</div>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<div class="refentry">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<a name="man.named"></a><div class="titlepage"></div>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="refnamediv">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<h2>Name</h2>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <span class="application">named</span>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra &#8212; Internet domain name server
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra</div>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="refsynopsisdiv">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<h2>Synopsis</h2>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="cmdsynopsis"><p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <code class="command">named</code>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra [<code class="option">-4</code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-6</code>]
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-D <em class="replaceable"><code>string</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-E <em class="replaceable"><code>engine-name</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-f</code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-g</code>]
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra [<code class="option">-L <em class="replaceable"><code>logfile</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-M <em class="replaceable"><code>option</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-m <em class="replaceable"><code>flag</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-p <em class="replaceable"><code>port</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-s</code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-S <em class="replaceable"><code>#max-socks</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-U <em class="replaceable"><code>#listeners</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-u <em class="replaceable"><code>user</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-v</code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-V</code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-X <em class="replaceable"><code>lock-file</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra [<code class="option">-x <em class="replaceable"><code>cache-file</code></em></code>]
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p></div>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </div>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="refsection">
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<a name="id-1.14.19.7"></a><h2>DESCRIPTION</h2>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <p><span class="command"><strong>named</strong></span>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra is a Domain Name System (DNS) server,
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra part of the BIND 9 distribution from ISC. For more
ff8b03787b79f0f9ab8c1a7fac736c5e47d02648Tilo Mitra information on the DNS, see RFCs 1033, 1034, and 1035.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra When invoked without arguments, <span class="command"><strong>named</strong></span>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra will
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra read the default configuration file
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <code class="filename">/etc/named.conf</code>, read any initial
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra data, and listen for queries.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </div>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="refsection">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<a name="id-1.14.19.8"></a><h2>OPTIONS</h2>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <div class="variablelist"><dl class="variablelist">
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-4</span></dt>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Use IPv4 only even if the host machine is capable of IPv6.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <code class="option">-4</code> and <code class="option">-6</code> are mutually
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra exclusive.
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<dt><span class="term">-6</span></dt>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<dd>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra Use IPv6 only even if the host machine is capable of IPv4.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <code class="option">-4</code> and <code class="option">-6</code> are mutually
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra exclusive.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<dd>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Use <em class="replaceable"><code>config-file</code></em> as the
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra configuration file instead of the default,
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <code class="filename">/etc/named.conf</code>. To
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra ensure that reloading the configuration file continues
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra to work after the server has changed its working
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra directory due to to a possible
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <code class="option">directory</code> option in the configuration
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra file, <em class="replaceable"><code>config-file</code></em> should be
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra an absolute pathname.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Debugging traces from <span class="command"><strong>named</strong></span> become
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra more verbose as the debug level increases.
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-D <em class="replaceable"><code>string</code></em></span></dt>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Specifies a string that is used to identify a instance of
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <span class="command"><strong>named</strong></span> in a process listing. The contents
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra of <em class="replaceable"><code>string</code></em> are
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra not examined.
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra When applicable, specifies the hardware to use for
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra cryptographic operations, such as a secure key store used
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra for signing.
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra <p>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra When BIND is built with OpenSSL PKCS#11 support, this defaults
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra to the string "pkcs11", which identifies an OpenSSL engine
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra that can drive a cryptographic accelerator or hardware service
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra module. When BIND is built with native PKCS#11 cryptography
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra (--enable-native-pkcs11), it defaults to the path of the PKCS#11
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra provider library specified via "--with-pkcs11".
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dt><span class="term">-f</span></dt>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra<dd>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra <p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra Run the server in the foreground (i.e. do not daemonize).
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra </p>
a31d4503481b752a9ea058cce3d9b025d040a87cTilo Mitra </dd>
1b94590fd02ca19669dfb4b5deb563a290459d81Tilo Mitra<dt><span class="term">-g</span></dt>
<dd>
<p>
Run the server in the foreground and force all logging
to <code class="filename">stderr</code>.
</p>
</dd>
<dt><span class="term">-L <em class="replaceable"><code>logfile</code></em></span></dt>
<dd>
<p>
Log to the file <code class="option">logfile</code> by default
instead of the system log.
</p>
</dd>
<dt><span class="term">-M <em class="replaceable"><code>option</code></em></span></dt>
<dd>
<p>
Sets the default memory context options. Currently
the only supported option is
<em class="replaceable"><code>external</code></em>,
which causes the internal memory manager to be bypassed
in favor of system-provided memory allocation functions.
</p>
</dd>
<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt>
<dd>
<p>
Turn on memory usage debugging flags. Possible flags are
<em class="replaceable"><code>usage</code></em>,
<em class="replaceable"><code>trace</code></em>,
<em class="replaceable"><code>record</code></em>,
<em class="replaceable"><code>size</code></em>, and
<em class="replaceable"><code>mctx</code></em>.
These correspond to the ISC_MEM_DEBUGXXXX flags described in
<code class="filename">&lt;isc/mem.h&gt;</code>.
</p>
</dd>
<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt>
<dd>
<p>
Create <em class="replaceable"><code>#cpus</code></em> worker threads
to take advantage of multiple CPUs. If not specified,
<span class="command"><strong>named</strong></span> will try to determine the
number of CPUs present and create one thread per CPU.
If it is unable to determine the number of CPUs, a
single worker thread will be created.
</p>
</dd>
<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
<dd>
<p>
Listen for queries on port <em class="replaceable"><code>port</code></em>. If not
specified, the default is port 53.
</p>
</dd>
<dt><span class="term">-s</span></dt>
<dd>
<p>
Write memory usage statistics to <code class="filename">stdout</code> on exit.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
This option is mainly of interest to BIND 9 developers
and may be removed or changed in a future release.
</p>
</div>
</dd>
<dt><span class="term">-S <em class="replaceable"><code>#max-socks</code></em></span></dt>
<dd>
<p>
Allow <span class="command"><strong>named</strong></span> to use up to
<em class="replaceable"><code>#max-socks</code></em> sockets.
The default value is 4096 on systems built with default
configuration options, and 21000 on systems built with
"configure --with-tuning=large".
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>
This option should be unnecessary for the vast majority
of users.
The use of this option could even be harmful because the
specified value may exceed the limitation of the
underlying system API.
It is therefore set only when the default configuration
causes exhaustion of file descriptors and the
operational environment is known to support the
specified number of sockets.
Note also that the actual maximum number is normally a little
fewer than the specified value because
<span class="command"><strong>named</strong></span> reserves some file descriptors
for its internal use.
</p>
</div>
</dd>
<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
<dd>
<p>Chroot
to <em class="replaceable"><code>directory</code></em> after
processing the command line arguments, but before
reading the configuration file.
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>
This option should be used in conjunction with the
<code class="option">-u</code> option, as chrooting a process
running as root doesn't enhance security on most
systems; the way <code class="function">chroot(2)</code> is
defined allows a process with root privileges to
escape a chroot jail.
</p>
</div>
</dd>
<dt><span class="term">-U <em class="replaceable"><code>#listeners</code></em></span></dt>
<dd>
<p>
Use <em class="replaceable"><code>#listeners</code></em>
worker threads to listen for incoming UDP packets on each
address. If not specified, <span class="command"><strong>named</strong></span> will
calculate a default value based on the number of detected
CPUs: 1 for 1 CPU, and the number of detected CPUs
minus one for machines with more than 1 CPU. This cannot
be increased to a value higher than the number of CPUs.
If <code class="option">-n</code> has been set to a higher value than
the number of detected CPUs, then <code class="option">-U</code> may
be increased as high as that value, but no higher.
On Windows, the number of UDP listeners is hardwired to 1
and this option has no effect.
</p>
</dd>
<dt><span class="term">-u <em class="replaceable"><code>user</code></em></span></dt>
<dd>
<p>Setuid
to <em class="replaceable"><code>user</code></em> after completing
privileged operations, such as creating sockets that
listen on privileged ports.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
On Linux, <span class="command"><strong>named</strong></span> uses the kernel's
capability mechanism to drop all root privileges
except the ability to <code class="function">bind(2)</code> to
a
privileged port and set process resource limits.
Unfortunately, this means that the <code class="option">-u</code>
option only works when <span class="command"><strong>named</strong></span> is
run
on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
later, since previous kernels did not allow privileges
to be retained after <code class="function">setuid(2)</code>.
</p>
</div>
</dd>
<dt><span class="term">-v</span></dt>
<dd>
<p>
Report the version number and exit.
</p>
</dd>
<dt><span class="term">-V</span></dt>
<dd>
<p>
Report the version number and build options, and exit.
</p>
</dd>
<dt><span class="term">-X <em class="replaceable"><code>lock-file</code></em></span></dt>
<dd>
<p>
Acquire a lock on the specified file at runtime; this
helps to prevent duplicate <span class="command"><strong>named</strong></span> instances
from running simultaneously.
Use of this option overrides the <span class="command"><strong>lock-file</strong></span>
option in <code class="filename">named.conf</code>.
If set to <code class="literal">none</code>, the lock file check
is disabled.
</p>
</dd>
<dt><span class="term">-x <em class="replaceable"><code>cache-file</code></em></span></dt>
<dd>
<p>
Load data from <em class="replaceable"><code>cache-file</code></em> into the
cache of the default view.
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>
This option must not be used. It is only of interest
to BIND 9 developers and may be removed or changed in a
future release.
</p>
</div>
</dd>
</dl></div>
</div>
<div class="refsection">
<a name="id-1.14.19.9"></a><h2>SIGNALS</h2>
<p>
In routine operation, signals should not be used to control
the nameserver; <span class="command"><strong>rndc</strong></span> should be used
instead.
</p>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term">SIGHUP</span></dt>
<dd>
<p>
Force a reload of the server.
</p>
</dd>
<dt><span class="term">SIGINT, SIGTERM</span></dt>
<dd>
<p>
Shut down the server.
</p>
</dd>
</dl></div>
<p>
The result of sending any other signals to the server is undefined.
</p>
</div>
<div class="refsection">
<a name="id-1.14.19.10"></a><h2>CONFIGURATION</h2>
<p>
The <span class="command"><strong>named</strong></span> configuration file is too complex
to describe in detail here. A complete description is provided
in the
<em class="citetitle">BIND 9 Administrator Reference Manual</em>.
</p>
<p>
<span class="command"><strong>named</strong></span> inherits the <code class="function">umask</code>
(file creation mode mask) from the parent process. If files
created by <span class="command"><strong>named</strong></span>, such as journal files,
need to have custom permissions, the <code class="function">umask</code>
should be set explicitly in the script used to start the
<span class="command"><strong>named</strong></span> process.
</p>
</div>
<div class="refsection">
<a name="id-1.14.19.11"></a><h2>FILES</h2>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="filename">/etc/named.conf</code></span></dt>
<dd>
<p>
The default configuration file.
</p>
</dd>
<dt><span class="term"><code class="filename">/var/run/named/named.pid</code></span></dt>
<dd>
<p>
The default process-id file.
</p>
</dd>
</dl></div>
</div>
<div class="refsection">
<a name="id-1.14.19.12"></a><h2>SEE ALSO</h2>
<p><em class="citetitle">RFC 1033</em>,
<em class="citetitle">RFC 1034</em>,
<em class="citetitle">RFC 1035</em>,
<span class="citerefentry">
<span class="refentrytitle">named-checkconf</span>
(8)
</span>,
<span class="citerefentry">
<span class="refentrytitle">named-checkzone</span>
(8)
</span>,
<span class="citerefentry">
<span class="refentrytitle">rndc</span>
(8)
</span>,
<span class="citerefentry">
<span class="refentrytitle">lwresd</span>
(8)
</span>,
<span class="citerefentry">
<span class="refentrytitle">named.conf</span>
(5)
</span>,
<em class="citetitle">BIND 9 Administrator Reference Manual</em>.
</p>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="man.lwresd.html">Prev</a>�</td>
<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
<td width="40%" align="right">�<a accesskey="n" href="man.named.conf.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">
<span class="application">lwresd</span>�</td>
<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
<td width="40%" align="right" valign="top">�<code class="filename">named.conf</code>
</td>
</tr>
</table>
</div>
<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.2</p>
</body>
</html>