WWWWWW

Current Directory: /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules
Viewing File: /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/upstart_service.py
"""
Module for the management of upstart systems. The Upstart system only supports
service starting, stopping and restarting.

.. important::
    If you feel that Salt should be using this module to manage services on a
    minion, and it is using a different module (or gives an error similar to
    *'service.start' is not available*), see :ref:`here
    <module-provider-override>`.

Currently (as of Ubuntu 12.04) there is no tool available to disable
Upstart services (like update-rc.d). This[1] is the recommended way to
disable an Upstart service. So we assume that all Upstart services
that have not been disabled in this manner are enabled.

But this is broken because we do not check to see that the dependent
services are enabled. Otherwise we would have to do something like
parse the output of "initctl show-config" to determine if all service
dependencies are enabled to start on boot. For example, see the "start
on" condition for the lightdm service below[2]. And this would be too
hard. So we wait until the upstart developers have solved this
problem. :) This is to say that an Upstart service that is enabled may
not really be enabled.

Also, when an Upstart service is enabled, should the dependent
services be enabled too? Probably not. But there should be a notice
about this, at least.

[1] http://upstart.ubuntu.com/cookbook/#disabling-a-job-from-automatically-starting

[2] example upstart configuration file::

    lightdm
    emits login-session-start
    emits desktop-session-start
    emits desktop-shutdown
    start on ((((filesystem and runlevel [!06]) and started dbus) and (drm-device-added card0 PRIMARY_DEVICE_FOR_DISPLAY=1 or stopped udev-fallback-graphics)) or runlevel PREVLEVEL=S)
    stop on runlevel [016]

.. warning::
    This module should not be used on Red Hat systems. For these,
    the :mod:`rh_service <salt.modules.rh_service>` module should be
    used, as it supports the hybrid upstart/sysvinit system used in
    RHEL/CentOS 6.
"""

import fnmatch
import glob
import os
import re

import salt.modules.cmdmod
import salt.utils.files
import salt.utils.path
import salt.utils.systemd

__func_alias__ = {"reload_": "reload"}

# Define the module's virtual name
__virtualname__ = "service"


def __virtual__():
    """
    Only work on Ubuntu
    """
    # Disable on these platforms, specific service modules exist:
    if salt.utils.systemd.booted(__context__):
        return (
            False,
            "The upstart execution module failed to load: this system was booted with"
            " systemd.",
        )
    elif __grains__["os"] in ("Ubuntu", "Linaro", "elementary OS", "Mint"):
        return __virtualname__
    elif __grains__["os"] in ("Debian", "Raspbian"):
        debian_initctl = "/sbin/initctl"
        if os.path.isfile(debian_initctl):
            initctl_version = salt.modules.cmdmod._run_quiet(
                debian_initctl + " version"
            )
            if "upstart" in initctl_version:
                return __virtualname__
    return (
        False,
        "The upstart execution module failed to load: "
        " the system must be Ubuntu-based, or Debian-based with upstart support.",
    )


def _find_utmp():
    """
    Figure out which utmp file to use when determining runlevel.
    Sometimes /var/run/utmp doesn't exist, /run/utmp is the new hotness.
    """
    result = {}
    # These are the likely locations for the file on Ubuntu
    for utmp in "/var/run/utmp", "/run/utmp":
        try:
            result[os.stat(utmp).st_mtime] = utmp
        except Exception:  # pylint: disable=broad-except
            pass
    if result:
        return result[sorted(result).pop()]
    else:
        return False


