byp4a55 professor6T9

Linux vps-223903.laweb30.com.mx 3.10.0-1160.95.1.el7.x86_64 #1 SMP Mon Jul 24 13:59:37 UTC 2023 x86_64
Apache
162.214.112.52

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

#ifndef DNS_REQUEST_H
#define DNS_REQUEST_H 1

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

/*! \file dns/request.h
 *
 * \brief
 * The request module provides simple request/response services useful for
 * sending SOA queries, DNS Notify messages, and dynamic update requests.
 *
 * MP:
 *\li	The module ensures appropriate synchronization of data structures it
 *	creates and manipulates.
 *
 * Resources:
 *\li	TBS
 *
 * Security:
 *\li	No anticipated impact.
 */

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

#include <dns/types.h>

#define DNS_REQUESTOPT_TCP 0x00000001U
#define DNS_REQUESTOPT_CASE 0x00000002U
#define DNS_REQUESTOPT_FIXEDID 0x00000004U
#define DNS_REQUESTOPT_SHARE 0x00000008U

typedef struct dns_requestevent {
	ISC_EVENT_COMMON(struct dns_requestevent);
	isc_result_t result;
	dns_request_t *request;
} dns_requestevent_t;

ISC_LANG_BEGINDECLS

isc_result_t
dns_requestmgr_create(isc_mem_t *mctx, isc_timermgr_t *timermgr,
		      isc_socketmgr_t *socketmgr, isc_taskmgr_t *taskmgr,
		      dns_dispatchmgr_t *dispatchmgr,
		      dns_dispatch_t *dispatchv4, dns_dispatch_t *dispatchv6,
		      dns_requestmgr_t **requestmgrp);
/*%<
 * Create a request manager.
 *
 * Requires:
 *
 *\li	'mctx' is a valid memory context.
 *
 *\li	'timermgr' is a valid timer manager.
 *
 *\li	'socketmgr' is a valid socket manager.
 *
 *\li	'taskmgr' is a valid task manager.
 *
 *\li	'dispatchv4' is a valid dispatcher with an IPv4 UDP socket, or is NULL.
 *
 *\li	'dispatchv6' is a valid dispatcher with an IPv6 UDP socket, or is NULL.
 *
 *\li	requestmgrp != NULL && *requestmgrp == NULL
 *
 * Ensures:
 *
 *\li	On success, *requestmgrp is a valid request manager.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any other result indicates failure.
 */

void
dns_requestmgr_whenshutdown(dns_requestmgr_t *requestmgr, isc_task_t *task,
			    isc_event_t **eventp);
/*%<
 * Send '*eventp' to 'task' when 'requestmgr' has completed shutdown.
 *
 * Notes:
 *
 *\li	It is not safe to detach the last reference to 'requestmgr' until
 *	shutdown is complete.
 *
 * Requires:
 *
 *\li	'requestmgr' is a valid request manager.
 *
 *\li	'task' is a valid task.
 *
 *\li	*eventp is a valid event.
 *
 * Ensures:
 *
 *\li	*eventp == NULL.
 */

void
dns_requestmgr_shutdown(dns_requestmgr_t *requestmgr);
/*%<
 * Start the shutdown process for 'requestmgr'.
 *
 * Notes:
 *
 *\li	This call has no effect if the request manager is already shutting
 *	down.
 *
 * Requires:
 *
 *\li	'requestmgr' is a valid requestmgr.
 */

void
dns_requestmgr_attach(dns_requestmgr_t *source, dns_requestmgr_t **targetp);
/*%<
 *	Attach to the request manager.  dns_requestmgr_shutdown() must not
 *	have been called on 'source' prior to calling dns_requestmgr_attach().
 *
 * Requires:
 *
 *\li	'source' is a valid requestmgr.
 *
 *\li	'targetp' to be non NULL and '*targetp' to be NULL.
 */

void
dns_requestmgr_detach(dns_requestmgr_t **requestmgrp);
/*%<
 *	Detach from the given requestmgr.  If this is the final detach
 *	requestmgr will be destroyed.  dns_requestmgr_shutdown() must
 *	be called before the final detach.
 *
 * Requires:
 *
 *\li	'*requestmgrp' is a valid requestmgr.
 *
 * Ensures:
 *\li	'*requestmgrp' is NULL.
 */

