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: message.html

<!DOCTYPE html>

<title>message &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="option.html" title="option"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="math.html" title="math"
 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="">message</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="message">
<h1>message<a class="headerlink" href="#message" title="Permalink to this heading">¶</a></h1>
Log a message.
<section id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this heading">¶</a></h2>
<pre class="literal-block"><a class="reference internal" href="#general-messages">General messages</a>
 message([&lt;mode&gt;] &quot;message text&quot; ...)

<a class="reference internal" href="#reporting-checks">Reporting checks</a>
 message(&lt;checkState&gt; &quot;message text&quot; ...)

<a class="reference internal" href="#configure-log">Configure Log</a>
 message(CONFIGURE_LOG &lt;text&gt;...)</pre>
</section>
<section id="general-messages">
<h2>General messages<a class="headerlink" href="#general-messages" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message([&lt;mode&gt;] &quot;message text&quot; ...)
</pre></div>
</div>
Record the specified message text in the log. If more than one message
string is given, they are concatenated into a single message with no
separator between the strings.
The optional <code class="docutils literal notranslate">&lt;mode&gt;</code> keyword determines the type of message, which
influences the way the message is handled:
<dl>
<dt><code class="docutils literal notranslate">FATAL_ERROR</code></dt><dd>CMake Error, stop processing and generation.
The <a class="reference internal" href="../manual/cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> executable will return a non-zero
<a class="reference internal" href="../manual/cmake.1.html#cmake-exit-code">exit code</a>.
</dd>
<dt><code class="docutils literal notranslate">SEND_ERROR</code></dt><dd>CMake Error, continue processing, but skip generation.
</dd>
<dt><code class="docutils literal notranslate">WARNING</code></dt><dd>CMake Warning, continue processing.
</dd>
<dt><code class="docutils literal notranslate">AUTHOR_WARNING</code></dt><dd>CMake Warning (dev), continue processing.
</dd>
<dt><code class="docutils literal notranslate">DEPRECATION</code></dt><dd>CMake Deprecation Error or Warning if variable
<a class="reference internal" href="../variable/CMAKE_ERROR_DEPRECATED.html#variable:CMAKE_ERROR_DEPRECATED" title="CMAKE_ERROR_DEPRECATED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ERROR_DEPRECATED</code></a> or <a class="reference internal" href="../variable/CMAKE_WARN_DEPRECATED.html#variable:CMAKE_WARN_DEPRECATED" title="CMAKE_WARN_DEPRECATED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_WARN_DEPRECATED</code></a>
is enabled, respectively, else no message.
</dd>
<dt>(none) or <code class="docutils literal notranslate">NOTICE</code></dt><dd>Important message printed to stderr to attract user's attention.
</dd>
<dt><code class="docutils literal notranslate">STATUS</code></dt><dd>The main interesting messages that project users might be interested in.
Ideally these should be concise, no more than a single line, but still
informative.
</dd>
<dt><code class="docutils literal notranslate">VERBOSE</code></dt><dd>Detailed informational messages intended for project users. These messages
should provide additional details that won't be of interest in most cases,
but which may be useful to those building the project when they want deeper
insight into what's happening.
</dd>
<dt><code class="docutils literal notranslate">DEBUG</code></dt><dd>Detailed informational messages intended for developers working on the
project itself as opposed to users who just want to build it. These messages
will not typically be of interest to other users building the project and
will often be closely related to internal implementation details.
</dd>
<dt><code class="docutils literal notranslate">TRACE</code></dt><dd>Fine-grained messages with very low-level implementation details. Messages
using this log level would normally only be temporary and would expect to be
removed before releasing the project, packaging up the files, etc.
</dd>
</dl>
<div class="versionadded">
New in version 3.15: Added the <code class="docutils literal notranslate">NOTICE</code>, <code class="docutils literal notranslate">VERBOSE</code>, <code class="docutils literal notranslate">DEBUG</code>, and <code class="docutils literal notranslate">TRACE</code> levels.
</div>
The CMake command-line tool displays <code class="docutils literal notranslate">STATUS</code> to <code class="docutils literal notranslate">TRACE</code> messages on stdout
with the message preceded by two hyphens and a space. All other message types
are sent to stderr and are not prefixed with hyphens. The
<a class="reference internal" href="../manual/cmake-gui.1.html#manual:cmake-gui(1)" title="cmake-gui(1)"><code class="xref cmake cmake-manual docutils literal notranslate">CMake GUI</code></a> displays all messages in its log area.
The <a class="reference internal" href="../manual/ccmake.1.html#manual:ccmake(1)" title="ccmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">curses interface</code></a> shows <code class="docutils literal notranslate">STATUS</code> to <code class="docutils literal notranslate">TRACE</code>
messages one at a time on a status line and other messages in an
interactive pop-up box. The <a class="reference internal" href="../manual/cmake.1.html#cmdoption-cmake-log-level"><code class="xref std std-option docutils literal notranslate">--log-level</code></a>
command-line option to each of these tools can be used to control which
messages will be shown.
<div class="versionadded">
New in version 3.17: To make a log level persist between CMake runs, the
<a class="reference internal" href="../variable/CMAKE_MESSAGE_LOG_LEVEL.html#variable:CMAKE_MESSAGE_LOG_LEVEL" title="CMAKE_MESSAGE_LOG_LEVEL"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_LOG_LEVEL</code></a> variable can be set instead.
Note that the command line option takes precedence over the cache variable.
</div>
<div class="versionadded">
New in version 3.16: Messages of log levels <code class="docutils literal notranslate">NOTICE</code> and below will have each line preceded
by the content of the <a class="reference internal" href="../variable/CMAKE_MESSAGE_INDENT.html#variable:CMAKE_MESSAGE_INDENT" title="CMAKE_MESSAGE_INDENT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_INDENT</code></a> variable (converted to
a single string by concatenating its list items). For <code class="docutils literal notranslate">STATUS</code> to <code class="docutils literal notranslate">TRACE</code>
messages, this indenting content will be inserted after the hyphens.
</div>
<div class="versionadded">
New in version 3.17: Messages of log levels <code class="docutils literal notranslate">NOTICE</code> and below can also have each line preceded
with context of the form <code class="docutils literal notranslate">[some.context.example]</code>. The content between the
square brackets is obtained by converting the <a class="reference internal" href="../variable/CMAKE_MESSAGE_CONTEXT.html#variable:CMAKE_MESSAGE_CONTEXT" title="CMAKE_MESSAGE_CONTEXT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_CONTEXT</code></a>
list variable to a dot-separated string. The message context will always
appear before any indenting content but after any automatically added leading
hyphens. By default, message context is not shown, it has to be explicitly
enabled by giving the <a class="reference internal" href="../manual/cmake.1.html#cmdoption-cmake-log-context"><code class="xref std std-option docutils literal notranslate">cmake --log-context</code></a>
command-line option or by setting the <a class="reference internal" href="../variable/CMAKE_MESSAGE_CONTEXT_SHOW.html#variable:CMAKE_MESSAGE_CONTEXT_SHOW" title="CMAKE_MESSAGE_CONTEXT_SHOW"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_CONTEXT_SHOW</code></a>
variable to true. See the <a class="reference internal" href="../variable/CMAKE_MESSAGE_CONTEXT.html#variable:CMAKE_MESSAGE_CONTEXT" title="CMAKE_MESSAGE_CONTEXT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_CONTEXT</code></a> documentation for
usage examples.
</div>
CMake Warning and Error message text displays using a simple markup
language. Non-indented text is formatted in line-wrapped paragraphs
delimited by newlines. Indented text is considered pre-formatted.
</section>
<section id="reporting-checks">
<h2>Reporting checks<a class="headerlink" href="#reporting-checks" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.17.
</div>
A common pattern in CMake output is a message indicating the start of some
sort of check, followed by another message reporting the result of that check.
For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message(STATUS &quot;Looking for someheader.h&quot;)
#... do the checks, set checkSuccess with the result
if(checkSuccess)
 message(STATUS &quot;Looking for someheader.h - found&quot;)
