1*00b67f09SDavid van Moolenbroek<!-- 2*00b67f09SDavid van Moolenbroek - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC") 3*00b67f09SDavid van Moolenbroek - Copyright (C) 2000-2003 Internet Software Consortium. 4*00b67f09SDavid van Moolenbroek - 5*00b67f09SDavid van Moolenbroek - Permission to use, copy, modify, and/or distribute this software for any 6*00b67f09SDavid van Moolenbroek - purpose with or without fee is hereby granted, provided that the above 7*00b67f09SDavid van Moolenbroek - copyright notice and this permission notice appear in all copies. 8*00b67f09SDavid van Moolenbroek - 9*00b67f09SDavid van Moolenbroek - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 10*00b67f09SDavid van Moolenbroek - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 11*00b67f09SDavid van Moolenbroek - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 12*00b67f09SDavid van Moolenbroek - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 13*00b67f09SDavid van Moolenbroek - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 14*00b67f09SDavid van Moolenbroek - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 15*00b67f09SDavid van Moolenbroek - PERFORMANCE OF THIS SOFTWARE. 16*00b67f09SDavid van Moolenbroek--> 17*00b67f09SDavid van Moolenbroek<!-- $Id: man.named.html,v 1.5 2015/09/03 07:33:34 christos Exp $ --> 18*00b67f09SDavid van Moolenbroek<html> 19*00b67f09SDavid van Moolenbroek<head> 20*00b67f09SDavid van Moolenbroek<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 21*00b67f09SDavid van Moolenbroek<title>named</title> 22*00b67f09SDavid van Moolenbroek<meta name="generator" content="DocBook XSL Stylesheets V1.71.1"> 23*00b67f09SDavid van Moolenbroek<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> 24*00b67f09SDavid van Moolenbroek<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages"> 25*00b67f09SDavid van Moolenbroek<link rel="prev" href="man.named-checkzone.html" title="named-checkzone"> 26*00b67f09SDavid van Moolenbroek<link rel="next" href="man.named-journalprint.html" title="named-journalprint"> 27*00b67f09SDavid van Moolenbroek</head> 28*00b67f09SDavid van Moolenbroek<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 29*00b67f09SDavid van Moolenbroek<div class="navheader"> 30*00b67f09SDavid van Moolenbroek<table width="100%" summary="Navigation header"> 31*00b67f09SDavid van Moolenbroek<tr><th colspan="3" align="center"><span class="application">named</span></th></tr> 32*00b67f09SDavid van Moolenbroek<tr> 33*00b67f09SDavid van Moolenbroek<td width="20%" align="left"> 34*00b67f09SDavid van Moolenbroek<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td> 35*00b67f09SDavid van Moolenbroek<th width="60%" align="center">Manual pages</th> 36*00b67f09SDavid van Moolenbroek<td width="20%" align="right">�<a accesskey="n" href="man.named-journalprint.html">Next</a> 37*00b67f09SDavid van Moolenbroek</td> 38*00b67f09SDavid van Moolenbroek</tr> 39*00b67f09SDavid van Moolenbroek</table> 40*00b67f09SDavid van Moolenbroek<hr> 41*00b67f09SDavid van Moolenbroek</div> 42*00b67f09SDavid van Moolenbroek<div class="refentry" lang="en"> 43*00b67f09SDavid van Moolenbroek<a name="man.named"></a><div class="titlepage"></div> 44*00b67f09SDavid van Moolenbroek<div class="refnamediv"> 45*00b67f09SDavid van Moolenbroek<h2>Name</h2> 46*00b67f09SDavid van Moolenbroek<p><span class="application">named</span> — Internet domain name server</p> 47*00b67f09SDavid van Moolenbroek</div> 48*00b67f09SDavid van Moolenbroek<div class="refsynopsisdiv"> 49*00b67f09SDavid van Moolenbroek<h2>Synopsis</h2> 50*00b67f09SDavid van Moolenbroek<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">-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>cache-file</code></em></code>]</p></div> 51*00b67f09SDavid van Moolenbroek</div> 52*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 53*00b67f09SDavid van Moolenbroek<a name="id2646772"></a><h2>DESCRIPTION</h2> 54*00b67f09SDavid van Moolenbroek<p><span><strong class="command">named</strong></span> 55*00b67f09SDavid van Moolenbroek is a Domain Name System (DNS) server, 56*00b67f09SDavid van Moolenbroek part of the BIND 9 distribution from ISC. For more 57*00b67f09SDavid van Moolenbroek information on the DNS, see RFCs 1033, 1034, and 1035. 58*00b67f09SDavid van Moolenbroek </p> 59*00b67f09SDavid van Moolenbroek<p> 60*00b67f09SDavid van Moolenbroek When invoked without arguments, <span><strong class="command">named</strong></span> 61*00b67f09SDavid van Moolenbroek will 62*00b67f09SDavid van Moolenbroek read the default configuration file 63*00b67f09SDavid van Moolenbroek <code class="filename">/etc/named.conf</code>, read any initial 64*00b67f09SDavid van Moolenbroek data, and listen for queries. 65*00b67f09SDavid van Moolenbroek </p> 66*00b67f09SDavid van Moolenbroek</div> 67*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 68*00b67f09SDavid van Moolenbroek<a name="id2646803"></a><h2>OPTIONS</h2> 69*00b67f09SDavid van Moolenbroek<div class="variablelist"><dl> 70*00b67f09SDavid van Moolenbroek<dt><span class="term">-4</span></dt> 71*00b67f09SDavid van Moolenbroek<dd><p> 72*00b67f09SDavid van Moolenbroek Use IPv4 only even if the host machine is capable of IPv6. 73*00b67f09SDavid van Moolenbroek <code class="option">-4</code> and <code class="option">-6</code> are mutually 74*00b67f09SDavid van Moolenbroek exclusive. 75*00b67f09SDavid van Moolenbroek </p></dd> 76*00b67f09SDavid van Moolenbroek<dt><span class="term">-6</span></dt> 77*00b67f09SDavid van Moolenbroek<dd><p> 78*00b67f09SDavid van Moolenbroek Use IPv6 only even if the host machine is capable of IPv4. 79*00b67f09SDavid van Moolenbroek <code class="option">-4</code> and <code class="option">-6</code> are mutually 80*00b67f09SDavid van Moolenbroek exclusive. 81*00b67f09SDavid van Moolenbroek </p></dd> 82*00b67f09SDavid van Moolenbroek<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt> 83*00b67f09SDavid van Moolenbroek<dd><p> 84*00b67f09SDavid van Moolenbroek Use <em class="replaceable"><code>config-file</code></em> as the 85*00b67f09SDavid van Moolenbroek configuration file instead of the default, 86*00b67f09SDavid van Moolenbroek <code class="filename">/etc/named.conf</code>. To 87*00b67f09SDavid van Moolenbroek ensure that reloading the configuration file continues 88*00b67f09SDavid van Moolenbroek to work after the server has changed its working 89*00b67f09SDavid van Moolenbroek directory due to to a possible 90*00b67f09SDavid van Moolenbroek <code class="option">directory</code> option in the configuration 91*00b67f09SDavid van Moolenbroek file, <em class="replaceable"><code>config-file</code></em> should be 92*00b67f09SDavid van Moolenbroek an absolute pathname. 93*00b67f09SDavid van Moolenbroek </p></dd> 94*00b67f09SDavid van Moolenbroek<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt> 95*00b67f09SDavid van Moolenbroek<dd><p> 96*00b67f09SDavid van Moolenbroek Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>. 97*00b67f09SDavid van Moolenbroek Debugging traces from <span><strong class="command">named</strong></span> become 98*00b67f09SDavid van Moolenbroek more verbose as the debug level increases. 99*00b67f09SDavid van Moolenbroek </p></dd> 100*00b67f09SDavid van Moolenbroek<dt><span class="term">-D <em class="replaceable"><code>string</code></em></span></dt> 101*00b67f09SDavid van Moolenbroek<dd><p> 102*00b67f09SDavid van Moolenbroek Specifies a string that is used to identify a instance of 103*00b67f09SDavid van Moolenbroek <span><strong class="command">named</strong></span> in a process listing. The contents 104*00b67f09SDavid van Moolenbroek of <em class="replaceable"><code>string</code></em> are 105*00b67f09SDavid van Moolenbroek not examined. 106*00b67f09SDavid van Moolenbroek </p></dd> 107*00b67f09SDavid van Moolenbroek<dt><span class="term">-E <em class="replaceable"><code>engine-name</code></em></span></dt> 108*00b67f09SDavid van Moolenbroek<dd> 109*00b67f09SDavid van Moolenbroek<p> 110*00b67f09SDavid van Moolenbroek When applicable, specifies the hardware to use for 111*00b67f09SDavid van Moolenbroek cryptographic operations, such as a secure key store used 112*00b67f09SDavid van Moolenbroek for signing. 113*00b67f09SDavid van Moolenbroek </p> 114*00b67f09SDavid van Moolenbroek<p> 115*00b67f09SDavid van Moolenbroek When BIND is built with OpenSSL PKCS#11 support, this defaults 116*00b67f09SDavid van Moolenbroek to the string "pkcs11", which identifies an OpenSSL engine 117*00b67f09SDavid van Moolenbroek that can drive a cryptographic accelerator or hardware service 118*00b67f09SDavid van Moolenbroek module. When BIND is built with native PKCS#11 cryptography 119*00b67f09SDavid van Moolenbroek (--enable-native-pkcs11), it defaults to the path of the PKCS#11 120*00b67f09SDavid van Moolenbroek provider library specified via "--with-pkcs11". 121*00b67f09SDavid van Moolenbroek </p> 122*00b67f09SDavid van Moolenbroek</dd> 123*00b67f09SDavid van Moolenbroek<dt><span class="term">-f</span></dt> 124*00b67f09SDavid van Moolenbroek<dd><p> 125*00b67f09SDavid van Moolenbroek Run the server in the foreground (i.e. do not daemonize). 126*00b67f09SDavid van Moolenbroek </p></dd> 127*00b67f09SDavid van Moolenbroek<dt><span class="term">-g</span></dt> 128*00b67f09SDavid van Moolenbroek<dd><p> 129*00b67f09SDavid van Moolenbroek Run the server in the foreground and force all logging 130*00b67f09SDavid van Moolenbroek to <code class="filename">stderr</code>. 131*00b67f09SDavid van Moolenbroek </p></dd> 132*00b67f09SDavid van Moolenbroek<dt><span class="term">-m <em class="replaceable"><code>flag</code></em></span></dt> 133*00b67f09SDavid van Moolenbroek<dd><p> 134*00b67f09SDavid van Moolenbroek Turn on memory usage debugging flags. Possible flags are 135*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>usage</code></em>, 136*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>trace</code></em>, 137*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>record</code></em>, 138*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>size</code></em>, and 139*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>mctx</code></em>. 140*00b67f09SDavid van Moolenbroek These correspond to the ISC_MEM_DEBUGXXXX flags described in 141*00b67f09SDavid van Moolenbroek <code class="filename"><isc/mem.h></code>. 142*00b67f09SDavid van Moolenbroek </p></dd> 143*00b67f09SDavid van Moolenbroek<dt><span class="term">-n <em class="replaceable"><code>#cpus</code></em></span></dt> 144*00b67f09SDavid van Moolenbroek<dd><p> 145*00b67f09SDavid van Moolenbroek Create <em class="replaceable"><code>#cpus</code></em> worker threads 146*00b67f09SDavid van Moolenbroek to take advantage of multiple CPUs. If not specified, 147*00b67f09SDavid van Moolenbroek <span><strong class="command">named</strong></span> will try to determine the 148*00b67f09SDavid van Moolenbroek number of CPUs present and create one thread per CPU. 149*00b67f09SDavid van Moolenbroek If it is unable to determine the number of CPUs, a 150*00b67f09SDavid van Moolenbroek single worker thread will be created. 151*00b67f09SDavid van Moolenbroek </p></dd> 152*00b67f09SDavid van Moolenbroek<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt> 153*00b67f09SDavid van Moolenbroek<dd><p> 154*00b67f09SDavid van Moolenbroek Listen for queries on port <em class="replaceable"><code>port</code></em>. If not 155*00b67f09SDavid van Moolenbroek specified, the default is port 53. 156*00b67f09SDavid van Moolenbroek </p></dd> 157*00b67f09SDavid van Moolenbroek<dt><span class="term">-s</span></dt> 158*00b67f09SDavid van Moolenbroek<dd> 159*00b67f09SDavid van Moolenbroek<p> 160*00b67f09SDavid van Moolenbroek Write memory usage statistics to <code class="filename">stdout</code> on exit. 161*00b67f09SDavid van Moolenbroek </p> 162*00b67f09SDavid van Moolenbroek<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 163*00b67f09SDavid van Moolenbroek<h3 class="title">Note</h3> 164*00b67f09SDavid van Moolenbroek<p> 165*00b67f09SDavid van Moolenbroek This option is mainly of interest to BIND 9 developers 166*00b67f09SDavid van Moolenbroek and may be removed or changed in a future release. 167*00b67f09SDavid van Moolenbroek </p> 168*00b67f09SDavid van Moolenbroek</div> 169*00b67f09SDavid van Moolenbroek</dd> 170*00b67f09SDavid van Moolenbroek<dt><span class="term">-S <em class="replaceable"><code>#max-socks</code></em></span></dt> 171*00b67f09SDavid van Moolenbroek<dd> 172*00b67f09SDavid van Moolenbroek<p> 173*00b67f09SDavid van Moolenbroek Allow <span><strong class="command">named</strong></span> to use up to 174*00b67f09SDavid van Moolenbroek <em class="replaceable"><code>#max-socks</code></em> sockets. 175*00b67f09SDavid van Moolenbroek The default value is 4096 on systems built with default 176*00b67f09SDavid van Moolenbroek configuration options, and 21000 on systems built with 177*00b67f09SDavid van Moolenbroek "configure --with-tuning=large". 178*00b67f09SDavid van Moolenbroek </p> 179*00b67f09SDavid van Moolenbroek<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> 180*00b67f09SDavid van Moolenbroek<h3 class="title">Warning</h3> 181*00b67f09SDavid van Moolenbroek<p> 182*00b67f09SDavid van Moolenbroek This option should be unnecessary for the vast majority 183*00b67f09SDavid van Moolenbroek of users. 184*00b67f09SDavid van Moolenbroek The use of this option could even be harmful because the 185*00b67f09SDavid van Moolenbroek specified value may exceed the limitation of the 186*00b67f09SDavid van Moolenbroek underlying system API. 187*00b67f09SDavid van Moolenbroek It is therefore set only when the default configuration 188*00b67f09SDavid van Moolenbroek causes exhaustion of file descriptors and the 189*00b67f09SDavid van Moolenbroek operational environment is known to support the 190*00b67f09SDavid van Moolenbroek specified number of sockets. 191*00b67f09SDavid van Moolenbroek Note also that the actual maximum number is normally a little 192*00b67f09SDavid van Moolenbroek fewer than the specified value because 193*00b67f09SDavid van Moolenbroek <span><strong class="command">named</strong></span> reserves some file descriptors 194*00b67f09SDavid van Moolenbroek for its internal use. 195*00b67f09SDavid van Moolenbroek </p> 196*00b67f09SDavid van Moolenbroek</div> 197*00b67f09SDavid van Moolenbroek</dd> 198*00b67f09SDavid van Moolenbroek<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt> 199*00b67f09SDavid van Moolenbroek<dd> 200*00b67f09SDavid van Moolenbroek<p>Chroot 201*00b67f09SDavid van Moolenbroek to <em class="replaceable"><code>directory</code></em> after 202*00b67f09SDavid van Moolenbroek processing the command line arguments, but before 203*00b67f09SDavid van Moolenbroek reading the configuration file. 204*00b67f09SDavid van Moolenbroek </p> 205*00b67f09SDavid van Moolenbroek<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> 206*00b67f09SDavid van Moolenbroek<h3 class="title">Warning</h3> 207*00b67f09SDavid van Moolenbroek<p> 208*00b67f09SDavid van Moolenbroek This option should be used in conjunction with the 209*00b67f09SDavid van Moolenbroek <code class="option">-u</code> option, as chrooting a process 210*00b67f09SDavid van Moolenbroek running as root doesn't enhance security on most 211*00b67f09SDavid van Moolenbroek systems; the way <code class="function">chroot(2)</code> is 212*00b67f09SDavid van Moolenbroek defined allows a process with root privileges to 213*00b67f09SDavid van Moolenbroek escape a chroot jail. 214*00b67f09SDavid van Moolenbroek </p> 215*00b67f09SDavid van Moolenbroek</div> 216*00b67f09SDavid van Moolenbroek</dd> 217*00b67f09SDavid van Moolenbroek<dt><span class="term">-U <em class="replaceable"><code>#listeners</code></em></span></dt> 218*00b67f09SDavid van Moolenbroek<dd><p> 219*00b67f09SDavid van Moolenbroek Use <em class="replaceable"><code>#listeners</code></em> 220*00b67f09SDavid van Moolenbroek worker threads to listen for incoming UDP packets on each 221*00b67f09SDavid van Moolenbroek address. If not specified, <span><strong class="command">named</strong></span> will 222*00b67f09SDavid van Moolenbroek calculate a default value based on the number of detected 223*00b67f09SDavid van Moolenbroek CPUs: 1 for 1 CPU, 2 for 2-4 CPUs, and the number of 224*00b67f09SDavid van Moolenbroek detected CPUs divided by 2 for values higher than 4. 225*00b67f09SDavid van Moolenbroek If <code class="option">-n</code> has been set to a higher value than 226*00b67f09SDavid van Moolenbroek the number of detected CPUs, then <code class="option">-U</code> may 227*00b67f09SDavid van Moolenbroek be increased as high as that value, but no higher. 228*00b67f09SDavid van Moolenbroek </p></dd> 229*00b67f09SDavid van Moolenbroek<dt><span class="term">-u <em class="replaceable"><code>user</code></em></span></dt> 230*00b67f09SDavid van Moolenbroek<dd> 231*00b67f09SDavid van Moolenbroek<p>Setuid 232*00b67f09SDavid van Moolenbroek to <em class="replaceable"><code>user</code></em> after completing 233*00b67f09SDavid van Moolenbroek privileged operations, such as creating sockets that 234*00b67f09SDavid van Moolenbroek listen on privileged ports. 235*00b67f09SDavid van Moolenbroek </p> 236*00b67f09SDavid van Moolenbroek<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 237*00b67f09SDavid van Moolenbroek<h3 class="title">Note</h3> 238*00b67f09SDavid van Moolenbroek<p> 239*00b67f09SDavid van Moolenbroek On Linux, <span><strong class="command">named</strong></span> uses the kernel's 240*00b67f09SDavid van Moolenbroek capability mechanism to drop all root privileges 241*00b67f09SDavid van Moolenbroek except the ability to <code class="function">bind(2)</code> to 242*00b67f09SDavid van Moolenbroek a 243*00b67f09SDavid van Moolenbroek privileged port and set process resource limits. 244*00b67f09SDavid van Moolenbroek Unfortunately, this means that the <code class="option">-u</code> 245*00b67f09SDavid van Moolenbroek option only works when <span><strong class="command">named</strong></span> is 246*00b67f09SDavid van Moolenbroek run 247*00b67f09SDavid van Moolenbroek on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or 248*00b67f09SDavid van Moolenbroek later, since previous kernels did not allow privileges 249*00b67f09SDavid van Moolenbroek to be retained after <code class="function">setuid(2)</code>. 250*00b67f09SDavid van Moolenbroek </p> 251*00b67f09SDavid van Moolenbroek</div> 252*00b67f09SDavid van Moolenbroek</dd> 253*00b67f09SDavid van Moolenbroek<dt><span class="term">-v</span></dt> 254*00b67f09SDavid van Moolenbroek<dd><p> 255*00b67f09SDavid van Moolenbroek Report the version number and exit. 256*00b67f09SDavid van Moolenbroek </p></dd> 257*00b67f09SDavid van Moolenbroek<dt><span class="term">-V</span></dt> 258*00b67f09SDavid van Moolenbroek<dd><p> 259*00b67f09SDavid van Moolenbroek Report the version number and build options, and exit. 260*00b67f09SDavid van Moolenbroek </p></dd> 261*00b67f09SDavid van Moolenbroek<dt><span class="term">-x <em class="replaceable"><code>cache-file</code></em></span></dt> 262*00b67f09SDavid van Moolenbroek<dd> 263*00b67f09SDavid van Moolenbroek<p> 264*00b67f09SDavid van Moolenbroek Load data from <em class="replaceable"><code>cache-file</code></em> into the 265*00b67f09SDavid van Moolenbroek cache of the default view. 266*00b67f09SDavid van Moolenbroek </p> 267*00b67f09SDavid van Moolenbroek<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> 268*00b67f09SDavid van Moolenbroek<h3 class="title">Warning</h3> 269*00b67f09SDavid van Moolenbroek<p> 270*00b67f09SDavid van Moolenbroek This option must not be used. It is only of interest 271*00b67f09SDavid van Moolenbroek to BIND 9 developers and may be removed or changed in a 272*00b67f09SDavid van Moolenbroek future release. 273*00b67f09SDavid van Moolenbroek </p> 274*00b67f09SDavid van Moolenbroek</div> 275*00b67f09SDavid van Moolenbroek</dd> 276*00b67f09SDavid van Moolenbroek</dl></div> 277*00b67f09SDavid van Moolenbroek</div> 278*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 279*00b67f09SDavid van Moolenbroek<a name="id2679367"></a><h2>SIGNALS</h2> 280*00b67f09SDavid van Moolenbroek<p> 281*00b67f09SDavid van Moolenbroek In routine operation, signals should not be used to control 282*00b67f09SDavid van Moolenbroek the nameserver; <span><strong class="command">rndc</strong></span> should be used 283*00b67f09SDavid van Moolenbroek instead. 284*00b67f09SDavid van Moolenbroek </p> 285*00b67f09SDavid van Moolenbroek<div class="variablelist"><dl> 286*00b67f09SDavid van Moolenbroek<dt><span class="term">SIGHUP</span></dt> 287*00b67f09SDavid van Moolenbroek<dd><p> 288*00b67f09SDavid van Moolenbroek Force a reload of the server. 289*00b67f09SDavid van Moolenbroek </p></dd> 290*00b67f09SDavid van Moolenbroek<dt><span class="term">SIGINT, SIGTERM</span></dt> 291*00b67f09SDavid van Moolenbroek<dd><p> 292*00b67f09SDavid van Moolenbroek Shut down the server. 293*00b67f09SDavid van Moolenbroek </p></dd> 294*00b67f09SDavid van Moolenbroek</dl></div> 295*00b67f09SDavid van Moolenbroek<p> 296*00b67f09SDavid van Moolenbroek The result of sending any other signals to the server is undefined. 297*00b67f09SDavid van Moolenbroek </p> 298*00b67f09SDavid van Moolenbroek</div> 299*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 300*00b67f09SDavid van Moolenbroek<a name="id2679417"></a><h2>CONFIGURATION</h2> 301*00b67f09SDavid van Moolenbroek<p> 302*00b67f09SDavid van Moolenbroek The <span><strong class="command">named</strong></span> configuration file is too complex 303*00b67f09SDavid van Moolenbroek to describe in detail here. A complete description is provided 304*00b67f09SDavid van Moolenbroek in the 305*00b67f09SDavid van Moolenbroek <em class="citetitle">BIND 9 Administrator Reference Manual</em>. 306*00b67f09SDavid van Moolenbroek </p> 307*00b67f09SDavid van Moolenbroek<p> 308*00b67f09SDavid van Moolenbroek <span><strong class="command">named</strong></span> inherits the <code class="function">umask</code> 309*00b67f09SDavid van Moolenbroek (file creation mode mask) from the parent process. If files 310*00b67f09SDavid van Moolenbroek created by <span><strong class="command">named</strong></span>, such as journal files, 311*00b67f09SDavid van Moolenbroek need to have custom permissions, the <code class="function">umask</code> 312*00b67f09SDavid van Moolenbroek should be set explicitly in the script used to start the 313*00b67f09SDavid van Moolenbroek <span><strong class="command">named</strong></span> process. 314*00b67f09SDavid van Moolenbroek </p> 315*00b67f09SDavid van Moolenbroek</div> 316*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 317*00b67f09SDavid van Moolenbroek<a name="id2679466"></a><h2>FILES</h2> 318*00b67f09SDavid van Moolenbroek<div class="variablelist"><dl> 319*00b67f09SDavid van Moolenbroek<dt><span class="term"><code class="filename">/etc/named.conf</code></span></dt> 320*00b67f09SDavid van Moolenbroek<dd><p> 321*00b67f09SDavid van Moolenbroek The default configuration file. 322*00b67f09SDavid van Moolenbroek </p></dd> 323*00b67f09SDavid van Moolenbroek<dt><span class="term"><code class="filename">/var/run/named/named.pid</code></span></dt> 324*00b67f09SDavid van Moolenbroek<dd><p> 325*00b67f09SDavid van Moolenbroek The default process-id file. 326*00b67f09SDavid van Moolenbroek </p></dd> 327*00b67f09SDavid van Moolenbroek</dl></div> 328*00b67f09SDavid van Moolenbroek</div> 329*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 330*00b67f09SDavid van Moolenbroek<a name="id2679510"></a><h2>SEE ALSO</h2> 331*00b67f09SDavid van Moolenbroek<p><em class="citetitle">RFC 1033</em>, 332*00b67f09SDavid van Moolenbroek <em class="citetitle">RFC 1034</em>, 333*00b67f09SDavid van Moolenbroek <em class="citetitle">RFC 1035</em>, 334*00b67f09SDavid van Moolenbroek <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>, 335*00b67f09SDavid van Moolenbroek <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>, 336*00b67f09SDavid van Moolenbroek <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>, 337*00b67f09SDavid van Moolenbroek <span class="citerefentry"><span class="refentrytitle">lwresd</span>(8)</span>, 338*00b67f09SDavid van Moolenbroek <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>, 339*00b67f09SDavid van Moolenbroek <em class="citetitle">BIND 9 Administrator Reference Manual</em>. 340*00b67f09SDavid van Moolenbroek </p> 341*00b67f09SDavid van Moolenbroek</div> 342*00b67f09SDavid van Moolenbroek<div class="refsect1" lang="en"> 343*00b67f09SDavid van Moolenbroek<a name="id2679580"></a><h2>AUTHOR</h2> 344*00b67f09SDavid van Moolenbroek<p><span class="corpauthor">Internet Systems Consortium</span> 345*00b67f09SDavid van Moolenbroek </p> 346*00b67f09SDavid van Moolenbroek</div> 347*00b67f09SDavid van Moolenbroek</div> 348*00b67f09SDavid van Moolenbroek<div class="navfooter"> 349*00b67f09SDavid van Moolenbroek<hr> 350*00b67f09SDavid van Moolenbroek<table width="100%" summary="Navigation footer"> 351*00b67f09SDavid van Moolenbroek<tr> 352*00b67f09SDavid van Moolenbroek<td width="40%" align="left"> 353*00b67f09SDavid van Moolenbroek<a accesskey="p" href="man.named-checkzone.html">Prev</a>�</td> 354*00b67f09SDavid van Moolenbroek<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td> 355*00b67f09SDavid van Moolenbroek<td width="40%" align="right">�<a accesskey="n" href="man.named-journalprint.html">Next</a> 356*00b67f09SDavid van Moolenbroek</td> 357*00b67f09SDavid van Moolenbroek</tr> 358*00b67f09SDavid van Moolenbroek<tr> 359*00b67f09SDavid van Moolenbroek<td width="40%" align="left" valign="top"> 360*00b67f09SDavid van Moolenbroek<span class="application">named-checkzone</span>�</td> 361*00b67f09SDavid van Moolenbroek<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td> 362*00b67f09SDavid van Moolenbroek<td width="40%" align="right" valign="top">�<span class="application">named-journalprint</span> 363*00b67f09SDavid van Moolenbroek</td> 364*00b67f09SDavid van Moolenbroek</tr> 365*00b67f09SDavid van Moolenbroek</table> 366*00b67f09SDavid van Moolenbroek</div> 367*00b67f09SDavid van Moolenbroek<p style="text-align: center;">BIND 9.10.2-P4</p> 368*00b67f09SDavid van Moolenbroek</body> 369*00b67f09SDavid van Moolenbroek</html> 370