/*

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

[11] Fix | Delete

#define DNS_DB_H 1

[12] Fix | Delete

[13] Fix | Delete

/*****

[14] Fix | Delete

***** Module Info

[15] Fix | Delete

*****/

[16] Fix | Delete

[17] Fix | Delete

/*! \file dns/db.h

[18] Fix | Delete

* \brief

[19] Fix | Delete

* The DNS DB interface allows named rdatasets to be stored and retrieved.

[20] Fix | Delete

*

[21] Fix | Delete

* The dns_db_t type is like a "virtual class". To actually use

[22] Fix | Delete

* DBs, an implementation of the class is required.

[23] Fix | Delete

*

[24] Fix | Delete

* XXX more XXX

[25] Fix | Delete

*

[26] Fix | Delete

* MP:

[27] Fix | Delete

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

[28] Fix | Delete

* creates and manipulates.

[29] Fix | Delete

*

[30] Fix | Delete

* Reliability:

[31] Fix | Delete

* \li No anticipated impact.

[32] Fix | Delete

*

[33] Fix | Delete

* Resources:

[34] Fix | Delete

* \li TBS

[35] Fix | Delete

*

[36] Fix | Delete

* Security:

[37] Fix | Delete

* \li No anticipated impact.

[38] Fix | Delete

*

[39] Fix | Delete

* Standards:

[40] Fix | Delete

* \li None.

[41] Fix | Delete

*/

[42] Fix | Delete

[43] Fix | Delete

/*****

[44] Fix | Delete

***** Imports

[45] Fix | Delete

*****/

[46] Fix | Delete

[47] Fix | Delete

#include <inttypes.h>

[48] Fix | Delete

#include <stdbool.h>

[49] Fix | Delete

[50] Fix | Delete

#include <isc/deprecated.h>

[51] Fix | Delete

#include <isc/lang.h>

[52] Fix | Delete

#include <isc/magic.h>

[53] Fix | Delete

#include <isc/ondestroy.h>

[54] Fix | Delete

#include <isc/stats.h>

[55] Fix | Delete

#include <isc/stdtime.h>

[56] Fix | Delete

[57] Fix | Delete

#include <dns/clientinfo.h>

[58] Fix | Delete

#include <dns/fixedname.h>

[59] Fix | Delete

#include <dns/name.h>

[60] Fix | Delete

#include <dns/rdata.h>

[61] Fix | Delete

#include <dns/rdataset.h>

[62] Fix | Delete

#include <dns/rpz.h>

[63] Fix | Delete

#include <dns/types.h>

[64] Fix | Delete

[65] Fix | Delete

ISC_LANG_BEGINDECLS

[66] Fix | Delete

[67] Fix | Delete

/*****

[68] Fix | Delete

***** Types

[69] Fix | Delete

*****/

[70] Fix | Delete

[71] Fix | Delete

