systemd Manager — Units

naftiko: 1.0.0-alpha2
info:
  label: systemd Manager — Units
  description: |
    Self-contained Naftiko capability covering the systemd Manager unit-lifecycle surface. Wraps the
    org.freedesktop.systemd1 D-Bus methods for enumerating units, starting/stopping/restarting them,
    sending signals, freezing/thawing cgroups, and reading per-unit properties.
  tags:
  - Cgroups
  - D-Bus
  - Service Manager
  - Systemd
  - Units
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
- namespace: env
  keys:
    SYSTEMD_BUS_ADDRESS: SYSTEMD_BUS_ADDRESS
capability:
  consumes:
  - type: dbus
    namespace: org.freedesktop.systemd1
    busName: org.freedesktop.systemd1
    objectPath: /org/freedesktop/systemd1
    description: Manager unit lifecycle methods on PID 1.
    resources:
    - name: units
      operations:
      - name: ListUnits
        method: ListUnits
        description: List all loaded units.
      - name: GetUnit
        method: GetUnit
        description: Get the object path for a unit by name.
      - name: LoadUnit
        method: LoadUnit
        description: Load a unit from disk.
      - name: StartUnit
        method: StartUnit
        description: Enqueue a start job for a unit.
      - name: StopUnit
        method: StopUnit
        description: Enqueue a stop job for a unit.
      - name: RestartUnit
        method: RestartUnit
        description: Enqueue a restart job for a unit.
      - name: ReloadUnit
        method: ReloadUnit
        description: Reload a unit's configuration.
      - name: ReloadOrRestartUnit
        method: ReloadOrRestartUnit
        description: Reload if supported, else restart.
      - name: KillUnit
        method: KillUnit
        description: Send a UNIX signal to a unit's processes.
      - name: FreezeUnit
        method: FreezeUnit
        description: Suspend the unit's cgroup (v2 freezer).
      - name: ThawUnit
        method: ThawUnit
        description: Resume a frozen cgroup.
      - name: StartTransientUnit
        method: StartTransientUnit
        description: Create and start a transient scope or service.
      - name: SetUnitProperties
        method: SetUnitProperties
        description: Set runtime properties (cgroup resource controls) on a unit.