5.2. Integrated GNU-Syntax Arm Assembler¶
The tiarmclang compiler tools installation includes a GNU-syntax Arm assembler that is integrated into the tiarmclang compiler tool. The tiarmclang command can be used to assemble a source file containing GNU-syntax Arm assembly language.
5.2.1. Invoking the Integrated GNU-Syntax Arm Assembler¶
tiarmclang is the command to invoke the integrated GNU-syntax Arm assembler when presented with a GNU-syntax Arm assembly source input file.
options may be a set of command-line options to influence the behavior of the tiarmclang compiler and integrated assembler. These are described in the Compiler Options section.
.S files are GNU-syntax assembly source files that are run through the C preprocessor before presenting the output of the preprocessor to the GNU-syntax Arm assembler. Preprocessing directives in the assembly source file are useful for configuring assembly source content based on predefined macro symbols that are available to the C preprocessor.
.s files are GNU-syntax assembly source files that are passed directly to the GNU-syntax Arm assembler for processing.
Files with other file extensions are processed by the tiarmclang compiler as usual for C source files.
Additional documentation for the GNU-syntax assembler is provided in this documentation and elsewhere:
For an overview of GNU Arm assembly syntax, see GNU-Syntax Arm Assembly Source Anatomy.
For links to documentation of assembly instructions for your Arm device, see GNU-Syntax Arm Assembly Instructions.
For documentation of the assembly directives supported with tiarmclang, see GNU-Syntax Arm Assembly Directives.
For information about migrating legacy TI-syntax Arm assembly language instructions and directives to GNU-syntax Arm assembly, see Migrating Assembly Language Source Code.
Other documentation of GNU-syntax Arm assembly language is available in GNU and Arm documentation online. The majority of the documented syntax is recognized and processed by tiarmclang’s integrated GNU-syntax Arm assembler. Here are some suggested sources: