Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/108500/?format=api
{ "id": 108500, "url": "http://patches.dpdk.org/api/patches/108500/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220302172217.472279-7-bruce.richardson@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": "<20220302172217.472279-7-bruce.richardson@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220302172217.472279-7-bruce.richardson@intel.com", "date": "2022-03-02T17:22:14", "name": "[6/9] doc/linux_gsg: split VFIO section into subsections", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "5ef5ca489ee6b7cd37fd6e492384f34ae88b1a64", "submitter": { "id": 20, "url": "http://patches.dpdk.org/api/people/20/?format=api", "name": "Bruce Richardson", "email": "bruce.richardson@intel.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220302172217.472279-7-bruce.richardson@intel.com/mbox/", "series": [ { "id": 21992, "url": "http://patches.dpdk.org/api/series/21992/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=21992", "date": "2022-03-02T17:22:08", "name": "Improve linux drivers GSG section", "version": 1, "mbox": "http://patches.dpdk.org/series/21992/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/108500/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/108500/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 794EFA04A4;\n\tWed, 2 Mar 2022 18:24:49 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id A43C842773;\n\tWed, 2 Mar 2022 18:24:23 +0100 (CET)", "from mga06.intel.com (mga06.intel.com [134.134.136.31])\n by mails.dpdk.org (Postfix) with ESMTP id 327D442756;\n Wed, 2 Mar 2022 18:24:21 +0100 (CET)", "from orsmga008.jf.intel.com ([10.7.209.65])\n by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 02 Mar 2022 09:24:16 -0800", "from silpixa00399126.ir.intel.com ([10.237.223.34])\n by orsmga008.jf.intel.com with ESMTP; 02 Mar 2022 09:24:15 -0800" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1646241861; x=1677777861;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=qz1Tj1pQmOzs/CldsKWLIzTXnrmnOIyBk9b50iuj6CU=;\n b=T82c4Z70A8URBZmo5Gk0Kdk2Eq4teNPociiyVEL7Chue/YKKyCD9Lqst\n S7M6X2IksLWnOCNoqf8jMeI8V5zUof5HXIYFz5zaf/7zBbPvRTy3IFSRS\n 3vDFhoo6yQ2aHGqNK3gEa5r8tlkfk4Xih26B2kWd/UKtrlB7yeJKQ1uHk\n zh45xQ8TtrIvw2HFYLlFv7xxTGHyfnR5Kydy+24vUEeZyax9poBhqR5Sw\n QCDKEO6xUuo26Qs/2bMz54kK3CAzwNwaXCBoSwJpypOHf/Ytt4Xyi6zsu\n bEjDROmqxKAmkeu6PmNlqLERlJ2oYzm+WVg3BgEL5PG7uAwY3Y05jIjOZ Q==;", "X-IronPort-AV": [ "E=McAfee;i=\"6200,9189,10274\"; a=\"314177962\"", "E=Sophos;i=\"5.90,149,1643702400\"; d=\"scan'208\";a=\"314177962\"", "E=Sophos;i=\"5.90,149,1643702400\"; d=\"scan'208\";a=\"551348139\"" ], "X-ExtLoop1": "1", "From": "Bruce Richardson <bruce.richardson@intel.com>", "To": "dev@dpdk.org", "Cc": "stable@dpdk.org,\n\tBruce Richardson <bruce.richardson@intel.com>", "Subject": "[PATCH 6/9] doc/linux_gsg: split VFIO section into subsections", "Date": "Wed, 2 Mar 2022 17:22:14 +0000", "Message-Id": "<20220302172217.472279-7-bruce.richardson@intel.com>", "X-Mailer": "git-send-email 2.32.0", "In-Reply-To": "<20220302172217.472279-1-bruce.richardson@intel.com>", "References": "<20220302172217.472279-1-bruce.richardson@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": "The VFIO section of the page about linux drivers was rather long and\nunstructured. This can be improved by splitting it up into subsections,\nto cover the specifics of memory limits and creating VFs. When moving\nthe various text notes into the relevant subsections, we can drop the\nnote about kernels earlier than 3.6, since DPDK no longer supports\nkernels that old.\n\nSigned-off-by: Bruce Richardson <bruce.richardson@intel.com>\n---\n doc/guides/linux_gsg/linux_drivers.rst | 35 ++++++++++++++------------\n 1 file changed, 19 insertions(+), 16 deletions(-)", "diff": "diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst\nindex af7e3c4fbc..e29f79e385 100644\n--- a/doc/guides/linux_gsg/linux_drivers.rst\n+++ b/doc/guides/linux_gsg/linux_drivers.rst\n@@ -122,6 +122,22 @@ To make use of VFIO, the ``vfio-pci`` module must be loaded:\n VFIO kernel is usually present by default in all distributions,\n however please consult your distributions documentation to make sure that is the case.\n \n+To make use of full VFIO functionality,\n+both kernel and BIOS must support and be configured\n+to use IO virtualization (such as Intel\\ |reg| VT-d).\n+\n+.. note::\n+\n+ In most cases, specifying \"iommu=on\" as kernel parameter should be enough to\n+ configure the Linux kernel to use IOMMU.\n+\n+For proper operation of VFIO when running DPDK applications as a non-privileged user, correct permissions should also be set up.\n+For more information, please refer to :ref:`Running_Without_Root_Privileges`.\n+\n+\n+VFIO Memory Mapping Limits\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n For DMA mapping of either external memory or hugepages, VFIO interface is used.\n VFIO does not support partial unmap of once mapped memory. Hence DPDK's memory is\n mapped in hugepage granularity or system page granularity. Number of DMA\n@@ -132,6 +148,9 @@ VFIO module parameter ``dma_entry_limit`` with a default value of 64K.\n When application is out of DMA entries, these limits need to be adjusted to\n increase the allowed limit.\n \n+Creating Virtual Functions using vfio-pci\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n Since Linux version 5.7,\n the ``vfio-pci`` module supports the creation of virtual functions.\n After the PF is bound to ``vfio-pci`` module,\n@@ -194,27 +213,11 @@ The token will be used for all PF and VF ports within the application.\n <build_dir>/app/dpdk-testpmd -l 26-29 -n 4 -a 86:02.0 \\\n --vfio-vf-token=14d63f20-8445-11ea-8900-1f9ce7d5650d --file-prefix=vf0 -- -i\n \n-To make use of full VFIO functionality,\n-both kernel and BIOS must support and be configured\n-to use IO virtualization (such as Intel\\ |reg| VT-d).\n-\n-.. note::\n-\n- Linux versions earlier than version 3.6 do not support VFIO.\n-\n .. note::\n \n Linux versions earlier than version 5.7 do not support the creation of\n virtual functions within the VFIO framework.\n \n-.. note::\n-\n- In most cases, specifying \"iommu=on\" as kernel parameter should be enough to\n- configure the Linux kernel to use IOMMU.\n-\n-For proper operation of VFIO when running DPDK applications as a non-privileged user, correct permissions should also be set up.\n-For more information, please refer to :ref:`Running_Without_Root_Privileges`.\n-\n .. _vfio_noiommu:\n \n VFIO no-IOMMU mode\n", "prefixes": [ "6/9" ] }