code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_EXTRA_GENERATOR — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_AUTOMOC_RELAXED_MODE" href="CMAKE_AUTOMOC_RELAXED_MODE.html" />
    <link rel="prev" title="CMAKE_VS_INTEL_Fortran_PROJECT_VERSION" href="CMAKE_VS_INTEL_Fortran_PROJECT_VERSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_EXTRA_GENERATOR

CMAKE_EXTRA_GENERATOR¶

Deprecated since version 3.27: Support for Extra Generators is deprecated and will be removed from
a future version of CMake.  IDEs may use the cmake-file-api(7)
to view CMake-generated project build trees.

The extra generator used to build the project.  See
cmake-generators(7).

When using the Eclipse, CodeBlocks, CodeLite, Kate or Sublime generators, CMake
generates Makefiles (CMAKE_GENERATOR) and additionally project
files for the respective IDE.  This IDE project file generator is stored in
CMAKE_EXTRA_GENERATOR (e.g.  Eclipse CDT4).

Previous topic

CMAKE_VS_INTEL_Fortran_PROJECT_VERSION

Next topic

CMAKE_AUTOMOC_RELAXED_MODE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_EXTRA_GENERATOR

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_DEBUG_MODE" href="CMAKE_FIND_DEBUG_MODE.html" />
    <link rel="prev" title="CMAKE_EXECUTABLE_SUFFIX_<LANG>" href="CMAKE_EXECUTABLE_SUFFIX_LANG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES

CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES¶

Additional suffixes for shared libraries.

Extensions for shared libraries other than that specified by
CMAKE_SHARED_LIBRARY_SUFFIX, if any.  CMake uses this to recognize
external shared library files during analysis of libraries linked by a
target.

Previous topic

CMAKE_EXECUTABLE_SUFFIX_<LANG>

Next topic

CMAKE_FIND_DEBUG_MODE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.

repo_name: lazytadpole/codenamesilverfish

license: mit


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_APPBUNDLE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_FRAMEWORK" href="CMAKE_FIND_FRAMEWORK.html" />
    <link rel="prev" title="CMAKE_EXPORT_NO_PACKAGE_REGISTRY" href="CMAKE_EXPORT_NO_PACKAGE_REGISTRY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_APPBUNDLE

CMAKE_FIND_APPBUNDLE¶

New in version 3.4.

This variable affects how find_* commands choose between
macOS Application Bundles and unix-style package components.

On Darwin or systems supporting macOS Application Bundles, the
CMAKE_FIND_APPBUNDLE variable can be set to empty or
one of the following:

FIRST

Try to find application bundles before standard programs.
This is the default on Darwin.

LAST

Try to find application bundles after standard programs.

ONLY

Only try to find application bundles.

NEVER

Never try to find application bundles.

Previous topic

CMAKE_EXPORT_NO_PACKAGE_REGISTRY

Next topic

CMAKE_FIND_FRAMEWORK

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_APPBUNDLE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_DEBUG_MODE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_NAME" href="CMAKE_FIND_PACKAGE_NAME.html" />
    <link rel="prev" title="CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES" href="CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_DEBUG_MODE

CMAKE_FIND_DEBUG_MODE¶

New in version 3.17.

Print extra find call information for the following commands to standard
error:

find_program()

find_library()

find_file()

find_path()

find_package()

Output is designed for human consumption and not for parsing.
Enabling this variable is equivalent to using cmake --debug-find
with the added ability to enable debugging for a subset of find calls.

set(CMAKE_FIND_DEBUG_MODE TRUE)
find_program(...)
set(CMAKE_FIND_DEBUG_MODE FALSE)

Default is unset.

Previous topic

CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES

Next topic

CMAKE_FIND_PACKAGE_NAME

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_DEBUG_MODE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_FRAMEWORK — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX" href="CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX.html" />
    <link rel="prev" title="CMAKE_FIND_APPBUNDLE" href="CMAKE_FIND_APPBUNDLE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_FRAMEWORK

CMAKE_FIND_FRAMEWORK¶

New in version 3.4.

This variable affects how find_* commands choose between
macOS Frameworks and unix-style package components.

On Darwin or systems supporting macOS Frameworks, the
CMAKE_FIND_FRAMEWORK variable can be set to empty or
one of the following:

FIRST

Try to find frameworks before standard libraries or headers.
This is the default on Darwin.

LAST

Try to find frameworks after standard libraries or headers.

ONLY

Only try to find frameworks.

NEVER

Never try to find frameworks.

Previous topic

CMAKE_FIND_APPBUNDLE

Next topic

CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_FRAMEWORK

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_LIBRARY_PREFIXES" href="CMAKE_FIND_LIBRARY_PREFIXES.html" />
    <link rel="prev" title="CMAKE_FIND_FRAMEWORK" href="CMAKE_FIND_FRAMEWORK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX

CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX¶

New in version 3.9.

Specify a <suffix> to tell the find_library() command to
search in a lib<suffix> directory before each lib directory that
would normally be searched.

This overrides the behavior of related global properties:

FIND_LIBRARY_USE_LIB32_PATHS

FIND_LIBRARY_USE_LIB64_PATHS

