You copied the Doc URL to your clipboard.

Toolchain environment variables

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 ARMCCn_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).

ARMLMD_LICENSE_FILE

The location of your ARM license file. See the ARM® DS-5™ License Management Guide for information on this environment variable.

Note

On Windows, the length of ARMLMD_LICENSE_FILE must not be more than 260 characters.

ARMCCn_ASMOPT

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

--licretry

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.

ARMCCn_CCOPT

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

--licretry

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.

ARMCCn_FROMELFOPT

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

--licretry

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.

ARMCCn_LINKOPT

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

--licretry

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.

ARMCCnINC

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\include

ARMCCnLIB

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

install_directory\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\lib the linker searches:

lib

lib\armlib

lib\cpplib

ARMINC

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

See the description of ARMCCnINC for more information.

ARMLIB

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

See the description of ARMCCnLIB for more information.

CPATH

Defines additional paths that are used by armcc when the GCC emulation mode --translate_gcc or --translate_g++ is specified.

CPLUS_INCLUDE_PATH

Defines additional include paths that are used by armcc when the GCC emulation mode --translate_gcc or --translate_g++ is specified.

C_INCLUDE_PATH

Defines additional paths that are used by armcc when the GCC emulation mode --translate_gcc or --translate_g++ is specified.

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.

TMPDIR

Used on Red Hat Linux platforms to specify the directory to be used for temporary files. If TMPDIR is not set, a default temporary directory, usually /tmp or /var/tmp, is used.

[a] Replace n with the version of the toolchain you are using. For example, ARMCC5INC if you are using ARM Compiler toolchain v5.02.


See also

Was this page helpful? Yes No