This is an archive of the discontinued LLVM Phabricator instance.

Show First 20 Lines • Show All 2,672 Lines • ▼ Show 20 Lines
represented by a different DWARF address space.*		represented by a different DWARF address space.*

Although DWARF address space identifiers are target architecture specific,		Although DWARF address space identifiers are target architecture specific,
``DW_ASPACE_none`` is a common address space supported by all target		``DW_ASPACE_none`` is a common address space supported by all target
architectures.		architectures.

DWARF address space identifiers are used by:		DWARF address space identifiers are used by:

* The DWARF expession operations: ``DW_OP_LLVM_aspace_bregx``,		* The DWARF expression operations: ``DW_OP_LLVM_aspace_bregx``,
``DW_OP_LLVM_form_aspace_address``, ``DW_OP_LLVM_implicit_aspace_pointer``,		``DW_OP_LLVM_form_aspace_address``, ``DW_OP_LLVM_implicit_aspace_pointer``,
and ``DW_OP_xderef*``.		and ``DW_OP_xderef*``.

* The CFI instructions: ``DW_CFA_def_aspace_cfa`` and		* The CFI instructions: ``DW_CFA_def_aspace_cfa`` and
``DW_CFA_def_aspace_cfa_sf``.		``DW_CFA_def_aspace_cfa_sf``.

.. note::		.. note::

▲ Show 20 Lines • Show All 692 Lines • ▼ Show 20 Lines	1. ``DW_LNCT_LLVM_source``
the source is available but is an empty file then the value is a		the source is available but is an empty file then the value is a
null-terminated single "\ ``\n``\ ".		null-terminated single "\ ``\n``\ ".

*When the source field is present, consumers can use the embedded source		*When the source field is present, consumers can use the embedded source
instead of attempting to discover the source on disk using the file path		instead of attempting to discover the source on disk using the file path
provided by the* ``DW_LNCT_path`` *field. When the source field is absent,		provided by the* ``DW_LNCT_path`` *field. When the source field is absent,
consumers can access the file to get the source text.*		consumers can access the file to get the source text.*

*This is particularly useful for programing languages that support runtime		*This is particularly useful for programming languages that support runtime
compilation and runtime generation of source text. In these cases, the		compilation and runtime generation of source text. In these cases, the
source text does not reside in any permanent file. For example, the OpenCL		source text does not reside in any permanent file. For example, the OpenCL
language [:ref:`OpenCL <amdgpu-dwarf-OpenCL>`] supports online compilation.*		language [:ref:`OpenCL <amdgpu-dwarf-OpenCL>`] supports online compilation.*

2. ``DW_LNCT_LLVM_is_MD5``		2. ``DW_LNCT_LLVM_is_MD5``

``DW_LNCT_LLVM_is_MD5`` indicates if the ``DW_LNCT_MD5`` content kind, if		``DW_LNCT_LLVM_is_MD5`` indicates if the ``DW_LNCT_MD5`` content kind, if
present, is valid: when 0 it is not valid and when 1 it is valid. If		present, is valid: when 0 it is not valid and when 1 it is valid. If
▲ Show 20 Lines • Show All 916 Lines • Show Last 20 Lines

This is an archive of the discontinued LLVM Phabricator instance.

[docs] Fix typosClosedPublic

Details

Diff Detail

Event Timeline

Revision Contents

Diff 291237

llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst

[docs] Fix typos
ClosedPublic