LOLCATS

: /usr/include/bind9/isc/ [ drwxr-xr-x ]

Information Server

NONE

Command ON Config Searcher Create RDP Find Modified Time Find File Get Tools GSocket Jumping Lock File Mass Deface Mass Delete Mass Chmod Mass Change Date Port Scan Reverse Shell Upload Zone-H

: quota.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 ISC_QUOTA_H
#define ISC_QUOTA_H 1

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

/*! \file isc/quota.h
 *
 * \brief The isc_quota_t object is a simple helper object for implementing
 * quotas on things like the number of simultaneous connections to
 * a server.  It keeps track of the amount of quota in use, and
 * encapsulates the locking necessary to allow multiple tasks to
 * share a quota.
 */

/***
 *** Imports.
 ***/

#include <isc/atomic.h>
#include <isc/lang.h>
#include <isc/magic.h>
#include <isc/mutex.h>
#include <isc/types.h>

/*****
***** Types.
*****/

ISC_LANG_BEGINDECLS

/*% isc_quota_cb - quota callback structure */
typedef struct isc_quota_cb isc_quota_cb_t;
typedef void (*isc_quota_cb_func_t)(isc_quota_t *quota, void *data);
struct isc_quota_cb {
	int		    magic;
	isc_quota_cb_func_t cb_func;
	void		     *data;
	ISC_LINK(isc_quota_cb_t) link;
};

/*% isc_quota structure */
struct isc_quota {
	int		     magic;
	atomic_uint_fast32_t max;
	atomic_uint_fast32_t used;
	atomic_uint_fast32_t soft;
	atomic_uint_fast32_t waiting;
	isc_mutex_t	     cblock;
	ISC_LIST(isc_quota_cb_t) cbs;
};

void
isc_quota_init(isc_quota_t *quota, unsigned int max);
/*%<
 * Initialize a quota object.
 */

void
isc_quota_destroy(isc_quota_t *quota);
/*%<
 * Destroy a quota object.
 */

void
isc_quota_soft(isc_quota_t *quota, unsigned int soft);
/*%<
 * Set a soft quota.
 */

void
isc_quota_max(isc_quota_t *quota, unsigned int max);
/*%<
 * Re-set a maximum quota.
 */

unsigned int
isc_quota_getmax(isc_quota_t *quota);
/*%<
 * Get the maximum quota.
 */

unsigned int
isc_quota_getsoft(isc_quota_t *quota);
/*%<
 * Get the soft quota.
 */

unsigned int
isc_quota_getused(isc_quota_t *quota);
/*%<
 * Get the current usage of quota.
 */

isc_result_t
isc_quota_attach(isc_quota_t *quota, isc_quota_t **p);
/*%<
 *
 * Attempt to reserve one unit of 'quota', and also attaches '*p' to the quota
 * if successful (ISC_R_SUCCESS or ISC_R_SOFTQUOTA).
 *
 * Returns:
 * \li	#ISC_R_SUCCESS		Success
 * \li	#ISC_R_SOFTQUOTA	Success soft quota reached
 * \li	#ISC_R_QUOTA		Quota is full
 */

isc_result_t
isc_quota_attach_cb(isc_quota_t *quota, isc_quota_t **p, isc_quota_cb_t *cb);
/*%<
 *
 * Like isc_quota_attach(), but if there's no quota left then cb->cb_func will
 * be called when we are attached to quota.
 *
 * Note: It's the caller's responsibility to make sure that we don't end up
 * with a huge number of callbacks waiting, making it easy to create a
 * resource exhaustion attack. For example, in the case of TCP listening,
 * we simply don't accept new connections when the quota is exceeded, so
 * the number of callbacks waiting in the queue will be limited by the
 * listen() backlog.
 *
 * Returns:
 * \li	#ISC_R_SUCCESS		Success
 * \li	#ISC_R_SOFTQUOTA	Success soft quota reached
 * \li	#ISC_R_QUOTA		Quota is full
 */

void
isc_quota_cb_init(isc_quota_cb_t *cb, isc_quota_cb_func_t cb_func, void *data);
/*%<
 * Initialize isc_quota_cb_t - setup the list, set the callback and data.
 */

void
isc_quota_detach(isc_quota_t **p);
/*%<
 * Release one unit of quota, and also detaches '*p' from the quota.
 */

ISC_LANG_ENDDECLS

#endif /* ISC_QUOTA_H */

