Gecko [ nbspublicschool.com ]

Name	Size	Permission
aes.h	1.05 KB	-rw-r--r--
app.h	10.23 KB	-rw-r--r--
assertions.h	2.78 KB	-rw-r--r--
atomic.h	4.15 KB	-rw-r--r--
backtrace.h	3.8 KB	-rw-r--r--
base32.h	3.94 KB	-rw-r--r--
base64.h	2.39 KB	-rw-r--r--
bind9.h	849 B	-rw-r--r--
boolean.h	746 B	-rw-r--r--
buffer.h	25.69 KB	-rw-r--r--
bufferlist.h	1.42 KB	-rw-r--r--
commandline.h	1.69 KB	-rw-r--r--
condition.h	1.44 KB	-rw-r--r--
counter.h	1.88 KB	-rw-r--r--
crc64.h	986 B	-rw-r--r--
deprecated.h	622 B	-rw-r--r--
dir.h	1.96 KB	-rw-r--r--
entropy.h	8.76 KB	-rw-r--r--
errno.h	658 B	-rw-r--r--
errno2result.h	893 B	-rw-r--r--
error.h	1.4 KB	-rw-r--r--
event.h	2.98 KB	-rw-r--r--
eventclass.h	1.35 KB	-rw-r--r--
file.h	11.43 KB	-rw-r--r--
formatcheck.h	892 B	-rw-r--r--
fsaccess.h	7.25 KB	-rw-r--r--
hash.h	7.52 KB	-rw-r--r--
heap.h	5.14 KB	-rw-r--r--
hex.h	2.33 KB	-rw-r--r--
hmacmd5.h	1.75 KB	-rw-r--r--
hmacsha.h	4.44 KB	-rw-r--r--
ht.h	4.29 KB	-rw-r--r--
httpd.h	2.26 KB	-rw-r--r--
int.h	1.37 KB	-rw-r--r--
interfaceiter.h	3.03 KB	-rw-r--r--
iterated_hash.h	1.02 KB	-rw-r--r--
json.h	1.42 KB	-rw-r--r--
keyboard.h	976 B	-rw-r--r--
lang.h	636 B	-rw-r--r--
lex.h	9.42 KB	-rw-r--r--
lfsr.h	2.88 KB	-rw-r--r--
lib.h	1.04 KB	-rw-r--r--
likely.h	718 B	-rw-r--r--
list.h	5.65 KB	-rw-r--r--
log.h	28.06 KB	-rw-r--r--
magic.h	993 B	-rw-r--r--
md5.h	2.34 KB	-rw-r--r--
mem.h	20.63 KB	-rw-r--r--
meminfo.h	690 B	-rw-r--r--
msgcat.h	2.66 KB	-rw-r--r--
msgs.h	8.22 KB	-rw-r--r--
mutex.h	3.44 KB	-rw-r--r--
mutexblock.h	1.34 KB	-rw-r--r--
net.h	10.32 KB	-rw-r--r--
netaddr.h	4.56 KB	-rw-r--r--
netdb.h	862 B	-rw-r--r--
netscope.h	947 B	-rw-r--r--
offset.h	699 B	-rw-r--r--
once.h	981 B	-rw-r--r--
ondestroy.h	2.79 KB	-rw-r--r--
os.h	670 B	-rw-r--r--
parseint.h	1.49 KB	-rw-r--r--
platform.h	9.31 KB	-rw-r--r--
pool.h	3.42 KB	-rw-r--r--
portset.h	3.21 KB	-rw-r--r--
print.h	2.49 KB	-rw-r--r--
queue.h	4.66 KB	-rw-r--r--
quota.h	2.29 KB	-rw-r--r--
radix.h	6.37 KB	-rw-r--r--
random.h	2.99 KB	-rw-r--r--
ratelimiter.h	3.38 KB	-rw-r--r--
refcount.h	7.89 KB	-rw-r--r--
regex.h	766 B	-rw-r--r--
region.h	1.99 KB	-rw-r--r--
resource.h	2.8 KB	-rw-r--r--
result.h	4.62 KB	-rw-r--r--
resultclass.h	1.56 KB	-rw-r--r--
rwlock.h	3.6 KB	-rw-r--r--
safe.h	1.21 KB	-rw-r--r--
serial.h	1.4 KB	-rw-r--r--
sha1.h	1.52 KB	-rw-r--r--
sha2.h	5.65 KB	-rw-r--r--
sockaddr.h	6 KB	-rw-r--r--
socket.h	35.81 KB	-rw-r--r--
stat.h	805 B	-rw-r--r--
stats.h	3.02 KB	-rw-r--r--
stdio.h	1.74 KB	-rw-r--r--
stdlib.h	703 B	-rw-r--r--
stdtime.h	1.3 KB	-rw-r--r--
strerror.h	776 B	-rw-r--r--
string.h	5.94 KB	-rw-r--r--
symtab.h	4.21 KB	-rw-r--r--
syslog.h	843 B	-rw-r--r--
task.h	21.08 KB	-rw-r--r--
taskpool.h	3.61 KB	-rw-r--r--
thread.h	1.47 KB	-rw-r--r--
time.h	8.66 KB	-rw-r--r--
timer.h	10.54 KB	-rw-r--r--
tm.h	894 B	-rw-r--r--
types.h	5.54 KB	-rw-r--r--
util.h	7.49 KB	-rw-r--r--
version.h	688 B	-rw-r--r--
xml.h	1.07 KB	-rw-r--r--

Code Editor : util.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 http://mozilla.org/MPL/2.0/.
 *
 * See the COPYRIGHT file distributed with this work for additional
 * information regarding copyright ownership.
 */

#ifndef ISC_UTIL_H
#define ISC_UTIL_H 1

/*! \file isc/util.h
 * NOTE:
 *
 * This file is not to be included from any <isc/???.h> (or other) library
 * files.
 *
 * \brief
 * Including this file puts several macros in your name space that are
 * not protected (as all the other ISC functions/macros do) by prepending
 * ISC_ or isc_ to the name.
 */

/***
 *** General Macros.
 ***/

/*%
 * Use this to hide unused function arguments.
 * \code
 * int
 * foo(char *bar)
 * {
 *	UNUSED(bar);
 * }
 * \endcode
 */
#define UNUSED(x)      (void)(x)

/*%
 * The opposite: silent warnings about stored values which are never read.
 */
#define POST(x)        (void)(x)

#define ISC_MAX(a, b)  ((a) > (b) ? (a) : (b))
#define ISC_MIN(a, b)  ((a) < (b) ? (a) : (b))

#define ISC_CLAMP(v, x, y) ((v) < (x) ? (x) : ((v) > (y) ? (y) : (v)))

/*%
 * Use this to remove the const qualifier of a variable to assign it to
 * a non-const variable or pass it as a non-const function argument ...
 * but only when you are sure it won't then be changed!
 * This is necessary to sometimes shut up some compilers
 * (as with gcc -Wcast-qual) when there is just no other good way to avoid the
 * situation.
 */
#define DE_CONST(konst, var) \
	do { \
		union { const void *k; void *v; } _u; \
		_u.k = konst; \
		var = _u.v; \
	} while (0)

/*%
 * Use this in translation units that would otherwise be empty, to
 * suppress compiler warnings.
 */
#define EMPTY_TRANSLATION_UNIT static void isc__empty(void) { isc__empty(); }

/*%
 * We use macros instead of calling the routines directly because
 * the capital letters make the locking stand out.
 * We RUNTIME_CHECK for success since in general there's no way
 * for us to continue if they fail.
 */

#ifdef ISC_UTIL_TRACEON
#define ISC_UTIL_TRACE(a) a
#include <stdio.h>		/* Required for fprintf/stderr when tracing. */
#include <isc/msgs.h>		/* Required for isc_msgcat when tracing. */
#else
#define ISC_UTIL_TRACE(a)
#endif

#include <isc/result.h>		/* Contractual promise. */

#define LOCK(lp) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_LOCKING, "LOCKING"), \
			       (lp), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_mutex_lock((lp)) == ISC_R_SUCCESS); \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_LOCKED, "LOCKED"), \
			       (lp), __FILE__, __LINE__)); \
	} while (0)
#define UNLOCK(lp) do { \
	RUNTIME_CHECK(isc_mutex_unlock((lp)) == ISC_R_SUCCESS); \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_UNLOCKED, "UNLOCKED"), \
			       (lp), __FILE__, __LINE__)); \
	} while (0)
#define ISLOCKED(lp) (1)
#define DESTROYLOCK(lp) \
	RUNTIME_CHECK(isc_mutex_destroy((lp)) == ISC_R_SUCCESS)

#define BROADCAST(cvp) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_BROADCAST, "BROADCAST"),\
			       (cvp), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_condition_broadcast((cvp)) == ISC_R_SUCCESS); \
	} while (0)
#define SIGNAL(cvp) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_SIGNAL, "SIGNAL"), \
			       (cvp), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_condition_signal((cvp)) == ISC_R_SUCCESS); \
	} while (0)
