REDROOM

Navigation

Breadcrumbs

/ / usr / include / bind9 / dns

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 3.29 KB

//usr/include/bind9/dns/badcache.h

Text Base64

/*
 * 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_BADCACHE_H
#define DNS_BADCACHE_H 1

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

/*! \file dns/badcache.h
 * \brief
 * Defines dns_badcache_t, the "bad cache" object.
 *
 * Notes:
 *\li 	A bad cache object is a hash table of name/type tuples,
 *	indicating whether a given tuple known to be "bad" in some
 *	sense (e.g., queries for that name and type have been
 *	returning SERVFAIL). This is used for both the "bad server
 *	cache" in the resolver and for the "servfail cache" in
 *	the view.
 *
 * Reliability:
 *
 * Resources:
 *
 * Security:
 *
 * Standards:
 */

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

#include <inttypes.h>
#include <stdbool.h>

#include <dns/types.h>

ISC_LANG_BEGINDECLS

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

isc_result_t
dns_badcache_init(isc_mem_t *mctx, unsigned int size, dns_badcache_t **bcp);
/*%
 * Allocate and initialize a badcache and store it in '*bcp'.
 *
 * Requires:
 * \li	mctx != NULL
 * \li	bcp != NULL
 * \li	*bcp == NULL
 */

void
dns_badcache_destroy(dns_badcache_t **bcp);
/*%
 * Flush and then free badcache in 'bcp'. '*bcp' is set to NULL on return.
 *
 * Requires:
 * \li	'*bcp' to be a valid badcache
 */

void
dns_badcache_add(dns_badcache_t *bc, dns_name_t *name,
		 dns_rdatatype_t type, bool update,
		 uint32_t flags, isc_time_t *expire);
/*%
 * Adds a badcache entry to the badcache 'bc' for name 'name' and
 * type 'type'.  If an entry already exists, then it will be updated if
 * 'update' is true.  The entry will be stored with flags 'flags'
 * and expiration date 'expire'.
 *
 * Requires:
 * \li	bc to be a valid badcache.
 * \li	name != NULL
 * \li	expire != NULL
 */

bool
dns_badcache_find(dns_badcache_t *bc, dns_name_t *name,
		  dns_rdatatype_t type, uint32_t *flagp,
		  isc_time_t *now);
/*%
 * Returns true if a record is found in the badcache 'bc' matching
 * 'name' and 'type', with an expiration date later than 'now'.
 * If 'flagp' is not NULL, then '*flagp' is updated to the flags
 * that were stored in the badcache entry.  Returns false if
 * no matching record is found.
 *
 * Requires:
 * \li	bc to be a valid badcache.
 * \li	name != NULL
 * \li	now != NULL
 */

void
dns_badcache_flush(dns_badcache_t *bc);
/*%
 * Flush the entire bad cache.
 *
 * Requires:
 * \li	bc to be a valid badcache
 */

void
dns_badcache_flushname(dns_badcache_t *bc, dns_name_t *name);
/*%
 * Flush the bad cache of all entries at 'name'.
 *
 * Requires:
 * \li	bc to be a valid badcache
 * \li	name != NULL
 */

void
dns_badcache_flushtree(dns_badcache_t *bc, dns_name_t *name);
/*%
 * Flush the bad cache of all entries at or below 'name'.
 *
 * Requires:
 * \li	bc to be a valid badcache
 * \li	name != NULL
 */

void
dns_badcache_print(dns_badcache_t *bc, const char *cachename, FILE *fp);
/*%
 * Print the contents of badcache 'bc' (headed by the title 'cachename')
 * to file pointer 'fp'.
 *
 * Requires:
 * \li	bc to be a valid badcache
 * \li	cachename != NULL
 * \li	fp != NULL
 */

ISC_LANG_ENDDECLS

#endif /* DNS_BADCACHE_H */

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 0 × Files: 97

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
acache.h	13.90 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
acl.h	7.07 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
adb.h	22.07 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
badcache.h	3.29 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
bit.h	807 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
byaddr.h	3.91 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
cache.h	8.44 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
callbacks.h	2.22 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
catz.h	11.56 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
cert.h	1.43 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
client.h	21.53 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
clientinfo.h	1.96 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
compress.h	6.49 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
db.h	45.96 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dbiterator.h	7.25 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dbtable.h	3.09 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
diff.h	6.82 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dispatch.h	16.04 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dlz.h	10.37 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dlz_dlopen.h	4.57 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dns64.h	5.50 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dnssec.h	11.83 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dnstap.h	9.14 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ds.h	1.20 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dsdigest.h	1.68 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
dyndb.h	4.72 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ecdb.h	809 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
edns.h	722 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
enumclass.h	1.19 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
enumtype.h	8.11 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
events.h	3.96 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
fixedname.h	1.62 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
forward.h	3.37 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
geoip.h	2.73 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ipkeylist.h	2.13 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
iptable.h	1.58 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
journal.h	8.03 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
keydata.h	1.03 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
keyflags.h	1.25 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
keytable.h	9.24 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
keyvalues.h	4.06 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
lib.h	1.16 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
log.h	3.87 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
lookup.h	2.86 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
master.h	11.02 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
masterdump.h	12.35 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
message.h	38.11 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
name.h	36.25 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ncache.h	4.81 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
nsec.h	2.86 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
nsec3.h	7.84 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
nta.h	4.44 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
opcode.h	1007 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
order.h	1.95 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
peer.h	5.83 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
portlist.h	2.05 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
private.h	1.89 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rbt.h	39.67 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rcode.h	2.42 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdata.h	21.11 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdataclass.h	2.20 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdatalist.h	2.51 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdataset.h	21.03 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdatasetiter.h	3.83 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdataslab.h	4.40 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdatastruct.h	60.14 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rdatatype.h	2.24 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
request.h	10.89 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
resolver.h	19.75 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
result.h	9.07 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rootns.h	892 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rpz.h	10.09 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rriterator.h	4.13 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
rrl.h	6.48 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
sdb.h	7.05 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
sdlz.h	13.88 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
secalg.h	1.67 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
secproto.h	1.52 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
soa.h	2.13 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ssu.h	8.11 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
stats.h	13.14 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
tcpmsg.h	3.07 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
time.h	1.66 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
timer.h	1.03 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
tkey.h	7.45 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
tsec.h	2.88 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
tsig.h	8.19 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
ttl.h	1.90 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
types.h	13.83 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
update.h	1.61 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
validator.h	6.99 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
version.h	868 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
view.h	34.45 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
xfrin.h	2.86 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
zone.h	59.44 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
zonekey.h	777 B	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive
zt.h	5.43 KB	lrw-r--r--	2025-11-06 07:45:36	Edit Download recursive recursive