dig [-h]
dig [global-queryopt...] [query...]
dig +
dig (domain information groper) is a flexible tool for interrogating DNS name servers. It performs DNS lookups and displays the answers that are returned from the name server(s) that - were queried. Most DNS administrators use dig to + were queried. Most DNS administrators use dig to troubleshoot DNS problems because of its flexibility, ease of use and clarity of output. Other lookup tools tend to have less functionality - than dig. + than dig.
- Although dig is normally used with
+ Although dig is normally used with
command-line
arguments, it also has a batch mode of operation for reading lookup
requests from a file. A brief summary of its command-line arguments
and options is printed when the -h option is given.
Unlike earlier versions, the BIND 9 implementation of
- dig allows multiple lookups to be issued
+ dig allows multiple lookups to be issued
from the
command line.
Unless it is told to query a specific name server,
- dig will try each of the servers listed in
+ dig will try each of the servers listed in
/etc/resolv.conf. If no usable server addresses
- are found, dig will send the query to the local
+ are found, dig will send the query to the local
host.
When no command line arguments or options are given, - dig will perform an NS query for "." (the root). + dig will perform an NS query for "." (the root).
- It is possible to set per-user defaults for dig via
+ It is possible to set per-user defaults for dig via
${HOME}/.digrc. This file is read and
any options in it
are applied before the command line arguments.
@@ -80,17 +80,17 @@
use "IN." and "CH." when looking up these top level domains.
- A typical invocation of dig looks like: + A typical invocation of dig looks like:
dig @server name type
where:
-server
@@ -98,19 +98,19 @@
can be an IPv4 address in dotted-decimal notation or an IPv6
address in colon-delimited notation. When the supplied
server argument is a hostname,
- dig resolves that name before querying
+ dig resolves that name before querying
that name server.
If no server argument is
- provided, dig consults
+ provided, dig consults
/etc/resolv.conf; if an
address is found there, it queries the name server at
that address. If either of the -4 or
-6 options are in use, then
only addresses for the corresponding transport
will be tried. If no usable addresses are found,
- dig will send the query to the
+ dig will send the query to the
local host. The reply from the name server that
responds is displayed.
type can be any valid query
type. If no
type argument is supplied,
- dig will perform a lookup for an
+ dig will perform a lookup for an
A record.
The -b option sets the source IP address of the query
to address. This must be a valid
@@ -150,14 +150,14 @@
class, such as HS for Hesiod records or CH for Chaosnet records.
- The -f option makes dig
+ The -f option makes dig
operate
in batch mode by reading a list of lookup requests to process from the
file filename. The file contains a
number of
queries, one per line. Each entry in the file should be organized in
the same way they would be presented as queries to
- dig using the command-line interface.
+ dig using the command-line interface.
The -m option enables memory usage debugging.
@@ -166,17 +166,17 @@
If a non-standard port number is to be queried, the
-p option is used. port# is
- the port number that dig will send its
+ the port number that dig will send its
queries
instead of the standard DNS port number 53. This option would be used
to test a name server that has been configured to listen for queries
on a non-standard port number.
- The -4 option forces dig
+ The -4 option forces dig
to only
use IPv4 query transport. The -6 option forces
- dig to only use IPv6 query transport.
+ dig to only use IPv6 query transport.
The -t option sets the query type to
@@ -197,7 +197,7 @@
name from other arguments.
- The -v causes dig to
+ The -v causes dig to
print the version number and exit.
@@ -207,7 +207,7 @@
address in dotted-decimal notation, or a colon-delimited IPv6 address.
When this option is used, there is no need to provide the
name, class and
- type arguments. dig
+ type arguments. dig
automatically performs a lookup for a name like
11.12.13.10.in-addr.arpa and sets the
query type and
@@ -218,7 +218,7 @@
are now experimental and are not attempted.
- To sign the DNS queries sent by dig and
+ To sign the DNS queries sent by dig and
their
responses using transaction signatures (TSIG), specify a TSIG key file
using the -k option. You can also specify the TSIG
@@ -234,16 +234,16 @@
multi-user systems as the key can be visible in the output from
ps(1)
or in the shell's history file. When
- using TSIG authentication with dig, the name
+ using TSIG authentication with dig, the name
server that is queried needs to know the key and algorithm that is
being used. In BIND, this is done by providing appropriate
- key and server statements in
+ key and server statements in
named.conf.
dig +
dig provides a number of query options which affect the way in which lookups are made and the results displayed. Some of these set or reset flag bits in the query header, some determine which @@ -261,20 +261,20 @@ The query options are:
-+[no]aaflag
- A synonym for +[no]aaonly.
-
+[no]aaonly.
+
+[no]aaonly- Sets the "aa" flag in the query. -
+[no]additional- Display [do not display] the additional section of a reply. - The default is to display it. -
+[no]adflagSet [do not set] the AD (authentic data) bit in the @@ -289,78 +289,77 @@
+[no]all- Set or clear all display flags. -
+[no]answer- Display [do not display] the answer section of a reply. The - default - is to display it. -
+[no]authority- Display [do not display] the authority section of a reply. The - default is to display it. -
+[no]besteffort- Attempt to display the contents of messages which are malformed. - The default is to not display malformed answers. -
+bufsize=B
- Set the UDP message buffer size advertised using EDNS0 to
- B bytes. The maximum and minimum sizes
- of this buffer are 65535 and 0 respectively. Values outside
- this range are rounded up or down appropriately.
- Values other than zero will cause a EDNS query to be sent.
-
B bytes. The maximum and
+ minimum sizes of this buffer are 65535 and 0 respectively.
+ Values outside this range are rounded up or down
+ appropriately. Values other than zero will cause a
+ EDNS query to be sent.
+
+[no]cdflag- Set [do not set] the CD (checking disabled) bit in the query. - This - requests the server to not perform DNSSEC validation of - responses. -
+[no]cl- Display [do not display] the CLASS when printing the record. -
+[no]cmd- Toggles the printing of the initial comment in the output - identifying - the version of dig and the query - options that have - been applied. This comment is printed by default. -
+[no]comments- Toggle the display of comment lines in the output. The default - is to print comments. -
+[no]defname
- Deprecated, treated as a synonym for +[no]search
-
+[no]search
+
+[no]dnssec- Requests DNSSEC records be sent by setting the DNSSEC OK bit - (DO) - in the OPT record in the additional section of the query. -
+domain=somename
- Set the search list to contain the single domain
- somename, as if specified in
- a
- domain directive in
- /etc/resolv.conf, and enable
- search list
- processing as if the +search
- option were given.
-
+[no]edns[=#]somename, as if specified in
+ a domain directive in
+ /etc/resolv.conf, and enable
+ search list processing as if the
+ +search option were given.
+
++[no]edns[=#]Specify the EDNS version to query with. Valid values are 0 to 255. Setting the EDNS version will cause @@ -370,162 +369,152 @@
+[no]fail- Do not try the next server if you receive a SERVFAIL. The - default is - to not try the next server which is the reverse of normal stub - resolver - behavior. -
+[no]identify
- Show [or do not show] the IP address and port number that
- supplied the
- answer when the +short option
- is enabled. If
- short form answers are requested, the default is not to show the
- source address and port number of the server that provided the
- answer.
-
+short option is enabled. If
+ short form answers are requested, the default is not
+ to show the source address and port number of the
+ server that provided the answer.
+
+[no]ignore- Ignore truncation in UDP responses instead of retrying with TCP. - By - default, TCP retries are performed. -
+[no]keepopen
- Keep the TCP socket open between queries and reuse it rather
- than creating a new TCP socket for each lookup. The default
- is +nokeepopen.
-
+nokeepopen.
+
+[no]multiline- Print records like the SOA records in a verbose multi-line - format with human-readable comments. The default is to print - each record on a single line, to facilitate machine parsing - of the dig output. -
+ndots=D
- Set the number of dots that have to appear in
- name to D for it to be
- considered absolute. The default value is that defined using
- the
- ndots statement in /etc/resolv.conf, or 1 if no
- ndots statement is present. Names with fewer dots are
- interpreted as
- relative names and will be searched for in the domains listed in
- the
- search or domain directive in
- /etc/resolv.conf.
-
name to D
+ for it to be considered absolute. The default value
+ is that defined using the ndots statement in
+ /etc/resolv.conf, or 1 if no
+ ndots statement is present. Names with fewer dots
+ are interpreted as relative names and will be searched
+ for in the domains listed in the search
+ or domain directive in
+ /etc/resolv.conf.
+
+[no]nsid- Include an EDNS name server ID request when sending a query. -
+[no]nssearch- When this option is set, dig - attempts to find the - authoritative name servers for the zone containing the name - being - looked up and display the SOA record that each name server has - for the - zone. -
+[no]onesoaPrint only one (starting) SOA record when performing - an AXFR. The default is to print both the starting and - ending SOA records. + an AXFR. The default is to print both the starting + and ending SOA records.
+[no]qr- Print [do not print] the query as it is sent. - By default, the query is not printed. -
+[no]question- Print [do not print] the question section of a query when an - answer is - returned. The default is to print the question section as a - comment. -
+[no]recurse
Toggle the setting of the RD (recursion desired) bit
in the query. This bit is set by default, which means
- dig normally sends recursive
+ dig normally sends recursive
queries. Recursion is automatically disabled when
the +nssearch or
+trace query options are used.
+retry=T
- Sets the number of times to retry UDP queries to server to
- T instead of the default, 2.
- Unlike
- +tries, this does not include
- the initial
- query.
-
T instead of the
+ default, 2. Unlike +tries,
+ this does not include the initial query.
+
+[no]rrcomments- Toggle the display of per-record comments in the output (for - example, human-readable key information about DNSKEY records). - The default is not to print record comments unless multiline - mode is active. -
+[no]search
- Use [do not use] the search list defined by the searchlist or
- domain
- directive in resolv.conf (if
- any).
- The search list is not used by default.
-
resolv.conf (if any). The search
+ list is not used by default.
+
+[no]short- Provide a terse answer. The default is to print the answer in a - verbose form. -
+[no]showsearch- Perform [do not perform] a search showing intermediate + Perform [do not perform] a search showing intermediate results. -
+split=W
- Split long hex- or base64-formatted fields in resource
- records into chunks of W characters
- (where W is rounded up to the nearest
- multiple of 4).
- +nosplit or
- +split=0 causes fields not to be
- split at all. The default is 56 characters, or 44 characters
- when multiline mode is active.
-
W
+ characters (where W is rounded
+ up to the nearest multiple of 4).
+ +nosplit or
+ +split=0 causes fields not to
+ be split at all. The default is 56 characters, or
+ 44 characters when multiline mode is active.
+
+[no]sigchase- Chase DNSSEC signature chains. Requires dig be compiled with - -DDIG_SIGCHASE. -
+[no]stats- This query option toggles the printing of statistics: when the - query - was made, the size of the reply and so on. The default - behavior is - to print the query statistics. -
+[no]tcp
- Use [do not use] TCP when querying name servers. The
- default behavior is to use UDP unless
- an ixfr=N query is requested, in
- which case the default is TCP.
- AXFR queries always use TCP.
-
ixfr=N query is requested, in which
+ case the default is TCP. AXFR queries always use
+ TCP.
+
+time=T@@ -538,71 +527,72 @@
+[no]topdown- When chasing DNSSEC signature chains perform a top-down - validation. - Requires dig be compiled with -DDIG_SIGCHASE. -
+[no]traceToggle tracing of the delegation path from the root name servers for the name being looked up. Tracing is disabled by default. When tracing is enabled, - dig makes iterative queries to + dig makes iterative queries to resolve the name being looked up. It will follow referrals from the root servers, showing the answer from each server that was used to resolve the lookup.
- +dnssec is also set when +trace is - set to better emulate the default queries from a nameserver. + +dnssec is also set when +trace + is set to better emulate the default queries from a + nameserver.
+tries=T
- Sets the number of times to try UDP queries to server to
- T instead of the default, 3.
- If
- T is less than or equal to
- zero, the number of
- tries is silently rounded up to 1.
-
T instead of the default,
+ 3. If T is less than or equal
+ to zero, the number of tries is silently rounded up
+ to 1.
+
+trusted-key=####
- Specifies a file containing trusted keys to be used with
- +sigchase. Each DNSKEY record must be
- on its own line.
-
- If not specified, dig will look for
- /etc/trusted-key.key then
- trusted-key.key in the current directory.
+ Specifies a file containing trusted keys to be used
+ with +sigchase. Each DNSKEY record
+ must be on its own line.
- Requires dig be compiled with -DDIG_SIGCHASE.
+ If not specified, dig will look
+ for /etc/trusted-key.key then
+ trusted-key.key in the current
+ directory.
+
+ Requires dig be compiled with -DDIG_SIGCHASE.
+[no]ttlid- Display [do not display] the TTL when printing the record. -
+[no]vc
- Use [do not use] TCP when querying name servers. This alternate
- syntax to +[no]tcp is
- provided for backwards
- compatibility. The "vc" stands for "virtual circuit".
-
+[no]tcp
+ is provided for backwards compatibility. The "vc"
+ stands for "virtual circuit".
+
- The BIND 9 implementation of dig
+ The BIND 9 implementation of dig
supports
specifying multiple queries on the command line (in addition to
supporting the -f batch file option). Each of those
@@ -629,7 +619,7 @@
dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
- shows how dig could be used from the
+ shows how dig could be used from the
command line
to make three lookups: an ANY query for www.isc.org, a
reverse lookup of 127.0.0.1 and a query for the NS records of
@@ -637,45 +627,45 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
A global query option of +qr is
applied, so
- that dig shows the initial query it made
+ that dig shows the initial query it made
for each
lookup. The final query has a local query option of
- +noqr which means that dig
+ +noqr which means that dig
will not print the initial query when it looks up the NS records for
isc.org.
- If dig has been built with IDN (internationalized
+ If dig has been built with IDN (internationalized
domain name) support, it can accept and display non-ASCII domain names.
- dig appropriately converts character encoding of
+ dig appropriately converts character encoding of
domain name before sending a request to DNS server or displaying a
reply from the server.
If you'd like to turn off the IDN support for some reason, defines
the IDN_DISABLE environment variable.
The IDN support is disabled if the variable is set when
- dig runs.
+ dig runs.
There are probably too many query options.
diff --git a/bin/dig/host.1 b/bin/dig/host.1 index 5175de6733..4ff5a7cc61 100644 --- a/bin/dig/host.1 +++ b/bin/dig/host.1 @@ -17,35 +17,18 @@ .\" .hy 0 .ad l -'\" t .\" Title: host -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.78.1arpaname {ipaddress ...}
arpaname translates IP addresses (IPv4 and IPv6) to the corresponding IN-ADDR.ARPA or IP6.ARPA names.
ddns-confgen [-a ] [algorithm-h] [-k ] [keyname-r ] [ -s randomfilename | -z zone ] [-q] [name]
ddns-confgen generates a key for use by nsupdate and named. It simplifies configuration @@ -77,7 +77,7 @@
dig [global-queryopt...] [query...]
dig (domain information groper) is a flexible tool for interrogating DNS name servers. It performs DNS lookups and @@ -99,7 +99,7 @@
The -b option sets the source IP address of the query
to address. This must be a valid
@@ -260,7 +260,7 @@
dig provides a number of query options which affect the way in which lookups are made and the results displayed. Some of @@ -280,63 +280,19 @@
+[no]tcp
- Use [do not use] TCP when querying name servers. The
- default behavior is to use UDP unless
- an ixfr=N query is requested, in
- which case the default is TCP.
- AXFR queries always use TCP.
-
+[no]vc
- Use [do not use] TCP when querying name servers. This alternate
- syntax to +[no]tcp is
- provided for backwards
- compatibility. The "vc" stands for "virtual circuit".
-
+[no]ignore- Ignore truncation in UDP responses instead of retrying with TCP. - By - default, TCP retries are performed. -
+domain=somename
- Set the search list to contain the single domain
- somename, as if specified in
- a
- domain directive in
- /etc/resolv.conf, and enable
- search list
- processing as if the +search
- option were given.
-
+[no]search
- Use [do not use] the search list defined by the searchlist or
- domain
- directive in resolv.conf (if
- any).
- The search list is not used by default.
-
+[no]showsearch- Perform [do not perform] a search showing intermediate - results. -
+[no]defname
- Deprecated, treated as a synonym for +[no]search
-
+[no]aaonly- Sets the "aa" flag in the query. -
+[no]aaflag
- A synonym for +[no]aaonly.
-
+[no]aaonly.
+
++[no]aaonly+ Sets the "aa" flag in the query. +
+[no]additional+ Display [do not display] the additional section of a + reply. The default is to display it. +
+[no]adflagSet [do not set] the AD (authentic data) bit in the @@ -349,21 +305,163 @@ of the answer was insecure or not validated. This bit is set by default.
+[no]all+ Set or clear all display flags. +
+[no]answer+ Display [do not display] the answer section of a + reply. The default is to display it. +
+[no]authority+ Display [do not display] the authority section of a + reply. The default is to display it. +
+[no]besteffort+ Attempt to display the contents of messages which are + malformed. The default is to not display malformed + answers. +
+bufsize=B
+ Set the UDP message buffer size advertised using EDNS0
+ to B bytes. The maximum and
+ minimum sizes of this buffer are 65535 and 0 respectively.
+ Values outside this range are rounded up or down
+ appropriately. Values other than zero will cause a
+ EDNS query to be sent.
+
+[no]cdflag- Set [do not set] the CD (checking disabled) bit in the query. - This - requests the server to not perform DNSSEC validation of - responses. -
+[no]cl- Display [do not display] the CLASS when printing the record. -
+[no]ttlid+[no]cmd- Display [do not display] the TTL when printing the record. -
+[no]comments+ Toggle the display of comment lines in the output. + The default is to print comments. +
+[no]defname
+ Deprecated, treated as a synonym for
+ +[no]search
+
+[no]dnssec+ Requests DNSSEC records be sent by setting the DNSSEC + OK bit (DO) in the OPT record in the additional section + of the query. +
+domain=somename
+ Set the search list to contain the single domain
+ somename, as if specified in
+ a domain directive in
+ /etc/resolv.conf, and enable
+ search list processing as if the
+ +search option were given.
+
+[no]edns[=#]
+ Specify the EDNS version to query with. Valid values
+ are 0 to 255. Setting the EDNS version will cause
+ a EDNS query to be sent. +noedns
+ clears the remembered EDNS version. EDNS is set to
+ 0 by default.
+
+[no]fail+ Do not try the next server if you receive a SERVFAIL. + The default is to not try the next server which is + the reverse of normal stub resolver behavior. +
+[no]identify
+ Show [or do not show] the IP address and port number
+ that supplied the answer when the
+ +short option is enabled. If
+ short form answers are requested, the default is not
+ to show the source address and port number of the
+ server that provided the answer.
+
+[no]ignore+ Ignore truncation in UDP responses instead of retrying + with TCP. By default, TCP retries are performed. +
+[no]keepopen
+ Keep the TCP socket open between queries and reuse
+ it rather than creating a new TCP socket for each
+ lookup. The default is +nokeepopen.
+
+[no]multiline+ Print records like the SOA records in a verbose + multi-line format with human-readable comments. The + default is to print each record on a single line, to + facilitate machine parsing of the dig + output. +
+ndots=D
+ Set the number of dots that have to appear in
+ name to D
+ for it to be considered absolute. The default value
+ is that defined using the ndots statement in
+ /etc/resolv.conf, or 1 if no
+ ndots statement is present. Names with fewer dots
+ are interpreted as relative names and will be searched
+ for in the domains listed in the search
+ or domain directive in
+ /etc/resolv.conf.
+
+[no]nsid+ Include an EDNS name server ID request when sending + a query. +
+[no]nssearch+ When this option is set, dig + attempts to find the authoritative name servers for + the zone containing the name being looked up and + display the SOA record that each name server has for + the zone. +
+[no]onesoa+ Print only one (starting) SOA record when performing + an AXFR. The default is to print both the starting + and ending SOA records. +
+[no]qr+ Print [do not print] the query as it is sent. By + default, the query is not printed. +
+[no]question+ Print [do not print] the question section of a query + when an answer is returned. The default is to print + the question section as a comment. +
+[no]recurse
Toggle the setting of the RD (recursion desired) bit
@@ -373,16 +471,83 @@
the +nssearch or
+trace query options are used.
+[no]nssearch+retry=T
- When this option is set, dig
- attempts to find the
- authoritative name servers for the zone containing the name
- being
- looked up and display the SOA record that each name server has
- for the
- zone.
+ Sets the number of times to retry UDP queries to
+ server to T instead of the
+ default, 2. Unlike +tries,
+ this does not include the initial query.
+
+[no]rrcomments+ Toggle the display of per-record comments in the + output (for example, human-readable key information + about DNSKEY records). The default is not to print + record comments unless multiline mode is active. +
+[no]search
+ Use [do not use] the search list defined by the
+ searchlist or domain directive in
+ resolv.conf (if any). The search
+ list is not used by default.
+
+[no]short+ Provide a terse answer. The default is to print the + answer in a verbose form. +
+[no]showsearch+ Perform [do not perform] a search showing intermediate + results. +
+split=W
+ Split long hex- or base64-formatted fields in resource
+ records into chunks of W
+ characters (where W is rounded
+ up to the nearest multiple of 4).
+ +nosplit or
+ +split=0 causes fields not to
+ be split at all. The default is 56 characters, or
+ 44 characters when multiline mode is active.
+
+[no]sigchase+ Chase DNSSEC signature chains. Requires dig be + compiled with -DDIG_SIGCHASE. +
+[no]stats+ This query option toggles the printing of statistics: + when the query was made, the size of the reply and + so on. The default behavior is to print the query + statistics. +
+[no]tcp
+ Use [do not use] TCP when querying name servers. The
+ default behavior is to use UDP unless an
+ ixfr=N query is requested, in which
+ case the default is TCP. AXFR queries always use
+ TCP.
+
+time=T
+
+ Sets the timeout for a query to
+ T seconds. The default
+ timeout is 5 seconds.
+ An attempt to set T to less
+ than 1 will result
+ in a query timeout of 1 second being applied.
+[no]topdown+ When chasing DNSSEC signature chains perform a top-down + validation. Requires dig be compiled with -DDIG_SIGCHASE. +
+[no]trace@@ -395,230 +560,55 @@ from each server that was used to resolve the lookup.
- +dnssec is also set when +trace is - set to better emulate the default queries from a nameserver. + +dnssec is also set when +trace + is set to better emulate the default queries from a + nameserver.
+[no]cmd- Toggles the printing of the initial comment in the output - identifying - the version of dig and the query - options that have - been applied. This comment is printed by default. -
+[no]short- Provide a terse answer. The default is to print the answer in a - verbose form. -
+[no]identify
- Show [or do not show] the IP address and port number that
- supplied the
- answer when the +short option
- is enabled. If
- short form answers are requested, the default is not to show the
- source address and port number of the server that provided the
- answer.
-
+[no]comments- Toggle the display of comment lines in the output. The default - is to print comments. -
+[no]rrcomments- Toggle the display of per-record comments in the output (for - example, human-readable key information about DNSKEY records). - The default is not to print record comments unless multiline - mode is active. -
+split=W
- Split long hex- or base64-formatted fields in resource
- records into chunks of W characters
- (where W is rounded up to the nearest
- multiple of 4).
- +nosplit or
- +split=0 causes fields not to be
- split at all. The default is 56 characters, or 44 characters
- when multiline mode is active.
-
+[no]stats- This query option toggles the printing of statistics: when the - query - was made, the size of the reply and so on. The default - behavior is - to print the query statistics. -
+[no]qr- Print [do not print] the query as it is sent. - By default, the query is not printed. -
+[no]question- Print [do not print] the question section of a query when an - answer is - returned. The default is to print the question section as a - comment. -
+[no]answer- Display [do not display] the answer section of a reply. The - default - is to display it. -
+[no]authority- Display [do not display] the authority section of a reply. The - default is to display it. -
+[no]additional- Display [do not display] the additional section of a reply. - The default is to display it. -
+[no]all- Set or clear all display flags. -
+time=T
-
- Sets the timeout for a query to
- T seconds. The default
- timeout is 5 seconds.
- An attempt to set T to less
- than 1 will result
- in a query timeout of 1 second being applied.
-
+tries=T
- Sets the number of times to try UDP queries to server to
- T instead of the default, 3.
- If
- T is less than or equal to
- zero, the number of
- tries is silently rounded up to 1.
-
+retry=T
- Sets the number of times to retry UDP queries to server to
- T instead of the default, 2.
- Unlike
- +tries, this does not include
- the initial
- query.
-
+ndots=D
- Set the number of dots that have to appear in
- name to D for it to be
- considered absolute. The default value is that defined using
- the
- ndots statement in /etc/resolv.conf, or 1 if no
- ndots statement is present. Names with fewer dots are
- interpreted as
- relative names and will be searched for in the domains listed in
- the
- search or domain directive in
- /etc/resolv.conf.
-
+bufsize=B
- Set the UDP message buffer size advertised using EDNS0 to
- B bytes. The maximum and minimum sizes
- of this buffer are 65535 and 0 respectively. Values outside
- this range are rounded up or down appropriately.
- Values other than zero will cause a EDNS query to be sent.
-
+edns=#
- Specify the EDNS version to query with. Valid values
- are 0 to 255. Setting the EDNS version will cause
- a EDNS query to be sent. +noedns
- clears the remembered EDNS version. EDNS is set to
- 0 by default.
+ Sets the number of times to try UDP queries to server
+ to T instead of the default,
+ 3. If T is less than or equal
+ to zero, the number of tries is silently rounded up
+ to 1.
+[no]multiline- Print records like the SOA records in a verbose multi-line - format with human-readable comments. The default is to print - each record on a single line, to facilitate machine parsing - of the dig output. -
+[no]onesoa- Print only one (starting) SOA record when performing - an AXFR. The default is to print both the starting and - ending SOA records. -
+[no]fail- Do not try the next server if you receive a SERVFAIL. The - default is - to not try the next server which is the reverse of normal stub - resolver - behavior. -
+[no]besteffort- Attempt to display the contents of messages which are malformed. - The default is to not display malformed answers. -
+[no]dnssec- Requests DNSSEC records be sent by setting the DNSSEC OK bit - (DO) - in the OPT record in the additional section of the query. -
+[no]sigchase- Chase DNSSEC signature chains. Requires dig be compiled with - -DDIG_SIGCHASE. -
+trusted-key=####
- Specifies a file containing trusted keys to be used with
- +sigchase. Each DNSKEY record must be
- on its own line.
-
- If not specified, dig will look for
- /etc/trusted-key.key then
- trusted-key.key in the current directory.
+ Specifies a file containing trusted keys to be used
+ with +sigchase. Each DNSKEY record
+ must be on its own line.
- Requires dig be compiled with -DDIG_SIGCHASE.
+ If not specified, dig will look
+ for /etc/trusted-key.key then
+ trusted-key.key in the current
+ directory.
+
+ Requires dig be compiled with -DDIG_SIGCHASE.
+[no]topdown+[no]ttlid- When chasing DNSSEC signature chains perform a top-down - validation. - Requires dig be compiled with -DDIG_SIGCHASE. -
+[no]nsid+[no]vc- Include an EDNS name server ID request when sending a query. -
+[no]keepopen
- Keep the TCP socket open between queries and reuse it rather
- than creating a new TCP socket for each lookup. The default
- is +nokeepopen.
-
+[no]tcp
+ is provided for backwards compatibility. The "vc"
+ stands for "virtual circuit".
+
The BIND 9 implementation of dig supports @@ -664,7 +654,7 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
If dig has been built with IDN (internationalized domain name) support, it can accept and display non-ASCII domain names. @@ -678,14 +668,14 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
host(1), named(8), dnssec-keygen(8), @@ -693,7 +683,7 @@ dig +qr www.isc.org any -x 127.0.0.1 isc.org ns +noqr
There are probably too many query options.
diff --git a/doc/arm/man.dnssec-checkds.html b/doc/arm/man.dnssec-checkds.html index fa3844fb35..1efa65d0e9 100644 --- a/doc/arm/man.dnssec-checkds.html +++ b/doc/arm/man.dnssec-checkds.html @@ -51,7 +51,7 @@dnssec-dsfromkey [-l ] [domain-f ] [file-d ] [dig path-D ] {zone}dsfromkey path
dnssec-checkds verifies the correctness of Delegation Signer (DS) or DNSSEC Lookaside Validation (DLV) resource records for keys in a specified @@ -59,7 +59,7 @@
dnssec-coverage [-K ] [directory-f ] [file-d ] [DNSKEY TTL-m ] [max TTL-r ] [interval-c ] [zone]compilezone path
dnssec-coverage verifies that the DNSSEC keys for a given zone or a set of zones have timing metadata set properly to ensure no future lapses in DNSSEC @@ -78,7 +78,7 @@
dnssec-dsfromkey {-s} [-1] [-2] [-a ] [alg-K ] [directory-l ] [domain-s] [-c ] [class-T ] [TTL-f ] [file-A] [-v ] {dnsname}level
dnssec-dsfromkey outputs the Delegation Signer (DS) resource record (RR), as defined in RFC 3658 and RFC 4509, for the given key(s).
The keyfile can be designed by the key identification
Knnnn.+aaa+iiiii or the full file name
@@ -164,13 +164,13 @@
dnssec-keygen(8), dnssec-signzone(8), BIND 9 Administrator Reference Manual, @@ -180,7 +180,7 @@
dnssec-keyfromlabel {-l label} [-3] [-a ] [algorithm-A ] [date/offset-c ] [class-D ] [date/offset-E ] [engine-f ] [flag-G] [-I ] [date/offset-i ] [interval-k] [-K ] [directory-L ] [ttl-n ] [nametype-P ] [date/offset-p ] [protocol-R ] [date/offset-S ] [key-t ] [type-v ] [level-y] {name}
When dnssec-keyfromlabel completes successfully, @@ -316,7 +316,7 @@
dnssec-keygen(8), dnssec-signzone(8), BIND 9 Administrator Reference Manual, @@ -324,7 +324,7 @@
dnssec-keygen [-a ] [algorithm-b ] [keysize-n ] [nametype-3] [-A ] [date/offset-C] [-c ] [class-D ] [date/offset-E ] [engine-f ] [flag-G] [-g ] [generator-h] [-I ] [date/offset-i ] [interval-K ] [directory-L ] [ttl-k] [-P ] [date/offset-p ] [protocol-q] [-R ] [date/offset-r ] [randomdev-S ] [key-s ] [strength-t ] [type-v ] [level-z] {name}
To generate a 768-bit DSA key for the domain
example.com, the following command would be
@@ -415,7 +415,7 @@
dnssec-signzone(8), BIND 9 Administrator Reference Manual, RFC 2539, @@ -424,7 +424,7 @@
dnssec-revoke [-hr] [-v ] [level-K ] [directory-E ] [engine-f] [-R] {keyfile}
dnssec-revoke reads a DNSSEC key file, sets the REVOKED bit on the key as defined in RFC 5011, and creates a new pair of key files containing the @@ -58,7 +58,7 @@
dnssec-settime [-f] [-K ] [directory-L ] [ttl-P ] [date/offset-A ] [date/offset-R ] [date/offset-I ] [date/offset-D ] [date/offset-h] [-v ] [level-E ] {keyfile}engine
dnssec-keygen(8), dnssec-signzone(8), BIND 9 Administrator Reference Manual, @@ -231,7 +231,7 @@
dnssec-signzone [-a] [-c ] [class-d ] [directory-D] [-E ] [engine-e ] [end-time-f ] [output-file-g] [-h] [-K ] [directory-k ] [key-L ] [serial-l ] [domain-i ] [interval-I ] [input-format-j ] [jitter-N ] [soa-serial-format-o ] [origin-O ] [output-format-P] [-p] [-R] [-r ] [randomdev-S] [-s ] [start-time-T ] [ttl-t] [-u] [-v ] [level-X ] [extended end-time-x] [-z] [-3 ] [salt-H ] [iterations-A] {zonefile} [key...]
dnssec-signzone signs a zone. It generates NSEC and RRSIG records and produces a signed version of the @@ -61,7 +61,7 @@
The following command signs the example.com
zone with the DSA key generated by dnssec-keygen
@@ -509,14 +509,14 @@ db.example.com.signed
%
dnssec-verify [-c ] [class-E ] [engine-I ] [input-format-o ] [origin-v ] [level-x] [-z] {zonefile}
dnssec-verify verifies that a zone is fully signed for each algorithm found in the DNSKEY RRset for the zone, and that the NSEC / NSEC3 @@ -58,7 +58,7 @@
genrandom [-n ] {numbersize} {filename}
genrandom generates a file or a set of files containing a specified quantity @@ -59,7 +59,7 @@
host [-aCdlnrsTwv] [-c ] [class-N ] [ndots-R ] [number-t ] [type-W ] [wait-m ] [flag-4] [-6] [-v] [-V] {name} [server]
host is a simple utility for performing DNS lookups. It is normally used to convert names to IP addresses and vice versa. @@ -206,7 +206,7 @@
If host has been built with IDN (internationalized domain name) support, it can accept and display non-ASCII domain names. @@ -220,12 +220,12 @@
dig(1), named(8).
diff --git a/doc/arm/man.isc-hmac-fixup.html b/doc/arm/man.isc-hmac-fixup.html index ed7d5bca66..3aac66364c 100644 --- a/doc/arm/man.isc-hmac-fixup.html +++ b/doc/arm/man.isc-hmac-fixup.html @@ -50,7 +50,7 @@isc-hmac-fixup {algorithm} {secret}
Versions of BIND 9 up to and including BIND 9.6 had a bug causing HMAC-SHA* TSIG keys which were longer than the digest length of the @@ -76,7 +76,7 @@
Secrets that have been converted by isc-hmac-fixup are shortened, but as this is how the HMAC protocol works in @@ -87,14 +87,14 @@
named-checkconf [-h] [-v] [-j] [-t ] {filename} [directory-p] [-x] [-z]
named-checkconf checks the syntax, but not the semantics, of a named configuration file. The file is parsed @@ -70,7 +70,7 @@
named-checkconf returns an exit status of 1 if errors were detected and 0 otherwise.
named-compilezone [-d] [-j] [-q] [-v] [-c ] [class-C ] [mode-f ] [format-F ] [format-i ] [mode-k ] [mode-m ] [mode-n ] [mode-L ] [serial-r ] [mode-s ] [style-t ] [directory-T ] [mode-w ] [directory-D] [-W ] {mode-o } {zonename} {filename}filename
named-checkzone checks the syntax and integrity of a zone file. It performs the same checks as named does when loading a @@ -71,7 +71,7 @@
named-checkzone returns an exit status of 1 if errors were detected and 0 otherwise.
named-journalprint {journal}
named-journalprint prints the contents of a zone journal file in a human-readable @@ -76,7 +76,7 @@
named [-4] [-6] [-c ] [config-file-d ] [debug-level-E ] [engine-name-f] [-g] [-m ] [flag-n ] [#cpus-p ] [port-s] [-S ] [#max-socks-t ] [directory-U ] [#listeners-u ] [user-v] [-V] [-x ]cache-file
named is a Domain Name System (DNS) server, part of the BIND 9 distribution from ISC. For more @@ -65,7 +65,7 @@
In routine operation, signals should not be used to control the nameserver; rndc should be used @@ -279,7 +279,7 @@
The named configuration file is too complex to describe in detail here. A complete description is provided @@ -296,7 +296,7 @@
nsec3hash {salt} {algorithm} {iterations} {domain}
nsec3hash generates an NSEC3 hash based on a set of NSEC3 parameters. This can be used to check the validity @@ -56,7 +56,7 @@
nsupdate [-d] [-D] [[-g] | [-o] | [-l] | [-y ] | [[hmac:]keyname:secret-k ]] [keyfile-t ] [timeout-u ] [udptimeout-r ] [udpretries-R ] [randomdev-v] [-V] [filename]
nsupdate is used to submit Dynamic DNS Update requests as defined in RFC 2136 to a name server. @@ -220,7 +220,7 @@
The TSIG key is redundantly stored in two separate files. This is a consequence of nsupdate using the DST library diff --git a/doc/arm/man.rndc-confgen.html b/doc/arm/man.rndc-confgen.html index a69537d818..be35bc81e4 100644 --- a/doc/arm/man.rndc-confgen.html +++ b/doc/arm/man.rndc-confgen.html @@ -50,7 +50,7 @@
rndc-confgen [-a] [-b ] [keysize-c ] [keyfile-h] [-k ] [keyname-p ] [port-r ] [randomfile-s ] [address-t ] [chrootdir-u ]user
rndc-confgen generates configuration files for rndc. It can be used as a @@ -66,7 +66,7 @@
rndc.conf
rndc.conf is the configuration file
for rndc, the BIND 9 name server control
utility. This file has a similar structure and syntax to
@@ -135,7 +135,7 @@
The name server must be configured to accept rndc connections and
to recognize the key specified in the rndc.conf
@@ -219,7 +219,7 @@
rndc [-b ] [source-address-c ] [config-file-k ] [key-file-s ] [server-p ] [port-V] [-y ] {command}key_id
rndc controls the operation of a name server. It supersedes the ndc utility @@ -79,7 +79,7 @@
A list of commands supported by rndc can be seen by running rndc without arguments. @@ -498,7 +498,7 @@