Show a cover letter.

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

{
    "id": 40769,
    "url": "http://patches.dpdk.org/api/covers/40769/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20180607073705.32895-1-david.hunt@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": "<20180607073705.32895-1-david.hunt@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20180607073705.32895-1-david.hunt@intel.com",
    "date": "2018-06-07T07:36:59",
    "name": "[dpdk-dev,v1,0/6] examples/vm_power: 100% Busy Polling",
    "submitter": {
        "id": 342,
        "url": "http://patches.dpdk.org/api/people/342/?format=api",
        "name": "Hunt, David",
        "email": "david.hunt@intel.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20180607073705.32895-1-david.hunt@intel.com/mbox/",
    "series": [
        {
            "id": 33,
            "url": "http://patches.dpdk.org/api/series/33/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=33",
            "date": "2018-06-07T07:36:59",
            "name": "examples/vm_power: 100% Busy Polling",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/33/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/40769/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 2C1B91B3D4;\n\tThu,  7 Jun 2018 16:39:54 +0200 (CEST)",
            "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n\tby dpdk.org (Postfix) with ESMTP id 724AB1B1E3\n\tfor <dev@dpdk.org>; Thu,  7 Jun 2018 16:39:52 +0200 (CEST)",
            "from fmsmga001.fm.intel.com ([10.253.24.23])\n\tby orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t07 Jun 2018 07:39:51 -0700",
            "from silpixa00399952.ir.intel.com (HELO\n\tsilpixa00399952.ger.corp.intel.com) ([10.237.223.64])\n\tby fmsmga001.fm.intel.com with ESMTP; 07 Jun 2018 07:39:50 -0700"
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.49,486,1520924400\"; d=\"scan'208\";a=\"62111488\"",
        "From": "David Hunt <david.hunt@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "david.hunt@intel.com",
        "Date": "Thu,  7 Jun 2018 08:36:59 +0100",
        "Message-Id": "<20180607073705.32895-1-david.hunt@intel.com>",
        "X-Mailer": "git-send-email 2.17.0",
        "Subject": "[dpdk-dev] [PATCH v1 0/6] examples/vm_power: 100% Busy Polling",
        "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://dpdk.org/ml/options/dev>,\n\t<mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://dpdk.org/ml/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://dpdk.org/ml/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "This patch set adds the capability to do out-of-band power\nmonitoring on a systemi by detecting when a core is doing 100%\nbusy polling, but not handling any packets.\n\nIt uses a thread to monitor the branch counters in the targeted\ncores, and calculates the branch ratio if the running code.\n\nIf the branch ratop is low (0.01), then\nthe code is most likely running in a tight poll loop and doing\nnothing, i.e. receiving no packets. In this case we scale down\nthe frequency of that core.\n\nIf the branch ratio is higher (>0.01), then it is likely that\nthe code is receiving and processing packets. In this case, we\nscale up the frequency of that core.\n\nThe cpu counters are read via /dev/cpu/x/msr, so requires the\nmsr kernel module to be loaded. Because this method is used,\nthe patch set is implemented with one file for x86 systems, and\nanother for non-x86 systems, with conditional compilation in\nthe Makefile. The non-x86 functions are stubs, and do not\ncurrently implement any functionality.\n\nThe vm_power_manager app has been modified to take a new parameter\n   --core-list or -l\nwhich takes a list of cores in a comma-separated list format,\ne.g. 1,3,5-7,9, which resolvest to a core list of 1,3,5,6,7,9\nThese cores will then be enabled for oob monitoring. When the\nOOB monitoring thread starts, it reads the branch hits/miss\ncounters of each monitored core, and scales up/down accordingly.\n\n[1/6] examples/vm_power: add check for port count\n[2/6] examples/vm_power: add core list parameter\n[3/6] examples/vm_power: add oob monitoring functions\n[4/6] examples/vm_power: allow greater than 64 cores\n[5/6] examples/vm_power: add thread for oob core monitor\n[6/6] examples/vm_power: add port-list to command line"
}