dtjt> NUddlmZddlZddlZddlmZddlmZddlm Z m Z ddl m Z ddl mZmZejd krVddlZddlZdd 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/<ej+d0Z,d1ed2<ej+d3d45Z-d1ed6<Gd7d8ej.Z/Gd9d:ej.Z0Gd;dej.Z2Gd?d@ej.Z3ej4e,j5_6ej7ej8ej9ej7e0ej7e1ej7ej:ej;ej;ej;ej;ej<ej;g e,j5_=ej4e,j>_6ej?ej7e/ej<ej<ge,j>_=de,j@_6ej7e/ge,j@_=ej;e,jA_6ej4ge,jA_=ej8ge-jB_=ejCe-jB_6ej8ej7e3ge-jD_=ejCe-jD_6ej8ej9ej9ej9ej9ej7e2ge-jE_=ejCe-jE_6ej8ej9ej9ej9ej7e2ge-jF_=ejCe-jF_6dSdEZGdTdGZHGdHdIe ZIdUdNZJdVdQZKnGdRdIe ZIdIgZLdS)W) 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 _kernel32cBeZdZdejfdejfdejffZdS)_UNICODE_STRINGLength MaximumLengthBufferN)__name__ __module__ __qualname__r USHORTLPWSTR_fields_O/var/www/html/CA-Chatbot/venv/lib/python3.11/site-packages/filelock/_windows.pyr0r08s3 x ' ho . x ' r;r0ceZdZdejfdejfdejefdejfdej fdej ffZ dS)_OBJECT_ATTRIBUTESr1 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServiceN) r4r5r6r ULONGHANDLEctypesPOINTERr0c_void_pr9r:r;r<r>r>?s[ x~ & ho . >6>/:: ; 8> * !6? 3 ' 9  r;r>c2eZdZdejfdejffZdS)_IO_STATUS_BLOCKStatus InformationN)r4r5r6rFrHr9r:r;r<rJrJIs) v ' FO , r;rJcbeZdZdejfdejfdejfdejfdejffZdS) _OVERLAPPEDInternal InternalHighOffset OffsetHighhEventN) r4r5r6rFrHr DWORDrEr9r:r;r<rNrNOsG  ) V_ - x~ & 8> * x '  r;rNc eZdZdejfdejfdejfdejfdejfdejfdejfdejfd ejfd ejff Zd S) _BY_HANDLE_FILE_INFORMATIONdwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowN)r4r5r6r rTFILETIMEr9r:r;r<rVrVXs|  0 x0 1 !2 3  1 2 #X^ 4 hn - X^ , x~ . x~ . hn -  r;rVfdintreturnboolc .t}ttz}tt j||dddtj|rdStj }|tkrdStj |)NrrTF) rNr#r!r. LockFileExmsvcrt get_osfhandlerFbyrefget_last_errorr%WinError)rb overlappedflagserrs r<_lock_fd_nonblockingrps!]] (+EE    4R 8 8%Aq&,WaJbJb c c 4#%% ' ' '5oc"""r;Nonec t}ttj|dddt j|s%t jt jdS)Nrr) rNr. UnlockFileExrhrirFrjrlrk)rbrms r< _unlock_fdrtsb ]] %%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. rdrqcrt|jt|jt|j|}|dS t |}|r||n##t$rtj |wxYw|stj |dSdSN) r lock_filer _open_non_reparse_fd _open_moderp_mark_descriptor_owned BaseExceptionosclose)selfrblockeds r<_acquirezWindowsFileLock._acquires &t~ 6 6 6 #DN 3 3 3&dndoo6G6GHHBz -b114//333          s &A<< Bcftd|jj}t||||d|jsUtt5t|j  ddddS#1swxYwYdSdS)NrcF)default_suppresses) r_context lock_file_fdrt_mark_descriptor_released_close_released_fd_preserve_lock_filerOSErrorrryunlink)rrbs r<_releasezWindowsFileLock._releaseseT]788B rNNN  * * , , ,  # #B5 # A A A+ 2g&&22((//111222222222222222222 2 2s0'B$$B(+B(Nrdrqr4r5r6__doc__rrr:r;r<rvrvsF      & 2 2 2 2 2 2r;rvpathstrmode int | Nonectjd|dtjtjzt ||t z \}}|tkrb|tthvrdSt |}tdtj|||t!}t"|tj|sAtj}t"|tj||jt0zr.t"|d|}t| t3j|tjtjzS#t8$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. openN) read_onlyz1Lock file is a reparse point (symlink/junction): )sysauditr~O_RDWRO_CREAT_nt_openr r&r(r)r+RtlNtStatusToDosErrorrrF FormatErrorstriprVr.GetFileInformationByHandlerjrk CloseHandlerlrWrrhopen_osfhandle O_NOINHERITr})rrhandlestatuswinerrorinforomsgs r<rzrzs@ &$bi"*&<===!$d\6I2IJJJ _ $ $35KLLLt33F;;H$ 28 < < B B D DdHUU U*,,33FFLsizeofr1pointerr@rrAr rErJ NtCreateFilerrrrrrRtlFreeUnicodeStringvalue)rrnt_namer attributesr io_statuss r<rr s"##??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)rvzRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.rdrqctrxNotImplementedErrorrs r<rzWindowsFileLock._acquire:% %r;ctrxrrs r<rzWindowsFileLock._release=rr;Nrrr:r;r<rvrv7sB`` & & & & & & & & & &r;)rbrcrdre)rbrcrdrq)rrrrcrdr)rrrrerdr)M __future__rr~r contextlibrpathlibrtypingrr_apir _utilr r platformrFrhr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)WinDLLr+r. Structurer0r>rJrNrVLONGrrestyperGrErT c_longlongrDrHargtypesrLPCWSTRrrrBOOLrrgrsrprtrvrzr__all__r:r;r<rs""""""" 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&2P8888t')')')')')V&&&&&,&&& r;