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>CUDA_FATBIN_COMPILATION — 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="CUDA_OPTIX_COMPILATION" href="CUDA_OPTIX_COMPILATION.html" />
    <link rel="prev" title="CUDA_EXTENSIONS" href="CUDA_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_FATBIN_COMPILATION

CUDA_FATBIN_COMPILATION¶

New in version 3.27.

Compile CUDA sources to .fatbin files instead of .obj files
within Object Libraries.

For example:

add_library(myfbins OBJECT a.cu b.cu)
set_property(TARGET myfbins PROPERTY CUDA_FATBIN_COMPILATION ON)

Previous topic

CUDA_EXTENSIONS

Next topic

CUDA_OPTIX_COMPILATION

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-properties(7) »

CUDA_FATBIN_COMPILATION

        © 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>CUDA_OPTIX_COMPILATION — 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="CUDA_PTX_COMPILATION" href="CUDA_PTX_COMPILATION.html" />
    <link rel="prev" title="CUDA_FATBIN_COMPILATION" href="CUDA_FATBIN_COMPILATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_OPTIX_COMPILATION

CUDA_OPTIX_COMPILATION¶

New in version 3.27.

Compile CUDA sources to .optixir files instead of .obj files
within Object Libraries.

For example:

add_library(myoptix OBJECT a.cu b.cu)
set_property(TARGET myoptix PROPERTY CUDA_OPTIX_COMPILATION ON)

Previous topic

CUDA_FATBIN_COMPILATION

Next topic

CUDA_PTX_COMPILATION

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-properties(7) »

CUDA_OPTIX_COMPILATION

        © 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>CUDA_PTX_COMPILATION — 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="CUDA_RESOLVE_DEVICE_SYMBOLS" href="CUDA_RESOLVE_DEVICE_SYMBOLS.html" />
    <link rel="prev" title="CUDA_OPTIX_COMPILATION" href="CUDA_OPTIX_COMPILATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_PTX_COMPILATION

CUDA_PTX_COMPILATION¶

New in version 3.9.

Compile CUDA sources to .ptx files instead of .obj files
within Object Libraries.

For example:

add_library(myptx OBJECT a.cu b.cu)
set_property(TARGET myptx PROPERTY CUDA_PTX_COMPILATION ON)

Previous topic

CUDA_OPTIX_COMPILATION

Next topic

CUDA_RESOLVE_DEVICE_SYMBOLS

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-properties(7) »

CUDA_PTX_COMPILATION

        © 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>CUDA_RESOLVE_DEVICE_SYMBOLS — 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="CUDA_RUNTIME_LIBRARY" href="CUDA_RUNTIME_LIBRARY.html" />
    <link rel="prev" title="CUDA_PTX_COMPILATION" href="CUDA_PTX_COMPILATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_RESOLVE_DEVICE_SYMBOLS

CUDA_RESOLVE_DEVICE_SYMBOLS¶

New in version 3.9.

CUDA only: Enables device linking for the specific library target where
required.

If set, this will tell the required compilers to enable device linking
on the library target. Device linking is an additional link step
required by some CUDA compilers when CUDA_SEPARABLE_COMPILATION is
enabled. Normally device linking is deferred until a shared library or
executable is generated, allowing for multiple static libraries to resolve
device symbols at the same time when they are used by a shared library or
executable.

If this property or CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS is unset,
static libraries are treated as if it is disabled while shared, module,
and executable targets behave as if it is on.

If CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS has been defined,
this property is initialized to the value the variable and overriding
the default behavior.

Note that device linking is not supported for Object Libraries.

For instance:

set_property(TARGET mystaticlib PROPERTY CUDA_RESOLVE_DEVICE_SYMBOLS ON)

Previous topic

CUDA_PTX_COMPILATION

Next topic

CUDA_RUNTIME_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-properties(7) »

CUDA_RESOLVE_DEVICE_SYMBOLS

        © 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>CUDA_RUNTIME_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="CUDA_SEPARABLE_COMPILATION" href="CUDA_SEPARABLE_COMPILATION.html" />
    <link rel="prev" title="CUDA_RESOLVE_DEVICE_SYMBOLS" href="CUDA_RESOLVE_DEVICE_SYMBOLS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_RUNTIME_LIBRARY

CUDA_RUNTIME_LIBRARY¶

New in version 3.17.

Select the CUDA runtime library for use by compilers targeting the CUDA language.

The allowed case insensitive values are:

None

Link with -cudart=none or equivalent flag(s) to use no CUDA
runtime library.

Shared

Link with -cudart=shared or equivalent flag(s) to use a
dynamically-linked CUDA runtime library.

Static

Link with -cudart=static or equivalent flag(s) to use a
statically-linked CUDA runtime library.

Contents of CUDA_RUNTIME_LIBRARY may use
generator expressions.

If that property is not set then CMake uses an appropriate default
value based on the compiler to select the CUDA runtime library.

Note

This property has effect only when the CUDA language is enabled. To
control the CUDA runtime linking when only using the CUDA SDK with the
C or C++ language we recommend using the FindCUDAToolkit
module.

Previous topic

CUDA_RESOLVE_DEVICE_SYMBOLS

Next topic

CUDA_SEPARABLE_COMPILATION

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-properties(7) »

CUDA_RUNTIME_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>CUDA_SEPARABLE_COMPILATION — 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="CUDA_STANDARD" href="CUDA_STANDARD.html" />
    <link rel="prev" title="CUDA_RUNTIME_LIBRARY" href="CUDA_RUNTIME_LIBRARY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_SEPARABLE_COMPILATION

CUDA_SEPARABLE_COMPILATION¶

New in version 3.8.

CUDA only: Enables separate compilation of device code

If set this will enable separable compilation for all CUDA files for
the given target.

For instance:

set_property(TARGET myexe PROPERTY CUDA_SEPARABLE_COMPILATION ON)