typedef struct dns_dbmethods {

[72] Fix | Delete

void (*attach)(dns_db_t *source, dns_db_t **targetp);

[73] Fix | Delete

void (*detach)(dns_db_t **dbp);

[74] Fix | Delete

isc_result_t (*beginload)(dns_db_t *db,

[75] Fix | Delete

dns_rdatacallbacks_t *callbacks);

[76] Fix | Delete

isc_result_t (*endload)(dns_db_t *db,

[77] Fix | Delete

dns_rdatacallbacks_t *callbacks);

[78] Fix | Delete

isc_result_t (*serialize)(dns_db_t *db,

[79] Fix | Delete

dns_dbversion_t *version, FILE *file);

[80] Fix | Delete

isc_result_t (*dump)(dns_db_t *db, dns_dbversion_t *version,

[81] Fix | Delete

const char *filename,

[82] Fix | Delete

dns_masterformat_t masterformat);

[83] Fix | Delete

void (*currentversion)(dns_db_t *db,

[84] Fix | Delete

dns_dbversion_t **versionp);

[85] Fix | Delete

isc_result_t (*newversion)(dns_db_t *db,

[86] Fix | Delete

dns_dbversion_t **versionp);

[87] Fix | Delete

void (*attachversion)(dns_db_t *db, dns_dbversion_t *source,

[88] Fix | Delete

dns_dbversion_t **targetp);

[89] Fix | Delete

void (*closeversion)(dns_db_t *db,

[90] Fix | Delete

dns_dbversion_t **versionp,

[91] Fix | Delete

bool commit);

[92] Fix | Delete

isc_result_t (*findnode)(dns_db_t *db, dns_name_t *name,

[93] Fix | Delete

bool create,

[94] Fix | Delete

dns_dbnode_t **nodep);

[95] Fix | Delete

isc_result_t (*find)(dns_db_t *db, dns_name_t *name,

[96] Fix | Delete

dns_dbversion_t *version,

[97] Fix | Delete

dns_rdatatype_t type, unsigned int options,

[98] Fix | Delete

isc_stdtime_t now,

[99] Fix | Delete

dns_dbnode_t **nodep, dns_name_t *foundname,

[100] Fix | Delete

dns_rdataset_t *rdataset,

[101] Fix | Delete

dns_rdataset_t *sigrdataset);

[102] Fix | Delete

isc_result_t (*findzonecut)(dns_db_t *db, dns_name_t *name,

[103] Fix | Delete

unsigned int options, isc_stdtime_t now,

[104] Fix | Delete

dns_dbnode_t **nodep,

[105] Fix | Delete

dns_name_t *foundname,

[106] Fix | Delete

dns_rdataset_t *rdataset,

[107] Fix | Delete

dns_rdataset_t *sigrdataset);

[108] Fix | Delete

void (*attachnode)(dns_db_t *db,

[109] Fix | Delete

dns_dbnode_t *source,

[110] Fix | Delete

dns_dbnode_t **targetp);

[111] Fix | Delete

void (*detachnode)(dns_db_t *db,

[112] Fix | Delete

dns_dbnode_t **targetp);

[113] Fix | Delete

isc_result_t (*expirenode)(dns_db_t *db, dns_dbnode_t *node,

[114] Fix | Delete

isc_stdtime_t now);

[115] Fix | Delete

void (*printnode)(dns_db_t *db, dns_dbnode_t *node,

[116] Fix | Delete

FILE *out);

[117] Fix | Delete

isc_result_t (*createiterator)(dns_db_t *db, unsigned int options,

[118] Fix | Delete

dns_dbiterator_t **iteratorp);

[119] Fix | Delete

isc_result_t (*findrdataset)(dns_db_t *db, dns_dbnode_t *node,

[120] Fix | Delete

dns_dbversion_t *version,

[121] Fix | Delete

dns_rdatatype_t type,

[122] Fix | Delete

dns_rdatatype_t covers,

[123] Fix | Delete

isc_stdtime_t now,

[124] Fix | Delete

dns_rdataset_t *rdataset,

[125] Fix | Delete

dns_rdataset_t *sigrdataset);

[126] Fix | Delete

isc_result_t (*allrdatasets)(dns_db_t *db, dns_dbnode_t *node,

[127] Fix | Delete

dns_dbversion_t *version,

[128] Fix | Delete

isc_stdtime_t now,

[129] Fix | Delete

dns_rdatasetiter_t **iteratorp);

[130] Fix | Delete

isc_result_t (*addrdataset)(dns_db_t *db, dns_dbnode_t *node,

[131] Fix | Delete

dns_dbversion_t *version,

[132] Fix | Delete

isc_stdtime_t now,

[133] Fix | Delete

dns_rdataset_t *rdataset,

[134] Fix | Delete

unsigned int options,

[135] Fix | Delete

dns_rdataset_t *addedrdataset);

[136] Fix | Delete

isc_result_t (*subtractrdataset)(dns_db_t *db, dns_dbnode_t *node,

[137] Fix | Delete

dns_dbversion_t *version,

[138] Fix | Delete

dns_rdataset_t *rdataset,

[139] Fix | Delete

unsigned int options,

[140] Fix | Delete

dns_rdataset_t *newrdataset);

[141] Fix | Delete

isc_result_t (*deleterdataset)(dns_db_t *db, dns_dbnode_t *node,

[142] Fix | Delete

dns_dbversion_t *version,

[143] Fix | Delete

dns_rdatatype_t type,

[144] Fix | Delete

dns_rdatatype_t covers);

[145] Fix | Delete

bool (*issecure)(dns_db_t *db);

[146] Fix | Delete

unsigned int (*nodecount)(dns_db_t *db);

[147] Fix | Delete

bool (*ispersistent)(dns_db_t *db);

[148] Fix | Delete

void (*overmem)(dns_db_t *db, bool overmem);

[149] Fix | Delete

void (*settask)(dns_db_t *db, isc_task_t *);

[150] Fix | Delete

isc_result_t (*getoriginnode)(dns_db_t *db, dns_dbnode_t **nodep);

[151] Fix | Delete

void (*transfernode)(dns_db_t *db, dns_dbnode_t **sourcep,

[152] Fix | Delete

dns_dbnode_t **targetp);

[153] Fix | Delete

isc_result_t (*getnsec3parameters)(dns_db_t *db,

[154] Fix | Delete

dns_dbversion_t *version,

[155] Fix | Delete

dns_hash_t *hash,

[156] Fix | Delete

uint8_t *flags,

[157] Fix | Delete

uint16_t *iterations,

[158] Fix | Delete

unsigned char *salt,

[159] Fix | Delete

size_t *salt_len);

[160] Fix | Delete

isc_result_t (*findnsec3node)(dns_db_t *db, dns_name_t *name,

[161] Fix | Delete

bool create,

[162] Fix | Delete

dns_dbnode_t **nodep);

[163] Fix | Delete

isc_result_t (*setsigningtime)(dns_db_t *db,

[164] Fix | Delete

dns_rdataset_t *rdataset,

[165] Fix | Delete

isc_stdtime_t resign);

[166] Fix | Delete

isc_result_t (*getsigningtime)(dns_db_t *db,

[167] Fix | Delete

dns_rdataset_t *rdataset,

[168] Fix | Delete

dns_name_t *name);

[169] Fix | Delete

void (*resigned)(dns_db_t *db, dns_rdataset_t *rdataset,

[170] Fix | Delete

dns_dbversion_t *version);

[171] Fix | Delete

bool (*isdnssec)(dns_db_t *db);

[172] Fix | Delete

dns_stats_t *(*getrrsetstats)(dns_db_t *db);

[173] Fix | Delete

void (*rpz_attach)(dns_db_t *db, dns_rpz_zones_t *rpzs,

[174] Fix | Delete

dns_rpz_num_t rpz_num);

[175] Fix | Delete

isc_result_t (*rpz_ready)(dns_db_t *db);

[176] Fix | Delete

isc_result_t (*findnodeext)(dns_db_t *db, dns_name_t *name,

[177] Fix | Delete

bool create,

[178] Fix | Delete

dns_clientinfomethods_t *methods,

[179] Fix | Delete

dns_clientinfo_t *clientinfo,

[180] Fix | Delete

dns_dbnode_t **nodep);

[181] Fix | Delete

isc_result_t (*findext)(dns_db_t *db, dns_name_t *name,

[182] Fix | Delete

dns_dbversion_t *version,

[183] Fix | Delete

dns_rdatatype_t type, unsigned int options,

[184] Fix | Delete

isc_stdtime_t now,

[185] Fix | Delete

dns_dbnode_t **nodep, dns_name_t *foundname,

[186] Fix | Delete

dns_clientinfomethods_t *methods,

[187] Fix | Delete

dns_clientinfo_t *clientinfo,

[188] Fix | Delete

dns_rdataset_t *rdataset,

[189] Fix | Delete

dns_rdataset_t *sigrdataset);

[190] Fix | Delete

isc_result_t (*setcachestats)(dns_db_t *db, isc_stats_t *stats);

[191] Fix | Delete

size_t (*hashsize)(dns_db_t *db);

[192] Fix | Delete

isc_result_t (*nodefullname)(dns_db_t *db, dns_dbnode_t *node,

[193] Fix | Delete

dns_name_t *name);

[194] Fix | Delete

isc_result_t (*getsize)(dns_db_t *db, dns_dbversion_t *version,

[195] Fix | Delete

uint64_t *records, uint64_t *bytes);

[196] Fix | Delete

isc_result_t (*setservestalettl)(dns_db_t *db, dns_ttl_t ttl);

[197] Fix | Delete

isc_result_t (*getservestalettl)(dns_db_t *db, dns_ttl_t *ttl);

[198] Fix | Delete

} dns_dbmethods_t;

