Current File : //lib/python2.7/site-packages/salt/modules/launchctl_service.pyo
�
���^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 d d l Z d d l j j Z d d l m Z d d l m Z e j e � Z d Z e a d � Z d � Z e j d � � Z! d
� Z" d � Z# d d � Z% d
� Z& d � Z' d d � Z( d d � Z) d d � Z* d d � Z+ d d � Z, d d � Z- d S( uq
Module for the management of MacOS systems that use launchd/launchctl
.. 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>`.
:depends: - plistlib Python module
i ( t absolute_importt print_functiont unicode_literalsN( t LooseVersion( t sixu servicec C@ s� t j j j � s t d f St j j d � s8 t d f St t d � t d � k r^ t d f St t d � t d � k r� t a
n t S( u
Only work on MacOS
uG Failed to load the mac_service module:
Only available on macOS systems.u /bin/launchctluR Failed to load the mac_service module:
Required binary not found: "/bin/launchctl"u osreleaseu 10.11uW Failed to load the mac_service module:
Not available on El Capitan, uses mac_service.pyu 10.10( t saltt utilst platformt is_darwint Falset ost patht existst
_LooseVersiont
__grains__t BEFORE_YOSEMITEt __virtualname__( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt __virtual__) s
c C@ s d d d d g S( u3
Paths where launchd services can be found
u /Library/LaunchAgentsu /Library/LaunchDaemonsu /System/Library/LaunchAgentsu /System/Library/LaunchDaemons( ( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt _launchd_paths@ s c
C@ s� t � } x~t � D]s} xjt j j j | � D]S\ } } } xA| D]9} t j j | | � } t j j | � } t j j | � s� qE n y> t j j
j | � �# t j
t j j j | � � } Wd QXWns t k
r=d j | � } t d | d t �d }
t j r t j |
� } q>t j t j j j |
� � } n Xy, i | d 6| d 6| d 6| | j j � <WqE t k
r}qE XqE Wq/ Wq W| S( uE
Return a dictionary of all available services on the system
Nu+ /usr/bin/plutil -convert xml1 -o - -- "{0}"u cmd.run_allt python_shellu stdoutu filenameu file_pathu plist( t dictR R R R t os_walkR
t joint realpathR t filest fopent plistlibt readPlistt datat decodet Exceptiont formatt __salt__R R t PY2t readPlistFromStringt readPlistFromBytest stringutilst to_bytest Labelt lowert AttributeError( t available_servicest
launch_dirt roott dirsR t filenamet file_patht true_patht plistt cmdt plist_xml( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt _available_servicesL s: %
"
c C@ s� t � } | j � } | | k r) | | Sxc t j | � D]R } | d j � | k rY | St j j | d � \ } } | j � | k r9 | Sq9 Wt S( uJ
Return the service info for a service by label, filename or path
u file_pathu filename( R3 R' R t
itervaluesR
R t splitextR ( t namet servicest servicet basenamet ext( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt _service_by_name� s c C@ s� d } g t d | � j � D] } | j d � s | ^ q } g | D] } | j d � d ^ qE } t t � j � � } t t | | � � S( uu
Return all installed services
CLI Example:
.. code-block:: bash
salt '*' service.get_all
u launchctl listu cmd.runu PIDu i ( R t
splitlinest
startswitht splitt listR3 t keyst sortedt set( R1 t linet
service_linest service_labels_from_listt service_labels_from_services( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt get_all� s
&c C@ sY t r d j | � } n d j | � } t d | d t d | �} | d rQ d S| d S( Nu launchctl list -x {0}u launchctl list {0}u cmd.run_allR t runasu stderru stdout( R R R R t None( t job_labelRH R1 t launchctl_data( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt _get_launchctl_data� s
c C@ s t | � r t St S( u�
Check that the given service is available.
CLI Example:
.. code-block:: bash
salt '*' service.available com.openssh.sshd
( R; t TrueR ( RJ ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt available� s
c C@ s t | � r t St S( u�
The inverse of service.available
Check that the given service is not available.
CLI Example:
.. code-block:: bash
salt '*' service.missing com.openssh.sshd
( R; R RM ( RJ ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt missing� s c
C@ s( t t j d | � � } | r6 t j t � | � } n | g } i } x� | D]� } t | � } | rr | d d n | } t | d | �} | rt r� t j
r� d t j | � k | | <qd t
t j | � � k | | <qd } t j | | � r� t n t | | <qL t | | <qL W| r | S| | S( uJ
Return the status for a service via systemd.
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
runas (str): User to run launchctl commands
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>
u \*|\?|\[.+\]u plistu LabelRH u PIDu "PID" = [0-9]+;( t boolt ret searcht fnmatcht filterRG R; RL R R t PY3R t loadsR R" RM R (
R6 RH t contains_globbingR7 t resultsR8 t service_infot lookup_nameRK t pattern( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt status� s(
"%c C@ sJ t | � } | rF d j | d d | �} t d | d | d t � St S( u�
Stop the specified service
CLI Example:
.. code-block:: bash
salt '*' service.stop <service label>
salt '*' service.stop org.ntp.ntpd
salt '*' service.stop /System/Library/LaunchDaemons/org.ntp.ntpd.plist
u launchctl unload -w {0}u file_pathRH u cmd.retcodeR ( R; R R R ( RJ RH R8 R1 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt stop s c C@ sJ t | � } | rF d j | d d | �} t d | d | d t � St S( u�
Start the specified service
CLI Example:
.. code-block:: bash
salt '*' service.start <service label>
salt '*' service.start org.ntp.ntpd
salt '*' service.start /System/Library/LaunchDaemons/org.ntp.ntpd.plist
u launchctl load -w {0}u file_pathRH u cmd.retcodeR ( R; R R R ( RJ RH R8 R1 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt start' s
c C@ s t | d | �t | d | �S( u�
Restart the named service
CLI Example:
.. code-block:: bash
salt '*' service.restart <service label>
RH ( R] R^ ( RJ RH ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt restart; s
c C@ sH t t j d � � } | j | t � r@ | | d r9 t St Sn t Sd S( u�
Return True if the named service is enabled, false otherwise
CLI Example:
.. code-block:: bash
salt '*' service.enabled <service label>
u4 /var/db/launchd.db/com.apple.launchd/overrides.plistu DisabledN( R R R t getR RM ( RJ RH t overrides_data( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt enabledI s
c C@ sH t t j d � � } | j | t � r@ | | d r9 t St Sn t Sd S( u�
Return True if the named service is disabled, false otherwise
CLI Example:
.. code-block:: bash
salt '*' service.disabled <service label>
u4 /var/db/launchd.db/com.apple.launchd/overrides.plistu DisabledN( R R R R` R RM ( RJ RH Ra ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt disabled_ s
(. t __doc__t
__future__R R R t loggingR
R RS RQ t salt.utils.dataR t salt.utils.filest salt.utils.patht salt.utils.platformt salt.utils.stringutilst salt.utils.decoratorsR t
decoratorst salt.utils.versionsR R
t salt.extR t getLoggert __name__t logR RM R R R t memoizeR3 R; RG RI RL RN RO R\ R] R^ R_ Rb Rc ( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/launchctl_service.pyt <module> s> 4
4
Mini Shell