diff options
Diffstat (limited to 'packages/httpd22/src/apr/apr_general.inc')
| -rw-r--r-- | packages/httpd22/src/apr/apr_general.inc | 219 |
1 files changed, 219 insertions, 0 deletions
diff --git a/packages/httpd22/src/apr/apr_general.inc b/packages/httpd22/src/apr/apr_general.inc new file mode 100644 index 0000000000..8e98912297 --- /dev/null +++ b/packages/httpd22/src/apr/apr_general.inc @@ -0,0 +1,219 @@ +{ Copyright 2000-2005 The Apache Software Foundation or its licensors, as + * applicable. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + } + +{ + * @file apr_general.h + * This is collection of oddballs that didn't fit anywhere else, + * and might move to more appropriate headers with the release + * of APR 1.0. + * @brief APR Miscellaneous library routines + } + +{#include "apr.h" +#include "apr_pools.h" +#include "apr_errno.h" + +#if APR_HAVE_SIGNAL_H +#include <signal.h> +#endif} + +{ + * @defgroup apr_general Miscellaneous library routines + * @ingroup APR + * This is collection of oddballs that didn't fit anywhere else, + * and might move to more appropriate headers with the release + * of APR 1.0. + } + +const +{ a space } + APR_ASCII_BLANK = #040; +{ a carrige return } + APR_ASCII_CR = #015; +{ a line feed } + APR_ASCII_LF = #012; +{ a tab } + APR_ASCII_TAB = #011; + +{ signal numbers typedef } +type + apr_signum_t = Integer; + +{ + * Finding offsets of elements within structures. + * Taken from the X code... they've sweated portability of this stuff + * so we don't have to. Sigh... + * @param p_type pointer type name + * @param field data field within the structure pointed to + * @return offset + } + +{#if defined(CRAY) || (defined(__arm) && !defined(LINUX)) +#ifdef __STDC__ +#define APR_OFFSET(p_type,field) _Offsetof(p_type,field) +#else +#ifdef CRAY2 +#define APR_OFFSET(p_type,field) \ + (sizeof(int)*((unsigned int)&(((p_type)NULL)->field))) + +#else} { !CRAY2 } + +{#define APR_OFFSET(p_type,field) ((unsigned int)&(((p_type)NULL)->field)) + +#endif} { !CRAY2 } +//#endif { __STDC__ } +//#else { ! (CRAY || __arm) } + +//#define APR_OFFSET(p_type,field) \ +// ((long) (((char *) (&(((p_type)NULL)->field))) - ((char *) NULL))) + +//#endif { !CRAY } + +{ + * Finding offsets of elements within structures. + * @param s_type structure type name + * @param field data field within the structure + * @return offset + } +{#if defined(offsetof) && !defined(__cplusplus) +#define APR_OFFSETOF(s_type,field) offsetof(s_type,field) +#else +#define APR_OFFSETOF(s_type,field) APR_OFFSET(s_type*,field) +#endif} + +{$ifndef DOXYGEN} + +{ A couple of prototypes for functions in case some platform doesn't + * have it + } +{#if (!APR_HAVE_STRCASECMP) && (APR_HAVE_STRICMP) +#define strcasecmp(s1, s2) stricmp(s1, s2) +#elif (!APR_HAVE_STRCASECMP) +int strcasecmp(const char *a, const char *b); +#endif + +#if (!APR_HAVE_STRNCASECMP) && (APR_HAVE_STRNICMP) +#define strncasecmp(s1, s2, n) strnicmp(s1, s2, n) +#elif (!APR_HAVE_STRNCASECMP) +int strncasecmp(const char *a, const char *b, size_t n); +#endif} + +{$endif} + +{ + * Alignment macros + } + +{ APR_ALIGN() is only to be used to align on a power of 2 boundary } +{#define APR_ALIGN(size, boundary) \ + (((size) + ((boundary) - 1)) & ~((boundary) - 1))} + +{ Default alignment } +//#define APR_ALIGN_DEFAULT(size) APR_ALIGN(size, 8) + + +{ + * String and memory functions + } + +{ APR_STRINGIFY is defined here, and also in apr_release.h, so wrap it } +{$ifndef APR_STRINGIFY} +{ Properly quote a value as a string in the C preprocessor } +//#define APR_STRINGIFY(n) APR_STRINGIFY_HELPER(n) +{ Helper macro for APR_STRINGIFY } +{#define APR_STRINGIFY_HELPER(n) #n} +{$endif} + +{#if (!APR_HAVE_MEMMOVE) +#define memmove(a,b,c) bcopy(b,a,c) +#endif + +#if (!APR_HAVE_MEMCHR) +void *memchr(const void *s, int c, size_t n); +#endif} + +{ + * @defgroup apr_library Library initialization and termination + } + +{ + * Setup any APR internal data structures. This MUST be the first function + * called for any APR library. + * @remark See apr_app_initialize if this is an application, rather than + * a library consumer of apr. + } +function apr_initialize: apr_status_t; + {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} + external LibAPR name LibNamePrefix + 'apr_initialize' + LibSuff0; + +{ + * Set up an application with normalized argc, argv (and optionally env) in + * order to deal with platform-specific oddities, such as Win32 services, + * code pages and signals. This must be the first function called for any + * APR program. + * @param argc Pointer to the argc that may be corrected + * @param argv Pointer to the argv that may be corrected + * @param env Pointer to the env that may be corrected, may be NULL + * @remark See apr_initialize if this is a library consumer of apr. + * Otherwise, this call is identical to apr_initialize, and must be closed + * with a call to apr_terminate at the end of program execution. + } +function apr_app_initialize(argc: PInteger; argv, env: PPChar): apr_status_t; + {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} + external LibAPR name LibNamePrefix + 'apr_app_initialize' + LibSuff12; + +{ + * Tear down any APR internal data structures which aren't torn down + * automatically. + * @remark An APR program must call this function at termination once it + * has stopped using APR services. The APR developers suggest using + * atexit to ensure this is called. When using APR from a language + * other than C that has problems with the calling convention, use + * apr_terminate2() instead. + } +procedure apr_terminate; + cdecl; external LibAPR name 'apr_terminate'; + +{ + * Tear down any APR internal data structures which aren't torn down + * automatically, same as apr_terminate + * @remark An APR program must call either the apr_terminate or apr_terminate2 + * function once it it has finished using APR services. The APR + * developers suggest using atexit(apr_terminate) to ensure this is done. + * apr_terminate2 exists to allow non-c language apps to tear down apr, + * while apr_terminate is recommended from c language applications. + } +procedure apr_terminate2; + cdecl; external LibAPR name LibNamePrefix + 'apr_terminate2' + LibSuff0; + +{ + * @defgroup apr_random Random Functions + } + +{$if defined(APR_HAS_RANDOM) or defined(DOXYGEN)} + +{ TODO: I'm not sure this is the best place to put this prototype...} +{ + * Generate random bytes. + * @param buf Buffer to fill with random bytes + * @param length Length of buffer in bytes (becomes apr_size_t in APR 1.0) + } +function apr_generate_random_bytes(buf: PChar; length: Integer): apr_status_t; + {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} + external LibAPR name LibNamePrefix + 'apr_generate_random_bytes' + LibSuff8; + +{$endif} + |