Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/84369/?format=api
{ "id": 84369, "url": "http://patchwork.dpdk.org/api/patches/84369/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/75243d22963555e1460b243df6bb12efd146abf4.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": "<75243d22963555e1460b243df6bb12efd146abf4.1605785484.git.anatoly.burakov@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/75243d22963555e1460b243df6bb12efd146abf4.1605785484.git.anatoly.burakov@intel.com", "date": "2020-11-19T11:32:32", "name": "[v3,4/4] doc: add VFIO troubleshooting section", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "3a62b0c71cb0cd4654e1ca65f94c4f8f427fb760", "submitter": { "id": 4, "url": "http://patchwork.dpdk.org/api/people/4/?format=api", "name": "Burakov, Anatoly", "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/75243d22963555e1460b243df6bb12efd146abf4.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/84369/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/84369/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 CCE12A04DD;\n\tThu, 19 Nov 2020 12:33:41 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 0A0E4C8DC;\n\tThu, 19 Nov 2020 12:32:46 +0100 (CET)", "from mga18.intel.com (mga18.intel.com [134.134.136.126])\n by dpdk.org (Postfix) with ESMTP id 32B254C96\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:37 -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:36 -0800" ], "IronPort-SDR": [ "\n 30vWoQCsX95pr+O571uSZgnqzIb085qs93qwi7EmY4N0phR0EDLb649JaooPf4Drelt9X6re8z\n L/PyQQkJAUGQ==", "\n QQynhBoJYz4VREw45wZrYFMtP8EKjyI4e0yIPV5xUvrxEdVfP+L7Awz/GxG+dTRPJYfDZYB9Fe\n JCmLw7uxn3Dw==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9809\"; a=\"159046298\"", "E=Sophos;i=\"5.77,490,1596524400\"; d=\"scan'208\";a=\"159046298\"", "E=Sophos;i=\"5.77,490,1596524400\"; d=\"scan'208\";a=\"363351472\"" ], "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:32 +0000", "Message-Id": "\n <75243d22963555e1460b243df6bb12efd146abf4.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>" ], "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH v3 4/4] doc: add VFIO troubleshooting 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": "There are common problems with VFIO that get asked over and over on the\nmailing list. Document common problems with VFIO and how to fix them or\nat least figure out what went wrong.\n\nSigned-off-by: Anatoly Burakov <anatoly.burakov@intel.com>\n---\n doc/guides/linux_gsg/linux_drivers.rst | 43 ++++++++++++++++++++++++++\n 1 file changed, 43 insertions(+)", "diff": "diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst\nindex 9c61850dbb..f3c06c68d1 100644\n--- a/doc/guides/linux_gsg/linux_drivers.rst\n+++ b/doc/guides/linux_gsg/linux_drivers.rst\n@@ -276,3 +276,46 @@ To restore device ``82:00.0`` to its original kernel binding:\n .. code-block:: console\n \n ./usertools/dpdk-devbind.py --bind=ixgbe 82:00.0\n+\n+Troubleshooting VFIO\n+--------------------\n+\n+In certain situations, using ``dpdk-devbind.py`` script to bing a device to VFIO\n+driver may fail. The first place to check is the kernel messages:\n+\n+.. code-block:: console\n+\n+ # dmesg | tail\n+ ...\n+ [ 1297.875090] vfio-pci: probe of 0000:31:00.0 failed with error -22\n+ ...\n+\n+In most cases, the ``error -22`` indicates that the VFIO subsystem couldn't be\n+enabled because there is no IOMMU support. To check whether the kernel has been\n+booted with correct parameters, one can check the kernel command-line:\n+\n+.. code-block:: console\n+\n+ cat /proc/cmdline\n+\n+Please refer to earlier sections on how to configure kernel parameters correctly\n+for your system.\n+\n+If the kernel is configured correctly, one also has to make sure that the BIOS\n+configuration has virtualization features (such as Intel® VT-d). There is no\n+standard way to check if the platform is configured correctly, so please check\n+with your platform documentation to see if it has such features, and how to\n+enable them.\n+\n+In certain distributions, default kernel configuration is such that the no-IOMMU\n+mode is disabled altogether at compile time. This can be checked in the boot\n+configuration of your system:\n+\n+.. code-block:: console\n+\n+ # cat /boot/config-$(uname -r) | grep NOIOMMU\n+ # CONFIG_VFIO_NOIOMMU is not set\n+\n+If ``CONFIG_VFIO_NOIOMMU`` is not enabled in the kernel configuration, VFIO\n+driver will not support the no-IOMMU mode, and other alternatives (such as UIO\n+drivers) will have to be used.\n", "prefixes": [ "v3", "4/4" ] }