/*

[0] Fix | Delete

* Copyright (C) Internet Systems Consortium, Inc. ("ISC")

[1] Fix | Delete

*

[2] Fix | Delete

* This Source Code Form is subject to the terms of the Mozilla Public

[3] Fix | Delete

* License, v. 2.0. If a copy of the MPL was not distributed with this

[4] Fix | Delete

* file, you can obtain one at https://mozilla.org/MPL/2.0/.

[5] Fix | Delete

*

[6] Fix | Delete

* See the COPYRIGHT file distributed with this work for additional

[7] Fix | Delete

* information regarding copyright ownership.

[8] Fix | Delete

*/

[9] Fix | Delete

[10] Fix | Delete

#ifndef DNS_RESOLVER_H

[11] Fix | Delete

#define DNS_RESOLVER_H 1

[12] Fix | Delete

[13] Fix | Delete

/*****

[14] Fix | Delete

***** Module Info

[15] Fix | Delete

*****/

[16] Fix | Delete

[17] Fix | Delete

/*! \file dns/resolver.h

[18] Fix | Delete

*

[19] Fix | Delete

* \brief

[20] Fix | Delete

* This is the BIND 9 resolver, the module responsible for resolving DNS

[21] Fix | Delete

* requests by iteratively querying authoritative servers and following

[22] Fix | Delete

* referrals. This is a "full resolver", not to be confused with

[23] Fix | Delete

* the stub resolvers most people associate with the word "resolver".

[24] Fix | Delete

* The full resolver is part of the caching name server or resolver

[25] Fix | Delete

* daemon the stub resolver talks to.

[26] Fix | Delete

*

[27] Fix | Delete

* MP:

[28] Fix | Delete

*\li The module ensures appropriate synchronization of data structures it

[29] Fix | Delete

* creates and manipulates.

[30] Fix | Delete

*

[31] Fix | Delete

* Reliability:

[32] Fix | Delete

*\li No anticipated impact.

[33] Fix | Delete

*

[34] Fix | Delete

* Resources:

[35] Fix | Delete

*\li TBS

[36] Fix | Delete

*

[37] Fix | Delete

* Security:

[38] Fix | Delete

*\li No anticipated impact.

[39] Fix | Delete

*

[40] Fix | Delete

* Standards:

[41] Fix | Delete

*\li RFCs: 1034, 1035, 2181, TBS

[42] Fix | Delete

*\li Drafts: TBS

[43] Fix | Delete

*/

[44] Fix | Delete

[45] Fix | Delete

#include <inttypes.h>

[46] Fix | Delete

#include <stdbool.h>

[47] Fix | Delete

[48] Fix | Delete

#include <isc/lang.h>

[49] Fix | Delete

#include <isc/socket.h>

[50] Fix | Delete

#include <isc/stats.h>

[51] Fix | Delete

[52] Fix | Delete

#include <dns/types.h>

[53] Fix | Delete

#include <dns/fixedname.h>

[54] Fix | Delete

[55] Fix | Delete

ISC_LANG_BEGINDECLS

[56] Fix | Delete

[57] Fix | Delete

/*%

[58] Fix | Delete

* A dns_fetchevent_t is sent when a 'fetch' completes. Any of 'db',

[59] Fix | Delete

* 'node', 'rdataset', and 'sigrdataset' may be bound. It is the

[60] Fix | Delete

* receiver's responsibility to detach before freeing the event.

[61] Fix | Delete

* \brief

[62] Fix | Delete

* 'rdataset', 'sigrdataset', 'client' and 'id' are the values that were

[63] Fix | Delete

* supplied when dns_resolver_createfetch() was called. They are returned

[64] Fix | Delete

* to the caller so that they may be freed.

[65] Fix | Delete

*/

[66] Fix | Delete

