CMAKE_PREFIX_PATH¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The CMAKE_PREFIX_PATH environment variable may be set to a list of directories specifying installation prefixes to be searched by the find_package(), find_program(), find_library(), find_file(), and find_path() commands. Each command will add appropriate subdirectories (like bin, lib, or include) as specified in its own documentation.

This variable may hold a single prefix or a list of prefixes separated by : on UNIX or ; on Windows (the same as the PATH environment variable convention on those platforms).

See also the CMAKE_PREFIX_PATH CMake variable.

SSL_CERT_DIR¶

New in version 3.25.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specify default directory containing CA certificates. It overrides the default CA directory used.

SSL_CERT_FILE¶

New in version 3.25.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specify the file name containing CA certificates. It overrides the default, os-specific CA file used.

ADSP_ROOT¶

New in version 3.24.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The ADSP_ROOT environment variable specifies a default value for the CMAKE_ADSP_ROOT variable when there is no explicit configuration given on the first run while creating a new build tree.

CMAKE_APPLE_SILICON_PROCESSOR¶

New in version 3.19.2.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

On Apple Silicon hosts running macOS, set this environment variable to tell CMake what architecture to use for CMAKE_HOST_SYSTEM_PROCESSOR. The value must be either arm64 or x86_64.

The CMAKE_APPLE_SILICON_PROCESSOR normal variable, if set, overrides this environment variable.

CMAKE_BUILD_PARALLEL_LEVEL¶

New in version 3.12.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specifies the maximum number of concurrent processes to use when building using the cmake --build command line Build Tool Mode.

If this variable is defined empty the native build tool's default number is used.

CMAKE_BUILD_TYPE¶

New in version 3.22.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The CMAKE_BUILD_TYPE environment variable specifies a default value for the CMAKE_BUILD_TYPE variable when there is no explicit configuration given on the first run while creating a new build tree.

CMAKE_COLOR_DIAGNOSTICS¶

New in version 3.24.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specifies a default value for the CMAKE_COLOR_DIAGNOSTICS variable when there is no explicit value given on the first run.

CMAKE_CONFIGURATION_TYPES¶

New in version 3.22.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The CMAKE_CONFIGURATION_TYPES environment variable specifies a default value for the CMAKE_CONFIGURATION_TYPES variable when there is no explicit configuration given on the first run while creating a new build tree.

CMAKE_CONFIG_TYPE¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The default build configuration for Build Tool Mode and ctest build handler when there is no explicit configuration given.

CMAKE_EXPORT_COMPILE_COMMANDS¶

New in version 3.17.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The default value for CMAKE_EXPORT_COMPILE_COMMANDS when there is no explicit configuration given on the first run while creating a new build tree. On later runs in an existing build tree the value persists in the cache as CMAKE_EXPORT_COMPILE_COMMANDS.

CMAKE_GENERATOR¶

New in version 3.15.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specifies the CMake default generator to use when no generator is supplied with -G. If the provided value doesn't name a generator known by CMake, the internal default is used. Either way the resulting generator selection is stored in the CMAKE_GENERATOR variable.

Some generators may be additionally configured using the environment variables:

CMAKE_GENERATOR_INSTANCE¶

New in version 3.15.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Default value for CMAKE_GENERATOR_INSTANCE if no Cache entry is present. This value is only applied if CMAKE_GENERATOR is set.

CMAKE_GENERATOR_PLATFORM¶

New in version 3.15.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Default value for CMAKE_GENERATOR_PLATFORM if no Cache entry is present and no value is specified by cmake -A option. This value is only applied if CMAKE_GENERATOR is set.

CMAKE_GENERATOR_TOOLSET¶

New in version 3.15.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Default value for CMAKE_GENERATOR_TOOLSET if no Cache entry is present and no value is specified by cmake -T option. This value is only applied if CMAKE_GENERATOR is set.

CMAKE_INSTALL_MODE¶

New in version 3.22.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The CMAKE_INSTALL_MODE environment variable allows users to operate CMake in an alternate mode of file(INSTALL) and install().

The default behavior for an installation is to copy a source file from a source directory into a destination directory. This environment variable however allows the user to override this behavior, causing CMake to create symbolic links instead.

Usage Scenarios¶

Installing symbolic links rather than copying files can help in the following ways:

Allowed Values¶

The following values are allowed for CMAKE_INSTALL_MODE:

NOTE:

When To Set The Environment Variable¶

For the environment variable to take effect, it must be set during the correct build phase(s).

Given the above, it is recommended to set the environment variable consistently across all phases (configure, build and install).

