Chapter 42. Xtensa Dependent Features

245

Relaxation is enabled by default unless the

 no relax

command line option was specified.

42.5.3. longcalls

The

longcalls

directive enables or disables function call relaxation. Section 42.4.2 Function Call

Relaxation.

.begin [no ]longcalls

.end [no ]longcalls

Call relaxation is disabled by default unless the

 longcalls

command line option is specified.

42.5.4. generics

This directive enables or disables all assembler transformation, including relaxation (Section 42.4

Xtensa Relaxation) and optimization (Section 42.3 Xtensa Optimizations).

.begin [no ]generics

.end [no ]generics

Disabling generics is roughly equivalent to adding an underscore prefix to every opcode within the

region, so that every opcode is treated as a specific opcode. Section 42.2.1 Opcode Names. In the

current implementation of

as

, built in macros are also disabled within a

no generics

region.

42.5.5. literal

The

.literal

directive is used to define literal pool data, i.e., read only 32 bit data accessed via

L32R

instructions.

.literal label, value[, value...]

This directive is similar to the standard

.word

directive, except that the actual location of the literal

data is determined by the assembler and linker, not by the position of the

.literal

directive. Using

this directive gives the assembler freedom to locate the literal data in the most appropriate place and

possibly to combine identical literals. For example, the code:

entry sp, 40

.literal .L1, sym

l32r

a4, .L1

can be used to load a pointer to the symbol

sym

into register

a4

. The value of

sym

will not be placed

between the

ENTRY

and

L32R

instructions; instead, the assembler puts the data in a literal pool.

By default literal pools are placed in a separate section; however, when using the

 text section literals

option (Section 42.1 Command Line Options), the literal pools are

placed in the current section. These text section literal pools are created automatically before

ENTRY

instructions and manually after

.literal_position

directives (Section 42.5.6 literal_position). If