File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/mac_service.cpython-310.pyc
Back
o ;j�N � @ s> d Z ddlZddlZddlZddlZddlZddlZddlm Z ddl m Z dZ ddiZ e�e�Zdd d d d �Zd d� Zdd� Zdd� Zdd� Zd:dd�Zdd� Zdd� Zd d � Zd;d d�Zd<d d �Zd<d!d"�Z d<d#d$�Z d<d%d&�Z d<d'd(�Z d;d)d*�Z d+d,� Z!d-d.� Z"d<d/d0�Z#d=d2d3�Z$d<d4d5�Z%d<d6d7�Z&d<d8d9�Z'dS )>az The service module for macOS .. versionadded:: 2016.3.0 This module has support for services in the following locations. .. code-block:: bash /System/Library/LaunchDaemons/ /System/Library/LaunchAgents/ /Library/LaunchDaemons/ /Library/LaunchAgents/ # As of version "2019.2.0" support for user-specific services were added. /Users/foo/Library/LaunchAgents/ .. note:: As of the 2019.2.0 release, if a service is located in a ``LaunchAgent`` path and a ``runas`` user is NOT specified, the current console user will be used to properly interact with the service. .. note:: As of the 3002 release, if a service name of ``salt-minion`` is passed this module will convert it over to it's macOS equivalent name, in this case to ``com.saltstack.salt.minion``. This is true for ``salt-master`` ``salt-api``, and ``salt-syndic`` as well. � N)�CommandExecutionError)�Version�service�list_�listzcom.saltstack.salt.minionzcom.saltstack.salt.masterzcom.saltstack.salt.apizcom.saltstack.salt.syndic)z salt-minionz salt-masterzsalt-apiz salt-syndicc C sP t jj�� sdS t jj�d�sdS t jj�d�sdS ttd �td�k r&dS tS ) z' Only for macOS with launchctl )FzGFailed to load the mac_service module: Only available on macOS systems.� launchctl)FzMFailed to load the mac_service module: Required binary not found: "launchctl"Zplutil)FzJFailed to load the mac_service module: Required binary not found: "plutil"Z osreleasez10.11)FzDFailed to load the mac_service module: Requires macOS 10.11 or newer) �salt�utils�platformZ is_darwin�path�whichr Z __grains__�__virtualname__� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/mac_service.py� __virtual__: s r c C sd | |v r|| S |� � D ]"}|d �� | kr| S tj�|d �\}}|�� | kr.| S q t� S )a+ Checks to see if the given service is in the given services. :param str name: Service label, file name, or full path :param dict services: The currently available services. :return: The service information for the service, otherwise an empty dictionary :rtype: dict � file_path� file_name)�values�lower�osr �splitext�dict)�name�servicesr �basename�extr r r �_name_in_services[ s �r c C s� t d � }t�| | ��� } t| |�}|r|S z td s"td| � ���W n ty, Y nw t�d�dkr;td| � ���t d dd�}t| |�}|sPtd| � ���|S )z� Get information about a service. If the service is not found, raise an error :param str name: Service label, file name, or full path :return: The service information for the service, otherwise an Error :rtype: dict � mac_utils.available_servicesZusing_cached_serviceszService not found: z service.stateZdeadT)Zrefresh)� __utils__�SALT_MAC_SERVICES�getr r � __context__r �KeyError)r r r r r r � _get_servicex s& � � r# c C s� t | �}z|d d }W n ty Y dS w t|t�rC|�di ��� D ] \}}|du r5tj�|�r5 dS |du rBtj�|�sB dS q$|du rIdS dS )aQ Check if the service should always be running based on the KeepAlive Key in the service plist. :param str name: Service label, file name, or full path :return: True if the KeepAlive key is set to True, False if set to False or not set in the plist at all. :rtype: bool .. versionadded:: 2019.2.0 �plistZ KeepAliveFZ PathStateT) �showr" � isinstancer r �itemsr r �exists)r Z service_infoZ keep_aliveZ_file�valuer r r �_always_running_service� s � �r* Fc C sT t | �}|d }d}d|v rtd � }d|� �}|du r&d�||d d �}||fS ) a Returns the domain/service target and path for a service. This is used to determine whether or not a service should be loaded in a user space or system space. :param str name: Service label, file name, or full path :param bool service_target: Whether to return a full service target. This is needed for the enable and disable subcommands of /bin/launchctl. Defaults to False :return: Tuple of the domain/service target and the path to the service. :rtype: tuple .. versionadded:: 2019.2.0 r �system� LaunchAgents�mac_utils.console_userzgui/Tz{}/{}r$ �Label)r# r �format)r �service_targetr r � domain_target�uidr r r �_get_domain_target� s r3 c C s t | �d }d|vr dS dS )z� Checks to see if the provided service is a LaunchAgent :param str name: Service label, file name, or full path :return: True if a LaunchAgent, False if not. :rtype: bool .. versionadded:: 2019.2.0 r r, FT�r# )r r r r r � _launch_agent� s r5 c C s t | �S )a� Show properties of a launchctl service :param str name: Service label, file name, or full path :return: The service information if the service is found :rtype: dict CLI Example: .. code-block:: bash salt '*' service.show org.cups.cupsd # service label salt '*' service.show org.cups.cupsd.plist # file name salt '*' service.show /System/Library/LaunchDaemons/org.cups.cupsd.plist # full path r4 �r r r r r% s r% c O s t d | g|�R i |��S )a� Run a launchctl command and raise an error if it fails :param str sub_cmd: Sub command supplied to launchctl :param tuple args: Tuple containing additional arguments to pass to launchctl :param dict kwargs: Dictionary containing arguments to pass to ``cmd.run_all`` :param bool return_stdout: A keyword argument. If true return the stdout of the launchctl command :return: ``True`` if successful, raise ``CommandExecutionError`` if not, or the stdout of the launchctl command if requested :rtype: bool, str CLI Example: .. code-block:: bash salt '*' service.launchctl debug org.cups.cupsd zmac_utils.launchctl)r )Zsub_cmd�args�kwargsr r r r % s r c C sP | r!t | �}|d d }|st| �rtd dd�}td|d|d�S tdd|d�S )a� Run launchctl list and return the output :param str name: The name of the service to list :param str runas: User to run launchctl commands :return: If a name is passed returns information about the named service, otherwise returns a list of all services and pids :rtype: str CLI Example: .. code-block:: bash salt '*' service.list salt '*' service.list org.cups.cupsd r$ r. r- T��usernamer �Z return_stdout�runas)r# r5 r r )r r< r �labelr r r r A s c C � t | dd�d }td||d�S )a� Enable a launchd service. Raises an error if the service fails to be enabled :param str name: Service label, file name, or full path :param str runas: User to run launchctl commands :return: ``True`` if successful or if the service is already enabled :rtype: bool CLI Example: .. code-block:: bash salt '*' service.enable org.cups.cupsd T�r0 r �enable�r< �r3 r �r r< r0 r r r r@ e s r@ c C r> )a� Disable a launchd service. Raises an error if the service fails to be disabled :param str name: Service label, file name, or full path :param str runas: User to run launchctl commands :return: ``True`` if successful or if the service is already disabled :rtype: bool CLI Example: .. code-block:: bash salt '*' service.disable org.cups.cupsd Tr? r �disablerA rB rC r r r rD } s rD c C � t | �\}}td|||d�S )a Start a launchd service. Raises an error if the service fails to start .. note:: To start a service in macOS the service must be enabled first. Use ``service.enable`` to enable the service. :param str name: Service label, file name, or full path :param str runas: User to run launchctl commands :return: ``True`` if successful or if the service is already running :rtype: bool CLI Example: .. code-block:: bash salt '*' service.start org.cups.cupsd � bootstraprA rB �r r< r1 r r r r �start� s rH c C rE )a@ Stop a launchd service. Raises an error if the service fails to stop .. note:: Though ``service.stop`` will unload a service in macOS, the service will start on next boot unless it is disabled. Use ``service.disable`` to disable the service :param str name: Service label, file name, or full path :param str runas: User to run launchctl commands :return: ``True`` if successful or if the service is already stopped :rtype: bool CLI Example: .. code-block:: bash salt '*' service.stop org.cups.cupsd ZbootoutrA rB rG r r r �stop� s rI c C s0 t d | |d�rt d | |d� t d | |d�S )aj Unloads and reloads a launchd service. Raises an error if the service fails to reload :param str name: Service label, file name, or full path :param str runas: User to run launchctl commands :return: ``True`` if successful :rtype: bool CLI Example: .. code-block:: bash salt '*' service.restart org.cups.cupsd zservice.loadedrA z service.stopz service.start��__salt__�r r< r r r �restart� s rM c C s� |rt d |�S zt| � W n ty& } z t�|� W Y d}~dS d}~ww |s4t| �r4td dd�}z t d | |d�}W n tyH Y dS w t| �rUd |v rSdS dS dS ) a Return the status for a service. .. note:: Previously this function would return a PID for a running service with a PID or 'loaded' for a loaded service without a PID. This was changed to have better parity with other service modules that return True/False. :param str name: Used to find the service from launchctl. Can be the service Label, file name, or path to the service file. (normally a plist) :param str sig: Find the service with status.pid instead. Note that ``name`` must still be provided. :param str runas: User to run launchctl commands. :return: True if running, otherwise False. :rtype: str CLI Example: .. code-block:: bash salt '*' service.status cups z status.pidNFr- Tr9 � service.listrA z"PID" =)rK r# r �log�errorr5 r r* )r �sigr< �msg�outputr r r �status� s& �� �rT c C s$ zt | � W dS ty Y dS w )a Check that the given service is available. :param str name: The name of the service :return: True if the service is available, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' service.available com.openssh.sshd TF)r# r r6 r r r � available s �rU c C s t | � S )a? The inverse of service.available Check that the given service is not available. :param str name: The name of the service :return: True if the service is not available, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' service.missing com.openssh.sshd )rU r6 r r r �missing2 s rV c C s t d | |� S )a� Check if the specified service is enabled (not disabled, capable of being loaded/bootstrapped). .. note:: Previously this function would see if the service is loaded via ``launchctl list`` to determine if the service is enabled. This was not an accurate way to do so. The new behavior checks to make sure its not disabled to determine the status. Please use ``service.loaded`` for the previous behavior. :param str name: The name of the service to look up. :param str runas: User to run launchctl commands. :return: True if the specified service enabled, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' service.enabled org.cups.cupsd zservice.disabledrJ rL r r r �enabledE s rW r+ c s� t | dd�d }td|d|d�}|�d�D ]5}| |v rJ|�d�d �d�d }|�d�d � | |kr3qd d g}t� fd d �|D ��rFd S d S qdS )a� Check if the specified service is not enabled. This is the opposite of ``service.enabled`` :param str name: The name to look up :param str runas: User to run launchctl commands :param str domain: domain to check for disabled services. Default is system. :return: True if the specified service is NOT enabled, otherwise False :rtype: bool CLI Example: .. code-block:: bash salt '*' service.disabled org.cups.cupsd Tr? r zprint-disabledr; � z=>�"� �true�disabledc s g | ]}|� � � v �qS r )r )�.0�x�rT r r � <listcomp>� s z disabled.<locals>.<listcomp>F)r3 r �split�any)r r< �domainr\ r Zsrv_name�matchesr r_ r r\ c s &� r\ c C s, t | d�}ttd � �� �}tt|| ��S )aD Return a list of services that are enabled or available. Can be used to find the name of a service. :param str runas: User to run launchctl commands :return: A list of all the services available or enabled :rtype: list CLI Example: .. code-block:: bash salt '*' service.get_all rA r )� get_enabledr r �keys�sorted�set)r< rW rU r r r �get_all� s ri c C s\ t | d�}dd� |�� D �}g }|D ]}|�d�rq|�d�\}}}|�|� qtt|��S )a@ Return a list of all services that are enabled. Can be used to find the name of a service. :param str runas: User to run launchctl commands :return: A list of all the services enabled on the system :rtype: list CLI Example: .. code-block:: bash salt '*' service.get_enabled rA c S s g | ]}|�qS r r )r] �liner r r r` � s z get_enabled.<locals>.<listcomp>ZPID� )r � splitlines� startswithra �appendrg rh )r< �stdoutZ service_linesrW rj �pidrT r= r r r re � s re c C s, z t d | |d� W dS ty Y dS w )a^ Check if the specified service is loaded. :param str name: The name of the service to look up :param str runas: User to run launchctl commands :return: ``True`` if the specified service is loaded, otherwise ``False`` :rtype: bool CLI Example: .. code-block:: bash salt '*' service.loaded org.cups.cupsd rN rL TF)rK r rL r r r �loaded� s �rq )F)NN)N)Nr+ )(�__doc__�loggingr Zsalt.utils.filesr Zsalt.utils.pathZsalt.utils.platformZsalt.utils.stringutilsZsalt.exceptionsr Zsalt.utils.versionsr r Z__func_alias__� getLogger�__name__rO r r r r# r* r3 r5 r% r r r@ rD rH rI rM rT rU rV rW r\ ri re rq r r r r �<module> sP � �! 3 () $ 5 $ !
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings