From: Alex Deucher <alexander.deucher@amd.com>
To: <linux-doc@vger.kernel.org>, <linux-kernel@vger.kernel.org>,
<corbet@lwn.net>, <hpa@zytor.com>, <x86@kernel.org>,
<dave.hansen@linux.intel.com>, <bp@alien8.de>, <mingo@redhat.com>,
<tglx@linutronix.de>, <joro@8bytes.org>,
<suravee.suthikulpanit@amd.com>, <will@kernel.org>,
<iommu@lists.linux-foundation.org>, <robin.murphy@arm.com>,
<vasant.hegde@amd.com>
Cc: Alex Deucher <alexander.deucher@amd.com>
Subject: [PATCH V3 2/2] Documentation: x86: Clarify Intel IOMMU documentation
Date: Mon, 28 Mar 2022 13:28:29 -0400 [thread overview]
Message-ID: <20220328172829.718235-3-alexander.deucher@amd.com> (raw)
In-Reply-To: <20220328172829.718235-1-alexander.deucher@amd.com>
Based on feedback from Robin on the initial AMD IOMMU
documentation, fix up the Intel documentation to
clarify IOMMU vs device and modern DMA API.
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>
---
V2: Fix spelling error in commit message
Rework ACPI section as suggested by Dave Hansen
Documentation/x86/intel-iommu.rst | 11 +++++------
1 file changed, 5 insertions(+), 6 deletions(-)
diff --git a/Documentation/x86/intel-iommu.rst b/Documentation/x86/intel-iommu.rst
index 4d3391c7bd3f..17d8497e506b 100644
--- a/Documentation/x86/intel-iommu.rst
+++ b/Documentation/x86/intel-iommu.rst
@@ -19,9 +19,8 @@ Some Keywords
Basic stuff
-----------
-ACPI enumerates and lists the different DMA engines in the platform, and
-device scope relationships between PCI devices and which DMA engine controls
-them.
+ACPI enumerates both the IOMMUs in the platform and which IOMMU
+controls a specific PCI device.
What is RMRR?
-------------
@@ -36,9 +35,9 @@ unity mappings for these regions for these devices to access these regions.
How is IOVA generated?
----------------------
-Well behaved drivers call pci_map_*() calls before sending command to device
+Well behaved drivers call dma_map_*() calls before sending command to device
that needs to perform DMA. Once DMA is completed and mapping is no longer
-required, device performs a pci_unmap_*() calls to unmap the region.
+required, device performs a dma_unmap_*() calls to unmap the region.
The Intel IOMMU driver allocates a virtual address per domain. Each PCIE
device has its own domain (hence protection). Devices under p2p bridges
@@ -68,7 +67,7 @@ address from PCI MMIO ranges so they are not allocated for IOVA addresses.
Fault reporting
---------------
-When errors are reported, the DMA engine signals via an interrupt. The fault
+When errors are reported, the IOMMU signals via an interrupt. The fault
reason and device that caused it with fault reason is printed on console.
See below for sample.
--
2.35.1
next prev parent reply other threads:[~2022-03-28 17:28 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-03-28 17:28 [PATCH V3 0/2] x86 IOMMU Documentation updates Alex Deucher
2022-03-28 17:28 ` [PATCH V3 1/2] Documentation: x86: Add documentation for AMD IOMMU Alex Deucher
2022-03-29 15:24 ` Dave Hansen
2022-03-30 14:01 ` Deucher, Alexander
2022-03-30 14:20 ` Dave Hansen
2022-03-28 17:28 ` Alex Deucher [this message]
2022-03-29 6:38 ` [PATCH V3 2/2] Documentation: x86: Clarify Intel IOMMU documentation Bagas Sanjaya
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220328172829.718235-3-alexander.deucher@amd.com \
--to=alexander.deucher@amd.com \
--cc=bp@alien8.de \
--cc=corbet@lwn.net \
--cc=dave.hansen@linux.intel.com \
--cc=hpa@zytor.com \
--cc=iommu@lists.linux-foundation.org \
--cc=joro@8bytes.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mingo@redhat.com \
--cc=robin.murphy@arm.com \
--cc=suravee.suthikulpanit@amd.com \
--cc=tglx@linutronix.de \
--cc=vasant.hegde@amd.com \
--cc=will@kernel.org \
--cc=x86@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®