isc_result_t
dns_request_create(dns_requestmgr_t *requestmgr, dns_message_t *message,
		   isc_sockaddr_t *address, unsigned int options,
		   dns_tsigkey_t *key,
		   unsigned int timeout, isc_task_t *task,
		   isc_taskaction_t action, void *arg,
		   dns_request_t **requestp);
/*%<
 * Create and send a request.
 *
 * Notes:
 *
 *\li	'message' will be rendered and sent to 'address'.  If the
 *	#DNS_REQUESTOPT_TCP option is set, TCP will be used,
 *	#DNS_REQUESTOPT_SHARE option is set too, connecting TCP
 *	(vs. connected) will be shared too.  The request
 *	will timeout after 'timeout' seconds.
 *
 *\li	If the #DNS_REQUESTOPT_CASE option is set, use case sensitive
 *	compression.
 *
 *\li	When the request completes, successfully, due to a timeout, or
 *	because it was canceled, a completion event will be sent to 'task'.
 *
 * Requires:
 *
 *\li	'message' is a valid DNS message.
 *
 *\li	'address' is a valid sockaddr.
 *
 *\li	'timeout' > 0
 *
 *\li	'task' is a valid task.
 *
 *\li	requestp != NULL && *requestp == NULL
 */

/*% See dns_request_createvia4() */
isc_result_t
dns_request_createvia(dns_requestmgr_t *requestmgr, dns_message_t *message,
		      isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		      unsigned int options, dns_tsigkey_t *key,
		      unsigned int timeout, isc_task_t *task,
		      isc_taskaction_t action, void *arg,
		      dns_request_t **requestp);

/*% See dns_request_createvia4() */
isc_result_t
dns_request_createvia2(dns_requestmgr_t *requestmgr, dns_message_t *message,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       unsigned int options, dns_tsigkey_t *key,
		       unsigned int timeout, unsigned int udptimeout,
		       isc_task_t *task, isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);

/*% See dns_request_createvia4() */
isc_result_t
dns_request_createvia3(dns_requestmgr_t *requestmgr, dns_message_t *message,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       unsigned int options, dns_tsigkey_t *key,
		       unsigned int timeout, unsigned int udptimeout,
		       unsigned int udpretries, isc_task_t *task,
		       isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);

isc_result_t
dns_request_createvia4(dns_requestmgr_t *requestmgr, dns_message_t *message,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       isc_dscp_t dscp, unsigned int options,
		       dns_tsigkey_t *key, unsigned int timeout,
		       unsigned int udptimeout, unsigned int udpretries,
		       isc_task_t *task, isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);
/*%<
 * Create and send a request.
 *
 * Notes:
 *
 *\li	'message' will be rendered and sent to 'address'.  If the
 *	#DNS_REQUESTOPT_TCP option is set, TCP will be used,
 *	#DNS_REQUESTOPT_SHARE option is set too, connecting TCP
 *	(vs. connected) will be shared too.  The request
 *	will timeout after 'timeout' seconds.  UDP requests will be resent
 *	at 'udptimeout' intervals if non-zero or 'udpretries' is non-zero.
 *
 *\li	If the #DNS_REQUESTOPT_CASE option is set, use case sensitive
 *	compression.
 *
 *\li	When the request completes, successfully, due to a timeout, or
 *	because it was canceled, a completion event will be sent to 'task'.
 *
 * Requires:
 *
 *\li	'message' is a valid DNS message.
 *
 *\li	'dstaddr' is a valid sockaddr.
 *
 *\li	'srcaddr' is a valid sockaddr or NULL.
 *
 *\li	'srcaddr' and 'dstaddr' are the same protocol family.
 *
 *\li	'timeout' > 0
 *
 *\li	'task' is a valid task.
 *
 *\li	requestp != NULL && *requestp == NULL
 */

/*% See dns_request_createraw4() */
isc_result_t
dns_request_createraw(dns_requestmgr_t *requestmgr, isc_buffer_t *msgbuf,
		      isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		      unsigned int options, unsigned int timeout,
		      isc_task_t *task, isc_taskaction_t action, void *arg,
		      dns_request_t **requestp);

