Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nodejs/node.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorQuentin Headen <qheaden@phaseshiftsoftware.com>2016-07-04 12:12:32 +0300
committerAnna Henningsen <anna@addaleax.net>2016-07-11 20:59:56 +0300
commitfcae5e2d9187b4a9c16cbce843c10e2087990946 (patch)
tree0e2292c6313cddd4b7a803e1862cdecd8c19d2e6 /doc/api/dns.md
parentaab306679efbf7db6cad7fcf6f4486a2b521b720 (diff)
doc: dns.resolve fix callback argument description
The dns.resolve documentation stated that an array of IP addresses would be returned in the callback. This is true for everything other than the SOA record which returns an object. This fixes that documentation. Fixes: https://github.com/nodejs/node/issues/6506 PR-URL: https://github.com/nodejs/node/pull/7532 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Roman Reiss <me@silverwind.io>
Diffstat (limited to 'doc/api/dns.md')
-rw-r--r--doc/api/dns.md5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/api/dns.md b/doc/api/dns.md
index 7dd74903254..3f90d632a85 100644
--- a/doc/api/dns.md
+++ b/doc/api/dns.md
@@ -174,7 +174,9 @@ Valid values for `rrtype` are:
* `'NAPTR'` - name authority pointer record
The `callback` function has arguments `(err, addresses)`. When successful,
-`addresses` will be an array. The type of each item in `addresses` is
+`addresses` will be an array, except when resolving an SOA record which returns
+an object structured in the same manner as one returned by the
+[`dns.resolveSoa()`][] method. The type of each item in `addresses` is
determined by the record type, and described in the documentation for the
corresponding lookup methods.
@@ -437,6 +439,7 @@ uses. For instance, _they do not use the configuration from `/etc/hosts`_.
[`dns.lookup()`]: #dns_dns_lookup_hostname_options_callback
[`dns.resolve()`]: #dns_dns_resolve_hostname_rrtype_callback
[`dns.resolve4()`]: #dns_dns_resolve4_hostname_callback
+[`dns.resolveSoa()`]: #dns_dns_resolvesoa_hostname_callback
[`Error`]: errors.html#errors_class_error
[Implementation considerations section]: #dns_implementation_considerations
[supported `getaddrinfo` flags]: #dns_supported_getaddrinfo_flags