관리-도구
편집 파일: file.cpython-39.pyc
a �)g�� � @ sb d dl mZmZmZ eZdZdZdZd dl Z d dl Z d dl Z d dl Z d dl Z d dlmZmZ d dlmZmZ d dlmZ d d lmZmZ daG d d � d e�ZG d d � d e�Z G dd� de �Z dd� Z dd� Z dd� Z!dd� Z"dd� Z#dd� Z$d5d d �Z%d d � Z&d d!� Z'd"d#� Z(d$d%� Z)d&d'� Z*d(d)� Z+d*d+� Z,d,d-� Z-d.d/� Z.d0d1� Z/d2d3� Z0e1d4k�r^e0� dS )6� )�absolute_import�division�print_functionaZ --- module: file version_added: historical short_description: Manage files and file properties extends_documentation_fragment: [files, action_common_attributes] description: - Set attributes of files, directories, or symlinks and their targets. - Alternatively, remove files, symlinks or directories. - Many other modules support the same options as the C(file) module - including M(ansible.builtin.copy), M(ansible.builtin.template), and M(ansible.builtin.assemble). - For Windows targets, use the M(ansible.windows.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), with no other options, returns the current state of C(path). - If C(file), even with other options (such as C(mode)), the file will be modified if it exists but will NOT be created if it does not exist. Set to C(touch) or use the M(ansible.builtin.copy) or M(ansible.builtin.template) module if you want to create the file if it does not exist. - 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 file 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). - Default is the current state of the file if it exists, C(directory) if C(recurse=yes), or C(file) otherwise. type: str 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. - I(follow=yes) and I(state=link) can modify I(src) when combined with parameters such as I(mode). - Previous to Ansible 2.5, this was C(false) 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: ansible.builtin.assemble - module: ansible.builtin.copy - module: ansible.builtin.stat - module: ansible.builtin.template - module: ansible.windows.win_file attributes: check_mode: support: full diff_mode: details: permissions and ownership will be shown but file contents on absent/touch will not. support: partial platform: platforms: posix author: - Ansible Core Team - Michael DeHaan a$ - name: Change file ownership, group and permissions ansible.builtin.file: path: /etc/foo.conf owner: foo group: foo mode: '0644' - name: Give insecure permissions to an existing file ansible.builtin.file: path: /work owner: root group: root mode: '1777' - name: Create a symbolic link ansible.builtin.file: src: /file/to/link/to dest: /path/to/symlink owner: foo group: foo state: link - name: Create two hard links ansible.builtin.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) ansible.builtin.file: path: /etc/foo.conf state: touch mode: u=rw,g=r,o=r - name: Touch the same file, but add/remove some permissions ansible.builtin.file: path: /etc/foo.conf state: touch mode: u+rw,g-wx,o-rwx - name: Touch again the same file, but do not change times this makes the task idempotent ansible.builtin.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 ansible.builtin.file: path: /etc/some_directory state: directory mode: '0755' - name: Update modification and access time of given file ansible.builtin.file: path: /etc/some_file state: file modification_time: now access_time: now - name: Set access time based on seconds from epoch value ansible.builtin.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 ansible.builtin.file: path: /etc/foo state: directory recurse: yes owner: foo group: foo - name: Remove file (delete file) ansible.builtin.file: path: /etc/foo.txt state: absent - name: Recursively remove directory ansible.builtin.file: path: /etc/foo state: absent ak dest: description: Destination file/path, equal to the value passed to I(path). returned: state=touch, state=hard, state=link type: str sample: /path/to/file.txt path: description: Destination file/path, equal to the value passed to I(path). returned: state=absent, state=directory, state=file type: str sample: /path/to/file.txt N)�getpwnam�getpwuid)�getgrnam�getgrgid)� AnsibleModule)�to_bytes� to_nativec @ s e Zd Zdd� Zdd� ZdS )�AnsibleModuleErrorc C s || _ d S �N��results)�selfr � r �8/usr/lib/python3.9/site-packages/ansible/modules/file.py�__init__� s zAnsibleModuleError.__init__c C s d� | j�S )Nz AnsibleModuleError(results={0}))�formatr )r r r r �__repr__� s zAnsibleModuleError.__repr__N)�__name__� __module__� __qualname__r r r r r r r � s r c @ s e Zd ZdS )�ParameterErrorN)r r r r r r r r � s r c @ s e Zd Zdd� ZdS )�Sentinelc O s | S r r )�cls�args�kwargsr r r �__new__ s zSentinel.__new__N)r r r r r r r r r s r c C s0 t | t�r tjf i |j�� nt�| ||� d S r )� issubclassr �moduleZ fail_jsonr �sys�__excepthook__)�exc_type� exc_value�tbr r r �_ansible_excepthook s r& c C s | d dvrlt j�t| d dd��rld}| d r:| d }n| d rRt j�| d �}|rlt j�| d |�| d< tt| d dd��}| d du r�|d kr�|| d< n| d r�d | d< nd | d< | d r�| d d kr�td | d d�d��| d �r | d dv�r td| d d�d��dS )z0Additional parameter validation and reformatting�state)�link�absent�path�surrogate_or_strict��errorsN�_original_basename�srcr) �recurse� directory�filez/recurse option requires state to be 'directory'��msgr* r )r( �hardz0src option requires state to be 'link' or 'hard')�osr* �isdirr �basename�join� get_stater )�paramsr8 � prev_stater r r � additional_parameter_handling s. $ � �r= c C s� t | dd�}zRtj�|�rZtj�|�r,W dS tj�|�r>W dS t�|�jdkrTW dS W dS W dS ty� } z(|j t j kr�W Y d }~dS � W Y d }~n d }~0 0 d S ) z Find out current state r+ r, r( r1 � r5 r2 r) N) r r6 r* �lexists�islinkr7 �stat�st_nlink�OSError�errno�ENOENT)r* �b_path�er r r r: > s r: c C s� d}�zNt �| �D �]<\}}}|| D �]&} t j�|| �} t j�| �s�|�� } t| dd�| d< |tj| |dd�O }|t | d ||�O }q&|�� } t| dd�| d< |tj| |dd�O }|t | d ||�O }|r&t j�|t � | ��} t j� | �r&t j� | ��r|t | ||||�O }|�� } t| dd�| d< |tj| |dd�O }|t | d ||�O }q&qW nD t�y� } z*tddt| �t| �f id��W Y d } ~ n d } ~ 0 0 |S ) NFr+ r, r* ��expandr4 zDCould not recursively set attributes on %s. Original error was: '%s'r )r6 �walkr* r9 r@ �copyr r � set_fs_attributes_if_different�update_timestamp_for_file�readlink�existsr7 �recursive_set_attributes� RuntimeErrorr ) rF �follow� file_args�mtime�atime�changedZb_rootZb_dirsZb_filesZb_fsobjZb_fsname� tmp_file_argsrG r r r rP W s8 � rP c C s� d| id| id�}||kr�||d d< ||d d< |dkr�|dkr�g g d�}t | d d �}t�|�D ]V\}}}|D ] } tj�|| �} |d �| � qp|D ] } tj�|| �} |d �| � q�qb||d d < |S )Nr* )�before�afterrX r' rY r) r1 )� directories�filesr+ r, rZ r[ Z path_content)r r6 rJ r* r9 �append) r* r' r< �diffZwalklistrF � base_pathZ sub_foldersr[ ZfolderZ folderpath�filename�filepathr r r � initial_diff� s( � � ra c C s� | dkr d S | dkrt S zt�| |�}t�|�}W nH ttfyz } z,tdd| |t|dd�f id��W Y d }~n d }~0 0 |S d S )N�preserve�nowr4 z?Error while obtaining timestamp for time %s using format %s: %s� simplerepr�Z nonstringr )r �time�strptime�mktime� ValueError� OverflowErrorr r )Zformatted_timeZ time_format�struct� struct_timerG r r r �get_timestamp_for_time� s � rm c C s� t | dd�}�zH|tu rJ|tu rJt�� }}t�|�j}t�|�j}d }n�|d u r`|d u r`W dS t�|�j}t�|�j}|d u r�|}n|tu r�t�� }|d u r�|}n|tu r�t�� }||kr�||kr�W dS ||f}tjs�t� ||� |d u�rTd|vr�i |d< d|v�ri |d< ||k�r2||d d< ||d d< ||k�rT||d d< ||d d< W nB t �y� } z(t dt |d d � | d �d ��W Y d }~n d }~0 0 d S )Nr+ r, FrX rY rT rU z4Error while updating modification or access time: %srd re r3 r T) r r rf r6 rA �st_mtime�st_atimer � check_mode�utimerC r r ) r* rT rU r] rF Zprevious_mtimeZprevious_atimeZset_timerG r r r rM � sT �� rM c C s0 |dv r| d u rdS |dkr(| d u r(dS | S d S )N)r2 r5 r1 r( rb �touchrc r )Z parameterr' r r r �)keep_backward_compatibility_on_timestamps� s rs c C sl t | dd�}d}z8t|d��}|�d�}W d � n1 s<0 Y W n tyZ Y n0 d|v rhd}|S ) z2Take a guess as to whether a file is a binary filer+ r, F�rbi N� T)r �open�read� Exception)r* rF �appears_binary�f�headr r r �execute_diff_peek� s , r| c C s t | dd�}t|�}i }|dkr�t| d|�}tjs�|dkr�ztj|dd� W q� ty� } z"tddt |� id ��W Y d }~q�d }~0 0 nXzt � |� W nH t y� } z0|j t jkr�td t |� | d �d ��W Y d }~n d }~0 0 |�| d |dd �� n|�| ddd�� |S )Nr+ r, r) r1 F)� ignore_errorsr4 zrmtree failed: %sr zunlinking failed: %s r3 T)r* rV r] r' )r* rV r' )r r: ra r rp �shutil�rmtreerx r r r6 �unlinkrC rD rE �update)r* rF r< �resultr] rG r r r � ensure_absent s* . � r� c C sX t | dd�}t|�}d}d| i}t|d |d �}t|d |d �}|d kr�tjr^d |d < |S zt|d ��� d }W nD ttfy� } z(t d t | dd� | d�d��W Y d } ~ n d } ~ 0 0 t | d|�} t� tj �} z,tj| || dd�}|t| d ||| �O }W nD t�yB } z*| j�r,|d k�r,t�|� � W Y d } ~ n d } ~ 0 0 ||d < | |d< |S )Nr+ r, F�dest�modification_time�modification_time_format� access_time�access_time_formatr) TrV �wbz!Error, could not touch target: %srd re r3 r rr rH r* r] )r r: rm r rp rv �closerC �IOErrorr r ra �load_file_common_argumentsr; rL rM � SystemExit�coder6 �remove) r* rR � timestampsrF r< rV r� rT rU rG r] rS r r r � execute_touch$ s@ �� r� c C s� t | dd�}t|�}t�tj�}t|d |d �}t|d |d �}|dkr�|r�|dkr�tj�|�}t |d d�} t|�}| |d < |d vr�t d | |f | |d �d��t | d|�}tj |d|dd�} | t |d |||�O } | | |d�S )Nr+ r, r� r� r� r� r2 r( �strictr* �r2 r5 z file (%s) is %s, cannot continue)r4 r* r' r FrH �r* rV r] )r r: r r� r; rm r6 r* �realpathr r ra rL rM ) r* rR r� rF r< rS rT rU r] rV r r r �ensure_file_attributesO s& � r� c C sN t | dd�}t|�}t�tj�}t|d |d �}t|d |d �}|rx|dkrxtj�|�}t |dd�} | |d < t|�}d } t | d |�} |d k�r�tj r�| d | d�S d} z�| � d�� d�D ]�} d�| | g�} tj�| �s�| �d�} t | dd�} tj�| �s�zt�| � d } W nD t�yP } z*|jtjk�r:tj�| ��s<� W Y d }~n d }~0 0 |�� }| |d < tj|| | d d�} | t|d ||| �O } q�W nB t�y� } z(td| t |�f | d�d��W Y d }~n d }~0 0 | | | d�S |d k�r td| |f | d�d��tj|| | d d�} | t|d ||| �O } |�rB| t |||||�O } | | | d�S )Nr+ r, r� r� r� r� r( r� r* Fr1 r) Tr� � �/rH z/There was an issue creating %s as requested: %sr3 r z%s already exists as a %s) r r: r r� r; rm r6 r* r� r ra rp �strip�splitr9 �isabs�lstriprO �mkdirrC rD ZEEXISTr7 rK rL rM rx r rP )r* rR r0 r� rF r< rS rT rU rV r] Zcurpath�dirnameZ b_curpath�exrW rG r r r �ensure_directoryi sb �� � r� c C s� t | dd�}t |dd�}t|�}t|d |d �}t|d |d �} |d u rz|rztj�|�rztt�|�dd�}t |dd�}tj�|�s�tj� |�r�| } ntj� |�} t| dd�} |d u r�d } ntj� | |�} t | dd�} |�s |d u�r tj�| ��s t d| | |d �d ��|d k�rX|�s6t d || f | d �d ��n t� |��r�t d| | d �d ��n(|dv �r�|�s�t d || f | d �d ��t| d|�}d}|dv �r�|d u �r�t ddid ��d}n`|dk�r|d u�rt�|�}||k�rt|dd�|d d< ||d d< d}nt d| |d�d ��|�rDtj�sD|dk�r�t tjj�� tj� |�t d t�� t�� f �g�}z0|d k�rxt�|� t�||� t�||� W nZ t�y� } z@tj�|��r�t�|� t d t|d d � | d �d ��W Y d }~n d }~0 0 nTzt�||� W nB t�yB } z(t d t|d d � | d �d ��W Y d }~n d }~0 0 tj�rhtj�|��sh| |||d!�S t�tj�}|�r�tj�|��r�tj�|d" ��s�t�d#� n(tj |||dd$�}|t |d" || |�O }| |||d!�S )%Nr+ r, r� r� r� r� r� zRsrc file does not exist, use "force=yes" if you really want to create the link: %s)r4 r* r/ r r1 z-refusing to convert from %s to symlink for %sr3 z5the directory %s is not empty, refusing to convert itr� r( F)r5 r2 r1 r) r4 z)src is required for creating new symlinksTrX r/ rY �unexpected position reached�r4 r� r/ r) � .%s.%s.tmp�Error while replacing: %srd re �Error while linking: %s�r� r/ rV r] r* zgCannot set fs attributes on a non-existent symlink target. follow should be set to False to avoid this.rH ) r r: rm r6 r* rO r rN r@ r7 r� r9 r �listdirra r rp �sep�getpidrf �rmdir�symlink�renamerC r� r� r; �warnrL rM )r* r/ rR �forcer� rF �b_srcr< rT rU �relpathZ b_relpathZabsrcZb_absrcr] rV � b_old_src� b_tmppathrG rS r r r �ensure_symlink� s� �� �� �� �� "� ��" �� & r� c C s� t | dd�}t |dd�}t|�}t�tj�}t|d |d �} t|d |d �} |dkrn|d u rntdd id ��|d ur�tj� |�s�td | |d �d ��t | d|�} d } |dkr�d} �n$|dkr�t� |�} | |kr�t | dd�| d d< || d d< d} n�|dk�r@|d u�r�t� |�jt� |�jk�s�d} |�s�td| |d �d ��n�|dk�rld} |�s�td| | |d �d ��nl|dk�r�d} tj� |��r�t� |�jt� |�jk�r�| d d�S |�s�td| |d �d ��ntd| |d �d ��| �rNtj�sN|dk�r�t tjj��tj�|�t d t�� t�� f �g�}zz|dk�r�tj� |��r�zt�|� W n6 t�y� } z |jtjk�rl� W Y d }~n d }~0 0 t�||� t�||� W nZ t�y� } z@tj� |��r�t�|� td t |d d � | d �d ��W Y d }~n d }~0 0 nTzt�||� W nB t�yL } z(td!t |d d � | d �d ��W Y d }~n d }~0 0 tj�rrtj� |��sr| || | d"�S tj|| | d d#�} | t |d$ | | | �O } | || | d"�S )%Nr+ r, r� r� r� r� r5 r4 z*src is required for creating new hardlinksr zsrc does not existr� Fr) Tr( r� rX r/ rY z6Cannot link, different hard link exists at destinationr2 z%Cannot link, %s exists at destinationr1 )r* rV z6Cannot link: different hard link exists at destinationr� r� r� rd re r3 r� r� rH r* ) r r: r r� r; rm r r6 r* rO ra rN r rA �st_inorp r� r9 r� r� rf r� rC rD rE r( r� rL rM )r* r/ rR r� r� rF r� r< rS rT rU r] rV r� r� rG r r r �ensure_hardlink s� $� � � "� ��" �� r� c C s� z<t |�}zt|�j W n ty8 | �d| � Y n0 W nB ty~ zt|�j W n tyx | �d| � Y n0 Y n0 d S )NzMfailed to look up user with uid %s. Create user up to this point in real playzDfailed to look up user %s. Create user up to this point in real play)�intr �pw_name�KeyErrorr� ri r �pw_uid)r �owner�uidr r r �check_owner_existsy s r� c C s� z<t |�}zt|�j W n ty8 | �d| � Y n0 W nB ty~ zt|�j W n tyx | �d| � Y n0 Y n0 d S )NzOfailed to look up group with gid %s. Create group up to this point in real playzFfailed to look up group %s. Create group up to this point in real play)r� r �gr_namer� r� ri r �gr_gid)r �group�gidr r r �check_group_exists� s r� c C s4 t ttdg d�d�tddddgd�tdd �td d d �td d d �td dd �td d �tdd �tdd �tdd d �tdd �tdd d �d� ddd�att_ttj� tj} | d }| d }| d }| d }| d }| d }tj�r |dk�r t� tj�}|d �rt t|d � |d �r t t|d � i }t | d |�|d< | d |d< t | d |�|d< | d |d< | d d u�r�t t|d d ��} tj|d | d � |d k�r�t|||�} n||d!k�r�t||||�} nb|d"k�r�t|||||�} nF|d#k�r�t|||||�} n*|d$k�rt|||�} n|dk�r t|�} tjf i | �� d S )%N�str)r) r1 r2 r5 r( rr )�type�choicesr* Tr� �name)r� �required�aliases)r� �boolF)r� �defaultz %Y%m%d%H%M.%S) r' r* r. r0 r� rR � _diff_peekr/ r� r� r� r� )Z argument_specZadd_file_common_argsZsupports_check_moder' r0 r� rR r/ r) r� r� r� r� r� r� r� r+ r, )r* rV ry r2 r1 r( r5 rr )r �dictr r& r! � excepthookr= r; rp r� r� r� rs r| r Z exit_jsonr� r� r� r� r� r� ) r; r' r0 r� rR r* r/ rS r� ry r� r r r �main� sl �� r� �__main__)N)2Z __future__r r r r� Z __metaclass__Z DOCUMENTATIONZEXAMPLESZRETURNrD r6 r~ r! rf �pwdr r �grpr r Zansible.module_utils.basicr Zansible.module_utils._textr r r rx r r �objectr r& r= r: rP ra rm rM rs r| r� r� r� r� r� r� r� r� r� r r r r r �<module> sJ tZ .+ ; +GoZE