Show a cover letter.

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

{
    "id": 118042,
    "url": "http://patchwork.dpdk.org/api/covers/118042/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20221012104805.44185-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": "<20221012104805.44185-1-fengchengwen@huawei.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20221012104805.44185-1-fengchengwen@huawei.com",
    "date": "2022-10-12T10:47:58",
    "name": "[v9,0/7] 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/20221012104805.44185-1-fengchengwen@huawei.com/mbox/",
    "series": [
        {
            "id": 25175,
            "url": "http://patchwork.dpdk.org/api/series/25175/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=25175",
            "date": "2022-10-12T10:47:58",
            "name": "introduce memarea library",
            "version": 9,
            "mbox": "http://patchwork.dpdk.org/series/25175/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/118042/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 CF83AA00C4;\n\tWed, 12 Oct 2022 12:53:52 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id AE62F42D6E;\n\tWed, 12 Oct 2022 12:53:52 +0200 (CEST)",
            "from szxga01-in.huawei.com (szxga01-in.huawei.com [45.249.212.187])\n by mails.dpdk.org (Postfix) with ESMTP id 006CA42B6D\n for <dev@dpdk.org>; Wed, 12 Oct 2022 12:53:50 +0200 (CEST)",
            "from dggpeml500024.china.huawei.com (unknown [172.30.72.54])\n by szxga01-in.huawei.com (SkyGuard) with ESMTP id 4MnTvd60nMzpVfp;\n Wed, 12 Oct 2022 18:50:37 +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; Wed, 12 Oct 2022 18:53:48 +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 v9 0/7] introduce memarea library",
        "Date": "Wed, 12 Oct 2022 10:47:58 +0000",
        "Message-ID": "<20221012104805.44185-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": "dggems704-chm.china.huawei.com (10.3.19.181) 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 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 provides refcnt feature which could be useful in multi-reader\n  scenario.\n\n- It supports MT-safe as long as it's specified at creation time.\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 (7):\n  memarea: introduce memarea library\n  test/memarea: support memarea test\n  memarea: support alloc/free/refcnt-update API\n  test/memarea: support alloc/free/refcnt-update test\n  memarea: support dump API\n  test/memarea: support dump test\n  app/test: add memarea to malloc-perf-autotest\n\n---\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_malloc_perf.c            |  75 +++++\n app/test/test_memarea.c                | 320 ++++++++++++++++++++\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  |  52 ++++\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          |  36 +++\n lib/memarea/meson.build                |  16 +\n lib/memarea/rte_memarea.c              | 398 +++++++++++++++++++++++++\n lib/memarea/rte_memarea.h              | 219 ++++++++++++++\n lib/memarea/version.map                |  16 +\n lib/meson.build                        |   1 +\n 17 files changed, 1153 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"
}