https://gcc.gnu.org/g:aa8ba1b0d90b86c7fd5c1689b1563a6d5a7e5cdf
commit r16-3455-gaa8ba1b0d90b86c7fd5c1689b1563a6d5a7e5cdf
Author: Tobias Burnus <tbur...@baylibre.com>
Date: Fri Aug 29 09:47:52 2025 +0200
install.texi: For amdgcn, clarify which llvm-* binaries are required
Also remove future tense for ROCm as 6.4.0 has been released in April 2025
and it supports generic architectures.
gcc/ChangeLog:
* doc/install.texi (amdgcn): Clarify which binaries must be the
LLVM version and which must be installed. Update version data for
ROCm for generic architectures.
Diff:
---
gcc/doc/install.texi | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index f2a8d0e24abe..f404a922d405 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -4068,7 +4068,12 @@ Instead of GNU Binutils, you need to install LLVM and
copy
@file{bin/llvm-objdump} to @file{amdgcn-amdhsa/bin/objdump},
@file{bin/llvm-nm} to @file{amdgcn-amdhsa/bin/nm}, and
@file{bin/llvm-ar} to both @file{bin/amdgcn-amdhsa-ar} and
-@file{bin/amdgcn-amdhsa-ranlib}.
+@file{bin/amdgcn-amdhsa-ranlib}. The LLVM version is required for the
+assembler (llvm-mc) and linker (lld); however, for the others, the respective
+GNU Binutils counterpart can be used instead. While all mentioned programs are
+required when building GCC, the installed GCC compiler only needs the assembler
+and linker; @code{nm}, @code{ar}, and @code{ranlib} are required when
installing
+@code{gcc-nm}, @code{gcc-ar}, and @code{gcc-ranlib}.
The required version of LLVM depends on the devices that you want to support.
As the list of ISAs is long, GCC by default only builds a subset of the
@@ -4092,8 +4097,7 @@ ISA targets @code{gfx9-generic}, @code{gfx10-3-generic},
and
@code{gfx11-generic} reduce the number of required multilibs but note
that @code{gfx9-generic} does not include @code{gfx908} or @code{gfx90a},
that linking specific ISA code with generic code is currently not supported,
-and that only a future ROCm release (newer than 6.3.3) will be able to execute
-generic code.
+and that only ROCm 6.4.0 or newer is able to execute generic code.
Use Newlib (4.3.0 or newer; 4.4.0 contains some improvements and 4.5.0 fixes
the device console output for GFX10 and GFX11 devices; post-4.5.0
