minix/external/bsd/bind/dist/lib/dns/include/dns/callbacks.h
David van Moolenbroek 00b67f09dd Import NetBSD named(8)
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
2017-03-21 22:00:06 +00:00

112 lines
2.8 KiB
C

/* $NetBSD: callbacks.h,v 1.5 2014/12/10 04:37:58 christos Exp $ */
/*
* Copyright (C) 2004-2007, 2011-2013 Internet Systems Consortium, Inc. ("ISC")
* Copyright (C) 1999-2002 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: callbacks.h,v 1.26.40.1 2012/02/07 00:44:16 each Exp */
#ifndef DNS_CALLBACKS_H
#define DNS_CALLBACKS_H 1
/*! \file dns/callbacks.h */
/***
*** Imports
***/
#include <isc/lang.h>
#include <isc/magic.h>
#include <dns/types.h>
ISC_LANG_BEGINDECLS
/***
*** Types
***/
#define DNS_CALLBACK_MAGIC ISC_MAGIC('C','L','L','B')
#define DNS_CALLBACK_VALID(cb) ISC_MAGIC_VALID(cb, DNS_CALLBACK_MAGIC)
struct dns_rdatacallbacks {
unsigned int magic;
/*%
* dns_load_master calls this when it has rdatasets to commit.
*/
dns_addrdatasetfunc_t add;
/*%
* This is called when reading in a database image from a 'map'
* format zone file.
*/
dns_deserializefunc_t deserialize;
/*%
* dns_master_load*() call this when loading a raw zonefile,
* to pass back information obtained from the file header
*/
dns_rawdatafunc_t rawdata;
dns_zone_t *zone;
/*%
* dns_load_master / dns_rdata_fromtext call this to issue a error.
*/
void (*error)(struct dns_rdatacallbacks *, const char *, ...);
/*%
* dns_load_master / dns_rdata_fromtext call this to issue a warning.
*/
void (*warn)(struct dns_rdatacallbacks *, const char *, ...);
/*%
* Private data handles for use by the above callback functions.
*/
void *add_private;
void *deserialize_private;
void *error_private;
void *warn_private;
};
/***
*** Initialization
***/
void
dns_rdatacallbacks_init(dns_rdatacallbacks_t *callbacks);
/*%<
* Initialize 'callbacks'.
*
* \li 'magic' is set to DNS_CALLBACK_MAGIC
*
* \li 'error' and 'warn' are set to default callbacks that print the
* error message through the DNS library log context.
*
*\li All other elements are initialized to NULL.
*
* Requires:
* \li 'callbacks' is a valid dns_rdatacallbacks_t,
*/
void
dns_rdatacallbacks_init_stdio(dns_rdatacallbacks_t *callbacks);
/*%<
* Like dns_rdatacallbacks_init, but logs to stdio.
*/
ISC_LANG_ENDDECLS
#endif /* DNS_CALLBACKS_H */