Geforce File Manager

NAME	SIZE	ACTIONS
📄 acache.h	14,232 B	[ EDIT ] \| [ DEL ]
📄 acl.h	7,242 B	[ EDIT ] \| [ DEL ]
📄 adb.h	22,595 B	[ EDIT ] \| [ DEL ]
📄 badcache.h	3,369 B	[ EDIT ] \| [ DEL ]
📄 bit.h	807 B	[ EDIT ] \| [ DEL ]
📄 byaddr.h	4,002 B	[ EDIT ] \| [ DEL ]
📄 cache.h	8,643 B	[ EDIT ] \| [ DEL ]
📄 callbacks.h	2,271 B	[ EDIT ] \| [ DEL ]
📄 catz.h	11,833 B	[ EDIT ] \| [ DEL ]
📄 cert.h	1,466 B	[ EDIT ] \| [ DEL ]
📄 client.h	22,042 B	[ EDIT ] \| [ DEL ]
📄 clientinfo.h	2,006 B	[ EDIT ] \| [ DEL ]
📄 compress.h	6,646 B	[ EDIT ] \| [ DEL ]
📄 db.h	47,061 B	[ EDIT ] \| [ DEL ]
📄 dbiterator.h	7,422 B	[ EDIT ] \| [ DEL ]
📄 dbtable.h	3,165 B	[ EDIT ] \| [ DEL ]
📄 diff.h	6,980 B	[ EDIT ] \| [ DEL ]
📄 dispatch.h	16,427 B	[ EDIT ] \| [ DEL ]
📄 dlz.h	10,618 B	[ EDIT ] \| [ DEL ]
📄 dlz_dlopen.h	4,677 B	[ EDIT ] \| [ DEL ]
📄 dns64.h	5,635 B	[ EDIT ] \| [ DEL ]
📄 dnssec.h	12,115 B	[ EDIT ] \| [ DEL ]
📄 dnstap.h	9,364 B	[ EDIT ] \| [ DEL ]
📄 ds.h	1,225 B	[ EDIT ] \| [ DEL ]
📄 dsdigest.h	1,722 B	[ EDIT ] \| [ DEL ]
📄 dyndb.h	4,835 B	[ EDIT ] \| [ DEL ]
📄 ecdb.h	809 B	[ EDIT ] \| [ DEL ]
📄 edns.h	722 B	[ EDIT ] \| [ DEL ]
📄 enumclass.h	1,220 B	[ EDIT ] \| [ DEL ]
📄 enumtype.h	8,300 B	[ EDIT ] \| [ DEL ]
📄 events.h	4,059 B	[ EDIT ] \| [ DEL ]
📄 fixedname.h	1,663 B	[ EDIT ] \| [ DEL ]
📄 forward.h	3,452 B	[ EDIT ] \| [ DEL ]
📄 geoip.h	2,792 B	[ EDIT ] \| [ DEL ]
📄 ipkeylist.h	2,186 B	[ EDIT ] \| [ DEL ]
📄 iptable.h	1,621 B	[ EDIT ] \| [ DEL ]
📄 journal.h	8,227 B	[ EDIT ] \| [ DEL ]
📄 keydata.h	1,059 B	[ EDIT ] \| [ DEL ]
📄 keyflags.h	1,278 B	[ EDIT ] \| [ DEL ]
📄 keytable.h	9,462 B	[ EDIT ] \| [ DEL ]
📄 keyvalues.h	4,159 B	[ EDIT ] \| [ DEL ]
📄 lib.h	1,192 B	[ EDIT ] \| [ DEL ]
📄 log.h	3,964 B	[ EDIT ] \| [ DEL ]
📄 lookup.h	2,924 B	[ EDIT ] \| [ DEL ]
📄 master.h	11,289 B	[ EDIT ] \| [ DEL ]
📄 masterdump.h	12,647 B	[ EDIT ] \| [ DEL ]
📄 message.h	39,023 B	[ EDIT ] \| [ DEL ]
📄 name.h	37,115 B	[ EDIT ] \| [ DEL ]
📄 ncache.h	4,929 B	[ EDIT ] \| [ DEL ]
📄 nsec.h	2,928 B	[ EDIT ] \| [ DEL ]
📄 nsec3.h	8,032 B	[ EDIT ] \| [ DEL ]
📄 nta.h	4,548 B	[ EDIT ] \| [ DEL ]
📄 opcode.h	1,007 B	[ EDIT ] \| [ DEL ]
📄 order.h	1,999 B	[ EDIT ] \| [ DEL ]
📄 peer.h	5,966 B	[ EDIT ] \| [ DEL ]
📄 portlist.h	2,101 B	[ EDIT ] \| [ DEL ]
📄 private.h	1,935 B	[ EDIT ] \| [ DEL ]
📄 rbt.h	40,618 B	[ EDIT ] \| [ DEL ]
📄 rcode.h	2,481 B	[ EDIT ] \| [ DEL ]
📄 rdata.h	21,613 B	[ EDIT ] \| [ DEL ]
📄 rdataclass.h	2,257 B	[ EDIT ] \| [ DEL ]
📄 rdatalist.h	2,569 B	[ EDIT ] \| [ DEL ]
📄 rdataset.h	21,536 B	[ EDIT ] \| [ DEL ]
📄 rdatasetiter.h	3,926 B	[ EDIT ] \| [ DEL ]
📄 rdataslab.h	4,502 B	[ EDIT ] \| [ DEL ]
📄 rdatastruct.h	61,584 B	[ EDIT ] \| [ DEL ]
📄 rdatatype.h	2,298 B	[ EDIT ] \| [ DEL ]
📄 request.h	11,156 B	[ EDIT ] \| [ DEL ]
📄 resolver.h	20,227 B	[ EDIT ] \| [ DEL ]
📄 result.h	9,284 B	[ EDIT ] \| [ DEL ]
📄 rootns.h	892 B	[ EDIT ] \| [ DEL ]
📄 rpz.h	10,335 B	[ EDIT ] \| [ DEL ]
📄 rriterator.h	4,230 B	[ EDIT ] \| [ DEL ]
📄 rrl.h	6,640 B	[ EDIT ] \| [ DEL ]
📄 sdb.h	7,224 B	[ EDIT ] \| [ DEL ]
📄 sdlz.h	14,214 B	[ EDIT ] \| [ DEL ]
📄 secalg.h	1,706 B	[ EDIT ] \| [ DEL ]
📄 secproto.h	1,557 B	[ EDIT ] \| [ DEL ]
📄 soa.h	2,186 B	[ EDIT ] \| [ DEL ]
📄 ssu.h	8,308 B	[ EDIT ] \| [ DEL ]
📄 stats.h	13,451 B	[ EDIT ] \| [ DEL ]
📄 tcpmsg.h	3,145 B	[ EDIT ] \| [ DEL ]
📄 time.h	1,695 B	[ EDIT ] \| [ DEL ]
📄 timer.h	1,051 B	[ EDIT ] \| [ DEL ]
📄 tkey.h	7,631 B	[ EDIT ] \| [ DEL ]
📄 tsec.h	2,949 B	[ EDIT ] \| [ DEL ]
📄 tsig.h	8,384 B	[ EDIT ] \| [ DEL ]
📄 ttl.h	1,945 B	[ EDIT ] \| [ DEL ]
📄 types.h	14,158 B	[ EDIT ] \| [ DEL ]
📄 update.h	1,653 B	[ EDIT ] \| [ DEL ]
📄 validator.h	7,161 B	[ EDIT ] \| [ DEL ]
📄 version.h	868 B	[ EDIT ] \| [ DEL ]
📄 view.h	35,274 B	[ EDIT ] \| [ DEL ]
📄 xfrin.h	2,924 B	[ EDIT ] \| [ DEL ]
📄 zone.h	60,864 B	[ EDIT ] \| [ DEL ]
📄 zonekey.h	777 B	[ EDIT ] \| [ DEL ]
📄 zt.h	5,562 B	[ EDIT ] \| [ DEL ]

[ CLOSE ]

EDIT: 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 */