^jt> d UddlmZddlZddlZddlmZddlmZddlm Z m Z ddl m Z ddl mZmZej d k(raddlZddlZdd lmZd Zd ed <dZd ed<dZd ed<eezezZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZd ed<dZ d ed <eeze 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/<ejVd0Z,d1ed2<ejVd3d45Z-d1ed6<Gd7d8ej\Z/Gd9d:ej\Z0Gd;dej\Z2Gd?d@ej\Z3ejhe,jj_6ejnejpejrejne0ejne1ejnejtejvejvejvejvejxejvg e,jj_=ejhe,j|_6ej~ejne/ejxejxge,j|_=de,j_6ejne/ge,j_=ejve,j_6ejhge,j_=ejpge-j_=eje-j_6ejpejne3ge-j_=eje-j_6ejpejrejrejrejrejne2ge-j_=eje-j_6ejpejrejrejrejne2ge-j_=eje-j_6dHdAZGdIdBZHGdCdDe ZIdJdEZJdKdFZKdDgZLyGdGdDe ZIdDgZLy)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 _kernel32c^eZdZdejfdejfdej ffZy)_UNICODE_STRINGLength MaximumLengthBufferN)__name__ __module__ __qualname__r USHORTLPWSTR_fields_\/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/filelock/_windows.pyr0r08s- x ' hoo . x ' r;r0ceZdZdejfdej fdejefdejfdejfdejffZ y)_OBJECT_ATTRIBUTESr1 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServiceN) r4r5r6r ULONGHANDLEctypesPOINTERr0c_void_pr9r:r;r<r>r>?sX x~~ & hoo . >6>>/: ; 8>> * !6?? 3 ' 9  r;r>cDeZdZdejfdejffZy)_IO_STATUS_BLOCKStatus InformationN)r4r5r6rFrHr9r:r;r<rJrJIs! v ' FOO , r;rJceZdZdejfdejfdej fdej fdejffZy) _OVERLAPPEDInternal InternalHighOffset OffsetHighhEventN) r4r5r6rFrHr DWORDrEr9r:r;r<rNrNOsE  ) V__ - x~~ & 8>> * x '  r;rNc eZdZdejfdej fdej fdej fdejfdejfdejfdejfd ejfd ejff Zy ) _BY_HANDLE_FILE_INFORMATIONdwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowN)r4r5r6r rTFILETIMEr9r:r;r<rVrVXs  0 x00 1 !2!2 3  1 1 2 #X^^ 4 hnn - X^^ , x~~ . x~~ . hnn -  r;rVc t}ttz}tj t j ||dddtj|rytj}|tk(rytj|)NrrTF) rNr#r!r. LockFileExmsvcrt get_osfhandlerFbyrefget_last_errorr%WinError)fd overlappedflagserrs r<_lock_fd_nonblockingrmso!] (+EE    4 4R 8%Aq&,,WaJb c##% ' 'ooc""r;c t}tjtj|dddt j |s't jt jy)Nrr) rNr. UnlockFileExrdrerFrfrhrg)rirjs r< _unlock_fdrpsR ] %%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_moderm_mark_descriptor_owned BaseExceptionosclose)selfrilockeds r<_acquirezWindowsFileLock._acquires &t~~ 6 #DNN 3&dnndoo6GHBz -b1//3 !   s B B*cHtd|jj}t||j |j |d|j stj(}t"j+|tj,||j.t0zr%t"j+|d|}t| t3j4|tjtj6zS#t8$rt"j+|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. openN) read_onlyz1Lock file is a reparse point (symlink/junction): )sysauditrzO_RDWRO_CREAT_nt_openr r&r(r)r+RtlNtStatusToDosErrorrrF FormatErrorstriprVr.GetFileInformationByHandlerfrg CloseHandlerhrWrrdopen_osfhandle O_NOINHERITry)pathmodehandlestatuswinerrorinforlmsgs r<rvrvsO@ &$bii"**&<=!$d\6I2IJ _ $35KLL33F;H$ 2 28 < B B DdHU U*,33FFLLsizeofr1pointerr@rrAr rErJ NtCreateFilerrrrrrRtlFreeUnicodeStringvalue)rrnt_namer attributesr io_statuss r<rr sK"#??fllSZF[]acghkuu _ $f9  ?+-J & .@ AJ $*NN7$;J !$9J !__&F(*I##LL(#LL,LL+09,?U*!#   "  ' ' W(= > _ $f9 || q&((  ' ' W(= >s C"E00*Fc eZdZdZddZddZy)rrzRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.ctrtNotImplementedErrorr|s r<r~zWindowsFileLock._acquire:% %r;ctrtrrs r<rzWindowsFileLock._release=rr;Nrrr:r;r<rrrr7s` & &r;)rirrbool)rirrr)rstrrrrz int | None)rrrrrztuple[int, int])M __future__rrzr contextlibrpathlibrtypingrr_apir _utilr r platformrFrdr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)WinDLLr+r. Structurer0r>rJrNrVLONGrrestyperGrErT c_longlongrDrHargtypesrLPCWSTRrrrBOOLrrcrormrprrrvr__all__r:r;r<rsA" 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,&2P8t')l &,& r;