option
Provide a boolean option that the user can optionally select.
option(<variable> "<help_text>" [value])
If no initial <value> is provided, boolean OFF is the default value. If <variable> is already set as a normal or cache variable, then the command does nothing (see policy CMP0077).
In CMake project mode, a boolean cache variable is created with the option value. In CMake script mode, a boolean variable is set with the option value.
See Also
- The
CMakeDependentOptionmodule to specify boolean options that depend on the values of other options or a set of conditions.
© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/command/option.html