================ @@ -49,61 +49,178 @@ LLVM Target Triples -------------- -Use the Clang option ``--target=<Architecture>-<Vendor>-<OS>-<Environment>`` -to specify the target triple: +Use the Clang option ``--target=<Architecture><SubArch>-<Vendor>-<OS>-<Environment>`` +to specify the target triple. - .. table:: AMDGPU Architectures - :name: amdgpu-architecture-table - - ============ ============================================================== - Architecture Description - ============ ============================================================== - ``r600`` AMD GPUs HD2XXX-HD6XXX for graphics and compute shaders. - ``amdgcn`` AMD GPUs GCN GFX6 onwards for graphics and compute shaders. - ============ ============================================================== - - .. table:: AMDGPU Vendors - :name: amdgpu-vendor-table - - ============ ============================================================== - Vendor Description - ============ ============================================================== - ``amd`` Can be used for all AMD GPU usage. - ``mesa`` Can be used if the OS is ``mesa3d``. - ============ ============================================================== - - .. table:: AMDGPU Operating Systems - :name: amdgpu-os - - ============== ============================================================ - OS Description - ============== ============================================================ - *<empty>* Defaults to the *unknown* OS. - ``amdhsa`` Compute kernels executed on HSA [HSA]_ compatible runtimes - such as: - - - AMD's ROCm™ runtime [AMD-ROCm]_ using the *rocm-amdhsa* - loader on Linux. See *AMD ROCm Platform Release Notes* - [AMD-ROCm-Release-Notes]_ for supported hardware and - software. - - AMD's PAL runtime using the *pal-amdhsa* loader on - Windows. - - ``amdpal`` Graphic shaders and compute kernels executed on AMD's PAL - runtime using the *pal-amdpal* loader on Windows and Linux - Pro. - ``mesa3d`` Graphic shaders and compute kernels executed on AMD's Mesa - 3D runtime using the *mesa-mesa3d* loader on Linux. - ============== ============================================================ - - .. table:: AMDGPU Environments - :name: amdgpu-environment-table +.. note:: + Historically, the single top-level ``amdgcn`` architecture was used + for all devices and specific devices by the subtarget. It has been + replaced with the ``amdgpu`` architecture combined with a subarch + suffix. The legacy spelling is accepted for accepted for + compatibility. ---------------- slinder1 wrote:
This doesn't read great to me, still. Maybe something like: ```suggestion .. note:: Historically, the single top-level ``amdgcn`` architecture was used for all devices, with specific devices being identified using the subtarget. It has been replaced with the ``amdgpu`` architecture combined with a subarch suffix. The legacy spelling is accepted for compatibility. ``` https://github.com/llvm/llvm-project/pull/206480 _______________________________________________ cfe-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
