Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/84368/?format=api
{ "id": 84368, "url": "http://patchwork.dpdk.org/api/patches/84368/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/5d2b797b8f97381dac97bd59957df2ec96cd5239.1605785484.git.anatoly.burakov@intel.com/", "project": { "id": 1, "url": "http://patchwork.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": "<5d2b797b8f97381dac97bd59957df2ec96cd5239.1605785484.git.anatoly.burakov@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/5d2b797b8f97381dac97bd59957df2ec96cd5239.1605785484.git.anatoly.burakov@intel.com", "date": "2020-11-19T11:32:31", "name": "[v3,3/4] doc: add VFIO no-IOMMU Linux GSG section", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "fb5a7e19a242a4a2d607f8c190c2a759ad7d8f03", "submitter": { "id": 4, "url": "http://patchwork.dpdk.org/api/people/4/?format=api", "name": "Anatoly Burakov", "email": "anatoly.burakov@intel.com" }, "delegate": { "id": 1, "url": "http://patchwork.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/5d2b797b8f97381dac97bd59957df2ec96cd5239.1605785484.git.anatoly.burakov@intel.com/mbox/", "series": [ { "id": 13978, "url": "http://patchwork.dpdk.org/api/series/13978/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=13978", "date": "2020-11-19T11:32:29", "name": "[v3,1/4] doc: move VFIO driver to be first", "version": 3, "mbox": "http://patchwork.dpdk.org/series/13978/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/84368/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/84368/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 dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 5BA96A04DD;\n\tThu, 19 Nov 2020 12:33:15 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id C8D67C86E;\n\tThu, 19 Nov 2020 12:32:42 +0100 (CET)", "from mga18.intel.com (mga18.intel.com [134.134.136.126])\n by dpdk.org (Postfix) with ESMTP id 2C6CB3B5\n for <dev@dpdk.org>; Thu, 19 Nov 2020 12:32:38 +0100 (CET)", "from fmsmga002.fm.intel.com ([10.253.24.26])\n by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 19 Nov 2020 03:32:36 -0800", "from silpixa00399498.ir.intel.com (HELO\n silpixa00399498.ger.corp.intel.com) ([10.237.222.52])\n by fmsmga002.fm.intel.com with ESMTP; 19 Nov 2020 03:32:35 -0800" ], "IronPort-SDR": [ "\n +G3Npuo+HVfyQQIjGMnfYy0j8YzC/ij/YQ40iQHnQ9b3EAFJx/BgpVsc/CiV6r5dnwyZ5kCA45\n 8GRE6u37tW4Q==", "\n 6JBfwZCikvBgBkupncB4d/VGFx6kP1YHIEmmxC7r5QKs88S+AT9DdPtj90VYyAcwBu5JVEFWAj\n WIHjp/W9U8PA==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9809\"; a=\"159046293\"", "E=Sophos;i=\"5.77,490,1596524400\"; d=\"scan'208\";a=\"159046293\"", "E=Sophos;i=\"5.77,490,1596524400\"; d=\"scan'208\";a=\"363351468\"" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "From": "Anatoly Burakov <anatoly.burakov@intel.com>", "To": "dev@dpdk.org", "Cc": "thomas@monjalon.net,\n\tjohn.mcnamara@intel.com", "Date": "Thu, 19 Nov 2020 11:32:31 +0000", "Message-Id": "\n <5d2b797b8f97381dac97bd59957df2ec96cd5239.1605785484.git.anatoly.burakov@intel.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": [ "\n <374a115faa7be0f12ce89a39ef30e518bb3b0ca3.1605785484.git.anatoly.burakov@intel.com>", "\n <6d1a335178212c2983a8e59b7fcf66001c9b262a.1605713845.git.anatoly.burakov@intel.com>" ], "References": [ "\n <374a115faa7be0f12ce89a39ef30e518bb3b0ca3.1605785484.git.anatoly.burakov@intel.com>", "\n <6d1a335178212c2983a8e59b7fcf66001c9b262a.1605713845.git.anatoly.burakov@intel.com>" ], "Subject": "[dpdk-dev] [PATCH v3 3/4] doc: add VFIO no-IOMMU Linux GSG section", "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 <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", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Currently, we have no documentation on how to use VFIO in no-IOMMU mode.\nAdd such documentation.\n\nSigned-off-by: Anatoly Burakov <anatoly.burakov@intel.com>\n---\n\nNotes:\n v2:\n - Fixed the noiommu parameter name\n\n doc/guides/linux_gsg/linux_drivers.rst | 28 +++++++++++++++++++++++++-\n 1 file changed, 27 insertions(+), 1 deletion(-)", "diff": "diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst\nindex 19ac61d8f9..9c61850dbb 100644\n--- a/doc/guides/linux_gsg/linux_drivers.rst\n+++ b/doc/guides/linux_gsg/linux_drivers.rst\n@@ -99,9 +99,35 @@ DPDK setup script (called ``dpdk-setup.sh`` and located in the ``usertools``\n directory). For more information, please refer to\n :ref:`Running_Without_Root_Privileges`.\n \n+VFIO no-IOMMU mode\n+------------------\n+\n+If there is no IOMMU available on the system, VFIO can still be used, but it has\n+to be loaded with an additional module parameter:\n+\n+.. code-block:: console\n+\n+ modprobe vfio enable_unsafe_noiommu_mode=1\n+\n+Alternatively, one can also enable this option in an already loaded kernel module:\n+\n+.. code-block:: console\n+\n+ echo 1 > /sys/module/vfio/parameters/enable_unsafe_noiommu_mode\n+\n+After that, VFIO can be used with hardware devices as usual.\n+\n .. note::\n \n- VFIO can be used without IOMMU. While this is unsafe, it does make it possible for the user to keep the degree of device access and programming that VFIO has, in situations where IOMMU is not available.\n+ It may be required to unload all VFIO related-modules before probing the\n+ module again with ``enable_unsafe_noiommu_mode=1`` parameter.\n+\n+.. warning::\n+\n+ Since no-IOMMU mode forgoes IOMMU protection, it is inherently unsafe. That\n+ said, it does make it possible for the user to keep the degree of device\n+ access and programming that VFIO has, in situations where IOMMU is not\n+ available.\n \n UIO\n ---\n", "prefixes": [ "v3", "3/4" ] }