Show a cover letter.

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

{
    "id": 117345,
    "url": "http://patchwork.dpdk.org/api/covers/117345/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/tencent_CD9CAB5CF3950968A8BF4776F2D67DB3EA05@qq.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": "<tencent_CD9CAB5CF3950968A8BF4776F2D67DB3EA05@qq.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/tencent_CD9CAB5CF3950968A8BF4776F2D67DB3EA05@qq.com",
    "date": "2022-10-05T03:38:38",
    "name": "[v4,00/10] introduce memarea library",
    "submitter": {
        "id": 2867,
        "url": "http://patchwork.dpdk.org/api/people/2867/?format=api",
        "name": "datshan",
        "email": "datshan@qq.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/tencent_CD9CAB5CF3950968A8BF4776F2D67DB3EA05@qq.com/mbox/",
    "series": [
        {
            "id": 24978,
            "url": "http://patchwork.dpdk.org/api/series/24978/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=24978",
            "date": "2022-10-05T03:38:38",
            "name": "introduce memarea library",
            "version": 4,
            "mbox": "http://patchwork.dpdk.org/series/24978/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/117345/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 7F1A2A0542;\n\tWed,  5 Oct 2022 05:39:00 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 0D37840DDC;\n\tWed,  5 Oct 2022 05:38:59 +0200 (CEST)",
            "from out162-62-57-252.mail.qq.com (out162-62-57-252.mail.qq.com\n [162.62.57.252]) by mails.dpdk.org (Postfix) with ESMTP id 6D11D40041\n for <dev@dpdk.org>; Wed,  5 Oct 2022 05:38:56 +0200 (CEST)",
            "from qq.com ([120.229.93.179])\n by newxmesmtplogicsvrszc13.qq.com (NewEsmtp) with SMTP\n id 9B40FA58; Wed, 05 Oct 2022 11:38:52 +0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=qq.com; s=s201512;\n t=1664941134; bh=O/nh9HbKh2AplgaPwirbzlTWP0Gwg0pVYe78zJslN3c=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References;\n b=uyonHsTE/m5bh+nWgQ5am9bc9M8k8TcYQVi0m3T6CcgjpmcAMl78yDZ18/pBAQvMT\n GbZOGuOVc5E4Gz4fJBU2U90FoaJoHvEN0wVw64Vp+/bduYjCDWNOMNCywQktB4SQ7a\n SPgQoP/HgKLJfqNAJaGj/a0LkHtc7d3tVqCqAnvY=",
        "X-QQ-mid": "xmsmtpt1664941132t51osqo1y",
        "Message-ID": "<tencent_CD9CAB5CF3950968A8BF4776F2D67DB3EA05@qq.com>",
        "X-QQ-XMAILINFO": "Mdc3TkmnJyI/BWPyNCU4MG5AK7GMRabvZbdbvFMiZjSTGlvf8FIAViANUZeCce\n ik6p0WY/beZk0PvRShi+cgF3SotyH6gjNEAUf67w3GOlTn0qzQlL/tRQBv8+RuDsOJvewaDiys3k\n v3Nq/M5KoinESIK8RQAKc/Y9Uz86EG0vXB5wXaqaXlixl3HDYlToKaug9syfOBa4swk+Czly2YV9\n TYP/6VxxJCXQURZv4rmXGSaUbvKX8VL0OA5f/cFEeIRlzMhHqA7sixhowWrW9VrJeJ57DnIsGB8B\n AJO71neuIS+a85JEbswgiIKJBrxsB/4Y6GQoBSru4vbjlvv5ooDAwt4LZqQxDedVEr6TPLLLb36U\n dOW+kk8MZHLP7dGukbhsMZwdaB21OQbdvPyfoqPcvCmkKDKO9AFJayUMTCbVijsXuj8xvV/tdDQW\n BIiJm7q0ONYHs1hX9z/0DtOKllmURTFgJ9W0Q/YC6594XPGffYO9sfaSPjZIt2Figu9dCHG5Jizx\n bWqMzIFGcoO0IPXnsLMPO7n1NUjuRflkhpKiMmmhDQNcSddpHkZrR+CgVfnnCpFMcepsME4AtK/0\n kblJ/hKt9mWgdr+/uo052NhiAZiX+RpR65BQk6ui3pvVmkqwckJMydljobVhLtM+Pxo72kUwN5B3\n kZbU22uM+Q1qvHvikSgGs+7fyPkDnY66J78Et0nECjsPjvSYXRriwQaUenTlG8xvyl7uir61eWhZ\n OIcNQ6LJeRdV71LUsRBdCHaLViPNsK5ABUCAuMf2rIkK+OQM6qSZXoCLIPNURsAbthutgMfQCwqL\n E987NubzOWAUiYFaSdksnOMwpORfnl9yzYs+Bupy5L5loFYL51ZBvbdOGSeTeguyh7buda70dxbE\n WviJonkMTkKPObr5YO33XN53mrmCMXgsV7X5M091YqvgOFyW11hAlPdN5JyWinBJij6SEPUMHetF\n /U10LvnJ6d6s61CBjWKkzJVU+e1I7D",
        "From": "datshan <datshan@qq.com>",
        "To": "david.marchand@redhat.com, mb@smartsharesystems.com,\n anatoly.burakov@intel.com, dmitry.kozliuk@gmail.com, jerinjacobk@gmail.com",
        "Cc": "thomas@monjalon.net, dev@dpdk.org, datshan <datshan@qq.com>,\n Chengwen Feng <fengchengwen@huawei.com>",
        "Subject": "[PATCH v4 00/10] introduce memarea library",
        "Date": "Wed,  5 Oct 2022 11:38:38 +0800",
        "X-OQ-MSGID": "<20221005033848.2241-1-datshan@qq.com>",
        "X-Mailer": "git-send-email 2.34.1",
        "In-Reply-To": "<20220721044648.6817-1-fengchengwen@huawei.com>",
        "References": "<20220721044648.6817-1-fengchengwen@huawei.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "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 default alignment size is RTE_CACHE_LINE_SIZE.\n\n- The memory region can be initialized from the following memory\n  sources:\n  1. RTE memory: e.g. invoke rte_malloc_socket to obtain.\n  2. System API: e.g. invoke posix_memalign to obtain.\n  3. User provided address: it can be from extended memory as long as\n     it is available. The address must be aligned to\n     RTE_CACHE_LINE_SIZE.\n  4. User provided 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.\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 (10):\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  memarea: detect memory corruption based on magic\n  test/memarea: support no MT-safe test\n\n---\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                | 401 +++++++++++++++++++++++\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  |  55 ++++\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          |  37 +++\n lib/memarea/meson.build                |  16 +\n lib/memarea/rte_memarea.c              | 430 +++++++++++++++++++++++++\n lib/memarea/rte_memarea.h              | 229 +++++++++++++\n lib/memarea/version.map                |  16 +\n lib/meson.build                        |   1 +\n 16 files changed, 1205 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"
}