Show a cover letter.

GET /api/covers/42013/
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 42013,
    "url": "http://patches.dpdk.org/api/covers/42013/",
    "web_url": "http://patches.dpdk.org/cover/42013/",
    "project": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/projects/1/",
        "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": "<20180630235049.62610-1-yong.liu@intel.com>",
    "date": "2018-06-30T23:50:40",
    "name": "[v4,0/9] support in-order feature",
    "submitter": {
        "id": 17,
        "url": "http://patches.dpdk.org/api/people/17/",
        "name": "Liu, Yong",
        "email": "yong.liu@intel.com"
    },
    "mbox": "http://patches.dpdk.org/cover/42013/mbox/",
    "series": [
        {
            "id": 336,
            "url": "http://patches.dpdk.org/api/series/336/",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=336",
            "date": "2018-06-30T23:50:40",
            "name": "support in-order feature",
            "version": 4,
            "mbox": "http://patches.dpdk.org/series/336/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/42013/comments/",
    "headers": {
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Cc": "zhihong.wang@intel.com,\n\tdev@dpdk.org,\n\tMarvin Liu <yong.liu@intel.com>",
        "X-Original-To": "patchwork@dpdk.org",
        "Date": "Sun,  1 Jul 2018 07:50:40 +0800",
        "Precedence": "list",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailer": "git-send-email 2.17.0",
        "Return-Path": "<dev-bounces@dpdk.org>",
        "To": "maxime.coquelin@redhat.com,\n\ttiwei.bie@intel.com",
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "Errors-To": "dev-bounces@dpdk.org",
        "List-Post": "<mailto:dev@dpdk.org>",
        "MIME-Version": "1.0",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id D50621BE8A;\n\tSat, 30 Jun 2018 18:05:09 +0200 (CEST)",
            "from mga14.intel.com (mga14.intel.com [192.55.52.115])\n\tby dpdk.org (Postfix) with ESMTP id AEA0D1BE04\n\tfor <dev@dpdk.org>; Sat, 30 Jun 2018 18:05:08 +0200 (CEST)",
            "from fmsmga004.fm.intel.com ([10.253.24.48])\n\tby fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t30 Jun 2018 09:05:07 -0700",
            "from dpdk-test32.sh.intel.com ([10.67.119.193])\n\tby fmsmga004.fm.intel.com with ESMTP; 30 Jun 2018 09:05:06 -0700"
        ],
        "From": "Marvin Liu <yong.liu@intel.com>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "X-ExtLoop1": "1",
        "X-Amp-File-Uploaded": "False",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH v4 0/9] support in-order feature",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "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>",
        "Content-Type": "text/plain; charset=UTF-8",
        "X-IronPort-AV": "E=Sophos;i=\"5.51,291,1526367600\"; d=\"scan'208\";a=\"67643515\"",
        "Delivered-To": "patchwork@dpdk.org",
        "Message-Id": "<20180630235049.62610-1-yong.liu@intel.com>",
        "X-Mailman-Version": "2.1.15"
    },
    "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\nv4:\n- disable simple [RT]x function for ARM\n- squash doc update into relevant patches\n- fix git-check-log and checkpatch errors\n\nv3:\n- refine [RT]x function selection logic\n- fix in-order mergeable 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\nMarvin Liu (9):\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\n doc/guides/nics/virtio.rst                    |  27 +-\n drivers/net/virtio/virtio_ethdev.c            |  31 +-\n drivers/net/virtio/virtio_ethdev.h            |   7 +\n drivers/net/virtio/virtio_pci.h               |   8 +\n drivers/net/virtio/virtio_rxtx.c              | 639 ++++++++++++++++--\n .../net/virtio/virtio_user/virtio_user_dev.c  |  30 +-\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, 732 insertions(+), 85 deletions(-)"
}