This property is initialized by the value of the
CMAKE_CUDA_SEPARABLE_COMPILATION variable if it is set when a
target is created.

Previous topic

CUDA_RUNTIME_LIBRARY

Next topic

CUDA_STANDARD

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-properties(7) »

CUDA_SEPARABLE_COMPILATION

        © 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>CUDA_STANDARD — 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="CUDA_STANDARD_REQUIRED" href="CUDA_STANDARD_REQUIRED.html" />
    <link rel="prev" title="CUDA_SEPARABLE_COMPILATION" href="CUDA_SEPARABLE_COMPILATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_STANDARD

CUDA_STANDARD¶

New in version 3.8.

The CUDA/C++ standard whose features are requested to build this target.

This property specifies the CUDA/C++ standard whose features are requested
to build this target.  For some compilers, this results in adding a
flag such as -std=gnu++11 to the compile line.

Supported values are:

98

CUDA C++98. Note that this maps to the same as 03 internally.

03

CUDA C++03

11

CUDA C++11

14

CUDA C++14. While CMake 3.8 and later recognize 14 as a valid value,
CMake 3.9 was the first version to include support for any compiler.

17

CUDA C++17. While CMake 3.8 and later recognize 17 as a valid value,
CMake 3.18 was the first version to include support for any compiler.

20

New in version 3.12.

CUDA C++20. While CMake 3.12 and later recognize 20 as a valid value,
CMake 3.18 was the first version to include support for any compiler.

23

New in version 3.20.

CUDA C++23

26

New in version 3.25.

CUDA C++26. CMake 3.25 and later recognize 26 as a valid value,
no version has support for any compiler.

If the value requested does not result in a compile flag being added for
the compiler in use, a previous standard flag will be added instead.  This
means that using:

set_property(TARGET tgt PROPERTY CUDA_STANDARD 11)

with a compiler which does not support -std=gnu++11 or an equivalent
flag will not result in an error or warning, but will instead add the
-std=gnu++03 flag if supported.  This "decay" behavior may be controlled
with the CUDA_STANDARD_REQUIRED target property.
Additionally, the CUDA_EXTENSIONS target property may be used to
control whether compiler-specific extensions are enabled on a per-target basis.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_CUDA_STANDARD variable if it is set when a target
is created.

Previous topic

CUDA_SEPARABLE_COMPILATION

Next topic

CUDA_STANDARD_REQUIRED

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-properties(7) »

CUDA_STANDARD

        © 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>CUDA_STANDARD_REQUIRED — 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="CXX_EXTENSIONS" href="CXX_EXTENSIONS.html" />
    <link rel="prev" title="CUDA_STANDARD" href="CUDA_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CUDA_STANDARD_REQUIRED

CUDA_STANDARD_REQUIRED¶

New in version 3.8.

Boolean describing whether the value of CUDA_STANDARD is a requirement.

If this property is set to ON, then the value of the
CUDA_STANDARD target property is treated as a requirement.  If this
property is OFF or unset, the CUDA_STANDARD target property is
treated as optional and may "decay" to a previous standard if the requested is
not available.  For compilers that have no notion of a standard level, such as
MSVC 1800 (Visual Studio 2013) and lower, this has no effect.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_CUDA_STANDARD_REQUIRED variable if it is set when a
target is created.

Previous topic

CUDA_STANDARD

Next topic

CXX_EXTENSIONS

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-properties(7) »

CUDA_STANDARD_REQUIRED

        © 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>CXX_EXTENSIONS — 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="CXX_MODULE_DIRS" href="CXX_MODULE_DIRS.html" />
    <link rel="prev" title="CUDA_STANDARD_REQUIRED" href="CUDA_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_EXTENSIONS

CXX_EXTENSIONS¶

New in version 3.1.

Boolean specifying whether compiler specific extensions are requested.

This property specifies whether compiler specific extensions should be
used.  For some compilers, this results in adding a flag such
as -std=gnu++11 instead of -std=c++11 to the compile line.  This
property is ON by default. The basic C++ standard level is
controlled by the CXX_STANDARD target property.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_CXX_EXTENSIONS variable if set when a target is created
and otherwise by the value of
CMAKE_CXX_EXTENSIONS_DEFAULT (see
CMP0128).

Previous topic

CUDA_STANDARD_REQUIRED

Next topic

CXX_MODULE_DIRS

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-properties(7) »

CXX_EXTENSIONS

        © 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>CXX_MODULE_DIRS — 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="CXX_MODULE_DIRS_<NAME>" href="CXX_MODULE_DIRS_NAME.html" />
    <link rel="prev" title="CXX_EXTENSIONS" href="CXX_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_MODULE_DIRS

CXX_MODULE_DIRS¶

New in version 3.28.

Semicolon-separated list of base directories of the target's default
C++ module set (i.e. the file set with name and type CXX_MODULES). The
property supports
generator expressions.

This property is normally only set by target_sources(FILE_SET)
rather than being manipulated directly.

See CXX_MODULE_DIRS_<NAME> for the list of base directories in
other C++ module sets.

Previous topic

CXX_EXTENSIONS

Next topic

CXX_MODULE_DIRS_<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-properties(7) »

CXX_MODULE_DIRS

        © 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>CXX_MODULE_DIRS_<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="CXX_MODULE_SET" href="CXX_MODULE_SET.html" />
    <link rel="prev" title="CXX_MODULE_DIRS" href="CXX_MODULE_DIRS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_MODULE_DIRS_<NAME>

<span id="prop_tgt:CXX_MODULE_DIRS_<NAME>">
CXX_MODULE_DIRS_<NAME>¶

New in version 3.28.

Semicolon-separated list of base directories of the target's <NAME> C++
module set, which has the set type CXX_MODULES. The property supports
generator expressions.

This property is normally only set by target_sources(FILE_SET)
rather than being manipulated directly.

