man.named.html revision 8ec3c085233cedb22b05da36e2773c8f357a7e45
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - Copyright (C) 2004-2009 Internet Systems Consortium, Inc. ("ISC")
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - Copyright (C) 2000-2003 Internet Software Consortium.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - Permission to use, copy, modify, and/or distribute this software for any
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - purpose with or without fee is hereby granted, provided that the above
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - copyright notice and this permission notice appear in all copies.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy - PERFORMANCE OF THIS SOFTWARE.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<!-- $Id: man.named.html,v 1.139 2009/10/06 01:14:41 tbox Exp $ -->
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<link rel="prev" href="man.named-checkzone.html" title="named-checkzone">
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<link rel="next" href="man.nsupdate.html" title="nsupdate">
4b5c8e93cab28d3c65ba9d407fd8f46e3be1db1cMatthew Ahrens<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
4b5c8e93cab28d3c65ba9d407fd8f46e3be1db1cMatthew Ahrens<table width="100%" summary="Navigation header">
4b5c8e93cab28d3c65ba9d407fd8f46e3be1db1cMatthew Ahrens<tr><th colspan="3" align="center"><span class="application">named</span></th></tr>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<th width="60%" align="center">Manual pages</th>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<td width="20%" align="right">�<a accesskey="n" href="man.nsupdate.html">Next</a>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<a name="man.named"></a><div class="titlepage"></div>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<p><span class="application">named</span> — Internet domain name server</p>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<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>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<a name="id2612820"></a><h2>DESCRIPTION</h2>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<p><span><strong class="command">named</strong></span>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy is a Domain Name System (DNS) server,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy part of the BIND 9 distribution from ISC. For more
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy information on the DNS, see RFCs 1033, 1034, and 1035.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy When invoked without arguments, <span><strong class="command">named</strong></span>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy read the default configuration file
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy <code class="filename">/etc/named.conf</code>, read any initial
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy data, and listen for queries.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Use IPv4 only even if the host machine is capable of IPv6.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <code class="option">-4</code> and <code class="option">-6</code> are mutually
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Use IPv6 only even if the host machine is capable of IPv4.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <code class="option">-4</code> and <code class="option">-6</code> are mutually
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Use <em class="replaceable"><code>config-file</code></em> as the
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy configuration file instead of the default,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <code class="filename">/etc/named.conf</code>. To
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy ensure that reloading the configuration file continues
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy to work after the server has changed its working
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy directory due to to a possible
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <code class="option">directory</code> option in the configuration
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy file, <em class="replaceable"><code>config-file</code></em> should be
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy an absolute pathname.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Debugging traces from <span><strong class="command">named</strong></span> become
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy more verbose as the debug level increases.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Use a crypto hardware (OpenSSL engine) for the crypto operations
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy it supports, for instance re-signing with private keys from
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy a secure key store. When compiled with PKCS#11 support
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy <em class="replaceable"><code>engine-name</code></em>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy defaults to pkcs11, the empty name resets it to no engine.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Run the server in the foreground (i.e. do not daemonize).
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Run the server in the foreground and force all logging
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Turn on memory usage debugging flags. Possible flags are
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <em class="replaceable"><code>usage</code></em>,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <em class="replaceable"><code>trace</code></em>,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <em class="replaceable"><code>record</code></em>,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy <em class="replaceable"><code>size</code></em>, and
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <em class="replaceable"><code>mctx</code></em>.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy These correspond to the ISC_MEM_DEBUGXXXX flags described in
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <code class="filename"><isc/mem.h></code>.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt>
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Create <em class="replaceable"><code>#cpus</code></em> worker threads
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy to take advantage of multiple CPUs. If not specified,
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy <span><strong class="command">named</strong></span> will try to determine the
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy number of CPUs present and create one thread per CPU.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy If it is unable to determine the number of CPUs, a
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy single worker thread will be created.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy Listen for queries on port <em class="replaceable"><code>port</code></em>. If not
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy specified, the default is port 53.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy Write memory usage statistics to <code class="filename">stdout</code> on exit.