㚾jA  UddlmZddlZddlZddlZddlmZddlmZddl m Z m Z ddl m Z ddlmZmZej"d k(roddlZddlZdd 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=ejbZ2Gd>d?ejbZ3Gd@dAejbZ4GdBdCejbZ5GdDdEejbZ6ejne/jp_9ejtejvejxejte3ejte4ejtejzej|ej|ej|ej|ej~ej|g e/jp_@ejne/j_9ejejte2ej~ej~ge/j_@de/j_9ejte2ge/j_@ej|e/j_9ejnge/j_@ejvge0j_@eje0j_9ejvejte6ge0j_@eje0j_9ejvejxejxejxejxejte5ge0j_@eje0j_9ejvejxejxejxejte5ge0j_@eje0j_9dMdFZJdNdGZKGdHdIe ZLdOdJZMdPdKZNdIgZOyGdLdIe ZLdIgZOy)Q) 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 _kernel32c^eZdZdejfdejfdej ffZy)_UNICODE_STRINGLength MaximumLengthBufferN)__name__ __module__ __qualname__r USHORTLPWSTR_fields_[/home/spazio/kingdom_calls/work5/transenv/lib/python3.12/site-packages/filelock/_windows.pyr2r2=s- x ' hoo . x ' r=r2ceZdZdejfdej fdejefdejfdejfdejffZ y)_OBJECT_ATTRIBUTESr3 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServiceN) r6r7r8r ULONGHANDLEctypesPOINTERr2c_void_pr;r<r=r>r@r@DsX x~~ & hoo . >6>>/: ; 8>> * !6?? 3 ' 9  r=r@cDeZdZdejfdejffZy)_IO_STATUS_BLOCKStatus InformationN)r6r7r8rHrJr;r<r=r>rLrLNs! v ' FOO , r=rLceZdZdejfdejfdej fdej fdejffZy) _OVERLAPPEDInternal InternalHighOffset OffsetHighhEventN) r6r7r8rHrJr DWORDrGr;r<r=r>rPrPTsE  ) V__ - x~~ & 8>> * x '  r=rPc eZdZdejfdej fdej fdej fdejfdejfdejfdejfd ejfd ejff Zy ) _BY_HANDLE_FILE_INFORMATIONdwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowN)r6r7r8r rVFILETIMEr;r<r=r>rXrX]s  0 x00 1 !2!2 3  1 1 2 #X^^ 4 hnn - X^^ , x~~ . x~~ . hnn -  r=rXc t}ttz}tj t j ||dddtj|rytj}|tk(rytj|)NrrTF) rPr#r!r0 LockFileExmsvcrt get_osfhandlerHbyrefget_last_errorr%WinError)fd overlappedflagserrs r>_lock_fd_nonblockingroso!] (+EE    4 4R 8%Aq&,,WaJb c##% ' 'ooc""r=c t}tjtj|dddt j |s't jt jy)Nrr) rPr0 UnlockFileExrfrgrHrhrjri)rkrls r> _unlock_fdrrsR ] %%f&:&:2&>1aV`Iab//&"7"7"9: :cr=c eZdZdZddZddZy)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. cZt|jt|jt|j|j }|y t |}|r|j ||stj|yy#t$rtj|wxYwN) r lock_filer _open_non_reparse_fd _open_modero_mark_descriptor_owned BaseExceptionosclose)selfrklockeds r>_acquirezWindowsFileLock._acquires &t~~ 6 #DNN 3&dnndoo6GHBz -b1//3 !   s B B*cHtd|jj}t||j |j |d|j s_releasezWindowsFileLock._releaseseT]]778B rN  * * ,  # #B5 # A++g&2(//122,22s *$BB!NreturnNoner6r7r8__doc__rrr<r=r>rtrts  & 2r=rtc|tjd|dtjtjz|t z }t ||\}}|tk(rtjtz}|tk(ratj|krJtjtt ||\}}|tk(rtj|krJ|tk7rS|tthvryt j#|}t%dt'j(|j+||t-}t.j1|t'j2|s>t'j4}t.j7|t'j8||j:t<zr%t.j7|d|} t%|  t?j@|tjtjBzS#tD$rt.j7|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): )#sysauditr|O_RDWRO_CREATr _nt_openr'time monotonicr*sleepr+r&r(r)r-RtlNtStatusToDosErrorrrH FormatErrorstriprXr0GetFileInformationByHandlerhri CloseHandlerjrYrrfopen_osfhandle O_NOINHERITr{) pathmoderhandlestatusdeadlinewinerrorinfornmsgs r>rxrxsB &$bii"**&<=|++ !$)< * *~~'*>>H11dnn6F6Q /0!)$)!D11dnn6F6Q _ $35KLL33F;H$ 2 28 < B B DdHU U*,33FFLLrrsK"#??fllSZF[]acghkuu _ $f9  ?+-J & .@ AJ $*NN7$;J !$9J !__&F(*I##LL(#LL,LL+09,?U*!#   "  ' ' W(= > _ $f9 || q&((  ' ' W(= >s C"E00*Fc eZdZdZddZddZy)rtzRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.ctrvNotImplementedErrorr~s r>rzWindowsFileLock._acquireF% %r=ctrvrrs r>rzWindowsFileLock._releaseIrr=Nrrr<r=r>rtrtCs` & &r=)rkrrbool)rkrrr)rstrrrrz int | None)rrrrrztuple[int, int])P __future__rr|rr contextlibrpathlibrtypingrr_apir _utilr r platformrHrfr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)r*r+WinDLLr-r0 Structurer2r@rLrPrXLONGrrestyperIrGrV c_longlongrFrJargtypesrLPCWSTRrrrBOOLrrerqrorrrtrxr__all__r<r=r>rs\" F<<7 *M:*!+NJ+)L*)"/."@<"OOZOJ!"M:!+5j5)3J30:!::1;!::+5j5+5j5"?BZ"Z]u"uOZu(2:2$L*$ .8 7+5j5(*:* #-OZ,(2:2,6z6)3J3*-,,).,.#06==#9F 9&3fmmJt&TI#T &**  V--  6++  f&&   f&6&6  #+--Fx')*'(v(() $F >F]]F22:' ?F22; +/F',:FNN?,K+LF(+3>>F  (-5]]OF  )&.oo%6I"$,MMI!5=__nfnnUpFq4rI((13;==I((0{# %I!$,==I {# 'I#&.]]I" #; &2,&2P?B')l &,& r=