See CXX_MODULE_DIRS for the list of base directories in the
default C++ module set. See CXX_MODULE_SETS for the file set names
of all C++ module sets.

Previous topic

CXX_MODULE_DIRS

Next topic

CXX_MODULE_SET

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-properties(7) »

CXX_MODULE_DIRS_<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>CXX_MODULE_SET — 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="CXX_MODULE_SET_<NAME>" href="CXX_MODULE_SET_NAME.html" />
    <link rel="prev" title="CXX_MODULE_DIRS_<NAME>" href="CXX_MODULE_DIRS_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_MODULE_SET

CXX_MODULE_SET¶

New in version 3.28.

Semicolon-separated list of files in the target's default C++ module set,
(i.e. the file set with name and type CXX_MODULES). If any of the paths
are relative, they are computed relative to the target's source directory. The
property supports
generator expressions.

This property is normally only set by target_sources(FILE_SET)
rather than being manipulated directly.

See CXX_MODULE_SET_<NAME> for the list of files in other C++
module sets.

Previous topic

CXX_MODULE_DIRS_<NAME>

Next topic

CXX_MODULE_SET_<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-properties(7) »

CXX_MODULE_SET

        © 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>CXX_MODULE_SETS — 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="CXX_SCAN_FOR_MODULES" href="CXX_SCAN_FOR_MODULES.html" />
    <link rel="prev" title="CXX_MODULE_SET_<NAME>" href="CXX_MODULE_SET_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_MODULE_SETS

CXX_MODULE_SETS¶

New in version 3.28.

Read-only list of the target's PRIVATE and PUBLIC C++ module sets (i.e.
all file sets with the type CXX_MODULES). Files listed in these file sets
are treated as source files for the purpose of IDE integration.

C++ module sets may be defined using the target_sources() command
FILE_SET option with type CXX_MODULES.

See also CXX_MODULE_SET_<NAME>, CXX_MODULE_SET and
INTERFACE_CXX_MODULE_SETS.

Previous topic

CXX_MODULE_SET_<NAME>

Next topic

CXX_SCAN_FOR_MODULES

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-properties(7) »

CXX_MODULE_SETS

        © 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>CXX_MODULE_SET_<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="CXX_MODULE_SETS" href="CXX_MODULE_SETS.html" />
    <link rel="prev" title="CXX_MODULE_SET" href="CXX_MODULE_SET.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_MODULE_SET_<NAME>

<span id="prop_tgt:CXX_MODULE_SET_<NAME>">
CXX_MODULE_SET_<NAME>¶

New in version 3.28.

Semicolon-separated list of files in the target's <NAME> C++ module set,
which has the set type CXX_MODULES. If any of the paths are relative, they
are computed relative to the target's source directory. The property supports
generator expressions.

This property is normally only set by target_sources(FILE_SET)
rather than being manipulated directly.

See CXX_MODULE_SET for the list of files in the default C++ module
set. See CXX_MODULE_SETS for the file set names of all C++ module
sets.

Previous topic

CXX_MODULE_SET

Next topic

CXX_MODULE_SETS

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-properties(7) »

CXX_MODULE_SET_<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>CXX_SCAN_FOR_MODULES — 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="CXX_STANDARD" href="CXX_STANDARD.html" />
    <link rel="prev" title="CXX_MODULE_SETS" href="CXX_MODULE_SETS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_SCAN_FOR_MODULES

CXX_SCAN_FOR_MODULES¶

New in version 3.28.

CXX_SCAN_FOR_MODULES is a boolean specifying whether CMake will scan C++
sources in the target for module dependencies.  See also the
CXX_SCAN_FOR_MODULES for per-source settings which, if set,
overrides the target-wide settings.

This property is initialized by the value of the
CMAKE_CXX_SCAN_FOR_MODULES variable if it is set when a target is
created.

When this property is set ON or unset, CMake will scan the target's
CXX sources at build time and add module dependency information to the
compile line as necessary.  When this property is set OFF, CMake will not
scan the target's CXX sources at build time.

Note that scanning is only performed if C++20 or higher is enabled for the
target.  Scanning for modules in the target's sources belonging to file sets
of type CXX_MODULES is always performed.

Previous topic

CXX_MODULE_SETS

Next topic

CXX_STANDARD

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-properties(7) »

CXX_SCAN_FOR_MODULES

        © 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>CXX_STANDARD — 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="CXX_STANDARD_REQUIRED" href="CXX_STANDARD_REQUIRED.html" />
    <link rel="prev" title="CXX_SCAN_FOR_MODULES" href="CXX_SCAN_FOR_MODULES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_STANDARD

CXX_STANDARD¶

New in version 3.1.

The C++ standard whose features are requested to build this target.

This property specifies the C++ standard whose features are requested
to build this target.  For some compilers, this results in adding a
flag such as -std=gnu++11 to the compile line.  For compilers that
have no notion of a standard level, such as Microsoft Visual C++ before
2015 Update 3, this has no effect.

Supported values are:

98

C++98

11

C++11

14

C++14

17

New in version 3.8.

C++17

20

New in version 3.12.

C++20

23

New in version 3.20.

C++23

26

New in version 3.25.

C++26. CMake 3.25 and later recognize 26 as a valid value,
no version has support for any compiler.

If the value requested does not result in a compile flag being added for
the compiler in use, a previous standard flag will be added instead.  This
means that using:

set_property(TARGET tgt PROPERTY CXX_STANDARD 11)

with a compiler which does not support -std=gnu++11 or an equivalent
flag will not result in an error or warning, but will instead add the
-std=gnu++98 flag if supported.  This "decay" behavior may be controlled
with the CXX_STANDARD_REQUIRED target property.
Additionally, the CXX_EXTENSIONS target property may be used to
control whether compiler-specific extensions are enabled on a per-target basis.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_CXX_STANDARD variable if it is set when a target
is created.

