Show a cover letter.

GET /api/covers/129410/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 129410,
    "url": "http://patchwork.dpdk.org/api/covers/129410/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20230710064923.19849-1-fengchengwen@huawei.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.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": "<20230710064923.19849-1-fengchengwen@huawei.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230710064923.19849-1-fengchengwen@huawei.com",
    "date": "2023-07-10T06:49:17",
    "name": "[v16,0/6] introduce memarea library",
    "submitter": {
        "id": 2146,
        "url": "http://patchwork.dpdk.org/api/people/2146/?format=api",
        "name": "fengchengwen",
        "email": "fengchengwen@huawei.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/20230710064923.19849-1-fengchengwen@huawei.com/mbox/",
    "series": [
        {
            "id": 28882,
            "url": "http://patchwork.dpdk.org/api/series/28882/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=28882",
            "date": "2023-07-10T06:49:23",
            "name": "introduce memarea library",
            "version": 16,
            "mbox": "http://patchwork.dpdk.org/series/28882/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/129410/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 481F042E38;\n\tMon, 10 Jul 2023 08:57:49 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id A721842D0D;\n\tMon, 10 Jul 2023 08:57:35 +0200 (CEST)",
            "from szxga02-in.huawei.com (szxga02-in.huawei.com [45.249.212.188])\n by mails.dpdk.org (Postfix) with ESMTP id EFBE1411F3\n for <dev@dpdk.org>; Mon, 10 Jul 2023 08:57:30 +0200 (CEST)",
            "from dggpeml100024.china.huawei.com (unknown [172.30.72.53])\n by szxga02-in.huawei.com (SkyGuard) with ESMTP id 4Qzvqm09xhzMqRP;\n Mon, 10 Jul 2023 14:54:12 +0800 (CST)",
            "from localhost.localdomain (10.50.163.32) by\n dggpeml100024.china.huawei.com (7.185.36.115) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.1.2507.27; Mon, 10 Jul 2023 14:57:27 +0800"
        ],
        "From": "Chengwen Feng <fengchengwen@huawei.com>",
        "To": "<thomas@monjalon.net>, <david.marchand@redhat.com>",
        "CC": "<dev@dpdk.org>, <mb@smartsharesystems.com>, <anatoly.burakov@intel.com>,\n <dmitry.kozliuk@gmail.com>, <jerinjacobk@gmail.com>, <hofors@lysator.liu.se>,\n <stephen@networkplumber.org>",
        "Subject": "[PATCH v16 0/6] introduce memarea library",
        "Date": "Mon, 10 Jul 2023 06:49:17 +0000",
        "Message-ID": "<20230710064923.19849-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; charset=\"UTF-8\"",
        "Content-Transfer-Encoding": "8bit",
        "X-Originating-IP": "[10.50.163.32]",
        "X-ClientProxiedBy": "dggems703-chm.china.huawei.com (10.3.19.180) To\n dggpeml100024.china.huawei.com (7.185.36.115)",
        "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 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. Another memarea: it can be from another memarea.\n\n- It supports MT-safe as long as it's specified at creation time.\n\n- The address returned by the allocator is align to 8B.\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\nChengwen Feng (6):\n  memarea: introduce memarea library\n  test/memarea: support memarea test\n  memarea: support alloc and free API\n  test/memarea: support alloc and free API test\n  memarea: support dump API\n  test/memarea: support dump API test\n\n---\nv16:\n* fix compile failed when clang with thread-safety-analysis\n  (by disable annotate_locks in lib/memarea/meson.build).\n* add reserved field for 'struct rte_memarea_param' which address\n  Stephen's comments.\n* fix typo.\nv15:\n* rebase 23.07\n* address Anatoly's mostly comments: use rte_errno, abstract cookie\n  helper, more comment about critical function, rename add with split,\n  doc limitation.\nv14:\n* address Stephen's comments: RTE_MEMAREA_LOG use easy impl and add\n  __func__ print.\nv13:\n* address Morten's comments: make debug cookies optional, controlled\n  by RTE_LIBRTE_MEMAREA_DEBUG; disabled by default.\n* reduce management data overhead.\nv12:\n* remove rte_memarea_refcnt_update() API which address Dongdong's\n  comments.\n* refine the variable naming.\n* fix some bugs.\nv11:\n* rebase 23.03\n* remove \"app/test: add memarea to malloc-perf-autotest\" because the\n  two algorithm are not comparable which also address previous\n  comments.\nv10:\n* support windows platform.\n* add rte_memarea.libc perftest to malloc-perf-autotest.\nv9:\n* address Dmitry's comments.\n* drop features of SOURCE_USER and backup memarea mechanism.\n* rename rte_memarea_update_refcnt to rte_memarea_refcnt_update\n  to keep with rte_mbuf_refcnt_update name style.\n* fix memarea perftest compile failed at windows platform.\n* fix spell warning.\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_memarea.c                | 391 ++++++++++++++++++++\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  |  57 +++\n doc/guides/rel_notes/release_23_07.rst |   6 +\n lib/memarea/memarea_private.h          |  96 +++++\n lib/memarea/meson.build                |  12 +\n lib/memarea/rte_memarea.c              | 485 +++++++++++++++++++++++++\n lib/memarea/rte_memarea.h              | 206 +++++++++++\n lib/memarea/version.map                |  15 +\n lib/meson.build                        |   1 +\n 14 files changed, 1281 insertions(+), 1 deletion(-)\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"
}