.. _virtual-service:

====================
salt.modules.service
====================

.. py:module:: salt.modules.service
    :synopsis: A virtual module for service management

``service`` is a virtual module that is fulfilled by one of the following
modules:

====================================== ========================================
Execution Module                       Used for
====================================== ========================================
:py:mod:`~salt.modules.debian_service` Debian Wheezy and earlier
:py:mod:`~salt.modules.freebsdservice` FreeBSD-based OSes using ``service(8)``
:py:mod:`~salt.modules.gentoo_service` Gentoo Linux using ``sysvinit`` and
                                       ``rc-update(8)``
:py:mod:`~salt.modules.launchctl`      Mac OS hosts using ``launchctl(1)``
:py:mod:`~salt.modules.netbsdservice`  NetBSD-based OSes
:py:mod:`~salt.modules.openbsdservice` OpenBSD-based OSes
:py:mod:`~salt.modules.rh_service`     RedHat-based distros and derivatives
                                       using ``service(8)`` and
                                       ``chkconfig(8)``. Supports both pure
                                       sysvinit and mixed sysvinit/upstart
                                       systems.
:py:mod:`~salt.modules.service`        Fallback which simply wraps sysvinit
                                       scripts
:py:mod:`~salt.modules.smf`            Solaris-based OSes which use SMF
:py:mod:`~salt.modules.systemd`        Linux distros which use systemd
:py:mod:`~salt.modules.upstart`        Ubuntu-based distros using upstart
:py:mod:`~salt.modules.win_service`    Windows
====================================== ========================================

