tlsf/Readme.txt

   1 Two Level Segregated Fit memory allocator implementation.\r
   2 Written by Matthew Conte (matt@baisoku.org).\r
   3 Public Domain, no restrictions.\r
   4 \r
   5         http://tlsf.baisoku.org\r
   6 \r
   7 Features\r
   8 --------\r
   9 * O(1) cost for malloc, free, realloc, memalign\r
  10 * Extremely low overhead per allocation (4 bytes)\r
  11 * Low overhead per TLSF management of pools (~3kB)\r
  12 * Low fragmentation\r
  13 * Compiles to only a few kB of code and data\r
  14 * Support for adding and removing memory pool regions on the fly\r
  15 \r
  16 Caveats\r
  17 -------\r
  18 * Currently, assumes architecture can make 4-byte aligned accesses\r
  19 * Not designed to be thread safe; the user must provide this\r
  20 \r
  21 Notes\r
  22 -----\r
  23 This code was based on the TLSF 1.4 spec and documentation found at:\r
  24 \r
  25         http://rtportal.upv.es/rtmalloc/allocators/tlsf/index.shtml\r
  26 \r
  27 It also leverages the TLSF 2.0 improvement to shrink the per-block overhead\r
  28 from 8 to 4 bytes.\r
  29 \r
  30 Known Issues\r
  31 ------------\r
  32 * Due to the internal block structure size and the implementation\r
  33 details of tlsf_memalign, there is worst-case behavior when requesting\r
  34 small (<16 byte) blocks aligned to 8-byte boundaries. Overuse of memalign\r
  35 will generally increase fragmentation, but this particular case will leave\r
  36 lots of unusable "holes" in the pool. The solution would be to internally\r
  37 align all blocks to 8 bytes, but this will require significantl changes\r
  38 to the implementation. Contact me if you are interested.\r
  39 \r
  40 History\r
  41 -------\r
  42 2014/02/08 - v3.0\r
  43    * This version is based on improvements from 3DInteractive GmbH\r
  44    * Interface changed to allow more than one memory pool\r
  45    * Separated pool handling from control structure (adding, removing, debugging)\r
  46    * Control structure and pools can still be constructed in the same memory block\r
  47    * Memory blocks for control structure and pools are checked for alignment\r
  48    * Added functions to retrieve control structure size, alignment size, min and\r
  49      max block size, overhead of pool structure, and overhead of a single allocation\r
  50    * Minimal Pool size is tlsf_block_size_min() + tlsf_pool_overhead()\r
  51    * Pool must be empty when it is removed, in order to allow O(1) removal\r
  52 \r
  53 2011/10/20 - v2.0\r
  54    * 64-bit support\r
  55    * More compiler intrinsics for ffs/fls\r
  56    * ffs/fls verification during TLSF creation in debug builds\r
  57 \r
  58 2008/04/04 - v1.9\r
  59    * Add tlsf_heap_check, a heap integrity check\r
  60    * Support a predefined tlsf_assert macro\r
  61    * Fix realloc case where block should shrink; if adjacent block is\r
  62      in use, execution would go down the slow path\r
  63 \r
  64 2007/02/08 - v1.8\r
  65    * Fix for unnecessary reallocation in tlsf_realloc\r
  66 \r
  67 2007/02/03 - v1.7\r
  68    * tlsf_heap_walk takes a callback\r
  69    * tlsf_realloc now returns NULL on failure\r
  70    * tlsf_memalign optimization for 4-byte alignment\r
  71    * Usage of size_t where appropriate\r
  72 \r
  73 2006/11/21 - v1.6\r
  74    * ffs/fls broken out into tlsfbits.h\r
  75    * tlsf_overhead queries per-pool overhead\r
  76 \r
  77 2006/11/07 - v1.5\r
  78    * Smart realloc implementation\r
  79    * Smart memalign implementation\r
  80 \r
  81 2006/10/11 - v1.4\r
  82    * Add some ffs/fls implementations\r
  83    * Minor code footprint reduction\r
  84 \r
  85 2006/09/14 - v1.3\r
  86    * Profiling indicates heavy use of blocks of\r
  87      size 1-128, so implement small block handling\r
  88    * Reduce pool overhead by about 1kb\r
  89    * Reduce minimum block size from 32 to 12 bytes\r
  90    * Realloc bug fix\r
  91 \r
  92 2006/09/09 - v1.2\r
  93    * Add tlsf_block_size\r
  94    * Static assertion mechanism for invariants\r
  95    * Minor bugfixes \r
  96 \r
  97 2006/09/01 - v1.1\r
  98    * Add tlsf_realloc\r
  99    * Add tlsf_walk_heap\r
 100 \r
 101 2006/08/25 - v1.0\r
 102    * First release\r