Back to Cmake

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

Help/variable/CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY.rst

4.3.21023 B
Original Source

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

.. versionadded:: 3.1

.. deprecated:: 3.16

Use the :variable:CMAKE_FIND_USE_PACKAGE_REGISTRY variable instead.

By default this variable is not set. If neither :variable:CMAKE_FIND_USE_PACKAGE_REGISTRY nor CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY is set, then :command:find_package() will use the :ref:User Package Registry unless the NO_CMAKE_PACKAGE_REGISTRY option is provided.

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY is ignored if :variable:CMAKE_FIND_USE_PACKAGE_REGISTRY is set.

In some cases, for example to locate only system wide installations, it is not desirable to use the :ref:User Package Registry when searching for packages. If the CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY variable is TRUE, all the :command:find_package commands will skip the :ref:User Package Registry as if they were called with the NO_CMAKE_PACKAGE_REGISTRY argument.

See also :ref:Disabling the Package Registry.