Show a cover letter.

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

{
    "id": 52272,
    "url": "http://patches.dpdk.org/api/covers/52272/?format=api",
    "web_url": "http://patches.dpdk.org/cover/52272/",
    "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"
    },
    "msgid": "<20190404100127.29381-1-gage.eads@intel.com>",
    "date": "2019-04-04T10:01:19",
    "name": "[v10,0/8] Add stack library and new mempool handler",
    "submitter": {
        "id": 586,
        "url": "http://patches.dpdk.org/api/people/586/?format=api",
        "name": "Eads, Gage",
        "email": "gage.eads@intel.com"
    },
    "mbox": "http://patches.dpdk.org/cover/52272/mbox/",
    "series": [
        {
            "id": 4111,
            "url": "http://patches.dpdk.org/api/series/4111/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=4111",
            "date": "2019-04-04T10:01:19",
            "name": "Add stack library and new mempool handler",
            "version": 10,
            "mbox": "http://patches.dpdk.org/series/4111/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/52272/comments/",
    "headers": {
        "X-Mailer": "git-send-email 2.13.6",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "Precedence": "list",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "Date": "Thu,  4 Apr 2019 05:01:19 -0500",
        "X-Mailman-Version": "2.1.15",
        "Delivered-To": "patchwork@dpdk.org",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n\t<mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "Cc": "olivier.matz@6wind.com, arybchenko@solarflare.com,\n\tbruce.richardson@intel.com, konstantin.ananyev@intel.com,\n\tgavin.hu@arm.com, \n\tHonnappa.Nagarahalli@arm.com, nd@arm.com, thomas@monjalon.net",
        "To": "dev@dpdk.org",
        "Errors-To": "dev-bounces@dpdk.org",
        "References": "<20190403232020.12784-1-gage.eads@intel.com>",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>",
        "From": "Gage Eads <gage.eads@intel.com>",
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-IronPort-AV": "E=Sophos;i=\"5.60,308,1549958400\"; d=\"scan'208\";a=\"132898871\"",
        "List-Post": "<mailto:dev@dpdk.org>",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id C2FCB1B113;\n\tThu,  4 Apr 2019 12:02:12 +0200 (CEST)",
            "from mga07.intel.com (mga07.intel.com [134.134.136.100])\n\tby dpdk.org (Postfix) with ESMTP id 8986AD0B2\n\tfor <dev@dpdk.org>; Thu,  4 Apr 2019 12:02:11 +0200 (CEST)",
            "from orsmga006.jf.intel.com ([10.7.209.51])\n\tby orsmga105.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t04 Apr 2019 03:02:10 -0700",
            "from txasoft-yocto.an.intel.com ([10.123.72.192])\n\tby orsmga006.jf.intel.com with ESMTP; 04 Apr 2019 03:02:09 -0700"
        ],
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "X-Amp-File-Uploaded": "False",
        "Subject": "[dpdk-dev] [PATCH v10 0/8] Add stack library and new mempool handler",
        "In-Reply-To": "<20190403232020.12784-1-gage.eads@intel.com>",
        "Message-Id": "<20190404100127.29381-1-gage.eads@intel.com>",
        "X-ExtLoop1": "1",
        "X-BeenThere": "dev@dpdk.org",
        "X-Original-To": "patchwork@dpdk.org"
    },
    "content": "This patchset introduces a stack library, supporting both lock-based and\nlock-free stacks, and a lock-free stack mempool handler.\n\nThe lock-based stack code is derived from the existing stack mempool handler,\nand that handler is refactored to use the stack library.\n\nThe lock-free stack mempool handler is intended for usages where the rte\nring's \"non-preemptive\" constraint is not acceptable; for example, if the\napplication uses a mixture of pinned high-priority threads and multiplexed\nlow-priority threads that share a mempool.\n\nNote that the lock-free algorithm relies on a 128-bit compare-and-swap[1],\nso it is currently limited to the x86_64 platform.\n\nThis patchset is the successor to a patchset containing only the new mempool\nhandler[2].\n\n[1] http://mails.dpdk.org/archives/dev/2019-April/129014.html\n[2] http://mails.dpdk.org/archives/dev/2019-January/123555.html\n\n---\nv10:\n- Correct test/test/ -> app/test/ in MAINTAINERS\n\nv9:\n- Add rte_atomic.h includes to rte_stack.h, test_stack.c, and test_stack_perf.c\n  to fix ARM builds\n\nv8:\n- Add rte_debug.h include to rte_stack.h for RTE_ASSERT()\n\nv7:\n- Add rte_branch_prediction.h include to rte_stack_std.h for unlikely()\n- Add rte_compat.h include to rte_stack.h for __rte_experimental\n\nv6:\n- Add load-acquire fence to the lock-free push function\n- Correct generic implementation's pop_elems 128b CAS success and failure\n  memorder to match those in the C11 implementation.\n\nv5:\n- Add comment to explain padding in *_get_memsize() functions\n- Prefix internal functions with '__'\n- Use RTE_ASSERT for performance critical run-time checks\n- Don't use __atomic_load in the C11 pop_elems function, and put an acquire\n  thread fence at the start of the 2nd do-while loop\n- Change pop_elems 128b CAS success memorder to RELEASE and failure memorder to\n  RELAXED\n- Change compile-time assertion to run for all 64-bit architectures\n- Reorganize the code with standard and lock-free .c and .h files\n\nv4:\n- Fix 32-bit build error in test_stack.c by using %zu format specifier for\n  size_t\n- Rebase onto master\n\nv3:\n- Rebase patchset onto master (test/test/ -> app/test/)\n- Fix rte_stack_std_push() segfault introduced in v2\n\nv2:\n- Reworked structure and function naming to use rte_stack_{std, lf}_...\n- Updated to the latest rte_atomic128_cmp_exchange() interface.\n- Rename STACK_F_NB -> RTE_STACK_F_LF.\n- Remove rte_rmb() and rte_wmb() from the generic push and pop implementations.\n  These are obviated by rte_atomic128_cmp_exchange()'s two memorder arguments.\n- Edit stack_lib.rst text to 80 chars/line.\n- Fix rte_stack.h doxygen formatting.\n- Allocate popped_objs array from the heap\n- Fix stack_thread_push_pop bug (\"&t->sz\" -> \"t->sz\")\n- Remove unnecessary NULL check from test_stack_basic\n- Properly terminate the name string in test_stack_name_length\n- Add an empty array of struct rte_nb_lifo_elem elements\n- In rte_nb_lifo_push(), retrieve the last element from __nb_lifo_pop()\n- Split C11 implementation into a separate patchset\n\nGage Eads (8):\n  stack: introduce rte stack library\n  mempool/stack: convert mempool to use rte stack\n  test/stack: add stack test\n  test/stack: add stack perf test\n  stack: add lock-free stack implementation\n  stack: add C11 atomic implementation\n  test/stack: add lock-free stack tests\n  mempool/stack: add lock-free stack mempool handler\n\n MAINTAINERS                                     |   9 +-\n app/test/Makefile                               |   3 +\n app/test/meson.build                            |   7 +\n app/test/test_stack.c                           | 424 ++++++++++++++++++++++++\n app/test/test_stack_perf.c                      | 358 ++++++++++++++++++++\n config/common_base                              |   5 +\n doc/api/doxy-api-index.md                       |   1 +\n doc/api/doxy-api.conf.in                        |   1 +\n doc/guides/prog_guide/env_abstraction_layer.rst |  10 +\n doc/guides/prog_guide/index.rst                 |   1 +\n doc/guides/prog_guide/stack_lib.rst             |  83 +++++\n doc/guides/rel_notes/release_19_05.rst          |  13 +\n drivers/mempool/stack/Makefile                  |   3 +-\n drivers/mempool/stack/meson.build               |   6 +-\n drivers/mempool/stack/rte_mempool_stack.c       | 115 +++----\n lib/Makefile                                    |   2 +\n lib/librte_stack/Makefile                       |  29 ++\n lib/librte_stack/meson.build                    |  12 +\n lib/librte_stack/rte_stack.c                    | 196 +++++++++++\n lib/librte_stack/rte_stack.h                    | 262 +++++++++++++++\n lib/librte_stack/rte_stack_lf.c                 |  31 ++\n lib/librte_stack/rte_stack_lf.h                 | 106 ++++++\n lib/librte_stack/rte_stack_lf_c11.h             | 175 ++++++++++\n lib/librte_stack/rte_stack_lf_generic.h         | 164 +++++++++\n lib/librte_stack/rte_stack_pvt.h                |  34 ++\n lib/librte_stack/rte_stack_std.c                |  26 ++\n lib/librte_stack/rte_stack_std.h                | 121 +++++++\n lib/librte_stack/rte_stack_version.map          |   9 +\n lib/meson.build                                 |   2 +-\n mk/rte.app.mk                                   |   1 +\n 30 files changed, 2137 insertions(+), 72 deletions(-)\n create mode 100644 app/test/test_stack.c\n create mode 100644 app/test/test_stack_perf.c\n create mode 100644 doc/guides/prog_guide/stack_lib.rst\n create mode 100644 lib/librte_stack/Makefile\n create mode 100644 lib/librte_stack/meson.build\n create mode 100644 lib/librte_stack/rte_stack.c\n create mode 100644 lib/librte_stack/rte_stack.h\n create mode 100644 lib/librte_stack/rte_stack_lf.c\n create mode 100644 lib/librte_stack/rte_stack_lf.h\n create mode 100644 lib/librte_stack/rte_stack_lf_c11.h\n create mode 100644 lib/librte_stack/rte_stack_lf_generic.h\n create mode 100644 lib/librte_stack/rte_stack_pvt.h\n create mode 100644 lib/librte_stack/rte_stack_std.c\n create mode 100644 lib/librte_stack/rte_stack_std.h\n create mode 100644 lib/librte_stack/rte_stack_version.map"
}