Current File : //usr/lib/python2.7/site-packages/salt/modules/win_file.pyc
�
���^c @@ sR 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
m Z m Z d d l
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 m Z d d l m! Z" d d l# Z$ d d l% m& Z& m' Z' d d l( Z$ d d l) Z$ d d l* Z$ d d l+ m, a, m- a- m. a. m/ a/ m0 a0 m1 a1 m2 a2 m3 a3 m4 a4 m5 a5 m6 a6 m7 a7 m8 a8 m9 a9 m: a: m; a; m< a< m= a= m> a> m? a? m@ a@ mA aA mB aB mC aC mD aD mE aE mF aF mG aG mH aH mI aI mJ aJ mK aK mL aL mM aM mN aN mO aO mP aP mQ aQ mR aR mS aS mT ZT mU ZU mV ZV mW aW mX aX mY aY mZ aZ m[ a[ m\ a\ m] a] m^ a^ m_ a_ m` a` ma Za mb Zb mc ac md ad me ae mf af mg ag mh ah mi ai mj aj mk ak ml al mm am mn an mo ao mp ap mq aq mr ar d d
l+ ms at d d lu mv Zw ex Zy y[ e$ jz j{ j| � r�d d l} Z} d d l~ Z~ d d l Z d d l� Z� d d l� Z$ e� Zy n Wn e� k
r�ex Zy n Xy d d l� m� Z� Wn' e� k
r*d
e� f d � � YZ� n Xex Z� y+ e$ jz j{ j| � r[d d l� Z$ e� Z� n Wn e� k
ruex Z� n Xe j� e� � Z� d Z� d � Z� i d d 6d d 6Z� i d d 6d d 6Z� d d � Z� d � Z� d � Z� e� d � Z� e� d � Z� e� d � Z� e� d � Z� d � Z� d! � Z� e� d" � Z� e� d# � Z� d$ � Z� e� e� d% � Z� e� e� e� d& � Z� d' � Z� d( � Z� d) e� d* � Z� d+ � Z� e� e� e� e� e� e� e� d, � Z� d- � Z� ex d. � Z� d/ � Z� d0 � Z� d1 � Z� e� e� e� e� ex d2 � Z� e� e� e� e� ex d3 � Z� e� e� e� e� e� d4 � Z� e� e� e� e� e� ex d5 � Z� e� e� e� ex d6 � Z� d S(7 u�
Manage information about files on the minion, set/read user, group
data, modify the ACL of files/directories
:depends: - win32api
- win32file
- win32con
- salt.utils.win_dacl
i ( t absolute_importt unicode_literalst print_functionN( t Iterablet Mapping( t reduce( t six( t urlparse( t CommandExecutionErrort SaltInvocationError(G t
check_hasht directory_existst get_managedt
check_managedt check_managed_changest source_listt toucht appendt containst contains_regext get_source_sumt
contains_globt findt psedt get_sumt _get_bkroott
_mkstemp_copyt get_hasht manage_filet file_existst get_difft linet list_backupst __clean_tmpt check_file_metat _binary_replacet' _splitlines_preserving_trailing_newlinet restore_backupt accesst copyt readdirt readt rmdirt truncatet replacet
delete_backupt searcht
_get_flagst extract_hasht _errort _sed_esct _psedt
RE_FLAG_TABLEt blockreplacet prependt seek_readt
seek_writet renamet lstatt path_exists_globt writet pardirt joint HASHESt
HASHES_REVMAPt commentt uncommentt
_add_flagst comment_linet _regex_to_statict _set_line_indentt apply_template_on_contentst dirnamet basenamet list_backups_dirt _assert_occurrencet _starts_tillt
_set_line_eolt _get_eolt _insert_line_aftert _insert_line_before( t normpath( t namespaced_function( t WindowsErrorRS c B@ s e Z RS( ( t __name__t
__module__( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyRS T s u filec C@ s� t j j j � r�t r�t t t � � a t t t � � a t t t � � a t t
t � � a
t t t � � a t t t � � a t t
t � � a
t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t t! t � � a! t t" t � � a" t t# t � � a# t t$ t � � a$ t t% t � � a% t t& t � � a& t t' t � � a' t t( t � � a( t t) t � � a) t t* t � � a* t t+ t � � a+ t t, t � � a, t t- t � � a- t t. t � � a. t t/ t � � a/ t t0 t � � a0 t t1 t � � a1 t t2 t � � a2 t t3 t � � a3 t t4 t � � a4 t t5 t � � a5 t t6 t � � a6 t t7 t � � a7 t t8 t � � a8 t t9 t � � a9 t t: t � � a: t t; t � � a; t t< t � � a< t t= t � � a= t t> t � � a> t t? t � � a? t t@ t � � a@ t tA t � � aA t tB t � � aB t tC t � � aC t tD t � � aD t tE t � � aE t tF t � � aF t tG t � � aG t tH t � � aH t tI t � � aI q�tJ d f Sn tK s�tJ d f StL S( u'
Only works on Windows systems
u& Module win_file: Missing Win32 modulesu3 Module win_file: Unable to load salt.utils.win_dacl(M t saltt utilst platformt
is_windowst HAS_WINDOWS_MODULESt _namespaced_functionR, t globalsR. R/ R# R$ R1 R R R% R- R0 R R R
R R" R R R R! R R R R R R R R R R
R R R R& R' R( R) R* R+ R5 R6 R7 R8 R9 R: R; R< R= R> RA RB RD RE RF RM RN RO RP R RC RG RH RI RJ t normpath_RK RL t Falset HAS_WIN_DACLt __virtualname__( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt __virtual__e s�
u txtu touchu appendu makedirsu makedirs_u normpathu normpath_i@ c C@ s� t j � j d k r$ t d � � n t | f � } d } xi t | � r� t | � } | | k ro t d � � n | j | � | d 7} | | k r< t d � � q< q< W| S( u�
Resolves the given symlink path to its real path, up to a maximum of the
`max_depth` parameter which defaults to 64.
If the path is not a symlink path, it is simply returned.
i u6 Symlinks are only supported on Windows Vista or later.i u- The given path is involved in a symlink loop.i u" Too many levels of symbolic links.( t syst getwindowsversiont majorR t sett is_linkt readlinkR t add( t patht max_deptht
paths_seent cur_depth( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt _resolve_symlink� s
c C@ sD d j t � } t j d d � | k r: t j d | � n t | � S( u�
Convert the group id to the group name on this system
Under Windows, because groups are just another ACL entity, this function
behaves the same as uid_to_user.
For maintaining Windows systems, this function is superfluous and only
exists for API compatibility with Unix. Use the uid_to_user function
instead; an info level log entry will be generated if this function is used
directly.
Args:
gid (str): The gid of the group
Returns:
str: The name of the group
CLI Example:
.. code-block:: bash
salt '*' file.gid_to_group S-1-5-21-626487655-2533044672-482107328-1010
u {0}.gid_to_groupu funu uU The function %s should not be used on Windows systems; see function docs for details.( t formatR` t __opts__t gett logt infot uid_to_user( t gidt func_name( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt gid_to_group� s
c C@ s] d j t � } t j d d � | k r: t j d | � n | d k rJ d St j j j
| � S( u�
Convert the group to the gid on this system
Under Windows, because groups are just another ACL entity, this function
behaves the same as user_to_uid, except if None is given, '' is returned.
For maintaining Windows systems, this function is superfluous and only
exists for API compatibility with Unix. Use the user_to_uid function
instead; an info level log entry will be generated if this function is used
directly.
Args:
group (str): The name of the group
Returns:
str: The gid of the group
CLI Example:
.. code-block:: bash
salt '*' file.group_to_gid administrators
u {0}.group_to_gidu funu uU The function %s should not be used on Windows systems; see function docs for details.N( Rn R` Ro Rp Rq Rr t NoneRV RW t win_daclt get_sid_string( t groupRu ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt group_to_gid s
c C@ s| t j j | � s* t d j | � � � n | rT t j � j d k rT t | � } n t j
j j | � } t j
j j
| � S( u)
Return the id of the primary group that owns a given file (Windows only)
This function will return the rarely used primary group of a file. This
generally has no bearing on permissions unless intentionally configured
and is most commonly used to provide Unix compatibility (e.g. Services
For Unix, NFS services).
Ensure you know what you are doing before using this function.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The gid of the primary group
CLI Example:
.. code-block:: bash
salt '*' file.get_pgid c:\temp\test.txt
u Path not found: {0}i ( t osRi t existsR Rn Rb Rc Rd Rm RV RW Rx t get_primary_groupRy ( Ri t follow_symlinkst
group_name( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt get_pgid2 s c C@ s t t | | � � S( uc
Return the name of the primary group that owns a given file (Windows only)
This function will return the rarely used primary group of a file. This
generally has no bearing on permissions unless intentionally configured
and is most commonly used to provide Unix compatibility (e.g. Services
For Unix, NFS services).
Ensure you know what you are doing before using this function.
The return value may be 'None', e.g. if the user is not on a domain. This is
a valid group - do not confuse this with the Salt/Python value of None which
means no value was returned. To be certain, use the `get_pgid` function
which will return the SID, including for the system 'None' group.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The name of the primary group
CLI Example:
.. code-block:: bash
salt '*' file.get_pgroup c:\temp\test.txt
( Rs R� ( Ri R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt
get_pgroup\ s c C@ sG d j t � } t j d d � | k r: t j d | � n t | | � S( us
Return the id of the group that owns a given file
Under Windows, this will return the uid of the file.
While a file in Windows does have a 'primary group', this rarely used
attribute generally has no bearing on permissions unless intentionally
configured and is only used to support Unix compatibility features (e.g.
Services For Unix, NFS services).
Salt, therefore, remaps this function to provide functionality that
somewhat resembles Unix behavior for API compatibility reasons. When
managing Windows systems, this function is superfluous and will generate
an info level log entry if used directly.
If you do actually want to access the 'primary group' of a file, use
`file.get_pgid`.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The gid of the owner
CLI Example:
.. code-block:: bash
salt '*' file.get_gid c:\temp\test.txt
u {0}.get_gidu funu ut The function %s should not be used on Windows systems; see function docs for details. The value returned is the uid.( Rn R` Ro Rp Rq Rr t get_uid( Ri R Ru ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt get_gid s
#
c C@ sG d j t � } t j d d � | k r: t j d | � n t | | � S( uw
Return the group that owns a given file
Under Windows, this will return the user (owner) of the file.
While a file in Windows does have a 'primary group', this rarely used
attribute generally has no bearing on permissions unless intentionally
configured and is only used to support Unix compatibility features (e.g.
Services For Unix, NFS services).
Salt, therefore, remaps this function to provide functionality that
somewhat resembles Unix behavior for API compatibility reasons. When
managing Windows systems, this function is superfluous and will generate
an info level log entry if used directly.
If you do actually want to access the 'primary group' of a file, use
`file.get_pgroup`.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The name of the owner
CLI Example:
.. code-block:: bash
salt '*' file.get_group c:\temp\test.txt
u
{0}.get_groupu funu u} The function %s should not be used on Windows systems; see function docs for details. The value returned is the user (owner).( Rn R` Ro Rp Rq Rr t get_user( Ri R Ru ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt get_group� s
#
c C@ s/ | d k s | d k r d St j j j | � S( u
Convert a uid to a user name
Args:
uid (str): The user id to lookup
Returns:
str: The name of the user
CLI Example:
.. code-block:: bash
salt '*' file.uid_to_user S-1-5-21-626487655-2533044672-482107328-1010
u N( Rw RV RW Rx t get_name( t uid( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyRs � s c C@ s4 | d k r! t j j j � } n t j j j | � S( u�
Convert user name to a uid
Args:
user (str): The user to lookup
Returns:
str: The user id of the user
CLI Example:
.. code-block:: bash
salt '*' file.user_to_uid myusername
N( Rw RV RW t userR� Rx Ry ( R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt user_to_uid� s c C@ s| t j j | � s* t d j | � � � n | rT t j � j d k rT t | � } n t j
j j | � } t j
j j
| � S( u�
Return the id of the user that owns a given file
Symlinks are followed by default to mimic Unix behavior. Specify
`follow_symlinks=False` to turn off this behavior.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The uid of the owner
CLI Example:
.. code-block:: bash
salt '*' file.get_uid c:\temp\test.txt
salt '*' file.get_uid c:\temp\test.txt follow_symlinks=False
u Path not found: {0}i ( R| Ri R} R Rn Rb Rc Rd Rm RV RW Rx t get_ownerRy ( Ri R t owner_sid( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� s c C@ sg t j j | � s* t d j | � � � n | rT t j � j d k rT t | � } n t j
j j | � S( u
Return the user that owns a given file
Symlinks are followed by default to mimic Unix behavior. Specify
`follow_symlinks=False` to turn off this behavior.
Args:
path (str): The path to the file or directory
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
str: The name of the owner
CLI Example:
.. code-block:: bash
salt '*' file.get_user c:\temp\test.txt
salt '*' file.get_user c:\temp\test.txt follow_symlinks=False
u Path not found: {0}i (
R| Ri R} R Rn Rb Rc Rd Rm RV RW Rx R� ( Ri R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� + s
c C@ sh t j j | � s* t d j | � � � n d j t � } t j d d � | k rd t j d | � n d S( u4
Return the mode of a file
Right now we're just returning None because Windows' doesn't have a mode
like Linux
Args:
path (str): The path to the file or directory
Returns:
None
CLI Example:
.. code-block:: bash
salt '*' file.get_mode /etc/passwd
u Path not found: {0}u {0}.get_modeu funu ux The function %s should not be used on Windows systems; see function docs for details. The value returned is always None.N( R| Ri R} R Rn R` Ro Rp Rq Rr Rw ( Ri Ru ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt get_modeR s
c C@ su | r\ d j t � } t j d d � | k r@ t j d | � n t j d | | � d } n t | | | | d t �S( u.
Chown a file, pass the file the desired user and group without following any
symlinks.
Under Windows, the group parameter will be ignored.
This is because while files in Windows do have a 'primary group'
property, this is rarely used. It generally has no bearing on
permissions unless intentionally configured and is most commonly used to
provide Unix compatibility (e.g. Services For Unix, NFS services).
If you do want to change the 'primary group' property and understand the
implications, pass the Windows only parameter, pgroup, instead.
To set the primary group to 'None', it must be specified in quotes.
Otherwise Salt will interpret it as the Python value of None and no primary
group changes will occur. See the example below.
Args:
path (str): The path to the file or directory
user (str): The name of the user to own the file
group (str): The group (not used)
pgroup (str): The primary group to assign
Returns:
bool: True if successful, otherwise error
CLI Example:
.. code-block:: bash
salt '*' file.lchown c:\temp\test.txt myusername
salt '*' file.lchown c:\temp\test.txt myusername pgroup=Administrators
salt '*' file.lchown c:\temp\test.txt myusername "pgroup='None'"
u
{0}.lchownu funu ub The group parameter has no effect when using %s on Windows systems; see function docs for details.u2 win_file.py %s Ignoring the group parameter for %sR N(
Rn R` Ro Rp Rq Rr t debugRw t chownR^ ( Ri R� Rz t pgroupRu ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt lchownq s $
c C@ s� | d k r\ d j t � } t j d d � | k rF t j d | � n t j d | | � n | r� t j � j
d k r� t | � } n t j
j | � s� t d j | � � � n t j j j | | � | r� t j j j | | � n t S( u�
Chown a file, pass the file the desired user and group
Under Windows, the group parameter will be ignored.
This is because while files in Windows do have a 'primary group'
property, this is rarely used. It generally has no bearing on
permissions unless intentionally configured and is most commonly used to
provide Unix compatibility (e.g. Services For Unix, NFS services).
If you do want to change the 'primary group' property and understand the
implications, pass the Windows only parameter, pgroup, instead.
Args:
path (str): The path to the file or directory
user (str): The name of the user to own the file
group (str): The group (not used)
pgroup (str): The primary group to assign
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
bool: True if successful, otherwise error
CLI Example:
.. code-block:: bash
salt '*' file.chown c:\temp\test.txt myusername
salt '*' file.chown c:\temp\test.txt myusername pgroup=Administrators
salt '*' file.chown c:\temp\test.txt myusername "pgroup='None'"
u {0}.chownu funu ub The group parameter has no effect when using %s on Windows systems; see function docs for details.u2 win_file.py %s Ignoring the group parameter for %si u Path not found: {0}N( Rw Rn R` Ro Rp Rq Rr R� Rb Rc Rd Rm R| Ri R} R RV RW Rx t set_ownert set_primary_groupt True( Ri R� Rz R� R Ru ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� � s #
c C@ s t j j j | | � S( u�
Change the group of a file
Under Windows, this will set the rarely used primary group of a file.
This generally has no bearing on permissions unless intentionally
configured and is most commonly used to provide Unix compatibility (e.g.
Services For Unix, NFS services).
Ensure you know what you are doing before using this function.
Args:
path (str): The path to the file or directory
pgroup (str): The primary group to assign
Returns:
bool: True if successful, otherwise error
CLI Example:
.. code-block:: bash
salt '*' file.chpgrp c:\temp\test.txt Administrators
salt '*' file.chpgrp c:\temp\test.txt "'None'"
( RV RW Rx R� ( Ri Rz ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt chpgrp� s c C@ sQ d j t � } t j d d � | k r: t j d | � n t j d | | � d S( u�
Change the group of a file
Under Windows, this will do nothing.
While a file in Windows does have a 'primary group', this rarely used
attribute generally has no bearing on permissions unless intentionally
configured and is only used to support Unix compatibility features (e.g.
Services For Unix, NFS services).
Salt, therefore, remaps this function to do nothing while still being
compatible with Unix behavior. When managing Windows systems,
this function is superfluous and will generate an info level log entry if
used directly.
If you do actually want to set the 'primary group' of a file, use ``file
.chpgrp``.
To set group permissions use ``file.set_perms``
Args:
path (str): The path to the file or directory
group (str): The group (unused)
Returns:
None
CLI Example:
.. code-block:: bash
salt '*' file.chpgrp c:\temp\test.txt administrators
u {0}.chgrpu funu uU The function %s should not be used on Windows systems; see function docs for details.u# win_file.py %s Doing nothing for %sN( Rn R` Ro Rp Rq Rr R� Rw ( Ri Rz Ru ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt chgrp� s "
u sha256c C@ s[ t j j | � s* t d j | � � � n | rT t j � j d k rT t | � } n t j | � } i } | j
| d <t | d t �| d <| d | d <t
| d � | d <| d | d <t | | � | d <t | d � | d
<| j | d <| j | d <| j | d
<| j | d <t j j j t t j | j � � � | d <| r^t | | � | d <n d | d <t j | j � r�d | d <n t j | j � r�d | d <n t j | j � r�d | d <n t j | j � r�d | d <n t j | j � rd | d <n t j! | j � r"d | d <n t j" | j � rAd | d <n t j j# | � | d <| S( u#
Return a dict containing the stats about a given file
Under Windows, `gid` will equal `uid` and `group` will equal `user`.
While a file in Windows does have a 'primary group', this rarely used
attribute generally has no bearing on permissions unless intentionally
configured and is only used to support Unix compatibility features (e.g.
Services For Unix, NFS services).
Salt, therefore, remaps these properties to keep some kind of
compatibility with Unix behavior. If the 'primary group' is required, it
can be accessed in the `pgroup` and `pgid` properties.
Args:
path (str): The path to the file or directory
hash_type (str): The type of hash to return
follow_symlinks (bool):
If the object specified by ``path`` is a symlink, get attributes of
the linked file instead of the symlink itself. Default is True
Returns:
dict: A dictionary of file/directory stats
CLI Example:
.. code-block:: bash
salt '*' file.stats /etc/passwd
u Path not found: {0}i u inodeR u uidu gidu useru groupu pgidu pgroupu atimeu mtimeu ctimeu sizeu modeu sumu fileu typeu diru charu blocku linku pipeu socketu target($ R| Ri R} R Rn Rb Rc Rd Rm t statt st_inoR� R^ Rs R� Rv t st_atimet st_mtimet st_ctimet st_sizeRV RW t filest normalize_modet octt S_IMODEt st_modeR t S_ISDIRt S_ISCHRt S_ISBLKt S_ISREGt S_ISLNKt S_ISFIFOt S_ISSOCKt realpath( Ri t hash_typeR t pstatt ret( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt stats" sJ !
+
c C@ s� t j j | � s* t d j | � � � n i } t j | � } | d @d k | d <| d @d k | d <| d @d k | d <| d @d k | d <| d
@d
k | d <| d @d k | d
<| d @d k | d <| d @d k | d <| d @d k | d <| d @d k | d <| d @d k | d <| d @d k | d <t | d <| d t k r�| d t k r�t j | � } t
| � } | d d k r�t | d <q�n t | d <| d t k r�t j | � } t
| � } | d d k r�t | d <q�n | S( u2
Return a dictionary object with the Windows
file attributes for a file.
Args:
path (str): The path to the file or directory
Returns:
dict: A dictionary of file attributes
CLI Example:
.. code-block:: bash
salt '*' file.get_attributes c:\temp\a.txt
u Path not found: {0}i u archivei u reparsePointi u
compressedi u directoryi @ u encryptedi u hiddeni� u normali u
notIndexedi u offlinei u readonlyi u systemi u temporaryu
mountedVolumei I � u symbolicLinkI � ( R| Ri R} R Rn t win32filet GetFileAttributesR^ R� t FindFilesIteratort next( Ri t
attributest
intAttributest fileIteratort
findDataTuple( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt get_attributeso s:
c
C@ s� t j j | � s* t d j | � � � n | r� | sT | sT | sT | sT | sT | rc t d � � n t j | d � } | d k r� t St St j
| � } | d k r� | r� | d O} q� | d M} n | d k r� | r� | d O} q� | d M} n | d k r | r| d O} q | d M} n | d k rH| r;| d
O} qH| d M} n | d k rt| rg| d O} qt| d
M} n | d k r�| r�| d O} q�| d M} n t j | | � } | d k r�t St S( u�
Set file attributes for a file. Note that the normal attribute
means that all others are false. So setting it will clear all others.
Args:
path (str): The path to the file or directory
archive (bool): Sets the archive attribute. Default is None
hidden (bool): Sets the hidden attribute. Default is None
normal (bool):
Resets the file attributes. Cannot be used in conjunction with any
other attribute. Default is None
notIndexed (bool): Sets the indexed attribute. Default is None
readonly (bool): Sets the readonly attribute. Default is None
system (bool): Sets the system attribute. Default is None
temporary (bool): Sets the temporary attribute. Default is None
Returns:
bool: True if successful, otherwise False
CLI Example:
.. code-block:: bash
salt '*' file.set_attributes c:\temp\a.txt normal=True
salt '*' file.set_attributes c:\temp\a.txt readonly=True hidden=True
u Path not found: {0}u: Normal attribute may not be used with any other attributesi� i i� i i�� i i�� i i�� i i�� i i�� N( R| Ri R} R Rn R� t SetFileAttributesRw R� R^ R� (
Ri t archivet hiddent normalt
notIndexedt readonlyt systemt temporaryR� R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt set_attributes� sF $
c C@ sD d j t � } t j d d � | k r: t j d | � n t | � S( uP
Set the mode of a file
This just calls get_mode, which returns None because we don't use mode on
Windows
Args:
path: The path to the file or directory
mode: The mode (not used)
Returns:
None
CLI Example:
.. code-block:: bash
salt '*' file.set_mode /etc/passwd 0644
u {0}.set_modeu funu u� The function %s should not be used on Windows systems; see function docs for details. The value returned is always None. Use set_perms instead.( Rn R` Ro Rp Rq Rr R� ( Ri t modeRu ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt set_mode� s
c C@ sx t j j | � } t j j | � s< t d j | � � � n t j j | � rt t | � rt t d j | � � � n | r� t j
| � } t j | t j
� n y� t j j | � r� t j | � nb t | � r� t j | � nF x6 t j | � D]% } d j | | � } t | | � q� Wt j | � WnJ t t f k
rs} | rXt j | | � n t d j | | � � � n Xt S( uX
Remove the named file or directory
Args:
path (str): The path to the file or directory to remove.
force (bool): Remove even if marked Read-Only. Default is False
Returns:
bool: True if successful, False if unsuccessful
CLI Example:
.. code-block:: bash
salt '*' file.remove C:\Temp
u File path must be absolute: {0}u Path not found: {0}u {0}\{1}u Could not remove '{0}': {1}( R| Ri t
expandusert isabsR Rn R} Rf R t win32apiR� R� t win32cont FILE_ATTRIBUTE_NORMALt isfilet removeR* t listdirt OSErrort IOErrorR� ( Ri t forcet file_attributest namet itemt exc( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� s. c C@ s6 t j � j d k r$ t d � � n t j j | � sE t d � � n t j j | � sf t d � � n t j j | � } t j j | � } t j j | � } t
j t
j B} t
j
t j � | � } t j j j | � y! t j | | t | � � t SWn7 t j k
r1} t d j | | j | j � � � n Xd S( u�
Create a symbolic link to a file
This is only supported with Windows Vista or later and must be executed by
a user with the SeCreateSymbolicLink privilege.
The behavior of this function matches the Unix equivalent, with one
exception - invalid symlinks cannot be created. The source path must exist.
If it doesn't, an error will be raised.
Args:
src (str): The path to a file or directory
link (str): The path to the link
Returns:
bool: True if successful, otherwise False
CLI Example:
.. code-block:: bash
salt '*' file.symlink /path/to/file /path/to/link
i u6 Symlinks are only supported on Windows Vista or later.u% The given source path does not exist.u File path must be absolute.u" Could not create '{0}' - [{1}] {2}N( Rb Rc Rd R R| Ri R} R� RQ t isdirt
win32securityt TOKEN_QUERYt TOKEN_ADJUST_PRIVILEGESt OpenProcessTokenR� t GetCurrentProcessRV RX t wint
elevate_tokenR� t CreateSymbolicLinkt intR� t errorR Rn t winerrort strerror( t srct linkt is_dirt desired_accesst thR� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt symlinkV s.
c C@ sa t j � j d k r$ t d � � n y t j j j | � SWn t k
r\ } t | � � n Xd S( u�
Check if the path is a symlink
This is only supported on Windows Vista or later.
Inline with Unix behavior, this function will raise an error if the path
is not a symlink, however, the error raised will be a SaltInvocationError,
not an OSError.
Args:
path (str): The path to a file or directory
Returns:
bool: True if path is a symlink, otherwise False
CLI Example:
.. code-block:: bash
salt '*' file.is_link /path/to/link
i u6 Symlinks are only supported on Windows Vista or later.N(
Rb Rc Rd R RV RW Ri t islinkt ExceptionR ( Ri R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyRf � s c C@ s� t j � j d k r$ t d � � n y t j j j | � SWnm t k
r� } | j t j
k rw t d j | � � � n t | j
� � � n t k
r� } t | � � n Xd S( u�
Return the path that a symlink points to
This is only supported on Windows Vista or later.
Inline with Unix behavior, this function will raise an error if the path is
not a symlink, however, the error raised will be a SaltInvocationError, not
an OSError.
Args:
path (str): The path to the symlink
Returns:
str: The path that the symlink points to
CLI Example:
.. code-block:: bash
salt '*' file.readlink /path/to/link
i u6 Symlinks are only supported on Windows Vista or later.u {0} is not a symbolic linkN( Rb Rc Rd R RV RW Ri Rg R� t errnot EINVALR Rn t __str__R� ( Ri R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyRg � s c C@ s� t j j | � d } t j j | � s@ t d j | � � � n t j j | � } t j j | � } t j j | � s� y[ t j | � | r� t j
j j d | d | � n t
d | d | d | d | d | � Wq� t k
r� } t | � � q� Xn t S(
u�
Ensure that the directory is available and permissions are set.
Args:
path (str):
The full path to the directory.
owner (str):
The owner of the directory. If not passed, it will be the account
that created the directory, likely SYSTEM
grant_perms (dict):
A dictionary containing the user/group and the basic permissions to
grant, ie: ``{'user': {'perms': 'basic_permission'}}``. You can also
set the ``applies_to`` setting here. The default is
``this_folder_subfolders_files``. Specify another ``applies_to``
setting like this:
.. code-block:: yaml
{'user': {'perms': 'full_control', 'applies_to': 'this_folder'}}
To set advanced permissions use a list for the ``perms`` parameter,
ie:
.. code-block:: yaml
{'user': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder'}}
deny_perms (dict):
A dictionary containing the user/group and permissions to deny along
with the ``applies_to`` setting. Use the same format used for the
``grant_perms`` parameter. Remember, deny permissions supersede
grant permissions.
inheritance (bool):
If True the object will inherit permissions from the parent, if
``False``, inheritance will be disabled. Inheritance setting will
not apply to parent directories if they must be created.
reset (bool):
If ``True`` the existing DACL will be cleared and replaced with the
settings defined in this function. If ``False``, new entries will be
appended to the existing DACL. Default is ``False``.
.. versionadded:: 2018.3.0
Returns:
bool: True if successful
Raises:
CommandExecutionError: If unsuccessful
CLI Example:
.. code-block:: bash
# To grant the 'Users' group 'read & execute' permissions.
salt '*' file.mkdir C:\Temp\ Administrators "{'Users': {'perms': 'read_execute'}}"
# Locally using salt call
salt-call file.mkdir C:\Temp\ Administrators "{'Users': {'perms': 'read_execute', 'applies_to': 'this_folder_only'}}"
# Specify advanced attributes with a list
salt '*' file.mkdir C:\Temp\ Administrators "{'jsnuffy': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder_only'}}"
i u Drive {0} is not mappedt obj_namet principalRi t grant_permst
deny_permst inheritancet reset( R| Ri t
splitdriveR� R Rn R� t
expandvarst mkdirRV RW Rx R� t set_permsRS R� ( Ri t ownerR� R� R� R� t driveR� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� � s& J
c C@ s` t j j | � } t j j t j j | � � } t j j | � rb d j | � } t j | � | St j j | � r� d j | � } t j | � | Sg } xi t
rt j j | � r� Pn | j | � | } t j j | � } | | k r� t d j | � � � q� q� W| j
� xI | D]A }
t j d |
� t d |
d | d | d | d | d
| � qWt
S( uw
Ensure that the parent directory containing this path is available.
Args:
path (str):
The full path to the directory.
.. note::
The path must end with a trailing slash otherwise the
directory(s) will be created up to the parent directory. For
example if path is ``C:\temp\test``, then it would be treated
as ``C:\temp\`` but if the path ends with a trailing slash
like ``C:\temp\test\``, then it would be treated as
``C:\temp\test\``.
owner (str):
The owner of the directory. If not passed, it will be the account
that created the directory, likely SYSTEM.
grant_perms (dict):
A dictionary containing the user/group and the basic permissions to
grant, ie: ``{'user': {'perms': 'basic_permission'}}``. You can also
set the ``applies_to`` setting here. The default is
``this_folder_subfolders_files``. Specify another ``applies_to``
setting like this:
.. code-block:: yaml
{'user': {'perms': 'full_control', 'applies_to': 'this_folder'}}
To set advanced permissions use a list for the ``perms`` parameter, ie:
.. code-block:: yaml
{'user': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder'}}
deny_perms (dict):
A dictionary containing the user/group and permissions to deny along
with the ``applies_to`` setting. Use the same format used for the
``grant_perms`` parameter. Remember, deny permissions supersede
grant permissions.
inheritance (bool):
If True the object will inherit permissions from the parent, if
False, inheritance will be disabled. Inheritance setting will not
apply to parent directories if they must be created.
reset (bool):
If ``True`` the existing DACL will be cleared and replaced with the
settings defined in this function. If ``False``, new entries will be
appended to the existing DACL. Default is ``False``.
.. versionadded:: 2018.3.0
Returns:
bool: True if successful
Raises:
CommandExecutionError: If unsuccessful
CLI Example:
.. code-block:: bash
# To grant the 'Users' group 'read & execute' permissions.
salt '*' file.makedirs C:\Temp\ Administrators "{'Users': {'perms': 'read_execute'}}"
# Locally using salt call
salt-call file.makedirs C:\Temp\ Administrators "{'Users': {'perms': 'read_execute', 'applies_to': 'this_folder_only'}}"
# Specify advanced attributes with a list
salt '*' file.makedirs C:\Temp\ Administrators "{'jsnuffy': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder_only'}}"
u Directory '{0}' already existsu4 The path '{0}' already exists and is not a directoryu` Recursive creation for path '{0}' would result in an infinite loop. Please use an absolute path.u Creating directory: %sRi R� R� R� R� R� ( R| Ri R� RQ RH R� Rn Rq R� R} R� R R t reverseR� ( Ri R� R� R� R� R� RH t msgt directories_to_createt current_dirnamet directory_to_create( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt makedirs_@ sB Q
c C@ s t j j | � } t j j | � } t j j | � \ } } | s] t j j | � \ } } n | r� | r� t j j | � r� y/ t d | d | d | d | d t d t � Wn+ t k
r� } | j
t
j k r� � q� n X| t j k r� i Sn t
d | d | d | d | d | d | � t S( u�
Set owner and permissions for each directory created.
Args:
path (str):
The full path to the directory.
owner (str):
The owner of the directory. If not passed, it will be the account
that created the directory, likely SYSTEM.
grant_perms (dict):
A dictionary containing the user/group and the basic permissions to
grant, ie: ``{'user': {'perms': 'basic_permission'}}``. You can also
set the ``applies_to`` setting here. The default is
``this_folder_subfolders_files``. Specify another ``applies_to``
setting like this:
.. code-block:: yaml
{'user': {'perms': 'full_control', 'applies_to': 'this_folder'}}
To set advanced permissions use a list for the ``perms`` parameter, ie:
.. code-block:: yaml
{'user': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder'}}
deny_perms (dict):
A dictionary containing the user/group and permissions to deny along
with the ``applies_to`` setting. Use the same format used for the
``grant_perms`` parameter. Remember, deny permissions supersede
grant permissions.
inheritance (bool):
If ``True`` the object will inherit permissions from the parent, if
``False``, inheritance will be disabled. Inheritance setting will
not apply to parent directories if they must be created
reset (bool):
If ``True`` the existing DACL will be cleared and replaced with the
settings defined in this function. If ``False``, new entries will be
appended to the existing DACL. Default is ``False``.
.. versionadded:: 2018.3.0
Returns:
bool: True if successful, otherwise raises an error
CLI Example:
.. code-block:: bash
# To grant the 'Users' group 'read & execute' permissions.
salt '*' file.makedirs_perms C:\Temp\ Administrators "{'Users': {'perms': 'read_execute'}}"
# Locally using salt call
salt-call file.makedirs_perms C:\Temp\ Administrators "{'Users': {'perms': 'read_execute', 'applies_to': 'this_folder_only'}}"
# Specify advanced attributes with a list
salt '*' file.makedirs_perms C:\Temp\ Administrators "{'jsnuffy': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder_files'}}"
Ri R� R� R� R� R� ( R| Ri R� R� t splitR} t makedirs_permsR� R^ R� R� t EEXISTt curdirR� ( Ri R� R� R� R� R� t headt tailR� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� � s6 F
c C@ sw t j j | � s* t d j | � � � n t j j | � } t d d | d d d | d | d | d | d
| d | � S( u}
Check owner and permissions for the passed directory. This function checks
the permissions and sets them, returning the changes made. Used by the file
state to populate the return dict
Args:
path (str):
The full path to the directory.
ret (dict):
A dictionary to append changes to and return. If not passed, will
create a new dictionary to return.
owner (str):
The owner to set for the directory.
grant_perms (dict):
A dictionary containing the user/group and the basic permissions to
check/grant, ie: ``{'user': {'perms': 'basic_permission'}}``.
Default is ``None``.
deny_perms (dict):
A dictionary containing the user/group and permissions to
check/deny. Default is ``None``.
inheritance (bool):
``True will check if inheritance is enabled and enable it. ``False``
will check if inheritance is disabled and disable it. Default is
``True``.
reset (bool):
``True`` will show what permissions will be removed by resetting the
DACL. ``False`` will do nothing. Default is ``False``.
Returns:
dict: A dictionary of changes that have been made
CLI Example:
.. code-block:: bash
# To see changes to ``C:\Temp`` if the 'Users' group is given 'read & execute' permissions.
salt '*' file.check_perms C:\Temp\ {} Administrators "{'Users': {'perms': 'read_execute'}}"
# Locally using salt call
salt-call file.check_perms C:\Temp\ {} Administrators "{'Users': {'perms': 'read_execute', 'applies_to': 'this_folder_only'}}"
# Specify advanced attributes with a list
salt '*' file.check_perms C:\Temp\ {} Administrators "{'jsnuffy': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'files_only'}}"
u Path not found: {0}u dacl.check_permsR� t obj_typeu fileR� R� R� R� R� R� ( R| Ri R} R Rn R� t __utils__( Ri R� R� R� R� R� R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt check_perms4 s :c
C@ s/ t d d | d d d | d | d | d | � S( u�
Set permissions for the given path
Args:
path (str):
The full path to the directory.
grant_perms (dict):
A dictionary containing the user/group and the basic permissions to
grant, ie: ``{'user': {'perms': 'basic_permission'}}``. You can also
set the ``applies_to`` setting here. The default for ``applise_to``
is ``this_folder_subfolders_files``. Specify another ``applies_to``
setting like this:
.. code-block:: yaml
{'user': {'perms': 'full_control', 'applies_to': 'this_folder'}}
To set advanced permissions use a list for the ``perms`` parameter,
ie:
.. code-block:: yaml
{'user': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder'}}
To see a list of available attributes and applies to settings see
the documentation for salt.utils.win_dacl.
A value of ``None`` will make no changes to the ``grant`` portion of
the DACL. Default is ``None``.
deny_perms (dict):
A dictionary containing the user/group and permissions to deny along
with the ``applies_to`` setting. Use the same format used for the
``grant_perms`` parameter. Remember, deny permissions supersede
grant permissions.
A value of ``None`` will make no changes to the ``deny`` portion of
the DACL. Default is ``None``.
inheritance (bool):
If ``True`` the object will inherit permissions from the parent, if
``False``, inheritance will be disabled. Inheritance setting will
not apply to parent directories if they must be created. Default is
``False``.
reset (bool):
If ``True`` the existing DCL will be cleared and replaced with the
settings defined in this function. If ``False``, new entries will be
appended to the existing DACL. Default is ``False``.
.. versionadded:: 2018.3.0
Returns:
bool: True if successful
Raises:
CommandExecutionError: If unsuccessful
CLI Example:
.. code-block:: bash
# To grant the 'Users' group 'read & execute' permissions.
salt '*' file.set_perms C:\Temp\ "{'Users': {'perms': 'read_execute'}}"
# Locally using salt call
salt-call file.set_perms C:\Temp\ "{'Users': {'perms': 'read_execute', 'applies_to': 'this_folder_only'}}"
# Specify advanced attributes with a list
salt '*' file.set_perms C:\Temp\ "{'jsnuffy': {'perms': ['read_attributes', 'read_ea'], 'applies_to': 'this_folder_only'}}"
u dacl.set_permsR� R u fileR� R� R� R� ( R ( Ri R� R� R� R� ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyR� } s N(� t __doc__t
__future__R R R R| R� t os.patht loggingt operatort collectionsR R t functoolsR t datetimet tempfilet itertoolst
contextlibt difflibt hashlibR� t shutilt ret stringRb t iot fnmatcht mmapt globt salt.extR t salt.ext.six.moves.urllib.parseR t _urlparset salt.utils.atomicfileRV t salt.exceptionsR R t salt.utils.patht salt.utils.platformt salt.utils.usert salt.modules.fileR
R R R
R R R R R R R R R R R R R R R R R R R R! R" R# R$ R% R& R' R( R) R* R+ R, R- R. R/ R0 R1 R2 R3 R4 R5 R6 R7 R8 R9 R: R; R< R= R> R? R@ RA RB RC RD RE RF RG RH RI RJ RK RL RM RN RO RP RQ R] t salt.utils.functoolsRR R[ R^ RZ RW RX RY R� R� R� R� t salt.platform.winR� t ImportErrort
exceptionsRS R� R_ t salt.utils.win_daclt getLoggerRT Rq R` Ra t
__outputter__t __func_alias__Rm Rv R{ R� R� R� R� Rs R� R� R� R� Rw R� R� R� R� R� R� R� R� R� R� Rf Rg R� R� R� R R� ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_file.pyt <module>
s� � �
f
# * # , , ( ' 19 +M ? L > ? $ e m D
Mini Shell