Share via


ARM Assembler Command-Line Options (Windows Embedded CE 6.0)

1/5/2010

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

armasm {options} sourcefile objectfile

Parameters

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

Option Description

-arch architecture

Sets the target architecture. Legitimate architecture values are 4, 4T, 5, 5T, and 6.

Some microprocessor-specific instructions produce 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.

-cpu ARMcore

Sets the target ARM core.

Legitimate values include the following:

  • ARM7TM
  • ARM720t
  • ARM920t
  • ARM8
  • ARM10
  • ARM10T
  • ARM10200
  • StrongARM or StrongARM1
  • XSCALE
  • PXA270

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

-errors errorfile

Outputs error messages to errorfile.

-help

Displays a summary of the command-line options.

-i dir{,dir}

Specifies directories to include.

Directories can also be specified by using the INCLUDE environment variable.

-ignore warningnum

Instructs the build process to ignore the specified warning, where warningnum is the number of the warning.

-list listingfile-noterse

Turns the terse flag off.

When the terse flag is on, lines skipped due to conditional assembly do not appear in the listing.

When the terse flag is off, these lines appear in the listing.

The default is on.

-list listingfile-width n

Sets the listing page width.

The default is 79 characters.

-list listingfile-length n

Sets the listing page length.

Length 0 means an unpaged listing.

The default is 66 lines.

-list listingfile-xref

Lists cross-referencing information on symbols.

Provides definition location and usage location 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"

-Via file

Opens file and reads in more armasm command-line arguments.

See Also

Reference

Predeclared ARM Register Names
Built-In ARM Assembler Variables

Other Resources

ARM Assembler