FM / internal

/opt/imh/python3.13/include/python3.13/internal/

/opt/imh/python3.13/include/python3.13/internal

Name	Size	Mode	Actions
mimalloc/	-	0755	rm
pycore_abstract.h	1915	0644	edit dl rm
pycore_asdl.h	3035	0644	edit dl rm
pycore_ast.h	31520	0644	edit dl rm
pycore_ast_state.h	6779	0644	edit dl rm
pycore_atexit.h	1433	0644	edit dl rm
pycore_backoff.h	3902	0644	edit dl rm
pycore_bitutils.h	6026	0644	edit dl rm
pycore_blocks_output_buffer.h	8772	0644	edit dl rm
pycore_brc.h	2102	0644	edit dl rm
pycore_bytesobject.h	5099	0644	edit dl rm
pycore_bytes_methods.h	3933	0644	edit dl rm
pycore_call.h	6135	0644	edit dl rm
pycore_capsule.h	397	0644	edit dl rm
pycore_cell.h	1057	0644	edit dl rm
pycore_ceval.h	11162	0644	edit dl rm
pycore_ceval_state.h	3921	0644	edit dl rm
pycore_code.h	19864	0644	edit dl rm
pycore_codecs.h	2465	0644	edit dl rm
pycore_compile.h	3750	0644	edit dl rm
pycore_complexobject.h	588	0644	edit dl rm
pycore_condvar.h	2704	0644	edit dl rm
pycore_context.h	1182	0644	edit dl rm
pycore_critical_section.h	7968	0644	edit dl rm
pycore_crossinterp.h	12128	0644	edit dl rm
pycore_descrobject.h	543	0644	edit dl rm
pycore_dict.h	12264	0644	edit dl rm
pycore_dict_state.h	732	0644	edit dl rm
pycore_dtoa.h	1727	0644	edit dl rm
pycore_emscripten_signal.h	685	0644	edit dl rm
pycore_emscripten_trampoline.h	3180	0644	edit dl rm
pycore_exceptions.h	900	0644	edit dl rm
pycore_faulthandler.h	2245	0644	edit dl rm
pycore_fileutils.h	9468	0644	edit dl rm
pycore_fileutils_windows.h	2713	0644	edit dl rm
pycore_floatobject.h	1495	0644	edit dl rm
pycore_flowgraph.h	1489	0644	edit dl rm
pycore_format.h	480	0644	edit dl rm
pycore_frame.h	10875	0644	edit dl rm
pycore_freelist.h	4810	0644	edit dl rm
pycore_function.h	1538	0644	edit dl rm
pycore_gc.h	12967	0644	edit dl rm
pycore_genobject.h	859	0644	edit dl rm
pycore_getopt.h	490	0644	edit dl rm
pycore_gil.h	2196	0644	edit dl rm
pycore_global_objects.h	3090	0644	edit dl rm
pycore_global_objects_fini_generated.h	117804	0644	edit dl rm
pycore_global_strings.h	26706	0644	edit dl rm
pycore_hamt.h	3742	0644	edit dl rm
pycore_hashtable.h	4361	0644	edit dl rm
pycore_identifier.h	515	0644	edit dl rm
pycore_import.h	7731	0644	edit dl rm
pycore_importdl.h	4055	0644	edit dl rm
pycore_initconfig.h	6375	0644	edit dl rm
pycore_instruction_sequence.h	2161	0644	edit dl rm
pycore_instruments.h	2331	0644	edit dl rm
pycore_interp.h	15063	0644	edit dl rm
pycore_intrinsics.h	1756	0644	edit dl rm
pycore_jit.h	527	0644	edit dl rm
pycore_list.h	1859	0644	edit dl rm
pycore_llist.h	2420	0644	edit dl rm
pycore_lock.h	8538	0644	edit dl rm
pycore_long.h	9966	0644	edit dl rm
pycore_memoryobject.h	427	0644	edit dl rm
pycore_mimalloc.h	1637	0644	edit dl rm
pycore_modsupport.h	3351	0644	edit dl rm
pycore_moduleobject.h	1572	0644	edit dl rm
pycore_namespace.h	435	0644	edit dl rm
pycore_object.h	27936	0644	edit dl rm
pycore_object_alloc.h	2176	0644	edit dl rm
pycore_object_stack.h	2384	0644	edit dl rm
pycore_object_state.h	942	0644	edit dl rm
pycore_obmalloc.h	27418	0644	edit dl rm
pycore_obmalloc_init.h	1935	0644	edit dl rm
pycore_opcode_metadata.h	84722	0644	edit dl rm
pycore_opcode_utils.h	2122	0644	edit dl rm
pycore_optimizer.h	8303	0644	edit dl rm
pycore_parking_lot.h	3351	0644	edit dl rm
pycore_parser.h	2089	0644	edit dl rm
pycore_pathconfig.h	658	0644	edit dl rm
pycore_pyarena.h	2862	0644	edit dl rm
pycore_pyatomic_ft_wrappers.h	8056	0644	edit dl rm
pycore_pybuffer.h	510	0644	edit dl rm
pycore_pyerrors.h	4960	0644	edit dl rm
pycore_pyhash.h	2813	0644	edit dl rm
pycore_pylifecycle.h	4465	0644	edit dl rm
pycore_pymath.h	8600	0644	edit dl rm
pycore_pymem.h	4485	0644	edit dl rm
pycore_pymem_init.h	3520	0644	edit dl rm
pycore_pystate.h	9964	0644	edit dl rm
pycore_pystats.h	420	0644	edit dl rm
pycore_pythonrun.h	758	0644	edit dl rm
pycore_pythread.h	5431	0644	edit dl rm
pycore_qsbr.h	5524	0644	edit dl rm
pycore_range.h	346	0644	edit dl rm
pycore_runtime.h	13165	0644	edit dl rm
pycore_runtime_init.h	13045	0644	edit dl rm
pycore_runtime_init_generated.h	46820	0644	edit dl rm
pycore_semaphore.h	1731	0644	edit dl rm
pycore_setobject.h	951	0644	edit dl rm
pycore_signal.h	2931	0644	edit dl rm
pycore_sliceobject.h	369	0644	edit dl rm
pycore_stackref.h	5186	0644	edit dl rm
pycore_strhex.h	1013	0644	edit dl rm
pycore_structseq.h	963	0644	edit dl rm
pycore_symtable.h	8671	0644	edit dl rm
pycore_sysmodule.h	1177	0644	edit dl rm
pycore_time.h	11794	0644	edit dl rm
pycore_token.h	3001	0644	edit dl rm
pycore_traceback.h	3629	0644	edit dl rm
pycore_tracemalloc.h	4533	0644	edit dl rm
pycore_tstate.h	1354	0644	edit dl rm
pycore_tuple.h	820	0644	edit dl rm
pycore_typeobject.h	8877	0644	edit dl rm
pycore_typevarobject.h	924	0644	edit dl rm
pycore_ucnhash.h	958	0644	edit dl rm
pycore_unicodeobject.h	13270	0644	edit dl rm
pycore_unicodeobject_generated.h	132140	0644	edit dl rm
pycore_unionobject.h	742	0644	edit dl rm
pycore_uop_ids.h	10267	0644	edit dl rm
pycore_uop_metadata.h	39469	0644	edit dl rm
pycore_warnings.h	840	0644	edit dl rm
pycore_weakref.h	3889	0644	edit dl rm