[199] Fix | Delete

[200] Fix | Delete

typedef isc_result_t

[201] Fix | Delete

(*dns_dbcreatefunc_t)(isc_mem_t *mctx, dns_name_t *name,

[202] Fix | Delete

dns_dbtype_t type, dns_rdataclass_t rdclass,

[203] Fix | Delete

unsigned int argc, char *argv[], void *driverarg,

[204] Fix | Delete

dns_db_t **dbp);

[205] Fix | Delete

[206] Fix | Delete

typedef isc_result_t

[207] Fix | Delete

(*dns_dbupdate_callback_t)(dns_db_t *db, void *fn_arg);

[208] Fix | Delete

[209] Fix | Delete

#define DNS_DB_MAGIC ISC_MAGIC('D','N','S','D')

[210] Fix | Delete

#define DNS_DB_VALID(db) ISC_MAGIC_VALID(db, DNS_DB_MAGIC)

[211] Fix | Delete

[212] Fix | Delete

/*%

[213] Fix | Delete

* This structure is actually just the common prefix of a DNS db

[214] Fix | Delete

* implementation's version of a dns_db_t.

[215] Fix | Delete

* \brief

[216] Fix | Delete

* Direct use of this structure by clients is forbidden. DB implementations

[217] Fix | Delete

* may change the structure. 'magic' must be DNS_DB_MAGIC for any of the

[218] Fix | Delete

* dns_db_ routines to work. DB implementations must maintain all DB

[219] Fix | Delete

* invariants.

[220] Fix | Delete

*/