/*% See dns_request_createraw4() */
isc_result_t
dns_request_createraw2(dns_requestmgr_t *requestmgr, isc_buffer_t *msgbuf,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       unsigned int options, unsigned int timeout,
		       unsigned int udptimeout, isc_task_t *task,
		       isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);

/*% See dns_request_createraw4() */
isc_result_t
dns_request_createraw3(dns_requestmgr_t *requestmgr, isc_buffer_t *msgbuf,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       unsigned int options, unsigned int timeout,
		       unsigned int udptimeout, unsigned int udpretries,
		       isc_task_t *task, isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);

isc_result_t
dns_request_createraw4(dns_requestmgr_t *requestmgr, isc_buffer_t *msgbuf,
		       isc_sockaddr_t *srcaddr, isc_sockaddr_t *destaddr,
		       isc_dscp_t dscp, unsigned int options,
		       unsigned int timeout, unsigned int udptimeout,
		       unsigned int udpretries, isc_task_t *task,
		       isc_taskaction_t action, void *arg,
		       dns_request_t **requestp);
/*!<
 * \brief Create and send a request.
 *
 * Notes:
 *
 *\li	'msgbuf' will be sent to 'destaddr' after setting the id.  If the
 *	#DNS_REQUESTOPT_TCP option is set, TCP will be used,
 *	#DNS_REQUESTOPT_SHARE option is set too, connecting TCP
 *	(vs. connected) will be shared too.  The request
 *	will timeout after 'timeout' seconds.   UDP requests will be resent
 *	at 'udptimeout' intervals if non-zero or if 'udpretries' is not zero.
 *
 *\li	When the request completes, successfully, due to a timeout, or
 *	because it was canceled, a completion event will be sent to 'task'.
 *
 * Requires:
 *
 *\li	'msgbuf' is a valid DNS message in compressed wire format.
 *
 *\li	'destaddr' is a valid sockaddr.
 *
 *\li	'srcaddr' is a valid sockaddr or NULL.
 *
 *\li	'srcaddr' and 'dstaddr' are the same protocol family.
 *
 *\li	'timeout' > 0
 *
 *\li	'task' is a valid task.
 *
 *\li	requestp != NULL && *requestp == NULL
 */

void
dns_request_cancel(dns_request_t *request);
/*%<
 * Cancel 'request'.
 *
 * Requires:
 *
 *\li	'request' is a valid request.
 *
 * Ensures:
 *
 *\li	If the completion event for 'request' has not yet been sent, it
 *	will be sent, and the result code will be ISC_R_CANCELED.
 */

isc_result_t
dns_request_getresponse(dns_request_t *request, dns_message_t *message,
			unsigned int options);
/*%<
 * Get the response to 'request' by filling in 'message'.
 *
 * 'options' is passed to dns_message_parse().  See dns_message_parse()
 * for more details.
 *
 * Requires:
 *
 *\li	'request' is a valid request for which the caller has received the
 *	completion event.
 *
 *\li	The result code of the completion event was #ISC_R_SUCCESS.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	Any result that dns_message_parse() can return.
 */

isc_boolean_t
dns_request_usedtcp(dns_request_t *request);
/*%<
 * Return whether this query used TCP or not.  Setting #DNS_REQUESTOPT_TCP
 * in the call to dns_request_create() will cause the function to return
 * #ISC_TRUE, otherwise the result is based on the query message size.
 *
 * Requires:
 *\li	'request' is a valid request.
 *
 * Returns:
 *\li	ISC_TRUE	if TCP was used.
 *\li	ISC_FALSE	if UDP was used.
 */

void
dns_request_destroy(dns_request_t **requestp);
/*%<
 * Destroy 'request'.
 *
 * Requires:
 *
 *\li	'request' is a valid request for which the caller has received the
 *	completion event.
 *
 * Ensures:
 *
 *\li	*requestp == NULL
 */

ISC_LANG_ENDDECLS

#endif /* DNS_REQUEST_H */

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

Team Anon Force

https://t.me/Professor6T9x