summaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
authordreid <dreid@13f79535-47bb-0310-9956-ffa450edef68>2001-05-14 22:57:47 +0000
committerdreid <dreid@13f79535-47bb-0310-9956-ffa450edef68>2001-05-14 22:57:47 +0000
commita20d2d5c422a3598d0e2db897c7b2197341f98c8 (patch)
tree99f41f0f2bd7cfb1ff0b5a369896b49846649a9d /include
parent917d509826cbc42556bdce2f1f33e3186fcedb48 (diff)
downloadlibapr-a20d2d5c422a3598d0e2db897c7b2197341f98c8.tar.gz
apr_memory_system.h has become apr_sms.h
apr_tracking_memory_system.h has become apr_sms_tracking.h This removes the originals. git-svn-id: http://svn.apache.org/repos/asf/apr/apr/trunk@61637 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'include')
-rw-r--r--include/apr_memory_system.h287
-rw-r--r--include/apr_tracking_memory_system.h94
2 files changed, 0 insertions, 381 deletions
diff --git a/include/apr_memory_system.h b/include/apr_memory_system.h
deleted file mode 100644
index d34ecc16b..000000000
--- a/include/apr_memory_system.h
+++ /dev/null
@@ -1,287 +0,0 @@
-/* ====================================================================
- * The Apache Software License, Version 1.1
- *
- * Copyright (c) 2000-2001 The Apache Software Foundation. All rights
- * reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
- * "This product includes software developed by the
- * Apache Software Foundation (http://www.apache.org/)."
- * Alternately, this acknowledgment may appear in the software itself,
- * if and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Apache" and "Apache Software Foundation" must
- * not be used to endorse or promote products derived from this
- * software without prior written permission. For written
- * permission, please contact apache@apache.org.
- *
- * 5. Products derived from this software may not be called "Apache",
- * nor may "Apache" appear in their name, without prior written
- * permission of the Apache Software Foundation.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
- * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- * SUCH DAMAGE.
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many
- * individuals on behalf of the Apache Software Foundation. For more
- * information on the Apache Software Foundation, please see
- * <http://www.apache.org/>.
- */
-
-/* This code kindly donated to APR by
- * Elrond <elrond@samba-tng.org>
- * Luke Kenneth Casson Leighton <lkcl@samba-tng.org>
- * Sander Striker <striker@samba-tng.org>
- *
- * May 2001
- */
-
-#ifndef APR_MEMORY_SYSTEM_H
-#define APR_MEMORY_SYSTEM_H
-
-#include "apr.h"
-#include "apr_errno.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @package APR memory system
- */
-
-typedef struct apr_sms_t apr_sms_t;
-
-struct apr_sms_cleanup;
-
-/**
- * The memory system structure
- */
-struct apr_sms_t
-{
- apr_sms_t *parent_mem_sys;
- apr_sms_t *child_mem_sys;
- apr_sms_t *sibling_mem_sys;
- apr_sms_t **ref_mem_sys;
- apr_sms_t *accounting_mem_sys;
-
- struct apr_sms_cleanup *cleanups;
-
- void * (*malloc_fn)(apr_sms_t *mem_sys, apr_size_t size);
- void * (*calloc_fn)(apr_sms_t *mem_sys, apr_size_t size);
- void * (*realloc_fn)(apr_sms_t *mem_sys, void *memory,
- apr_size_t size);
- apr_status_t (*free_fn)(apr_sms_t *mem_sys, void *memory);
- apr_status_t (*reset_fn)(apr_sms_t *mem_sys);
- void (*pre_destroy_fn)(apr_sms_t *mem_sys);
- apr_status_t (*destroy_fn)(apr_sms_t *mem_sys);
- void (*threadsafe_lock_fn)(apr_sms_t *mem_sys);
- void (*threadsafe_unlock_fn)(apr_sms_t *mem_sys);
-};
-
-/*
- * memory allocation functions
- */
-
-/**
- * Allocate a block of memory using a certain memory system
- * @param mem_sys The memory system to use
- * @param size The (minimal required) size of the block to be allocated
- * @return pointer to a newly allocated block of memory, NULL if insufficient
- * memory available
- * @deffunc void *apr_sms_malloc(apr_sms_t *mem_sys, apr_size_t size)
- */
-APR_DECLARE(void *) apr_sms_malloc(apr_sms_t *mem_sys, apr_size_t size);
-
-/**
- * Allocate a block of zeroed memory using a certain memory system
- * @param mem_sys The memory system to use
- * @param size The (minimal required) size of the block to be allocated
- * @return pointer to a newly allocated block of memory, NULL if insufficient
- * memory available
- * @deffunc void *apr_sms_calloc(apr_sms_t *mem_sys, apr_size_t size)
- */
-APR_DECLARE(void *) apr_sms_calloc(apr_sms_t *mem_sys, apr_size_t size);
-
-/**
- * Change the size of a previously allocated block of memory
- * @param mem_sys The memory system to use (should be the same as the
- * one that returned the block)
- * @param mem Pointer to the previously allocated block. If NULL, this
- * function acts like apr_sms_malloc.
- * @param size The (minimal required) size of the block to be allocated
- * @return pointer to a newly allocated block of memory, NULL if insufficient
- * memory available
- * @deffunc void *apr_sms_realloc(apr_sms_t *mem_sys, void *mem, apr_size_t size)
- */
-APR_DECLARE(void *) apr_sms_realloc(apr_sms_t *mem_sys, void *mem, apr_size_t size);
-
-/**
- * Free a block of memory
- * @param mem_sys The memory system to use (should be the same as the
- * one that returned the block)
- * @param mem The block of memory to be freed
- * @deffunc void apr_sms_free(apr_sms_t *mem_sys,
- * void *mem)
- */
-APR_DECLARE(apr_status_t) apr_sms_free(apr_sms_t *mem_sys, void *mem);
-
-/*
- * memory system functions
- */
-
-/**
- * Create a memory system (actually it initialized a memory system structure)
- * @caution Call this function as soon as you have obtained a block of memory
- * to serve as a memory system structure from your
- * apr_xxx_sms_create. Only use this function when you are
- * implementing a memory system.
- * @param memory The memory to turn into a memory system
- * @warning The memory passed in should be at least of size
- * sizeof(apr_sms_t)
- * @param parent_mem_sys The parent memory system
- * @return The freshly initialized memory system
- * @deffunc apr_sms_t *apr_sms_create(void *memory,
- * apr_sms_t *parent_mem_sys)
- */
-APR_DECLARE(apr_sms_t *) apr_sms_create(void *memory, apr_sms_t *parent_mem_sys);
-
-/**
- * Check if a memory system is obeying all rules.
- * @caution Call this function as the last statement before returning a new
- * memory system from your apr_xxx_sms_create.
- * @deffunc void apr_sms_validate(apr_sms_t *mem_sys)
- */
-#ifdef APR_MEMORY_ASSERT
-APR_DECLARE(void) apr_sms_assert(apr_sms_t *mem_sys);
-#else
-#ifdef apr_sms_assert
-#undef apr_sms_assert
-#endif
-#define apr_sms_assert(mem_sys)
-#endif /* APR_MEMORY_ASSERT */
-
-/**
- * Reset a memory system so it can be reused.
- * This will also run all cleanup functions associated with the memory system
- * @warning This function will fail if there is no reset function available
- * for the given memory system (i.e. the memory system is non-
- * tracking).
- * @param mem_sys The memory system to be reset
- * @deffunc apr_status_t apr_sms_reset(apr_sms_t *mem_sys)
- */
-APR_DECLARE(apr_status_t) apr_sms_reset(apr_sms_t *mem_sys);
-
-/**
- * Destroy a memory system, effectively freeing all of its memory, and itself.
- * This will also run all cleanup functions associated with the memory system.
- * @caution Be carefull when using this function with a non-tracking memory
- * system
- * @param mem_sys The memory system to be destroyed
- * @deffunc apr_status_t apr_sms_destroy(apr_sms_t *mem_sys)
- */
-APR_DECLARE(apr_status_t) apr_sms_destroy(apr_sms_t *mem_sys);
-
-/**
- * Perform thread-safe locking required whilst this memory system is modified
- * @param mem_sys The memory system to be locked for thread-safety
- * @deffunc void apr_sms_threadsafe_lock(apr_sms_t *mem_sys)
- */
-APR_DECLARE(void) apr_sms_threadsafe_lock(apr_sms_t *mem_sys);
-
-/**
- * Release thread-safe locking required whilst this memory system was
- * being modified
- * @param mem_sys The memory system to be released from thread-safety
- * @deffunc void apr_sms_threadsafe_unlock(apr_sms_t *mem_sys)
- */
-APR_DECLARE(void) apr_sms_threadsafe_unlock(apr_sms_t *mem_sys);
-
-/**
- * Determine if memory system a is an ancestor of memory system b
- * @param a The memory system to search
- * @param b The memory system to search for
- * @return APR_SUCCESS if a is an ancestor of b, 1 if it isn't
- * @deffunc apr_status_t apr_sms_is_ancestor(apr_sms_t *a,
- * apr_sms_t *b)
- */
-APR_DECLARE(apr_status_t) apr_sms_is_ancestor(apr_sms_t *a, apr_sms_t *b);
-
-/*
- * memory system cleanup management functions
- */
-
-/**
- * Register a function to be called when a memory system is reset or destroyed
- * @param mem_sys The memory system to register the cleanup function with
- * @param data The data to pass to the cleanup function
- * @param cleanup_fn The function to call when the memory system is reset or
- * destroyed
- * @deffunc void apr_sms_cleanup_register(apr_sms_t *mem_sys,
- * void *data, apr_status_t (*cleanup_fn)(void *));
- */
-APR_DECLARE(apr_status_t) apr_sms_cleanup_register(apr_sms_t *mem_sys, void *data,
- apr_status_t (*cleanup_fn)(void *));
-
-/**
- * Unregister a previously registered cleanup function
- * @param mem_sys The memory system the cleanup function is registered
- * with
- * @param data The data associated with the cleanup function
- * @param cleanup_fn The registered cleanup function
- * @deffunc void apr_sms_cleanup_unregister(apr_sms_t *mem_sys,
- * void *data, apr_status_t (*cleanup_fn)(void *));
- */
-APR_DECLARE(apr_status_t) apr_sms_cleanup_unregister(apr_sms_t *mem_sys, void *data,
- apr_status_t (*cleanup)(void *));
-
-/**
- * Run the specified cleanup function immediately and unregister it
- * @param mem_sys The memory system the cleanup function is registered
- * with
- * @param data The data associated with the cleanup function
- * @param cleanup The registered cleanup function
- * @deffunc apr_status_t apr_sms_cleanup_run(apr_sms_t *mem_sys,
- * void *data, apr_status_t (*cleanup)(void *));
- */
-APR_DECLARE(apr_status_t) apr_sms_cleanup_run(apr_sms_t *mem_sys, void *data,
- apr_status_t (*cleanup)(void *));
-
-/**
- * Create a standard malloc/realloc/free memory system
- * @param mem_sys A pointer to the created apr_sms_t*
- * @deffunc apr_status_t apr_sms_std_create(apr_sms_t **mem_sys);
- */
-APR_DECLARE(apr_status_t) apr_sms_std_create(apr_sms_t **mem_sys);
-
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* !APR_MEMORY_SYSTEM_H */
-
diff --git a/include/apr_tracking_memory_system.h b/include/apr_tracking_memory_system.h
deleted file mode 100644
index c07c8a7d6..000000000
--- a/include/apr_tracking_memory_system.h
+++ /dev/null
@@ -1,94 +0,0 @@
-/* ====================================================================
- * The Apache Software License, Version 1.1
- *
- * Copyright (c) 2000-2001 The Apache Software Foundation. All rights
- * reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
- * "This product includes software developed by the
- * Apache Software Foundation (http://www.apache.org/)."
- * Alternately, this acknowledgment may appear in the software itself,
- * if and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Apache" and "Apache Software Foundation" must
- * not be used to endorse or promote products derived from this
- * software without prior written permission. For written
- * permission, please contact apache@apache.org.
- *
- * 5. Products derived from this software may not be called "Apache",
- * nor may "Apache" appear in their name, without prior written
- * permission of the Apache Software Foundation.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
- * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- * SUCH DAMAGE.
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many
- * individuals on behalf of the Apache Software Foundation. For more
- * information on the Apache Software Foundation, please see
- * <http://www.apache.org/>.
- */
-
-/* This code kindly donated to APR by
- * Elrond <elrond@samba-tng.org>
- * Luke Kenneth Casson Leighton <lkcl@samba-tng.org>
- * Sander Striker <striker@samba-tng.org>
- *
- * May 2001
- */
-
-#ifndef APR_TRACKING_MEMORY_SYSTEM_H
-#define APR_TRACKING_MEMORY_SYSTEM_H
-
-#include "apr.h"
-#include "apr_memory_system.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @package APR tracking memory system
- */
-
-/**
- * Create a standard malloc/realloc/free memory system
- * @param mem_sys A pointer to the returned apr_sms_t*
- * @param pms The parent memory system, used to allocate the memory
- * that we will be tracking.
- * @deffunc apr_status_t apr_sms_tracking_create(apr_sms_t **mem_sys,
- * apr_sms_t *pms);
- */
-APR_DECLARE(apr_status_t) apr_sms_tracking_create(apr_sms_t **mem_sys,
- apr_sms_t *pms);
-
-
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* !APR_TRACKING_MEMORY_SYSTEM_H */