Function _systemctl_cmd

salt/modules/systemd_service.py:312–347

Build a systemctl command line. Treat unit names without one of the valid suffixes as a service.

(
    action, name=None, systemd_scope=False, no_block=False, root=None, extra_args=None
)

def _systemctl_cmd(
    action, name=None, systemd_scope=False, no_block=False, root=None, extra_args=None
):
    """
    Build a systemctl command line. Treat unit names without one
    of the valid suffixes as a service.
    """
    ret = []
    if (
        systemd_scope
        and salt.utils.systemd.has_scope(__context__)
        and __salt__["config.get"]("systemd.scope", True)
    ):
        if systemd_run_path := salt.utils.path.which("systemd-run"):
            ret.extend([systemd_run_path, "--scope"])
        else:
            raise CommandExecutionError(
                "systemd-run is required for running systemctl with --scope, but it was not found on the system. "
                "Make sure systemd-run is installed and in the system's PATH "
                "or disable it using the 'systemd.scope' config option."
            )
    ret.append(salt.utils.path.which("systemctl"))
    if no_block:
        ret.append("--no-block")
    if root:
        ret.extend(["--root", root])
    if isinstance(action, str):
        action = shlex.split(action)
    ret.extend(action)
    if name is not None:
        ret.append(_canonical_unit_name(name))
    if "status" in ret:
        ret.extend(["-n", "0"])
    if isinstance(extra_args, list):
        ret.extend(extra_args)
    return ret


def _systemctl_status(name):