Current File : //usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l Z d d l
Z d d l Z i d d 6Z d Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d � Z' d d � Z) d � Z* d � Z+ d! � Z, d" � Z- d# � Z. d$ � Z/ d% � Z0 d S(& u�
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.
i ( t absolute_importt unicode_literalst print_functionNu reloadu reload_u servicec C@ s� t j j j t � r t d f St d d
k r3 t St d d k r� d } t j j
| � r� t j j j
| d
� } d | k r� t Sq� n t d f S( u
Only work on Ubuntu
uQ The upstart execution module failed to load: this system was booted with systemd.u osu Ubuntuu Linarou
elementary OSu Mintu Debianu Raspbianu
/sbin/initctlu versionu upstartut The upstart execution module failed to load: the system must be Ubuntu-based, or Debian-based with upstart support.( u Ubuntuu Linarou
elementary OSu Mint( u Debianu Raspbian( t saltt utilst systemdt bootedt __context__t Falset
__grains__t __virtualname__t ost patht isfilet modulest cmdmodt
_run_quiet( t debian_initctlt initctl_version( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt __virtual__F s
c C@ sm i } x< d D]4 } y | | t j | � j <Wq
t k
r@ q
Xq
Wt | � re | t | � j � St Sd S( u�
Figure out which utmp file to use when determining runlevel.
Sometimes /var/run/utmp doesn't exist, /run/utmp is the new hotness.
u
/var/run/utmpu /run/utmpN( u
/var/run/utmpu /run/utmp( R t statt st_mtimet Exceptiont lent sortedt popR ( t resultt utmp( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt
_find_utmpY s
c C@ s� ys t j j j d � �X } xN | D]F } t j j j | � } | j d � r" | j d � d j � } q" q" WWd QXWn t k
r� d SXyz t j j j d � �_ } xU | D]M } t j j j | � } | j d � r� d | k r� | j d
� d } q� q� WWd QXWn t k
rn Xy� t
d � } t j j j d � �` } xV | D]N } t j j j | � } x0 | j � j � D] } | | k rr| } PqrqrWqDWWd QXWn t k
r�n X| S( u�
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
u /etc/init/rc-sysinit.confu env DEFAULT_RUNLEVELu =i����Nu 2u /etc/inittabu #u initdefaultu :i u 0u 1u 3u 4u 5u 6u su Su -su singleu
/proc/cmdline( u 0u 1u 2u 3u 4u 5u 6u su Su -su single( R R t filest fopent stringutilst
to_unicodet
startswitht splitt stripR t set( t fp_t linet runlevelt
valid_stringst arg( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _default_runlevelk s:
*
$
c C@ s� d t k r t d St � } t � } | r| t d d d j | � g d t �} y | j � d } Wq| t k
rx q| Xn | t d <| S( u%
Return the current runlevel
u upstart._runlevelu cmd.runu runlevelu {0}t python_shelli ( R R* R t __salt__t formatR R" t
IndexError( t retR t out( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _runlevel� s %
c C@ s" t j j | � t j j | � k S( N( R R t abspatht realpath( t name( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _is_symlink� s c C@ s t j d j | � t j � S( u�
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.
u /etc/init/{0}.conf( R t accessR- t R_OK( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _service_is_upstart� s c C@ s� d j | � d j | � g } xo t j t j j | � D]U } t j j j | � �8 } t
j d t j j j
| j � � t
j � r� t SWd QXq7 Wt S( u�
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.
u /etc/init/{0}.confu /etc/init/{0}.overrideu
^\s*manualN( R- t itertoolst ifilterR R R
R R R R t ret searchR R t readt MULTILINEt TrueR ( R4 R t file_nameR% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _upstart_is_disabled� s c C@ s t | � S( uX
Assume that if an Upstart service is not disabled then it must be
enabled.
( RA ( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _upstart_is_enabled� s c C@ s/ d j | � } t | � o. t j | t j � S( u�
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.
u /etc/init.d/{0}( R- R8 R R6 t X_OK( R4 t script( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _service_is_sysv� s c C@ s# t t j d j t � | � � � S( u�
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.
u /etc/rc{0}.d/S*{1}( t boolt globR- R1 ( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _sysv_is_disabled� s c C@ s t | � S( u^
Assume that if a System-V style service is not disabled then it
must be enabled.
( RH ( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _sysv_is_enabled� s c c@ s� t � } x; t j d � D]* } t j j | � } | j | � | Vq Wd } x� t j j j | � D]� \ } } } t j j | | � } xc t
j | d � D]O } | d k r� | d } n t j j | | d � } | | k r� q� n | Vq� Wqc Wd S( u�
Detect all of the service names available to upstart via init configuration
files and via classic sysv init scripts
u
/etc/init.d/*u
/etc/init/u *.confu .i����N(
R$ RG R R t basenamet addR R t os_walkt relpatht fnmatcht filtert join( t foundR& R4 t init_roott roott dirnamest filenamesRM t filename( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _iter_service_names� s
%
c C@ s} t � } xg t � D]\ } t | � rD t | � ro | j | � qo q t | � r t | � ro | j | � qo q q Wt | � S( uw
Return the enabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_enabled
( R$ RW R8 RB RK RE RI R ( R/ R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt get_enabled s
c C@ s} t � } xg t � D]\ } t | � rD t | � ro | j | � qo q t | � r t | � ro | j | � qo q q Wt | � S( uy
Return the disabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_disabled
( R$ RW R8 RA RK RE RH R ( R/ R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt get_disabled" s
c C@ s
| t � k S( u�
Returns ``True`` if the specified service is available, otherwise returns
``False``.
CLI Example:
.. code-block:: bash
salt '*' service.available sshd
( t get_all( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt available8 s c C@ s
| t � k S( u�
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
( RZ ( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt missingF s c C@ s t t � t � � S( uu
Return all installed services
CLI Example:
.. code-block:: bash
salt '*' service.get_all
( R RX RY ( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyRZ U s
c C@ s$ d | d g } t d | d t � S( u�
Start the specified service
CLI Example:
.. code-block:: bash
salt '*' service.start <service name>
u serviceu startu cmd.retcodeR+ ( R, R ( R4 t cmd( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt startb s
c C@ s$ d | d g } t d | d t � S( u~
Stop the specified service
CLI Example:
.. code-block:: bash
salt '*' service.stop <service name>
u serviceu stopu cmd.retcodeR+ ( R, R ( R4 R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt stopp s
c C@ s$ d | d g } t d | d t � S( u�
Restart the named service
CLI Example:
.. code-block:: bash
salt '*' service.restart <service name>
u serviceu restartu cmd.retcodeR+ ( R, R ( R4 R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt restart~ s
c C@ s$ d | d g } t d | d t � S( u�
Do a full restart (stop/start) of the named service
CLI Example:
.. code-block:: bash
salt '*' service.full_restart <service name>
u serviceu --full-restartu cmd.retcodeR+ ( R, R ( R4 R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt full_restart� s
c C@ s$ d | d g } t d | d t � S( u~
Reload the named service
CLI Example:
.. code-block:: bash
salt '*' service.reload <service name>
u serviceu reloadu cmd.retcodeR+ ( R, R ( R4 R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt reload_� s
c C@ s$ d | d g } t d | d t � S( u�
Force-reload the named service
CLI Example:
.. code-block:: bash
salt '*' service.force_reload <service name>
u serviceu force-reloadu cmd.retcodeR+ ( R, R ( R4 R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt force_reload� s
c
C@ s� | r t t d | � � St t j d | � � } | rP t j t � | � } n | g } i } x | D]w } d | d g } t | � r� d t d | d t d t �k | | <qf t t d | d t d t d
t �� | | <qf W| r� | S| | S( u]
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]
u
status.pidu \*|\?|\[.+\]u serviceu statusu
start/runningu cmd.runR+ t ignore_retcodeu cmd.retcodet quite(
RF R, R; R< RN RO RZ R8 R R? ( R4 t sigt contains_globbingt servicest resultst serviceR] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt status� s$
c C@ s d } t j j j | � | S( u�
Debian uses update-rc.d to manage System-V style services.
http://www.debian.org/doc/debian-policy/ch-opersys.html#s9.3.3
u update-rc.d( R R R t check_or_die( t
executable( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _get_service_exec� s c C@ sl t | � r t | � Sd j | � } t j j j | d � �# } | j t j j j d � � Wd QXt | � S( u%
Disable an Upstart service.
u /etc/init/{0}.overrideu au manual
N( RA R- R R R R t writeR t to_str( R4 t overridet ofile( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _upstart_disable� s
"c C@ s+ t | � r t | � Sd j | � } d j | � | g } x� t j t j j | � D]� } t j j j
| d � �m } t j d d t j j
j | j � � d t j � } | j d � | j t j j
j | � � | j � Wd QXqS Wt j | t j � r!t j j | � d k r!t j | � n t | � S( u$
Enable an Upstart service.
u /etc/init/{0}.overrideu /etc/init/{0}.confu r+u
^\s*manual\n?u i N( RB R- R9 R: R R R
R R R R R; t subR R R= R> t seekRo Rp t truncateR6 R7 t getsizet unlink( R4 Rq R R@ R% t new_text( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt _upstart_enable� s&
-c K@ sF t | � r t | � St � } d j | | � } t d | d t � S( u�
Enable the named service to start at boot
CLI Example:
.. code-block:: bash
salt '*' service.enable <service name>
u {0} -f {1} defaultsu cmd.retcodeR+ ( R8 Rz Rn R- R, R ( R4 t kwargsRm R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt enable s
c K@ sF t | � r t | � St � } | d | d g } t d | d t � S( u�
Disable the named service from starting on boot
CLI Example:
.. code-block:: bash
salt '*' service.disable <service name>
u -fu removeu cmd.retcodeR+ ( R8 Rs Rn R, R ( R4 R{ Rm R] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt disable+ s
c K@ s0 t | � r t | � St | � r, t | � Sd S( u�
Check to see if the named service is enabled to start on boot
CLI Example:
.. code-block:: bash
salt '*' service.enabled <service name>
N( R8 RB RE RI t None( R4 R{ ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt enabled< s
c C@ s0 t | � r t | � St | � r, t | � Sd S( u�
Check to see if the named service is disabled to start on boot
CLI Example:
.. code-block:: bash
salt '*' service.disabled <service name>
N( R8 RA RE RH R~ ( R4 ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt disabledN s
(1 t __doc__t
__future__R R R RG R R; R9 RN t salt.modules.cmdmodR t salt.utils.filest salt.utils.patht salt.utils.systemdt __func_alias__R
R R R* R1 R5 R8 RA RB RE RH RI RW RX RY R[ R\ RZ R^ R_ R` Ra Rb Rc R~ Rk Rn Rs Rz R| R} R R� ( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/upstart_service.pyt <module>. sX
-
3
Mini Shell