 RealView Assembler User's Guide | |
| Home Products Events Support | |
Technical Support
On-Line Manuals
RealView Assembler User's Guide
Preface Introduction Writing ARM Assembly Language Assembler Reference Command syntax
Obtaining a list of available options Specifying command‑line options with an environm AAPCS Floating‑point model Memory access attributes Pre‑executing a SET directive Splitting long LDMs and STMs Listing output to a file Project template options Controlling the output of diagnostic messages Controlling exception table generation Format of source lines Predefined register and coprocessor names Predeclared register names Predeclared extension register names Predeclared coprocessor names Built‑in variables and constants Symbols Symbol naming rules Variables Numeric constants Assembly time substitution of variables Labels Local labels Expressions, literals, and operators String expressions String literals Numeric expressions Numeric literals Floating‑point literals Register‑relative and program‑relative express Logical expressions Logical literals Operator precedence Unary operators Binary operators Diagnostic messages Interlocks IT block generation Thumb branch target alignment Using the C preprocessor ARM and Thumb Instructions Directives ReferenceCommand syntax
  | |||
  |  | ||
| |||
| Home > Assembler Reference > Command syntax | |||
This section relates only to armasm. The inline assemblers are part of the C and C++ compilers, and have no command syntax of their own.
The armasm command line is case‑insensitive, except in filenames, and where specified.
Invoke the ARM assembler using this command:
armasm {options} {inputfile}
where options
‑‑16Instructs the assembler to interpret instructions as Thumb® instructions, using the old Thumb syntax. This is equivalent to a
CODE16directive at the head of the source file. Use the‑‑thumboption to specify Thumb or Thumb‑2 instructions using the new syntax.‑‑32Instructs the assembler to interpret instructions as ARM instructions. This is the default.
‑‑apcs [qualifiers]Specifies whether you are using the Procedure Call Standard for the ARM Architecture (AAPCS). It can also specify some attributes of code sections. See AAPCS for details.
‑‑armIs a synonym for
‑‑32.‑‑bigendInstructs the assembler to assemble code suitable for a big‑endian ARM. The default is
‑‑littleend.‑‑brief_diagnostics‑‑littleendInstructs the assembler to assemble code suitable for a little‑endian ARM.
‑‑checkreglistInstructs the assembler to check
RLIST,LDM, andSTMregister lists to ensure that all registers are provided in increasing register number order. A warning is given if registers are not listed in order.This option is deprecated and will be removed in a future release. Use
‑‑diag_warning 1206instead (see Controlling the output of diagnostic messages).‑‑debugInstructs the assembler to generate DWARF debug tables.
‑‑debugis a synonym for‑g.The default is DWARF 3.
Note
Local symbols are not preserved with
‑‑debug. You must specify‑‑keepif you want to preserve the local symbols to aid debugging.‑‑dependdependfileInstructs the assembler to save source file dependency lists to
dependfile‑‑depend_format=stringChanges the format of output dependency files to UNIX-style format, for compatibility with some UNIX make programs.
The value of
stringunixGenerates dependency files with UNIX‑style path separators.
unix_escapedIs the same as
unix, but escapes spaces with backslash.unix_quotedIs the same as
unix, but surrounds path names with double quotes.
‑‑device=listSee ‑‑device=list.
‑‑device=nameSee ‑‑device=name.
--device_opt=optionSee --device_opt=option.
‑‑diag_[error | remark | warning | suppress | style]‑‑dwarf2Use with
‑‑debug, to instruct the assembler to generate DWARF 2 debug tables.‑‑dwarf3Use with
‑‑debug, to instruct the assembler to generate DWARF 3 debug tables. This is the default if‑‑debugis specified.‑‑errorserrorfileInstructs the assembler to output error messages to
errorfile‑‑exceptions‑‑exceptions_unwind‑‑fpmodemodelSpecifies the floating‑point conformance, and sets library attributes and floating‑point optimizations. See Floating‑point model.
‑gIs a synonym for
‑‑debug.‑idir,dirAdds directories to the source file have to be fully qualified (see GET or INCLUDE).
‑‑keepInstructs the assembler to keep local labels in the symbol table of the object file, for use by the debugger (see KEEP).
‑‑length‑‑library_type=libEnables the relevant library selection to be used at link time.
Where
libstandardlibSpecifies that the full RVCT runtime libraries are selected at link time. This is the default.
microlibSpecifies that the C micro-library (microlib) is selected at link time.
Note
This option can be used with the compiler, assembler or linker when use of the libraries require more specialized optimizations.
Use this option with the linker to override all other
‑‑library_typeoptions.For more information see:
Building an application with microlib in the Libraries Guide
--library_type=lib in the RealView Compilation Tools Compiler Reference Guide.
‑‑listfileInstructs the assembler to output a detailed listing of the assembly language produced by the assembler to
file‑mInstructs the assembler to write source file dependency lists to
stdout.‑‑maxcachenSets the maximum source cache size to
nbytes. The default is 8MB.armasmgives a warning if size is less than 8MB.‑‑mdInstructs the assembler to write source file dependency lists to
inputfile.d.‑‑memaccessattributesSpecifies memory access attributes of the target memory system. See Memory access attributes.
Note
The
‑‑memaccessoption is deprecated and will be removed in a future release.‑‑no_code_genInstructs the assembler to exit after pass 1. No object file is generated.
‑‑no_escInstructs the assembler to ignore C‑style escaped special characters, such as
\nand\t.‑‑no_exceptions‑‑no_exceptions_unwind‑‑no_regsInstructs the assembler not to predefine register names. See Predefined register and coprocessor names for a list of predefined register names.
This option is deprecated and will be removed in a future release. Use
‑‑regnames=noneinstead.‑‑no_terse‑‑no_unaligned_accessInstructs the assembler to set an attribute in the object file indicating that unaligned accesses are not used.
‑‑no_warnTurns off warning messages.
‑ofilenameNames the output object file. If this option is not specified, the assembler creates an object filename of the form
inputfilename.o‑‑predefine "directiveInstructs the assembler to pre‑execute one of the
SETdirectives. See Pre‑executing a SET directive for details.--[no_]reduce_pathsEnables or disables the elimination of redundant pathname information in file paths. This option is valid for Windows systems only.
Windows systems impose a 260 character limit on file paths. Where relative pathnames exist whose absolute names expand to longer than 260 characters, you can use the
--reduce_pathsoption to reduce absolute pathname length by matching up directories with corresponding instances of..and eliminating the directory/..sequences in pairs.Note
It is recommended that you avoid using long and deeply nested file paths, in preference to minimizing path lengths using the
--reduce_pathsoption.See --[no_]reduce_paths in the RealView Compilation Tools Compiler Reference Guide for more information.
‑‑regnames=noneInstructs the assembler not to predefine register names. See Predefined register and coprocessor names for a list of predefined register names.
‑‑regnames=callstdDefines additional register names based on the AAPCS variant that you are using as specified by the
‑‑apcsoption (see AAPCS for details).‑‑regnames=allDefines all AAPCS registers regardless of the value of
‑‑apcs(see AAPCS for details).‑‑show_cmdlineShows how the assembler has processed the command line. The commands are shown normalized, and the contents of any via files are expanded.
‑‑split_ldmInstructs the assembler to fault long
LDMandSTMinstructions. See Splitting long LDMs and STMs for details. Use of this option is deprecated.‑‑thumbInstructs the assembler to interpret instructions as Thumb instructions, using the ARM syntax. This is equivalent to a
THUMBdirective at the head of the source file.‑‑unaligned_accessInstructs the assembler to set an attribute in the object file indicating the use of unaligned accesses.
‑‑unsafeEnables instructions from differing architectures to be assembled without error. See Controlling the output of diagnostic messages).
‑‑untyped_local_labelsForces the assembler not to set the Thumb bit when referencing labels in Thumb code. See LDR pseudo‑instruction for details.
‑‑viafileInstructs the assembler to open
file‑‑width‑‑xrefinputfileSpecifies the input file for the assembler. Input files must be ARM or Thumb assembly language source files.
| Copyright © 2007 ARM Limited. All rights reserved. | ARM DUI 0379A |
 PDF version | |
| Home > Assembler Reference > Command syntax | |
| |
| Contact Site Map Press Privacy | Copyright © 2008 Keil™, An ARM® Company. All rights reserved. |
