Show a cover letter.

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

{
    "id": 41848,
    "url": "https://patches.dpdk.org/api/covers/41848/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/cover/20180628215235.106069-1-yong.liu@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": "<20180628215235.106069-1-yong.liu@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20180628215235.106069-1-yong.liu@intel.com",
    "date": "2018-06-28T21:52:24",
    "name": "[v3,00/11] support in-order feature",
    "submitter": {
        "id": 17,
        "url": "https://patches.dpdk.org/api/people/17/?format=api",
        "name": "Marvin Liu",
        "email": "yong.liu@intel.com"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/cover/20180628215235.106069-1-yong.liu@intel.com/mbox/",
    "series": [
        {
            "id": 296,
            "url": "https://patches.dpdk.org/api/series/296/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=296",
            "date": "2018-06-28T21:52:24",
            "name": "support in-order feature",
            "version": 3,
            "mbox": "https://patches.dpdk.org/series/296/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/covers/41848/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 4A909199B9;\n\tThu, 28 Jun 2018 16:06:49 +0200 (CEST)",
            "from mga04.intel.com (mga04.intel.com [192.55.52.120])\n\tby dpdk.org (Postfix) with ESMTP id 7A5FC1DB9\n\tfor <dev@dpdk.org>; Thu, 28 Jun 2018 16:06:47 +0200 (CEST)",
            "from fmsmga003.fm.intel.com ([10.253.24.29])\n\tby fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t28 Jun 2018 07:06:46 -0700",
            "from dpdk-test32.sh.intel.com ([10.67.119.193])\n\tby FMSMGA003.fm.intel.com with ESMTP; 28 Jun 2018 07:06:45 -0700"
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.51,283,1526367600\"; d=\"scan'208\";a=\"60850324\"",
        "From": "Marvin Liu <yong.liu@intel.com>",
        "To": "maxime.coquelin@redhat.com,\n\ttiwei.bie@intel.com",
        "Cc": "zhihong.wang@intel.com,\n\tdev@dpdk.org,\n\tMarvin Liu <yong.liu@intel.com>",
        "Date": "Fri, 29 Jun 2018 05:52:24 +0800",
        "Message-Id": "<20180628215235.106069-1-yong.liu@intel.com>",
        "X-Mailer": "git-send-email 2.17.0",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=UTF-8",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH v3 00/11] support in-order 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": "In latest virtio-spec, new feature bit VIRTIO_F_IN_ORDER was introduced.\nWhen this feature has been negotiated, virtio driver will use\ndescriptors in ring order: starting from offset 0 in the table, and\nwrapping around at the end of the table. Vhost devices will always use\ndescriptors in the same order in which they have been made available.\nThis can reduce virtio accesses to used ring.\n\nBased on updated virtio-spec, this series realized IN_ORDER prototype\nin virtio driver. Due to new [RT]x path added into selection, also add\ntwo new parameters mrg_rx and in_order into virtio-user vdev parameters\nlist. This will allow user to configure feature bits thus can impact\n[RT]x path selection.\n\nPerformance of virtio user with IN_ORDER feature:\n\n    Platform: Purely\n    CPU: Intel(R) Xeon(R) Platinum 8160 CPU @ 2.10GHz\n    DPDK baseline: 18.05\n    Setup: testpmd with vhost vdev + testpmd with virtio vdev\n\n    +--------------+----------+----------+---------+\n    |Vhost->Virtio |1 Queue   |2 Queues  |4 Queues |\n    +--------------+----------+----------+---------+\n    |Inorder       |12.0Mpps  |24.2Mpps  |26.0Mpps |\n    |Normal        |12.1Mpps  |18.5Mpps  |18.9Mpps |\n    +--------------+----------+----------+---------+\n    \n    +--------------+----------+----------------+---------+\n    |Virtio->Vhost |1 Queue   |2 Queues        |4 Queues |\n    +--------------+----------+----------------+---------+\n    |Inorder       |13.8Mpps  |10.7 ~ 15.2Mpps |11.5Mpps |\n    |Normal        |13.3Mpps  |9.8 ~ 14Mpps    |10.5Mpps |\n    +--------------+----------+----------------+---------+\n    \n    +---------+----------+----------------+----------------+\n    |Loopback |1 Queue   |2 Queues        |4 Queues        |\n    +---------+----------+----------------+----------------+\n    |Inorder  |7.4Mpps   |9.1 ~ 11.6Mpps  |10.5 ~ 11.3Mpps |\n    +---------+----------+----------------+----------------+\n    |Normal   |7.5Mpps   |7.7 ~ 9.0Mpps   |7.6 ~ 7.8Mpps   |\n    +---------+----------+----------------+----------------+\n\nv3:\n- refine [RT]x function selection logic\n- fix in-order mergable packets index error\n- combine unsupport mask patch\n- doc virtio in-order update\n- fix checkpatch error\n\nv2:\n- merge to latest dpdk-net-virtio \n- not use in_direct for normal xmit packets\n- update available ring for each descriptor\n- clean up IN_ORDER xmit function\n- unmask feature bits when disabled in_order or mgr_rxbuf\n- extract common part between IN_ORDER and normal functions\n- update performance result\n\nMarvin Liu (11):\n  vhost: advertise support in-order feature\n  net/virtio: add in-order feature bit definition\n  net/virtio-user: add unsupported features mask\n  net/virtio-user: add mrg_rxbuf and in_order vdev parameters\n  net/virtio: free in-order descriptors before device start\n  net/virtio: extract common part for in-order functions\n  net/virtio: support in-order Rx and Tx\n  net/virtio: add in-order Rx/Tx into selection\n  net/virtio: advertise support in-order feature\n  doc: add mrg_rxbuf and in_order parameters for virtio device\n  doc: add in-order funciton for virtio device\n\n doc/guides/nics/virtio.rst                    |  27 +-\n drivers/net/virtio/virtio_ethdev.c            |  29 +-\n drivers/net/virtio/virtio_ethdev.h            |   7 +\n drivers/net/virtio/virtio_pci.h               |   8 +\n drivers/net/virtio/virtio_rxtx.c              | 635 ++++++++++++++++--\n .../net/virtio/virtio_user/virtio_user_dev.c  |  26 +-\n .../net/virtio/virtio_user/virtio_user_dev.h  |   4 +-\n drivers/net/virtio/virtio_user_ethdev.c       |  45 +-\n drivers/net/virtio/virtqueue.c                |   8 +\n drivers/net/virtio/virtqueue.h                |   2 +\n lib/librte_vhost/socket.c                     |   6 +\n lib/librte_vhost/vhost.h                      |  10 +-\n 12 files changed, 723 insertions(+), 84 deletions(-)"
}