Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
acl.h	6.33 KB	-rw-r--r--	2021-11-05 09:03
adb.h	21.75 KB	-rw-r--r--	2021-11-05 09:03
badcache.h	3.31 KB	-rw-r--r--	2021-11-05 09:03
bit.h	798 B	-rw-r--r--	2021-11-05 09:03
byaddr.h	3.51 KB	-rw-r--r--	2021-11-05 09:03
cache.h	8.53 KB	-rw-r--r--	2025-07-29 21:41
callbacks.h	2.23 KB	-rw-r--r--	2021-11-05 09:03
catz.h	11.6 KB	-rw-r--r--	2021-11-05 09:03
cert.h	1.43 KB	-rw-r--r--	2021-11-05 09:03
client.h	14.19 KB	-rw-r--r--	2021-11-05 09:03
clientinfo.h	1.97 KB	-rw-r--r--	2021-11-05 09:03
compress.h	6.88 KB	-rw-r--r--	2021-11-05 09:03
db.h	49.26 KB	-rw-r--r--	2025-07-29 21:41
dbiterator.h	7.21 KB	-rw-r--r--	2021-11-05 09:03
dbtable.h	3.09 KB	-rw-r--r--	2021-11-05 09:03
diff.h	6.87 KB	-rw-r--r--	2021-11-05 09:03
dispatch.h	15.17 KB	-rw-r--r--	2021-11-05 09:03
dlz.h	10.62 KB	-rw-r--r--	2021-11-05 09:03
dlz_dlopen.h	4.29 KB	-rw-r--r--	2021-11-05 09:03
dns64.h	5.59 KB	-rw-r--r--	2021-11-05 09:03
dnsrps.h	2.51 KB	-rw-r--r--	2021-11-05 09:03
dnssec.h	12.29 KB	-rw-r--r--	2021-11-05 09:03
dnstap.h	9.95 KB	-rw-r--r--	2021-11-05 09:03
ds.h	1.63 KB	-rw-r--r--	2021-11-05 09:03
dsdigest.h	1.67 KB	-rw-r--r--	2021-11-05 09:03
dyndb.h	4.75 KB	-rw-r--r--	2021-11-05 09:03
ecdb.h	806 B	-rw-r--r--	2021-11-05 09:03
ecs.h	1.22 KB	-rw-r--r--	2021-11-05 09:03
edns.h	783 B	-rw-r--r--	2021-11-05 09:03
enumclass.h	1.19 KB	-rw-r--r--	2025-07-29 21:42
enumtype.h	8.29 KB	-rw-r--r--	2025-07-29 21:42
events.h	4.35 KB	-rw-r--r--	2021-11-05 09:03
fixedname.h	1.61 KB	-rw-r--r--	2021-11-05 09:03
forward.h	2.99 KB	-rw-r--r--	2021-11-05 09:03
geoip.h	2.29 KB	-rw-r--r--	2021-11-05 09:03
ipkeylist.h	2.17 KB	-rw-r--r--	2021-11-05 09:03
iptable.h	1.49 KB	-rw-r--r--	2021-11-05 09:03
journal.h	9.48 KB	-rw-r--r--	2021-11-05 09:03
kasp.h	11.84 KB	-rw-r--r--	2021-11-05 09:03
keydata.h	1.02 KB	-rw-r--r--	2021-11-05 09:03
keyflags.h	1.25 KB	-rw-r--r--	2021-11-05 09:03
keymgr.h	4.01 KB	-rw-r--r--	2021-11-05 09:03
keytable.h	7.69 KB	-rw-r--r--	2021-11-05 09:03
keyvalues.h	3.99 KB	-rw-r--r--	2021-11-05 09:03
lib.h	993 B	-rw-r--r--	2021-11-05 09:03
librpz.h	30.67 KB	-rw-r--r--	2021-11-05 09:03
lmdb.h	779 B	-rw-r--r--	2021-11-05 09:03
log.h	3.93 KB	-rw-r--r--	2021-11-05 09:03
lookup.h	2.85 KB	-rw-r--r--	2021-11-05 09:03
master.h	8.58 KB	-rw-r--r--	2021-11-05 09:03
masterdump.h	9.9 KB	-rw-r--r--	2021-11-05 09:03
message.h	38.41 KB	-rw-r--r--	2025-07-29 21:41
name.h	36.9 KB	-rw-r--r--	2025-07-29 21:41
ncache.h	4.84 KB	-rw-r--r--	2021-11-05 09:03
nsec.h	2.99 KB	-rw-r--r--	2021-11-05 09:03
nsec3.h	8.06 KB	-rw-r--r--	2021-11-05 09:03
nta.h	4.73 KB	-rw-r--r--	2021-11-05 09:03
opcode.h	1006 B	-rw-r--r--	2021-11-05 09:03
order.h	1.96 KB	-rw-r--r--	2021-11-05 09:03
peer.h	6.32 KB	-rw-r--r--	2021-11-05 09:03
portlist.h	2.05 KB	-rw-r--r--	2021-11-05 09:03
private.h	1.92 KB	-rw-r--r--	2021-11-05 09:03
rbt.h	36.61 KB	-rw-r--r--	2025-07-29 21:41
rcode.h	2.41 KB	-rw-r--r--	2021-11-05 09:03
rdata.h	22.04 KB	-rw-r--r--	2021-11-05 09:03
rdataclass.h	2.2 KB	-rw-r--r--	2021-11-05 09:03
rdatalist.h	2.5 KB	-rw-r--r--	2021-11-05 09:03
rdataset.h	18.28 KB	-rw-r--r--	2025-07-29 21:41
rdatasetiter.h	3.82 KB	-rw-r--r--	2021-11-05 09:03
rdataslab.h	4.14 KB	-rw-r--r--	2025-07-29 21:41
rdatastruct.h	61.23 KB	-rw-r--r--	2025-07-29 21:42
rdatatype.h	2.24 KB	-rw-r--r--	2021-11-05 09:03
request.h	8.97 KB	-rw-r--r--	2021-11-05 09:03
resolver.h	19.68 KB	-rw-r--r--	2021-11-05 09:03
result.h	8.98 KB	-rw-r--r--	2021-11-05 09:03
rootns.h	891 B	-rw-r--r--	2021-11-05 09:03
rpz.h	11.87 KB	-rw-r--r--	2021-11-05 09:03
rriterator.h	4.12 KB	-rw-r--r--	2021-11-05 09:03
rrl.h	6.8 KB	-rw-r--r--	2021-11-05 09:03
sdb.h	7.18 KB	-rw-r--r--	2021-11-05 09:03
sdlz.h	13.76 KB	-rw-r--r--	2021-11-05 09:03
secalg.h	1.67 KB	-rw-r--r--	2021-11-05 09:03
secproto.h	1.52 KB	-rw-r--r--	2021-11-05 09:03
soa.h	2.13 KB	-rw-r--r--	2021-11-05 09:03
ssu.h	7.01 KB	-rw-r--r--	2021-11-05 09:03
stats.h	24.11 KB	-rw-r--r--	2021-11-05 09:03
tcpmsg.h	3.05 KB	-rw-r--r--	2021-11-05 09:03
time.h	1.65 KB	-rw-r--r--	2021-11-05 09:03
timer.h	1.03 KB	-rw-r--r--	2021-11-05 09:03
tkey.h	7.48 KB	-rw-r--r--	2021-11-05 09:03
tsec.h	2.88 KB	-rw-r--r--	2021-11-05 09:03
tsig.h	8.3 KB	-rw-r--r--	2021-11-05 09:03
ttl.h	1.83 KB	-rw-r--r--	2021-11-05 09:03
types.h	14.19 KB	-rw-r--r--	2021-11-05 09:03
update.h	1.96 KB	-rw-r--r--	2021-11-05 09:03
validator.h	6.52 KB	-rw-r--r--	2025-07-29 21:41
version.h	679 B	-rw-r--r--	2021-11-05 09:03
view.h	34.51 KB	-rw-r--r--	2025-07-29 21:41
xfrin.h	2.26 KB	-rw-r--r--	2021-11-05 09:03
zone.h	64.01 KB	-rw-r--r--	2025-07-29 21:41
zonekey.h	776 B	-rw-r--r--	2021-11-05 09:03
zoneverify.h	1.36 KB	-rw-r--r--	2021-11-05 09:03
zt.h	5.12 KB	-rw-r--r--	2025-07-29 21:41

