Debian Codegraph @

Include/internal/pycore_tstate.h

raw
1 #ifndef Py_INTERNAL_TSTATE_H
2 #define Py_INTERNAL_TSTATE_H
3 #ifdef __cplusplus
4 extern "C" {
5 #endif
6
7 #ifndef Py_BUILD_CORE
8 # error "this header requires Py_BUILD_CORE define"
9 #endif
10
11 #include "pycore_brc.h" // struct _brc_thread_state
12 #include "pycore_freelist_state.h" // struct _Py_freelists
13 #include "pycore_mimalloc.h" // struct _mimalloc_thread_state
14 #include "pycore_qsbr.h" // struct qsbr
15
16
17 #ifdef Py_GIL_DISABLED
18 struct _gc_thread_state {
19 /* Thread-local allocation count. */
20 Py_ssize_t alloc_count;
21 };
22 #endif
23
24 // Every PyThreadState is actually allocated as a _PyThreadStateImpl. The
25 // PyThreadState fields are exposed as part of the C API, although most fields
26 // are intended to be private. The _PyThreadStateImpl fields not exposed.
27 typedef struct _PyThreadStateImpl {
28 // semi-public fields are in PyThreadState.
29 PyThreadState base;
30
31 // The reference count field is used to synchronize deallocation of the
32 // thread state during runtime finalization.
33 Py_ssize_t refcount;
34
35 // These are addresses, but we need to convert to ints to avoid UB.
36 uintptr_t c_stack_top;
37 uintptr_t c_stack_soft_limit;
38 uintptr_t c_stack_hard_limit;
39
40 PyObject *asyncio_running_loop; // Strong reference
41 PyObject *asyncio_running_task; // Strong reference
42
43 /* Head of circular linked-list of all tasks which are instances of `asyncio.Task`
44 or subclasses of it used in `asyncio.all_tasks`.
45 */
46 struct llist_node asyncio_tasks_head;
47 struct _qsbr_thread_state *qsbr; // only used by free-threaded build
48 struct llist_node mem_free_queue; // delayed free queue
49
50 #ifdef Py_GIL_DISABLED
51 // Stack references for the current thread that exist on the C stack
52 struct _PyCStackRef *c_stack_refs;
53 struct _gc_thread_state gc;
54 struct _mimalloc_thread_state mimalloc;
55 struct _Py_freelists freelists;
56 struct _brc_thread_state brc;
57 struct {
58 // The per-thread refcounts
59 Py_ssize_t *values;
60
61 // Size of the refcounts array.
62 Py_ssize_t size;
63
64 // If set, don't use per-thread refcounts
65 int is_finalized;
66 } refcounts;
67
68 // Index to use to retrieve thread-local bytecode for this thread
69 int32_t tlbc_index;
70
71 // When >1, code objects do not immortalize their non-string constants.
72 int suppress_co_const_immortalization;
73 #endif
74
75 #if defined(Py_REF_DEBUG) && defined(Py_GIL_DISABLED)
76 Py_ssize_t reftotal; // this thread's total refcount operations
77 #endif
78
79 // PyUnstable_ThreadState_ResetStackProtection() values
80 uintptr_t c_stack_init_base;
81 uintptr_t c_stack_init_top;
82
83 #ifdef Py_GIL_DISABLED
84 // gh-144438: Add padding to ensure that the fields above don't share a
85 // cache line with other allocations.
86 char __padding[64];
87 #endif
88 } _PyThreadStateImpl;
89
90 #ifdef __cplusplus
91 }
92 #endif
93 #endif /* !Py_INTERNAL_TSTATE_H */