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