Gecko [ cel-fi.com.my ]

Name	Size	Permission	Date
acache.h	13.99 KB	-rw-r--r--	2026-05-27 23:00
acl.h	7.1 KB	-rw-r--r--	2026-05-27 23:00
adb.h	22.03 KB	-rw-r--r--	2026-05-27 23:00
badcache.h	3.28 KB	-rw-r--r--	2026-05-27 23:00
bit.h	856 B	-rw-r--r--	2026-05-27 23:00
byaddr.h	3.89 KB	-rw-r--r--	2026-05-27 23:00
cache.h	7.95 KB	-rw-r--r--	2026-05-27 23:00
callbacks.h	2.22 KB	-rw-r--r--	2026-05-27 23:00
catz.h	11.54 KB	-rw-r--r--	2026-05-27 23:00
cert.h	1.43 KB	-rw-r--r--	2026-05-27 23:00
client.h	21.52 KB	-rw-r--r--	2026-05-27 23:00
clientinfo.h	1.95 KB	-rw-r--r--	2026-05-27 23:00
compress.h	6.51 KB	-rw-r--r--	2026-05-27 23:00
db.h	44.68 KB	-rw-r--r--	2026-05-27 23:00
dbiterator.h	7.26 KB	-rw-r--r--	2026-05-27 23:00
dbtable.h	3.09 KB	-rw-r--r--	2026-05-27 23:00
diff.h	6.82 KB	-rw-r--r--	2026-05-27 23:00
dispatch.h	16.05 KB	-rw-r--r--	2026-05-27 23:00
dlz.h	10.38 KB	-rw-r--r--	2026-05-27 23:00
dlz_dlopen.h	4.54 KB	-rw-r--r--	2026-05-27 23:00
dns64.h	5.51 KB	-rw-r--r--	2026-05-27 23:00
dnssec.h	12 KB	-rw-r--r--	2026-05-27 23:00
dnstap.h	9.2 KB	-rw-r--r--	2026-05-27 23:00
ds.h	1.19 KB	-rw-r--r--	2026-05-27 23:00
dsdigest.h	1.68 KB	-rw-r--r--	2026-05-27 23:00
dyndb.h	4.72 KB	-rw-r--r--	2026-05-27 23:00
ecdb.h	808 B	-rw-r--r--	2026-05-27 23:00
edns.h	721 B	-rw-r--r--	2026-05-27 23:00
enumclass.h	1.19 KB	-rw-r--r--	2026-05-27 23:00
enumtype.h	7.74 KB	-rw-r--r--	2026-05-27 23:00
events.h	3.96 KB	-rw-r--r--	2026-05-27 23:00
fixedname.h	1.56 KB	-rw-r--r--	2026-05-27 23:00
forward.h	3.37 KB	-rw-r--r--	2026-05-27 23:00
geoip.h	2.34 KB	-rw-r--r--	2026-05-27 23:00
ipkeylist.h	2.12 KB	-rw-r--r--	2026-05-27 23:00
iptable.h	1.6 KB	-rw-r--r--	2026-05-27 23:00
journal.h	8.05 KB	-rw-r--r--	2026-05-27 23:00
keydata.h	1.02 KB	-rw-r--r--	2026-05-27 23:00
keyflags.h	1.25 KB	-rw-r--r--	2026-05-27 23:00
keytable.h	9.28 KB	-rw-r--r--	2026-05-27 23:00
keyvalues.h	4.06 KB	-rw-r--r--	2026-05-27 23:00
lib.h	1.16 KB	-rw-r--r--	2026-05-27 23:00
log.h	3.87 KB	-rw-r--r--	2026-05-27 23:00
lookup.h	2.85 KB	-rw-r--r--	2026-05-27 23:00
master.h	11.08 KB	-rw-r--r--	2026-05-27 23:00
masterdump.h	12.35 KB	-rw-r--r--	2026-05-27 23:00
message.h	38.69 KB	-rw-r--r--	2026-05-27 23:00
name.h	36.62 KB	-rw-r--r--	2026-05-27 23:00
ncache.h	4.8 KB	-rw-r--r--	2026-05-27 23:00
nsec.h	2.88 KB	-rw-r--r--	2026-05-27 23:00
nsec3.h	8.21 KB	-rw-r--r--	2026-05-27 23:00
nta.h	4.32 KB	-rw-r--r--	2026-05-27 23:00
opcode.h	1006 B	-rw-r--r--	2026-05-27 23:00
order.h	1.95 KB	-rw-r--r--	2026-05-27 23:00
peer.h	6.06 KB	-rw-r--r--	2026-05-27 23:00
portlist.h	2.05 KB	-rw-r--r--	2026-05-27 23:00
private.h	1.9 KB	-rw-r--r--	2026-05-27 23:00
rbt.h	39.7 KB	-rw-r--r--	2026-05-27 23:00
rcode.h	2.42 KB	-rw-r--r--	2026-05-27 23:00
rdata.h	20.92 KB	-rw-r--r--	2026-05-27 23:00
rdataclass.h	2.2 KB	-rw-r--r--	2026-05-27 23:00
rdatalist.h	2.51 KB	-rw-r--r--	2026-05-27 23:00
rdataset.h	20.85 KB	-rw-r--r--	2026-05-27 23:00
rdatasetiter.h	3.83 KB	-rw-r--r--	2026-05-27 23:00
rdataslab.h	4.29 KB	-rw-r--r--	2026-05-27 23:00
rdatastruct.h	57.57 KB	-rw-r--r--	2026-05-27 23:00
rdatatype.h	2.24 KB	-rw-r--r--	2026-05-27 23:00
request.h	10.89 KB	-rw-r--r--	2026-05-27 23:00
resolver.h	18.63 KB	-rw-r--r--	2026-05-27 23:00
result.h	8.57 KB	-rw-r--r--	2026-05-27 23:00
rootns.h	891 B	-rw-r--r--	2026-05-27 23:00
rpz.h	10.09 KB	-rw-r--r--	2026-05-27 23:00
rriterator.h	4.17 KB	-rw-r--r--	2026-05-27 23:00
rrl.h	6.49 KB	-rw-r--r--	2026-05-27 23:00
sdb.h	7.04 KB	-rw-r--r--	2026-05-27 23:00
sdlz.h	13.87 KB	-rw-r--r--	2026-05-27 23:00
secalg.h	1.67 KB	-rw-r--r--	2026-05-27 23:00
secproto.h	1.52 KB	-rw-r--r--	2026-05-27 23:00
soa.h	2.17 KB	-rw-r--r--	2026-05-27 23:00
ssu.h	8.09 KB	-rw-r--r--	2026-05-27 23:00
stats.h	13.15 KB	-rw-r--r--	2026-05-27 23:00
tcpmsg.h	3.05 KB	-rw-r--r--	2026-05-27 23:00
time.h	1.66 KB	-rw-r--r--	2026-05-27 23:00
timer.h	1.02 KB	-rw-r--r--	2026-05-27 23:00
tkey.h	7.43 KB	-rw-r--r--	2026-05-27 23:00
tsec.h	2.88 KB	-rw-r--r--	2026-05-27 23:00
tsig.h	8.06 KB	-rw-r--r--	2026-05-27 23:00
ttl.h	1.93 KB	-rw-r--r--	2026-05-27 23:00
types.h	13.8 KB	-rw-r--r--	2026-05-27 23:00
update.h	1.61 KB	-rw-r--r--	2026-05-27 23:00
validator.h	7.02 KB	-rw-r--r--	2026-05-27 23:00
version.h	867 B	-rw-r--r--	2026-05-27 23:00
view.h	34.69 KB	-rw-r--r--	2026-05-27 23:00
xfrin.h	2.85 KB	-rw-r--r--	2026-05-27 23:00
zone.h	59.8 KB	-rw-r--r--	2026-05-27 23:00
zonekey.h	763 B	-rw-r--r--	2026-05-27 23:00
zt.h	5.31 KB	-rw-r--r--	2026-05-27 23:00

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

