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>LINK_WHAT_YOU_USE — 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="LINKER_LANGUAGE" href="LINKER_LANGUAGE.html" />
    <link rel="prev" title="LINK_SEARCH_START_STATIC" href="LINK_SEARCH_START_STATIC.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_WHAT_YOU_USE

LINK_WHAT_YOU_USE¶

New in version 3.7.

This is a boolean option that, when set to TRUE, will automatically run
contents of variable CMAKE_LINK_WHAT_YOU_USE_CHECK on the target
after it is linked. In addition, the linker flag specified by variable
CMAKE_<LANG>_LINK_WHAT_YOU_USE_FLAG  will be passed to the target
with the link command so that all libraries specified on the command line will
be linked into the target. This will result in the link producing a list of
libraries that provide no symbols used by this target but are being linked to
it.

Note

For now, it is only supported for ELF platforms and is only applicable to
executable and shared or module library targets. This property will be
ignored for any other targets and configurations.

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

Previous topic

LINK_SEARCH_START_STATIC

Next topic

LINKER_LANGUAGE

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

LINK_WHAT_YOU_USE

        © 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>LOCATION — 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="LOCATION_<CONFIG>" href="LOCATION_CONFIG.html" />
    <link rel="prev" title="LINKER_TYPE" href="LINKER_TYPE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LOCATION

LOCATION¶

Read-only location of a target on disk.

For an imported target, this read-only property returns the value of
the LOCATION_<CONFIG> property for an unspecified configuration
<CONFIG> provided by the target.

For a non-imported target, this property is provided for compatibility
with CMake 2.4 and below.  It was meant to get the location of an
executable target's output file for use in add_custom_command().  The
path may contain a build-system-specific portion that is replaced at
build time with the configuration getting built (such as
$(ConfigurationName) in VS).  In CMake 2.6 and above
add_custom_command() automatically recognizes a target name in its
COMMAND and DEPENDS options and computes the target location.  In
CMake 2.8.4 and above add_custom_command() recognizes
generator expressions
to refer to target locations anywhere in the command.
Therefore this property is not needed for creating custom commands.

Do not set properties that affect the location of a target after
reading this property.  These include properties whose names match
(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?,
(IMPLIB_)?(PREFIX|SUFFIX), or "LINKER_LANGUAGE".  Failure to follow
this rule is not diagnosed and leaves the location of the target
undefined.

Previous topic

LINKER_TYPE

Next topic

LOCATION_<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) »

LOCATION

        © 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>LOCATION_<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="MACHO_COMPATIBILITY_VERSION" href="MACHO_COMPATIBILITY_VERSION.html" />
    <link rel="prev" title="LOCATION" href="LOCATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LOCATION_<CONFIG>

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

Read-only property providing a target location on disk.

A read-only property that indicates where a target's main file is
located on disk for the configuration <CONFIG>.  The property is
defined only for library and executable targets.  An imported target
may provide a set of configurations different from that of the
importing project.  By default CMake looks for an exact-match but
otherwise uses an arbitrary available configuration.  Use the
MAP_IMPORTED_CONFIG_<CONFIG> property to map imported
configurations explicitly.

Do not set properties that affect the location of a target after
reading this property.  These include properties whose names match
(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?,
(IMPLIB_)?(PREFIX|SUFFIX), or  LINKER_LANGUAGE.
Failure to follow this rule is not diagnosed and leaves
the location of the target undefined.

Previous topic

LOCATION

Next topic

MACHO_COMPATIBILITY_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) »

LOCATION_<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>MACHO_COMPATIBILITY_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="MACHO_CURRENT_VERSION" href="MACHO_CURRENT_VERSION.html" />
    <link rel="prev" title="LOCATION_<CONFIG>" href="LOCATION_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACHO_COMPATIBILITY_VERSION

MACHO_COMPATIBILITY_VERSION¶

New in version 3.17.

What compatibility version number is this target for Mach-O binaries.

For shared libraries on Mach-O systems (e.g. macOS, iOS)
the MACHO_COMPATIBILITY_VERSION property corresponds to the
compatibility version and MACHO_CURRENT_VERSION corresponds to
the current version.  These are both embedded in the shared library binary
and can be checked with the otool -L <binary> command.

It should be noted that the MACHO_CURRENT_VERSION and
MACHO_COMPATIBILITY_VERSION properties do not affect the file
names or version-related symlinks that CMake generates for the library.
The VERSION and SOVERSION target properties still
control the file and symlink names.  The install_name is also still
controlled by SOVERSION.

When MACHO_CURRENT_VERSION and MACHO_COMPATIBILITY_VERSION
are not given, VERSION and SOVERSION are used for
the version details to be embedded in the binaries respectively.
The MACHO_CURRENT_VERSION and MACHO_COMPATIBILITY_VERSION
properties only need to be given if the project needs to decouple the file
and symlink naming from the version details embedded in the binaries
(e.g. to match libtool conventions).

Previous topic

LOCATION_<CONFIG>

Next topic

MACHO_CURRENT_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) »

MACHO_COMPATIBILITY_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>MACHO_CURRENT_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="MACOSX_BUNDLE" href="MACOSX_BUNDLE.html" />
    <link rel="prev" title="MACHO_COMPATIBILITY_VERSION" href="MACHO_COMPATIBILITY_VERSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACHO_CURRENT_VERSION

MACHO_CURRENT_VERSION¶

New in version 3.17.

What current version number is this target for Mach-O binaries.

For shared libraries on Mach-O systems (e.g. macOS, iOS)
the MACHO_COMPATIBILITY_VERSION property corresponds to the
compatibility version and MACHO_CURRENT_VERSION corresponds to the
current version.  These are both embedded in the shared library binary
and can be checked with the otool -L <binary> command.

