ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include / bind9 / dns

/*
 * 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 http://mozilla.org/MPL/2.0/.
 *
 * See the COPYRIGHT file distributed with this work for additional
 * information regarding copyright ownership.
 */

#ifndef DNS_NCACHE_H
#define DNS_NCACHE_H 1

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

/*! \file dns/ncache.h
 *\brief
 * DNS Ncache
 *
 * XXX TBS XXX
 *
 * MP:
 *\li	The caller must ensure any required synchronization.
 *
 * Reliability:
 *\li	No anticipated impact.
 *
 * Resources:
 *\li	TBS
 *
 * Security:
 *\li	No anticipated impact.
 *
 * Standards:
 *\li	RFC2308
 */

#include <isc/lang.h>
#include <isc/stdtime.h>

#include <dns/types.h>

ISC_LANG_BEGINDECLS

/*%
 * _OMITDNSSEC:
 *      Omit DNSSEC records when rendering.
 */
#define DNS_NCACHETOWIRE_OMITDNSSEC   0x0001

isc_result_t
dns_ncache_add(dns_message_t *message, dns_db_t *cache, dns_dbnode_t *node,
	       dns_rdatatype_t covers, isc_stdtime_t now, dns_ttl_t maxttl,
	       dns_rdataset_t *addedrdataset);
isc_result_t
dns_ncache_addoptout(dns_message_t *message, dns_db_t *cache,
		     dns_dbnode_t *node, dns_rdatatype_t covers,
		     isc_stdtime_t now, dns_ttl_t maxttl,
		     isc_boolean_t optout, dns_rdataset_t *addedrdataset);
/*%<
 * Convert the authority data from 'message' into a negative cache
 * rdataset, and store it in 'cache' at 'node' with a TTL limited to
 * 'maxttl'.
 *
 * \li dns_ncache_add produces a negative cache entry with a trust of no
 *     more than answer
 * \li dns_ncache_addoptout produces a negative cache entry which will have
 *     a trust of secure if all the records that make up the entry are secure.
 *
 * The 'covers' argument is the RR type whose nonexistence we are caching,
 * or dns_rdatatype_any when caching a NXDOMAIN response.
 *
 * 'optout' indicates a DNS_RDATASETATTR_OPTOUT should be set.
 *
 * Note:
 *\li	If 'addedrdataset' is not NULL, then it will be attached to the added
 *	rdataset.  See dns_db_addrdataset() for more details.
 *
 * Requires:
 *\li	'message' is a valid message with a properly formatting negative cache
 *	authority section.
 *
 *\li	The requirements of dns_db_addrdataset() apply to 'cache', 'node',
 *	'now', and 'addedrdataset'.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_NOSPACE
 *
 *\li	Any result code of dns_db_addrdataset() is a possible result code
 *	of dns_ncache_add().
 */

isc_result_t
dns_ncache_towire(dns_rdataset_t *rdataset, dns_compress_t *cctx,
		  isc_buffer_t *target, unsigned int options,
		  unsigned int *countp);
/*%<
 * Convert the negative caching rdataset 'rdataset' to wire format,
 * compressing names as specified in 'cctx', and storing the result in
 * 'target'.  If 'omit_dnssec' is set, DNSSEC records will not
 * be added to 'target'.
 *
 * Notes:
 *\li	The number of RRs added to target will be added to *countp.
 *
 * Requires:
 *\li	'rdataset' is a valid negative caching rdataset.
 *
 *\li	'rdataset' is not empty.
 *
 *\li	'countp' is a valid pointer.
 *
 * Ensures:
 *\li	On a return of ISC_R_SUCCESS, 'target' contains a wire format
 *	for the data contained in 'rdataset'.  Any error return leaves
 *	the buffer unchanged.
 *
 *\li	*countp has been incremented by the number of RRs added to
 *	target.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS		- all ok
 *\li	#ISC_R_NOSPACE		- 'target' doesn't have enough room
 *
 *\li	Any error returned by dns_rdata_towire(), dns_rdataset_next(),
 *	dns_name_towire().
 */

isc_result_t
dns_ncache_getrdataset(dns_rdataset_t *ncacherdataset, dns_name_t *name,
		       dns_rdatatype_t type, dns_rdataset_t *rdataset);
/*%<
 * Search the negative caching rdataset for an rdataset with the
 * specified name and type.
 *
 * Requires:
 *\li	'ncacherdataset' is a valid negative caching rdataset.
 *
 *\li	'ncacherdataset' is not empty.
 *
 *\li	'name' is a valid name.
 *
 *\li	'type' is not SIG, or a meta-RR type.
 *
 *\li	'rdataset' is a valid disassociated rdataset.
 *
 * Ensures:
 *\li	On a return of ISC_R_SUCCESS, 'rdataset' is bound to the found
 *	rdataset.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS		- the rdataset was found.
 *\li	#ISC_R_NOTFOUND		- the rdataset was not found.
 *
 */

isc_result_t
dns_ncache_getsigrdataset(dns_rdataset_t *ncacherdataset, dns_name_t *name,
			  dns_rdatatype_t covers, dns_rdataset_t *rdataset);
/*%<
 * Similar to dns_ncache_getrdataset() but get the rrsig that matches.
 */

void
dns_ncache_current(dns_rdataset_t *ncacherdataset, dns_name_t *found,
		   dns_rdataset_t *rdataset);

/*%<
 * Extract the current rdataset and name from a ncache entry.
 *
 * Requires:
 * \li	'ncacherdataset' to be valid and to be a negative cache entry
 * \li	'found' to be valid.
 * \li	'rdataset' to be unassociated.
 */

ISC_LANG_ENDDECLS

#endif /* DNS_NCACHE_H */

[-] diff.h [edit]
[-] callbacks.h [edit]
[-] badcache.h [edit]
[-] version.h [edit]
[-] rdataslab.h [edit]
[-] nsec3.h [edit]
[-] dlz_dlopen.h [edit]
[-] validator.h [edit]
[-] rdatasetiter.h [edit]
[-] rriterator.h [edit]
[-] rdata.h [edit]
[-] stats.h [edit]
[+] ..
[-] opcode.h [edit]
[-] dbtable.h [edit]
[-] geoip.h [edit]
[-] catz.h [edit]
[-] journal.h [edit]
[-] zt.h [edit]
[-] tkey.h [edit]
[-] rdatatype.h [edit]
[-] result.h [edit]
[-] view.h [edit]
[-] acache.h [edit]
[-] message.h [edit]
[-] byaddr.h [edit]
[-] dsdigest.h [edit]
[-] rdatastruct.h [edit]
[-] clientinfo.h [edit]
[-] rbt.h [edit]
[-] sdlz.h [edit]
[-] cache.h [edit]
[-] zonekey.h [edit]
[-] acl.h [edit]
[-] enumclass.h [edit]
[-] log.h [edit]
[-] portlist.h [edit]
[-] rdataset.h [edit]
[-] tcpmsg.h [edit]
[-] client.h [edit]
[-] zone.h [edit]
[-] time.h [edit]
[-] xfrin.h [edit]
[-] secproto.h [edit]
[-] rcode.h [edit]
[-] dyndb.h [edit]
[-] peer.h [edit]
[-] ttl.h [edit]
[-] types.h [edit]
[-] rrl.h [edit]
[-] rootns.h [edit]
[-] keytable.h [edit]
[-] forward.h [edit]
[-] ipkeylist.h [edit]
[-] timer.h [edit]
[-] ds.h [edit]
[-] dnstap.h [edit]
[-] dispatch.h [edit]
[-] private.h [edit]
[-] ssu.h [edit]
[-] order.h [edit]
[-] update.h [edit]
[-] rdatalist.h [edit]
[-] lookup.h [edit]
[-] db.h [edit]
[-] name.h [edit]
[-] ncache.h [edit]
[-] nta.h [edit]
[-] ecdb.h [edit]
[-] iptable.h [edit]
[-] resolver.h [edit]
[-] masterdump.h [edit]
[-] nsec.h [edit]
[-] cert.h [edit]
[-] soa.h [edit]
[-] bit.h [edit]
[-] events.h [edit]
[-] dnssec.h [edit]
[-] dbiterator.h [edit]
[-] request.h [edit]
[-] keyflags.h [edit]
[-] secalg.h [edit]
[-] dns64.h [edit]
[-] edns.h [edit]
[-] enumtype.h [edit]
[-] fixedname.h [edit]
[-] tsec.h [edit]
[-] lib.h [edit]
[-] keyvalues.h [edit]
[-] keydata.h [edit]
[-] sdb.h [edit]
[-] adb.h [edit]
[-] compress.h [edit]
[-] rdataclass.h [edit]
[-] dlz.h [edit]
[-] tsig.h [edit]
[-] master.h [edit]
[-] rpz.h [edit]