You copied the Doc URL to your clipboard.

Miscellaneous directives

Miscellaneous directives perform a range of different functions.

The following table shows how to translate ARM® syntax miscellaneous directives to GNU syntax directives:

Table 5-8 Miscellaneous directives translation

ARM syntax directive GNU syntax directive Description
foo EQU 0x1C .equ foo, 0x1C Assigns a value to a symbol. Note the rearrangement of operands.

EXPORT StartHere

GLOBAL StartHere

.global StartHere

.type StartHere, @function

Declares a symbol that can be used by the linker (that is, a symbol that is visible to the linker).

armasm automatically determines the types of exported symbols. However, armclang requires that you explicitly specify the types of exported symbols using the .type directive.

If the .type directive is not specified, the linker outputs warnings of the form:

Warning: L6437W: Relocation #RELA:1 in test.o(.text) with respect to symbol...

Warning: L6318W: test.o(.text) contains branch to a non-code symbol symbol.

GET file


.include file Includes a file within the file being assembled.
IMPORT foo .global foo Provides the assembler with a name that is not defined in the current assembly.
INCBIN .incbin Partial support, armclang does not fully support .incbin.
INFO n, "string" .warning "string" The INFO directive supports diagnostic generation on either pass of the assembly (specified by n). The .warning directive does not let you specify a particular pass, as the armclang integrated assembler only performs one pass.
ENTRY armlink --entry=location The ENTRY directive declares an entry point to a program. armclang does not provide an equivalent directive. Use armlink --entry=location to specify the entry point directly to the linker, rather than defining it in the assembly code.
END .end Marks the end of the assembly file.
PRESERVE8 .eabi_attribute Tag_ABI_align_preserved, 1 Emits a build attribute which guarantees that the functions in the file preserve 8-byte stack alignment.


For armasm syntax assembly language source files, even if you do not specify the PRESERVE8 directive, armasm automatically emits the build attribute if all functions in the file preserve 8-byte stack alignment. For GNU syntax assembly language source files, the armclang integrated assembler does not automatically emit this build attribute. Therefore you must manually inspect and ensure that all functions in your GNU syntax assembly language source file preserve 8-byte stack alignment and then manually add the directive to the file.