Show a cover letter.

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

{
    "id": 60787,
    "url": "http://patches.dpdk.org/api/covers/60787/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20191009204837.65039-1-jin.yu@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": "<20191009204837.65039-1-jin.yu@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20191009204837.65039-1-jin.yu@intel.com",
    "date": "2019-10-09T20:48:28",
    "name": "[v11,0/9] vhost: support inflight share memory protocol feature",
    "submitter": {
        "id": 1265,
        "url": "http://patches.dpdk.org/api/people/1265/?format=api",
        "name": "Jin Yu",
        "email": "jin.yu@intel.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20191009204837.65039-1-jin.yu@intel.com/mbox/",
    "series": [
        {
            "id": 6764,
            "url": "http://patches.dpdk.org/api/series/6764/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=6764",
            "date": "2019-10-09T20:48:28",
            "name": "vhost: support inflight share memory protocol feature",
            "version": 11,
            "mbox": "http://patches.dpdk.org/series/6764/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/60787/comments/",
    "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 168D21E550;\n\tWed,  9 Oct 2019 15:05:40 +0200 (CEST)",
            "from mga17.intel.com (mga17.intel.com [192.55.52.151])\n\tby dpdk.org (Postfix) with ESMTP id 98AED1E54B\n\tfor <dev@dpdk.org>; Wed,  9 Oct 2019 15:05:37 +0200 (CEST)",
            "from fmsmga007.fm.intel.com ([10.253.24.52])\n\tby fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t09 Oct 2019 06:05:36 -0700",
            "from storage36.sh.intel.com ([10.67.110.177])\n\tby fmsmga007.fm.intel.com with ESMTP; 09 Oct 2019 06:05:35 -0700"
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.67,276,1566889200\"; d=\"scan'208\";a=\"193675113\"",
        "From": "Jin Yu <jin.yu@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "changpeng.liu@intel.com, maxime.coquelin@redhat.com, tiwei.bie@intel.com,\n\tzhihong.wang@intel.com, Jin Yu <jin.yu@intel.com>",
        "Date": "Thu, 10 Oct 2019 04:48:28 +0800",
        "Message-Id": "<20191009204837.65039-1-jin.yu@intel.com>",
        "X-Mailer": "git-send-email 2.17.2",
        "In-Reply-To": "<20191009152515.21765>",
        "References": "<20191009152515.21765>",
        "Subject": "[dpdk-dev] [PATCH v11 0/9] vhost: support inflight share memory\n\tprotocol feature",
        "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": "v2:\n- specify the APIs are split-ring only\n\nv3:\n- fix APIs issues and judge split or packed\n\nv4:\n- add rte_vhost_ prefix and fix issues\n\nv5:\n- add the packed ring support and add the vhost_blk example\n\nv6:\n- revise get_vring_base func depend on Tiwei's suggestion\n\nv7:\n- divide patch into small patches\n\nv8:\n- updated base on Maxime's comments\n\nv9:\n- updated base on Tiwei's comments\n\nv10:\n- fix code style and update some misleading log\n\nv11:\n- add the version log to cover letter\n\nThis patches introduces two new messages VHOST_USER_GET_INFLIGHT_FD and VHOST_USER_SET_INFLIGHT_FD to support transferring a shared buffer between qemu and backend.\nNow It can both support split and packed ring. The example code show how these API work. The test has passed.\n\nHow to test the example:\n1, Qemu need two patches.\nhttps://patchwork.kernel.org/patch/10766813/\nhttps://patchwork.kernel.org/patch/10861411/(QEMU merged) it also needs some manual modifications:\nwe should confirm that before we send get inflight we have already sent the set features but it seems Qemu didn't do like this. So we manually revise this, we can add below code in vhost_dev_get_inflight\n    int r;\n\n    r = vhost_dev_set_features(dev, dev->log_enabled);\n    if (r < 0) {\n        return -errno;\n    }\nbefore get_inflight_fd.\n2, Guest OS version >= 5.0\n3, run the example\n4, run the qemu with vhost-user-blk-pci.\n eg:\n        -chardev socket,id=spdk_vhost_blk0,reconnect=1,path=xxxx\\\n        -device vhost-user-blk-pci,ring_packed=on,chardev=spdk_vhost_blk0,num-queues=1\\\n5, run fio in the guest\n6, kill the example and run again.\n7, the fio in the guest should continue run without errors.\n\n\nJin Yu (9):\n  vhost: add the inflight description\n  vhost: add packed ring\n  vhost: add the inflight structure\n  vhost: add two new messages to support a shared buffer\n  vhost: checkout the resubmit inflight information\n  vhost: add the APIs to operate inflight ring\n  vhost: add APIs for user getting inflight ring\n  vhost: add vring functions packed ring support\n  vhost: add vhost-user-blk example which support inflight\n\n examples/vhost_blk/Makefile            |   68 ++\n examples/vhost_blk/blk.c               |  125 +++\n examples/vhost_blk/blk_spec.h          |   95 +++\n examples/vhost_blk/meson.build         |   21 +\n examples/vhost_blk/vhost_blk.c         | 1092 ++++++++++++++++++++++++\n examples/vhost_blk/vhost_blk.h         |  128 +++\n examples/vhost_blk/vhost_blk_compat.c  |  195 +++++\n lib/librte_vhost/rte_vhost.h           |  237 ++++-\n lib/librte_vhost/rte_vhost_version.map |    8 +\n lib/librte_vhost/vhost.c               |  407 ++++++++-\n lib/librte_vhost/vhost.h               |   16 +\n lib/librte_vhost/vhost_user.c          |  456 +++++++++-\n lib/librte_vhost/vhost_user.h          |   12 +-\n 13 files changed, 2847 insertions(+), 13 deletions(-)\n create mode 100644 examples/vhost_blk/Makefile\n create mode 100644 examples/vhost_blk/blk.c\n create mode 100644 examples/vhost_blk/blk_spec.h\n create mode 100644 examples/vhost_blk/meson.build\n create mode 100644 examples/vhost_blk/vhost_blk.c\n create mode 100644 examples/vhost_blk/vhost_blk.h\n create mode 100644 examples/vhost_blk/vhost_blk_compat.c"
}