def _default_runlevel():
    """
    Try to figure out the default runlevel.  It is kept in
    /etc/init/rc-sysinit.conf, but can be overridden with entries
    in /etc/inittab, or via the kernel command-line at boot
    """
    # Try to get the "main" default.  If this fails, throw up our
    # hands and just guess "2", because things are horribly broken
    try:
        with salt.utils.files.fopen("/etc/init/rc-sysinit.conf") as fp_:
            for line in fp_:
                line = salt.utils.stringutils.to_unicode(line)
                if line.startswith("env DEFAULT_RUNLEVEL"):
                    runlevel = line.split("=")[-1].strip()
    except Exception:  # pylint: disable=broad-except
        return "2"

    # Look for an optional "legacy" override in /etc/inittab
    try:
        with salt.utils.files.fopen("/etc/inittab") as fp_:
            for line in fp_:
                line = salt.utils.stringutils.to_unicode(line)
                if not line.startswith("#") and "initdefault" in line:
                    runlevel = line.split(":")[1]
    except Exception:  # pylint: disable=broad-except
        pass

    # The default runlevel can also be set via the kernel command-line.
    # Kinky.
    try:
        valid_strings = {"0", "1", "2", "3", "4", "5", "6", "s", "S", "-s", "single"}
        with salt.utils.files.fopen("/proc/cmdline") as fp_:
            for line in fp_:
                line = salt.utils.stringutils.to_unicode(line)
                for arg in line.strip().split():
                    if arg in valid_strings:
                        runlevel = arg
                        break
    except Exception:  # pylint: disable=broad-except
        pass

    return runlevel


def _runlevel():
    """
    Return the current runlevel
    """
    if "upstart._runlevel" in __context__:
        return __context__["upstart._runlevel"]
    ret = _default_runlevel()
    utmp = _find_utmp()
    if utmp:
        out = __salt__["cmd.run"](["runlevel", f"{utmp}"], python_shell=False)
        try:
            ret = out.split()[1]
        except IndexError:
            pass
    __context__["upstart._runlevel"] = ret
    return ret


def _is_symlink(name):
    return os.path.abspath(name) != os.path.realpath(name)


def _service_is_upstart(name):
    """
    From "Writing Jobs" at
    http://upstart.ubuntu.com/getting-started.html:

    Jobs are defined in files placed in /etc/init, the name of the job
    is the filename under this directory without the .conf extension.
    """
    return os.access(f"/etc/init/{name}.conf", os.R_OK)


def _upstart_is_disabled(name):
    """
    An Upstart service is assumed disabled if a manual stanza is
    placed in /etc/init/[name].override.
    NOTE: An Upstart service can also be disabled by placing "manual"
    in /etc/init/[name].conf.
    """
    files = [f"/etc/init/{name}.conf", f"/etc/init/{name}.override"]
    for file_name in filter(os.path.isfile, files):
        with salt.utils.files.fopen(file_name) as fp_:
            if re.search(
                r"^\s*manual",
                salt.utils.stringutils.to_unicode(fp_.read()),
                re.MULTILINE,
            ):
                return True
    return False


def _upstart_is_enabled(name):
    """
    Assume that if an Upstart service is not disabled then it must be
    enabled.
    """
    return not _upstart_is_disabled(name)


def _service_is_sysv(name):
    """
    A System-V style service will have a control script in
    /etc/init.d. We make sure to skip over symbolic links that point
    to Upstart's /lib/init/upstart-job, and anything that isn't an
    executable, like README or skeleton.
    """
    script = f"/etc/init.d/{name}"
    return not _service_is_upstart(name) and os.access(script, os.X_OK)


def _sysv_is_disabled(name):
    """
    A System-V style service is assumed disabled if there is no
    start-up link (starts with "S") to its script in /etc/init.d in
    the current runlevel.
    """
    return not bool(glob.glob(f"/etc/rc{_runlevel()}.d/S*{name}"))


def _sysv_is_enabled(name):
    """
    Assume that if a System-V style service is not disabled then it
    must be enabled.
    """
    return not _sysv_is_disabled(name)


