aDriv4 website!

Linux ircpanel.novinhost.org 4.18.0-553.34.1.lve.el8.x86_64 #1 SMP Thu Jan 9 16:30:32 UTC 2025 x86_64
Apache
213.232.124.78

dnstap.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 _DNSTAP_H
#define _DNSTAP_H

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

/*! \file
 * \brief
 * The dt (dnstap) module provides fast passive logging of DNS messages.
 * Protocol Buffers.  The protobuf schema for Dnstap messages is in the
 * file dnstap.proto, which is compiled to dnstap.pb-c.c and dnstap.pb-c.h.
 */

#include <inttypes.h>
#include <stdbool.h>

#ifdef HAVE_DNSTAP
#include <fstrm.h>
#include <protobuf-c/protobuf-c.h>
#else
struct fstrm_iothr_options;
#endif /* HAVE_DNSTAP */

#include <isc/region.h>
#include <isc/sockaddr.h>
#include <isc/time.h>
#include <isc/types.h>

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

/*%
 * Dnstap message types:
 *
 * STUB QUERY: SQ
 * STUB RESPONSE: SR
 * CLIENT QUERY: CQ
 * CLIENT RESPONSE: CR
 * AUTH QUERY: AQ
 * AUTH RESPONSE: AR
 * RESOLVER QUERY: RQ
 * RESOLVER RESPONSE: RR
 * FORWARDER QUERY: FQ
 * FORWARDER RESPONSE: FR
 */

#define DNS_DTTYPE_SQ 0x0001
#define DNS_DTTYPE_SR 0x0002
#define DNS_DTTYPE_CQ 0x0004
#define DNS_DTTYPE_CR 0x0008
#define DNS_DTTYPE_AQ 0x0010
#define DNS_DTTYPE_AR 0x0020
#define DNS_DTTYPE_RQ 0x0040
#define DNS_DTTYPE_RR 0x0080
#define DNS_DTTYPE_FQ 0x0100
#define DNS_DTTYPE_FR 0x0200
#define DNS_DTTYPE_TQ 0x0400
#define DNS_DTTYPE_TR 0x0800

typedef enum {
	dns_dtmode_none = 0,
	dns_dtmode_file,
	dns_dtmode_unix
} dns_dtmode_t;

typedef struct dns_dthandle dns_dthandle_t;

#ifdef HAVE_DNSTAP
struct dns_dtdata {
	isc_mem_t *mctx;

void *frame;

bool query;
	bool tcp;
	dns_dtmsgtype_t type;

isc_time_t qtime;
	isc_time_t rtime;

isc_region_t qaddr;
	isc_region_t raddr;

uint32_t qport;
	uint32_t rport;

isc_region_t msgdata;
	dns_message_t *msg;

char namebuf[DNS_NAME_FORMATSIZE];
	char typebuf[DNS_RDATATYPE_FORMATSIZE];
	char classbuf[DNS_RDATACLASS_FORMATSIZE];
};
#endif /* HAVE_DNSTAP */

isc_result_t
dns_dt_create(isc_mem_t *mctx, dns_dtmode_t mode, const char *path,
	      struct fstrm_iothr_options **foptp, dns_dtenv_t **envp);
/*%<
 * Create and initialize the dnstap environment.
 *
 * There should be a single global dnstap environment for the server;
 * copies of it will be attached to each view.
 *
 * Notes:
 *
 *\li	'path' refers to a UNIX domain socket by default. It may
 *	optionally be prepended with "socket:" or "file:". If prepended
 *	with "file:", then dnstap logs are sent to a file instead of a
 *	socket.
 *
 *\li	'*foptp' set the options for fstrm_iothr_init(). '*foptp' must have
 *	have had the number of input queues set and this should be set
 *	to the number of worker threads.  Additionally the queue model
 *	should also be set.  Other options may be set if desired.
 *	If dns_dt_create succeeds the *foptp is set to NULL.
 *
 * Requires:
 *
 *\li	'mctx' is a valid memory context.
 *
 *\li	'path' is a valid C string.
 *
 *\li	'fopt' is non NULL.
 *
 *\li	envp != NULL && *envp == NULL
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_NOMEMORY
 *
 *\li	Other errors are possible.
 */

isc_result_t
dns_dt_reopen(dns_dtenv_t *env, int roll);
/*%<
 * Reopens files established by dns_dt_create().
 *
 * If 'roll' is non-negative and 'env->mode' is dns_dtmode_file,
 * then the file is automatically rolled over before reopening.
 * The value of 'roll' indicates the number of backup log files to
 * keep.  If 'roll' is negative, or if 'env->mode' is dns_dtmode_unix,
 * then the channel is simply reopened.
 *
 * Note: dns_dt_reopen() must be called in task exclusive mode.
 *
 * Requires:
 *\li	'env' is a valid dnstap environment.
 */

isc_result_t
dns_dt_setidentity(dns_dtenv_t *env, const char *identity);
isc_result_t
dns_dt_setversion(dns_dtenv_t *env, const char *version);
/*%<
 * Set the "identity" and "version" strings to be sent in dnstap messages.
 *
 * Requires:
 *
 *\li	'env' is a valid dnstap environment.
 */

void
dns_dt_attach(dns_dtenv_t *source, dns_dtenv_t **destp);
/*%<
 * Attach '*destp' to 'source', incrementing the reference counter.
 *
 * Requires:
 *
 *\li	'source' is a valid dnstap environment.
 *
 *\li	'destp' is not NULL and '*destp' is NULL.
 *
 *\li	*destp is attached to source.
 */