Caveats¶

Use this environment variable with caution. The following highlights some points to be considered:

CMAKE_<LANG>_COMPILER_LAUNCHER¶

New in version 3.17.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Default compiler launcher to use for the specified language. Will only be used by CMake to initialize the variable on the first configuration. Afterwards, it is available through the cache setting of the variable of the same name. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_<LANG>_COMPILER_LAUNCHER variable is defined.

CMAKE_<LANG>_LINKER_LAUNCHER¶

New in version 3.21.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Default launcher to use when linking a target of the specified language. Will only be used by CMake to initialize the variable on the first configuration. Afterwards, it is available through the cache setting of the variable of the same name. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_<LANG>_LINKER_LAUNCHER variable is defined.

CMAKE_MSVCIDE_RUN_PATH¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Extra PATH locations for custom commands when using Visual Studio 9 2008 (or above) generators.

The CMAKE_MSVCIDE_RUN_PATH environment variable sets the default value for the CMAKE_MSVCIDE_RUN_PATH variable if not already explicitly set.

CMAKE_NO_VERBOSE¶

New in version 3.14.

Disables verbose output from CMake when VERBOSE environment variable is set.

Only your build tool of choice will still print verbose output when you start to actually build your project.

CMAKE_OSX_ARCHITECTURES¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Target specific architectures for macOS.

The CMAKE_OSX_ARCHITECTURES environment variable sets the default value for the CMAKE_OSX_ARCHITECTURES variable. See OSX_ARCHITECTURES for more information.

CMAKE_TOOLCHAIN_FILE¶

New in version 3.21.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

The CMAKE_TOOLCHAIN_FILE environment variable specifies a default value for the CMAKE_TOOLCHAIN_FILE variable when there is no explicit configuration given on the first run while creating a new build tree. On later runs in an existing build tree the value persists in the cache as CMAKE_TOOLCHAIN_FILE.

DESTDIR¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

On UNIX one can use the DESTDIR mechanism in order to relocate the whole installation. DESTDIR means DESTination DIRectory. It is commonly used by packagers to install software in a staging directory.

For example, running

make DESTDIR=/package/stage install

will install the software using the installation prefix, e.g. /usr/local, prepended with the DESTDIR value which gives /package/stage/usr/local. The packaging tool may then construct the package from the content of the /package/stage directory.

See the CMAKE_INSTALL_PREFIX variable to control the installation prefix when configuring a build tree. Or, when using the cmake(1) command-line tool's --install mode, one may specify a different prefix using the --prefix option.

NOTE:

LDFLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Will only be used by CMake on the first configuration to determine the default linker flags, after which the value for LDFLAGS is stored in the cache as CMAKE_EXE_LINKER_FLAGS_INIT, CMAKE_SHARED_LINKER_FLAGS_INIT, and CMAKE_MODULE_LINKER_FLAGS_INIT. For any configuration run (including the first), the environment variable will be ignored if the equivalent CMAKE_<TYPE>_LINKER_FLAGS_INIT variable is defined.

MACOSX_DEPLOYMENT_TARGET¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specify the minimum version of macOS on which the target binaries are to be deployed.

The MACOSX_DEPLOYMENT_TARGET environment variable sets the default value for the CMAKE_OSX_DEPLOYMENT_TARGET variable.

<PackageName>_ROOT¶

New in version 3.12.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Calls to find_package(<PackageName>) will search in prefixes specified by the <PackageName>_ROOT environment variable, where <PackageName> is the (case-preserved) name given to the find_package() call and _ROOT is literal. For example, find_package(Foo) will search prefixes specified in the Foo_ROOT environment variable (if set). See policy CMP0074.

This variable may hold a single prefix or a list of prefixes separated by : on UNIX or ; on Windows (the same as the PATH environment variable convention on those platforms).

See also the <PackageName>_ROOT CMake variable.

VERBOSE¶

New in version 3.14.

Activates verbose output from CMake and your build tools of choice when you start to actually build your project.

Note that any given value is ignored. It's just checked for existence.

See also Build Tool Mode and CMAKE_NO_VERBOSE environment variable

ASM<DIALECT>¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling a specific dialect of assembly language files. ASM<DIALECT> can be one of:

Will only be used by CMake on the first configuration to determine ASM<DIALECT> compiler, after which the value for ASM<DIALECT> is stored in the cache as CMAKE_ASM<DIALECT>_COMPILER. For subsequent configuration runs, the environment variable will be ignored in favor of CMAKE_ASM<DIALECT>_COMPILER.