Previous topic

CXX_SCAN_FOR_MODULES

Next topic

CXX_STANDARD_REQUIRED

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-properties(7) »

CXX_STANDARD

        © 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>CXX_STANDARD_REQUIRED — 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="DEBUG_POSTFIX" href="DEBUG_POSTFIX.html" />
    <link rel="prev" title="CXX_STANDARD" href="CXX_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

CXX_STANDARD_REQUIRED

CXX_STANDARD_REQUIRED¶

New in version 3.1.

Boolean describing whether the value of CXX_STANDARD is a requirement.

If this property is set to ON, then the value of the
CXX_STANDARD target property is treated as a requirement.  If this
property is OFF or unset, the CXX_STANDARD target property is
treated as optional and may "decay" to a previous standard if the requested is
not available.  For compilers that have no notion of a standard level, such as
MSVC 1800 (Visual Studio 2013) and lower, this has no effect.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_CXX_STANDARD_REQUIRED variable if it is set when a
target is created.

Previous topic

CXX_STANDARD

Next topic

DEBUG_POSTFIX

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-properties(7) »

CXX_STANDARD_REQUIRED

        © 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>C_EXTENSIONS — 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="C_STANDARD" href="C_STANDARD.html" />
    <link rel="prev" title="BUNDLE_EXTENSION" href="BUNDLE_EXTENSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

C_EXTENSIONS

C_EXTENSIONS¶

New in version 3.1.

Boolean specifying whether compiler specific extensions are requested.

This property specifies whether compiler specific extensions should be
used.  For some compilers, this results in adding a flag such
as -std=gnu11 instead of -std=c11 to the compile line.  This
property is ON by default. The basic C standard level is
controlled by the C_STANDARD target property.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_C_EXTENSIONS variable if set when a target is created and
otherwise by the value of
CMAKE_C_EXTENSIONS_DEFAULT (see
CMP0128).

Previous topic

BUNDLE_EXTENSION

Next topic

C_STANDARD

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-properties(7) »

C_EXTENSIONS

        © 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>C_STANDARD — 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="C_STANDARD_REQUIRED" href="C_STANDARD_REQUIRED.html" />
    <link rel="prev" title="C_EXTENSIONS" href="C_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

C_STANDARD

C_STANDARD¶

New in version 3.1.

The C standard whose features are requested to build this target.

This property specifies the C standard whose features are requested
to build this target.  For some compilers, this results in adding a
flag such as -std=gnu11 to the compile line.  For compilers that
have no notion of a C standard level, such as Microsoft Visual C++ before
VS 16.7, this property has no effect.

Supported values are:

90

C89/C90

99

C99

11

C11

17

New in version 3.21.

C17

23

New in version 3.21.

C23

If the value requested does not result in a compile flag being added for
the compiler in use, a previous standard flag will be added instead.  This
means that using:

set_property(TARGET tgt PROPERTY C_STANDARD 11)

with a compiler which does not support -std=gnu11 or an equivalent
flag will not result in an error or warning, but will instead add the
-std=gnu99 or -std=gnu90 flag if supported.  This "decay" behavior may
be controlled with the C_STANDARD_REQUIRED target property.
Additionally, the C_EXTENSIONS target property may be used to
control whether compiler-specific extensions are enabled on a per-target basis.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_C_STANDARD variable if it is set when a target
is created.

Previous topic

C_EXTENSIONS

Next topic

C_STANDARD_REQUIRED

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-properties(7) »

C_STANDARD

        © 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>C_STANDARD_REQUIRED — 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="COMMON_LANGUAGE_RUNTIME" href="COMMON_LANGUAGE_RUNTIME.html" />
    <link rel="prev" title="C_STANDARD" href="C_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

C_STANDARD_REQUIRED

C_STANDARD_REQUIRED¶

New in version 3.1.

Boolean describing whether the value of C_STANDARD is a requirement.

If this property is set to ON, then the value of the
C_STANDARD target property is treated as a requirement.  If this
property is OFF or unset, the C_STANDARD target property is
treated as optional and may "decay" to a previous standard if the requested is
not available.  For compilers that have no notion of a C standard level, such
as Microsoft Visual C++ before VS 16.7, this property has no effect.

See the cmake-compile-features(7) manual for information on
compile features and a list of supported compilers.

This property is initialized by the value of
the CMAKE_C_STANDARD_REQUIRED variable if it is set when a
target is created.

Previous topic

C_STANDARD

Next topic

COMMON_LANGUAGE_RUNTIME

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-properties(7) »

C_STANDARD_REQUIRED

        © 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>DEBUG_POSTFIX — 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="DEFINE_SYMBOL" href="DEFINE_SYMBOL.html" />
    <link rel="prev" title="CXX_STANDARD_REQUIRED" href="CXX_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DEBUG_POSTFIX

DEBUG_POSTFIX¶

See target property <CONFIG>_POSTFIX.

This property is a special case of the more-general <CONFIG>_POSTFIX
property for the DEBUG configuration.

Previous topic

CXX_STANDARD_REQUIRED

Next topic

DEFINE_SYMBOL

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-properties(7) »

DEBUG_POSTFIX

        © 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>DEFINE_SYMBOL — 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="DEPLOYMENT_ADDITIONAL_FILES" href="DEPLOYMENT_ADDITIONAL_FILES.html" />
    <link rel="prev" title="DEBUG_POSTFIX" href="DEBUG_POSTFIX.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DEFINE_SYMBOL

DEFINE_SYMBOL¶

Define a symbol when compiling this target's sources.

DEFINE_SYMBOL sets the name of the preprocessor symbol defined when
compiling sources in a shared library.  If not set here then it is set
to target_EXPORTS by default (with some substitutions if the target is
not a valid C identifier).  This is useful for headers to know whether
they are being included from inside their library or outside to
properly setup dllexport/dllimport decorations on Windows.

