named.docbook revision 8e15d5eb3a000f1341e6bea0ddbc28d6dd2a0591
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews [<!ENTITY mdash "—">]>
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Copyright (C) 2004-2009, 2011, 2013 Internet Systems Consortium, Inc. ("ISC")
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (C) 2000, 2001, 2003 Internet Software Consortium.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Permission to use, copy, modify, and/or distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<!-- $Id: named.docbook,v 1.28 2011/11/09 23:46:23 tbox Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle><application>named</application></refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refname><application>named</application></refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refpurpose>Internet domain name server</refpurpose>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <cmdsynopsis>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-c <replaceable class="parameter">config-file</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-d <replaceable class="parameter">debug-level</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-D <replaceable class="parameter">string</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-E <replaceable class="parameter">engine-name</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-m <replaceable class="parameter">flag</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-n <replaceable class="parameter">#cpus</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-p <replaceable class="parameter">port</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-S <replaceable class="parameter">#max-socks</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg><option>-U <replaceable class="parameter">#listeners</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-u <replaceable class="parameter">user</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-x <replaceable class="parameter">cache-file</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsynopsisdiv>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater is a Domain Name System (DNS) server,
727f5b8846457a33d06f515a10a7e1aa849ddf18Andreas Gustafsson part of the BIND 9 distribution from ISC. For more
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce information on the DNS, see RFCs 1033, 1034, and 1035.
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce When invoked without arguments, <command>named</command>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce read the default configuration file
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <filename>/etc/named.conf</filename>, read any initial
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce data, and listen for queries.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use IPv4 only even if the host machine is capable of IPv6.
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater <option>-4</option> and <option>-6</option> are mutually
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater </varlistentry>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater <varlistentry>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater Use IPv6 only even if the host machine is capable of IPv4.
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater <option>-4</option> and <option>-6</option> are mutually
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce </varlistentry>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <varlistentry>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <term>-c <replaceable class="parameter">config-file</replaceable></term>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater Use <replaceable class="parameter">config-file</replaceable> as the
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater configuration file instead of the default,
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce ensure that reloading the configuration file continues
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce to work after the server has changed its working
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce directory due to to a possible
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <option>directory</option> option in the configuration
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce file, <replaceable class="parameter">config-file</replaceable> should be
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce an absolute pathname.
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce </varlistentry>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-d <replaceable class="parameter">debug-level</replaceable></term>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Set the daemon's debug level to <replaceable class="parameter">debug-level</replaceable>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Debugging traces from <command>named</command> become
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User more verbose as the debug level increases.
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <term>-D <replaceable class="parameter">string</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specifies a string that is used to identify a instance of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> in a process listing. The contents
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein of <replaceable class="parameter">string</replaceable> are
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User not examined.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <term>-E <replaceable class="parameter">engine-name</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use a crypto hardware (OpenSSL engine) for the crypto operations
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein it supports, for instance re-signing with private keys from
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein a secure key store. When compiled with PKCS#11 support
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">engine-name</replaceable>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein defaults to pkcs11, the empty name resets it to no engine.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Run the server in the foreground (i.e. do not daemonize).
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Run the server in the foreground and force all logging
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-m <replaceable class="parameter">flag</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Turn on memory usage debugging flags. Possible flags are
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">usage</replaceable>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">trace</replaceable>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">record</replaceable>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">size</replaceable>, and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">mctx</replaceable>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein These correspond to the ISC_MEM_DEBUGXXXX flags described in
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-n <replaceable class="parameter">#cpus</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Create <replaceable class="parameter">#cpus</replaceable> worker threads
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to take advantage of multiple CPUs. If not specified,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> will try to determine the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein number of CPUs present and create one thread per CPU.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If it is unable to determine the number of CPUs, a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein single worker thread will be created.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-p <replaceable class="parameter">port</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Listen for queries on port <replaceable class="parameter">port</replaceable>. If not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified, the default is port 53.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Write memory usage statistics to <filename>stdout</filename> on exit.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option is mainly of interest to BIND 9 developers
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and may be removed or changed in a future release.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-S <replaceable class="parameter">#max-socks</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <replaceable class="parameter">#max-socks</replaceable> sockets.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option should be unnecessary for the vast majority
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The use of this option could even be harmful because the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified value may exceed the limitation of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein underlying system API.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein It is therefore set only when the default configuration
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein causes exhaustion of file descriptors and the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein operational environment is known to support the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified number of sockets.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Note also that the actual maximum number is normally a little
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein fewer than the specified value because
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named</command> reserves some file descriptors
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein for its internal use.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-t <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to <replaceable class="parameter">directory</replaceable> after
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt processing the command line arguments, but before
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt reading the configuration file.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User This option should be used in conjunction with the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <option>-u</option> option, as chrooting a process
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User running as root doesn't enhance security on most
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User systems; the way <function>chroot(2)</function> is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein defined allows a process with root privileges to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User escape a chroot jail.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <term>-U <replaceable class="parameter">#listeners</replaceable></term>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Use <replaceable class="parameter">#listeners</replaceable>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt worker threads to listen for incoming UDP packets on each
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt address. If not specified, <command>named</command> will
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein use the number of detected CPUs. If <option>-n</option>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein has been set to a higher value than the number of CPUs,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein then <option>-U</option> may be increased as high as that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein value, but no higher.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-u <replaceable class="parameter">user</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>Setuid
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to <replaceable class="parameter">user</replaceable> after completing
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein privileged operations, such as creating sockets that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein listen on privileged ports.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User On Linux, <command>named</command> uses the kernel's
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt capability mechanism to drop all root privileges
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein except the ability to <function>bind(2)</function> to
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt privileged port and set process resource limits.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Unfortunately, this means that the <option>-u</option>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User option only works when <command>named</command> is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt on kernel 2.2.18 or later, or kernel 2.3.99-pre3 or
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein later, since previous kernels did not allow privileges
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to be retained after <function>setuid(2)</function>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Report the version number and exit.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Report the version number and build options, and exit.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-x <replaceable class="parameter">cache-file</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Load data from <replaceable class="parameter">cache-file</replaceable> into the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein cache of the default view.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option must not be used. It is only of interest
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to BIND 9 developers and may be removed or changed in a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein future release.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein In routine operation, signals should not be used to control
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt the nameserver; <command>rndc</command> should be used
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <variablelist>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Force a reload of the server.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Shut down the server.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The result of sending any other signals to the server is undefined.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The <command>named</command> configuration file is too complex
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt to describe in detail here. A complete description is provided
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <command>named</command> inherits the <function>umask</function>
7208386cd37a2092c70eddf80cf29519b16c4c80Mark Andrews (file creation mode mask) from the parent process. If files
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt created by <command>named</command>, such as journal files,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein need to have custom permissions, the <function>umask</function>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein should be set explicitly in the script used to start the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <variablelist>
bea931e17b7567f09107f93ab7e25c7f00abeb9cMark Andrews <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default configuration file.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <term><filename>/var/run/named/named.pid</filename></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default process-id file.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </citerefentry>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para><corpauthor>Internet Systems Consortium</corpauthor>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Local variables:
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - mode: sgml