It should be noted that the MACHO_CURRENT_VERSION and
MACHO_COMPATIBILITY_VERSION properties do not affect the file
names or version-related symlinks that CMake generates for the library.
The VERSION and SOVERSION target properties still
control the file and symlink names.  The install_name is also still
controlled by SOVERSION.

When MACHO_CURRENT_VERSION and MACHO_COMPATIBILITY_VERSION
are not given, VERSION and SOVERSION are used for
the version details to be embedded in the binaries respectively.
The MACHO_CURRENT_VERSION and MACHO_COMPATIBILITY_VERSION
properties only need to be given if the project needs to decouple the file
and symlink naming from the version details embedded in the binaries
(e.g. to match libtool conventions).

Previous topic

MACHO_COMPATIBILITY_VERSION

Next topic

MACOSX_BUNDLE

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

MACHO_CURRENT_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>MACOSX_BUNDLE — 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="MACOSX_BUNDLE_INFO_PLIST" href="MACOSX_BUNDLE_INFO_PLIST.html" />
    <link rel="prev" title="MACHO_CURRENT_VERSION" href="MACHO_CURRENT_VERSION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACOSX_BUNDLE

MACOSX_BUNDLE¶

Build an executable as an Application Bundle on macOS or iOS.

When this property is set to TRUE the executable when built on macOS
or iOS will be created as an application bundle.  This makes it
a GUI executable that can be launched from the Finder.  See the
MACOSX_BUNDLE_INFO_PLIST target property for information about
creation of the Info.plist file for the application bundle.
This property is initialized by the value of the variable
CMAKE_MACOSX_BUNDLE if it is set when a target is created.

Previous topic

MACHO_CURRENT_VERSION

Next topic

MACOSX_BUNDLE_INFO_PLIST

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

MACOSX_BUNDLE

        © 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>MACOSX_BUNDLE_INFO_PLIST — 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="MACOSX_FRAMEWORK_INFO_PLIST" href="MACOSX_FRAMEWORK_INFO_PLIST.html" />
    <link rel="prev" title="MACOSX_BUNDLE" href="MACOSX_BUNDLE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACOSX_BUNDLE_INFO_PLIST

MACOSX_BUNDLE_INFO_PLIST¶

Specify a custom Info.plist template for a macOS and iOS Application Bundle.

An executable target with MACOSX_BUNDLE enabled will be built as an
application bundle on macOS.  By default its Info.plist file is created
by configuring a template called MacOSXBundleInfo.plist.in located in the
CMAKE_MODULE_PATH.  This property specifies an alternative template
file name which may be a full path.

The following target properties may be set to specify content to be
configured into the file:

MACOSX_BUNDLE_BUNDLE_NAME

Sets CFBundleName.

MACOSX_BUNDLE_BUNDLE_VERSION

Sets CFBundleVersion.

MACOSX_BUNDLE_COPYRIGHT

Sets NSHumanReadableCopyright.

MACOSX_BUNDLE_GUI_IDENTIFIER

Sets CFBundleIdentifier.

MACOSX_BUNDLE_ICON_FILE

Sets CFBundleIconFile.

MACOSX_BUNDLE_INFO_STRING

Sets CFBundleGetInfoString.

MACOSX_BUNDLE_LONG_VERSION_STRING

Sets CFBundleLongVersionString.

MACOSX_BUNDLE_SHORT_VERSION_STRING

Sets CFBundleShortVersionString.

CMake variables of the same name may be set to affect all targets in a
directory that do not have each specific property set.  If a custom
Info.plist is specified by this property it may of course hard-code
all the settings instead of using the target properties.

Previous topic

MACOSX_BUNDLE

Next topic

MACOSX_FRAMEWORK_INFO_PLIST

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

MACOSX_BUNDLE_INFO_PLIST

        © 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>MACOSX_FRAMEWORK_INFO_PLIST — 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="MACOSX_RPATH" href="MACOSX_RPATH.html" />
    <link rel="prev" title="MACOSX_BUNDLE_INFO_PLIST" href="MACOSX_BUNDLE_INFO_PLIST.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACOSX_FRAMEWORK_INFO_PLIST

MACOSX_FRAMEWORK_INFO_PLIST¶

Specify a custom Info.plist template for a macOS and iOS Framework.

A library target with FRAMEWORK enabled will be built as a
framework on macOS.  By default its Info.plist file is created by
configuring a template called MacOSXFrameworkInfo.plist.in located in the
CMAKE_MODULE_PATH.  This property specifies an alternative template
file name which may be a full path.

The following target properties may be set to specify content to be
configured into the file:

MACOSX_FRAMEWORK_BUNDLE_VERSION

Sets CFBundleVersion.

MACOSX_FRAMEWORK_ICON_FILE

Sets CFBundleIconFile.

MACOSX_FRAMEWORK_IDENTIFIER

Sets CFBundleIdentifier.

MACOSX_FRAMEWORK_SHORT_VERSION_STRING

Sets CFBundleShortVersionString.

CMake variables of the same name may be set to affect all targets in a
directory that do not have each specific property set.  If a custom
Info.plist is specified by this property it may of course hard-code
all the settings instead of using the target properties.

Previous topic

MACOSX_BUNDLE_INFO_PLIST

Next topic

MACOSX_RPATH

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

MACOSX_FRAMEWORK_INFO_PLIST

        © 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>MACOSX_RPATH — 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="MANUALLY_ADDED_DEPENDENCIES" href="MANUALLY_ADDED_DEPENDENCIES.html" />
    <link rel="prev" title="MACOSX_FRAMEWORK_INFO_PLIST" href="MACOSX_FRAMEWORK_INFO_PLIST.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MACOSX_RPATH

