Geforce File Manager

NAME	SIZE	ACTIONS
📄 acache.h	14,232 B	[ EDIT ] \| [ DEL ]
📄 acl.h	7,242 B	[ EDIT ] \| [ DEL ]
📄 adb.h	22,595 B	[ EDIT ] \| [ DEL ]
📄 badcache.h	3,369 B	[ EDIT ] \| [ DEL ]
📄 bit.h	807 B	[ EDIT ] \| [ DEL ]
📄 byaddr.h	4,002 B	[ EDIT ] \| [ DEL ]
📄 cache.h	8,643 B	[ EDIT ] \| [ DEL ]
📄 callbacks.h	2,271 B	[ EDIT ] \| [ DEL ]
📄 catz.h	11,833 B	[ EDIT ] \| [ DEL ]
📄 cert.h	1,466 B	[ EDIT ] \| [ DEL ]
📄 client.h	22,042 B	[ EDIT ] \| [ DEL ]
📄 clientinfo.h	2,006 B	[ EDIT ] \| [ DEL ]
📄 compress.h	6,646 B	[ EDIT ] \| [ DEL ]
📄 db.h	47,061 B	[ EDIT ] \| [ DEL ]
📄 dbiterator.h	7,422 B	[ EDIT ] \| [ DEL ]
📄 dbtable.h	3,165 B	[ EDIT ] \| [ DEL ]
📄 diff.h	6,980 B	[ EDIT ] \| [ DEL ]
📄 dispatch.h	16,427 B	[ EDIT ] \| [ DEL ]
📄 dlz.h	10,618 B	[ EDIT ] \| [ DEL ]
📄 dlz_dlopen.h	4,677 B	[ EDIT ] \| [ DEL ]
📄 dns64.h	5,635 B	[ EDIT ] \| [ DEL ]
📄 dnssec.h	12,115 B	[ EDIT ] \| [ DEL ]
📄 dnstap.h	9,364 B	[ EDIT ] \| [ DEL ]
📄 ds.h	1,225 B	[ EDIT ] \| [ DEL ]
📄 dsdigest.h	1,722 B	[ EDIT ] \| [ DEL ]
📄 dyndb.h	4,835 B	[ EDIT ] \| [ DEL ]
📄 ecdb.h	809 B	[ EDIT ] \| [ DEL ]
📄 edns.h	722 B	[ EDIT ] \| [ DEL ]
📄 enumclass.h	1,220 B	[ EDIT ] \| [ DEL ]
📄 enumtype.h	8,300 B	[ EDIT ] \| [ DEL ]
📄 events.h	4,059 B	[ EDIT ] \| [ DEL ]
📄 fixedname.h	1,663 B	[ EDIT ] \| [ DEL ]
📄 forward.h	3,452 B	[ EDIT ] \| [ DEL ]
📄 geoip.h	2,792 B	[ EDIT ] \| [ DEL ]
📄 ipkeylist.h	2,186 B	[ EDIT ] \| [ DEL ]
📄 iptable.h	1,621 B	[ EDIT ] \| [ DEL ]
📄 journal.h	8,227 B	[ EDIT ] \| [ DEL ]
📄 keydata.h	1,059 B	[ EDIT ] \| [ DEL ]
📄 keyflags.h	1,278 B	[ EDIT ] \| [ DEL ]
📄 keytable.h	9,462 B	[ EDIT ] \| [ DEL ]
📄 keyvalues.h	4,159 B	[ EDIT ] \| [ DEL ]
📄 lib.h	1,192 B	[ EDIT ] \| [ DEL ]
📄 log.h	3,964 B	[ EDIT ] \| [ DEL ]
📄 lookup.h	2,924 B	[ EDIT ] \| [ DEL ]
📄 master.h	11,289 B	[ EDIT ] \| [ DEL ]
📄 masterdump.h	12,647 B	[ EDIT ] \| [ DEL ]
📄 message.h	39,023 B	[ EDIT ] \| [ DEL ]
📄 name.h	37,115 B	[ EDIT ] \| [ DEL ]
📄 ncache.h	4,929 B	[ EDIT ] \| [ DEL ]
📄 nsec.h	2,928 B	[ EDIT ] \| [ DEL ]
📄 nsec3.h	8,032 B	[ EDIT ] \| [ DEL ]
📄 nta.h	4,548 B	[ EDIT ] \| [ DEL ]
📄 opcode.h	1,007 B	[ EDIT ] \| [ DEL ]
📄 order.h	1,999 B	[ EDIT ] \| [ DEL ]
📄 peer.h	5,966 B	[ EDIT ] \| [ DEL ]
📄 portlist.h	2,101 B	[ EDIT ] \| [ DEL ]
📄 private.h	1,935 B	[ EDIT ] \| [ DEL ]
📄 rbt.h	40,618 B	[ EDIT ] \| [ DEL ]
📄 rcode.h	2,481 B	[ EDIT ] \| [ DEL ]
📄 rdata.h	21,613 B	[ EDIT ] \| [ DEL ]
📄 rdataclass.h	2,257 B	[ EDIT ] \| [ DEL ]
📄 rdatalist.h	2,569 B	[ EDIT ] \| [ DEL ]
📄 rdataset.h	21,536 B	[ EDIT ] \| [ DEL ]
📄 rdatasetiter.h	3,926 B	[ EDIT ] \| [ DEL ]
📄 rdataslab.h	4,502 B	[ EDIT ] \| [ DEL ]
📄 rdatastruct.h	61,584 B	[ EDIT ] \| [ DEL ]
📄 rdatatype.h	2,298 B	[ EDIT ] \| [ DEL ]
📄 request.h	11,156 B	[ EDIT ] \| [ DEL ]
📄 resolver.h	20,227 B	[ EDIT ] \| [ DEL ]
📄 result.h	9,284 B	[ EDIT ] \| [ DEL ]
📄 rootns.h	892 B	[ EDIT ] \| [ DEL ]
📄 rpz.h	10,335 B	[ EDIT ] \| [ DEL ]
📄 rriterator.h	4,230 B	[ EDIT ] \| [ DEL ]
📄 rrl.h	6,640 B	[ EDIT ] \| [ DEL ]
📄 sdb.h	7,224 B	[ EDIT ] \| [ DEL ]
📄 sdlz.h	14,214 B	[ EDIT ] \| [ DEL ]
📄 secalg.h	1,706 B	[ EDIT ] \| [ DEL ]
📄 secproto.h	1,557 B	[ EDIT ] \| [ DEL ]
📄 soa.h	2,186 B	[ EDIT ] \| [ DEL ]
📄 ssu.h	8,308 B	[ EDIT ] \| [ DEL ]
📄 stats.h	13,451 B	[ EDIT ] \| [ DEL ]
📄 tcpmsg.h	3,145 B	[ EDIT ] \| [ DEL ]
📄 time.h	1,695 B	[ EDIT ] \| [ DEL ]
📄 timer.h	1,051 B	[ EDIT ] \| [ DEL ]
📄 tkey.h	7,631 B	[ EDIT ] \| [ DEL ]
📄 tsec.h	2,949 B	[ EDIT ] \| [ DEL ]
📄 tsig.h	8,384 B	[ EDIT ] \| [ DEL ]
📄 ttl.h	1,945 B	[ EDIT ] \| [ DEL ]
📄 types.h	14,158 B	[ EDIT ] \| [ DEL ]
📄 update.h	1,653 B	[ EDIT ] \| [ DEL ]
📄 validator.h	7,161 B	[ EDIT ] \| [ DEL ]
📄 version.h	868 B	[ EDIT ] \| [ DEL ]
📄 view.h	35,274 B	[ EDIT ] \| [ DEL ]
📄 xfrin.h	2,924 B	[ EDIT ] \| [ DEL ]
📄 zone.h	60,864 B	[ EDIT ] \| [ DEL ]
📄 zonekey.h	777 B	[ EDIT ] \| [ DEL ]
📄 zt.h	5,562 B	[ EDIT ] \| [ DEL ]

