#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 / isc /

216.73.216.5

Home

File random.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_RANDOM_H
#define ISC_RANDOM_H 1

#include <isc/lang.h>
#include <isc/types.h>
#include <isc/entropy.h>
#include <isc/mem.h>
#include <isc/mutex.h>

/*! \file isc/random.h
 * \brief Implements pseudo random number generators.
 *
 * Two pseudo-random number generators are implemented, in isc_random_*
 * and isc_rng_*. Neither one is very strong; they should not be used
 * in cryptography functions.
 *
 * isc_random_* is based on arc4random if it is available on the system.
 * Otherwise it is based on the posix srand() and rand() functions.
 * It is useful for jittering values a bit here and there, such as
 * timeouts, etc, but should not be relied upon to generate
 * unpredictable sequences (for example, when choosing transaction IDs).
  *
 * isc_rng_* is based on ChaCha20, and is seeded and stirred from the
 * system entropy source. It is stronger than isc_random_* and can
 * be used for generating unpredictable sequences. It is still not as
 * good as using system entropy directly (see entropy.h) and should not
 * be used for cryptographic functions such as key generation.
 */

ISC_LANG_BEGINDECLS

typedef struct isc_rng isc_rng_t;
/*%<
 * Opaque type
 */

void
isc_random_seed(uint32_t seed);
/*%<
 * Set the initial seed of the random state.
 */

void
isc_random_get(uint32_t *val);
/*%<
 * Get a random value.
 *
 * Requires:
 *	val != NULL.
 */

uint32_t
isc_random_jitter(uint32_t max, uint32_t jitter);
/*%<
 * Get a random value between (max - jitter) and (max).
 * This is useful for jittering timer values.
 */

isc_result_t
isc_rng_create(isc_mem_t *mctx, isc_entropy_t *entropy, isc_rng_t **rngp);
/*%<
 * Creates and initializes a pseudo random number generator. The
 * returned RNG can be used to generate pseudo random numbers.
 *
 * The reference count of the returned RNG is set to 1.
 *
 * Requires:
 * \li mctx is a pointer to a valid memory context.
 * \li entropy is an optional entopy source (can be NULL)
 * \li rngp != NULL && *rngp == NULL is where a pointer to the RNG is
 *     returned.
 *
 * Ensures:
 *\li	If result is ISC_R_SUCCESS:
 *		*rngp points to a valid RNG.
 *
 *\li	If result is failure:
 *		*rngp does not point to a valid RNG.
 *
 * Returns:
 *\li	#ISC_R_SUCCESS	Success
 *\li	#ISC_R_NOMEMORY Resource limit: Out of Memory
 */

void
isc_rng_attach(isc_rng_t *source, isc_rng_t **targetp);
/*%<
 * Increments a reference count on the passed RNG.
 *
 * Requires:
 * \li source the RNG struct to attach to (is refcount is incremented)
 * \li targetp != NULL && *targetp == NULL where a pointer to the
 *     reference incremented RNG is returned.
 */

void
isc_rng_detach(isc_rng_t **rngp);
/*%<
 * Decrements a reference count on the passed RNG. If the reference
 * count reaches 0, the RNG is destroyed.
 *
 * Requires:
 * \li rngp != NULL the RNG struct to decrement reference for
 */

uint16_t
isc_rng_random(isc_rng_t *rngctx);
/*%<
 * Returns a pseudo random 16-bit unsigned integer.
 */

uint16_t
isc_rng_uniformrandom(isc_rng_t *rngctx, uint16_t upper_bound);
/*%<
 * Returns a uniformly distributed pseudo-random 16-bit unsigned integer
 * less than 'upper_bound'.
 */

ISC_LANG_ENDDECLS

#endif /* ISC_RANDOM_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
aes.h	text/x-c	1.05 KB	-rw-r--r--	2025-11-06 07:45:35
app.h	text/x-c	10.23 KB	-rw-r--r--	2025-11-06 07:45:35
assertions.h	text/x-c	2.84 KB	-rw-r--r--	2025-11-06 07:45:35
atomic.h	text/x-c	4.07 KB	-rw-r--r--	2025-11-06 07:45:35
backtrace.h	text/x-c	3.8 KB	-rw-r--r--	2025-11-06 07:45:35
base32.h	text/x-c	4.35 KB	-rw-r--r--	2025-11-06 07:45:35
base64.h	text/x-c	2.8 KB	-rw-r--r--	2025-11-06 07:45:35
bind9.h	text/x-c	830 B	-rw-r--r--	2025-11-06 07:45:35
boolean.h	text/x-c	594 B	-rw-r--r--	2025-11-06 07:45:35
buffer.h	text/x-c	25.65 KB	-rw-r--r--	2025-11-06 07:45:35
bufferlist.h	text/x-c	1.42 KB	-rw-r--r--	2025-11-06 07:45:35
cmocka.h	text/x-c	1.35 KB	-rw-r--r--	2025-11-06 07:45:35
commandline.h	text/x-c	1.67 KB	-rw-r--r--	2025-11-06 07:45:35
condition.h	text/x-c	1.44 KB	-rw-r--r--	2025-11-06 07:45:35
counter.h	text/x-c	1.88 KB	-rw-r--r--	2025-11-06 07:45:35
crc64.h	text/x-c	998 B	-rw-r--r--	2025-11-06 07:45:35
deprecated.h	text/x-c	623 B	-rw-r--r--	2025-11-06 07:45:35
dir.h	text/x-c	1.56 KB	-rw-r--r--	2025-11-06 07:45:35
endian.h	text/x-c	4.67 KB	-rw-r--r--	2025-11-06 07:45:35
entropy.h	text/x-c	10.13 KB	-rw-r--r--	2025-11-06 07:45:35
errno.h	text/x-c	659 B	-rw-r--r--	2025-11-06 07:45:35
errno2result.h	text/x-c	902 B	-rw-r--r--	2025-11-06 07:45:48
error.h	text/x-c	1.4 KB	-rw-r--r--	2025-11-06 07:45:35
event.h	text/x-c	2.98 KB	-rw-r--r--	2025-11-06 07:45:35
eventclass.h	text/x-c	1.35 KB	-rw-r--r--	2025-11-06 07:45:35
file.h	text/x-c	11.39 KB	-rw-r--r--	2025-11-06 07:45:35
formatcheck.h	text/x-c	893 B	-rw-r--r--	2025-11-06 07:45:35
fsaccess.h	text/x-c	7.27 KB	-rw-r--r--	2025-11-06 07:45:35
hash.h	text/x-c	7.48 KB	-rw-r--r--	2025-11-06 07:45:35
heap.h	text/x-c	5.14 KB	-rw-r--r--	2025-11-06 07:45:35
hex.h	text/x-c	2.74 KB	-rw-r--r--	2025-11-06 07:45:35
hmacmd5.h	text/x-c	1.75 KB	-rw-r--r--	2025-11-06 07:45:35
hmacsha.h	text/x-c	4.41 KB	-rw-r--r--	2025-11-06 07:45:35
ht.h	text/x-c	4.29 KB	-rw-r--r--	2025-11-06 07:45:35
httpd.h	text/x-c	2.26 KB	-rw-r--r--	2025-11-06 07:45:35
int.h	text/x-c	1.06 KB	-rw-r--r--	2025-11-06 07:45:35
interfaceiter.h	text/x-c	3.05 KB	-rw-r--r--	2025-11-06 07:45:35
iterated_hash.h	text/x-c	1.02 KB	-rw-r--r--	2025-11-06 07:45:35
json.h	text/x-c	1.42 KB	-rw-r--r--	2025-11-06 07:45:35
keyboard.h	text/x-c	989 B	-rw-r--r--	2025-11-06 07:45:35
lang.h	text/x-c	637 B	-rw-r--r--	2025-11-06 07:45:35
lex.h	text/x-c	9.54 KB	-rw-r--r--	2025-11-06 07:45:35
lfsr.h	text/x-c	2.89 KB	-rw-r--r--	2025-11-06 07:45:35
lib.h	text/x-c	1.04 KB	-rw-r--r--	2025-11-06 07:45:35
likely.h	text/x-c	818 B	-rw-r--r--	2025-11-06 07:45:35
list.h	text/x-c	5.62 KB	-rw-r--r--	2025-11-06 07:45:35
log.h	text/x-c	28.06 KB	-rw-r--r--	2025-11-06 07:45:35
magic.h	text/x-c	994 B	-rw-r--r--	2025-11-06 07:45:35
md5.h	text/x-c	2.32 KB	-rw-r--r--	2025-11-06 07:45:35
mem.h	text/x-c	20.62 KB	-rw-r--r--	2025-11-06 07:45:35
meminfo.h	text/x-c	710 B	-rw-r--r--	2025-11-06 07:45:35
msgcat.h	text/x-c	2.66 KB	-rw-r--r--	2025-11-06 07:45:35
msgs.h	text/x-c	8.22 KB	-rw-r--r--	2025-11-06 07:45:35
mutex.h	text/x-c	3.44 KB	-rw-r--r--	2025-11-06 07:45:35
mutexblock.h	text/x-c	1.34 KB	-rw-r--r--	2025-11-06 07:45:35
net.h	text/x-c	10.29 KB	-rw-r--r--	2025-11-06 07:45:35
netaddr.h	text/x-c	4.48 KB	-rw-r--r--	2025-11-06 07:45:35
netdb.h	text/x-c	863 B	-rw-r--r--	2025-11-06 07:45:35
netscope.h	text/x-c	967 B	-rw-r--r--	2025-11-06 07:45:35
offset.h	text/x-c	700 B	-rw-r--r--	2025-11-06 07:45:35
once.h	text/x-c	983 B	-rw-r--r--	2025-11-06 07:45:35
ondestroy.h	text/x-c	2.73 KB	-rw-r--r--	2025-11-06 07:45:35
os.h	text/x-c	671 B	-rw-r--r--	2025-11-06 07:45:35
parseint.h	text/x-c	1.51 KB	-rw-r--r--	2025-11-06 07:45:35
platform.h	text/x-c	9.49 KB	-rw-r--r--	2025-11-06 07:45:35
pool.h	text/x-c	3.42 KB	-rw-r--r--	2025-11-06 07:45:35
portset.h	text/x-c	3.22 KB	-rw-r--r--	2025-11-06 07:45:35
print.h	text/x-c	2.42 KB	-rw-r--r--	2025-11-06 07:45:35
queue.h	text/x-c	5.08 KB	-rw-r--r--	2025-11-06 07:45:35
quota.h	text/x-c	2.38 KB	-rw-r--r--	2025-11-06 07:45:35
radix.h	text/x-c	6.34 KB	-rw-r--r--	2025-11-06 07:45:35
random.h	text/x-c	3.5 KB	-rw-r--r--	2025-11-06 07:45:35
ratelimiter.h	text/x-c	3.42 KB	-rw-r--r--	2025-11-06 07:45:35
refcount.h	text/x-c	8 KB	-rw-r--r--	2025-11-06 07:45:35
regex.h	text/x-c	767 B	-rw-r--r--	2025-11-06 07:45:35
region.h	text/x-c	1.99 KB	-rw-r--r--	2025-11-06 07:45:35
resource.h	text/x-c	2.79 KB	-rw-r--r--	2025-11-06 07:45:35
result.h	text/x-c	4.87 KB	-rw-r--r--	2025-11-06 07:45:35
resultclass.h	text/x-c	1.56 KB	-rw-r--r--	2025-11-06 07:45:35
rwlock.h	text/x-c	3.72 KB	-rw-r--r--	2025-11-06 07:45:35
safe.h	text/x-c	1.32 KB	-rw-r--r--	2025-11-06 07:45:35
serial.h	text/x-c	1.34 KB	-rw-r--r--	2025-11-06 07:45:35
sha1.h	text/x-c	1.52 KB	-rw-r--r--	2025-11-06 07:45:35
sha2.h	text/x-c	5.6 KB	-rw-r--r--	2025-11-06 07:45:35
siphash.h	text/x-c	734 B	-rw-r--r--	2025-11-06 07:45:35
sockaddr.h	text/x-c	5.9 KB	-rw-r--r--	2025-11-06 07:45:35
socket.h	text/x-c	35.8 KB	-rw-r--r--	2025-11-06 07:45:35
stat.h	text/x-c	806 B	-rw-r--r--	2025-11-06 07:45:35
stats.h	text/x-c	3.62 KB	-rw-r--r--	2025-11-06 07:45:35
stdatomic.h	text/x-c	5.13 KB	-rw-r--r--	2025-11-06 07:45:35
stdio.h	text/x-c	1.75 KB	-rw-r--r--	2025-11-06 07:45:35
stdlib.h	text/x-c	704 B	-rw-r--r--	2025-11-06 07:45:35
stdtime.h	text/x-c	1.04 KB	-rw-r--r--	2025-11-06 07:45:35
strerror.h	text/x-c	777 B	-rw-r--r--	2025-11-06 07:45:35
string.h	text/x-c	5.88 KB	-rw-r--r--	2025-11-06 07:45:35
symtab.h	text/x-c	4.22 KB	-rw-r--r--	2025-11-06 07:45:35
syslog.h	text/x-c	844 B	-rw-r--r--	2025-11-06 07:45:35
task.h	text/x-tex	21.04 KB	-rw-r--r--	2025-11-06 07:45:35
taskpool.h	text/x-c	3.62 KB	-rw-r--r--	2025-11-06 07:45:35
thread.h	text/x-c	1.47 KB	-rw-r--r--	2025-11-06 07:45:35
time.h	text/x-c	8.67 KB	-rw-r--r--	2025-11-06 07:45:35
timer.h	text/x-c	10.54 KB	-rw-r--r--	2025-11-06 07:45:35
tm.h	text/x-c	895 B	-rw-r--r--	2025-11-06 07:45:35
types.h	text/x-c	5.64 KB	-rw-r--r--	2025-11-06 07:45:35
utf8.h	text/x-c	928 B	-rw-r--r--	2025-11-06 07:45:35
util.h	text/x-c	10.29 KB	-rw-r--r--	2025-11-06 07:45:35
version.h	text/x-c	689 B	-rw-r--r--	2025-11-06 07:45:35
xml.h	text/x-c	1.07 KB	-rw-r--r--	2025-11-06 07:45:35

~ ACUPOFTEA - accounting.gulfstore-gcc.com