@@ -54,11 +54,17 @@ There are subtle consequences in choosing one over the other, please consult
5454the [ Implementation considerations section] [ ] for more information.
5555
5656## dns.getServers()
57+ <!-- YAML
58+ added: v0.11.3
59+ -->
5760
5861Returns an array of IP address strings that are being used for name
5962resolution.
6063
6164## dns.lookup(hostname[ , options] , callback)
65+ <!-- YAML
66+ added: v0.1.90
67+ -->
6268
6369Resolves a hostname (e.g. ` 'nodejs.org' ` ) into the first found A (IPv4) or
6470AAAA (IPv6) record. ` options ` can be an object or integer. If ` options ` is
@@ -122,6 +128,9 @@ found, then return IPv4 mapped IPv6 addresses. Note that it is not supported
122128on some operating systems (e.g FreeBSD 10.1).
123129
124130## dns.lookupService(address, port, callback)
131+ <!-- YAML
132+ added: v0.11.14
133+ -->
125134
126135Resolves the given ` address ` and ` port ` into a hostname and service using
127136the operating system's underlying ` getnameinfo ` implementation.
@@ -144,6 +153,9 @@ dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
144153```
145154
146155## dns.resolve(hostname[ , rrtype] , callback)
156+ <!-- YAML
157+ added: v0.1.27
158+ -->
147159
148160Uses the DNS protocol to resolve a hostname (e.g. ` 'nodejs.org' ` ) into an
149161array of the record types specified by ` rrtype ` .
@@ -170,33 +182,48 @@ On error, `err` is an [`Error`][] object, where `err.code` is
170182one of the error codes listed [ here] ( #dns_error_codes ) .
171183
172184## dns.resolve4(hostname, callback)
185+ <!-- YAML
186+ added: v0.1.16
187+ -->
173188
174189Uses the DNS protocol to resolve a IPv4 addresses (` A ` records) for the
175190` hostname ` . The ` addresses ` argument passed to the ` callback ` function
176191will contain an array of IPv4 addresses (e.g.
177192` ['74.125.79.104', '74.125.79.105', '74.125.79.106'] ` ).
178193
179194## dns.resolve6(hostname, callback)
195+ <!-- YAML
196+ added: v0.1.16
197+ -->
180198
181199Uses the DNS protocol to resolve a IPv6 addresses (` AAAA ` records) for the
182200` hostname ` . The ` addresses ` argument passed to the ` callback ` function
183201will contain an array of IPv6 addresses.
184202
185203## dns.resolveCname(hostname, callback)
204+ <!-- YAML
205+ added: v0.3.2
206+ -->
186207
187208Uses the DNS protocol to resolve ` CNAME ` records for the ` hostname ` . The
188209` addresses ` argument passed to the ` callback ` function
189210will contain an array of canonical name records available for the ` hostname `
190211(e.g. ` ['bar.example.com'] ` ).
191212
192213## dns.resolveMx(hostname, callback)
214+ <!-- YAML
215+ added: v0.1.27
216+ -->
193217
194218Uses the DNS protocol to resolve mail exchange records (` MX ` records) for the
195219` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
196220contain an array of objects containing both a ` priority ` and ` exchange `
197221property (e.g. ` [{priority: 10, exchange: 'mx.example.com'}, ...] ` ).
198222
199223## dns.resolveNaptr(hostname, callback)
224+ <!-- YAML
225+ added: v0.9.12
226+ -->
200227
201228Uses the DNS protocol to resolve regular expression based records (` NAPTR `
202229records) for the ` hostname ` . The ` callback ` function has arguments
@@ -224,13 +251,19 @@ For example:
224251```
225252
226253## dns.resolveNs(hostname, callback)
254+ <!-- YAML
255+ added: v0.1.90
256+ -->
227257
228258Uses the DNS protocol to resolve name server records (` NS ` records) for the
229259` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
230260contain an array of name server records available for ` hostname `
231261(e.g., ` ['ns1.example.com', 'ns2.example.com'] ` ).
232262
233263## dns.resolveSoa(hostname, callback)
264+ <!-- YAML
265+ added: v0.11.10
266+ -->
234267
235268Uses the DNS protocol to resolve a start of authority record (` SOA ` record) for
236269the ` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -257,6 +290,9 @@ be an object with the following properties:
257290```
258291
259292## dns.resolveSrv(hostname, callback)
293+ <!-- YAML
294+ added: v0.1.27
295+ -->
260296
261297Uses the DNS protocol to resolve service records (` SRV ` records) for the
262298` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -277,12 +313,18 @@ be an array of objects with the following properties:
277313```
278314
279315## dns.resolvePtr(hostname, callback)
316+ <!-- YAML
317+ added: v6.0.0
318+ -->
280319
281320Uses the DNS protocol to resolve pointer records (` PTR ` records) for the
282321` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
283322be an array of strings containing the reply records.
284323
285324## dns.resolveTxt(hostname, callback)
325+ <!-- YAML
326+ added: v0.1.27
327+ -->
286328
287329Uses the DNS protocol to resolve text queries (` TXT ` records) for the
288330` hostname ` . The ` addresses ` argument passed to the ` callback ` function is
@@ -292,6 +334,9 @@ one record. Depending on the use case, these could be either joined together or
292334treated separately.
293335
294336## dns.reverse(ip, callback)
337+ <!-- YAML
338+ added: v0.1.16
339+ -->
295340
296341Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
297342array of hostnames.
@@ -303,6 +348,9 @@ On error, `err` is an [`Error`][] object, where `err.code` is
303348one of the [ DNS error codes] [ ] .
304349
305350## dns.setServers(servers)
351+ <!-- YAML
352+ added: v0.11.3
353+ -->
306354
307355Sets the IP addresses of the servers to be used when resolving. The ` servers `
308356argument is an array of IPv4 or IPv6 addresses.
0 commit comments