def _iter_service_names():
    """
    Detect all of the service names available to upstart via init configuration
    files and via classic sysv init scripts
    """
    found = set()
    for line in glob.glob("/etc/init.d/*"):
        name = os.path.basename(line)
        found.add(name)
        yield name

    # This walk method supports nested services as per the init man page
    # definition 'For example a configuration file /etc/init/rc-sysinit.conf
    # is named rc-sysinit, while a configuration file /etc/init/net/apache.conf
    # is named net/apache'
    init_root = "/etc/init/"
    for root, dirnames, filenames in salt.utils.path.os_walk(init_root):
        relpath = os.path.relpath(root, init_root)
        for filename in fnmatch.filter(filenames, "*.conf"):
            if relpath == ".":
                # service is defined in the root, no need to append prefix.
                name = filename[:-5]
            else:
                # service is nested, append its relative path prefix.
                name = os.path.join(relpath, filename[:-5])
            if name in found:
                continue
            yield name


def get_enabled():
    """
    Return the enabled services

    CLI Example:

    .. code-block:: bash

        salt '*' service.get_enabled
    """
    ret = set()
    for name in _iter_service_names():
        if _service_is_upstart(name):
            if _upstart_is_enabled(name):
                ret.add(name)
        else:
            if _service_is_sysv(name):
                if _sysv_is_enabled(name):
                    ret.add(name)
    return sorted(ret)


def get_disabled():
    """
    Return the disabled services

    CLI Example:

    .. code-block:: bash

        salt '*' service.get_disabled
    """
    ret = set()
    for name in _iter_service_names():
        if _service_is_upstart(name):
            if _upstart_is_disabled(name):
                ret.add(name)
        else:
            if _service_is_sysv(name):
                if _sysv_is_disabled(name):
                    ret.add(name)
    return sorted(ret)


def available(name):
    """
    Returns ``True`` if the specified service is available, otherwise returns
    ``False``.

    CLI Example:

    .. code-block:: bash

        salt '*' service.available sshd
    """
    return name in get_all()


def missing(name):
    """
    The inverse of service.available.
    Returns ``True`` if the specified service is not available, otherwise returns
    ``False``.

    CLI Example:

    .. code-block:: bash

        salt '*' service.missing sshd
    """
    return name not in get_all()


def get_all():
    """
    Return all installed services

    CLI Example:

    .. code-block:: bash

        salt '*' service.get_all
    """
    return sorted(get_enabled() + get_disabled())


