OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 add_compile_definitions.html	8.97 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_compile_options.html	13.11 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_custom_command.html	67.2 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_custom_target.html	26.7 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_definitions.html	9.72 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_dependencies.html	8.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_executable.html	20.23 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_library.html	43.25 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_link_options.html	17.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_subdirectory.html	8.85 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_test.html	17.09 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 aux_source_directory.html	6.45 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 block.html	13.15 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 break.html	5.97 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_command.html	10.66 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_name.html	6.43 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_host_system_information.html	38.46 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_language.html	59.74 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_minimum_required.html	13.56 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_parse_arguments.html	18.62 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_path.html	80.45 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_policy.html	23.14 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 configure_file.html	20.36 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 continue.html	6.15 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 create_test_sourcelist.html	7.61 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_build.html	14.87 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_configure.html	10.28 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_coverage.html	9.93 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_empty_binary_directory.html	5.54 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_memcheck.html	11.73 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_read_custom_files.html	5.78 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_run_script.html	6.72 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_sleep.html	5.66 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_start.html	14.68 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_submit.html	16.18 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_test.html	38.64 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_update.html	8.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_upload.html	6.7 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 define_property.html	15.53 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 else.html	5.35 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 elseif.html	5.44 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_language.html	10.08 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_testing.html	6.04 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endblock.html	5.66 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endforeach.html	5.88 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endfunction.html	5.85 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endif.html	5.71 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endmacro.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endwhile.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 exec_program.html	7.52 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 execute_process.html	20.95 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export.html	19.49 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export_library_dependencies.html	8.01 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 file.html	128.25 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_file.html	39.65 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_library.html	46.52 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_package.html	91.29 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_path.html	40.22 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_program.html	37.17 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 fltk_wrap_ui.html	5.8 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 foreach.html	18.65 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 function.html	12.42 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_cmake_property.html	8.05 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_directory_property.html	9.08 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_filename_component.html	12.57 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_property.html	15.95 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_source_file_property.html	11.47 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_target_property.html	9.1 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_test_property.html	8.06 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 if.html	41.89 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include.html	8.04 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_directories.html	10.54 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_external_msproject.html	8.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_guard.html	8.85 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_regular_expression.html	6.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install.html	126.44 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_files.html	9.13 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_programs.html	9.09 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_targets.html	7 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_directories.html	11.99 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_libraries.html	7.36 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 list.html	35.79 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_cache.html	6.78 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_command.html	6.61 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 macro.html	20.49 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 make_directory.html	5.77 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 mark_as_advanced.html	6.73 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 math.html	9.01 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 message.html	27.67 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 option.html	6.48 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 output_required_files.html	6.59 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 project.html	30.84 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_cpp.html	7.2 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_ui.html	7.43 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove.html	6 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove_definitions.html	6.15 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 return.html	16.06 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 separate_arguments.html	11.04 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set.html	18.35 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_directory_properties.html	7.58 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_property.html	17.74 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_source_files_properties.html	10.63 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_target_properties.html	8.33 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_tests_properties.html	7.98 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 site_name.html	5.46 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 source_group.html	10.97 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 string.html	64.24 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdir_depends.html	5.69 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdirs.html	7.51 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_definitions.html	16.09 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_features.html	14.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_options.html	18.02 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_include_directories.html	22.39 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_directories.html	16.03 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_libraries.html	60.83 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_options.html	23.66 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_precompile_headers.html	24.42 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_sources.html	38.35 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_compile.html	57.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_run.html	24.62 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 unset.html	9.21 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 use_mangled_mesa.html	5.91 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 utility_source.html	6.78 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_requires.html	6.84 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_watch.html	8.98 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 while.html	9.14 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 write_file.html	7.25 KB	04/04/2023 07:05:04 PM	rw-r--r--

Editing: target_sources.html

<!DOCTYPE html>

<title>target_sources &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="try_compile.html" title="try_compile"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="target_precompile_headers.html" title="target_precompile_headers"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" accesskey="U">cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">target_sources</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="target-sources">
<h1>target_sources<a class="headerlink" href="#target-sources" title="Permalink to this heading">¶</a></h1>
<div class="versionadded">
New in version 3.1.
</div>
Add sources to a target.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_sources(&lt;target&gt;
 &lt;INTERFACE|PUBLIC|PRIVATE&gt; [items1...]
 [&lt;INTERFACE|PUBLIC|PRIVATE&gt; [items2...] ...])
</pre></div>
</div>
Specifies sources to use when building a target and/or its dependents.
The named <code class="docutils literal notranslate">&lt;target&gt;</code> must have been created by a command such as
<a class="reference internal" href="add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a> or <a class="reference internal" href="add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a> or
<a class="reference internal" href="add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a> and must not be an
<a class="reference internal" href="../manual/cmake-buildsystem.7.html#alias-targets">ALIAS target</a>. The <code class="docutils literal notranslate">&lt;items&gt;</code> may use
<a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a>.
<div class="versionadded">
New in version 3.20: <code class="docutils literal notranslate">&lt;target&gt;</code> can be a custom target.
</div>
The <code class="docutils literal notranslate">INTERFACE</code>, <code class="docutils literal notranslate">PUBLIC</code> and <code class="docutils literal notranslate">PRIVATE</code> keywords are required to
specify the <a class="reference internal" href="../manual/cmake-buildsystem.7.html#target-usage-requirements">scope</a> of the source file paths
(<code class="docutils literal notranslate">&lt;items&gt;</code>) that follow them. <code class="docutils literal notranslate">PRIVATE</code> and <code class="docutils literal notranslate">PUBLIC</code> items will
populate the <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a> property of <code class="docutils literal notranslate">&lt;target&gt;</code>, which are used when
building the target itself. <code class="docutils literal notranslate">PUBLIC</code> and <code class="docutils literal notranslate">INTERFACE</code> items will populate the
<a class="reference internal" href="../prop_tgt/INTERFACE_SOURCES.html#prop_tgt:INTERFACE_SOURCES" title="INTERFACE_SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_SOURCES</code></a> property of <code class="docutils literal notranslate">&lt;target&gt;</code>, which are used
when building dependents. A target created by <a class="reference internal" href="add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>
can only have <code class="docutils literal notranslate">PRIVATE</code> scope.
Repeated calls for the same <code class="docutils literal notranslate">&lt;target&gt;</code> append items in the order called.
<div class="versionadded">
New in version 3.3: Allow exporting targets with <a class="reference internal" href="../prop_tgt/INTERFACE_SOURCES.html#prop_tgt:INTERFACE_SOURCES" title="INTERFACE_SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_SOURCES</code></a>.
</div>
<div class="versionadded">
New in version 3.11: Allow setting <code class="docutils literal notranslate">INTERFACE</code> items on
<a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">IMPORTED targets</a>.
</div>
<div class="versionchanged">
Changed in version 3.13: Relative source file paths are interpreted as being relative to the current
source directory (i.e. <a class="reference internal" href="../variable/CMAKE_CURRENT_SOURCE_DIR.html#variable:CMAKE_CURRENT_SOURCE_DIR" title="CMAKE_CURRENT_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_SOURCE_DIR</code></a>).
See policy <a class="reference internal" href="../policy/CMP0076.html#policy:CMP0076" title="CMP0076"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0076</code></a>.
</div>
A path that begins with a generator expression is left unmodified.
When a target's <a class="reference internal" href="../prop_tgt/SOURCE_DIR.html#prop_tgt:SOURCE_DIR" title="SOURCE_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCE_DIR</code></a> property differs from
<a class="reference internal" href="../variable/CMAKE_CURRENT_SOURCE_DIR.html#variable:CMAKE_CURRENT_SOURCE_DIR" title="CMAKE_CURRENT_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_SOURCE_DIR</code></a>, use absolute paths in generator
expressions to ensure the sources are correctly assigned to the target.
<div class="highlight-cmake notranslate"><div class="highlight"><pre># WRONG: starts with generator expression, but relative path used
target_sources(MyTarget PRIVATE &quot;$&lt;$&lt;CONFIG:Debug&gt;:dbgsrc.cpp&gt;&quot;)

# CORRECT: absolute path used inside the generator expression
target_sources(MyTarget PRIVATE &quot;$&lt;$&lt;CONFIG:Debug&gt;:${CMAKE_CURRENT_SOURCE_DIR}/dbgsrc.cpp&gt;&quot;)
</pre></div>
</div>
See the <a class="reference internal" href="../manual/cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-buildsystem(7)</code></a> manual for more on defining
buildsystem properties.
<section id="file-sets">
<h2>File Sets<a class="headerlink" href="#file-sets" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.23.
</div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_sources(&lt;target&gt;
 [&lt;INTERFACE|PUBLIC|PRIVATE&gt;
 [FILE_SET &lt;set&gt; [TYPE &lt;type&gt;] [BASE_DIRS &lt;dirs&gt;...] [FILES &lt;files&gt;...]]...
 ]...)
</pre></div>
</div>
Adds a file set to a target, or adds files to an existing file set. Targets
have zero or more named file sets. Each file set has a name, a type, a scope of
<code class="docutils literal notranslate">INTERFACE</code>, <code class="docutils literal notranslate">PUBLIC</code>, or <code class="docutils literal notranslate">PRIVATE</code>, one or more base directories, and
files within those directories. The acceptable types include:
<code class="docutils literal notranslate">HEADERS</code>
<blockquote>
<div>Sources intended to be used via a language's <code class="docutils literal notranslate">#include</code> mechanism.
</div></blockquote>
<code class="docutils literal notranslate">CXX_MODULES</code>
<blockquote>
<div><div class="admonition note">
Note
Experimental. Gated by <code class="docutils literal notranslate">CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API</code>
</div>
Sources which contain C++ interface module or partition units (i.e., those
using the <code class="docutils literal notranslate">export</code> keyword). This file set type may not have an
<code class="docutils literal notranslate">INTERFACE</code> scope except on <code class="docutils literal notranslate">IMPORTED</code> targets.
</div></blockquote>
<code class="docutils literal notranslate">CXX_MODULE_HEADER_UNITS</code>
<blockquote>
<div><div class="admonition note">
Note
Experimental. Gated by <code class="docutils literal notranslate">CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API</code>
</div>
C++ header sources which may be imported by other C++ source code. This file
set type may not have an <code class="docutils literal notranslate">INTERFACE</code> scope except on <code class="docutils literal notranslate">IMPORTED</code> targets.
</div></blockquote>
The optional default file sets are named after their type. The target may not
be a custom target or <a class="reference internal" href="../prop_tgt/FRAMEWORK.html#prop_tgt:FRAMEWORK" title="FRAMEWORK"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">FRAMEWORK</code></a> target.
Files in a <code class="docutils literal notranslate">PRIVATE</code> or <code class="docutils literal notranslate">PUBLIC</code> file set are marked as source files for
the purposes of IDE integration. Additionally, files in <code class="docutils literal notranslate">HEADERS</code> file sets
have their <a class="reference internal" href="../prop_sf/HEADER_FILE_ONLY.html#prop_sf:HEADER_FILE_ONLY" title="HEADER_FILE_ONLY"><code class="xref cmake cmake-prop_sf docutils literal notranslate">HEADER_FILE_ONLY</code></a> property set to <code class="docutils literal notranslate">TRUE</code>. Files in an
<code class="docutils literal notranslate">INTERFACE</code> or <code class="docutils literal notranslate">PUBLIC</code> file set can be installed with the
<a class="reference internal" href="install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(TARGETS)</code></a> command, and exported with the
<a class="reference internal" href="install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(EXPORT)</code></a> and <a class="reference internal" href="export.html#command:export" title="export"><code class="xref cmake cmake-command docutils literal notranslate">export()</code></a> commands.
Each <code class="docutils literal notranslate">target_sources(FILE_SET)</code> entry starts with <code class="docutils literal notranslate">INTERFACE</code>, <code class="docutils literal notranslate">PUBLIC</code>, or
<code class="docutils literal notranslate">PRIVATE</code> and accepts the following arguments:
<code class="docutils literal notranslate">FILE_SET &lt;set&gt;</code>
<blockquote>
<div>The name of the file set to create or add to. It must contain only letters,
numbers and underscores. Names starting with a capital letter are reserved
for built-in file sets predefined by CMake. The only predefined set names
are those matching the acceptable types. All other set names must not start
with a capital letter or
underscore.
</div></blockquote>
<code class="docutils literal notranslate">TYPE &lt;type&gt;</code>
<blockquote>
<div>Every file set is associated with a particular type of file. Only types
specified above may be used and it is an error to specify anything else. As
a special case, if the name of the file set is one of the types, the type
does not need to be specified and the <code class="docutils literal notranslate">TYPE &lt;type&gt;</code> arguments can be
omitted. For all other file set names, <code class="docutils literal notranslate">TYPE</code> is required.
</div></blockquote>
<code class="docutils literal notranslate">BASE_DIRS &lt;dirs&gt;...</code>
<blockquote>
<div>An optional list of base directories of the file set. Any relative path
is treated as relative to the current source directory
(i.e. <a class="reference internal" href="../variable/CMAKE_CURRENT_SOURCE_DIR.html#variable:CMAKE_CURRENT_SOURCE_DIR" title="CMAKE_CURRENT_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_SOURCE_DIR</code></a>). If no <code class="docutils literal notranslate">BASE_DIRS</code> are
specified when the file set is first created, the value of
<a class="reference internal" href="../variable/CMAKE_CURRENT_SOURCE_DIR.html#variable:CMAKE_CURRENT_SOURCE_DIR" title="CMAKE_CURRENT_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_SOURCE_DIR</code></a> is added. This argument supports
<a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a>.
No two base directories for a file set may be sub-directories of each other.
This requirement must be met across all base directories added to a file set,
not just those within a single call to <code class="docutils literal notranslate">target_sources()</code>.
</div></blockquote>
<code class="docutils literal notranslate">FILES &lt;files&gt;...</code>
<blockquote>
<div>An optional list of files to add to the file set. Each file must be in
one of the base directories, or a subdirectory of one of the base
directories. This argument supports
<a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a>.
If relative paths are specified, they are considered relative to
<a class="reference internal" href="../variable/CMAKE_CURRENT_SOURCE_DIR.html#variable:CMAKE_CURRENT_SOURCE_DIR" title="CMAKE_CURRENT_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_SOURCE_DIR</code></a> at the time <code class="docutils literal notranslate">target_sources()</code> is
called. An exception to this is a path starting with <code class="docutils literal notranslate">$&lt;</code>. Such paths
are treated as relative to the target's source directory after evaluation
of generator expressions.
</div></blockquote>
The following target properties are set by <code class="docutils literal notranslate">target_sources(FILE_SET)</code>,
but they should not generally be manipulated directly:
For file sets of type <code class="docutils literal notranslate">HEADERS</code>:
<ul class="simple">
<li><a class="reference internal" href="../prop_tgt/HEADER_SETS.html#prop_tgt:HEADER_SETS" title="HEADER_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/INTERFACE_HEADER_SETS.html#prop_tgt:INTERFACE_HEADER_SETS" title="INTERFACE_HEADER_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_HEADER_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/HEADER_SET.html#prop_tgt:HEADER_SET" title="HEADER_SET"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_SET</code></a></li>
<li><a class="reference internal" href="../prop_tgt/HEADER_SET_NAME.html#prop_tgt:HEADER_SET_&lt;NAME&gt;" title="HEADER_SET_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_SET_&lt;NAME&gt;</code></a></li>
<li><a class="reference internal" href="../prop_tgt/HEADER_DIRS.html#prop_tgt:HEADER_DIRS" title="HEADER_DIRS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_DIRS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/HEADER_DIRS_NAME.html#prop_tgt:HEADER_DIRS_&lt;NAME&gt;" title="HEADER_DIRS_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_DIRS_&lt;NAME&gt;</code></a></li>
</ul>
For file sets of type <code class="docutils literal notranslate">CXX_MODULES</code>:
<ul class="simple">
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_SETS.html#prop_tgt:CXX_MODULE_SETS" title="CXX_MODULE_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/INTERFACE_CXX_MODULE_SETS.html#prop_tgt:INTERFACE_CXX_MODULE_SETS" title="INTERFACE_CXX_MODULE_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_CXX_MODULE_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_SET.html#prop_tgt:CXX_MODULE_SET" title="CXX_MODULE_SET"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_SET</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_SET_NAME.html#prop_tgt:CXX_MODULE_SET_&lt;NAME&gt;" title="CXX_MODULE_SET_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_SET_&lt;NAME&gt;</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_DIRS.html#prop_tgt:CXX_MODULE_DIRS" title="CXX_MODULE_DIRS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_DIRS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_DIRS_NAME.html#prop_tgt:CXX_MODULE_DIRS_&lt;NAME&gt;" title="CXX_MODULE_DIRS_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_DIRS_&lt;NAME&gt;</code></a></li>
</ul>
For file sets of type <code class="docutils literal notranslate">CXX_MODULE_HEADER_UNITS</code>:
<ul class="simple">
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_HEADER_UNIT_SETS.html#prop_tgt:CXX_MODULE_HEADER_UNIT_SETS" title="CXX_MODULE_HEADER_UNIT_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_HEADER_UNIT_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/INTERFACE_CXX_MODULE_HEADER_UNIT_SETS.html#prop_tgt:INTERFACE_CXX_MODULE_HEADER_UNIT_SETS" title="INTERFACE_CXX_MODULE_HEADER_UNIT_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_CXX_MODULE_HEADER_UNIT_SETS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_HEADER_UNIT_SET.html#prop_tgt:CXX_MODULE_HEADER_UNIT_SET" title="CXX_MODULE_HEADER_UNIT_SET"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_HEADER_UNIT_SET</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_HEADER_UNIT_SET_NAME.html#prop_tgt:CXX_MODULE_HEADER_UNIT_SET_&lt;NAME&gt;" title="CXX_MODULE_HEADER_UNIT_SET_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_HEADER_UNIT_SET_&lt;NAME&gt;</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_HEADER_UNIT_DIRS.html#prop_tgt:CXX_MODULE_HEADER_UNIT_DIRS" title="CXX_MODULE_HEADER_UNIT_DIRS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_HEADER_UNIT_DIRS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/CXX_MODULE_HEADER_UNIT_DIRS_NAME.html#prop_tgt:CXX_MODULE_HEADER_UNIT_DIRS_&lt;NAME&gt;" title="CXX_MODULE_HEADER_UNIT_DIRS_&lt;NAME&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_MODULE_HEADER_UNIT_DIRS_&lt;NAME&gt;</code></a></li>
</ul>
Target properties related to include directories are also modified by
<code class="docutils literal notranslate">target_sources(FILE_SET)</code> as follows:
<a class="reference internal" href="../prop_tgt/INCLUDE_DIRECTORIES.html#prop_tgt:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INCLUDE_DIRECTORIES</code></a>
<blockquote>
<div>If the <code class="docutils literal notranslate">TYPE</code> is <code class="docutils literal notranslate">HEADERS</code> or <code class="docutils literal notranslate">CXX_MODULE_HEADER_UNITS</code>, and the scope
of the file set is <code class="docutils literal notranslate">PRIVATE</code> or <code class="docutils literal notranslate">PUBLIC</code>, all of the <code class="docutils literal notranslate">BASE_DIRS</code> of
the file set are wrapped in <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#genex:BUILD_INTERFACE" title="BUILD_INTERFACE"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;BUILD_INTERFACE&gt;</code></a> and appended to this
property.
</div></blockquote>
<a class="reference internal" href="../prop_tgt/INTERFACE_INCLUDE_DIRECTORIES.html#prop_tgt:INTERFACE_INCLUDE_DIRECTORIES" title="INTERFACE_INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_INCLUDE_DIRECTORIES</code></a>
<blockquote>
<div>If the <code class="docutils literal notranslate">TYPE</code> is <code class="docutils literal notranslate">HEADERS</code> or <code class="docutils literal notranslate">CXX_MODULE_HEADER_UNITS</code>, and the scope
of the file set is <code class="docutils literal notranslate">INTERFACE</code> or <code class="docutils literal notranslate">PUBLIC</code>, all of the <code class="docutils literal notranslate">BASE_DIRS</code> of
the file set are wrapped in <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#genex:BUILD_INTERFACE" title="BUILD_INTERFACE"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;BUILD_INTERFACE&gt;</code></a> and appended to this
property.
</div></blockquote>
</section>
<section id="see-also">
<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li><a class="reference internal" href="add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a></li>
<li><a class="reference internal" href="add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a></li>
<li><a class="reference internal" href="target_compile_definitions.html#command:target_compile_definitions" title="target_compile_definitions"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_definitions()</code></a></li>
<li><a class="reference internal" href="target_compile_features.html#command:target_compile_features" title="target_compile_features"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_features()</code></a></li>
<li><a class="reference internal" href="target_compile_options.html#command:target_compile_options" title="target_compile_options"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_options()</code></a></li>
<li><a class="reference internal" href="target_include_directories.html#command:target_include_directories" title="target_include_directories"><code class="xref cmake cmake-command docutils literal notranslate">target_include_directories()</code></a></li>
<li><a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a></li>
<li><a class="reference internal" href="target_link_directories.html#command:target_link_directories" title="target_link_directories"><code class="xref cmake cmake-command docutils literal notranslate">target_link_directories()</code></a></li>
<li><a class="reference internal" href="target_link_options.html#command:target_link_options" title="target_link_options"><code class="xref cmake cmake-command docutils literal notranslate">target_link_options()</code></a></li>
<li><a class="reference internal" href="target_precompile_headers.html#command:target_precompile_headers" title="target_precompile_headers"><code class="xref cmake cmake-command docutils literal notranslate">target_precompile_headers()</code></a></li>
</ul>
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">target_sources</a><ul>
<li><a class="reference internal" href="#file-sets">File Sets</a></li>
<li><a class="reference internal" href="#see-also">See Also</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="target_precompile_headers.html"
 title="previous chapter">target_precompile_headers</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="try_compile.html"
 title="next chapter">try_compile</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/target_sources.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <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>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="try_compile.html" title="try_compile"
 >next</a> |</li>
 <li class="right" >
 <a href="target_precompile_headers.html" title="target_precompile_headers"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">target_sources</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>