# dnstools
> An all in one dns related tools
Latest version **2.0.3** (published 2019-10-09) · Apache-2.0 license · 0 weekly downloads
## Install
```sh
npm install dnstools
pnpm add dnstools
yarn add dnstools
bun add dnstools
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 2.0.3 |
| Published | 2019-10-09 |
| First published | 2019-01-04 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 60.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Gurkirat Singh |
| Maintainers | tbhaxor |
| Keywords | view-dns, tbhaxor, dns, api, dnstools, tools |
## Links
- npm: https://www.npmjs.com/package/dnstools
- Repository: https://github.com/tbhaxor/node-dnstools
- Homepage: https://github.com/tbhaxor/node-dnstools#readme
- Issues: https://github.com/tbhaxor/node-dnstools/issues
- npm.io page: https://npm.io/package/dnstools
## Recent versions
- 2.0.3 (latest) — 2019-10-09
- 2.0.0 (stable) — 2019-02-08
- 2.0.2 — 2019-02-17
- 2.0.1 — 2019-02-16
- 1.0.4 — 2019-01-05
- 1.0.3 — 2019-01-05
- 1.0.2 — 2019-01-04
- 1.0.1 — 2019-01-04
## README
DNS Tools
> All in one library for dns query
DNS Tools is powered by [view-dns](https://viewdns.info) and [ip-api](http://ip-api.com). It provides you with a bunch of dns related search api.
## Node versions
v8.15.0 +
## Features
- All in one DNS Query Library
- No Dependency
- Formatted OUTPUT
- Fast
- Reliable
## Functions
- [x] Reverse IP Lookup
- [x] IP To Location
- [x] Check if host is down
- [x] ASN Lookup
- [x] Reverse MX Lookup
- [x] Chinese Firewall Test
- [x] Port Scan
- [x] IP History
- [x] DNS Report
- [x] DNSSEC Test
- [ ] WHOIS Report
- [ ] Reverse Whois Lookup
- [ ] Iran Firewall Test
- [ ] DNS Record Lookup
- [ ] Spam Database Lookup
- [ ] Abuse Contact Lookup
- [ ] Reverse NS Lookup
- [ ] DNS Propagation Checker
- [ ] Reverse DNS Lookup
- [ ] MAC Address Lookup
## Install and Use
npm i dnstools@latest
Demonstrating `IP Location`
```js
const dnstool = require("dnstools");
dnstool.ipLocation("172.9.8.5", (err, data) => {
if (err) {
console.log("error in query");
} else {
console.log(data);
/* OUTPUT
{ as: 'AS7018 AT&T Services, Inc.',
city: 'Los Angeles',
country: 'United States',
countryCode: 'US',
isp: 'AT&T Services, Inc.',
lat: 34.0818,
lon: -118.1753,
org: 'AT&T Corp',
query: '172.9.8.5',
region: 'CA',
regionName: 'California',
status: 'success',
timezone: 'America/Los_Angeles',
zip: '90032' }
*/
}
});
```
## API
| Function | Description | Parameters | Callback Data |
| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- | :-------------------------------------------- |
| reverseIp | Reverse lookup to quickly shows all other domains hosted from the same server. | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Array` |
| ipLocation | Display geographic information about a supplied IP address including city, country, latitude, longitude and more. | ip: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Object` |
| isHostDown | Checks whether a specified site is down or not. | host: `string`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Boolean` |
| asnLookup | Determine which company owns the specified Autonomous System Number | asn: `Number`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Object` |
| reverseMX | Takes a mail server (e.g. `mail.google.com`) and quickly shows all other domains that use the same mail server | mailServer: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Array` |
| chineseFirewall | Checks whether a site is blocked by the Great Firewall of China | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Array` |
| portScan | Port scanner will test whether common ports are open on a server. Ports scanned are: 21, 22, 23, 25, 80, 110, 139, 143, 445, 1433, 1521, 3306 and 3389 | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Array` |
| ipHistory | Shows a historical list of IP addresses a given domain name has been hosted on as well as where that IP address is geographically located, and the owner of that IP address. | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Array` |
| dnssec | Test if any domain name is configured for DNSSEC (Domain Name System Security Extensions). | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Object` |
| dnsreport | View a complete report on the DNS settings for your domain. This tool is designed to assist webmasters and system administrators diagnose DNS related issues. A number of tests are run on your DNS settings with results displayed in an easy to understand manner. | host: `String`
callback: `callback(err, data)` | err: `Error` or `String`
data: `Object` |
## License
DNS Tool is licensed under [Apache-2.0](https://github.com/tbhaxor/dnstools/blob/master/LICENSE)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Ftbhaxor%2Fnode-dnstools?ref=badge_large)
## Contribution
Read contribution guidelines from [here](https://github.com/tbhaxor/dnstools/blob/master/CONTRIBUTING.md)
---
_Source: https://npm.io/package/dnstools · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._