]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
white space
authorMark Andrews <marka@isc.org>
Thu, 15 May 2014 04:30:12 +0000 (14:30 +1000)
committerMark Andrews <marka@isc.org>
Thu, 15 May 2014 04:30:12 +0000 (14:30 +1000)
bin/dig/dig.docbook

index b0c5546351a2758df754e6986dbf64b3a62ece8d..7c8971bf7d232e6b8e7254010118bdb2883c6d0b 100644 (file)
@@ -1,5 +1,5 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-               "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+              "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
               [<!ENTITY mdash "&#8212;">]>
 <!--
  - Copyright (C) 2004-2011, 2013, 2014  Internet Systems Consortium, Inc. ("ISC")
 
       <variablelist>
 
-        <varlistentry>
-          <term><constant>server</constant></term>
-          <listitem>
-            <para>
-              is the name or IP address of the name server to query.  This
-              can be an IPv4 address in dotted-decimal notation or an IPv6
-              address in colon-delimited notation.  When the supplied
-              <parameter>server</parameter> argument is a hostname,
-              <command>dig</command> resolves that name before querying
-              that name server.
-            </para>
-            <para>
-              If no <parameter>server</parameter> argument is
-              provided, <command>dig</command> consults
-              <filename>/etc/resolv.conf</filename>; if an
-              address is found there, it queries the name server at
-              that address. If either of the <option>-4</option> or
-              <option>-6</option> options are in use, then
-              only addresses for the corresponding transport
-              will be tried.  If no usable addresses are found,
-              <command>dig</command> will send the query to the
-              local host.  The reply from the name server that
-              responds is displayed.
-            </para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><constant>name</constant></term>
-          <listitem>
-            <para>
-              is the name of the resource record that is to be looked up.
-            </para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><constant>type</constant></term>
-          <listitem>
-            <para>
-              indicates what type of query is required &mdash;
-              ANY, A, MX, SIG, etc.
-              <parameter>type</parameter> can be any valid query
-              type.  If no
-              <parameter>type</parameter> argument is supplied,
-              <command>dig</command> will perform a lookup for an
-              A record.
-            </para>
-          </listitem>
-        </varlistentry>
+       <varlistentry>
+         <term><constant>server</constant></term>
+         <listitem>
+           <para>
+             is the name or IP address of the name server to query.  This
+             can be an IPv4 address in dotted-decimal notation or an IPv6
+             address in colon-delimited notation.  When the supplied
+             <parameter>server</parameter> argument is a hostname,
+             <command>dig</command> resolves that name before querying
+             that name server.
+           </para>
+           <para>
+             If no <parameter>server</parameter> argument is
+             provided, <command>dig</command> consults
+             <filename>/etc/resolv.conf</filename>; if an
+             address is found there, it queries the name server at
+             that address. If either of the <option>-4</option> or
+             <option>-6</option> options are in use, then
+             only addresses for the corresponding transport
+             will be tried.  If no usable addresses are found,
+             <command>dig</command> will send the query to the
+             local host.  The reply from the name server that
+             responds is displayed.
+           </para>
+         </listitem>
+       </varlistentry>
+
+       <varlistentry>
+         <term><constant>name</constant></term>
+         <listitem>
+           <para>
+             is the name of the resource record that is to be looked up.
+           </para>
+         </listitem>
+       </varlistentry>
+
+       <varlistentry>
+         <term><constant>type</constant></term>
+         <listitem>
+           <para>
+             indicates what type of query is required &mdash;
+             ANY, A, MX, SIG, etc.
+             <parameter>type</parameter> can be any valid query
+             type.  If no
+             <parameter>type</parameter> argument is supplied,
+             <command>dig</command> will perform a lookup for an
+             A record.
+           </para>
+         </listitem>
+       </varlistentry>
 
       </variablelist>
     </para>
     <para>
       The <option>-m</option> option enables memory usage debugging.
       <!-- It enables ISC_MEM_DEBUGTRACE and ISC_MEM_DEBUGRECORD
-           documented in include/isc/mem.h -->
+          documented in include/isc/mem.h -->
     </para>
 
     <para>
       base-64
       encoded string, typically generated by
       <citerefentry>
-        <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
+       <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>.
 
       Caution should be taken when using the <option>-y</option> option on
       multi-user systems as the key can be visible in the output from
       <citerefentry>
-        <refentrytitle>ps</refentrytitle><manvolnum>1</manvolnum>
+       <refentrytitle>ps</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>
       or in the shell's history file.  When
       using TSIG authentication with <command>dig</command>, the name
 
       <variablelist>
 
