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_qsbr.h (5524B)

// The QSBR APIs (quiescent state-based reclamation) provide a mechanism for
// the free-threaded build to safely reclaim memory when there may be
// concurrent accesses.
//
// Many operations in the free-threaded build are protected by locks. However,
// in some cases, we want to allow reads to happen concurrently with updates.
// In this case, we need to delay freeing ("reclaiming") any memory that may be
// concurrently accessed by a reader. The QSBR APIs provide a way to do this.
#ifndef Py_INTERNAL_QSBR_H
#define Py_INTERNAL_QSBR_H

#include <stdbool.h>
#include <stdint.h>
#include "pycore_lock.h"        // PyMutex

#ifdef __cplusplus
extern "C" {
#endif

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

// The shared write sequence is always odd and incremented by two. Detached
// threads are indicated by a read sequence of zero. This avoids collisions
// between the offline state and any valid sequence number even if the
// sequences numbers wrap around.
#define QSBR_OFFLINE 0
#define QSBR_INITIAL 1
#define QSBR_INCR    2

// Wrap-around safe comparison. This is a holdover from the FreeBSD
// implementation, which uses 32-bit sequence numbers. We currently use 64-bit
// sequence numbers, so wrap-around is unlikely.
#define QSBR_LT(a, b) ((int64_t)((a)-(b)) < 0)
#define QSBR_LEQ(a, b) ((int64_t)((a)-(b)) <= 0)

struct _qsbr_shared;
struct _PyThreadStateImpl;  // forward declare to avoid circular dependency

// Per-thread state
struct _qsbr_thread_state {
    // Last observed write sequence (or 0 if detached)
    uint64_t seq;

// Shared (per-interpreter) QSBR state
    struct _qsbr_shared *shared;

// Thread state (or NULL)
    PyThreadState *tstate;

// Number of held items added by this thread since the last write sequence
    // advance
    int deferred_count;

// Estimate for the amount of memory that is held by this thread since
    // the last write sequence advance
    size_t deferred_memory;

// Amount of memory in mimalloc pages deferred from collection.  When
    // deferred, they are prevented from being used for a different size class
    // and in a different thread.
    size_t deferred_page_memory;

// True if the deferred memory frees should be processed.
    bool should_process;

// Is this thread state allocated?
    bool allocated;
    struct _qsbr_thread_state *freelist_next;
};

// Padding to avoid false sharing
struct _qsbr_pad {
    struct _qsbr_thread_state qsbr;
    char __padding[64 - sizeof(struct _qsbr_thread_state)];
};

// Per-interpreter state
struct _qsbr_shared {
    // Write sequence: always odd, incremented by two
    uint64_t wr_seq;

// Minimum observed read sequence of all QSBR thread states
    uint64_t rd_seq;

// Array of QSBR thread states.
    struct _qsbr_pad *array;
    Py_ssize_t size;

// Freelist of unused _qsbr_thread_states (protected by mutex)
    PyMutex mutex;
    struct _qsbr_thread_state *freelist;
};

static inline uint64_t
_Py_qsbr_shared_current(struct _qsbr_shared *shared)
{
    return _Py_atomic_load_uint64_acquire(&shared->wr_seq);
}

// Reports a quiescent state: the caller no longer holds any pointer to shared
// data not protected by locks or reference counts.
static inline void
_Py_qsbr_quiescent_state(struct _qsbr_thread_state *qsbr)
{
    uint64_t seq = _Py_qsbr_shared_current(qsbr->shared);
    _Py_atomic_store_uint64_release(&qsbr->seq, seq);
}

// Have the read sequences advanced to the given goal? Like `_Py_qsbr_poll()`,
// but does not perform a scan of threads.
static inline bool
_Py_qbsr_goal_reached(struct _qsbr_thread_state *qsbr, uint64_t goal)
{
    uint64_t rd_seq = _Py_atomic_load_uint64(&qsbr->shared->rd_seq);
    return QSBR_LEQ(goal, rd_seq);
}

// Advance the write sequence and return the new goal. This should be called
// after data is removed. The returned goal is used with `_Py_qsbr_poll()` to
// determine when it is safe to reclaim (free) the memory.
extern uint64_t
_Py_qsbr_advance(struct _qsbr_shared *shared);

// Return the next value for the write sequence (current plus the increment).
extern uint64_t
_Py_qsbr_shared_next(struct _qsbr_shared *shared);

// Return true if deferred memory frees held by QSBR should be processed to
// determine if they can be safely freed.
static inline bool
_Py_qsbr_should_process(struct _qsbr_thread_state *qsbr)
{
    return qsbr->should_process;
}

// Have the read sequences advanced to the given goal? If this returns true,
// it safe to reclaim any memory tagged with the goal (or earlier goal).
extern bool
_Py_qsbr_poll(struct _qsbr_thread_state *qsbr, uint64_t goal);

// Called when thread attaches to interpreter
extern void
_Py_qsbr_attach(struct _qsbr_thread_state *qsbr);

// Called when thread detaches from interpreter
extern void
_Py_qsbr_detach(struct _qsbr_thread_state *qsbr);

// Reserves (allocates) a QSBR state and returns its index.
extern Py_ssize_t
_Py_qsbr_reserve(PyInterpreterState *interp);

// Associates a PyThreadState with the QSBR state at the given index
extern void
_Py_qsbr_register(struct _PyThreadStateImpl *tstate,
                  PyInterpreterState *interp, Py_ssize_t index);

// Disassociates a PyThreadState from the QSBR state and frees the QSBR state.
extern void
_Py_qsbr_unregister(PyThreadState *tstate);

extern void
_Py_qsbr_fini(PyInterpreterState *interp);

extern void
_Py_qsbr_after_fork(struct _PyThreadStateImpl *tstate);

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

cmd: