File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/snapper.cpython-310.pyc
Back
o ;j4l � @ sn d Z ddlZddlZddlZddlZddlZddlZddlm Z z ddl m Z dZ W n e y5 dZ Y nw zddlZdZW n e yI dZY nw ddd d d d d ddd� ZdZdZdZe�e�ZdZdZdZdZer�ze�� ZW n ej y� Z ze ZW Y dZ [ n2dZ [ ww ee� � v r�z ej e� ee�ed�ZW n ej e!fy� Z ze ZW Y dZ [ ndZ [ ww dZdd� Z"dd� Z#dd� Z$dMd d �Z%dNd d �Z&d d!� Z'd"d#� Z(dMd$d%�Z)dMd&d'�Z*d(d)� Z+dMd*d+�Z, dOd,d-�Z- . / dPd0d1�Z.dQd2d3�Z/ dRd4d5�Z0d6d7� Z1d8d9� Z2d:d;� Z3dSd<d=�Z4dSd>d?�Z5dTd@dA�Z6dMdBdC�Z7dMdDdE�Z8dTdFdG�Z9dMdHdI�Z:dUdKdL�Z;dS )Vuj Module to manage filesystem snapshots with snapper .. versionadded:: 2016.11.0 :codeauthor: Duncan Mac-Vicar P. <dmacvicar@suse.de> :codeauthor: Pablo Suárez Hernández <psuarezhernandez@suse.de> :depends: ``dbus`` Python module. :depends: ``snapper`` http://snapper.io, available in most distros :maturity: new :platform: Linux � N��CommandExecutionError)�getpwuidTF�created�deletedz type changedZmodifiedzpermission changedz owner changedz group changedzextended attributes changedzACL info changed) � � � � � � �@ � � zorg.opensuse.Snapperz/org/opensuse/Snapper)Zdbus_interfacezsnapper is missingc C sP d} t s d| �d�fS tsd| �t�fS ts d| �t�fS ts&d| �d�fS dS )Nz(The snapper module cannot be loaded: {0}Fzmissing python dbus modulezpwd module not available�snapper)�HAS_DBUS�formatr � snapper_error�bus�system_bus_error�HAS_PWD)Z error_msg� r �H/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/snapper.py� __virtual__S s r c C s� i }| d |d< g d�| d |d< |d dkr | d |d< | d d kr+| d |d < nt t�� �|d < t| d �d |d < | d |d< | d |d< i |d< | d �� D ] \}}||d |< qS|S )a� Returns snapshot data from a D-Bus response. A snapshot D-Bus response is a dbus.Struct containing the information related to a snapshot: [id, type, pre_snapshot, timestamp, user, description, cleanup_algorithm, userdata] id: dbus.UInt32 type: dbus.UInt16 pre_snapshot: dbus.UInt32 timestamp: dbus.Int64 user: dbus.UInt32 description: dbus.String cleaup_algorithm: dbus.String userdata: dbus.Dictionary r �id)�single�pre�postr �typer r r � ���� timestampr �user� � description� �cleanup�userdata� )�int�timer �items)�snapshot�data�key�valuer r r �_snapshot_to_dataa s r0 c C s2 | � � }|dkrd�|d �S |dkrdS | � � S )z> Returns a error message from a snapper DBusException zerror.unknown_configzUnknown configuration '{}'�configzerror.illegal_snapshotzInvalid snapshot)Z get_dbus_namer )�exc�args�errorr r r �_dbus_exception_to_reason� s r5 �rootc C sL z t �| �}dd� |D �W S tjy% } z td�t|t� ����d}~ww )z� List available snapshots CLI Example: .. code-block:: bash salt '*' snapper.list_snapshots config=myconfig c S � g | ]}t |��qS r )r0 )�.0�sr r r � <listcomp>� � z"list_snapshots.<locals>.<listcomp>z-Error encountered while listing snapshots: {}N)r Z ListSnapshots�dbus� DBusExceptionr r r5 �locals)r1 Z snapshotsr2 r r r �list_snapshots� s ����r? c C sL z t �|t| ��}t|�W S tjy% } z td�t|t � ����d}~ww )z� Get detailed information about a given snapshot CLI Example: .. code-block:: bash salt '*' snapper.get_snapshot 1 z/Error encountered while retrieving snapshot: {}N) r Z GetSnapshotr) r0 r< r= r r r5 r> )�numberr1 r, r2 r r r � get_snapshot� s ����rA c C sJ z t �� } dd� | D �W S tjy$ } z td�t|t� ����d}~ww )zw List all available configs CLI Example: .. code-block:: bash salt '*' snapper.list_configs c S s i | ] }|d |d �qS )r r r )r8 r1 r r r � <dictcomp>� s z list_configs.<locals>.<dictcomp>z2Error encountered while listing configurations: {}N)r Z ListConfigsr< r= r r r5 r> )Zconfigsr2 r r r � list_configs� s ����rC c C s t | t�r | r dS dS | S )NZyes�no)� isinstance�bool)r/ r r r �_config_filter� s rG c K sX zdd� |� � D �}t�| |� W dS tjy+ } z td�| t|t� ����d}~ww )aN Set configuration values CLI Example: .. code-block:: bash salt '*' snapper.set_config SYNC_ACL=True Keys are case insensitive as they will be always uppercased to snapper convention. The above example is equivalent to: .. code-block:: bash salt '*' snapper.set_config sync_acl=True c S s( i | ]\}}|� d �s|�� t|��qS ��__)� startswith�upperrG �r8 �k�vr r r rB � s � �z set_config.<locals>.<dictcomp>z4Error encountered while setting configuration {}: {}NT) r+ r Z SetConfigr< r= r r r5 r> )�name�kwargsr- r2 r r r � set_config� s �� ����rQ c C s t t| �dd� d�}|d S )z4 Returns the last existing created snapshot c S s | d S )Nr r )�xr r r �<lambda> s z$_get_last_snapshot.<locals>.<lambda>)r. r )�sortedr? )r1 Z snapshot_listr r r �_get_last_snapshot� s rU c C sH | d@ | d@ | d@ | d@ | d@ | d@ | d@ | d@ | d @ f }d d � |D �S ) z� Converts a numeric dbus snapper status into a string CLI Example: .. code-block:: bash salt '*' snapper.status_to_string <dbus_status> r r r r r r r r r c S s g | ]}|rt | �qS r )�DBUS_STATUS_MAP)r8 �statusr r r r: s z$status_to_string.<locals>.<listcomp>r )Z dbus_statusZ status_tupler r r �status_to_string s � rX c C sB zt �| �}|W S tjy } z td�t|t� ����d}~ww )z� Retrieves all values from a given configuration CLI Example: .. code-block:: bash salt '*' snapper.get_config z4Error encountered while retrieving configuration: {}N)r Z GetConfigr< r= r r r5 r> )rO r1 r2 r r r � get_config s ����rY c C s� dd� }| s |d� |s|d� |s|d� |sd}zt �| |||� |r-t| fi |�� t| �W S tjyI } z td�t|t � ����d}~ww ) a Creates a new Snapper configuration name Name of the new Snapper configuration. subvolume Path to the related subvolume. fstype Filesystem type of the subvolume. template Configuration template to use. (Default: default) extra_opts Extra Snapper configuration opts dictionary. It will override the values provided by the given template (if any). CLI Example: .. code-block:: bash salt '*' snapper.create_config name=myconfig subvolume=/foo/bar/ fstype=btrfs salt '*' snapper.create_config name=myconfig subvolume=/foo/bar/ fstype=btrfs template="default" salt '*' snapper.create_config name=myconfig subvolume=/foo/bar/ fstype=btrfs extra_opts='{"NUMBER_CLEANUP": False}' c S s t d| � d���)NzYou must provide a "z" for the new configurationr )�argnamer r r �raise_arg_errorO s �z&create_config.<locals>.raise_arg_errorrO � subvolume�fstype� z:Error encountered while creating the new configuration: {}N) r Z CreateConfigrQ rY r< r= r r r5 r> )rO r\ r] �templateZ extra_optsr[ r2 r r r � create_config4 s, ����r` r r@ c K s� |si }|� d�}|du r|durd|� �}|dur ||d< d}z>|dkr0t�| |||�}W |S |dkr?t�| |||�}W |S |dkrW|du rKtd��t�| ||||�}W |S td |� d ��� tjyv } z td �t | t � ����d} ~ ww ) a� Creates an snapshot config Configuration name. snapshot_type Specifies the type of the new snapshot. Possible values are single, pre and post. pre_number For post snapshots the number of the pre snapshot must be provided. description Description for the snapshot. If not given, the salt job will be used. cleanup_algorithm Set the cleanup algorithm for the snapshot. number Deletes old snapshots when a certain number of snapshots is reached. timeline Deletes old snapshots but keeps a number of hourly, daily, weekly, monthly and yearly snapshots. empty-pre-post Deletes pre/post snapshot pairs with empty diffs. userdata Set userdata for the snapshot (key-value pairs). Returns the number of the created snapshot. CLI Example: .. code-block:: bash salt '*' snapper.create_snapshot Z __pub_jidNz salt job �salt_jidr r r zVpre snapshot number 'pre_number' needs to bespecified for snapshots of the 'post' typezInvalid snapshot type '�'�1Error encountered while listing changed files: {}) �getr ZCreateSingleSnapshotZCreatePreSnapshotr ZCreatePostSnapshotr< r= r r5 r> ) r1 � snapshot_type� pre_numberr$ �cleanup_algorithmr' rP �jidZnew_nrr2 r r r �create_snapshotj sJ , ����� � � ����ri c C s� | st d��z>dd� t|�D �}t| t�s| g} t| ��t|��s7t d�d�dd� t| ��t|��D �����t � || � || dd�iW S t j yY } zt t |t� ���d }~ww ) ax Deletes an snapshot config Configuration name. (Default: root) snapshots_ids List of the snapshots IDs to be deleted. CLI Example: .. code-block:: bash salt '*' snapper.delete_snapshot 54 salt '*' snapper.delete_snapshot config=root 54 salt '*' snapper.delete_snapshot config=root snapshots_ids=[54,55,56] �'Error: No snapshot ID has been providedc S s g | ]}|d �qS )r r �r8 rR r r r r: � r; z#delete_snapshot.<locals>.<listcomp>z Error: Snapshots '{}' not foundz, c S r7 r )�strrk r r r r: � s ��r )ZidsrW N)r r? rE �list�set�issubsetr �join� differencer ZDeleteSnapshotsr< r= r5 r> )Z snapshots_idsr1 Zcurrent_snapshots_idsr2 r r r �delete_snapshot� s0 ����� ��rr c C s� | st d��t|| d�}z4|dur|n|d |dur |n|d |dur%|n|d d�}t�|| |d |d |d � t|| d�W S tjyU } zt t|t� ���d}~ww )a� Modify attributes of an existing snapshot. config Configuration name. (Default: root) snapshot_id ID of the snapshot to be modified. cleanup Change the cleanup method of the snapshot. (str) description Change the description of the snapshot. (str) userdata Change the userdata dictionary of the snapshot. (dict) CLI Example: .. code-block:: bash salt '*' snapper.modify_snapshot 54 description="my snapshot description" salt '*' snapper.modify_snapshot 54 description="my snapshot description" salt '*' snapper.modify_snapshot 54 userdata='{"foo": "bar"}' salt '*' snapper.modify_snapshot snapshot_id=54 cleanup="number" rj )r1 r@ Nr$ r& r' )r$ r& r' )r rA r Z SetSnapshotr< r= r5 r> )Z snapshot_idr$ r' r& r1 r, Z updated_optsr2 r r r �modify_snapshot� s( ����rs c C s4 |rt |�nd}|durt |�nt| �d }||fS )zP Returns numerical interval based on optionals num_pre, num_post values r Nr )r) rU )r1 �num_pre�num_postr r r r r �_get_num_interval s rv c C s& t jdd| gdt jdd�j}|�d�S )z) Checks if a file is a text file �filez-biFT)�check�stdout�textrz )� subprocess�run�PIPEry rJ )�filenameZ type_of_filer r r � _is_text_file) s �� r c O s |� dd�}|� dd| � d��}|� dd�}|� di �}d d � |�� D �}d d � |�� D �}td d|d |||d�|��}| tvrItd| � d���z t| |i |��} W n tyr } zd�t| �t| jg�} W Y d} ~ nd} ~ ww td d|d||||d�|�� | S )a Runs a function from an execution module creating pre and post snapshots and associating the salt job id with those snapshots for easy undo and cleanup. function Salt function to call. config Configuration name. (default: "root") description A description for the snapshots. (default: None) userdata Data to include in the snapshot metadata. (default: None) cleanup_algorithm Snapper cleanup algorithm. (default: "number") `*args` args for the function to call. (default: None) `**kwargs` kwargs for the function to call (default: None) This would run append text to /etc/motd using the file.append module, and will create two snapshots, pre and post with the associated metadata. The jid will be available as salt_jid in the userdata of the snapshot. You can immediately see the changes CLI Example: .. code-block:: bash salt '*' snapper.run file.append args='["/etc/motd", "some text"]' r1 r6 r$ z snapper.run[�]rg r@ r' c S s i | ] \}}|� d �s||�qS rH �rJ rL r r r rB c � zrun.<locals>.<dictcomp>c S s i | ] \}}|� d �r||�qS rH r� rL r r r rB d r� �snapper.create_snapshotr �r1 re r$ rg r' z function "z" does not exist� Nr )r1 re rf r$ rg r' r )�popr+ �__salt__r rp rl �__doc__) �functionr3 rP r1 r$ rg r' Z func_kwargsZpre_nr�retr2 r r r r| 6 sD ( �� $���� r| c C s� zTt | ||�\}}t�| t|�t|�� t�| t|�t|��}i }t� | d }|D ]'}|d �|�r=|d t|�d� n|d } dt|d �i|t j � || �< q*|W S t j yl } z td�t| t� ����d} ~ ww )a| Returns a comparison between two snapshots config Configuration name. num_pre first snapshot ID to compare. Default is last snapshot num_post last snapshot ID to compare. Default is 0 (current state) CLI Example: .. code-block:: bash salt '*' snapper.status salt '*' snapper.status num_pre=19 num_post=20 � SUBVOLUMEr NrW r rc )rv r ZCreateComparisonr) ZGetFilesrC rJ �lenrX �os�path�normpathr< r= r r r5 r> ) r1 rt ru r r �filesZ status_retr\ rw � _filepathr2 r r r rW � s( (� � ����rW c C s t | ||��� S )a� Returns the files changed between two snapshots config Configuration name. num_pre first snapshot ID to compare. Default is last snapshot num_post last snapshot ID to compare. Default is 0 (current state) CLI Example: .. code-block:: bash salt '*' snapper.changed_files salt '*' snapper.changed_files num_pre=19 num_post=20 )rW �keys)r1 rt ru r r r � changed_files� s r� c C s� t | ||�\}}t| ||�}t|�� �}t|p|�}|�|�s(td�|| ���td d�| ||d�|���} z| � d�} i } | D ] } | � d�\} }|| | < qA| W S t yd } ztd| � ���d}~ww )a, Undo all file changes that happened between num_pre and num_post, leaving the files into the state of num_pre. .. warning:: If one of the files has changes after num_post, they will be overwritten The snapshots are used to determine the file list, but the current version of the files will be overwritten by the versions in num_pre. You to undo changes between num_pre and the current version of the files use num_post=0. CLI Example: .. code-block:: bash salt '*' snapper.undo zNGiven file list contains files that are not presentin the changed filelist: {}zcmd.runz"snapper -c {} undochange {}..{} {}� �:z)Error while processing Snapper response: N) rv rW rn r� ro r r r� rp �split� ValueError)r1 r� rt ru r r Zchanges�changed� requestedZcmdret� componentsr� �compr. �valr2 r r r �undo� s6 ��� ���r� c sb � fdd�t |�D �}dd� |D �}dd� |D �}|r |s%td� � d���|d d |d d fS ) z� Returns pre/post snapshots made by a given Salt jid Looks for 'salt_jid' entries into snapshots userdata which are created when 'snapper.run' is executed. c s" g | ] }|d � d�� kr|�qS )r' ra )rd rk �rh r r r: � s z&_get_jid_snapshots.<locals>.<listcomp>c S � g | ] }|d dkr|�qS )r r r rk r r r r: � c S r� )r r r rk r r r r: r� zJid 'z' snapshots not foundr r )r? r )rh r1 Z jid_snapshots� pre_snapshot� post_snapshotr r� r �_get_jid_snapshots� s �r� c C � t | |d�\}}t|||d�S )z� Undo the changes applied by a salt job jid The job id to lookup config Configuration name. CLI Example: .. code-block:: bash salt '*' snapper.undo_jid jid=20160607130930720112 �r1 �rt ru )r� r� �rh r1 r� r� r r r �undo_jid � r� c C s� �zUt | ||�\}}t| ||�}|r||v r|gng }t� | d }|r+t�| |d�n|}|r6t�| |d�n|} t� } dd� |D �D ]�} | } | �|�rS| t|�d� } tj � |d | �� dd�} tj � | d | �� dd�}tj � | �r�d}t jj�| ��}d d� |�� D �}W d � n1 s�w Y ng }d}tj � |�r�d}t jj�|��}d d� |�� D �}W d � n1 s�w Y ng }d}t| �s�t|�r�d d �tj||| |d ��d�| | < |r�|s�d| | d< |s�|r�d| | d< qBt| ��s?t|��s?ddi| | < |�rtd d �|��| | d< |�r'td d �|��| | d< |�r3|�s3d| | d< |�r?|�s?d| | d< qB|�rJt�| |d� |�rTt�| |d� | W S tj�yo } z td�t |t � ����d}~ww )a Returns the differences between two snapshots config Configuration name. filename if not provided the showing differences between snapshots for all "text" files num_pre first snapshot ID to compare. Default is last snapshot num_post last snapshot ID to compare. Default is 0 (current state) CLI Example: .. code-block:: bash salt '*' snapper.diff salt '*' snapper.diff filename=/var/log/snapper.log num_pre=19 num_post=20 r� Fc S s g | ] }t j�|�s|�qS r )r� r� �isdir)r8 �filepathr r r r: C r� zdiff.<locals>.<listcomp>N�/z//Tc S � g | ] }t jj�|��qS r ��salt�utilsZ stringutilsZ to_unicode�r8 Z_lr r r r: R � �c S r� r r� r� r r r r: \ r� ztext file changedr^ )�fromfile�tofile)�comment�diffztext file deletedr� ztext file createdzbinary file changedzhashutil.sha256_digestZold_sha256_digestZnew_sha256_digestzbinary file createdzbinary file deletedzAError encountered while showing differences between snapshots: {}) rv r� rC r Z MountSnapshot�dictrJ r� r� r� r� �replace�isfiler� r� r� Zfopen� readlinesr rp �difflibZ unified_diffr� ZUmountSnapshotr< r= r r r5 r> )r1 r~ rt ru r r r� r\ Z pre_mountZ post_mountZ files_diffr� r� Zpre_fileZ post_fileZpre_file_existsZrfhZpre_file_contentZpost_file_existsZpost_file_contentr2 r r r r� s� � � �� � ���� � � � �� � � ����r� c C r� )z� Returns the changes applied by a `jid` jid The job id to lookup config Configuration name. CLI Example: .. code-block:: bash salt '*' snapper.diff_jid jid=20160607130930720112 r� r� )r� r� r� r r r �diff_jid� r� r� �baselinec C s t d |dddd| id�S )a Creates a snapshot marked as baseline tag Tag name for the baseline config Configuration name. CLI Example: .. code-block:: bash salt '*' snapper.create_baseline salt '*' snapper.create_baseline my_custom_baseline r� r zbaseline snapshotr@ Z baseline_tagr� )r� )�tagr1 r r r �create_baseline� s �r� )r6 )r r6 )NNNNN)r6 r NNr@ N)Nr6 )NNNNr6 )r6 NN)r6 NNN)r� r6 )<r� r� �loggingr� r{ r* Zsalt.utils.filesr� Zsalt.exceptionsr �pwdr r � ImportErrorr< r rV ZSNAPPER_DBUS_OBJECTZSNAPPER_DBUS_PATHZSNAPPER_DBUS_INTERFACE� getLogger�__name__�logr r r r Z SystemBusr= r2 Zlist_activatable_namesZ InterfaceZ get_objectr� r r0 r5 r? rA rC rG rQ rU rX rY r` ri rr rs rv r r| rW r� r� r� r� r� r� r� r r r r �<module> s� � �� �� ���* ! �7 � T, �7 M , 2 s
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings