#acupoftea - accounting.gulfstore-gcc.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ usr / include / bind9 / dns /

216.73.216.141

Home

File byaddr.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_BYADDR_H
#define DNS_BYADDR_H 1

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

/*! \file dns/byaddr.h
 * \brief
 * The byaddr module provides reverse lookup services for IPv4 and IPv6
 * addresses.
 *
 * MP:
 *\li	The module ensures appropriate synchronization of data structures it
 *	creates and manipulates.
 *
 * Reliability:
 *\li	No anticipated impact.
 *
 * Resources:
 *\li	TBS
 *
 * Security:
 *\li	No anticipated impact.
 *
 * Standards:
 *\li	RFCs:	1034, 1035, 2181, TBS
 *\li	Drafts:	TBS
 */

#include <stdbool.h>

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

#include <dns/types.h>

ISC_LANG_BEGINDECLS

/*%
 * A 'dns_byaddrevent_t' is returned when a byaddr completes.
 * The sender field will be set to the byaddr that completed.  If 'result'
 * is ISC_R_SUCCESS, then 'names' will contain a list of names associated
 * with the address.  The recipient of the event must not change the list
 * and must not refer to any of the name data after the event is freed.
 */
typedef struct dns_byaddrevent {
	ISC_EVENT_COMMON(struct dns_byaddrevent);
	isc_result_t			result;
	dns_namelist_t			names;
} dns_byaddrevent_t;

/*
 * This option is deprecated since we now only consider nibbles.
#define DNS_BYADDROPT_IPV6NIBBLE	0x0001
 */
/*% Note DNS_BYADDROPT_IPV6NIBBLE is now deprecated. */
#define DNS_BYADDROPT_IPV6INT		0x0002

isc_result_t
dns_byaddr_create(isc_mem_t *mctx, isc_netaddr_t *address, dns_view_t *view,
		  unsigned int options, isc_task_t *task,
		  isc_taskaction_t action, void *arg, dns_byaddr_t **byaddrp);
/*%<
 * Find the domain name of 'address'.
 *
 * Notes:
 *
 *\li	There is a reverse lookup format for IPv6 addresses, 'nibble'
 *
 *\li	The 'nibble' format for that address is
 *
 * \code
 *   1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.e.f.ip6.arpa.
 * \endcode
 *
 *\li	#DNS_BYADDROPT_IPV6INT can be used to get nibble lookups under ip6.int.
 *
 * Requires:
 *
 *\li	'mctx' is a valid mctx.
 *
 *\li	'address' is a valid IPv4 or IPv6 address.
 *
 *\li	'view' is a valid view which has a resolver.
 *
 *\li	'task' is a valid task.
 *
 *\li	byaddrp != NULL && *byaddrp == NULL
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_NOMEMORY
 *
 *\li	Any resolver-related error (e.g. #ISC_R_SHUTTINGDOWN) may also be
 *	returned.
 */

void
dns_byaddr_cancel(dns_byaddr_t *byaddr);
/*%<
 * Cancel 'byaddr'.
 *
 * Notes:
 *
 *\li	If 'byaddr' has not completed, post its #DNS_EVENT_BYADDRDONE
 *	event with a result code of #ISC_R_CANCELED.
 *
 * Requires:
 *
 *\li	'byaddr' is a valid byaddr.
 */

void
dns_byaddr_destroy(dns_byaddr_t **byaddrp);
/*%<
 * Destroy 'byaddr'.
 *
 * Requires:
 *
 *\li	'*byaddrp' is a valid byaddr.
 *
 *\li	The caller has received the #DNS_EVENT_BYADDRDONE event (either because
 *	the byaddr completed or because dns_byaddr_cancel() was called).
 *
 * Ensures:
 *
 *\li	*byaddrp == NULL.
 */

isc_result_t
dns_byaddr_createptrname(isc_netaddr_t *address, bool nibble,
			 dns_name_t *name);

isc_result_t
dns_byaddr_createptrname2(isc_netaddr_t *address, unsigned int options,
			  dns_name_t *name);
/*%<
 * Creates a name that would be used in a PTR query for this address.  The
 * nibble flag indicates that the 'nibble' format is to be used if an IPv6
 * address is provided, instead of the 'bitstring' format.  Since we dropped
 * the support of the bitstring labels, it is expected that the flag is always
 * set.  'options' are the same as for dns_byaddr_create().
 *
 * Requires:
 *
 * \li	'address' is a valid address.
 * \li	'name' is a valid name with a dedicated buffer.
 */

ISC_LANG_ENDDECLS

#endif /* DNS_BYADDR_H */

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

~ ACUPOFTEA - accounting.gulfstore-gcc.com