Miscellaneous ARM Directives (Windows Embedded CE 6.0)

1/5/2010

The following table describes miscellaneous directives for the ARM assembler.

Directive Syntax Description

ALIGN

ALIGN {power-of-two {,offset-expression}}

Sets the instruction location to the next word boundary.

The optional power-of-two parameter can be used to align with a coarser byte boundary and the offset-expression parameter to define a byte offset from that boundary.

END

END

Stops the processing of a source file.

If a GET directive invoked assembly of the file, the assembler returns and continues after the GET directive.

If the assembler reaches an END directive in the top-level source file during the first pass and there are no errors, the second pass begins.

Absence of an END directive causes an error.

KEEP

KEEP {symbol}

Retains a local symbol in the assembler's symbol table.

By default, the assembler does not describe local symbols in its output object file.

If the KEEP directive appears without a symbol parameter, the assembler keeps all symbols.

To keep a specific symbol, specify it by name.

LTORG

LTORG

Directs the assembler to assemble the current literal pool that immediately follows the assembly.

A default LTORG is executed at every END directive that is not part of a nested assembly.

Large programs might need several literal pools, each closer to the location of their literals to avoid violating LDR's 4-KB offset limit.

NOFP

NOFP

Disables floating point instructions.

In some circumstances, there is no support in the target hardware or software for floating-point instructions.

RLIST

label RLIST list-of-registers 

Assigns a name to a set of registers to be transferred by LDM or STM.

List-of-registers is a comma-separated list of register names or ranges enclosed in braces.

If you select the -CheckReglist option, you must also supply a List-of-registers list, in increasing order of register number.

ROUT

{name}ROUT

Marks the boundaries of the scope of local labels.

name indicates the name to be assigned to the scope.

Use ROUT to limit the scope of local labels. This makes it easier for you to avoid referring to a wrong label by accident. The scope of local labels is the whole area if there are no ROUT directives in it.

SUBT

SUBT title

Specifies a subtitle to be inserted on all pages until a new subtitle appears.

TTL

TTL title

Specifies a title to be inserted on all pages until a new title appears.

See Also

Concepts

ARM Assembler Directives