GNU Compiler Collection (GCC) Internals

— Macro: OPTIMIZE_MODE_SWITCHING (entity)

Define this macro if the port needs extra instructions inserted for mode switching in an optimizing compilation.

For an example, the SH4 can perform both single and double precision floating point operations, but to perform a single precision operation, the FPSCR PR bit has to be cleared, while for a double precision operation, this bit has to be set. Changing the PR bit requires a general purpose register as a scratch register, hence these FPSCR sets have to be inserted before reload, i.e. you can't put this into instruction emitting or TARGET_MACHINE_DEPENDENT_REORG.

You can have multiple entities that are mode-switched, and select at run time which entities actually need it. OPTIMIZE_MODE_SWITCHING should return nonzero for any entity that needs mode-switching. If you define this macro, you also have to define NUM_MODES_FOR_MODE_SWITCHING, MODE_NEEDED, MODE_PRIORITY_TO_MODE and EMIT_MODE_SET. MODE_AFTER, MODE_ENTRY, and MODE_EXIT are optional.

— Macro: NUM_MODES_FOR_MODE_SWITCHING

If you define OPTIMIZE_MODE_SWITCHING, you have to define this as initializer for an array of integers. Each initializer element N refers to an entity that needs mode switching, and specifies the number of different modes that might need to be set for this entity. The position of the initializer in the initializer—starting counting at zero—determines the integer that is used to refer to the mode-switched entity in question. In macros that take mode arguments / yield a mode result, modes are represented as numbers 0 ... N − 1. N is used to specify that no mode switch is needed / supplied.

— Macro: MODE_NEEDED (entity, insn)

entity is an integer specifying a mode-switched entity. If OPTIMIZE_MODE_SWITCHING is defined, you must define this macro to return an integer value not larger than the corresponding element in NUM_MODES_FOR_MODE_SWITCHING, to denote the mode that entity must be switched into prior to the execution of insn.

— Macro: MODE_AFTER (mode, insn)

If this macro is defined, it is evaluated for every insn during mode switching. It determines the mode that an insn results in (if different from the incoming mode).

— Macro: MODE_ENTRY (entity)

If this macro is defined, it is evaluated for every entity that needs mode switching. It should evaluate to an integer, which is a mode that entity is assumed to be switched to at function entry. If MODE_ENTRY is defined then MODE_EXIT must be defined.

— Macro: MODE_EXIT (entity)

If this macro is defined, it is evaluated for every entity that needs mode switching. It should evaluate to an integer, which is a mode that entity is assumed to be switched to at function exit. If MODE_EXIT is defined then MODE_ENTRY must be defined.

— Macro: MODE_PRIORITY_TO_MODE (entity, n)

This macro specifies the order in which modes for entity are processed. 0 is the highest priority, NUM_MODES_FOR_MODE_SWITCHING[entity] - 1 the lowest. The value of the macro should be an integer designating a mode for entity. For any fixed entity, mode_priority_to_mode (entity, n) shall be a bijection in 0 ... num_modes_for_mode_switching[entity] - 1.

— Macro: EMIT_MODE_SET (entity, mode, hard_regs_live)

Generate one or more insns to set entity to mode. hard_reg_live is the set of hard registers live at the point where the insn(s) are to be inserted.