#ifndef DNS_TKEY_H
#define DNS_TKEY_H 1

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

#include <isc/lang.h>

#include <dns/types.h>

#include <dst/dst.h>
#include <dst/gssapi.h>

ISC_LANG_BEGINDECLS

/* Key agreement modes */
#define DNS_TKEYMODE_SERVERASSIGNED		1
#define DNS_TKEYMODE_DIFFIEHELLMAN		2
#define DNS_TKEYMODE_GSSAPI			3
#define DNS_TKEYMODE_RESOLVERASSIGNED		4
#define DNS_TKEYMODE_DELETE			5

struct dns_tkeyctx {
	dst_key_t *dhkey;
	dns_name_t *domain;
	gss_cred_id_t gsscred;
	isc_mem_t *mctx;
	isc_entropy_t *ectx;
	char *gssapi_keytab;
};

isc_result_t
dns_tkeyctx_create(isc_mem_t *mctx, isc_entropy_t *ectx,
		   dns_tkeyctx_t **tctxp);
/*%<
 *	Create an empty TKEY context.
 *
 * 	Requires:
 *\li		'mctx' is not NULL
 *\li		'tctx' is not NULL
 *\li		'*tctx' is NULL
 *
 *	Returns
 *\li		#ISC_R_SUCCESS
 *\li		#ISC_R_NOMEMORY
 *\li		return codes from dns_name_fromtext()
 */