FIND_LIBRARY_USE_LIBX32_PATHS

Previous topic

CMAKE_FIND_FRAMEWORK

Next topic

CMAKE_FIND_LIBRARY_PREFIXES

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_LIBRARY_PREFIXES — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_LIBRARY_SUFFIXES" href="CMAKE_FIND_LIBRARY_SUFFIXES.html" />
    <link rel="prev" title="CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX" href="CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_PREFIXES

CMAKE_FIND_LIBRARY_PREFIXES¶

Prefixes to prepend when looking for libraries.

This specifies what prefixes to add to library names when the
find_library() command looks for libraries.  On UNIX systems this is
typically lib, meaning that when trying to find the foo library it
will look for libfoo.

Previous topic

CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX

Next topic

CMAKE_FIND_LIBRARY_SUFFIXES

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_PREFIXES

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_LIBRARY_SUFFIXES — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_NO_INSTALL_PREFIX" href="CMAKE_FIND_NO_INSTALL_PREFIX.html" />
    <link rel="prev" title="CMAKE_FIND_LIBRARY_PREFIXES" href="CMAKE_FIND_LIBRARY_PREFIXES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_SUFFIXES

CMAKE_FIND_LIBRARY_SUFFIXES¶

Suffixes to append when looking for libraries.

This specifies what suffixes to add to library names when the
find_library() command looks for libraries.  On Windows systems this
is typically .lib and, depending on the compiler, .dll.lib, .dll.a,
.a (e.g. rustc, GCC, or Clang), so when it tries to find the foo
library, it will look for [<prefix>]foo[.dll].lib and/or
[<prefix>]foo[.dll].a, depending on the compiler used and the <prefix>
specified in the CMAKE_FIND_LIBRARY_PREFIXES.

Previous topic

CMAKE_FIND_LIBRARY_PREFIXES

Next topic

CMAKE_FIND_NO_INSTALL_PREFIX

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_LIBRARY_SUFFIXES

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_NO_INSTALL_PREFIX — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_PREFER_CONFIG" href="CMAKE_FIND_PACKAGE_PREFER_CONFIG.html" />
    <link rel="prev" title="CMAKE_FIND_LIBRARY_SUFFIXES" href="CMAKE_FIND_LIBRARY_SUFFIXES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_NO_INSTALL_PREFIX

CMAKE_FIND_NO_INSTALL_PREFIX¶

Exclude the values of the CMAKE_INSTALL_PREFIX and
CMAKE_STAGING_PREFIX variables from
CMAKE_SYSTEM_PREFIX_PATH.  CMake adds these project-destination
prefixes to CMAKE_SYSTEM_PREFIX_PATH by default in order to
support building a series of dependent packages and installing them into
a common prefix.  Set CMAKE_FIND_NO_INSTALL_PREFIX to TRUE
to suppress this behavior.

The CMAKE_SYSTEM_PREFIX_PATH is initialized on the first call to a
project() or enable_language() command.  Therefore one must
set CMAKE_FIND_NO_INSTALL_PREFIX before this in order to take effect.  A
user may set the variable as a cache entry on the command line to achieve this.

Note that the prefix(es) may still be searched for other reasons, such as being
the same prefix as the CMake installation, or for being a built-in system
prefix.

Previous topic

CMAKE_FIND_LIBRARY_SUFFIXES

Next topic

CMAKE_FIND_PACKAGE_PREFER_CONFIG

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_NO_INSTALL_PREFIX

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_NAME — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_REDIRECTS_DIR" href="CMAKE_FIND_PACKAGE_REDIRECTS_DIR.html" />
    <link rel="prev" title="CMAKE_FIND_DEBUG_MODE" href="CMAKE_FIND_DEBUG_MODE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NAME

CMAKE_FIND_PACKAGE_NAME¶

New in version 3.1.1.

Defined by the find_package() command while loading
a find module to record the caller-specified package name.
See command documentation for details.

Previous topic

CMAKE_FIND_DEBUG_MODE

Next topic

CMAKE_FIND_PACKAGE_REDIRECTS_DIR

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NAME

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY" href="CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY.html" />
    <link rel="prev" title="CMAKE_BACKWARDS_COMPATIBILITY" href="CMAKE_BACKWARDS_COMPATIBILITY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY¶

New in version 3.1.

Deprecated since version 3.16: Use the CMAKE_FIND_USE_PACKAGE_REGISTRY variable instead.

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

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY is ignored if
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 User Package Registry when searching
for packages. If the CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
variable is TRUE, all the find_package() commands will skip
the User Package Registry as if they were called with the
NO_CMAKE_PACKAGE_REGISTRY argument.

See also Disabling the Package Registry.

Previous topic

CMAKE_BACKWARDS_COMPATIBILITY

Next topic

CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="MSVC10" href="MSVC10.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY" href="CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY

CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY¶

New in version 3.1.

Deprecated since version 3.16: Use the CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY variable instead.

By default this variable is not set. If neither
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY nor
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY is set, then
find_package() will use the System Package Registry
unless the NO_CMAKE_SYSTEM_PACKAGE_REGISTRY option is provided.

CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY is ignored if
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY is set.

In some cases, it is not desirable to use the
System Package Registry when searching for packages. If the
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY variable is
TRUE, all the find_package() commands will skip
the System Package Registry as if they were called with the
NO_CMAKE_SYSTEM_PACKAGE_REGISTRY argument.

See also Disabling the Package Registry.

Previous topic

CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

Next topic

MSVC10

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_PREFER_CONFIG — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS" href="CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.html" />
    <link rel="prev" title="CMAKE_FIND_NO_INSTALL_PREFIX" href="CMAKE_FIND_NO_INSTALL_PREFIX.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_PREFER_CONFIG

CMAKE_FIND_PACKAGE_PREFER_CONFIG¶

New in version 3.15.

Tell find_package() to try "Config" mode before "Module" mode if no
mode was specified.

The command find_package() operates without an explicit mode when
the reduced signature is used without the MODULE option. In this case,
by default, CMake first tries Module mode by searching for a
Find<pkg>.cmake module.  If it fails, CMake then searches for the package
using Config mode.

Set CMAKE_FIND_PACKAGE_PREFER_CONFIG to TRUE to tell
find_package() to first search using Config mode before falling back
to Module mode.

This variable may be useful when a developer has compiled a custom version of
a common library and wishes to link it to a dependent project.  If this
variable is set to TRUE, it would prevent a dependent project's call
to find_package() from selecting the default library located by the
system's Find<pkg>.cmake module before finding the developer's custom
built library.

Once this variable is set, it is the responsibility of the exported
<pkg>Config.cmake files to provide the same result variables as the
Find<pkg>.cmake modules so that dependent projects can use them
interchangeably.

Previous topic

CMAKE_FIND_NO_INSTALL_PREFIX

Next topic

CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_PREFER_CONFIG

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_REDIRECTS_DIR — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_SORT_DIRECTION" href="CMAKE_FIND_PACKAGE_SORT_DIRECTION.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_NAME" href="CMAKE_FIND_PACKAGE_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_REDIRECTS_DIR

CMAKE_FIND_PACKAGE_REDIRECTS_DIR¶

New in version 3.24.

This read-only variable specifies a directory that the find_package()
command will check first before searching anywhere else for a module or config
package file.  A config package file in this directory will always be found in
preference to any other Find module file or config package file.

The primary purpose of this variable is to facilitate integration between
find_package() and FetchContent_MakeAvailable().  The latter
command may create files in the CMAKE_FIND_PACKAGE_REDIRECTS_DIR directory
when it populates a dependency.  This allows subsequent calls to
find_package() for the same dependency to reuse the populated
contents instead of trying to satisfy the dependency from somewhere external
to the build.  Projects may also want to write files into this directory in
some situations (see Integrating With find_package()
for examples).

The directory that CMAKE_FIND_PACKAGE_REDIRECTS_DIR points to will always
be erased and recreated empty at the start of every CMake run.  Any files
written into this directory during the CMake run will be lost the next time
CMake configures the project.

CMAKE_FIND_PACKAGE_REDIRECTS_DIR is only set in CMake project mode.
It is not set when CMake is run in script mode
(i.e. cmake -P).

Previous topic

CMAKE_FIND_PACKAGE_NAME

Next topic

CMAKE_FIND_PACKAGE_SORT_DIRECTION

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_REDIRECTS_DIR

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_TARGETS_GLOBAL" href="CMAKE_FIND_PACKAGE_TARGETS_GLOBAL.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_PREFER_CONFIG" href="CMAKE_FIND_PACKAGE_PREFER_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS

CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS¶

New in version 3.14.

Set to TRUE to tell find_package() calls to resolve symbolic
links in the value of <PackageName>_DIR.

This is helpful in use cases where the package search path points at a
proxy directory in which symlinks to the real package locations appear.
This is not enabled by default because there are also common use cases
in which the symlinks should be preserved.

Previous topic

CMAKE_FIND_PACKAGE_PREFER_CONFIG

Next topic

CMAKE_FIND_PACKAGE_TARGETS_GLOBAL

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_SORT_DIRECTION — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_SORT_ORDER" href="CMAKE_FIND_PACKAGE_SORT_ORDER.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_REDIRECTS_DIR" href="CMAKE_FIND_PACKAGE_REDIRECTS_DIR.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_SORT_DIRECTION

CMAKE_FIND_PACKAGE_SORT_DIRECTION¶

New in version 3.7.

The sorting direction used by CMAKE_FIND_PACKAGE_SORT_ORDER.
It can assume one of the following values:

DEC

Default.  Ordering is done in descending mode.
The highest folder found will be tested first.

ASC

Ordering is done in ascending mode.
The lowest folder found will be tested first.

If CMAKE_FIND_PACKAGE_SORT_ORDER is not set or is set to NONE
this variable has no effect.

Previous topic

CMAKE_FIND_PACKAGE_REDIRECTS_DIR

Next topic

CMAKE_FIND_PACKAGE_SORT_ORDER

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_SORT_DIRECTION

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_SORT_ORDER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_GENERATOR" href="CMAKE_GENERATOR.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_SORT_DIRECTION" href="CMAKE_FIND_PACKAGE_SORT_DIRECTION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_SORT_ORDER

