ARM Assembler Command-Line Options

The syntax of a command to invoke the ARM assembler is as follows:

armasm {options} sourcefile objectfile

The following table shows command-line options for the ARM assembler.

Option Description
-archarchitecture Sets the target architecture. Legitimate values are 4, 4T, 5 and 5T.
Some microprocessor-specific instructions produce either errors or warnings if assembled for the wrong target architecture.
-checkreglist Checks LDM and STM register lists to ensure that register number order is increasing. If not, a warning is given. You can use -checkreglist to detect misuse of symbolic register names.
-cpuARMcore Sets the target ARM core. Legitimate values include the following:
  • ARM7TM
  • ARM720t
  • ARM920t
  • ARM8
  • ARM10
  • ARM10T
  • ARM10200
  • StrongARM or StrongARM1
  • XSCALE

Some microprocessor-specific instructions produce warnings if assembled for the wrong ARM core.

-errorserrorfile Outputs error messages to errorfile.
-help Displays a summary of the command-line options.
-idir{,dir} Specifies directories to include. Directories can also be specified by using the INCLUDE environment variable.
-listlistingfile-noterse Turns the terse flag off. When the terse flag is on, lines skipped due to conditional assembly do not appear in the listing. With the terse flag off, these lines appear in the listing. The default is on.
-listlistingfile-widthn Sets the listing page width. Default is 79 characters.
-listlistingfile-lengthn Sets the listing page length. Length 0 means an unpaged listing. Default is 66 lines.
-listlistingfile-xref Lists cross-referencing information on symbols. Provides definition location and usage location both inside and outside of macros. The default is off.
-noesc Ignores C-style special characters (\n, \t, and so on).
-noregs Tells the assembler not to predefine implicit register names r0–r15, a1–a4, v1–v6, c0–c15, p0–p15, sl, fp, ip, sp, lr, pc.
-nowarn Turns off warning messages.
-predefine "directive" Pre-executes a SETx directive. This implicitly executes a corresponding GBLx directive. Because it contains spaces, place the full SETx argument in quotation marks. For example:
-predefine "Version SETA 44"
-Viafile Opens file and reads in more armasm command-line arguments.

See Also

ARM Assembler | Predeclared ARM Register Names | Built-in ARM Assembler Variables

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.