mirror of
https://github.com/python/cpython.git
synced 2025-10-20 21:52:10 +00:00
b482538523
Currently, we only use per-thread reference counting for heap type objects and the naming reflects that. We will extend it to a few additional types in an upcoming change to avoid scaling bottlenecks when creating nested functions. Rename some of the files and functions in preparation for this change.
72 lines
2.3 KiB
C
72 lines
2.3 KiB
C
#ifndef Py_INTERNAL_UNIQUEID_H
|
|
#define Py_INTERNAL_UNIQUEID_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef Py_BUILD_CORE
|
|
# error "this header requires Py_BUILD_CORE define"
|
|
#endif
|
|
|
|
#ifdef Py_GIL_DISABLED
|
|
|
|
// This contains code for allocating unique ids to objects for per-thread
|
|
// reference counting.
|
|
//
|
|
// Per-thread reference counting is used along with deferred reference
|
|
// counting to avoid scaling bottlenecks due to reference count contention.
|
|
//
|
|
// An id of -1 is used to indicate that an object doesn't use per-thread
|
|
// refcounting. This value is used when the object is finalized by the GC
|
|
// and during interpreter shutdown to allow the object to be
|
|
// deallocated promptly when the object's refcount reaches zero.
|
|
//
|
|
// Each entry implicitly represents a unique id based on its offset in the
|
|
// table. Non-allocated entries form a free-list via the 'next' pointer.
|
|
// Allocated entries store the corresponding PyObject.
|
|
typedef union _Py_unique_id_entry {
|
|
// Points to the next free type id, when part of the freelist
|
|
union _Py_unique_id_entry *next;
|
|
|
|
// Stores the object when the id is assigned
|
|
PyObject *obj;
|
|
} _Py_unique_id_entry;
|
|
|
|
struct _Py_unique_id_pool {
|
|
PyMutex mutex;
|
|
|
|
// combined table of object with allocated unique ids and unallocated ids.
|
|
_Py_unique_id_entry *table;
|
|
|
|
// Next entry to allocate inside 'table' or NULL
|
|
_Py_unique_id_entry *freelist;
|
|
|
|
// size of 'table'
|
|
Py_ssize_t size;
|
|
};
|
|
|
|
// Assigns the next id from the pool of ids.
|
|
extern Py_ssize_t _PyObject_AssignUniqueId(PyObject *obj);
|
|
|
|
// Releases the allocated id back to the pool.
|
|
extern void _PyObject_ReleaseUniqueId(Py_ssize_t unique_id);
|
|
|
|
// Merges the per-thread reference counts into the corresponding objects.
|
|
extern void _PyObject_MergePerThreadRefcounts(_PyThreadStateImpl *tstate);
|
|
|
|
// Like _PyObject_MergePerThreadRefcounts, but also frees the per-thread
|
|
// array of refcounts.
|
|
extern void _PyObject_FinalizePerThreadRefcounts(_PyThreadStateImpl *tstate);
|
|
|
|
// Frees the interpreter's pool of type ids.
|
|
extern void _PyObject_FinalizeUniqueIdPool(PyInterpreterState *interp);
|
|
|
|
// Increfs the type, resizing the per-thread refcount array if necessary.
|
|
PyAPI_FUNC(void) _PyType_IncrefSlow(PyHeapTypeObject *type);
|
|
|
|
#endif /* Py_GIL_DISABLED */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_INTERNAL_UNIQUEID_H */
|