--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/libxml2libs/inc/libxml2/libxml2_xmlmemory.h	Thu Dec 17 09:29:21 2009 +0200
@@ -0,0 +1,227 @@
+/*
+ * Summary: interface for the memory allocator
+ * Description: provides interfaces for the memory allocator,
+ *              including debugging capabilities.
+ *
+ * Copy: See Copyright for the status of this software.
+ *
+ * Author: Daniel Veillard
+ * Portion Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. 
+ */
+
+/** @file
+@publishedAll
+@released
+*/
+
+#ifndef LIBXML2_XMLMEMORY_H
+#define LIBXML2_XMLMEMORY_H
+
+#include <stddef.h>
+#include <stdapis/libxml2/libxml2_xmlversion.h>
+
+
+/**
+ * DEBUG_MEMORY:
+ *
+ * DEBUG_MEMORY replaces the allocator with a collect and debug
+ * shell to the libc allocator.
+ * DEBUG_MEMORY should only be activated when debugging
+ * libxml i.e. if libxml has been configured with --with-debug-mem too.
+ */
+/* #define DEBUG_MEMORY_FREED */
+/* #define DEBUG_MEMORY_LOCATION */
+
+#ifdef DEBUG
+#ifndef DEBUG_MEMORY
+#define DEBUG_MEMORY
+#endif
+#endif
+
+/**
+ * DEBUG_MEMORY_LOCATION:
+ *
+ * DEBUG_MEMORY_LOCATION should be activated only when debugging
+ * libxml i.e. if libxml has been configured with --with-debug-mem too.
+ */
+#ifdef DEBUG_MEMORY_LOCATION
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+ * The XML memory wrapper support 4 basic overloadable functions.
+ */
+/**
+ * xmlFreeFunc:
+ * @param mem an already allocated block of memory
+ *
+ * Signature for a free() implementation.
+ */
+typedef void (XMLCALL *xmlFreeFunc)(void *mem);
+/**
+ * xmlMallocFunc:
+ * @param size the size requested in bytes
+ *
+ * Signature for a malloc() implementation.
+ *
+ * Returns a pointer to the newly allocated block or NULL in case of error.
+ */
+typedef void *(XMLCALL *xmlMallocFunc)(size_t size);
+
+/**
+ * xmlReallocFunc:
+ * @param mem an already allocated block of memory
+ * @param size the new size requested in bytes
+ *
+ * Signature for a realloc() implementation.
+ *
+ * Returns a pointer to the newly reallocated block or NULL in case of error.
+ */
+typedef void *(XMLCALL *xmlReallocFunc)(void *mem, size_t size);
+
+/**
+ * xmlStrdupFunc:
+ * @param str a zero terminated string
+ *
+ * Signature for an strdup() implementation.
+ *
+ * Returns the copy of the string or NULL in case of error.
+ */
+typedef char *(XMLCALL *xmlStrdupFunc)(const char *str);
+
+/*The 4 interfaces used for all memory handling within libxml.
+LIBXML_DLL_IMPORT extern xmlFreeFunc xmlFree;
+LIBXML_DLL_IMPORT extern xmlMallocFunc xmlMalloc;
+LIBXML_DLL_IMPORT extern xmlMallocFunc xmlMallocAtomic;
+LIBXML_DLL_IMPORT extern xmlReallocFunc xmlRealloc;
+LIBXML_DLL_IMPORT extern xmlStrdupFunc xmlMemStrdup;
+ */
+
+/*
+ * The way to overload the existing functions.
+ * The xmlGc function have an extra entry for atomic block
+ * allocations useful for garbage collected memory allocators
+ */
+XMLPUBFUN int XMLCALL
+        xmlMemSetup     (xmlFreeFunc freeFunc,
+                         xmlMallocFunc mallocFunc,
+                         xmlReallocFunc reallocFunc,
+                         xmlStrdupFunc strdupFunc);
+XMLPUBFUN int XMLCALL
+        xmlMemGet       (xmlFreeFunc *freeFunc,
+                         xmlMallocFunc *mallocFunc,
+                         xmlReallocFunc *reallocFunc,
+                         xmlStrdupFunc *strdupFunc);
+
+#ifndef XMLENGINE_EXCLUDE_UNUSED
+
+XMLPUBFUN int XMLCALL
+        xmlGcMemSetup   (xmlFreeFunc freeFunc,
+                         xmlMallocFunc mallocFunc,
+                         xmlMallocFunc mallocAtomicFunc,
+                         xmlReallocFunc reallocFunc,
+                         xmlStrdupFunc strdupFunc);
+
+XMLPUBFUN int XMLCALL
+        xmlGcMemGet     (xmlFreeFunc *freeFunc,
+                         xmlMallocFunc *mallocFunc,
+                         xmlMallocFunc *mallocAtomicFunc,
+                         xmlReallocFunc *reallocFunc,
+                         xmlStrdupFunc *strdupFunc);
+#endif /* ifndef XMLENGINE_EXCLUDE_UNUSED */
+
+/*
+ * Initialization of the memory layer.
+ */
+XMLPUBFUN int XMLCALL
+        xmlInitMemory   (void);
+
+/*
+ * Cleanup of the memory layer.
+ */
+XMLPUBFUN void XMLCALL
+                xmlCleanupMemory        (void);
+/*
+ * These are specific to the XML debug memory wrapper.
+ */
+XMLPUBFUN int XMLCALL
+        xmlMemUsed      (void);
+
+#ifndef XMLENGINE_EXCLUDE_FILE_FUNC
+XMLPUBFUN void XMLCALL
+        xmlMemDisplay   (FILE *fp);
+XMLPUBFUN void XMLCALL
+        xmlMemShow      (FILE *fp, int nr);
+#endif
+
+XMLPUBFUN void XMLCALL
+        xmlMemoryDump   (void);
+XMLPUBFUN void * XMLCALL
+        xmlMemMalloc    (size_t size);
+XMLPUBFUN void * XMLCALL
+        xmlMemRealloc   (void *ptr,size_t size);
+XMLPUBFUN void XMLCALL
+        xmlMemFree      (void *ptr);
+XMLPUBFUN char * XMLCALL
+        xmlMemoryStrdup (const char *str);
+XMLPUBFUN void * XMLCALL
+        xmlMallocLoc    (size_t size, const char *file, int line);
+XMLPUBFUN void * XMLCALL
+        xmlReallocLoc   (void *ptr, size_t size, const char *file, int line);
+XMLPUBFUN void * XMLCALL
+        xmlMallocAtomicLoc (size_t size, const char *file, int line);
+XMLPUBFUN char * XMLCALL
+        xmlMemStrdupLoc (const char *str, const char *file, int line);
+
+
+#ifdef DEBUG_MEMORY_LOCATION
+/**
+ * xmlMalloc:
+ * @param size number of bytes to allocate
+ *
+ * Wrapper for the malloc() function used in the XML library.
+ *
+ * Returns the pointer to the allocated area or NULL in case of error.
+ */
+#define xmlMalloc(size) xmlMallocLoc((size), __FILE__, __LINE__)
+/**
+ * xmlMallocAtomic:
+ * @param size number of bytes to allocate
+ *
+ * Wrapper for the malloc() function used in the XML library for allocation
+ * of block not containing pointers to other areas.
+ *
+ * Returns the pointer to the allocated area or NULL in case of error.
+ */
+#define xmlMallocAtomic(size) xmlMallocAtomicLoc((size), __FILE__, __LINE__)
+/**
+ * xmlRealloc:
+ * @param ptr pointer to the existing allocated area
+ * @param size number of bytes to allocate
+ *
+ * Wrapper for the realloc() function used in the XML library.
+ *
+ * Returns the pointer to the allocated area or NULL in case of error.
+ */
+#define xmlRealloc(ptr, size) xmlReallocLoc((ptr), (size), __FILE__, __LINE__)
+/**
+ * xmlMemStrdup:
+ * @param str pointer to the existing string
+ *
+ * Wrapper for the strdup() function, xmlStrdup() is usually preferred.
+ *
+ * Returns the pointer to the allocated area or NULL in case of error.
+ */
+#define xmlMemStrdup(str) xmlMemStrdupLoc((str), __FILE__, __LINE__)
+
+#endif /* DEBUG_MEMORY_LOCATION */
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+
+#endif  /* LIBXML2_MEMORY_H */