void
dns_tkeyctx_destroy(dns_tkeyctx_t **tctxp);
/*%<
 *      Frees all data associated with the TKEY context
 *
 * 	Requires:
 *\li		'tctx' is not NULL
 *\li		'*tctx' is not NULL
 */

isc_result_t
dns_tkey_processquery(dns_message_t *msg, dns_tkeyctx_t *tctx,
		      dns_tsig_keyring_t *ring);
/*%<
 *	Processes a query containing a TKEY record, adding or deleting TSIG
 *	keys if necessary, and modifies the message to contain the response.
 *
 *	Requires:
 *\li		'msg' is a valid message
 *\li		'tctx' is a valid TKEY context
 *\li		'ring' is a valid TSIG keyring
 *
 *	Returns
 *\li		#ISC_R_SUCCESS	msg was updated (the TKEY operation succeeded,
 *				or msg now includes a TKEY with an error set)
 *		DNS_R_FORMERR	the packet was malformed (missing a TKEY
 *				or KEY).
 *\li		other		An error occurred while processing the message
 */

isc_result_t
dns_tkey_builddhquery(dns_message_t *msg, dst_key_t *key, dns_name_t *name,
		      dns_name_t *algorithm, isc_buffer_t *nonce,
		      isc_uint32_t lifetime);
/*%<
 *	Builds a query containing a TKEY that will generate a shared
 *	secret using a Diffie-Hellman key exchange.  The shared key
 *	will be of the specified algorithm (only DNS_TSIG_HMACMD5_NAME
 *	is supported), and will be named either 'name',
 *	'name' + server chosen domain, or random data + server chosen domain
 *	if 'name' == dns_rootname.  If nonce is not NULL, it supplies
 *	random data used in the shared secret computation.  The key is
 *	requested to have the specified lifetime (in seconds)
 *
 *
 *	Requires:
 *\li		'msg' is a valid message
 *\li		'key' is a valid Diffie Hellman dst key
 *\li		'name' is a valid name
 *\li		'algorithm' is a valid name
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS	msg was successfully updated to include the
 *				query to be sent
 *\li		other		an error occurred while building the message
 */

isc_result_t
dns_tkey_buildgssquery(dns_message_t *msg, dns_name_t *name, dns_name_t *gname,
		       isc_buffer_t *intoken, isc_uint32_t lifetime,
		       gss_ctx_id_t *context, isc_boolean_t win2k,
		       isc_mem_t *mctx, char **err_message);
/*%<
 *	Builds a query containing a TKEY that will generate a GSSAPI context.
 *	The key is requested to have the specified lifetime (in seconds).
 *
 *	Requires:
 *\li		'msg'	  is a valid message
 *\li		'name'	  is a valid name
 *\li		'gname'	  is a valid name
 *\li		'context' is a pointer to a valid gss_ctx_id_t
 *			  (which may have the value GSS_C_NO_CONTEXT)
 *\li		'win2k'   when true says to turn on some hacks to work
 *			  with the non-standard GSS-TSIG of Windows 2000
 *
 *	Returns:
 *\li		ISC_R_SUCCESS	msg was successfully updated to include the
 *				query to be sent
 *\li		other		an error occurred while building the message
 *\li		*err_message	optional error message
 */

