Toolchain environment variables

The ARM Compiler toolchain does not require environment variables to be set. However, there are situations where you might want to set environment variables. For example, if you want to specify additional command-line options for armcc, but you do not want to modify your build scripts, then you can specify the options using ARMCCnn_CCOPT.

The environment variables used by the toolchain are:

Table 1. Environment variables used by the toolchain

Environment variable [a]Setting
ARMROOT

Your installation directory root (install_directory). This documentation assumes that install_directory is C:\Keil\ARM.

ARMCCnn_ASMOPT

An optional environment variable to define additional assembler options that are to be used outside your regular makefile.

The options listed appear before any options specified for the armasm command in the makefile. Therefore, any options specified in the makefile might override the options listed in this environment variable.

ARMCCnn_CCOPT

An optional environment variable to define additional compiler options that are to be used outside your regular makefile.

The options listed appear before any options specified for the armcc command in the makefile. Therefore, any options specified in the makefile might override the options listed in this environment variable.

ARMCCnn_FROMELFOPT

An optional environment variable to define additional fromelf image converter options that are to be used outside your regular makefile.

The options listed appear before any options specified for the fromelf command in the makefile. Therefore, any options specified in the makefile might override the options listed in this environment variable.

ARMCCnn_LINKOPT

An optional environment variable to define additional linker options that are to be used outside your regular makefile.

The options listed appear before any options specified for the armlink command in the makefile. Therefore, any options specified in the makefile might override the options listed in this environment variable.

ARMCCnnINC

The default system include path. That is, the path used to search for header filenames enclosed in angle-brackets. The compiler option -J overrides this environment variable.

The default location of the compiler include files is:

install_directory\RV31\INC

ARMCCnnLIB

The default location of the ARM standard C and C++ library files:

install_directory\RV31\LIB

The compiler option --libpath overrides this environment variable.

Note

If you include a path separator at the end of the path, the linker searches that directory and the subdirectories. So for install_directory\RV31\LIB the linker searches:

LIB

LIB\armlib

LIB\cpplib

ARMINC

Used only if you do not specify the compiler option -J and ARMCCnnINC is either not set or is empty.

See the description of ARMCCnnINC for more information.

ARMLIB

Used only if you do not specify the compiler option --libpath and ARMCCnnLIB is either not set or is empty.

See the description of ARMCCnnLIB for more information.

CYGPATH

The location of the cygpath.exe file on your system in Cygwin path format. For example:

C:/cygwin/bin/cygpath.exe

You must set this if you want to specify paths in Cygwin format for the compilation tools.

TMP

Used on Windows platforms to specify the directory to be used for temporary files. If TMP is not defined, or if it is set to the name of a directory that does not exist, temporary files are created in the current working directory.

[a] Replace nn with the version of the toolchain you are using. For example, ARMCC41INC if you are using ARM Compiler toolchain v4.1.


Show/hideSee also

Concepts
Reference

Assembler Reference:

Compiler Reference:

Linker Reference:

Using the fromelf Image Converter:

Copyright © 2011 ARM. All rights reserved.ARM DUI 0592A
Non-ConfidentialID061811