Rename

/*
 * 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_TSIG_H
#define DNS_TSIG_H 1

/*! \file dns/tsig.h */

#include <stdbool.h>

#include <isc/lang.h>
#include <isc/refcount.h>
#include <isc/rwlock.h>
#include <isc/stdio.h>
#include <isc/stdtime.h>

#include <dns/name.h>
#include <dns/types.h>

#include <dst/dst.h>
#include <pk11/site.h>

/*
 * Algorithms.
 */
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacmd5_name;
#define DNS_TSIG_HMACMD5_NAME dns_tsig_hmacmd5_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_gssapi_name;
#define DNS_TSIG_GSSAPI_NAME dns_tsig_gssapi_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_gssapims_name;
#define DNS_TSIG_GSSAPIMS_NAME dns_tsig_gssapims_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacsha1_name;
#define DNS_TSIG_HMACSHA1_NAME dns_tsig_hmacsha1_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacsha224_name;
#define DNS_TSIG_HMACSHA224_NAME dns_tsig_hmacsha224_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacsha256_name;
#define DNS_TSIG_HMACSHA256_NAME dns_tsig_hmacsha256_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacsha384_name;
#define DNS_TSIG_HMACSHA384_NAME dns_tsig_hmacsha384_name
LIBDNS_EXTERNAL_DATA extern const dns_name_t *dns_tsig_hmacsha512_name;
#define DNS_TSIG_HMACSHA512_NAME dns_tsig_hmacsha512_name

