Lojt> b %SSKJr SSKrSSKrSSKJr SSKJr SSKJ r J r SSK J r SSK JrJr \R S :XGa_SSKrSSKrSS KJr S rS \S 'SrS \S'SrS \S'\\-\-rS \S'SrS \S'SrS \S'SrS \S'SrS \S'SrS \S'SrS \S'SrS \S'Sr S \S '\\-\ -r!S \S!'Sr"S \S"'Sr#S \S#'Sr$S \S$'S%r%S \S&'S'r&S \S('Sr'S \S)'S*r(S \S+'S,r)S \S-'S.r*S \S/'\RV"S05r,S1\S2'\RV"S3S4S59r-S1\S6'"S7S8\R\5r/"S9S:\R\5r0"S;S<\R\5r1"S=S>\R\5r2"S?S@\R\5r3\Rh\,Rjl6\Rn"\Rp5\Rr\Rn"\05\Rn"\15\Rn"\Rt5\Rv\Rv\Rv\Rv\Rx\Rv/ \,Rjl=\Rh\,R|l6\R~\Rn"\/5\Rx\Rx/\,R|l=S\,Rl6\Rn"\/5/\,Rl=\Rv\,Rl6\Rh/\,Rl=\Rp/\-Rl=\R\-Rl6\Rp\Rn"\35/\-Rl=\R\-Rl6\Rp\Rr\Rr\Rr\Rr\Rn"\25/\-Rl=\R\-Rl6\Rp\Rr\Rr\Rr\Rn"\25/\-Rl=\R\-Rl6SHSAjrGSISBjrH"SCSD\ 5rISJSEjrJSKSFjrKO "SGSD\ 5rISD/rLg)L) 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_PENDINGntdllzFinal[ctypes.WinDLL]_ntdllkernel32T)use_last_error _kernel32cf\rSrSrS\R 4S\R 4S\R 44rSrg)_UNICODE_STRING8Length MaximumLengthBufferN) __name__ __module__ __qualname____firstlineno__r USHORTLPWSTR_fields___static_attributes__r5K/mnt/workspace/venv-train/lib/python3.13/site-packages/filelock/_windows.pyr0r08s- x ' hoo . x ' r>r0c\rSrSrS\R 4S\R 4S\R"\ 54S\R 4S\R4S\R44r Sr g ) _OBJECT_ATTRIBUTES?r2 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServicer5N) r6r7r8r9r ULONGHANDLEctypesPOINTERr0c_void_pr<r=r5r>r?rArA?sV x~~ & hoo . 6>>/: ; 8>> * !6?? 3 ' 9  r>rAcL\rSrSrS\R 4S\R 44rSrg)_IO_STATUS_BLOCKIStatus Informationr5N)r6r7r8r9rJrLr<r=r5r>r?rNrNIs! v ' FOO , r>rNc\rSrSrS\R 4S\R 4S\R4S\R4S\R44r Sr g) _OVERLAPPEDOInternal InternalHighOffset OffsetHighhEventr5N) r6r7r8r9rJrLr DWORDrIr<r=r5r>r?rSrSOsE  ) V__ - x~~ & 8>> * x '  r>rSc \rSrSrS\R 4S\R 4S\R 4S\R 4S\R 4S\R 4S\R 4S \R 4S \R 4S \R 44 rS rg )_BY_HANDLE_FILE_INFORMATIONXdwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowr5N) r6r7r8r9r rZFILETIMEr<r=r5r>r?r\r\Xs  0 x00 1 !2!2 3  1 1 2 #X^^ 4 hnn - X^^ , x~~ . x~~ . hnn -  r>r\c ,[5n[[-n[R [ R "U5USSS[R"U55(ag[R"5nU[:Xag[R"U5e)NrrTF) rSr#r!r. LockFileExmsvcrt get_osfhandlerJbyrefget_last_errorr%WinError)fd overlappedflagserrs r?_lock_fd_nonblockingrtsr!] (+EE    4 4R 8%Aq&,,WaJb c c##% ' 'ooc""r>c [5n[R[R"U5SSS[ R "U55(d)[ R"[ R"55eg)Nrr) rSr. UnlockFileExrkrlrJrmrorn)rprqs r? _unlock_fdrwsU ] %%f&:&:2&>1aV`Iabb//&"7"7"9: :cr>c,\rSrSrSrSSjrSSjrSrg)WindowsFileLockaQ 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. cv[UR5 [UR5 [URUR 55nUcg[ U5nU(aUR U5 U(d[R"U5 gg![a [R"U5 ef=fN) r lock_filer _open_non_reparse_fd _open_modert_mark_descriptor_owned BaseExceptionosclose)selfrplockeds r?_acquireWindowsFileLock._acquires &t~~ 6 #DNN 3&dnndoo6GHBz -b1//3 !   s #B"B8cV[SURR5n[U5 UR 5 UR USS9 UR (d<[[5 [UR5R5 SSS5 gg!,(df  g=f)NintF)default_suppresses) r_context lock_file_fdrw_mark_descriptor_released_close_released_fd_preserve_lock_filerOSErrorrr}unlink)rrps r?_releaseWindowsFileLock._releaseszeT]]778B rN  * * ,  # #B5 # A++g&(//1'&,&&s ,$B B(r5NreturnNoner6r7r8r9__doc__rrr=r5r>r?ryrys  & 2r>ryc[R"SUS[R[R-5 [ X[ -(+S9up#U[:waUU[[1;ag[RU5n[S[R"U5R5X5e[!5n["R%U[R&"U55(d@[R("5n["R+U5 [R,"U5eUR.[0-(a%["R+U5 SU3n[U5e[2R4"U[R[R6-5$![8a ["R+U5 ef=f)aW 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. openN) read_onlyz1Lock file is a reparse point (symlink/junction): )sysauditrO_RDWRO_CREAT_nt_openr r&r(r)r+RtlNtStatusToDosErrorrrJ FormatErrorstripr\r.GetFileInformationByHandlermrn CloseHandleror^rrkopen_osfhandle O_NOINHERITr)pathmodehandlestatuswinerrorinforsmsgs r?r~r~sL@ &$bii"**&<=!$\6I2IJ _ $35KLL33F;H$ 2 28 < B B DdU U*,33FFLL _ $f9 || q&((  ' ' W(= >s C-F+F/c,\rSrSrSrSSjrSSjrSrg)ryi7zRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.c[er|NotImplementedErrorrs r?rr:% %r>c[er|rrs r?rr=rr>r5Nrrr5r>r?ryry7s` & &r>)rprrbool)rprrr)rstrrrrz int | None)rrrrrztuple[int, int])M __future__rrr contextlibrpathlibrtypingrr_apir _utilr r platformrJrkr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)WinDLLr+r. Structurer0rArNrSr\LONGrrestyperKrIrZ c_longlongrHrLargtypesrLPCWSTRrrrBOOLrrjrvrtrwryr~r__all__r5r>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#)==#9F 9&,mmJt&TI#T &**  V--  6++  f&&   f&6&6  #+--Fx')*'(v(() $F >F]]F22:' ?F22; +/F',2NN?,K+LF(+3>>F  (-5]]OF  )&.oo%6I"$,MMI!5=__fnnUpFq4rI((13;==I((0{# %I!$,==I {# 'I#&.]]I" #; &2,&2P8t')V&,& r>