[221] Fix | Delete

struct dns_db {

[222] Fix | Delete

unsigned int magic;

[223] Fix | Delete

unsigned int impmagic;

[224] Fix | Delete

dns_dbmethods_t * methods;

[225] Fix | Delete

uint16_t attributes;

[226] Fix | Delete

dns_rdataclass_t rdclass;

[227] Fix | Delete

dns_name_t origin;

[228] Fix | Delete

isc_ondestroy_t ondest;

[229] Fix | Delete

isc_mem_t * mctx;

[230] Fix | Delete

ISC_LIST(dns_dbonupdatelistener_t) update_listeners;

[231] Fix | Delete

};

[232] Fix | Delete

[233] Fix | Delete

#define DNS_DBATTR_CACHE 0x01

[234] Fix | Delete

#define DNS_DBATTR_STUB 0x02

[235] Fix | Delete

[236] Fix | Delete

struct dns_dbonupdatelistener {

[237] Fix | Delete

dns_dbupdate_callback_t onupdate;

[238] Fix | Delete

void * onupdate_arg;

[239] Fix | Delete

ISC_LINK(dns_dbonupdatelistener_t) link;

[240] Fix | Delete

};

[241] Fix | Delete

[242] Fix | Delete

/*@{*/

[243] Fix | Delete

/*%

[244] Fix | Delete

* Options that can be specified for dns_db_find().

[245] Fix | Delete

*/

[246] Fix | Delete

#define DNS_DBFIND_GLUEOK 0x0001

[247] Fix | Delete

#define DNS_DBFIND_VALIDATEGLUE 0x0002

[248] Fix | Delete

#define DNS_DBFIND_NOWILD 0x0004

[249] Fix | Delete

#define DNS_DBFIND_PENDINGOK 0x0008

[250] Fix | Delete

#define DNS_DBFIND_NOEXACT 0x0010

[251] Fix | Delete

#define DNS_DBFIND_FORCENSEC 0x0020

[252] Fix | Delete

#define DNS_DBFIND_COVERINGNSEC 0x0040

[253] Fix | Delete

#define DNS_DBFIND_FORCENSEC3 0x0080

[254] Fix | Delete

#define DNS_DBFIND_ADDITIONALOK 0x0100

[255] Fix | Delete

#define DNS_DBFIND_NOZONECUT 0x0200

[256] Fix | Delete

