Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/108497/?format=api
{ "id": 108497, "url": "http://patches.dpdk.org/api/patches/108497/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220302172217.472279-4-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-4-bruce.richardson@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220302172217.472279-4-bruce.richardson@intel.com", "date": "2022-03-02T17:22:11", "name": "[3/9] doc/linux_gsg: make UIO safety warning more visible", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "ce3d20aa4b90ccd53e83843558ec2b7efba32f6c", "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-4-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/108497/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/108497/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 DECB7A04A4;\n\tWed, 2 Mar 2022 18:24:26 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 320AF42754;\n\tWed, 2 Mar 2022 18:24:14 +0100 (CET)", "from mga14.intel.com (mga14.intel.com [192.55.52.115])\n by mails.dpdk.org (Postfix) with ESMTP id 625E742758;\n Wed, 2 Mar 2022 18:24:12 +0100 (CET)", "from orsmga008.jf.intel.com ([10.7.209.65])\n by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 02 Mar 2022 09:24:11 -0800", "from silpixa00399126.ir.intel.com ([10.237.223.34])\n by orsmga008.jf.intel.com with ESMTP; 02 Mar 2022 09:24:10 -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=1646241852; x=1677777852;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=W/WXqetrPzHPU1i0W4z6TE+FVsvpRPyPTwocyJ//w7U=;\n b=XxzHfB5PLv3HdhtF8OI02Wiw4YDdFu68k+qcV1i/O4vY/lu20kIH9FW+\n zMIfzXnXU5ofXUxdcE6kQse16iv2X/n+1qcSb550QYBZ3swmEFMJxKEmt\n 2UVzvOaj7Aak7tveGeWQVFlfpEK9E48Z9N9Str6vkNxrJEyRkGBBs1BSH\n f7CDr0LhflzsRE0XlDzYG7petaZa4iYwjF9FcL1ZktvU3Xat9FLXIHgLU\n a8uGyenyxZTSviHjxP/gcB5QfZbVTgSSrNEMgBxdibryk1Sk0TivfHOii\n ZN3lMA1uQdc1zf+z66YAZW8RsLL/jZATXnIIo+IfyXi4+nAXHUBzK0gP4 w==;", "X-IronPort-AV": [ "E=McAfee;i=\"6200,9189,10274\"; a=\"253651976\"", "E=Sophos;i=\"5.90,149,1643702400\"; d=\"scan'208\";a=\"253651976\"", "E=Sophos;i=\"5.90,149,1643702400\"; d=\"scan'208\";a=\"551348118\"" ], "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 3/9] doc/linux_gsg: make UIO safety warning more visible", "Date": "Wed, 2 Mar 2022 17:22:11 +0000", "Message-Id": "<20220302172217.472279-4-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 GSG has a note warning that use of UIO is inherently unsafe due to\nlack of IOMMU protection. However, this was only flagged as a \"NOTE\",\nmeaning it could easily be missed. Changing the rst tag from \"note\" to\n\"warning\" and moving it to the top of the UIO subsection makes this a\nlot more visible to users.\n\nSigned-off-by: Bruce Richardson <bruce.richardson@intel.com>\n---\n doc/guides/linux_gsg/linux_drivers.rst | 10 +++++-----\n 1 file changed, 5 insertions(+), 5 deletions(-)\n\n--\n2.32.0", "diff": "diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst\nindex 75af2f01e1..2cdacf0961 100644\n--- a/doc/guides/linux_gsg/linux_drivers.rst\n+++ b/doc/guides/linux_gsg/linux_drivers.rst\n@@ -153,6 +153,11 @@ After that, VFIO can be used with hardware devices as usual.\n UIO\n ---\n\n+.. warning::\n+\n+ Using UIO drivers is inherently unsafe due to this method lacking IOMMU protection,\n+ and can only be done by root user.\n+\n In situations where using VFIO is not an option, there are alternative drivers one can use.\n In many cases, the standard ``uio_pci_generic`` module included in the Linux kernel\n can be used as a substitute for VFIO. This module can be loaded using the command:\n@@ -195,11 +200,6 @@ It can be loaded as shown below:\n in GRUB command line on x86_64 systems,\n or add ``iommu.passthrough=1`` on aarch64 systems.\n\n-.. note::\n-\n- Using UIO drivers is inherently unsafe due to this method lacking IOMMU protection,\n- and can only be done by root user.\n-\n .. _bifurcated_driver:\n\n Bifurcated Driver\n", "prefixes": [ "3/9" ] }