Index: docs/AMDGPUUsage.rst =================================================================== --- docs/AMDGPUUsage.rst +++ docs/AMDGPUUsage.rst @@ -912,6 +912,28 @@ .. _amdgpu-amdhsa-hsa-code-object-metadata: +Code Object Target Identification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The AMDHSA OS uses the following syntax to specify the code object +target as a single string: + + ``-----`` + +Where the first four components are the same as the *Target Triple* +(see :ref:`amdgpu-target-triples`), the next component is the same as +the *Processor* (see :ref:`amdgpu-processors`) and the last component +is a comma separated list of the enabled *Target Features* that apply +to *Processor* in the same order as listed in the table +:ref:`amdgpu-target-feature-table` (see +:ref:`amdgpu-target-features`). Note that *Target Features* must be +included in the list if they are enabled even if that is the default for +*Processor*. + +For example: + + ``"amdgcn-amd-amdhsa--gfx902-xnack"`` + Code Object Metadata ~~~~~~~~~~~~~~~~~~~~