Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/67995/?format=api
{ "id": 67995, "url": "https://patches.dpdk.org/api/patches/67995/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20200408082921.31000-30-mk@semihalf.com/", "project": { "id": 1, "url": "https://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": "<20200408082921.31000-30-mk@semihalf.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20200408082921.31000-30-mk@semihalf.com", "date": "2020-04-08T08:29:20", "name": "[v3,29/30] doc: add notes on ENA usage on metal instances", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "b0ec2f3c6ce44560330e6c7d761f59df4f697b4f", "submitter": { "id": 786, "url": "https://patches.dpdk.org/api/people/786/?format=api", "name": "Michal Krawczyk", "email": "mk@semihalf.com" }, "delegate": { "id": 319, "url": "https://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20200408082921.31000-30-mk@semihalf.com/mbox/", "series": [ { "id": 9246, "url": "https://patches.dpdk.org/api/series/9246/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=9246", "date": "2020-04-08T08:28:51", "name": "Update ENA driver to v2.1.0", "version": 3, "mbox": "https://patches.dpdk.org/series/9246/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/67995/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/67995/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 604C3A0597;\n\tWed, 8 Apr 2020 10:34:39 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id AB6C91C202;\n\tWed, 8 Apr 2020 10:30:10 +0200 (CEST)", "from mail-lj1-f170.google.com (mail-lj1-f170.google.com\n [209.85.208.170]) by dpdk.org (Postfix) with ESMTP id D32051C1E1\n for <dev@dpdk.org>; Wed, 8 Apr 2020 10:30:03 +0200 (CEST)", "by mail-lj1-f170.google.com with SMTP id q19so6646174ljp.9\n for <dev@dpdk.org>; Wed, 08 Apr 2020 01:30:03 -0700 (PDT)", "from mkPC.semihalf.local (193-106-246-138.noc.fibertech.net.pl.\n [193.106.246.138])\n by smtp.gmail.com with ESMTPSA id e8sm765685lja.3.2020.04.08.01.30.01\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 08 Apr 2020 01:30:02 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=semihalf-com.20150623.gappssmtp.com; s=20150623;\n h=from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding;\n bh=gc7V4sTSOgeD1dMtWciT8dmyT5xWcLtVV7uSLTY6Pdc=;\n b=mCY9E4feEdJufFJV3b/S4orMD9JjFx87vVGiQVYgKEadShcT6EkZPF679AZtJD+9Y1\n aVSzZ8JYcz3FcpIecYamDpc94o/ylGxr9oaNQlvG6rY00GBG3e8zsq2UH7x/XJV0E2U6\n oIr3aJgK6AQiUbSOVbqM2epdqQ8jUjEZ63B6K3/twAhuWEuFhfCZlIJ9nYOAPNpsXyt+\n VJ0zA97bh8GrxqrCBhDu5+9CR+uCbVCoXYSmrQlqB+Dg4g+nzhzbdzC7TCwOPtB9Rv9R\n 3QFGpiNY6mLexxFN5kv83OH3vGyXzPdSJBdCW+oNBt6O39qrhxhHcAR8WdYL0i0EzY1n\n JgDw==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20161025;\n h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n :references:mime-version:content-transfer-encoding;\n bh=gc7V4sTSOgeD1dMtWciT8dmyT5xWcLtVV7uSLTY6Pdc=;\n b=m19MlLM0te0dkesBc6R5t3Rzt7GsGClsWATJ2s6cLFeH0q1pRMqYA48mP5E/WAfAfy\n dRsf1kijkqXZvme95kg6URk9BgRA9b+BCRZ0JGsXoOHT2Bu+ACCzcr3TNbWGRewnZa6S\n v3YvDK0wj2oqwpPmGRSmH+LddEuyQrQtkvIKEiM5ZFX7hwNGiV7MFTr+gkHvtXqe+Vet\n OHxNX+W/Chq0Wtg6jVfc99TXuRQInkE35xqxQBK+82bgYGRHlMZfHhZb3JOzGQ+V8d3n\n esEJOcEswiG1ddp9IfIyVwpXpVHMg9g901oVX68vvq6fVSA6DA9HtXAX+vbdoPM5Zj+e\n tkVg==", "X-Gm-Message-State": "AGi0PuYXqrGKNC3smsYn9TEQQkTPqInndXJTj0DT/5X24T9WBIy0gQbK\n fXBgPy1OCVsz6EXQ65Hc4z6TH+cqWho=", "X-Google-Smtp-Source": "\n APiQypJz3uf1YwtBp2wuWW3Hv/7Kmk8fZFfEcZge43VMuX4uiZNcNamGk5ZcDi9nFlB4AAENK8pb0w==", "X-Received": "by 2002:a2e:9cce:: with SMTP id g14mr4137717ljj.161.1586334603167;\n Wed, 08 Apr 2020 01:30:03 -0700 (PDT)", "From": "Michal Krawczyk <mk@semihalf.com>", "To": "dev@dpdk.org", "Cc": "mw@semihalf.com, mba@semihalf.com, gtzalik@amazon.com, evgenys@amazon.com,\n igorch@amazon.com, ferruh.yigit@intel.com, arybchenko@solarflare.com,\n Michal Krawczyk <mk@semihalf.com>", "Date": "Wed, 8 Apr 2020 10:29:20 +0200", "Message-Id": "<20200408082921.31000-30-mk@semihalf.com>", "X-Mailer": "git-send-email 2.20.1", "In-Reply-To": "<20200408082921.31000-1-mk@semihalf.com>", "References": "<20200408082921.31000-1-mk@semihalf.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH v3 29/30] doc: add notes on ENA usage on metal\n\tinstances", "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": "As AWS metal instances are supporting IOMMU, the usage of igb_uio or\nvfio-pci can lead to a problems (when to use which module), especially\nthat the vfio-pci isn't supporting SMMU on arm64.\n\nTo clear up the problem of using those modules in various setup\nconditions (with or without IOMMU) on metal instances, more detailed\nexplanation was added.\n\nSigned-off-by: Michal Krawczyk <mk@semihalf.com>\nReviewed-by: Igor Chauskin <igorch@amazon.com>\nReviewed-by: Guy Tzalik <gtzalik@amazon.com>\n---\n doc/guides/nics/ena.rst | 48 +++++++++++++++++++++++++++++++++++++++--\n 1 file changed, 46 insertions(+), 2 deletions(-)", "diff": "diff --git a/doc/guides/nics/ena.rst b/doc/guides/nics/ena.rst\nindex 0b9622ac85..bec97c3326 100644\n--- a/doc/guides/nics/ena.rst\n+++ b/doc/guides/nics/ena.rst\n@@ -187,11 +187,55 @@ Prerequisites\n \n echo 1 > /sys/module/vfio/parameters/enable_unsafe_noiommu_mode\n \n-#. Bind the intended ENA device to ``vfio-pci`` or ``igb_uio`` module.\n+ To use ``noiommu`` mode, the ``vfio-pci`` must be built with flag\n+ ``CONFIG_VFIO_NOIOMMU``.\n \n+#. Bind the intended ENA device to ``vfio-pci`` or ``igb_uio`` module.\n \n At this point the system should be ready to run DPDK applications. Once the\n-application runs to completion, the ENA can be detached from igb_uio if necessary.\n+application runs to completion, the ENA can be detached from attached module if\n+necessary.\n+\n+**Note about usage on \\*.metal instances**\n+\n+On AWS, the metal instances are supporting IOMMU for both arm64 and x86_64\n+hosts.\n+\n+* x86_64 (e.g. c5.metal, i3.metal):\n+ IOMMU should be disabled by default. In that situation, the ``igb_uio`` can\n+ be used as it is but ``vfio-pci`` should be working in no-IOMMU mode (please\n+ see above).\n+\n+ When IOMMU is enabled, ``igb_uio`` cannot be used as it's not supporting this\n+ feature, while ``vfio-pci`` should work without any changes.\n+ To enable IOMMU on those hosts, please update ``GRUB_CMDLINE_LINUX`` in file\n+ ``/etc/default/grub`` with the below extra boot arguments::\n+\n+ iommu=1 intel_iommu=on\n+\n+ Then, make the changes live by executing as a root::\n+\n+ # grub2-mkconfig > /boot/grub2/grub.cfg\n+\n+ Finally, reboot should result in IOMMU being enabled.\n+\n+* arm64 (a1.metal):\n+ IOMMU should be enabled by default. Unfortunately, ``vfio-pci`` isn't\n+ supporting SMMU, which is implementation of IOMMU for arm64 architecture and\n+ ``igb_uio`` isn't supporting IOMMU at all, so to use DPDK with ENA on those\n+ hosts, one must disable IOMMU. This can be done by updating\n+ ``GRUB_CMDLINE_LINUX`` in file ``/etc/default/grub`` with the extra boot\n+ argument::\n+\n+ iommu.passthrough=1\n+\n+ Then, make the changes live by executing as a root::\n+\n+ # grub2-mkconfig > /boot/grub2/grub.cfg\n+\n+ Finally, reboot should result in IOMMU being disabled.\n+ Without IOMMU, ``igb_uio`` can be used as it is but ``vfio-pci`` should be\n+ working in no-IOMMU mode (please see above).\n \n Usage example\n -------------\n", "prefixes": [ "v3", "29/30" ] }