mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-09-01 15:05:23 +00:00
spelling
This commit is contained in:
@@ -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.
|
||||||
*
|
*
|
||||||
|
@@ -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
|
||||||
|
@@ -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.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
@@ -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
|
||||||
|
@@ -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
|
||||||
|
@@ -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
|
||||||
|
@@ -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.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
@@ -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
|
||||||
|
@@ -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:
|
||||||
|
@@ -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.
|
||||||
|
@@ -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
|
||||||
|
Reference in New Issue
Block a user