1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
/* -*- C++ -*- */
// $Id$
// ============================================================================
//
// = LIBRARY
// ace
//
// = FILENAME
// Malloc.h
//
// = AUTHOR
// Doug Schmidt and Irfan Pyarali
//
// ============================================================================
#if !defined (ACE_MALLOC_H)
#define ACE_MALLOC_H
#include "ace/ACE.h"
class ACE_Export ACE_Allocator
// = TITLE
// Interface for a dynamic memory allocator that uses inheritance
// and dynamic binding to provide extensible mechanisms for
// allocating and deallocating memory.
{
public:
// = Memory Management
virtual void *malloc (size_t nbytes) = 0;
// Allocate <nbytes>, but don't give them any initial value.
virtual void *calloc (size_t nbytes, char initial_value = '\0') = 0;
// Allocate <nbytes>, giving them <initial_value>.
virtual void free (void *ptr) = 0;
// Free <ptr> (must have been allocated by <ACE_Allocator::malloc>).
virtual int remove (void) = 0;
// Remove any resources associated with this memory manager.
// = Map manager like functions
virtual int bind (const char *name, void *pointer, int duplicates = 0) = 0;
// Associate <name> with <pointer>. If <duplicates> == 0 then do
// not allow duplicate <name>/<pointer> associations, else if
// <duplicates> != 0 then allow duplicate <name>/<pointer>
// assocations. Returns 0 if successfully binds (1) a previously
// unbound <name> or (2) <duplicates> != 0, returns 1 if trying to
// bind a previously bound <name> and <duplicates> == 0, else
// returns -1 if a resource failure occurs.
virtual int trybind (const char *name, void *&pointer) = 0;
// Associate <name> with <pointer>. Does not allow duplicate
// <name>/<pointer> associations. Returns 0 if successfully binds
// (1) a previously unbound <name>, 1 if trying to bind a previously
// bound <name>, or returns -1 if a resource failure occurs. When
// this call returns <pointer>'s value will always reference the
// void * that <name> is associated with. Thus, if the caller needs
// to use <pointer> (e.g., to free it) a copy must be maintained by
// the caller.
virtual int find (const char *name, void *&pointer) = 0;
// Locate <name> and pass out parameter via pointer. If found,
// return 0, Returns -1 if failure occurs.
virtual int find (const char *name) = 0;
// returns 0 if the name is in the mapping. -1, otherwise.
virtual int unbind (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, void *&pointer) = 0;
// Break any association of name. Returns the value of pointer in
// case the caller needs to deallocate memory.
// = Protection and "sync" (i.e., flushing memory to persistent
// backing store).
virtual int sync (ssize_t len = -1, int flags = MS_SYNC) = 0;
// Sync <len> bytes of the memory region to the backing store
// starting at <this->base_addr_>. If <len> == -1 then sync the
// whole region.
virtual int sync (void *addr, size_t len, int flags = MS_SYNC) = 0;
// Sync <len> bytes of the memory region to the backing store
// starting at <addr_>.
virtual int protect (ssize_t len = -1, int prot = PROT_RDWR) = 0;
// Change the protection of the pages of the mapped region to <prot>
// starting at <this->base_addr_> up to <len> bytes. If <len> == -1
// then change protection of all pages in the mapped region.
virtual int protect (void *addr, size_t len, int prot = PROT_RDWR) = 0;
// Change the protection of the pages of the mapped region to <prot>
// starting at <addr> up to <len> bytes.
virtual void dump (void) const = 0;
// Dump the state of the object.
};
typedef long ACE_Malloc_Align;
// For alignment to long boundary
union ACE_Export ACE_Malloc_Header
// TITLE
// This is a block header.
{
struct ACE_Malloc_Control_Block
{
ACE_Malloc_Header *next_block_;
// Points to next block if on free list.
size_t size_;
// Size of this block.
} s_;
ACE_Malloc_Align x_;
// Force alignment.
};
class ACE_Export ACE_Name_Node
// = TITLE
// This is stored as a linked list within the Memory_Pool
// to allow "named memory chunks."
{
public:
// = Initialization methods.
ACE_Name_Node (const char *name, void *, ACE_Name_Node *);
ACE_Name_Node (void);
char *name_;
// Name of the Node.
void *pointer_;
// Pointer to the contents.
ACE_Name_Node *next_;
// Pointer to the next node in the chain.
void dump (void) const;
// Dump the state of the object.
};
class ACE_Export ACE_Control_Block
// = TITLE
// This information is stored in memory allocated by the MEMORY_POOL.
//
// = DESCRIPTION
// This class should be local to class ACE_Malloc, but cfront and
// G++ don't like nested classes in templates...
{
public:
ACE_Name_Node *name_head_;
// Head of the linked list of Name Nodes.
ACE_Malloc_Header *freep_;
// Current head of the freelist.
char lock_name_[MAXNAMELEN];
// Name of lock thats ensures mutual exclusion.
#if defined (ACE_MALLOC_STATS)
// Keep statistics about ACE_Malloc state and performance.
ACE_Malloc_Stats malloc_stats_;
#endif /* ACE_MALLOC_STATS */
ACE_Malloc_Header base_;
// Dummy node used to anchor the freelist.
void dump (void) const;
// Dump the state of the object.
};
#if defined (ACE_MALLOC_STATS)
#include "ace/Sync_T.h"
#if defined (ACE_HAS_THREADS)
#define ACE_PROCESS_MUTEX ACE_Process_Mutex
#else
#include "ace/SV_Semaphore_Simple.h"
#define ACE_PROCESS_MUTEX ACE_SV_Semaphore_Simple
#endif /* ACE_HAS_THREADS */
typedef ACE_Atomic_Op<ACE_PROCESS_MUTEX, int> ACE_INT;
struct ACE_Export ACE_Malloc_Stats
// TITLE
// This keeps stats on the usage of the memory manager.
{
ACE_Malloc_Stats (void);
void dump (void) const;
ACE_INT nchunks_;
// Coarse-grained unit of allocation.
ACE_INT nblocks_;
// Fine-grained unit of allocation.
ACE_INT ninuse_;
// Number of blocks in use
};
#define AMS(X) X
#else
#define AMS(X)
#endif /* ACE_MALLOC_STATS */
#if defined (__ACE_INLINE__)
#include "ace/Malloc.i"
#endif /* __ACE_INLINE__ */
// Include the ACE_Malloc templates and ACE_Memory_Pool stuff at this point.
#include "ace/Malloc_T.h"
#include "ace/Memory_Pool.h"
#endif /* ACE_MALLOC_H */
|