Show a cover letter.

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

{
    "id": 83176,
    "url": "http://patches.dpdk.org/api/covers/83176/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/1604165181-19929-1-git-send-email-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": "<1604165181-19929-1-git-send-email-timothy.mcdaniel@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1604165181-19929-1-git-send-email-timothy.mcdaniel@intel.com",
    "date": "2020-10-31T17:25:58",
    "name": "[v9,00/23] Add DLB2 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/1604165181-19929-1-git-send-email-timothy.mcdaniel@intel.com/mbox/",
    "series": [
        {
            "id": 13528,
            "url": "http://patches.dpdk.org/api/series/13528/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=13528",
            "date": "2020-10-31T17:25:58",
            "name": "Add DLB2 PMD",
            "version": 9,
            "mbox": "http://patches.dpdk.org/series/13528/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/83176/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 D58E5A04DC;\n\tSat, 31 Oct 2020 18:24:42 +0100 (CET)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 244612BE3;\n\tSat, 31 Oct 2020 18:24:41 +0100 (CET)",
            "from mga17.intel.com (mga17.intel.com [192.55.52.151])\n by dpdk.org (Postfix) with ESMTP id BF1A22BE2\n for <dev@dpdk.org>; Sat, 31 Oct 2020 18:24:39 +0100 (CET)",
            "from orsmga006.jf.intel.com ([10.7.209.51])\n by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 31 Oct 2020 10:24:37 -0700",
            "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by orsmga006.jf.intel.com with ESMTP; 31 Oct 2020 10:24:37 -0700"
        ],
        "IronPort-SDR": [
            "\n 2A0GyU6eFUCVDpg8l6meu55669MpA1wc29u81WQ1+QJI+37gnGz+8HYzx89PE06ZTY/F0d+XF8\n tkEd+Knwc3KQ==",
            "\n uGzhX2mv6pKViZmryc0TFh/PUDSOjsebnNkvaumoadSsW+xw+1yTc0IIhfQL8bwGmMwKlVU/VE\n 2cQ2TZsZDBSA=="
        ],
        "X-IronPort-AV": [
            "E=McAfee;i=\"6000,8403,9791\"; a=\"148597781\"",
            "E=Sophos;i=\"5.77,438,1596524400\"; d=\"scan'208\";a=\"148597781\"",
            "E=Sophos;i=\"5.77,438,1596524400\"; d=\"scan'208\";a=\"324397983\""
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "From": "Timothy McDaniel <timothy.mcdaniel@intel.com>",
        "To": "",
        "Cc": "dev@dpdk.org, erik.g.carrillo@intel.com, gage.eads@intel.com,\n harry.van.haaren@intel.com, jerinj@marvell.com, thomas@monjalon.net",
        "Date": "Sat, 31 Oct 2020 12:25:58 -0500",
        "Message-Id": "<1604165181-19929-1-git-send-email-timothy.mcdaniel@intel.com>",
        "X-Mailer": "git-send-email 1.7.10",
        "In-Reply-To": "<1602958879-8558-2-git-send-email-timothy.mcdaniel@intel.com>",
        "References": "<1602958879-8558-2-git-send-email-timothy.mcdaniel@intel.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=UTF-8",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] =?utf-8?q?=5BPATCH_v9_00/23=5D_Add_DLB2_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": "The following patch series adds support for a new eventdev PMD. The DLB2\nPMD adds support for the Intel Dynamic Load Balancer 2.0 (DLB2)\nhardware.\nThe DLB2 is a PCIe device that provides load-balanced, prioritized\nscheduling of core-to-core communication. The device consists of\nqueues and arbiters that connect producer and consumer cores, and\nimplements 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\nThe DLB2 hardware supports both load balanced and directed ports and\nqueues. Unlike other eventdev devices already in the repo,  not all\nDLB2 ports and queues are equally capable. In particular, directed\nports are limited to a single link, and must be connected to a\ndirected queue. Additionally, even though LDB ports may link multiple\nqueues,\nthe number of queues that may be linked is limited by hardware.\n\nWhile reviewing the code, please be aware that this PMD has full\ncontrol over the DLB2 hardware. Intel will be extending the DLB2 PMD\nin the future (not as part of this first series) with a mode that we\nrefer to as the bifurcated PMD. The bifurcated PMD communicates with a\nkernel driver to configure the device, ports, and queues, and memory\nmaps device MMIO so datapath operations occur purely in user-space.\nNote that the DLB2 hardware is a successor of the DLB hardware, and\nas such is structured similarly, both in terms of code layout and\nimplementation.\n\nThe framework to support both the PF PMD and bifurcated PMD exists in\nthis patchset, and is why the iface.[ch] layer is present.\n\nChanges since V8:\n=================\n- Fixed format errors in doc/api/doxy-api-index.md\n- Delayed introduction of dlb2_consume_qe_immediate until\n  add-dequeue-and-its-burst-variants.patch\n- Delayed introduction of dlb2_construct_token_pop_qe until \n  add-PMD-s-token-pop-public-interface.patch\n\nChanges since V7:\n================\n- fix CENTOS build error: use __m128i instead of __v2di with\n  _mm_stream_si128\n- deleted unused dlb2_umwait and dlb2_umonitor functions\n\nChanges since V6:\n=================\n- removed unused function, fixing build error\n- fixed typo in port_setup commit message\n- this patch series is based on dpdk-next-eventdev\n\nChanges since V5:\n================\n- convert to use rte_power_monitor patches\n- replace __builtin_ia32_movntdq() with _mm_stream_si128()\n- remove unused functions in dlb_selftest.c\n- workaround for RHEL 7 gcc brace bug\n\nChanges since V4:\n================\n- moved introduction of dlb in relnotes_20_11 to first patch in series\n- fixed underlines in dlb.rst that were too short\n- note that the code still uses its private byte-encoded versions of\n  umonitor/umwait, rather than the new functions in the power\n  patch that are built on top of those intrinsics. This is intentional.\n\nChanges since V3:\n================\n- updated MAINTAINERS file to alphabetically insert DLB\n- don't create RTE_ symbols in pmd\n- converted to use version.map scheme\n- converted to use .._master_lcore instead of .._main_lcore\n- this patch set is based on dpdk-next-eventdev\n\nChanges since V2:\n================\n- fixed meson conditional build. Moved test into driver’s meson.build\n  file instead of event/meson.build\n- documentation is populated as associated code is introduced\n- add log_register in add dynamic logging patch\n- rename RTE_xxx symbol(s) as DLB2_xxx\n- replaced function ptr enqueue_four with direct call to movdir64b\n- remove unused port_pages\n- broke up probe patch into 3 smaller patches for easier review\n- changed param order of movdir64b/movntdq to match intrinsics\n- added self to MAINTAINERS files\n- squashed announcement of availability into last patch in series\n- correct spelling errors and delete repeated words\n- DPDK_21.0 -> DPDK 21 in map file\n- add experimental banner to public structs and APIs\n\nChanges since V1:\n=================\n- implement changes requested in code reviews by Gage Eads and Mike\n  Chen\n- fix a memzone leak\n- convert to use eal rte-cpuflags patch from Liang Ma\n\nKnown Issues:\n- the documentation contained in dlb2.rst is not complete, and\n  should be updated to include command line parameters (class of service,\n  etc ...).\n\nDepends-on: patch-82202 (\"eventdev: increase MAX QUEUES PER DEV to 255\")\n\nTimothy McDaniel (23):\n  event/dlb2: add documentation and meson build infrastructure\n  event/dlb2: add dynamic logging\n  event/dlb2: add private data structures and constants\n  event/dlb2: add definitions shared with LKM or shared code\n  event/dlb2: add inline functions\n  event/dlb2: add eventdev probe\n  event/dlb2: add flexible interface\n  event/dlb2: add probe-time hardware init\n  event/dlb2: add xstats\n  event/dlb2: add infos get and configure\n  event/dlb2: add queue and port default conf\n  event/dlb2: add queue setup\n  event/dlb2: add port setup\n  event/dlb2: add port link\n  event/dlb2: add port unlink and port unlinks in progress\n  event/dlb2: add eventdev start\n  event/dlb2: add enqueue and its burst variants\n  event/dlb2: add dequeue and its burst variants\n  event/dlb2: add eventdev stop and close\n  event/dlb2: add PMD's token pop public interface\n  event/dlb2: add PMD self-tests\n  event/dlb2: add queue and port release\n  event/dlb2: add timeout ticks entry point\n\n MAINTAINERS                                    |    6 +-\n app/test/test_eventdev.c                       |    7 +\n config/rte_config.h                            |    7 +\n doc/api/doxy-api-index.md                      |    3 +-\n doc/guides/eventdevs/dlb2.rst                  |  365 ++\n doc/guides/eventdevs/index.rst                 |    1 +\n doc/guides/rel_notes/release_20_11.rst         |    5 +\n drivers/event/dlb2/dlb2.c                      | 3947 ++++++++++++++++\n drivers/event/dlb2/dlb2_iface.c                |   74 +\n drivers/event/dlb2/dlb2_iface.h                |   74 +\n drivers/event/dlb2/dlb2_inline_fns.h           |   42 +\n drivers/event/dlb2/dlb2_log.h                  |   25 +\n drivers/event/dlb2/dlb2_priv.h                 |  578 +++\n drivers/event/dlb2/dlb2_selftest.c             | 1524 ++++++\n drivers/event/dlb2/dlb2_user.h                 |  679 +++\n drivers/event/dlb2/dlb2_xstats.c               | 1240 +++++\n drivers/event/dlb2/meson.build                 |   22 +\n drivers/event/dlb2/pf/base/dlb2_hw_types.h     |  367 ++\n drivers/event/dlb2/pf/base/dlb2_mbox.h         |  596 +++\n drivers/event/dlb2/pf/base/dlb2_osdep.h        |  230 +\n drivers/event/dlb2/pf/base/dlb2_osdep_bitmap.h |  440 ++\n drivers/event/dlb2/pf/base/dlb2_osdep_list.h   |  131 +\n drivers/event/dlb2/pf/base/dlb2_osdep_types.h  |   31 +\n drivers/event/dlb2/pf/base/dlb2_regs.h         | 2527 ++++++++++\n drivers/event/dlb2/pf/base/dlb2_resource.c     | 6027 ++++++++++++++++++++++++\n drivers/event/dlb2/pf/base/dlb2_resource.h     | 1913 ++++++++\n drivers/event/dlb2/pf/dlb2_main.c              |  673 +++\n drivers/event/dlb2/pf/dlb2_main.h              |   97 +\n drivers/event/dlb2/pf/dlb2_pf.c                |  728 +++\n drivers/event/dlb2/rte_pmd_dlb2.c              |   39 +\n drivers/event/dlb2/rte_pmd_dlb2.h              |   72 +\n drivers/event/dlb2/version.map                 |    9 +\n drivers/event/meson.build                      |    3 +-\n 33 files changed, 22479 insertions(+), 3 deletions(-)\n create mode 100644 doc/guides/eventdevs/dlb2.rst\n create mode 100644 drivers/event/dlb2/dlb2.c\n create mode 100644 drivers/event/dlb2/dlb2_iface.c\n create mode 100644 drivers/event/dlb2/dlb2_iface.h\n create mode 100644 drivers/event/dlb2/dlb2_inline_fns.h\n create mode 100644 drivers/event/dlb2/dlb2_log.h\n create mode 100644 drivers/event/dlb2/dlb2_priv.h\n create mode 100644 drivers/event/dlb2/dlb2_selftest.c\n create mode 100644 drivers/event/dlb2/dlb2_user.h\n create mode 100644 drivers/event/dlb2/dlb2_xstats.c\n create mode 100644 drivers/event/dlb2/meson.build\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_hw_types.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_mbox.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_osdep.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_osdep_bitmap.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_osdep_list.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_osdep_types.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_regs.h\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_resource.c\n create mode 100644 drivers/event/dlb2/pf/base/dlb2_resource.h\n create mode 100644 drivers/event/dlb2/pf/dlb2_main.c\n create mode 100644 drivers/event/dlb2/pf/dlb2_main.h\n create mode 100644 drivers/event/dlb2/pf/dlb2_pf.c\n create mode 100644 drivers/event/dlb2/rte_pmd_dlb2.c\n create mode 100644 drivers/event/dlb2/rte_pmd_dlb2.h\n create mode 100644 drivers/event/dlb2/version.map"
}