Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/115587/?format=api
{ "id": 115587, "url": "http://patches.dpdk.org/api/patches/115587/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220829084127.934183-11-junfeng.guo@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": "<20220829084127.934183-11-junfeng.guo@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220829084127.934183-11-junfeng.guo@intel.com", "date": "2022-08-29T08:41:27", "name": "[v2,10/10] doc: update documentation", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "1579d0dc3e847dfc52a1a4d4cd2a01da4476cb24", "submitter": { "id": 1785, "url": "http://patches.dpdk.org/api/people/1785/?format=api", "name": "Junfeng Guo", "email": "junfeng.guo@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/20220829084127.934183-11-junfeng.guo@intel.com/mbox/", "series": [ { "id": 24441, "url": "http://patches.dpdk.org/api/series/24441/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=24441", "date": "2022-08-29T08:41:17", "name": "introduce GVE PMD", "version": 2, "mbox": "http://patches.dpdk.org/series/24441/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/115587/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/115587/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 33717A0542;\n\tMon, 29 Aug 2022 10:43:01 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 54BBC42B7A;\n\tMon, 29 Aug 2022 10:42:20 +0200 (CEST)", "from mga06.intel.com (mga06b.intel.com [134.134.136.31])\n by mails.dpdk.org (Postfix) with ESMTP id 76FD542B7A\n for <dev@dpdk.org>; Mon, 29 Aug 2022 10:42:18 +0200 (CEST)", "from orsmga008.jf.intel.com ([10.7.209.65])\n by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 29 Aug 2022 01:42:18 -0700", "from dpdk-jf-ntb-one.sh.intel.com ([10.67.111.104])\n by orsmga008.jf.intel.com with ESMTP; 29 Aug 2022 01:42:15 -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=1661762538; x=1693298538;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=olFGdmtVJdO+OfAtAr26VeeWaAHIP+B+3DzL3M97UB8=;\n b=blXK+yGSp3PHX4Nmw0WP9iiN4rGewcGwvOoZ3GVgaqG+d+Nws3GPZcBh\n Ky3yFETtgfe7nD+oA6/pmhUl+kw0cVgVTgQt+IlsPTwxt2K+ARgrJEM+e\n vMDzN3KLOHHUPCsyPpTr0iUKI21PlkQDXdtxZqc5emG/BeB/fBGvSByh6\n wM2T5ppZUs/RH8cv1w1bDLF98+iFIX9UtNy4cxTsQgivPCcN/TiE3+0h0\n kr7StrJ1OBch9P4WOtA7otCCwXJDGSaIiu6M5tOW3QLqHJEOks7TeBIo6\n JRZePDNQVOqky6MyhkbWJeMQdTKKeKtYc5sibiT/e/jwm2r47PxTChOie g==;", "X-IronPort-AV": [ "E=McAfee;i=\"6500,9779,10453\"; a=\"356559870\"", "E=Sophos;i=\"5.93,272,1654585200\"; d=\"scan'208\";a=\"356559870\"", "E=Sophos;i=\"5.93,272,1654585200\"; d=\"scan'208\";a=\"640856928\"" ], "X-ExtLoop1": "1", "From": "Junfeng Guo <junfeng.guo@intel.com>", "To": "qi.z.zhang@intel.com,\n\tjingjing.wu@intel.com", "Cc": "ferruh.yigit@xilinx.com, dev@dpdk.org, xiaoyun.li@intel.com,\n awogbemila@google.com, bruce.richardson@intel.com, junfeng.guo@intel.com", "Subject": "[PATCH v2 10/10] doc: update documentation", "Date": "Mon, 29 Aug 2022 16:41:27 +0800", "Message-Id": "<20220829084127.934183-11-junfeng.guo@intel.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20220829084127.934183-1-junfeng.guo@intel.com>", "References": "<20220729193042.2764633-2-xiaoyun.li@intel.com>\n <20220829084127.934183-1-junfeng.guo@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.\n\nSigned-off-by: Xiaoyun Li <xiaoyun.li@intel.com>\nSigned-off-by: Junfeng Guo <junfeng.guo@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..20cda5031b\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_gve**) 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_desc.h\n+- gve_desc_dqo.h\n+- gve_register.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 - GQI with queue page list\n+- GQI_RDA - GQI with raw DMA addressing\n+- DQO_RDA - DQO with raw DMA addressing\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": [ "v2", "10/10" ] }