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)


OptionDescriptionDefaultPossible Values (if applicable)
-w, --watchRe-run the specified query and update the output table every X millisecondspositive integer
-f, --fileUse 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, --serversThe servers to query against instead of the integrated servers.Any parseable IP (like, or multiple separated by commas (like,2001:4860:4860::8888)
--server-countdug runs queries against the top servers, ranked by reliability, per continent. This allows you to set how many servers from each continent to use.6integer >= 1
--continentsThe continents on which servers will be queried.AF,SA,NA,OC,AS,EU,ANAny of the following (or multiple separated by commas): AF, SA, NA, OC, AS, EU, AN
-q, --query-typesThe query type(s) to run against each server.AAny of the items in the Query Types table below (or multiple separated by commas)
-m, --multiple-sourcesWhen specifying servers (-s or --servers) also use integrated servers.false
--data-columnsSpecify 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-presentSpecifies whether or not headers are present in the file specified with (-f). Can only be used in conjuction with --data-columns
--data-separatorSpecifies 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-templateSpecify 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-formatSpecify the output format. For formats other than the default you must also specify a template (--output-template).TABLESTABLES, CSV, JSON
-d,--table-detailSpecify the level of detail to show when rendering tables. Ignored if output-format is set to anything other than its default (TABLES)11, 2
-v,--verboseEnable Verbose Output
-p, --parallelThe number of servers to perform queries against in parallel200integer >= 1
--retriesThe number of times to retry queries on servers that error (or timeout)0positive integer
-t, --timeoutThe timeout (in ms) to be used when querying each DNS Server3000positive integer

Query Types#

There are a lot of query types...

AA host address
NSAn authoritative name server
MDA mail destination (OBSOLETE - use MX)
MFA mail forwarder (OBSOLETE - use MX)
CNAMEThe canonical name for an alias
SOAMarks the start of a zone of authority
MBA mailbox domain name (EXPERIMENTAL)
MGA mail group member (EXPERIMENTAL)
MRA mailbox rename domain name (EXPERIMENTAL)
NULLA Null resource record (EXPERIMENTAL)
WKSA well known service description
PTRA domain name pointer
HINFOHost Information
MINFOMailbox or mail list information
MXMail exchange
TXTText resources
RPResponsible Person
AFSDBAFS Data Base location
AAAAAn IPv6 host address
SRVA resource record which specifies the location of the server(s) for a specific protocol and domain
SSHFPA SSH Fingerprint resource record
AXFRDNS zone transfer request. The DNS Server might only return results for the request if the client connection/IP is allowed to do so.
ANYGeneric any query *. Many servers do not respect this!
URIA Uniform Resource Identifier (URI) resource record
CAAA certification authority authorization