CMAKE_FIND_PACKAGE_SORT_ORDER¶

New in version 3.7.

The default order for sorting packages found using find_package().
It can assume one of the following values:

NONE

Default.  No attempt is done to sort packages.
The first valid package found will be selected.

NAME

Sort packages lexicographically before selecting one.

NATURAL

Sort packages using natural order (see strverscmp(3) manual),
i.e. such that contiguous digits are compared as whole numbers.

Natural sorting can be employed to return the highest version when multiple
versions of the same library are found by find_package().  For
example suppose that the following libraries have been found:

libX-1.1.0

libX-1.2.9

libX-1.2.10

By setting NATURAL order we can select the one with the highest
version number libX-1.2.10.

set(CMAKE_FIND_PACKAGE_SORT_ORDER NATURAL)
find_package(libX CONFIG)

The sort direction can be controlled using the
CMAKE_FIND_PACKAGE_SORT_DIRECTION variable
(by default decrescent, e.g. lib-B will be tested before lib-A).

Previous topic

CMAKE_FIND_PACKAGE_SORT_DIRECTION

Next topic

CMAKE_GENERATOR

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_SORT_ORDER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_TARGETS_GLOBAL — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_PACKAGE_WARN_NO_MODULE" href="CMAKE_FIND_PACKAGE_WARN_NO_MODULE.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS" href="CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_TARGETS_GLOBAL

CMAKE_FIND_PACKAGE_TARGETS_GLOBAL¶

New in version 3.24.

Setting to TRUE promotes all IMPORTED targets discoverd
by find_package() to a GLOBAL scope.

Setting this to TRUE is akin to specifying GLOBAL
as an argument to find_package().
Default value is OFF.

Previous topic

CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS

Next topic

CMAKE_FIND_PACKAGE_WARN_NO_MODULE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_TARGETS_GLOBAL

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_PACKAGE_WARN_NO_MODULE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_ROOT_PATH" href="CMAKE_FIND_ROOT_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_TARGETS_GLOBAL" href="CMAKE_FIND_PACKAGE_TARGETS_GLOBAL.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_WARN_NO_MODULE

CMAKE_FIND_PACKAGE_WARN_NO_MODULE¶

Tell find_package() to warn if called without an explicit mode.

If find_package() is called without an explicit mode option
(MODULE, CONFIG, or NO_MODULE) and no Find<pkg>.cmake module
is in CMAKE_MODULE_PATH then CMake implicitly assumes that the
caller intends to search for a package configuration file.  If no package
configuration file is found then the wording of the failure message
must account for both the case that the package is really missing and
the case that the project has a bug and failed to provide the intended
Find module.  If instead the caller specifies an explicit mode option
then the failure message can be more specific.

Set CMAKE_FIND_PACKAGE_WARN_NO_MODULE to TRUE to tell
find_package() to warn when it implicitly assumes Config mode.  This
helps developers enforce use of an explicit mode in all calls to
find_package() within a project.

This variable has no effect if CMAKE_FIND_PACKAGE_PREFER_CONFIG is
set to TRUE.

Previous topic

CMAKE_FIND_PACKAGE_TARGETS_GLOBAL

Next topic

CMAKE_FIND_ROOT_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_PACKAGE_WARN_NO_MODULE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_ROOT_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_ROOT_PATH_MODE_INCLUDE" href="CMAKE_FIND_ROOT_PATH_MODE_INCLUDE.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_WARN_NO_MODULE" href="CMAKE_FIND_PACKAGE_WARN_NO_MODULE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH

CMAKE_FIND_ROOT_PATH¶

Semicolon-separated list of root paths to search on the filesystem.

This variable is most useful when cross-compiling. CMake uses the paths in
this list as alternative roots to find filesystem items with
find_package(), find_library() etc.

Previous topic

CMAKE_FIND_PACKAGE_WARN_NO_MODULE

Next topic

CMAKE_FIND_ROOT_PATH_MODE_INCLUDE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_ROOT_PATH_MODE_INCLUDE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_ROOT_PATH_MODE_LIBRARY" href="CMAKE_FIND_ROOT_PATH_MODE_LIBRARY.html" />
    <link rel="prev" title="CMAKE_FIND_ROOT_PATH" href="CMAKE_FIND_ROOT_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_INCLUDE

CMAKE_FIND_ROOT_PATH_MODE_INCLUDE¶

This variable controls whether the CMAKE_FIND_ROOT_PATH and
CMAKE_SYSROOT are used by find_file() and find_path().

If set to ONLY, then only the roots in CMAKE_FIND_ROOT_PATH
will be searched. If set to NEVER, then the roots in
CMAKE_FIND_ROOT_PATH will be ignored and only the host system
root will be used. If set to BOTH, then the host system paths and the
paths in CMAKE_FIND_ROOT_PATH will be searched.

Previous topic

CMAKE_FIND_ROOT_PATH

Next topic

