Next: Alignment Output, Previous: Dispatch Tables, Up: Assembler Format
This describes commands marking the start and the end of an exception region.
If defined, a C string constant for the name of the section containing exception handling frame unwind information. If not defined, GCC will provide a default definition if the target supports named sections. crtstuff.c uses this macro to switch to the appropriate section.
You should define this symbol if your target supports DWARF 2 frame unwind information and the default definition does not work.
If defined, DWARF 2 frame unwind information will be placed in the data section even though the target supports named sections. This might be necessary, for instance, if the system linker does garbage collection and sections cannot be marked as not to be collected.
Do not define this macro unless
TARGET_ASM_NAMED_SECTION
is also defined.
Define this macro to 1 if your target is such that no frame unwind information encoding used with non-PIC code will ever require a runtime relocation, but the linker may not support merging read-only and read-write sections into a single read-write section.
An rtx used to mask the return address found via
RETURN_ADDR_RTX
, so that it does not contain any extraneous set bits in it.
Define this macro to 0 if your target supports DWARF 2 frame unwind information, but it does not yet work with exception handling. Otherwise, if your target supports this information (if it defines `INCOMING_RETURN_ADDR_RTX' and either `UNALIGNED_INT_ASM_OP' or `OBJECT_FORMAT_ELF'), GCC will provide a default definition of 1.
If
TARGET_UNWIND_INFO
is defined, the target specific unwinder will be used in all cases. Defining this macro will enable the generation of DWARF 2 frame debugging information.If
TARGET_UNWIND_INFO
is not defined, and this macro is defined to 1, the DWARF 2 unwinder will be the default exception handling mechanism; otherwise, thesetjmp
/longjmp
-based scheme will be used by default.
Define this macro if your target has ABI specified unwind tables. Usually these will be output by
TARGET_UNWIND_EMIT
.
This variable should be set to
true
if the target ABI requires unwinding tables even when exceptions are not used.
This macro need only be defined if
DWARF2_UNWIND_INFO
is runtime-variable. In that case, except.h cannot correctly determine the corresponding definition ofMUST_USE_SJLJ_EXCEPTIONS
, so the target must provide it directly.
Define this macro to 1 if the
setjmp
/longjmp
-based scheme should use thesetjmp
/longjmp
functions from the C library instead of the__builtin_setjmp
/__builtin_longjmp
machinery.
This macro need only be defined if the target might save registers in the function prologue at an offset to the stack pointer that is not aligned to
UNITS_PER_WORD
. The definition should be the negative minimum alignment ifSTACK_GROWS_DOWNWARD
is defined, and the positive minimum alignment otherwise. See SDB and DWARF. Only applicable if the target supports DWARF 2 frame unwind information.
Contains the value true if the target should add a zero word onto the end of a Dwarf-2 frame info section when used for exception handling. Default value is false if
EH_FRAME_SECTION_NAME
is defined, and true otherwise.
Given a register, this hook should return a parallel of registers to represent where to find the register pieces. Define this hook if the register and its mode are represented in Dwarf in non-contiguous locations, or if the register should be represented in more than one register in Dwarf. Otherwise, this hook should return
NULL_RTX
. If not defined, the default is to returnNULL_RTX
.
If some registers are represented in Dwarf-2 unwind information in multiple pieces, define this hook to fill in information about the sizes of those pieces in the table used by the unwinder at runtime. It will be called by
expand_builtin_init_dwarf_reg_sizes
after filling in a single size corresponding to each hard register; address is the address of the table.