Skip to content

Process

Summary

Matches while a process with the given name exists or does not exist. The name is compared with a match type.

Example

rules:
  # Match while Firefox is running
  - name: "Firefox is running"
    conditions:
      process:
        name: "firefox.exe"
        exists: true
    actions:
      - run: "echo Firefox is running"
rules:
  # Match while Firefox is running
  - name: "Firefox is running"
    conditions:
      process:
        name: "firefox"
        exists: true
    actions:
      - run: "echo Firefox is running"

Options

Option Default Description
name required Name of the process to check.
exists required Whether the process is expected to exist (true) or not (false).
match exact, case-sensitive How the name is matched, see Match Types.

Details

  • Process names usually differ between platforms (e.g. firefox.exe on Windows, firefox on Linux and macOS). Use a contains or regex match to write one policy for several platforms.
  • Policy Evaluation


    Continuous evaluation and --dry-run.

  • Actions


    Run commands when a rule matches.

  • Trust


    Detect modifications of policies and scripts.