distributed-dig
Advanced tools
Changelog
[1.8.0] - November 21<sup>st</sup> 2020
--unique which filters out duplicate addresses (but not errors).![ddig [domain] --unique](https://marksmurphy.github.io/img/ddig.single.domain.unique.gif)
debug).Readme
Install globally:
npm install -g distributed-dig
Lookup a single domain:
ddig domain
![ddig [domain]](https://marksmurphy.github.io/img/ddig.single.domains.gif)
A utility which makes DNS lookup requests across multiple DNS resolvers and collates the results.
Useful for checking if a DNS record has been fully propagated, or for querying the origins behind an AWS Route 53 / Azure Traffic Manager record (or any other DNS-based load balancing solution).
Installing globally is recommended:
npm install -g distributed-dig
ddig domain [domain [domain] ...] [options]
The following options are available:
--port <number> Specify the DNS port [53]
--protocol <upd|tcp> Specify the DNS protocol [udp]
--timeout <number> Specify the DNS timeout in milliseconds [2500]
--edns <true|false> Enable or disable EDNS(0) [false]
--config <filename> Specify an alternative configuration file
--list-resolvers List resolvers configured in config file
--list-options List DNS request options configured in config file
--list-defaults Print json of default config file settings
--verbose Outputs more information
--no-color Switches off colour output
--version Display version number
--help Display this help
Specify the TCP/UDP port tro use when connecting to the DNS resolver.
Default: 53
Specify whether to use UDP or TCP when connecting to the DNS resolver.
Default: udp
Specifies the timeout in milliseconds to wait for a response from each DNS resolver.
Default: 2500 (2.5 seconds)
Enables EDNS(0)
Default: false (disabled)
With EDNS(0) enabled, if an upstream resolver doesn't support it then the standard DNS will be used as a fallback.
Even though EDNS is support by ~90% of resolvers on the internet 1, it is disabled by default in ddig as it may cause the resolver to return the IP address it considers closest to you, which is counter-productive to the purpose of querying many geographically distributed DNS resolvers.
Specifies an alternative configuration file.
To create a custom config you can:
ddig --list-defaults > custom.jsoncustom.jsonddig --config [path]custom.json example.comLists the resolvers configured in the distributed-dig.json config file:
Lists the options configured in the distributed-dig.json config file:
Prints out a sample default config file in raw json. Pipe it to a file for an initial customised configuration file.
Switches on verbose mode which outputs the following additional fields:
cname records)
--verbose also modifies the --list-resolvers and --list-options switches.
If your terminal has problems rendering the colour output then you can switch it off by using --no-color.
Prints out distributed-dig's version number.
Displays the help screen:
www.asos.com from each of the configured resolver:ddig www.asos.com
www.asos.com from each of the configured resolver:ddig www.asos.com --verbose
www.asos.com & secure.asos.com from each of the configured resolver with a 5 second timeout:ddig www.asos.com my.asos.com secure.asos.com --timeout 5000
As of version 1.8.0 you can provide a URL and the domain will be extracted. This is handy when performing a copy/paste from a browser's address bar.
ddig https://example.com
![ddig [URL]](https://marksmurphy.github.io/img/ddig.single.url.gif)
The first occurrence of each unique IP address is marked by a bullet point:
The bullet point character used is U+2022 • BULLET (HTML •). If it is detected that the output is being piped (to a file or to more | cat) then the ascii character 42 * Asterisk (HTML *)
As of version 1.7.0 there is an option to provide a --unique switch which lists only the first occurrence of each distinct IP address returned. N.B. It will not filter out errors
If you use the --verbose switch and have a terminal window that's narrower than 130 columns you'll see a warning:
All Options and Resolvers are configured in distributed-dig.json file. This file can exist in any of the following locations:
node -p process.cwd()node -p require('os').homedir()distributed-dig.js)The default options are:
"options": {
"request": {
"port": 53,
"type": "udp",
"timeout": 2500,
"try_edns": false,
"cache": false
},
"question": {
"type": "A"
}
}
Resolvers are configured in an array with each resolver having a nameServer element which should be the IPv4 or IPv6 address, and a provider element which is just a free-form text label:
"resolvers": [
{
"nameServer": "208.67.222.222",
"provider": "OpenDNS (Primary)"
},
{
"nameServer": "208.67.220.220",
"provider": "OpenDNS (Secondary)"
},
{
"nameServer": "217.199.173.113",
"provider": "United Kingdom"
}
]
You can find a list of public DNS servers here and tailor the configured list for your own requirements.
distributed-dig uses the npm package debug. If you set the environment variable debug to ddig you'll see full debug output.
set debug=ddig
DEBUG=ddig
$env:debug="ddig"
--unique which filters out duplicate addresses (but not errors)
debug)yargs)parseAnswer()pretty-error & is-valid-domain)ddig-core.jsreturn() function calls in ddig-core.jsCNAME records and their IP addressesyargs & is-valid-domain)pretty-error formatting to TryCatch blocks' console output.debug)yargs & is-valid-domain)warning when parsing certain command line arguments--list-resolvers and --list-optionsCNAME records to now include the first FQDN it resolves to along with the IP address.undefined reference when using --list-defaults.ddig ignores an input.TTL value.moment as a dependency and refactored time difference calculations to be handled natively.--verbose switch, allowing for the new 'TTL' and record type columns.Record Type to be Unknown due to erroneously locating the json lookup file when install globally.Record Type and TTL column values being undefined.TTL column width and made it right-aligned.nxdomain. Non-existent domains aren't DNS errors, just an empty answer - so now handling those more sensibly.npm-shrinkwrap.json problem that prevented npm update succeeding.chalk instead of colors.--list-defaults now pretty-prints the raw json output.process.stdout.isTTY is false 1.npm dependencies.--verbose support tp --help to display more information.chalk instead of colors (on --help output).yargs to version 14.2.0valid-filename.colors to version 1.4.0..debug logging.--config option.--config.--config option to specify an alternative configuration file.--list-defaults option which prints a default config json file to the console; useful as an initial custom configuration file.--timeout & --protocol.Warning logic for ignored domains to remove erroneous warnings with valid switches and options.Question: What terminal/console are you using in the screen shots?
Answer: A pre-release of Microsoft's new tabbed Windows Terminal which has many excellent features, and the ability to configure a background image.
FAQs
A utility which makes DNS lookup requests across multiple DNS resolvers and collates the results.
The npm package distributed-dig receives a total of 0 weekly downloads. As such, distributed-dig popularity was classified as not popular.
We found that distributed-dig demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.
Security News
A JavaScript library maintainer is under fire after merging a controversial PR to support legacy versions of Node.js.
Security News
Results from the 2023 State of JavaScript Survey highlight key trends, including Vite's dominance, rising TypeScript adoption, and the enduring popularity of React. Discover more insights on developer preferences and technology usage.