/*%
 * Default fudge value.
 */
#define DNS_TSIG_FUDGE 300

struct dns_tsig_keyring {
	dns_rbt_t	  *keys;
	unsigned int writecount;
	isc_rwlock_t lock;
	isc_mem_t	  *mctx;
	/*
	 * LRU list of generated key along with a count of the keys on the
	 * list and a maximum size.
	 */
	unsigned int generated;
	unsigned int maxgenerated;
	ISC_LIST(dns_tsigkey_t) lru;
	isc_refcount_t references;
};

struct dns_tsigkey {
	/* Unlocked */
	unsigned int	    magic; /*%< Magic number. */
	isc_mem_t	  *mctx;
	dst_key_t	  *key;       /*%< Key */
	dns_name_t	    name;      /*%< Key name */
	const dns_name_t	 *algorithm; /*%< Algorithm name */
	dns_name_t	   *creator;   /*%< name that created secret */
	bool		    generated; /*%< was this generated? */
	isc_stdtime_t	    inception; /*%< start of validity period */
	isc_stdtime_t	    expire;    /*%< end of validity period */
	dns_tsig_keyring_t *ring;      /*%< the enclosing keyring */
	isc_refcount_t	    refs;      /*%< reference counter */
	ISC_LINK(dns_tsigkey_t) link;
};

ISC_LANG_BEGINDECLS

const dns_name_t *
dns_tsigkey_identity(const dns_tsigkey_t *tsigkey);
/*%<
 *	Returns the identity of the provided TSIG key.
 *
 *	Requires:
 *\li		'tsigkey' is a valid TSIG key or NULL
 *
 *	Returns:
 *\li		NULL if 'tsigkey' was NULL
 *\li		identity of the provided TSIG key
 */

isc_result_t
dns_tsigkey_create(const dns_name_t *name, const dns_name_t *algorithm,
		   unsigned char *secret, int length, bool generated,
		   const dns_name_t *creator, isc_stdtime_t inception,
		   isc_stdtime_t expire, isc_mem_t *mctx,
		   dns_tsig_keyring_t *ring, dns_tsigkey_t **key);

isc_result_t
dns_tsigkey_createfromkey(const dns_name_t *name, const dns_name_t *algorithm,
			  dst_key_t *dstkey, bool generated,
			  const dns_name_t *creator, isc_stdtime_t inception,
			  isc_stdtime_t expire, isc_mem_t *mctx,
			  dns_tsig_keyring_t *ring, dns_tsigkey_t **key);
/*%<
 *	Creates a tsig key structure and saves it in the keyring.  If key is
 *	not NULL, *key will contain a copy of the key.  The keys validity
 *	period is specified by (inception, expire), and will not expire if
 *	inception == expire.  If the key was generated, the creating identity,
 *	if there is one, should be in the creator parameter.  Specifying an
 *	unimplemented algorithm will cause failure only if dstkey != NULL; this
 *	allows a transient key with an invalid algorithm to exist long enough
 *	to generate a BADKEY response.
 *
 *	If dns_tsigkey_createfromkey is successful a new reference to 'dstkey'
 *	will have been made.
 *
 *	Requires:
 *\li		'name' is a valid dns_name_t
 *\li		'algorithm' is a valid dns_name_t
 *\li		'secret' is a valid pointer
 *\li		'length' is an integer >= 0
 *\li		'dstkey' is a valid dst key or NULL
 *\li		'creator' points to a valid dns_name_t or is NULL
 *\li		'mctx' is a valid memory context
 *\li		'ring' is a valid TSIG keyring or NULL
 *\li		'key' or '*key' must be NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_EXISTS - a key with this name already exists
 *\li		#ISC_R_NOTIMPLEMENTED - algorithm is not implemented
 *\li		#ISC_R_NOMEMORY
 */

void
dns_tsigkey_attach(dns_tsigkey_t *source, dns_tsigkey_t **targetp);
/*%<
 *	Attach '*targetp' to 'source'.
 *
 *	Requires:
 *\li		'key' is a valid TSIG key
 *
 *	Ensures:
 *\li		*targetp is attached to source.
 */

void
dns_tsigkey_detach(dns_tsigkey_t **keyp);
/*%<
 *	Detaches from the tsig key structure pointed to by '*key'.
 *
 *	Requires:
 *\li		'keyp' is not NULL and '*keyp' is a valid TSIG key
 *
 *	Ensures:
 *\li		'keyp' points to NULL
 */

void
dns_tsigkey_setdeleted(dns_tsigkey_t *key);
/*%<
 *	Prevents this key from being used again.  It will be deleted when
 *	no references exist.
 *
 *	Requires:
 *\li		'key' is a valid TSIG key on a keyring
 */

isc_result_t
dns_tsig_sign(dns_message_t *msg);
/*%<
 *	Generates a TSIG record for this message
 *
 *	Requires:
 *\li		'msg' is a valid message
 *\li		'msg->tsigkey' is a valid TSIG key
 *\li		'msg->tsig' is NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_NOMEMORY
 *\li		#ISC_R_NOSPACE
 *\li		#DNS_R_EXPECTEDTSIG
 *			- this is a response & msg->querytsig is NULL
 */

isc_result_t
dns_tsig_verify(isc_buffer_t *source, dns_message_t *msg,
		dns_tsig_keyring_t *ring1, dns_tsig_keyring_t *ring2);
/*%<
 *	Verifies the TSIG record in this message
 *
 *	Requires:
 *\li		'source' is a valid buffer containing the unparsed message
 *\li		'msg' is a valid message
 *\li		'msg->tsigkey' is a valid TSIG key if this is a response
 *\li		'msg->tsig' is NULL
 *\li		'msg->querytsig' is not NULL if this is a response
 *\li		'ring1' and 'ring2' are each either a valid keyring or NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_NOMEMORY
 *\li		#DNS_R_EXPECTEDTSIG - A TSIG was expected but not seen
 *\li		#DNS_R_UNEXPECTEDTSIG - A TSIG was seen but not expected
 *\li		#DNS_R_TSIGERRORSET - the TSIG verified but ->error was set
 *				     and this is a query
 *\li		#DNS_R_CLOCKSKEW - the TSIG failed to verify because of
 *				  the time was out of the allowed range.
 *\li		#DNS_R_TSIGVERIFYFAILURE - the TSIG failed to verify
 *\li		#DNS_R_EXPECTEDRESPONSE - the message was set over TCP and
 *					 should have been a response,
 *					 but was not.
 */

isc_result_t
dns_tsigkey_find(dns_tsigkey_t **tsigkey, const dns_name_t *name,
		 const dns_name_t *algorithm, dns_tsig_keyring_t *ring);
/*%<
 *	Returns the TSIG key corresponding to this name and (possibly)
 *	algorithm.  Also increments the key's reference counter.
 *
 *	Requires:
 *\li		'tsigkey' is not NULL
 *\li		'*tsigkey' is NULL
 *\li		'name' is a valid dns_name_t
 *\li		'algorithm' is a valid dns_name_t or NULL
 *\li		'ring' is a valid keyring
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_NOTFOUND
 */

isc_result_t
dns_tsigkeyring_create(isc_mem_t *mctx, dns_tsig_keyring_t **ringp);
/*%<
 *	Create an empty TSIG key ring.
 *
 *	Requires:
 *\li		'mctx' is not NULL
 *\li		'ringp' is not NULL, and '*ringp' is NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_NOMEMORY
 */

isc_result_t
dns_tsigkeyring_add(dns_tsig_keyring_t *ring, const dns_name_t *name,
		    dns_tsigkey_t *tkey);
/*%<
 *      Place a TSIG key onto a key ring.
 *
 *	Requires:
 *\li		'ring', 'name' and 'tkey' are not NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS
 *\li		Any other value indicates failure.
 */

void
dns_tsigkeyring_attach(dns_tsig_keyring_t *source, dns_tsig_keyring_t **target);

void
dns_tsigkeyring_detach(dns_tsig_keyring_t **ringp);

isc_result_t
dns_tsigkeyring_dumpanddetach(dns_tsig_keyring_t **ringp, FILE *fp);

/*%<
 *	Destroy a TSIG key ring.
 *
 *	Requires:
 *\li		'ringp' is not NULL
 */

void
dns_keyring_restore(dns_tsig_keyring_t *ring, FILE *fp);

ISC_LANG_ENDDECLS

#endif /* DNS_TSIG_H */