NOTE:

$ export ASM="custom-compiler --arg1 --arg2"

ASM<DIALECT>FLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling a specific dialect of an assembly language. ASM<DIALECT>FLAGS can be one of:

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_ASM<DIALECT>_FLAGS cache entry. This occurs the first time a build tree is configured for language ASM<DIALECT>. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_ASM<DIALECT>_FLAGS variable is already defined.

See also CMAKE_ASM<DIALECT>_FLAGS_INIT.

CC¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling C language files. Will only be used by CMake on the first configuration to determine C compiler, after which the value for CC is stored in the cache as CMAKE_C_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_C_COMPILER variable is defined.

NOTE:

$ export CC="custom-compiler --arg1 --arg2"

CFLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling C files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_C_FLAGS cache entry. This occurs the first time a build tree is configured for language C. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_C_FLAGS variable is already defined.

See also CMAKE_C_FLAGS_INIT.

CSFLAGS¶

New in version 3.9.2.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling CSharp files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_CSharp_FLAGS cache entry. This occurs the first time a build tree is configured for language CSharp. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_CSharp_FLAGS variable is already defined.

See also CMAKE_CSharp_FLAGS_INIT.

CUDAARCHS¶

New in version 3.20.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Value used to initialize CMAKE_CUDA_ARCHITECTURES on the first configuration. Subsequent runs will use the value stored in the cache.

This is a semicolon-separated list of architectures as described in CUDA_ARCHITECTURES.

CUDACXX¶

New in version 3.8.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling CUDA language files. Will only be used by CMake on the first configuration to determine CUDA compiler, after which the value for CUDA is stored in the cache as CMAKE_CUDA_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_CUDA_COMPILER variable is defined.

NOTE:

$ export CUDACXX="custom-compiler --arg1 --arg2"

CUDAFLAGS¶

New in version 3.8.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling CUDA files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_CUDA_FLAGS cache entry. This occurs the first time a build tree is configured for language CUDA. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_CUDA_FLAGS variable is already defined.

See also CMAKE_CUDA_FLAGS_INIT.

CUDAHOSTCXX¶

New in version 3.8.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling host code when compiling CUDA language files. Will only be used by CMake on the first configuration to determine CUDA host compiler, after which the value for CUDAHOSTCXX is stored in the cache as CMAKE_CUDA_HOST_COMPILER. This environment variable is preferred over CMAKE_CUDA_HOST_COMPILER.

This environment variable is primarily meant for use with projects that enable CUDA as a first-class language.

NOTE:

New in version 3.13: The FindCUDA module will use this variable to initialize its CUDA_HOST_COMPILER setting.

CXX¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling CXX language files. Will only be used by CMake on the first configuration to determine CXX compiler, after which the value for CXX is stored in the cache as CMAKE_CXX_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_CXX_COMPILER variable is defined.

NOTE:

$ export CXX="custom-compiler --arg1 --arg2"

CXXFLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling CXX (C++) files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_CXX_FLAGS cache entry. This occurs the first time a build tree is configured for language CXX. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_CXX_FLAGS variable is already defined.

See also CMAKE_CXX_FLAGS_INIT.

FC¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling Fortran language files. Will only be used by CMake on the first configuration to determine Fortran compiler, after which the value for Fortran is stored in the cache as CMAKE_Fortran_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_Fortran_COMPILER variable is defined.

NOTE:

$ export FC="custom-compiler --arg1 --arg2"

FFLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling Fortran files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_Fortran_FLAGS cache entry. This occurs the first time a build tree is configured for language Fortran. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_Fortran_FLAGS variable is already defined.

See also CMAKE_Fortran_FLAGS_INIT.

HIPCXX¶

New in version 3.21.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling HIP language files. Will only be used by CMake on the first configuration to determine HIP compiler, after which the value for HIP is stored in the cache as CMAKE_HIP_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_HIP_COMPILER variable is defined.

HIPFLAGS¶

New in version 3.21.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling HIP files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_HIP_FLAGS cache entry. This occurs the first time a build tree is configured for language HIP. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_HIP_FLAGS variable is already defined.

See also CMAKE_HIP_FLAGS_INIT.

ISPC¶

New in version 3.19.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling ISPC language files. Will only be used by CMake on the first configuration to determine ISPC compiler, after which the value for ISPC is stored in the cache as CMAKE_ISPC_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_ISPC_COMPILER variable is defined.

ISPCFLAGS¶

