mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-09-01 06:55:30 +00:00
Code Issues Releases Wiki Activity

white space

Browse Source
This commit is contained in:
Mark Andrews
2014-05-15 14:30:31 +10:00
parent 2d0bc1e0f3
commit 0af902c0df
1 changed files with 167 additions and 167 deletions
Download Patch File Download Diff File Expand all files Collapse all files

334
bin/dig/dig.docbook
View File

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