The memarea library is an allocator of variable-size object which based
on a memory region. The main features are as follows:
- The allocated object aligned at RTE_CACHE_LINE_SIZE default.
- The memory region can be initialized from the following memory
sources:
1. HEAP: e.g. invoke rte_malloc_socket.
2. LIBC: e.g. invoke posix_memalign.
3. User provided: it can be from e.g. rte_extmem_xxx as long as it is
available. The memory's start address must be aligned to
RTE_CACHE_LINE_SIZE.
4. User provided memarea: it can be from another memarea.
- It provides refcnt feature which could be useful in multi-reader
scenario.
- It provides backup memory mechanism, the memarea could use another
memarea as a backup. It will attempts to allocate object from backup
memarea when the current memarea failed to allocate.
Note:
a) The memarea is oriented towards the application layer, which could
provides 'region-based memory management' [1] function.
b) The eal library also provide memory zone/heap management, but these
are tied to huge pages management.
[1] https://en.wikipedia.org/wiki/Region-based_memory_management
Signed-off-by: Chengwen Feng <fengcheng...@huawei.com>
Chengwen Feng (10):
memarea: introduce memarea library
test/memarea: support memarea test
memarea: support alloc/free/update-refcnt API
test/memarea: support alloc/free/update-refcnt test
memarea: support dump API
test/memarea: support dump test
memarea: support backup memory mechanism
test/memarea: support backup memory test
memarea: detect memory corruption based on magic
test/memarea: support no MT-safe test
---
v6:
* address Mattias's comments.
* repost patches as there are spread over different series in patchwork.
v5:
* fix 09/10 patch spell warning.
v4:
* repost patches as there are spread over different series in patchwork.
v3:
* add memory source of RTE memory.
* add algorithm field to facilitate the introduction of new algorithms.
* fix memarea log don't output problem.
v2:
* fix compile issues reported by dpdk-test-report.
* address Dimitry and Jerin's comments.
* add no MT-safe test.
MAINTAINERS | 6 +
app/test/meson.build | 2 +
app/test/test_memarea.c | 420 ++++++++++++++++++++++++
doc/api/doxy-api-index.md | 3 +-
doc/api/doxy-api.conf.in | 1 +
doc/guides/prog_guide/index.rst | 1 +
doc/guides/prog_guide/memarea_lib.rst | 56 ++++
doc/guides/rel_notes/release_22_11.rst | 6 +
lib/eal/common/eal_common_log.c | 1 +
lib/eal/include/rte_log.h | 1 +
lib/memarea/memarea_private.h | 37 +++
lib/memarea/meson.build | 16 +
lib/memarea/rte_memarea.c | 428 +++++++++++++++++++++++++
lib/memarea/rte_memarea.h | 234 ++++++++++++++
lib/memarea/version.map | 16 +
lib/meson.build | 1 +
16 files changed, 1228 insertions(+), 1 deletion(-)
create mode 100644 app/test/test_memarea.c
create mode 100644 doc/guides/prog_guide/memarea_lib.rst
create mode 100644 lib/memarea/memarea_private.h
create mode 100644 lib/memarea/meson.build
create mode 100644 lib/memarea/rte_memarea.c
create mode 100644 lib/memarea/rte_memarea.h
create mode 100644 lib/memarea/version.map
--
2.17.1