New in version 3.19.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling ISPC files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_ISPC_FLAGS cache entry. This occurs the first time a build tree is configured for language ISPC. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_ISPC_FLAGS variable is already defined.

See also CMAKE_ISPC_FLAGS_INIT.

OBJC¶

New in version 3.16.7.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling OBJC language files. Will only be used by CMake on the first configuration to determine OBJC compiler, after which the value for OBJC is stored in the cache as CMAKE_OBJC_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_OBJC_COMPILER variable is defined.

If OBJC is not defined, the CC environment variable will be checked instead.

OBJCXX¶

New in version 3.16.7.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling OBJCXX language files. Will only be used by CMake on the first configuration to determine OBJCXX compiler, after which the value for OBJCXX is stored in the cache as CMAKE_OBJCXX_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_OBJCXX_COMPILER variable is defined.

If OBJCXX is not defined, the CXX environment variable will be checked instead.

RC¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling resource files. Will only be used by CMake on the first configuration to determine resource compiler, after which the value for RC is stored in the cache as CMAKE_RC_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_RC_COMPILER variable is defined.

NOTE:

$ export RC="custom-compiler --arg1 --arg2"

RCFLAGS¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Add default compilation flags to be used when compiling RC (resource) files.

CMake uses this environment variable value, in combination with its own builtin default flags for the toolchain, to initialize and store the CMAKE_RC_FLAGS cache entry. This occurs the first time a build tree is configured for language RC. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_RC_FLAGS variable is already defined.

See also CMAKE_RC_FLAGS_INIT.

SWIFTC¶

New in version 3.15.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Preferred executable for compiling Swift language files. Will only be used by CMake on the first configuration to determine Swift compiler, after which the value for SWIFTC is stored in the cache as CMAKE_Swift_COMPILER. For any configuration run (including the first), the environment variable will be ignored if the CMAKE_Swift_COMPILER variable is defined.

NOTE:

$ export SWIFTC="custom-compiler --arg1 --arg2"

CTEST_INTERACTIVE_DEBUG_MODE¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Environment variable that will exist and be set to 1 when a test executed by ctest(1) is run in interactive mode.

CTEST_NO_TESTS_ACTION¶

New in version 3.26.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Environment variable that controls how ctest handles cases when there are no tests to run. Possible values are: error, ignore, empty or unset.

The --no-tests=<action> option to ctest overrides this environment variable if both are given.

CTEST_OUTPUT_ON_FAILURE¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Boolean environment variable that controls if the output should be logged for failed tests. Set the value to 1, True, or ON to enable output on failure. See ctest(1) for more information on controlling output of failed tests.

CTEST_PARALLEL_LEVEL¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Specify the number of tests for CTest to run in parallel. See ctest(1) for more information on parallel test execution.

CTEST_PROGRESS_OUTPUT¶

New in version 3.13.

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Boolean environment variable that affects how ctest command output reports overall progress. When set to 1, TRUE, ON or anything else that evaluates to boolean true, progress is reported by repeatedly updating the same line. This greatly reduces the overall verbosity, but is only supported when output is sent directly to a terminal. If the environment variable is not set or has a value that evaluates to false, output is reported normally with each test having its own start and end lines logged to the output.

The --progress option to ctest overrides this environment variable if both are given.

CTEST_USE_LAUNCHERS_DEFAULT¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Initializes the CTEST_USE_LAUNCHERS variable if not already defined.

DASHBOARD_TEST_FROM_CTEST¶

This is a CMake Environment Variable. Its initial value is taken from the calling process environment.

Environment variable that will exist when a test executed by ctest(1) is run in non-interactive mode. The value will be equal to CMAKE_VERSION.

CCMAKE_COLORS¶

New in version 3.18.

Determines what colors are used by the CMake curses interface, when run on a terminal that supports colors. The syntax follows the same conventions as LS_COLORS; that is, a list of key/value pairs separated by :.

Keys are a single letter corresponding to a CMake cache variable type:

Values are an integer number that specifies what color to use. 0 is black (you probably don't want to use that). Others are determined by your terminal's color support. Most (color) terminals will support at least 8 or 16 colors. Some will support up to 256 colors. The colors will likely match this chart, although the first 16 colors may match the original CGA color palette. (Many modern terminal emulators also allow their color palette, at least for the first 16 colors, to be configured by the user.)

Note that fairly minimal checking is done for bad colors (although a value higher than what curses believes your terminal supports will be silently ignored) or bad syntax.

For example:

CCMAKE_COLORS='s=39:p=220:c=207:n=196:y=46'