CMAKE_IGNORE_PATH

Список, разделённый точкой с запятой каталогов, которые будут игнорироваться различными find...() командами.

Для find_program(), find_library(), find_file() и find_path() любой файл, найденный в одном из указанных каталогов, будет проигнорирован. Указанные каталоги не применяются рекурсивно, поэтому любые подкаталоги, которые нужно пропустить, также должны быть явно указаны. CMAKE_IGNORE_PATH не влияет на используемые этими четырьмя командами префиксы поиска. Чтобы пропустить отдельные пути под префиксом поиска (например, bin, include, lib, и т. д.), каждый путь должен быть указан в CMAKE_IGNORE_PATH в виде полного абсолютного пути. CMAKE_IGNORE_PREFIX_PATH предоставляет более подходящий способ пропуска целого префикса поиска.

find_package() также затрагивается CMAKE_IGNORE_PATH, но только для поиска в режиме Config. Любой <Name>Config.cmake или <name>-config.cmake файл, найденный в одном из указанных каталогов, будет пропущен. Кроме того, любой найденный в CMAKE_IGNORE_PATH поиск префикса будет пропущен по соображениям обратной совместимости, но новый код должен предпочесть использовать CMAKE_IGNORE_PREFIX_PATH для пропуска префиксов.

Пропуск расположений поиска может быть полезен в кросс-компилируемых средах, где некоторые системные каталоги содержат несовместимые, но, возможно, линковаемые библиотеки. Например, в кросс-компилируемых кластерных средах это позволяет пользователю игнорировать каталоги, содержащие библиотеки, предназначенные для машины переднего плана.

По умолчанию CMAKE_IGNORE_PATH пусто. Он предназначен для установки проектом или конечным пользователем.

См. также следующие переменные:

• CMAKE_IGNORE_PREFIX_PATH
• CMAKE_SYSTEM_IGNORE_PATH
• CMAKE_PREFIX_PATH
• CMAKE_LIBRARY_PATH
• CMAKE_INCLUDE_PATH
• CMAKE_PROGRAM_PATH