#define DNS_DBFIND_STALEOK 0x0400

[257] Fix | Delete

/*@}*/

[258] Fix | Delete

[259] Fix | Delete

/*@{*/

[260] Fix | Delete

/*%

[261] Fix | Delete

* Options that can be specified for dns_db_addrdataset().

[262] Fix | Delete

*/

[263] Fix | Delete

#define DNS_DBADD_MERGE 0x01

[264] Fix | Delete

#define DNS_DBADD_FORCE 0x02

[265] Fix | Delete

#define DNS_DBADD_EXACT 0x04

[266] Fix | Delete

#define DNS_DBADD_EXACTTTL 0x08

[267] Fix | Delete

#define DNS_DBADD_PREFETCH 0x10

[268] Fix | Delete

/*@}*/

[269] Fix | Delete

[270] Fix | Delete

/*%

[271] Fix | Delete

* Options that can be specified for dns_db_subtractrdataset().

[272] Fix | Delete

*/

[273] Fix | Delete

#define DNS_DBSUB_EXACT 0x01

[274] Fix | Delete

#define DNS_DBSUB_WANTOLD 0x02

[275] Fix | Delete

[276] Fix | Delete

/*@{*/

[277] Fix | Delete

/*%

[278] Fix | Delete

* Iterator options

[279] Fix | Delete

*/

[280] Fix | Delete

#define DNS_DB_RELATIVENAMES 0x1

[281] Fix | Delete

#define DNS_DB_NSEC3ONLY 0x2

[282] Fix | Delete

#define DNS_DB_NONSEC3 0x4

[283] Fix | Delete

/*@}*/

[284] Fix | Delete

[285] Fix | Delete

/*****

[286] Fix | Delete

***** Methods

[287] Fix | Delete

*****/

[288] Fix | Delete

[289] Fix | Delete

/***

[290] Fix | Delete

*** Basic DB Methods

[291] Fix | Delete

***/

[292] Fix | Delete

[293] Fix | Delete

isc_result_t

[294] Fix | Delete

dns_db_create(isc_mem_t *mctx, const char *db_type, dns_name_t *origin,

[295] Fix | Delete

dns_dbtype_t type, dns_rdataclass_t rdclass,

[296] Fix | Delete

unsigned int argc, char *argv[], dns_db_t **dbp);

[297] Fix | Delete

/*%<

[298] Fix | Delete

* Create a new database using implementation 'db_type'.

[299] Fix | Delete

*

[300] Fix | Delete

* Notes:

[301] Fix | Delete

* \li All names in the database must be subdomains of 'origin' and in class

[302] Fix | Delete

* 'rdclass'. The database makes its own copy of the origin, so the

[303] Fix | Delete

* caller may do whatever they like with 'origin' and its storage once the

[304] Fix | Delete

* call returns.

[305] Fix | Delete

*

[306] Fix | Delete

* \li DB implementation-specific parameters are passed using argc and argv.

[307] Fix | Delete

*

[308] Fix | Delete

* Requires:

[309] Fix | Delete

*

[310] Fix | Delete

* \li dbp != NULL and *dbp == NULL

[311] Fix | Delete

*

[312] Fix | Delete

* \li 'origin' is a valid absolute domain name.

[313] Fix | Delete

*

[314] Fix | Delete

* \li mctx is a valid memory context

[315] Fix | Delete

*

[316] Fix | Delete

* Ensures:

[317] Fix | Delete

*

[318] Fix | Delete

* \li A copy of 'origin' has been made for the databases use, and the

[319] Fix | Delete

* caller is free to do whatever they want with the name and storage

[320] Fix | Delete

* associated with 'origin'.

[321] Fix | Delete

*

[322] Fix | Delete

* Returns:

[323] Fix | Delete

*

[324] Fix | Delete

* \li #ISC_R_SUCCESS

[325] Fix | Delete

* \li #ISC_R_NOMEMORY

[326] Fix | Delete

* \li #ISC_R_NOTFOUND db_type not found

[327] Fix | Delete

*

[328] Fix | Delete

* \li Many other errors are possible, depending on what db_type was

[329] Fix | Delete

* specified.

[330] Fix | Delete

*/

[331] Fix | Delete

[332] Fix | Delete

void

[333] Fix | Delete

dns_db_attach(dns_db_t *source, dns_db_t **targetp);

[334] Fix | Delete

/*%<

[335] Fix | Delete

* Attach *targetp to source.

[336] Fix | Delete

*

[337] Fix | Delete

* Requires:

[338] Fix | Delete

*

[339] Fix | Delete

* \li 'source' is a valid database.

[340] Fix | Delete

*

[341] Fix | Delete

* \li 'targetp' points to a NULL dns_db_t *.

[342] Fix | Delete

*

[343] Fix | Delete

* Ensures:

[344] Fix | Delete

*

[345] Fix | Delete

* \li *targetp is attached to source.

[346] Fix | Delete

*/

[347] Fix | Delete

[348] Fix | Delete

void

[349] Fix | Delete

dns_db_detach(dns_db_t **dbp);

[350] Fix | Delete

/*%<

[351] Fix | Delete

* Detach *dbp from its database.

[352] Fix | Delete

*

[353] Fix | Delete

* Requires:

[354] Fix | Delete

*

[355] Fix | Delete

* \li 'dbp' points to a valid database.

[356] Fix | Delete

*

[357] Fix | Delete

* Ensures:

[358] Fix | Delete

*

[359] Fix | Delete

* \li *dbp is NULL.

[360] Fix | Delete

*

[361] Fix | Delete

* \li If '*dbp' is the last reference to the database,

[362] Fix | Delete

* all resources used by the database will be freed

[363] Fix | Delete

*/

[364] Fix | Delete

[365] Fix | Delete

isc_result_t

[366] Fix | Delete

dns_db_ondestroy(dns_db_t *db, isc_task_t *task, isc_event_t **eventp);

[367] Fix | Delete

/*%<

[368] Fix | Delete

* Causes 'eventp' to be sent to be sent to 'task' when the database is

[369] Fix | Delete

* destroyed.

[370] Fix | Delete

*

[371] Fix | Delete

* Note; ownership of the eventp is taken from the caller (and *eventp is

[372] Fix | Delete

* set to NULL). The sender field of the event is set to 'db' before it is

[373] Fix | Delete

* sent to the task.

[374] Fix | Delete

*/

[375] Fix | Delete

[376] Fix | Delete

bool

[377] Fix | Delete

dns_db_iscache(dns_db_t *db);

[378] Fix | Delete

/*%<

[379] Fix | Delete

* Does 'db' have cache semantics?

[380] Fix | Delete

*

[381] Fix | Delete

* Requires:

[382] Fix | Delete

*

[383] Fix | Delete

* \li 'db' is a valid database.

[384] Fix | Delete

*

[385] Fix | Delete

* Returns:

[386] Fix | Delete

* \li #true 'db' has cache semantics

[387] Fix | Delete

* \li #false otherwise

[388] Fix | Delete

*/

[389] Fix | Delete

[390] Fix | Delete

bool

[391] Fix | Delete

dns_db_iszone(dns_db_t *db);

[392] Fix | Delete

/*%<

[393] Fix | Delete

* Does 'db' have zone semantics?

[394] Fix | Delete

*

[395] Fix | Delete

* Requires:

[396] Fix | Delete

*

[397] Fix | Delete

* \li 'db' is a valid database.

[398] Fix | Delete

*

[399] Fix | Delete

* Returns:

[400] Fix | Delete

* \li #true 'db' has zone semantics

[401] Fix | Delete

* \li #false otherwise

[402] Fix | Delete

*/

[403] Fix | Delete

[404] Fix | Delete

bool

[405] Fix | Delete

dns_db_isstub(dns_db_t *db);

[406] Fix | Delete

/*%<

[407] Fix | Delete

* Does 'db' have stub semantics?

[408] Fix | Delete

*

[409] Fix | Delete

* Requires:

[410] Fix | Delete

*

[411] Fix | Delete

* \li 'db' is a valid database.

[412] Fix | Delete

*

[413] Fix | Delete

* Returns:

[414] Fix | Delete

* \li #true 'db' has zone semantics

[415] Fix | Delete

* \li #false otherwise

[416] Fix | Delete

*/

