no
  7   ˆl–ßi~”ªi?u8 �q—î
bÑ¿Á0a–ßi~”ªi?u8 �q—î
bÑ¿À  *   ˆl–Ãa¾”ji?u@?pÜŠbÑ¿Ãƒu–Á_†I|¥�+ÀÂ ¶    /*
 * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at https://mozilla.org/MPL/2.0/.
 *
 * See the COPYRIGHT file distributed with this work for additional
 * information regarding copyright ownership.
 */

#ifndef DNS_SDB_H
#define DNS_SDB_H 1

/*****
***** Module Info
*****/

/*! \file dns/sdb.h
 * \brief
 * Simple database API.
 */

/***
 *** Imports
 ***/

#include <inttypes.h>

#include <isc/lang.h>

#include <dns/clientinfo.h>
#include <dns/types.h>

/***
 *** Types
 ***/

/*%
 * A simple database.  This is an opaque type.
 */
typedef struct dns_sdb dns_sdb_t;

/*%
 * A simple database lookup in progress.  This is an opaque type.
 */
typedef struct dns_sdblookup dns_sdblookup_t;

/*%
 * A simple database traversal in progress.  This is an opaque type.
 */
typedef struct dns_sdballnodes dns_sdballnodes_t;

typedef isc_result_t (*dns_sdblookupfunc_t)(const char *zone, const char *name,
					    void			 *dbdata,
					    dns_sdblookup_t	    *lookup,
					    dns_clientinfomethods_t *methods,
					    dns_clientinfo_t *clientinfo);
typedef isc_result_t (*dns_sdblookup2func_t)(const dns_name_t	      *zone,
					     const dns_name_t	      *name,
					     void			  *dbdata,
					     dns_sdblookup_t	     *lookup,
					     dns_clientinfomethods_t *methods,
					     dns_clientinfo_t *clientinfo);

typedef isc_result_t (*dns_sdbauthorityfunc_t)(const char *zone, void *dbdata,
					       dns_sdblookup_t *);

typedef isc_result_t (*dns_sdballnodesfunc_t)(const char *zone, void *dbdata,
					      dns_sdballnodes_t *allnodes);

typedef isc_result_t (*dns_sdbcreatefunc_t)(const char *zone, int argc,
					    char **argv, void *driverdata,
					    void **dbdata);

typedef void (*dns_sdbdestroyfunc_t)(const char *zone, void *driverdata,
				     void **dbdata);

typedef struct dns_sdbmethods {
	dns_sdblookupfunc_t    lookup;
	dns_sdbauthorityfunc_t authority;
	dns_sdballnodesfunc_t  allnodes;
	dns_sdbcreatefunc_t    create;
	dns_sdbdestroyfunc_t   destroy;
	dns_sdblookup2func_t   lookup2;
} dns_sdbmethods_t;

/***
 *** Functions
 ***/

ISC_LANG_BEGINDECLS

#define DNS_SDBFLAG_RELATIVEOWNER 0x00000001U
#define DNS_SDBFLAG_RELATIVERDATA 0x00000002U
#define DNS_SDBFLAG_THREADSAFE	  0x00000004U
#define DNS_SDBFLAG_DNS64	  0x00000008U

isc_result_t
dns_sdb_register(const char *drivername, const dns_sdbmethods_t *methods,
		 void *driverdata, unsigned int flags, isc_mem_t *mctx,
		 dns_sdbimplementation_t **sdbimp);
/*%<
 * Register a simple database driver for the database type 'drivername',
 * implemented by the functions in '*methods'.
 *
 * sdbimp must point to a NULL dns_sdbimplementation_t pointer.  That is,
 * 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
 * function 'lookup', passing it a printable zone name 'zone', a printable
 * domain name 'name', and a copy of the argument 'dbdata' that
 * was potentially returned by the create function.  The 'dns_sdblookup_t'
 * argument to 'lookup' and 'authority' is an opaque pointer to be passed to
 * ns_sdb_putrr().
 *
 * The lookup function returns the lookup results to the name server
 * by calling ns_sdb_putrr() once for each record found.  On success,
 * the return value of the lookup function should be ISC_R_SUCCESS.
 * If the domain name 'name' does not exist, the lookup function should
 * ISC_R_NOTFOUND.  Any other return value is treated as an error.
 *
 * Lookups at the zone apex will cause the server to also call the
 * function 'authority' (if non-NULL), which must provide an SOA record
 * and NS records for the zone by calling ns_sdb_putrr() once for each of
 * these records.  The 'authority' function ma