void
dns_dt_detach(dns_dtenv_t **envp);
/*%<
 * Detach '*envp', decrementing the reference counter.
 *
 * Requires:
 *
 *\li	'*envp' is a valid dnstap environment.
 *
 * Ensures:
 *
 *\li	'*envp' will be destroyed when the number of references reaches zero.
 *
 *\li	'*envp' is NULL.
 */

isc_result_t
dns_dt_getstats(dns_dtenv_t *env, isc_stats_t **statsp);
/*%<
 * Attach to the stats struct if it exists.
 *
 * Requires:
 *
 *\li	'env' is a valid dnstap environment.
 *
 *\li	'statsp' is non NULL and '*statsp' is NULL.
 *
 * Returns:
 *
 *\li	ISC_R_SUCCESS
 *
 *\li	ISC_R_NOTFOUND
 */

void
dns_dt_shutdown(void);
/*%<
 * Shuts down dnstap and frees global resources. This function must only
 * be called immediately before server shutdown.
 */

void
dns_dt_send(dns_view_t *view, dns_dtmsgtype_t msgtype,
	    isc_sockaddr_t *qaddr, isc_sockaddr_t *dstaddr,
	    bool tcp, isc_region_t *zone, isc_time_t *qtime,
	    isc_time_t *rtime, isc_buffer_t *buf);
/*%<
 * Sends a dnstap message to the log, if 'msgtype' is one of the message
 * types represented in 'view->dttypes'.
 *
 * Parameters are: 'qaddr' (query address, i.e, the address of the
 * query initiator); 'raddr' (response address, i.e., the address of
 * the query responder); 'tcp' (boolean indicating whether the transaction
 * was over TCP); 'zone' (the authoritative zone or bailiwick, in
 * uncompressed wire format), 'qtime' and 'rtime' (query and response
 * times; if NULL, they are set to the current time); and 'buf' (the
 * DNS message being logged, in wire format).
 *
 * Requires:
 *
 *\li	'view' is a valid view, and 'view->dtenv' is NULL or is a
 *	valid dnstap environment.
 */

isc_result_t
dns_dt_parse(isc_mem_t *mctx, isc_region_t *src, dns_dtdata_t **destp);
/*%<
 * Converts a raw dnstap frame in 'src' to a parsed dnstap data structure
 * in '*destp'.
 *
 * Requires:
 *\li	'src' is not NULL
 *
 *\li	'destp' is not NULL and '*destp' points to a valid buffer.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS on success
 *
 *\li	Other errors are possible.
 */

isc_result_t
dns_dt_datatotext(dns_dtdata_t *d, isc_buffer_t **dest);
/*%<
 * Converts a parsed dnstap data structure 'd' to text, storing
 * the result in the buffer 'dest'.  If 'dest' points to a dynamically
 * allocated buffer, then it may be reallocated as needed.
 *
 * (XXX: add a 'long_form' option to generate a detailed listing of
 * dnstap data instead * of a one-line summary.)
 *
 * Requires:
 *\li	'd' is not NULL
 *
 *\li	'dest' is not NULL and '*dest' points to a valid buffer.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS on success
 *\li	#ISC_R_NOSPACE if buffer is not dynamic and runs out of space
 *\li	#ISC_R_NOMEMORY if buffer is dynamic but memory could not be allocated
 *
 *\li	Other errors are possible.
 */

void
dns_dtdata_free(dns_dtdata_t **dp);
/*%<
 * Frees the specified dns_dtdata structure and all its members,
 * and sets *dp to NULL.
 */

isc_result_t
dns_dt_open(const char *filename, dns_dtmode_t mode,
	    isc_mem_t *mctx, dns_dthandle_t **handlep);
/*%<
 * Opens a dnstap framestream at 'filename' and stores a pointer to the
 * reader object in a dns_dthandle_t structure.
 *
 * The caller is responsible for allocating the handle structure.
 *
 * (XXX: Currently only file readers are supported, not unix-domain socket
 * readers.)
 *
 * Requires:
 *
 *\li	'filename' is not NULL.
 *
 *\li	'handlep' is not NULL and '*handlep' is NULL.
 *
 *\li	'*mctx' is not a valid memory context.
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS on success
 *\li	#ISC_R_NOTIMPLEMENTED if 'mode' is not dns_dtmode_file. (XXX)
 *\li	#ISC_R_NOMEMORY if the fstrm library was unable to allocate a
 *      reader or options structure
 *\li	#ISC_R_FAILURE if 'filename' could not be opened.
 *\li	#DNS_R_BADDNSTAP if 'filename' does not contain a dnstap
 *      framestream.
 */

isc_result_t
dns_dt_getframe(dns_dthandle_t *handle, uint8_t **bufp, size_t *sizep);
/*%<
 * Read a dnstap frame from the framstream reader in 'handle', storing
 * a pointer to it in '*bufp' and its size in '*sizep'.
 *
 * Requires:
 *
 *\li	'handle' is not NULL
 *\li	'bufp' is not NULL
 *\li	'sizep' is not NULL
 *
 * Ensures:
 * \li	if returning ISC_R_SUCCESS then '*bufp' is not NULL
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS on success
 *\li	#ISC_R_NOMORE at the end of the frame stream
 *\li	#ISC_R_FAILURE for any other failure
 */

void
dns_dt_close(dns_dthandle_t **handlep);
/*%<
 * Closes the dnstap file referenced by 'handle'.
 *
 * Requires:
 *
 *\li	'*handlep' is not NULL
 */

#endif /* _DNSTAP_H */

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

For more Private tool come to me!

https://t.me/aDriv4vz