Variables are promises that can be defined in any promise bundle. Users can create their own variables.

To see variables defined on a particular host during pre-evaluation run cf-promises --show-vars as a privileged user. To see all variables defined over the course of an agent execution run cf-agent --show-evaluated-vars. Note cf-promises shows variables resolved during pre-evaluation while cf-agent can show variables resolved during actual execution where the system may be modified.

See Classes for an explanation of the tags.

CFEngine includes the following special variables:

  • connection Variables defined for embedding unprintable values or values with special meanings in strings.

  • const Variables defined for embedding unprintable values or values with special meanings in strings.

  • edit Variables used to access information about editing promises during their execution.

  • match Variable used in string matching.

  • mon Variables defined in a monitoring context.

  • sys Variables defined in order to automate discovery of system values.

  • def Variables with some default value that can be defined by augments file or in policy.

  • this Variables used to access information about promises during their execution.