Gecko [ bankpromax.com ]

Name	Size	Permission
mimalloc	[ DIR ]	drwxr-xr-x
pycore_abstract.h	1.87 KB	-rw-r--r--
pycore_asdl.h	2.96 KB	-rw-r--r--
pycore_ast.h	30.78 KB	-rw-r--r--
pycore_ast_state.h	6.62 KB	-rw-r--r--
pycore_atexit.h	1.4 KB	-rw-r--r--
pycore_backoff.h	3.81 KB	-rw-r--r--
pycore_bitutils.h	5.88 KB	-rw-r--r--
pycore_blocks_output_buffer.h	8.57 KB	-rw-r--r--
pycore_brc.h	2.05 KB	-rw-r--r--
pycore_bytes_methods.h	3.84 KB	-rw-r--r--
pycore_bytesobject.h	4.75 KB	-rw-r--r--
pycore_call.h	5.99 KB	-rw-r--r--
pycore_capsule.h	397 B	-rw-r--r--
pycore_cell.h	1.03 KB	-rw-r--r--
pycore_ceval.h	10.9 KB	-rw-r--r--
pycore_ceval_state.h	3.83 KB	-rw-r--r--
pycore_code.h	19.4 KB	-rw-r--r--
pycore_codecs.h	2.41 KB	-rw-r--r--
pycore_compile.h	3.66 KB	-rw-r--r--
pycore_complexobject.h	588 B	-rw-r--r--
pycore_condvar.h	2.64 KB	-rw-r--r--
pycore_context.h	1.15 KB	-rw-r--r--
pycore_critical_section.h	7.78 KB	-rw-r--r--
pycore_crossinterp.h	11.84 KB	-rw-r--r--
pycore_descrobject.h	543 B	-rw-r--r--
pycore_dict.h	11.98 KB	-rw-r--r--
pycore_dict_state.h	732 B	-rw-r--r--
pycore_dtoa.h	1.69 KB	-rw-r--r--
pycore_emscripten_signal.h	685 B	-rw-r--r--
pycore_emscripten_trampoline.h	3.11 KB	-rw-r--r--
pycore_exceptions.h	900 B	-rw-r--r--
pycore_faulthandler.h	2.19 KB	-rw-r--r--
pycore_fileutils.h	9.25 KB	-rw-r--r--
pycore_fileutils_windows.h	2.65 KB	-rw-r--r--
pycore_floatobject.h	1.46 KB	-rw-r--r--
pycore_flowgraph.h	1.45 KB	-rw-r--r--
pycore_format.h	480 B	-rw-r--r--
pycore_frame.h	10.62 KB	-rw-r--r--
pycore_freelist.h	4.7 KB	-rw-r--r--
pycore_function.h	1.5 KB	-rw-r--r--
pycore_gc.h	12.66 KB	-rw-r--r--
pycore_genobject.h	859 B	-rw-r--r--
pycore_getopt.h	490 B	-rw-r--r--
pycore_gil.h	2.14 KB	-rw-r--r--
pycore_global_objects.h	3.02 KB	-rw-r--r--
pycore_global_objects_fini_gen...	115.04 KB	-rw-r--r--
pycore_global_strings.h	26.08 KB	-rw-r--r--
pycore_hamt.h	3.65 KB	-rw-r--r--
pycore_hashtable.h	4.26 KB	-rw-r--r--
pycore_identifier.h	515 B	-rw-r--r--
pycore_import.h	7.55 KB	-rw-r--r--
pycore_importdl.h	3.96 KB	-rw-r--r--
pycore_initconfig.h	6.23 KB	-rw-r--r--
pycore_instruction_sequence.h	2.11 KB	-rw-r--r--
pycore_instruments.h	2.28 KB	-rw-r--r--
pycore_interp.h	14.71 KB	-rw-r--r--
pycore_intrinsics.h	1.71 KB	-rw-r--r--
pycore_jit.h	527 B	-rw-r--r--
pycore_list.h	1.82 KB	-rw-r--r--
pycore_llist.h	2.36 KB	-rw-r--r--
pycore_lock.h	8.34 KB	-rw-r--r--
pycore_long.h	9.73 KB	-rw-r--r--
pycore_memoryobject.h	427 B	-rw-r--r--
pycore_mimalloc.h	1.6 KB	-rw-r--r--
pycore_modsupport.h	3.27 KB	-rw-r--r--
pycore_moduleobject.h	1.54 KB	-rw-r--r--
pycore_namespace.h	435 B	-rw-r--r--
pycore_object.h	26.64 KB	-rw-r--r--
pycore_object_alloc.h	2.13 KB	-rw-r--r--
pycore_object_stack.h	2.33 KB	-rw-r--r--
pycore_object_state.h	942 B	-rw-r--r--
pycore_obmalloc.h	26.78 KB	-rw-r--r--
pycore_obmalloc_init.h	1.89 KB	-rw-r--r--
pycore_opcode_metadata.h	82.74 KB	-rw-r--r--
pycore_opcode_utils.h	2.07 KB	-rw-r--r--
pycore_optimizer.h	8.11 KB	-rw-r--r--
pycore_parking_lot.h	3.27 KB	-rw-r--r--
pycore_parser.h	2.04 KB	-rw-r--r--
pycore_pathconfig.h	658 B	-rw-r--r--
pycore_pyarena.h	2.79 KB	-rw-r--r--
pycore_pyatomic_ft_wrappers.h	7.87 KB	-rw-r--r--
pycore_pybuffer.h	510 B	-rw-r--r--
pycore_pyerrors.h	4.84 KB	-rw-r--r--
pycore_pyhash.h	2.75 KB	-rw-r--r--
pycore_pylifecycle.h	4.36 KB	-rw-r--r--
pycore_pymath.h	8.4 KB	-rw-r--r--
pycore_pymem.h	4.37 KB	-rw-r--r--
pycore_pymem_init.h	3.44 KB	-rw-r--r--
pycore_pystate.h	9.73 KB	-rw-r--r--
pycore_pystats.h	420 B	-rw-r--r--
pycore_pythonrun.h	758 B	-rw-r--r--
pycore_pythread.h	5.3 KB	-rw-r--r--
pycore_qsbr.h	4.81 KB	-rw-r--r--
pycore_range.h	346 B	-rw-r--r--
pycore_runtime.h	12.84 KB	-rw-r--r--
pycore_runtime_init.h	12.74 KB	-rw-r--r--
pycore_runtime_init_generated....	45.72 KB	-rw-r--r--
pycore_semaphore.h	1.69 KB	-rw-r--r--
pycore_setobject.h	951 B	-rw-r--r--
pycore_signal.h	2.86 KB	-rw-r--r--
pycore_sliceobject.h	369 B	-rw-r--r--
pycore_stackref.h	5.06 KB	-rw-r--r--
pycore_strhex.h	1013 B	-rw-r--r--
pycore_structseq.h	963 B	-rw-r--r--
pycore_symtable.h	8.47 KB	-rw-r--r--
pycore_sysmodule.h	1.15 KB	-rw-r--r--
pycore_time.h	11.52 KB	-rw-r--r--
pycore_token.h	2.93 KB	-rw-r--r--
pycore_traceback.h	3.54 KB	-rw-r--r--
pycore_tracemalloc.h	4.43 KB	-rw-r--r--
pycore_tstate.h	1.32 KB	-rw-r--r--
pycore_tuple.h	820 B	-rw-r--r--
pycore_typeobject.h	8.67 KB	-rw-r--r--
pycore_typevarobject.h	924 B	-rw-r--r--
pycore_ucnhash.h	958 B	-rw-r--r--
pycore_unicodeobject.h	12.15 KB	-rw-r--r--
pycore_unicodeobject_generated...	129.04 KB	-rw-r--r--
pycore_unionobject.h	742 B	-rw-r--r--
pycore_uop_ids.h	10.03 KB	-rw-r--r--
pycore_uop_metadata.h	38.54 KB	-rw-r--r--
pycore_warnings.h	840 B	-rw-r--r--
pycore_weakref.h	3.25 KB	-rw-r--r--

Code Editor : pycore_lock.h

// 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 */

${this.title}

Code Editor : pycore_lock.h