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];
 225 }
 226
 227 u64
 228 mp_total_size(struct mempool *pool)
 229 {
 230   return pool->total_size;
 231 }
 232
 233 void
 234 mp_shrink(struct mempool *pool, u64 min_total_size)
 235 {
 236   while (1)
 237     {
 238       struct mempool_chunk *chunk = pool->unused;
 239       if (!chunk || pool->total_size - (chunk->size + MP_CHUNK_TAIL) < min_total_size)
 240         break;
 241       pool->unused = chunk->next;
 242       mp_free_chunk(pool, chunk);
 243     }
 244 }
 245
 246 void *
 247 mp_alloc_internal(struct mempool *pool, uns size)
 248 {
 249   struct mempool_chunk *chunk;
 250   if (size <= pool->threshold)
 251     {
 252       pool->idx = 0;
 253       if (pool->unused)
 254         {
 255           chunk = pool->unused;
 256           pool->unused = chunk->next;
 257         }
 258       else
 259         {
 260           chunk = mp_new_chunk(pool, pool->chunk_size);
 261 #ifdef CONFIG_DEBUG
 262           chunk->pool = pool;
 263 #endif
 264         }
 265       chunk->next = pool->state.last[0];
 266       pool->state.last[0] = chunk;
 267       pool->state.free[0] = pool->chunk_size - size;
 268       return (void *)chunk - pool->chunk_size;
 269     }
 270   else if (likely(size <= MP_SIZE_MAX))
 271     {
 272       pool->idx = 1;
 273       uns aligned = ALIGN_TO(size, CPU_STRUCT_ALIGN);
 274       chunk = mp_new_big_chunk(pool, aligned);
 275       chunk->next = pool->state.last[1];
 276 #ifdef CONFIG_DEBUG
 277       chunk->pool = pool;
 278 #endif
 279       pool->state.last[1] = chunk;
 280       pool->state.free[1] = aligned - size;
 281       return pool->last_big = (void *)chunk - aligned;
 282     }
 283   else
 284     die("Cannot allocate %u bytes from a mempool", size);
 285 }
 286
 287 void *
 288 mp_alloc(struct mempool *pool, uns size)
 289 {
 290   return mp_alloc_fast(pool, size);
 291 }
 292
 293 void *
 294 mp_alloc_noalign(struct mempool *pool, uns size)
 295 {
 296   return mp_alloc_fast_noalign(pool, size);
 297 }
 298
 299 void *
 300 mp_alloc_zero(struct mempool *pool, uns size)
 301 {
 302   void *ptr = mp_alloc_fast(pool, size);
 303   bzero(ptr, size);
 304   return ptr;
 305 }
 306
 307 void *
 308 mp_start_internal(struct mempool *pool, uns size)
 309 {
 310   void *ptr = mp_alloc_internal(pool, size);
 311   pool->state.free[pool->idx] += size;
 312   return ptr;
 313 }
 314
 315 void *
 316 mp_start(struct mempool *pool, uns size)
 317 {
 318   return mp_start_fast(pool, size);
 319 }
 320
 321 void *
 322 mp_start_noalign(struct mempool *pool, uns size)
 323 {
 324   return mp_start_fast_noalign(pool, size);
 325 }
 326
 327 void *
 328 mp_grow_internal(struct mempool *pool, uns size)
 329 {
 330   if (unlikely(size > MP_SIZE_MAX))
 331     die("Cannot allocate %u bytes of memory", size);
 332   uns avail = mp_avail(pool);
 333   void *ptr = mp_ptr(pool);
 334   if (pool->idx)
 335     {
 336       uns amortized = likely(avail <= MP_SIZE_MAX / 2) ? avail * 2 : MP_SIZE_MAX;
 337       amortized = MAX(amortized, size);
 338       amortized = ALIGN_TO(amortized, CPU_STRUCT_ALIGN);
 339       struct mempool_chunk *chunk = pool->state.last[1], *next = chunk->next;
 340       pool->total_size = pool->total_size - chunk->size + amortized;
 341       ptr = xrealloc(ptr, amortized + MP_CHUNK_TAIL);
 342       chunk = ptr + amortized;
 343       chunk->next = next;
 344       chunk->size = amortized;
 345       pool->state.last[1] = chunk;
 346       pool->state.free[1] = amortized;
 347       pool->last_big = ptr;
 348       return ptr;
 349     }
 350   else
 351     {
 352       void *p = mp_start_internal(pool, size);
 353       memcpy(p, ptr, avail);
 354       return p;
 355     }
 356 }
 357
 358 uns
 359 mp_open(struct mempool *pool, void *ptr)
 360 {
 361   return mp_open_fast(pool, ptr);
 362 }
 363
 364 void *
 365 mp_realloc(struct mempool *pool, void *ptr, uns size)
 366 {
 367   return mp_realloc_fast(pool, ptr, size);
 368 }
 369
 370 void *
 371 mp_realloc_zero(struct mempool *pool, void *ptr, uns size)
 372 {
 373   uns old_size = mp_open_fast(pool, ptr);
 374   ptr = mp_grow(pool, size);
 375   if (size > old_size)
 376     bzero(ptr + old_size, size - old_size);
 377   mp_end(pool, ptr + size);
 378   return ptr;
 379 }
 380
 381 void *
 382 mp_spread_internal(struct mempool *pool, void *p, uns size)
 383 {
 384   void *old = mp_ptr(pool);
 385   void *new = mp_grow_internal(pool, p-old+size);
 386   return p-old+new;
 387 }
 388
 389 void
 390 mp_restore(struct mempool *pool, struct mempool_state *state)
 391 {
 392   struct mempool_chunk *chunk, *next;
 393   struct mempool_state s = *state;
 394   for (chunk = pool->state.last[0]; chunk != s.last[0]; chunk = next)
 395     {
 396       next = chunk->next;
 397       chunk->next = pool->unused;
 398       pool->unused = chunk;
 399     }
 400   for (chunk = pool->state.last[1]; chunk != s.last[1]; chunk = next)
 401     {
 402       next = chunk->next;
 403       mp_free_big_chunk(pool, chunk);
 404     }
 405   pool->state = s;
 406   pool->last_big = &pool->last_big;
 407 }
 408
 409 struct mempool_state *
 410 mp_push(struct mempool *pool)
 411 {
 412   struct mempool_state state = pool->state;
 413   struct mempool_state *p = mp_alloc_fast(pool, sizeof(*p));
 414   *p = state;
 415   pool->state.next = p;
 416   return p;
 417 }
 418
 419 void
 420 mp_pop(struct mempool *pool)
 421 {
 422   ASSERT(pool->state.next);
 423   mp_restore(pool, pool->state.next);
 424 }
 425
 426 #ifdef TEST
 427
 428 #include <ucw/getopt.h>
 429 #include <stdio.h>
 430 #include <stdlib.h>
 431 #include <time.h>
 432
 433 static void
 434 fill(byte *ptr, uns len, uns magic)
 435 {
 436   while (len--)
 437     *ptr++ = (magic++ & 255);
 438 }
 439
 440 static void
 441 check(byte *ptr, uns len, uns magic, uns align)
 442 {
 443   ASSERT(!((uintptr_t)ptr & (align - 1)));
 444   while (len--)
 445     if (*ptr++ != (magic++ & 255))
 446       ASSERT(0);
 447 }
 448
 449 int main(int argc, char **argv)
 450 {
 451   srand(time(NULL));
 452   log_init(argv[0]);
 453   cf_def_file = NULL;
 454   if (cf_getopt(argc, argv, CF_SHORT_OPTS, CF_NO_LONG_OPTS, NULL) >= 0 || argc != optind)
 455     die("Invalid usage");
 456
 457   uns max = 1000, n = 0, m = 0, can_realloc = 0;
 458   void *ptr[max];
 459   struct mempool_state *state[max];
 460   uns len[max], num[max], align[max];
 461   struct mempool *mp = mp_new(128), mp_static;
 462
 463   for (uns i = 0; i < 5000; i++)
 464     {
 465       for (uns j = 0; j < n; j++)
 466         check(ptr[j], len[j], j, align[j]);
 467 #if 0
 468       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);
 469       for (struct mempool_chunk *ch = mp->state.last[0]; ch; ch = ch->next)
 470         DBG("small %p %p %p %d", (byte *)ch - ch->size, ch, ch + 1, ch->size);
 471       for (struct mempool_chunk *ch = mp->state.last[1]; ch; ch = ch->next)
 472         DBG("big %p %p %p %d", (byte *)ch - ch->size, ch, ch + 1, ch->size);
 473 #endif
 474       int r = random_max(100);
 475       if ((r -= 1) < 0)
 476         {
 477           DBG("flush");
 478           mp_flush(mp);
 479           n = m = 0;
 480         }
 481       else if ((r -= 1) < 0)
 482         {
 483           DBG("delete & new");
 484           mp_delete(mp);
 485           if (random_max(2))
 486             mp = mp_new(random_max(0x1000) + 1);
 487           else
 488             mp = &mp_static, mp_init(mp, random_max(512) + 1);
 489           n = m = 0;
 490         }
 491       else if (n < max && (r -= 30) < 0)
 492         {
 493           len[n] = random_max(0x2000);
 494           DBG("alloc(%u)", len[n]);
 495           align[n] = random_max(2) ? CPU_STRUCT_ALIGN : 1;
 496           ptr[n] = (align[n] == 1) ? mp_alloc_fast_noalign(mp, len[n]) : mp_alloc_fast(mp, len[n]);
 497           DBG(" -> (%p)", ptr[n]);
 498           fill(ptr[n], len[n], n);
 499           n++;
 500           can_realloc = 1;
 501         }
 502       else if (n < max && (r -= 20) < 0)
 503         {
 504           len[n] = random_max(0x2000);
 505           DBG("start(%u)", len[n]);
 506           align[n] = random_max(2) ? CPU_STRUCT_ALIGN : 1;
 507           ptr[n] = (align[n] == 1) ? mp_start_fast_noalign(mp, len[n]) : mp_start_fast(mp, len[n]);
 508           DBG(" -> (%p)", ptr[n]);
 509           fill(ptr[n], len[n], n);
 510           n++;
 511           can_realloc = 1;
 512           goto grow;
 513         }
 514       else if (can_realloc && n && (r -= 10) < 0)
 515         {
 516           if (mp_open(mp, ptr[n - 1]) != len[n - 1])
 517             ASSERT(0);
 518 grow:
 519           {
 520             uns k = n - 1;
 521             for (uns i = random_max(4); i--; )
 522               {
 523                 uns l = len[k];
 524                 len[k] = random_max(0x2000);
 525                 DBG("grow(%u)", len[k]);
 526                 ptr[k] = mp_grow(mp, len[k]);
 527                 DBG(" -> (%p)", ptr[k]);
 528                 check(ptr[k], MIN(l, len[k]), k, align[k]);
 529                 fill(ptr[k], len[k], k);
 530               }
 531             mp_end(mp, ptr[k] + len[k]);
 532           }
 533         }
 534       else if (can_realloc && n && (r -= 20) < 0)
 535         {
 536           uns i = n - 1, l = len[i];
 537           DBG("realloc(%p, %u)", ptr[i], len[i]);
 538           ptr[i] = mp_realloc(mp, ptr[i], len[i] = random_max(0x2000));
 539           DBG(" -> (%p, %u)", ptr[i], len[i]);
 540           check(ptr[i],  MIN(len[i], l), i, align[i]);
 541           fill(ptr[i], len[i], i);
 542         }
 543       else if (m < max && (r -= 5) < 0)
 544         {
 545           DBG("push(%u)", m);
 546           num[m] = n;
 547           state[m++] = mp_push(mp);
 548           can_realloc = 0;
 549         }
 550       else if (m && (r -= 2) < 0)
 551         {
 552           m--;
 553           DBG("pop(%u)", m);
 554           mp_pop(mp);
 555           n = num[m];
 556           can_realloc = 0;
 557         }
 558       else if (m && (r -= 1) < 0)
 559         {
 560           uns i = random_max(m);
 561           DBG("restore(%u)", i);
 562           mp_restore(mp, state[i]);
 563           n = num[m = i];
 564           can_realloc = 0;
 565         }
 566       else if (can_realloc && n && (r -= 5) < 0)
 567         ASSERT(mp_size(mp, ptr[n - 1]) == len[n - 1]);
 568       else
 569         {
 570           struct mempool_stats stats;
 571           mp_stats(mp, &stats);
 572         }
 573     }
 574
 575   mp_delete(mp);
 576   return 0;
 577 }
 578
 579 #endif