2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-09-01 15:05:23 +00:00
This commit is contained in:
Francis Dupont
2009-01-17 23:42:01 +00:00
parent 59528addd7
commit 0ef59d2288
11 changed files with 33 additions and 33 deletions

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: log.h,v 1.57 2009/01/06 23:47:57 tbox Exp $ */ /* $Id: log.h,v 1.58 2009/01/17 23:19:14 fdupont Exp $ */
#ifndef ISC_LOG_H #ifndef ISC_LOG_H
#define ISC_LOG_H 1 #define ISC_LOG_H 1
@@ -477,7 +477,7 @@ isc_log_usechannel(isc_logconfig_t *lcfg, const char *name,
* number of named channels.) When multiple channels of the same * number of named channels.) When multiple channels of the same
* name are defined, the most recent definition is found. * name are defined, the most recent definition is found.
* *
*\li Specifing a very large number of channels for a category will have *\li Specifying a very large number of channels for a category will have
* a moderate impact on performance in isc_log_write(), as each * a moderate impact on performance in isc_log_write(), as each
* call looks up the category for the start of a linked list, which * call looks up the category for the start of a linked list, which
* it follows all the way to the end to find matching modules. The * it follows all the way to the end to find matching modules. The
@@ -546,7 +546,7 @@ isc_log_usechannel(isc_logconfig_t *lcfg, const char *name,
*\li lctx is a valid logging context. *\li lctx is a valid logging context.
* *
*\li The category and module arguments must have ids that are in the *\li The category and module arguments must have ids that are in the
* range of known ids, as estabished by isc_log_registercategories() * range of known ids, as established by isc_log_registercategories()
* and isc_log_registermodules(). * and isc_log_registermodules().
* *
*\li level != #ISC_LOG_DYNAMIC. ISC_LOG_DYNAMIC is used only to define *\li level != #ISC_LOG_DYNAMIC. ISC_LOG_DYNAMIC is used only to define
@@ -585,7 +585,7 @@ ISC_FORMAT_PRINTF(5, 6);
*\li lctx is a valid logging context. *\li lctx is a valid logging context.
* *
*\li The category and module arguments must have ids that are in the *\li The category and module arguments must have ids that are in the
* range of known ids, as estabished by isc_log_registercategories() * range of known ids, as established by isc_log_registercategories()
* and isc_log_registermodules(). * and isc_log_registermodules().
* *
*\li level != #ISC_LOG_DYNAMIC. ISC_LOG_DYNAMIC is used only to define *\li level != #ISC_LOG_DYNAMIC. ISC_LOG_DYNAMIC is used only to define
@@ -824,7 +824,7 @@ isc_log_opensyslog(const char *tag, int options, int facility);
* declared facility. * declared facility.
* \endcode * \endcode
* *
*\li Zero effort has been made (yet) to accomodate systems with openlog() *\li Zero effort has been made (yet) to accommodate systems with openlog()
* that only takes two arguments, or to identify valid syslog * that only takes two arguments, or to identify valid syslog
* facilities or options for any given architecture. * facilities or options for any given architecture.
* *

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: mem.h,v 1.78 2008/03/31 05:00:30 marka Exp $ */ /* $Id: mem.h,v 1.79 2009/01/17 23:22:35 fdupont Exp $ */
#ifndef ISC_MEM_H #ifndef ISC_MEM_H
#define ISC_MEM_H 1 #define ISC_MEM_H 1
@@ -94,7 +94,7 @@ LIBISC_EXTERNAL_DATA extern unsigned int isc_mem_debugging;
/*!< /*!<
* The variable isc_mem_debugging holds a set of flags for * The variable isc_mem_debugging holds a set of flags for
* turning certain memory debugging options on or off at * turning certain memory debugging options on or off at
* runtime. Its is intialized to the value ISC_MEM_DEGBUGGING, * runtime. It is initialized to the value ISC_MEM_DEGBUGGING,
* which is 0 by default but may be overridden at compile time. * which is 0 by default but may be overridden at compile time.
* The following flags can be specified: * The following flags can be specified:
* *
@@ -106,7 +106,7 @@ LIBISC_EXTERNAL_DATA extern unsigned int isc_mem_debugging;
* Crash if a free doesn't match an allocation. * Crash if a free doesn't match an allocation.
* *
* \li #ISC_MEM_DEBUGUSAGE * \li #ISC_MEM_DEBUGUSAGE
* If a hi_water mark is set, print the maximium inuse memory * If a hi_water mark is set, print the maximum inuse memory
* every time it is raised once it exceeds the hi_water mark. * every time it is raised once it exceeds the hi_water mark.
* *
* \li #ISC_MEM_DEBUGSIZE * \li #ISC_MEM_DEBUGSIZE
@@ -158,7 +158,7 @@ LIBISC_EXTERNAL_DATA extern unsigned int isc_mem_debugging;
#define isc_mempool_get(c) isc__mempool_get((c) _ISC_MEM_FILELINE) #define isc_mempool_get(c) isc__mempool_get((c) _ISC_MEM_FILELINE)
/*% /*%
* isc_mem_putanddetach() is a convienence function for use where you * isc_mem_putanddetach() is a convenience function for use where you
* have a structure with an attached memory context. * have a structure with an attached memory context.
* *
* Given: * Given:
@@ -341,12 +341,12 @@ isc_mem_setwater(isc_mem_t *mctx, isc_mem_water_t water, void *water_arg,
* *
* When the memory usage of 'mctx' exceeds 'hiwater', * When the memory usage of 'mctx' exceeds 'hiwater',
* '(water)(water_arg, #ISC_MEM_HIWATER)' will be called. 'water' needs to * '(water)(water_arg, #ISC_MEM_HIWATER)' will be called. 'water' needs to
* call isc_mem_waterack() with #ISC_MEM_HIWATER to acknowlege the state * call isc_mem_waterack() with #ISC_MEM_HIWATER to acknowledge the state
* change. 'water' may be called multiple times. * change. 'water' may be called multiple times.
* *
* When the usage drops below 'lowater', 'water' will again be called, this * When the usage drops below 'lowater', 'water' will again be called, this
* time with #ISC_MEM_LOWATER. 'water' need to calls isc_mem_waterack() with * time with #ISC_MEM_LOWATER. 'water' need to calls isc_mem_waterack() with
* #ISC_MEM_LOWATER to acknowlege the change. * #ISC_MEM_LOWATER to acknowledge the change.
* *
* static void * static void
* water(void *arg, int mark) { * water(void *arg, int mark) {
@@ -373,7 +373,7 @@ isc_mem_setwater(isc_mem_t *mctx, isc_mem_water_t water, void *water_arg,
void void
isc_mem_waterack(isc_mem_t *ctx, int mark); isc_mem_waterack(isc_mem_t *ctx, int mark);
/*%< /*%<
* Called to acknowledge changes in signalled by calls to 'water'. * Called to acknowledge changes in signaled by calls to 'water'.
*/ */
void void
@@ -512,7 +512,7 @@ isc_mempool_associatelock(isc_mempool_t *mpctx, isc_mutex_t *lock);
* and it is also used to set or get internal state via the isc_mempool_get*() * and it is also used to set or get internal state via the isc_mempool_get*()
* and isc_mempool_set*() set of functions. * and isc_mempool_set*() set of functions.
* *
* Mutiple pools can each share a single lock. For instance, if "manager" * Multiple pools can each share a single lock. For instance, if "manager"
* type object contained pools for various sizes of events, and each of * type object contained pools for various sizes of events, and each of
* these pools used a common lock. Note that this lock must NEVER be used * these pools used a common lock. Note that this lock must NEVER be used
* by other than mempool routines once it is given to a pool, since that can * by other than mempool routines once it is given to a pool, since that can

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: netaddr.h,v 1.35 2007/06/18 23:47:44 tbox Exp $ */ /* $Id: netaddr.h,v 1.36 2009/01/17 23:25:02 fdupont Exp $ */
#ifndef ISC_NETADDR_H #ifndef ISC_NETADDR_H
#define ISC_NETADDR_H 1 #define ISC_NETADDR_H 1
@@ -171,7 +171,7 @@ isc_netaddr_prefixok(const isc_netaddr_t *na, unsigned int prefixlen);
* Returns: * Returns:
* ISC_R_SUCCESS * ISC_R_SUCCESS
* ISC_R_RANGE prefixlen out of range * ISC_R_RANGE prefixlen out of range
* ISC_R_NOTIMPLENTED unsupported family * ISC_R_NOTIMPLEMENTED unsupported family
* ISC_R_FAILURE extra bits. * ISC_R_FAILURE extra bits.
*/ */

View File

@@ -14,10 +14,10 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: portset.h,v 1.3 2008/06/23 23:47:11 tbox Exp $ */ /* $Id: portset.h,v 1.4 2009/01/17 23:28:05 fdupont Exp $ */
/*! \file isc/portset.h /*! \file isc/portset.h
* \brief Transport Protocol Port Manipuration Module * \brief Transport Protocol Port Manipulation Module
* *
* This module provides simple utilities to handle a set of transport protocol * This module provides simple utilities to handle a set of transport protocol
* (UDP or TCP) port numbers, e.g., for creating an ACL list. An isc_portset_t * (UDP or TCP) port numbers, e.g., for creating an ACL list. An isc_portset_t

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: random.h,v 1.18 2007/06/19 23:47:18 tbox Exp $ */ /* $Id: random.h,v 1.19 2009/01/17 23:29:57 fdupont Exp $ */
#ifndef ISC_RANDOM_H #ifndef ISC_RANDOM_H
#define ISC_RANDOM_H 1 #define ISC_RANDOM_H 1
@@ -25,7 +25,7 @@
/*! \file isc/random.h /*! \file isc/random.h
* \brief Implements a random state pool which will let the caller return a * \brief Implements a random state pool which will let the caller return a
* series of possibly non-reproducable random values. * series of possibly non-reproducible random values.
* *
* Note that the * Note that the
* strength of these numbers is not all that high, and should not be * strength of these numbers is not all that high, and should not be

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: ratelimiter.h,v 1.21 2007/06/19 23:47:18 tbox Exp $ */ /* $Id: ratelimiter.h,v 1.22 2009/01/17 23:31:36 fdupont Exp $ */
#ifndef ISC_RATELIMITER_H #ifndef ISC_RATELIMITER_H
#define ISC_RATELIMITER_H 1 #define ISC_RATELIMITER_H 1
@@ -53,7 +53,7 @@ isc_ratelimiter_create(isc_mem_t *mctx, isc_timermgr_t *timermgr,
isc_result_t isc_result_t
isc_ratelimiter_setinterval(isc_ratelimiter_t *rl, isc_interval_t *interval); isc_ratelimiter_setinterval(isc_ratelimiter_t *rl, isc_interval_t *interval);
/*!< /*!<
* Set the mininum interval between event executions. * Set the minimum interval between event executions.
* The interval value is copied, so the caller need not preserve it. * The interval value is copied, so the caller need not preserve it.
* *
* Requires: * Requires:
@@ -102,7 +102,7 @@ isc_ratelimiter_shutdown(isc_ratelimiter_t *ratelimiter);
*\li Further attempts to enqueue events will fail with *\li Further attempts to enqueue events will fail with
* #ISC_R_SHUTTINGDOWN. * #ISC_R_SHUTTINGDOWN.
* *
*\li The reatelimiter is no longer attached to its task. *\li The rate limiter is no longer attached to its task.
*/ */
void void

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: serial.h,v 1.16 2007/06/19 23:47:18 tbox Exp $ */ /* $Id: serial.h,v 1.17 2009/01/17 23:34:27 fdupont Exp $ */
#ifndef ISC_SERIAL_H #ifndef ISC_SERIAL_H
#define ISC_SERIAL_H 1 #define ISC_SERIAL_H 1
@@ -24,7 +24,7 @@
#include <isc/types.h> #include <isc/types.h>
/*! \file isc/serial.h /*! \file isc/serial.h
* \brief Implement 32 bit serial space arithmetic comparision functions. * \brief Implement 32 bit serial space arithmetic comparison functions.
* Note: Undefined results are returned as ISC_FALSE. * Note: Undefined results are returned as ISC_FALSE.
*/ */

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: sockaddr.h,v 1.55 2007/06/18 23:47:44 tbox Exp $ */ /* $Id: sockaddr.h,v 1.56 2009/01/17 23:36:13 fdupont Exp $ */
#ifndef ISC_SOCKADDR_H #ifndef ISC_SOCKADDR_H
#define ISC_SOCKADDR_H 1 #define ISC_SOCKADDR_H 1
@@ -210,7 +210,7 @@ isc_sockaddr_isexperimental(const isc_sockaddr_t *sa);
isc_boolean_t isc_boolean_t
isc_sockaddr_islinklocal(const isc_sockaddr_t *sa); isc_sockaddr_islinklocal(const isc_sockaddr_t *sa);
/*%< /*%<
* Returns ISC_TRUE if the address is a link local addresss. * Returns ISC_TRUE if the address is a link local address.
*/ */
isc_boolean_t isc_boolean_t

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: socket.h,v 1.85 2008/09/04 07:46:02 marka Exp $ */ /* $Id: socket.h,v 1.86 2009/01/17 23:38:18 fdupont Exp $ */
#ifndef ISC_SOCKET_H #ifndef ISC_SOCKET_H
#define ISC_SOCKET_H 1 #define ISC_SOCKET_H 1
@@ -876,7 +876,7 @@ isc_socket_permunix(isc_sockaddr_t *sockaddr, isc_uint32_t perm,
* Set ownership and file permissions on the UNIX domain socket. * Set ownership and file permissions on the UNIX domain socket.
* *
* Note: On Solaris and SunOS this secures the directory containing * Note: On Solaris and SunOS this secures the directory containing
* the socket as Solaris and SunOS do not honour the filesytem * the socket as Solaris and SunOS do not honour the filesystem
* permissions on the socket. * permissions on the socket.
* *
* Requires: * Requires:

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: symtab.h,v 1.24 2007/06/19 23:47:18 tbox Exp $ */ /* $Id: symtab.h,v 1.25 2009/01/17 23:39:55 fdupont Exp $ */
#ifndef ISC_SYMTAB_H #ifndef ISC_SYMTAB_H
#define ISC_SYMTAB_H 1 #define ISC_SYMTAB_H 1
@@ -27,7 +27,7 @@
/*! \file isc/symtab.h /*! \file isc/symtab.h
* \brief Provides a simple memory-based symbol table. * \brief Provides a simple memory-based symbol table.
* *
* Keys are C strings, and key comparisons are case-insenstive. A type may * Keys are C strings, and key comparisons are case-insensitive. A type may
* be specified when looking up, defining, or undefining. A type value of * be specified when looking up, defining, or undefining. A type value of
* 0 means "match any type"; any other value will only match the given * 0 means "match any type"; any other value will only match the given
* type. * type.

View File

@@ -15,7 +15,7 @@
* PERFORMANCE OF THIS SOFTWARE. * PERFORMANCE OF THIS SOFTWARE.
*/ */
/* $Id: task.h,v 1.61 2007/06/18 23:47:44 tbox Exp $ */ /* $Id: task.h,v 1.62 2009/01/17 23:42:01 fdupont Exp $ */
#ifndef ISC_TASK_H #ifndef ISC_TASK_H
#define ISC_TASK_H 1 #define ISC_TASK_H 1
@@ -67,7 +67,7 @@
* Consumers of events should purge, not unsend. * Consumers of events should purge, not unsend.
* *
* Producers of events often want to remove events when the caller indicates * Producers of events often want to remove events when the caller indicates
* it is no longer interested in the object, e.g. by cancelling a timer. * it is no longer interested in the object, e.g. by canceling a timer.
* Sometimes this can be done by purging, but for some event types, the * Sometimes this can be done by purging, but for some event types, the
* calls to isc_event_free() cause deadlock because the event free routine * calls to isc_event_free() cause deadlock because the event free routine
* wants to acquire a lock the caller is already holding. Unsending instead * wants to acquire a lock the caller is already holding. Unsending instead
@@ -593,7 +593,7 @@ isc_taskmgr_destroy(isc_taskmgr_t **managerp);
* because it would block forever waiting for the event action to * because it would block forever waiting for the event action to
* complete. An event action that wants to cause task manager shutdown * complete. An event action that wants to cause task manager shutdown
* should request some non-event action thread of execution to do the * should request some non-event action thread of execution to do the
* shutdown, e.g. by signalling a condition variable or using * shutdown, e.g. by signaling a condition variable or using
* isc_app_shutdown(). * isc_app_shutdown().
* *
*\li Task manager references are not reference counted, so the caller *\li Task manager references are not reference counted, so the caller