Patch Detail

HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 26218,
    "url": "http://patches.dpdk.org/api/patches/26218/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/1499031314-7172-8-git-send-email-harry.van.haaren@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": "<1499031314-7172-8-git-send-email-harry.van.haaren@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1499031314-7172-8-git-send-email-harry.van.haaren@intel.com",
    "date": "2017-07-02T21:35:14",
    "name": "[dpdk-dev,v3,7/7] doc: add service cores to doc and release notes",
    "commit_ref": null,
    "pull_url": null,
    "state": "changes-requested",
    "archived": true,
    "hash": "8f6df4af9e95ed8f64f6c614d033bb6e15838693",
    "submitter": {
        "id": 317,
        "url": "http://patches.dpdk.org/api/people/317/?format=api",
        "name": "Van Haaren, Harry",
        "email": "harry.van.haaren@intel.com"
    },
    "delegate": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/users/1/?format=api",
        "username": "tmonjalo",
        "first_name": "Thomas",
        "last_name": "Monjalon",
        "email": "thomas@monjalon.net"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/1499031314-7172-8-git-send-email-harry.van.haaren@intel.com/mbox/",
    "series": [],
    "comments": "http://patches.dpdk.org/api/patches/26218/comments/",
    "check": "fail",
    "checks": "http://patches.dpdk.org/api/patches/26218/checks/",
    "tags": {},
    "related": [],
    "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 [IPv6:::1])\n\tby dpdk.org (Postfix) with ESMTP id D0A757CBB;\n\tSun,  2 Jul 2017 23:35:32 +0200 (CEST)",
            "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n\tby dpdk.org (Postfix) with ESMTP id CF33E7CAC\n\tfor <dev@dpdk.org>; Sun,  2 Jul 2017 23:35:29 +0200 (CEST)",
            "from orsmga003.jf.intel.com ([10.7.209.27])\n\tby orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t02 Jul 2017 14:35:28 -0700",
            "from silpixa00398672.ir.intel.com ([10.237.223.128])\n\tby orsmga003.jf.intel.com with ESMTP; 02 Jul 2017 14:35:27 -0700"
        ],
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.40,299,1496127600\"; d=\"scan'208\";a=\"987948527\"",
        "From": "Harry van Haaren <harry.van.haaren@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "jerin.jacob@caviumnetworks.com, thomas@monjalon.net,\n\tkeith.wiles@intel.com, bruce.richardson@intel.com,\n\tHarry van Haaren <harry.van.haaren@intel.com>",
        "Date": "Sun,  2 Jul 2017 22:35:14 +0100",
        "Message-Id": "<1499031314-7172-8-git-send-email-harry.van.haaren@intel.com>",
        "X-Mailer": "git-send-email 2.7.4",
        "In-Reply-To": "<1499031314-7172-1-git-send-email-harry.van.haaren@intel.com>",
        "References": "<1498735421-100164-1-git-send-email-harry.van.haaren@intel.com>\n\t<1499031314-7172-1-git-send-email-harry.van.haaren@intel.com>",
        "Subject": "[dpdk-dev] [PATCH v3 7/7] doc: add service cores to doc and release\n\tnotes",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.15",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<http://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": "<http://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": "Add a section describing the fundamental concepts behind service\ncores. Where service cores originate from, and how to enable services.\nThe release notes for 17.08 are updated, with an introductory paragraph\non the service cores concept. Finally the Eventdev SW PMD documentation\nis amended to reflect that it can be run as a service.\n\nSigned-off-by: Harry van Haaren <harry.van.haaren@intel.com>\n\n---\n\nI would like to enable the service-cores in the eventdev_pipeline\nsample app, to showcase the power of the service-core abstraction.\nThere is some remaining work TODO, in order to genericise the sample\napp for both HW and SW PMDs, and during that rework the service-cores\ncan be added too.\n\nThe sample app will make a good showcase for docs, and make it much\neasier to understand.\n---\n doc/guides/eventdevs/sw.rst             |  4 +-\n doc/guides/prog_guide/index.rst         |  1 +\n doc/guides/prog_guide/service_cores.rst | 81 +++++++++++++++++++++++++++++++++\n doc/guides/rel_notes/release_17_08.rst  |  8 ++++\n 4 files changed, 93 insertions(+), 1 deletion(-)\n create mode 100644 doc/guides/prog_guide/service_cores.rst",
    "diff": "diff --git a/doc/guides/eventdevs/sw.rst b/doc/guides/eventdevs/sw.rst\nindex fb63c84..a3e6624 100644\n--- a/doc/guides/eventdevs/sw.rst\n+++ b/doc/guides/eventdevs/sw.rst\n@@ -32,7 +32,9 @@ Software Eventdev Poll Mode Driver\n \n The software eventdev is an implementation of the eventdev API, that provides a\n wide range of the eventdev features. The eventdev relies on a CPU core to\n-perform event scheduling.\n+perform event scheduling. This PMD can use the service core library to run the\n+scheduling function, allowing an application to utilize the power of service\n+cores to multiplex other work on the same core if required.\n \n \n Features\ndiff --git a/doc/guides/prog_guide/index.rst b/doc/guides/prog_guide/index.rst\nindex ef5a02a..231622a 100644\n--- a/doc/guides/prog_guide/index.rst\n+++ b/doc/guides/prog_guide/index.rst\n@@ -38,6 +38,7 @@ Programmer's Guide\n     intro\n     overview\n     env_abstraction_layer\n+    service_cores\n     ring_lib\n     mempool_lib\n     mbuf_lib\ndiff --git a/doc/guides/prog_guide/service_cores.rst b/doc/guides/prog_guide/service_cores.rst\nnew file mode 100644\nindex 0000000..3a029ba\n--- /dev/null\n+++ b/doc/guides/prog_guide/service_cores.rst\n@@ -0,0 +1,81 @@\n+..  BSD LICENSE\n+    Copyright(c) 2017 Intel Corporation. All rights reserved.\n+    All rights reserved.\n+\n+    Redistribution and use in source and binary forms, with or without\n+    modification, are permitted provided that the following conditions\n+    are met:\n+\n+    * Redistributions of source code must retain the above copyright\n+    notice, this list of conditions and the following disclaimer.\n+    * Redistributions in binary form must reproduce the above copyright\n+    notice, this list of conditions and the following disclaimer in\n+    the documentation and/or other materials provided with the\n+    distribution.\n+    * Neither the name of Intel Corporation nor the names of its\n+    contributors may be used to endorse or promote products derived\n+    from this software without specific prior written permission.\n+\n+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n+    \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\n+    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\n+    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\n+    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\n+    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\n+    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\n+    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n+    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n+    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\n+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n+\n+Service Cores\n+=============\n+\n+DPDK has a concept known as service cores, which enables a dynamic way of\n+performing work on DPDK lcores. Service core support is built into the EAL, and\n+an API is provided to optionally allow applications to control how the service\n+cores are used at runtime.\n+\n+The service cores concept is built up out of services (components of DPDK that\n+require CPU cycles to operate) and service cores (DPDK lcores, tasked with\n+running services). The power of the service core concept is that the mapping\n+between service cores and services can be configured to abstract away the\n+difference between platforms and environments.\n+\n+For example, the Eventdev has hardware and software PMDs. Of these the software\n+PMD requires an lcore to perform the scheduling operations, while the hardware\n+PMD does not. With service cores, the application would not directly notice\n+that the scheduling is done in software.\n+\n+For detailed information about the service core API, please refer to the docs.\n+\n+Service Core Initialization\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+There are two methods to having service cores in a DPDK application, either by\n+using the service coremask, or by dynamically adding cores using the API.\n+The simpler of the two is to pass the `-s` coremask argument to EAL, which will\n+take any cores available in the main DPDK coremask, an if the bits are also set\n+in the service coremask the cores become service-cores instead of DPDK\n+application lcores.\n+\n+Enabling Services on Cores\n+~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Each registered service can be individually mapped to a service core, or set of\n+service cores. Enabling a service on a particular core means that the lcore in\n+question will run the service. Disabling that core on the service stops the\n+lcore in question from running the service.\n+\n+Using this method, it is possible to assign specific workloads to each\n+service core, and map N workloads to M number of service cores. Each service\n+lcore loops over the services that are enabled for that core, and invokes the\n+function to run the service.\n+\n+Service Core Statistics\n+~~~~~~~~~~~~~~~~~~~~~~~\n+\n+The service core library is capable of collecting runtime statistics like number\n+of calls to a specific service, and number of cycles used by the service. The\n+cycle count collection is dynamically configurable, allowing any application to\n+profile the services running on the system at any time.\ndiff --git a/doc/guides/rel_notes/release_17_08.rst b/doc/guides/rel_notes/release_17_08.rst\nindex 842f46f..2c8e78a 100644\n--- a/doc/guides/rel_notes/release_17_08.rst\n+++ b/doc/guides/rel_notes/release_17_08.rst\n@@ -41,6 +41,14 @@ New Features\n      Also, make sure to start the actual text at the margin.\n      =========================================================\n \n+* **Added Service Core functionality.**\n+\n+  The service core functionality added to EAL allows DPDK to run services such\n+  as SW PMDs on lcores without the application manually running them. The\n+  service core infrastructure allows flexibility of running multiple services\n+  on the same service lcore, and provides the application with powerful APIs to\n+  configure the mapping from service lcores to services.\n+\n * **Added Generic Flow API support to enic.**\n \n   Flow API support for outer Ethernet, VLAN, IPv4, IPv6, UDP, TCP, SCTP, VxLAN\n",
    "prefixes": [
        "dpdk-dev",
        "v3",
        "7/7"
    ]
}