def start(name):
    """
    Start the specified service

    CLI Example:

    .. code-block:: bash

        salt '*' service.start <service name>
    """
    cmd = ["service", name, "start"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def stop(name):
    """
    Stop the specified service

    CLI Example:

    .. code-block:: bash

        salt '*' service.stop <service name>
    """
    cmd = ["service", name, "stop"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def restart(name):
    """
    Restart the named service

    CLI Example:

    .. code-block:: bash

        salt '*' service.restart <service name>
    """
    cmd = ["service", name, "restart"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def full_restart(name):
    """
    Do a full restart (stop/start) of the named service

    CLI Example:

    .. code-block:: bash

        salt '*' service.full_restart <service name>
    """
    cmd = ["service", name, "--full-restart"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def reload_(name):
    """
    Reload the named service

    CLI Example:

    .. code-block:: bash

        salt '*' service.reload <service name>
    """
    cmd = ["service", name, "reload"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def force_reload(name):
    """
    Force-reload the named service

    CLI Example:

    .. code-block:: bash

        salt '*' service.force_reload <service name>
    """
    cmd = ["service", name, "force-reload"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def status(name, sig=None):
    """
    Return the status for a service.
    If the name contains globbing, a dict mapping service name to True/False
    values is returned.

    .. versionchanged:: 2018.3.0
        The service name can now be a glob (e.g. ``salt*``)

    Args:
        name (str): The name of the service to check
        sig (str): Signature to use to find the service via ps

    Returns:
        bool: True if running, False otherwise
        dict: Maps service name to True if running, False otherwise

    CLI Example:

    .. code-block:: bash

        salt '*' service.status <service name> [service signature]
    """
    if sig:
        return bool(__salt__["status.pid"](sig))

    contains_globbing = bool(re.search(r"\*|\?|\[.+\]", name))
    if contains_globbing:
        services = fnmatch.filter(get_all(), name)
    else:
        services = [name]
    results = {}
    for service in services:
        cmd = ["service", service, "status"]
        if _service_is_upstart(service):
            # decide result base on cmd output, thus ignore retcode,
            # which makes cmd output not at error lvl even when cmd fail.
            results[service] = "start/running" in __salt__["cmd.run"](
                cmd, python_shell=False, ignore_retcode=True
            )
        else:
            # decide result base on retcode, thus ignore output (set quite)
            # because there is no way to avoid logging at error lvl when
            # service is not running - retcode != 0 (which is totally relevant).
            results[service] = not bool(
                __salt__["cmd.retcode"](
                    cmd, python_shell=False, ignore_retcode=True, quite=True
                )
            )
    if contains_globbing:
        return results
    return results[name]


def _get_service_exec():
    """
    Debian uses update-rc.d to manage System-V style services.
    http://www.debian.org/doc/debian-policy/ch-opersys.html#s9.3.3
    """
    executable = "update-rc.d"
    salt.utils.path.check_or_die(executable)
    return executable


def _upstart_disable(name):
    """
    Disable an Upstart service.
    """
    if _upstart_is_disabled(name):
        return _upstart_is_disabled(name)
    override = f"/etc/init/{name}.override"
    with salt.utils.files.fopen(override, "a") as ofile:
        ofile.write(salt.utils.stringutils.to_str("manual\n"))
    return _upstart_is_disabled(name)


def _upstart_enable(name):
    """
    Enable an Upstart service.
    """
    if _upstart_is_enabled(name):
        return _upstart_is_enabled(name)
    override = f"/etc/init/{name}.override"
    files = [f"/etc/init/{name}.conf", override]
    for file_name in filter(os.path.isfile, files):
        with salt.utils.files.fopen(file_name, "r+") as fp_:
            new_text = re.sub(
                r"^\s*manual\n?",
                "",
                salt.utils.stringutils.to_unicode(fp_.read()),
                0,
                re.MULTILINE,
            )
            fp_.seek(0)
            fp_.write(salt.utils.stringutils.to_str(new_text))
            fp_.truncate()
    if os.access(override, os.R_OK) and os.path.getsize(override) == 0:
        os.unlink(override)
    return _upstart_is_enabled(name)


def enable(name, **kwargs):
    """
    Enable the named service to start at boot

    CLI Example:

    .. code-block:: bash

        salt '*' service.enable <service name>
    """
    if _service_is_upstart(name):
        return _upstart_enable(name)
    executable = _get_service_exec()
    cmd = f"{executable} -f {name} defaults"
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def disable(name, **kwargs):
    """
    Disable the named service from starting on boot

    CLI Example:

    .. code-block:: bash

        salt '*' service.disable <service name>
    """
    if _service_is_upstart(name):
        return _upstart_disable(name)
    executable = _get_service_exec()
    cmd = [executable, "-f", name, "remove"]
    return not __salt__["cmd.retcode"](cmd, python_shell=False)


def enabled(name, **kwargs):
    """
    Check to see if the named service is enabled to start on boot

    CLI Example:

    .. code-block:: bash

        salt '*' service.enabled <service name>
    """
    if _service_is_upstart(name):
        return _upstart_is_enabled(name)
    else:
        if _service_is_sysv(name):
            return _sysv_is_enabled(name)
    return None


def disabled(name):
    """
    Check to see if the named service is disabled to start on boot

    CLI Example:

    .. code-block:: bash

        salt '*' service.disabled <service name>
    """
    if _service_is_upstart(name):
        return _upstart_is_disabled(name)
    else:
        if _service_is_sysv(name):
            return _sysv_is_disabled(name)
    return None
F1l3 Manager
