include/dns/db.h

82 	isc_result_t	(*dump)(dns_db_t *db, dns_dbversion_t *version,
98 				dns_dbversion_t *version,
122 					dns_dbversion_t *version,
129 					dns_dbversion_t *version,
133 				       dns_dbversion_t *version,
139 					    dns_dbversion_t *version,
144 					  dns_dbversion_t *version,
156 					      dns_dbversion_t *version,
172 					   dns_dbversion_t *version);
179 				       dns_dbversion_t *version,
189 				   dns_dbversion_t *version,
210  * implementation's version of a dns_db_t.
553 dns_db_dump(dns_db_t *db, dns_dbversion_t *version, const char *filename);
556 dns_db_dump2(dns_db_t *db, dns_dbversion_t *version, const char *filename,
559  * Dump version 'version' of 'db' to master file 'filename'.
565  * \li	'version' is a valid version.
583  * Open the current version for reading.
593  * \li	On success, '*versionp' is attached to the current version.
600  * Open a new version for reading and writing.
610  * \li	On success, '*versionp' is attached to the current version.
631  * \li	source is a valid open version
644  * Close version '*versionp'.
646  * Note: if '*versionp' is a read-write version and 'commit' is ISC_TRUE,
647  * then all changes made in the version will take effect, otherwise they
655  * \li	'*versionp' refers to a valid version.
657  * \li	If committing a writable version, then there must be no other
658  *	outstanding references to the version (e.g. an active rdataset
665  * \li	If *versionp is a read-write version, and commit is ISC_TRUE, then
666  *	the version will become the current version.  If !commit, then all
667  *	changes made in the version will be undone, and the version will
668  *	not become the current version.
723 dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version,
729 dns_db_findext(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version,
735  * Find the best match for 'name' and 'type' in version 'version' of 'db'.
1054  * Create an iterator for version 'version' of 'db'.
1088 dns_db_findrdataset(dns_db_t *db, dns_dbnode_t *node, dns_dbversion_t *version,
1094  * Search for an rdataset of type 'type' at 'node' that are in version
1095  * 'version' of 'db'.  If found, make 'rdataset' refer to it.
1099  * \li	If 'version' is NULL, then the current version will be used.
1138 dns_db_allrdatasets(dns_db_t *db, dns_dbnode_t *node, dns_dbversion_t *version,
1142  * version 'version' of 'db'.
1146  * \li	If 'version' is NULL, then the current version will be used.
1176 dns_db_addrdataset(dns_db_t *db, dns_dbnode_t *node, dns_dbversion_t *version,
1180  * Add 'rdataset' to 'node' in version 'version' of 'db'.
1216  * \li	The database has zone semantics and 'version' is a valid
1217  *	read-write version, or the database has cache semantics
1218  *	and version is NULL.
1236 			dns_dbversion_t *version, dns_rdataset_t *rdataset,
1239  * Remove any rdata in 'rdataset' from 'node' in version 'version' of
1260  * \li	The database has zone semantics and 'version' is a valid
1261  *	read-write version.
1278 		      dns_dbversion_t *version, dns_rdatatype_t type,
1281  * Make it so that no rdataset of type 'type' exists at 'node' in version
1282  * version 'version' of 'db'.
1287  *	'version' (provided that the dns_db_deleterdataset() isn't followed
1296  * \li	The database has zone semantics and 'version' is a valid
1297  *	read-write version, or the database has cache semantics
1298  *	and version is NULL.
1322  * \li	'ver' is a valid version.
1431 dns_db_getnsec3parameters(dns_db_t *db, dns_dbversion_t *version,
1501  * Note: the rdataset is version agnostic.
1515 		dns_dbversion_t *version);
1518  * dns_db_getsigningtime().  If the changes associated with 'version'
1519  * are committed this will be permanent.  If the version is not committed
1520  * this change will be rolled back when the version is closed.  Until
1521  * 'version' is either committed or rolled back, 'rdataset' can no longer
1527  * \li	'version' to be open for writing.
1554 		   dns_zone_t *zone, dns_db_t *db, dns_dbversion_t *version,
1565  * \li	'version' is the required version of the database