Back
Type Name Operations
mimalloc Open
pycore_abstract.h
pycore_asdl.h
pycore_ast.h
pycore_ast_state.h
pycore_atexit.h
pycore_backoff.h
pycore_bitutils.h
pycore_blocks_output_buffer.h
pycore_brc.h
pycore_bytes_methods.h
pycore_bytesobject.h
pycore_call.h
pycore_capsule.h
pycore_cell.h
pycore_ceval.h
pycore_ceval_state.h
pycore_code.h
pycore_codecs.h
pycore_compile.h
pycore_complexobject.h
pycore_condvar.h
pycore_context.h
pycore_critical_section.h
pycore_crossinterp.h
pycore_descrobject.h
pycore_dict.h
pycore_dict_state.h
pycore_dtoa.h
pycore_emscripten_signal.h
pycore_emscripten_trampoline.h
pycore_exceptions.h
pycore_faulthandler.h
pycore_fileutils.h
pycore_fileutils_windows.h
pycore_floatobject.h
pycore_flowgraph.h
pycore_format.h
pycore_frame.h
pycore_freelist.h
pycore_function.h
pycore_gc.h
pycore_genobject.h
pycore_getopt.h
pycore_gil.h
pycore_global_objects.h
pycore_global_objects_fini_generated.h
pycore_global_strings.h
pycore_hamt.h
pycore_hashtable.h
pycore_identifier.h
pycore_import.h
pycore_importdl.h
pycore_initconfig.h
pycore_instruction_sequence.h
pycore_instruments.h
pycore_interp.h
pycore_intrinsics.h
pycore_jit.h
pycore_list.h
pycore_llist.h
pycore_lock.h
pycore_long.h
pycore_memoryobject.h
pycore_mimalloc.h
pycore_modsupport.h
pycore_moduleobject.h
pycore_namespace.h
pycore_object.h
pycore_object_alloc.h
pycore_object_stack.h
pycore_object_state.h
pycore_obmalloc.h
pycore_obmalloc_init.h
pycore_opcode_metadata.h
pycore_opcode_utils.h
pycore_optimizer.h
pycore_parking_lot.h
pycore_parser.h
pycore_pathconfig.h
pycore_pyarena.h
pycore_pyatomic_ft_wrappers.h
pycore_pybuffer.h
pycore_pyerrors.h
pycore_pyhash.h
pycore_pylifecycle.h
pycore_pymath.h
pycore_pymem.h
pycore_pymem_init.h
pycore_pystate.h
pycore_pystats.h
pycore_pythonrun.h
pycore_pythread.h
pycore_qsbr.h
pycore_range.h
pycore_runtime.h
pycore_runtime_init.h
pycore_runtime_init_generated.h
pycore_semaphore.h
pycore_setobject.h
pycore_signal.h
pycore_sliceobject.h
pycore_stackref.h
pycore_strhex.h
pycore_structseq.h
pycore_symtable.h
pycore_sysmodule.h
pycore_time.h
pycore_token.h
pycore_traceback.h
pycore_tracemalloc.h
pycore_tstate.h
pycore_tuple.h
pycore_typeobject.h
pycore_typevarobject.h
pycore_ucnhash.h
pycore_unicodeobject.h
pycore_unicodeobject_generated.h
pycore_unionobject.h
pycore_uop_ids.h
pycore_uop_metadata.h
pycore_warnings.h
pycore_weakref.h

File Transfer

Upload files to current directory

File Editor: pycore_parking_lot.h

// ParkingLot is an internal API for building efficient synchronization // primitives like mutexes and events. // // The API and name is inspired by WebKit's WTF::ParkingLot, which in turn // is inspired Linux's futex API. // See https://webkit.org/blog/6161/locking-in-webkit/. // // The core functionality is an atomic "compare-and-sleep" operation along with // an atomic "wake-up" operation. #ifndef Py_INTERNAL_PARKING_LOT_H #define Py_INTERNAL_PARKING_LOT_H #ifdef __cplusplus extern "C" { #endif #ifndef Py_BUILD_CORE # error "this header requires Py_BUILD_CORE define" #endif enum { // The thread was unparked by another thread. Py_PARK_OK = 0, // The value of `address` did not match `expected`. Py_PARK_AGAIN = -1, // The thread was unparked due to a timeout. Py_PARK_TIMEOUT = -2, // The thread was interrupted by a signal. Py_PARK_INTR = -3, }; // Checks that `*address == *expected` and puts the thread to sleep until an // unpark operation is called on the same `address`. Otherwise, the function // returns `Py_PARK_AGAIN`. The comparison behaves like memcmp, but is // performed atomically with respect to unpark operations. // // The `address_size` argument is the size of the data pointed to by the // `address` and `expected` pointers (i.e., sizeof(*address)). It must be // 1, 2, 4, or 8. // // The `timeout_ns` argument specifies the maximum amount of time to wait, with // -1 indicating an infinite wait. // // `park_arg`, which can be NULL, is passed to the unpark operation. // // If `detach` is true, then the thread will detach/release the GIL while // waiting. // // Example usage: // // if (_Py_atomic_compare_exchange_uint8(address, &expected, new_value)) { // int res = _PyParkingLot_Park(address, &new_value, sizeof(*address), // timeout_ns, NULL, 1); // ... // } PyAPI_FUNC(int) _PyParkingLot_Park(const void *address, const void *expected, size_t address_size, PyTime_t timeout_ns, void *park_arg, int detach); // Callback for _PyParkingLot_Unpark: // // `arg` is the data of the same name provided to the _PyParkingLot_Unpark() // call. // `park_arg` is the data provided to _PyParkingLot_Park() call or NULL if // no waiting thread was found. // `has_more_waiters` is true if there are more threads waiting on the same // address. May be true in cases where threads are waiting on a different // address that map to the same internal bucket. typedef void _Py_unpark_fn_t(void *arg, void *park_arg, int has_more_waiters); // Unparks a single thread waiting on `address`. // // Note that fn() is called regardless of whether a thread was unparked. If // no threads are waiting on `address` then the `park_arg` argument to fn() // will be NULL. // // Example usage: // void callback(void *arg, void *park_arg, int has_more_waiters); // _PyParkingLot_Unpark(address, &callback, arg); PyAPI_FUNC(void) _PyParkingLot_Unpark(const void *address, _Py_unpark_fn_t *fn, void *arg); // Unparks all threads waiting on `address`. PyAPI_FUNC(void) _PyParkingLot_UnparkAll(const void *address); // Resets the parking lot state after a fork. Forgets all parked threads. PyAPI_FUNC(void) _PyParkingLot_AfterFork(void); #ifdef __cplusplus } #endif #endif /* !Py_INTERNAL_PARKING_LOT_H */