Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
ansible
/
modules
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: copy.cpython-310.pyc
o O�hf} � @ s� d dl mZ dZdZdZd dlZd dlZd dlZd dlZd dl Zd dl Z d dl Z d dl Z d dl Z d dlZd dlmZmZ d dlmZ G dd � d e�Zd d � Zd d � Zdd� Zdd� Zdd� Zdd� Zdd� Z e dkroe � dS dS )� )� annotationsa --- module: copy version_added: historical short_description: Copy files to remote locations description: - The M(ansible.builtin.copy) module copies a file or a directory structure from the local or remote machine to a location on the remote machine. File system meta-information (permissions, ownership, etc.) may be set, even when the file or directory already exists on the target system. Some meta-information may be copied on request. - Get meta-information with the M(ansible.builtin.stat) module. - Set meta-information with the M(ansible.builtin.file) module. - Use the M(ansible.builtin.fetch) module to copy files from remote locations to the local box. - If you need variable interpolation in copied files, use the M(ansible.builtin.template) module. Using a variable with the O(content) parameter produces unpredictable results. - For Windows targets, use the M(ansible.windows.win_copy) module instead. options: src: description: - Local path to a file to copy to the remote server. - This can be absolute or relative. - If path is a directory, it is copied recursively. In this case, if path ends with "/", only inside contents of that directory are copied to destination. Otherwise, if it does not end with "/", the directory itself with all contents is copied. This behavior is similar to the C(rsync) command line tool. type: path content: description: - When used instead of O(src), sets the contents of a file directly to the specified value. - Works only when O(dest) is a file. Creates the file if it does not exist. - For advanced formatting or if O(content) contains a variable, use the M(ansible.builtin.template) module. type: str version_added: '1.1' dest: description: - Remote absolute path where the file should be copied to. - If O(src) is a directory, this must be a directory too. - If O(dest) is a non-existent path and if either O(dest) ends with "/" or O(src) is a directory, O(dest) is created. - If O(dest) is a relative path, the starting directory is determined by the remote host. - If O(src) and O(dest) are files, the parent directory of O(dest) is not created and the task fails if it does not already exist. type: path required: yes backup: description: - Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. type: bool default: no version_added: '0.7' force: description: - Influence whether the remote file must always be replaced. - If V(true), the remote file will be replaced when contents are different than the source. - If V(false), the file will only be transferred if the destination does not exist. type: bool default: yes version_added: '1.1' mode: description: - The permissions of the destination file or directory. - For those used to C(/usr/bin/chmod) remember that modes are actually octal numbers. You must either add a leading zero so that Ansible's YAML parser knows it is an octal number (like V(0644) or V(01777)) or quote it (like V('644') or V('1777')) so Ansible receives a string and can do its own conversion from string into number. Giving Ansible a number without following one of these rules will end up with a decimal number which will have unexpected results. - As of Ansible 1.8, the mode may be specified as a symbolic mode (for example, V(u+rwx) or V(u=rw,g=r,o=r)). - As of Ansible 2.3, the mode may also be the special string V(preserve). - V(preserve) means that the file will be given the same permissions as the source file. - When doing a recursive copy, see also O(directory_mode). - If O(mode) is not specified and the destination file B(does not) exist, the default C(umask) on the system will be used when setting the mode for the newly created file. - If O(mode) is not specified and the destination file B(does) exist, the mode of the existing file will be used. - Specifying O(mode) is the best way to ensure files are created with the correct permissions. See CVE-2020-1736 for further details. directory_mode: description: - Set the access permissions of newly created directories to the given mode. Permissions on existing directories do not change. - See O(mode) for the syntax of accepted values. - The target system's defaults determine permissions when this parameter is not set. type: raw version_added: '1.5' remote_src: description: - Influence whether O(src) needs to be transferred or already is present remotely. - If V(false), it will search for O(src) on the controller node. - If V(true) it will search for O(src) on the managed (remote) node. - O(remote_src) supports recursive copying as of version 2.8. - O(remote_src) only works with O(mode=preserve) as of version 2.6. - Auto-decryption of files does not work when O(remote_src=yes). type: bool default: no version_added: '2.0' follow: description: - This flag indicates that filesystem links in the destination, if they exist, should be followed. type: bool default: no version_added: '1.8' local_follow: description: - This flag indicates that filesystem links in the source tree, if they exist, should be followed. type: bool default: yes version_added: '2.4' checksum: description: - SHA1 checksum of the file being transferred. - Used to validate that the copy of the file was successful. - If this is not provided, ansible will use the local calculated checksum of the src file. type: str version_added: '2.5' extends_documentation_fragment: - decrypt - files - validate - action_common_attributes - action_common_attributes.files - action_common_attributes.flow notes: - The M(ansible.builtin.copy) module recursively copy facility does not scale to lots (>hundreds) of files. seealso: - module: ansible.builtin.assemble - module: ansible.builtin.fetch - module: ansible.builtin.file - module: ansible.builtin.template - module: ansible.posix.synchronize - module: ansible.windows.win_copy author: - Ansible Core Team - Michael DeHaan attributes: action: support: full async: support: none bypass_host_loop: support: none check_mode: support: full diff_mode: support: full platform: platforms: posix safe_file_operations: support: full vault: support: full version_added: '2.2' a� - name: Copy file with owner and permissions ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: '0644' - name: Copy file with owner and permission, using symbolic representation ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: u=rw,g=r,o=r - name: Another symbolic mode example, adding some permissions and removing others ansible.builtin.copy: src: /srv/myfiles/foo.conf dest: /etc/foo.conf owner: foo group: foo mode: u+rw,g-wx,o-rwx - name: Copy a new "ntp.conf" file into place, backing up the original if it differs from the copied version ansible.builtin.copy: src: /mine/ntp.conf dest: /etc/ntp.conf owner: root group: root mode: '0644' backup: yes - name: Copy a new "sudoers" file into place, after passing validation with visudo ansible.builtin.copy: src: /mine/sudoers dest: /etc/sudoers validate: /usr/sbin/visudo -csf %s - name: Copy a "sudoers" file on the remote machine for editing ansible.builtin.copy: src: /etc/sudoers dest: /etc/sudoers.edit remote_src: yes validate: /usr/sbin/visudo -csf %s - name: Copy using inline content ansible.builtin.copy: content: '# This file was moved to /etc/other.conf' dest: /etc/mine.conf - name: If follow=yes, /path/to/file will be overwritten by contents of foo.conf ansible.builtin.copy: src: /etc/foo.conf dest: /path/to/link # link to /path/to/file follow: yes - name: If follow=no, /path/to/link will become a file and be overwritten by contents of foo.conf ansible.builtin.copy: src: /etc/foo.conf dest: /path/to/link # link to /path/to/file follow: no a; dest: description: Destination file/path. returned: success type: str sample: /path/to/file.txt src: description: Source file used for the copy on the target machine. returned: changed type: str sample: /home/httpd/.ansible/tmp/ansible-tmp-1423796390.97-147729857856000/source md5sum: description: MD5 checksum of the file after running copy. returned: when supported type: str sample: 2a5aeecc61dc98c4d780b14b330e3282 checksum: description: SHA1 checksum of the file after running copy. returned: success type: str sample: 6e642bb8dd5c2e027bf21dd923337cbb4214f827 backup_file: description: Name of backup file created. returned: changed and if backup=yes type: str sample: /path/to/file.txt.2015-02-12@22:09~ gid: description: Group id of the file, after execution. returned: success type: int sample: 100 group: description: Group of the file, after execution. returned: success type: str sample: httpd owner: description: Owner of the file, after execution. returned: success type: str sample: httpd uid: description: Owner id of the file, after execution. returned: success type: int sample: 100 mode: description: Permissions of the target, after execution. returned: success type: str sample: '0644' size: description: Size of the target, after execution. returned: success type: int sample: 1220 state: description: State of the target, after execution. returned: success type: str sample: file N)�to_bytes� to_native)� AnsibleModulec @ s e Zd Zdd� ZdS )�AnsibleModuleErrorc C s || _ d S )N��results)�selfr � r �?/usr/local/lib/python3.10/dist-packages/ansible/modules/copy.py�__init__0 s zAnsibleModuleError.__init__N)�__name__� __module__� __qualname__r r r r r r / s r c C sz t j�| �\}}t|dd�}|dkrd|gfS t j�|�s/|dkr(tddid��t|�\}}n||gfS |�|� ||fS ) zi Return the first pre-existing directory and a list of the new directories that will be created. �surrogate_or_strict��errors� �.�/�msgz0The '/' directory doesn't exist on this machine.r )�os�path�splitr �existsr �split_pre_existing_dir�append)�dirname�head�tail�b_head�pre_existing_dir�new_directory_listr r r r 4 s r c C s@ |r t j�| |�d��}||d< |�||�}t|||||�}|S )z] Walk the new directories list and make sure that permissions are as we would expect r r )r r �join�pop� set_fs_attributes_if_different�&adjust_recursive_directory_permissions)r! r" �module�directory_args�changed� working_dirr r r r& F s r& c s� d}|j d }|j d }|d ur�|js^t�| �D ]D\� }}|�� |d�}|du r*|}� fdd�|D �D ]}|�||d�}|du rB|}q3� fdd�|D �D ]} |�| |d�}|du r[|}qLqnSt�|�j} t�| �D ]G\� }}t�� �j | k}|du r||}� fdd�|D �D ]}t�|�j | k}|du r�|}q�� fd d�|D �D ]} t�| �j | k}|du r�|}q�qi|d u�r`|j�st�| �D ]E\� }}|� � |d�} | du r�| }� fd d�|D �D ]}|� ||d�} | du r�| }qڇ fd d�|D �D ]} |� | |d�} | du �r| }q�q�|S t � |�j } t�| �D ]M\� }}t�� �j| k} | du �r&| }� fd d�|D �D ]}t�|�j| k} | du �r@| }�q/� fd d�|D �D ]} t�| �j| k} | du �r\| }�qK�q|S )NF�owner�groupTc � g | ] }t j�� |��qS r �r r r# ��.0�d��dirpathr r � <listcomp>^ � z#chown_recursive.<locals>.<listcomp>c r- r r. �r0 �fr2 r r r4 b r5 c r- r r. r/ r2 r r r4 l r5 c r- r r. r6 r2 r r r4 p r5 c r- r r. r/ r2 r r r4 z r5 c r- r r. r6 r2 r r r4 ~ r5 c r- r r. r/ r2 r r r4 � r5 c r- r r. r6 r2 r r r4 � r5 )�params� check_moder �walk�set_owner_if_different�pwd�getpwnam�pw_uid�stat�st_uid�set_group_if_different�grp�getgrnam�gr_gid�st_gid) r r' r) r+ r, �dirnames� filenames� owner_changed�dir�file�uid� group_changed�gidr r2 r �chown_recursiveS s� ���� ��� � �� � � ��rN c C s� d}|j d }|j d }|j d }t�| |�j}t|�r d}|jsz|D ]V}tj�| |�} tj�||�} t | dd�} t | dd�} tj� | �rU|du rUt� | �} t� | | � n t �| | � t �| | � |durl|�| |d� |durw|�| |d� d}q#|S ) zKCopy files that are different between `src` directory and `dest` directory.Fr+ r, � local_followTr r N)r8 �filecmp�dircmp� diff_files�lenr9 r r r# r �islink�readlink�symlink�shutil�copyfile�copymoder; rA )�src�destr' r) r+ r, rO rR �item� src_item_path�dest_item_path�b_src_item_path�b_dest_item_path�linktor r r �copy_diff_files� s0 rb c C s d}|j d }|j d }|j d }t�| |�j}t|�r d}|j�s |D ]�}tj�| |�} tj�||�} t | dd�} t | dd�} tj� | �r^tj� | �r^|du r^t j | | | d� t| |� tj� | �rytj� | �ry|du ryt�| �} t�| | � tj� | �r�tj�| �r�|du r�t �| | � |d ur�|�| |d� |d ur�|�| |d� tj� | �r�tj�| �r�|du r�t�| �} t�| | � tj� | �s�tj�| �r�t �| | � t �| | � |d ur�|�| |d� |d ur�|�| |d� tj� | ��s tj� | ��r t j | | | d� t| |� d}q$|S ) zFCopy files that exist in `src` directory only to the `dest` directory.Fr+ r, rO Tr r ��symlinksN)r8 rP rQ � left_onlyrS r9 r r r# r rT �isdirrW �copytreerN rU rV �isfilerX r; rA rY )rZ r[ r' r) r+ r, rO re r\ r] r^ r_ r` ra r r r �copy_left_only� sP ri c C s� d}t �| |�j}|D ]@}tj�| |�}tj�||�}t|dd�}t|dd�} t|| |�} t|| |�} | s7| r9d}t tj�| |�tj�||�|�pJ|}q |S )NFr r T) rP rQ � common_dirsr r r# r rb ri �copy_common_dirs) rZ r[ r' r) rj r\ r] r^ r_ r` �diff_files_changed�left_only_changedr r r rk � s &rk c ) C s� t ttdd�tdd�tddd�tddd�tddd �tddd �tdd�td d�tdd�tdd�tdd�tddd �d � ddd �} | jd }t|dd�}| jd }tjj|vr\d�tjj|�}t|dd�}| jd }| jd }| j�dd �}| j�dd �}| jd } | jd } | jd } | jd } | jd } | jd }| jd }tj� |�s�| j d | d � t� |tj �s�| j d | d � | jd d kr�d!t �t� |�j� | jd< | jd } d}d }d }d }tj�|��rz| �|�}W n ttf�y } z| �d"t|� � W Y d }~nd }~ww z| �|�}W n t�y Y nw |�r.tj�|��s.| � d#t|� � |�r>||k�r>| j d$||d%� |�tj��r�|�rOtj�||�}t|dd�}tj�|�}t|dd�}tj� |��s�zt |�\}}W n( t �y� } z|j d& d'�|�7 < | j dCi |j �� W Y d }~nd }~ww | j �r�| j!d(| d|d)� t�"|� d}| �#| j�}| jd* }|d u�r�||d< nd |d< t$||| ||� tj�|��r�tj�%|�}|�r�|}tj�||�}t|dd�}tj� |��r,tj�&|��r | �r tj�'|�}t|dd�}|�s| j!d+||dd,� t� |tj ��r+tj�|��r+| �|�}nKtj� tj�|���swz t� tj�|�� W n( t�yj } zd-t|��(� v �r`| j d.tj�|� d � W Y d }~nd }~ww | j d/tj�|� d � t� tj�|�tj)��s�| jd0 �s�| j d1tj�|� d � d } ||k�s�tj�&|��r�| j �s�z�|�r�tj� |��r�| �*|�} tj�&|��r�t�+|� t,|d2��-� |�r| d u�r�| �.|| d� | d u�r�| �/|| d� | d u�r�| �0|| d� d3|v�r�| j d4| d � | �1|| �\} } } | d5k�r| j d6| | | d7� |} |�rhtj�|��rht2j3tj�|�d8�\}!} t4�5|| � zt4�6|| � W n+ t�yg } z | j7t7j8k�r\| d k�r\| �d9�t|��� n� W Y d } ~ nd } ~ ww | j9| || jd0 | d:� W n ttf�y� | j d;||f t:�;� d<� Y nw d}|d u �r2|d u �r2|�r2tj�| jd ��r2t| jd dd�}t| jd dd�}|�tjj��r�tj�| jd ��r�t<||| �}"t=||| �}#t>||| �}$t?|| �}%|"�s�|#�s�|$�s�|%�r�d}|�tjj��r;tj� | jd ��s;ttj�%|�dd�}&ttj�||&�dd�}ttj�| jd d=�dd�}| j �s4t4j@||| d>� t?|| � d}|�tjj��s�tj�| jd ��r�ttj�%|�dd�}&ttj�||&�dd�}ttj�| jd d=�dd�}| j �s�tj� |��s�t4j@||| d>� d}t?|| � | j �r�tj� |��s�d}tj� |��r�t<||| �}"t=||| �}#t>||| �}$t?|| �}%|"�s�|#�s�|$�s�|%�r�d}|�tjj��s2tj� | jd ��s2ttj�%| jd �dd�}&ttj�||&�dd�}| j �s%tj� |��s%t�"|� d}ttj�| jd d=�dd�}t<||| �}"t=||| �}#t>||| �}$t?|| �}%| j �r2tj� |��s2d}t|||||d?�}'| �rB| |'d@< | j#| j|dA�}(| �A|(|'dB �|'dB< | j!dCi |'�� d S )DNr )�type�strT)rn �no_log)rn �required�boolF)rn �default�raw) rZ �_original_basename�contentr[ �backup�force�validate�directory_mode� remote_srcrO �checksum�follow)� argument_spec�add_file_common_args�supports_check_moderZ r r r[ z.{0}{1}rw rx ru ry r} rO �moder+ r, r{ r| zSource %s not found)r zSource %s not readable�preservez0%03oz5Unable to calculate src checksum, assuming change: %sz+Cannot copy invalid source '%s': not a filezBCopied file does not match the expected checksum. Transfer failed.)r r| �expected_checksumr z Could not copy to {0}z"dest directory %s would be created)r r) rZ rz zfile already exists)r rZ r[ r) zpermission deniedz*Destination directory %s is not accessiblez'Destination directory %s does not exist� unsafe_writeszDestination %s not writable�wz%sz validate must contain %%s: %sr zfailed to validate)r � exit_status�stdout�stderr)rI zUnable to copy stats {0})r� �keep_dest_attrszfailed to copy: %s to %s)r � tracebackr rc )r[ rZ �md5sumr| r) � backup_file)r r) r )Br �dictr8 r r r �sep�format�getr � fail_json�access�R_OKr? �S_IMODE�st_moderh �sha1�OSError�IOError�warnr �md5� ValueErrorrf �endswithr# r r r �resultr r9 � exit_json�makedirs�load_file_common_argumentsr& �basenamerT �realpath�lower�W_OK� backup_local�unlink�open�close�set_mode_if_differentr; rA � run_command�tempfile�mkstemprW rX �copystat�errno�ENOSYS� atomic_mover� � format_excrb ri rk rN rg r% ))r' rZ �b_srcr[ �b_destrw rx ru ry r} rO r� r+ r, r{ r| r) � checksum_dest� checksum_src� md5sum_src�er � b_dirnamer! r" r( rz r� r� �rc�out�err�b_mysrc�dummyrl rm �common_dirs_changed�owner_group_changed� b_basename�res_args� file_argsr r r �main� s� �� ���� �� ���$ ��� �$ $ $ $ �r� �__main__) � __future__r � DOCUMENTATION�EXAMPLES�RETURNr� rP rB r �os.pathr< rW r? r� r� �+ansible.module_utils.common.text.convertersr r �ansible.module_utils.basicr � Exceptionr r r& rN rb ri rk r� r r r r r �<module> s: A? A 5 { �
Save
Cancel