[PATCH] docs/x86: Update AMD IOMMU specification locationi

[PATCH] docs/x86: Update AMD IOMMU specification locationi

[Richard Lyu]

The current link to the AMD I/O Virtualization Technology IOMMU
specification (document 48882) in Documentation/arch/x86/iommu.rst
is outdated and points to a defunct URL on the AMD website.

Update the link in Documentation/arch/x86/iommu.rst to the current stable
location for the specification. This ensures users can easily access the
required architectural details.

Signed-off-by: Richard Lyu <richard.lyu@suse.com>
---
 Documentation/arch/x86/iommu.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/arch/x86/iommu.rst b/Documentation/arch/x86/iommu.rst
index 41fbadfe2221..cd1843812b4b 100644
--- a/Documentation/arch/x86/iommu.rst
+++ b/Documentation/arch/x86/iommu.rst
@@ -5,7 +5,7 @@ x86 IOMMU Support
 The architecture specs can be obtained from the below locations.
 
 - Intel: http://www.intel.com/content/dam/www/public/us/en/documents/product-specifications/vt-directed-io-spec.pdf
-- AMD: https://www.amd.com/content/dam/amd/en/documents/processor-tech-docs/specifications/48882_3_07_PUB.pdf
+- AMD: https://docs.amd.com/v/u/en-US/48882_IOMMU
 
 This guide gives a quick cheat sheet for some basic understanding.
 
-- 
2.51.0

Re: [PATCH] docs/x86: Update AMD IOMMU specification locationi

[Borislav Petkov]

On Mon, Jan 05, 2026 at 11:05:54PM +0800, Richard Lyu wrote:
> The current link to the AMD I/O Virtualization Technology IOMMU
> specification (document 48882) in Documentation/arch/x86/iommu.rst
> is outdated and points to a defunct URL on the AMD website.
> 
> Update the link in Documentation/arch/x86/iommu.rst to the current stable
> location for the specification. This ensures users can easily access the
> required architectural details.
> 
> Signed-off-by: Richard Lyu <richard.lyu@suse.com>
> ---
>  Documentation/arch/x86/iommu.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/Documentation/arch/x86/iommu.rst b/Documentation/arch/x86/iommu.rst
> index 41fbadfe2221..cd1843812b4b 100644
> --- a/Documentation/arch/x86/iommu.rst
> +++ b/Documentation/arch/x86/iommu.rst
> @@ -5,7 +5,7 @@ x86 IOMMU Support
>  The architecture specs can be obtained from the below locations.
>  
>  - Intel: http://www.intel.com/content/dam/www/public/us/en/documents/product-specifications/vt-directed-io-spec.pdf
> -- AMD: https://www.amd.com/content/dam/amd/en/documents/processor-tech-docs/specifications/48882_3_07_PUB.pdf
> +- AMD: https://docs.amd.com/v/u/en-US/48882_IOMMU
>  
>  This guide gives a quick cheat sheet for some basic understanding.

What I'd do instead is leave enough breadcrumbs here in the text - doc ID, doc
title etc, so that people can actually find the document by using a search
engine which has managed to index it.

Instead of updating links mindlessly because those do change constantly. No
matter the vendor - as long as it is a corporate website, links get changed on
a regular basis.

I'd say.

-- 
Regards/Gruss,
    Boris.

https://people.kernel.org/tglx/notes-about-netiquette

Re: [PATCH] docs/x86: Update AMD IOMMU specification locationi

[Borislav Petkov]

On Tue, Jan 06, 2026 at 12:10:41PM +0800, Richard Lyu wrote:
> I completely agree. Corporate URLs are fragile and lead to constant link rot.
> Using persistent metadata like the Doc ID and formal title is a much more
> robust approach for long-term maintenance. 
> I'll update the documentation to use these stable identifiers instead of direct
> links.

Thanks.

Btw, I see you're new to this. Please read

https://people.kernel.org/tglx/notes-about-netiquette

about how to do public mailing lists and also:

https://kernel.org/doc/html/latest/process/submitting-patches.html

Thx.

-- 
Regards/Gruss,
    Boris.

https://people.kernel.org/tglx/notes-about-netiquette

Re: [PATCH] docs/x86: Update AMD IOMMU specification locationi

[Richard Lyu]

On 2026/01/07 15:53, Borislav Petkov wrote:
> 
> Btw, I see you're new to this. Please read
> 
> https://people.kernel.org/tglx/notes-about-netiquette
> 
> about how to do public mailing lists and also:
> 
> https://kernel.org/doc/html/latest/process/submitting-patches.html

Hi Borislav,

Thanks for the pointers. I've realized where I went wrong. I will study 
the documentation carefully and ensure my future contributions follow the 
guidelines, and I'll send an updated version.

Best Regards
Richard Lyu