00b67f09dd
Also known as ISC bind. This import adds utilities such as host(1), dig(1), and nslookup(1), as well as many other tools and libraries. Change-Id: I035ca46e64f1965d57019e773f4ff0ef035e4aa3
168 lines
3.7 KiB
C
168 lines
3.7 KiB
C
/* $NetBSD: dbtable.h,v 1.4 2014/12/10 04:37:58 christos Exp $ */
|
|
|
|
/*
|
|
* Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
|
|
* Copyright (C) 1999-2001 Internet Software Consortium.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
|
|
* REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
* AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
* INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
* LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
|
|
* OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
* PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
/* Id: dbtable.h,v 1.23 2007/06/19 23:47:16 tbox Exp */
|
|
|
|
#ifndef DNS_DBTABLE_H
|
|
#define DNS_DBTABLE_H 1
|
|
|
|
/*****
|
|
***** Module Info
|
|
*****/
|
|
|
|
/*! \file dns/dbtable.h
|
|
* \brief
|
|
* DNS DB Tables
|
|
*
|
|
* XXX TBS XXX
|
|
*
|
|
* MP:
|
|
*\li The module ensures appropriate synchronization of data structures it
|
|
* creates and manipulates.
|
|
*
|
|
* Reliability:
|
|
*\li No anticipated impact.
|
|
*
|
|
* Resources:
|
|
*\li None.
|
|
*
|
|
* Security:
|
|
*\li No anticipated impact.
|
|
*
|
|
* Standards:
|
|
*\li None.
|
|
*/
|
|
|
|
#include <isc/lang.h>
|
|
|
|
#include <dns/types.h>
|
|
|
|
#define DNS_DBTABLEFIND_NOEXACT 0x01
|
|
|
|
ISC_LANG_BEGINDECLS
|
|
|
|
isc_result_t
|
|
dns_dbtable_create(isc_mem_t *mctx, dns_rdataclass_t rdclass,
|
|
dns_dbtable_t **dbtablep);
|
|
/*%<
|
|
* Make a new dbtable of class 'rdclass'
|
|
*
|
|
* Requires:
|
|
*\li mctx != NULL
|
|
* \li dbtablep != NULL && *dptablep == NULL
|
|
*\li 'rdclass' is a valid class
|
|
*
|
|
* Returns:
|
|
*\li #ISC_R_SUCCESS
|
|
*\li #ISC_R_NOMEMORY
|
|
*\li #ISC_R_UNEXPECTED
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_attach(dns_dbtable_t *source, dns_dbtable_t **targetp);
|
|
/*%<
|
|
* Attach '*targetp' to 'source'.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li 'source' is a valid dbtable.
|
|
*
|
|
*\li 'targetp' points to a NULL dns_dbtable_t *.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li *targetp is attached to source.
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_detach(dns_dbtable_t **dbtablep);
|
|
/*%<
|
|
* Detach *dbtablep from its dbtable.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li '*dbtablep' points to a valid dbtable.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li *dbtablep is NULL.
|
|
*
|
|
*\li If '*dbtablep' is the last reference to the dbtable,
|
|
* all resources used by the dbtable will be freed
|
|
*/
|
|
|
|
isc_result_t
|
|
dns_dbtable_add(dns_dbtable_t *dbtable, dns_db_t *db);
|
|
/*%<
|
|
* Add 'db' to 'dbtable'.
|
|
*
|
|
* Requires:
|
|
*\li 'dbtable' is a valid dbtable.
|
|
*
|
|
*\li 'db' is a valid database with the same class as 'dbtable'
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_remove(dns_dbtable_t *dbtable, dns_db_t *db);
|
|
/*%<
|
|
* Remove 'db' from 'dbtable'.
|
|
*
|
|
* Requires:
|
|
*\li 'db' was previously added to 'dbtable'.
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_adddefault(dns_dbtable_t *dbtable, dns_db_t *db);
|
|
/*%<
|
|
* Use 'db' as the result of a dns_dbtable_find() if no better match is
|
|
* available.
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_getdefault(dns_dbtable_t *dbtable, dns_db_t **db);
|
|
/*%<
|
|
* Get the 'db' used as the result of a dns_dbtable_find()
|
|
* if no better match is available.
|
|
*/
|
|
|
|
void
|
|
dns_dbtable_removedefault(dns_dbtable_t *dbtable);
|
|
/*%<
|
|
* Remove the default db from 'dbtable'.
|
|
*/
|
|
|
|
isc_result_t
|
|
dns_dbtable_find(dns_dbtable_t *dbtable, dns_name_t *name,
|
|
unsigned int options, dns_db_t **dbp);
|
|
/*%<
|
|
* Find the deepest match to 'name' in the dbtable, and return it
|
|
*
|
|
* Notes:
|
|
*\li If the DNS_DBTABLEFIND_NOEXACT option is set, the best partial
|
|
* match (if any) to 'name' will be returned.
|
|
*
|
|
* Returns:
|
|
* \li #ISC_R_SUCCESS on success
|
|
*\li something else: no default and match
|
|
*/
|
|
|
|
ISC_LANG_ENDDECLS
|
|
|
|
#endif /* DNS_DBTABLE_H */
|