Cover Detail
Show a cover letter.
GET /api/covers/117926/?format=api
{ "id": 117926, "url": "http://patches.dpdk.org/api/covers/117926/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/cover/20221011121720.2657-1-fengchengwen@huawei.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20221011121720.2657-1-fengchengwen@huawei.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20221011121720.2657-1-fengchengwen@huawei.com", "date": "2022-10-11T12:17:11", "name": "[v8,0/9] introduce memarea library", "submitter": { "id": 2146, "url": "http://patches.dpdk.org/api/people/2146/?format=api", "name": "fengchengwen", "email": "fengchengwen@huawei.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/cover/20221011121720.2657-1-fengchengwen@huawei.com/mbox/", "series": [ { "id": 25146, "url": "http://patches.dpdk.org/api/series/25146/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=25146", "date": "2022-10-11T12:17:17", "name": "introduce memarea library", "version": 8, "mbox": "http://patches.dpdk.org/series/25146/mbox/" } ], "comments": "http://patches.dpdk.org/api/covers/117926/comments/", "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 76550A0545;\n\tTue, 11 Oct 2022 14:23:30 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 804F042DF8;\n\tTue, 11 Oct 2022 14:23:10 +0200 (CEST)", "from szxga03-in.huawei.com (szxga03-in.huawei.com [45.249.212.189])\n by mails.dpdk.org (Postfix) with ESMTP id 4227442DE1\n for <dev@dpdk.org>; Tue, 11 Oct 2022 14:23:05 +0200 (CEST)", "from dggpeml500024.china.huawei.com (unknown [172.30.72.56])\n by szxga03-in.huawei.com (SkyGuard) with ESMTP id 4Mmvxq6VS5z1CDyK;\n Tue, 11 Oct 2022 20:20:31 +0800 (CST)", "from localhost.localdomain (10.67.165.24) by\n dggpeml500024.china.huawei.com (7.185.36.10) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.1.2375.31; Tue, 11 Oct 2022 20:23:02 +0800" ], "From": "Chengwen Feng <fengchengwen@huawei.com>", "To": "<david.marchand@redhat.com>, <mb@smartsharesystems.com>,\n <anatoly.burakov@intel.com>, <dmitry.kozliuk@gmail.com>,\n <jerinjacobk@gmail.com>, <hofors@lysator.liu.se>", "CC": "<thomas@monjalon.net>, <dev@dpdk.org>", "Subject": "[PATCH v8 0/9] introduce memarea library", "Date": "Tue, 11 Oct 2022 12:17:11 +0000", "Message-ID": "<20221011121720.2657-1-fengchengwen@huawei.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20220721044648.6817-1-fengchengwen@huawei.com>", "References": "<20220721044648.6817-1-fengchengwen@huawei.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[10.67.165.24]", "X-ClientProxiedBy": "dggems701-chm.china.huawei.com (10.3.19.178) To\n dggpeml500024.china.huawei.com (7.185.36.10)", "X-CFilter-Loop": "Reflected", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "The memarea library is an allocator of variable-size object which based\non a memory region. The main features are as follows:\n\n- The allocated object aligned at RTE_CACHE_LINE_SIZE default.\n\n- The memory region can be initialized from the following memory\n sources:\n 1. HEAP: e.g. invoke rte_malloc_socket.\n 2. LIBC: e.g. invoke posix_memalign.\n 3. User memory: it can be from e.g. rte_extmem_xxx as long as it is\n available. The memory's start address must be aligned to\n RTE_CACHE_LINE_SIZE.\n 4. Another memarea: it can be from another memarea.\n\n- It provides refcnt feature which could be useful in multi-reader\n scenario.\n\n- It provides backup memory mechanism, the memarea could use another\n memarea as a backup. It will attempts to allocate object from backup\n memarea when the current memarea failed to allocate.\n\nNote:\na) The memarea is oriented towards the application layer, which could\nprovides 'region-based memory management' [1] function.\nb) The eal library also provide memory zone/heap management, but these\nare tied to huge pages management.\n\n[1] https://en.wikipedia.org/wiki/Region-based_memory_management\n\nSigned-off-by: Chengwen Feng <fengchengwen@huawei.com>\n\nChengwen Feng (9):\n memarea: introduce memarea library\n test/memarea: support memarea test\n memarea: support alloc/free/update-refcnt API\n test/memarea: support alloc/free/update-refcnt test\n memarea: support dump API\n test/memarea: support dump test\n memarea: support backup memory mechanism\n test/memarea: support backup memory test\n app/test: add memarea to malloc-perf-autotest\n\n---\nv8:\n* address Mattias's comments (rename ALG_DEFAULT with ALG_NEXTFIT).\n* small feature patches are combined.\n* enhanced backup memory mechanism.\n* add memarea to malloc-perf-autotest.\n* other tiny naming optimize.\nv7:\n* repost patches as there are spread over different series in patchwork.\nv6:\n* address Mattias's comments.\nv5:\n* fix 09/10 patch spell warning.\nv4:\n* repost patches as there are spread over different series in patchwork.\nv3:\n* add memory source of RTE memory.\n* add algorithm field to facilitate the introduction of new algorithms.\n* fix memarea log don't output problem.\nv2:\n* fix compile issues reported by dpdk-test-report.\n* address Dimitry and Jerin's comments.\n* add no MT-safe test.\n\n MAINTAINERS | 6 +\n app/test/meson.build | 2 +\n app/test/test_malloc_perf.c | 55 ++-\n app/test/test_memarea.c | 442 +++++++++++++++++++++++\n doc/api/doxy-api-index.md | 3 +-\n doc/api/doxy-api.conf.in | 1 +\n doc/guides/prog_guide/index.rst | 1 +\n doc/guides/prog_guide/memarea_lib.rst | 56 +++\n doc/guides/rel_notes/release_22_11.rst | 6 +\n lib/eal/common/eal_common_log.c | 1 +\n lib/eal/include/rte_log.h | 1 +\n lib/memarea/memarea_private.h | 39 ++\n lib/memarea/meson.build | 16 +\n lib/memarea/rte_memarea.c | 476 +++++++++++++++++++++++++\n lib/memarea/rte_memarea.h | 223 ++++++++++++\n lib/memarea/version.map | 16 +\n lib/meson.build | 1 +\n 17 files changed, 1343 insertions(+), 2 deletions(-)\n create mode 100644 app/test/test_memarea.c\n create mode 100644 doc/guides/prog_guide/memarea_lib.rst\n create mode 100644 lib/memarea/memarea_private.h\n create mode 100644 lib/memarea/meson.build\n create mode 100644 lib/memarea/rte_memarea.c\n create mode 100644 lib/memarea/rte_memarea.h\n create mode 100644 lib/memarea/version.map" }