[ CLOSE ]

EDIT: keytable.h

/*
 * 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_KEYTABLE_H
#define DNS_KEYTABLE_H 1

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

/*! \file
 * \brief
 * The keytable module provides services for storing and retrieving DNSSEC
 * trusted keys, as well as the ability to find the deepest matching key
 * for a given domain name.
 *
 * MP:
 *\li	The module ensures appropriate synchronization of data structures it
 *	creates and manipulates.
 *
 * Resources:
 *\li	TBS
 *
 * Security:
 *\li	No anticipated impact.
 */

#include <stdbool.h>

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

#include <dns/types.h>

#include <dst/dst.h>

ISC_LANG_BEGINDECLS

isc_result_t
dns_keytable_create(isc_mem_t *mctx, dns_keytable_t **keytablep);
/*%<
 * Create a keytable.
 *
 * Requires:
 *
 *\li	'mctx' is a valid memory context.
 *
 *\li	keytablep != NULL && *keytablep == NULL
 *
 * Ensures:
 *
 *\li	On success, *keytablep is a valid, empty key table.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any other result indicates failure.
 */

void
dns_keytable_attach(dns_keytable_t *source, dns_keytable_t **targetp);
/*%<
 * Attach *targetp to source.
 *
 * Requires:
 *
 *\li	'source' is a valid keytable.
 *
 *\li	'targetp' points to a NULL dns_keytable_t *.
 *
 * Ensures:
 *
 *\li	*targetp is attached to source.
 */

void
dns_keytable_detach(dns_keytable_t **keytablep);
/*%<
 * Detach *keytablep from its keytable.
 *
 * Requires:
 *
 *\li	'keytablep' points to a valid keytable.
 *
 * Ensures:
 *
 *\li	*keytablep is NULL.
 *
 *\li	If '*keytablep' is the last reference to the keytable,
 *		all resources used by the keytable will be freed
 */

isc_result_t
dns_keytable_add(dns_keytable_t *keytable, bool managed,
		 dst_key_t **keyp);
/*%<
 * Add '*keyp' to 'keytable' (using the name in '*keyp').
 * The value of keynode->managed is set to 'managed'
 *
 * Notes:
 *
 *\li	Ownership of *keyp is transferred to the keytable.
 *\li   If the key already exists in the table, ISC_R_EXISTS is
 *      returned and the new key is freed.
 *
 * Requires:
 *
 *\li	'keytable' points to a valid keytable.
 *
 *\li	keyp != NULL && *keyp is a valid dst_key_t *.
 *
 * Ensures:
 *
 *\li	On success, *keyp == NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_EXISTS
 *
 *\li	Any other result indicates failure.
 */

isc_result_t
dns_keytable_marksecure(dns_keytable_t *keytable, dns_name_t *name);
/*%<
 * Add a null key to 'keytable' for name 'name'.  This marks the
 * name as a secure domain, but doesn't supply any key data to allow the
 * domain to be validated.  (Used when automated trust anchor management
 * has gotten broken by a zone misconfiguration; for example, when the
 * active key has been revoked but the stand-by key was still in its 30-day
 * waiting period for validity.)
 *
 * Notes:
 *
 *\li   If a key already exists in the table, ISC_R_EXISTS is
 *      returned and nothing is done.
 *
 * Requires:
 *
 *\li	'keytable' points to a valid keytable.
 *
 *\li	keyp != NULL && *keyp is a valid dst_key_t *.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_EXISTS
 *
 *\li	Any other result indicates failure.
 */

isc_result_t
dns_keytable_delete(dns_keytable_t *keytable, dns_name_t *keyname);
/*%<
 * Delete node(s) from 'keytable' matching name 'keyname'
 *
 * Requires:
 *
 *\li	'keytable' points to a valid keytable.
 *
 *\li	'name' is not NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any other result indicates failure.
 */

isc_result_t
dns_keytable_deletekeynode(dns_keytable_t *keytable, dst_key_t *dstkey);
/*%<
 * Delete node(s) from 'keytable' containing copies of the key pointed
 * to by 'dstkey'
 *
 * Requires:
 *
 *\li	'keytable' points to a valid keytable.
 *\li	'dstkey' is not NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any other result indicates failure.
 */

isc_result_t
dns_keytable_find(dns_keytable_t *keytable, dns_name_t *keyname,
		  dns_keynode_t **keynodep);
/*%<
 * Search for the first instance of a key named 'name' in 'keytable',
 * without regard to keyid and algorithm.  Use dns_keytable_nextkeynode()
 * to find subsequent instances.
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'name' is a valid absolute name.
 *
 *\li	keynodep != NULL && *keynodep == NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_NOTFOUND
 *
 *\li	Any other result indicates an error.
 */

isc_result_t
dns_keytable_nextkeynode(dns_keytable_t *keytable, dns_keynode_t *keynode,
			 dns_keynode_t **nextnodep);
/*%<
 * Return for the next key after 'keynode' in 'keytable', without regard to
 * keyid and algorithm.
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'keynode' is a valid keynode.
 *
 *\li	nextnodep != NULL && *nextnodep == NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_NOTFOUND
 *
 *\li	Any other result indicates an error.
 */

isc_result_t
dns_keytable_findkeynode(dns_keytable_t *keytable, dns_name_t *name,
			 dns_secalg_t algorithm, dns_keytag_t tag,
			 dns_keynode_t **keynodep);
