Show a cover letter.

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

{
    "id": 117356,
    "url": "http://patchwork.dpdk.org/api/covers/117356/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/tencent_CB66DA3977B9E9EB16D054FF9A2CC82DEC06@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_CB66DA3977B9E9EB16D054FF9A2CC82DEC06@qq.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/tencent_CB66DA3977B9E9EB16D054FF9A2CC82DEC06@qq.com",
    "date": "2022-10-05T04:09:42",
    "name": "[v5,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_CB66DA3977B9E9EB16D054FF9A2CC82DEC06@qq.com/mbox/",
    "series": [
        {
            "id": 24980,
            "url": "http://patchwork.dpdk.org/api/series/24980/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=24980",
            "date": "2022-10-05T04:09:42",
            "name": "introduce memarea library",
            "version": 5,
            "mbox": "http://patchwork.dpdk.org/series/24980/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/117356/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 0CE0AA0542;\n\tWed,  5 Oct 2022 06:10:01 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id A27DC40A7D;\n\tWed,  5 Oct 2022 06:10:00 +0200 (CEST)",
            "from out203-205-221-242.mail.qq.com (out203-205-221-242.mail.qq.com\n [203.205.221.242])\n by mails.dpdk.org (Postfix) with ESMTP id 7C8C140041\n for <dev@dpdk.org>; Wed,  5 Oct 2022 06:09:58 +0200 (CEST)",
            "from qq.com ([120.229.93.179])\n by newxmesmtplogicsvrsza31.qq.com (NewEsmtp) with SMTP\n id 27598E97; Wed, 05 Oct 2022 12:09:53 +0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=qq.com; s=s201512;\n t=1664942995; bh=6lpwnjs8NBqVG4SdwT/E1YpL1VbTfm40yfiYw4VY6Hg=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References;\n b=pB/GP2nGSzLFPDb4V/KXCU+dAuhR8JpRLhl6AHSlAoUPdl8/KK7SQN5qufo8PSGlW\n ec3MF/+zClISnOPYRp7QTeGPWHDh9H7OjByVnHjMDF1j31Y0Mm0XOBF5Gg7w+bd2aU\n 3tZMbwaCuz0/JaGHWSdoZWxwjonUTujCYCyNs6Mo=",
        "X-QQ-mid": "xmsmtpt1664942993tr24oxhz9",
        "Message-ID": "<tencent_CB66DA3977B9E9EB16D054FF9A2CC82DEC06@qq.com>",
        "X-QQ-XMAILINFO": "MVKy59SpMLfUuZ22MmEqGPMlPwfSL/yI7dacmI1741JeB4Vdte6UXOvtIOnnvY\n HFTfWa9NUIUR5CYKKh3UhTmF4+mrTLmuDUYHHbd5fa61AmVo64NiyxF6xhsP8WYwYhZpfxs0+H0A\n PoG7QTaCYYUJLf87FH+a0oDB8xgDriT1HjyNpx/WL0BxshtvcUQ1MsixDABoUYrE7+tOTBP/bCnb\n I2PEcNVtt1oYZvAypTHM5T3uYQNBpbth3x9b2eC/I3VxR5xj2uZu/IZf6sYNwBeFtzi89OiboZDf\n TSLj0yJ/9mqHr3QIArsGbwmdFow2S6CjTcfHlX+UuRhGjfuELb8AbhcV7sLef2AFHx5eMu6oYh6v\n eFuUVbqOybvFS3MFZv/+/ioj3g4YXyzoscvZg4FCgaKiI4PpCZamy3sDzCD+hpg+pgwZ5NkoNoRE\n /5/Z6vQLG1MZo5Wo8Iv/a81zHvcTg7TN9KhDm3oIXgJ378MW4HHsrFXeO3dFCymYt1Ly0HGiBzlb\n V8zyZ0W6Vgo1y1zxwclwzAJyQ6+SXSLH9dRdNlKqXXw/b5MGJ7yZKJ0K8RIevKI9JcmN4theJJVh\n se1b1DdN8h5pwMrBMJijWn3j4c4tOOHAnbDtQRAbPWd7ucUtFx0aYOEYL8wjgCPHrOeDUKv6cj81\n udqGkUZayLlFuMRS6clFitX9GIuaAc2JRDTLjjnnhD7cJU+El3/Y7qyFriIG7cXFjpk7pGvD9Vll\n NwUyx7ugbgYnOL5z+tw9ge8ic/jrF5MQwokDpbNvI/u0fxp1OSw8xOXJ4wFrNkxy3iOGqCmLhtQY\n 3VPict/5mUlk0mFJEV4p8L8FEl4GDdOXpc0MtHaXM1HFaB0Dwl7vprb4QIFkAHKFR7MTkw7b41Lz\n lPc08UPvTPpCvCZ8nchXGrJBqE2n90p9AaxsWQg29OFyB+cRRFsg+4ann2x7q8ZsAuQ7gDingc9U\n L8pizG10sWsCea9U3O1La3/VZsURniG4LzM5HkB++UblCt4dtpjB82lj/bCa6ET+Ko0wJxnYBiuI\n Su13RLBYDmS3wt9HHoo7zYYxrhHVc=",
        "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 v5 00/10] introduce memarea library",
        "Date": "Wed,  5 Oct 2022 12:09:42 +0800",
        "X-OQ-MSGID": "<20221005040952.8166-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---\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                | 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"
}