#define WAIT(cvp, lp) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_UTILWAIT, "WAIT"), \
			       (cvp), \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_LOCK, "LOCK"), \
			       (lp), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_condition_wait((cvp), (lp)) == ISC_R_SUCCESS); \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p %s %p %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_WAITED, "WAITED"), \
			       (cvp), \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_LOCKED, "LOCKED"), \
			       (lp), __FILE__, __LINE__)); \
	} while (0)

/*
 * isc_condition_waituntil can return ISC_R_TIMEDOUT, so we
 * don't RUNTIME_CHECK the result.
 *
 *  XXX Also, can't really debug this then...
 */

#define WAITUNTIL(cvp, lp, tp) \
	isc_condition_waituntil((cvp), (lp), (tp))

#define RWLOCK(lp, t) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p, %d %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_RWLOCK, "RWLOCK"), \
			       (lp), (t), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_rwlock_lock((lp), (t)) == ISC_R_SUCCESS); \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p, %d %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_RWLOCKED, "RWLOCKED"), \
			       (lp), (t), __FILE__, __LINE__)); \
	} while (0)
#define RWUNLOCK(lp, t) do { \
	ISC_UTIL_TRACE(fprintf(stderr, "%s %p, %d %s %d\n", \
			       isc_msgcat_get(isc_msgcat, ISC_MSGSET_UTIL, \
					      ISC_MSG_RWUNLOCK, "RWUNLOCK"), \
			       (lp), (t), __FILE__, __LINE__)); \
	RUNTIME_CHECK(isc_rwlock_unlock((lp), (t)) == ISC_R_SUCCESS); \
	} while (0)

#define DESTROYMUTEXBLOCK(bp, n) \
	RUNTIME_CHECK(isc_mutexblock_destroy((bp), (n)) == ISC_R_SUCCESS)

/*
 * List Macros.
 */
#include <isc/list.h>		/* Contractual promise. */

#define LIST(type)			ISC_LIST(type)
#define INIT_LIST(type)			ISC_LIST_INIT(type)
#define LINK(type)			ISC_LINK(type)
#define INIT_LINK(elt, link)		ISC_LINK_INIT(elt, link)
#define HEAD(list)			ISC_LIST_HEAD(list)
#define TAIL(list)			ISC_LIST_TAIL(list)
#define EMPTY(list)			ISC_LIST_EMPTY(list)
#define PREV(elt, link)			ISC_LIST_PREV(elt, link)
#define NEXT(elt, link)			ISC_LIST_NEXT(elt, link)
#define APPEND(list, elt, link)		ISC_LIST_APPEND(list, elt, link)
#define PREPEND(list, elt, link)	ISC_LIST_PREPEND(list, elt, link)
#define UNLINK(list, elt, link)		ISC_LIST_UNLINK(list, elt, link)
#define ENQUEUE(list, elt, link)	ISC_LIST_APPEND(list, elt, link)
#define DEQUEUE(list, elt, link)	ISC_LIST_UNLINK(list, elt, link)
#define INSERTBEFORE(li, b, e, ln)	ISC_LIST_INSERTBEFORE(li, b, e, ln)
#define INSERTAFTER(li, a, e, ln)	ISC_LIST_INSERTAFTER(li, a, e, ln)
#define APPENDLIST(list1, list2, link)	ISC_LIST_APPENDLIST(list1, list2, link)

/*%
 * Performance
 */
#include <isc/likely.h>

/*
 * Assertions
 */
#include <isc/assertions.h>	/* Contractual promise. */

/*% Require Assertion */
#define REQUIRE(e)			ISC_REQUIRE(e)
/*% Ensure Assertion */
#define ENSURE(e)			ISC_ENSURE(e)
/*% Insist Assertion */
#define INSIST(e)			ISC_INSIST(e)
/*% Invariant Assertion */
#define INVARIANT(e)			ISC_INVARIANT(e)

/*
 * Errors
 */
#include <isc/error.h>		/* Contractual promise. */

/*% Unexpected Error */
#define UNEXPECTED_ERROR		isc_error_unexpected
/*% Fatal Error */
#define FATAL_ERROR			isc_error_fatal
/*% Runtime Check */
#define RUNTIME_CHECK(cond)		ISC_ERROR_RUNTIMECHECK(cond)

/*%
 * Time
 */
#define TIME_NOW(tp) 	RUNTIME_CHECK(isc_time_now((tp)) == ISC_R_SUCCESS)
#ifdef CLOCK_BOOTTIME
#define TIME_MONOTONIC(tp) 	RUNTIME_CHECK(isc_time_boottime((tp)) == ISC_R_SUCCESS)
#endif

/*%
 * Misc
 */
#include <isc/deprecated.h>

#endif /* ISC_UTIL_H */

${this.title}

Code Editor : util.h