Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/114460/?format=api
{ "id": 114460, "url": "http://patches.dpdk.org/api/patches/114460/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220729193042.2764633-11-xiaoyun.li@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": "<20220729193042.2764633-11-xiaoyun.li@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220729193042.2764633-11-xiaoyun.li@intel.com", "date": "2022-07-29T19:30:42", "name": "[10/10] doc: update documentation", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "e389723a08733787cfcab413dbb42765388795ed", "submitter": { "id": 798, "url": "http://patches.dpdk.org/api/people/798/?format=api", "name": "Li, Xiaoyun", "email": "xiaoyun.li@intel.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220729193042.2764633-11-xiaoyun.li@intel.com/mbox/", "series": [ { "id": 24137, "url": "http://patches.dpdk.org/api/series/24137/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=24137", "date": "2022-07-29T19:30:32", "name": "introduce GVE PMD", "version": 1, "mbox": "http://patches.dpdk.org/series/24137/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/114460/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/114460/checks/", "tags": {}, "related": [], "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 A4D7AA00C4;\n\tFri, 29 Jul 2022 21:32:14 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id D1BC342C79;\n\tFri, 29 Jul 2022 21:31:24 +0200 (CEST)", "from mga12.intel.com (mga12.intel.com [192.55.52.136])\n by mails.dpdk.org (Postfix) with ESMTP id E753842C48\n for <dev@dpdk.org>; Fri, 29 Jul 2022 21:31:20 +0200 (CEST)", "from orsmga006.jf.intel.com ([10.7.209.51])\n by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 29 Jul 2022 12:31:20 -0700", "from silpixa00399779.ir.intel.com (HELO\n silpixa00399779.ger.corp.intel.com) ([10.237.223.111])\n by orsmga006.jf.intel.com with ESMTP; 29 Jul 2022 12:31:18 -0700" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1659123081; x=1690659081;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=iQ6k7vwuSesPlv27XqT9acmhsWe9Gi5yiMRz28EdFiM=;\n b=XK6PBpCROPtjZZJavhhKXRlxeTfeMUaPbWq46PDSHVfvx5mO3liCcNVh\n 9Hzai+qxBZSEHY08J/qya/MX44Q/or78N79RCBfexvAt1YGWyg29cRKMx\n KrAD04nPXCmh8s06H8bRncUd4OLpuwtw9oI208kuCfZbSazJ2bgvV/iDI\n p8fg+/JS2lkc3hucy0iY0CFIHBplOYrADQOkruUXF6X/3syjGIB2We7x7\n d9dxc0Lj8YVdJSqCMQvWgLWmFDUirKUHYySRbXTywcYzEwKi/UbKSW0Gz\n C4oiQT5bXkKuTS1lyRsO+ouxfJFlmJiddpZ/UUnB29Z4pIcgcfiX/jeoh w==;", "X-IronPort-AV": [ "E=McAfee;i=\"6400,9594,10423\"; a=\"268602976\"", "E=Sophos;i=\"5.93,201,1654585200\"; d=\"scan'208\";a=\"268602976\"", "E=Sophos;i=\"5.93,201,1654585200\"; d=\"scan'208\";a=\"577059607\"" ], "X-ExtLoop1": "1", "From": "Xiaoyun Li <xiaoyun.li@intel.com>", "To": "junfeng.guo@intel.com, qi.z.zhang@intel.com, awogbemila@google.com,\n bruce.richardson@intel.com", "Cc": "dev@dpdk.org,\n\tXiaoyun Li <xiaoyun.li@intel.com>", "Subject": "[PATCH 10/10] doc: update documentation", "Date": "Fri, 29 Jul 2022 19:30:42 +0000", "Message-Id": "<20220729193042.2764633-11-xiaoyun.li@intel.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220729193042.2764633-1-xiaoyun.li@intel.com>", "References": "<20220729193042.2764633-1-xiaoyun.li@intel.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "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" }, "content": "Update documentation of GVE PMD and release note.\nAdd Junfeng Guo as GVE PMD maintainer since he'll work on GVE PMD\nin the future and maintain it and I won't be available for maintaining.\n\nSigned-off-by: Xiaoyun Li <xiaoyun.li@intel.com>\n---\n MAINTAINERS | 6 +++\n doc/guides/nics/features/gve.ini | 18 +++++++\n doc/guides/nics/gve.rst | 65 ++++++++++++++++++++++++++\n doc/guides/rel_notes/release_22_11.rst | 4 ++\n 4 files changed, 93 insertions(+)\n create mode 100644 doc/guides/nics/features/gve.ini\n create mode 100644 doc/guides/nics/gve.rst", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 32ffdd1a61..474f41f0de 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -697,6 +697,12 @@ F: drivers/net/enic/\n F: doc/guides/nics/enic.rst\n F: doc/guides/nics/features/enic.ini\n \n+Google Virtual Ethernet\n+M: Junfeng Guo <junfeng.guo@intel.com>\n+F: drivers/net/gve/\n+F: doc/guides/nics/gve.rst\n+F: doc/guides/nics/features/gve.ini\n+\n Hisilicon hns3\n M: Dongdong Liu <liudongdong3@huawei.com>\n M: Yisen Zhuang <yisen.zhuang@huawei.com>\ndiff --git a/doc/guides/nics/features/gve.ini b/doc/guides/nics/features/gve.ini\nnew file mode 100644\nindex 0000000000..180408aa80\n--- /dev/null\n+++ b/doc/guides/nics/features/gve.ini\n@@ -0,0 +1,18 @@\n+;\n+; Supported features of the Google Virtual Ethernet 'gve' poll mode driver.\n+;\n+; Refer to default.ini for the full list of available PMD features.\n+;\n+[Features]\n+Speed capabilities = Y\n+Link status = Y\n+MTU update = Y\n+TSO = Y\n+RSS hash = Y\n+L4 checksum offload = Y\n+Basic stats = Y\n+Stats per queue = Y\n+Linux = Y\n+x86-32 = Y\n+x86-64 = Y\n+Usage doc = Y\ndiff --git a/doc/guides/nics/gve.rst b/doc/guides/nics/gve.rst\nnew file mode 100644\nindex 0000000000..310328c8ab\n--- /dev/null\n+++ b/doc/guides/nics/gve.rst\n@@ -0,0 +1,65 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(C) 2022 Intel Corporation.\n+\n+GVE poll mode driver\n+=======================\n+\n+The GVE PMD (**librte_net_i40e**) provides poll mode driver support for\n+Google Virtual Ethernet device.\n+\n+The base code is under MIT license and based on GVE kernel driver v1.3.0.\n+GVE base code files are:\n+\n+- gve_adminq.h\n+- gve_adminq.c\n+- gve_register.h\n+- gve_desc.h\n+- gve_desc_dqo.h\n+\n+Please refer to https://github.com/GoogleCloudPlatform/compute-virtual-ethernet-linux/tree/v1.3.0/google/gve\n+to find the original base code.\n+\n+GVE has 3 queue formats:\n+\n+- GQI_QPL\n+- GQI_RDA\n+- DQO_RDA\n+\n+GQI_QPL queue format is queue page list mode. Driver needs to allocate\n+memory and register this memory as a Queue Page List (QPL) in hardware\n+(Google Hypervisor/GVE Backend) first. Each queue has its own QPL.\n+Then Tx needs to copy packets to QPL memory and put this packet's offset\n+in the QPL memory into hardware descriptors so that hardware can get the\n+packets data. And Rx needs to read descriptors of offset in QPL to get\n+QPL address and copy packets from the address to get real packets data.\n+\n+GQI_RDA queue format works like usual NICs that driver can put packets'\n+physical address into hardware descriptors.\n+\n+DQO_RDA queue format has submission and completion queue pair for each\n+Tx/Rx queue. And similar as GQI_RDA, driver can put packets' physical\n+address into hardware descriptors.\n+\n+Please refer to https://www.kernel.org/doc/html/latest/networking/device_drivers/ethernet/google/gve.html\n+to get more information about GVE queue formats.\n+\n+Features and Limitations\n+------------------------\n+\n+In this release, the GVE PMD provides the basic functionality of packet\n+reception and transmission.\n+Supported features of the GVE PMD are:\n+\n+- Multiple queues for TX and RX\n+- Receiver Side Scaling (RSS)\n+- TSO offload\n+- Port hardware statistics\n+- Link state information\n+- TX multi-segments (Scatter TX)\n+- Tx UDP/TCP/SCTP Checksum\n+\n+Currently, only GQI_QPL and GQI_RDA queue format are supported in PMD.\n+Jumbo Frame is not supported in PMD for now. It'll be added in the future\n+DPDK release.\n+Also, only GQI_QPL queue format is in use on GCP since GQI_RDA hasn't been\n+released in production.\ndiff --git a/doc/guides/rel_notes/release_22_11.rst b/doc/guides/rel_notes/release_22_11.rst\nindex 8c021cf050..6674f4cf6f 100644\n--- a/doc/guides/rel_notes/release_22_11.rst\n+++ b/doc/guides/rel_notes/release_22_11.rst\n@@ -55,6 +55,10 @@ New Features\n Also, make sure to start the actual text at the margin.\n =======================================================\n \n+* **Added GVE net PMD**\n+\n+ Added the new ``gve`` net driver for Google Virtual Ethernet devices.\n+ See the :doc:`../nics/gve` NIC guide for more details on this new driver.\n \n Removed Items\n -------------\n", "prefixes": [ "10/10" ] }