??????????????
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 173
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 174
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 175
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 176
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 177
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 178
ó
ßUdac @` s© d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d
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 d a d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d d „ Z! d „ Z" d „ Z# d „ Z$ d „ Z% d „ Z& d „ Z' d! „ Z( d" „ Z) d# „ Z* e+ d$ k r¥e* ƒ n d S(% i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont stableinterfacet statust coret supported_bysÀ
---
module: file
version_added: historical
short_description: Manage files and file properties
extends_documentation_fragment: files
description:
- Set attributes of files, symlinks or directories.
- Alternatively, remove files, symlinks or directories.
- Many other modules support the same options as the C(file) module - including M(copy), M(template), and M(assemble).
- For Windows targets, use the M(win_file) module instead.
options:
path:
description:
- Path to the file being managed.
type: path
required: yes
aliases: [ dest, name ]
state:
description:
- If C(absent), directories will be recursively deleted, and files or symlinks will
be unlinked. In the case of a directory, if C(diff) is declared, you will see the files and folders deleted listed
under C(path_contents). Note that C(absent) will not cause C(file) to fail if the C(path) does
not exist as the state did not change.
- If C(directory), all intermediate subdirectories will be created if they
do not exist. Since Ansible 1.7 they will be created with the supplied permissions.
- If C(file), without any other options this works mostly as a 'stat' and will return the current state of C(path).
Even with other options (i.e C(mode)), the file will be modified but will NOT be created if it does not exist;
see the C(touch) value or the M(copy) or M(template) module if you want that behavior.
- If C(hard), the hard link will be created or changed.
- If C(link), the symbolic link will be created or changed.
- If C(touch) (new in 1.4), an empty file will be created if the C(path) does not
exist, while an existing file or directory will receive updated file access and
modification times (similar to the way C(touch) works from the command line).
type: str
default: file
choices: [ absent, directory, file, hard, link, touch ]
src:
description:
- Path of the file to link to.
- This applies only to C(state=link) and C(state=hard).
- For C(state=link), this will also accept a non-existing path.
- Relative paths are relative to the file being created (C(path)) which is how
the Unix command C(ln -s SRC DEST) treats relative paths.
type: path
recurse:
description:
- Recursively set the specified file attributes on directory contents.
- This applies only when C(state) is set to C(directory).
type: bool
default: no
version_added: '1.1'
force:
description:
- >
Force the creation of the symlinks in two cases: the source file does
not exist (but will appear later); the destination exists and is a file (so, we need to unlink the
C(path) file and create symlink to the C(src) file in place of it).
type: bool
default: no
follow:
description:
- This flag indicates that filesystem links, if they exist, should be followed.
- Previous to Ansible 2.5, this was C(no) by default.
type: bool
default: yes
version_added: '1.8'
modification_time:
description:
- This parameter indicates the time the file's modification time should be set to.
- Should be C(preserve) when no modification is required, C(YYYYMMDDHHMM.SS) when using default time format, or C(now).
- Default is None meaning that C(preserve) is the default for C(state=[file,directory,link,hard]) and C(now) is default for C(state=touch).
type: str
version_added: "2.7"
modification_time_format:
description:
- When used with C(modification_time), indicates the time format that must be used.
- Based on default Python format (see time.strftime doc).
type: str
default: "%Y%m%d%H%M.%S"
version_added: '2.7'
access_time:
description:
- This parameter indicates the time the file's access time should be set to.
- Should be C(preserve) when no modification is required, C(YYYYMMDDHHMM.SS) when using default time format, or C(now).
- Default is C(None) meaning that C(preserve) is the default for C(state=[file,directory,link,hard]) and C(now) is default for C(state=touch).
type: str
version_added: '2.7'
access_time_format:
description:
- When used with C(access_time), indicates the time format that must be used.
- Based on default Python format (see time.strftime doc).
type: str
default: "%Y%m%d%H%M.%S"
version_added: '2.7'
seealso:
- module: assemble
- module: copy
- module: stat
- module: template
- module: win_file
author:
- Ansible Core Team
- Michael DeHaan
sR
- name: Change file ownership, group and permissions
file:
path: /etc/foo.conf
owner: foo
group: foo
mode: '0644'
- name: Give insecure permissions to an existing file
file:
path: /work
owner: root
group: root
mode: '1777'
- name: Create a symbolic link
file:
src: /file/to/link/to
dest: /path/to/symlink
owner: foo
group: foo
state: link
- name: Create two hard links
file:
src: '/tmp/{{ item.src }}'
dest: '{{ item.dest }}'
state: hard
loop:
- { src: x, dest: y }
- { src: z, dest: k }
- name: Touch a file, using symbolic modes to set the permissions (equivalent to 0644)
file:
path: /etc/foo.conf
state: touch
mode: u=rw,g=r,o=r
- name: Touch the same file, but add/remove some permissions
file:
path: /etc/foo.conf
state: touch
mode: u+rw,g-wx,o-rwx
- name: Touch again the same file, but dont change times this makes the task idempotent
file:
path: /etc/foo.conf
state: touch
mode: u+rw,g-wx,o-rwx
modification_time: preserve
access_time: preserve
- name: Create a directory if it does not exist
file:
path: /etc/some_directory
state: directory
mode: '0755'
- name: Update modification and access time of given file
file:
path: /etc/some_file
state: file
modification_time: now
access_time: now
- name: Set access time based on seconds from epoch value
file:
path: /etc/another_file
state: file
access_time: '{{ "%Y%m%d%H%M.%S" | strftime(stat_var.stat.atime) }}'
- name: Recursively change ownership of a directory
file:
path: /etc/foo
state: directory
recurse: yes
owner: foo
group: foo
- name: Remove file (delete file)
file:
path: /etc/foo.txt
state: absent
- name: Recursively remove directory
file:
path: /etc/foo
state: absent
s
N( t
AnsibleModule( t to_bytest to_nativet AnsibleModuleErrorc B` s e Z d „ Z d „ Z RS( c C` s
| | _ d S( N( t results( t selfR ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt __init__æ s c C` s t d j | j ƒ ƒ d S( Ns AnsibleModuleError(results={0})( t printt formatR ( R
( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt __repr__é s ( t __name__t
__module__R R ( ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyR å s t ParameterErrorc B` s e Z RS( ( R R ( ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyR í s t Sentinelc B` s e Z d „ Z RS( c O` s | S( N( ( t clst argst kwargs( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt __new__ò s ( R R R ( ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyR ñ s c C` s9 t | t ƒ r" t j | j n t j | | | ƒ d S( N( t
issubclassR t modulet fail_jsonR t syst __excepthook__( t exc_typet exc_valuet tb( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt _ansible_excepthookö s c C` sz | d d k r› t j j t | d d d ƒƒ r› d } | d rO | d } n# | d rr t j j | d ƒ } n | r› t j j | d | ƒ | d /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt additional_parameter_handlingþ s* 2
#
c C` s« t | d d ƒ} yf t j j | ƒ rs t j j | ƒ r= d St j j | ƒ rS d St j | ƒ j d k ro d Sd Sd SWn, t k
r¦ } | j t j
k r d S‚ n Xd S(
s Find out current state R' R( R$ R, i R/ R- R% N( R R0 R& t lexistst islinkR1 t statt st_nlinkt OSErrort errnot ENOENT( R& t b_patht e( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyR5 1 s c
C` s' t } yÛxÔt j | ƒ D]Ã\ } } } x±| | D]¥} t j j | | ƒ }
t j j |
ƒ s» | j ƒ } t |
d d ƒ| d <| t j | | d t ƒO} | t
| d | | ƒ O} q3 | j ƒ } t |
d d ƒ| d <| t j | | d t ƒO} | t
| d | | ƒ O} | r3 t j j | t j |
ƒ ƒ }
t j j |
ƒ rØt j j
|
ƒ rz| t |
| | | | ƒ O} n | j ƒ } t |
d d ƒ| d <| t j | | d t ƒO} | t
| d | | ƒ O} qØq3 q3 Wq WWn? t k
r"} t d i d t | ƒ t | ƒ f d 6ƒ ‚ n X| S( NR' R( R& t expandR sD Could not recursively set attributes on %s. Original error was: '%s'R. ( t FalseR0 t walkR& R4 R; t copyR
R t set_fs_attributes_if_differentt update_timestamp_for_filet readlinkt existsR1 t recursive_set_attributest RuntimeErrorR (
RA t followt file_argst mtimet atimet changedt b_roott b_dirst b_filest b_fsobjt b_fsnamet
tmp_file_argsRB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyRK J s6 ,*c
C` s1 i i | d 6d 6i | d 6d 6} | | k r-| | d d <| | d d <| d k r-| d k r-i g d 6g d 6} t | d d
ƒ} xŽ t j | ƒ D]} \ } } } x4 | D], } t j j | | ƒ }
| d j |
ƒ q® Wx4 | D], } t j j | | ƒ } | d j | ƒ qå Wq˜ W| | d d /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt initial_diffu s&
c
C` s˜ | d k r d S| d k r t Sy% t j | | ƒ } t j | ƒ } WnH t t f k
r } t d i d | | t | d d ƒf d 6ƒ ‚ n X| Sd S( Nt preservet nowR s? Error while obtaining timestamp for time %s using format %s: %st nonstringt
simplereprR. ( R2 R t timet strptimet mktimet
ValueErrort
OverflowErrorR R
( t formatted_timet time_formatt structt struct_timeRB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt get_timestamp_for_time• s 'c C` s! t | d d ƒ} yÈ| t k rj | t k rj t j ƒ } } t j | ƒ j } t j | ƒ j } d } nÈ | d k r† | d k r† t St j | ƒ j } t j | ƒ j } | d k r¿ | } n | t k rÚ t j ƒ } n | d k rï | } n | t k r
t j ƒ } n | | k r&| | k r&t S| | f } t j | | ƒ | d k rÙd | k rgi | d R R
t True( R& RO RP R^ RA t previous_mtimet previous_atimet set_timeRB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyRH ¥ sL
%c C` s@ | d k r | d k r d S| d k r8 | d k r8 d S| Sd S( NR- R/ R, R$ Rg t touchRh ( s files hards directorys link( R2 ( t parameterR# ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt) keep_backward_compatibility_on_timestampsß s
c C` sp t | d d ƒ} t } y+ t | d ƒ } | j d ƒ } Wd QXWn t k
rV n Xd | k rl t } n | S( s2 Take a guess as to whether a file is a binary fileR' R( t rbi Nt ( R RD t opent readt ExceptionRx ( R& RA t appears_binaryt ft head( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt execute_diff_peekè s
c C` s_ t | d d ƒ} t | ƒ } i } | d k r9t | d | ƒ } t j s
| d k r§ y t j | d t ƒWq
t k
r£ } t d i d t
| ƒ d 6ƒ ‚ q
Xq
y t j | ƒ Wq
t
k
r } | j t j k r
t d i d t
| ƒ d 6| d
6ƒ ‚ q
q
Xn | j i | d
6t d 6| d 6d d
6ƒ n" | j i | d
6t d 6d d
6ƒ | S( NR' R( R% R, t
ignore_errorsR s rmtree failed: %sR. s unlinking failed: %s R& RQ R^ R# ( R R5 Rf R t
check_modet shutilt rmtreeRD Rƒ R R
R0 t unlinkR> R? R@ t updateRx ( R& RA R8 t resultR^ RB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt
ensure_absentù s( ',"c C` s™ t | d d ƒ} t | ƒ } t } i | d 6} t | d | d ƒ } t | d | d ƒ } t j s•| d k rÝ y t | d ƒ j ƒ t } WqÝ t t
f k
rÙ } t d
i d t | d d
ƒd 6| d 6ƒ ‚ qÝ Xn t
| d | ƒ }
t j t j ƒ } y< t j | | |
d t ƒ} | t | d | | |
ƒ O} Wn> t k
r}} | j rw| d k rwt j | ƒ qwn ‚ n X| | d <|
| d t IOErrorR R
Rf t load_file_common_argumentsR7 RG RH t
SystemExitt codeR0 t remove( R& RM t
timestampsRA R8 RQ RŽ RO RP RB R^ RN ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt
execute_touch s8
!
c
C` s\ t | d d ƒ} t | ƒ } t j t j ƒ } t | d | d ƒ } t | d | d ƒ } | d k r¼ | r¼ | d k r¼ t j j | ƒ } t | d d ƒ} t | ƒ } | | d
/usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt ensure_file_attributes= s$ c C` s& t | d d ƒ} t | ƒ } t j t j ƒ } t | d | d ƒ } t | d | d ƒ } | r | d k r t j j | ƒ } t | d d ƒ} | | d R? t EEXISTR1 RF RG RH Rƒ R RK ( R& RM R+ Rœ RA R8 RN RO RP RQ R^ t curpatht dirnamet b_curpatht exRW RB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt ensure_directoryW s\
$
( c
C` sæ t | d d ƒ} t | d d ƒ} t | ƒ } t | d | d ƒ } t | d | d ƒ } | d k r¦ | r¦ t t j j | ƒ d d ƒ} t | d d ƒ} q¦ n t j j | ƒ rÔ t j j | ƒ rÔ | }
n$ t j j
| ƒ } t | d d ƒ}
t j j |
| ƒ } t | d d ƒ}
| rdt j j |
ƒ rdt
d i d | d
6| d 6| d 6ƒ ‚ n | d
k rÖ| s t
d i d | | f d
6| d 6ƒ ‚ qt j | ƒ rt
d i d | d
6| d 6ƒ ‚ qn= | d# k r| rt
d i d | | f d
6| d 6ƒ ‚ n t | d | ƒ } t } | d k r@t } nZ| d k r›t j | ƒ } | | k ršt | d d ƒ| d d <| | d d RŒ R˜ R7 R6 RG RH ( R& R* RM t forceRœ RA t b_srcR8 RO RP t relpatht b_relpatht absrct b_absrcR^ RQ t b_old_srct b_tmppathRB RN ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt ensure_symlinkž s° % $ 7 / c C` sø t | d d ƒ} t | d d ƒ} t | ƒ } t j t j ƒ } t | d | d ƒ } t | d | d ƒ }
| d k r• t d i d d 6ƒ ‚ n t j j
| ƒ sÎ t d i d
d 6| d 6| d 6ƒ ‚ n t | d
| ƒ } t } | d k rû t
} n»| d k rVt j | ƒ }
|
| k r¶t |
d d ƒ| d d <| | d d R? R@ R$ R³ RG RH ( R& R* RM R´ Rœ RA Rµ R8 RN RO RP R^ RQ Rº R» RB ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt ensure_hardlink sŽ ' $ $ $ 7 c
C` sì t d t d t d d d d d d d d
d g ƒ d t d d d
t d d d g ƒ d t d d ƒ d t d d d t ƒ d t d d d t ƒ d t d d d t ƒ d t d d ƒ d t d d ƒ d t d d ƒ d t d d d d ƒ d t d d ƒ d t d d d d ƒ ƒ d t d t ƒ a t t _ t t j ƒ t j } | d } | d } | d } | d } | d } | d } i } t
| d | ƒ | d <| d | d /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt mainm s\ '!
t __main__(, t
__future__R R R RÀ t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR? R0 RŠ R Rk t ansible.module_utils.basicR t ansible.module_utils._textR R
R2 R Rƒ R R t objectR R" R9 R5 RK Rf Rt RH R~ R‡ R R R R R¼ R¾ RÎ R ( ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/file.pyt sH
j[ 3 + : ' G w X >