Current File : //lib/python2.7/site-packages/salt/utils/mac_utils.pyo
�
���^c @@ s d Z d d l 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
y d d l Z Wn e k
r� n Xd 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 m Z m Z m Z d d l m Z d d l m Z e j j j � d Z! e j" e# � Z$ d Z% i e j& j' j( d 6e j& j' j) d
6Z* e j+ r�d e, f d � � YZ- e- e _- n d
� Z. d � Z/ d � Z0 d � Z1 d � Z2 d � Z3 d � Z4 e5 d d � Z6 d � Z7 e5 d � Z8 e5 d � Z9 e5 d � Z: d S( uD
Helper functions for use by mac modules
.. versionadded:: 2016.3.0
i ( t absolute_importt unicode_literalsN( t CommandExecutionErrort SaltInvocationErrort TimedProcTimeoutError( t range( t sixu shellu mac_utilsu cmd.run_allu cmd.runt InvalidFileExceptionc B@ s e Z RS( ( t __name__t
__module__( ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyR 2 s c C@ s t j j j � s t d f St S( u
Load only on Mac OS
uO The mac_utils utility could not be loaded: utility only works on MacOS systems.( t saltt utilst platformt is_darwint Falset __virtualname__( ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt __virtual__7 s
c
C@ s7 t | t � s- t j j j | d t �} n xJ t | � D]< \ } } t | | t j � s: t j
| | � | | <q: q: Wd j | � } t j
j � } i d d 6t d 6| d 6d d 6t j d 6t j d 6t d 6d d
6t d 6} y t j j j | | � } Wn4 t t f k
r5} t d j | | | � � � n Xi } y | j � WnK t k
r�} t j
| � | d <d
| d <d | d <| j j | d <| SX| j | j } } | d k r�t j j j! | � j" � } n | d k r�t j j j! | � j" � } n | j j | d <| j j# | d <| | d <| | d <| S( u,
Args:
cmd:
Returns:
t posixu u cwdu shellu envu stdinu stdoutu stderru with_communicateu timeoutu bgu? Unable to run command '{0}' with the context '{1}', reason: {2}u i u retcodeu pidN($ t
isinstancet listR
R t argst shlex_splitR t enumerateR t string_typest text_typet joint ost environt copyt Nonet
DEFAULT_SHELLt
subprocesst PIPEt Truet timed_subprocesst TimedProct OSErrort IOErrorR t formatt runR t processt pidt stdoutt stderrt stringutilst to_strt rstript
returncode(
t cmdt idxt itemt run_envt kwargst proct exct rett outt err( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt _run_allB sR
c C@ s$ | d j � } d | k r t St S( u�
helper class to check the launchctl stderr.
launchctl does not always return bad exit code
if there is a failure
u stderru service is disabled( t lowerR! R ( R7 R9 ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt _check_launchctl_stderr� s c C@ s� t | � } t j d | | � | d d k sE d | d j � k r� d j | � } | d j | d � 7} | d j | d � 7} | d j | d
� 7} t | � � n t S( u�
Executes the passed command. Returns True if successful
:param str cmd: The command to run
:return: True if successful, otherwise False
:rtype: bool
:raises: Error if command fails or is not supported
u Execute return success %s: %ru retcodei u
not supportedu stdoutu Command Failed: {0}
u Return Code: {0}
u Output: {0}
u Error: {0}
u stderr( R: t logt debugR; R& R R! ( R0 R7 t msg( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt execute_return_success� s &c C@ s� t | � } | d d k s2 d | d j � k r� d j | � } | d j | d � 7} | d j | d � 7} | d j | d � 7} t | � � n | d S(
u
Executes the passed command. Returns the standard out if successful
:param str cmd: The command to run
:return: The standard out of the command if successful, otherwise returns
an error
:rtype: str
:raises: Error if command fails or is not supported
u retcodei u
not supportedu stdoutu Command Failed: {0}
u Return Code: {0}
u Output: {0}
u Error: {0}
u stderr( R: R; R& R ( R0 R7 R? ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt execute_return_result� s &c C@ sB d | k r | j d � d Sd | k r: | j d � d S| Sd S( u
Returns the data portion of a string that is colon separated.
:param str data: The string that contains the data to be parsed. Usually the
standard out from a command
For example:
``Time Zone: America/Denver``
will return:
``America/Denver``
u : i u :
N( t split( t data( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt parse_return� s
c C@ sp t | t j � r\ | j � d k rB d j | � } t | � � n | j � d k rX d Sd St | � rl d Sd S( u�
Helper function to validate the enabled parameter. Boolean values are
converted to "on" and "off". String values are checked to make sure they are
either "on" or "off"/"yes" or "no". Integer ``0`` will return "off". All
other integers will return "on"
:param enabled: Enabled can be boolean True or False, Integers, or string
values "on" and "off"/"yes" and "no".
:type: str, int, bool
:return: "on" or "off" or errors
:rtype: str
u onu offu yesu noul
Mac Power: Invalid String Value for Enabled.
String values must be 'on' or 'off'/'yes' or 'no'.
Passed: {0}( u onu offu yesu no( u onu yes( R R R R; R& R t bool( t enabledR? ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt validate_enabled� s i c C@ so xh t | � D]Z } | r( t | � � n | � } t j d | | | | � | | k rZ t St j d � q
Wt S( u�
Wait up to ``wait`` seconds for a system parameter to be changed before
deciding it hasn't changed.
:param str value: The value indicating a successful change
:param function check_fun: The function whose return is compared with
``value``
:param bool normalize_ret: Whether to normalize the return from
``check_fun`` with ``validate_enabled``
:param int wait: The maximum amount of seconds to wait for a system
parameter to change
u0 Confirm update try: %d func:%r state:%s value:%si ( R RG R= R> R! t timet sleepR ( t valuet check_funt
normalize_rett waitt it state( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt confirm_updated� s c O@ s� | j d t � } d | g } | j | � t | d <t j j j | � } t d | | � } t | � } | d sy | r� d j | � } | d j | d � 7} | d j | d
� 7} | d j | d � 7} t
| � � n | r� | d St Sd S(
u�
Run a launchctl command and raise an error if it fails
Args: additional args are passed to launchctl
sub_cmd (str): Sub command supplied to launchctl
Kwargs: passed to ``cmd.run_all``
return_stdout (bool): A keyword argument. If true return the stdout of
the launchctl command
Returns:
bool: ``True`` if successful
str: The stdout of the launchctl command if requested
Raises:
CommandExecutionError: If command fails
CLI Example:
.. code-block:: bash
import salt.utils.mac_service
salt.utils.mac_service.launchctl('debug', 'org.cups.cupsd')
u
return_stdoutu launchctlu python_shellu cmd.run_allu retcodeu Failed to {0} service:
u stdout: {0}
u stdoutu stderr: {0}
u stderru retcode: {0}N( t popR t extendR
R R t clean_kwargst __salt__R< R& R R! ( t sub_cmdR R4 t
return_stdoutR0 R7 t errorR8 ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt launchctl s
c
C@ s
y4 t d r3 | r3 t j d � t t d <t d SWn t k
rG n Xd d d d g } yO xH t j d � D]7 } d j | � } t j j | � rm | j
| � qm qm WWn t k
r� n Xt � } x%| D] } xt
j j j | � D]�\ } } } x�| D]�} | j d
� sq� n t j j | | � }
t j j |
� } t j d | � t j j | � siq� n yO t j r�t j | � } n0 t
j j j | d � � }
t j |
� } Wd
QXWn� t j k
r�d } t j | | � q� n� t j j! j" k
r�t j# r"d } t j | | � q� n d j | � } y# t$ d | � } t j% | � } Wq�t j j! j" k
r�d } t j | | � q� q�Xn Xy- i | d 6| d 6| d 6| | d j& � <Wq� t k
r�t j d | � q� q� Xq� Wq� Wq� W| t d <t' t d <t d S( u�
This is a helper function for getting the available macOS services.
The strategy is to look through the known system locations for
launchd plist files, parse them, and use their information for
populating the list of services. Services can run without a plist
file present, but normally services which have an automated startup
will have a plist file, so this is a minor compromise.
u available_servicesu% Found context for available services.u using_cached_servicesu /Library/LaunchAgentsu /Library/LaunchDaemonsu /System/Library/LaunchAgentsu /System/Library/LaunchDaemonsu /Users/u /Users/{}/Library/LaunchAgentsu .plistu Gathering service info for %su rbNu@ Unable to parse "%s" as it is invalid XML: InvalidFileException.uH Unable to parse "%s" as it is invalid XML: xml.parsers.expat.ExpatError.u+ /usr/bin/plutil -convert xml1 -o - -- "{0}"u cmd.runu file_nameu file_pathu plistu Labelu2 Service %s does not contain a Label key. Skipping.(( t __context__R= R> R! t KeyErrorR t listdirR& t patht isdirt appendR$ t dictR
R t os_walkt endswithR t realpatht tracet existsR t PY2t plistlibt readPlistt filest fopent loadR t loggingt warningt xmlt parserst expatt
ExpatErrort PY3RT t readPlistFromStringR; R ( t refresht
launchd_pathst usert
agent_patht _available_servicest
launch_dirt roott dirsRh t file_namet file_patht true_patht plistt handleR? R0 t plist_xml( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyRw = s�
%
c C@ s t j d � t | � S( ut
Return a dictionary of all available services on the system
:param bool refresh: If you wish to refresh the available services
as this data is cached on the first run.
Returns:
dict: All available services
CLI Example:
.. code-block:: bash
import salt.utils.mac_service
salt.utils.mac_service.available_services()
u Loading available services( R= R> Rw ( Rs ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt available_services� s
c C@ sX y t j d � d } Wn# t t f k
r< t d � � n X| rT t j | � d S| S( u�
Gets the UID or Username of the current console user.
:return: The uid or username of the console user.
:param bool username: Whether to return the username of the console
user instead of the UID. Defaults to False
:rtype: Interger of the UID, or a string of the username.
Raises:
CommandExecutionError: If we fail to get the UID.
CLI Example:
.. code-block:: bash
import salt.utils.mac_service
salt.utils.mac_service.console_user()
u /dev/consolei u) Failed to get a UID for the console user.i ( R t statR$ t
IndexErrorR t pwdt getpwuid( t usernamet uid( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt console_user� s (; t __doc__t
__future__R R Rk R R Rf RH t xml.parsers.expatRm R� t ImportErrort salt.modules.cmdmodR
t salt.utils.argst salt.utils.filest salt.utils.patht salt.utils.platformt salt.utils.stringutilst salt.utils.timed_subprocesst salt.grains.extrat salt.exceptionsR R R t salt.ext.six.movesR t salt.extR t grainst extrat shellR t getLoggerR R= R t modulest cmdmodt _run_all_quiett
_run_quietRT Re t ExceptionR R R: R< R@ RA RD RG R RP RX Rw R� R� ( ( ( s8 /usr/lib/python2.7/site-packages/salt/utils/mac_utils.pyt <module> sV
B 1 l
Mini Shell