ucw/mempool.c

   1 /*
   2  *      UCW Library -- Memory Pools (One-Time Allocation)
   3  *
   4  *      (c) 1997--2014 Martin Mares <mj@ucw.cz>
   5  *      (c) 2007--2014 Pavel Charvat <pchar@ucw.cz>
   6  *
   7  *      This software may be freely distributed and used according to the terms
   8  *      of the GNU Lesser General Public License.
   9  */
  10
  11 #undef LOCAL_DEBUG
  12
  13 #include <ucw/lib.h>
  14 #include <ucw/alloc.h>
  15 #include <ucw/mempool.h>
  16
  17 #include <string.h>
  18
  19 #define MP_CHUNK_TAIL ALIGN_TO(sizeof(struct mempool_chunk), CPU_STRUCT_ALIGN)
  20 #define MP_SIZE_MAX (~0U - MP_CHUNK_TAIL - CPU_PAGE_SIZE)
  21
  22 struct mempool_chunk {
  23 #ifdef CONFIG_DEBUG
  24   struct mempool *pool;         // Can be useful when analysing coredump for memory leaks
  25 #endif
  26   struct mempool_chunk *next;
  27   uns size;
  28 };
  29
  30 static uns
  31 mp_align_size(uns size)
  32 {
  33 #ifdef CONFIG_UCW_POOL_IS_MMAP
  34   return ALIGN_TO(size + MP_CHUNK_TAIL, CPU_PAGE_SIZE) - MP_CHUNK_TAIL;
  35 #else
  36   return ALIGN_TO(size, CPU_STRUCT_ALIGN);
  37 #endif
  38 }
  39
  40 static void *mp_allocator_alloc(struct ucw_allocator *a, size_t size)
  41 {
  42   struct mempool *mp = (struct mempool *) a;
  43   return mp_alloc_fast(mp, size);
  44 }
  45
  46 static void *mp_allocator_realloc(struct ucw_allocator *a, void *ptr, size_t old_size, size_t new_size)
  47 {
  48   if (new_size <= old_size)
  49     return ptr;
  50
  51   /*
  52    *  In the future, we might want to do something like mp_realloc(),
  53    *  but we have to check that it is indeed the last block in the pool.
  54    */
  55   struct mempool *mp = (struct mempool *) a;
  56   void *new = mp_alloc_fast(mp, new_size);
  57   memcpy(new, ptr, old_size);
  58   return new;
  59 }
  60
  61 static void mp_allocator_free(struct ucw_allocator *a UNUSED, void *ptr UNUSED)
  62 {
  63   // Does nothing
  64 }
  65
  66 void
  67 mp_init(struct mempool *pool, uns chunk_size)
  68 {
  69   chunk_size = mp_align_size(MAX(sizeof(struct mempool), chunk_size));
  70   *pool = (struct mempool) {
  71     .allocator = {
  72       .alloc = mp_allocator_alloc,
  73       .realloc = mp_allocator_realloc,
  74       .free = mp_allocator_free,
  75     },
  76     .chunk_size = chunk_size,
  77     .threshold = chunk_size >> 1,
  78     .last_big = &pool->last_big
  79   };
  80 }
  81
  82 static void *
  83 mp_new_big_chunk(struct mempool *pool, uns size)
  84 {
  85   struct mempool_chunk *chunk;
  86   chunk = xmalloc(size + MP_CHUNK_TAIL) + size;
  87   chunk->size = size;
  88   if (pool)
  89     pool->total_size += size + MP_CHUNK_TAIL;
  90   return chunk;
  91 }
  92
  93 static void
  94 mp_free_big_chunk(struct mempool *pool, struct mempool_chunk *chunk)
  95 {
  96   pool->total_size -= chunk->size + MP_CHUNK_TAIL;
  97   xfree((void *)chunk - chunk->size);
  98 }
  99
 100 static void *
 101 mp_new_chunk(struct mempool *pool, uns size)
 102 {
 103 #ifdef CONFIG_UCW_POOL_IS_MMAP
 104   struct mempool_chunk *chunk;
 105   chunk = page_alloc(size + MP_CHUNK_TAIL) + size;
 106   chunk->size = size;
 107   if (pool)
 108     pool->total_size += size + MP_CHUNK_TAIL;
 109   return chunk;
 110 #else
 111   return mp_new_big_chunk(pool, size);
 112 #endif
 113 }
 114
 115 static void
 116 mp_free_chunk(struct mempool *pool, struct mempool_chunk *chunk)
 117 {
 118 #ifdef CONFIG_UCW_POOL_IS_MMAP
 119   pool->total_size -= chunk->size + MP_CHUNK_TAIL;
 120   page_free((void *)chunk - chunk->size, chunk->size + MP_CHUNK_TAIL);
 121 #else
 122   mp_free_big_chunk(pool, chunk);
 123 #endif
 124 }
 125
 126 struct mempool *
 127 mp_new(uns chunk_size)
 128 {
 129   chunk_size = mp_align_size(MAX(sizeof(struct mempool), chunk_size));
 130   struct mempool_chunk *chunk = mp_new_chunk(NULL, chunk_size);
 131   struct mempool *pool = (void *)chunk - chunk_size;
 132   DBG("Creating mempool %p with %u bytes long chunks", pool, chunk_size);
 133   chunk->next = NULL;
 134 #ifdef CONFIG_DEBUG
 135   chunk->pool = pool;
 136 #endif
 137   *pool = (struct mempool) {
 138     .allocator = {
 139       .alloc = mp_allocator_alloc,
 140       .realloc = mp_allocator_realloc,
 141       .free = mp_allocator_free,
 142     },
 143     .state = { .free = { chunk_size - sizeof(*pool) }, .last = { chunk } },
 144     .chunk_size = chunk_size,
 145     .threshold = chunk_size >> 1,
 146     .last_big = &pool->last_big,
 147     .total_size = chunk->size + MP_CHUNK_TAIL,
 148   };
 149   return pool;
 150 }
 151
 152 static void
 153 mp_free_chain(struct mempool *pool, struct mempool_chunk *chunk)
 154 {
 155   while (chunk)
 156     {
 157       struct mempool_chunk *next = chunk->next;
 158       mp_free_chunk(pool, chunk);
 159       chunk = next;
 160     }
 161 }
 162
 163 static void
 164 mp_free_big_chain(struct mempool *pool, struct mempool_chunk *chunk)
 165 {
 166   while (chunk)
 167     {
 168       struct mempool_chunk *next = chunk->next;
 169       mp_free_big_chunk(pool, chunk);
 170       chunk = next;
 171     }
 172 }
 173
 174 void
 175 mp_delete(struct mempool *pool)
 176 {
 177   DBG("Deleting mempool %p", pool);
 178   mp_free_big_chain(pool, pool->state.last[1]);
 179   mp_free_chain(pool, pool->unused);
 180   mp_free_chain(pool, pool->state.last[0]); // can contain the mempool structure
 181 }
 182
 183 void
 184 mp_flush(struct mempool *pool)
 185 {
 186   mp_free_big_chain(pool, pool->state.last[1]);
 187   struct mempool_chunk *chunk, *next;
 188   for (chunk = pool->state.last[0]; chunk && (void *)chunk - chunk->size != pool; chunk = next)
 189     {
 190       next = chunk->next;
 191       chunk->next = pool->unused;
 192       pool->unused = chunk;
 193     }
 194   pool->state.last[0] = chunk;
 195   pool->state.free[0] = chunk ? chunk->size - sizeof(*pool) : 0;
 196   pool->state.last[1] = NULL;
 197   pool->state.free[1] = 0;
 198   pool->state.next = NULL;
 199   pool->last_big = &pool->last_big;
 200 }
 201
 202 static void
 203 mp_stats_chain(struct mempool_chunk *chunk, struct mempool_stats *stats, uns idx)
 204 {
 205   while (chunk)
 206     {
 207       stats->chain_size[idx] += chunk->size + MP_CHUNK_TAIL;
 208       stats->chain_count[idx]++;
 209       chunk = chunk->next;
 210     }
 211   stats->total_size += stats->chain_size[idx];
 212 }
 213
 214 void
 215 mp_stats(struct mempool *pool, struct mempool_stats *stats)
 216 {
 217   bzero(stats, sizeof(*stats));
 218   mp_stats_chain(pool->state.last[0], stats, 0);
 219   mp_stats_chain(pool->state.last[1], stats, 1);
 220   mp_stats_chain(pool->unused, stats, 2);
 221   ASSERT(stats->total_size == pool->total_size);
 222   stats->used_size = stats->chain_size[0] + stats->chain_size[1]
 223     - MP_CHUNK_TAIL * (stats->chain_count[0] + stats->chain_count[1])
 224     - pool->state.free[0] - pool->state.free[1] - sizeof(*pool);
 225   ASSERT(stats->used_size < stats->total_size);
 226 }
 227
 228 u64
 229 mp_total_size(struct mempool *pool)
 230 {
 231   return pool->total_size;
 232 }
 233
 234 void
 235 mp_shrink(struct mempool *pool, u64 min_total_size)
 236 {
 237   while (1)
 238     {
 239       struct mempool_chunk *chunk = pool->unused;
 240       if (!chunk || pool->total_size - (chunk->size + MP_CHUNK_TAIL) < min_total_size)
 241         break;
 242       pool->unused = chunk->next;
 243       mp_free_chunk(pool, chunk);
 244     }
 245 }
 246
 247 void *
 248 mp_alloc_internal(struct mempool *pool, uns size)
 249 {
 250   struct mempool_chunk *chunk;
 251   if (size <= pool->threshold)
 252     {
 253       pool->idx = 0;
 254       if (pool->unused)
 255         {
 256           chunk = pool->unused;
 257           pool->unused = chunk->next;
 258         }
 259       else
 260         {
 261           chunk = mp_new_chunk(pool, pool->chunk_size);
 262 #ifdef CONFIG_DEBUG
 263           chunk->pool = pool;
 264 #endif
 265         }
 266       chunk->next = pool->state.last[0];
 267       pool->state.last[0] = chunk;
 268       pool->state.free[0] = pool->chunk_size - size;
 269       return (void *)chunk - pool->chunk_size;
 270     }
 271   else if (likely(size <= MP_SIZE_MAX))
 272     {
 273       pool->idx = 1;
 274       uns aligned = ALIGN_TO(size, CPU_STRUCT_ALIGN);
 275       chunk = mp_new_big_chunk(pool, aligned);
 276       chunk->next = pool->state.last[1];
 277 #ifdef CONFIG_DEBUG
 278       chunk->pool = pool;
 279 #endif
 280       pool->state.last[1] = chunk;
 281       pool->state.free[1] = aligned - size;
 282       return pool->last_big = (void *)chunk - aligned;
 283     }
 284   else
 285     die("Cannot allocate %u bytes from a mempool", size);
 286 }
 287
 288 void *
 289 mp_alloc(struct mempool *pool, uns size)
 290 {
 291   return mp_alloc_fast(pool, size);
 292 }
 293
 294 void *
 295 mp_alloc_noalign(struct mempool *pool, uns size)
 296 {
 297   return mp_alloc_fast_noalign(pool, size);
 298 }
 299
 300 void *
 301 mp_alloc_zero(struct mempool *pool, uns size)
 302 {
 303   void *ptr = mp_alloc_fast(pool, size);
 304   bzero(ptr, size);
 305   return ptr;
 306 }
 307
 308 void *
 309 mp_start_internal(struct mempool *pool, uns size)
 310 {
 311   void *ptr = mp_alloc_internal(pool, size);
 312   pool->state.free[pool->idx] += size;
 313   return ptr;
 314 }
 315
 316 void *
 317 mp_start(struct mempool *pool, uns size)
 318 {
 319   return mp_start_fast(pool, size);
 320 }
 321
 322 void *
 323 mp_start_noalign(struct mempool *pool, uns size)
 324 {
 325   return mp_start_fast_noalign(pool, size);
 326 }
 327
 328 void *
 329 mp_grow_internal(struct mempool *pool, uns size)
 330 {
 331   if (unlikely(size > MP_SIZE_MAX))
 332     die("Cannot allocate %u bytes of memory", size);
 333   uns avail = mp_avail(pool);
 334   void *ptr = mp_ptr(pool);
 335   if (pool->idx)
 336     {
 337       uns amortized = likely(avail <= MP_SIZE_MAX / 2) ? avail * 2 : MP_SIZE_MAX;
 338       amortized = MAX(amortized, size);
 339       amortized = ALIGN_TO(amortized, CPU_STRUCT_ALIGN);
 340       struct mempool_chunk *chunk = pool->state.last[1], *next = chunk->next;
 341       pool->total_size = pool->total_size - chunk->size + amortized;
 342       ptr = xrealloc(ptr, amortized + MP_CHUNK_TAIL);
 343       chunk = ptr + amortized;
 344       chunk->next = next;
 345       chunk->size = amortized;
 346       pool->state.last[1] = chunk;
 347       pool->state.free[1] = amortized;
 348       pool->last_big = ptr;
 349       return ptr;
 350     }
 351   else
 352     {
 353       void *p = mp_start_internal(pool, size);
 354       memcpy(p, ptr, avail);
 355       return p;
 356     }
 357 }
 358
 359 uns
 360 mp_open(struct mempool *pool, void *ptr)
 361 {
 362   return mp_open_fast(pool, ptr);
 363 }
 364
 365 void *
 366 mp_realloc(struct mempool *pool, void *ptr, uns size)
 367 {
 368   return mp_realloc_fast(pool, ptr, size);
 369 }
 370
 371 void *
 372 mp_realloc_zero(struct mempool *pool, void *ptr, uns size)
 373 {
 374   uns old_size = mp_open_fast(pool, ptr);
 375   ptr = mp_grow(pool, size);
 376   if (size > old_size)
 377     bzero(ptr + old_size, size - old_size);
 378   mp_end(pool, ptr + size);
 379   return ptr;
 380 }
 381
 382 void *
 383 mp_spread_internal(struct mempool *pool, void *p, uns size)
 384 {
 385   void *old = mp_ptr(pool);
 386   void *new = mp_grow_internal(pool, p-old+size);
 387   return p-old+new;
 388 }
 389
 390 void
 391 mp_restore(struct mempool *pool, struct mempool_state *state)
 392 {
 393   struct mempool_chunk *chunk, *next;
 394   struct mempool_state s = *state;
 395   for (chunk = pool->state.last[0]; chunk != s.last[0]; chunk = next)
 396     {
 397       next = chunk->next;
 398       chunk->next = pool->unused;
 399       pool->unused = chunk;
 400     }
 401   for (chunk = pool->state.last[1]; chunk != s.last[1]; chunk = next)
 402     {
 403       next = chunk->next;
 404       mp_free_big_chunk(pool, chunk);
 405     }
 406   pool->state = s;
 407   pool->last_big = &pool->last_big;
 408 }
 409
 410 struct mempool_state *
 411 mp_push(struct mempool *pool)
 412 {
 413   struct mempool_state state = pool->state;
 414   struct mempool_state *p = mp_alloc_fast(pool, sizeof(*p));
 415   *p = state;
 416   pool->state.next = p;
 417   return p;
 418 }
 419
 420 void
 421 mp_pop(struct mempool *pool)
 422 {
 423   ASSERT(pool->state.next);
 424   mp_restore(pool, pool->state.next);
 425 }
 426
 427 #ifdef TEST
 428
 429 #include <ucw/getopt.h>
 430 #include <stdio.h>
 431 #include <stdlib.h>
 432 #include <time.h>
 433
 434 static void
 435 fill(byte *ptr, uns len, uns magic)
 436 {
 437   while (len--)
 438     *ptr++ = (magic++ & 255);
 439 }
 440
 441 static void
 442 check(byte *ptr, uns len, uns magic, uns align)
 443 {
 444   ASSERT(!((uintptr_t)ptr & (align - 1)));
 445   while (len--)
 446     if (*ptr++ != (magic++ & 255))
 447       ASSERT(0);
 448 }
 449
 450 int main(int argc, char **argv)
 451 {
 452   srand(time(NULL));
 453   log_init(argv[0]);
 454   cf_def_file = NULL;
 455   if (cf_getopt(argc, argv, CF_SHORT_OPTS, CF_NO_LONG_OPTS, NULL) >= 0 || argc != optind)
 456     die("Invalid usage");
 457
 458   uns max = 1000, n = 0, m = 0, can_realloc = 0;
 459   void *ptr[max];
 460   struct mempool_state *state[max];
 461   uns len[max], num[max], align[max];
 462   struct mempool *mp = mp_new(128), mp_static;
 463
 464   for (uns i = 0; i < 5000; i++)
 465     {
 466       for (uns j = 0; j < n; j++)
 467         check(ptr[j], len[j], j, align[j]);
 468 #if 0
 469       DBG("free_small=%u free_big=%u idx=%u chunk_size=%u last_big=%p", mp->state.free[0], mp->state.free[1], mp->idx, mp->chunk_size, mp->last_big);
 470       for (struct mempool_chunk *ch = mp->state.last[0]; ch; ch = ch->next)
 471         DBG("small %p %p %p %d", (byte *)ch - ch->size, ch, ch + 1, ch->size);
 472       for (struct mempool_chunk *ch = mp->state.last[1]; ch; ch = ch->next)
 473         DBG("big %p %p %p %d", (byte *)ch - ch->size, ch, ch + 1, ch->size);
 474 #endif
 475       int r = random_max(100);
 476       if ((r -= 1) < 0)
 477         {
 478           DBG("flush");
 479           mp_flush(mp);
 480           n = m = 0;
 481         }
 482       else if ((r -= 1) < 0)
 483         {
 484           DBG("delete & new");
 485           mp_delete(mp);
 486           if (random_max(2))
 487             mp = mp_new(random_max(0x1000) + 1);
 488           else
 489             mp = &mp_static, mp_init(mp, random_max(512) + 1);
 490           n = m = 0;
 491         }
 492       else if (n < max && (r -= 30) < 0)
 493         {
 494           len[n] = random_max(0x2000);
 495           DBG("alloc(%u)", len[n]);
 496           align[n] = random_max(2) ? CPU_STRUCT_ALIGN : 1;
 497           ptr[n] = (align[n] == 1) ? mp_alloc_fast_noalign(mp, len[n]) : mp_alloc_fast(mp, len[n]);
 498           DBG(" -> (%p)", ptr[n]);
 499           fill(ptr[n], len[n], n);
 500           n++;
 501           can_realloc = 1;
 502         }
 503       else if (n < max && (r -= 20) < 0)
 504         {
 505           len[n] = random_max(0x2000);
 506           DBG("start(%u)", len[n]);
 507           align[n] = random_max(2) ? CPU_STRUCT_ALIGN : 1;
 508           ptr[n] = (align[n] == 1) ? mp_start_fast_noalign(mp, len[n]) : mp_start_fast(mp, len[n]);
 509           DBG(" -> (%p)", ptr[n]);
 510           fill(ptr[n], len[n], n);
 511           n++;
 512           can_realloc = 1;
 513           goto grow;
 514         }
 515       else if (can_realloc && n && (r -= 10) < 0)
 516         {
 517           if (mp_open(mp, ptr[n - 1]) != len[n - 1])
 518             ASSERT(0);
 519 grow:
 520           {
 521             uns k = n - 1;
 522             for (uns i = random_max(4); i--; )
 523               {
 524                 uns l = len[k];
 525                 len[k] = random_max(0x2000);
 526                 DBG("grow(%u)", len[k]);
 527                 ptr[k] = mp_grow(mp, len[k]);
 528                 DBG(" -> (%p)", ptr[k]);
 529                 check(ptr[k], MIN(l, len[k]), k, align[k]);
 530                 fill(ptr[k], len[k], k);
 531               }
 532             mp_end(mp, ptr[k] + len[k]);
 533           }
 534         }
 535       else if (can_realloc && n && (r -= 20) < 0)
 536         {
 537           uns i = n - 1, l = len[i];
 538           DBG("realloc(%p, %u)", ptr[i], len[i]);
 539           ptr[i] = mp_realloc(mp, ptr[i], len[i] = random_max(0x2000));
 540           DBG(" -> (%p, %u)", ptr[i], len[i]);
 541           check(ptr[i],  MIN(len[i], l), i, align[i]);
 542           fill(ptr[i], len[i], i);
 543         }
 544       else if (m < max && (r -= 5) < 0)
 545         {
 546           DBG("push(%u)", m);
 547           num[m] = n;
 548           state[m++] = mp_push(mp);
 549           can_realloc = 0;
 550         }
 551       else if (m && (r -= 2) < 0)
 552         {
 553           m--;
 554           DBG("pop(%u)", m);
 555           mp_pop(mp);
 556           n = num[m];
 557           can_realloc = 0;
 558         }
 559       else if (m && (r -= 1) < 0)
 560         {
 561           uns i = random_max(m);
 562           DBG("restore(%u)", i);
 563           mp_restore(mp, state[i]);
 564           n = num[m = i];
 565           can_realloc = 0;
 566         }
 567       else if (can_realloc && n && (r -= 5) < 0)
 568         ASSERT(mp_size(mp, ptr[n - 1]) == len[n - 1]);
 569       else
 570         {
 571           struct mempool_stats stats;
 572           mp_stats(mp, &stats);
 573         }
 574     }
 575
 576   mp_delete(mp);
 577   return 0;
 578 }
 579
 580 #endif