else()
 message(STATUS &quot;Looking for someheader.h - not found&quot;)
endif()
</pre></div>
</div>
This can be more robustly and conveniently expressed using the <code class="docutils literal notranslate">CHECK_...</code>
keyword form of the <code class="docutils literal notranslate">message()</code> command:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message(&lt;checkState&gt; &quot;message&quot; ...)
</pre></div>
</div>
where <code class="docutils literal notranslate">&lt;checkState&gt;</code> must be one of the following:
<blockquote>
<div><dl class="simple">
<dt><code class="docutils literal notranslate">CHECK_START</code></dt><dd>Record a concise message about the check about to be performed.
</dd>
<dt><code class="docutils literal notranslate">CHECK_PASS</code></dt><dd>Record a successful result for a check.
</dd>
<dt><code class="docutils literal notranslate">CHECK_FAIL</code></dt><dd>Record an unsuccessful result for a check.
</dd>
</dl>
</div></blockquote>
When recording a check result, the command repeats the message from the most
recently started check for which no result has yet been reported, then some
separator characters and then the message text provided after the
<code class="docutils literal notranslate">CHECK_PASS</code> or <code class="docutils literal notranslate">CHECK_FAIL</code> keyword. Check messages are always reported
at <code class="docutils literal notranslate">STATUS</code> log level.
Checks may be nested and every <code class="docutils literal notranslate">CHECK_START</code> should have exactly one
matching <code class="docutils literal notranslate">CHECK_PASS</code> or <code class="docutils literal notranslate">CHECK_FAIL</code>.
The <a class="reference internal" href="../variable/CMAKE_MESSAGE_INDENT.html#variable:CMAKE_MESSAGE_INDENT" title="CMAKE_MESSAGE_INDENT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_INDENT</code></a> variable can also be used to add
indenting to nested checks if desired. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message(CHECK_START &quot;Finding my things&quot;)
list(APPEND CMAKE_MESSAGE_INDENT &quot; &quot;)
unset(missingComponents)

