Systemd Operations

Manage systemd services.

Facts used in these operations: systemd.SystemdEnabled, systemd.SystemdStatus.

systemd.daemon_reload

Stateless operation

This operation will always execute commands and is not idempotent.

Reload the systemd daemon to read unit file changes.

systemd.daemon_reload(user_mode=False, machine: str | None=None, user_name: str | None=None, **kwargs)

• user_mode: whether to use per-user systemd (systemctl –user) or not

• machine: the machine name to connect to

• user_name: connect to a specific user’s systemd session

Note:

This operation also inherits all global arguments.

systemd.service

Manage the state of systemd managed units.

systemd.service(
    service: str, running=True, restarted=False, reloaded=False, command: str | None=None,
    enabled: bool | None=None, daemon_reload=False, user_mode=False, machine: str | None=None,
    user_name: str | None=None, **kwargs,
)

• service: name of the systemd unit to manage

• running: whether the unit should be running

• restarted: whether the unit should be restarted

• reloaded: whether the unit should be reloaded

• command: custom command to pass like: /etc/rc.d/<name> <command>

• enabled: whether this unit should be enabled/disabled on boot

• daemon_reload: reload the systemd daemon to read updated unit files

• user_mode: whether to use per-user systemd (systemctl –user) or not

• machine: the machine name to connect to

• user_name: connect to a specific user’s systemd session

Examples:

systemd.service(
    name="Restart and enable the dnsmasq service",
    service="dnsmasq.service",
    running=True,
    restarted=True,
    enabled=True,
)

systemd.service(
    name="Enable logrotate timer",
    service="logrotate.timer",
    running=True,
    enabled=True,
)

Note:

This operation also inherits all global arguments.