Sorry, your browser is not supported. We recommend upgrading your browser.
We have done our best to make all the documentation and resources available on old versions of Internet Explorer, but vector image support and the layout may not be optimal. Technical documentation is available as a PDF Download.
Introduces some of the more common ARM compiler command-line options.
Compiler command-line syntax
Use the armcc command from the command-line to invoke the compiler. Specify the source files you want to compile, together with any options you need to control compiler behavior.
Default compiler behavior
By default, the compiler determines the source language by examining the source filename extension. For example, filename.c indicates C, while filename.cpp indicates C++03, although the command-line options --c90, --c99, --cpp, and --cpp11 let you override this.
Order of compiler command-line options
In general, compiler command-line options can appear in any order in a single compiler invocation. However, the effects of some options depend on the order they appear in the command line and how they are combined with other related options.
Compiler search rules and the current place
By default, the compiler uses Berkeley UNIX search rules, so source files and #include header files are searched for relative to the current place. The current place is the directory containing the source or header file currently being processed by the compiler.
The ARMCC5INC environment variable
The ARMCC5INC environment variable points to the location of the included header and source files that are provided with the compilation tools.
Using GCC fallback when building applications
When building applications developed to build with GCC, there might be cases when the ARM Compiler toolchain cannot complete the build successfully, because of unsupported GCC-specific functionality. For such cases, GCC fallback can invoke the GCC toolchain to complete the build.
Compilation build time
Modern software applications can comprise many thousands of source code files. These files can take a considerable amount of time to compile. The many different techniques that the ARM compilation tools use to optimize for small code size and high performance can also increase build time.
Effect of --multifile on compilation build time
When compiling with --multifile, the compiler might generate code with additional optimizations by compiling across several source files to produce a single object file. These additional cross-source optimizations can increase compilation time.