.. versionadded:: 3.13
* :samp:`-X gil={0,1}` forces the GIL to be disabled or enabled,
- respectively. Only available in builds configured with
+ respectively. Setting to ``0`` is only available in builds configured with
:option:`--disable-gil`. See also :envvar:`PYTHON_GIL` and
:ref:`whatsnew313-free-threaded-cpython`.
.. envvar:: PYTHON_GIL
If this variable is set to ``1``, the global interpreter lock (GIL) will be
- forced on. Setting it to ``0`` forces the GIL off.
+ forced on. Setting it to ``0`` forces the GIL off (needs Python configured with
+ the :option:`--disable-gil` build option).
See also the :option:`-X gil <-X>` command-line option, which takes
precedence over this variable, and :ref:`whatsnew313-free-threaded-cpython`.
- Needs Python configured with the :option:`--disable-gil` build option.
-
.. versionadded:: 3.13
Debug-mode variables
static PyStatus
config_read_gil(PyConfig *config, size_t len, wchar_t first_char)
{
-#ifdef Py_GIL_DISABLED
if (len == 1 && first_char == L'0') {
+#ifdef Py_GIL_DISABLED
config->enable_gil = _PyConfig_GIL_DISABLE;
+#else
+ return _PyStatus_ERR("Disabling the GIL is not supported by this build");
+#endif
}
else if (len == 1 && first_char == L'1') {
+#ifdef Py_GIL_DISABLED
config->enable_gil = _PyConfig_GIL_ENABLE;
+#else
+ return _PyStatus_OK();
+#endif
}
else {
return _PyStatus_ERR("PYTHON_GIL / -X gil must be \"0\" or \"1\"");
}
return _PyStatus_OK();
-#else
- return _PyStatus_ERR("PYTHON_GIL / -X gil are not supported by this build");
-#endif
}
static PyStatus