-        <varlistentry>
-          <term><option>+[no]aaflag</option></term>
+       <varlistentry>
+         <term><option>+[no]aaflag</option></term>
          <listitem>
            <para>
              A synonym for <parameter>+[no]aaonly</parameter>.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]aaonly</option></term>
+       <varlistentry>
+         <term><option>+[no]aaonly</option></term>
          <listitem>
            <para>
              Sets the "aa" flag in the query.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]additional</option></term>
+       <varlistentry>
+         <term><option>+[no]additional</option></term>
          <listitem>
            <para>
              Display [do not display] the additional section of a
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]adflag</option></term>
+       <varlistentry>
+         <term><option>+[no]adflag</option></term>
          <listitem>
            <para>
              Set [do not set] the AD (authentic data) bit in the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]all</option></term>
+       <varlistentry>
+         <term><option>+[no]all</option></term>
          <listitem>
            <para>
              Set or clear all display flags.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]answer</option></term>
+       <varlistentry>
+         <term><option>+[no]answer</option></term>
          <listitem>
            <para>
              Display [do not display] the answer section of a
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]authority</option></term>
+       <varlistentry>
+         <term><option>+[no]authority</option></term>
          <listitem>
            <para>
              Display [do not display] the authority section of a
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]besteffort</option></term>
+       <varlistentry>
+         <term><option>+[no]besteffort</option></term>
          <listitem>
            <para>
              Attempt to display the contents of messages which are
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+bufsize=B</option></term>
+       <varlistentry>
+         <term><option>+bufsize=B</option></term>
          <listitem>
            <para>
              Set the UDP message buffer size advertised using EDNS0
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]cdflag</option></term>
+       <varlistentry>
+         <term><option>+[no]cdflag</option></term>
          <listitem>
            <para>
              Set [do not set] the CD (checking disabled) bit in
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]cl</option></term>
+       <varlistentry>
+         <term><option>+[no]cl</option></term>
          <listitem>
            <para>
              Display [do not display] the CLASS when printing the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]cmd</option></term>
+       <varlistentry>
+         <term><option>+[no]cmd</option></term>
          <listitem>
            <para>
              Toggles the printing of the initial comment in the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]comments</option></term>
+       <varlistentry>
+         <term><option>+[no]comments</option></term>
          <listitem>
            <para>
              Toggle the display of comment lines in the output.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]crypto</option></term>
+       <varlistentry>
+         <term><option>+[no]crypto</option></term>
          <listitem>
            <para>
              Toggle the display of cryptographic fields in DNSSEC
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]defname</option></term>
+       <varlistentry>
+         <term><option>+[no]defname</option></term>
          <listitem>
            <para>
              Deprecated, treated as a synonym for
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]dnssec</option></term>
+       <varlistentry>
+         <term><option>+[no]dnssec</option></term>
          <listitem>
            <para>
              Requests DNSSEC records be sent by setting the DNSSEC
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+domain=somename</option></term>
+       <varlistentry>
+         <term><option>+domain=somename</option></term>
          <listitem>
            <para>
              Set the search list to contain the single domain
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]expire</option></term>
+       <varlistentry>
+         <term><option>+[no]expire</option></term>
          <listitem>
            <para>
              Send an EDNS Expire option.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]fail</option></term>
+       <varlistentry>
+         <term><option>+[no]fail</option></term>
          <listitem>
            <para>
              Do not try the next server if you receive a SERVFAIL.
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]identify</option></term>
+       <varlistentry>
+         <term><option>+[no]identify</option></term>
          <listitem>
            <para>
              Show [or do not show] the IP address and port number
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]ignore</option></term>
+       <varlistentry>
+         <term><option>+[no]ignore</option></term>
          <listitem>
            <para>
              Ignore truncation in UDP responses instead of retrying
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]keepopen</option></term>
+       <varlistentry>
+         <term><option>+[no]keepopen</option></term>
          <listitem>
            <para>
              Keep the TCP socket open between queries and reuse
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]multiline</option></term>
+       <varlistentry>
+         <term><option>+[no]multiline</option></term>
          <listitem>
            <para>
              Print records like the SOA records in a verbose
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+ndots=D</option></term>
+       <varlistentry>
+         <term><option>+ndots=D</option></term>
          <listitem>
            <para>
              Set the number of dots that have to appear in
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]nsid</option></term>
+       <varlistentry>
+         <term><option>+[no]nsid</option></term>
          <listitem>
            <para>
              Include an EDNS name server ID request when sending
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]nssearch</option></term>
+       <varlistentry>
+         <term><option>+[no]nssearch</option></term>
          <listitem>
            <para>
              When this option is set, <command>dig</command>
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]qr</option></term>
+       <varlistentry>
+         <term><option>+[no]qr</option></term>
          <listitem>
            <para>
              Print [do not print] the query as it is sent.  By
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]question</option></term>
+       <varlistentry>
+         <term><option>+[no]question</option></term>
          <listitem>
            <para>
              Print [do not print] the question section of a query
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]recurse</option></term>
+       <varlistentry>
+         <term><option>+[no]recurse</option></term>
          <listitem>
            <para>
              Toggle the setting of the RD (recursion desired) bit
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+retry=T</option></term>
+       <varlistentry>
+         <term><option>+retry=T</option></term>
          <listitem>
            <para>
              Sets the number of times to retry UDP queries to
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]rrcomments</option></term>
+       <varlistentry>
+         <term><option>+[no]rrcomments</option></term>
          <listitem>
            <para>
              Toggle the display of per-record comments in the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]search</option></term>
