Semicolon-separated list of directories
to be ignored by the various
find_path(), any file found in one of the listed directories
will be ignored. The listed directories do not apply recursively, so any
subdirectories to be ignored must also be explicitly listed.
CMAKE_SYSTEM_IGNORE_PATH does not affect the search prefixes used by these
four commands. To ignore individual paths under a search prefix
lib, etc.), each path must be listed in
CMAKE_SYSTEM_IGNORE_PATH as a full absolute path.
provides a more appropriate way to ignore a whole search prefix.
find_package() is also affected by
CMAKE_SYSTEM_IGNORE_PATH, but only
for Config mode searches. Any
<name>-config.cmake file found in one of the specified directories
will be ignored. In addition, any search prefix found in
will be skipped for backward compatibility reasons, but new code should
prefer to use
CMAKE_SYSTEM_IGNORE_PREFIX_PATH to ignore prefixes instead.
Ignoring search locations can be useful in cross-compiling environments where some system directories contain incompatible but possibly linkable libraries. For example, on cross-compiled cluster environments, this allows a user to ignore directories containing libraries meant for the front-end machine.
CMAKE_SYSTEM_IGNORE_PATH is populated by CMake as part of its platform
and toolchain setup. Its purpose is to ignore locations containing
incompatible binaries meant for the host rather than the target platform.
The project or end user should not modify this variable, they should use
See also the following variables: