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

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

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

ISPC_HEADER_SUFFIX

ISPC_HEADER_SUFFIX¶

New in version 3.19.2.

Specify output suffix to be used for ISPC generated headers provided by the target.

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

If the target contains ISPC source files, this specifies the header suffix to
be used for the generated headers.

The default value is _ispc.h.

Previous topic

ISPC_HEADER_DIRECTORY

Next topic

ISPC_INSTRUCTION_SETS

This Page

Show Source

Quick search

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

ISPC_HEADER_SUFFIX

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


code:
<!DOCTYPE html>

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

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

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

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

ISPC_INSTRUCTION_SETS

ISPC_INSTRUCTION_SETS¶

New in version 3.19.

List of instruction set architectures to generate code for.

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

The ISPC_INSTRUCTION_SETS target property must be used when generating for multiple
instruction sets so that CMake can track what object files will be generated.

Examples¶

set_property(TARGET tgt PROPERTY ISPC_INSTRUCTION_SETS avx2-i32x4 avx512skx-i32x835)

Generates code for avx2 and avx512skx target architectures.

Table of Contents

ISPC_INSTRUCTION_SETS

Examples

Previous topic

ISPC_HEADER_SUFFIX

Next topic

JOB_POOL_COMPILE

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

ISPC_INSTRUCTION_SETS

        © 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>JOB_POOL_COMPILE — 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="JOB_POOL_LINK" href="JOB_POOL_LINK.html" />
    <link rel="prev" title="ISPC_INSTRUCTION_SETS" href="ISPC_INSTRUCTION_SETS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

JOB_POOL_COMPILE

JOB_POOL_COMPILE¶

Ninja only: Pool used for compiling.

The number of parallel compile processes could be limited by defining
pools with the global JOB_POOLS
property and then specifying here the pool name.

For instance:

set_property(TARGET myexe PROPERTY JOB_POOL_COMPILE ten_jobs)

This property is initialized by the value of
CMAKE_JOB_POOL_COMPILE.

Previous topic

ISPC_INSTRUCTION_SETS

Next topic

JOB_POOL_LINK

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

JOB_POOL_COMPILE

        © 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>JOB_POOL_LINK — 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="JOB_POOL_PRECOMPILE_HEADER" href="JOB_POOL_PRECOMPILE_HEADER.html" />
    <link rel="prev" title="JOB_POOL_COMPILE" href="JOB_POOL_COMPILE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

JOB_POOL_LINK

JOB_POOL_LINK¶

Ninja only: Pool used for linking.

The number of parallel link processes could be limited by defining
pools with the global JOB_POOLS
property and then specifying here the pool name.

For instance:

set_property(TARGET myexe PROPERTY JOB_POOL_LINK two_jobs)

This property is initialized by the value of CMAKE_JOB_POOL_LINK.

Previous topic

JOB_POOL_COMPILE

Next topic

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

JOB_POOL_LINK

        © 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>JOB_POOL_PRECOMPILE_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="LABELS" href="LABELS.html" />
    <link rel="prev" title="JOB_POOL_LINK" href="JOB_POOL_LINK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

JOB_POOL_PRECOMPILE_HEADER

JOB_POOL_PRECOMPILE_HEADER¶

New in version 3.17.

Ninja only: Pool used for generating pre-compiled headers.

The number of parallel compile processes could be limited by defining
pools with the global JOB_POOLS
property and then specifying here the pool name.

For instance:

set_property(TARGET myexe PROPERTY JOB_POOL_PRECOMPILE_HEADER two_jobs)

This property is initialized by the value of
CMAKE_JOB_POOL_PRECOMPILE_HEADER.

If neither JOB_POOL_PRECOMPILE_HEADER nor
CMAKE_JOB_POOL_PRECOMPILE_HEADER are set then
JOB_POOL_COMPILE will be used for this task.

Previous topic

JOB_POOL_LINK

Next topic

LABELS

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

JOB_POOL_PRECOMPILE_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>LABELS — 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="<LANG>_CLANG_TIDY" href="LANG_CLANG_TIDY.html" />
    <link rel="prev" title="JOB_POOL_PRECOMPILE_HEADER" href="JOB_POOL_PRECOMPILE_HEADER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LABELS

LABELS¶

Specify a list of text labels associated with a target.

Target label semantics are currently unspecified.

Previous topic

JOB_POOL_PRECOMPILE_HEADER

Next topic

<LANG>_CLANG_TIDY

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

LABELS

        © 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><LANG>_CLANG_TIDY — 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="<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR" href="LANG_CLANG_TIDY_EXPORT_FIXES_DIR.html" />
    <link rel="prev" title="LABELS" href="LABELS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_CLANG_TIDY

<span id="prop_tgt:<LANG>_CLANG_TIDY">
<LANG>_CLANG_TIDY¶

New in version 3.6.

This property is implemented only when <LANG> is C, CXX, OBJC
or OBJCXX.

Specify a semicolon-separated list containing
a command line for the clang-tidy tool.  The Makefile Generators
and the Ninja generator will run this tool along with the
compiler and report a warning if the tool reports any problems.

The specified clang-tidy command line will be invoked with additional
arguments specifying the source file and, after --, the full compiler
command line.

Changed in version 3.25: If the specified clang-tidy command line includes the -p option,
it will be invoked without -- and the full compiler command line.
clang-tidy will look up the source file in the specified compiler
commands database.

This property is initialized by the value of
the CMAKE_<LANG>_CLANG_TIDY variable if it is set
when a target is created.

New in version 3.27: This property supports
generator expressions.

New in version 3.27: SKIP_LINTING can be set on individual source files to exclude
them from the linting tools defined by <LANG>_CPPLINT,
<LANG>_CLANG_TIDY, <LANG>_CPPCHECK, and
<LANG>_INCLUDE_WHAT_YOU_USE.  When SKIP_LINTING is
set to true on a source file, those tools will not be run on that specific
file.

Previous topic

LABELS

Next topic

<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR

This Page

Show Source

Quick search

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_CLANG_TIDY

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

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

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="<LANG>_COMPILER_LAUNCHER" href="LANG_COMPILER_LAUNCHER.html" />
    <link rel="prev" title="<LANG>_CLANG_TIDY" href="LANG_CLANG_TIDY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR

<span id="prop_tgt:<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR">
<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR¶

New in version 3.26.

This property is implemented only when <LANG> is C, CXX, OBJC
or OBJCXX, and only has an effect when <LANG>_CLANG_TIDY is
set.

Specify a directory for the clang-tidy tool to put .yaml files
containing its suggested changes in. This can be used for automated mass
refactoring by clang-tidy. Each object file that gets compiled will have a
corresponding .yaml file in this directory. After the build is completed,
you can run clang-apply-replacements on this directory to simultaneously
apply all suggested changes to the code base. If this property is not an
absolute directory, it is assumed to be relative to the target's binary
directory. This property should be preferred over adding an --export-fixes
or --fix argument directly to the <LANG>_CLANG_TIDY property.

When this property is set, CMake takes ownership of the specified directory,
and may create, modify, or delete files and directories within the directory
at any time during configure or build time. Users should use a dedicated
directory for exporting clang-tidy fixes to avoid having files deleted or
overwritten by CMake. Users should not create, modify, or delete files in this
directory.

This property is initialized by the value of
the CMAKE_<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR variable if it is set
when a target is created.

Previous topic

<LANG>_CLANG_TIDY

Next topic

<LANG>_COMPILER_LAUNCHER

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

<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR

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


code:
<!DOCTYPE html>

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

  <title><LANG>_COMPILER_LAUNCHER — 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="<LANG>_CPPCHECK" href="LANG_CPPCHECK.html" />
    <link rel="prev" title="<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR" href="LANG_CLANG_TIDY_EXPORT_FIXES_DIR.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_COMPILER_LAUNCHER

<span id="prop_tgt:<LANG>_COMPILER_LAUNCHER">
<LANG>_COMPILER_LAUNCHER¶

New in version 3.4.

This property is implemented only when <LANG> is C, CXX,
Fortran, HIP, ISPC, OBJC, OBJCXX, or CUDA.

Specify a semicolon-separated list containing a command line
for a compiler launching tool. The Makefile Generators and the
Ninja generator will run this tool and pass the compiler and
its arguments to the tool. Some example tools are distcc and ccache.

This property is initialized by the value of
the CMAKE_<LANG>_COMPILER_LAUNCHER variable if it is set
when a target is created.

New in version 3.25: The property value may use
generator expressions.

Previous topic

<LANG>_CLANG_TIDY_EXPORT_FIXES_DIR

Next topic

<LANG>_CPPCHECK

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

<LANG>_COMPILER_LAUNCHER

        © 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><LANG>_CPPCHECK — 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="<LANG>_CPPLINT" href="LANG_CPPLINT.html" />
    <link rel="prev" title="<LANG>_COMPILER_LAUNCHER" href="LANG_COMPILER_LAUNCHER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_CPPCHECK

<span id="prop_tgt:<LANG>_CPPCHECK">
<LANG>_CPPCHECK¶

New in version 3.10.

This property is supported only when <LANG> is C or CXX.

Specify a semicolon-separated list containing a command line
for the cppcheck static analysis tool.  The Makefile Generators
and the Ninja generator will run cppcheck along with the
compiler and report any problems.  If the command-line specifies the
exit code options to cppcheck then the build  will fail if the
tool returns non-zero.

This property is initialized by the value of the
CMAKE_<LANG>_CPPCHECK variable if it is set when a target is
created.

New in version 3.27: This property supports
generator expressions.

New in version 3.27: SKIP_LINTING can be set on individual source files to exclude
them from the linting tools defined by <LANG>_CPPLINT,
<LANG>_CLANG_TIDY, <LANG>_CPPCHECK, and
<LANG>_INCLUDE_WHAT_YOU_USE.  When SKIP_LINTING is
set to true on a source file, those tools will not be run on that specific
file.

Previous topic

<LANG>_COMPILER_LAUNCHER

Next topic

<LANG>_CPPLINT

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

<LANG>_CPPCHECK

        © 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><LANG>_CPPLINT — 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="<LANG>_EXTENSIONS" href="LANG_EXTENSIONS.html" />
    <link rel="prev" title="<LANG>_CPPCHECK" href="LANG_CPPCHECK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_CPPLINT

<span id="prop_tgt:<LANG>_CPPLINT">
<LANG>_CPPLINT¶

New in version 3.8.

This property is supported only when <LANG> is C or CXX.

Specify a semicolon-separated list containing a command line
for the cpplint style checker.  The Makefile Generators and the
Ninja generator will run cpplint along with the compiler
and report any problems.

This property is initialized by the value of the
CMAKE_<LANG>_CPPLINT variable if it is set when a target is
created.

New in version 3.27: This property supports
generator expressions.

New in version 3.27: SKIP_LINTING can be set on individual source files to exclude
them from the linting tools defined by <LANG>_CPPLINT,
<LANG>_CLANG_TIDY, <LANG>_CPPCHECK, and
<LANG>_INCLUDE_WHAT_YOU_USE.  When SKIP_LINTING is
set to true on a source file, those tools will not be run on that specific
file.

Previous topic

<LANG>_CPPCHECK

Next topic

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

<LANG>_CPPLINT

        © 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><LANG>_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="<LANG>_INCLUDE_WHAT_YOU_USE" href="LANG_INCLUDE_WHAT_YOU_USE.html" />
    <link rel="prev" title="<LANG>_CPPLINT" href="LANG_CPPLINT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_EXTENSIONS

<span id="prop_tgt:<LANG>_EXTENSIONS">
<LANG>_EXTENSIONS¶

The variations are:

C_EXTENSIONS

CXX_EXTENSIONS

CUDA_EXTENSIONS

HIP_EXTENSIONS

OBJC_EXTENSIONS

OBJCXX_EXTENSIONS

These properties specify whether compiler-specific extensions are requested.

These properties are initialized by the value of the
CMAKE_<LANG>_EXTENSIONS variable if it is set when a target is
created and otherwise by the value of
CMAKE_<LANG>_EXTENSIONS_DEFAULT (see CMP0128).

For supported CMake versions see the respective pages.
To control language standard versions see <LANG>_STANDARD.

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

Previous topic

<LANG>_CPPLINT

Next topic

<LANG>_INCLUDE_WHAT_YOU_USE

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

<LANG>_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><LANG>_INCLUDE_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="<LANG>_LINKER_LAUNCHER" href="LANG_LINKER_LAUNCHER.html" />
    <link rel="prev" title="<LANG>_EXTENSIONS" href="LANG_EXTENSIONS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_INCLUDE_WHAT_YOU_USE

<span id="prop_tgt:<LANG>_INCLUDE_WHAT_YOU_USE">
<LANG>_INCLUDE_WHAT_YOU_USE¶

New in version 3.3.

This property is implemented only when <LANG> is C or CXX.

Specify a semicolon-separated list containing a command
line for the include-what-you-use tool.  The Makefile Generators
and the Ninja generator will run this tool along with the
compiler and report a warning if the tool reports any problems.

This property is initialized by the value of
the CMAKE_<LANG>_INCLUDE_WHAT_YOU_USE variable if it is set
when a target is created.

New in version 3.27: This property supports
generator expressions.

New in version 3.27: SKIP_LINTING can be set on individual source files to exclude
them from the linting tools defined by <LANG>_CPPLINT,
<LANG>_CLANG_TIDY, <LANG>_CPPCHECK, and
<LANG>_INCLUDE_WHAT_YOU_USE.  When SKIP_LINTING is
set to true on a source file, those tools will not be run on that specific
file.

Previous topic

<LANG>_EXTENSIONS

Next topic

<LANG>_LINKER_LAUNCHER

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

<LANG>_INCLUDE_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><LANG>_LINKER_LAUNCHER — 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="<LANG>_STANDARD" href="LANG_STANDARD.html" />
    <link rel="prev" title="<LANG>_INCLUDE_WHAT_YOU_USE" href="LANG_INCLUDE_WHAT_YOU_USE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_LINKER_LAUNCHER

<span id="prop_tgt:<LANG>_LINKER_LAUNCHER">
<LANG>_LINKER_LAUNCHER¶

New in version 3.21.

This property is implemented only when <LANG> is C, CXX,
OBJC, or OBJCXX

Specify a semicolon-separated list containing a
command line for a linker launching tool. The Makefile Generators and the
Ninja generator will run this tool and pass the linker and its
arguments to the tool. This is useful for tools such as static analyzers.

This property is initialized by the value of the
CMAKE_<LANG>_LINKER_LAUNCHER variable if it is set when a target is
created.

New in version 3.27: The property value may use
generator expressions.

Previous topic

<LANG>_INCLUDE_WHAT_YOU_USE

Next topic

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

<LANG>_LINKER_LAUNCHER

        © 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><LANG>_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="<LANG>_STANDARD_REQUIRED" href="LANG_STANDARD_REQUIRED.html" />
    <link rel="prev" title="<LANG>_LINKER_LAUNCHER" href="LANG_LINKER_LAUNCHER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_STANDARD

<span id="prop_tgt:<LANG>_STANDARD">
<LANG>_STANDARD¶

The variations are:

C_STANDARD

CXX_STANDARD

CUDA_STANDARD

HIP_STANDARD

OBJC_STANDARD

OBJCXX_STANDARD

These properties specify language standard versions which are requested. When a
newer standard is specified than is supported by the compiler, then it will
fallback to the latest supported standard. This "decay" behavior may be
controlled with the <LANG>_STANDARD_REQUIRED target property.

Note that the actual language standard used may be higher than that specified
by <LANG>_STANDARD, regardless of the value of
<LANG>_STANDARD_REQUIRED.  In particular,
transitive usage requirements or the use of
compile features can raise the required
language standard above what <LANG>_STANDARD specifies.

These properties are initialized by the value of the
CMAKE_<LANG>_STANDARD variable if it is set when a target is
created.

For supported values and CMake versions see the respective pages.
To control compiler-specific extensions see <LANG>_EXTENSIONS.

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

Previous topic

<LANG>_LINKER_LAUNCHER

Next topic

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

<LANG>_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><LANG>_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="<LANG>_VISIBILITY_PRESET" href="LANG_VISIBILITY_PRESET.html" />
    <link rel="prev" title="<LANG>_STANDARD" href="LANG_STANDARD.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_STANDARD_REQUIRED

<span id="prop_tgt:<LANG>_STANDARD_REQUIRED">
<LANG>_STANDARD_REQUIRED¶

The variations are:

C_STANDARD_REQUIRED

CXX_STANDARD_REQUIRED

CUDA_STANDARD_REQUIRED

HIP_STANDARD_REQUIRED

OBJC_STANDARD_REQUIRED

OBJCXX_STANDARD_REQUIRED

These properties specify whether the value of <LANG>_STANDARD is a
requirement.  When false or unset, the <LANG>_STANDARD target
property is treated as optional and may "decay" to a previous standard if the
requested standard is not available.  When <LANG>_STANDARD_REQUIRED is set
to true, <LANG>_STANDARD becomes a hard requirement and a fatal
error will be issued if that requirement cannot be met.

Note that the actual language standard used may be higher than that specified
by <LANG>_STANDARD, regardless of the value of
<LANG>_STANDARD_REQUIRED.  In particular,
transitive usage requirements or the use of
compile features can raise the required
language standard above what <LANG>_STANDARD specifies.

These properties are initialized by the value of the
CMAKE_<LANG>_STANDARD_REQUIRED variable if it is set when a target
is created.

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

Previous topic

<LANG>_STANDARD

Next topic

<LANG>_VISIBILITY_PRESET

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

<LANG>_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><LANG>_VISIBILITY_PRESET — 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="LIBRARY_OUTPUT_DIRECTORY" href="LIBRARY_OUTPUT_DIRECTORY.html" />
    <link rel="prev" title="<LANG>_STANDARD_REQUIRED" href="LANG_STANDARD_REQUIRED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

<LANG>_VISIBILITY_PRESET

<span id="prop_tgt:<LANG>_VISIBILITY_PRESET">
<LANG>_VISIBILITY_PRESET¶

Value for symbol visibility compile flags

The <LANG>_VISIBILITY_PRESET property determines the value passed in a
visibility related compile option, such as -fvisibility= for <LANG>.
This property affects compilation in sources of all types of targets
(subject to policy CMP0063).

This property is initialized by the value of the
CMAKE_<LANG>_VISIBILITY_PRESET variable if it is set when a
target is created.

Previous topic

<LANG>_STANDARD_REQUIRED

Next topic

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

<LANG>_VISIBILITY_PRESET

        © 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>LIBRARY_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="LIBRARY_OUTPUT_DIRECTORY_<CONFIG>" href="LIBRARY_OUTPUT_DIRECTORY_CONFIG.html" />
    <link rel="prev" title="<LANG>_VISIBILITY_PRESET" href="LANG_VISIBILITY_PRESET.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LIBRARY_OUTPUT_DIRECTORY

LIBRARY_OUTPUT_DIRECTORY¶

Output directory in which to build LIBRARY target files.

This property specifies the directory into which library target files
should be built.  The property value may use
generator expressions.
Multi-configuration generators (Visual Studio,
Xcode, Ninja Multi-Config) 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_LIBRARY_OUTPUT_DIRECTORY variable if it is set when a target is created.

See also the LIBRARY_OUTPUT_DIRECTORY_<CONFIG> target property.

Previous topic

<LANG>_VISIBILITY_PRESET

Next topic

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

LIBRARY_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>LIBRARY_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="LIBRARY_OUTPUT_NAME" href="LIBRARY_OUTPUT_NAME.html" />
    <link rel="prev" title="LIBRARY_OUTPUT_DIRECTORY" href="LIBRARY_OUTPUT_DIRECTORY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LIBRARY_OUTPUT_DIRECTORY_<CONFIG>

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

Per-configuration output directory for
LIBRARY target files.

This is a per-configuration version of the
LIBRARY_OUTPUT_DIRECTORY target property, 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_LIBRARY_OUTPUT_DIRECTORY_<CONFIG> variable if
it is set when a target is created.

Contents of LIBRARY_OUTPUT_DIRECTORY_<CONFIG> may use
generator expressions.

Previous topic

LIBRARY_OUTPUT_DIRECTORY

Next topic

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

LIBRARY_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>LIBRARY_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="LIBRARY_OUTPUT_NAME_<CONFIG>" href="LIBRARY_OUTPUT_NAME_CONFIG.html" />
    <link rel="prev" title="LIBRARY_OUTPUT_DIRECTORY_<CONFIG>" href="LIBRARY_OUTPUT_DIRECTORY_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LIBRARY_OUTPUT_NAME

LIBRARY_OUTPUT_NAME¶

Output name for LIBRARY target files.

This property specifies the base name for library target files.  It
overrides OUTPUT_NAME and OUTPUT_NAME_<CONFIG>
properties.

See also the LIBRARY_OUTPUT_NAME_<CONFIG> target property.

Previous topic

LIBRARY_OUTPUT_DIRECTORY_<CONFIG>

Next topic

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

LIBRARY_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>LIBRARY_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="LINK_DEPENDS" href="LINK_DEPENDS.html" />
    <link rel="prev" title="LIBRARY_OUTPUT_NAME" href="LIBRARY_OUTPUT_NAME.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LIBRARY_OUTPUT_NAME_<CONFIG>

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

Per-configuration output name for
LIBRARY target files.

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

Previous topic

LIBRARY_OUTPUT_NAME

Next topic

LINK_DEPENDS

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

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINKER_LANGUAGE

LINKER_LANGUAGE¶

Specifies language whose compiler will invoke the linker.

For executables, shared libraries, and modules, this sets the language
whose compiler is used to link the target (such as "C" or "CXX").  A
typical value for an executable is the language of the source file
providing the program entry point (main).  If not set, the language
with the highest linker preference value is the default.  Details of
the linker preferences are considered internal, but some limited
discussion can be found under the internal
CMAKE_<LANG>_LINKER_PREFERENCE variables.

If this property is not set by the user, it will be calculated at
generate-time by CMake.

Previous topic

LINK_WHAT_YOU_USE

Next topic

LINKER_TYPE

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

LINKER_LANGUAGE

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINKER_TYPE

LINKER_TYPE¶

New in version 3.29.

Specify which linker will be used for the link step. The property value may use
generator expressions.

add_library(lib1 SHARED ...)
set_property(TARGET lib1 PROPERTY LINKER_TYPE LLD)

This specifies that lib1 should use linker type LLD for the link step.
The implementation details will be provided by the variable
CMAKE_<LANG>_USING_LINKER_<TYPE> with <TYPE> having the value
LLD.

This property is not supported on Green Hills MULTI and
Visual Studio 9 2008 generators.

Note

It is assumed that the linker specified is fully compatible with the standard
one. CMake will not do any options translation.

Linker types are case-sensitive and may only contain letters, numbers and
underscores. Linker types defined in all uppercase are reserved for CMake's own
built-in types. The pre-defined linker types are:

DEFAULT

This type corresponds to standard linking, essentially equivalent to
not specifying LINKER_TYPE target property.

SYSTEM

Use the standard linker delivered by the platform or the standard toolkit
(for example, SYSTEM imply Microsoft linker for all MSVC compatible
compilers). This type is supported for the following platforms/compilers:

Linux, for GNU, Clang, LLVMFlang and NVIDIA compilers.

All Apple variants for AppleClang, Clang and GNU compilers.

Windows, for MSVC, GNU, Clang and NVIDIA compilers.

LLD

Use the LLVM linker. This type is supported for the following
platforms/compilers:

Linux, for GNU, Clang, LLVMFlang and NVIDIA compilers.

All Apple variants for Clang and AppleClang compilers.

Windows, for GNU, Clang compilers with GNU front-end and
CLang, MSVC and NVIDIA compilers with MSVC front-end.

BFD

Use the GNU linker.  This type is supported for the following
platforms/compilers:

Linux, for GNU, Clang, LLVMFlang and NVIDIA compilers.

Windows, for GNU, Clang compilers with GNU front-end.

GOLD

Supported on Linux platform for GNU, Clang, LLVMFlang and
NVIDIA compilers.

MOLD

Use the mold linker. This type is
supported on the following platforms:

Linux platform for GNU, Clang, LLVMFlang and NVIDIA
compilers.

All Apple variants for Clang and AppleClang compilers as an
alias to SOLD.

SOLD

Use the sold linker. This type
is only supported on Apple platforms for Clang and AppleClang
compilers.

APPLE_CLASSIC

Use the Apple linker in the classic behavior (i.e. before Xcode 15.0).
This type is only supported on Apple platforms for GNU, Clang and
AppleClang compilers.

MSVC

Use the Microsoft linker. This type is only supported on Windows
platform for MSVC and Clang compiler with MSVC front-end.

Previous topic

LINKER_LANGUAGE

Next topic

LOCATION

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

LINKER_TYPE

        © 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>LINK_DEPENDS — 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="LINK_DEPENDS_NO_SHARED" href="LINK_DEPENDS_NO_SHARED.html" />
    <link rel="prev" title="LIBRARY_OUTPUT_NAME_<CONFIG>" href="LIBRARY_OUTPUT_NAME_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_DEPENDS

LINK_DEPENDS¶

Additional files on which a target binary depends for linking.

Specifies a semicolon-separated list of full-paths to files on which
the link rule for this target depends.  The target binary will be
linked if any of the named files is newer than it.

This property is supported only by Ninja and
Makefile Generators.  It is
intended to specify dependencies on "linker scripts" for custom Makefile link
rules.

Contents of LINK_DEPENDS may use "generator expressions" with
the syntax $<...>.  See the cmake-generator-expressions(7)
manual for available expressions.  See the cmake-buildsystem(7)
manual for more on defining buildsystem properties.

Previous topic

LIBRARY_OUTPUT_NAME_<CONFIG>

Next topic

LINK_DEPENDS_NO_SHARED

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_DEPENDS

        © 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>LINK_DEPENDS_NO_SHARED — 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="LINK_DIRECTORIES" href="LINK_DIRECTORIES.html" />
    <link rel="prev" title="LINK_DEPENDS" href="LINK_DEPENDS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_DEPENDS_NO_SHARED

LINK_DEPENDS_NO_SHARED¶

Do not depend on linked shared library files.

Set this property to true to tell CMake generators not to add
file-level dependencies on the shared library files linked by this
target.  Modification to the shared libraries will not be sufficient
to re-link this target.  Logical target-level dependencies will not be
affected so the linked shared libraries will still be brought up to
date before this target is built.

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

Previous topic

LINK_DEPENDS

Next topic

LINK_DIRECTORIES

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_DEPENDS_NO_SHARED

        © 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>LINK_DIRECTORIES — 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="LINK_FLAGS" href="LINK_FLAGS.html" />
    <link rel="prev" title="LINK_DEPENDS_NO_SHARED" href="LINK_DEPENDS_NO_SHARED.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_DIRECTORIES

LINK_DIRECTORIES¶

New in version 3.13.

List of directories to use for the link step of shared library, module
and executable targets.

This property holds a semicolon-separated list of directories
specified so far for its target.  Use the target_link_directories()
command to append more search directories.

This property is initialized by the LINK_DIRECTORIES directory
property when a target is created, and is used by the generators to set
the search directories for the linker.

Contents of LINK_DIRECTORIES may use "generator expressions" with the
syntax $<...>.  See the cmake-generator-expressions(7) manual
for available expressions.  See the cmake-buildsystem(7) manual
for more on defining buildsystem properties.

Previous topic

LINK_DEPENDS_NO_SHARED

Next topic

LINK_FLAGS

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_DIRECTORIES

        © 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>LINK_FLAGS — 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="LINK_FLAGS_<CONFIG>" href="LINK_FLAGS_CONFIG.html" />
    <link rel="prev" title="LINK_DIRECTORIES" href="LINK_DIRECTORIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_FLAGS

LINK_FLAGS¶

Additional flags to use when linking this target if it is a shared library,
module library, or an executable. Static libraries need to use
STATIC_LIBRARY_OPTIONS or STATIC_LIBRARY_FLAGS
properties.

The LINK_FLAGS property, managed as a string, can be used to add extra
flags to the link step of a target.  LINK_FLAGS_<CONFIG> will add
to the configuration <CONFIG>, for example, DEBUG, RELEASE,
MINSIZEREL, RELWITHDEBINFO, ...

Note

This property has been superseded by LINK_OPTIONS property.

Previous topic

LINK_DIRECTORIES

Next topic

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

LINK_FLAGS

        © 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>LINK_FLAGS_<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="LINK_INTERFACE_LIBRARIES" href="LINK_INTERFACE_LIBRARIES.html" />
    <link rel="prev" title="LINK_FLAGS" href="LINK_FLAGS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_FLAGS_<CONFIG>

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

Per-configuration linker flags for a SHARED library, MODULE or
EXECUTABLE target.

This is the configuration-specific version of LINK_FLAGS.

Note

This property has been superseded by LINK_OPTIONS property.

Previous topic

LINK_FLAGS

Next topic

LINK_INTERFACE_LIBRARIES

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_FLAGS_<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>LINK_INTERFACE_LIBRARIES — 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="LINK_INTERFACE_LIBRARIES_<CONFIG>" href="LINK_INTERFACE_LIBRARIES_CONFIG.html" />
    <link rel="prev" title="LINK_FLAGS_<CONFIG>" href="LINK_FLAGS_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_INTERFACE_LIBRARIES

LINK_INTERFACE_LIBRARIES¶

List public interface libraries for a shared library or executable.

By default linking to a shared library target transitively links to
targets with which the library itself was linked.  For an executable
with exports (see the ENABLE_EXPORTS target property) no
default transitive link dependencies are used.  This property replaces the default
transitive link dependencies with an explicit list.  When the target
is linked into another target using the target_link_libraries()
command, the libraries listed (and recursively
their link interface libraries) will be provided to the other target
also.  If the list is empty then no transitive link dependencies will
be incorporated when this target is linked into another target even if
the default set is non-empty.  This property is initialized by the
value of the CMAKE_LINK_INTERFACE_LIBRARIES variable if it is
set when a target is created.  This property is ignored for STATIC
libraries.

This property is overridden by the INTERFACE_LINK_LIBRARIES
property if policy CMP0022 is NEW.

This property is deprecated.  Use INTERFACE_LINK_LIBRARIES
instead.

Creating Relocatable Packages¶

Note that it is not advisable to populate the
LINK_INTERFACE_LIBRARIES of a target with absolute paths to dependencies.
That would hard-code into installed packages the library file paths
for dependencies as found on the machine the package was made on.

See the Creating Relocatable Packages section of the
cmake-packages(7) manual for discussion of additional care
that must be taken when specifying usage requirements while creating
packages for redistribution.

Table of Contents

LINK_INTERFACE_LIBRARIES

Creating Relocatable Packages

Previous topic

LINK_FLAGS_<CONFIG>

Next topic

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

LINK_INTERFACE_LIBRARIES

        © 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>LINK_INTERFACE_LIBRARIES_<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="LINK_INTERFACE_MULTIPLICITY" href="LINK_INTERFACE_MULTIPLICITY.html" />
    <link rel="prev" title="LINK_INTERFACE_LIBRARIES" href="LINK_INTERFACE_LIBRARIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_INTERFACE_LIBRARIES_<CONFIG>

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

Per-configuration list of public interface libraries for a target.

This is the configuration-specific version of
LINK_INTERFACE_LIBRARIES.  If set, this property completely
overrides the generic property for the named configuration.

This property is overridden by the INTERFACE_LINK_LIBRARIES
property if policy CMP0022 is NEW.

This property is deprecated.  Use INTERFACE_LINK_LIBRARIES
instead.

Creating Relocatable Packages¶

Note that it is not advisable to populate the
LINK_INTERFACE_LIBRARIES_<CONFIG> of a target with absolute paths to dependencies.
That would hard-code into installed packages the library file paths
for dependencies as found on the machine the package was made on.

See the Creating Relocatable Packages section of the
cmake-packages(7) manual for discussion of additional care
that must be taken when specifying usage requirements while creating
packages for redistribution.

Table of Contents

LINK_INTERFACE_LIBRARIES_<CONFIG>

Creating Relocatable Packages

Previous topic

LINK_INTERFACE_LIBRARIES

Next topic

LINK_INTERFACE_MULTIPLICITY

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_INTERFACE_LIBRARIES_<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>LINK_INTERFACE_MULTIPLICITY — 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="LINK_INTERFACE_MULTIPLICITY_<CONFIG>" href="LINK_INTERFACE_MULTIPLICITY_CONFIG.html" />
    <link rel="prev" title="LINK_INTERFACE_LIBRARIES_<CONFIG>" href="LINK_INTERFACE_LIBRARIES_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_INTERFACE_MULTIPLICITY

LINK_INTERFACE_MULTIPLICITY¶

Repetition count for STATIC libraries with cyclic dependencies.

When linking to a STATIC library target with cyclic dependencies the
linker may need to scan more than once through the archives in the
strongly connected component of the dependency graph.  CMake by
default constructs the link line so that the linker will scan through
the component at least twice.  This property specifies the minimum
number of scans if it is larger than the default.  CMake uses the
largest value specified by any target in a component.

Previous topic

LINK_INTERFACE_LIBRARIES_<CONFIG>

Next topic

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

LINK_INTERFACE_MULTIPLICITY

        © 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>LINK_INTERFACE_MULTIPLICITY_<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="LINK_LIBRARIES" href="LINK_LIBRARIES.html" />
    <link rel="prev" title="LINK_INTERFACE_MULTIPLICITY" href="LINK_INTERFACE_MULTIPLICITY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_INTERFACE_MULTIPLICITY_<CONFIG>

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

Per-configuration repetition count for cycles of STATIC libraries.

This is the configuration-specific version of
LINK_INTERFACE_MULTIPLICITY.  If set, this property completely
overrides the generic property for the named configuration.

Previous topic

LINK_INTERFACE_MULTIPLICITY

Next topic

LINK_LIBRARIES

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_INTERFACE_MULTIPLICITY_<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>LINK_LIBRARIES — 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="LINK_LIBRARIES_ONLY_TARGETS" href="LINK_LIBRARIES_ONLY_TARGETS.html" />
    <link rel="prev" title="LINK_INTERFACE_MULTIPLICITY_<CONFIG>" href="LINK_INTERFACE_MULTIPLICITY_CONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_LIBRARIES

LINK_LIBRARIES¶

List of direct link dependencies.

This property specifies the list of libraries or targets which will be
used for linking.  In addition to accepting values from the
target_link_libraries() command, values may be set directly on
any target using the set_property() command.

The value of this property is used by the generators to construct the
link rule for the target.  The direct link dependencies are linked first,
followed by indirect dependencies from the transitive closure of the
direct dependencies' INTERFACE_LINK_LIBRARIES properties.
See policy CMP0022.

Contents of LINK_LIBRARIES may use
generator expressions with the
syntax $<...>.  Policy CMP0131 affects the behavior of the
LINK_ONLY generator expression for this property.

See the cmake-buildsystem(7) manual for more on defining
buildsystem properties.

Note

A call to target_link_libraries(<target> ...) may update this
property on <target>.  If <target> was not created in the same
directory as the call then target_link_libraries() will wrap each
entry with the form ::@(directory-id);...;::@, where the ::@ is
literal and the (directory-id) is unspecified.
This tells the generators that the named libraries must be looked up in
the scope of the caller rather than in the scope in which the
<target> was created.  Valid directory ids are stripped on export
by the install(EXPORT) and export() commands.

In advanced use cases, the list of direct link dependencies specified
by this property may be updated by usage requirements from dependencies.
See the INTERFACE_LINK_LIBRARIES_DIRECT and
INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE target properties.

Previous topic

LINK_INTERFACE_MULTIPLICITY_<CONFIG>

Next topic

LINK_LIBRARIES_ONLY_TARGETS

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_LIBRARIES

        © 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>LINK_LIBRARIES_ONLY_TARGETS — 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="LINK_LIBRARY_OVERRIDE" href="LINK_LIBRARY_OVERRIDE.html" />
    <link rel="prev" title="LINK_LIBRARIES" href="LINK_LIBRARIES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_LIBRARIES_ONLY_TARGETS

LINK_LIBRARIES_ONLY_TARGETS¶

New in version 3.23.

Enforce that link items that can be target names are actually existing targets.

Set this property to a true value to enable additional checks on the contents
of the LINK_LIBRARIES and INTERFACE_LINK_LIBRARIES
target properties, typically populated by target_link_libraries().
Checks are also applied to libraries added to a target through the
INTERFACE_LINK_LIBRARIES_DIRECT properties of its dependencies.
CMake will verify that link items that might be target names actually name
existing targets.  An item is considered a possible target name if:

it does not contain a / or \, and

it does not start in -, and

(for historical reasons) it does not start in $ or `.

This property is initialized by the value of the
CMAKE_LINK_LIBRARIES_ONLY_TARGETS variable when a non-imported
target is created.  The property may be explicitly enabled on an imported
target to check its link interface.

In the following example, CMake will halt with an error at configure time
because miLib is not a target:

set(CMAKE_LINK_LIBRARIES_ONLY_TARGETS ON)
add_library(myLib STATIC myLib.c)
add_executable(myExe myExe.c)
target_link_libraries(myExe PRIVATE miLib) # typo for myLib

In order to link toolchain-provided libraries by name while still
enforcing LINK_LIBRARIES_ONLY_TARGETS, use an
imported
Interface Library with the
IMPORTED_LIBNAME target property:

add_library(toolchain::m INTERFACE IMPORTED)
set_property(TARGET toolchain::m PROPERTY IMPORTED_LIBNAME "m")
target_link_libraries(myExe PRIVATE toolchain::m)

See also policy CMP0028.

Note

If INTERFACE_LINK_LIBRARIES contains generator expressions,
its actual list of link items may depend on the type and properties of
the consuming target.  In such cases CMake may not always detect names
of missing targets that only appear for specific consumers.
A future version of CMake with improved heuristics may start triggering
errors on projects accepted by previous versions of CMake.

Previous topic

LINK_LIBRARIES

Next topic

LINK_LIBRARY_OVERRIDE

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_LIBRARIES_ONLY_TARGETS

        © 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>LINK_LIBRARY_OVERRIDE — 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="LINK_LIBRARY_OVERRIDE_<LIBRARY>" href="LINK_LIBRARY_OVERRIDE_LIBRARY.html" />
    <link rel="prev" title="LINK_LIBRARIES_ONLY_TARGETS" href="LINK_LIBRARIES_ONLY_TARGETS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_LIBRARY_OVERRIDE

LINK_LIBRARY_OVERRIDE¶

New in version 3.24.

Override the library features associated with libraries from
LINK_LIBRARY generator expressions.  This can be used to resolve
incompatible library features that result from specifying different features
for the same library in different LINK_LIBRARY generator expressions.

This property supports overriding multiple libraries and features. It expects
a semicolon-separated list, where each list item
has the following form:

feature[,link-item]*

For each comma-separated link-item, any existing library feature associated
with it will be ignored for the target this property is set on.  The item
will instead be associated with the specified feature.  Each link-item
can be anything that would be accepted as part of a library-list in a
LINK_LIBRARY generator expression.

add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)

target_link_libraries(lib1 PUBLIC "$<LINK_LIBRARY:feature1,external>")
target_link_libraries(lib2 PUBLIC "$<LINK_LIBRARY:feature2,lib1>")
target_link_libraries(lib3 PRIVATE lib1 lib2)

# lib1 is associated with both feature2 and no feature. Without any override,
# this would result in a fatal error at generation time for lib3.
# Define an override to resolve the incompatible feature associations.
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE "feature2,lib1,external")

# lib1 and external will now be associated with feature2 instead when linking lib3

It is also possible to override any feature with the pre-defined DEFAULT
library feature.  This effectively discards any feature for that link item,
for that target only (lib3 in this example):

# When linking lib3, discard any library feature for lib1, and use feature2 for external
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE
  "DEFAULT,lib1"
  "feature2,external"
)

The above example also demonstrates how to specify different feature overrides
for different link items.  See the LINK_LIBRARY_OVERRIDE_<LIBRARY>
target property for an alternative way of overriding library features for
individual libraries, which may be simpler in some cases.  If both properties
are defined and specify an override for the same link item,
LINK_LIBRARY_OVERRIDE_<LIBRARY> takes precedence over
LINK_LIBRARY_OVERRIDE.

Contents of LINK_LIBRARY_OVERRIDE may use
generator expressions.

For more information about library features, see the
CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE> and
CMAKE_LINK_LIBRARY_USING_<FEATURE> variables.

Previous topic

LINK_LIBRARIES_ONLY_TARGETS

Next topic

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

LINK_LIBRARY_OVERRIDE

        © 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>LINK_LIBRARY_OVERRIDE_<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="LINK_OPTIONS" href="LINK_OPTIONS.html" />
    <link rel="prev" title="LINK_LIBRARY_OVERRIDE" href="LINK_LIBRARY_OVERRIDE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_LIBRARY_OVERRIDE_<LIBRARY>

<span id="prop_tgt:LINK_LIBRARY_OVERRIDE_<LIBRARY>">
LINK_LIBRARY_OVERRIDE_<LIBRARY>¶

New in version 3.24.

Override the library feature associated with <LIBRARY> from
LINK_LIBRARY generator expressions.  This can be used to resolve
incompatible library features that result from specifying different features
for <LIBRARY> in different LINK_LIBRARY generator expressions.

When set on a target, this property holds a single library feature name, which
will be applied to <LIBRARY> when linking that target.

add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)

target_link_libraries(lib1 PUBLIC "$<LINK_LIBRARY:feature1,external>")
target_link_libraries(lib2 PUBLIC "$<LINK_LIBRARY:feature2,lib1>")
target_link_libraries(lib3 PRIVATE lib1 lib2)

# lib1 is associated with both feature2 and no feature. Without any override,
# this would result in a fatal error at generation time for lib3.
# Define an override to resolve the incompatible feature associations.
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE_lib1 feature2)

# lib1 will now be associated with feature2 instead when linking lib3

It is also possible to override any feature with the pre-defined DEFAULT
library feature.  This effectively discards any feature for that link item,
for that target only (lib3 in this example):

# When linking lib3, discard any library feature for lib1
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE_lib1 DEFAULT)

See the LINK_LIBRARY_OVERRIDE target property for an alternative
way of overriding library features for multiple libraries at once.  If both
properties are defined and specify an override for the same link item,
LINK_LIBRARY_OVERRIDE_<LIBRARY> takes precedence over
LINK_LIBRARY_OVERRIDE.

Contents of LINK_LIBRARY_OVERRIDE_<LIBRARY> may use
generator expressions.

For more information about library features, see the
CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE> and
CMAKE_LINK_LIBRARY_USING_<FEATURE> variables.

Previous topic

LINK_LIBRARY_OVERRIDE

Next topic

LINK_OPTIONS

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_LIBRARY_OVERRIDE_<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>LINK_OPTIONS — 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="LINK_SEARCH_END_STATIC" href="LINK_SEARCH_END_STATIC.html" />
    <link rel="prev" title="LINK_LIBRARY_OVERRIDE_<LIBRARY>" href="LINK_LIBRARY_OVERRIDE_LIBRARY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_OPTIONS

LINK_OPTIONS¶

New in version 3.13.

List of options to use for the link step of shared library, module
and executable targets as well as the device link step. Targets that are static
libraries need to use the STATIC_LIBRARY_OPTIONS target property.

These options are used for both normal linking and device linking
(see policy CMP0105). To control link options for normal and device
link steps, $<HOST_LINK> and $<DEVICE_LINK> generator
expressions can be used.

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

This property is initialized by the LINK_OPTIONS directory
property when a target is created, and is used by the generators to set
the options for the compiler.

Contents of LINK_OPTIONS may use "generator expressions" with the
syntax $<...>.  See the cmake-generator-expressions(7) manual
for available expressions.  See the cmake-buildsystem(7) manual
for more on defining buildsystem properties.

Note

This property must be used in preference to LINK_FLAGS property.

Host And Device Specific Link Options¶

New in version 3.18: When a device link step is involved, which is controlled by
CUDA_SEPARABLE_COMPILATION and
CUDA_RESOLVE_DEVICE_SYMBOLS properties and policy CMP0105,
the raw options will be delivered to the host and device link steps (wrapped in
-Xcompiler or equivalent for device link). Options wrapped with
$<DEVICE_LINK:...> generator expression will be used
only for the device link step. Options wrapped with $<HOST_LINK:...>
generator expression will be used only for the host link step.

Option De-duplication¶

The final set of options used for a target is constructed by
accumulating options from the current target and the usage requirements of
its dependencies.  The set of options is de-duplicated to avoid repetition.

New in version 3.12: While beneficial for individual options, the de-duplication step can break
up option groups.  For example, -option A -option B becomes
-option A B.  One may specify a group of options using shell-like
quoting along with a SHELL: prefix.  The SHELL: prefix is dropped,
and the rest of the option string is parsed using the
separate_arguments() UNIX_COMMAND mode. For example,
"SHELL:-option A" "SHELL:-option B" becomes -option A -option B.

Handling Compiler Driver Differences¶

To pass options to the linker tool, each compiler driver has its own syntax.
The LINKER: prefix and , separator can be used to specify, in a portable
way, options to pass to the linker tool. LINKER: is replaced by the
appropriate driver option and , by the appropriate driver separator.
The driver prefix and driver separator are given by the values of the
CMAKE_<LANG>_LINKER_WRAPPER_FLAG and
CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP variables.

For example, "LINKER:-z,defs" becomes -Xlinker -z -Xlinker defs for
Clang and -Wl,-z,defs for GNU GCC.

The LINKER: prefix can be specified as part of a SHELL: prefix
expression.

The LINKER: prefix supports, as an alternative syntax, specification of
arguments using the SHELL: prefix and space as separator. The previous
example then becomes "LINKER:SHELL:-z defs".

Note

Specifying the SHELL: prefix anywhere other than at the beginning of the
LINKER: prefix is not supported.

Table of Contents

LINK_OPTIONS

Host And Device Specific Link Options

Option De-duplication

Handling Compiler Driver Differences

Previous topic

LINK_LIBRARY_OVERRIDE_<LIBRARY>

Next topic

LINK_SEARCH_END_STATIC

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_OPTIONS

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_SEARCH_END_STATIC

LINK_SEARCH_END_STATIC¶

End a link line such that static system libraries are used.

Some linkers support switches such as -Bstatic and -Bdynamic to
determine whether to use static or shared libraries for -lXXX options.
CMake uses these options to set the link type for libraries whose full
paths are not known or (in some cases) are in implicit link
directories for the platform.  By default CMake adds an option at the
end of the library list (if necessary) to set the linker search type
back to its starting type.  This property switches the final linker
search type to -Bstatic regardless of how it started.

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

See also LINK_SEARCH_START_STATIC.

Previous topic

LINK_OPTIONS

Next topic

LINK_SEARCH_START_STATIC

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_SEARCH_END_STATIC

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

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

LINK_SEARCH_START_STATIC

LINK_SEARCH_START_STATIC¶

Assume the linker looks for static libraries by default.

Some linkers support switches such as -Bstatic and -Bdynamic to
determine whether to use static or shared libraries for -lXXX options.
CMake uses these options to set the link type for libraries whose full
paths are not known or (in some cases) are in implicit link
directories for the platform.  By default the linker search type is
assumed to be -Bdynamic at the beginning of the library list.  This
property switches the assumption to -Bstatic.  It is intended for use
when linking an executable statically (e.g. with the GNU -static
option).

This property is initialized by the value of the variable

CMAKE_LINK_SEARCH_START_STATIC if it is set
when a target is created.

See also LINK_SEARCH_END_STATIC.

Previous topic

LINK_SEARCH_END_STATIC

Next topic

LINK_WHAT_YOU_USE

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_SEARCH_START_STATIC

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