message(CHECK_START &quot;Finding partA&quot;)
# ... do check, assume we find A
message(CHECK_PASS &quot;found&quot;)

message(CHECK_START &quot;Finding partB&quot;)
# ... do check, assume we don&#39;t find B
list(APPEND missingComponents B)
message(CHECK_FAIL &quot;not found&quot;)

list(POP_BACK CMAKE_MESSAGE_INDENT)
if(missingComponents)
 message(CHECK_FAIL &quot;missing components: ${missingComponents}&quot;)
else()
 message(CHECK_PASS &quot;all components found&quot;)
endif()
</pre></div>
</div>
Output from the above would appear something like the following:
<div class="highlight-none notranslate"><div class="highlight"><pre>-- Finding my things
-- Finding partA
-- Finding partA - found
-- Finding partB
-- Finding partB - not found
-- Finding my things - missing components: B
</pre></div>
</div>
</section>
<section id="configure-log">
<h2>Configure Log<a class="headerlink" href="#configure-log" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.26.
</div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message(CONFIGURE_LOG &lt;text&gt;...)
</pre></div>
</div>
Record a <a class="reference internal" href="../manual/cmake-configure-log.7.html#message-configure-log-event">configure-log message event</a>
with the specified <code class="docutils literal notranslate">&lt;text&gt;</code>. By convention, if the text contains more
than one line, the first line should be a summary of the event.
This mode is intended to record the details of a system inspection check
or other one-time operation guarded by a cache entry, but that is not
performed using <a class="reference internal" href="try_compile.html#command:try_compile" title="try_compile"><code class="xref cmake cmake-command docutils literal notranslate">try_compile()</code></a> or <a class="reference internal" href="try_run.html#command:try_run" title="try_run"><code class="xref cmake cmake-command docutils literal notranslate">try_run()</code></a>, which
automatically log their details. Projects should avoid calling it every
time CMake runs. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>if (NOT DEFINED MY_CHECK_RESULT)
 # Print check summary in configure output.
 message(CHECK_START &quot;My Check&quot;)

# ... perform system inspection, e.g., with execute_process ...

# Cache the result so we do not run the check again.
 set(MY_CHECK_RESULT &quot;${MY_CHECK_RESULT}&quot; CACHE INTERNAL &quot;My Check&quot;)

# Record the check details in the cmake-configure-log.
 message(CONFIGURE_LOG
 &quot;My Check Result: ${MY_CHECK_RESULT}\n&quot;
 &quot;${details}&quot;
 )

# Print check result in configure output.
 if(MY_CHECK_RESULT)
 message(CHECK_PASS &quot;passed&quot;)
 else()
 message(CHECK_FAIL &quot;failed&quot;)
 endif()
endif()
</pre></div>
</div>
If no project is currently being configured, such as in
<a class="reference internal" href="../manual/cmake.1.html#script-processing-mode">cmake -P</a> script mode,
this command does nothing.
</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="cmake_language.html#command:cmake_language" title="cmake_language"><code class="xref cmake cmake-command docutils literal notranslate">cmake_language(GET_MESSAGE_LOG_LEVEL)</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="#">message</a><ul>
<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
<li><a class="reference internal" href="#general-messages">General messages</a></li>
<li><a class="reference internal" href="#reporting-checks">Reporting checks</a></li>
<li><a class="reference internal" href="#configure-log">Configure Log</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="math.html"
 title="previous chapter">math</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="option.html"
 title="next chapter">option</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/message.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="option.html" title="option"
 >next</a> |</li>
 <li class="right" >
 <a href="math.html" title="math"
 >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="">message</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>