blob: 928ac5b6f011c105c9b09c0fcb6df56a3734c2f0 [file] [log] [blame]
.. _chapter-pw-malloc-freelist:
.. default-domain:: cpp
------------------
pw_malloc_freelist
------------------
``pw_malloc_freelist`` implements the ``pw_malloc`` facade using a freelist
heap.
``pw_malloc_freelist`` initializes a global ``FreeListHeapBuffer`` object to
organize heap usage. Implementation details are in the ``pw_allocator`` module.
``pw_malloc_freelist`` provides wrapper functions for ``malloc``, ``free``,
``realloc`` and ``calloc`` that uses the freelist implementation of heap in
``pw_allocator``. In the GN build file, ``pw_malloc_freelist`` provides linker
options needed in ``public_configs``, which will be forwarded to the facade. In
the case of freelist, we specify the wrapper functions ``malloc, free, realloc,
calloc, _malloc_r, _free_r, _realloc_r, _calloc_r`` to replace the original libc
functions at linker time.