MACOSX_RPATH¶

Whether this target on macOS or iOS is located at runtime using rpaths.

When this property is set to TRUE, the directory portion of
the install_name field of this shared library will be @rpath
unless overridden by INSTALL_NAME_DIR.  This indicates
the shared library is to be found at runtime using runtime
paths (rpaths).

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

Runtime paths will also be embedded in binaries using this target and
can be controlled by the INSTALL_RPATH target property on
the target linking to this target.

Policy CMP0042 was introduced to change the default value of
MACOSX_RPATH to TRUE.  This is because use of @rpath is a
more flexible and powerful alternative to @executable_path and
@loader_path.

Previous topic

MACOSX_FRAMEWORK_INFO_PLIST

Next topic

MANUALLY_ADDED_DEPENDENCIES

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

MACOSX_RPATH

        © 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>MANUALLY_ADDED_DEPENDENCIES — 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="MAP_IMPORTED_CONFIG_<CONFIG>" href="MAP_IMPORTED_CONFIG_CONFIG.html" />
    <link rel="prev" title="MACOSX_RPATH" href="MACOSX_RPATH.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MANUALLY_ADDED_DEPENDENCIES

MANUALLY_ADDED_DEPENDENCIES¶

New in version 3.8.

Get manually added dependencies to other top-level targets.

This read-only property can be used to query all dependencies that
were added for this target with the add_dependencies()
command.

Previous topic

MACOSX_RPATH

Next topic

MAP_IMPORTED_CONFIG_<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) »

MANUALLY_ADDED_DEPENDENCIES

        © 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>MAP_IMPORTED_CONFIG_<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="MSVC_DEBUG_INFORMATION_FORMAT" href="MSVC_DEBUG_INFORMATION_FORMAT.html" />
    <link rel="prev" title="MANUALLY_ADDED_DEPENDENCIES" href="MANUALLY_ADDED_DEPENDENCIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MAP_IMPORTED_CONFIG_<CONFIG>

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

Map from project configuration to
imported target's configuration.

Set this to the list of configurations of an imported target that may
be used for the current project's <CONFIG> configuration.  Targets
imported from another project may not provide the same set of
configuration names available in the current project.  Setting this
property tells CMake what imported configurations are suitable for use
when building the <CONFIG> configuration.  The first configuration in
the list found to be provided by the imported target (i.e. via
IMPORTED_LOCATION_<CONFIG> for the mapped-to <CONFIG>)
is selected.  As a special case, an empty list element refers to the
configuration-less imported target location
(i.e. IMPORTED_LOCATION).

If this property is set and no matching configurations are available,
then the imported target is considered to be not found.  This property
is ignored for non-imported targets.

This property is initialized by the value of the
CMAKE_MAP_IMPORTED_CONFIG_<CONFIG> variable if it is set when a
target is created.

Example¶

For example creating imported C++ library foo:

add_library(foo STATIC IMPORTED)

Use foo_debug path for Debug build type:

set_property(
  TARGET foo APPEND PROPERTY IMPORTED_CONFIGURATIONS DEBUG
  )

set_target_properties(foo PROPERTIES
  IMPORTED_LINK_INTERFACE_LANGUAGES_DEBUG "CXX"
  IMPORTED_LOCATION_DEBUG "${foo_debug}"
  )

Use foo_release path for Release build type:

set_property(
  TARGET foo APPEND PROPERTY IMPORTED_CONFIGURATIONS RELEASE
  )

set_target_properties(foo PROPERTIES
  IMPORTED_LINK_INTERFACE_LANGUAGES_RELEASE "CXX"
  IMPORTED_LOCATION_RELEASE "${foo_release}"
  )

Use Release version of library for MinSizeRel and RelWithDebInfo
build types:

set_target_properties(foo PROPERTIES
  MAP_IMPORTED_CONFIG_MINSIZEREL Release
  MAP_IMPORTED_CONFIG_RELWITHDEBINFO Release
  )

Table of Contents

MAP_IMPORTED_CONFIG_<CONFIG>

Example

Previous topic

MANUALLY_ADDED_DEPENDENCIES

Next topic

MSVC_DEBUG_INFORMATION_FORMAT

This Page

Show Source

Quick search

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MAP_IMPORTED_CONFIG_<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>MSVC_DEBUG_INFORMATION_FORMAT — CMake 3.29.0-rc3 Documentation</title>

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

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MSVC_DEBUG_INFORMATION_FORMAT

MSVC_DEBUG_INFORMATION_FORMAT¶

New in version 3.25.

Select debug information format when targeting the MSVC ABI.

The allowed values are:

Embedded

Compile with -Z7 or equivalent flag(s) to produce object files
with full symbolic debugging information.

ProgramDatabase

Compile with -Zi or equivalent flag(s) to produce a program
database that contains all the symbolic debugging information.

EditAndContinue

Compile with -ZI or equivalent flag(s) to produce a program
database that supports the Edit and Continue feature.

The value is ignored on compilers not targeting the MSVC ABI, but an
unsupported value will be rejected as an error when using a compiler
targeting the MSVC ABI.

The value may also be the empty string (""), in which case no debug
information format flag will be added explicitly by CMake.

Use generator expressions to
support per-configuration specification.  For example, the code:

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  MSVC_DEBUG_INFORMATION_FORMAT "$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>")

selects for the target foo the program database debug information format
for the Debug configuration.

This property is initialized from the value of the
CMAKE_MSVC_DEBUG_INFORMATION_FORMAT variable, if it is set.
If this property is not set, CMake selects a debug information format using
the default value $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>, if
supported by the compiler, and otherwise
$<$<CONFIG:Debug,RelWithDebInfo>:Embedded>.

Note

This property has effect only when policy CMP0141 is set to NEW
prior to the first project() or enable_language() command
that enables a language using a compiler targeting the MSVC ABI.

Previous topic

MAP_IMPORTED_CONFIG_<CONFIG>

Next topic

MSVC_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) »

MSVC_DEBUG_INFORMATION_FORMAT

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


code:
<!DOCTYPE html>

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

  <title>MSVC_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="NAME" href="NAME.html" />
    <link rel="prev" title="MSVC_DEBUG_INFORMATION_FORMAT" href="MSVC_DEBUG_INFORMATION_FORMAT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

MSVC_RUNTIME_LIBRARY

MSVC_RUNTIME_LIBRARY¶

New in version 3.15.

Select the MSVC runtime library for use by compilers targeting the MSVC ABI.

The allowed values are:

MultiThreaded

Compile with -MT or equivalent flag(s) to use a multi-threaded
statically-linked runtime library.

MultiThreadedDLL

Compile with -MD or equivalent flag(s) to use a multi-threaded
dynamically-linked runtime library.

MultiThreadedDebug

Compile with -MTd or equivalent flag(s) to use a multi-threaded
statically-linked runtime library.

MultiThreadedDebugDLL

Compile with -MDd or equivalent flag(s) to use a multi-threaded
dynamically-linked runtime library.

The value is ignored on compilers not targeting the MSVC ABI, but an
unsupported value will be rejected as an error when using a compiler
targeting the MSVC ABI.

The value may also be the empty string ("") in which case no runtime
library selection flag will be added explicitly by CMake.  Note that with
Visual Studio Generators the native build system may choose to
add its own default runtime library selection flag.

Use generator expressions to
support per-configuration specification.  For example, the code:

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

selects for the target foo a multi-threaded statically-linked runtime
library with or without debug information depending on the configuration.

The property is initialized from the value of the
CMAKE_MSVC_RUNTIME_LIBRARY variable, if it is set.
If the property is not set, then CMake uses the default value
MultiThreaded$<$<CONFIG:Debug>:Debug>DLL to select a MSVC runtime library.

Note

This property has effect only when policy CMP0091 is set to NEW
prior to the first project() or enable_language() command
that enables a language using a compiler targeting the MSVC ABI.

Previous topic

MSVC_DEBUG_INFORMATION_FORMAT

Next topic

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

MSVC_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>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="NO_SONAME" href="NO_SONAME.html" />
    <link rel="prev" title="MSVC_RUNTIME_LIBRARY" href="MSVC_RUNTIME_LIBRARY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

NAME

NAME¶

Logical name for the target.

Read-only logical name for the target as used by CMake.

Previous topic

MSVC_RUNTIME_LIBRARY

Next topic

NO_SONAME

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

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>NO_SONAME — 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="NO_SYSTEM_FROM_IMPORTED" href="NO_SYSTEM_FROM_IMPORTED.html" />
    <link rel="prev" title="NAME" href="NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

NO_SONAME

NO_SONAME¶

Whether to set soname when linking a shared library.

Enable this boolean property if a generated SHARED library
should not have soname set.  Default is to set soname on all
shared libraries as long as the platform supports it.
Generally, use this property only for leaf private libraries or
plugins.  If you use it on normal shared libraries which other targets
link against, on some platforms a linker will insert a full path to
the library (as specified at link time) into the dynamic section of
the dependent binary.  Therefore, once installed, dynamic loader may
eventually fail to locate the library for the binary.

Previous topic

NAME

Next topic

NO_SYSTEM_FROM_IMPORTED

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

NO_SONAME

        © 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>NO_SYSTEM_FROM_IMPORTED — 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="OBJC_EXTENSIONS" href="OBJC_EXTENSIONS.html" />
    <link rel="prev" title="NO_SONAME" href="NO_SONAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

NO_SYSTEM_FROM_IMPORTED

NO_SYSTEM_FROM_IMPORTED¶

Do not treat include directories from the interfaces of consumed
Imported Targets as system directories.

When the consumed target's SYSTEM property is set to true, the
contents of the INTERFACE_INCLUDE_DIRECTORIES target property are
treated as system includes or, on Apple platforms, when the target is a
framework, it will be treated as system.  By default, SYSTEM is
true for imported targets and false for other target types.  If the
NO_SYSTEM_FROM_IMPORTED property is set to true on a consuming target,
compilation of sources in that consuming target will not treat the contents of
the INTERFACE_INCLUDE_DIRECTORIES of consumed imported targets as
system includes, even if that imported target's SYSTEM property
is false.

Directories listed in the INTERFACE_SYSTEM_INCLUDE_DIRECTORIES
property of consumed targets are not affected by NO_SYSTEM_FROM_IMPORTED.
Those directories will always be treated as system include directories by
consumers.

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

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

Previous topic

NO_SONAME

Next topic

OBJC_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) »

NO_SYSTEM_FROM_IMPORTED

        © 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>OBJCXX_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="OBJCXX_STANDARD" href="OBJCXX_STANDARD.html" />
    <link rel="prev" title="OBJC_STANDARD_REQUIRED" href="OBJC_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJCXX_EXTENSIONS

OBJCXX_EXTENSIONS¶

New in version 3.16.

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 ObjC++ standard level is
controlled by the OBJCXX_STANDARD target property.

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

If the property is not set, and the project has set the CXX_EXTENSIONS,
the value of CXX_EXTENSIONS is set for OBJCXX_EXTENSIONS.

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

Previous topic

OBJC_STANDARD_REQUIRED

Next topic

OBJCXX_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) »

OBJCXX_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>OBJCXX_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="OBJCXX_STANDARD_REQUIRED" href="OBJCXX_STANDARD_REQUIRED.html" />
    <link rel="prev" title="OBJCXX_EXTENSIONS" href="OBJCXX_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJCXX_STANDARD

OBJCXX_STANDARD¶

New in version 3.16.

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

This property specifies the ObjC++ 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

Objective C++98

11

Objective C++11

14

Objective C++14

17

Objective C++17

20

Objective C++20

23

New in version 3.20.

Objective C++23

26

New in version 3.25.

Objective 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 OBJCXX_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 OBJCXX_STANDARD_REQUIRED target property.
Additionally, the OBJCXX_EXTENSIONS target property may be used to
control whether compiler-specific extensions are enabled on a per-target basis.

If the property is not set, and the project has set the CXX_STANDARD,
the value of CXX_STANDARD is set for OBJCXX_STANDARD.

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_OBJCXX_STANDARD variable if it is set when a target
is created.

Previous topic

OBJCXX_EXTENSIONS

Next topic

OBJCXX_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) »

OBJCXX_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>OBJCXX_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="OPTIMIZE_DEPENDENCIES" href="OPTIMIZE_DEPENDENCIES.html" />
    <link rel="prev" title="OBJCXX_STANDARD" href="OBJCXX_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJCXX_STANDARD_REQUIRED

OBJCXX_STANDARD_REQUIRED¶

New in version 3.16.

Boolean describing whether the value of OBJCXX_STANDARD is a requirement.

If this property is set to ON, then the value of the
OBJCXX_STANDARD target property is treated as a requirement.  If this
property is OFF or unset, the OBJCXX_STANDARD target property is
treated as optional and may "decay" to a previous standard if the requested is
not available.

If the property is not set, and the project has set the CXX_STANDARD_REQUIRED,
the value of CXX_STANDARD_REQUIRED is set for OBJCXX_STANDARD_REQUIRED.

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_OBJCXX_STANDARD_REQUIRED variable if it is set when a
target is created.

Previous topic

OBJCXX_STANDARD

Next topic

OPTIMIZE_DEPENDENCIES

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

OBJCXX_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>OBJC_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="OBJC_STANDARD" href="OBJC_STANDARD.html" />
    <link rel="prev" title="NO_SYSTEM_FROM_IMPORTED" href="NO_SYSTEM_FROM_IMPORTED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJC_EXTENSIONS

OBJC_EXTENSIONS¶

New in version 3.16.

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 OBJC standard level is
controlled by the OBJC_STANDARD target property.

If the property is not set, and the project has set the C_EXTENSIONS,
the value of C_EXTENSIONS is set for OBJC_EXTENSIONS.

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_OBJC_EXTENSIONS variable if set when a target is created
and otherwise by the value of
CMAKE_OBJC_EXTENSIONS_DEFAULT
(see CMP0128).

Previous topic

NO_SYSTEM_FROM_IMPORTED

Next topic

OBJC_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) »

OBJC_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>OBJC_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="OBJC_STANDARD_REQUIRED" href="OBJC_STANDARD_REQUIRED.html" />
    <link rel="prev" title="OBJC_EXTENSIONS" href="OBJC_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJC_STANDARD

OBJC_STANDARD¶

New in version 3.16.

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

This property specifies the OBJC 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.

Supported values are:

90

Objective C89/C90

99

Objective C99

11

Objective C11

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 OBJC_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 OBJC_STANDARD_REQUIRED target property.
Additionally, the OBJC_EXTENSIONS target property may be used to
control whether compiler-specific extensions are enabled on a per-target basis.

If the property is not set, and the project has set the C_STANDARD,
the value of C_STANDARD is set for OBJC_STANDARD.

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_OBJC_STANDARD variable if it is set when a target
is created.

Previous topic

OBJC_EXTENSIONS

Next topic

OBJC_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) »

OBJC_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>OBJC_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="OBJCXX_EXTENSIONS" href="OBJCXX_EXTENSIONS.html" />
    <link rel="prev" title="OBJC_STANDARD" href="OBJC_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OBJC_STANDARD_REQUIRED

OBJC_STANDARD_REQUIRED¶

New in version 3.16.

Boolean describing whether the value of OBJC_STANDARD is a requirement.

If this property is set to ON, then the value of the
OBJC_STANDARD target property is treated as a requirement.  If this
property is OFF or unset, the OBJC_STANDARD target property is
treated as optional and may "decay" to a previous standard if the requested is
not available.

If the property is not set, and the project has set the C_STANDARD_REQUIRED,
the value of C_STANDARD_REQUIRED is set for OBJC_STANDARD_REQUIRED.

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_OBJC_STANDARD_REQUIRED variable if it is set when a
target is created.

Previous topic

OBJC_STANDARD

Next topic

OBJCXX_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) »

OBJC_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>OPTIMIZE_DEPENDENCIES — 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="OSX_ARCHITECTURES" href="OSX_ARCHITECTURES.html" />
    <link rel="prev" title="OBJCXX_STANDARD_REQUIRED" href="OBJCXX_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OPTIMIZE_DEPENDENCIES

OPTIMIZE_DEPENDENCIES¶

New in version 3.19.

Activates dependency optimization of static and object libraries.

When this property is set to true, some dependencies for a static or object
library may be removed at generation time if they are not necessary to build
the library, since static and object libraries don't actually link against
anything.

If a static or object library has dependency optimization enabled, it first
discards all dependencies. Then, it looks through all of the direct and
indirect dependencies that it initially had, and adds them back if they meet
any of the following criteria:

The dependency was added to the library by add_dependencies().

The dependency was added to the library through a source file in the library
generated by a custom command that uses the dependency.

The dependency has any PRE_BUILD, PRE_LINK, or POST_BUILD custom
commands associated with it.

The dependency contains any source files that were generated by a custom
command.

The dependency contains any languages which produce side effects that are
relevant to the library. Currently, all languages except C, C++, Objective-C,
Objective-C++, assembly, and CUDA are assumed to produce side effects.
However, side effects from one language are assumed not to be relevant to
another (for example, a Fortran library is assumed to not have any side
effects that are relevant for a Swift library.)

As an example, assume you have a static Fortran library which depends on a
static C library, which in turn depends on a static Fortran library. The
top-level Fortran library has optimization enabled, but the middle C library
does not. If you build the top Fortran library, the bottom Fortran library will
also build, but not the middle C library, since the C library does not have any
side effects that are relevant for the Fortran library. However, if you build
the middle C library, the bottom Fortran library will also build, even though
it does not have any side effects that are relevant to the C library, since the
C library does not have optimization enabled.

This property is initialized by the value of the
CMAKE_OPTIMIZE_DEPENDENCIES variable when the target is created.

Previous topic

OBJCXX_STANDARD_REQUIRED

Next topic

OSX_ARCHITECTURES

This Page

Show Source

Quick search

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OPTIMIZE_DEPENDENCIES

        © 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>OSX_ARCHITECTURES — 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="OSX_ARCHITECTURES_<CONFIG>" href="OSX_ARCHITECTURES_CONFIG.html" />
    <link rel="prev" title="OPTIMIZE_DEPENDENCIES" href="OPTIMIZE_DEPENDENCIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OSX_ARCHITECTURES

OSX_ARCHITECTURES¶

Target specific architectures for macOS.

The OSX_ARCHITECTURES property sets the target binary architecture for
targets on macOS (-arch).  This property is initialized by the value of the
variable CMAKE_OSX_ARCHITECTURES if it is set when a target is
created.  Use OSX_ARCHITECTURES_<CONFIG> to set the binary
architectures on a per-configuration basis, where <CONFIG> is an
upper-case name (e.g. OSX_ARCHITECTURES_DEBUG).

Previous topic

OPTIMIZE_DEPENDENCIES

Next topic

OSX_ARCHITECTURES_<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) »

OSX_ARCHITECTURES

        © 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>OSX_ARCHITECTURES_<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="OUTPUT_NAME" href="OUTPUT_NAME.html" />
    <link rel="prev" title="OSX_ARCHITECTURES" href="OSX_ARCHITECTURES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OSX_ARCHITECTURES_<CONFIG>

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

Per-configuration macOS and iOS binary architectures for a target.

This property is the configuration-specific version of
OSX_ARCHITECTURES.

Previous topic

OSX_ARCHITECTURES

Next topic

OUTPUT_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) »

OSX_ARCHITECTURES_<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>OUTPUT_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="OUTPUT_NAME_<CONFIG>" href="OUTPUT_NAME_CONFIG.html" />
    <link rel="prev" title="OSX_ARCHITECTURES_<CONFIG>" href="OSX_ARCHITECTURES_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OUTPUT_NAME

OUTPUT_NAME¶

Output name for target files.

This sets the base name for output files created for an executable or
library target.  If not set, the logical target name is used by
default during generation. The value is not set by default during
configuration.

Contents of OUTPUT_NAME and the variants listed below may use
generator expressions.

See also the variants:

OUTPUT_NAME_<CONFIG>

ARCHIVE_OUTPUT_NAME_<CONFIG>

ARCHIVE_OUTPUT_NAME

LIBRARY_OUTPUT_NAME_<CONFIG>

LIBRARY_OUTPUT_NAME

RUNTIME_OUTPUT_NAME_<CONFIG>

RUNTIME_OUTPUT_NAME

Previous topic

OSX_ARCHITECTURES_<CONFIG>

Next topic

OUTPUT_NAME_<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) »

OUTPUT_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>OUTPUT_NAME_<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="PCH_INSTANTIATE_TEMPLATES" href="PCH_INSTANTIATE_TEMPLATES.html" />
    <link rel="prev" title="OUTPUT_NAME" href="OUTPUT_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

OUTPUT_NAME_<CONFIG>

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

Per-configuration target file base name.

This is the configuration-specific version of the OUTPUT_NAME
target property.

Previous topic

OUTPUT_NAME

Next topic

PCH_INSTANTIATE_TEMPLATES

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

OUTPUT_NAME_<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>PCH_INSTANTIATE_TEMPLATES — 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="PCH_WARN_INVALID" href="PCH_WARN_INVALID.html" />
    <link rel="prev" title="OUTPUT_NAME_<CONFIG>" href="OUTPUT_NAME_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PCH_INSTANTIATE_TEMPLATES

PCH_INSTANTIATE_TEMPLATES¶

New in version 3.19.

When this property is set to true, the precompiled header compiler options
will contain a flag to instantiate templates during the generation of the PCH
if supported. This can significantly improve compile times. Supported in Clang
since version 11.

This property is initialized by the value of the
CMAKE_PCH_INSTANTIATE_TEMPLATES variable if it is set when a target
is created.  If that variable is not set, the property defaults to ON.

Previous topic

OUTPUT_NAME_<CONFIG>

Next topic

PCH_WARN_INVALID

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

PCH_INSTANTIATE_TEMPLATES

        © 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>PCH_WARN_INVALID — 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="PDB_NAME" href="PDB_NAME.html" />
    <link rel="prev" title="PCH_INSTANTIATE_TEMPLATES" href="PCH_INSTANTIATE_TEMPLATES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PCH_WARN_INVALID

PCH_WARN_INVALID¶

New in version 3.18.

When this property is set to true, the precompile header compiler options
will contain a compiler flag which should warn about invalid precompiled
headers e.g. -Winvalid-pch for GNU compiler.

This property is initialized by the value of the
CMAKE_PCH_WARN_INVALID variable if it is set when a target is
created.  If that variable is not set, the property defaults to ON.

Previous topic

PCH_INSTANTIATE_TEMPLATES

Next topic

PDB_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) »

PCH_WARN_INVALID

        © 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>PDB_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="PDB_NAME_<CONFIG>" href="PDB_NAME_CONFIG.html" />
    <link rel="prev" title="PCH_WARN_INVALID" href="PCH_WARN_INVALID.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PDB_NAME

PDB_NAME¶

Output name for the MS debug symbol .pdb file generated by the
linker for an executable or shared library target.

This property specifies the base name for the debug symbols file.
If not set, the OUTPUT_NAME target property value or
logical target name is used by default.

Note

This property does not apply to STATIC library targets because no linker
is invoked to produce them so they have no linker-generated .pdb file
containing debug symbols.

The linker-generated program database files are specified by the
/pdb linker flag and are not the same as compiler-generated
program database files specified by the /Fd compiler flag.
Use the COMPILE_PDB_NAME property to specify the latter.

Previous topic

PCH_WARN_INVALID

Next topic

PDB_NAME_<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) »

PDB_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>PDB_NAME_<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="PDB_OUTPUT_DIRECTORY" href="PDB_OUTPUT_DIRECTORY.html" />
    <link rel="prev" title="PDB_NAME" href="PDB_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PDB_NAME_<CONFIG>

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

Per-configuration output name for the MS debug symbol .pdb file
generated by the linker for an executable or shared library target.

This is the configuration-specific version of PDB_NAME.

Note

This property does not apply to STATIC library targets because no linker
is invoked to produce them so they have no linker-generated .pdb file
containing debug symbols.

The linker-generated program database files are specified by the
/pdb linker flag and are not the same as compiler-generated
program database files specified by the /Fd compiler flag.
Use the COMPILE_PDB_NAME_<CONFIG> property to specify the latter.

Previous topic

PDB_NAME

Next topic

PDB_OUTPUT_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) »

PDB_NAME_<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>PDB_OUTPUT_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="PDB_OUTPUT_DIRECTORY_<CONFIG>" href="PDB_OUTPUT_DIRECTORY_CONFIG.html" />
    <link rel="prev" title="PDB_NAME_<CONFIG>" href="PDB_NAME_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PDB_OUTPUT_DIRECTORY

PDB_OUTPUT_DIRECTORY¶

Output directory for the MS debug symbols .pdb file
generated by the linker for an executable or shared library target.

This property specifies the directory into which the MS debug symbols
will be placed by the linker. The property value may use
generator expressions.
Multi-configuration generators append a per-configuration
subdirectory to the specified directory unless a generator expression
is used.

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

Note

This property does not apply to STATIC library targets because no linker
is invoked to produce them so they have no linker-generated .pdb file
containing debug symbols.

The linker-generated program database files are specified by the
/pdb linker flag and are not the same as compiler-generated
program database files specified by the /Fd compiler flag.
Use the COMPILE_PDB_OUTPUT_DIRECTORY property to specify the latter.

Previous topic

PDB_NAME_<CONFIG>

Next topic

PDB_OUTPUT_DIRECTORY_<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) »

PDB_OUTPUT_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>PDB_OUTPUT_DIRECTORY_<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="POSITION_INDEPENDENT_CODE" href="POSITION_INDEPENDENT_CODE.html" />
    <link rel="prev" title="PDB_OUTPUT_DIRECTORY" href="PDB_OUTPUT_DIRECTORY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PDB_OUTPUT_DIRECTORY_<CONFIG>

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

Per-configuration output directory for the MS debug symbol .pdb file
generated by the linker for an executable or shared library target.

This is a per-configuration version of PDB_OUTPUT_DIRECTORY,
but multi-configuration generators (Visual Studio Generators,
Xcode) do NOT append a
per-configuration subdirectory to the specified directory.  This
property is initialized by the value of the
CMAKE_PDB_OUTPUT_DIRECTORY_<CONFIG> variable if it is
set when a target is created.

Contents of PDB_OUTPUT_DIRECTORY_<CONFIG> may use
generator expressions.

Note

This property does not apply to STATIC library targets because no linker
is invoked to produce them so they have no linker-generated .pdb file
containing debug symbols.

The linker-generated program database files are specified by the
/pdb linker flag and are not the same as compiler-generated
program database files specified by the /Fd compiler flag.
Use the COMPILE_PDB_OUTPUT_DIRECTORY_<CONFIG> property to specify the latter.

Previous topic

PDB_OUTPUT_DIRECTORY

Next topic

POSITION_INDEPENDENT_CODE

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

PDB_OUTPUT_DIRECTORY_<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>POSITION_INDEPENDENT_CODE — 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="PRECOMPILE_HEADERS" href="PRECOMPILE_HEADERS.html" />
    <link rel="prev" title="PDB_OUTPUT_DIRECTORY_<CONFIG>" href="PDB_OUTPUT_DIRECTORY_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

POSITION_INDEPENDENT_CODE

POSITION_INDEPENDENT_CODE¶

Whether to create a position-independent target

The POSITION_INDEPENDENT_CODE property determines whether position
independent executables or shared libraries will be created.  This
property is True by default for SHARED and MODULE library
targets and False otherwise.  This property is initialized by the value
of the CMAKE_POSITION_INDEPENDENT_CODE variable  if it is set
when a target is created.

Note

For executable targets, the link step is controlled by the CMP0083
policy and the CheckPIESupported module.

Previous topic

PDB_OUTPUT_DIRECTORY_<CONFIG>

Next topic

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

POSITION_INDEPENDENT_CODE

        © 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>POST_INSTALL_SCRIPT — 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="PRE_INSTALL_SCRIPT" href="PRE_INSTALL_SCRIPT.html" />
    <link rel="prev" title="IOS_INSTALL_COMBINED" href="IOS_INSTALL_COMBINED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

POST_INSTALL_SCRIPT

POST_INSTALL_SCRIPT¶

Deprecated install support.

The PRE_INSTALL_SCRIPT and POST_INSTALL_SCRIPT properties are
the old way to specify CMake scripts to run before and after installing a
target.  They are used only when the old INSTALL_TARGETS command is
used to install the target.  Use the install() command instead.

Previous topic

IOS_INSTALL_COMBINED

Next topic

PRE_INSTALL_SCRIPT

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

POST_INSTALL_SCRIPT

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PRECOMPILE_HEADERS

PRECOMPILE_HEADERS¶

New in version 3.16.

List of header files to precompile.

This property holds a semicolon-separated list
of header files to precompile specified so far for its target.
Use the target_precompile_headers() command to append more header
files.

This property supports
generator expressions.

Previous topic

POSITION_INDEPENDENT_CODE

Next topic

PRECOMPILE_HEADERS_REUSE_FROM

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

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>PRECOMPILE_HEADERS_REUSE_FROM — 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="PREFIX" href="PREFIX.html" />
    <link rel="prev" title="PRECOMPILE_HEADERS" href="PRECOMPILE_HEADERS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PRECOMPILE_HEADERS_REUSE_FROM

PRECOMPILE_HEADERS_REUSE_FROM¶

New in version 3.16.

Target from which to reuse the precompiled headers build artifact.

See the second signature of target_precompile_headers() command
for more detailed information.

Previous topic

PRECOMPILE_HEADERS

Next topic

PREFIX

This Page

Show Source

Quick search

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PRECOMPILE_HEADERS_REUSE_FROM

        © 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>PREFIX — CMake 3.29.0-rc3 Documentation</title>

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

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PREFIX

PREFIX¶

What comes before the library name.

A target property that can be set to override the prefix (such as
lib) on a library name.

Previous topic

PRECOMPILE_HEADERS_REUSE_FROM

Next topic

PRIVATE_HEADER

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

PREFIX

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


code:
<!DOCTYPE html>

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

  <title>PRE_INSTALL_SCRIPT — 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="VS_WINRT_EXTENSIONS" href="VS_WINRT_EXTENSIONS.html" />
    <link rel="prev" title="POST_INSTALL_SCRIPT" href="POST_INSTALL_SCRIPT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PRE_INSTALL_SCRIPT

PRE_INSTALL_SCRIPT¶

Deprecated install support.

The PRE_INSTALL_SCRIPT and POST_INSTALL_SCRIPT properties are
the old way to specify CMake scripts to run before and after installing a
target.  They are used only when the old INSTALL_TARGETS command is
used to install the target.  Use the install() command instead.

Previous topic

POST_INSTALL_SCRIPT

Next topic

VS_WINRT_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) »

PRE_INSTALL_SCRIPT

        © 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>PRIVATE_HEADER — 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="PROJECT_LABEL" href="PROJECT_LABEL.html" />
    <link rel="prev" title="PREFIX" href="PREFIX.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PRIVATE_HEADER

PRIVATE_HEADER¶

Specify private header files in a FRAMEWORK shared library target.

Shared library targets marked with the FRAMEWORK property generate
frameworks on macOS, iOS and normal shared libraries on other platforms.
This property may be set to a list of header files to be placed in the
PrivateHeaders directory inside the framework folder.  On non-Apple
platforms these headers may be installed using the PRIVATE_HEADER
option to the install(TARGETS) command.

Previous topic

PREFIX

Next topic

PROJECT_LABEL

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

PRIVATE_HEADER

        © 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>PROJECT_LABEL — 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="PUBLIC_HEADER" href="PUBLIC_HEADER.html" />
    <link rel="prev" title="PRIVATE_HEADER" href="PRIVATE_HEADER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PROJECT_LABEL

PROJECT_LABEL¶

Change the name of a target in an IDE.

Can be used to change the name of the target in an IDE like Visual
Studio.

Previous topic

PRIVATE_HEADER

Next topic

PUBLIC_HEADER

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

PROJECT_LABEL

        © 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>PUBLIC_HEADER — 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="RESOURCE" href="RESOURCE.html" />
    <link rel="prev" title="PROJECT_LABEL" href="PROJECT_LABEL.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

PUBLIC_HEADER

PUBLIC_HEADER¶

Specify public header files in a FRAMEWORK shared library target.

Shared library targets marked with the FRAMEWORK property generate
frameworks on macOS, iOS and normal shared libraries on other platforms.
This property may be set to a list of header files to be placed in the
Headers directory inside the framework folder.  On non-Apple platforms
these headers may be installed using the PUBLIC_HEADER option to the
install(TARGETS) command.

Previous topic

PROJECT_LABEL

Next topic

RESOURCE

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

PUBLIC_HEADER

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