Current File : //lib/python2.7/site-packages/salt/modules/cmdmod.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 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 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$ d d l% m& Z& m' Z' m( Z( d d l) m* Z* d d l+ m, Z, m- Z- m. Z. y d d l/ Z/ d d l0 Z0 Wn e1 k
rn Xe j2 j3 j4 � rAd d l5 m6 Z7 d d l8 m9 Z: e; Z< n d d
l+ m= Z: e> Z< d g Z? d Z@ e jA eB � ZC e jD jE jF � d
ZG d � ZH d � ZI d � ZJ d � ZK d eL eL d � ZM d d � ZN d � ZO d � ZP d � ZQ eL eL e
jR e
jR eL d eL eL eL eG e> eL e> eL e; eL eL eL e; e; e> d eL eL e> eL e> e> eL d � ZS eL eL eL eL eG e> eL eL eL eL e; d eL eL eL d � ZT eL eL eL eG e> eL eL eL eL e; d eL eL eL eL d � ZU eL eL eL eL eG eL eL e> eL e; eL eL d eL e> eL e; e> d e> e> eL e> e> eL eL d � ZV eL eL eL eL eG eL e> eL e; eL eL d eL e> eL e; e> d e> e> eL eL eL d � ZF eL eL eL eL eG eL eL e> eL e; eL eL d eL e> eL e; e> d e> eL eL eL d � ZW eL eL eL eL eG eL eL e> eL e; eL eL d eL e> eL e; e> d e> eL eL eL d � ZX eL eL eL eL eG eL eL e> eL e; eL eL d eL e> eL e; e> d e> e> eL e> eL eL d! � ZY eL eL eL eL eG eL eL e> eL eL eL d eL eL e; e> d e> eL eL d" � ZZ eL eL eL eL eG e> eL e> eL eL eL eL eL e; e> d e> eL eL d# � Z[ eL eL eL eL eL eG eL eL eL eL eL d eL e> eL e; d e> e> eL eL d$ � Z\ eL eL eL eL eL eG eL eL d% eL eL e; d eL d eL e> eL eL d& � Z] d' � Z^ d( � Z_ d) � Z` eL eL d* � Za eL eL d+ � Zb d, d- � Zc eL eL eL eL eG e; eL e> eL e; eL eL d. eL e> eL e; e> d e> e> eL d/ � Zd d0 � Ze d1 � Zf e> d2 � Zg eL eL eL eG eL e> eL e; eL eL d e> eL e; e> d e> eL eL e> eL d3 � Zh eL eL eL eG eL e> eL e; eL eL d e> eL e; e> d e> eL eL e> e> eL d4 � Zi eL eL eL eG eL eL e> eL eL eL eL d eL e; e> d eL eL eL d5 � Zj d S(6 u�
A module for shelling out.
Keep in mind that this module is insecure, in that it can give whomever has
access to the master root execution access to all salt minions.
i ( t absolute_importt print_functiont unicode_literalsN( t six( t CommandExecutionErrort TimedProcTimeoutErrort SaltInvocationError( t
LOG_LEVELS( t ranget zipt map( t runas( t escape_argument( t shlex_quoteu *u cmdu shellc C@ s t S( N( t __virtualname__( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt __virtual__K s c C@ s6 | d k r/ t | d � r | St j d � n d � S( uh
If the callback is None or is not callable, return a lambda that returns
the value passed.
u __call__u& log_callback is not callable, ignoringc S@ s | S( N( ( t x( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt <lambda>Y s N( t Nonet hasattrt logt error( t cb_( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _check_cbO s
c C@ sZ yB | r | d k r t St j d t � t k rA | d k rA t SWn t k
rU n X| S( uU
Set python_shell default based on remote execution and __opts__['cmd_safe']
u cmd_safeN( R t Truet __opts__t gett Falset NameError( t python_shellt __pub_jid( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _python_shell_default\ s $
c C@ s� g } x~ t j d � D]m } yS t j j | � } | j | � rn | j t t j j t j j | � � � � n Wq t k
r� q Xq W| S( Nu /proc/[0-9]*/root(
t globt ost patht realpatht
startswitht appendt intt basenamet dirnamet OSError( t chroott pidst roott link( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _chroot_pidsm s
u basec @ s� � s | | f S� t j j j k r= t d j � � � � n i � t � d <| d k se | d k r� | pr t d } t | | � � d <n
t
� d <t � d <t � d <| � d <� � f d � } | | � } | | � } | | f S(
ub
If template is a valid template engine, process the cmd and cwd through
that engine.
u: Attempted to render file paths with unavailable engine {0}u saltu pillarenvu pillaru grainsu optsu saltenvc @ s� t j j j � } t j j j | d � �# } | j t j j j | � � Wd QXt j j j � | d t
� �} t j j j | � | d s� t d j
| d � � � n | d Sd S( Nu w+t to_stru resultu% Failed to execute cmd with error: {0}u data( t saltt utilst filest mkstempt fopent writet stringutilsR/ t templatest TEMPLATE_REGISTRYR t safe_rmR t format( t contentst tmp_path_fnt fp_t data( t kwargst template( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _render� s "
N( R0 R1 R7 R8 R R: t __salt__R R t _gather_pillart
__pillar__t
__grains__( t cmdt cwdR@ t saltenvt pillarenvt pillar_overrideRA ( ( R? R@ s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _render_cmd{ s&
u infoc C@ ss y( | j � } | d k r d St | SWnD t t f k
rn t j d | d j t t d t �� � t d SXd S( uB
Retrieve the level code for use in logging.Logger.log().
u quietuK Invalid output_loglevel '%s'. Valid levels are: %s. Falling back to 'info'.u , t reverseu infoN(
t lowerR R t AttributeErrort KeyErrorR R t joint sortedR ( t level( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _check_loglevel� s c C@ sR | s i } n t | t � r6 t j j j | � } n t | t � sN i } n | S( N( t
isinstancet listR0 R1 R> t repack_dictlistt dict( t env( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
_parse_env� s c C@ sd t j j t t t d t d d | d | �} | j � } | r` t | t � r` | j | � n | S( uC
Whenever a state run starts, gather the pillar data fresh
u idu saltenvRJ RI ( R0 t pillart
get_pillarR RE t compile_pillarRT RW t update( RI RJ RZ t ret( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyRC � s
c C@ s t | t � rU d j g | D]- } t | t j � sC t j | � n | ^ q � } n t } t } t d d � r� t d d g � } x, | D]! } t j | | � r� t } q� q� Wn t d d g � r t d d g � } x3 | D]" } t j | | � r� t } Pq� q� Wn t } | o| S( u6
Check to see if the given command can be run
u u
config.getu cmd_blacklist_globu cmd_whitelist_glob(
RT RU RP R t string_typest text_typeR R RB t fnmatch( RF R t brett wrett blistt comp( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _check_avail� s$ =
u debugc > & K@ s� d | k r | r | d } n | d k rQ t |
� t k rQ t j d |
� n t | � } t | � } t } | d- k r� d t � k r� t j d � } n | d- k r� d t � k r� t j d � } n | sAt
j j d j
| s� d n | � � } t
j | t
j � sPd } t j j j � r>t
j j t
j � } q>qPn t j | � } | ret } t } n t j j j � s�t
j j |
� s�t
j |
t
j � r�d
j
|
� } t | � � q�n t j j j � r�| r�t d � � n |
j � j � d k r�t | t j � r!| j � } n t j! d
d � }! |! d d d k rTd | } q�| rld j
| � } q�d j
| j" d d � � } n t# | | | | | | � \ } } i }" d | k r�t$ | � s�t d j
| � � � q�n t% | � } x; d � t j& | � D� D] }# t j' d |# � d | |# <q
Wd � }$ | d- k r�d j
t | t( � s^d n d |$ | � | rd j
| � n d | r�d j
| � n d | | r�d n d � } t j) | | � � n | r5t j j j � r5t* s�d } t | � � n t | t( t+ f � r"d! j, | � } n t- | | | | � S| r�t j j j. � r�t | t( t+ f � r}d! j, t/ t0 | � � } n d" j
d# t0 | � d$ | � } d% j
d$ t0 | � � } d& j
t0 | � t0 | � � } d- } n | r y t1 j2 | � Wq t3 k
rt d' j
| � � � q Xn | r�t j j j � rJd( } t4 | � � n t5 d) g � snd* } t | � � n y t6 j7 | � Wn& t3 k
r�t d+ j
| � � � q�Xt } n | s�| r� y�d, d- l8 }% d. t9 |% j: � � d/ }& |& j; t< � }' d0 |& d1 |& d2 }( | r�d) g }) | r6|) j= d3 | g � n | rR|) j= d4 | g � n |
t> k rz|) j= d5 d6 |
d7 g � n |) j= d8 d6 g � |) j= t? j@ g � n� tA d9 d� k r�d; d< | d7 d= j
|
t? j@ � f }) nt tA d> d� k rd; d< | d7 t? j@ f }) nI tA d> d� k r0d; d< | d7 t? j@ f }) n d; d5 |
d< | d7 t? j@ f }) dA j
|) � } t jB | | � � tC jD |) dB tC jE dC tC jE dD tC jE �jF t j jG jH |( � � \ }* }+ |* jI |' � }, |, d, k r�t j' dE | |+ |* � dF }* nN |, d k r-t dG dH i tJ |+ � dI 6tJ |* � dJ 6�� n |* jK |' � dK }* t jL r�d, d- lM }- tN |- jO tP |* jK dL � � g d � � }. n: t jQ r�tN t( tR tP |* jK dL � � g d � � � }. n tN dM � t j& |. � D� � }. |. jS | � |. j dN � | k r | |. dN <n t
j j d j
| � � }/ |. j dO � |/ k rH |/ |. dO <n |. } Wq� tT k
r� }0 t jU dP | � t dQ j
| |0 � � � q� Xn | t k r�
t j j j � s�
| jV dR dS � | jV dT dS � | jV dU dS � | jV dV dS � | jV dW dS � | jV dX dS � | jV dY dS � | jV dZ dS � | jV d[ dS � | jV d\ dS � | jV d] dS � | jV d^ dS � | jV d_ dS � q�
| r�
d` | } q�
n |
r�
| }1 nL t j j j � r�
d, d- lW }2 |2 jX jY � }1 n t
jX jY � }1 |1 jS | � | r da j, | |1 db f � |1 db <n | d- k r- t } n i | dc 6| dd 6t jQ rM |1 n t j jZ j; |1 � de 6| d- k r~ t j | � n | df 6| dJ 6| dI 6| dg 6| dh 6| di 6}3 dj | k r� | dj |3 dj <n | d- k rL t j | � j[ dk � }4 |4 d k r
dl } t | � � n y t\ |4 dm � }4 WqR tT k
rH t dn j
| � � � qR Xn d- }4 | sd | sd | r� t] j^ t j j_ j` | |4 | � |3 do <n t j j j � s� |3 dd t k r� |
|3 dp <n t |3 dq <n t
j ja | � s� t
j jb | � r
t dr j
| � � � n | t k rM
t j j j � rM
t | t( � rM
t j jc jd | � } n | d- k re
d, g } nR y2 g t j jc je | � D] }5 t\ |5 � ^ q~
} Wn tT k
r�
t4 ds � � n X| s�y t j jf jg | |3 � }6 Wn� th ti f k
r{}0 dt j
| d- k r | n du |3 � } y9 |0 jj d- k r4| dv 7} n | dw j
|0 |0 jj � 7} Wn tk k
rk| dx 7} n Xt | � � n Xy |6 jl � WnU tm k
r�}0 t j |0 � |" dJ <d |" dI <d- |" dy <|6 jn jo |" dz <dK |" dy <|" SX| d k r| d- k rt jB d{ | | � n y" t j jG jp |6 jq d| | �}7 Wnj tr k
rKd }7 nT ts k
r�t j jG jp |6 jq d| | d} d~ �}7 | d k r�t j' d | � q�n Xy" t j jG jp |6 jt d| | �}8 Wnj tr k
r�d }8 nT ts k
r-t j jG jp |6 jt d| | d} d~ �}8 | d k r.t j' d� | � q.n X| rm|7 d- k rO|7 ju � }7 n |8 d- k rm|8 ju � }8 qmn |6 jn jo |" dz <|6 jn jv |" dy <|" dy | k r�d, |" dy <n |7 |" dJ <|8 |" dI <n�d }9 | r�d� j
| � }9 n | d- k rd� j
| |9 � } t jB | | � � n d� \ } } tw jw � }: | r>|: | }; n d� }; zt j jx jy | d� t d� t d� t d� | d� |3 j do d- � d� |1 d� | d� | d� | d� t d� t � }6 |6 jo |" dz <x�|6 jz rXy� y� tw j{ d� � y |6 j| � \ }< }= Wn ti k
r d� \ }< }= n X|< r | |< 7} n d }< |= r8| |= 7} n d }= | rztw jw � |; k rzd� j
| | � |" dI <d- |" dy <Pn Wn/ t} k
r�d� j
| � |" dI <dK |" dy <Pn XWnJ t j jx j~ k
r�}0 t j' d� |0 d� t j� �i dK dy 6d� dz 6}" Pn X| |" dJ <|6 j� � sH| |" dI <|6 j� |" dy <|" dy | k rHd, |" dy <qHn |6 jo |" dz <q�WWd- |6 j� d� t d� t � Xy% | r�d, t dy <n |" dy t dy <Wn t� k
r�n X| d- k r�| r|" dy d, k r| t� d� k r�t� d� } n d� j
| |" dy � } t j' | | � � n |" dJ rIt j | d� j
| |" dJ � � � n |" dI ryt j | d� j
| |" dI � � � n |" dy r�t j | d� j
|" dy � � q�n |" S(� u@
Do the DRY thing and only call subprocess.Popen() once
u pillaru quietu} Attempt to run a shell command with what may be an invalid shell! Check to ensure that the shell <%s> is valid for this user.u __context__u runasu runas_passwordu ~{0}u u /u The shell {0} is not availableu VT not available on windowsu
powershellt limiti i����u scriptuD Powershell -NonInteractive -NoProfile -ExecutionPolicy Bypass -File u. Powershell -NonInteractive -EncodedCommand {0}u+ Powershell -NonInteractive -NoProfile "{0}"u "u \"u __pub_jidu( The shell command "{0}" is not permittedc s@ s' | ] \ } } | d k r | Vq d S( N( R ( t .0R t y( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pys <genexpr>p s uR Environment variable '%s' passed without a value. Setting value to an empty stringc S@ sh t | t � rD g | D]* } t | t j � r: | j � n | ^ q St | t j � r` | j � S| Sd S( N( RT RU R R_ t strip( RF R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
_get_strippedu s
5
u7 Executing command {0}{1}{0} {2}{3}in directory '{4}'{5}u 'u as user '{0}' u in group '{0}' u@ . Executing command in the background, no output will be logged.u missing salt/utils/win_runas.pyu u cd -- {dir} && {{ {cmd}
}}t dirRF u /bin/bash -l -c {cmd}u su -l {0} -c {1}u User '{0}' is not availableu+ group is not currently available on Windowsu sudou* group argument requires sudo but not foundu Group '{0}' is not availablei Nu <<<u >>>u- import sys, os, itertools; sys.stdout.write("uY "); sys.stdout.write("\0".join(itertools.chain(*os.environ.items()))); sys.stdout.write("u ");u -uu -gu -su --u -cu -iu osu FreeBSDu suu -u
{0} -c {1}u os_familyu Solarisu AIXu env command: {0}t stderrt stdoutt stdinuE Environment could not be retrieved for user '%s': stderr=%r stdout=%rt u1 Environment could not be retrieved for user '{0}'t infou stderru stdouti t c s@ s? | ]5 \ } } t j j j | � t j j j | � f Vq d S( N( R0 R1 R6 R/ ( Rh t kt v( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pys <genexpr> s u USERu HOMEu/ Error raised retrieving environment for user %su6 Environment could not be retrieved for user '{0}': {1}u LC_CTYPEu Cu
LC_NUMERICu LC_TIMEu
LC_COLLATEu LC_MONETARYu LC_MESSAGESu LC_PAPERu LC_NAMEu
LC_ADDRESSu LC_TELEPHONEu LC_MEASUREMENTu LC_IDENTIFICATIONu LANGUAGEu chcp 437 > nul & u :u PATHu cwdu shellu envu stdinu with_communicateu timeoutu bgu stdin_raw_newlinesu 0u Zero umask is not allowed.i u Invalid umask: '{0}'u
preexec_fnu
executableu close_fdsu9 Specified cwd '{0}' either not absolute or does not existu+ success_retcodes must be a list of integersu< Unable to run command '{0}' with the context '{1}', reason: u REDACTEDu command not foundu {0}: {1}u unknownu retcodeu pidu1 Decoding output from command %s using %s encodingt encodingt errorsu replaceuT Failed to decode stdout from command %s, non-decodable characters have been replaceduT Failed to decode stderr from command %s, non-decodable characters have been replacedu (timeout: {0}s)u Running {0} in VT{1}i����t shellt
log_stdoutt
log_stderrRG t
preexec_fnRX t log_stdin_levelt log_stdout_levelt log_stderr_levelt
stream_stdoutt
stream_stderrg �?u SALT: Timeout after {0}s
{1}u SALT: User break
{0}u VT: %st exc_info_on_loglevelu 2t terminatet killu erroru* Command '{0}' failed with return code: {1}u stdout: {0}u stderr: {0}u retcode: {0}( u FreeBSD( u Solaris( u AIX( u u ( u u (� t _is_valid_shellR R t warningRS R R t globalst __context__R R! R" t
expanduserR: t accesst R_OKR0 R1 t platformt
is_windowst abspatht sepR R` R t isfilet X_OKR RM Rj RT R_ t tracebackt
extract_stackt replaceRK Rf RY t iteritemsR RU Rq t
HAS_WIN_RUNASt tupleRP t win_runast is_darwinR
t
_cmd_quotet pwdt getpwnamRO R t which_bint grpt getgrnamt uuidt strt uuid4t encodet __salt_system_encoding__t extendt
DEFAULT_SHELLt syst
executableRE t debugt
subprocesst Popent PIPEt communicateR6 t to_bytest countt reprt splitt PY2t itertoolsRW t izipt itert PY3R R] t
ValueErrort exceptiont
setdefaultt ntt environt copyR> t lstripR& t functoolst partialt usert chugid_and_umaskt isabst isdirt argst shlex_splitt split_inputt timed_subprocesst TimedProcR) t IOErrort filenameRN t runR t processt pidt
to_unicodeRn t TypeErrort UnicodeDecodeErrorRm t rstript
returncodet timet vtt Terminalt has_unread_datat sleept recvt KeyboardInterruptt TerminalExceptiont loggingt DEBUGt isalivet
exitstatust closeR R (> RF RG Ro Rn Rm t output_encodingt output_loglevelt log_callbackR t groupRw R RX t clean_envt prepend_pathR� R@ t umaskt timeoutt with_communicatet reset_system_localet ignore_retcodeRH RI RJ t use_vtt passwordt bgt encoded_cmdt success_retcodesR? t use_sudot msgt stackR^ t bad_env_keyRk R� t markert marker_bt py_codet env_cmdt env_bytest env_encoded_errt marker_countR� t env_runast
runas_homet exct run_envR� t
new_kwargst _umaskt it proct outt errt formatted_timeoutt nowt will_timeoutt cstdoutt cstderr( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _run� s� "
' )
!
. 1
%"
& #
&
&
#c & C@ s} t | d | d | d | d t j d | d d d d d | d
| d | d | d
| d |
d | d | d |
d | d | �d S( u@
Helper for running commands quietly for minion startup
R RG Ro Rm R� R� u quietR� Rw R RX R@ R� R� R� RH RI RJ R� u stdoutN( R R� t STDOUTR ( RF RG Ro R� R Rw R RX R@ R� R� R� RH RI RJ R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
_run_quietT s& c $ C@ sp t | d | d | d | d | d | d | d | d d d
d d | d | d
| d |
d | d | d |
d | �S( uj
Helper for running commands quietly for minion startup.
Returns a dict of return data.
output_loglevel argument is ignored. This is here for when we alias
cmd.run_all directly to _run_all_quiet in certain chicken-and-egg
situations where modules need to work both before and after
the __salt__ dictionary is populated (cf dracr.py)
R RG Ro Rw R RX R� R� u quietR� R@ R� R� R� RH RI RJ R� N( R R ( RF RG Ro R Rw R RX R@ R� R� R� RH RI RJ R� R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _run_all_quiet| s$ c 5 K@ s� t | | j d d � � } t | d | d | d | d | d | d | d t j d
| d | d | d
| d |
d | d | d |
d | d | d | d | d | d | d | d | d | d | | �} t | � } t |
� } | d" k r�| rr| d d k rr| t d k rt d } n d j | | d � } t
j | | � � | rrt | | s`| d n d � � � qrn t
j
| d! | | d � � n | s�| d Sd S(# u�
Execute the passed command and return the output as a string
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.run 'echo '\''h=\"baz\"'\''' runas=macuser
:param str group: Group to run command as. Not currently supported
on Windows.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If ``False``, let python handle the positional
arguments. Set to ``True`` to use shell features, such as pipes or
redirection.
:param bool bg: If ``True``, run command in background and do not await or
deliver it's results
.. versionadded:: 2016.3.0
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not
necessary) to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param bool encoded_cmd: Specify if the supplied command is encoded.
Only applies to shell 'powershell'.
:param bool raise_err: If ``True`` and the command has a nonzero exit code,
a CommandExecutionError exception will be raised.
.. warning::
This function does not process commands through a shell
unless the python_shell flag is set to True. This means that any
shell-specific functionality such as 'echo' or the use of pipes,
redirection or &&, should either be migrated to cmd.shell or
have the python_shell=True flag set here.
The use of python_shell=True means that the shell will accept _any_ input
including potentially malicious commands such as 'good_command;rm -rf /'.
Be absolutely certain that you have sanitized your input prior to using
python_shell=True
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run "ls -l | awk '/foo/{print \\$2}'"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.run template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \\$2}'"
Specify an alternate shell with the shell parameter:
.. code-block:: bash
salt '*' cmd.run "Get-ChildItem C:\\ " shell='powershell'
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.run "grep f" stdin='one\\ntwo\\nthree\\nfour\\nfive\\n'
If an equal sign (``=``) appears in an argument to a Salt command it is
interpreted as a keyword argument in the format ``key=val``. That
processing can be bypassed in order to pass an equal sign through to the
remote shell command by manually specifying the kwarg:
.. code-block:: bash
salt '*' cmd.run cmd='sed -e s/=/:/g'
u __pub_jidu R R� Rw R RG Ro Rm RX R� R� R@ R� R� R� R� R� R� R� R� RH R� R� R� R� R� u retcodei u erroru* Command '{0}' failed with return code: {1}u stdoutu
output: %sN(
R R R R� R R RS R R R: R R R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� t hide_outputR� R� R� RH R� R� R� R� t raise_errR� R� R? R^ t lvlR� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR� � sX �
% c 3 K@ s� d | k r | j d � } n t } t | d | d | d | d | d | d | d | d | d
| d | d |
d
| d | d |
d | d | d | d | d | d | d | d | d | d | | �S( u0
Execute the passed command and return the output as a string.
.. versionadded:: 2015.5.0
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.shell 'echo '\''h=\"baz\"'\''' runas=macuser
:param str group: Group to run command as. Not currently supported
on Windows.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param int shell: Shell to execute under. Defaults to the system default
shell.
:param bool bg: If True, run command in background and do not await or
deliver its results
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.shell 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not necessary)
to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to
return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
.. warning::
This passes the cmd argument directly to the shell without any further
processing! Be absolutely sure that you have properly sanitized the
command passed to this function and do not use untrusted inputs.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.shell "ls -l | awk '/foo/{print \$2}'"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.shell template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \$2}'"
Specify an alternate shell with the shell parameter:
.. code-block:: bash
salt '*' cmd.shell "Get-ChildItem C:\ " shell='powershell'
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.shell "grep f" stdin='one\ntwo\nthree\nfour\nfive\n'
If an equal sign (``=``) appears in an argument to a Salt command it is
interpreted as a keyword argument in the format ``key=val``. That
processing can be bypassed in order to pass an equal sign through to the
remote shell command by manually specifying the kwarg:
.. code-block:: bash
salt '*' cmd.shell cmd='sed -e s/=/:/g'
u python_shellRG Ro R R� Rw RX R� R� R@ R� R� R� R� R� R R� R� R� RH R� R R� R� R� ( t popR R� ( RF RG Ro R R� Rw RX R� R@ R� R� R� R� R� R R� R� R� RH R� R� R� R� R� R? R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyRw � s: � c / K@ s� t | | j d d � � } t | d | d | d | d | d | d | d | d
| d | d | d
|
d | d | d |
d | d | d | d | d | d | d | d | | �} | s� | d Sd S( un
Execute a command, and only return the standard out
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.run_stdout 'echo '\''h=\"baz\"'\''' runas=macuser
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run command as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run_stdout 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not necessary)
to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to
return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run_stdout "ls -l | awk '/foo/{print \$2}'"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.run_stdout template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \$2}'"
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.run_stdout "grep f" stdin='one\ntwo\nthree\nfour\nfive\n'
u __pub_jidu R R� RG Ro Rw R RX R� R� R@ R� R� R� R� R� R� R� R� RH R� R� R� u stdout( R R R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R R� R� R� RH R� R� R� R� R? R^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
run_stdout� s6 � c / K@ s� t | | j d d � � } t | d | d | d | d | d | d | d | d
| d | d | d
|
d | d | d |
d | d | d | d | d | d | d | d | | �} | s� | d Sd S( uo
Execute a command and only return the standard error
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.run_stderr 'echo '\''h=\"baz\"'\''' runas=macuser
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run command as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run_stderr 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not
necessary) to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to
return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run_stderr "ls -l | awk '/foo/{print \$2}'"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.run_stderr template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \$2}'"
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.run_stderr "grep f" stdin='one\ntwo\nthree\nfour\nfive\n'
u __pub_jidu R R� RG Ro Rw R RX R� R� R@ R� R� R� R� R� R� R� R� R� RH R� R� u stderr( R R R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R R� R� R� RH R� R� R� R� R? R^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
run_stderrn s6 � c 3 K@ s� t | | j d d � � } | r* t j n t j } t | d | d | d | d | d | d | d | d
| d | d | d
| d |
d | d | d |
d | d | d | d | d | d | d | d | d | | �} | r� d | d <| d <n | S( u�
Execute the passed command and return a dict of return data
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.run_all 'echo '\''h=\"baz\"'\''' runas=macuser
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run command as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run_all 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not
necessary) to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to
return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param bool encoded_cmd: Specify if the supplied command is encoded.
Only applies to shell 'powershell'.
.. versionadded:: 2018.3.0
:param bool redirect_stderr: If set to ``True``, then stderr will be
redirected to stdout. This is helpful for cases where obtaining both
the retcode and output is desired, but it is not desired to have the
output separated into both stdout and stderr.
.. versionadded:: 2015.8.2
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param bool bg: If ``True``, run command in background and do not await or
deliver its results
.. versionadded:: 2016.3.6
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run_all "ls -l | awk '/foo/{print \$2}'"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.run_all template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \$2}'"
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.run_all "grep f" stdin='one\ntwo\nthree\nfour\nfive\n'
u __pub_jidu R R� RG Ro Rm Rw R RX R� R� R@ R� R� R� R� R� R� R� R� RH R� R� R� R� u stdoutu stderr( R R R� R R� R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R R� R� R� RH R� t redirect_stderrR� R� R� R� R? Rm R^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt run_all> s@ � c - K@ s� t | | j d d � � } t | d | d | d | d | d t j d | d | d
| d | d | d
|
d | d | d |
d | d | d | d | d | d | d | | �} | d S( u
Execute a shell command and return the command's return code.
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.retcode 'echo '\''h=\"baz\"'\''' runas=macuser
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run command as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.retcode 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param int timeout: A timeout in seconds for the executed process to return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:rtype: int
:rtype: None
:returns: Return Code as an int or None if there was an exception.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.retcode "file /bin/bash"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.retcode template=jinja "file {{grains.pythonpath[0]}}/python"
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.retcode "grep f" stdin='one\ntwo\nthree\nfour\nfive\n'
u __pub_jidu R R� RG Ro Rm Rw R RX R� R@ R� R� R� R� R� R� R� RH R� R� R� u retcode( R R R R� R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R� R� RH R� R� R� R? R^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt retcode+ s4 � c + K@ s� t | d | d | d | d | d | d | d | d | d | d
|
d | d d
d | d |
d | d | d | d | d | d | | �S( um
Helper for running commands quietly for minion startup. Returns same as
the retcode() function.
RG Ro R R� Rw R RX R� R@ R� R� R� u quietR� R� R� R� RH R� R� R� ( R ( RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R� RH R� R� R� R? ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _retcode_quiet� s, c + K@ sb t | | j d d � � } d � } d | k r@ | j d � n t } t j j j � r� | r� | d/ k r� t j
d t d � } t } t j j
j d | d | d d
� n t j j j d | d t j j | � d � } | r�d
| k s� d | k r1| j d
t j d
� � } t | | j d � � | d <n t d | | | | | � } | s| | � | rp| | � n i d d 6d d 6d d 6d d 6t d 6Snm t d | | � } | s�| | � | r�| | � n i d d 6d d 6d d 6d d 6t d 6St j | | � t j j j � sIt j | d � t j | t d | � d � n t j j j � r�| j � d k r�t | d t �} n t | � } t | r�| d t j | � n | d | d | d | d | d! |
d" | d# | d$ | d% | d& | d' |
d( | d) | d* | d+ | d, | d- | d. | | �} | | � | rC| | � n | r^d | d <| d <n | S(0 u�
Download a script from a remote location and execute the script locally.
The script can be located on the salt master file server or on an HTTP/FTP
server.
The script will be executed directly, so it can be written in any available
programming language.
:param str source: The location of the script to download. If the file is
located on the master in the directory named spam, and is called eggs,
the source string is salt://spam/eggs
:param str args: String of command line args to pass to the script. Only
used if no args are specified as part of the `name` argument. To pass a
string containing spaces in YAML, you will need to doubly-quote it:
.. code-block:: bash
salt myminion cmd.script salt://foo.sh "arg1 'arg two' arg3"
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run script as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param bool bg: If True, run script in background and do not await or
deliver it's results
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.script 'some command' env='{"FOO": "bar"}'
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: If the command has not terminated after timeout
seconds, send the subprocess sigterm, and if sigterm is ignored, follow
up with sigkill
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.script salt://scripts/runme.sh
salt '*' cmd.script salt://scripts/runme.sh 'arg1 arg2 "arg 3"'
salt '*' cmd.script salt://scripts/windows_task.ps1 args=' -Input c:\tmp\infile.txt' shell='powershell'
.. code-block:: bash
salt '*' cmd.script salt://scripts/runme.sh stdin='one\ntwo\nthree\nfour\nfive\n'
u __pub_jidu c S@ sN y t d | � Wn5 t t f k
rI } t j d | | d t j �n Xd S( Nu file.removeu- cmd.script: Unable to clean tempfile '%s': %sR� ( RB R R R R R� R� ( R" R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt _cleanup_tempfile� s u __env__Rl u cachedirt obj_namet principalt permissionsu full_controlt suffixi u pillarenvu pillaru cp.get_templatei u pidu retcodeu stdoutu stderru cache_erroru
cp.cache_filei@ u file.user_to_uidi����u
powershellt escapeu RG Ro R� R� R� R R� Rw R RX R� R� R� RH R� R� R� R� N( R R R R R0 R1 R� R� R t tempfilet mkdtempR R t win_daclt set_permissionsR2 R3 R! R" t splitextRC RB t shutilt copyfilet chmodt chownRM R� R R R` ( t sourceR� RG Ro R R� Rw R RX R@ R� R� R� R� R R� R� RH R� R� R� R� R? R t win_cwdR" RI t fn_t cmd_pathR^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt script s� � $
.
$ &
u jinjac * K@ s� d | k r | j d � n t d | d | d | d | d | d | d | d | d
| d | d |
d
| d | d |
d | d | d | d | d | d | | � d S( u�
Download a script from a remote location and execute the script locally.
The script can be located on the salt master file server or on an HTTP/FTP
server.
The script will be executed directly, so it can be written in any available
programming language.
The script can also be formatted as a template, the default is jinja.
Only evaluate the script return code and do not block for terminal output
:param str source: The location of the script to download. If the file is
located on the master in the directory named spam, and is called eggs,
the source string is salt://spam/eggs
:param str args: String of command line args to pass to the script. Only
used if no args are specified as part of the `name` argument. To pass a
string containing spaces in YAML, you will need to doubly-quote it:
"arg1 'arg two' arg3"
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str group: Group to run script as. Not currently supported
on Windows.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.script_retcode 'some command' env='{"FOO": "bar"}'
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param int timeout: If the command has not terminated after timeout
seconds, send the subprocess sigterm, and if sigterm is ignored, follow
up with sigkill
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.script_retcode salt://scripts/runme.sh
salt '*' cmd.script_retcode salt://scripts/runme.sh 'arg1 arg2 "arg 3"'
salt '*' cmd.script_retcode salt://scripts/windows_task.ps1 args=' -Input c:\tmp\infile.txt' shell='powershell'
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.
.. code-block:: bash
salt '*' cmd.script_retcode salt://scripts/runme.sh stdin='one\ntwo\nthree\nfour\nfive\n'
u __env__R% R� RG Ro R R� Rw R RX R@ R� R� R� RH R� R� R� R� R� R� u retcode( R R) ( R% R� RG Ro R R� Rw R RX R@ R� R� R� RH R� R� R� R� R� R� R? ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt script_retcode!
s. � c C@ s t j j j | � S( u�
Returns the path of an executable available on the minion, None otherwise
CLI Example:
.. code-block:: bash
salt '*' cmd.which cat
( R0 R1 R" t which( RF ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR+ �
s
c C@ s t j j j | � S( u�
Returns the first command found in a list of commands
CLI Example:
.. code-block:: bash
salt '*' cmd.which_bin '[pip2, pip, pip-python]'
( R0 R1 R" R� ( t cmds( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR� �
s
c C@ s t | � d k S( u�
Returns true if the executable is available on the minion, false otherwise
CLI Example:
.. code-block:: bash
salt '*' cmd.has_exec cat
N( R+ R ( RF ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt has_exec�
s
c K@ s t | | | | | � d S( u
Pass in two strings, the first naming the executable language, aka -
python2, python3, ruby, perl, lua, etc. the second string containing
the code you wish to execute. The stdout will be returned.
All parameters from :mod:`cmd.run_all <salt.modules.cmdmod.run_all>` except python_shell can be used.
CLI Example:
.. code-block:: bash
salt '*' cmd.exec_code ruby 'puts "cheese"'
salt '*' cmd.exec_code ruby 'puts "cheese"' args='["arg1", "arg2"]' env='{"FOO": "bar"}'
u stdout( t
exec_code_all( t langt codeRG R� R? ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt exec_code�
s c
K@ s | j � j d � } | r6 t j j j d d � } n t j j j � } t j j j | d d t ��# } | j t j j j
| � � Wd QX| r� | d | g } n | | g } t | t j
� r� | j | � n t | t � r� | | 7} n t | d | d t | �} t j | � | S(
u5
Pass in two strings, the first naming the executable language, aka -
python2, python3, ruby, perl, lua, etc. the second string containing
the code you wish to execute. All cmd artifacts (stdout, stderr, retcode, pid)
will be returned.
All parameters from :mod:`cmd.run_all <salt.modules.cmdmod.run_all>` except python_shell can be used.
CLI Example:
.. code-block:: bash
salt '*' cmd.exec_code_all ruby 'puts "cheese"'
salt '*' cmd.exec_code_all ruby 'puts "cheese"' args='["arg1", "arg2"]' env='{"FOO": "bar"}'
u
powershellR u .ps1u w+tt binaryNu -FileRG R ( RM R$ R0 R1 R2 R3 R4 R R5 R6 R/ RT R R_ R% RU R R! t remove(
R/ R0 RG R� R? t
powershellt codefileR= RF R^ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR.
s !"
u c C@ s� | j d � r! d j | � } n8 | j d � rN d j | j d d � � } n i d d 6SyU t j j j | d � �# } | j t j j j | � � Wd QXi d j | � d
6SWn" t
k
r� i d j | � d 6SXd S( u�
Echo a string to a specific tty
CLI Example:
.. code-block:: bash
salt '*' cmd.tty tty0 'This is a test'
salt '*' cmd.tty pts3 'This is a test'
u ttyu /dev/{0}u ptsu pts/u' The specified device is not a valid TTYu Erroru wbNu& Message was successfully echoed to {0}u Successu Echoing to {0} returned error( R$ R: R� R0 R1 R2 R4 R5 R6 R� R� ( t devicet echot teletypet
tty_device( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt tty6 s "
u quietc 0 K@ s� t d t j j | d � d d d �t d t j j | d � d d d �t d t j j | d � d d d �d } t j j t j j | d � � r� d
} n t | t t f � r� d j g | D] } t j | � ^ q� � } n d j
| | t | � � } t j
d
t � } | | d | d | d | d | d | d | d | d | d |
d | d | d |
d | d | d | d | d | d | d | j d! � d" | j d# � d$ | d% | d& | �} xc t d' � D]U } t | � } | s�Pn x6 | D]. } | d( k rd) n d* } t j | | � q�Wq�Wt | � r<t j d+ � n t d, t j j | d � � t d, t j j | d � � t d, t j j | d � � | r�d- | d. <| d/ <n | S(0 u�
.. versionadded:: 2014.7.0
This function runs :mod:`cmd.run_all <salt.modules.cmdmod.run_all>` wrapped
within a chroot, with dev and proc mounted in the chroot
:param str root: Path to the root of the jail to use.
stdin
A string of standard input can be specified for the command to be run using
the ``stdin`` parameter. This can be useful in cases where sensitive
information must be read from standard input.:
runas
User to run script as.
group
Group to run script as.
shell
Shell to execute under. Defaults to the system default shell.
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:parar str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run_chroot 'some command' env='{"FOO": "bar"}'
:param dict clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip:
Strip all whitespace off the end of output before it is returned.
:param str umask:
The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout:
A timeout in seconds for the executed process to return.
:param bool use_vt:
Use VT utils (saltstack) to stream the command output more
interactively to the console and the logs. This is experimental.
success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run_chroot /var/lib/lxc/container_name/rootfs 'sh /tmp/bootstrap.sh'
u mount.mountu devu devtmpfst fstypeu procu sysu sysfsu /bin/shu bin/bashu /bin/bashu u chroot {0} {1} -c {2}u cmd.run_chroot.funcR R� RG Ro Rw R RX R� R@ R� R� R� R� R� R� R� R� RH RI u pillarenvRZ u pillarR� R� R� i i i i uO Processes running in chroot could not be killed, filesystem will remain mountedu mount.umountu u stdoutu stderr( RB R! R" RP R� RT RU R� R R` R: R� R� R R R R R. R� R R ( R, RF RG Ro R R� Rw R RX R� R@ R� R� R� R� R� R R� R� R� RH R� R� R� R? t sh_R� t run_funcR^ R+ R� t sig( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
run_chrootS st �! .
c C@ s� t j j j � r t Sd } g } t j j | � r� y� t j j j | d � �; } g | j
� j � D] } t j j j
| � ^ qe } Wd QXx0 | D]( } | j d � r� q� q� | j | � q� WWq� t k
r� t SXn d S| | k r� t St Sd S( ue
Attempts to search for valid shells on a system and
see if a given shell is in the list
u /etc/shellsu rNu #( R0 R1 R� R� R R! R" t existsR2 R4 t readt
splitlinesR6 R� R$ R% R) R R ( Rw t shellst available_shellst shell_fpR t linest line( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR� 2 s& 7
c C@ s� d } g } t j j | � r� y� t j j j | d � �; } g | j � j � D] } t j j j
| � ^ qO } Wd QXxH | D]@ } | j � } | j d � r� q} q} | s� q} q} | j
| � q} WWq� t k
r� t j d | � q� Xn | S( u�
Lists the valid shells on this system via the /etc/shells file
.. versionadded:: 2015.5.0
CLI Example::
salt '*' cmd.shells
u /etc/shellsu rNu #u File '%s' was not found( R! R" R@ R0 R1 R2 R4 RA RB R6 R� Rj R$ R% R) R R ( t shells_fnR^ RE R RF RG ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyRC P s"
7
c C@ s� i d d d g d 6d d d g d 6d d d d g d 6d
d d g d 6d d
d g d
6d d d d g d 6d d d d g d 6d d d d g d 6d d d g d 6d d d g d 6d! d" d g d" 6} i t d# 6} t j j j � r | d k r t j j j d$ d% d& d' � } | j d& t � t | � d( k r?i d) d* 6t d# 6Sx�| D]�} t j j j
d$ d% d& d+ j | � d, d- � } | j d. � d/ k rF| j d0 � d1 k rFt j j j
d$ d% d& d2 j | � � } i } d= | d# <t d3 � | d4 <x| D]
} | d5 j � d6 k rq�q�| d5 j � d7 k rH| d0 | d8 <| d0 | d9 <q�| d5 j � d: k r�| d0 | d; <| d; d( j � d< k r�| d; d1 d= d= � | d; <q�q�| d5 j � d> k r�| d0 j d? d@ � j dA � | dB <q�| d0 | | d5 j � <q�WqFqFWn�| | k r0i dC j | � d* 6d= d# 6S| | } | j d( � }
t j j j � rsd( d= l } | j } n t j } dD | k r�t j j j � r�t j j dE � | dD <t j dF | dD � n y= t j j j | dG d= dH t j dI t j dJ dK dL | �}
Wn= t t! f k
rD} i dM j d? j" | � | � d* 6t d# 6SXy |
j# � Wn4 t$ k
r�} i dN j d? j" | � � d* 6t d# 6SXt | d( � | d4 <t% j& |
|
j' dO t% j( �} | r�| j) d1 � | d9 <n d9 | k ret% j* dP | d9 � } | rot+ | d# <| j) d1 � j dQ � dR } t | � d1 k rH| j, dS � n dQ j" | dR � | dT <qon
d= | d# <| d k r�| d# r�| r�t j j- j. � | dU <n dT | k r�dV j | � | d* <|
j' | dW <t j/ | d* � n | S(X u�
.. versionadded:: 2016.11.0
Provides information about a shell or script languages which often use
``#!``. The values returned are dependent on the shell or scripting
languages all return the ``installed``, ``path``, ``version``,
``version_raw``
Args:
shell (str): Name of the shell. Support shells/script languages include
bash, cmd, perl, php, powershell, python, ruby and zsh
list_modules (bool): True to list modules available to the shell.
Currently only lists powershell modules.
Returns:
dict: A dictionary of information about the shell
.. code-block:: python
{'version': '<2 or 3 numeric components dot-separated>',
'version_raw': '<full version string>',
'path': '<full path to binary>',
'installed': <True, False or None>,
'<attribute>': '<attribute value>'}
.. note::
- ``installed`` is always returned, if ``None`` or ``False`` also
returns error and may also return ``stdout`` for diagnostics.
- ``version`` is for use in determine if a shell/script language has a
particular feature set, not for package management.
- The shell must be within the executable search path.
CLI Example:
.. code-block:: bash
salt '*' cmd.shell_info bash
salt '*' cmd.shell_info powershell
:codeauthor: Damon Atkins <https://github.com/damon-atkins>
u version (\d\S*)u bashu --versionu versioZ ([-\w.]+)u bash-test-erroru (HOME=.*)u -cu declareu
bash-test-envu ^zsh (\d\S*)u zshu
^tcsh (\d\S*)u tcshu Version ([\d.]+)u cmd.exeu /Cu veru cmdu PSVersion\s+(\d\S*)u
powershellu -NonInteractiveu $PSVersionTableu ^(\d\S*)u perlu -eu printf "%vd
", $^V;u ^Python (\d\S*)u pythonu -Vu
^ruby (\d\S*)u rubyu -vu ^PHP (\d\S*)u phpu installedt hiveu HKEY_LOCAL_MACHINEt keyu Software\Microsoft\PowerShelli uB Unable to locate 'powershell' Reason: Cannot be found in registry.u erroru! Software\Microsoft\PowerShell\{0}t vnameu Installu vtypeu REG_DWORDu vdatai u2 Software\Microsoft\PowerShell\{0}\PowerShellEngineu powershell.exeu pathu vnameu (default)u powershellversionu psversionu version_rawu runtimeversionu
crlversionu vNu pscompatibleversionu u u ,u pscompatibleversionsu8 Salt does not know how to get the version number for {0}u HOMEu ~u HOME environment set to %sRo Rn Rm R� i
RX u' Unable to run command '{0}' Reason: {1}u. Unable to run command '{0}' Reason: Timed out.t flagsu
(\d[\d.]*)u .i u 0u versionu modulesuJ The version regex pattern for shell {0}, could not find the version stringu stdout(0 R R0 R1 R� R� t win_regt list_keyst sortR& t lent
read_valueR: R t list_valuesR R+ RM R� R� R R� R� R! R" R� R R� R� R� R� R� R R) R� RP R� R t ret searchRn t
IGNORECASER� t matchR R% R4 t get_modulesR ( Rw t list_modulest regex_shellsR^ t pw_keyst reg_vert install_datat detailst attributet
shell_datat patternR� t newenvR R� t pattern_resultt version_resultst ver_list( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt
shell_infon s� +
!&&
c - K@ s� d | k r | j d � } n t } t d � d } t j j j | d � d k r� | d 7} | d$ k r� | d j | � 7} q� n | r� t j
d | � | j d � j d
� } t
j | � } t } n t } d | d } t | d
| d | d | d d d | d | d | d | d | d |
d | d | d |
d | d | d | d | d | d | d | d! | | �} y t j j j | � SWn% t k
r�t j d" d# t �i SXd$ S(% u�
Execute the passed PowerShell command and return the output as a dictionary.
Other ``cmd.*`` functions (besides ``cmd.powershell_all``)
return the raw text output of the command. This
function appends ``| ConvertTo-JSON`` to the command and then parses the
JSON into a Python dictionary. If you want the raw textual result of your
PowerShell command you should use ``cmd.run`` with the ``shell=powershell``
option.
For example:
.. code-block:: bash
salt '*' cmd.run '$PSVersionTable.CLRVersion' shell=powershell
salt '*' cmd.run 'Get-NetTCPConnection' shell=powershell
.. versionadded:: 2016.3.0
.. warning::
This passes the cmd argument directly to PowerShell
without any further processing! Be absolutely sure that you
have properly sanitized the command passed to this function
and do not use untrusted inputs.
In addition to the normal ``cmd.run`` parameters, this command offers the
``depth`` parameter to change the Windows default depth for the
``ConvertTo-JSON`` powershell command. The Windows default is 2. If you need
more depth, set that here.
.. note::
For some commands, setting the depth to a value greater than 4 greatly
increases the time it takes for the command to return and in many cases
returns useless data.
:param str cmd: The powershell command to run.
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in cases
where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.powershell 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param bool hide_output: If ``True``, suppress stdout and stderr in the
return data.
.. note::
This is separate from ``output_loglevel``, which only handles how
Salt logs to the minion log.
.. versionadded:: 2018.3.0
:param int timeout: A timeout in seconds for the executed process to return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param bool reset_system_locale: Resets the system locale
:param str saltenv: The salt environment to use. Default is 'base'
:param int depth: The number of levels of contained objects to be included.
Default is 2. Values greater than 4 seem to greatly increase the time
it takes for the command to complete for some commands. eg: ``dir``
.. versionadded:: 2016.3.4
:param bool encode_cmd: Encode the command before executing. Use in cases
where characters may be dropped or incorrectly converted when executed.
Default is False.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
:returns:
:dict: A dictionary of data returned by the powershell command.
CLI Example:
.. code-block:: powershell
salt '*' cmd.powershell "$PSVersionTable.CLRVersion"
u python_shellu
powershellu psversionu 2.0i u | ConvertTo-JSONu -Depth {0}u Encoding PowerShell command '%s'u utf-8u utf-16leu try {u } catch { "{}" }RG Ro R Rw RX R� R@ R� R� R� R� R R� R� R� RH R� R R� R� R� u' Error converting PowerShell JSON returnt exc_infoN( R R Re R0 R1 t versionst version_cmpR R: R R� t decodeR� t base64t standard_b64encodeR R� t jsont loadst ExceptionR ( RF RG Ro R Rw RX R� R@ R� R� R� R� R R� R� R� RH R� R� t deptht
encode_cmdR� R? R t psversiont cmd_utf16R� t response( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyR4 $
sV �
c - K@ s d | k r | j d � } n t } | d 7} | t k rP | d j | � 7} n | r� t j d | � | j d � j d � } t j | � } t } n t
} t | d | d | d | d
d d | d
| d | d | d | d |
d | d | d |
d | d | d | d | d | d | d | d | | �} | d } | ra| j d � | rZg | d <n | Sn y t j
j j | � } Wn: t k
r�d d } | | d! <t d" | d# | � � n X| j d � t | � t k r�| r�| g | d <n
| | d <n
| | d <| S($ u�)
Execute the passed PowerShell command and return a dictionary with a result
field representing the output of the command, as well as other fields
showing us what the PowerShell invocation wrote to ``stderr``, the process
id, and the exit code of the invocation.
This function appends ``| ConvertTo-JSON`` to the command before actually
invoking powershell.
An unquoted empty string is not valid JSON, but it's very normal for the
Powershell output to be exactly that. Therefore, we do not attempt to parse
empty Powershell output (which would result in an exception). Instead we
treat this as a special case and one of two things will happen:
- If the value of the ``force_list`` parameter is ``True``, then the
``result`` field of the return dictionary will be an empty list.
- If the value of the ``force_list`` parameter is ``False``, then the
return dictionary **will not have a result key added to it**. We aren't
setting ``result`` to ``None`` in this case, because ``None`` is the
Python representation of "null" in JSON. (We likewise can't use ``False``
for the equivalent reason.)
If Powershell's output is not an empty string and Python cannot parse its
content, then a ``CommandExecutionError`` exception will be raised.
If Powershell's output is not an empty string, Python is able to parse its
content, and the type of the resulting Python object is other than ``list``
then one of two things will happen:
- If the value of the ``force_list`` parameter is ``True``, then the
``result`` field will be a singleton list with the Python object as its
sole member.
- If the value of the ``force_list`` parameter is ``False``, then the value
of ``result`` will be the unmodified Python object.
If Powershell's output is not an empty string, Python is able to parse its
content, and the type of the resulting Python object is ``list``, then the
value of ``result`` will be the unmodified Python object. The
``force_list`` parameter has no effect in this case.
.. note::
An example of why the ``force_list`` parameter is useful is as
follows: The Powershell command ``dir x | Convert-ToJson`` results in
- no output when x is an empty directory.
- a dictionary object when x contains just one item.
- a list of dictionary objects when x contains multiple items.
By setting ``force_list`` to ``True`` we will always end up with a
list of dictionary items, representing files, no matter how many files
x contains. Conversely, if ``force_list`` is ``False``, we will end
up with no ``result`` key in our return dictionary when x is an empty
directory, and a dictionary object when x contains just one file.
If you want a similar function but with a raw textual result instead of a
Python dictionary, you should use ``cmd.run_all`` in combination with
``shell=powershell``.
The remaining fields in the return dictionary are described in more detail
in the ``Returns`` section.
Example:
.. code-block:: bash
salt '*' cmd.run_all '$PSVersionTable.CLRVersion' shell=powershell
salt '*' cmd.run_all 'Get-NetTCPConnection' shell=powershell
.. versionadded:: 2018.3.0
.. warning::
This passes the cmd argument directly to PowerShell without any further
processing! Be absolutely sure that you have properly sanitized the
command passed to this function and do not use untrusted inputs.
In addition to the normal ``cmd.run`` parameters, this command offers the
``depth`` parameter to change the Windows default depth for the
``ConvertTo-JSON`` powershell command. The Windows default is 2. If you need
more depth, set that here.
.. note::
For some commands, setting the depth to a value greater than 4 greatly
increases the time it takes for the command to return and in many cases
returns useless data.
:param str cmd: The powershell command to run.
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str stdin: A string of standard input can be specified for the
command to be run using the ``stdin`` parameter. This can be useful in
cases where sensitive information must be read from standard input.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.powershell_all 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param bool rstrip: Strip all whitespace off the end of output before it is
returned.
:param str umask: The umask (in octal) to use when running the command.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param int timeout: A timeout in seconds for the executed process to
return.
:param bool use_vt: Use VT utils (saltstack) to stream the command output
more interactively to the console and the logs. This is experimental.
:param bool reset_system_locale: Resets the system locale
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param str saltenv: The salt environment to use. Default is 'base'
:param int depth: The number of levels of contained objects to be included.
Default is 2. Values greater than 4 seem to greatly increase the time
it takes for the command to complete for some commands. eg: ``dir``
:param bool encode_cmd: Encode the command before executing. Use in cases
where characters may be dropped or incorrectly converted when executed.
Default is False.
:param bool force_list: The purpose of this parameter is described in the
preamble of this function's documentation. Default value is False.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
:return: A dictionary with the following entries:
result
For a complete description of this field, please refer to this
function's preamble. **This key will not be added to the dictionary
when force_list is False and Powershell's output is the empty
string.**
stderr
What the PowerShell invocation wrote to ``stderr``.
pid
The process id of the PowerShell invocation
retcode
This is the exit code of the invocation of PowerShell.
If the final execution status (in PowerShell) of our command
(with ``| ConvertTo-JSON`` appended) is ``False`` this should be non-0.
Likewise if PowerShell exited with ``$LASTEXITCODE`` set to some
non-0 value, then ``retcode`` will end up with this value.
:rtype: dict
CLI Example:
.. code-block:: bash
salt '*' cmd.powershell_all "$PSVersionTable.CLRVersion"
CLI Example:
.. code-block:: bash
salt '*' cmd.powershell_all "dir mydirectory" force_list=True
u python_shellu | ConvertTo-JSONu -Depth {0}u Encoding PowerShell command '%s'u utf-8u utf-16leRG Ro R Rw u
powershellRX R� R@ R� R� R� R� t quietR� R� R� RH R� R R� R� R� u stdoutu resultu cmd.powershell_all u# cannot parse the Powershell output.u cmdt messageRq ( R R R R: R R� Ri R� Rj Rk R R R0 R1 Rl Rm Rn R t typeRU ( RF RG Ro R Rw RX R� R@ R� R� R� R� Rt R� R� R� RH R� R� Ro Rp t
force_listR� R? R Rr R� Rs t stdoutputt resultt err_msg( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt powershell_all st �
c 5 K@ s� t | | j d d � � } t | d d d d d d d | d | d d d t d
t d t d | d
| d | d | d | d | d | d | d | d | d |
d |
d | d | d | d | | �} i | d d 6S( u�
.. versionadded: 2016.3.0
Execute the passed command in the background and return it's PID
.. note::
If the init system is systemd and the backgrounded task should run even
if the salt-minion process is restarted, prepend ``systemd-run
--scope`` to the command. This will reparent the process in its own
scope separate from salt-minion, and will not be affected by restarting
the minion service.
:param str cmd: The command to run. ex: ``ls -lart /home``
:param str cwd: The directory from which to execute the command. Defaults
to the home directory of the user specified by ``runas`` (or the user
under which Salt is running if ``runas`` is not specified).
:param str group: Group to run command as. Not currently supported
on Windows.
:param str shell: Shell to execute under. Defaults to the system default
shell.
:param str output_encoding: Control the encoding used to decode the
command's output.
.. note::
This should not need to be used in most cases. By default, Salt
will try to use the encoding detected from the system locale, and
will fall back to UTF-8 if this fails. This should only need to be
used in cases where the output of the command is encoded in
something other than the system locale or UTF-8.
To see the encoding Salt has detected from the system locale, check
the `locale` line in the output of :py:func:`test.versions_report
<salt.modules.test.versions_report>`.
.. versionadded:: 2018.3.0
:param str output_loglevel: Control the loglevel at which the output from
the command is logged to the minion log.
.. note::
The command being run will still be logged at the ``debug``
loglevel regardless, unless ``quiet`` is used for this value.
:param bool ignore_retcode: If the exit code of the command is nonzero,
this is treated as an error condition, and the output from the command
will be logged to the minion log. However, there are some cases where
programs use the return code for signaling and a nonzero exit code
doesn't necessarily mean failure. Pass this argument as ``True`` to
skip logging the output if the command has a nonzero exit code.
:param str runas: Specify an alternate user to run the command. The default
behavior is to run as the user under which Salt is running. If running
on a Windows minion you must also use the ``password`` argument, and
the target user account must be in the Administrators group.
.. warning::
For versions 2018.3.3 and above on macosx while using runas,
to pass special characters to the command you need to escape
the characters on the shell.
Example:
.. code-block:: bash
cmd.run_bg 'echo '\''h=\"baz\"'\''' runas=macuser
:param str password: Windows only. Required when specifying ``runas``. This
parameter will be ignored on non-Windows platforms.
.. versionadded:: 2016.3.0
:param str shell: Specify an alternate shell. Defaults to the system's
default shell.
:param bool python_shell: If False, let python handle the positional
arguments. Set to True to use shell features, such as pipes or
redirection.
:param dict env: Environment variables to be set prior to execution.
.. note::
When passing environment variables on the CLI, they should be
passed as the string representation of a dictionary.
.. code-block:: bash
salt myminion cmd.run_bg 'some command' env='{"FOO": "bar"}'
:param bool clean_env: Attempt to clean out all other shell environment
variables and set only those provided in the 'env' argument to this
function.
:param str prepend_path: $PATH segment to prepend (trailing ':' not
necessary) to $PATH
.. versionadded:: 2018.3.0
:param str template: If this setting is applied then the named templating
engine will be used to render the downloaded file. Currently jinja,
mako, and wempy are supported.
:param str umask: The umask (in octal) to use when running the command.
:param int timeout: A timeout in seconds for the executed process to return.
.. warning::
This function does not process commands through a shell unless the
``python_shell`` argument is set to ``True``. This means that any
shell-specific functionality such as 'echo' or the use of pipes,
redirection or &&, should either be migrated to cmd.shell or have the
python_shell=True flag set here.
The use of ``python_shell=True`` means that the shell will accept _any_
input including potentially malicious commands such as 'good_command;rm
-rf /'. Be absolutely certain that you have sanitized your input prior
to using ``python_shell=True``.
:param list success_retcodes: This parameter will be allow a list of
non-zero return codes that should be considered a success. If the
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' cmd.run_bg "fstrim-all"
The template arg can be set to 'jinja' or another supported template
engine to render the command arguments before execution.
For example:
.. code-block:: bash
salt '*' cmd.run_bg template=jinja "ls -l /tmp/{{grains.id}} | awk '/foo/{print \\$2}'"
Specify an alternate shell with the shell parameter:
.. code-block:: bash
salt '*' cmd.run_bg "Get-ChildItem C:\\ " shell='powershell'
If an equal sign (``=``) appears in an argument to a Salt command it is
interpreted as a keyword argument in the format ``key=val``. That
processing can be bypassed in order to pass an equal sign through to the
remote shell command by manually specifying the kwarg:
.. code-block:: bash
salt '*' cmd.run_bg cmd='ls -lR / | sed -e s/=/:/g > /tmp/dontwait'
u __pub_jidu Ro Rm Rn R� R� R� R� R� R� R R� Rw R RG RX R� R� R@ R� R� R� R� RH R� R� u pidN( R R R R R R ( RF RG R R� Rw R RX R� R@ R� R� R� R� R� R� R� RH R� R� R� R? t res( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt run_bgu s> � (k t __doc__t
__future__R R R R� R R� R! R! R� R� R� R� Ra Rj RS R t salt.utils.argsR0 t salt.utils.datat salt.utils.filest salt.utils.jsont salt.utils.patht salt.utils.platformt salt.utils.powershellt salt.utils.stringutilst salt.utils.templatest salt.utils.timed_subprocesst salt.utils.usert salt.utils.versionst
salt.utils.vtt salt.utils.win_daclt salt.utils.win_regt salt.grains.extrat salt.extR t salt.exceptionsR R R t salt.logR t salt.ext.six.movesR R R
R� R� t ImportErrorR1 R� R� t salt.utils.win_runasR R� t salt.utils.win_functionsR R� R R� R
R t __proxyenabled__R t getLoggert __name__R t grainst extraRw R� R R R R. R RK RS RY RC Rf R� R R
R R� R R R R R R) R* R+ R� R- R1 R. R: R? R� RC Re R4 R{ R} ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/cmdmod.pyt <module> s8
4
� � @ � � � � � � � �
) � � � � B
Mini Shell