Show a cover letter.

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

{
    "id": 55668,
    "url": "http://patches.dpdk.org/api/covers/55668/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/1561911676-37718-1-git-send-email-gavin.hu@arm.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": "<1561911676-37718-1-git-send-email-gavin.hu@arm.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1561911676-37718-1-git-send-email-gavin.hu@arm.com",
    "date": "2019-06-30T16:21:11",
    "name": "[RFC,0/5] use WFE for locks and ring on aarch64",
    "submitter": {
        "id": 1018,
        "url": "http://patches.dpdk.org/api/people/1018/?format=api",
        "name": "Gavin Hu",
        "email": "gavin.hu@arm.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/1561911676-37718-1-git-send-email-gavin.hu@arm.com/mbox/",
    "series": [
        {
            "id": 5234,
            "url": "http://patches.dpdk.org/api/series/5234/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=5234",
            "date": "2019-06-30T16:21:11",
            "name": "use WFE for locks and ring on aarch64",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/5234/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/55668/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@dpdk.org",
        "Delivered-To": "patchwork@dpdk.org",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id D15477CBC;\n\tSun, 30 Jun 2019 18:21:41 +0200 (CEST)",
            "from foss.arm.com (foss.arm.com [217.140.110.172])\n\tby dpdk.org (Postfix) with ESMTP id 34E785689\n\tfor <dev@dpdk.org>; Sun, 30 Jun 2019 18:21:40 +0200 (CEST)",
            "from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14])\n\tby usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 4832B344;\n\tSun, 30 Jun 2019 09:21:39 -0700 (PDT)",
            "from net-arm-thunderx2.shanghai.arm.com\n\t(net-arm-thunderx2.shanghai.arm.com [10.169.40.40])\n\tby usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id\n\t6317F3F718; Sun, 30 Jun 2019 09:21:37 -0700 (PDT)"
        ],
        "From": "Gavin Hu <gavin.hu@arm.com>",
        "To": "dev@dpdk.org",
        "Cc": "thomas@monjalon.net, jerinj@marvell.com, hemant.agrawal@nxp.com,\n\tbruce.richardson@intel.com, chaozhu@linux.vnet.ibm.com,\n\tHonnappa.Nagarahalli@arm.com, nd@arm.com, gavin.hu@arm.com",
        "Date": "Mon,  1 Jul 2019 00:21:11 +0800",
        "Message-Id": "<1561911676-37718-1-git-send-email-gavin.hu@arm.com>",
        "X-Mailer": "git-send-email 2.7.4",
        "Subject": "[dpdk-dev] [RFC 0/5] use WFE for locks and ring on aarch64",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.15",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n\t<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\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "DPDK has multiple use cases where the core repeatedly polls a location in\nmemory. This polling results in many cache and memory transactions.\n\nArm architecture provides WFE (Wait For Event) instruction, which allows\nthe cpu core to enter a low power state until woken up by the update to the\nmemory location being polled. Thus reducing the cache and memory\ntransactions.\n\nx86 has the PAUSE hint instruction to reduce such overhead.\n\nThe rte_wait_until_equal_xxx APIs abstract the functionality of 'polling\nfor a memory location to become equal to a given value'.\n\nFor non-Arm platforms, these APIs are just wrappers around do-while loop\nwith rte_pause, so there are no performance differences.\n\nFor Arm platforms, use of WFE can be configured using CONFIG_RTE_USE_WFE\noption. It is disabled by default.\n\nCurrently, use of WFE is supported only for aarch64 platforms. armv7\nplatforms do support the WFE instruction, but they require explicit wake up\nevents(sev) and are less performannt.\n\nTesting shows that, performance varies across different platforms, with\nsome showing degradation.\n\nCONFIG_RTE_USE_WFE should be enabled depending on the performance on the\ntarget platforms.\n\nGavin Hu (5):\n  eal: add the APIs to wait until equal\n  ticketlock: use new API to reduce contention on aarch64\n  ring: use wfe to wait for ring tail update on aarch64\n  spinlock: use wfe to reduce contention on aarch64\n  config: add WFE config entry for aarch64\n\n config/arm/meson.build                             |   1 +\n config/common_armv8a_linux                         |   6 +\n .../common/include/arch/arm/rte_pause_64.h         | 143 +++++++++++++++++++++\n .../common/include/arch/arm/rte_spinlock.h         |  25 ++++\n lib/librte_eal/common/include/generic/rte_pause.h  |  20 +++\n .../common/include/generic/rte_spinlock.h          |   2 +-\n .../common/include/generic/rte_ticketlock.h        |   4 +-\n lib/librte_ring/rte_ring_c11_mem.h                 |   5 +-\n lib/librte_ring/rte_ring_generic.h                 |   4 +-\n 9 files changed, 203 insertions(+), 7 deletions(-)"
}