CMAKE_FIND_ROOT_PATH_MODE_LIBRARY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_INCLUDE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_ROOT_PATH_MODE_LIBRARY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_ROOT_PATH_MODE_PACKAGE" href="CMAKE_FIND_ROOT_PATH_MODE_PACKAGE.html" />
    <link rel="prev" title="CMAKE_FIND_ROOT_PATH_MODE_INCLUDE" href="CMAKE_FIND_ROOT_PATH_MODE_INCLUDE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_LIBRARY

CMAKE_FIND_ROOT_PATH_MODE_LIBRARY¶

This variable controls whether the CMAKE_FIND_ROOT_PATH and
CMAKE_SYSROOT are used by find_library().

If set to ONLY, then only the roots in CMAKE_FIND_ROOT_PATH
will be searched. If set to NEVER, then the roots in
CMAKE_FIND_ROOT_PATH will be ignored and only the host system
root will be used. If set to BOTH, then the host system paths and the
paths in CMAKE_FIND_ROOT_PATH will be searched.

Previous topic

CMAKE_FIND_ROOT_PATH_MODE_INCLUDE

Next topic

CMAKE_FIND_ROOT_PATH_MODE_PACKAGE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_LIBRARY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_ROOT_PATH_MODE_PACKAGE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_ROOT_PATH_MODE_PROGRAM" href="CMAKE_FIND_ROOT_PATH_MODE_PROGRAM.html" />
    <link rel="prev" title="CMAKE_FIND_ROOT_PATH_MODE_LIBRARY" href="CMAKE_FIND_ROOT_PATH_MODE_LIBRARY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_PACKAGE

CMAKE_FIND_ROOT_PATH_MODE_PACKAGE¶

This variable controls whether the CMAKE_FIND_ROOT_PATH and
CMAKE_SYSROOT are used by find_package().

If set to ONLY, then only the roots in CMAKE_FIND_ROOT_PATH
will be searched. If set to NEVER, then the roots in
CMAKE_FIND_ROOT_PATH will be ignored and only the host system
root will be used. If set to BOTH, then the host system paths and the
paths in CMAKE_FIND_ROOT_PATH will be searched.

Previous topic

CMAKE_FIND_ROOT_PATH_MODE_LIBRARY

Next topic

CMAKE_FIND_ROOT_PATH_MODE_PROGRAM

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_PACKAGE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_ROOT_PATH_MODE_PROGRAM — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH" href="CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_ROOT_PATH_MODE_PACKAGE" href="CMAKE_FIND_ROOT_PATH_MODE_PACKAGE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_PROGRAM

CMAKE_FIND_ROOT_PATH_MODE_PROGRAM¶

This variable controls whether the CMAKE_FIND_ROOT_PATH and
CMAKE_SYSROOT are used by find_program().

If set to ONLY, then only the roots in CMAKE_FIND_ROOT_PATH
will be searched. If set to NEVER, then the roots in
CMAKE_FIND_ROOT_PATH will be ignored and only the host system
root will be used. If set to BOTH, then the host system paths and the
paths in CMAKE_FIND_ROOT_PATH will be searched.

Previous topic

CMAKE_FIND_ROOT_PATH_MODE_PACKAGE

Next topic

CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_ROOT_PATH_MODE_PROGRAM

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_CMAKE_PATH" href="CMAKE_FIND_USE_CMAKE_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_ROOT_PATH_MODE_PROGRAM" href="CMAKE_FIND_ROOT_PATH_MODE_PROGRAM.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH

CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH¶

New in version 3.16.

Controls the default behavior of the following commands for whether or not to
search paths provided by cmake-specific environment variables:

find_program()

find_library()

find_file()

find_path()

find_package()

This is useful in cross-compiling environments.

By default this variable is not set, which is equivalent to it having
a value of TRUE.  Explicit options given to the above commands
take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_ROOT_PATH_MODE_PROGRAM

Next topic

CMAKE_FIND_USE_CMAKE_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_CMAKE_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_CMAKE_SYSTEM_PATH" href="CMAKE_FIND_USE_CMAKE_SYSTEM_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH" href="CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_PATH

CMAKE_FIND_USE_CMAKE_PATH¶

New in version 3.16.

Controls the default behavior of the following commands for whether or not to
search paths provided by cmake-specific cache variables:

find_program()

find_library()

find_file()

find_path()

find_package()

This is useful in cross-compiling environments.

By default this variable is not set, which is equivalent to it having
a value of TRUE.  Explicit options given to the above commands
take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH

Next topic

CMAKE_FIND_USE_CMAKE_SYSTEM_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_CMAKE_SYSTEM_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_INSTALL_PREFIX" href="CMAKE_FIND_USE_INSTALL_PREFIX.html" />
    <link rel="prev" title="CMAKE_FIND_USE_CMAKE_PATH" href="CMAKE_FIND_USE_CMAKE_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_SYSTEM_PATH

CMAKE_FIND_USE_CMAKE_SYSTEM_PATH¶

New in version 3.16.

Controls the default behavior of the following commands for whether or not to
search paths provided by platform-specific cmake variables:

find_program()

find_library()

find_file()

find_path()

find_package()

This is useful in cross-compiling environments.

By default this variable is not set, which is equivalent to it having
a value of TRUE.  Explicit options given to the above commands
take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_USE_CMAKE_PATH