isc_result_t
dns_tkey_builddeletequery(dns_message_t *msg, dns_tsigkey_t *key);
/*%<
 *	Builds a query containing a TKEY record that will delete the
 *	specified shared secret from the server.
 *
 *	Requires:
 *\li		'msg' is a valid message
 *\li		'key' is a valid TSIG key
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS	msg was successfully updated to include the
 *				query to be sent
 *\li		other		an error occurred while building the message
 */

isc_result_t
dns_tkey_processdhresponse(dns_message_t *qmsg, dns_message_t *rmsg,
			   dst_key_t *key, isc_buffer_t *nonce,
			   dns_tsigkey_t **outkey, dns_tsig_keyring_t *ring);
/*%<
 *	Processes a response to a query containing a TKEY that was
 *	designed to generate a shared secret using a Diffie-Hellman key
 *	exchange.  If the query was successful, a new shared key
 *	is created and added to the list of shared keys.
 *
 *	Requires:
 *\li		'qmsg' is a valid message (the query)
 *\li		'rmsg' is a valid message (the response)
 *\li		'key' is a valid Diffie Hellman dst key
 *\li		'outkey' is either NULL or a pointer to NULL
 *\li		'ring' is a valid keyring or NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS	the shared key was successfully added
 *\li		#ISC_R_NOTFOUND	an error occurred while looking for a
 *				component of the query or response
 */

isc_result_t
dns_tkey_processgssresponse(dns_message_t *qmsg, dns_message_t *rmsg,
			    dns_name_t *gname, gss_ctx_id_t *context,
			    isc_buffer_t *outtoken, dns_tsigkey_t **outkey,
			    dns_tsig_keyring_t *ring, char **err_message);
/*%<
 * XXX
 */

isc_result_t
dns_tkey_processdeleteresponse(dns_message_t *qmsg, dns_message_t *rmsg,
			       dns_tsig_keyring_t *ring);
/*%<
 *	Processes a response to a query containing a TKEY that was
 *	designed to delete a shared secret.  If the query was successful,
 *	the shared key is deleted from the list of shared keys.
 *
 *	Requires:
 *\li		'qmsg' is a valid message (the query)
 *\li		'rmsg' is a valid message (the response)
 *\li		'ring' is not NULL
 *
 *	Returns:
 *\li		#ISC_R_SUCCESS	the shared key was successfully deleted
 *\li		#ISC_R_NOTFOUND	an error occurred while looking for a
 *				component of the query or response
 */

isc_result_t
dns_tkey_gssnegotiate(dns_message_t *qmsg, dns_message_t *rmsg,
		      dns_name_t *server, gss_ctx_id_t *context,
		      dns_tsigkey_t **outkey, dns_tsig_keyring_t *ring,
		      isc_boolean_t win2k, char **err_message);

/*
 *	Client side negotiation of GSS-TSIG.  Process the response
 *	to a TKEY, and establish a TSIG key if negotiation was successful.
 *	Build a response to the input TKEY message.  Can take multiple
 *	calls to successfully establish the context.
 *
 *	Requires:
 *		'qmsg'    is a valid message, the original TKEY request;
 *			     it will be filled with the new message to send
 *		'rmsg'    is a valid message, the incoming TKEY message
 *		'server'  is the server name
 *		'context' is the input context handle
 *		'outkey'  receives the established key, if non-NULL;
 *			      if non-NULL must point to NULL
 *		'ring'	  is the keyring in which to establish the key,
 *			      or NULL
 *		'win2k'   when true says to turn on some hacks to work
 *			      with the non-standard GSS-TSIG of Windows 2000
 *
 *	Returns:
 *		ISC_R_SUCCESS	context was successfully established
 *		ISC_R_NOTFOUND  couldn't find a needed part of the query
 *					or response
 *		DNS_R_CONTINUE  additional context negotiation is required;
 *					send the new qmsg to the server
 */

ISC_LANG_ENDDECLS

#endif /* DNS_TKEY_H */