Index: llvm/docs/AMDGPUUsage.rst =================================================================== --- llvm/docs/AMDGPUUsage.rst +++ llvm/docs/AMDGPUUsage.rst @@ -23,6 +23,7 @@ AMDGPUInstructionSyntax AMDGPUInstructionNotation AMDGPUDwarfExtensionsForHeterogeneousDebugging + AMDGPULLVMExtensionsForHeterogeneousDebugging AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack Introduction @@ -1018,12 +1019,12 @@ * ``ELFABIVERSION_AMDGPU_HSA_V3`` is used to specify the version of AMD HSA runtime ABI for code object V3. Specify using the Clang option - ``-mcode-object-version=3``. This is the default code object - version if not specified. + ``-mcode-object-version=3``. * ``ELFABIVERSION_AMDGPU_HSA_V4`` is used to specify the version of AMD HSA runtime ABI for code object V4. Specify using the Clang option - ``-mcode-object-version=4``. + ``-mcode-object-version=4``. This is the default code object + version if not specified. * ``ELFABIVERSION_AMDGPU_PAL`` is used to specify the version of AMD PAL runtime ABI. @@ -1704,6 +1705,10 @@ :doc:`AMDGPUDwarfExtensionsForHeterogeneousDebugging` that are made available in DWARF Version 4 and DWARF Version 5 as an LLVM vendor extension. +AMDGPU uses LLVM features defined in +:doc:`AMDGPULLVMExtensionsForHeterogeneousDebugging` to implement the generation +of DWARF. + This section defines the AMDGPU target architecture specific DWARF mappings. .. _amdgpu-dwarf-register-identifier: @@ -2990,6 +2995,10 @@ Code Object V3 Metadata +++++++++++++++++++++++ +.. warning:: + Code object V3 is not the default code object version emitted by this version + of LLVM. + Code object V3 to V4 metadata is specified by the ``NT_AMDGPU_METADATA`` note record (see :ref:`amdgpu-note-records-v3-v4`). @@ -3425,10 +3434,6 @@ Code Object V4 Metadata +++++++++++++++++++++++ -.. warning:: - Code object V4 is not the default code object version emitted by this version - of LLVM. - Code object V4 metadata is the same as :ref:`amdgpu-amdhsa-code-object-metadata-v3` with the changes and additions defined in table :ref:`amdgpu-amdhsa-code-object-metadata-map-table-v3`.