Next topic

CMAKE_FIND_USE_INSTALL_PREFIX

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_CMAKE_SYSTEM_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_INSTALL_PREFIX — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_PACKAGE_REGISTRY" href="CMAKE_FIND_USE_PACKAGE_REGISTRY.html" />
    <link rel="prev" title="CMAKE_FIND_USE_CMAKE_SYSTEM_PATH" href="CMAKE_FIND_USE_CMAKE_SYSTEM_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_INSTALL_PREFIX

CMAKE_FIND_USE_INSTALL_PREFIX¶

New in version 3.24.

Controls the default behavior of the following commands for whether or not to
search the locations in the CMAKE_INSTALL_PREFIX and
CMAKE_STAGING_PREFIX variables.

find_program()

find_library()

find_file()

find_path()

find_package()

This is useful in cross-compiling environments.

Due to backwards compatibility with CMAKE_FIND_NO_INSTALL_PREFIX,
the behavior of the find command change based on if this variable exists.

CMAKE_FIND_USE_INSTALL_PREFIX

CMAKE_FIND_NO_INSTALL_PREFIX

Search

Not Defined

On

NO

Not Defined

Off || Not Defined

YES

Off

On

NO

Off

Off || Not Defined

NO

On

On

YES

On

Off || Not Defined

YES

By default this variable is not defined. Explicit options given to the above
commands take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_USE_CMAKE_SYSTEM_PATH

Next topic

CMAKE_FIND_USE_PACKAGE_REGISTRY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_INSTALL_PREFIX

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_PACKAGE_REGISTRY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_PACKAGE_ROOT_PATH" href="CMAKE_FIND_USE_PACKAGE_ROOT_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_USE_INSTALL_PREFIX" href="CMAKE_FIND_USE_INSTALL_PREFIX.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_PACKAGE_REGISTRY

CMAKE_FIND_USE_PACKAGE_REGISTRY¶

New in version 3.16.

Controls the default behavior of the find_package() command for
whether or not to search paths provided by the User Package Registry.

By default this variable is not set and the behavior will fall back
to that determined by the deprecated
CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY variable.  If that is
also not set, then find_package() will use the
User Package Registry unless the NO_CMAKE_PACKAGE_REGISTRY option
is provided.

This variable takes precedence over
CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY when both are set.

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

See also Disabling the Package Registry and the
CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_USE_INSTALL_PREFIX

Next topic

CMAKE_FIND_USE_PACKAGE_ROOT_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_PACKAGE_REGISTRY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_PACKAGE_ROOT_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH" href="CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_USE_PACKAGE_REGISTRY" href="CMAKE_FIND_USE_PACKAGE_REGISTRY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_PACKAGE_ROOT_PATH

CMAKE_FIND_USE_PACKAGE_ROOT_PATH¶

New in version 3.16.

Controls the default behavior of the following commands for whether or not to
search paths provided by <PackageName>_ROOT variables:

find_program()

find_library()

find_file()

find_path()

find_package()

By default this variable is not set, which is equivalent to it having
a value of TRUE.  Explicit options given to the above commands
take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_REGISTRY variables.

Previous topic

CMAKE_FIND_USE_PACKAGE_REGISTRY

Next topic

CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_PACKAGE_ROOT_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY" href="CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY.html" />
    <link rel="prev" title="CMAKE_FIND_USE_PACKAGE_ROOT_PATH" href="CMAKE_FIND_USE_PACKAGE_ROOT_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH

CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH¶

New in version 3.16.

Controls the default behavior of the following commands for whether or not to
search paths provided by standard system environment variables:

find_program()

find_library()

find_file()

find_path()

find_package()

This is useful in cross-compiling environments.

By default this variable is not set, which is equivalent to it having
a value of TRUE.  Explicit options given to the above commands
take precedence over this variable.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
CMAKE_FIND_USE_PACKAGE_ROOT_PATH,
and CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY variables.

Previous topic

CMAKE_FIND_USE_PACKAGE_ROOT_PATH

Next topic

CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FRAMEWORK_PATH" href="CMAKE_FRAMEWORK_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH" href="CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY¶

New in version 3.16.

Controls searching the System Package Registry by the
find_package() command.

By default this variable is not set and the behavior will fall back
to that determined by the deprecated
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY variable.
If that is also not set, then find_package() will use the
System Package Registry unless the NO_CMAKE_SYSTEM_PACKAGE_REGISTRY
option is provided.

This variable takes precedence over
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY when both are set.

In some cases, for example to locate only user specific installations, it
is not desirable to use the System Package Registry when searching
for packages. If the CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY
variable is FALSE, all the find_package() commands will skip
the System Package Registry as if they were called with the
NO_CMAKE_SYSTEM_PACKAGE_REGISTRY argument.

See also Disabling the Package Registry.

See also the CMAKE_FIND_USE_CMAKE_PATH,
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH,
CMAKE_FIND_USE_INSTALL_PREFIX,
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH,
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH,
CMAKE_FIND_USE_PACKAGE_REGISTRY,
and CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.

Previous topic

CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH

Next topic

