Run Verb
run provides the core functionality for dug and is used to query a large number of servers in parallel (or at least as parallel as you want).
run should be invoked as follows: dug run [<options>] domain or dug [<options>] domain (because run is the default verb)
Options
| Option | Description | Default | Possible Values (if applicable) |
|---|---|---|---|
| -w, --watch | Re-run the specified query and update the output table every X milliseconds | positive integer | |
| -f, --file | Use DNS servers in the specified list for this run. (Must be in default csv format (todo: page) or use --data-columns to specify csv structure) | A filepath | |
| -s, --servers | The servers to query against instead of the integrated servers. | Any parseable IP (like 8.8.8.8), or multiple separated by commas (like 8.8.8.8,2001:4860:4860::8888) | |
| --server-count | dug runs queries against the top servers, ranked by reliability, per continent. This allows you to set how many servers from each continent to use. | 6 | integer >= 1 |
| --continents | The continents on which servers will be queried. | AF,SA,NA,OC,AS,EU,AN | Any of the following (or multiple separated by commas): AF, SA, NA, OC, AS, EU, AN |
| -q, --query-types | The query type(s) to run against each server. | A | Any of the items in the Query Types table below (or multiple separated by commas) |
| -m, --multiple-sources | When specifying servers (-s or --servers) also use integrated servers. | false | |
| --data-columns | Specify the fields, and their order, in the file specified with (-f). Must be used with (-f). | Any of the following (or multiple separated by commas): ipaddress, countrycode, city, dnssec, reliability, ignore | |
| --data-headers-present | Specifies whether or not headers are present in the file specified with (-f). Can only be used in conjuction with --data-columns | ||
| --data-separator | Specifies the separator to be used when parsing servers from the file specified with (-f). Can only be used in conjuction with --data-columns. | , | Any character |
| --output-template | Specify which data, and in what order, to put into out. Ignored if --output-format=TABLES. | Any of the following (or multiple separated by commas): ipaddress, countrycode, city, dnssec, reliability, continentcode, countryname, countryflag, citycountryname, citycountrycontinentname, responsetime, recordtype, haserror, errormessage, errorcode, value | |
| --output-format | Specify the output format. For formats other than the default you must also specify a template (--output-template). | TABLES | TABLES, CSV, JSON |
| -d,--table-detail | Specify the level of detail to show when rendering tables. Ignored if output-format is set to anything other than its default (TABLES) | 1 | 1, 2 |
| -v,--verbose | Enable Verbose Output | ||
| -p, --parallel | The number of servers to perform queries against in parallel | 200 | integer >= 1 |
| --retries | The number of times to retry queries on servers that error (or timeout) | 0 | positive integer |
| -t, --timeout | The timeout (in ms) to be used when querying each DNS Server | 3000 | positive integer |
Query Types
There are a lot of query types...
| Name | Description |
|---|---|
| A | A host address |
| NS | An authoritative name server |
| MD | A mail destination (OBSOLETE - use MX) |
| MF | A mail forwarder (OBSOLETE - use MX) |
| CNAME | The canonical name for an alias |
| SOA | Marks the start of a zone of authority |
| MB | A mailbox domain name (EXPERIMENTAL) |
| MG | A mail group member (EXPERIMENTAL) |
| MR | A mailbox rename domain name (EXPERIMENTAL) |
| NULL | A Null resource record (EXPERIMENTAL) |
| WKS | A well known service description |
| PTR | A domain name pointer |
| HINFO | Host Information |
| MINFO | Mailbox or mail list information |
| MX | Mail exchange |
| TXT | Text resources |
| RP | Responsible Person |
| AFSDB | AFS Data Base location |
| AAAA | An IPv6 host address |
| SRV | A resource record which specifies the location of the server(s) for a specific protocol and domain |
| SSHFP | A SSH Fingerprint resource record |
| RRSIG | RRSIG rfc3755 |
| AXFR | DNS zone transfer request. The DNS Server might only return results for the request if the client connection/IP is allowed to do so. |
| ANY | Generic any query *. Many servers do not respect this! |
| URI | A Uniform Resource Identifier (URI) resource record |
| CAA | A certification authority authorization |