Current File : //lib/python2.7/site-packages/salt/modules/runit.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 e j e
� Z d d l m
Z
d d l Z d d l Z i d d 6Z d d d g Z d Z x* e D]" Z e j j e � r� e Z Pq� q� Wg Z d
a d' Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z! d d � Z" d � Z# d � Z$ d d � Z% d � Z& d � Z' d d d � Z( d d d � Z) d � Z* d � Z+ d � Z, d � Z- d � Z. d � Z/ d! � Z0 d" � Z1 d# � Z2 e3 d$ � Z4 e3 d% � Z5 d& � Z6 d S(( u�
runit service module
(http://smarden.org/runit)
This module is compatible with the :mod:`service <salt.states.service>` states,
so it can be used to maintain services using the ``provider`` argument:
.. code-block:: yaml
myservice:
service:
- running
- provider: runit
Provides virtual `service` module on systems using runit as init.
Service management rules (`sv` command):
service $n is ENABLED if file SERVICE_DIR/$n/run exists
service $n is AVAILABLE if ENABLED or if file AVAIL_SVR_DIR/$n/run exists
service $n is DISABLED if AVAILABLE but not ENABLED
SERVICE_DIR/$n is normally a symlink to a AVAIL_SVR_DIR/$n folder
Service auto-start/stop mechanism:
`sv` (auto)starts/stops service as soon as SERVICE_DIR/<service> is
created/deleted, both on service creation or a boot time.
autostart feature is disabled if file SERVICE_DIR/<n>/down exists. This
does not affect the current's service status (if already running) nor
manual service management.
Service's alias:
Service `sva` is an alias of service `svc` when `AVAIL_SVR_DIR/sva` symlinks
to folder `AVAIL_SVR_DIR/svc`. `svc` can't be enabled if it is already
enabled through an alias already enabled, since `sv` files are stored in
folder `SERVICE_DIR/svc/`.
XBPS package management uses a service's alias to provides service
alternative(s), such as chrony and openntpd both aliased to ntpd.
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionErroru reloadu reload_u /serviceu /var/serviceu /etc/serviceu runitc C@ s_ t j d � d k r< t d d k r2 t d � n d a t St j j j d � rU t St d f S( u�
Virtual service only on systems using runit as init process (PID 1).
Otherwise, use this module with the provider mechanism.
u initu runitu osu Voidu /etc/svu serviceu svu' Runit not available. Please install sv( t
__grains__t gett add_svc_avail_patht __virtualname__t saltt utilst patht whicht False( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt __virtual__X s
c C@ s( t s t d � � n t j j t | � S( u]
Return SERVICE_DIR+name if possible
name
the service's name to work on
u! Could not find service directory.( t SERVICE_DIRR t osR
t join( t name( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt
_service_pathh s c C@ s$ d j t | � � } t d | � S( u�
Start service
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.start <service name>
u sv start {0}u cmd.retcode( t formatR t __salt__( R t cmd( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt startu s
c C@ s$ d j t | � � } t d | � S( u�
Stop service
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.stop <service name>
u sv stop {0}u cmd.retcode( R R R ( R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt stop� s
c C@ s$ d j t | � � } t d | � S( u�
Reload service
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.reload <service name>
u
sv reload {0}u cmd.retcode( R R R ( R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt reload_� s
c C@ s$ d j t | � � } t d | � S( u�
Restart service
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.restart <service name>
u sv restart {0}u cmd.retcode( R R R ( R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt restart� s
c C@ s t | � d S( u�
Calls runit.restart()
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.full_restart <service name>
N( R ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt full_restart� s
c C@ s� | r t t d | � � St | � } t j j | � s< t Sd j | � } y! t d | � } | j d � SWn t k
r� t SXd S( u�
Return ``True`` if service is running
name
the service's name
sig
signature to identify with ps
CLI Example:
.. code-block:: bash
salt '*' runit.status <service name>
u
status.pidu
sv status {0}u cmd.run_stdoutu run: N(
t boolR R R R
t existsR R t
startswitht Exception( R t sigt svc_pathR t out( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt status� s
c C@ sV t j j | d � } t j j | � rR t j j | � rR t j | t j � rR t St S( u�
Return ``True`` if directory <svc_path> is really a service:
file <svc_path>/run exists and is executable
svc_path
the (absolute) directory to check for compatibility
u run( R R
R R t accesst X_OKt TrueR ( R t run_file( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt _is_svc� s c C@ s& t j j t j j t | � d � � S( u0
Return ``True`` if service <name> is autostarted by sv
(file $service_folder/down does not exist)
NB: return ``False`` if the service is not enabled.
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.status_autostart <service name>
u down( R R
R R R ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt status_autostart s u *c C@ sm t s t d � � n t � } xB t j t j j t | � � D]" } t | � s= | j | � q= q= Wt | � S( u9
Return list of broken path(s) in SERVICE_DIR that match ``name``
A path is broken if it is a broken symlink or can not be a runit service
name
a glob for service name. default is '*'
CLI Example:
.. code-block:: bash
salt '*' runit.get_svc_broken_path <service name>
u! Could not find service directory.(
R R t sett globR R
R R' t addt sorted( R t rett el( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt get_svc_broken_path s % c C@ s t S( uB
Return list of paths that may contain available services
( t AVAIL_SVR_DIRS( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt get_svc_avail_path/ s c C@ s6 t j j | � r2 | t k r. t j | � n t St S( u�
Add a path that may contain available services.
Return ``True`` if added (or already present), ``False`` on error.
path
directory to add to AVAIL_SVR_DIRS
( R R
R R0 t appendR% R ( R
( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyR 6 s
c C@ s8 t s t d � � n t � } x[ t j t j j t | � � D]; } t | � r= | j t j | � � t
j d | � q= q= W| d k r� t | � St � } xc t
D][ } xR t j t j j | | � � D]2 } t | � r� | j | � t
j d | � q� q� Wq� W| d k r | j | � } n | j | � } t | � S( ue
Return a list of paths to services with ``name`` that have the specified ``status``
name
a glob for service name. default is '*'
status
None : all services (no filter, default choice)
'DISABLED' : available service(s) that is not enabled
'ENABLED' : enabled service (whether started on boot or not)
u! Could not find service directory.u found enabled service path: %su ENABLEDu found available service path: %su DISABLED( R R R) R* R R
R R' R+ t readlinkt logt traceR, R0 t
differencet union( R R" t enaR. t avat dR- ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt
_get_svc_pathE s& %
%
c C@ s2 t g t | | � D] } t j j | � ^ q � S( uQ
Return list of services that have the specified service ``status``
name
a glob for service name. default is '*'
status
None : all services (no filter, default choice)
'DISABLED' : available service that is not enabled
'ENABLED' : enabled service (whether started on boot or not)
( R, R; R R
t basename( R R" R. ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt
_get_svc_listy s c C@ s� i } x� t D]� } x� t j t j j | d � � D]� } t j j | � sP q2 n t j | � } t j j | � s� t j j | | � } n t j j | � } | | k r� g | | <n | | j | � q2 Wq
W| S( uU
Returns the list of service's name that are aliased and their alias path(s)
u *(
R0 R* R R
R t islinkR3 t isabsR< R2 ( R- R: R. t psvct nsvc( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt
get_svc_alias� s
%
c C@ s | t | � k S( u�
Returns ``True`` if the specified service is available, otherwise returns
``False``.
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.available <service name>
( R= ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt available� s c C@ s | t | � k S( u
The inverse of runit.available.
Returns ``True`` if the specified service is not available, otherwise returns
``False``.
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' runit.missing <service name>
( R= ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt missing� s c C@ s t � S( u}
Return a list of all available services
CLI Example:
.. code-block:: bash
salt '*' runit.get_all
( R= ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt get_all� s
c C@ s
t d d � S( u�
Return a list of all enabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_enabled
R" u ENABLED( R= ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt get_enabled� s
c C@ s
t d d � S( u�
Return a list of all disabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_disabled
R" u DISABLED( R= ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt get_disabled� s
c C@ s | t | d � k S( u�
Return ``True`` if the named service is enabled, ``False`` otherwise
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' service.enabled <service name>
u ENABLED( R= ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt enabled� s c C@ s | t | d � k S( u�
Return ``True`` if the named service is disabled, ``False`` otherwise
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' service.disabled <service name>
u ENABLED( R= ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt disabled� s c C@ s� i } t | d <t | d <t | d <d
| d <t | d <d
| d <t | � | d <| d s` | St | � | d <| d | d <t | � | d <t | � | d <t | � d | d <| d r� t j j
| d d � | d <n | S( u�
Show properties of one or more units/jobs or the manager
name
the service's name
CLI Example:
salt '*' service.show <service name>
u enabledu disabledu runningu service_pathu autostartu command_pathu availablei u runN( R R% t NoneRC RH R" R( R; R R
R ( R R- ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt show s$
c
K@ s� t | � s t St � } | | k r6 t j d � t St | � d } t j j | d � } t | � r� t j j
| � r� y t j | � Wq� t k
r� t j d | � t SXn t
S| s/t j d | � t j j
| � s/y t j j j | d � j � Wq,t k
r(t j d j | � � t SXq/n y t j | t | � � Wn> t k
r�t j d j | � � | s�t j | � n t SXd j t | � � } d
} d } xM | d k r�| d k r�t j d � | d
7} t d
| � } | d } q�W| rRt j j
| � rRy t j | � WqRt k
rNt j d | � d
} qRXn | d k r�t j t j j t | � | g � � t St
S( u'
Start service ``name`` at boot.
Returns ``True`` if operation is successful
name
the service's name
start : False
If ``True``, start the service once enabled.
CLI Example:
.. code-block:: bash
salt '*' service.enable <name> [start=True]
u1 This service is aliased, enable its alias insteadi u downu Unable to remove file %su need a temporary file %su wu Unable to create file {0}u Unable to create symlink {0}u
sv status {0}i i
g �?u cmd.run_allu retcodeu Unable to remove temp file %s( RC R RB R4 t errorR; R R
R RH R t unlinkt OSErrorR% R5 R R t filest fopent closet IOErrorR t symlinkR t timet sleepR (
R R t kwargst aliast svc_realpatht down_fileR t
retcode_svt count_svt call( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt enable, sb
%c K@ s� t | � s t St | � d } t j j | d � } | rH | | � n t j j | � s� y t j j j
| d � j � Wq� t k
r� t
j d | � t SXn t S( u
Don't start service ``name`` at boot
Returns ``True`` if operation is successful
name
the service's name
stop
if True, also stops the service
CLI Example:
.. code-block:: bash
salt '*' service.disable <name> [stop=True]
i u downu wu Unable to create file %s( RH R R; R R
R R R R RO RP RQ RR R4 RL R% ( R R RV RX RY ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt disable� s
c C@ s� t | � s t St | � } t j j | � sB t j d | � t St | � sb t j d | � t Sy t j | � Wn" t
k
r� t j d | � t SXt S( u
Remove the service <name> from system.
Returns ``True`` if operation is successful.
The service will be also stopped.
name
the service's name
CLI Example:
.. code-block:: bash
salt '*' service.remove <name>
u %s is not a symlink: not removedu Failed to stop service %su Unable to remove symlink %s( RH R R R R
R> R4 RL R t removeRR R% ( R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyR_ � s
( u runit(7 t __doc__t
__future__R R R R R* t loggingRT t getLoggert __name__R4 t salt.exceptionsR t salt.utils.filesR t salt.utils.patht __func_alias__t VALID_SERVICE_DIRSRJ R t service_dirR
R R0 R t __virtual_aliases__R
R R R R R R R" R' R( R/ R1 R R; R= RB RC RD RE RF RG RH RI RK R R] R^ R_ ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/runit.pyt <module>/ sb
% 4
$ _ '
Mini Shell