+       <varlistentry>
+         <term><option>+[no]search</option></term>
          <listitem>
            <para>
              Use [do not use] the search list defined by the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]short</option></term>
+       <varlistentry>
+         <term><option>+[no]short</option></term>
          <listitem>
            <para>
              Provide a terse answer.  The default is to print the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]showsearch</option></term>
+       <varlistentry>
+         <term><option>+[no]showsearch</option></term>
          <listitem>
            <para>
              Perform [do not perform] a search showing intermediate
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]sigchase</option></term>
+       <varlistentry>
+         <term><option>+[no]sigchase</option></term>
          <listitem>
            <para>
              Chase DNSSEC signature chains.  Requires dig be
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]sit<optional>=####</optional></option></term>
+       <varlistentry>
+         <term><option>+[no]sit<optional>=####</optional></option></term>
          <listitem>
            <para>
              Send a Source Identity Token EDNS option, with optional
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+split=W</option></term>
+       <varlistentry>
+         <term><option>+split=W</option></term>
          <listitem>
            <para>
              Split long hex- or base64-formatted fields in resource
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]stats</option></term>
+       <varlistentry>
+         <term><option>+[no]stats</option></term>
          <listitem>
            <para>
              This query option toggles the printing of statistics:
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]subnet=addr/prefix</option></term>
+       <varlistentry>
+         <term><option>+[no]subnet=addr/prefix</option></term>
          <listitem>
            <para>
              Send an EDNS Client Subnet option with the speciifed
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]tcp</option></term>
+       <varlistentry>
+         <term><option>+[no]tcp</option></term>
          <listitem>
            <para>
              Use [do not use] TCP when querying name servers. The
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+time=T</option></term>
+       <varlistentry>
+         <term><option>+time=T</option></term>
          <listitem>
            <para>
 
-              Sets the timeout for a query to
-              <parameter>T</parameter> seconds.  The default
+             Sets the timeout for a query to
+             <parameter>T</parameter> seconds.  The default
              timeout is 5 seconds.
-              An attempt to set <parameter>T</parameter> to less
-              than 1 will result
-              in a query timeout of 1 second being applied.
-            </para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><option>+[no]topdown</option></term>
+             An attempt to set <parameter>T</parameter> to less
+             than 1 will result
+             in a query timeout of 1 second being applied.
+           </para>
+         </listitem>
+       </varlistentry>
+
+       <varlistentry>
+         <term><option>+[no]topdown</option></term>
          <listitem>
            <para>
              When chasing DNSSEC signature chains perform a top-down
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]trace</option></term>
+       <varlistentry>
+         <term><option>+[no]trace</option></term>
          <listitem>
            <para>
              Toggle tracing of the delegation path from the root
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+tries=T</option></term>
+       <varlistentry>
+         <term><option>+tries=T</option></term>
          <listitem>
            <para>
              Sets the number of times to try UDP queries to server
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+trusted-key=####</option></term>
+       <varlistentry>
+         <term><option>+trusted-key=####</option></term>
          <listitem>
            <para>
              Specifies a file containing trusted keys to be used
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]ttlid</option></term>
+       <varlistentry>
+         <term><option>+[no]ttlid</option></term>
          <listitem>
            <para>
              Display [do not display] the TTL when printing the
          </listitem>
        </varlistentry>
 
-        <varlistentry>
-          <term><option>+[no]vc</option></term>
+       <varlistentry>
+         <term><option>+[no]vc</option></term>
          <listitem>
            <para>
              Use [do not use] TCP when querying name servers.  This
@@ -1030,13 +1030,13 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
   <refsect1>
     <title>SEE ALSO</title>
     <para><citerefentry>
-        <refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
+       <refentrytitle>host</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
+       <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
+       <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citetitle>RFC1035</citetitle>.
     </para>