typedef struct dns_fetchevent {

[67] Fix | Delete

ISC_EVENT_COMMON(struct dns_fetchevent);

[68] Fix | Delete

dns_fetch_t * fetch;

[69] Fix | Delete

isc_result_t result;

[70] Fix | Delete

dns_rdatatype_t qtype;

[71] Fix | Delete

dns_db_t * db;

[72] Fix | Delete

dns_dbnode_t * node;

[73] Fix | Delete

dns_rdataset_t * rdataset;

[74] Fix | Delete

dns_rdataset_t * sigrdataset;

[75] Fix | Delete

dns_fixedname_t foundname;

[76] Fix | Delete

isc_sockaddr_t * client;

[77] Fix | Delete

dns_messageid_t id;

[78] Fix | Delete

isc_result_t vresult;

[79] Fix | Delete

} dns_fetchevent_t;

[80] Fix | Delete

[81] Fix | Delete

/*%

[82] Fix | Delete

* The two quota types (fetches-per-zone and fetches-per-server)

[83] Fix | Delete

*/

[84] Fix | Delete

typedef enum {

[85] Fix | Delete

dns_quotatype_zone = 0,

[86] Fix | Delete

dns_quotatype_server

[87] Fix | Delete

} dns_quotatype_t;

[88] Fix | Delete

[89] Fix | Delete

/*

[90] Fix | Delete

* Options that modify how a 'fetch' is done.

[91] Fix | Delete

*/

[92] Fix | Delete

#define DNS_FETCHOPT_TCP 0x00001 /*%< Use TCP. */

[93] Fix | Delete

#define DNS_FETCHOPT_UNSHARED 0x00002 /*%< See below. */

[94] Fix | Delete

#define DNS_FETCHOPT_RECURSIVE 0x00004 /*%< Set RD? */

[95] Fix | Delete

#define DNS_FETCHOPT_NOEDNS0 0x00008 /*%< Do not use EDNS. */

[96] Fix | Delete

#define DNS_FETCHOPT_FORWARDONLY 0x00010 /*%< Only use forwarders. */

[97] Fix | Delete

#define DNS_FETCHOPT_NOVALIDATE 0x00020 /*%< Disable validation. */

[98] Fix | Delete

#define DNS_FETCHOPT_EDNS512 0x00040 /*%< Advertise a 512 byte

[99] Fix | Delete

0 UDP buffer. */

[100] Fix | Delete

#define DNS_FETCHOPT_WANTNSID 0x00080 /*%< Request NSID */

[101] Fix | Delete

#define DNS_FETCHOPT_PREFETCH 0x00100 /*%< Do prefetch */

[102] Fix | Delete

#define DNS_FETCHOPT_NOCDFLAG 0x00200 /*%< Don't set CD flag. */

[103] Fix | Delete

#define DNS_FETCHOPT_NONTA 0x00400 /*%< Ignore NTA table. */

[104] Fix | Delete

/* RESERVED ECS 0x00000 */

[105] Fix | Delete

/* RESERVED ECS 0x01000 */

[106] Fix | Delete

/* RESERVED ECS 0x02000 */

[107] Fix | Delete

/* RESERVED TCPCLIENT 0x04000 */

[108] Fix | Delete

#define DNS_FETCHOPT_NOCACHED 0x08000 /*%< Force cache update. */

[109] Fix | Delete

#define DNS_FETCHOPT_NOFORWARD 0x80000 /*%< Do not use forwarders

[110] Fix | Delete

if possible. */

[111] Fix | Delete

[112] Fix | Delete

/* Reserved in use by adb.c 0x00400000 */

[113] Fix | Delete

#define DNS_FETCHOPT_EDNSVERSIONSET 0x00800000

[114] Fix | Delete

#define DNS_FETCHOPT_EDNSVERSIONMASK 0xff000000

[115] Fix | Delete

#define DNS_FETCHOPT_EDNSVERSIONSHIFT 24

[116] Fix | Delete

[117] Fix | Delete

/*

[118] Fix | Delete

* Upper bounds of class of query RTT (ms). Corresponds to

[119] Fix | Delete

* dns_resstatscounter_queryrttX statistics counters.

[120] Fix | Delete

*/

[121] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS0 10

[122] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS0STR "10"

[123] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS1 100

[124] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS1STR "100"

[125] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS2 500

[126] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS2STR "500"

[127] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS3 800

[128] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS3STR "800"

[129] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS4 1600

[130] Fix | Delete

#define DNS_RESOLVER_QRYRTTCLASS4STR "1600"

[131] Fix | Delete

[132] Fix | Delete

/*

[133] Fix | Delete

* XXXRTH Should this API be made semi-private? (I.e.

[134] Fix | Delete

* _dns_resolver_create()).

[135] Fix | Delete

*/

[136] Fix | Delete

[137] Fix | Delete

#define DNS_RESOLVER_CHECKNAMES 0x01

[138] Fix | Delete

#define DNS_RESOLVER_CHECKNAMESFAIL 0x02

[139] Fix | Delete

[140] Fix | Delete

isc_result_t

[141] Fix | Delete

dns_resolver_create(dns_view_t *view,

[142] Fix | Delete

isc_taskmgr_t *taskmgr,

[143] Fix | Delete

unsigned int ntasks, unsigned int ndisp,

[144] Fix | Delete

isc_socketmgr_t *socketmgr,

[145] Fix | Delete

isc_timermgr_t *timermgr,

[146] Fix | Delete

unsigned int options,

[147] Fix | Delete

dns_dispatchmgr_t *dispatchmgr,

[148] Fix | Delete

dns_dispatch_t *dispatchv4,

[149] Fix | Delete

dns_dispatch_t *dispatchv6,

[150] Fix | Delete

dns_resolver_t **resp);

[151] Fix | Delete

[152] Fix | Delete

/*%<

[153] Fix | Delete

* Create a resolver.

[154] Fix | Delete

*

[155] Fix | Delete

* Notes:

[156] Fix | Delete

*

[157] Fix | Delete

*\li Generally, applications should not create a resolver directly, but

[158] Fix | Delete

* should instead call dns_view_createresolver().

[159] Fix | Delete

*

[160] Fix | Delete

* Requires:

[161] Fix | Delete

*

[162] Fix | Delete

*\li 'view' is a valid view.

[163] Fix | Delete

*

[164] Fix | Delete

*\li 'taskmgr' is a valid task manager.

[165] Fix | Delete

*

[166] Fix | Delete

*\li 'ntasks' > 0.

[167] Fix | Delete

*

[168] Fix | Delete

*\li 'socketmgr' is a valid socket manager.

[169] Fix | Delete

*

[170] Fix | Delete

*\li 'timermgr' is a valid timer manager.

[171] Fix | Delete

*

[172] Fix | Delete

*\li 'dispatchv4' is a dispatch with an IPv4 UDP socket, or is NULL.

[173] Fix | Delete

* If not NULL, 'ndisp' clones of it will be created by the resolver.

[174] Fix | Delete

*

[175] Fix | Delete

*\li 'dispatchv6' is a dispatch with an IPv6 UDP socket, or is NULL.

[176] Fix | Delete

* If not NULL, 'ndisp' clones of it will be created by the resolver.

[177] Fix | Delete

*

[178] Fix | Delete

*\li resp != NULL && *resp == NULL.

[179] Fix | Delete

*

[180] Fix | Delete

* Returns:

[181] Fix | Delete

*

[182] Fix | Delete

*\li #ISC_R_SUCCESS On success.

[183] Fix | Delete

*

[184] Fix | Delete

*\li Anything else Failure.

[185] Fix | Delete

*/

[186] Fix | Delete

[187] Fix | Delete

void

[188] Fix | Delete

dns_resolver_freeze(dns_resolver_t *res);

[189] Fix | Delete

/*%<

[190] Fix | Delete

* Freeze resolver.

[191] Fix | Delete

*

[192] Fix | Delete

* Notes:

[193] Fix | Delete

*

[194] Fix | Delete

*\li Certain configuration changes cannot be made after the resolver

[195] Fix | Delete

* is frozen. Fetches cannot be created until the resolver is frozen.

[196] Fix | Delete

*

[197] Fix | Delete

* Requires:

[198] Fix | Delete

*

[199] Fix | Delete

*\li 'res' is a valid resolver.

[200] Fix | Delete

*

[201] Fix | Delete

* Ensures:

[202] Fix | Delete

*

[203] Fix | Delete

*\li 'res' is frozen.

[204] Fix | Delete

*/

[205] Fix | Delete

[206] Fix | Delete

void

[207] Fix | Delete

dns_resolver_prime(dns_resolver_t *res);

[208] Fix | Delete

/*%<

[209] Fix | Delete

* Prime resolver.

[210] Fix | Delete

*

[211] Fix | Delete

* Notes:

[212] Fix | Delete

*

[213] Fix | Delete

*\li Resolvers which have a forwarding policy other than dns_fwdpolicy_only

[214] Fix | Delete

* need to be primed with the root nameservers, otherwise the root

[215] Fix | Delete

* nameserver hints data may be used indefinitely. This function requests

[216] Fix | Delete

* that the resolver start a priming fetch, if it isn't already priming.

[217] Fix | Delete

*

[218] Fix | Delete

* Requires:

[219] Fix | Delete

*

[220] Fix | Delete

*\li 'res' is a valid, frozen resolver.

[221] Fix | Delete

*/

[222] Fix | Delete

[223] Fix | Delete

[224] Fix | Delete

void

[225] Fix | Delete

dns_resolver_whenshutdown(dns_resolver_t *res, isc_task_t *task,

[226] Fix | Delete

isc_event_t **eventp);

[227] Fix | Delete

/*%<

[228] Fix | Delete

* Send '*eventp' to 'task' when 'res' has completed shutdown.

[229] Fix | Delete

*

[230] Fix | Delete

* Notes:

[231] Fix | Delete

*

[232] Fix | Delete

*\li It is not safe to detach the last reference to 'res' until

[233] Fix | Delete

* shutdown is complete.

[234] Fix | Delete

*

[235] Fix | Delete

* Requires:

[236] Fix | Delete

*

[237] Fix | Delete

*\li 'res' is a valid resolver.

[238] Fix | Delete

*

[239] Fix | Delete

*\li 'task' is a valid task.

[240] Fix | Delete

*

[241] Fix | Delete

*\li *eventp is a valid event.

[242] Fix | Delete

*

[243] Fix | Delete

* Ensures:

[244] Fix | Delete

*

[245] Fix | Delete

*\li *eventp == NULL.

[246] Fix | Delete

*/

[247] Fix | Delete

[248] Fix | Delete

void

[249] Fix | Delete

dns_resolver_shutdown(dns_resolver_t *res);

[250] Fix | Delete

/*%<

[251] Fix | Delete

* Start the shutdown process for 'res'.

[252] Fix | Delete

*

[253] Fix | Delete

* Notes:

[254] Fix | Delete

*

[255] Fix | Delete

*\li This call has no effect if the resolver is already shutting down.

[256] Fix | Delete

*

[257] Fix | Delete

* Requires:

[258] Fix | Delete

*

[259] Fix | Delete

*\li 'res' is a valid resolver.

[260] Fix | Delete

*/

[261] Fix | Delete

[262] Fix | Delete

void

[263] Fix | Delete

dns_resolver_attach(dns_resolver_t *source, dns_resolver_t **targetp);

[264] Fix | Delete

[265] Fix | Delete

void

[266] Fix | Delete

dns_resolver_detach(dns_resolver_t **resp);

[267] Fix | Delete

[268] Fix | Delete

isc_result_t

[269] Fix | Delete

dns_resolver_createfetch(dns_resolver_t *res, dns_name_t *name,

[270] Fix | Delete

dns_rdatatype_t type,

[271] Fix | Delete

dns_name_t *domain, dns_rdataset_t *nameservers,

[272] Fix | Delete

dns_forwarders_t *forwarders,

[273] Fix | Delete

unsigned int options, isc_task_t *task,

[274] Fix | Delete

isc_taskaction_t action, void *arg,

[275] Fix | Delete

dns_rdataset_t *rdataset,

[276] Fix | Delete

dns_rdataset_t *sigrdataset,

[277] Fix | Delete

dns_fetch_t **fetchp);

[278] Fix | Delete

[279] Fix | Delete

isc_result_t

[280] Fix | Delete

dns_resolver_createfetch2(dns_resolver_t *res, dns_name_t *name,

[281] Fix | Delete

dns_rdatatype_t type,

[282] Fix | Delete

dns_name_t *domain, dns_rdataset_t *nameservers,

[283] Fix | Delete

dns_forwarders_t *forwarders,

[284] Fix | Delete

isc_sockaddr_t *client, uint16_t id,

[285] Fix | Delete

unsigned int options, isc_task_t *task,

[286] Fix | Delete

isc_taskaction_t action, void *arg,

[287] Fix | Delete

dns_rdataset_t *rdataset,

[288] Fix | Delete

dns_rdataset_t *sigrdataset,

[289] Fix | Delete

dns_fetch_t **fetchp);

[290] Fix | Delete

isc_result_t

[291] Fix | Delete

dns_resolver_createfetch3(dns_resolver_t *res, dns_name_t *name,

[292] Fix | Delete

dns_rdatatype_t type,

[293] Fix | Delete

dns_name_t *domain, dns_rdataset_t *nameservers,

[294] Fix | Delete

dns_forwarders_t *forwarders,

[295] Fix | Delete

isc_sockaddr_t *client, uint16_t id,

[296] Fix | Delete

unsigned int options, unsigned int depth,

[297] Fix | Delete

isc_counter_t *qc, isc_task_t *task,

[298] Fix | Delete

isc_taskaction_t action, void *arg,

[299] Fix | Delete

dns_rdataset_t *rdataset,

[300] Fix | Delete

dns_rdataset_t *sigrdataset,

[301] Fix | Delete

dns_fetch_t **fetchp);

[302] Fix | Delete

/*%<

[303] Fix | Delete

* Recurse to answer a question.

[304] Fix | Delete

*

[305] Fix | Delete

* Notes:

[306] Fix | Delete

*

[307] Fix | Delete

*\li This call starts a query for 'name', type 'type'.

[308] Fix | Delete

*

[309] Fix | Delete

*\li The 'domain' is a parent domain of 'name' for which

[310] Fix | Delete

* a set of name servers 'nameservers' is known. If no

[311] Fix | Delete

* such name server information is available, set

[312] Fix | Delete

* 'domain' and 'nameservers' to NULL.

[313] Fix | Delete

*

[314] Fix | Delete

*\li 'forwarders' is unimplemented, and subject to change when

[315] Fix | Delete

* we figure out how selective forwarding will work.

[316] Fix | Delete

*

[317] Fix | Delete

*\li When the fetch completes (successfully or otherwise), a

[318] Fix | Delete

* #DNS_EVENT_FETCHDONE event with action 'action' and arg 'arg' will be

[319] Fix | Delete

* posted to 'task'.

[320] Fix | Delete

*

[321] Fix | Delete

*\li The values of 'rdataset' and 'sigrdataset' will be returned in

[322] Fix | Delete

* the FETCHDONE event.

[323] Fix | Delete

*

[324] Fix | Delete

*\li 'client' and 'id' are used for duplicate query detection. '*client'

[325] Fix | Delete

* must remain stable until after 'action' has been called or

[326] Fix | Delete

* dns_resolver_cancelfetch() is called.

[327] Fix | Delete

*

[328] Fix | Delete

* Requires:

[329] Fix | Delete

*

[330] Fix | Delete

*\li 'res' is a valid resolver that has been frozen.

[331] Fix | Delete

*

[332] Fix | Delete

*\li 'name' is a valid name.

[333] Fix | Delete

*

[334] Fix | Delete

*\li 'type' is not a meta type other than ANY.

[335] Fix | Delete

*

[336] Fix | Delete

*\li 'domain' is a valid name or NULL.

[337] Fix | Delete

*

[338] Fix | Delete

*\li 'nameservers' is a valid NS rdataset (whose owner name is 'domain')

[339] Fix | Delete

* iff. 'domain' is not NULL.

[340] Fix | Delete

*

[341] Fix | Delete

*\li 'forwarders' is NULL.

[342] Fix | Delete

*

[343] Fix | Delete

*\li 'client' is a valid sockaddr or NULL.

[344] Fix | Delete

*

[345] Fix | Delete

*\li 'options' contains valid options.

[346] Fix | Delete

*

[347] Fix | Delete

*\li 'rdataset' is a valid, disassociated rdataset.

[348] Fix | Delete

*

[349] Fix | Delete

*\li 'sigrdataset' is NULL, or is a valid, disassociated rdataset.

[350] Fix | Delete

*

[351] Fix | Delete

*\li fetchp != NULL && *fetchp == NULL.

[352] Fix | Delete

*

[353] Fix | Delete

* Returns:

[354] Fix | Delete

*

[355] Fix | Delete

*\li #ISC_R_SUCCESS Success

[356] Fix | Delete

*\li #DNS_R_DUPLICATE

[357] Fix | Delete

*\li #DNS_R_DROP

[358] Fix | Delete

*

[359] Fix | Delete

*\li Many other values are possible, all of which indicate failure.

[360] Fix | Delete

*/

