Files
cmake/Help/envvar/CMAKE_SYSTEM_ENVIRONMENT_ID.rst
Aiden Woodruff fc3c71d11f cmake: Add cached environment id that triggers reconfigure when changed
The opaque `CMAKE_SYSTEM_ENVIRONMENT_ID` variable is cached during the
first invocation of `cmake` and is a user-defined hint about the state
of the environment. When the value changes, `cmake` either does nothing,
emits a warning (by default), or refreshes the cache as if by `--fresh`.
The action is controlled by the `CMAKE_SYSTEM_ENVIRONMENT_ACTION`
environment variable (which is not cached).

Implements: #28025
2026-08-24 15:06:35 -04:00

16 lines
572 B
ReStructuredText

CMAKE_SYSTEM_ENVIRONMENT_ID
---------------------------
.. versionadded:: 4.5
.. include:: include/ENV_VAR.rst
Externally-defined environment identifier that is cached. The value is not
interpreted by :manual:`cmake(1)` and is a hint about the state of the
environment during the first configure. When the value changes,
:manual:`cmake(1)` by default emits a warning to the user indicating that the
environment has changed and introspection results may be out of date.
The default warning behavior can be modified by setting
:envvar:`CMAKE_SYSTEM_ENVIRONMENT_ACTION`.