aboutsummaryrefslogtreecommitdiff
path: root/externals/ace/Malloc_Base.h
diff options
context:
space:
mode:
authorRat <none@none>2010-06-07 19:10:55 +0200
committerRat <none@none>2010-06-07 19:10:55 +0200
commit32546e22828e793e3881e1055acb72b6a044e331 (patch)
tree759706cdfe8423887c69a2f8ed651c0c1e5ab7d7 /externals/ace/Malloc_Base.h
parent2e0f8fb6e558088b33bdee83bc5ff20014e983b3 (diff)
added ace + vcproj for win
--HG-- branch : trunk
Diffstat (limited to 'externals/ace/Malloc_Base.h')
-rw-r--r--externals/ace/Malloc_Base.h168
1 files changed, 168 insertions, 0 deletions
diff --git a/externals/ace/Malloc_Base.h b/externals/ace/Malloc_Base.h
new file mode 100644
index 00000000000..6a13d020ad6
--- /dev/null
+++ b/externals/ace/Malloc_Base.h
@@ -0,0 +1,168 @@
+// -*- C++ -*-
+
+//=============================================================================
+/**
+ * @file Malloc_Base.h
+ *
+ * $Id: Malloc_Base.h 80826 2008-03-04 14:51:23Z wotte $
+ *
+ * @author Doug Schmidt and Irfan Pyarali
+ */
+//=============================================================================
+
+
+#ifndef ACE_MALLOC_BASE_H
+#define ACE_MALLOC_BASE_H
+#include /**/ "ace/pre.h"
+
+#include /**/ "ace/ACE_export.h"
+
+#if !defined (ACE_LACKS_PRAGMA_ONCE)
+# pragma once
+#endif /* ACE_LACKS_PRAGMA_ONCE */
+
+#include "ace/os_include/sys/os_types.h"
+#include "ace/os_include/sys/os_mman.h"
+#include "ace/os_include/sys/os_types.h"
+
+ACE_BEGIN_VERSIONED_NAMESPACE_DECL
+
+// The definition of this class is located in Malloc.cpp.
+
+/**
+ * @class ACE_Allocator
+ *
+ * @brief Interface for a dynamic memory allocator that uses inheritance
+ * and dynamic binding to provide extensible mechanisms for
+ * allocating and deallocating memory.
+ */
+class ACE_Export ACE_Allocator
+{
+public:
+
+ /// Unsigned integer type used for specifying memory block lengths.
+ typedef size_t size_type;
+
+ // = Memory Management
+
+ /// Get pointer to a default ACE_Allocator.
+ static ACE_Allocator *instance (void);
+
+ /// Set pointer to a process-wide ACE_Allocator and return existing
+ /// pointer.
+ static ACE_Allocator *instance (ACE_Allocator *);
+
+ /// Delete the dynamically allocated Singleton
+ static void close_singleton (void);
+
+ /// "No-op" constructor (needed to make certain compilers happy).
+ ACE_Allocator (void);
+
+ /// Virtual destructor
+ virtual ~ACE_Allocator (void);
+
+ /// Allocate @a nbytes, but don't give them any initial value.
+ virtual void *malloc (size_type nbytes) = 0;
+
+ /// Allocate @a nbytes, giving them @a initial_value.
+ virtual void *calloc (size_type nbytes, char initial_value = '\0') = 0;
+
+ /// Allocate <n_elem> each of size @a elem_size, giving them
+ /// @a initial_value.
+ virtual void *calloc (size_type n_elem,
+ size_type elem_size,
+ char initial_value = '\0') = 0;
+
+ /// Free <ptr> (must have been allocated by <ACE_Allocator::malloc>).
+ virtual void free (void *ptr) = 0;
+
+ /// Remove any resources associated with this memory manager.
+ virtual int remove (void) = 0;
+
+ // = Map manager like functions
+
+ /**
+ * Associate @a name with @a pointer. If @a duplicates == 0 then do
+ * not allow duplicate @a name/@a pointer associations, else if
+ * @a duplicates != 0 then allow duplicate @a name/@a pointer
+ * assocations. Returns 0 if successfully binds (1) a previously
+ * unbound @a name or (2) @a duplicates != 0, returns 1 if trying to
+ * bind a previously bound @a name and @a duplicates == 0, else
+ * returns -1 if a resource failure occurs.
+ */
+ virtual int bind (const char *name, void *pointer, int duplicates = 0) = 0;
+
+ /**
+ * Associate @a name with @a pointer. Does not allow duplicate
+ * @a name/@a pointer associations. Returns 0 if successfully binds
+ * (1) a previously unbound @a name, 1 if trying to bind a previously
+ * bound @a name, or returns -1 if a resource failure occurs. When
+ * this call returns @a pointer's value will always reference the
+ * void * that @a name is associated with. Thus, if the caller needs
+ * to use @a pointer (e.g., to free it) a copy must be maintained by
+ * the caller.
+ */
+ virtual int trybind (const char *name, void *&pointer) = 0;
+
+ /// Locate @a name and pass out parameter via pointer. If found,
+ /// return 0, returns -1 if failure occurs.
+ virtual int find (const char *name, void *&pointer) = 0;
+
+ /// Returns 0 if the name is in the mapping. -1, otherwise.
+ virtual int find (const char *name) = 0;
+
+ /// Unbind (remove) the name from the map. Don't return the pointer
+ /// to the caller
+ virtual int unbind (const char *name) = 0;
+
+ /// Break any association of name. Returns the value of pointer in
+ /// case the caller needs to deallocate memory.
+ virtual int unbind (const char *name, void *&pointer) = 0;
+
+ // = Protection and "sync" (i.e., flushing memory to persistent
+ // backing store).
+
+ /**
+ * Sync @a len bytes of the memory region to the backing store
+ * starting at @c this->base_addr_. If @a len == -1 then sync the
+ * whole region.
+ */
+ virtual int sync (ssize_t len = -1, int flags = MS_SYNC) = 0;
+
+ /// Sync @a len bytes of the memory region to the backing store
+ /// starting at @a addr.
+ virtual int sync (void *addr, size_type len, int flags = MS_SYNC) = 0;
+
+ /**
+ * Change the protection of the pages of the mapped region to @a prot
+ * starting at <this->base_addr_> up to @a len bytes. If @a len == -1
+ * then change protection of all pages in the mapped region.
+ */
+ virtual int protect (ssize_t len = -1, int prot = PROT_RDWR) = 0;
+
+ /// Change the protection of the pages of the mapped region to @a prot
+ /// starting at @a addr up to @a len bytes.
+ virtual int protect (void *addr, size_type len, int prot = PROT_RDWR) = 0;
+
+#if defined (ACE_HAS_MALLOC_STATS)
+ /// Dump statistics of how malloc is behaving.
+ virtual void print_stats (void) const = 0;
+#endif /* ACE_HAS_MALLOC_STATS */
+
+ /// Dump the state of the object.
+ virtual void dump (void) const = 0;
+private:
+ // DO NOT ADD ANY STATE (DATA MEMBERS) TO THIS CLASS!!!! See the
+ // <ACE_Allocator::instance> implementation for explanation.
+
+ /// Pointer to a process-wide ACE_Allocator instance.
+ static ACE_Allocator *allocator_;
+
+ /// Must delete the <allocator_> if non-0.
+ static int delete_allocator_;
+};
+
+ACE_END_VERSIONED_NAMESPACE_DECL
+
+#include /**/ "ace/post.h"
+#endif /* ACE_MALLOC_BASE_H */