File: //usr/lib64/python3.9/site-packages/borg/helpers/__pycache__/fs.cpython-39.opt-1.pyc
a
HZ�h:= � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZddlm Z ddl
m Z ddl m
Z
ddlT ddlmZ e� ZejejB ejB d fd
d �Zd d
� Zdd� ZdBdd�Zdd� Zdd� Zdd� Zdd� Ze� d�Z dd � Z d d � Z d d � Z dd!�d"d#�Z!d$d%� Z"d&d'� Z#d(d)� Z$d*d+� Z%e%d,d-d.�Z&e&e%d/�B Z'e&Z(e&e%d0d/�B Z)e)e%d1�B Z*e%d2d.d/�Z+dddd3d4�d5d6�Z,dddd3d7�d8d9�Z-d:d;� Z.d dlZ/d dlZ0d dl Z1d d<l2m3Z3m4Z4m5Z5m6Z6m7Z7 dCd>d?�Z8dDd@dA�Z9dS )E� N� )�Error)�prepare_subprocess_env� )�is_win32)�*)�
create_loggerTc
C sR zt j| |dd� W n8 tyL } z |r6tt|���n� W Y d}~n
d}~0 0 dS )a
Ensures that the dir exists with the right permissions.
1) Make sure the directory exists in a race-free operation
2) If mode is not None and the directory has been created, give the right
permissions to the leaf directory. The current umask value is masked out first.
3) If pretty_deadly is True, catch exceptions, reraise them with a pretty
message.
Returns if the directory has been created and has the right permissions,
An exception otherwise. If a deadly exception happened it is reraised.
T)�mode�exist_okN)�os�makedirs�OSErrorr �str)�pathr Z
pretty_deadly�e� r �5/usr/lib64/python3.9/site-packages/borg/helpers/fs.py�
ensure_dir s r c C s: t j�d�pt j�d�} | s6t j�dt j�dd� �} | S )z�Get home directory / base directory for borg:
- BORG_BASE_DIR, if set
- HOME, if set
- ~$USER, if USER is set
- ~
�
BORG_BASE_DIR�HOMEz~%sZUSER� )r �environ�getr �
expanduser)�base_dirr r r � get_base_dir) s r c C s0 t j�d�} | du r$t j�t� d�} t| � | S )�,Determine where to repository keys and cacheZ
BORG_KEYS_DIRN�keys�r r r r �join�get_config_dirr )Zkeys_dirr r r � get_keys_dir; s
r! c C sB t j�d�}|du r$t j�t� d�}| r6t j�|| �}t|� |S )z4Determine where to store local security information.ZBORG_SECURITY_DIRNZsecurityr )Z
repository_idZ security_dirr r r �get_security_dirE s r" c C s� t j�t� d�} t j�d�s*t j�d| �} t j�dt j�| d��}t|� t j�|t�}t j�|�s�t t
� d�� d� }dd l
m} ||d
d ��}|�|� W d � n1 s�0 Y |S )
r z.cacher ZXDG_CACHE_HOMEZBORG_CACHE_DIR�borgz�
# This file is a cache directory tag created by Borg.
# For information about cache directory tags, see:
# http://www.bford.info/cachedir/spec.html
�asciir )�SaveFileT)ZbinaryN)r r r r r r r �CACHE_TAG_NAME�exists�CACHE_TAG_CONTENTS�textwrap�dedent�encode�platformr% �write)Z
cache_homeZ cache_dirZ cache_tag_fnZcache_tag_contentsr% �fdr r r �
get_cache_dirQ s � (r/ c C sN t j�t� d�} t j�d�s*t j�d| �} t j�dt j�| d��}t|� |S )z%Determine where to store whole configz.configr ZXDG_CONFIG_HOMEZBORG_CONFIG_DIRr# )r r r r r r r )Z config_homeZ
config_dirr r r r i s r c C s� t j�| t�}zbt j�|�rnt|d��8}|�tt��}|tkrPW d � W dS W d � n1 sd0 Y W n t y� Y n0 dS )z�Determines whether the specified path is a cache directory (and
therefore should potentially be excluded from the backup) according to
the CACHEDIR.TAG protocol
(http://www.bford.info/cachedir/spec.html).
�rbNTF)
r r r r& r' �open�read�lenr( r
)r �tag_pathZtag_fileZtag_datar r r �dir_is_cachedirw s 4 r5 c C sT g }|rt | �r|�t� |durP|D ](}tj�| |�}tj�|�r&|�|� q&|S )a Determines whether the specified path is excluded by being a cache
directory or containing user-specified tag files/directories. Returns a
list of the names of the tag files/directories (either CACHEDIR.TAG or the
matching user-specified files/directories).
N)r5 �appendr& r r r r' )r Zexclude_cachesZexclude_if_presentZ tag_names�tagr4 r r r �
dir_is_tagged� s
r8 z
^((\.\.)?/+)+c C s t �d| �pdS )z3Make path safe by making it relative and local
r �.)�_safe_re�sub)r r r r �make_path_safe� s r< c C s( t �| �p&t �| �p&t �| �p&t �| �S )z7return True if we support hardlinked items of this type)�stat�S_ISREG�S_ISBLK�S_ISCHR�S_ISFIFO)r r r r � hardlinkable� s rB c
C sR zd| � � fW S tyL } z&t�d| j|� d| jfW Y d }~S d }~0 0 d S )Nr z&scandir_inorder: Unable to stat %s: %sr )�inoder
�logger�debugr �name)Zdirentr r r r �scandir_keyfunc� s
rG )r. c C s" |d ur |n| }t t�|�td�S )N)�key)�sortedr �scandirrG )r r. �argr r r �scandir_inorder� s rL c C s| t | d��T}t�|�� �}|jdkr(|sP|�t�|j�� |�� t� |�� � W d � n1 sd0 Y t�
| � dS )a� Attempt to securely erase a file by writing random data over it before deleting it.
If avoid_collateral_damage is True, we only secure erase if the total link count is 1,
otherwise we just do a normal "delete" (unlink) without first overwriting it with random.
This avoids other hardlinks pointing to same inode as <path> getting damaged, but might be less secure.
A typical scenario where this is useful are quick "hardlink copies" of bigger directories.
If avoid_collateral_damage is False, we always secure erase.
If there are hardlinks pointing to the same inode as <path>, they will contain random garbage afterwards.
�r+br N) r1 r r= �fileno�st_nlinkr- �urandom�st_size�flush�fsync�unlink)r Zavoid_collateral_damager. �str r r � secure_erase� s ,rV c C s� zt �| � W n� ty� } z�|jtjkr,� t �| �}|jdkrB� z6t| d��}|�� W d � n1 sl0 Y W n ty� |�Y n 0 t �| � W Y d}~n
d}~0 0 dS )a�
Safely unlink (delete) *path*.
If we run out of space while deleting the file, we try truncating it first.
BUT we truncate only if path is the only hardlink referring to this content.
Use this when deleting potentially large files when recovering
from a VFS error such as ENOSPC. It can help a full file system
recover. Refer to the "File system interaction" section
in repository.py for further explanations.
r rM N) r rT r
�errno�ENOSPCr= rO r1 �truncate)r Z
unlink_errrU r. r r r � safe_unlink� s
*
rZ c C s< | dkr.d|v rt jnt j}d|v r*|jS |S t| |�S d S )N�-�r�b)�sys�stdin�stdout�bufferr1 )r r �streamr r r � dash_open� s rc c G s& d}| D ]}|t td| d�O }q|S )Nr �O_)�getattrr )�flags�result�flagr r r rd � s rd ZBINARYZNOCTTYZRDONLYZNOFOLLOWZNONBLOCK�NOATIMEZ DIRECTORYF)r � parent_fdrF �noatimec
C s� |r|dur|}n
|d }}t r0tj�|�r0dS | }|r�|td�B }ztj|||d�}W q� ty� ||krp� tj|||d�}Y q� ty� } zHddlm }
d|
v r�| j
t
j kr�||kr�tj|||d�}n� W Y d} ~ q�d} ~ 0 0 ntj|||d�}|S )a�
Use os.open to open a fs item.
If parent_fd and name are given, they are preferred and openat will be used,
path is not used in this case.
:param path: full (but not necessarily absolute) path
:param parent_fd: open directory file descriptor
:param name: name relative to parent_fd
:param flags: open flags for os.open() (int)
:param noatime: True if access time shall be preserved
:return: file descriptor
Nri )�dir_fdr )� workaroundsZ retry_erofs) r r r �isdirrd r1 �PermissionErrorr
r rm rW ZEROFS) rf r rj rF rk �fnameZ
_flags_normalZ_flags_noatimer. �excrm r r r �os_open s*
rr )r rj rF �follow_symlinksc C s, |r|dur|}n
| d }}t j|||d�S )aP
Use os.stat to open a fs item.
If parent_fd and name are given, they are preferred and statat will be used,
path is not used in this case.
:param path: full (but not necessarily absolute) path
:param parent_fd: open directory file descriptor
:param name: name relative to parent_fd
:return: stat info
N)rl rs )r r= )r rj rF rs rp r r r �os_stat: s
rt c C sJ t dd�}ztjdd| g|d�W S tyD tjd| g|d� Y S 0 d S )NT)�systemZ
fusermountz-u)�env�umount)r �
subprocess�call�FileNotFoundError)Z
mountpointrv r r r rw N s
rw )�_sanitize_params�_get_candidate_names�TMP_MAX�_text_openflags�_bin_openflags� c C s� t j�| �} t� }|tu r&tt j|�}tt�D ]�}t |�}t j�
| || | �} t � d| � zt �
| ||�}
W nR ty� Y q.Y n> ty� t jdkr�t j�| �r�t �| t j�r�Y q.n� Y n0 |
| f S ttjd��dS )z>Code common to mkstemp, TemporaryFile, and NamedTemporaryFile.ztempfile.mkstemp�ntz#No usable temporary file name foundN)�_osr �abspathr| �bytes�map�fsencode�ranger} �nextr �_sys�auditr1 �FileExistsErrorro rF rn �access�W_OK�_errnoZEEXIST) �dirZpreZsufrf � output_typer �names�seqrF �filer. r r r �_mkstemp_inner_ s$ $ r� c C s4 t || |�\}} }}|r t}nt}t||| |||�S )a� User-callable function to create and return a unique temporary
file. The return value is a pair (fd, name) where fd is the
file descriptor returned by os.open, and name is the filename.
If 'suffix' is not None, the file name will end with that suffix,
otherwise there will be no suffix.
If 'prefix' is not None, the file name will begin with that prefix,
otherwise a default prefix is used.
If 'dir' is not None, the file will be created in that directory,
otherwise a default directory is used.
If 'text' is specified and true, the file is opened in text
mode. Else (the default) the file is opened in binary mode.
If any of 'suffix', 'prefix' and 'dir' are not None, they must be the
same type. If they are bytes, the returned name will be bytes; str
otherwise.
The file is readable and writable only by the creating user ID.
If the operating system uses permission bits to indicate whether a
file is executable, the file is executable by no one. The file
descriptor is not inherited by children of this process.
Caller is responsible for deleting the file when done with it.
)r{ r~ r r� )�suffix�prefixr� �textr r� rf r r r � mkstemp_mode{ s
r� )N)r� )NNNFr� ):rW r Zos.path�rer= rx r^ r) �errorsr Zprocessr Z
platformflagsr Z constantsrD r �S_IRWXU�S_IRWXG�S_IRWXOr r r! r" r/ r r5 r8 �compiler: r< rB rG rL rV rZ rc rd Z
flags_baseZ
flags_specialZflags_special_followZ flags_normalZ
flags_noatimeZ flags_dirrr rt rw r� r� r� Ztempfiler{ r| r} r~ r r� r� r r r r �<module> sZ
$ .