Trace Properties

.. This file was generated by Utilities/Scripts/regenerate-presets.py from Help/manual/presets/schema.yaml. Do not edit.

.. _CMakePresets.configurePresets.trace.mode:

mode An optional string that specifies the trace mode. Valid values are:

on Causes a trace of all calls made and from where to be printed. Equivalent to passing :cmake-option:--trace on the command line.

off A trace of all calls will not be printed.

expand Causes a trace with variables expanded of all calls made and from where to be printed. Equivalent to passing :cmake-option:--trace-expand on the command line.

.. _CMakePresets.configurePresets.trace.format:

format An optional string that specifies the format output of the trace. Valid values are:

human Prints each trace line in a human-readable format. This is the default format. Equivalent to passing :cmake-option:--trace-format=human on the command line.

json-v1 Prints each line as a separate JSON document. Equivalent to passing :cmake-option:--trace-format=json-v1 on the command line.

.. _CMakePresets.configurePresets.trace.source:

source An optional array of strings representing the paths of source files to be traced. This field can also be a string, which is equivalent to an array containing one string. Equivalent to passing :cmake-option:--trace-source on the command line.

.. _CMakePresets.configurePresets.trace.redirect:

redirect An optional string specifying a path to a trace output file. Equivalent to passing :cmake-option:--trace-redirect on the command line.