Edit: /opt/imh/python3.13/include/python3.13/internal/pycore_lock.h (8538B)

// Lightweight locks and other synchronization mechanisms.
//
// These implementations are based on WebKit's WTF::Lock. See
// https://webkit.org/blog/6161/locking-in-webkit/ for a description of the
// design.
#ifndef Py_INTERNAL_LOCK_H
#define Py_INTERNAL_LOCK_H
#ifdef __cplusplus
extern "C" {
#endif

#ifndef Py_BUILD_CORE
#  error "this header requires Py_BUILD_CORE define"
#endif

//_Py_UNLOCKED is defined as 0 and _Py_LOCKED as 1 in Include/cpython/lock.h
#define _Py_HAS_PARKED  2
#define _Py_ONCE_INITIALIZED 4

static inline int
PyMutex_LockFast(uint8_t *lock_bits)
{
    uint8_t expected = _Py_UNLOCKED;
    return _Py_atomic_compare_exchange_uint8(lock_bits, &expected, _Py_LOCKED);
}

// Checks if the mutex is currently locked.
static inline int
PyMutex_IsLocked(PyMutex *m)
{
    return (_Py_atomic_load_uint8(&m->_bits) & _Py_LOCKED) != 0;
}

// Re-initializes the mutex after a fork to the unlocked state.
static inline void
_PyMutex_at_fork_reinit(PyMutex *m)
{
    memset(m, 0, sizeof(*m));
}

typedef enum _PyLockFlags {
    // Do not detach/release the GIL when waiting on the lock.
    _Py_LOCK_DONT_DETACH = 0,

// Detach/release the GIL while waiting on the lock.
    _PY_LOCK_DETACH = 1,

// Handle signals if interrupted while waiting on the lock.
    _PY_LOCK_HANDLE_SIGNALS = 2,
} _PyLockFlags;

// Lock a mutex with an optional timeout and additional options. See
// _PyLockFlags for details.
extern PyLockStatus
_PyMutex_LockTimed(PyMutex *m, PyTime_t timeout_ns, _PyLockFlags flags);

// Lock a mutex with aditional options. See _PyLockFlags for details.
static inline void
PyMutex_LockFlags(PyMutex *m, _PyLockFlags flags)
{
    uint8_t expected = _Py_UNLOCKED;
    if (!_Py_atomic_compare_exchange_uint8(&m->_bits, &expected, _Py_LOCKED)) {
        _PyMutex_LockTimed(m, -1, flags);
    }
}

// Unlock a mutex, returns 0 if the mutex is not locked (used for improved
// error messages).
extern int _PyMutex_TryUnlock(PyMutex *m);

// PyEvent is a one-time event notification
typedef struct {
    uint8_t v;
} PyEvent;

// Check if the event is set without blocking. Returns 1 if the event is set or
// 0 otherwise.
PyAPI_FUNC(int) _PyEvent_IsSet(PyEvent *evt);

// Set the event and notify any waiting threads.
// Export for '_testinternalcapi' shared extension
PyAPI_FUNC(void) _PyEvent_Notify(PyEvent *evt);

// Wait for the event to be set. If the event is already set, then this returns
// immediately.
PyAPI_FUNC(void) PyEvent_Wait(PyEvent *evt);

// Wait for the event to be set, or until the timeout expires. If the event is
// already set, then this returns immediately. Returns 1 if the event was set,
// and 0 if the timeout expired or thread was interrupted. If `detach` is
// true, then the thread will detach/release the GIL while waiting.
PyAPI_FUNC(int)
PyEvent_WaitTimed(PyEvent *evt, PyTime_t timeout_ns, int detach);

// _PyRawMutex implements a word-sized mutex that that does not depend on the
// parking lot API, and therefore can be used in the parking lot
// implementation.
//
// The mutex uses a packed representation: the least significant bit is used to
// indicate whether the mutex is locked or not. The remaining bits are either
// zero or a pointer to a `struct raw_mutex_entry` (see lock.c).
typedef struct {
    uintptr_t v;
} _PyRawMutex;

// Slow paths for lock/unlock
extern void _PyRawMutex_LockSlow(_PyRawMutex *m);
extern void _PyRawMutex_UnlockSlow(_PyRawMutex *m);

static inline void
_PyRawMutex_Lock(_PyRawMutex *m)
{
    uintptr_t unlocked = _Py_UNLOCKED;
    if (_Py_atomic_compare_exchange_uintptr(&m->v, &unlocked, _Py_LOCKED)) {
        return;
    }
    _PyRawMutex_LockSlow(m);
}

static inline void
_PyRawMutex_Unlock(_PyRawMutex *m)
{
    uintptr_t locked = _Py_LOCKED;
    if (_Py_atomic_compare_exchange_uintptr(&m->v, &locked, _Py_UNLOCKED)) {
        return;
    }
    _PyRawMutex_UnlockSlow(m);
}

// Type signature for one-time initialization functions. The function should
// return 0 on success and -1 on failure.
typedef int _Py_once_fn_t(void *arg);

// (private) slow path for one time initialization
PyAPI_FUNC(int)
_PyOnceFlag_CallOnceSlow(_PyOnceFlag *flag, _Py_once_fn_t *fn, void *arg);

// Calls `fn` once using `flag`. The `arg` is passed to the call to `fn`.
//
// Returns 0 on success and -1 on failure.
//
// If `fn` returns 0 (success), then subsequent calls immediately return 0.
// If `fn` returns -1 (failure), then subsequent calls will retry the call.
static inline int
_PyOnceFlag_CallOnce(_PyOnceFlag *flag, _Py_once_fn_t *fn, void *arg)
{
    if (_Py_atomic_load_uint8(&flag->v) == _Py_ONCE_INITIALIZED) {
        return 0;
    }
    return _PyOnceFlag_CallOnceSlow(flag, fn, arg);
}

// A recursive mutex. The mutex should zero-initialized.
typedef struct {
    PyMutex mutex;
    unsigned long long thread;  // i.e., PyThread_get_thread_ident_ex()
    size_t level;
} _PyRecursiveMutex;

PyAPI_FUNC(int) _PyRecursiveMutex_IsLockedByCurrentThread(_PyRecursiveMutex *m);
PyAPI_FUNC(void) _PyRecursiveMutex_Lock(_PyRecursiveMutex *m);
PyAPI_FUNC(void) _PyRecursiveMutex_Unlock(_PyRecursiveMutex *m);

// A readers-writer (RW) lock. The lock supports multiple concurrent readers or
// a single writer. The lock is write-preferring: if a writer is waiting while
// the lock is read-locked then, new readers will be blocked. This avoids
// starvation of writers.
//
// In C++, the equivalent synchronization primitive is std::shared_mutex
// with shared ("read") and exclusive ("write") locking.
//
// The two least significant bits are used to indicate if the lock is
// write-locked and if there are parked threads (either readers or writers)
// waiting to acquire the lock. The remaining bits are used to indicate the
// number of readers holding the lock.
//
// 0b000..00000: unlocked
// 0bnnn..nnn00: nnn..nnn readers holding the lock
// 0bnnn..nnn10: nnn..nnn readers holding the lock and a writer is waiting
// 0b00000..010: unlocked with awoken writer about to acquire lock
// 0b00000..001: write-locked
// 0b00000..011: write-locked and readers or other writers are waiting
//
// Note that reader_count must be zero if the lock is held by a writer, and
// vice versa. The lock can only be held by readers or a writer, but not both.
//
// The design is optimized for simplicity of the implementation. The lock is
// not fair: if fairness is desired, use an additional PyMutex to serialize
// writers. The lock is also not reentrant.
typedef struct {
    uintptr_t bits;
} _PyRWMutex;

// Read lock (i.e., shared lock)
PyAPI_FUNC(void) _PyRWMutex_RLock(_PyRWMutex *rwmutex);
PyAPI_FUNC(void) _PyRWMutex_RUnlock(_PyRWMutex *rwmutex);

// Write lock (i.e., exclusive lock)
PyAPI_FUNC(void) _PyRWMutex_Lock(_PyRWMutex *rwmutex);
PyAPI_FUNC(void) _PyRWMutex_Unlock(_PyRWMutex *rwmutex);

// Similar to linux seqlock: https://en.wikipedia.org/wiki/Seqlock
// We use a sequence number to lock the writer, an even sequence means we're unlocked, an odd
// sequence means we're locked.  Readers will read the sequence before attempting to read the
// underlying data and then read the sequence number again after reading the data.  If the
// sequence has not changed the data is valid.
//
// Differs a little bit in that we use CAS on sequence as the lock, instead of a separate spin lock.
// The writer can also detect that the undelering data has not changed and abandon the write
// and restore the previous sequence.
typedef struct {
    uint32_t sequence;
} _PySeqLock;

// Lock the sequence lock for the writer
PyAPI_FUNC(void) _PySeqLock_LockWrite(_PySeqLock *seqlock);

// Unlock the sequence lock and move to the next sequence number.
PyAPI_FUNC(void) _PySeqLock_UnlockWrite(_PySeqLock *seqlock);

// Abandon the current update indicating that no mutations have occurred
// and restore the previous sequence value.
PyAPI_FUNC(void) _PySeqLock_AbandonWrite(_PySeqLock *seqlock);

// Begin a read operation and return the current sequence number.
PyAPI_FUNC(uint32_t) _PySeqLock_BeginRead(_PySeqLock *seqlock);

// End the read operation and confirm that the sequence number has not changed.
// Returns 1 if the read was successful or 0 if the read should be retried.
PyAPI_FUNC(int) _PySeqLock_EndRead(_PySeqLock *seqlock, uint32_t previous);

// Check if the lock was held during a fork and clear the lock.  Returns 1
// if the lock was held and any associated data should be cleared.
PyAPI_FUNC(int) _PySeqLock_AfterFork(_PySeqLock *seqlock);

#ifdef __cplusplus
}
#endif
#endif   /* !Py_INTERNAL_LOCK_H */

cmd: