/*

[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_ZONE_H

[11] Fix | Delete

#define DNS_ZONE_H 1

[12] Fix | Delete

[13] Fix | Delete

/*! \file dns/zone.h */

[14] Fix | Delete

[15] Fix | Delete

/***

[16] Fix | Delete

*** Imports

[17] Fix | Delete

***/

[18] Fix | Delete

[19] Fix | Delete

#include <stdio.h>

[20] Fix | Delete

#include <stdbool.h>

[21] Fix | Delete

[22] Fix | Delete

#include <isc/formatcheck.h>

[23] Fix | Delete

#include <isc/lang.h>

[24] Fix | Delete

#include <isc/rwlock.h>

[25] Fix | Delete

[26] Fix | Delete

#include <dns/catz.h>

[27] Fix | Delete

#include <dns/master.h>

[28] Fix | Delete

#include <dns/masterdump.h>

[29] Fix | Delete

#include <dns/rdatastruct.h>

[30] Fix | Delete

#include <dns/rpz.h>

[31] Fix | Delete

#include <dns/types.h>

[32] Fix | Delete

#include <dns/zt.h>

[33] Fix | Delete

[34] Fix | Delete

typedef enum {

[35] Fix | Delete

dns_zone_none,

[36] Fix | Delete

dns_zone_master,

[37] Fix | Delete

dns_zone_slave,

[38] Fix | Delete

dns_zone_stub,

[39] Fix | Delete

dns_zone_staticstub,

[40] Fix | Delete

dns_zone_key,

[41] Fix | Delete

dns_zone_dlz,

[42] Fix | Delete

dns_zone_redirect

[43] Fix | Delete

} dns_zonetype_t;

[44] Fix | Delete

[45] Fix | Delete

typedef enum {

[46] Fix | Delete

dns_zonestat_none = 0,

[47] Fix | Delete

dns_zonestat_terse,

[48] Fix | Delete

dns_zonestat_full

[49] Fix | Delete

} dns_zonestat_level_t;

[50] Fix | Delete

[51] Fix | Delete

#define DNS_ZONEOPT_SERVERS 0x00000001U /*%< perform server checks */

[52] Fix | Delete

#define DNS_ZONEOPT_PARENTS 0x00000002U /*%< perform parent checks */

[53] Fix | Delete

#define DNS_ZONEOPT_CHILDREN 0x00000004U /*%< perform child checks */

[54] Fix | Delete

#define DNS_ZONEOPT_NOTIFY 0x00000008U /*%< perform NOTIFY */

[55] Fix | Delete

#define DNS_ZONEOPT_MANYERRORS 0x00000010U /*%< return many errors on load */

[56] Fix | Delete

#define DNS_ZONEOPT_IXFRFROMDIFFS 0x00000020U /*%< calculate differences */

[57] Fix | Delete

#define DNS_ZONEOPT_NOMERGE 0x00000040U /*%< don't merge journal */

[58] Fix | Delete

#define DNS_ZONEOPT_CHECKNS 0x00000080U /*%< check if NS's are addresses */

[59] Fix | Delete

#define DNS_ZONEOPT_FATALNS 0x00000100U /*%< DNS_ZONEOPT_CHECKNS is fatal */

[60] Fix | Delete

#define DNS_ZONEOPT_MULTIMASTER 0x00000200U /*%< this zone has multiple masters */

[61] Fix | Delete

#define DNS_ZONEOPT_USEALTXFRSRC 0x00000400U /*%< use alternate transfer sources */

[62] Fix | Delete

#define DNS_ZONEOPT_CHECKNAMES 0x00000800U /*%< check-names */

[63] Fix | Delete

#define DNS_ZONEOPT_CHECKNAMESFAIL 0x00001000U /*%< fatal check-name failures */

[64] Fix | Delete

#define DNS_ZONEOPT_CHECKWILDCARD 0x00002000U /*%< check for internal wildcards */

[65] Fix | Delete

#define DNS_ZONEOPT_CHECKMX 0x00004000U /*%< check-mx */

[66] Fix | Delete

#define DNS_ZONEOPT_CHECKMXFAIL 0x00008000U /*%< fatal check-mx failures */

[67] Fix | Delete

#define DNS_ZONEOPT_CHECKINTEGRITY 0x00010000U /*%< perform integrity checks */

[68] Fix | Delete

#define DNS_ZONEOPT_CHECKSIBLING 0x00020000U /*%< perform sibling glue checks */

[69] Fix | Delete

#define DNS_ZONEOPT_NOCHECKNS 0x00040000U /*%< disable IN NS address checks */

[70] Fix | Delete

#define DNS_ZONEOPT_WARNMXCNAME 0x00080000U /*%< warn on MX CNAME check */

[71] Fix | Delete

#define DNS_ZONEOPT_IGNOREMXCNAME 0x00100000U /*%< ignore MX CNAME check */

[72] Fix | Delete

#define DNS_ZONEOPT_WARNSRVCNAME 0x00200000U /*%< warn on SRV CNAME check */

[73] Fix | Delete

#define DNS_ZONEOPT_IGNORESRVCNAME 0x00400000U /*%< ignore SRV CNAME check */

[74] Fix | Delete

#define DNS_ZONEOPT_UPDATECHECKKSK 0x00800000U /*%< check dnskey KSK flag */

[75] Fix | Delete

#define DNS_ZONEOPT_TRYTCPREFRESH 0x01000000U /*%< try tcp refresh on udp failure */

[76] Fix | Delete

#define DNS_ZONEOPT_NOTIFYTOSOA 0x02000000U /*%< Notify the SOA MNAME */

[77] Fix | Delete

#define DNS_ZONEOPT_NSEC3TESTZONE 0x04000000U /*%< nsec3-test-zone */

[78] Fix | Delete

#define DNS_ZONEOPT_SECURETOINSECURE 0x08000000U /*%< dnssec-secure-to-insecure */

[79] Fix | Delete

#define DNS_ZONEOPT_DNSKEYKSKONLY 0x10000000U /*%< dnssec-dnskey-kskonly */

[80] Fix | Delete

#define DNS_ZONEOPT_CHECKDUPRR 0x20000000U /*%< check-dup-records */

[81] Fix | Delete

#define DNS_ZONEOPT_CHECKDUPRRFAIL 0x40000000U /*%< fatal check-dup-records failures */

[82] Fix | Delete

#define DNS_ZONEOPT_CHECKSPF 0x80000000U /*%< check SPF records */

[83] Fix | Delete

[84] Fix | Delete

/*

[85] Fix | Delete

* The following zone options are shifted left into the

[86] Fix | Delete

* higher-order 32 bits of the options.

[87] Fix | Delete

*/

[88] Fix | Delete

#define DNS_ZONEOPT2_CHECKTTL 0x00000001U /*%< check max-zone-ttl */

[89] Fix | Delete

#define DNS_ZONEOPT2_AUTOEMPTY 0x00000002U /*%< automatic empty zone */

[90] Fix | Delete

[91] Fix | Delete

#ifndef NOMINUM_PUBLIC

[92] Fix | Delete

/*

[93] Fix | Delete

* Nominum specific options build down.

[94] Fix | Delete

*/

[95] Fix | Delete

#define DNS_ZONEOPT_NOTIFYFORWARD 0x80000000U /* forward notify to master */

[96] Fix | Delete

#endif /* NOMINUM_PUBLIC */

[97] Fix | Delete

[98] Fix | Delete

/*

[99] Fix | Delete

* Zone key maintenance options

[100] Fix | Delete

*/

[101] Fix | Delete

#define DNS_ZONEKEY_ALLOW 0x00000001U /*%< fetch keys on command */

[102] Fix | Delete

#define DNS_ZONEKEY_MAINTAIN 0x00000002U /*%< publish/sign on schedule */

[103] Fix | Delete

#define DNS_ZONEKEY_CREATE 0x00000004U /*%< make keys when needed */

[104] Fix | Delete

#define DNS_ZONEKEY_FULLSIGN 0x00000008U /*%< roll to new keys immediately */

[105] Fix | Delete

#define DNS_ZONEKEY_NORESIGN 0x00000010U /*%< no automatic resigning */

[106] Fix | Delete

[107] Fix | Delete

#ifndef DNS_ZONE_MINREFRESH

[108] Fix | Delete

#define DNS_ZONE_MINREFRESH 300 /*%< 5 minutes */

[109] Fix | Delete

#endif

[110] Fix | Delete

#ifndef DNS_ZONE_MAXREFRESH

[111] Fix | Delete

#define DNS_ZONE_MAXREFRESH 2419200 /*%< 4 weeks */

[112] Fix | Delete

#endif

[113] Fix | Delete

#ifndef DNS_ZONE_DEFAULTREFRESH

[114] Fix | Delete

#define DNS_ZONE_DEFAULTREFRESH 3600 /*%< 1 hour */

[115] Fix | Delete

#endif

[116] Fix | Delete

#ifndef DNS_ZONE_MINRETRY

[117] Fix | Delete

#define DNS_ZONE_MINRETRY 300 /*%< 5 minutes */

[118] Fix | Delete

#endif

[119] Fix | Delete

#ifndef DNS_ZONE_MAXRETRY

[120] Fix | Delete

#define DNS_ZONE_MAXRETRY 1209600 /*%< 2 weeks */

[121] Fix | Delete

#endif

[122] Fix | Delete

#ifndef DNS_ZONE_DEFAULTRETRY

[123] Fix | Delete

#define DNS_ZONE_DEFAULTRETRY 60 /*%< 1 minute, subject to

[124] Fix | Delete

exponential backoff */

[125] Fix | Delete

#endif

[126] Fix | Delete

[127] Fix | Delete

#define DNS_ZONESTATE_XFERRUNNING 1

[128] Fix | Delete

#define DNS_ZONESTATE_XFERDEFERRED 2

[129] Fix | Delete

#define DNS_ZONESTATE_SOAQUERY 3

[130] Fix | Delete

#define DNS_ZONESTATE_ANY 4

[131] Fix | Delete

#define DNS_ZONESTATE_AUTOMATIC 5

[132] Fix | Delete

[133] Fix | Delete

ISC_LANG_BEGINDECLS

[134] Fix | Delete

[135] Fix | Delete

/***

[136] Fix | Delete

*** Functions

[137] Fix | Delete

***/

[138] Fix | Delete

[139] Fix | Delete

isc_result_t

[140] Fix | Delete

dns_zone_create(dns_zone_t **zonep, isc_mem_t *mctx);

[141] Fix | Delete

/*%<

[142] Fix | Delete

* Creates a new empty zone and attach '*zonep' to it.

[143] Fix | Delete

*

[144] Fix | Delete

* Requires:

[145] Fix | Delete

*\li 'zonep' to point to a NULL pointer.

[146] Fix | Delete

*\li 'mctx' to be a valid memory context.

[147] Fix | Delete

*

[148] Fix | Delete

* Ensures:

[149] Fix | Delete

*\li '*zonep' refers to a valid zone.

[150] Fix | Delete

*

[151] Fix | Delete

* Returns:

[152] Fix | Delete

*\li #ISC_R_SUCCESS

[153] Fix | Delete

*\li #ISC_R_NOMEMORY

[154] Fix | Delete

*\li #ISC_R_UNEXPECTED

[155] Fix | Delete

*/

[156] Fix | Delete

[157] Fix | Delete

void

[158] Fix | Delete

dns_zone_setclass(dns_zone_t *zone, dns_rdataclass_t rdclass);

[159] Fix | Delete

/*%<

[160] Fix | Delete

* Sets the class of a zone. This operation can only be performed

[161] Fix | Delete

* once on a zone.

[162] Fix | Delete

*

[163] Fix | Delete

* Require:

[164] Fix | Delete

*\li 'zone' to be a valid zone.

[165] Fix | Delete

*\li dns_zone_setclass() not to have been called since the zone was

[166] Fix | Delete

* created.

[167] Fix | Delete

*\li 'rdclass' != dns_rdataclass_none.

[168] Fix | Delete

*/

[169] Fix | Delete

[170] Fix | Delete

dns_rdataclass_t

[171] Fix | Delete

dns_zone_getclass(dns_zone_t *zone);

[172] Fix | Delete

/*%<

[173] Fix | Delete

* Returns the current zone class.

[174] Fix | Delete

*

[175] Fix | Delete

* Requires:

[176] Fix | Delete

*\li 'zone' to be a valid zone.

[177] Fix | Delete

*/

[178] Fix | Delete

[179] Fix | Delete

isc_result_t

[180] Fix | Delete

dns_zone_getserial2(dns_zone_t *zone, uint32_t *serialp);

[181] Fix | Delete

[182] Fix | Delete

uint32_t

[183] Fix | Delete

dns_zone_getserial(dns_zone_t *zone);

[184] Fix | Delete

/*%<

[185] Fix | Delete

* Returns the current serial number of the zone. On success, the SOA

[186] Fix | Delete

* serial of the zone will be copied into '*serialp'.

[187] Fix | Delete

* dns_zone_getserial() cannot catch failure cases and is deprecated by

[188] Fix | Delete

* dns_zone_getserial2().

[189] Fix | Delete

*

[190] Fix | Delete

* Requires:

[191] Fix | Delete

*\li 'zone' to be a valid zone.

[192] Fix | Delete

*\li 'serialp' to be non NULL

[193] Fix | Delete

*

[194] Fix | Delete

* Returns:

[195] Fix | Delete

*\li #ISC_R_SUCCESS

[196] Fix | Delete

*\li #DNS_R_NOTLOADED zone DB is not loaded

[197] Fix | Delete

*/

[198] Fix | Delete

[199] Fix | Delete

void

[200] Fix | Delete

dns_zone_settype(dns_zone_t *zone, dns_zonetype_t type);

[201] Fix | Delete

/*%<

[202] Fix | Delete

* Sets the zone type. This operation can only be performed once on

[203] Fix | Delete

* a zone.

[204] Fix | Delete

*

[205] Fix | Delete

* Requires:

[206] Fix | Delete

*\li 'zone' to be a valid zone.

[207] Fix | Delete

*\li dns_zone_settype() not to have been called since the zone was

[208] Fix | Delete

* created.

[209] Fix | Delete

*\li 'type' != dns_zone_none

[210] Fix | Delete

*/

[211] Fix | Delete

[212] Fix | Delete

void

[213] Fix | Delete

dns_zone_setview(dns_zone_t *zone, dns_view_t *view);

[214] Fix | Delete

/*%<

[215] Fix | Delete

* Associate the zone with a view.

[216] Fix | Delete

*

[217] Fix | Delete

* Require:

[218] Fix | Delete

*\li 'zone' to be a valid zone.

[219] Fix | Delete

*/

[220] Fix | Delete

[221] Fix | Delete

dns_view_t *

[222] Fix | Delete

dns_zone_getview(dns_zone_t *zone);

[223] Fix | Delete

/*%<

[224] Fix | Delete

* Returns the zone's associated view.

[225] Fix | Delete

*

[226] Fix | Delete

* Requires:

[227] Fix | Delete

*\li 'zone' to be a valid zone.

[228] Fix | Delete

*/

[229] Fix | Delete

[230] Fix | Delete

void

[231] Fix | Delete

dns_zone_setviewcommit(dns_zone_t *zone);

[232] Fix | Delete

/*%<

[233] Fix | Delete

* Commit the previous view saved internally via dns_zone_setview().

[234] Fix | Delete

*

[235] Fix | Delete

* Require:

[236] Fix | Delete

*\li 'zone' to be a valid zone.

[237] Fix | Delete

*/

[238] Fix | Delete

[239] Fix | Delete

void

[240] Fix | Delete

dns_zone_setviewrevert(dns_zone_t *zone);

[241] Fix | Delete

/*%<

[242] Fix | Delete

* Revert the most recent dns_zone_setview() on this zone,

[243] Fix | Delete

* restoring the previous view.

[244] Fix | Delete

*

[245] Fix | Delete

* Require:

[246] Fix | Delete

*\li 'zone' to be a valid zone.

[247] Fix | Delete

*/

[248] Fix | Delete

[249] Fix | Delete

[250] Fix | Delete

isc_result_t

[251] Fix | Delete

dns_zone_setorigin(dns_zone_t *zone, const dns_name_t *origin);

[252] Fix | Delete

/*%<

[253] Fix | Delete

* Sets the zones origin to 'origin'.

[254] Fix | Delete

*

[255] Fix | Delete

* Require:

[256] Fix | Delete

*\li 'zone' to be a valid zone.

[257] Fix | Delete

*\li 'origin' to be non NULL.

[258] Fix | Delete

*

[259] Fix | Delete

* Returns:

[260] Fix | Delete

*\li #ISC_R_SUCCESS

[261] Fix | Delete

*\li #ISC_R_NOMEMORY

[262] Fix | Delete

*/

[263] Fix | Delete

[264] Fix | Delete

dns_name_t *

[265] Fix | Delete

dns_zone_getorigin(dns_zone_t *zone);

[266] Fix | Delete

/*%<

[267] Fix | Delete

* Returns the value of the origin.

[268] Fix | Delete

*

[269] Fix | Delete

* Require:

[270] Fix | Delete

*\li 'zone' to be a valid zone.

[271] Fix | Delete

*/

[272] Fix | Delete

[273] Fix | Delete

isc_result_t

[274] Fix | Delete

dns_zone_setfile(dns_zone_t *zone, const char *file);

[275] Fix | Delete

[276] Fix | Delete

isc_result_t

[277] Fix | Delete

dns_zone_setfile2(dns_zone_t *zone, const char *file,

[278] Fix | Delete

dns_masterformat_t format);

[279] Fix | Delete

isc_result_t

[280] Fix | Delete

dns_zone_setfile3(dns_zone_t *zone, const char *file,

[281] Fix | Delete

dns_masterformat_t format, const dns_master_style_t *style);

[282] Fix | Delete

/*%<

[283] Fix | Delete

* Sets the name of the master file in the format of 'format' from which

[284] Fix | Delete

* the zone loads its database to 'file'.

[285] Fix | Delete

*

[286] Fix | Delete

* For zones that have no associated master file, 'file' will be NULL.

[287] Fix | Delete

*

[288] Fix | Delete

* For zones with persistent databases, the file name

[289] Fix | Delete

* setting is ignored.

[290] Fix | Delete

*

[291] Fix | Delete

* dns_zone_setfile() is a backward-compatible form of

[292] Fix | Delete

* dns_zone_setfile2(), which always specifies the

[293] Fix | Delete

* dns_masterformat_text (RFC1035) format.

[294] Fix | Delete

*

[295] Fix | Delete

* dns_zone_setfile2() is a backward-compatible form of

[296] Fix | Delete

* dns_zone_setfile3(), which also specifies the style

[297] Fix | Delete

* that should be used if a zone using the 'text'

[298] Fix | Delete

* masterformat is ever dumped.

[299] Fix | Delete

*

[300] Fix | Delete

* Require:

[301] Fix | Delete

*\li 'zone' to be a valid zone.

[302] Fix | Delete

*

[303] Fix | Delete

* Returns:

[304] Fix | Delete

*\li #ISC_R_NOMEMORY

[305] Fix | Delete

*\li #ISC_R_SUCCESS

[306] Fix | Delete

*/

[307] Fix | Delete

[308] Fix | Delete

const char *

[309] Fix | Delete

dns_zone_getfile(dns_zone_t *zone);

[310] Fix | Delete

/*%<

[311] Fix | Delete

* Gets the name of the zone's master file, if any.

[312] Fix | Delete

*

[313] Fix | Delete

* Requires:

[314] Fix | Delete

*\li 'zone' to be valid initialised zone.

[315] Fix | Delete

*

[316] Fix | Delete

* Returns:

[317] Fix | Delete

*\li Pointer to null-terminated file name, or NULL.

[318] Fix | Delete

*/

[319] Fix | Delete

[320] Fix | Delete

void

[321] Fix | Delete

dns_zone_setmaxrecords(dns_zone_t *zone, uint32_t records);

[322] Fix | Delete

/*%<

[323] Fix | Delete

* Sets the maximum number of records permitted in a zone.

[324] Fix | Delete

* 0 implies unlimited.

[325] Fix | Delete

*

[326] Fix | Delete

* Requires:

[327] Fix | Delete

*\li 'zone' to be valid initialised zone.

[328] Fix | Delete

*

[329] Fix | Delete

* Returns:

[330] Fix | Delete

*\li void

[331] Fix | Delete

*/

[332] Fix | Delete

[333] Fix | Delete

uint32_t

[334] Fix | Delete

dns_zone_getmaxrecords(dns_zone_t *zone);

[335] Fix | Delete

/*%<

[336] Fix | Delete

* Gets the maximum number of records permitted in a zone.

[337] Fix | Delete

* 0 implies unlimited.

[338] Fix | Delete

*

[339] Fix | Delete

* Requires:

[340] Fix | Delete

*\li 'zone' to be valid initialised zone.

[341] Fix | Delete

*

[342] Fix | Delete

* Returns:

[343] Fix | Delete

*\li uint32_t maxrecords.

[344] Fix | Delete

*/

[345] Fix | Delete

[346] Fix | Delete

void

[347] Fix | Delete

dns_zone_setmaxttl(dns_zone_t *zone, uint32_t maxttl);

[348] Fix | Delete

/*%<

[349] Fix | Delete

* Sets the max ttl of the zone.

[350] Fix | Delete

*

[351] Fix | Delete

* Requires:

[352] Fix | Delete

*\li 'zone' to be valid initialised zone.

[353] Fix | Delete

*

[354] Fix | Delete

* Returns:

[355] Fix | Delete

*\li void

[356] Fix | Delete

*/

[357] Fix | Delete

[358] Fix | Delete

dns_ttl_t

[359] Fix | Delete

dns_zone_getmaxttl(dns_zone_t *zone);

[360] Fix | Delete

/*%<

[361] Fix | Delete

* Gets the max ttl of the zone.

[362] Fix | Delete

*

[363] Fix | Delete

* Requires:

[364] Fix | Delete

*\li 'zone' to be valid initialised zone.

[365] Fix | Delete

*

[366] Fix | Delete

* Returns:

[367] Fix | Delete

*\li dns_ttl_t maxttl.

[368] Fix | Delete

*/

[369] Fix | Delete

[370] Fix | Delete

isc_result_t

[371] Fix | Delete

dns_zone_load(dns_zone_t *zone);

[372] Fix | Delete

[373] Fix | Delete

isc_result_t

[374] Fix | Delete

dns_zone_loadnew(dns_zone_t *zone);

[375] Fix | Delete

[376] Fix | Delete

isc_result_t

[377] Fix | Delete

dns_zone_loadandthaw(dns_zone_t *zone);

[378] Fix | Delete

[379] Fix | Delete

/*%<

[380] Fix | Delete

* Cause the database to be loaded from its backing store.

[381] Fix | Delete

* Confirm that the minimum requirements for the zone type are

[382] Fix | Delete

* met, otherwise DNS_R_BADZONE is returned.

[383] Fix | Delete

*

[384] Fix | Delete

* dns_zone_loadnew() only loads zones that are not yet loaded.

[385] Fix | Delete

* dns_zone_load() also loads zones that are already loaded and

[386] Fix | Delete

* and whose master file has changed since the last load.

[387] Fix | Delete

* dns_zone_loadandthaw() is similar to dns_zone_load() but will

[388] Fix | Delete

* also re-enable DNS UPDATEs when the load completes.

[389] Fix | Delete

*

[390] Fix | Delete

* Require:

[391] Fix | Delete

*\li 'zone' to be a valid zone.

[392] Fix | Delete

*

[393] Fix | Delete

* Returns:

[394] Fix | Delete

*\li #ISC_R_UNEXPECTED

[395] Fix | Delete

*\li #ISC_R_SUCCESS

[396] Fix | Delete

*\li DNS_R_CONTINUE Incremental load has been queued.

[397] Fix | Delete

*\li DNS_R_UPTODATE The zone has already been loaded based on

[398] Fix | Delete

* file system timestamps.

[399] Fix | Delete

*\li DNS_R_BADZONE

[400] Fix | Delete

*\li Any result value from dns_db_load().

[401] Fix | Delete

*/

[402] Fix | Delete

[403] Fix | Delete

isc_result_t

[404] Fix | Delete

dns_zone_asyncload(dns_zone_t *zone, dns_zt_zoneloaded_t done, void *arg);

[405] Fix | Delete

[406] Fix | Delete

isc_result_t

[407] Fix | Delete

dns_zone_asyncload2(dns_zone_t *zone, dns_zt_zoneloaded_t done, void *arg,

[408] Fix | Delete

bool newonly);

[409] Fix | Delete

/*%<

[410] Fix | Delete

* Cause the database to be loaded from its backing store asynchronously.

[411] Fix | Delete

* Other zone maintenance functions are suspended until this is complete.

[412] Fix | Delete

* When finished, 'done' is called to inform the caller, with 'arg' as

[413] Fix | Delete

* its first argument and 'zone' as its second. (Normally, 'arg' is

[414] Fix | Delete

* expected to point to the zone table but is left undefined for testing

[415] Fix | Delete

* purposes.)

[416] Fix | Delete

*

[417] Fix | Delete

* Require:

[418] Fix | Delete

*\li 'zone' to be a valid zone.

[419] Fix | Delete

*

[420] Fix | Delete

* Returns:

[421] Fix | Delete

*\li #ISC_R_ALREADYRUNNING

[422] Fix | Delete

*\li #ISC_R_SUCCESS

[423] Fix | Delete

*\li #ISC_R_FAILURE

[424] Fix | Delete

*\li #ISC_R_NOMEMORY

[425] Fix | Delete

*/

[426] Fix | Delete

[427] Fix | Delete

bool

[428] Fix | Delete

dns__zone_loadpending(dns_zone_t *zone);

[429] Fix | Delete

/*%<

[430] Fix | Delete

* Indicates whether the zone is waiting to be loaded asynchronously.

[431] Fix | Delete

* (Not currently intended for use outside of this module and associated

[432] Fix | Delete

* tests.)

[433] Fix | Delete

*/

[434] Fix | Delete

[435] Fix | Delete

void

[436] Fix | Delete

dns_zone_attach(dns_zone_t *source, dns_zone_t **target);

[437] Fix | Delete

/*%<

[438] Fix | Delete

* Attach '*target' to 'source' incrementing its external

[439] Fix | Delete

* reference count.

[440] Fix | Delete

*

[441] Fix | Delete

* Require:

[442] Fix | Delete

*\li 'zone' to be a valid zone.

[443] Fix | Delete

*\li 'target' to be non NULL and '*target' to be NULL.

[444] Fix | Delete

*/

[445] Fix | Delete

[446] Fix | Delete

void

[447] Fix | Delete

dns_zone_detach(dns_zone_t **zonep);

[448] Fix | Delete

/*%<

[449] Fix | Delete

* Detach from a zone decrementing its external reference count.

[450] Fix | Delete

* If this was the last external reference to the zone it will be

[451] Fix | Delete

* shut down and eventually freed.

[452] Fix | Delete

*

[453] Fix | Delete

* Require:

[454] Fix | Delete

*\li 'zonep' to point to a valid zone.

[455] Fix | Delete

*/

[456] Fix | Delete

[457] Fix | Delete

void

[458] Fix | Delete

dns_zone_iattach(dns_zone_t *source, dns_zone_t **target);

[459] Fix | Delete

/*%<

[460] Fix | Delete

* Attach '*target' to 'source' incrementing its internal

[461] Fix | Delete

* reference count. This is intended for use by operations

[462] Fix | Delete

* such as zone transfers that need to prevent the zone

[463] Fix | Delete

* object from being freed but not from shutting down.

[464] Fix | Delete

*

[465] Fix | Delete

* Require:

[466] Fix | Delete

*\li The caller is running in the context of the zone's task.

[467] Fix | Delete

*\li 'zone' to be a valid zone.

[468] Fix | Delete

*\li 'target' to be non NULL and '*target' to be NULL.

[469] Fix | Delete

*/

[470] Fix | Delete

[471] Fix | Delete

void

[472] Fix | Delete

dns_zone_idetach(dns_zone_t **zonep);

[473] Fix | Delete

/*%<

[474] Fix | Delete

* Detach from a zone decrementing its internal reference count.

[475] Fix | Delete

* If there are no more internal or external references to the

[476] Fix | Delete

* zone, it will be freed.

[477] Fix | Delete

*

[478] Fix | Delete

* Require:

[479] Fix | Delete

*\li The caller is running in the context of the zone's task.

[480] Fix | Delete

*\li 'zonep' to point to a valid zone.

[481] Fix | Delete

*/

[482] Fix | Delete

[483] Fix | Delete

void

[484] Fix | Delete

dns_zone_setflag(dns_zone_t *zone, unsigned int flags, bool value);

[485] Fix | Delete

/*%<

[486] Fix | Delete

* Sets ('value' == 'true') / clears ('value' == 'IS_FALSE')

[487] Fix | Delete

* zone flags. Valid flag bits are DNS_ZONE_F_*.

[488] Fix | Delete

*

[489] Fix | Delete

* Requires

[490] Fix | Delete

*\li 'zone' to be a valid zone.

[491] Fix | Delete

*/

[492] Fix | Delete

[493] Fix | Delete

isc_result_t

[494] Fix | Delete

dns_zone_getdb(dns_zone_t *zone, dns_db_t **dbp);

[495] Fix | Delete

/*%<

[496] Fix | Delete

* Attach '*dbp' to the database to if it exists otherwise

[497] Fix | Delete

* return DNS_R_NOTLOADED.

[498] Fix | Delete

*

[499] Fix | Delete