On POSIX platforms, this can optionally be used to control the visibility
of symbols.

CMake provides support for such decorations with the GenerateExportHeader
module.

Previous topic

DEBUG_POSTFIX

Next topic

DEPLOYMENT_ADDITIONAL_FILES

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-properties(7) »

DEFINE_SYMBOL

        © 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>DEPLOYMENT_ADDITIONAL_FILES — 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="DEPLOYMENT_REMOTE_DIRECTORY" href="DEPLOYMENT_REMOTE_DIRECTORY.html" />
    <link rel="prev" title="DEFINE_SYMBOL" href="DEFINE_SYMBOL.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DEPLOYMENT_ADDITIONAL_FILES

DEPLOYMENT_ADDITIONAL_FILES¶

New in version 3.13.

Set the WinCE project AdditionalFiles in DeploymentTool in .vcproj
files generated by the Visual Studio 9 2008 generator.
This is useful when you want to debug on remote WinCE device.
Specify additional files that will be copied to the device.
For example:

set_property(TARGET ${TARGET} PROPERTY
  DEPLOYMENT_ADDITIONAL_FILES "english.lng|local_folder|remote_folder|0"
  "german.lng|local_folder|remote_folder|0")

produces:

<DeploymentTool AdditionalFiles="english.lng|local_folder|remote_folder|0;german.lng|local_folder|remote_folder|0" ... />

Previous topic

DEFINE_SYMBOL

Next topic

DEPLOYMENT_REMOTE_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-properties(7) »

DEPLOYMENT_ADDITIONAL_FILES

        © 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>DEPLOYMENT_REMOTE_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="DEPRECATION" href="DEPRECATION.html" />
    <link rel="prev" title="DEPLOYMENT_ADDITIONAL_FILES" href="DEPLOYMENT_ADDITIONAL_FILES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DEPLOYMENT_REMOTE_DIRECTORY

DEPLOYMENT_REMOTE_DIRECTORY¶

New in version 3.6.

Set the WinCE project RemoteDirectory in DeploymentTool and
RemoteExecutable in DebuggerTool in .vcproj files generated
by the Visual Studio 9 2008 generator.
This is useful when you want to debug on remote WinCE device.
For example:

set_property(TARGET ${TARGET} PROPERTY
  DEPLOYMENT_REMOTE_DIRECTORY "\\FlashStorage")

produces:

<DeploymentTool RemoteDirectory="\FlashStorage" ... />
<DebuggerTool RemoteExecutable="\FlashStorage\target_file" ... />

Previous topic

DEPLOYMENT_ADDITIONAL_FILES

Next topic

DEPRECATION

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-properties(7) »

DEPLOYMENT_REMOTE_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>DEPRECATION — 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="DISABLE_PRECOMPILE_HEADERS" href="DISABLE_PRECOMPILE_HEADERS.html" />
    <link rel="prev" title="DEPLOYMENT_REMOTE_DIRECTORY" href="DEPLOYMENT_REMOTE_DIRECTORY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DEPRECATION

DEPRECATION¶

New in version 3.17.

Deprecation message from imported target's developer.

DEPRECATION is the message regarding a deprecation status to be displayed
to downstream users of a target.

The message is formatted as follows:

Lines that do not start in whitespace are wrapped as paragraph text.

Lines that start in whitespace are preserved as preformatted text.

Previous topic

DEPLOYMENT_REMOTE_DIRECTORY

Next topic

DISABLE_PRECOMPILE_HEADERS

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-properties(7) »

DEPRECATION

        © 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>DISABLE_PRECOMPILE_HEADERS — 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="DLL_NAME_WITH_SOVERSION" href="DLL_NAME_WITH_SOVERSION.html" />
    <link rel="prev" title="DEPRECATION" href="DEPRECATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DISABLE_PRECOMPILE_HEADERS

DISABLE_PRECOMPILE_HEADERS¶

New in version 3.16.

Disables the precompilation of header files specified by
PRECOMPILE_HEADERS property.

If the property is not set, CMake will use the value provided
by CMAKE_DISABLE_PRECOMPILE_HEADERS.

Previous topic

DEPRECATION

Next topic

DLL_NAME_WITH_SOVERSION

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-properties(7) »

DISABLE_PRECOMPILE_HEADERS

        © 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>DLL_NAME_WITH_SOVERSION — 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="DOTNET_SDK" href="DOTNET_SDK.html" />
    <link rel="prev" title="DISABLE_PRECOMPILE_HEADERS" href="DISABLE_PRECOMPILE_HEADERS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DLL_NAME_WITH_SOVERSION

DLL_NAME_WITH_SOVERSION¶

New in version 3.27.

This property controls whether the SOVERSION target
property is added to the filename of generated DLL filenames
for the Windows platform, which is selected when the
WIN32 variable is set.

The value of the listed property is appended to the
basename of the runtime component of the shared library
target as -<SOVERSION>.

Please note that setting this property has no effect
if versioned filenames are globally disabled with the
CMAKE_PLATFORM_NO_VERSIONED_SONAME variable.

Previous topic

DISABLE_PRECOMPILE_HEADERS

Next topic

DOTNET_SDK

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-properties(7) »

DLL_NAME_WITH_SOVERSION

        © 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>DOTNET_SDK — 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="DOTNET_TARGET_FRAMEWORK" href="DOTNET_TARGET_FRAMEWORK.html" />
    <link rel="prev" title="DLL_NAME_WITH_SOVERSION" href="DLL_NAME_WITH_SOVERSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DOTNET_SDK

DOTNET_SDK¶

New in version 3.23.

Specify the .NET SDK for C# projects.  For example: Microsoft.NET.Sdk.

This property tells Visual Studio Generators for VS 2019 and
above to generate a .NET SDK-style project using the specified SDK.
The property is meaningful only to these generators, and only in C#
targets.  It is ignored for C++ projects, even if they are managed
(e.g. using COMMON_LANGUAGE_RUNTIME).

This property must be a non-empty string to generate .NET SDK-style projects.
CMake does not perform any validations for the value of the property.

This property may be initialized for all targets using the
CMAKE_DOTNET_SDK variable.

Note

The Visual Studio Generators in this version of CMake have not
yet learned to support add_custom_command() in .NET SDK-style
projects.  It is currently an error to attach a custom command to a
target with the DOTNET_SDK property set.

Previous topic

DLL_NAME_WITH_SOVERSION

Next topic

DOTNET_TARGET_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-properties(7) »

DOTNET_SDK

        © 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>DOTNET_TARGET_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="DOTNET_TARGET_FRAMEWORK_VERSION" href="DOTNET_TARGET_FRAMEWORK_VERSION.html" />
    <link rel="prev" title="DOTNET_SDK" href="DOTNET_SDK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DOTNET_TARGET_FRAMEWORK

DOTNET_TARGET_FRAMEWORK¶

New in version 3.17.

Specify the .NET target framework.

Used to specify the .NET target framework for C++/CLI and C#.  For
example: netcoreapp2.1.

This property is only evaluated for Visual Studio Generators
VS 2010 and above.

Can be initialized for all targets using the variable
CMAKE_DOTNET_TARGET_FRAMEWORK.

Previous topic

DOTNET_SDK

Next topic

DOTNET_TARGET_FRAMEWORK_VERSION

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-properties(7) »

DOTNET_TARGET_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>DOTNET_TARGET_FRAMEWORK_VERSION — 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="EchoString" href="EchoString.html" />
    <link rel="prev" title="DOTNET_TARGET_FRAMEWORK" href="DOTNET_TARGET_FRAMEWORK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

DOTNET_TARGET_FRAMEWORK_VERSION

DOTNET_TARGET_FRAMEWORK_VERSION¶

New in version 3.12.

Specify the .NET target framework version.

Used to specify the .NET target framework version for C++/CLI and C#.
For example: v4.5.

This property is only evaluated for Visual Studio Generators
VS 2010 and above.

To initialize this variable for all targets set
CMAKE_DOTNET_TARGET_FRAMEWORK or
CMAKE_DOTNET_TARGET_FRAMEWORK_VERSION. If both are set,
the latter is ignored.

Previous topic

DOTNET_TARGET_FRAMEWORK

Next topic

EchoString

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-properties(7) »

DOTNET_TARGET_FRAMEWORK_VERSION

        © 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>ENABLE_EXPORTS — 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="EXCLUDE_FROM_ALL" href="EXCLUDE_FROM_ALL.html" />
    <link rel="prev" title="EchoString" href="EchoString.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

ENABLE_EXPORTS

ENABLE_EXPORTS¶

Specify whether an executable or a shared library exports symbols.

Normally an executable does not export any symbols because it is the
final program.  It is possible for an executable to export symbols to
be used by loadable modules.  When this property is set to true CMake
will allow other targets to "link" to the executable with the
target_link_libraries() command.  On all platforms a target-level
dependency on the executable is created for targets that link to it.
Handling of the executable on the link lines of the loadable modules
varies by platform:

On Windows-based systems (including Cygwin) an "import library" is
created along with the executable to list the exported symbols.
Loadable modules link to the import library to get the symbols.

On macOS, loadable modules link to the executable itself using the
-bundle_loader flag.

On AIX, a linker "import file" is created along with the executable
to list the exported symbols for import when linking other targets.
Loadable modules link to the import file to get the symbols.

On other platforms, loadable modules are simply linked without
referencing the executable since the dynamic loader will
automatically bind symbols when the module is loaded.

This property is initialized by the value of the
CMAKE_EXECUTABLE_ENABLE_EXPORTS variable, if it is set when an
executable target is created.  If CMAKE_EXECUTABLE_ENABLE_EXPORTS
is not set, the CMAKE_ENABLE_EXPORTS variable is used to initialize
the property instead for backward compatibility reasons.
See below for alternative initialization behavior for shared library targets.

New in version 3.27: To link with a shared library on macOS, or to a shared framework on any Apple
platform, a linker import file can be used instead of the actual shared
library. These linker import files are also known as text-based stubs, and
they have a .tbd file extension.

The generation of these linker import files, as well as their consumption, is
controlled by this property. When this property is set to true on a shared
library target, CMake will generate a .tbd file for the library.
Other targets that link to the shared library target will then use this
.tbd file when linking rather than linking to the shared library binary.

Note

For backward compatibility reasons, this property will be ignored if the
XCODE_ATTRIBUTE_GENERATE_TEXT_BASED_STUBS
target property or the
CMAKE_XCODE_ATTRIBUTE_GENERATE_TEXT_BASED_STUBS
variable is set to false.

For shared library targets, this property is initialized by the value of the
CMAKE_SHARED_LIBRARY_ENABLE_EXPORTS variable, if it is set when
the target is created.

Previous topic

EchoString

Next topic

EXCLUDE_FROM_ALL

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-properties(7) »

ENABLE_EXPORTS

        © 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>EXCLUDE_FROM_ALL — 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="EXCLUDE_FROM_DEFAULT_BUILD" href="EXCLUDE_FROM_DEFAULT_BUILD.html" />
    <link rel="prev" title="ENABLE_EXPORTS" href="ENABLE_EXPORTS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXCLUDE_FROM_ALL

EXCLUDE_FROM_ALL¶

Set this target property to a true (or false) value to exclude (or include)
the target from the "all" target of the containing directory and its
ancestors.  If excluded, running e.g. make in the containing directory
or its ancestors will not build the target by default.

If this target property is not set then the target will be included in
the "all" target of the containing directory.  Furthermore, it will be
included in the "all" target of its ancestor directories unless the
EXCLUDE_FROM_ALL directory property is set.

With EXCLUDE_FROM_ALL set to false or not set at all, the target
will be brought up to date as part of doing a make install or its
equivalent for the CMake generator being used.

If a target has EXCLUDE_FROM_ALL set to true, it may still be listed
in an install(TARGETS) command, but the user is responsible for
ensuring that the target's build artifacts are not missing or outdated when
an install is performed.

This property may use "generator expressions" with the syntax $<...>. See
the cmake-generator-expressions(7) manual for available expressions.

Only the "Ninja Multi-Config" generator supports a property value that varies by
configuration.  For all other generators the value of this property must be the
same for all configurations.

Previous topic

ENABLE_EXPORTS

Next topic

EXCLUDE_FROM_DEFAULT_BUILD

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-properties(7) »

EXCLUDE_FROM_ALL

        © 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>EXCLUDE_FROM_DEFAULT_BUILD — 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="EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>" href="EXCLUDE_FROM_DEFAULT_BUILD_CONFIG.html" />
    <link rel="prev" title="EXCLUDE_FROM_ALL" href="EXCLUDE_FROM_ALL.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXCLUDE_FROM_DEFAULT_BUILD

EXCLUDE_FROM_DEFAULT_BUILD¶

Exclude target from Build Solution.

This property is only used by Visual Studio generators.
When set to TRUE, the target will not be built when you press
Build Solution.

Previous topic

EXCLUDE_FROM_ALL

Next topic

EXCLUDE_FROM_DEFAULT_BUILD_<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-properties(7) »

EXCLUDE_FROM_DEFAULT_BUILD

        © 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>EXCLUDE_FROM_DEFAULT_BUILD_<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="EXPORT_COMPILE_COMMANDS" href="EXPORT_COMPILE_COMMANDS.html" />
    <link rel="prev" title="EXCLUDE_FROM_DEFAULT_BUILD" href="EXCLUDE_FROM_DEFAULT_BUILD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>

<span id="prop_tgt:EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>">
EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>¶

Per-configuration version of target exclusion from Build Solution.

This is the configuration-specific version of
EXCLUDE_FROM_DEFAULT_BUILD.  If the generic
EXCLUDE_FROM_DEFAULT_BUILD is also set on a target,
EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG> takes
precedence in configurations for which it has a value.

Previous topic

EXCLUDE_FROM_DEFAULT_BUILD

Next topic

EXPORT_COMPILE_COMMANDS

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-properties(7) »

EXCLUDE_FROM_DEFAULT_BUILD_<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>EXPORT_COMPILE_COMMANDS — 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="EXPORT_FIND_PACKAGE_NAME" href="EXPORT_FIND_PACKAGE_NAME.html" />
    <link rel="prev" title="EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>" href="EXCLUDE_FROM_DEFAULT_BUILD_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXPORT_COMPILE_COMMANDS

EXPORT_COMPILE_COMMANDS¶

New in version 3.20.

Enable/Disable output of compile commands during generation for a target.

This property is initialized by the value of the variable
CMAKE_EXPORT_COMPILE_COMMANDS if it is set when a target is created.

Previous topic

EXCLUDE_FROM_DEFAULT_BUILD_<CONFIG>

Next topic

EXPORT_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-properties(7) »

EXPORT_COMPILE_COMMANDS

        © 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>EXPORT_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="EXPORT_NAME" href="EXPORT_NAME.html" />
    <link rel="prev" title="EXPORT_COMPILE_COMMANDS" href="EXPORT_COMPILE_COMMANDS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXPORT_FIND_PACKAGE_NAME

EXPORT_FIND_PACKAGE_NAME¶

New in version 3.29.

Control the package name associated with a dependency target when exporting a
find_dependency() call in install(EXPORT) or
export(EXPORT). This can be used to assign a package name to a
package that is built by CMake and exported, or to override the package in the
find_package() call that created the target.

This property is initialized by CMAKE_EXPORT_FIND_PACKAGE_NAME.

Previous topic

EXPORT_COMPILE_COMMANDS

Next topic

EXPORT_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-properties(7) »

EXPORT_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>EXPORT_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="EXPORT_NO_SYSTEM" href="EXPORT_NO_SYSTEM.html" />
    <link rel="prev" title="EXPORT_FIND_PACKAGE_NAME" href="EXPORT_FIND_PACKAGE_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXPORT_NAME

EXPORT_NAME¶

Exported name for target files.

This sets the name for the IMPORTED target generated by the
install(EXPORT) and export() commands.
If not set, the logical target name is used by default.

Previous topic

EXPORT_FIND_PACKAGE_NAME

Next topic

EXPORT_NO_SYSTEM

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-properties(7) »

EXPORT_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>EXPORT_NO_SYSTEM — 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="EXPORT_PROPERTIES" href="EXPORT_PROPERTIES.html" />
    <link rel="prev" title="EXPORT_NAME" href="EXPORT_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXPORT_NO_SYSTEM

EXPORT_NO_SYSTEM¶

New in version 3.25.

This property affects the behavior of the install(EXPORT) and
export() commands when they install or export the target respectively.
When EXPORT_NO_SYSTEM is set to true, those commands generate an imported
target with SYSTEM property set to false.

See the NO_SYSTEM_FROM_IMPORTED target property to set this
behavior on the target consuming the include directories rather than the
one providing them.

Previous topic

EXPORT_NAME

Next topic

EXPORT_PROPERTIES

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-properties(7) »

EXPORT_NO_SYSTEM

        © 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>EXPORT_PROPERTIES — 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="FOLDER" href="FOLDER.html" />
    <link rel="prev" title="EXPORT_NO_SYSTEM" href="EXPORT_NO_SYSTEM.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EXPORT_PROPERTIES

EXPORT_PROPERTIES¶

New in version 3.12.

List additional properties to export for a target.

This property contains a list of property names that should be exported by
the install(EXPORT) and export() commands.  By default
only a limited number of properties are exported. This property can be used
to additionally export other properties as well.

Properties starting with INTERFACE_ or IMPORTED_ are not allowed as
they are reserved for internal CMake use.

Properties containing generator expressions are also not allowed.

Note

Since CMake 3.19, Interface Libraries may have arbitrary
target properties.  If a project exports an interface library
with custom properties, the resulting package may not work with
dependents configured by older versions of CMake that reject the
custom properties.

Previous topic

EXPORT_NO_SYSTEM

Next topic

FOLDER

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-properties(7) »

EXPORT_PROPERTIES

        © 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>EchoString — 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="ENABLE_EXPORTS" href="ENABLE_EXPORTS.html" />
    <link rel="prev" title="DOTNET_TARGET_FRAMEWORK_VERSION" href="DOTNET_TARGET_FRAMEWORK_VERSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

EchoString

EchoString¶

A message to be displayed when the target is built.

A message to display on some generators (such as Makefile Generators)
when the target is built.

Previous topic

DOTNET_TARGET_FRAMEWORK_VERSION

Next topic

ENABLE_EXPORTS

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-properties(7) »

EchoString

        © 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>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="Fortran_BUILDING_INSTRINSIC_MODULES" href="Fortran_BUILDING_INSTRINSIC_MODULES.html" />
    <link rel="prev" title="EXPORT_PROPERTIES" href="EXPORT_PROPERTIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

FOLDER

FOLDER¶

For IDEs that present targets using a folder hierarchy, this property
specifies the name of the folder to place the target under.
To nest folders, use FOLDER values such as GUI/Dialogs with /
characters separating folder levels.  Targets with no FOLDER property
will appear as top level entities.  Targets with the same FOLDER
property value will appear in the same folder as siblings.

Only some CMake generators honor the FOLDER property
(e.g. Xcode or any of the
Visual Studio generators).
Those generators that don't will simply ignore it.

This property is initialized by the value of the variable
CMAKE_FOLDER if it is set when a target is created.

The global property USE_FOLDERS must be set to true, otherwise
the FOLDER property is ignored.

Previous topic

EXPORT_PROPERTIES

Next topic

Fortran_BUILDING_INSTRINSIC_MODULES

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-properties(7) »

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>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="FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>" href="FRAMEWORK_MULTI_CONFIG_POSTFIX_CONFIG.html" />
    <link rel="prev" title="Fortran_PREPROCESS" href="Fortran_PREPROCESS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

FRAMEWORK

FRAMEWORK¶

Build SHARED or STATIC library as Framework Bundle on the macOS and iOS.

If such a library target has this property set to TRUE it will be
built as a framework when built on the macOS and iOS.  It will have the
directory structure required for a framework and will be suitable to
be used with the -framework option.  This property is initialized by the
value of the CMAKE_FRAMEWORK variable if it is set when a target is
created.

To customize Info.plist file in the framework, use
MACOSX_FRAMEWORK_INFO_PLIST target property.

For macOS see also the FRAMEWORK_VERSION target property.

Example of creation dynamicFramework:

add_library(dynamicFramework SHARED
            dynamicFramework.c
            dynamicFramework.h
)
set_target_properties(dynamicFramework PROPERTIES
  FRAMEWORK TRUE
  FRAMEWORK_VERSION C
  MACOSX_FRAMEWORK_IDENTIFIER com.cmake.dynamicFramework
  MACOSX_FRAMEWORK_INFO_PLIST Info.plist
  # "current version" in semantic format in Mach-O binary file
  VERSION 16.4.0
  # "compatibility version" in semantic format in Mach-O binary file
  SOVERSION 1.0.0
  PUBLIC_HEADER dynamicFramework.h
  XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "iPhone Developer"
)

Previous topic

Fortran_PREPROCESS

Next topic

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-properties(7) »

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>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="FRAMEWORK_VERSION" href="FRAMEWORK_VERSION.html" />
    <link rel="prev" title="FRAMEWORK" href="FRAMEWORK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>

<span id="prop_tgt:FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>">
FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>¶

New in version 3.18.

Postfix to append to the framework file name for configuration <CONFIG>,
when using a multi-config generator (like Xcode and Ninja Multi-Config).

When building with configuration <CONFIG> the value of this property
is appended to the framework file name built on disk.

For example, given a framework called my_fw, a value of _debug
for the FRAMEWORK_MULTI_CONFIG_POSTFIX_DEBUG property, and
Debug;Release in CMAKE_CONFIGURATION_TYPES, the following
relevant files would be created for the Debug and Release
configurations:

Release/my_fw.framework/my_fw

Release/my_fw.framework/Versions/A/my_fw

Debug/my_fw.framework/my_fw_debug

Debug/my_fw.framework/Versions/A/my_fw_debug

For framework targets, this property is initialized by the value of the
CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG> variable if it
is set when a target is created.

This property is ignored for non-framework targets, and when using single
config generators.

Previous topic

FRAMEWORK

Next topic

FRAMEWORK_VERSION

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-properties(7) »

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>FRAMEWORK_VERSION — 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="GENERATOR_FILE_NAME" href="GENERATOR_FILE_NAME.html" />
    <link rel="prev" title="FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>" href="FRAMEWORK_MULTI_CONFIG_POSTFIX_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

FRAMEWORK_VERSION

FRAMEWORK_VERSION¶

New in version 3.4.

Version of a framework created using the FRAMEWORK target
property (e.g. A).

This property only affects macOS, as iOS doesn't have versioned
directory structure.

Previous topic

FRAMEWORK_MULTI_CONFIG_POSTFIX_<CONFIG>

Next topic

GENERATOR_FILE_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-properties(7) »

FRAMEWORK_VERSION

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