+ Ki3csLRt^RIt^RIt^RIt^RItRt^RIHt!RR]P4t Rt R^R^R^R^R^R^R^R^/t Rt Rt RtR tR tR t]R 4t]R 4tRRRRRRRRRRRRRRRR/tRt!RR]P4tRt]R4t]R4tR#)u Module for detecting the availability of the Linux futex FUTEX_WAIT_MULTIPLE operation, or the Linux futex2 syscalls. Either of these is required for fsync to work in Wine. Fsync is an alternative implementation of the Windows synchronization primitives that are used to guard data from being accessed by multiple threads concurrently (which would be A Bad Thing™). Fsync improves upon the previous implementation in Wine of these primitives, known as esync, which in turn improved upon the original implementation known as "Server-side synchronization". The original implementation used a wineserver call for each synchronization operation, which required multiple context switches per operation. Esync instead used file descriptors for synchronization, which can be passed around between processes and therefore allowed synchronization to happen directly between the processes involved, instead of going through the wineserver. This made the synchronization operations faster and improved performance of games a bit. A problem with this implementation was that each created synchronization object required one file descriptor, and there is only a limited amount of these available for each process. Some games would run out of available file descriptors, and would stop working. This has been partly mitigated by raising the per-process file descriptor limit, but there are also games that leak synchronization objects continuously while running, and would eventually run out despite the raised limits. Fsync improved on esync by not requiring a file descriptor for each created synchronization object, and instead using the Linux kernel's futex interface for synchronizations. This matches Windows's implementation more closely and mitigated all the file descriptor related issues of esync. However, since the default futex interface was insufficient for implementing all required synchronization operations, a patch to the Linux kernel was needed, which usually meant that users needed to compile their own Linux kernel with the patch, or install a kernel provided by a third-party. It was attempted to get the kernel patch into the mainline Linux kernel, but it didn't get accepted. Instead, patches were written that would add a new set of system calls which extend the original futex system calls, dubbed "futex2", and the Wine fsync code was adjusted to make use of these new system calls. The new Wine fsync code is backwards-compatible with the old futex patch, therefore it makes sense for now to detect the presence of either patch in the running kernel. The detection of the old patch can probably be removed when the new patch is merged and in a stable Linux release. This module's code is based on https://gist.github.com/openglfreak/715d5ab5902497378f1996061dbbf8ec N) cache_singlecsV]tRt^@tRtRtR]P3R]P3.tRt R#)timespeczLinux kernel compatible timespec type. Fields: tv_sec: The whole seconds of the timespec. tv_nsec: The nanoseconds of the timespec. Ztv_secZtv_nsecN) __name__ __module__ __qualname____firstlineno____doc__ __slots__ctypesc_long_fields___static_attributes__r;/usr/lib/python3.14/site-packages/lutris/util/wine/fsync.pyrr@s-I 6==! FMM"Hr rc s\P!\P4^,p\P!RR\ V4,RRRRR3\P \P \P RRR 7;_uu_4pVPR V,R ,4wr4R R R 4XP'd\R T,R,X4hX'g\R T,R,4hTP4R,pTR8Xd(\R T,R,T,R,4h\T4# +'giL;i \d p\R T,R,4ThR p?ii;i \d5p\R T,R,T,R,T,4ThR p?ii;i)iZcppz-mz-Ez-Pz-xZcZ-T)ZstdinstdoutstderrZ close_fdsZuniversal_newlinesz#include __NR_Z Nzfailed to determine z1 syscall number: cpp not installed or not in PATHz/ syscall number: cpp returned nonzero exit codez# syscall number: no output from cppZ __NR_futexz syscall number: __NR_z not expandedz not a valid number: )r sizeofc_void_p subprocessZPopenZstrZPIPEZ communicateZFileNotFoundError RuntimeErrorZ returncodeZ splitlinesZintZ ValueError)Z syscall_namebitsZpopenrrZexZ last_lines& r_get_syscall_nr_from_headersrOs == )A -D     D3t9$dD$S A//????#   "../PS_/_bf/fgNF   "\ 14e egm   1L@Chhii!!#B'IL  "\ 14L L| [^m m  9~=    "\ 14g g  ,  "\ 15 " #%< =?H I  sNA%E-"E4E- F E* %E-*E-- F8FF G%/GGc\P!\P4^,p\\P !4^,V3,# \ dMi;i\R4#)zGet the syscall number of the Linux futex() syscall. Returns: The futex() syscall number. Raises: RuntimeError: When the syscall number could not be determined. Zfutex)r rr_NR_FUTEX_PER_ARCHosunameKeyErrorrr r_get_futex_syscall_nrrsY == )A -D !288:a=$"788     ( 00(A A$#A$csj\VR4;'d!\VR4;'d \VR4#)Z_b_base_Z _b_needsfree_Z_objectsZhasattrZobj&r_is_ctypes_objr$s/ 3 # b b_(E b b'RUWaJbbr csB\VR4;'d \VR4#)Z_type_Zcontentsr!r"r#r_is_ctypes_obj_pointerr%s 3 ! > >gc:&>>r csVfR#\V4'd*\V4'dV#\P!V4#\ V4pV^,P \ V4,!V!#)N)r$r%r ZpointerZtupleZ __class__Zlenr"r#r_coerce_to_pointerr&s[ {c !# & &J~~c"" *C F  s3x '# ..r csaa\P!RRR7Po\P\P\P \P \P !\4\P\P 3Sn\P Sn \4oVV3RlpV#)aCreate a function that can be used to execute the Linux futex() syscall. Returns: A proxy function for the Linux futex() syscall. Raises: AttributeError: When the libc has no syscall() function. RuntimeError: When the syscall number could not be determined. NTZ use_errnoc s<S!S\V4TT\T;'g \44\V4V4pYfR8Xd\P!43#^3#)a\Invoke the Linux futex() syscall with the provided arguments. Args: See the description of the futex() syscall for the parameter meanings. `uaddr` and `uaddr2` are automatically converted to pointers. If timeout is None, a zero timeout is passed. Returns: A tuple of the return value of the syscall and the error code in case an error occurred. Raises: AttributeError: When the libc has no syscall() function. RuntimeError: When the syscall number could not be determined. TypeError: If `uaddr` or `uaddr2` is not a pointer and can't be converted into one. r)r&rr get_errno) uaddrZfutex_opvaltimeoutZuaddr2Zval3error futex_syscallfutex_syscall_nrs &&&&&& r_futex_syscallZ*_get_futex_syscall.._futex_syscalls_&  u %   w44(* 5 v &  b[v'')@@a@@r ) r CDLLsyscallr rZc_intPOINTERrargtypesrestyper)r/r-r. @@r_get_futex_syscallr6sKK5==M   x  M#LLM,.A< r csV!R^^RR^4pV^,\P8wd^#V!R^ ^RR^4pV^,\P8wd^ #R#)zDetects which (if any) futex opcode is used for the FUTEX_WAIT_MULTIPLE operation on this kernel. Returns: The opcode number, or None if the operation is not supported. N)errnoENOSYS)r-rets& r_get_futex_wait_multiple_opr:sU b!T4 3C 1v b!T4 3C 1v r cs^\\44RJ# \\3dR#i;i)zChecks whether the Linux futex FUTEX_WAIT_MULTIPLE operation is supported on this kernel. Returns: Whether this kernel supports the FUTEX_WAIT_MULTIPLE operation. NF)r:r6AttributeErrorrrr r is_futex_wait_multiple_supportedr<s2*+=+?@LL L )s ,,cs,RFfp\RV,R4;_uu_4pVP4P4P4'g RRR4R#RRR4Kh R# +'giK};i \dR#i;i)zChecks whether the Linux futex2 syscall is supported on this kernel. Returns: Whether this kernel supports the futex2 syscall. z/sys/kernel/futex2/ZrbNFT)ZwaitZwaitvZwake)ZopenZreadlineZstripZisdigitZOSError)ZfilenameZfiles ris_futex2_supportedr=s~1H+h6==}},,.6688 >=8>=2  >== s. B4A0 B" B0 B ; B BBicr)zGet the syscall number of the Linux futex_waitv() syscall. Returns: The futex_waitv() syscall number. Raises: RuntimeError: When the syscall number could not be determined. futex_waitv)r rr_NR_FUTEX_WAITV_PER_ARCHrrrrrrr_get_futex_waitv_syscall_nrr@'sY == )A -D 'A(=>>     ( 66r csp]tRtRtRtRtR]P3R]P3R]P3.t Rt R#)r>i;zLinux kernel compatible futex_waitv type. Fields: val: The expected value. uaddr: The address to wait for. flags: The type and size of the futex. r*r)flagsrN) rrrrrrr Zc_uint64rc_uintr r rr rr>r>;s9I  &//" &-- Hr r>csfaa\P!RRR7Po\P\P!\ 4\P \P \P!\43Sn\PSn \4oVV3RlpV#)aCreate a function that can be used to execute the Linux futex_waitv() syscall. Returns: A proxy function for the Linux futex_waitv() syscall. Raises: AttributeError: When the libc has no syscall() function. RuntimeError: When the syscall number could not be determined. NTr'c s~<S!S\V4W\V44pYDR8Xd\P!43#^3#)aSInvoke the Linux futex_waitv() syscall with the provided arguments. Args: See the description of the futex_waitv() syscall for the parameter meanings. `waiters` is automatically converted to a pointer. If timeout is None, a zero timeout is passed. Returns: A tuple of the return value of the syscall and the error code in case an error occurred. Raises: AttributeError: When the libc has no syscall() function. RuntimeError: When the syscall number could not be determined. TypeError: If `waiters` is not a pointer and can't be converted into one. r)r&r r()ZwaitersZ nr_futexesrAr+r,futex_waitv_syscallfutex_waitv_syscall_nrs&&&& r_futex_waitv_syscallZ6_get_futex_waitv_syscall.._futex_waitv_syscallcsG($ "$6w$?TfgnTo b[v'')@@a@@r ) r r0r1r r2r>rBrr3r4r@)rErCrDr5r_get_futex_waitv_syscallrFLsz!++dd;CC {#  x $ #)--8:A2 r cs\4!R^^R4pV^,\P8g# \\3dR#i;i)zChecks whether the Linux 5.16 futex_waitv syscall is supported on this kernel. Returns: Whether this kernel supports the futex_waitv syscall. NF)rFr7r8r;r)r9rris_futex_waitv_supportedrGsD&(q!T:1v%% L )s,/AAcsr\4'dR#\4'dR#\4'dR#R#)zChecks whether the FUTEX_WAIT_MULTIPLE operation, the futex2 syscalls, or the futex_waitv syscall is supported on this kernel. Returns: The result of the check. TF)rGr=r<rr rget_fsync_supportrHs+ !!')) r )rH)Zi386 )Zi686rI)x86_64rI)rJ@)Zaarch64rK)Z aarch64_berK)Zarmv8brI)Zarmv8lrI)rr r7rrZ__all__Z lutris.utilrZ Structurerrrrr$r%r&r6r:r<r=r?r@r>rFrGrHrr rrLs*2h  $ v 'Z##CCSCC 1&c? /7t    (##CCSCC 7(&"""0 f    r