man.named.html revision 1238b38c9f0ab563b762dc0fd00ac6c34c2b7295
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - Copyright (C) 2004-2010 Internet Systems Consortium, Inc. ("ISC")
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - Copyright (C) 2000-2003 Internet Software Consortium.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - Permission to use, copy, modify, and/or distribute this software for any
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - purpose with or without fee is hereby granted, provided that the above
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - copyright notice and this permission notice appear in all copies.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
222c232d357e358bf67bd0685b8331b71bb56f97JHKST - PERFORMANCE OF THIS SOFTWARE.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<!-- $Id: man.named.html,v 1.169 2010/06/26 01:14:18 tbox Exp $ -->
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<link rel="prev" href="man.named-checkzone.html" title="named-checkzone">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<link rel="next" href="man.named-journalprint.html" title="named-journalprint">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco<tr><th colspan="3" align="center"><span class="application">named</span></th></tr>
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td>
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco<td width="20%" align="right">�<a accesskey="n" href="man.named-journalprint.html">Next</a>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<p><span class="application">named</span> — Internet domain name server</p>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<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">-E <em class="replaceable"><code>engine-name</code></em></code>] [<code class="option">-f</code>] [<code class="option">-g</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>user</code></em></code>] [<code class="option">-v</code>] [<code class="option">-V</code>] [<code class="option">-x <em class="replaceable"><code>cache-file</code></em></code>]</p></div>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST is a Domain Name System (DNS) server,
222c232d357e358bf67bd0685b8331b71bb56f97JHKST part of the BIND 9 distribution from ISC. For more
222c232d357e358bf67bd0685b8331b71bb56f97JHKST information on the DNS, see RFCs 1033, 1034, and 1035.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST When invoked without arguments, <span><strong class="command">named</strong></span>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST read the default configuration file
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <code class="filename">/etc/named.conf</code>, read any initial
222c232d357e358bf67bd0685b8331b71bb56f97JHKST data, and listen for queries.
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco Use IPv4 only even if the host machine is capable of IPv6.
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco <code class="option">-4</code> and <code class="option">-6</code> are mutually
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Use IPv6 only even if the host machine is capable of IPv4.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <code class="option">-4</code> and <code class="option">-6</code> are mutually
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Use <em class="replaceable"><code>config-file</code></em> as the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST configuration file instead of the default,
222c232d357e358bf67bd0685b8331b71bb56f97JHKST ensure that reloading the configuration file continues
222c232d357e358bf67bd0685b8331b71bb56f97JHKST to work after the server has changed its working
222c232d357e358bf67bd0685b8331b71bb56f97JHKST directory due to to a possible
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <code class="option">directory</code> option in the configuration
222c232d357e358bf67bd0685b8331b71bb56f97JHKST file, <em class="replaceable"><code>config-file</code></em> should be
222c232d357e358bf67bd0685b8331b71bb56f97JHKST an absolute pathname.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco Debugging traces from <span><strong class="command">named</strong></span> become
222c232d357e358bf67bd0685b8331b71bb56f97JHKST more verbose as the debug level increases.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Use a crypto hardware (OpenSSL engine) for the crypto operations
222c232d357e358bf67bd0685b8331b71bb56f97JHKST it supports, for instance re-signing with private keys from
222c232d357e358bf67bd0685b8331b71bb56f97JHKST a secure key store. When compiled with PKCS#11 support
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco <em class="replaceable"><code>engine-name</code></em>
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco defaults to pkcs11, the empty name resets it to no engine.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Run the server in the foreground (i.e. do not daemonize).
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Run the server in the foreground and force all logging
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Turn on memory usage debugging flags. Possible flags are
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco <em class="replaceable"><code>usage</code></em>,
222c232d357e358bf67bd0685b8331b71bb56f97JHKST These correspond to the ISC_MEM_DEBUGXXXX flags described in
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Create <em class="replaceable"><code>#cpus</code></em> worker threads
222c232d357e358bf67bd0685b8331b71bb56f97JHKST to take advantage of multiple CPUs. If not specified,
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <span><strong class="command">named</strong></span> will try to determine the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST number of CPUs present and create one thread per CPU.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST If it is unable to determine the number of CPUs, a
222c232d357e358bf67bd0685b8331b71bb56f97JHKST single worker thread will be created.
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Listen for queries on port <em class="replaceable"><code>port</code></em>. If not
222c232d357e358bf67bd0685b8331b71bb56f97JHKST specified, the default is port 53.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Write memory usage statistics to <code class="filename">stdout</code> on exit.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST This option is mainly of interest to BIND 9 developers
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco and may be removed or changed in a future release.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-S <em class="replaceable"><code>#max-socks</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Allow <span><strong class="command">named</strong></span> to use up to
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <em class="replaceable"><code>#max-socks</code></em> sockets.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST This option should be unnecessary for the vast majority
222c232d357e358bf67bd0685b8331b71bb56f97JHKST The use of this option could even be harmful because the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST specified value may exceed the limitation of the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST underlying system API.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST It is therefore set only when the default configuration
222c232d357e358bf67bd0685b8331b71bb56f97JHKST causes exhaustion of file descriptors and the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST operational environment is known to support the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST specified number of sockets.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST Note also that the actual maximum number is normally a little
222c232d357e358bf67bd0685b8331b71bb56f97JHKST fewer than the specified value because
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <span><strong class="command">named</strong></span> reserves some file descriptors
222c232d357e358bf67bd0685b8331b71bb56f97JHKST for its internal use.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
222c232d357e358bf67bd0685b8331b71bb56f97JHKST to <em class="replaceable"><code>directory</code></em> after
222c232d357e358bf67bd0685b8331b71bb56f97JHKST processing the command line arguments, but before
bf4379bb564a2928917ad5dac2fc88c788cbcbb5Lubos Kosco reading the configuration file.
222c232d357e358bf67bd0685b8331b71bb56f97JHKST<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
222c232d357e358bf67bd0685b8331b71bb56f97JHKST This option should be used in conjunction with the
222c232d357e358bf67bd0685b8331b71bb56f97JHKST <code class="option">-u</code> option, as chrooting a process