Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
[mc] Comments/documentation of memory related code
[simgrid.git] / src / xbt / mmalloc / mmalloc.c
1 /* Memory allocator `malloc'. */
2
3 /* Copyright (c) 2010-2014. The SimGrid Team.
4  * All rights reserved.                                                     */
5
6 /* This program is free software; you can redistribute it and/or modify it
7  * under the terms of the license (GNU LGPL) which comes with this package. */
8
9 /* Copyright 1990, 1991, 1992 Free Software Foundation
10
11    Written May 1989 by Mike Haertel.
12    Heavily modified Mar 1992 by Fred Fish for mmap'd version. */
13
14 #include <string.h>             /* Prototypes for memcpy, memmove, memset, etc */
15 #include <stdio.h>
16 #include "mmprivate.h"
17
18 /* Prototypes for local functions */
19
20 static void initialize(xbt_mheap_t mdp);
21 static void *register_morecore(xbt_mheap_t mdp, size_t size);
22 static void *align(xbt_mheap_t mdp, size_t size);
23
24 /* Allocation aligned on block boundary.
25  *
26  * It never returns NULL, but dies verbosely on error.
27  */
28 static void *align(struct mdesc *mdp, size_t size)
29 {
30   void *result;
31   unsigned long int adj;
32
33   result = mmorecore(mdp, size);
34
35   /* if this reservation does not fill up the last block of our resa,
36    * complete the reservation by also asking for the full latest block.
37    *
38    * Also, the returned block is aligned to the end of block (but I've
39    * no fucking idea of why, actually -- http://abstrusegoose.com/432 --
40    * but not doing so seems to lead to issues).
41    */
42   adj = RESIDUAL(result, BLOCKSIZE);
43   if (adj != 0) {
44     adj = BLOCKSIZE - adj;
45     mmorecore(mdp, adj);
46     result = (char *) result + adj;
47   }
48   return (result);
49 }
50
51 /* Finish the initialization of the mheap. If we want to inline it
52  * properly, we need to make the align function publicly visible, too  */
53 static void initialize(xbt_mheap_t mdp)
54 {
55   int i;
56   malloc_info mi; /* to compute the offset of the swag hook */
57
58   mdp->heapsize = HEAP / BLOCKSIZE;
59   mdp->heapinfo = (malloc_info *)
60     align(mdp, mdp->heapsize * sizeof(malloc_info));
61
62   memset((void *) mdp->heapinfo, 0, mdp->heapsize * sizeof(malloc_info));
63   mdp->heapinfo[0].type=-1;
64   mdp->heapinfo[0].free_block.size = 0;
65   mdp->heapinfo[0].free_block.next = mdp->heapinfo[0].free_block.prev = 0;
66   mdp->heapindex = 0;
67   mdp->heapbase = (void *) mdp->heapinfo;
68   mdp->flags |= MMALLOC_INITIALIZED;
69
70   for (i=0;i<BLOCKLOG;i++) {
71       xbt_swag_init(&(mdp->fraghead[i]),
72                     xbt_swag_offset(mi, freehook));
73   }
74 }
75
76 #define update_hook(a,offset) do { if (a) { a = ((char*)a +(offset));} }while(0)
77
78 /* Get neatly aligned memory from the low level layers, and register it
79  * into the heap info table as necessary. */
80 static void *register_morecore(struct mdesc *mdp, size_t size)
81 {
82   int i;
83   void *result;
84   malloc_info *newinfo, *oldinfo;
85   size_t newsize;
86
87   result = align(mdp, size); // Never returns NULL
88
89   /* Check if we need to grow the info table (in a multiplicative manner)  */
90   if ((size_t) BLOCK((char *) result + size) > mdp->heapsize) {
91     int it;
92
93     newsize = mdp->heapsize;
94     while ((size_t) BLOCK((char *) result + size) > newsize)
95       newsize *= 2;
96
97     /* Copy old info into new location */
98     oldinfo = mdp->heapinfo;
99     newinfo = (malloc_info *) align(mdp, newsize * sizeof(malloc_info));
100     memset(newinfo, 0, newsize * sizeof(malloc_info));
101     memcpy(newinfo, oldinfo, mdp->heapsize * sizeof(malloc_info));
102
103     /* Update the swag of busy blocks containing free fragments by applying the offset to all swag_hooks. Yeah. My hand is right in the fan and I still type */
104     size_t offset=((char*)newinfo)-((char*)oldinfo);
105
106     for (i=1/*first element of heapinfo describes the mdesc area*/;
107          i<mdp->heaplimit;
108          i++) {
109       update_hook(newinfo[i].freehook.next,offset);
110       update_hook(newinfo[i].freehook.prev,offset);
111     }
112     // also update the starting points of the swag
113     for (i=0;i<BLOCKLOG;i++) {
114       update_hook(mdp->fraghead[i].head,offset);
115       update_hook(mdp->fraghead[i].tail,offset);
116     }
117     mdp->heapinfo = newinfo;
118
119     /* mark the space previously occupied by the block info as free by first marking it
120      * as occupied in the regular way, and then freing it */
121     for (it=0; it<BLOCKIFY(mdp->heapsize * sizeof(malloc_info)); it++){
122       newinfo[BLOCK(oldinfo)+it].type = 0;
123       newinfo[BLOCK(oldinfo)+it].busy_block.ignore = 0;
124     }
125
126     newinfo[BLOCK(oldinfo)].busy_block.size = BLOCKIFY(mdp->heapsize * sizeof(malloc_info));
127     newinfo[BLOCK(oldinfo)].busy_block.busy_size = size;
128     mfree(mdp, (void *) oldinfo);
129     mdp->heapsize = newsize;
130   }
131
132   mdp->heaplimit = BLOCK((char *) result + size);
133   return (result);
134 }
135 #undef update_hook
136
137 /* Allocate memory from the heap.  */
138 void *mmalloc(xbt_mheap_t mdp, size_t size) {
139   void *res= mmalloc_no_memset(mdp,size);
140 //  fprintf(stderr,"malloc(%zu)~>%p\n",size,res);
141   memset(res,0,size);
142   return res;
143 }
144 /* Spliting mmalloc this way is mandated by a trick in mrealloc, that gives
145    back the memory of big blocks to the system before reallocating them: we don't
146    want to loose the beginning of the area when this happens */
147 void *mmalloc_no_memset(xbt_mheap_t mdp, size_t size)
148 {
149   void *result;
150   size_t block, blocks, lastblocks, start;
151   register size_t i;
152   register size_t log;
153   int it;
154
155   size_t requested_size = size; // The amount of memory requested by user, for real
156
157   /* Work even if the user was stupid enough to ask a ridicullously small block (even 0-length),
158    *    ie return a valid block that can be realloced and freed.
159    * glibc malloc does not use this trick but return a constant pointer, but we need to enlist the free fragments later on.
160    */
161   if (size < SMALLEST_POSSIBLE_MALLOC)
162     size = SMALLEST_POSSIBLE_MALLOC;
163
164   //  printf("(%s) Mallocing %d bytes on %p (default: %p)...",xbt_thread_self_name(),size,mdp,__mmalloc_default_mdp);fflush(stdout);
165
166   if (!(mdp->flags & MMALLOC_INITIALIZED))
167     initialize(mdp);
168
169   mmalloc_paranoia(mdp);
170
171   /* Determine the allocation policy based on the request size.  */
172   if (size <= BLOCKSIZE / 2) {
173     /* Small allocation to receive a fragment of a block.
174        Determine the logarithm to base two of the fragment size. */
175     log = 1;
176     --size;
177     while ((size /= 2) != 0) {
178       ++log;
179     }
180
181     /* Look in the fragment lists for a free fragment of the desired size. */
182     if (xbt_swag_size(&mdp->fraghead[log])>0) {
183       /* There are free fragments of this size; Get one of them and prepare to return it.
184          Update the block's nfree and if no other free fragment, get out of the swag. */
185
186       /* search a fragment that I could return as a result */
187       malloc_info *candidate_info = xbt_swag_getFirst(&mdp->fraghead[log]);
188       size_t candidate_block = (candidate_info - &(mdp->heapinfo[0]));
189       size_t candidate_frag;
190       for (candidate_frag=0;candidate_frag<(size_t) (BLOCKSIZE >> log);candidate_frag++)
191         if (candidate_info->busy_frag.frag_size[candidate_frag] == -1)
192           break;
193       xbt_assert(candidate_frag < (size_t) (BLOCKSIZE >> log),
194           "Block %zu was registered as containing free fragments of type %zu, but I can't find any",candidate_block,log);
195
196       result = (void*) (((char*)ADDRESS(candidate_block)) + (candidate_frag << log));
197
198       /* Remove this fragment from the list of free guys */
199       candidate_info->busy_frag.nfree--;
200       if (candidate_info->busy_frag.nfree == 0) {
201         xbt_swag_remove(candidate_info,&mdp->fraghead[log]);
202       }
203
204       /* Update our metadata about this fragment */
205       candidate_info->busy_frag.frag_size[candidate_frag] = requested_size;
206       candidate_info->busy_frag.ignore[candidate_frag] = 0;
207       //xbt_backtrace_no_malloc(candidate_info->busy_frag.bt[candidate_frag],XBT_BACKTRACE_SIZE);
208       //xbt_libunwind_backtrace(candidate_info->busy_frag.bt[candidate_frag],XBT_BACKTRACE_SIZE);
209
210       /* Update the statistics.  */
211       mdp -> heapstats.chunks_used++;
212       mdp -> heapstats.bytes_used += 1 << log;
213       mdp -> heapstats.chunks_free--;
214       mdp -> heapstats.bytes_free -= 1 << log;
215
216     } else {
217       /* No free fragments of the desired size, so get a new block
218          and break it into fragments, returning the first.  */
219
220       result = mmalloc(mdp, BLOCKSIZE); // does not return NULL
221       block = BLOCK(result);
222
223       mdp->heapinfo[block].type = log;
224       /* Link all fragments but the first as free, and add the block to the swag of blocks containing free frags  */
225       for (i = 1; i < (size_t) (BLOCKSIZE >> log); ++i) {
226         mdp->heapinfo[block].busy_frag.frag_size[i] = -1;
227         mdp->heapinfo[block].busy_frag.ignore[i] = 0;
228       }
229       mdp->heapinfo[block].busy_frag.nfree = i - 1;
230       mdp->heapinfo[block].freehook.prev = NULL;
231       mdp->heapinfo[block].freehook.next = NULL;
232
233       xbt_swag_insert(&mdp->heapinfo[block], &(mdp->fraghead[log]));
234
235       /* mark the fragment returned as busy */
236       mdp->heapinfo[block].busy_frag.frag_size[0] = requested_size;
237       mdp->heapinfo[block].busy_frag.ignore[0] = 0;
238       //xbt_backtrace_no_malloc(mdp->heapinfo[block].busy_frag.bt[0],XBT_BACKTRACE_SIZE);
239       //xbt_libunwind_backtrace(mdp->heapinfo[block].busy_frag.bt[0],XBT_BACKTRACE_SIZE);
240       
241       /* update stats */
242       mdp -> heapstats.chunks_free += (BLOCKSIZE >> log) - 1;
243       mdp -> heapstats.bytes_free += BLOCKSIZE - (1 << log);
244       mdp -> heapstats.bytes_used -= BLOCKSIZE - (1 << log);
245     }
246   } else {
247     /* Large allocation to receive one or more blocks.
248        Search the free list in a circle starting at the last place visited.
249        If we loop completely around without finding a large enough
250        space we will have to get more memory from the system.  */
251     blocks = BLOCKIFY(size);
252     start = block = MALLOC_SEARCH_START;
253     while (mdp->heapinfo[block].free_block.size < blocks) {
254       if (mdp->heapinfo[block].type >=0) { // Don't trust xbt_die and friends in malloc-level library, you fool!
255         fprintf(stderr,"Internal error: found a free block not marked as such (block=%lu type=%lu). Please report this bug.\n",(unsigned long)block,(unsigned long)mdp->heapinfo[block].type);
256         abort();
257       }
258
259       block = mdp->heapinfo[block].free_block.next;
260       if (block == start) {
261         /* Need to get more from the system.  Check to see if
262            the new core will be contiguous with the final free
263            block; if so we don't need to get as much.  */
264         block = mdp->heapinfo[0].free_block.prev;
265         lastblocks = mdp->heapinfo[block].free_block.size;
266         if (mdp->heaplimit != 0 &&
267             block + lastblocks == mdp->heaplimit &&
268             mmorecore(mdp, 0) == ADDRESS(block + lastblocks) &&
269             (register_morecore(mdp, (blocks - lastblocks) * BLOCKSIZE)) != NULL) {
270           /* Which block we are extending (the `final free
271              block' referred to above) might have changed, if
272              it got combined with a freed info table.  */
273           block = mdp->heapinfo[0].free_block.prev;
274
275           mdp->heapinfo[block].free_block.size += (blocks - lastblocks);
276           continue;
277         }
278         result = register_morecore(mdp, blocks * BLOCKSIZE);
279
280         block = BLOCK(result);
281         for (it=0;it<blocks;it++){
282           mdp->heapinfo[block+it].type = 0;
283           mdp->heapinfo[block+it].busy_block.busy_size = 0;
284           mdp->heapinfo[block+it].busy_block.ignore = 0;
285         }
286         mdp->heapinfo[block].busy_block.size = blocks;
287         mdp->heapinfo[block].busy_block.busy_size = requested_size;
288         //mdp->heapinfo[block].busy_block.bt_size=xbt_backtrace_no_malloc(mdp->heapinfo[block].busy_block.bt,XBT_BACKTRACE_SIZE);
289         //mdp->heapinfo[block].busy_block.bt_size = xbt_libunwind_backtrace(mdp->heapinfo[block].busy_block.bt,XBT_BACKTRACE_SIZE);
290         mdp -> heapstats.chunks_used++;
291         mdp -> heapstats.bytes_used += blocks * BLOCKSIZE;
292
293         return result;
294       }
295       /* Need large block(s), but found some in the existing heap */
296     }
297
298     /* At this point we have found a suitable free list entry.
299        Figure out how to remove what we need from the list. */
300     result = ADDRESS(block);
301     if (mdp->heapinfo[block].free_block.size > blocks) {
302       /* The block we found has a bit left over,
303          so relink the tail end back into the free list. */
304       mdp->heapinfo[block + blocks].free_block.size
305         = mdp->heapinfo[block].free_block.size - blocks;
306       mdp->heapinfo[block + blocks].free_block.next
307         = mdp->heapinfo[block].free_block.next;
308       mdp->heapinfo[block + blocks].free_block.prev
309         = mdp->heapinfo[block].free_block.prev;
310       mdp->heapinfo[mdp->heapinfo[block].free_block.prev].free_block.next
311         = mdp->heapinfo[mdp->heapinfo[block].free_block.next].free_block.prev
312         = mdp->heapindex = block + blocks;
313     } else {
314       /* The block exactly matches our requirements,
315          so just remove it from the list. */
316       mdp->heapinfo[mdp->heapinfo[block].free_block.next].free_block.prev
317         = mdp->heapinfo[block].free_block.prev;
318       mdp->heapinfo[mdp->heapinfo[block].free_block.prev].free_block.next
319         = mdp->heapindex = mdp->heapinfo[block].free_block.next;
320     }
321
322     for (it=0;it<blocks;it++){
323       mdp->heapinfo[block+it].type = 0;
324       mdp->heapinfo[block+it].busy_block.busy_size = 0;
325       mdp->heapinfo[block+it].busy_block.ignore = 0;
326     }
327     mdp->heapinfo[block].busy_block.size = blocks;
328     mdp->heapinfo[block].busy_block.busy_size = requested_size; 
329     //mdp->heapinfo[block].busy_block.bt_size = xbt_backtrace_no_malloc(mdp->heapinfo[block].busy_block.bt,XBT_BACKTRACE_SIZE);
330     //mdp->heapinfo[block].busy_block.bt_size = xbt_libunwind_backtrace(mdp->heapinfo[block].busy_block.bt,XBT_BACKTRACE_SIZE);
331     
332     mdp -> heapstats.chunks_used++;
333     mdp -> heapstats.bytes_used += blocks * BLOCKSIZE;
334     mdp -> heapstats.bytes_free -= blocks * BLOCKSIZE;
335
336   }
337   //printf("(%s) Done mallocing. Result is %p\n",xbt_thread_self_name(),result);fflush(stdout);
338
339   return (result);
340 }