doc: note about DNS ANY queries / RFC 8482

PR-URL: #26695 Reviewed-By: Gus Caplan <[email protected]> Reviewed-By: Rich Trott <[email protected]> Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Bryan English <[email protected]> Reviewed-By: Ruben Bridgewater <[email protected]>
nodejs · Apr 17, 2019 · 1e6faf9 · 1e6faf9
1 parent 3eab58f
commit 1e6faf9
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/api/dns.md b/doc/api/dns.md
@@ -367,6 +367,10 @@ Here is an example of the `ret` object passed to the callback:
     minttl: 60 } ]
 ```
 
+DNS server operators may choose not to respond to `ANY`
+queries. It may be better to call individual methods like [`dns.resolve4()`][],
+[`dns.resolveMx()`][], and so on. For more details, see [RFC 8482][].
+
 ## dns.resolveCname(hostname, callback)
 <!-- YAML
 added: v0.3.2
@@ -1138,5 +1142,6 @@ uses. For instance, _they do not use the configuration from `/etc/hosts`_.
 [`util.promisify()`]: util.html#util_util_promisify_original
 [DNS error codes]: #dns_error_codes
 [Implementation considerations section]: #dns_implementation_considerations
+[RFC 8482]: https://tools.ietf.org/html/rfc8482
 [rfc5952]: https://tools.ietf.org/html/rfc5952#section-6
 [supported `getaddrinfo` flags]: #dns_supported_getaddrinfo_flags