NAME	TYPE	LAST MODIFIED	SIZE	OWNER / GROUP	PERMISSIONS	ACTION
..
aes.h	f!le	2021-11-05 9:03	1015 B	root / root	-rw-r--r--
align.h	f!le	2021-11-05 9:03	569 B	root / root	-rw-r--r--
app.h	f!le	2021-11-05 9:03	6.97 KB	root / root	-rw-r--r--
assertions.h	f!le	2021-11-05 9:03	2.17 KB	root / root	-rw-r--r--
astack.h	f!le	2021-11-05 9:03	1.11 KB	root / root	-rw-r--r--
atomic.h	f!le	2021-11-05 9:03	3.01 KB	root / root	-rw-r--r--
backtrace.h	f!le	2021-11-05 9:03	3.8 KB	root / root	-rw-r--r--
barrier.h	f!le	2021-11-05 9:03	1.03 KB	root / root	-rw-r--r--
base32.h	f!le	2021-11-05 9:03	4.35 KB	root / root	-rw-r--r--
base64.h	f!le	2021-11-05 9:03	2.8 KB	root / root	-rw-r--r--
bind9.h	f!le	2021-11-05 9:03	829 B	root / root	-rw-r--r--
buffer.h	f!le	2021-11-05 9:03	29.91 KB	root / root	-rw-r--r--
bufferlist.h	f!le	2021-11-05 9:03	1.42 KB	root / root	-rw-r--r--
cmocka.h	f!le	2021-11-05 9:03	1.35 KB	root / root	-rw-r--r--
commandline.h	f!le	2021-11-05 9:03	1.67 KB	root / root	-rw-r--r--
condition.h	f!le	2021-11-05 9:03	1.87 KB	root / root	-rw-r--r--
counter.h	f!le	2021-11-05 9:03	1.88 KB	root / root	-rw-r--r--
crc64.h	f!le	2021-11-05 9:03	998 B	root / root	-rw-r--r--
deprecated.h	f!le	2021-11-05 9:03	662 B	root / root	-rw-r--r--
dir.h	f!le	2021-11-05 9:03	1.51 KB	root / root	-rw-r--r--
endian.h	f!le	2021-11-05 9:03	4.75 KB	root / root	-rw-r--r--
errno.h	f!le	2021-11-05 9:03	659 B	root / root	-rw-r--r--
errno2result.h	f!le	2025-11-13 8:16	901 B	root / root	-rw-r--r--
error.h	f!le	2021-11-05 9:03	1.4 KB	root / root	-rw-r--r--
event.h	f!le	2021-11-05 9:03	3.36 KB	root / root	-rw-r--r--
eventclass.h	f!le	2021-11-05 9:03	1.41 KB	root / root	-rw-r--r--
file.h	f!le	2021-11-05 9:03	11.4 KB	root / root	-rw-r--r--
formatcheck.h	f!le	2021-11-05 9:03	940 B	root / root	-rw-r--r--
fsaccess.h	f!le	2021-11-05 9:03	7.28 KB	root / root	-rw-r--r--
fuzz.h	f!le	2021-11-05 9:03	593 B	root / root	-rw-r--r--
hash.h	f!le	2021-11-05 9:03	1.61 KB	root / root	-rw-r--r--
heap.h	f!le	2021-11-05 9:03	5.14 KB	root / root	-rw-r--r--
hex.h	f!le	2021-11-05 9:03	2.74 KB	root / root	-rw-r--r--
hmac.h	f!le	2021-11-05 9:03	3.88 KB	root / root	-rw-r--r--
hp.h	f!le	2021-11-05 9:03	4.48 KB	root / root	-rw-r--r--
ht.h	f!le	2025-11-13 8:14	4.38 KB	root / root	-rw-r--r--
httpd.h	f!le	2021-11-05 9:03	2.24 KB	root / root	-rw-r--r--
interfaceiter.h	f!le	2021-11-05 9:03	3.07 KB	root / root	-rw-r--r--
iterated_hash.h	f!le	2021-11-05 9:03	933 B	root / root	-rw-r--r--
lang.h	f!le	2021-11-05 9:03	686 B	root / root	-rw-r--r--
lex.h	f!le	2021-11-05 9:03	9.77 KB	root / root	-rw-r--r--
lfsr.h	f!le	2021-11-05 9:03	2.89 KB	root / root	-rw-r--r--
lib.h	f!le	2021-11-05 9:03	1.13 KB	root / root	-rw-r--r--
likely.h	f!le	2021-11-05 9:03	868 B	root / root	-rw-r--r--
list.h	f!le	2021-11-05 9:03	7.9 KB	root / root	-rw-r--r--
log.h	f!le	2021-11-05 9:03	25.88 KB	root / root	-rw-r--r--
magic.h	f!le	2021-11-05 9:03	999 B	root / root	-rw-r--r--
managers.h	f!le	2021-11-05 9:03	776 B	root / root	-rw-r--r--
md.h	f!le	2021-11-05 9:03	5.63 KB	root / root	-rw-r--r--
mem.h	f!le	2021-11-05 9:03	17.66 KB	root / root	-rw-r--r--
meminfo.h	f!le	2021-11-05 9:03	710 B	root / root	-rw-r--r--
mutex.h	f!le	2021-11-05 9:03	4.08 KB	root / root	-rw-r--r--
mutexatomic.h	f!le	2021-11-05 9:03	9.56 KB	root / root	-rw-r--r--
mutexblock.h	f!le	2021-11-05 9:03	1.13 KB	root / root	-rw-r--r--
net.h	f!le	2021-11-05 9:03	8.36 KB	root / root	-rw-r--r--
netaddr.h	f!le	2021-11-05 9:03	4.67 KB	root / root	-rw-r--r--
netdb.h	f!le	2021-11-05 9:03	860 B	root / root	-rw-r--r--
netmgr.h	f!le	2025-11-13 8:14	15.36 KB	root / root	-rw-r--r--
netscope.h	f!le	2021-11-05 9:03	966 B	root / root	-rw-r--r--
nonce.h	f!le	2021-11-05 9:03	743 B	root / root	-rw-r--r--
offset.h	f!le	2021-11-05 9:03	687 B	root / root	-rw-r--r--
once.h	f!le	2021-11-05 9:03	767 B	root / root	-rw-r--r--
os.h	f!le	2025-11-13 8:14	765 B	root / root	-rw-r--r--
parseint.h	f!le	2021-11-05 9:03	1.5 KB	root / root	-rw-r--r--
platform.h	f!le	2025-11-13 8:14	1.82 KB	root / root	-rw-r--r--
pool.h	f!le	2021-11-05 9:03	3.41 KB	root / root	-rw-r--r--
portset.h	f!le	2021-11-05 9:03	3.22 KB	root / root	-rw-r--r--
print.h	f!le	2021-11-05 9:03	680 B	root / root	-rw-r--r--
queue.h	f!le	2021-11-05 9:03	1.31 KB	root / root	-rw-r--r--
quota.h	f!le	2021-11-05 9:03	3.48 KB	root / root	-rw-r--r--
radix.h	f!le	2021-11-05 9:03	6.85 KB	root / root	-rw-r--r--
random.h	f!le	2025-11-13 8:14	1.45 KB	root / root	-rw-r--r--
ratelimiter.h	f!le	2021-11-05 9:03	3.41 KB	root / root	-rw-r--r--
refcount.h	f!le	2021-11-05 9:03	4.98 KB	root / root	-rw-r--r--
regex.h	f!le	2021-11-05 9:03	767 B	root / root	-rw-r--r--
region.h	f!le	2021-11-05 9:03	2.18 KB	root / root	-rw-r--r--
resource.h	f!le	2021-11-05 9:03	2.79 KB	root / root	-rw-r--r--
result.h	f!le	2021-11-05 9:03	5.45 KB	root / root	-rw-r--r--
resultclass.h	f!le	2021-11-05 9:03	1.56 KB	root / root	-rw-r--r--
rwlock.h	f!le	2021-11-05 9:03	2.48 KB	root / root	-rw-r--r--
safe.h	f!le	2021-11-05 9:03	1.12 KB	root / root	-rw-r--r--
serial.h	f!le	2021-11-05 9:03	1.33 KB	root / root	-rw-r--r--
siphash.h	f!le	2021-11-05 9:03	916 B	root / root	-rw-r--r--
sockaddr.h	f!le	2021-11-05 9:03	6.13 KB	root / root	-rw-r--r--
socket.h	f!le	2021-11-05 9:03	23.55 KB	root / root	-rw-r--r--
stat.h	f!le	2021-11-05 9:03	803 B	root / root	-rw-r--r--
stats.h	f!le	2021-11-05 9:03	6.53 KB	root / root	-rw-r--r--
stdatomic.h	f!le	2021-11-05 9:03	8.9 KB	root / root	-rw-r--r--
stdio.h	f!le	2021-11-05 9:03	1.69 KB	root / root	-rw-r--r--
stdtime.h	f!le	2021-11-05 9:03	1.36 KB	root / root	-rw-r--r--
strerr.h	f!le	2021-11-05 9:03	575 B	root / root	-rw-r--r--
string.h	f!le	2021-11-05 9:03	851 B	root / root	-rw-r--r--
symtab.h	f!le	2021-11-05 9:03	4.22 KB	root / root	-rw-r--r--
syslog.h	f!le	2021-11-05 9:03	843 B	root / root	-rw-r--r--
task.h	f!le	2021-11-05 9:03	16.72 KB	root / root	-rw-r--r--
taskpool.h	f!le	2021-11-05 9:03	3.2 KB	root / root	-rw-r--r--
thread.h	f!le	2021-11-05 9:03	1.86 KB	root / root	-rw-r--r--
time.h	f!le	2021-11-05 9:03	10.85 KB	root / root	-rw-r--r--
timer.h	f!le	2021-11-05 9:03	7.77 KB	root / root	-rw-r--r--
tm.h	f!le	2021-11-05 9:03	894 B	root / root	-rw-r--r--
types.h	f!le	2021-11-05 9:03	5.72 KB	root / root	-rw-r--r--
url.h	f!le	2021-11-05 9:03	2.62 KB	root / root	-rw-r--r--
utf8.h	f!le	2021-11-05 9:03	928 B	root / root	-rw-r--r--
util.h	f!le	2021-11-05 9:03	13.96 KB	root / root	-rw-r--r--
version.h	f!le	2021-11-05 9:03	499 B	root / root	-rw-r--r--

ÿØÿî