�
��g
* � � � S r SSKrSSKrSSKrSSKrSSKrSSKJr SSKJr SSKJ r \R " 5 q Sq \R " 5 qS r " S S\5 rg) z�
Provides temporary file handling cenetered around a single top-level
securely created temporary directory.
The public interface of this module is thread-safe.
� N)�config)�log)�utilc �2 � [ R 5 [ b [ R 5 c4 [ [
R S9q[ R 5 [ l [ [ R 5 $ ! [ R 5 f = f)aQ
Obtain the global default instance of TemporaryDirectory, creating
it first if necessary. Failures are propagated to caller. Most
callers are expected to use this function rather than
instantiating TemporaryDirectory directly, unless they explicitly
desdire to have their "own" directory for some reason.
This function is thread-safe.
)�temproot)
� _defaultLock�acquire�_defaultInstance�dir�TemporaryDirectoryr r �tempfile�tempdir�release� � �3/usr/lib/python3/dist-packages/duplicity/tempdir.py�defaultr 0 sf � � ���� � � #�'7�';�';�'=�'E� 1�6�?�?� K� � /� 3� 3� 5�H� � �� � � �� � � � �s �AB � Bc �L � \ rS rSrSrS
S jrS rS rS rS r S r
S
r S r S r
g)r �H a�
A temporary directory.
An instance of this class is backed by a directory in the file
system created securely by the use of tempfile.mkdtemp(). Said
instance can be used to obtain unique filenames inside of this
directory for cases where mktemp()-like semantics is desired, or
(recommended) an fd,filename pair for mkstemp()-like semantics.
See further below for the security implications of using it.
Each instance will keep a list of all files ever created by it, to
faciliate deletion of such files and rmdir() of the directory
itself. It does this in order to be able to clean out the
directory without resorting to a recursive delete (ala rm -rf),
which would be risky. Calling code can optionally (recommended)
notify an instance of the fact that a tempfile was deleted, and
thus need not be kept track of anymore.
This class serves two primary purposes:
Firstly, it provides a convenient single top-level directory in
which all the clutter ends up, rather than cluttering up the root
of the system temp directory itself with many files.
Secondly, it provides a way to get mktemp() style semantics for
temporary file creation, with most of the risks
gone. Specifically, since the directory itself is created
securely, files in this directory can be (mostly) safely created
non-atomically without the usual mktemp() security
implications. However, in the presence of tmpwatch, tmpreaper, or
similar mechanisms that will cause files in the system tempdir to
expire, a security risk is still present because the removal of
the TemporaryDirectory managed directory removes all protection it
offers.
For this reason, use of mkstemp() is greatly preferred above use
of mktemp().
In addition, since cleanup is in the form of deletion based on a
list of filenames, completely independently of whether someone
else already deleted the file, there exists a race here as
well. The impact should however be limited to the removal of an
'attackers' file.
Nc � � S nUc, [ R ( a [ R nO[ n[ U[ 5 ( a [
R " U5 n[ R " 5 R S5 ( aI U" U5 ( a< [ R " SS/5 n[
R " U5 R 5 n[ R " SSU5 U l [ R" " [% S5 U R - 5 S U l 0 U l [* R, " 5 U l g)
z�
Create a new TemporaryDirectory backed by a unique and
securely created file system directory.
tempbase - The temp root directory, or None to use system
default (recommended).
c � � [ R R S5 [ R R S5 /n[ R R U 5 nU H nUR U5 ( d M g g)z-Determine if path point to a MAcOS system tmpz/tmpz/var/tmpTF)�os�path�realpath�
startswith)r � sys_temps� user_temp�sys_temps r �defaults_to_tmp�4TemporaryDirectory.__init__.<locals>.defaults_to_tmp� sh � � ��� � ��(���� � ��,��I�
���(�(��.�I� %�� �'�'��1�1� � &� r N�Darwin�getconf�DARWIN_USER_TEMP_DIRz-tempdirz
duplicity-z Using temporary directory %sr )r r �_initialSystemTempRoot�
isinstance�bytesr �fsdecode�platform�systemr �
subprocess� check_output�rstripr
�mkdtemp�_TemporaryDirectory__dirr �Info�_� _TemporaryDirectory__tempcount� _TemporaryDirectory__pending� threading�Lock�_TemporaryDirectory__lock)�selfr r s r �__init__�TemporaryDirectory.__init__w s� � � � � ����!�?�?�� 2�� �h�� &� &��{�{�8�,�H� �?�?� � '� '�� 1� 1�o�h�6O�6O�!�.�.� �;Q�/R�S�H��{�{�8�,�3�3�5�H� �%�%�j�,��I��
� ����1�2�T�Z�Z�?�@� ��� ��� �n�n�&�� r c � � U R $ )z3
Returns the absolute pathname of the temp folder.
)r. �r6 s r r �TemporaryDirectory.dir� s � � �z�z�r c �4 � [ b U R 5 gg)z
Perform cleanup.
N)r
�cleanupr: s r �__del__�TemporaryDirectory.__del__� s � �
� '� �L�L�N� (r c � � SnU R R 5 U R S- U l S[ U R 5 3n[ R
" [ R " USU R 5 5 n[ R " [ S5 [ R " U5 - 5 SU R U' U R R 5 U$ ! U R R 5 f = f)a
Return a unique filename suitable for use for a temporary
file. The file is not created.
Subsequent calls to this method are guaranteed to never return
the same filename again. As a result, it is safe to use under
concurrent conditions.
NOTE: mkstemp() is greatly preferred.
N� �-zmktemp-z&Registering (mktemp) temporary file %s)r5 r r1 �intr �fsencoder
�mktempr. r �Debugr0 r' r2 r )r6 �filename�suffixs r rE �TemporaryDirectory.mktemp� s� � � �� � � ��� � "� #� /� /�!� 3�D� ���T� -� -�.�/�0�F��{�{�8�?�?�6�9�d�j�j�#Q�R�H� �I�I�a�@�A�B�K�K�PX�DY�Y� Z�'+�D�N�N�8� $� �K�K� � � !����
�K�K� � � !�s �B'C! �! C=c � � SnSnU R R 5 U R S- U l S[ U R 5 3n[ R
" USU R 5 u p[ R " [ S5 U- 5 SU R U' U R R 5 X4$ ! U R R 5 f = f)z�
Returns a filedescriptor and a filename, as per os.mkstemp(),
but located in the temporary directory and subject to tracking
and automatic cleanup.
NrA rB zmkstemp-z'Registering (mkstemp) temporary file %s) r5 r r1 rC r
�mkstempr. r rF r0 r2 r )r6 �fdrG rH s r rK �TemporaryDirectory.mkstemp� s� � � ���� � � ��� � "� #� /� /�!� 3�D� ���T� -� -�.�/�0�F�#�+�+����
�
� �L�B�
�I�I�a�A�B�X�M� N�'+�D�N�N�8� $� �K�K� � � !��|���
�K�K� � � !�s �BB> �> Cc �X � U R 5 u p[ R " US5 U4$ )z^
Convenience wrapper around mkstemp(), with the file descriptor
converted into a file object.
zr+)rK r �fdopen)r6 rL rG s r � mkstemp_file� TemporaryDirectory.mkstemp_file� s' � �
�|�|�~� ���y�y��T�"�H�,�,r c � � U R R 5 XR ; aD [ R " [ S5 [ R " U5 - 5 U R U O7[ R " [ S5 [ R " U5 - 5 U R R 5 g! U R R 5 f = f)a�
Forget about the given filename previously obtained through
mktemp() or mkstemp(). This should be called *after* the file
has been deleted, to stop a future cleanup() from trying to
delete it.
Forgetting is only needed for scaling purposes; that is, to
avoid n timefile creations from implying that n filenames are
kept in memory. Typically this whould never matter in
duplicity, but for niceness sake callers are recommended to
use this method whenever possible.
z Forgetting temporary file %sz?Attempt to forget unknown tempfile %s - this is probably a bug.N)
r5 r r2 r rF r0 r r' �Warnr )r6 �fnames r �forget�TemporaryDirectory.forget� s� � �
� � ��� � "����&�� � �!� :�;�b�k�k�%�>P�P�Q��N�N�5�)�����\�]�`b�`k�`k�lq�`r�r�s�� �K�K� � � !��D�K�K� � � !�s �B
C � C c �( � U R R 5 U R b� [ U R R 5 5 HV n [ R " S[ R " U5 - 5 [ R " [ R U5 MX [ R " U R 5 SU l SU l U R R# 5 g! [ a1 [ R " S[ R " U5 - 5 M� f = f! [ a: [ R " S[ R " U R 5 - 5 N�f = f! U R R# 5 f = f)z�
Cleanup any files created in the temporary directory (that
have not been forgotten), and clean up the temporary directory
itself.
On failure they are logged, but this method will not raise an
exception.
Nz+Removing still remembered temporary file %sz#Cleanup of temporary file %s failedzBCleanup of temporary directory %s failed - this is probably a bug.)r5 r r. �listr2 �keysr rF r r' r �ignore_missing�unlink� Exceptionr/ �rmdirrS r )r6 �files r r= �TemporaryDirectory.cleanup s+ � �
� � ��� � "��z�z�%� �� � �!4�!4�!6� 7�D� �� � �"O�RT�R]�R]�^b�Rc�"c�d� �+�+�B�I�I�t�<� 8���H�H�T�Z�Z�(� "&��� !��
� �K�K� � � !�� %� ����!F����UY�IZ�!Z�[� � ��
!� ��H�H�\�_a�_j�_j�ko�ku�ku�_v�v�� � ��
�K�K� � � !�sU �3E5 �AC0�"E5 �' D. �E5 �07D+�'E5 �*D+�+E5 �.AE2�/E5 �1E2�2E5 �5 F)�__dir�__lock� __pending� __tempcount)N)�__name__�
__module__� __qualname__�__firstlineno__�__doc__r7 r r> rE rK rP rU r= �__static_attributes__r r r r r H s1 � �,�\/'�b� ��4 �4-�"�0 "r r )rh r r( r* r
r3 � duplicityr r r r4 r r
�
gettempdirr$ r �objectr r r r �<module>rm s\ ��,�
� � � � � � � � �~�~� � �� � "�,�,�.� � �0a"�� a"r