Show a cover letter.

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

{
    "id": 95982,
    "url": "http://patchwork.dpdk.org/api/covers/95982/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/1626465089-17052-1-git-send-email-jiayu.hu@intel.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.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": "<1626465089-17052-1-git-send-email-jiayu.hu@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1626465089-17052-1-git-send-email-jiayu.hu@intel.com",
    "date": "2021-07-16T19:51:26",
    "name": "[v5,0/3] provide thread unsafe async registration functions",
    "submitter": {
        "id": 539,
        "url": "http://patchwork.dpdk.org/api/people/539/?format=api",
        "name": "Hu, Jiayu",
        "email": "jiayu.hu@intel.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/1626465089-17052-1-git-send-email-jiayu.hu@intel.com/mbox/",
    "series": [
        {
            "id": 17867,
            "url": "http://patchwork.dpdk.org/api/series/17867/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=17867",
            "date": "2021-07-16T19:51:26",
            "name": "provide thread unsafe async registration functions",
            "version": 5,
            "mbox": "http://patchwork.dpdk.org/series/17867/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/95982/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 59CC4A0C50;\n\tFri, 16 Jul 2021 15:24:07 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 44EED4067B;\n\tFri, 16 Jul 2021 15:24:07 +0200 (CEST)",
            "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n by mails.dpdk.org (Postfix) with ESMTP id D28A840151\n for <dev@dpdk.org>; Fri, 16 Jul 2021 15:24:05 +0200 (CEST)",
            "from fmsmga003.fm.intel.com ([10.253.24.29])\n by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 16 Jul 2021 06:24:04 -0700",
            "from npg_dpdk_virtio_jiayuhu_07.sh.intel.com ([10.67.119.25])\n by FMSMGA003.fm.intel.com with ESMTP; 16 Jul 2021 06:24:03 -0700"
        ],
        "X-IronPort-AV": [
            "E=McAfee;i=\"6200,9189,10046\"; a=\"210718525\"",
            "E=Sophos;i=\"5.84,245,1620716400\"; d=\"scan'208\";a=\"210718525\"",
            "E=Sophos;i=\"5.84,245,1620716400\"; d=\"scan'208\";a=\"496728410\""
        ],
        "X-ExtLoop1": "1",
        "From": "Jiayu Hu <jiayu.hu@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "maxime.coquelin@redhat.com, chenbo.xia@intel.com,\n Jiayu Hu <jiayu.hu@intel.com>",
        "Date": "Fri, 16 Jul 2021 15:51:26 -0400",
        "Message-Id": "<1626465089-17052-1-git-send-email-jiayu.hu@intel.com>",
        "X-Mailer": "git-send-email 2.7.4",
        "In-Reply-To": "<1626162383-89674-2-git-send-email-jiayu.hu@intel.com>",
        "References": "<1626162383-89674-2-git-send-email-jiayu.hu@intel.com>",
        "Subject": "[dpdk-dev] [PATCH v5 0/3] provide thread unsafe async registration\n functions",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "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": "Lock protection is needed during the vhost notifies the application of\ndevice readiness, so the first patch adds lock protection. In addition,\nthe second patch reworks async feature structure to improve readability.\nAfter performing locking, existed async vhost registration functions will\ncause deadlock, as they acquire lock too. The last patch provides thread\nunsafe registration functions to support calling within vhost callback\nfunctions.\n\nv5:\n* improve coding style\n* update commit log, doc and comments\n* remove useless field async_inorder\n* change async_threshold from uint16_t to uint32_t\nv4:\n* remove brace {} in single statement block\nv3:\n* rename and use enum to define async device features\n* change padding fields to 8 bytes\nv2:\n* rework async feature structure\n* fix typo in commit log\n\nJiayu Hu (3):\n  vhost: fix lock on device readiness notification\n  vhost: rework async configuration structure\n  vhost: add thread unsafe async registeration functions\n\n doc/guides/prog_guide/vhost_lib.rst |  35 ++++++--\n examples/vhost/main.c               |   8 +-\n lib/vhost/rte_vhost_async.h         |  86 ++++++++++++++-----\n lib/vhost/version.map               |   4 +\n lib/vhost/vhost.c                   | 162 ++++++++++++++++++++++++++----------\n lib/vhost/vhost.h                   |   3 +-\n lib/vhost/vhost_user.c              |   5 +-\n 7 files changed, 219 insertions(+), 84 deletions(-)"
}