1.7.1 Environment variables used by the toolchain

You can use environment variables to modify the ARM Compiler environment if required.

The environment variables are:

Table 1-1 Environment variables used by the toolchain

Environment variable Setting
ARM_PRODUCT_PATH

Required only if you have a DS-5 toolkit license and you are running the ARM Compiler tools outside of the DS-5 environment.

Use this environment variable to specify the location of the sw/mappings directory within an ARM Compiler or DS-5 installation.

ARM_TOOL_VARIANT

Required only if you have a DS-5 toolkit license and you are running the ARM Compiler tools outside of the DS-5 environment.

If you have an ultimate license, set this environment variable to ult to enable the Ultimate features. See FAQ 16372 for more information.

ARMLMD_LICENSE_FILE

This environment variable must be set, and specifies 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 exceed 260 characters.

ARMROOT

Your installation directory root, install_directory.

ARMCC5_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.

ARMCC5_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.

ARMCC5_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.

ARMCC5_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.

ARMCC5INC

The default system include path. That is, the path used by the compiler 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

ARMCC5LIB

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:

install_directory\lib

install_directory\lib\armlib

install_directory\lib\cpplib

ARMINC

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

See the description of ARMCC5INC for more information.

ARMLIB

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

See the description of ARMCC5LIB 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.

Note:

Cygwin path translation enabled by CYGPATH is only supported on 32-bit Windows platforms, and is not supported on Windows Server 2012 and 64-bit Windows 8.1.

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.

Non-ConfidentialPDF file icon PDF versionARM DUI0529M
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.