/*%<
 * Search for a key named 'name', matching 'algorithm' and 'tag' in
 * 'keytable'.  This finds the first instance which matches.  Use
 * dns_keytable_findnextkeynode() to find other instances.
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'name' is a valid absolute name.
 *
 *\li	keynodep != NULL && *keynodep == NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	DNS_R_PARTIALMATCH	the name existed in the keytable.
 *\li	ISC_R_NOTFOUND
 *
 *\li	Any other result indicates an error.
 */

isc_result_t
dns_keytable_findnextkeynode(dns_keytable_t *keytable, dns_keynode_t *keynode,
					     dns_keynode_t **nextnodep);
/*%<
 * Search for the next key with the same properties as 'keynode' in
 * 'keytable' as found by dns_keytable_findkeynode().
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'keynode' is a valid keynode.
 *
 *\li	nextnodep != NULL && *nextnodep == NULL
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_NOTFOUND
 *
 *\li	Any other result indicates an error.
 */

isc_result_t
dns_keytable_finddeepestmatch(dns_keytable_t *keytable, dns_name_t *name,
			      dns_name_t *foundname);
/*%<
 * Search for the deepest match of 'name' in 'keytable'.
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'name' is a valid absolute name.
 *
 *\li	'foundname' is a name with a dedicated buffer.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *\li	ISC_R_NOTFOUND
 *
 *\li	Any other result indicates an error.
 */

void
dns_keytable_attachkeynode(dns_keytable_t *keytable, dns_keynode_t *source,
			   dns_keynode_t **target);
/*%<
 * Attach a keynode and and increment the active_nodes counter in a
 * corresponding keytable.
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'source' is a valid keynode.
 *
 *\li	'target' is not null and '*target' is null.
 */

void
dns_keytable_detachkeynode(dns_keytable_t *keytable,
			   dns_keynode_t **keynodep);
/*%<
 * Give back a keynode found via dns_keytable_findkeynode().
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	*keynodep is a valid keynode returned by a call to
 *	dns_keytable_findkeynode().
 *
 * Ensures:
 *
 *\li	*keynodep == NULL
 */

isc_result_t
dns_keytable_issecuredomain(dns_keytable_t *keytable, dns_name_t *name,
			    dns_name_t *foundname, bool *wantdnssecp);
/*%<
 * Is 'name' at or beneath a trusted key?
 *
 * Requires:
 *
 *\li	'keytable' is a valid keytable.
 *
 *\li	'name' is a valid absolute name.
 *
 *\li	'foundanme' is NULL or is a pointer to an initialized dns_name_t
 *
 *\li	'*wantsdnssecp' is a valid bool.

* Ensures:
 *
 *\li	On success, *wantsdnssecp will be true if and only if 'name'
 *	is at or beneath a trusted key.  If 'foundname' is not NULL, then
 *	it will be updated to contain the name of the closest enclosing
 *	trust anchor.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any other result is an error.
 */

isc_result_t
dns_keytable_dump(dns_keytable_t *keytable, FILE *fp);
/*%<
 * Dump the keytable on fp.
 */

isc_result_t
dns_keytable_totext(dns_keytable_t *keytable, isc_buffer_t **buf);
/*%<
 * Dump the keytable to buffer at 'buf'
 */

dst_key_t *
dns_keynode_key(dns_keynode_t *keynode);
/*%<
 * Get the DST key associated with keynode.
 */

bool
dns_keynode_managed(dns_keynode_t *keynode);
/*%<
 * Is this flagged as a managed key?
 */

isc_result_t
dns_keynode_create(isc_mem_t *mctx, dns_keynode_t **target);
/*%<
 * Allocate space for a keynode
 */

void
dns_keynode_attach(dns_keynode_t *source, dns_keynode_t **target);
/*%<
 * Attach keynode 'source' to '*target'
 */

void
dns_keynode_detach(isc_mem_t *mctx, dns_keynode_t **target);
/*%<
 * Detach a single keynode, without touching any keynodes that
 * may be pointed to by its 'next' pointer
 */

void
dns_keynode_detachall(isc_mem_t *mctx, dns_keynode_t **target);
/*%<
 * Detach a keynode and all its successors.
 */

isc_result_t
dns_keytable_forall(dns_keytable_t *keytable,
		    void (*func)(dns_keytable_t *, dns_keynode_t *, void *),
		    void *arg);
ISC_LANG_ENDDECLS

#endif /* DNS_KEYTABLE_H */