mirror of
https://github.com/python/cpython.git
synced 2025-10-31 02:15:10 +00:00
2731913dd5
In free-threaded builds, running with `PYTHON_GIL=0` will now disable the GIL. Follow-up issues track work to re-enable the GIL when loading an incompatible extension, and to disable the GIL by default. In order to support re-enabling the GIL at runtime, all GIL-related data structures are initialized as usual, and disabling the GIL simply sets a flag that causes `take_gil()` and `drop_gil()` to return early.
54 lines
1.7 KiB
C
54 lines
1.7 KiB
C
#ifndef Py_INTERNAL_GIL_H
|
|
#define Py_INTERNAL_GIL_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef Py_BUILD_CORE
|
|
# error "this header requires Py_BUILD_CORE define"
|
|
#endif
|
|
|
|
#include "pycore_condvar.h" // PyCOND_T
|
|
|
|
#ifndef Py_HAVE_CONDVAR
|
|
# error You need either a POSIX-compatible or a Windows system!
|
|
#endif
|
|
|
|
/* Enable if you want to force the switching of threads at least
|
|
every `interval`. */
|
|
#undef FORCE_SWITCHING
|
|
#define FORCE_SWITCHING
|
|
|
|
struct _gil_runtime_state {
|
|
#ifdef Py_GIL_DISABLED
|
|
/* Whether or not this GIL is being used. Can change from 0 to 1 at runtime
|
|
if, for example, a module that requires the GIL is loaded. */
|
|
int enabled;
|
|
#endif
|
|
/* microseconds (the Python API uses seconds, though) */
|
|
unsigned long interval;
|
|
/* Last PyThreadState holding / having held the GIL. This helps us
|
|
know whether anyone else was scheduled after we dropped the GIL. */
|
|
PyThreadState* last_holder;
|
|
/* Whether the GIL is already taken (-1 if uninitialized). This is
|
|
atomic because it can be read without any lock taken in ceval.c. */
|
|
int locked;
|
|
/* Number of GIL switches since the beginning. */
|
|
unsigned long switch_number;
|
|
/* This condition variable allows one or several threads to wait
|
|
until the GIL is released. In addition, the mutex also protects
|
|
the above variables. */
|
|
PyCOND_T cond;
|
|
PyMUTEX_T mutex;
|
|
#ifdef FORCE_SWITCHING
|
|
/* This condition variable helps the GIL-releasing thread wait for
|
|
a GIL-awaiting thread to be scheduled and take the GIL. */
|
|
PyCOND_T switch_cond;
|
|
PyMUTEX_T switch_mutex;
|
|
#endif
|
|
};
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_INTERNAL_GIL_H */
|