get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/49638/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 49638,
    "url": "https://patches.dpdk.org/api/patches/49638/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20190110210122.24889-1-gage.eads@intel.com/",
    "project": {
        "id": 1,
        "url": "https://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": "<20190110210122.24889-1-gage.eads@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20190110210122.24889-1-gage.eads@intel.com",
    "date": "2019-01-10T21:01:16",
    "name": "[0/6] Add non-blocking ring",
    "commit_ref": null,
    "pull_url": null,
    "state": null,
    "archived": false,
    "hash": null,
    "submitter": {
        "id": 586,
        "url": "https://patches.dpdk.org/api/people/586/?format=api",
        "name": "Eads, Gage",
        "email": "gage.eads@intel.com"
    },
    "delegate": null,
    "mbox": "https://patches.dpdk.org/project/dpdk/patch/20190110210122.24889-1-gage.eads@intel.com/mbox/",
    "series": [],
    "comments": "https://patches.dpdk.org/api/patches/49638/comments/",
    "check": "pending",
    "checks": "https://patches.dpdk.org/api/patches/49638/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 [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 8D1351B915;\n\tThu, 10 Jan 2019 22:02:35 +0100 (CET)",
            "from mga02.intel.com (mga02.intel.com [134.134.136.20])\n\tby dpdk.org (Postfix) with ESMTP id 9DD831B90D\n\tfor <dev@dpdk.org>; Thu, 10 Jan 2019 22:02:33 +0100 (CET)",
            "from fmsmga003.fm.intel.com ([10.253.24.29])\n\tby orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t10 Jan 2019 13:02:32 -0800",
            "from txasoft-yocto.an.intel.com (HELO txasoft-yocto.an.intel.com.)\n\t([10.123.72.192])\n\tby FMSMGA003.fm.intel.com with ESMTP; 10 Jan 2019 13:02:31 -0800"
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.56,462,1539673200\"; d=\"scan'208\";a=\"124971945\"",
        "From": "Gage Eads <gage.eads@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "olivier.matz@6wind.com, arybchenko@solarflare.com,\n\tbruce.richardson@intel.com, konstantin.ananyev@intel.com",
        "Date": "Thu, 10 Jan 2019 15:01:16 -0600",
        "Message-Id": "<20190110210122.24889-1-gage.eads@intel.com>",
        "X-Mailer": "git-send-email 2.13.6",
        "Subject": "[dpdk-dev] [PATCH 0/6] Add non-blocking ring",
        "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\t<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\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "For some users, the rte ring's \"non-preemptive\" constraint is not acceptable;\nfor example, if the application uses a mixture of pinned high-priority threads\nand multiplexed low-priority threads that share a mempool.\n\nThis patchset introduces a non-blocking ring, on top of which a mempool can run.\nCrucially, the non-blocking algorithm relies on a 128-bit compare-and-swap, so\nit is limited to x86_64 machines.\n\nThe ring uses more compare-and-swap atomic operations than the regular rte ring:\nWith no contention, an enqueue of n pointers uses (1 + 2n) CAS operations and a\ndequeue of n pointers uses 2. This algorithm has worse average-case performance\nthan the regular rte ring (particularly a highly-contended ring with large bulk\naccesses), however:\n- For applications with preemptible pthreads, the regular rte ring's worst-case\n  performance (i.e. one thread being preempted in the update_tail() critical\n  section) is much worse than the non-blocking ring's.\n- Software caching can mitigate the average case performance for ring-based\n  algorithms. For example, a non-blocking ring based mempool (a likely use case\n  for this ring) with per-thread caching.\n\nThe non-blocking ring is enabled via a new flag, RING_F_NB. For ease-of-use,\nexisting ring enqueue/dequeue functions work with both \"regular\" and\nnon-blocking rings.\n\nThis patchset also adds non-blocking versions of ring_autotest and\nring_perf_autotest, and a non-blocking ring based mempool.\n\nThis patchset makes ABI changes, and thus an ABI update announcement and\ndeprecation cycle are required.\n\nThis patchset depends on the non-blocking stack patchset[1].\n\n[1] http://mails.dpdk.org/archives/dev/2019-January/122923.html\n\nGage Eads (6):\n  ring: change head and tail to pointer-width size\n  ring: add a non-blocking implementation\n  test_ring: add non-blocking ring autotest\n  test_ring_perf: add non-blocking ring perf test\n  mempool/ring: add non-blocking ring handlers\n  doc: add NB ring comment to EAL \"known issues\"\n\n doc/guides/prog_guide/env_abstraction_layer.rst |   2 +-\n drivers/mempool/ring/rte_mempool_ring.c         |  58 ++-\n lib/librte_eventdev/rte_event_ring.h            |   6 +-\n lib/librte_ring/rte_ring.c                      |  53 ++-\n lib/librte_ring/rte_ring.h                      | 555 ++++++++++++++++++++++--\n lib/librte_ring/rte_ring_generic.h              |  16 +-\n lib/librte_ring/rte_ring_version.map            |   7 +\n test/test/test_ring.c                           |  57 ++-\n test/test/test_ring_perf.c                      |  19 +-\n 9 files changed, 689 insertions(+), 84 deletions(-)",
    "diff": null,
    "prefixes": [
        "0/6"
    ]
}