named.html revision 6ea1b817e31b89a627e146fe69e23ea0a64c89ec
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont<!--
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater - Copyright (C) 2000, 2001 Internet Software Consortium.
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont -
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and distribute this software for any
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - purpose with or without fee is hereby granted, provided that the above
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - copyright notice and this permission notice appear in all copies.
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont -
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
0e9e255d1643375056aa9ed7fe2a279713ffae78Automatic Updater-->
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont<HTML
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><HEAD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><TITLE
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>named</TITLE
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><META
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontNAME="GENERATOR"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCONTENT="Modular DocBook HTML Stylesheet Version 1.63
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont"></HEAD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><BODY
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REFENTRY"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontBGCOLOR="#FFFFFF"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontTEXT="#000000"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontLINK="#0000FF"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontVLINK="#840084"
a3416b0a1b5482b6df32839445ca98c016945570Automatic UpdaterALINK="#0000FF"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><H1
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><A
a3416b0a1b5482b6df32839445ca98c016945570Automatic UpdaterNAME="AEN1"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><SPAN
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="APPLICATION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>named</SPAN
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></H1
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><DIV
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="REFNAMEDIV"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><A
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterNAME="AEN9"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><H2
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>Name</H2
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater><SPAN
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="APPLICATION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>named</SPAN
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>&nbsp;--&nbsp;Internet domain name server</DIV
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DIV
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REFSYNOPSISDIV"
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater><A
0e9e255d1643375056aa9ed7fe2a279713ffae78Automatic UpdaterNAME="AEN13"
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater></A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><H2
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater>Synopsis</H2
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater><P
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater><B
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic UpdaterCLASS="COMMAND"
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater>named</B
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater> [<TT
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic UpdaterCLASS="OPTION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-c <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>config-file</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>] [<TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="OPTION"
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater>-d <TT
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic UpdaterCLASS="REPLACEABLE"
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater><I
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater>debug-level</I
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater></TT
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater></TT
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater>] [<TT
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic UpdaterCLASS="OPTION"
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>-f</TT
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>] [<TT
64affc54f96a2c71cbd10ed71e246ce0746259aaAutomatic UpdaterCLASS="OPTION"
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>-g</TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>] [<TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="OPTION"
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater>-n <TT
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic UpdaterCLASS="REPLACEABLE"
2a6d4c9948b3f4f31311bd799d114585a30419a9Automatic Updater><I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>#cpus</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>] [<TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="OPTION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-p <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>port</I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>] [<TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="OPTION"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>-s</TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>] [<TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="OPTION"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>-t <TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="REPLACEABLE"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>directory</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>] [<TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="OPTION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-u <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>user</I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>] [<TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="OPTION"
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>-v</TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>] [<TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="OPTION"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-x <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>cache-file</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater></TT
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater>]</P
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater></DIV
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater><DIV
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REFSECT1"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontNAME="AEN45"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><H2
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>DESCRIPTION</H2
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> <B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="COMMAND"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>named</B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> is a Domain Name System (DNS) server,
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont part of the BIND 9 distribution from ISC. For more
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont information on the DNS, see RFCs 1033, 1034, and 1035.
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont </P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> When invoked without arguments, <B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="COMMAND"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>named</B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> will
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont read the default configuration file
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="FILENAME"
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater>/etc/named.conf</TT
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater>, read any initial
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater data, and listen for queries.
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater </P
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater></DIV
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater><DIV
a3416b0a1b5482b6df32839445ca98c016945570Automatic UpdaterCLASS="REFSECT1"
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater><A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontNAME="AEN52"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></A
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><H2
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater>OPTIONS</H2
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><P
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></P
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><DIV
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="VARIABLELIST"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><DL
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><DT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>-c <TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="REPLACEABLE"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>config-file</I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></DT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><DD
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><P
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater> Use <TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="REPLACEABLE"
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater><I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>config-file</I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater> as the
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater configuration file instead of the default,
5a24d24c8fba3480d707c0c902379ddb36501e12Automatic Updater <TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="FILENAME"
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>/etc/named.conf</TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>. To
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater ensure that reloading the configuration file continues
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater to work after the server has changed its working
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater directory due to to a possible
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater <TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="OPTION"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>directory</TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater> option in the configuration
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater file, <TT
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="REPLACEABLE"
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater><I
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>config-file</I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater> should be
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater an absolute pathname.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater </P
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater></DD
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater><DT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>-d <TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic UpdaterCLASS="REPLACEABLE"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater><I
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>debug-level</I
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> Set the daemon's debug level to <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>debug-level</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>.
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont Debugging traces from <B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="COMMAND"
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>named</B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> become
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont more verbose as the debug level increases.
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont </P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-f</DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> Run the server in the foreground (i.e. do not daemonize).
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont </P
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater></DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-g</DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> Run the server in the foreground and force all logging
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont to <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="FILENAME"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>stderr</TT
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater>.
c7d32c0b0ff4c01f0d4479af3410d3c06044d48aAutomatic Updater </P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></DD
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont>-n <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater>#cpus</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></DT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><DD
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater><P
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> Create <TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="REPLACEABLE"
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont><I
a3416b0a1b5482b6df32839445ca98c016945570Automatic Updater>#cpus</I
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont></TT
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont> worker threads
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont to take advantage of multiple CPUs. If not specified,
90f35c2f2a1c660f3b96eec413036d238df395f6Francis Dupont <B
90f35c2f2a1c660f3b96eec413036d238df395f6Francis DupontCLASS="COMMAND"
>named</B
> 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
>-p <TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
></DT
><DD
><P
> Listen for queries on port <TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
>. If not
specified, the default is port 53.
</P
></DD
><DT
>-s</DT
><DD
><P
> Write memory usage statistics to <TT
CLASS="FILENAME"
>stdout</TT
> on exit.
</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
> This option is mainly of interest to BIND 9 developers
and may be removed or changed in a future release.
</P
></BLOCKQUOTE
></DIV
></DD
><DT
>-t <TT
CLASS="REPLACEABLE"
><I
>directory</I
></TT
></DT
><DD
><P
> <TT
CLASS="FUNCTION"
>chroot()</TT
> to <TT
CLASS="REPLACEABLE"
><I
>directory</I
></TT
> after
processing the command line arguments, but before
reading the configuration file.
</P
><DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
BORDER="1"
WIDTH="90%"
><TR
><TD
ALIGN="CENTER"
><B
>Warning</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
> This option should be used in conjunction with the
<TT
CLASS="OPTION"
>-u</TT
> option, as chrooting a process
running as root doesn't enhance security on most
systems; the way <TT
CLASS="FUNCTION"
>chroot()</TT
> is
defined allows a process with root privileges to
escape a chroot jail.
</P
></TD
></TR
></TABLE
></DIV
></DD
><DT
>-u <TT
CLASS="REPLACEABLE"
><I
>user</I
></TT
></DT
><DD
><P
> <TT
CLASS="FUNCTION"
>setuid()</TT
> to <TT
CLASS="REPLACEABLE"
><I
>user</I
></TT
> after completing
privileged operations, such as creating sockets that
listen on privileged ports.
</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
> On Linux, <B
CLASS="COMMAND"
>named</B
> uses the kernel's
capability mechanism to drop all root privileges
except the ability to <TT
CLASS="FUNCTION"
>bind()</TT
> to a
privileged port and set process resource limits.
Unfortunately, this means that the <TT
CLASS="OPTION"
>-u</TT
>
option only works when <B
CLASS="COMMAND"
>named</B
> 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 <TT
CLASS="FUNCTION"
>setuid()</TT
>.
</P
></BLOCKQUOTE
></DIV
></DD
><DT
>-v</DT
><DD
><P
> Report the version number and exit.
</P
></DD
><DT
>-x <TT
CLASS="REPLACEABLE"
><I
>cache-file</I
></TT
></DT
><DD
><P
> Load data from <TT
CLASS="REPLACEABLE"
><I
>cache-file</I
></TT
> into the
cache of the default view.
</P
><DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
BORDER="1"
WIDTH="90%"
><TR
><TD
ALIGN="CENTER"
><B
>Warning</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><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
></TD
></TR
></TABLE
></DIV
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN137"
></A
><H2
>SIGNALS</H2
><P
> In routine operation, signals should not be used to control
the nameserver; <B
CLASS="COMMAND"
>rndc</B
> should be used
instead.
</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>SIGHUP</DT
><DD
><P
> Force a reload of the server.
</P
></DD
><DT
>SIGINT, SIGTERM</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="REFSECT1"
><A
NAME="AEN151"
></A
><H2
>CONFIGURATION</H2
><P
> The <B
CLASS="COMMAND"
>named</B
> configuration file is too complex
to describe in detail here. A complete description is
provided in the <I
CLASS="CITETITLE"
>BIND 9 Administrator Reference
Manual</I
>.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN156"
></A
><H2
>FILES</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="FILENAME"
>/etc/named.conf</TT
></DT
><DD
><P
> The default configuration file.
</P
></DD
><DT
><TT
CLASS="FILENAME"
>/var/run/named.pid</TT
></DT
><DD
><P
> The default process-id file.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN169"
></A
><H2
>SEE ALSO</H2
><P
> <I
CLASS="CITETITLE"
>RFC 1033</I
>,
<I
CLASS="CITETITLE"
>RFC 1034</I
>,
<I
CLASS="CITETITLE"
>RFC 1035</I
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>rndc</SPAN
>(8)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>lwresd</SPAN
>(8)</SPAN
>,
<I
CLASS="CITETITLE"
>BIND 9 Administrator Reference Manual</I
>.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN182"
></A
><H2
>AUTHOR</H2
><P
> Internet Software Consortium
</P
></DIV
></BODY
></HTML
>