[361] Fix | Delete

[362] Fix | Delete

void

[363] Fix | Delete

dns_resolver_cancelfetch(dns_fetch_t *fetch);

[364] Fix | Delete

/*%<

[365] Fix | Delete

* Cancel 'fetch'.

[366] Fix | Delete

*

[367] Fix | Delete

* Notes:

[368] Fix | Delete

*

[369] Fix | Delete

*\li If 'fetch' has not completed, post its FETCHDONE event with a

[370] Fix | Delete

* result code of #ISC_R_CANCELED.

[371] Fix | Delete

*

[372] Fix | Delete

* Requires:

[373] Fix | Delete

*

[374] Fix | Delete

*\li 'fetch' is a valid fetch.

[375] Fix | Delete

*/

[376] Fix | Delete

[377] Fix | Delete

void

[378] Fix | Delete

dns_resolver_destroyfetch(dns_fetch_t **fetchp);

[379] Fix | Delete

/*%<

[380] Fix | Delete

* Destroy 'fetch'.

[381] Fix | Delete

*

[382] Fix | Delete

* Requires:

[383] Fix | Delete

*

[384] Fix | Delete

*\li '*fetchp' is a valid fetch.

[385] Fix | Delete

*

[386] Fix | Delete

*\li The caller has received the FETCHDONE event (either because the

[387] Fix | Delete

* fetch completed or because dns_resolver_cancelfetch() was called).

[388] Fix | Delete

*

[389] Fix | Delete

* Ensures:

[390] Fix | Delete

*

[391] Fix | Delete

*\li *fetchp == NULL.

[392] Fix | Delete

*/

[393] Fix | Delete

[394] Fix | Delete

void

[395] Fix | Delete

dns_resolver_logfetch(dns_fetch_t *fetch, isc_log_t *lctx,

[396] Fix | Delete

isc_logcategory_t *category, isc_logmodule_t *module,

[397] Fix | Delete

int level, bool duplicateok);

[398] Fix | Delete

/*%<

[399] Fix | Delete

* Dump a log message on internal state at the completion of given 'fetch'.

[400] Fix | Delete

* 'lctx', 'category', 'module', and 'level' are used to write the log message.

[401] Fix | Delete

* By default, only one log message is written even if the corresponding fetch

[402] Fix | Delete

* context serves multiple clients; if 'duplicateok' is true the suppression

[403] Fix | Delete

* is disabled and the message can be written every time this function is

[404] Fix | Delete

* called.

[405] Fix | Delete

*

[406] Fix | Delete

* Requires:

[407] Fix | Delete

*

[408] Fix | Delete

*\li 'fetch' is a valid fetch, and has completed.

[409] Fix | Delete

*/

[410] Fix | Delete

[411] Fix | Delete

dns_dispatchmgr_t *

[412] Fix | Delete

dns_resolver_dispatchmgr(dns_resolver_t *resolver);

[413] Fix | Delete

[414] Fix | Delete

dns_dispatch_t *

[415] Fix | Delete

dns_resolver_dispatchv4(dns_resolver_t *resolver);

[416] Fix | Delete

[417] Fix | Delete

dns_dispatch_t *

[418] Fix | Delete

dns_resolver_dispatchv6(dns_resolver_t *resolver);

[419] Fix | Delete

[420] Fix | Delete

isc_socketmgr_t *

[421] Fix | Delete

dns_resolver_socketmgr(dns_resolver_t *resolver);

[422] Fix | Delete

[423] Fix | Delete

isc_taskmgr_t *

[424] Fix | Delete

dns_resolver_taskmgr(dns_resolver_t *resolver);

[425] Fix | Delete