CMAKE_FRAMEWORK_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FOLDER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_Fortran_FORMAT" href="CMAKE_Fortran_FORMAT.html" />
    <link rel="prev" title="CMAKE_EXPORT_FIND_PACKAGE_NAME" href="CMAKE_EXPORT_FIND_PACKAGE_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FOLDER

CMAKE_FOLDER¶

New in version 3.12.

Set the folder name. Use to organize targets in an IDE.

This variable is used to initialize the FOLDER property on all the
targets.  See that target property for additional information.

Previous topic

CMAKE_EXPORT_FIND_PACKAGE_NAME

Next topic

CMAKE_Fortran_FORMAT

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FOLDER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FRAMEWORK — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>" href="CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_CONFIG.html" />
    <link rel="prev" title="CMAKE_Fortran_PREPROCESS" href="CMAKE_Fortran_PREPROCESS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK

CMAKE_FRAMEWORK¶

New in version 3.15.

Default value for FRAMEWORK of targets.

This variable is used to initialize the FRAMEWORK property on
all the targets.  See that target property for additional information.

Previous topic

CMAKE_Fortran_PREPROCESS

Next topic

CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG> — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_GHS_NO_SOURCE_GROUP_FILE" href="CMAKE_GHS_NO_SOURCE_GROUP_FILE.html" />
    <link rel="prev" title="CMAKE_FRAMEWORK" href="CMAKE_FRAMEWORK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>

<span id="variable:CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>">
CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>¶

New in version 3.18.

Default framework filename postfix under configuration <CONFIG> when
using a multi-config generator.

When a framework target is created its FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>
target property is initialized with the value of this variable if it is set.

Previous topic

CMAKE_FRAMEWORK

Next topic

CMAKE_GHS_NO_SOURCE_GROUP_FILE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_FRAMEWORK_PATH — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_IGNORE_PATH" href="CMAKE_IGNORE_PATH.html" />
    <link rel="prev" title="CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY" href="CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK_PATH

CMAKE_FRAMEWORK_PATH¶

Semicolon-separated list of directories specifying a search path
for macOS frameworks used by the find_library(),
find_package(), find_path(), and find_file()
commands.

There is also an environment variable CMAKE_FRAMEWORK_PATH, which is used
as an additional list of search directories.

Previous topic

CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

Next topic

CMAKE_IGNORE_PATH

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_FRAMEWORK_PATH

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_FORMAT — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_Fortran_MODULE_DIRECTORY" href="CMAKE_Fortran_MODULE_DIRECTORY.html" />
    <link rel="prev" title="CMAKE_FOLDER" href="CMAKE_FOLDER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_FORMAT

CMAKE_Fortran_FORMAT¶

Set to FIXED or FREE to indicate the Fortran source layout.

This variable is used to initialize the Fortran_FORMAT property on
all the targets.  See that target property for additional information.

Previous topic

CMAKE_FOLDER

Next topic

CMAKE_Fortran_MODULE_DIRECTORY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_FORMAT

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_MODDIR_DEFAULT — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_Fortran_MODDIR_FLAG" href="CMAKE_Fortran_MODDIR_FLAG.html" />
    <link rel="prev" title="CMAKE_CXX_STANDARD_REQUIRED" href="CMAKE_CXX_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODDIR_DEFAULT

CMAKE_Fortran_MODDIR_DEFAULT¶

Fortran default module output directory.

Most Fortran compilers write .mod files to the current working
directory.  For those that do not, this is set to . and used when
the Fortran_MODULE_DIRECTORY target property is not set.

Previous topic

CMAKE_CXX_STANDARD_REQUIRED

Next topic

CMAKE_Fortran_MODDIR_FLAG

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODDIR_DEFAULT

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_MODDIR_FLAG — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_Fortran_MODOUT_FLAG" href="CMAKE_Fortran_MODOUT_FLAG.html" />
    <link rel="prev" title="CMAKE_Fortran_MODDIR_DEFAULT" href="CMAKE_Fortran_MODDIR_DEFAULT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODDIR_FLAG

CMAKE_Fortran_MODDIR_FLAG¶

Fortran flag for module output directory.

This stores the flag needed to pass the value of the
Fortran_MODULE_DIRECTORY target property to the compiler.

Previous topic

CMAKE_Fortran_MODDIR_DEFAULT

Next topic

CMAKE_Fortran_MODOUT_FLAG

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODDIR_FLAG

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_MODOUT_FLAG — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_HIP_ARCHITECTURES" href="CMAKE_HIP_ARCHITECTURES.html" />
    <link rel="prev" title="CMAKE_Fortran_MODDIR_FLAG" href="CMAKE_Fortran_MODDIR_FLAG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODOUT_FLAG

CMAKE_Fortran_MODOUT_FLAG¶

Fortran flag to enable module output.

Most Fortran compilers write .mod files out by default.  For others,
this stores the flag needed to enable module output.

Previous topic

CMAKE_Fortran_MODDIR_FLAG

Next topic

CMAKE_HIP_ARCHITECTURES

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODOUT_FLAG

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_MODULE_DIRECTORY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_Fortran_PREPROCESS" href="CMAKE_Fortran_PREPROCESS.html" />
    <link rel="prev" title="CMAKE_Fortran_FORMAT" href="CMAKE_Fortran_FORMAT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODULE_DIRECTORY

CMAKE_Fortran_MODULE_DIRECTORY¶

Fortran module output directory.

This variable is used to initialize the Fortran_MODULE_DIRECTORY
property on all the targets.  See that target property for additional
information.

Previous topic

CMAKE_Fortran_FORMAT

Next topic

CMAKE_Fortran_PREPROCESS

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_MODULE_DIRECTORY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_Fortran_PREPROCESS — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_FRAMEWORK" href="CMAKE_FRAMEWORK.html" />
    <link rel="prev" title="CMAKE_Fortran_MODULE_DIRECTORY" href="CMAKE_Fortran_MODULE_DIRECTORY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_PREPROCESS

CMAKE_Fortran_PREPROCESS¶

New in version 3.18.

Default value for Fortran_PREPROCESS of targets.

This variable is used to initialize the Fortran_PREPROCESS
property on all the targets.  See that target property for additional
information.

Previous topic

CMAKE_Fortran_MODULE_DIRECTORY

Next topic

CMAKE_FRAMEWORK

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_Fortran_PREPROCESS

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_GENERATOR — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_GENERATOR_INSTANCE" href="CMAKE_GENERATOR_INSTANCE.html" />
    <link rel="prev" title="CMAKE_FIND_PACKAGE_SORT_ORDER" href="CMAKE_FIND_PACKAGE_SORT_ORDER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_GENERATOR

CMAKE_GENERATOR¶

The generator used to build the project.  See cmake-generators(7).

The name of the generator that is being used to generate the build
files.  (e.g.  Unix Makefiles, Ninja, etc.)

The value of this variable should never be modified by project code.
A generator may be selected via the cmake -G option,
interactively in cmake-gui(1), or via the CMAKE_GENERATOR
environment variable.

Previous topic

CMAKE_FIND_PACKAGE_SORT_ORDER

Next topic

CMAKE_GENERATOR_INSTANCE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_GENERATOR

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMAKE_GENERATOR_INSTANCE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMAKE_GENERATOR_PLATFORM" href="CMAKE_GENERATOR_PLATFORM.html" />
    <link rel="prev" title="CMAKE_GENERATOR" href="CMAKE_GENERATOR.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_GENERATOR_INSTANCE

CMAKE_GENERATOR_INSTANCE¶

New in version 3.11.

Generator-specific instance specification provided by user.

Some CMake generators support selection of an instance of the native build
system when multiple instances are available.  If the user specifies an
instance (e.g. by setting this cache entry or via the
CMAKE_GENERATOR_INSTANCE environment variable), or after a default
instance is chosen when a build tree is first configured, the value will be
available in this variable.

The value of this variable should never be modified by project code.
A toolchain file specified by the CMAKE_TOOLCHAIN_FILE
variable may initialize CMAKE_GENERATOR_INSTANCE as a cache entry.
Once a given build tree has been initialized with a particular value
for this variable, changing the value has undefined behavior.

Instance specification is supported only on specific generators.

Visual Studio Instance Selection¶

Visual Studio Generators support instance specification for
Visual Studio 2017 and above.  The CMAKE_GENERATOR_INSTANCE variable
may be set as a cache entry selecting an instance of Visual Studio
via one of the following forms:

location

location[,key=value]*

key=value[,key=value]*

The location specifies the absolute path to the top-level directory
of the VS installation.

The key=value pairs form a comma-separated list of options to
specify details of the instance selection.
Supported pairs are:

version=<major>.<minor>.<date>.<build>

New in version 3.23.

Specify the 4-component VS Build Version, a.k.a. Build Number.

The components are:

<major>.<minor>

The VS major and minor version numbers.
These are the same as the release version numbers.

<date>

A build date in the format MMMDD, where MMM is a month index
since an epoch used by Microsoft, and DD is a day in that month.

<build>

A build index on the day represented by <date>.

The build number is reported by vswhere as installationVersion.
For example, VS 16.11.10 has build number 16.11.32126.315.

New in version 3.23: A portable VS instance, which is not known to the Visual Studio Installer,
may be specified by providing both location and version=.

If the value of CMAKE_GENERATOR_INSTANCE is not specified explicitly
by the user or a toolchain file, CMake queries the Visual Studio Installer
to locate VS instances, chooses one, and sets the variable as a cache entry
to hold the value persistently.  If an environment variable of the form
VS##0COMNTOOLS, where ## the Visual Studio major version number,
is set and points to the Common7/Tools directory within one of the
VS instances, that instance will be used.  Otherwise, if more than one
VS instance is installed we do not define which one is chosen by default.

The VS version build number of the selected VS instance is provided in
the CMAKE_VS_VERSION_BUILD_NUMBER variable.

Table of Contents

CMAKE_GENERATOR_INSTANCE

Visual Studio Instance Selection

Previous topic

CMAKE_GENERATOR

Next topic

CMAKE_GENERATOR_PLATFORM

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-variables(7) »

CMAKE_GENERATOR_INSTANCE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.