include/xbt/mmalloc.h

   1 /* Copyright (C) 1991, 1992 Free Software Foundation, Inc.
   2    This file was then part of the GNU C Library. */
   3
   4 /* Copyright (c) 2010-2012. The SimGrid Team.
   5  * All rights reserved.                                                     */
   6
   7 /* This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the license (GNU LGPL) which comes with this package. */
   9
  10
  11 #ifndef MMALLOC_H
  12 #define MMALLOC_H 1
  13
  14 #ifdef HAVE_STDDEF_H
  15 #  include <stddef.h>
  16 #else
  17 #  include <sys/types.h>        /* for size_t */
  18 #  include <stdio.h>            /* for NULL */
  19 #endif
  20
  21 #include "xbt/dynar.h"
  22
  23 /* Datatype representing a separate heap. The whole point of the mmalloc module
  24  * is to allow several such heaps in the process. It thus works by redefining
  25  * all the classical memory management functions (malloc and friends) with an
  26  * extra first argument: the heap in which the memory is to be taken.
  27  *
  28  * The heap structure itself is an opaque object that shouldnt be messed with.
  29  */
  30 typedef struct mdesc *xbt_mheap_t;
  31
  32 /* Allocate SIZE bytes of memory.  */
  33 extern void *mmalloc(xbt_mheap_t md, size_t size);
  34
  35 /* Re-allocate the previously allocated block in void*, making the new block
  36    SIZE bytes long.  */
  37 extern void *mrealloc(xbt_mheap_t md, void *ptr, size_t size);
  38
  39 /* Free a block allocated by `mmalloc', `mrealloc' or `mcalloc'.  */
  40 extern void mfree(xbt_mheap_t md, void *ptr);
  41
  42 /* Allocate SIZE bytes allocated to ALIGNMENT bytes.  */
  43 extern void *mmemalign(xbt_mheap_t md, size_t alignment, size_t size);
  44
  45 /* Allocate SIZE bytes on a page boundary.  */
  46 extern void *mvalloc(xbt_mheap_t md, size_t size);
  47
  48 extern xbt_mheap_t xbt_mheap_new(int fd, void *baseaddr);
  49
  50 extern void xbt_mheap_destroy_no_free(xbt_mheap_t md);
  51
  52 extern void *xbt_mheap_destroy(xbt_mheap_t md);
  53
  54 /* return the heap used when NULL is passed as first argument to any mm* function */
  55 extern xbt_mheap_t mmalloc_get_default_md(void);
  56
  57 /* To change the heap used when using the legacy version malloc/free/realloc and such */
  58 void mmalloc_set_current_heap(xbt_mheap_t new_heap);
  59 xbt_mheap_t mmalloc_get_current_heap(void);
  60
  61 int mmalloc_compare_heap(xbt_mheap_t heap1, xbt_mheap_t heap2, xbt_dynar_t *stacks1, xbt_dynar_t *stacks2, xbt_dynar_t *equals);
  62 int mmalloc_linear_compare_heap(xbt_mheap_t heap1, xbt_mheap_t heap2);
  63
  64 void mmalloc_backtrace_block_display(void* heapinfo, int block);
  65 void mmalloc_backtrace_fragment_display(void* heapinfo, int block, int frag);
  66
  67 int is_free_area(void *area, xbt_mheap_t heap);
  68
  69
  70
  71 #endif                          /* MMALLOC_H */