[417] Fix | Delete

[418] Fix | Delete

bool

[419] Fix | Delete

dns_db_issecure(dns_db_t *db);

[420] Fix | Delete

/*%<

[421] Fix | Delete

* Is 'db' secure?

[422] Fix | Delete

*

[423] Fix | Delete

* Requires:

[424] Fix | Delete

*

[425] Fix | Delete

* \li 'db' is a valid database with zone semantics.

[426] Fix | Delete

*

[427] Fix | Delete

* Returns:

[428] Fix | Delete

* \li #true 'db' is secure.

[429] Fix | Delete

* \li #false 'db' is not secure.

[430] Fix | Delete

*/

[431] Fix | Delete

[432] Fix | Delete

bool

[433] Fix | Delete

dns_db_isdnssec(dns_db_t *db);

[434] Fix | Delete

/*%<

[435] Fix | Delete

* Is 'db' secure or partially secure?

[436] Fix | Delete

*

[437] Fix | Delete

* Requires:

[438] Fix | Delete

*

[439] Fix | Delete

* \li 'db' is a valid database with zone semantics.

[440] Fix | Delete

*

[441] Fix | Delete

* Returns:

[442] Fix | Delete

* \li #true 'db' is secure or is partially.

[443] Fix | Delete

* \li #false 'db' is not secure.

[444] Fix | Delete

*/

[445] Fix | Delete

[446] Fix | Delete

dns_name_t *

[447] Fix | Delete

dns_db_origin(dns_db_t *db);

[448] Fix | Delete

/*%<

[449] Fix | Delete

* The origin of the database.

[450] Fix | Delete

*

[451] Fix | Delete

* Note: caller must not try to change this name.

[452] Fix | Delete

*

[453] Fix | Delete

* Requires:

[454] Fix | Delete

*

[455] Fix | Delete

* \li 'db' is a valid database.

[456] Fix | Delete

*

[457] Fix | Delete

* Returns:

[458] Fix | Delete

*

[459] Fix | Delete

* \li The origin of the database.

[460] Fix | Delete

*/

[461] Fix | Delete

[462] Fix | Delete

dns_rdataclass_t

[463] Fix | Delete

dns_db_class(dns_db_t *db);

[464] Fix | Delete

/*%<

[465] Fix | Delete

* The class of the database.

[466] Fix | Delete

*

[467] Fix | Delete

* Requires:

[468] Fix | Delete

*

[469] Fix | Delete

* \li 'db' is a valid database.

[470] Fix | Delete

*

[471] Fix | Delete

* Returns:

[472] Fix | Delete

*

[473] Fix | Delete

* \li The class of the database.

[474] Fix | Delete

*/

[475] Fix | Delete

[476] Fix | Delete

isc_result_t

[477] Fix | Delete

dns_db_beginload(dns_db_t *db, dns_rdatacallbacks_t *callbacks);

[478] Fix | Delete

/*%<

[479] Fix | Delete

* Begin loading 'db'.

[480] Fix | Delete

*

[481] Fix | Delete

* Requires:

[482] Fix | Delete

*

[483] Fix | Delete

* \li 'db' is a valid database.

[484] Fix | Delete

*

[485] Fix | Delete

* \li This is the first attempt to load 'db'.

[486] Fix | Delete

*

[487] Fix | Delete

* \li 'callbacks' is a pointer to an initialized dns_rdatacallbacks_t

[488] Fix | Delete

* structure.

[489] Fix | Delete

*

[490] Fix | Delete

* Ensures:

[491] Fix | Delete

*

[492] Fix | Delete

* \li On success, callbacks->add will be a valid dns_addrdatasetfunc_t

[493] Fix | Delete

* suitable for loading records into 'db' from a raw or text zone

[494] Fix | Delete

* file. callbacks->add_private will be a valid DB load context

[495] Fix | Delete

* which should be used as 'arg' when callbacks->add is called.

[496] Fix | Delete

* callbacks->deserialize will be a valid dns_deserialize_func_t

[497] Fix | Delete

* suitable for loading 'db' from a map format zone file.

[498] Fix | Delete

*

[499] Fix | Delete