"jA rUddlmZddlZddlZddlZddlmZddlmZddl m Z m Z ddl m Z ddlmZmZejd krdddlZddlZdd lmZd Zd ed <dZd ed<dZd ed<eezezZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZ d ed<dZ!d ed <ee ze!zZ"d ed!<dZ#d ed"<dZ$d ed#<dZ%d ed$<d%Z&d ed&<d'Z'd ed(<dZ(d ed)<d*Z)d ed+<d,Z*d ed-<d.Z+d ed/<d0Z,d1ed2<d3Z-d1ed4<ej.d5Z/d6ed7<ej.d8d9:Z0d6ed;<Gd<d=ej1Z2Gd>d?ej1Z3Gd@dAej1Z4GdBdCej1Z5GdDdEej1Z6ej7e/j8_9ej:ej;ej<ej:e3ej:e4ej:ej=ej>ej>ej>ej>ej?ej>g e/j8_@ej7e/jA_9ejBej:e2ej?ej?ge/jA_@de/jC_9ej:e2ge/jC_@ej>e/jD_9ej7ge/jD_@ej;ge0jE_@ejFe0jE_9ej;ej:e6ge0jG_@ejFe0jG_9ej;ej<ej<ej<ej<ej:e5ge0jH_@ejFe0jH_9ej;ej<ej<ej<ej:e5ge0jI_@ejFe0jI_9dXdJZJdYdLZKGdMdNe ZLdZdSZMd[dVZNnGdWdNe ZLdNgZOdS)\) annotationsN)suppress)Path)Finalcast) BaseFileLock)ensure_directory_existsraise_on_not_writable_filewin32)wintypeslz Final[int] _GENERIC_READi@_GENERIC_WRITEi _SYNCHRONIZE_DESIRED_ACCESS_FILE_SHARE_READ_WRITE _FILE_OPEN_IF_FILE_ATTRIBUTE_READONLY_FILE_ATTRIBUTE_NORMALi_FILE_ATTRIBUTE_REPARSE_POINT _FILE_SYNCHRONOUS_IO_NONALERT@_FILE_NON_DIRECTORY_FILEi _FILE_OPEN_REPARSE_POINT_CREATE_OPTIONS_OBJ_CASE_INSENSITIVE _OWNER_WRITE_LOCKFILE_FAIL_IMMEDIATELY_LOCKFILE_EXCLUSIVE_LOCK!_ERROR_LOCK_VIOLATION_STATUS_SUCCESSl"_STATUS_ACCESS_DENIEDlC_STATUS_SHARING_VIOLATIONlV_STATUS_DELETE_PENDINGg?z Final[float]_ACCESS_DENIED_GRACEgMb`?_ACCESS_DENIED_RETRYntdllzFinal[ctypes.WinDLL]_ntdllkernel32T)use_last_error _kernel32cBeZdZdejfdejfdejffZdS)_UNICODE_STRINGLength MaximumLengthBufferN)__name__ __module__ __qualname__r USHORTLPWSTR_fields_Q/home/spazio/kingdom_calls/venv/lib/python3.11/site-packages/filelock/_windows.pyr2r2=s3 x ' ho . x ' r=r2ceZdZdejfdejfdejefdejfdej fdej ffZ dS)_OBJECT_ATTRIBUTESr3 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServiceN) r6r7r8r ULONGHANDLEctypesPOINTERr2c_void_pr;r<r=r>r@r@Ds[ x~ & ho . >6>/:: ; 8> * !6? 3 ' 9  r=r@c2eZdZdejfdejffZdS)_IO_STATUS_BLOCKStatus InformationN)r6r7r8rHrJr;r<r=r>rLrLNs) v ' FO , r=rLcbeZdZdejfdejfdejfdejfdejffZdS) _OVERLAPPEDInternal InternalHighOffset OffsetHighhEventN) r6r7r8rHrJr DWORDrGr;r<r=r>rPrPTsG  ) V_ - x~ & 8> * x '  r=rPc eZdZdejfdejfdejfdejfdejfdejfdejfdejfd ejfd ejff Zd S) _BY_HANDLE_FILE_INFORMATIONdwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowN)r6r7r8r rVFILETIMEr;r<r=r>rXrX]s|  0 x0 1 !2 3  1 2 #X^ 4 hn - X^ , x~ . x~ . hn -  r=rXfdintreturnboolc .t}ttz}tt j||dddtj|rdStj }|tkrdStj |)NrrTF) rPr#r!r0 LockFileExmsvcrt get_osfhandlerHbyrefget_last_errorr%WinError)rd overlappedflagserrs r>_lock_fd_nonblockingrrs!]] (+EE    4R 8 8%Aq&,WaJbJb c c 4#%% ' ' '5oc"""r=Nonec t}ttj|dddt j|s%t jt jdS)Nrr) rPr0 UnlockFileExrjrkrHrlrnrm)rdros r> _unlock_fdrvsb ]] %%f&:2&>&>1aV`IaIabb ;/&"7"9"9:: : ; ;r=c"eZdZdZddZddZdS)WindowsFileLockay Uses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems. Lock file cleanup: Windows attempts to delete the lock file after release, but deletion is not guaranteed in multi-threaded scenarios where another thread holds an open handle. The lock file may persist on disk, which does not affect lock correctness. rfrscrt|jt|jt|j|}|dS t |}|r||n##t$rtj |wxYw|stj |dSdSN) r lock_filer _open_non_reparse_fd _open_moderr_mark_descriptor_owned BaseExceptionosclose)selfrdlockeds r>_acquirezWindowsFileLock._acquires &t~ 6 6 6 #DN 3 3 3&dndoo6G6GHHBz -b114//333          s &A<< Bcftd|jj}t||||d|jsUtt5t|j  ddddS#1swxYwYdSdS)NreF)default_suppresses) r_context lock_file_fdrv_mark_descriptor_released_close_released_fd_preserve_lock_filerOSErrorrr{unlink)rrds r>_releasezWindowsFileLock._releaseseT]788B rNNN  * * , , ,  # #B5 # A A A+ 2g&&22((//111222222222222222222 2 2s0'B$$B(+B(Nrfrsr6r7r8__doc__rrr<r=r>rxrxsF      & 2 2 2 2 2 2r=rxpathstrmode int | Nonectjd|dtjtjz|t z }t ||\}}|tkrtj tz}|tkrftj |krOtj tt ||\}}|tkrtj |kO|tkrb|tthvrdSt |}t%dt'j|||t-}t.|t'j|sAt'j}t.|t'j||jt<zr.t.|d|} t%|  t?j |tjtj!zS#tD$rt.|wxYw)a Open *path* for locking while refusing reparse points, bound to the handle actually locked. The file is opened through ``NtCreateFile`` with ``FILE_OPEN_REPARSE_POINT`` so a symlink or junction planted at the path is not followed, and the reparse decision is read from *that* handle via ``GetFileInformationByHandle`` rather than from a prior pathname query. Reading the held handle closes the check-then-open race: an attacker cannot swap the path between validation and use because both act on the same handle. Share mode omits delete so a peer cannot unlink or rename the file out from under a live holder, matching ``os.open``'s ``_SH_DENYNO``. ``NtCreateFile`` is used instead of ``CreateFileW`` because its return value carries the raw ``NTSTATUS``. Windows collapses a transient delete-pending name and a permanent access denial into the same Win32 ``ERROR_ACCESS_DENIED``; the status keeps them apart, so a real denial fails fast instead of spinning until the caller's timeout (#604). The reparse option only guards the final path component; Windows still follows reparse points in intermediate directories. This assumes the lock file sits in a lock directory untrusted users cannot modify. A path with attacker-controlled parent directories would need component-by-component handle validation. :param path: the lock file path. :param mode: the permission mode; as ``os.open`` does on Windows, a cleared owner-write bit creates the file read-only. The attribute only takes effect when the file is created, not when an existing one is opened. :returns: a file descriptor owning the opened handle, or ``None`` on a sharing violation or a delete-pending name the caller should treat as contention and retry. :raises OSError: if the path resolves to a reparse point, or the open fails for any other reason, raised with the Win32 error the status maps to. An access denial is raised only once it outlasts a short grace, since a peer unlinking the file as it releases can make the open answer ``STATUS_ACCESS_DENIED`` for a moment. openN) read_onlyz1Lock file is a reparse point (symlink/junction): )#sysauditrO_RDWRO_CREATr _nt_openr'time monotonicr*sleepr+r&r(r)r-RtlNtStatusToDosErrorrrH FormatErrorstriprXr0GetFileInformationByHandlerlrm CloseHandlernrYrrjopen_osfhandle O_NOINHERITr) rrrhandlestatusdeadlinewinerrorinforqmsgs r>r|r|sB &$bi"*&<===|++ !$)<<< * * *~''*>>H111dn6F6F6Q6Q /000!)$)!D!D!D111dn6F6F6Q6Q _ $ $35KLLLt33F;;H$ 28 < < B B D DdHUU U*,,33FFLrrs"##??flSZF[F[]acghhkuu _ $ $f9  ?+--J & .@ A AJ $*N7$;$;J !$9J !_&&F(**I##L((#L,,L++09U,,?U*!#    "  ' ' W(=(= > > > >F ' ' W(=(= > > > > _ $ $f9 | q&((s C1E//.Fc"eZdZdZddZddZdS)rxzRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.rfrsctrzNotImplementedErrorrs r>rzWindowsFileLock._acquireF% %r=ctrzrrs r>rzWindowsFileLock._releaseIrr=Nrrr<r=r>rxrxCsB`` & & & & & & & & & &r=)rdrerfrg)rdrerfrs)rrrrerfr)rrrrgrfr)P __future__rrrr contextlibrpathlibrtypingrr_apir _utilr r platformrHrjr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)r*r+WinDLLr-r0 Structurer2r@rLrPrXLONGrrestyperIrGrV c_longlongrFrJargtypesrLPCWSTRrrrBOOLrrirurrrvrxr|r__all__r<r=r>rsG""""""" FFFFFFFF<7MMMMMM *M****!+N++++)L))))"/."@<"OOOOOO!"M!!!!+55555)333330:!::::1;!::::+55555+55555"?BZ"Z]u"uOuuuu(22222$L$$$$ .87777+55555(***** #-O,,,,(22222,66666)33333*-,,,,).....#06=#9#9F9999&3fmJt&T&T&TITTTT     &*        V-        6+        f&         f&6    #+-Fx'')**'((v()) $F >F]F2:'' ?F2; +/F',:FN?,K,K+LF(+3>F (-5]OF )&.o%6I"$,MI!5=_nfnUpFqFq4rI(13;=I(0{## %I!$,=I {## 'I#&.]I" # # # #;;;; &2&2&2&2&2,&2&2&2P????B')')')')')V&&&&&,&&& r=