]> git.ipfire.org Git - thirdparty/linux.git/commit
iommu/amd: Document which IRTE fields amd_iommu_update_ga() can modify
authorSean Christopherson <seanjc@google.com>
Wed, 11 Jun 2025 22:45:42 +0000 (15:45 -0700)
committerSean Christopherson <seanjc@google.com>
Mon, 23 Jun 2025 16:50:37 +0000 (09:50 -0700)
commit3be405e89f3daea23ddfcf6b6526ae44ce38dd9a
tree666be0ca17740842fa096446310dfa1183ed25b8
parentc3d591c91f9c99a35f8cf80d28ea689214a1acf3
iommu/amd: Document which IRTE fields amd_iommu_update_ga() can modify

Add a comment to amd_iommu_update_ga() to document what fields it can
safely modify without issuing an invalidation of the IRTE, and to explain
its role in keeping GA IRTEs up-to-date.

Per page 93 of the IOMMU spec dated Feb 2025:

  When virtual interrupts are enabled by setting MMIO Offset 0018h[GAEn] and
  IRTE[GuestMode=1], IRTE[IsRun], IRTE[Destination], and if present IRTE[GATag],
  are not cached by the IOMMU. Modifications to these fields do not require an
  invalidation of the Interrupt Remapping Table.

Link: https://lore.kernel.org/all/9b7ceea3-8c47-4383-ad9c-1a9bbdc9044a@oracle.com
Cc: Joao Martins <joao.m.martins@oracle.com>
Link: https://lore.kernel.org/r/20250611224604.313496-41-seanjc@google.com
Signed-off-by: Sean Christopherson <seanjc@google.com>
drivers/iommu/amd/iommu.c