Show a cover letter.

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

{
    "id": 71455,
    "url": "http://patches.dpdk.org/api/covers/71455/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20200612212434.6852-1-timothy.mcdaniel@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": "<20200612212434.6852-1-timothy.mcdaniel@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20200612212434.6852-1-timothy.mcdaniel@intel.com",
    "date": "2020-06-12T21:24:07",
    "name": "[00/27] V1 event/dlb add Intel DLB PMD",
    "submitter": {
        "id": 826,
        "url": "http://patches.dpdk.org/api/people/826/?format=api",
        "name": "Timothy McDaniel",
        "email": "timothy.mcdaniel@intel.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20200612212434.6852-1-timothy.mcdaniel@intel.com/mbox/",
    "series": [
        {
            "id": 10445,
            "url": "http://patches.dpdk.org/api/series/10445/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=10445",
            "date": "2020-06-12T21:24:07",
            "name": "V1 event/dlb add Intel DLB PMD",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/10445/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/71455/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 88197A00BE;\n\tFri, 12 Jun 2020 23:26:21 +0200 (CEST)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id D78B21BED9;\n\tFri, 12 Jun 2020 23:26:20 +0200 (CEST)",
            "from mga07.intel.com (mga07.intel.com [134.134.136.100])\n by dpdk.org (Postfix) with ESMTP id 009AA1BED2\n for <dev@dpdk.org>; Fri, 12 Jun 2020 23:26:18 +0200 (CEST)",
            "from orsmga003.jf.intel.com ([10.7.209.27])\n by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 12 Jun 2020 14:26:18 -0700",
            "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by orsmga003.jf.intel.com with ESMTP; 12 Jun 2020 14:26:17 -0700"
        ],
        "IronPort-SDR": [
            "\n n/Sgjt70LAHT7UOoIljaK70qUIXWk7k6UwigiAmJI44auh+Jni7QiMfCTJr5EXRguz2h8yl93W\n q8qSAvH0bK8Q==",
            "\n SAxxHKOblgV9+qPYhJ7OGd6fQaJnsjIcHYaDukW6qS30ZB3xvrLILKDgtdEWkG46ql13GIROVT\n GsrtABAWCZMA=="
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.73,504,1583222400\"; d=\"scan'208\";a=\"272035756\"",
        "From": "\"McDaniel, Timothy\" <timothy.mcdaniel@intel.com>",
        "To": "jerinj@marvell.com",
        "Cc": "dev@dpdk.org,\n\tgage.eads@intel.com,\n\tharry.van.haaren@intel.com",
        "Date": "Fri, 12 Jun 2020 16:24:07 -0500",
        "Message-Id": "<20200612212434.6852-1-timothy.mcdaniel@intel.com>",
        "X-Mailer": "git-send-email 2.13.6",
        "Subject": "[dpdk-dev] [PATCH 00/27] V1 event/dlb add Intel DLB PMD",
        "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": "Hello Jerin and the DPDK community.\n\n    The following patchset adds support for a new eventdev PMD. The DLB\n    PMD adds support for the Intel Dynamic Load Balancer (DLB) hardware.\n    The DLB is a PCIe device that provides load-balanced, prioritized\n    scheduling of core-to-core communication. The device consists of\n    queues and arbiters that connect producer and consumer cores, and\n    implements load-balanced queueing features including:\n    - Lock-free multi-producer/multi-consumer operation.\n    - Multiple priority levels for varying traffic types.\n    - 'Direct' traffic (i.e. multi-producer/single-consumer)\n    - Simple unordered load-balanced distribution.\n    - Atomic lock-free load balancing across multiple consumers.\n    - Queue element reordering feature allowing ordered load-balanced\n      distribution.\n   \n    The DLB hardware supports both load balanced and directed ports and\n    queues. Unlike other eventdev devices already in the repo,  not all\n    DLB ports and queues are equally capable. In particular, directed\n    ports are limited to a single link, and must be connected to a directed\n    queue.\n    Additionally, even though LDB ports may link multiple queues, the\n    number of queues that may be linked is limited by hardware. Another\n    difference is that DLB does not have a straightforward way of carrying\n    the flow_id in the queue elements (QE) that the hardware operates on.\n   \n    Due to the above restrictions, we would like to extend the eventdev\n    interface in manner that allows our PMD to take full advantage of\n    the DLB hardware, while also adding useful functionality for non-Intel\n    PMDs. Our proposed changes are contained in the first two patches\n    in this patchset.\n   \n    While reviewing the code, please be aware that this PMD has full\n    control over the DLB hardware. Intel will be extending the DLB PMD\n    in the future (not as part of this first series) with a mode that we\n    refer to as the bifurcated PMD. The bifurcated PMD communicates with a\n    kernel driver to configure the device, ports, and queues, and memory\n    maps device MMIO so datapath operations occur purely in user-space.\n   \n    The framework to support both the PF PMD and bifurcated PMD exists in\n    this patchset, and is why the iface.[ch] layer is present.\n   \n    Thank You and Best Regards,\n   \n    Tim McDaniel\n\n\nMcDaniel, Timothy (27):\n  eventdev: dlb upstream prerequisites\n  eventdev: do not pass disable_implicit_release bit to trace macro\n  event/dlb: add shared code version 10.7.9\n  event/dlb: add make and meson build infrastructure\n  event/dlb: add DLB documentation\n  event/dlb: add dynamic logging\n  event/dlb: add private data structures and constants\n  event/dlb: add definitions shared with LKM or shared code\n  event/dlb: inline functions used in multiple files\n  event/dlb: add PFPMD-specific interface layer to shared code\n  event/dlb: add flexible PMD to device interfaces\n  event/dlb: add the PMD's public interfaces\n  event/dlb: add xstats support\n  event/dlb: add PMD self-tests\n  event/dlb: add probe\n  event/dlb: add infos_get and configure\n  event/dlb: add queue_def_conf and port_def_conf\n  event/dlb: add queue setup\n  event/dlb: add port_setup\n  event/dlb: add port_link\n  event/dlb: add queue_release and port_release\n  event/dlb: add port_unlink and port_unlinks_in_progress\n  event/dlb: add eventdev_start\n  event/dlb: add timout_ticks, dump, xstats, and selftest\n  event/dlb: add enqueue and its burst variants\n  event/dlb: add dequeue, dequeue_burst, and variants\n  event/dlb: add eventdev_stop and eventdev_close\n\n app/test-eventdev/evt_common.h                     |    1 +\n app/test-eventdev/test_order_atq.c                 |    4 +\n app/test-eventdev/test_order_common.c              |    6 +-\n app/test-eventdev/test_order_queue.c               |    4 +\n app/test-eventdev/test_perf_atq.c                  |    1 +\n app/test-eventdev/test_perf_queue.c                |    1 +\n app/test-eventdev/test_pipeline_atq.c              |    1 +\n app/test-eventdev/test_pipeline_queue.c            |    1 +\n app/test/test_eventdev.c                           |    4 +-\n config/common_base                                 |   17 +\n config/rte_config.h                                |    6 +\n doc/guides/eventdevs/dlb.rst                       |  497 +\n drivers/event/Makefile                             |    5 +\n drivers/event/dlb/Makefile                         |   36 +\n drivers/event/dlb/dlb.c                            | 4306 +++++++++\n drivers/event/dlb/dlb_iface.c                      |  105 +\n drivers/event/dlb/dlb_iface.h                      |   92 +\n drivers/event/dlb/dlb_inline_fns.h                 |   80 +\n drivers/event/dlb/dlb_log.h                        |   24 +\n drivers/event/dlb/dlb_priv.h                       |  595 ++\n drivers/event/dlb/dlb_selftest.c                   | 1628 ++++\n drivers/event/dlb/dlb_user.h                       | 1351 +++\n drivers/event/dlb/dlb_xstats.c                     | 1251 +++\n drivers/event/dlb/meson.build                      |   16 +\n drivers/event/dlb/pf/base/dlb_hw_types.h           |  360 +\n drivers/event/dlb/pf/base/dlb_mbox.h               |  645 ++\n drivers/event/dlb/pf/base/dlb_osdep.h              |  350 +\n drivers/event/dlb/pf/base/dlb_osdep_bitmap.h       |  449 +\n drivers/event/dlb/pf/base/dlb_osdep_list.h         |  131 +\n drivers/event/dlb/pf/base/dlb_osdep_types.h        |   31 +\n drivers/event/dlb/pf/base/dlb_regs.h               | 2646 ++++++\n drivers/event/dlb/pf/base/dlb_resource.c           | 9699 ++++++++++++++++++++\n drivers/event/dlb/pf/base/dlb_resource.h           | 1625 ++++\n drivers/event/dlb/pf/base/dlb_user.h               | 1084 +++\n drivers/event/dlb/pf/dlb_main.c                    |  670 ++\n drivers/event/dlb/pf/dlb_main.h                    |   90 +\n drivers/event/dlb/pf/dlb_pf.c                      |  839 ++\n drivers/event/dlb/rte_pmd_dlb.c                    |   39 +\n drivers/event/dlb/rte_pmd_dlb.h                    |   69 +\n drivers/event/dlb/rte_pmd_dlb_event_version.map    |    6 +\n drivers/event/dpaa2/dpaa2_eventdev.c               |    2 +-\n drivers/event/meson.build                          |    3 +\n drivers/event/octeontx/ssovf_evdev.c               |    2 +-\n drivers/event/skeleton/skeleton_eventdev.c         |    2 +-\n drivers/event/sw/sw_evdev.c                        |    5 +-\n drivers/event/sw/sw_evdev_selftest.c               |    9 +-\n .../eventdev_pipeline/pipeline_worker_generic.c    |    8 +-\n examples/eventdev_pipeline/pipeline_worker_tx.c    |    3 +\n examples/l2fwd-event/l2fwd_event_generic.c         |    5 +-\n examples/l2fwd-event/l2fwd_event_internal_port.c   |    5 +-\n examples/l3fwd/l3fwd_event_generic.c               |    5 +-\n examples/l3fwd/l3fwd_event_internal_port.c         |    5 +-\n lib/librte_eal/x86/include/rte_cpuflags.h          |    1 +\n lib/librte_eal/x86/rte_cpuflags.c                  |    1 +\n lib/librte_eventdev/rte_event_crypto_adapter.c     |    7 +-\n lib/librte_eventdev/rte_event_eth_tx_adapter.c     |   16 +-\n lib/librte_eventdev/rte_eventdev.c                 |   72 +-\n lib/librte_eventdev/rte_eventdev.h                 |   51 +-\n lib/librte_eventdev/rte_eventdev_pmd_pci.h         |   54 +\n lib/librte_eventdev/rte_eventdev_trace.h           |   15 +-\n 60 files changed, 28987 insertions(+), 49 deletions(-)\n create mode 100644 doc/guides/eventdevs/dlb.rst\n create mode 100644 drivers/event/dlb/Makefile\n create mode 100644 drivers/event/dlb/dlb.c\n create mode 100644 drivers/event/dlb/dlb_iface.c\n create mode 100644 drivers/event/dlb/dlb_iface.h\n create mode 100644 drivers/event/dlb/dlb_inline_fns.h\n create mode 100644 drivers/event/dlb/dlb_log.h\n create mode 100644 drivers/event/dlb/dlb_priv.h\n create mode 100644 drivers/event/dlb/dlb_selftest.c\n create mode 100644 drivers/event/dlb/dlb_user.h\n create mode 100644 drivers/event/dlb/dlb_xstats.c\n create mode 100644 drivers/event/dlb/meson.build\n create mode 100644 drivers/event/dlb/pf/base/dlb_hw_types.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_mbox.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_osdep.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_osdep_bitmap.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_osdep_list.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_osdep_types.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_regs.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_resource.c\n create mode 100644 drivers/event/dlb/pf/base/dlb_resource.h\n create mode 100644 drivers/event/dlb/pf/base/dlb_user.h\n create mode 100644 drivers/event/dlb/pf/dlb_main.c\n create mode 100644 drivers/event/dlb/pf/dlb_main.h\n create mode 100644 drivers/event/dlb/pf/dlb_pf.c\n create mode 100644 drivers/event/dlb/rte_pmd_dlb.c\n create mode 100644 drivers/event/dlb/rte_pmd_dlb.h\n create mode 100644 drivers/event/dlb/rte_pmd_dlb_event_version.map"
}