Skip to main content
Go to Latest
File
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542
// Copyright 2018-2022 the Deno authors. All rights reserved. MIT license.// Copyright Joyent, Inc. and other Node contributors.//// Permission is hereby granted, free of charge, to any person obtaining a// copy of this software and associated documentation files (the// "Software"), to deal in the Software without restriction, including// without limitation the rights to use, copy, modify, merge, publish,// distribute, sublicense, and/or sell copies of the Software, and to permit// persons to whom the Software is furnished to do so, subject to the// following conditions://// The above copyright notice and this permission notice shall be included// in all copies or substantial portions of the Software.//// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE// USE OR OTHER DEALINGS IN THE SOFTWARE.
// This module ports:// - https://github.com/nodejs/node/blob/master/src/cares_wrap.cc// - https://github.com/nodejs/node/blob/master/src/cares_wrap.h
import type { ErrnoException } from "../internal/errors.ts";import { isIPv4 } from "../internal/net.ts";import { codeMap } from "./uv.ts";import { AsyncWrap, providerType } from "./async_wrap.ts";import { ares_strerror } from "./ares.ts";import { notImplemented } from "../_utils.ts";import { isWindows } from "../../_util/os.ts";
interface LookupAddress { address: string; family: number;}
export class GetAddrInfoReqWrap extends AsyncWrap { family!: number; hostname!: string;
callback!: ( err: ErrnoException | null, addressOrAddresses?: string | LookupAddress[] | null, family?: number, ) => void; resolve!: (addressOrAddresses: LookupAddress | LookupAddress[]) => void; reject!: (err: ErrnoException | null) => void; oncomplete!: (err: number | null, addresses: string[]) => void;
constructor() { super(providerType.GETADDRINFOREQWRAP); }}
export function getaddrinfo( req: GetAddrInfoReqWrap, hostname: string, family: number, _hints: number, verbatim: boolean,): number { let addresses: string[] = [];
// TODO(cmorten): use hints // REF: https://nodejs.org/api/dns.html#dns_supported_getaddrinfo_flags
const recordTypes: ("A" | "AAAA")[] = [];
if (family === 0 || family === 4) { recordTypes.push("A"); } if (family === 0 || family === 6) { recordTypes.push("AAAA"); }
(async () => { await Promise.allSettled( recordTypes.map((recordType) => Deno.resolveDns(hostname, recordType).then((records) => { records.forEach((record) => addresses.push(record)); }) ), );
const error = addresses.length ? 0 : codeMap.get("EAI_NODATA")!;
// TODO(cmorten): needs work // REF: https://github.com/nodejs/node/blob/master/src/cares_wrap.cc#L1444 if (!verbatim) { addresses.sort((a: string, b: string): number => { if (isIPv4(a)) { return -1; } else if (isIPv4(b)) { return 1; }
return 0; }); }
// TODO: Forces IPv4 as a workaround for Deno not // aligning with Node on implicit binding on Windows // REF: https://github.com/denoland/deno/issues/10762 if (isWindows && hostname === "localhost") { addresses = addresses.filter((address) => isIPv4(address)); }
req.oncomplete(error, addresses); })();
return 0;}
export class QueryReqWrap extends AsyncWrap { bindingName!: string; hostname!: string; ttl!: boolean;
callback!: ( err: ErrnoException | null, // deno-lint-ignore no-explicit-any records?: any, ) => void; // deno-lint-ignore no-explicit-any resolve!: (records: any) => void; reject!: (err: ErrnoException | null) => void; oncomplete!: ( err: number, // deno-lint-ignore no-explicit-any records: any, ttls?: number[], ) => void;
constructor() { super(providerType.QUERYWRAP); }}
export interface ChannelWrapQuery { queryAny(req: QueryReqWrap, name: string): number; queryA(req: QueryReqWrap, name: string): number; queryAaaa(req: QueryReqWrap, name: string): number; queryCaa(req: QueryReqWrap, name: string): number; queryCname(req: QueryReqWrap, name: string): number; queryMx(req: QueryReqWrap, name: string): number; queryNs(req: QueryReqWrap, name: string): number; queryTxt(req: QueryReqWrap, name: string): number; querySrv(req: QueryReqWrap, name: string): number; queryPtr(req: QueryReqWrap, name: string): number; queryNaptr(req: QueryReqWrap, name: string): number; querySoa(req: QueryReqWrap, name: string): number; getHostByAddr(req: QueryReqWrap, name: string): number;}
function fqdnToHostname(fqdn: string): string { return fqdn.replace(/\.$/, "");}
function compressIPv6(address: string): string { const formatted = address.replace(/\b(?:0+:){2,}/, ":"); const finalAddress = formatted .split(":") .map((octet) => { if (octet.match(/^\d+\.\d+\.\d+\.\d+$/)) { // decimal return Number(octet.replaceAll(".", "")).toString(16); }
return octet.replace(/\b0+/g, ""); }) .join(":");
return finalAddress;}
export class ChannelWrap extends AsyncWrap implements ChannelWrapQuery { #servers: [string, number][] = []; #timeout: number; #tries: number;
constructor(timeout: number, tries: number) { super(providerType.DNSCHANNEL);
this.#timeout = timeout; this.#tries = tries; }
async #query(query: string, recordType: Deno.RecordType) { // TODO: TTL logic.
let code: number; let ret: Awaited<ReturnType<typeof Deno.resolveDns>>;
if (this.#servers.length) { for (const [ipAddr, port] of this.#servers) { const resolveOptions = { nameServer: { ipAddr, port, }, };
({ code, ret } = await this.#resolve( query, recordType, resolveOptions, ));
if (code === 0 || code === codeMap.get("EAI_NODATA")!) { break; } } } else { ({ code, ret } = await this.#resolve(query, recordType)); }
return { code: code!, ret: ret! }; }
async #resolve( query: string, recordType: Deno.RecordType, resolveOptions?: Deno.ResolveDnsOptions, ): Promise<{ code: number; ret: Awaited<ReturnType<typeof Deno.resolveDns>>; }> { let ret: Awaited<ReturnType<typeof Deno.resolveDns>> = []; let code = 0;
try { ret = await Deno.resolveDns(query, recordType, resolveOptions); } catch (e) { if (e instanceof Deno.errors.NotFound) { code = codeMap.get("EAI_NODATA")!; } else { // TODO(cmorten): map errors to appropriate error codes. code = codeMap.get("UNKNOWN")!; } }
return { code, ret }; }
queryAny(req: QueryReqWrap, name: string): number { // TODO: implemented temporary measure to allow limited usage of // `resolveAny` like APIs. // // Ideally we move to using the "ANY" / "*" DNS query in future // REF: https://github.com/denoland/deno/issues/14492 (async () => { const records: { type: Deno.RecordType; [key: string]: unknown }[] = [];
await Promise.allSettled([ this.#query(name, "A").then(({ ret }) => { ret.forEach((record) => records.push({ type: "A", address: record })); }), this.#query(name, "AAAA").then(({ ret }) => { (ret as string[]).forEach((record) => records.push({ type: "AAAA", address: compressIPv6(record) }) ); }), this.#query(name, "CAA").then(({ ret }) => { (ret as Deno.CAARecord[]).forEach(({ critical, tag, value }) => records.push({ type: "CAA", [tag]: value, critical: +critical && 128, }) ); }), this.#query(name, "CNAME").then(({ ret }) => { ret.forEach((record) => records.push({ type: "CNAME", value: record }) ); }), this.#query(name, "MX").then(({ ret }) => { (ret as Deno.MXRecord[]).forEach(({ preference, exchange }) => records.push({ type: "MX", priority: preference, exchange: fqdnToHostname(exchange), }) ); }), this.#query(name, "NAPTR").then(({ ret }) => { (ret as Deno.NAPTRRecord[]).forEach( ({ order, preference, flags, services, regexp, replacement }) => records.push({ type: "NAPTR", order, preference, flags, service: services, regexp, replacement, }), ); }), this.#query(name, "NS").then(({ ret }) => { (ret as string[]).forEach((record) => records.push({ type: "NS", value: fqdnToHostname(record) }) ); }), this.#query(name, "PTR").then(({ ret }) => { (ret as string[]).forEach((record) => records.push({ type: "PTR", value: fqdnToHostname(record) }) ); }), this.#query(name, "SOA").then(({ ret }) => { (ret as Deno.SOARecord[]).forEach( ({ mname, rname, serial, refresh, retry, expire, minimum }) => records.push({ type: "SOA", nsname: fqdnToHostname(mname), hostmaster: fqdnToHostname(rname), serial, refresh, retry, expire, minttl: minimum, }), ); }), this.#query(name, "SRV").then(({ ret }) => { (ret as Deno.SRVRecord[]).forEach( ({ priority, weight, port, target }) => records.push({ type: "SRV", priority, weight, port, name: target, }), ); }), this.#query(name, "TXT").then(({ ret }) => { ret.forEach((record) => records.push({ type: "TXT", entries: record }) ); }), ]);
const err = records.length ? 0 : codeMap.get("EAI_NODATA")!;
req.oncomplete(err, records); })();
return 0; }
queryA(req: QueryReqWrap, name: string): number { this.#query(name, "A").then(({ code, ret }) => { req.oncomplete(code, ret); });
return 0; }
queryAaaa(req: QueryReqWrap, name: string): number { this.#query(name, "AAAA").then(({ code, ret }) => { const records = (ret as string[]).map((record) => compressIPv6(record));
req.oncomplete(code, records); });
return 0; }
queryCaa(req: QueryReqWrap, name: string): number { this.#query(name, "CAA").then(({ code, ret }) => { const records = (ret as Deno.CAARecord[]).map( ({ critical, tag, value }) => ({ [tag]: value, critical: +critical && 128, }), );
req.oncomplete(code, records); });
return 0; }
queryCname(req: QueryReqWrap, name: string): number { this.#query(name, "CNAME").then(({ code, ret }) => { req.oncomplete(code, ret); });
return 0; }
queryMx(req: QueryReqWrap, name: string): number { this.#query(name, "MX").then(({ code, ret }) => { const records = (ret as Deno.MXRecord[]).map( ({ preference, exchange }) => ({ priority: preference, exchange: fqdnToHostname(exchange), }), );
req.oncomplete(code, records); });
return 0; }
queryNaptr(req: QueryReqWrap, name: string): number { this.#query(name, "NAPTR").then(({ code, ret }) => { const records = (ret as Deno.NAPTRRecord[]).map( ({ order, preference, flags, services, regexp, replacement }) => ({ flags, service: services, regexp, replacement, order, preference, }), );
req.oncomplete(code, records); });
return 0; }
queryNs(req: QueryReqWrap, name: string): number { this.#query(name, "NS").then(({ code, ret }) => { const records = (ret as string[]).map((record) => fqdnToHostname(record));
req.oncomplete(code, records); });
return 0; }
queryPtr(req: QueryReqWrap, name: string): number { this.#query(name, "PTR").then(({ code, ret }) => { const records = (ret as string[]).map((record) => fqdnToHostname(record));
req.oncomplete(code, records); });
return 0; }
querySoa(req: QueryReqWrap, name: string): number { this.#query(name, "SOA").then(({ code, ret }) => { let record = {};
if (ret.length) { const { mname, rname, serial, refresh, retry, expire, minimum } = ret[0] as Deno.SOARecord;
record = { nsname: fqdnToHostname(mname), hostmaster: fqdnToHostname(rname), serial, refresh, retry, expire, minttl: minimum, }; }
req.oncomplete(code, record); });
return 0; }
querySrv(req: QueryReqWrap, name: string): number { this.#query(name, "SRV").then(({ code, ret }) => { const records = (ret as Deno.SRVRecord[]).map( ({ priority, weight, port, target }) => ({ priority, weight, port, name: target, }), );
req.oncomplete(code, records); });
return 0; }
queryTxt(req: QueryReqWrap, name: string): number { this.#query(name, "TXT").then(({ code, ret }) => { req.oncomplete(code, ret); });
return 0; }
getHostByAddr(_req: QueryReqWrap, _name: string): number { // TODO: https://github.com/denoland/deno/issues/14432 notImplemented("cares.ChannelWrap.prototype.getHostByAddr"); }
getServers(): [string, number][] { return this.#servers; }
setServers(servers: string | [number, string, number][]): number { if (typeof servers === "string") { const tuples: [string, number][] = [];
for (let i = 0; i < servers.length; i += 2) { tuples.push([servers[i], parseInt(servers[i + 1])]); }
this.#servers = tuples; } else { this.#servers = servers.map(([_ipVersion, ip, port]) => [ip, port]); }
return 0; }
setLocalAddress(_addr0: string, _addr1?: string): void { notImplemented("cares.ChannelWrap.prototype.setLocalAddress"); }
cancel() { notImplemented("cares.ChannelWrap.prototype.cancel"); }}
const DNS_ESETSRVPENDING = -1000;const EMSG_ESETSRVPENDING = "There are pending queries.";
export function strerror(code: number) { return code === DNS_ESETSRVPENDING ? EMSG_ESETSRVPENDING : ares_strerror(code);}