Miscellaneous ARM Directives
9/7/2007
The following table describes miscellaneous directives for the ARM assembler.
| Directive | Syntax | Description |
|---|---|---|
ALIGN |
|
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 |
|
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 |
|
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 |
|
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 |
|
Disables floating point instructions. In some circumstances, there is no support in the target hardware or software for floating-point instructions. |
RLIST |
|
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 |
|
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 |
|
Specifies a subtitle to be inserted on all pages until a new subtitle appears. |
TTL |
|
Specifies a title to be inserted on all pages until a new title appears. |