[426] Fix | Delete

uint32_t

[427] Fix | Delete

dns_resolver_getlamettl(dns_resolver_t *resolver);

[428] Fix | Delete

/*%<

[429] Fix | Delete

* Get the resolver's lame-ttl. zero => no lame processing.

[430] Fix | Delete

*

[431] Fix | Delete

* Requires:

[432] Fix | Delete

*\li 'resolver' to be valid.

[433] Fix | Delete

*/

[434] Fix | Delete

[435] Fix | Delete

void

[436] Fix | Delete

dns_resolver_setlamettl(dns_resolver_t *resolver, uint32_t lame_ttl);

[437] Fix | Delete

/*%<

[438] Fix | Delete

* Set the resolver's lame-ttl. zero => no lame processing.

[439] Fix | Delete

*

[440] Fix | Delete

* Requires:

[441] Fix | Delete

*\li 'resolver' to be valid.

[442] Fix | Delete

*/

[443] Fix | Delete

[444] Fix | Delete

unsigned int

[445] Fix | Delete

dns_resolver_nrunning(dns_resolver_t *resolver);

[446] Fix | Delete

/*%<

[447] Fix | Delete

* Return the number of currently running resolutions in this

[448] Fix | Delete

* resolver. This is may be less than the number of outstanding

[449] Fix | Delete

* fetches due to multiple identical fetches, or more than the

[450] Fix | Delete

* number of of outstanding fetches due to the fact that resolution

[451] Fix | Delete

* can continue even though a fetch has been canceled.

[452] Fix | Delete

*/

[453] Fix | Delete

[454] Fix | Delete

isc_result_t

[455] Fix | Delete

dns_resolver_addalternate(dns_resolver_t *resolver, isc_sockaddr_t *alt,

[456] Fix | Delete

dns_name_t *name, in_port_t port);

[457] Fix | Delete

/*%<

[458] Fix | Delete

* Add alternate addresses to be tried in the event that the nameservers

[459] Fix | Delete

* for a zone are not available in the address families supported by the

[460] Fix | Delete

* operating system.

[461] Fix | Delete

*

[462] Fix | Delete

* Require:

[463] Fix | Delete

* \li only one of 'name' or 'alt' to be valid.

[464] Fix | Delete

*/

[465] Fix | Delete

[466] Fix | Delete

void

[467] Fix | Delete

dns_resolver_setudpsize(dns_resolver_t *resolver, uint16_t udpsize);

[468] Fix | Delete

/*%<

[469] Fix | Delete

* Set the EDNS UDP buffer size advertised by the server.

[470] Fix | Delete

*/

[471] Fix | Delete

[472] Fix | Delete

uint16_t

[473] Fix | Delete

dns_resolver_getudpsize(dns_resolver_t *resolver);

[474] Fix | Delete

/*%<

[475] Fix | Delete

* Get the current EDNS UDP buffer size.

[476] Fix | Delete

*/

[477] Fix | Delete

[478] Fix | Delete

void

[479] Fix | Delete

dns_resolver_reset_algorithms(dns_resolver_t *resolver);

[480] Fix | Delete

/*%<

[481] Fix | Delete

* Clear the disabled DNSSEC algorithms.

[482] Fix | Delete

*/

[483] Fix | Delete

[484] Fix | Delete

void

[485] Fix | Delete

dns_resolver_reset_ds_digests(dns_resolver_t *resolver);

[486] Fix | Delete

/*%<

[487] Fix | Delete

* Clear the disabled DS/DLV digest types.

[488] Fix | Delete

*/

[489] Fix | Delete

[490] Fix | Delete

isc_result_t

[491] Fix | Delete

dns_resolver_disable_algorithm(dns_resolver_t *resolver, dns_name_t *name,

[492] Fix | Delete

unsigned int alg);

[493] Fix | Delete

/*%<

[494] Fix | Delete

* Mark the given DNSSEC algorithm as disabled and below 'name'.

[495] Fix | Delete

* Valid algorithms are less than 256.

[496] Fix | Delete

*

[497] Fix | Delete

* Returns:

[498] Fix | Delete

*\li #ISC_R_SUCCESS

[499] Fix | Delete