2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-09-02 15:45:25 +00:00

clarified

This commit is contained in:
Andreas Gustafsson
2000-11-16 23:10:19 +00:00
parent 77ac297199
commit 26e801318b

View File

@@ -15,7 +15,7 @@
* WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: sdb.h,v 1.9 2000/11/16 22:33:52 bwelling Exp $ */ /* $Id: sdb.h,v 1.10 2000/11/16 23:10:19 gson Exp $ */
#ifndef DNS_SDB_H #ifndef DNS_SDB_H
#define DNS_SDB_H 1 #define DNS_SDB_H 1
@@ -96,11 +96,12 @@ dns_sdb_register(const char *drivername, const dns_sdbmethods_t *methods,
void *driverdata, unsigned int flags, isc_mem_t *mctx, void *driverdata, unsigned int flags, isc_mem_t *mctx,
dns_sdbimplementation_t **sdbimp); dns_sdbimplementation_t **sdbimp);
/* /*
* Register a simple database driver of name 'drivername' with the * Register a simple database driver for the database type 'drivername',
* specified functions, and return a handle to the implementation structure. * implemented by the functions in '*methods'.
* *
* sdbimp must point to an object with the value NULL. That is, * sdbimp must point to a NULL dns_sdbimplementation_t pointer. That is,
* sdbimp != NULL && *sdbimp == NULL. * sdbimp != NULL && *sdbimp == NULL. It will be assigned a value that
* will later be used to identify the driver when deregistering it.
* *
* The name server will perform lookups in the database by calling the * The name server will perform lookups in the database by calling the
* function 'lookup', passing it a printable zone name 'zone', a printable * function 'lookup', passing it a printable zone name 'zone', a printable
@@ -121,14 +122,17 @@ dns_sdb_register(const char *drivername, const dns_sdbmethods_t *methods,
* The allnodes function, if non-NULL, fills in an opaque structure to be * The allnodes function, if non-NULL, fills in an opaque structure to be
* used by a database iterator. This allows the zone to be transferred. * used by a database iterator. This allows the zone to be transferred.
* This may use a considerable amount of memory for large zones, and the * This may use a considerable amount of memory for large zones, and the
* zone transfer may not be RFC 1035 compliant if the zone is frequently * zone transfer may not be fully RFC 1035 compliant if the zone is
* changed. * frequently changed.
* *
* The create function will be called when a database is created, and * The create function will be called for each zone configured
* allows the implementation to create database specific data. * into the name server using this database type. It can be used
* to create a "database object" containg zone specific data,
* which can make use of the database arguments specified in the
* name server configuration.
* *
* The destroy function will be called when a database is destroyed, * The destroy function will be called to free the database object
* and allows the implementation to free any database specific data. * when its zone is destroyed.
* *
* The create and destroy functions may be NULL. * The create and destroy functions may be NULL.
* *