Show a cover letter.

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

{
    "id": 82015,
    "url": "http://patches.dpdk.org/api/covers/82015/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/1603494392-7181-1-git-send-email-liang.j.ma@intel.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": "<1603494392-7181-1-git-send-email-liang.j.ma@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1603494392-7181-1-git-send-email-liang.j.ma@intel.com",
    "date": "2020-10-23T23:06:22",
    "name": "[v9,00/10] Add PMD power mgmt",
    "submitter": {
        "id": 904,
        "url": "http://patches.dpdk.org/api/people/904/?format=api",
        "name": "Liang, Ma",
        "email": "liang.j.ma@intel.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/1603494392-7181-1-git-send-email-liang.j.ma@intel.com/mbox/",
    "series": [
        {
            "id": 13288,
            "url": "http://patches.dpdk.org/api/series/13288/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=13288",
            "date": "2020-10-23T23:06:22",
            "name": "Add PMD power mgmt",
            "version": 9,
            "mbox": "http://patches.dpdk.org/series/13288/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/82015/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 53A28A04B0;\n\tSat, 24 Oct 2020 01:06:52 +0200 (CEST)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 5B4F55AA3;\n\tSat, 24 Oct 2020 01:06:50 +0200 (CEST)",
            "from mga01.intel.com (mga01.intel.com [192.55.52.88])\n by dpdk.org (Postfix) with ESMTP id 8ECFD5A62\n for <dev@dpdk.org>; Sat, 24 Oct 2020 01:06:47 +0200 (CEST)",
            "from fmsmga007.fm.intel.com ([10.253.24.52])\n by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 23 Oct 2020 16:06:44 -0700",
            "from irvmail001.ir.intel.com ([163.33.26.43])\n by fmsmga007.fm.intel.com with ESMTP; 23 Oct 2020 16:06:41 -0700",
            "from sivswdev09.ir.intel.com (sivswdev09.ir.intel.com\n [10.237.217.48])\n by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id\n 09NN6emW016401; Sat, 24 Oct 2020 00:06:40 +0100",
            "from sivswdev09.ir.intel.com (localhost [127.0.0.1])\n by sivswdev09.ir.intel.com with ESMTP id 09NN6eVW007317;\n Sat, 24 Oct 2020 00:06:40 +0100",
            "(from lma25@localhost)\n by sivswdev09.ir.intel.com with LOCAL id 09NN6dQX007300;\n Sat, 24 Oct 2020 00:06:39 +0100"
        ],
        "IronPort-SDR": [
            "\n xFE0JkzSUwvA468b9tfq3Lp/xiPyno7iVgdTD6dav8B041+X8rNfRiHQd6z6MGL+MS4zkh3WXI\n Mpn+KN2M/OGQ==",
            "\n FfrwhH1SF/3N1OfL3FkQu1LQOwTytRtXMhabPVCC2weTD6yiaI/QxgJqmGFgtW1UwzrMPNfZUQ\n 7UZjdDxLK83w=="
        ],
        "X-IronPort-AV": [
            "E=McAfee;i=\"6000,8403,9783\"; a=\"185449680\"",
            "E=Sophos;i=\"5.77,410,1596524400\"; d=\"scan'208\";a=\"185449680\"",
            "E=Sophos;i=\"5.77,410,1596524400\"; d=\"scan'208\";a=\"302907083\""
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "From": "Liang Ma <liang.j.ma@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "anatoly.burakov@intel.com, viktorin@rehivetech.com, qi.z.zhang@intel.com,\n ruifeng.wang@arm.com, beilei.xing@intel.com, jia.guo@intel.com,\n qiming.yang@intel.com, haiyue.wang@intel.com,\n bruce.richardson@intel.com, konstantin.ananyev@intel.com,\n david.hunt@intel.com, jerinjacobk@gmail.com, nhorman@tuxdriver.com,\n thomas@monjalon.net, timothy.mcdaniel@intel.com, gage.eads@intel.com,\n drc@linux.vnet.ibm.com, Liang Ma <liang.j.ma@intel.com>",
        "Date": "Sat, 24 Oct 2020 00:06:22 +0100",
        "Message-Id": "<1603494392-7181-1-git-send-email-liang.j.ma@intel.com>",
        "X-Mailer": "git-send-email 1.7.7.4",
        "In-Reply-To": [
            "<n>",
            "<1603473432-11153-1-git-send-email-liang.j.ma@intel.com>"
        ],
        "References": [
            "<n>",
            "<1603473432-11153-1-git-send-email-liang.j.ma@intel.com>"
        ],
        "Subject": "[dpdk-dev] [PATCH v9 00/10] Add PMD power mgmt",
        "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 <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",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "This patchset proposes a simple API for Ethernet drivers\nto cause the CPU to enter a power-optimized state while\nwaiting for packets to arrive, along with a set of\ngeneric intrinsics that facilitate that. This is achieved\nthrough cooperation with the NIC driver that will allow\nus to know address of wake up event, and wait for writes\non it.\n\nOn IA, this is achieved through using UMONITOR/UMWAIT\ninstructions. They are used in their raw opcode form\nbecause there is no widespread compiler support for\nthem yet. Still, the API is made generic enough to\nhopefully support other architectures, if they happen\nto implement similar instructions.\n\nTo achieve power savings, there is a very simple mechanism\nused: we're counting empty polls, and if a certain threshold\nis reached, we get the address of next RX ring descriptor\nfrom the NIC driver, arm the monitoring hardware, and\nenter a power-optimized state. We will then wake up when\neither a timeout happens, or a write happens (or generally\nwhenever CPU feels like waking up - this is platform-\nspecific), and proceed as normal. The empty poll counter is\nreset whenever we actually get packets, so we only go to\nsleep when we know nothing is going on. The mechanism is\ngeneric which can be used for any write back descriptor.\n\nWhy are we putting it into ethdev as opposed to leaving\nthis up to the application? Our customers specifically\nrequested a way to do it wit minimal changes to the\napplication code. The current approach allows to just\nflip a switch and automatically have power savings.\n\n- Only 1:1 core to queue mapping is supported,\n  meaning that each lcore must at most handle RX on a\n  single queue\n- Support 3 type policies. UMWAIT/PAUSE/Frequency_Scale\n- Power management is enabled per-queue\n- The API doesn't extend to other device types\n\nLiang Ma (10):\n  eal: add new x86 cpuid support for WAITPKG\n  eal: add power management intrinsics\n  eal: add intrinsics support check infrastructure\n  ethdev: add simple power management API\n  power: add PMD power management API and callback\n  net/ixgbe: implement power management API\n  net/i40e: implement power management API\n  net/ice: implement power management API\n  examples/l3fwd-power: enable PMD power mgmt\n  doc: update programmer's guide for power library\n\n doc/guides/prog_guide/power_man.rst           |  42 +++\n doc/guides/rel_notes/release_20_11.rst        |  16 +\n .../sample_app_ug/l3_forward_power_man.rst    |  13 +\n drivers/net/i40e/i40e_ethdev.c                |   1 +\n drivers/net/i40e/i40e_rxtx.c                  |  26 ++\n drivers/net/i40e/i40e_rxtx.h                  |   2 +\n drivers/net/ice/ice_ethdev.c                  |   1 +\n drivers/net/ice/ice_rxtx.c                    |  26 ++\n drivers/net/ice/ice_rxtx.h                    |   2 +\n drivers/net/ixgbe/ixgbe_ethdev.c              |   1 +\n drivers/net/ixgbe/ixgbe_rxtx.c                |  25 ++\n drivers/net/ixgbe/ixgbe_rxtx.h                |   2 +\n examples/l3fwd-power/main.c                   |  46 ++-\n lib/librte_eal/arm/include/meson.build        |   1 +\n .../arm/include/rte_power_intrinsics.h        |  60 ++++\n lib/librte_eal/arm/rte_cpuflags.c             |   6 +\n lib/librte_eal/include/generic/rte_cpuflags.h |  26 ++\n .../include/generic/rte_power_intrinsics.h    | 123 +++++++\n lib/librte_eal/include/meson.build            |   1 +\n lib/librte_eal/ppc/include/meson.build        |   1 +\n .../ppc/include/rte_power_intrinsics.h        |  60 ++++\n lib/librte_eal/ppc/rte_cpuflags.c             |   7 +\n lib/librte_eal/version.map                    |   1 +\n lib/librte_eal/x86/include/meson.build        |   1 +\n lib/librte_eal/x86/include/rte_cpuflags.h     |   1 +\n .../x86/include/rte_power_intrinsics.h        | 135 ++++++++\n lib/librte_eal/x86/rte_cpuflags.c             |  14 +\n lib/librte_ethdev/rte_ethdev.c                |  23 ++\n lib/librte_ethdev/rte_ethdev.h                |  28 ++\n lib/librte_ethdev/rte_ethdev_driver.h         |  28 ++\n lib/librte_ethdev/version.map                 |   1 +\n lib/librte_power/meson.build                  |   5 +-\n lib/librte_power/rte_power_pmd_mgmt.c         | 320 ++++++++++++++++++\n lib/librte_power/rte_power_pmd_mgmt.h         |  92 +++++\n lib/librte_power/version.map                  |   4 +\n 35 files changed, 1138 insertions(+), 3 deletions(-)\n create mode 100644 lib/librte_eal/arm/include/rte_power_intrinsics.h\n create mode 100644 lib/librte_eal/include/generic/rte_power_intrinsics.h\n create mode 100644 lib/librte_eal/ppc/include/rte_power_intrinsics.h\n create mode 100644 lib/librte_eal/x86/include/rte_power_intrinsics.h\n create mode 100644 lib/librte_power/rte_power_pmd_mgmt.c\n create mode 100644 lib/librte_power/rte_power_pmd_mgmt.h"
}