Bv9ARM.ch03.html revision fafd1d771905532e8dc3efa2ce90ce4c9e74af61
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Nameserver Configuration</TITLE
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="GENERATOR"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsREL="PREVIOUS"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsTITLE="BIND Resource Requirements"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsTITLE="Advanced Concepts"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="chapter"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsBGCOLOR="#FFFFFF"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsTEXT="#000000"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsLINK="#0000FF"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVLINK="#840084"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALINK="#0000FF"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="NAVHEADER"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCELLPADDING="0"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCELLSPACING="0"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="center"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="bottom"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="center"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="bottom"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="right"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="bottom"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="chapter"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Chapter 3. Nameserver Configuration</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Table of Contents</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsHREF="Bv9ARM.ch03.html#sample_configuration"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Sample Configurations</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Load Balancing</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Nameserver Operations</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>In this section we provide some suggested configurations along
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewswith guidelines for their use. We also address the topic of reasonable
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsoption setting.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="sample_configuration"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.1. Sample Configurations</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN276"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.1.1. A Caching-only Nameserver</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>The following sample configuration is appropriate for a caching-only
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsname server for use by clients internal to a corporation. All queries
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsfrom outside clients are refused.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="programlisting"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> // Two corporate subnets we wish to allow queries from.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsacl "corpnets" { 192.168.4.0/24; 192.168.7.0/24; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews pid-file "named.pid"; // Put pid file in working dir
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews allow-query { "corpnets"; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// Root server hints
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewszone "." { type hint; file "root.hint"; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// Provide a reverse mapping for the loopback address 127.0.0.1
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews type master;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN280"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.1.2. An Authoritative-only Nameserver</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>This sample configuration is for an authoritative-only server
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsthat is the master server for "<TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsand a slave for the subdomain "<TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="programlisting"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> options {
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews pid-file "named.pid"; // Put pid file in working dir
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews allow-query { any; }; // This is the default
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews recursion no; // Do not provide recursive service
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// Root server hints
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewszone "." { type hint; file "root.hint"; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// Provide a reverse mapping for the loopback address 127.0.0.1
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews type master;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// We are the master server for example.com
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews type master;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews // IP addresses of slave servers allowed to transfer example.com
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews allow-transfer {
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews 192.168.4.14;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews 192.168.5.53;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews// We are a slave server for eng.example.com
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews // IP address of eng.example.com master server
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews masters { 192.168.4.12; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN286"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.2. Load Balancing</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Primitive load balancing can be achieved in <SPAN
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> using multiple
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsA records for one name.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>For example, if you have three WWW servers with network addresses
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof 10.0.0.1, 10.0.0.2 and 10.0.0.3, a set of records such as the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsfollowing means that clients will connect to each machine one third
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof the time:</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="informaltable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN291"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="CALSTABLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Resource Record (RR) Data</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>10.0.0.1</TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>10.0.0.2</TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>10.0.0.3</TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>When a resolver queries for these records, <SPAN
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> will rotate
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews them and respond to the query with the records in a different
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews order. In the example above, clients will randomly receive
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews records in the order 1, 2, 3; 2, 3, 1; and 3, 1, 2. Most clients
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews will use the first record returned and discard the rest.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>For more detail on ordering responses, check the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>rrset-order</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> substatement in the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement, see <A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsHREF="Bv9ARM.ch06.html#rrset_ordering"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>RRset Ordering</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>. This substatement is not supported in
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> 9, and only the ordering scheme described above is
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews available.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="notify"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.3. Notify</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> Notify is a mechanism that allows master nameservers to
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews notify their slave servers of changes to a zone's data. In
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews response to a <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> from a master server, the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews slave will check to see that its version of the zone is the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews current version and, if not, initiate a transfer.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Notify is fully documented in RFC 1996. See also the description
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews of the zone option <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>also-notify</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsHREF="Bv9ARM.ch06.html#zone_transfers"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Section 6.2.12.7</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>. For more information about
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsHREF="Bv9ARM.ch06.html#boolean_options"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Section 6.2.12.1</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect1"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN374"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.4. Nameserver Operations</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN376"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.4.1. Tools for Use With the Nameserver Daemon</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>There are several indispensable diagnostic, administrative
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsand monitoring tools available to the system administrator for controlling
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsand debugging the nameserver daemon. We describe several in this
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect3"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect3"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN379"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.4.1.1. Diagnostic Tools</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="variablelist"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>The domain information groper (<B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsa command line tool that can be used to gather information from
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsthe Domain Name System servers. Dig has two modes: simple interactive
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsmode for a single query, and batch mode which executes a query for
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewseach in a list of several query lines. All query options are accessible
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsfrom the command line.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>query-type</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>query-class</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>query-option</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>dig-option</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>The usual simple use of dig will take the form</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>dig @server domain query-type query-class</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>For more information and a list of available commands and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsoptions, see the <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> man page.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsprovides a simple <SPAN
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> lookup using a command-line interface for
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewslooking up Internet hostnames. By default, the utility converts
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsbetween host names and Internet addresses, but its functionality
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewscan be extended with the use of options.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> [-aCdlrTwv] [-c <TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>For more information and a list of available commands and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsoptions, see the <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> man page.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> is a program used to query Internet
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsdomain nameservers. <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> has two modes: interactive
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsand non-interactive. Interactive mode allows the user to query nameservers
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsfor information about various hosts and domains or to print a list
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof hosts in a domain. Non-interactive mode is used to print just
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsthe name and requested information for a host or domain.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> [-option...] [<TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>host-to-find</I
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> | - [server]]</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Interactive mode is entered when no arguments are given (the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsdefault nameserver will be used) or when the first argument is a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewshyphen (`-') and the second argument is the host name or Internet address
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof a nameserver.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Non-interactive mode is used when the name or Internet address
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof the host to be looked up is given as the first argument. The
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsoptional second argument specifies the host name or address of a nameserver.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Due to its arcane user interface and frequently inconsistent
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsbehavior, we do not recommend the use of <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> instead.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect3"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect3"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="admin_tools"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.4.1.2. Administrative Tools</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Administrative tools play an integral part in the management
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsof a server.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="variablelist"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>The remote name daemon control
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>) program allows the system
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews administrator to control the operation of a nameserver.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews If you run <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> without any options
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews it will display a usage message as follows:</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="replaceable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> is one of the following
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="informaltable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN483"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="CALSTABLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Display ps(1) status of named.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Dump database and cache to /var/tmp/named_dump.db.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Reload configuration file and zones.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Increment debugging level by one.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Set debugging level to 0.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Toggle query logging.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Stop the server.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Restart the server.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>As noted above, <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews only command available for <SPAN
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> 9.0.0. The other
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews commands, and more, are planned to be implemented for
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews future releases.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>A configuration file is required, since all
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews communication with the server is authenticated with
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews digital signatures that rely on a shared secret, and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews there is no way to provide that secret other than with a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews configuration file. The default location for the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> configuration file is
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>, but an alternate
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews location can be specified with the <TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="option"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>The format of the configuration file is similar to
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>, but limited to
1bb2f53b9f74a8ca9812cbe9243ef41190b4da14Evan Hunt only three statements, the <B
1bb2f53b9f74a8ca9812cbe9243ef41190b4da14Evan HuntCLASS="command"
1bb2f53b9f74a8ca9812cbe9243ef41190b4da14Evan Hunt>options{}</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews statements. These statements are what associate the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews secret keys to the servers with which they are meant to
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews be shared. The order of statements is not
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews significant.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>options{}</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement has two clauses: <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>default-server</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>default-key</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>default-server</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewshost name or address argument and represents the server that will
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsbe contacted if no <TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="option"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsoption is provided on the command line. <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>default-key</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsthe name of key as its argument, as defined by a <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews In the future a <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>default-port</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> clause will be
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsadded to specify the port to which <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement names a key with its
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsstring argument. The string is required by the server to be a valid
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsdomain name, though it need not actually be hierarchical; thus,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsa string like "<TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>" is a valid name.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement has two clauses: <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>algorithm</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews While the configuration parser will accept any string as the argument
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsto algorithm, currently only the string "<TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewshas any meaning. The secret is a base-64 encoded string, typically
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsgenerated with either <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>dnssec-keygen</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement uses the key clause
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsto associate a <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>-defined key with a server.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The argument to the <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> statement is a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewshost name or address (addresses must be double quoted). The argument
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsto the key clause is the name of the key as defined by the <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> clause will be added to a future release
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsto specify the port to which <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> should connect
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewson the given server.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>A sample minimal configuration file is as follows:</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="programlisting"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> key rndc_key {
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews algorithm "hmac-md5";
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews secret "c3Ryb25nIGVub3VnaCBmb3IgYSBtYW4gYnV0IG1hZGUgZm9yIGEgd29tYW4K";
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews default-server localhost;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews default-key rndc_key;
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>This file, if installed as <TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewswould allow the command:</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="prompt"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="userinput"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>rndc reload</B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>to connect to 127.0.0.1 port 953 and cause the nameserver
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsto reload, if a nameserver on the local machine were running with
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsfollowing controls statements:</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="programlisting"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> controls {
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews inet 127.0.0.1 allow { localhost; } keys { rndc_key; };
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>and it had an identical key statement for
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="literal"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>rndc_key</TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="sect2"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN600"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>3.4.2. Signals</A
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Certain UNIX signals cause the name server to take specific
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsactions, as described in the following table. These signals can
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsbe sent using the <B
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> command.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="informaltable"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsNAME="AEN604"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="CALSTABLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Causes the server to read <TT
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="filename"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrewsreload the database. </P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Causes the server to clean up and exit.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="command"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsVALIGN="MIDDLE"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Causes the server to clean up and exit.</P
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="NAVFOOTER"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCELLPADDING="0"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCELLSPACING="0"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="center"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="right"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsCLASS="acronym"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews> Resource Requirements</TD
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="center"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark AndrewsALIGN="right"
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews>Advanced Concepts</TD