blob: f0770727f4de713a9147e27ed9f90ee3f97a9905 [file] [log] [blame]
Nick Coghland6009512014-11-20 21:39:37 +10001/* Python interpreter top-level routines, including init/exit */
2
3#include "Python.h"
4
5#include "Python-ast.h"
Victor Stinner3bb183d2018-11-22 18:38:38 +01006#undef Yield /* undefine macro conflicting with <winbase.h> */
Victor Stinner4f98f462020-04-15 04:01:58 +02007
8#include "pycore_ceval.h" // _PyEval_FiniGIL()
9#include "pycore_context.h" // _PyContext_Init()
10#include "pycore_fileutils.h" // _Py_ResetForceASCII()
Victor Stinnere5014be2020-04-14 17:52:15 +020011#include "pycore_import.h" // _PyImport_Cleanup()
Victor Stinner4f98f462020-04-15 04:01:58 +020012#include "pycore_initconfig.h" // _PyStatus_OK()
13#include "pycore_object.h" // _PyDebug_PrintTotalRefs()
14#include "pycore_pathconfig.h" // _PyConfig_WritePathConfig()
15#include "pycore_pyerrors.h" // _PyErr_Occurred()
16#include "pycore_pylifecycle.h" // _PyErr_Print()
Victor Stinnere5014be2020-04-14 17:52:15 +020017#include "pycore_pystate.h" // _PyThreadState_GET()
Victor Stinner4f98f462020-04-15 04:01:58 +020018#include "pycore_sysmodule.h" // _PySys_ClearAuditHooks()
19#include "pycore_traceback.h" // _Py_DumpTracebackThreads()
20
Victor Stinner4f98f462020-04-15 04:01:58 +020021#include <locale.h> // setlocale()
Nick Coghland6009512014-11-20 21:39:37 +100022
23#ifdef HAVE_SIGNAL_H
Victor Stinner4f98f462020-04-15 04:01:58 +020024# include <signal.h> // SIG_IGN
Nick Coghland6009512014-11-20 21:39:37 +100025#endif
26
27#ifdef HAVE_LANGINFO_H
Victor Stinner4f98f462020-04-15 04:01:58 +020028# include <langinfo.h> // nl_langinfo(CODESET)
Nick Coghland6009512014-11-20 21:39:37 +100029#endif
30
31#ifdef MS_WINDOWS
Victor Stinner4f98f462020-04-15 04:01:58 +020032# undef BYTE
33# include "windows.h"
Steve Dower39294992016-08-30 21:22:36 -070034
Victor Stinner4f98f462020-04-15 04:01:58 +020035 extern PyTypeObject PyWindowsConsoleIO_Type;
36# define PyWindowsConsoleIO_Check(op) \
37 (PyObject_TypeCheck((op), &PyWindowsConsoleIO_Type))
Nick Coghland6009512014-11-20 21:39:37 +100038#endif
39
Victor Stinner4f98f462020-04-15 04:01:58 +020040
Nick Coghland6009512014-11-20 21:39:37 +100041_Py_IDENTIFIER(flush);
42_Py_IDENTIFIER(name);
43_Py_IDENTIFIER(stdin);
44_Py_IDENTIFIER(stdout);
45_Py_IDENTIFIER(stderr);
Eric Snow3f9eee62017-09-15 16:35:20 -060046_Py_IDENTIFIER(threading);
Nick Coghland6009512014-11-20 21:39:37 +100047
48#ifdef __cplusplus
49extern "C" {
50#endif
51
Nick Coghland6009512014-11-20 21:39:37 +100052
Victor Stinnerb45d2592019-06-20 00:05:23 +020053/* Forward declarations */
Victor Stinner331a6a52019-05-27 16:39:22 +020054static PyStatus add_main_module(PyInterpreterState *interp);
Victor Stinnerb45d2592019-06-20 00:05:23 +020055static PyStatus init_import_site(void);
Andy Lester75cd5bf2020-03-12 02:49:05 -050056static PyStatus init_set_builtins_open(void);
Victor Stinnerb45d2592019-06-20 00:05:23 +020057static PyStatus init_sys_streams(PyThreadState *tstate);
58static PyStatus init_signals(PyThreadState *tstate);
59static void call_py_exitfuncs(PyThreadState *tstate);
60static void wait_for_thread_shutdown(PyThreadState *tstate);
Victor Stinner8e91c242019-04-24 17:24:01 +020061static void call_ll_exitfuncs(_PyRuntimeState *runtime);
Nick Coghland6009512014-11-20 21:39:37 +100062
Gregory P. Smith38f11cc2019-02-16 12:57:40 -080063int _Py_UnhandledKeyboardInterrupt = 0;
Victor Stinnerf7e5b562017-11-15 15:48:08 -080064_PyRuntimeState _PyRuntime = _PyRuntimeState_INIT;
Victor Stinnerfd23cfa2019-03-20 00:03:01 +010065static int runtime_initialized = 0;
Eric Snow2ebc5ce2017-09-07 23:51:28 -060066
Victor Stinner331a6a52019-05-27 16:39:22 +020067PyStatus
Eric Snow2ebc5ce2017-09-07 23:51:28 -060068_PyRuntime_Initialize(void)
69{
70 /* XXX We only initialize once in the process, which aligns with
71 the static initialization of the former globals now found in
72 _PyRuntime. However, _PyRuntime *should* be initialized with
73 every Py_Initialize() call, but doing so breaks the runtime.
74 This is because the runtime state is not properly finalized
75 currently. */
Victor Stinnerfd23cfa2019-03-20 00:03:01 +010076 if (runtime_initialized) {
Victor Stinner331a6a52019-05-27 16:39:22 +020077 return _PyStatus_OK();
Victor Stinnerf7e5b562017-11-15 15:48:08 -080078 }
Victor Stinnerfd23cfa2019-03-20 00:03:01 +010079 runtime_initialized = 1;
Victor Stinnerf7e5b562017-11-15 15:48:08 -080080
81 return _PyRuntimeState_Init(&_PyRuntime);
Eric Snow2ebc5ce2017-09-07 23:51:28 -060082}
83
84void
85_PyRuntime_Finalize(void)
86{
87 _PyRuntimeState_Fini(&_PyRuntime);
Victor Stinnerfd23cfa2019-03-20 00:03:01 +010088 runtime_initialized = 0;
Eric Snow2ebc5ce2017-09-07 23:51:28 -060089}
90
91int
92_Py_IsFinalizing(void)
93{
Victor Stinner7b3c2522020-03-07 00:24:23 +010094 return _PyRuntimeState_GetFinalizing(&_PyRuntime) != NULL;
Eric Snow2ebc5ce2017-09-07 23:51:28 -060095}
96
Nick Coghland6009512014-11-20 21:39:37 +100097/* Hack to force loading of object files */
98int (*_PyOS_mystrnicmp_hack)(const char *, const char *, Py_ssize_t) = \
99 PyOS_mystrnicmp; /* Python/pystrcmp.o */
100
101/* PyModule_GetWarningsModule is no longer necessary as of 2.6
102since _warnings is builtin. This API should not be used. */
103PyObject *
104PyModule_GetWarningsModule(void)
105{
106 return PyImport_ImportModule("warnings");
107}
108
Eric Snowc7ec9982017-05-23 23:00:52 -0700109
Eric Snow1abcf672017-05-23 21:46:51 -0700110/* APIs to access the initialization flags
111 *
112 * Can be called prior to Py_Initialize.
113 */
Nick Coghland6009512014-11-20 21:39:37 +1000114
Eric Snow1abcf672017-05-23 21:46:51 -0700115int
116_Py_IsCoreInitialized(void)
117{
Eric Snow2ebc5ce2017-09-07 23:51:28 -0600118 return _PyRuntime.core_initialized;
Eric Snow1abcf672017-05-23 21:46:51 -0700119}
Nick Coghland6009512014-11-20 21:39:37 +1000120
121int
122Py_IsInitialized(void)
123{
Eric Snow2ebc5ce2017-09-07 23:51:28 -0600124 return _PyRuntime.initialized;
Nick Coghland6009512014-11-20 21:39:37 +1000125}
126
Nick Coghlan6ea41862017-06-11 13:16:15 +1000127
Martin Panterb4ce1fc2015-11-30 03:18:29 +0000128/* Global initializations. Can be undone by Py_FinalizeEx(). Don't
129 call this twice without an intervening Py_FinalizeEx() call. When
Nick Coghland6009512014-11-20 21:39:37 +1000130 initializations fail, a fatal error is issued and the function does
131 not return. On return, the first thread and interpreter state have
132 been created.
133
134 Locking: you must hold the interpreter lock while calling this.
135 (If the lock has not yet been initialized, that's equivalent to
136 having the lock, but you cannot use multiple threads.)
137
138*/
139
Victor Stinner331a6a52019-05-27 16:39:22 +0200140static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +0200141init_importlib(PyThreadState *tstate, PyObject *sysmod)
Nick Coghland6009512014-11-20 21:39:37 +1000142{
143 PyObject *importlib;
144 PyObject *impmod;
Nick Coghland6009512014-11-20 21:39:37 +1000145 PyObject *value;
Victor Stinnerb45d2592019-06-20 00:05:23 +0200146 PyInterpreterState *interp = tstate->interp;
Victor Stinnerda7933e2020-04-13 03:04:28 +0200147 int verbose = _PyInterpreterState_GetConfig(interp)->verbose;
Nick Coghland6009512014-11-20 21:39:37 +1000148
149 /* Import _importlib through its frozen version, _frozen_importlib. */
150 if (PyImport_ImportFrozenModule("_frozen_importlib") <= 0) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200151 return _PyStatus_ERR("can't import _frozen_importlib");
Nick Coghland6009512014-11-20 21:39:37 +1000152 }
Victor Stinnerc96be812019-05-14 17:34:56 +0200153 else if (verbose) {
Nick Coghland6009512014-11-20 21:39:37 +1000154 PySys_FormatStderr("import _frozen_importlib # frozen\n");
155 }
156 importlib = PyImport_AddModule("_frozen_importlib");
157 if (importlib == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200158 return _PyStatus_ERR("couldn't get _frozen_importlib from sys.modules");
Nick Coghland6009512014-11-20 21:39:37 +1000159 }
160 interp->importlib = importlib;
161 Py_INCREF(interp->importlib);
162
Serhiy Storchaka133138a2016-08-02 22:51:21 +0300163 interp->import_func = PyDict_GetItemString(interp->builtins, "__import__");
164 if (interp->import_func == NULL)
Victor Stinner331a6a52019-05-27 16:39:22 +0200165 return _PyStatus_ERR("__import__ not found");
Serhiy Storchaka133138a2016-08-02 22:51:21 +0300166 Py_INCREF(interp->import_func);
167
Victor Stinnercd6e6942015-09-18 09:11:57 +0200168 /* Import the _imp module */
Benjamin Petersonc65ef772018-01-29 11:33:57 -0800169 impmod = PyInit__imp();
Nick Coghland6009512014-11-20 21:39:37 +1000170 if (impmod == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200171 return _PyStatus_ERR("can't import _imp");
Nick Coghland6009512014-11-20 21:39:37 +1000172 }
Victor Stinnerc96be812019-05-14 17:34:56 +0200173 else if (verbose) {
Victor Stinnercd6e6942015-09-18 09:11:57 +0200174 PySys_FormatStderr("import _imp # builtin\n");
Nick Coghland6009512014-11-20 21:39:37 +1000175 }
Eric Snow3f9eee62017-09-15 16:35:20 -0600176 if (_PyImport_SetModuleString("_imp", impmod) < 0) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200177 return _PyStatus_ERR("can't save _imp to sys.modules");
Nick Coghland6009512014-11-20 21:39:37 +1000178 }
179
Victor Stinnercd6e6942015-09-18 09:11:57 +0200180 /* Install importlib as the implementation of import */
Nick Coghland6009512014-11-20 21:39:37 +1000181 value = PyObject_CallMethod(importlib, "_install", "OO", sysmod, impmod);
182 if (value == NULL) {
Victor Stinnerb45d2592019-06-20 00:05:23 +0200183 _PyErr_Print(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +0200184 return _PyStatus_ERR("importlib install failed");
Nick Coghland6009512014-11-20 21:39:37 +1000185 }
186 Py_DECREF(value);
187 Py_DECREF(impmod);
188
Victor Stinner331a6a52019-05-27 16:39:22 +0200189 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +1000190}
191
Victor Stinner331a6a52019-05-27 16:39:22 +0200192static PyStatus
Victor Stinner0a28f8d2019-06-19 02:54:39 +0200193init_importlib_external(PyThreadState *tstate)
Eric Snow1abcf672017-05-23 21:46:51 -0700194{
195 PyObject *value;
Victor Stinner0a28f8d2019-06-19 02:54:39 +0200196 value = PyObject_CallMethod(tstate->interp->importlib,
Eric Snow1abcf672017-05-23 21:46:51 -0700197 "_install_external_importers", "");
198 if (value == NULL) {
Victor Stinnerb45d2592019-06-20 00:05:23 +0200199 _PyErr_Print(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +0200200 return _PyStatus_ERR("external importer setup failed");
Eric Snow1abcf672017-05-23 21:46:51 -0700201 }
Stéphane Wirtelab1cb802017-06-08 13:13:20 +0200202 Py_DECREF(value);
Victor Stinner0a28f8d2019-06-19 02:54:39 +0200203 return _PyImportZip_Init(tstate);
Eric Snow1abcf672017-05-23 21:46:51 -0700204}
Nick Coghland6009512014-11-20 21:39:37 +1000205
Nick Coghlan6ea41862017-06-11 13:16:15 +1000206/* Helper functions to better handle the legacy C locale
207 *
208 * The legacy C locale assumes ASCII as the default text encoding, which
209 * causes problems not only for the CPython runtime, but also other
210 * components like GNU readline.
211 *
212 * Accordingly, when the CLI detects it, it attempts to coerce it to a
213 * more capable UTF-8 based alternative as follows:
214 *
215 * if (_Py_LegacyLocaleDetected()) {
216 * _Py_CoerceLegacyLocale();
217 * }
218 *
219 * See the documentation of the PYTHONCOERCECLOCALE setting for more details.
220 *
221 * Locale coercion also impacts the default error handler for the standard
222 * streams: while the usual default is "strict", the default for the legacy
223 * C locale and for any of the coercion target locales is "surrogateescape".
224 */
225
226int
Victor Stinner0f721472019-05-20 17:16:38 +0200227_Py_LegacyLocaleDetected(int warn)
Nick Coghlan6ea41862017-06-11 13:16:15 +1000228{
229#ifndef MS_WINDOWS
Victor Stinner0f721472019-05-20 17:16:38 +0200230 if (!warn) {
231 const char *locale_override = getenv("LC_ALL");
232 if (locale_override != NULL && *locale_override != '\0') {
233 /* Don't coerce C locale if the LC_ALL environment variable
234 is set */
235 return 0;
236 }
237 }
238
Nick Coghlan6ea41862017-06-11 13:16:15 +1000239 /* On non-Windows systems, the C locale is considered a legacy locale */
Nick Coghlaneb817952017-06-18 12:29:42 +1000240 /* XXX (ncoghlan): some platforms (notably Mac OS X) don't appear to treat
241 * the POSIX locale as a simple alias for the C locale, so
242 * we may also want to check for that explicitly.
243 */
Nick Coghlan6ea41862017-06-11 13:16:15 +1000244 const char *ctype_loc = setlocale(LC_CTYPE, NULL);
245 return ctype_loc != NULL && strcmp(ctype_loc, "C") == 0;
246#else
247 /* Windows uses code pages instead of locales, so no locale is legacy */
248 return 0;
249#endif
250}
251
Victor Stinnerb0051362019-11-22 17:52:42 +0100252#ifndef MS_WINDOWS
Nick Coghlaneb817952017-06-18 12:29:42 +1000253static const char *_C_LOCALE_WARNING =
254 "Python runtime initialized with LC_CTYPE=C (a locale with default ASCII "
255 "encoding), which may cause Unicode compatibility problems. Using C.UTF-8, "
256 "C.utf8, or UTF-8 (if available) as alternative Unicode-compatible "
257 "locales is recommended.\n";
258
Nick Coghlaneb817952017-06-18 12:29:42 +1000259static void
Victor Stinner43125222019-04-24 18:23:53 +0200260emit_stderr_warning_for_legacy_locale(_PyRuntimeState *runtime)
Nick Coghlaneb817952017-06-18 12:29:42 +1000261{
Victor Stinner331a6a52019-05-27 16:39:22 +0200262 const PyPreConfig *preconfig = &runtime->preconfig;
Victor Stinner0f721472019-05-20 17:16:38 +0200263 if (preconfig->coerce_c_locale_warn && _Py_LegacyLocaleDetected(1)) {
Victor Stinnercf215042018-08-29 22:56:06 +0200264 PySys_FormatStderr("%s", _C_LOCALE_WARNING);
Nick Coghlaneb817952017-06-18 12:29:42 +1000265 }
266}
Victor Stinnerb0051362019-11-22 17:52:42 +0100267#endif /* !defined(MS_WINDOWS) */
Nick Coghlaneb817952017-06-18 12:29:42 +1000268
Nick Coghlan6ea41862017-06-11 13:16:15 +1000269typedef struct _CandidateLocale {
270 const char *locale_name; /* The locale to try as a coercion target */
271} _LocaleCoercionTarget;
272
273static _LocaleCoercionTarget _TARGET_LOCALES[] = {
274 {"C.UTF-8"},
275 {"C.utf8"},
Nick Coghlan18974c32017-06-30 00:48:14 +1000276 {"UTF-8"},
Nick Coghlan6ea41862017-06-11 13:16:15 +1000277 {NULL}
278};
279
Victor Stinnerdfe0dc72018-08-29 11:47:29 +0200280
281int
282_Py_IsLocaleCoercionTarget(const char *ctype_loc)
Nick Coghlan6ea41862017-06-11 13:16:15 +1000283{
Victor Stinnerdfe0dc72018-08-29 11:47:29 +0200284 const _LocaleCoercionTarget *target = NULL;
285 for (target = _TARGET_LOCALES; target->locale_name; target++) {
286 if (strcmp(ctype_loc, target->locale_name) == 0) {
287 return 1;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000288 }
Victor Stinner124b9eb2018-08-29 01:29:06 +0200289 }
Victor Stinnerdfe0dc72018-08-29 11:47:29 +0200290 return 0;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000291}
292
Victor Stinnerdfe0dc72018-08-29 11:47:29 +0200293
Nick Coghlan6ea41862017-06-11 13:16:15 +1000294#ifdef PY_COERCE_C_LOCALE
Victor Stinner94540602017-12-16 04:54:22 +0100295static const char C_LOCALE_COERCION_WARNING[] =
Nick Coghlan6ea41862017-06-11 13:16:15 +1000296 "Python detected LC_CTYPE=C: LC_CTYPE coerced to %.20s (set another locale "
297 "or PYTHONCOERCECLOCALE=0 to disable this locale coercion behavior).\n";
298
Victor Stinner0f721472019-05-20 17:16:38 +0200299static int
Victor Stinnerb2457ef2018-08-29 13:25:36 +0200300_coerce_default_locale_settings(int warn, const _LocaleCoercionTarget *target)
Nick Coghlan6ea41862017-06-11 13:16:15 +1000301{
302 const char *newloc = target->locale_name;
303
304 /* Reset locale back to currently configured defaults */
xdegaye1588be62017-11-12 12:45:59 +0100305 _Py_SetLocaleFromEnv(LC_ALL);
Nick Coghlan6ea41862017-06-11 13:16:15 +1000306
307 /* Set the relevant locale environment variable */
308 if (setenv("LC_CTYPE", newloc, 1)) {
309 fprintf(stderr,
310 "Error setting LC_CTYPE, skipping C locale coercion\n");
Victor Stinner0f721472019-05-20 17:16:38 +0200311 return 0;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000312 }
Victor Stinnerb2457ef2018-08-29 13:25:36 +0200313 if (warn) {
Victor Stinner94540602017-12-16 04:54:22 +0100314 fprintf(stderr, C_LOCALE_COERCION_WARNING, newloc);
Nick Coghlaneb817952017-06-18 12:29:42 +1000315 }
Nick Coghlan6ea41862017-06-11 13:16:15 +1000316
317 /* Reconfigure with the overridden environment variables */
xdegaye1588be62017-11-12 12:45:59 +0100318 _Py_SetLocaleFromEnv(LC_ALL);
Victor Stinner0f721472019-05-20 17:16:38 +0200319 return 1;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000320}
321#endif
322
Victor Stinner0f721472019-05-20 17:16:38 +0200323int
Victor Stinnerb2457ef2018-08-29 13:25:36 +0200324_Py_CoerceLegacyLocale(int warn)
Nick Coghlan6ea41862017-06-11 13:16:15 +1000325{
Victor Stinner0f721472019-05-20 17:16:38 +0200326 int coerced = 0;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000327#ifdef PY_COERCE_C_LOCALE
Victor Stinner8ea09112018-09-03 17:05:18 +0200328 char *oldloc = NULL;
329
330 oldloc = _PyMem_RawStrdup(setlocale(LC_CTYPE, NULL));
331 if (oldloc == NULL) {
Victor Stinner0f721472019-05-20 17:16:38 +0200332 return coerced;
Victor Stinner8ea09112018-09-03 17:05:18 +0200333 }
334
Victor Stinner94540602017-12-16 04:54:22 +0100335 const char *locale_override = getenv("LC_ALL");
336 if (locale_override == NULL || *locale_override == '\0') {
337 /* LC_ALL is also not set (or is set to an empty string) */
338 const _LocaleCoercionTarget *target = NULL;
339 for (target = _TARGET_LOCALES; target->locale_name; target++) {
340 const char *new_locale = setlocale(LC_CTYPE,
341 target->locale_name);
342 if (new_locale != NULL) {
Victor Stinnere2510952019-05-02 11:28:57 -0400343#if !defined(_Py_FORCE_UTF8_LOCALE) && defined(HAVE_LANGINFO_H) && defined(CODESET)
Victor Stinner94540602017-12-16 04:54:22 +0100344 /* Also ensure that nl_langinfo works in this locale */
345 char *codeset = nl_langinfo(CODESET);
346 if (!codeset || *codeset == '\0') {
347 /* CODESET is not set or empty, so skip coercion */
348 new_locale = NULL;
349 _Py_SetLocaleFromEnv(LC_CTYPE);
350 continue;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000351 }
Victor Stinner94540602017-12-16 04:54:22 +0100352#endif
353 /* Successfully configured locale, so make it the default */
Victor Stinner0f721472019-05-20 17:16:38 +0200354 coerced = _coerce_default_locale_settings(warn, target);
Victor Stinner8ea09112018-09-03 17:05:18 +0200355 goto done;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000356 }
357 }
358 }
359 /* No C locale warning here, as Py_Initialize will emit one later */
Victor Stinner8ea09112018-09-03 17:05:18 +0200360
361 setlocale(LC_CTYPE, oldloc);
362
363done:
364 PyMem_RawFree(oldloc);
Nick Coghlan6ea41862017-06-11 13:16:15 +1000365#endif
Victor Stinner0f721472019-05-20 17:16:38 +0200366 return coerced;
Nick Coghlan6ea41862017-06-11 13:16:15 +1000367}
368
xdegaye1588be62017-11-12 12:45:59 +0100369/* _Py_SetLocaleFromEnv() is a wrapper around setlocale(category, "") to
370 * isolate the idiosyncrasies of different libc implementations. It reads the
371 * appropriate environment variable and uses its value to select the locale for
372 * 'category'. */
373char *
374_Py_SetLocaleFromEnv(int category)
375{
Victor Stinner353933e2018-11-23 13:08:26 +0100376 char *res;
xdegaye1588be62017-11-12 12:45:59 +0100377#ifdef __ANDROID__
378 const char *locale;
379 const char **pvar;
380#ifdef PY_COERCE_C_LOCALE
381 const char *coerce_c_locale;
382#endif
383 const char *utf8_locale = "C.UTF-8";
384 const char *env_var_set[] = {
385 "LC_ALL",
386 "LC_CTYPE",
387 "LANG",
388 NULL,
389 };
390
391 /* Android setlocale(category, "") doesn't check the environment variables
392 * and incorrectly sets the "C" locale at API 24 and older APIs. We only
393 * check the environment variables listed in env_var_set. */
394 for (pvar=env_var_set; *pvar; pvar++) {
395 locale = getenv(*pvar);
396 if (locale != NULL && *locale != '\0') {
397 if (strcmp(locale, utf8_locale) == 0 ||
398 strcmp(locale, "en_US.UTF-8") == 0) {
399 return setlocale(category, utf8_locale);
400 }
401 return setlocale(category, "C");
402 }
403 }
404
405 /* Android uses UTF-8, so explicitly set the locale to C.UTF-8 if none of
406 * LC_ALL, LC_CTYPE, or LANG is set to a non-empty string.
407 * Quote from POSIX section "8.2 Internationalization Variables":
408 * "4. If the LANG environment variable is not set or is set to the empty
409 * string, the implementation-defined default locale shall be used." */
410
411#ifdef PY_COERCE_C_LOCALE
412 coerce_c_locale = getenv("PYTHONCOERCECLOCALE");
413 if (coerce_c_locale == NULL || strcmp(coerce_c_locale, "0") != 0) {
414 /* Some other ported code may check the environment variables (e.g. in
415 * extension modules), so we make sure that they match the locale
416 * configuration */
417 if (setenv("LC_CTYPE", utf8_locale, 1)) {
418 fprintf(stderr, "Warning: failed setting the LC_CTYPE "
419 "environment variable to %s\n", utf8_locale);
420 }
421 }
422#endif
Victor Stinner353933e2018-11-23 13:08:26 +0100423 res = setlocale(category, utf8_locale);
424#else /* !defined(__ANDROID__) */
425 res = setlocale(category, "");
426#endif
427 _Py_ResetForceASCII();
428 return res;
xdegaye1588be62017-11-12 12:45:59 +0100429}
430
Nick Coghlan6ea41862017-06-11 13:16:15 +1000431
Eric Snow1abcf672017-05-23 21:46:51 -0700432/* Global initializations. Can be undone by Py_Finalize(). Don't
433 call this twice without an intervening Py_Finalize() call.
434
Victor Stinner331a6a52019-05-27 16:39:22 +0200435 Every call to Py_InitializeFromConfig, Py_Initialize or Py_InitializeEx
Eric Snow1abcf672017-05-23 21:46:51 -0700436 must have a corresponding call to Py_Finalize.
437
438 Locking: you must hold the interpreter lock while calling these APIs.
439 (If the lock has not yet been initialized, that's equivalent to
440 having the lock, but you cannot use multiple threads.)
441
442*/
443
Victor Stinner331a6a52019-05-27 16:39:22 +0200444static PyStatus
Victor Stinner5edcf262019-05-23 00:57:57 +0200445pyinit_core_reconfigure(_PyRuntimeState *runtime,
Victor Stinnerb45d2592019-06-20 00:05:23 +0200446 PyThreadState **tstate_p,
Victor Stinner331a6a52019-05-27 16:39:22 +0200447 const PyConfig *config)
Victor Stinner1dc6e392018-07-25 02:49:17 +0200448{
Victor Stinner331a6a52019-05-27 16:39:22 +0200449 PyStatus status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100450 PyThreadState *tstate = _PyThreadState_GET();
451 if (!tstate) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200452 return _PyStatus_ERR("failed to read thread state");
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100453 }
Victor Stinnerb45d2592019-06-20 00:05:23 +0200454 *tstate_p = tstate;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100455
456 PyInterpreterState *interp = tstate->interp;
457 if (interp == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200458 return _PyStatus_ERR("can't make main interpreter");
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100459 }
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100460
Victor Stinnere81f6e62020-06-08 18:12:59 +0200461 status = _PyConfig_Write(config, runtime);
462 if (_PyStatus_EXCEPTION(status)) {
463 return status;
464 }
Victor Stinner1dc6e392018-07-25 02:49:17 +0200465
Victor Stinnerda7933e2020-04-13 03:04:28 +0200466 status = _PyInterpreterState_SetConfig(interp, config);
Victor Stinner331a6a52019-05-27 16:39:22 +0200467 if (_PyStatus_EXCEPTION(status)) {
468 return status;
Victor Stinner1dc6e392018-07-25 02:49:17 +0200469 }
Victor Stinnerda7933e2020-04-13 03:04:28 +0200470 config = _PyInterpreterState_GetConfig(interp);
Victor Stinner1dc6e392018-07-25 02:49:17 +0200471
Victor Stinner331a6a52019-05-27 16:39:22 +0200472 if (config->_install_importlib) {
Victor Stinner12f2f172019-09-26 15:51:50 +0200473 status = _PyConfig_WritePathConfig(config);
Victor Stinner331a6a52019-05-27 16:39:22 +0200474 if (_PyStatus_EXCEPTION(status)) {
475 return status;
Victor Stinner1dc6e392018-07-25 02:49:17 +0200476 }
477 }
Victor Stinner331a6a52019-05-27 16:39:22 +0200478 return _PyStatus_OK();
Victor Stinner1dc6e392018-07-25 02:49:17 +0200479}
480
481
Victor Stinner331a6a52019-05-27 16:39:22 +0200482static PyStatus
Victor Stinner43125222019-04-24 18:23:53 +0200483pycore_init_runtime(_PyRuntimeState *runtime,
Victor Stinner331a6a52019-05-27 16:39:22 +0200484 const PyConfig *config)
Nick Coghland6009512014-11-20 21:39:37 +1000485{
Victor Stinner43125222019-04-24 18:23:53 +0200486 if (runtime->initialized) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200487 return _PyStatus_ERR("main interpreter already initialized");
Victor Stinner1dc6e392018-07-25 02:49:17 +0200488 }
Victor Stinnerda273412017-12-15 01:46:02 +0100489
Victor Stinnere81f6e62020-06-08 18:12:59 +0200490 PyStatus status = _PyConfig_Write(config, runtime);
491 if (_PyStatus_EXCEPTION(status)) {
492 return status;
493 }
Eric Snow2ebc5ce2017-09-07 23:51:28 -0600494
Eric Snow1abcf672017-05-23 21:46:51 -0700495 /* Py_Finalize leaves _Py_Finalizing set in order to help daemon
496 * threads behave a little more gracefully at interpreter shutdown.
497 * We clobber it here so the new interpreter can start with a clean
498 * slate.
499 *
500 * However, this may still lead to misbehaviour if there are daemon
501 * threads still hanging around from a previous Py_Initialize/Finalize
502 * pair :(
503 */
Victor Stinner7b3c2522020-03-07 00:24:23 +0100504 _PyRuntimeState_SetFinalizing(runtime, NULL);
Eric Snow2ebc5ce2017-09-07 23:51:28 -0600505
Victor Stinnere81f6e62020-06-08 18:12:59 +0200506 status = _Py_HashRandomization_Init(config);
Victor Stinner331a6a52019-05-27 16:39:22 +0200507 if (_PyStatus_EXCEPTION(status)) {
508 return status;
Victor Stinnerf7e5b562017-11-15 15:48:08 -0800509 }
510
Victor Stinner331a6a52019-05-27 16:39:22 +0200511 status = _PyInterpreterState_Enable(runtime);
512 if (_PyStatus_EXCEPTION(status)) {
513 return status;
Victor Stinnera7368ac2017-11-15 18:11:45 -0800514 }
Victor Stinner331a6a52019-05-27 16:39:22 +0200515 return _PyStatus_OK();
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100516}
Victor Stinnera7368ac2017-11-15 18:11:45 -0800517
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100518
Victor Stinner331a6a52019-05-27 16:39:22 +0200519static PyStatus
Victor Stinnerdda5d6e2020-04-08 17:54:59 +0200520init_interp_create_gil(PyThreadState *tstate)
521{
522 PyStatus status;
523
524 /* finalize_interp_delete() comment explains why _PyEval_FiniGIL() is
525 only called here. */
526 _PyEval_FiniGIL(tstate);
527
528 /* Auto-thread-state API */
529 status = _PyGILState_Init(tstate);
530 if (_PyStatus_EXCEPTION(status)) {
531 return status;
532 }
533
534 /* Create the GIL and take it */
535 status = _PyEval_InitGIL(tstate);
536 if (_PyStatus_EXCEPTION(status)) {
537 return status;
538 }
539
540 return _PyStatus_OK();
541}
542
543
544static PyStatus
Victor Stinner43125222019-04-24 18:23:53 +0200545pycore_create_interpreter(_PyRuntimeState *runtime,
Victor Stinner331a6a52019-05-27 16:39:22 +0200546 const PyConfig *config,
Victor Stinnerb45d2592019-06-20 00:05:23 +0200547 PyThreadState **tstate_p)
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100548{
549 PyInterpreterState *interp = PyInterpreterState_New();
Victor Stinnerda273412017-12-15 01:46:02 +0100550 if (interp == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200551 return _PyStatus_ERR("can't make main interpreter");
Victor Stinnerda273412017-12-15 01:46:02 +0100552 }
553
Victor Stinnerda7933e2020-04-13 03:04:28 +0200554 PyStatus status = _PyInterpreterState_SetConfig(interp, config);
Victor Stinner331a6a52019-05-27 16:39:22 +0200555 if (_PyStatus_EXCEPTION(status)) {
556 return status;
Victor Stinnerda273412017-12-15 01:46:02 +0100557 }
Nick Coghland6009512014-11-20 21:39:37 +1000558
Victor Stinnerd19d8d52018-07-24 13:55:48 +0200559 PyThreadState *tstate = PyThreadState_New(interp);
Victor Stinnerb45d2592019-06-20 00:05:23 +0200560 if (tstate == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200561 return _PyStatus_ERR("can't make first thread");
Victor Stinnerb45d2592019-06-20 00:05:23 +0200562 }
Nick Coghland6009512014-11-20 21:39:37 +1000563 (void) PyThreadState_Swap(tstate);
564
Victor Stinnerdda5d6e2020-04-08 17:54:59 +0200565 status = init_interp_create_gil(tstate);
Victor Stinner111e4ee2020-03-09 21:24:14 +0100566 if (_PyStatus_EXCEPTION(status)) {
567 return status;
568 }
Victor Stinner2914bb32018-01-29 11:57:45 +0100569
Victor Stinnerb45d2592019-06-20 00:05:23 +0200570 *tstate_p = tstate;
Victor Stinner331a6a52019-05-27 16:39:22 +0200571 return _PyStatus_OK();
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100572}
Nick Coghland6009512014-11-20 21:39:37 +1000573
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100574
Victor Stinner331a6a52019-05-27 16:39:22 +0200575static PyStatus
Victor Stinnerb93f31f2019-11-20 18:39:12 +0100576pycore_init_types(PyThreadState *tstate)
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100577{
Victor Stinner444b39b2019-11-20 01:18:11 +0100578 PyStatus status;
Victor Stinnerb93f31f2019-11-20 18:39:12 +0100579 int is_main_interp = _Py_IsMainInterpreter(tstate);
Victor Stinner444b39b2019-11-20 01:18:11 +0100580
Victor Stinner01b1cc12019-11-20 02:27:56 +0100581 status = _PyGC_Init(tstate);
Victor Stinner444b39b2019-11-20 01:18:11 +0100582 if (_PyStatus_EXCEPTION(status)) {
583 return status;
584 }
585
Victor Stinnere7e699e2019-11-20 12:08:13 +0100586 if (is_main_interp) {
587 status = _PyTypes_Init();
588 if (_PyStatus_EXCEPTION(status)) {
589 return status;
590 }
Victor Stinner630c8df2019-12-17 13:02:18 +0100591 }
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100592
Victor Stinner630c8df2019-12-17 13:02:18 +0100593
594 if (!_PyLong_Init(tstate)) {
595 return _PyStatus_ERR("can't init longs");
Victor Stinnerb93f31f2019-11-20 18:39:12 +0100596 }
Victor Stinneref5aa9a2019-11-20 00:38:03 +0100597
Victor Stinnerb93f31f2019-11-20 18:39:12 +0100598 if (is_main_interp) {
Victor Stinnere7e699e2019-11-20 12:08:13 +0100599 status = _PyUnicode_Init();
600 if (_PyStatus_EXCEPTION(status)) {
601 return status;
602 }
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100603 }
604
Victor Stinner331a6a52019-05-27 16:39:22 +0200605 status = _PyExc_Init();
606 if (_PyStatus_EXCEPTION(status)) {
607 return status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100608 }
609
Victor Stinnere7e699e2019-11-20 12:08:13 +0100610 if (is_main_interp) {
611 if (!_PyFloat_Init()) {
612 return _PyStatus_ERR("can't init float");
613 }
Nick Coghland6009512014-11-20 21:39:37 +1000614
Victor Stinnere7e699e2019-11-20 12:08:13 +0100615 if (_PyStructSequence_Init() < 0) {
616 return _PyStatus_ERR("can't initialize structseq");
617 }
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100618 }
Victor Stinneref9d9b62019-05-22 11:28:22 +0200619
Victor Stinner331a6a52019-05-27 16:39:22 +0200620 status = _PyErr_Init();
621 if (_PyStatus_EXCEPTION(status)) {
622 return status;
Victor Stinneref9d9b62019-05-22 11:28:22 +0200623 }
624
Victor Stinnere7e699e2019-11-20 12:08:13 +0100625 if (is_main_interp) {
626 if (!_PyContext_Init()) {
627 return _PyStatus_ERR("can't init context");
628 }
Victor Stinneref5aa9a2019-11-20 00:38:03 +0100629 }
630
Victor Stinner331a6a52019-05-27 16:39:22 +0200631 return _PyStatus_OK();
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100632}
633
634
Victor Stinner331a6a52019-05-27 16:39:22 +0200635static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +0200636pycore_init_builtins(PyThreadState *tstate)
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100637{
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100638 assert(!_PyErr_Occurred(tstate));
639
Victor Stinnerb45d2592019-06-20 00:05:23 +0200640 PyObject *bimod = _PyBuiltin_Init(tstate);
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100641 if (bimod == NULL) {
Victor Stinner2582d462019-11-22 19:24:49 +0100642 goto error;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100643 }
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100644
Victor Stinner2582d462019-11-22 19:24:49 +0100645 PyInterpreterState *interp = tstate->interp;
646 if (_PyImport_FixupBuiltin(bimod, "builtins", interp->modules) < 0) {
647 goto error;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100648 }
Victor Stinner2582d462019-11-22 19:24:49 +0100649
650 PyObject *builtins_dict = PyModule_GetDict(bimod);
651 if (builtins_dict == NULL) {
652 goto error;
653 }
654 Py_INCREF(builtins_dict);
655 interp->builtins = builtins_dict;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100656
Victor Stinner331a6a52019-05-27 16:39:22 +0200657 PyStatus status = _PyBuiltins_AddExceptions(bimod);
658 if (_PyStatus_EXCEPTION(status)) {
659 return status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100660 }
Victor Stinner2582d462019-11-22 19:24:49 +0100661
662 interp->builtins_copy = PyDict_Copy(interp->builtins);
663 if (interp->builtins_copy == NULL) {
664 goto error;
665 }
Pablo Galindob96c6b02019-12-04 11:19:59 +0000666 Py_DECREF(bimod);
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100667
668 assert(!_PyErr_Occurred(tstate));
669
Victor Stinner331a6a52019-05-27 16:39:22 +0200670 return _PyStatus_OK();
Victor Stinner2582d462019-11-22 19:24:49 +0100671
672error:
Pablo Galindob96c6b02019-12-04 11:19:59 +0000673 Py_XDECREF(bimod);
Victor Stinner2582d462019-11-22 19:24:49 +0100674 return _PyStatus_ERR("can't initialize builtins module");
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100675}
676
677
Victor Stinner331a6a52019-05-27 16:39:22 +0200678static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +0200679pycore_init_import_warnings(PyThreadState *tstate, PyObject *sysmod)
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100680{
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100681 assert(!_PyErr_Occurred(tstate));
Victor Stinnerb45d2592019-06-20 00:05:23 +0200682
Victor Stinner2582d462019-11-22 19:24:49 +0100683 PyStatus status = _PyImportHooks_Init(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +0200684 if (_PyStatus_EXCEPTION(status)) {
685 return status;
Victor Stinnerf7e5b562017-11-15 15:48:08 -0800686 }
Nick Coghland6009512014-11-20 21:39:37 +1000687
Victor Stinner30a89332020-06-23 15:55:45 +0200688 /* Initialize _warnings. */
689 status = _PyWarnings_InitState(tstate);
690 if (_PyStatus_EXCEPTION(status)) {
691 return status;
692 }
Nick Coghland6009512014-11-20 21:39:37 +1000693
Victor Stinner30a89332020-06-23 15:55:45 +0200694 const PyConfig *config = _PyInterpreterState_GetConfig(tstate->interp);
695 if (config->_install_importlib) {
696 if (_Py_IsMainInterpreter(tstate)) {
Victor Stinner2ec1a1b2019-11-22 21:54:33 +0100697 status = _PyConfig_WritePathConfig(config);
698 if (_PyStatus_EXCEPTION(status)) {
699 return status;
700 }
Victor Stinnerb1147e42018-07-21 02:06:16 +0200701 }
Victor Stinnerb1147e42018-07-21 02:06:16 +0200702
Victor Stinner30a89332020-06-23 15:55:45 +0200703 /* This call sets up builtin and frozen import support */
Victor Stinnerb45d2592019-06-20 00:05:23 +0200704 status = init_importlib(tstate, sysmod);
Victor Stinner331a6a52019-05-27 16:39:22 +0200705 if (_PyStatus_EXCEPTION(status)) {
706 return status;
Victor Stinnerf7e5b562017-11-15 15:48:08 -0800707 }
Eric Snow1abcf672017-05-23 21:46:51 -0700708 }
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100709
710 assert(!_PyErr_Occurred(tstate));
711
Victor Stinner331a6a52019-05-27 16:39:22 +0200712 return _PyStatus_OK();
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100713}
714
715
Victor Stinner331a6a52019-05-27 16:39:22 +0200716static PyStatus
Victor Stinnerd863ade2019-12-06 03:37:07 +0100717pycore_interp_init(PyThreadState *tstate)
718{
719 PyStatus status;
Victor Stinner080ee5a2019-12-08 21:55:58 +0100720 PyObject *sysmod = NULL;
Victor Stinnerd863ade2019-12-06 03:37:07 +0100721
722 status = pycore_init_types(tstate);
723 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner080ee5a2019-12-08 21:55:58 +0100724 goto done;
Victor Stinnerd863ade2019-12-06 03:37:07 +0100725 }
726
Victor Stinnerd863ade2019-12-06 03:37:07 +0100727 status = _PySys_Create(tstate, &sysmod);
728 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner080ee5a2019-12-08 21:55:58 +0100729 goto done;
Victor Stinnerd863ade2019-12-06 03:37:07 +0100730 }
731
732 status = pycore_init_builtins(tstate);
733 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner080ee5a2019-12-08 21:55:58 +0100734 goto done;
Victor Stinnerd863ade2019-12-06 03:37:07 +0100735 }
736
Victor Stinner080ee5a2019-12-08 21:55:58 +0100737 status = pycore_init_import_warnings(tstate, sysmod);
738
739done:
740 /* sys.modules['sys'] contains a strong reference to the module */
741 Py_XDECREF(sysmod);
742 return status;
Victor Stinnerd863ade2019-12-06 03:37:07 +0100743}
744
745
746static PyStatus
Victor Stinner331a6a52019-05-27 16:39:22 +0200747pyinit_config(_PyRuntimeState *runtime,
Victor Stinnerb45d2592019-06-20 00:05:23 +0200748 PyThreadState **tstate_p,
Victor Stinner331a6a52019-05-27 16:39:22 +0200749 const PyConfig *config)
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100750{
Victor Stinner331a6a52019-05-27 16:39:22 +0200751 PyStatus status = pycore_init_runtime(runtime, config);
752 if (_PyStatus_EXCEPTION(status)) {
753 return status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100754 }
755
Victor Stinnerb45d2592019-06-20 00:05:23 +0200756 PyThreadState *tstate;
757 status = pycore_create_interpreter(runtime, config, &tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +0200758 if (_PyStatus_EXCEPTION(status)) {
759 return status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100760 }
Victor Stinnerb45d2592019-06-20 00:05:23 +0200761 *tstate_p = tstate;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100762
Victor Stinnerd863ade2019-12-06 03:37:07 +0100763 status = pycore_interp_init(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +0200764 if (_PyStatus_EXCEPTION(status)) {
765 return status;
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100766 }
Eric Snow1abcf672017-05-23 21:46:51 -0700767
768 /* Only when we get here is the runtime core fully initialized */
Victor Stinner43125222019-04-24 18:23:53 +0200769 runtime->core_initialized = 1;
Victor Stinner331a6a52019-05-27 16:39:22 +0200770 return _PyStatus_OK();
Eric Snow1abcf672017-05-23 21:46:51 -0700771}
772
Victor Stinner7d2ef3e2019-03-06 00:36:56 +0100773
Victor Stinner331a6a52019-05-27 16:39:22 +0200774PyStatus
775_Py_PreInitializeFromPyArgv(const PyPreConfig *src_config, const _PyArgv *args)
Victor Stinnerf29084d2019-03-20 02:20:13 +0100776{
Victor Stinner331a6a52019-05-27 16:39:22 +0200777 PyStatus status;
Victor Stinnerf29084d2019-03-20 02:20:13 +0100778
Victor Stinner6d1c4672019-05-20 11:02:00 +0200779 if (src_config == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200780 return _PyStatus_ERR("preinitialization config is NULL");
Victor Stinner6d1c4672019-05-20 11:02:00 +0200781 }
782
Victor Stinner331a6a52019-05-27 16:39:22 +0200783 status = _PyRuntime_Initialize();
784 if (_PyStatus_EXCEPTION(status)) {
785 return status;
Victor Stinner7d2ef3e2019-03-06 00:36:56 +0100786 }
Victor Stinner43125222019-04-24 18:23:53 +0200787 _PyRuntimeState *runtime = &_PyRuntime;
Victor Stinner7d2ef3e2019-03-06 00:36:56 +0100788
Victor Stinnerd3b90412019-09-17 23:59:51 +0200789 if (runtime->preinitialized) {
Victor Stinnerf72346c2019-03-25 17:54:58 +0100790 /* If it's already configured: ignored the new configuration */
Victor Stinner331a6a52019-05-27 16:39:22 +0200791 return _PyStatus_OK();
Victor Stinnera6fbc4e2019-03-25 18:37:10 +0100792 }
793
Victor Stinnerd3b90412019-09-17 23:59:51 +0200794 /* Note: preinitialized remains 1 on error, it is only set to 0
795 at exit on success. */
796 runtime->preinitializing = 1;
797
Victor Stinner331a6a52019-05-27 16:39:22 +0200798 PyPreConfig config;
Victor Stinner441b10c2019-09-28 04:28:35 +0200799
800 status = _PyPreConfig_InitFromPreConfig(&config, src_config);
801 if (_PyStatus_EXCEPTION(status)) {
802 return status;
803 }
Victor Stinnerf72346c2019-03-25 17:54:58 +0100804
Victor Stinner331a6a52019-05-27 16:39:22 +0200805 status = _PyPreConfig_Read(&config, args);
806 if (_PyStatus_EXCEPTION(status)) {
807 return status;
Victor Stinnerf29084d2019-03-20 02:20:13 +0100808 }
809
Victor Stinner331a6a52019-05-27 16:39:22 +0200810 status = _PyPreConfig_Write(&config);
811 if (_PyStatus_EXCEPTION(status)) {
812 return status;
Victor Stinnerf72346c2019-03-25 17:54:58 +0100813 }
814
Victor Stinnerd3b90412019-09-17 23:59:51 +0200815 runtime->preinitializing = 0;
816 runtime->preinitialized = 1;
Victor Stinner331a6a52019-05-27 16:39:22 +0200817 return _PyStatus_OK();
Victor Stinnerf72346c2019-03-25 17:54:58 +0100818}
819
Victor Stinner70005ac2019-05-02 15:25:34 -0400820
Victor Stinner331a6a52019-05-27 16:39:22 +0200821PyStatus
822Py_PreInitializeFromBytesArgs(const PyPreConfig *src_config, Py_ssize_t argc, char **argv)
Victor Stinnerf72346c2019-03-25 17:54:58 +0100823{
Victor Stinner5ac27a52019-03-27 13:40:14 +0100824 _PyArgv args = {.use_bytes_argv = 1, .argc = argc, .bytes_argv = argv};
Victor Stinner70005ac2019-05-02 15:25:34 -0400825 return _Py_PreInitializeFromPyArgv(src_config, &args);
Victor Stinnerf29084d2019-03-20 02:20:13 +0100826}
827
828
Victor Stinner331a6a52019-05-27 16:39:22 +0200829PyStatus
830Py_PreInitializeFromArgs(const PyPreConfig *src_config, Py_ssize_t argc, wchar_t **argv)
Victor Stinner20004952019-03-26 02:31:11 +0100831{
Victor Stinner5ac27a52019-03-27 13:40:14 +0100832 _PyArgv args = {.use_bytes_argv = 0, .argc = argc, .wchar_argv = argv};
Victor Stinner70005ac2019-05-02 15:25:34 -0400833 return _Py_PreInitializeFromPyArgv(src_config, &args);
Victor Stinner20004952019-03-26 02:31:11 +0100834}
835
836
Victor Stinner331a6a52019-05-27 16:39:22 +0200837PyStatus
838Py_PreInitialize(const PyPreConfig *src_config)
Victor Stinnera6fbc4e2019-03-25 18:37:10 +0100839{
Victor Stinner70005ac2019-05-02 15:25:34 -0400840 return _Py_PreInitializeFromPyArgv(src_config, NULL);
Victor Stinnera6fbc4e2019-03-25 18:37:10 +0100841}
842
843
Victor Stinner331a6a52019-05-27 16:39:22 +0200844PyStatus
845_Py_PreInitializeFromConfig(const PyConfig *config,
846 const _PyArgv *args)
Victor Stinnerf29084d2019-03-20 02:20:13 +0100847{
Victor Stinner331a6a52019-05-27 16:39:22 +0200848 assert(config != NULL);
Victor Stinner6d1c4672019-05-20 11:02:00 +0200849
Victor Stinner331a6a52019-05-27 16:39:22 +0200850 PyStatus status = _PyRuntime_Initialize();
851 if (_PyStatus_EXCEPTION(status)) {
852 return status;
Victor Stinner6d1c4672019-05-20 11:02:00 +0200853 }
854 _PyRuntimeState *runtime = &_PyRuntime;
855
Victor Stinnerd3b90412019-09-17 23:59:51 +0200856 if (runtime->preinitialized) {
Victor Stinner6d1c4672019-05-20 11:02:00 +0200857 /* Already initialized: do nothing */
Victor Stinner331a6a52019-05-27 16:39:22 +0200858 return _PyStatus_OK();
Victor Stinner70005ac2019-05-02 15:25:34 -0400859 }
Victor Stinnercab5d072019-05-17 19:01:14 +0200860
Victor Stinner331a6a52019-05-27 16:39:22 +0200861 PyPreConfig preconfig;
Victor Stinner441b10c2019-09-28 04:28:35 +0200862
Victor Stinner3c30a762019-10-01 10:56:37 +0200863 _PyPreConfig_InitFromConfig(&preconfig, config);
Victor Stinner6d1c4672019-05-20 11:02:00 +0200864
Victor Stinner331a6a52019-05-27 16:39:22 +0200865 if (!config->parse_argv) {
866 return Py_PreInitialize(&preconfig);
Victor Stinner6d1c4672019-05-20 11:02:00 +0200867 }
868 else if (args == NULL) {
Victor Stinnercab5d072019-05-17 19:01:14 +0200869 _PyArgv config_args = {
870 .use_bytes_argv = 0,
Victor Stinner331a6a52019-05-27 16:39:22 +0200871 .argc = config->argv.length,
872 .wchar_argv = config->argv.items};
Victor Stinner6d1c4672019-05-20 11:02:00 +0200873 return _Py_PreInitializeFromPyArgv(&preconfig, &config_args);
Victor Stinnercab5d072019-05-17 19:01:14 +0200874 }
875 else {
Victor Stinner6d1c4672019-05-20 11:02:00 +0200876 return _Py_PreInitializeFromPyArgv(&preconfig, args);
Victor Stinnercab5d072019-05-17 19:01:14 +0200877 }
Victor Stinner7d2ef3e2019-03-06 00:36:56 +0100878}
879
880
Victor Stinner6d43f6f2019-01-22 21:18:05 +0100881/* Begin interpreter initialization
882 *
883 * On return, the first thread and interpreter state have been created,
884 * but the compiler, signal handling, multithreading and
885 * multiple interpreter support, and codec infrastructure are not yet
886 * available.
887 *
888 * The import system will support builtin and frozen modules only.
889 * The only supported io is writing to sys.stderr
890 *
891 * If any operation invoked by this function fails, a fatal error is
892 * issued and the function does not return.
893 *
894 * Any code invoked from this function should *not* assume it has access
895 * to the Python C API (unless the API is explicitly listed as being
896 * safe to call without calling Py_Initialize first)
897 */
Victor Stinner331a6a52019-05-27 16:39:22 +0200898static PyStatus
Victor Stinner5edcf262019-05-23 00:57:57 +0200899pyinit_core(_PyRuntimeState *runtime,
Victor Stinner331a6a52019-05-27 16:39:22 +0200900 const PyConfig *src_config,
Victor Stinnerb45d2592019-06-20 00:05:23 +0200901 PyThreadState **tstate_p)
Victor Stinner1dc6e392018-07-25 02:49:17 +0200902{
Victor Stinner331a6a52019-05-27 16:39:22 +0200903 PyStatus status;
Victor Stinner1dc6e392018-07-25 02:49:17 +0200904
Victor Stinner331a6a52019-05-27 16:39:22 +0200905 status = _Py_PreInitializeFromConfig(src_config, NULL);
906 if (_PyStatus_EXCEPTION(status)) {
907 return status;
Victor Stinner1dc6e392018-07-25 02:49:17 +0200908 }
909
Victor Stinner331a6a52019-05-27 16:39:22 +0200910 PyConfig config;
Victor Stinner8462a492019-10-01 12:06:16 +0200911 _PyConfig_InitCompatConfig(&config);
Victor Stinner5edcf262019-05-23 00:57:57 +0200912
Victor Stinner331a6a52019-05-27 16:39:22 +0200913 status = _PyConfig_Copy(&config, src_config);
914 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner5edcf262019-05-23 00:57:57 +0200915 goto done;
916 }
917
Victor Stinner331a6a52019-05-27 16:39:22 +0200918 status = PyConfig_Read(&config);
919 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner5edcf262019-05-23 00:57:57 +0200920 goto done;
921 }
922
923 if (!runtime->core_initialized) {
Victor Stinnerb45d2592019-06-20 00:05:23 +0200924 status = pyinit_config(runtime, tstate_p, &config);
Victor Stinner5edcf262019-05-23 00:57:57 +0200925 }
926 else {
Victor Stinnerb45d2592019-06-20 00:05:23 +0200927 status = pyinit_core_reconfigure(runtime, tstate_p, &config);
Victor Stinner5edcf262019-05-23 00:57:57 +0200928 }
Victor Stinner331a6a52019-05-27 16:39:22 +0200929 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner5edcf262019-05-23 00:57:57 +0200930 goto done;
931 }
932
933done:
Victor Stinner331a6a52019-05-27 16:39:22 +0200934 PyConfig_Clear(&config);
935 return status;
Victor Stinner1dc6e392018-07-25 02:49:17 +0200936}
937
Victor Stinner5ac27a52019-03-27 13:40:14 +0100938
Victor Stinnerfb47bca2018-07-20 17:34:23 +0200939/* Py_Initialize() has already been called: update the main interpreter
940 configuration. Example of bpo-34008: Py_Main() called after
941 Py_Initialize(). */
Victor Stinner331a6a52019-05-27 16:39:22 +0200942static PyStatus
Victor Stinnerb0051362019-11-22 17:52:42 +0100943_Py_ReconfigureMainInterpreter(PyThreadState *tstate)
Victor Stinnerfb47bca2018-07-20 17:34:23 +0200944{
Victor Stinnerda7933e2020-04-13 03:04:28 +0200945 const PyConfig *config = _PyInterpreterState_GetConfig(tstate->interp);
Victor Stinner8b9dbc02019-03-27 01:36:16 +0100946
Victor Stinner331a6a52019-05-27 16:39:22 +0200947 PyObject *argv = _PyWideStringList_AsList(&config->argv);
Victor Stinner8b9dbc02019-03-27 01:36:16 +0100948 if (argv == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200949 return _PyStatus_NO_MEMORY(); \
Victor Stinner8b9dbc02019-03-27 01:36:16 +0100950 }
951
Victor Stinnerb0051362019-11-22 17:52:42 +0100952 int res = PyDict_SetItemString(tstate->interp->sysdict, "argv", argv);
Victor Stinner8b9dbc02019-03-27 01:36:16 +0100953 Py_DECREF(argv);
954 if (res < 0) {
Victor Stinner331a6a52019-05-27 16:39:22 +0200955 return _PyStatus_ERR("fail to set sys.argv");
Victor Stinnerfb47bca2018-07-20 17:34:23 +0200956 }
Victor Stinner331a6a52019-05-27 16:39:22 +0200957 return _PyStatus_OK();
Victor Stinnerfb47bca2018-07-20 17:34:23 +0200958}
959
Victor Stinnerb0051362019-11-22 17:52:42 +0100960
961static PyStatus
962init_interp_main(PyThreadState *tstate)
963{
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100964 assert(!_PyErr_Occurred(tstate));
965
Victor Stinnerb0051362019-11-22 17:52:42 +0100966 PyStatus status;
967 int is_main_interp = _Py_IsMainInterpreter(tstate);
968 PyInterpreterState *interp = tstate->interp;
Victor Stinnerda7933e2020-04-13 03:04:28 +0200969 const PyConfig *config = _PyInterpreterState_GetConfig(interp);
Victor Stinnerb0051362019-11-22 17:52:42 +0100970
971 if (!config->_install_importlib) {
972 /* Special mode for freeze_importlib: run with no import system
973 *
974 * This means anything which needs support from extension modules
975 * or pure Python code in the standard library won't work.
976 */
977 if (is_main_interp) {
978 interp->runtime->initialized = 1;
979 }
980 return _PyStatus_OK();
981 }
982
983 if (is_main_interp) {
984 if (_PyTime_Init() < 0) {
985 return _PyStatus_ERR("can't initialize time");
986 }
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100987 }
Victor Stinnerb0051362019-11-22 17:52:42 +0100988
Victor Stinner81fe5bd2019-12-06 02:43:30 +0100989 if (_PySys_InitMain(tstate) < 0) {
990 return _PyStatus_ERR("can't finish initializing sys");
Victor Stinnerb0051362019-11-22 17:52:42 +0100991 }
992
993 status = init_importlib_external(tstate);
994 if (_PyStatus_EXCEPTION(status)) {
995 return status;
996 }
997
998 if (is_main_interp) {
999 /* initialize the faulthandler module */
1000 status = _PyFaulthandler_Init(config->faulthandler);
1001 if (_PyStatus_EXCEPTION(status)) {
1002 return status;
1003 }
1004 }
1005
1006 status = _PyUnicode_InitEncodings(tstate);
1007 if (_PyStatus_EXCEPTION(status)) {
1008 return status;
1009 }
1010
1011 if (is_main_interp) {
1012 if (config->install_signal_handlers) {
1013 status = init_signals(tstate);
1014 if (_PyStatus_EXCEPTION(status)) {
1015 return status;
1016 }
1017 }
1018
1019 if (_PyTraceMalloc_Init(config->tracemalloc) < 0) {
1020 return _PyStatus_ERR("can't initialize tracemalloc");
1021 }
1022 }
1023
1024 status = init_sys_streams(tstate);
1025 if (_PyStatus_EXCEPTION(status)) {
1026 return status;
1027 }
1028
Andy Lester75cd5bf2020-03-12 02:49:05 -05001029 status = init_set_builtins_open();
Victor Stinnerb0051362019-11-22 17:52:42 +01001030 if (_PyStatus_EXCEPTION(status)) {
1031 return status;
1032 }
1033
1034 status = add_main_module(interp);
1035 if (_PyStatus_EXCEPTION(status)) {
1036 return status;
1037 }
1038
1039 if (is_main_interp) {
1040 /* Initialize warnings. */
1041 PyObject *warnoptions = PySys_GetObject("warnoptions");
1042 if (warnoptions != NULL && PyList_Size(warnoptions) > 0)
1043 {
1044 PyObject *warnings_module = PyImport_ImportModule("warnings");
1045 if (warnings_module == NULL) {
1046 fprintf(stderr, "'import warnings' failed; traceback:\n");
1047 _PyErr_Print(tstate);
1048 }
1049 Py_XDECREF(warnings_module);
1050 }
1051
1052 interp->runtime->initialized = 1;
1053 }
1054
1055 if (config->site_import) {
1056 status = init_import_site();
1057 if (_PyStatus_EXCEPTION(status)) {
1058 return status;
1059 }
1060 }
1061
1062 if (is_main_interp) {
1063#ifndef MS_WINDOWS
1064 emit_stderr_warning_for_legacy_locale(interp->runtime);
1065#endif
1066 }
1067
Victor Stinner81fe5bd2019-12-06 02:43:30 +01001068 assert(!_PyErr_Occurred(tstate));
1069
Victor Stinnerb0051362019-11-22 17:52:42 +01001070 return _PyStatus_OK();
1071}
1072
1073
Eric Snowc7ec9982017-05-23 23:00:52 -07001074/* Update interpreter state based on supplied configuration settings
1075 *
1076 * After calling this function, most of the restrictions on the interpreter
1077 * are lifted. The only remaining incomplete settings are those related
1078 * to the main module (sys.argv[0], __main__ metadata)
1079 *
1080 * Calling this when the interpreter is not initializing, is already
1081 * initialized or without a valid current thread state is a fatal error.
1082 * Other errors should be reported as normal Python exceptions with a
1083 * non-zero return code.
1084 */
Victor Stinner331a6a52019-05-27 16:39:22 +02001085static PyStatus
Victor Stinner01b1cc12019-11-20 02:27:56 +01001086pyinit_main(PyThreadState *tstate)
Eric Snow1abcf672017-05-23 21:46:51 -07001087{
Victor Stinnerb0051362019-11-22 17:52:42 +01001088 PyInterpreterState *interp = tstate->interp;
1089 if (!interp->runtime->core_initialized) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001090 return _PyStatus_ERR("runtime core not initialized");
Eric Snowc7ec9982017-05-23 23:00:52 -07001091 }
Eric Snowc7ec9982017-05-23 23:00:52 -07001092
Victor Stinnerb0051362019-11-22 17:52:42 +01001093 if (interp->runtime->initialized) {
1094 return _Py_ReconfigureMainInterpreter(tstate);
Victor Stinnerfb47bca2018-07-20 17:34:23 +02001095 }
1096
Victor Stinnerb0051362019-11-22 17:52:42 +01001097 PyStatus status = init_interp_main(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +02001098 if (_PyStatus_EXCEPTION(status)) {
1099 return status;
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001100 }
Victor Stinner331a6a52019-05-27 16:39:22 +02001101 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +10001102}
1103
Victor Stinner9ef5dca2019-05-16 17:38:16 +02001104
Victor Stinner331a6a52019-05-27 16:39:22 +02001105PyStatus
Victor Stinner9ef5dca2019-05-16 17:38:16 +02001106_Py_InitializeMain(void)
1107{
Victor Stinner331a6a52019-05-27 16:39:22 +02001108 PyStatus status = _PyRuntime_Initialize();
1109 if (_PyStatus_EXCEPTION(status)) {
1110 return status;
Victor Stinner9ef5dca2019-05-16 17:38:16 +02001111 }
1112 _PyRuntimeState *runtime = &_PyRuntime;
Victor Stinnerb45d2592019-06-20 00:05:23 +02001113 PyThreadState *tstate = _PyRuntimeState_GetThreadState(runtime);
Victor Stinner01b1cc12019-11-20 02:27:56 +01001114 return pyinit_main(tstate);
Victor Stinner9ef5dca2019-05-16 17:38:16 +02001115}
1116
1117
Victor Stinner331a6a52019-05-27 16:39:22 +02001118PyStatus
1119Py_InitializeFromConfig(const PyConfig *config)
Eric Snow1abcf672017-05-23 21:46:51 -07001120{
Victor Stinner6d1c4672019-05-20 11:02:00 +02001121 if (config == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001122 return _PyStatus_ERR("initialization config is NULL");
Victor Stinner6d1c4672019-05-20 11:02:00 +02001123 }
1124
Victor Stinner331a6a52019-05-27 16:39:22 +02001125 PyStatus status;
Victor Stinner43125222019-04-24 18:23:53 +02001126
Victor Stinner331a6a52019-05-27 16:39:22 +02001127 status = _PyRuntime_Initialize();
1128 if (_PyStatus_EXCEPTION(status)) {
1129 return status;
Victor Stinner43125222019-04-24 18:23:53 +02001130 }
1131 _PyRuntimeState *runtime = &_PyRuntime;
1132
Victor Stinnerb45d2592019-06-20 00:05:23 +02001133 PyThreadState *tstate = NULL;
1134 status = pyinit_core(runtime, config, &tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +02001135 if (_PyStatus_EXCEPTION(status)) {
1136 return status;
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001137 }
Victor Stinnerda7933e2020-04-13 03:04:28 +02001138 config = _PyInterpreterState_GetConfig(tstate->interp);
Victor Stinnerbc8ac6b2017-11-30 18:03:55 +01001139
Victor Stinner9ef5dca2019-05-16 17:38:16 +02001140 if (config->_init_main) {
Victor Stinner01b1cc12019-11-20 02:27:56 +01001141 status = pyinit_main(tstate);
Victor Stinner331a6a52019-05-27 16:39:22 +02001142 if (_PyStatus_EXCEPTION(status)) {
1143 return status;
Victor Stinner484f20d2019-03-27 02:04:16 +01001144 }
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001145 }
Victor Stinner484f20d2019-03-27 02:04:16 +01001146
Victor Stinner331a6a52019-05-27 16:39:22 +02001147 return _PyStatus_OK();
Victor Stinner5ac27a52019-03-27 13:40:14 +01001148}
1149
1150
Eric Snow1abcf672017-05-23 21:46:51 -07001151void
Nick Coghland6009512014-11-20 21:39:37 +10001152Py_InitializeEx(int install_sigs)
1153{
Victor Stinner331a6a52019-05-27 16:39:22 +02001154 PyStatus status;
Victor Stinner43125222019-04-24 18:23:53 +02001155
Victor Stinner331a6a52019-05-27 16:39:22 +02001156 status = _PyRuntime_Initialize();
1157 if (_PyStatus_EXCEPTION(status)) {
1158 Py_ExitStatusException(status);
Victor Stinner43125222019-04-24 18:23:53 +02001159 }
1160 _PyRuntimeState *runtime = &_PyRuntime;
1161
1162 if (runtime->initialized) {
Victor Stinner1dc6e392018-07-25 02:49:17 +02001163 /* bpo-33932: Calling Py_Initialize() twice does nothing. */
1164 return;
1165 }
1166
Victor Stinner331a6a52019-05-27 16:39:22 +02001167 PyConfig config;
Victor Stinner8462a492019-10-01 12:06:16 +02001168 _PyConfig_InitCompatConfig(&config);
Victor Stinner441b10c2019-09-28 04:28:35 +02001169
Victor Stinner1dc6e392018-07-25 02:49:17 +02001170 config.install_signal_handlers = install_sigs;
1171
Victor Stinner331a6a52019-05-27 16:39:22 +02001172 status = Py_InitializeFromConfig(&config);
1173 if (_PyStatus_EXCEPTION(status)) {
1174 Py_ExitStatusException(status);
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001175 }
Nick Coghland6009512014-11-20 21:39:37 +10001176}
1177
1178void
1179Py_Initialize(void)
1180{
1181 Py_InitializeEx(1);
1182}
1183
1184
Nick Coghland6009512014-11-20 21:39:37 +10001185/* Flush stdout and stderr */
1186
1187static int
1188file_is_closed(PyObject *fobj)
1189{
1190 int r;
1191 PyObject *tmp = PyObject_GetAttrString(fobj, "closed");
1192 if (tmp == NULL) {
1193 PyErr_Clear();
1194 return 0;
1195 }
1196 r = PyObject_IsTrue(tmp);
1197 Py_DECREF(tmp);
1198 if (r < 0)
1199 PyErr_Clear();
1200 return r > 0;
1201}
1202
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001203static int
Nick Coghland6009512014-11-20 21:39:37 +10001204flush_std_files(void)
1205{
1206 PyObject *fout = _PySys_GetObjectId(&PyId_stdout);
1207 PyObject *ferr = _PySys_GetObjectId(&PyId_stderr);
1208 PyObject *tmp;
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001209 int status = 0;
Nick Coghland6009512014-11-20 21:39:37 +10001210
1211 if (fout != NULL && fout != Py_None && !file_is_closed(fout)) {
Jeroen Demeyer762f93f2019-07-08 10:19:25 +02001212 tmp = _PyObject_CallMethodIdNoArgs(fout, &PyId_flush);
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001213 if (tmp == NULL) {
Nick Coghland6009512014-11-20 21:39:37 +10001214 PyErr_WriteUnraisable(fout);
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001215 status = -1;
1216 }
Nick Coghland6009512014-11-20 21:39:37 +10001217 else
1218 Py_DECREF(tmp);
1219 }
1220
1221 if (ferr != NULL && ferr != Py_None && !file_is_closed(ferr)) {
Jeroen Demeyer762f93f2019-07-08 10:19:25 +02001222 tmp = _PyObject_CallMethodIdNoArgs(ferr, &PyId_flush);
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001223 if (tmp == NULL) {
Nick Coghland6009512014-11-20 21:39:37 +10001224 PyErr_Clear();
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001225 status = -1;
1226 }
Nick Coghland6009512014-11-20 21:39:37 +10001227 else
1228 Py_DECREF(tmp);
1229 }
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001230
1231 return status;
Nick Coghland6009512014-11-20 21:39:37 +10001232}
1233
1234/* Undo the effect of Py_Initialize().
1235
1236 Beware: if multiple interpreter and/or thread states exist, these
1237 are not wiped out; only the current thread and interpreter state
1238 are deleted. But since everything else is deleted, those other
1239 interpreter and thread states should no longer be used.
1240
1241 (XXX We should do better, e.g. wipe out all interpreters and
1242 threads.)
1243
1244 Locking: as above.
1245
1246*/
1247
Victor Stinner7eee5be2019-11-20 10:38:34 +01001248
1249static void
1250finalize_interp_types(PyThreadState *tstate, int is_main_interp)
1251{
Victor Stinner3744ed22020-06-05 01:39:24 +02001252 _PyFrame_Fini(tstate);
Victor Stinner78a02c22020-06-05 02:34:14 +02001253 _PyAsyncGen_Fini(tstate);
Victor Stinnere005ead2020-06-05 02:56:37 +02001254 _PyContext_Fini(tstate);
Victor Stinner7eee5be2019-11-20 10:38:34 +01001255
Victor Stinner261cfed2020-06-23 14:07:52 +02001256 _PySet_Fini(tstate);
Victor Stinnerb4e85ca2020-06-23 11:33:18 +02001257 _PyDict_Fini(tstate);
Victor Stinner7907f8c2020-06-08 01:22:36 +02001258 _PyList_Fini(tstate);
1259 _PyTuple_Fini(tstate);
1260
1261 _PySlice_Fini(tstate);
Victor Stinner3d483342019-11-22 12:27:50 +01001262
Victor Stinnerc41eed12020-06-23 15:54:35 +02001263 _PyBytes_Fini(tstate);
Victor Stinner7907f8c2020-06-08 01:22:36 +02001264 _PyUnicode_Fini(tstate);
1265 _PyFloat_Fini(tstate);
1266 _PyLong_Fini(tstate);
Victor Stinner7eee5be2019-11-20 10:38:34 +01001267}
1268
1269
1270static void
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001271finalize_interp_clear(PyThreadState *tstate)
Victor Stinner7eee5be2019-11-20 10:38:34 +01001272{
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001273 int is_main_interp = _Py_IsMainInterpreter(tstate);
1274
Victor Stinner7eee5be2019-11-20 10:38:34 +01001275 /* Clear interpreter state and all thread states */
1276 PyInterpreterState_Clear(tstate->interp);
1277
Pablo Galindoac0e1c22019-12-04 11:51:03 +00001278 /* Trigger a GC collection on subinterpreters*/
1279 if (!is_main_interp) {
1280 _PyGC_CollectNoFail();
1281 }
1282
Victor Stinner88ec9192020-06-05 02:05:41 +02001283 _PyGC_Fini(tstate);
1284
Victor Stinner7907f8c2020-06-08 01:22:36 +02001285 if (is_main_interp) {
1286 _Py_HashRandomization_Fini();
1287 _PyArg_Fini();
1288 _Py_ClearFileSystemEncoding();
1289 }
1290
1291 _PyWarnings_Fini(tstate->interp);
Victor Stinner7eee5be2019-11-20 10:38:34 +01001292
1293 if (is_main_interp) {
Victor Stinner7eee5be2019-11-20 10:38:34 +01001294 _PyExc_Fini();
Victor Stinner7eee5be2019-11-20 10:38:34 +01001295 }
Victor Stinner7907f8c2020-06-08 01:22:36 +02001296
1297 finalize_interp_types(tstate, is_main_interp);
Victor Stinner7eee5be2019-11-20 10:38:34 +01001298}
1299
1300
1301static void
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001302finalize_interp_delete(PyThreadState *tstate)
Victor Stinner7eee5be2019-11-20 10:38:34 +01001303{
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001304 if (_Py_IsMainInterpreter(tstate)) {
Victor Stinner7eee5be2019-11-20 10:38:34 +01001305 /* Cleanup auto-thread-state */
1306 _PyGILState_Fini(tstate);
1307 }
1308
Victor Stinnerdda5d6e2020-04-08 17:54:59 +02001309 /* We can't call _PyEval_FiniGIL() here because destroying the GIL lock can
1310 fail when it is being awaited by another running daemon thread (see
1311 bpo-9901). Instead pycore_create_interpreter() destroys the previously
1312 created GIL, which ensures that Py_Initialize / Py_FinalizeEx can be
1313 called multiple times. */
1314
Victor Stinner7eee5be2019-11-20 10:38:34 +01001315 PyInterpreterState_Delete(tstate->interp);
1316}
1317
1318
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001319int
1320Py_FinalizeEx(void)
Nick Coghland6009512014-11-20 21:39:37 +10001321{
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001322 int status = 0;
Nick Coghland6009512014-11-20 21:39:37 +10001323
Victor Stinner8e91c242019-04-24 17:24:01 +02001324 _PyRuntimeState *runtime = &_PyRuntime;
1325 if (!runtime->initialized) {
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001326 return status;
Victor Stinner8e91c242019-04-24 17:24:01 +02001327 }
Nick Coghland6009512014-11-20 21:39:37 +10001328
Victor Stinnere225beb2019-06-03 18:14:24 +02001329 /* Get current thread state and interpreter pointer */
1330 PyThreadState *tstate = _PyRuntimeState_GetThreadState(runtime);
1331 PyInterpreterState *interp = tstate->interp;
Victor Stinner8e91c242019-04-24 17:24:01 +02001332
Victor Stinnerb45d2592019-06-20 00:05:23 +02001333 // Wrap up existing "threading"-module-created, non-daemon threads.
1334 wait_for_thread_shutdown(tstate);
1335
1336 // Make any remaining pending calls.
Victor Stinner2b1df452020-01-13 18:46:59 +01001337 _Py_FinishPendingCalls(tstate);
Victor Stinnerb45d2592019-06-20 00:05:23 +02001338
Nick Coghland6009512014-11-20 21:39:37 +10001339 /* The interpreter is still entirely intact at this point, and the
1340 * exit funcs may be relying on that. In particular, if some thread
1341 * or exit func is still waiting to do an import, the import machinery
1342 * expects Py_IsInitialized() to return true. So don't say the
Eric Snow842a2f02019-03-15 15:47:51 -06001343 * runtime is uninitialized until after the exit funcs have run.
Nick Coghland6009512014-11-20 21:39:37 +10001344 * Note that Threading.py uses an exit func to do a join on all the
1345 * threads created thru it, so this also protects pending imports in
1346 * the threads created via Threading.
1347 */
Nick Coghland6009512014-11-20 21:39:37 +10001348
Victor Stinnerb45d2592019-06-20 00:05:23 +02001349 call_py_exitfuncs(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001350
Victor Stinnerda273412017-12-15 01:46:02 +01001351 /* Copy the core config, PyInterpreterState_Delete() free
1352 the core config memory */
Victor Stinner5d862462017-12-19 11:35:58 +01001353#ifdef Py_REF_DEBUG
Victor Stinner331a6a52019-05-27 16:39:22 +02001354 int show_ref_count = interp->config.show_ref_count;
Victor Stinner5d862462017-12-19 11:35:58 +01001355#endif
1356#ifdef Py_TRACE_REFS
Victor Stinner331a6a52019-05-27 16:39:22 +02001357 int dump_refs = interp->config.dump_refs;
Victor Stinner5d862462017-12-19 11:35:58 +01001358#endif
1359#ifdef WITH_PYMALLOC
Victor Stinner331a6a52019-05-27 16:39:22 +02001360 int malloc_stats = interp->config.malloc_stats;
Victor Stinner5d862462017-12-19 11:35:58 +01001361#endif
Victor Stinner6bf992a2017-12-06 17:26:10 +01001362
Victor Stinnereb4e2ae2020-03-08 11:57:45 +01001363 /* Remaining daemon threads will automatically exit
1364 when they attempt to take the GIL (ex: PyEval_RestoreThread()). */
Victor Stinner7b3c2522020-03-07 00:24:23 +01001365 _PyRuntimeState_SetFinalizing(runtime, tstate);
Victor Stinner8e91c242019-04-24 17:24:01 +02001366 runtime->initialized = 0;
1367 runtime->core_initialized = 0;
Nick Coghland6009512014-11-20 21:39:37 +10001368
Victor Stinner9ad58ac2020-03-09 23:37:49 +01001369 /* Destroy the state of all threads of the interpreter, except of the
1370 current thread. In practice, only daemon threads should still be alive,
1371 except if wait_for_thread_shutdown() has been cancelled by CTRL+C.
1372 Clear frames of other threads to call objects destructors. Destructors
1373 will be called in the current Python thread. Since
1374 _PyRuntimeState_SetFinalizing() has been called, no other Python thread
1375 can take the GIL at this point: if they try, they will exit
1376 immediately. */
1377 _PyThreadState_DeleteExcept(runtime, tstate);
1378
Victor Stinnere0deff32015-03-24 13:46:18 +01001379 /* Flush sys.stdout and sys.stderr */
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001380 if (flush_std_files() < 0) {
1381 status = -1;
1382 }
Nick Coghland6009512014-11-20 21:39:37 +10001383
1384 /* Disable signal handling */
1385 PyOS_FiniInterrupts();
1386
1387 /* Collect garbage. This may call finalizers; it's nice to call these
1388 * before all modules are destroyed.
1389 * XXX If a __del__ or weakref callback is triggered here, and tries to
1390 * XXX import a module, bad things can happen, because Python no
1391 * XXX longer believes it's initialized.
1392 * XXX Fatal Python error: Interpreter not initialized (version mismatch?)
1393 * XXX is easy to provoke that way. I've also seen, e.g.,
1394 * XXX Exception exceptions.ImportError: 'No module named sha'
1395 * XXX in <function callback at 0x008F5718> ignored
1396 * XXX but I'm unclear on exactly how that one happens. In any case,
1397 * XXX I haven't seen a real-life report of either of these.
1398 */
Łukasz Langafef7e942016-09-09 21:47:46 -07001399 _PyGC_CollectIfEnabled();
Eric Snowdae02762017-09-14 00:35:58 -07001400
Steve Dowerb82e17e2019-05-23 08:45:22 -07001401 /* Clear all loghooks */
Victor Stinner08faf002020-03-26 18:57:32 +01001402 _PySys_ClearAuditHooks(tstate);
Steve Dowerb82e17e2019-05-23 08:45:22 -07001403
Nick Coghland6009512014-11-20 21:39:37 +10001404 /* Destroy all modules */
Victor Stinner987a0dc2019-06-19 10:36:10 +02001405 _PyImport_Cleanup(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001406
Inada Naoki91234a12019-06-03 21:30:58 +09001407 /* Print debug stats if any */
1408 _PyEval_Fini();
1409
Victor Stinnere0deff32015-03-24 13:46:18 +01001410 /* Flush sys.stdout and sys.stderr (again, in case more was printed) */
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001411 if (flush_std_files() < 0) {
1412 status = -1;
1413 }
Nick Coghland6009512014-11-20 21:39:37 +10001414
1415 /* Collect final garbage. This disposes of cycles created by
1416 * class definitions, for example.
1417 * XXX This is disabled because it caused too many problems. If
1418 * XXX a __del__ or weakref callback triggers here, Python code has
1419 * XXX a hard time running, because even the sys module has been
1420 * XXX cleared out (sys.stdout is gone, sys.excepthook is gone, etc).
1421 * XXX One symptom is a sequence of information-free messages
1422 * XXX coming from threads (if a __del__ or callback is invoked,
1423 * XXX other threads can execute too, and any exception they encounter
1424 * XXX triggers a comedy of errors as subsystem after subsystem
1425 * XXX fails to find what it *expects* to find in sys to help report
1426 * XXX the exception and consequent unexpected failures). I've also
1427 * XXX seen segfaults then, after adding print statements to the
1428 * XXX Python code getting called.
1429 */
1430#if 0
Łukasz Langafef7e942016-09-09 21:47:46 -07001431 _PyGC_CollectIfEnabled();
Nick Coghland6009512014-11-20 21:39:37 +10001432#endif
1433
1434 /* Disable tracemalloc after all Python objects have been destroyed,
1435 so it is possible to use tracemalloc in objects destructor. */
1436 _PyTraceMalloc_Fini();
1437
1438 /* Destroy the database used by _PyImport_{Fixup,Find}Extension */
1439 _PyImport_Fini();
1440
1441 /* Cleanup typeobject.c's internal caches. */
1442 _PyType_Fini();
1443
1444 /* unload faulthandler module */
1445 _PyFaulthandler_Fini();
1446
Nick Coghland6009512014-11-20 21:39:37 +10001447 /* dump hash stats */
1448 _PyHash_Fini();
1449
Eric Snowdae02762017-09-14 00:35:58 -07001450#ifdef Py_REF_DEBUG
Victor Stinnerda273412017-12-15 01:46:02 +01001451 if (show_ref_count) {
Victor Stinner25420fe2017-11-20 18:12:22 -08001452 _PyDebug_PrintTotalRefs();
1453 }
Eric Snowdae02762017-09-14 00:35:58 -07001454#endif
Nick Coghland6009512014-11-20 21:39:37 +10001455
1456#ifdef Py_TRACE_REFS
1457 /* Display all objects still alive -- this can invoke arbitrary
1458 * __repr__ overrides, so requires a mostly-intact interpreter.
1459 * Alas, a lot of stuff may still be alive now that will be cleaned
1460 * up later.
1461 */
Victor Stinnerda273412017-12-15 01:46:02 +01001462 if (dump_refs) {
Nick Coghland6009512014-11-20 21:39:37 +10001463 _Py_PrintReferences(stderr);
Victor Stinner6bf992a2017-12-06 17:26:10 +01001464 }
Nick Coghland6009512014-11-20 21:39:37 +10001465#endif /* Py_TRACE_REFS */
1466
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001467 finalize_interp_clear(tstate);
1468 finalize_interp_delete(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001469
1470#ifdef Py_TRACE_REFS
1471 /* Display addresses (& refcnts) of all objects still alive.
1472 * An address can be used to find the repr of the object, printed
1473 * above by _Py_PrintReferences.
1474 */
Victor Stinnerda273412017-12-15 01:46:02 +01001475 if (dump_refs) {
Nick Coghland6009512014-11-20 21:39:37 +10001476 _Py_PrintReferenceAddresses(stderr);
Victor Stinner6bf992a2017-12-06 17:26:10 +01001477 }
Nick Coghland6009512014-11-20 21:39:37 +10001478#endif /* Py_TRACE_REFS */
Victor Stinner34be8072016-03-14 12:04:26 +01001479#ifdef WITH_PYMALLOC
Victor Stinnerda273412017-12-15 01:46:02 +01001480 if (malloc_stats) {
Victor Stinner6bf992a2017-12-06 17:26:10 +01001481 _PyObject_DebugMallocStats(stderr);
Victor Stinner34be8072016-03-14 12:04:26 +01001482 }
Nick Coghland6009512014-11-20 21:39:37 +10001483#endif
1484
Victor Stinner8e91c242019-04-24 17:24:01 +02001485 call_ll_exitfuncs(runtime);
Victor Stinner9316ee42017-11-25 03:17:57 +01001486
Eric Snow2ebc5ce2017-09-07 23:51:28 -06001487 _PyRuntime_Finalize();
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001488 return status;
1489}
1490
1491void
1492Py_Finalize(void)
1493{
1494 Py_FinalizeEx();
Nick Coghland6009512014-11-20 21:39:37 +10001495}
1496
Victor Stinnerb0051362019-11-22 17:52:42 +01001497
Nick Coghland6009512014-11-20 21:39:37 +10001498/* Create and initialize a new interpreter and thread, and return the
1499 new thread. This requires that Py_Initialize() has been called
1500 first.
1501
1502 Unsuccessful initialization yields a NULL pointer. Note that *no*
1503 exception information is available even in this case -- the
1504 exception information is held in the thread, and there is no
1505 thread.
1506
1507 Locking: as above.
1508
1509*/
1510
Victor Stinner331a6a52019-05-27 16:39:22 +02001511static PyStatus
Victor Stinner252346a2020-05-01 11:33:44 +02001512new_interpreter(PyThreadState **tstate_p, int isolated_subinterpreter)
Nick Coghland6009512014-11-20 21:39:37 +10001513{
Victor Stinner331a6a52019-05-27 16:39:22 +02001514 PyStatus status;
Nick Coghland6009512014-11-20 21:39:37 +10001515
Victor Stinner331a6a52019-05-27 16:39:22 +02001516 status = _PyRuntime_Initialize();
1517 if (_PyStatus_EXCEPTION(status)) {
1518 return status;
Victor Stinner43125222019-04-24 18:23:53 +02001519 }
1520 _PyRuntimeState *runtime = &_PyRuntime;
1521
1522 if (!runtime->initialized) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001523 return _PyStatus_ERR("Py_Initialize must be called first");
Victor Stinnera7368ac2017-11-15 18:11:45 -08001524 }
Nick Coghland6009512014-11-20 21:39:37 +10001525
Victor Stinner8a1be612016-03-14 22:07:55 +01001526 /* Issue #10915, #15751: The GIL API doesn't work with multiple
1527 interpreters: disable PyGILState_Check(). */
Victor Stinner1c4cbdf2020-04-13 11:45:21 +02001528 runtime->gilstate.check_enabled = 0;
Victor Stinner8a1be612016-03-14 22:07:55 +01001529
Victor Stinner43125222019-04-24 18:23:53 +02001530 PyInterpreterState *interp = PyInterpreterState_New();
Victor Stinnera7368ac2017-11-15 18:11:45 -08001531 if (interp == NULL) {
1532 *tstate_p = NULL;
Victor Stinner331a6a52019-05-27 16:39:22 +02001533 return _PyStatus_OK();
Victor Stinnera7368ac2017-11-15 18:11:45 -08001534 }
Nick Coghland6009512014-11-20 21:39:37 +10001535
Victor Stinner43125222019-04-24 18:23:53 +02001536 PyThreadState *tstate = PyThreadState_New(interp);
Nick Coghland6009512014-11-20 21:39:37 +10001537 if (tstate == NULL) {
1538 PyInterpreterState_Delete(interp);
Victor Stinnera7368ac2017-11-15 18:11:45 -08001539 *tstate_p = NULL;
Victor Stinner331a6a52019-05-27 16:39:22 +02001540 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +10001541 }
1542
Victor Stinner43125222019-04-24 18:23:53 +02001543 PyThreadState *save_tstate = PyThreadState_Swap(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001544
Eric Snow1abcf672017-05-23 21:46:51 -07001545 /* Copy the current interpreter config into the new interpreter */
Victor Stinnerda7933e2020-04-13 03:04:28 +02001546 const PyConfig *config;
Victor Stinner7be4e352020-05-05 20:27:47 +02001547#ifndef EXPERIMENTAL_ISOLATED_SUBINTERPRETERS
Eric Snow1abcf672017-05-23 21:46:51 -07001548 if (save_tstate != NULL) {
Victor Stinnerda7933e2020-04-13 03:04:28 +02001549 config = _PyInterpreterState_GetConfig(save_tstate->interp);
Victor Stinner7be4e352020-05-05 20:27:47 +02001550 }
1551 else
1552#endif
1553 {
Eric Snow1abcf672017-05-23 21:46:51 -07001554 /* No current thread state, copy from the main interpreter */
1555 PyInterpreterState *main_interp = PyInterpreterState_Main();
Victor Stinnerda7933e2020-04-13 03:04:28 +02001556 config = _PyInterpreterState_GetConfig(main_interp);
Victor Stinnerda273412017-12-15 01:46:02 +01001557 }
1558
Victor Stinnerda7933e2020-04-13 03:04:28 +02001559 status = _PyInterpreterState_SetConfig(interp, config);
Victor Stinner331a6a52019-05-27 16:39:22 +02001560 if (_PyStatus_EXCEPTION(status)) {
Victor Stinner81fe5bd2019-12-06 02:43:30 +01001561 goto error;
Victor Stinnerda273412017-12-15 01:46:02 +01001562 }
Victor Stinner252346a2020-05-01 11:33:44 +02001563 interp->config._isolated_interpreter = isolated_subinterpreter;
Eric Snow1abcf672017-05-23 21:46:51 -07001564
Victor Stinner0dd5e7a2020-05-05 20:16:37 +02001565 status = init_interp_create_gil(tstate);
1566 if (_PyStatus_EXCEPTION(status)) {
1567 goto error;
1568 }
1569
Victor Stinnerd863ade2019-12-06 03:37:07 +01001570 status = pycore_interp_init(tstate);
Victor Stinner81fe5bd2019-12-06 02:43:30 +01001571 if (_PyStatus_EXCEPTION(status)) {
1572 goto error;
Nick Coghland6009512014-11-20 21:39:37 +10001573 }
1574
Victor Stinner81fe5bd2019-12-06 02:43:30 +01001575 status = init_interp_main(tstate);
1576 if (_PyStatus_EXCEPTION(status)) {
1577 goto error;
Victor Stinnera7368ac2017-11-15 18:11:45 -08001578 }
Nick Coghland6009512014-11-20 21:39:37 +10001579
Victor Stinnera7368ac2017-11-15 18:11:45 -08001580 *tstate_p = tstate;
Victor Stinner331a6a52019-05-27 16:39:22 +02001581 return _PyStatus_OK();
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001582
Victor Stinner81fe5bd2019-12-06 02:43:30 +01001583error:
Victor Stinnerb0051362019-11-22 17:52:42 +01001584 *tstate_p = NULL;
1585
1586 /* Oops, it didn't work. Undo it all. */
Nick Coghland6009512014-11-20 21:39:37 +10001587 PyErr_PrintEx(0);
1588 PyThreadState_Clear(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001589 PyThreadState_Delete(tstate);
1590 PyInterpreterState_Delete(interp);
Victor Stinner9da74302019-11-20 11:17:17 +01001591 PyThreadState_Swap(save_tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001592
Victor Stinnerb0051362019-11-22 17:52:42 +01001593 return status;
Victor Stinnera7368ac2017-11-15 18:11:45 -08001594}
1595
1596PyThreadState *
Victor Stinner252346a2020-05-01 11:33:44 +02001597_Py_NewInterpreter(int isolated_subinterpreter)
Victor Stinnera7368ac2017-11-15 18:11:45 -08001598{
Stéphane Wirtel9e06d2b2019-03-18 17:10:29 +01001599 PyThreadState *tstate = NULL;
Victor Stinner252346a2020-05-01 11:33:44 +02001600 PyStatus status = new_interpreter(&tstate, isolated_subinterpreter);
Victor Stinner331a6a52019-05-27 16:39:22 +02001601 if (_PyStatus_EXCEPTION(status)) {
1602 Py_ExitStatusException(status);
Victor Stinnera7368ac2017-11-15 18:11:45 -08001603 }
1604 return tstate;
1605
Nick Coghland6009512014-11-20 21:39:37 +10001606}
1607
Victor Stinner252346a2020-05-01 11:33:44 +02001608PyThreadState *
1609Py_NewInterpreter(void)
1610{
1611 return _Py_NewInterpreter(0);
1612}
1613
Nick Coghland6009512014-11-20 21:39:37 +10001614/* Delete an interpreter and its last thread. This requires that the
1615 given thread state is current, that the thread has no remaining
1616 frames, and that it is its interpreter's only remaining thread.
1617 It is a fatal error to violate these constraints.
1618
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001619 (Py_FinalizeEx() doesn't have these constraints -- it zaps
Nick Coghland6009512014-11-20 21:39:37 +10001620 everything, regardless.)
1621
1622 Locking: as above.
1623
1624*/
1625
1626void
1627Py_EndInterpreter(PyThreadState *tstate)
1628{
1629 PyInterpreterState *interp = tstate->interp;
1630
Victor Stinnerb45d2592019-06-20 00:05:23 +02001631 if (tstate != _PyThreadState_GET()) {
Victor Stinner9e5d30c2020-03-07 00:54:20 +01001632 Py_FatalError("thread is not current");
Victor Stinnerb45d2592019-06-20 00:05:23 +02001633 }
1634 if (tstate->frame != NULL) {
Victor Stinner9e5d30c2020-03-07 00:54:20 +01001635 Py_FatalError("thread still has a frame");
Victor Stinnerb45d2592019-06-20 00:05:23 +02001636 }
Eric Snow5be45a62019-03-08 22:47:07 -07001637 interp->finalizing = 1;
Nick Coghland6009512014-11-20 21:39:37 +10001638
Eric Snow842a2f02019-03-15 15:47:51 -06001639 // Wrap up existing "threading"-module-created, non-daemon threads.
Victor Stinnerb45d2592019-06-20 00:05:23 +02001640 wait_for_thread_shutdown(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001641
Victor Stinnerb45d2592019-06-20 00:05:23 +02001642 call_py_exitfuncs(tstate);
Marcel Plch776407f2017-12-20 11:17:58 +01001643
Victor Stinnerb45d2592019-06-20 00:05:23 +02001644 if (tstate != interp->tstate_head || tstate->next != NULL) {
Victor Stinner9e5d30c2020-03-07 00:54:20 +01001645 Py_FatalError("not the last thread");
Victor Stinnerb45d2592019-06-20 00:05:23 +02001646 }
Nick Coghland6009512014-11-20 21:39:37 +10001647
Victor Stinner987a0dc2019-06-19 10:36:10 +02001648 _PyImport_Cleanup(tstate);
Victor Stinnerb93f31f2019-11-20 18:39:12 +01001649 finalize_interp_clear(tstate);
1650 finalize_interp_delete(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10001651}
1652
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001653/* Add the __main__ module */
Nick Coghland6009512014-11-20 21:39:37 +10001654
Victor Stinner331a6a52019-05-27 16:39:22 +02001655static PyStatus
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001656add_main_module(PyInterpreterState *interp)
Nick Coghland6009512014-11-20 21:39:37 +10001657{
Yury Selivanovf8cb8a12016-09-08 20:50:03 -07001658 PyObject *m, *d, *loader, *ann_dict;
Nick Coghland6009512014-11-20 21:39:37 +10001659 m = PyImport_AddModule("__main__");
1660 if (m == NULL)
Victor Stinner331a6a52019-05-27 16:39:22 +02001661 return _PyStatus_ERR("can't create __main__ module");
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001662
Nick Coghland6009512014-11-20 21:39:37 +10001663 d = PyModule_GetDict(m);
Yury Selivanovf8cb8a12016-09-08 20:50:03 -07001664 ann_dict = PyDict_New();
1665 if ((ann_dict == NULL) ||
1666 (PyDict_SetItemString(d, "__annotations__", ann_dict) < 0)) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001667 return _PyStatus_ERR("Failed to initialize __main__.__annotations__");
Yury Selivanovf8cb8a12016-09-08 20:50:03 -07001668 }
1669 Py_DECREF(ann_dict);
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001670
Nick Coghland6009512014-11-20 21:39:37 +10001671 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
1672 PyObject *bimod = PyImport_ImportModule("builtins");
1673 if (bimod == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001674 return _PyStatus_ERR("Failed to retrieve builtins module");
Nick Coghland6009512014-11-20 21:39:37 +10001675 }
1676 if (PyDict_SetItemString(d, "__builtins__", bimod) < 0) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001677 return _PyStatus_ERR("Failed to initialize __main__.__builtins__");
Nick Coghland6009512014-11-20 21:39:37 +10001678 }
1679 Py_DECREF(bimod);
1680 }
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001681
Nick Coghland6009512014-11-20 21:39:37 +10001682 /* Main is a little special - imp.is_builtin("__main__") will return
1683 * False, but BuiltinImporter is still the most appropriate initial
1684 * setting for its __loader__ attribute. A more suitable value will
1685 * be set if __main__ gets further initialized later in the startup
1686 * process.
1687 */
1688 loader = PyDict_GetItemString(d, "__loader__");
1689 if (loader == NULL || loader == Py_None) {
1690 PyObject *loader = PyObject_GetAttrString(interp->importlib,
1691 "BuiltinImporter");
1692 if (loader == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001693 return _PyStatus_ERR("Failed to retrieve BuiltinImporter");
Nick Coghland6009512014-11-20 21:39:37 +10001694 }
1695 if (PyDict_SetItemString(d, "__loader__", loader) < 0) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001696 return _PyStatus_ERR("Failed to initialize __main__.__loader__");
Nick Coghland6009512014-11-20 21:39:37 +10001697 }
1698 Py_DECREF(loader);
1699 }
Victor Stinner331a6a52019-05-27 16:39:22 +02001700 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +10001701}
1702
Nick Coghland6009512014-11-20 21:39:37 +10001703/* Import the site module (not into __main__ though) */
1704
Victor Stinner331a6a52019-05-27 16:39:22 +02001705static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +02001706init_import_site(void)
Nick Coghland6009512014-11-20 21:39:37 +10001707{
1708 PyObject *m;
1709 m = PyImport_ImportModule("site");
1710 if (m == NULL) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001711 return _PyStatus_ERR("Failed to import the site module");
Nick Coghland6009512014-11-20 21:39:37 +10001712 }
Victor Stinnerf7e5b562017-11-15 15:48:08 -08001713 Py_DECREF(m);
Victor Stinner331a6a52019-05-27 16:39:22 +02001714 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +10001715}
1716
Victor Stinner874dbe82015-09-04 17:29:57 +02001717/* Check if a file descriptor is valid or not.
1718 Return 0 if the file descriptor is invalid, return non-zero otherwise. */
1719static int
1720is_valid_fd(int fd)
1721{
Victor Stinner3092d6b2019-04-17 18:09:12 +02001722/* dup() is faster than fstat(): fstat() can require input/output operations,
1723 whereas dup() doesn't. There is a low risk of EMFILE/ENFILE at Python
1724 startup. Problem: dup() doesn't check if the file descriptor is valid on
1725 some platforms.
1726
1727 bpo-30225: On macOS Tiger, when stdout is redirected to a pipe and the other
1728 side of the pipe is closed, dup(1) succeed, whereas fstat(1, &st) fails with
1729 EBADF. FreeBSD has similar issue (bpo-32849).
1730
1731 Only use dup() on platforms where dup() is enough to detect invalid FD in
1732 corner cases: on Linux and Windows (bpo-32849). */
1733#if defined(__linux__) || defined(MS_WINDOWS)
1734 if (fd < 0) {
1735 return 0;
1736 }
1737 int fd2;
1738
1739 _Py_BEGIN_SUPPRESS_IPH
1740 fd2 = dup(fd);
1741 if (fd2 >= 0) {
1742 close(fd2);
1743 }
1744 _Py_END_SUPPRESS_IPH
1745
1746 return (fd2 >= 0);
1747#else
Victor Stinner1c4670e2017-05-04 00:45:56 +02001748 struct stat st;
1749 return (fstat(fd, &st) == 0);
Victor Stinner1c4670e2017-05-04 00:45:56 +02001750#endif
Victor Stinner874dbe82015-09-04 17:29:57 +02001751}
1752
1753/* returns Py_None if the fd is not valid */
Nick Coghland6009512014-11-20 21:39:37 +10001754static PyObject*
Victor Stinner331a6a52019-05-27 16:39:22 +02001755create_stdio(const PyConfig *config, PyObject* io,
Serhiy Storchakaef1585e2015-12-25 20:01:53 +02001756 int fd, int write_mode, const char* name,
Victor Stinner709d23d2019-05-02 14:56:30 -04001757 const wchar_t* encoding, const wchar_t* errors)
Nick Coghland6009512014-11-20 21:39:37 +10001758{
1759 PyObject *buf = NULL, *stream = NULL, *text = NULL, *raw = NULL, *res;
1760 const char* mode;
1761 const char* newline;
Serhiy Storchaka77732be2017-10-04 20:25:40 +03001762 PyObject *line_buffering, *write_through;
Nick Coghland6009512014-11-20 21:39:37 +10001763 int buffering, isatty;
1764 _Py_IDENTIFIER(open);
1765 _Py_IDENTIFIER(isatty);
1766 _Py_IDENTIFIER(TextIOWrapper);
1767 _Py_IDENTIFIER(mode);
Victor Stinnerfbca9082018-08-30 00:50:45 +02001768 const int buffered_stdio = config->buffered_stdio;
Nick Coghland6009512014-11-20 21:39:37 +10001769
Victor Stinner874dbe82015-09-04 17:29:57 +02001770 if (!is_valid_fd(fd))
1771 Py_RETURN_NONE;
1772
Nick Coghland6009512014-11-20 21:39:37 +10001773 /* stdin is always opened in buffered mode, first because it shouldn't
1774 make a difference in common use cases, second because TextIOWrapper
1775 depends on the presence of a read1() method which only exists on
1776 buffered streams.
1777 */
Victor Stinnerfbca9082018-08-30 00:50:45 +02001778 if (!buffered_stdio && write_mode)
Nick Coghland6009512014-11-20 21:39:37 +10001779 buffering = 0;
1780 else
1781 buffering = -1;
1782 if (write_mode)
1783 mode = "wb";
1784 else
1785 mode = "rb";
Serhiy Storchaka1f21eaa2019-09-01 12:16:51 +03001786 buf = _PyObject_CallMethodId(io, &PyId_open, "isiOOOO",
Nick Coghland6009512014-11-20 21:39:37 +10001787 fd, mode, buffering,
Martin Panterb4ce1fc2015-11-30 03:18:29 +00001788 Py_None, Py_None, /* encoding, errors */
Serhiy Storchaka1f21eaa2019-09-01 12:16:51 +03001789 Py_None, Py_False); /* newline, closefd */
Nick Coghland6009512014-11-20 21:39:37 +10001790 if (buf == NULL)
1791 goto error;
1792
1793 if (buffering) {
1794 _Py_IDENTIFIER(raw);
1795 raw = _PyObject_GetAttrId(buf, &PyId_raw);
1796 if (raw == NULL)
1797 goto error;
1798 }
1799 else {
1800 raw = buf;
1801 Py_INCREF(raw);
1802 }
1803
Steve Dower39294992016-08-30 21:22:36 -07001804#ifdef MS_WINDOWS
1805 /* Windows console IO is always UTF-8 encoded */
1806 if (PyWindowsConsoleIO_Check(raw))
Victor Stinner709d23d2019-05-02 14:56:30 -04001807 encoding = L"utf-8";
Steve Dower39294992016-08-30 21:22:36 -07001808#endif
1809
Nick Coghland6009512014-11-20 21:39:37 +10001810 text = PyUnicode_FromString(name);
1811 if (text == NULL || _PyObject_SetAttrId(raw, &PyId_name, text) < 0)
1812 goto error;
Jeroen Demeyer762f93f2019-07-08 10:19:25 +02001813 res = _PyObject_CallMethodIdNoArgs(raw, &PyId_isatty);
Nick Coghland6009512014-11-20 21:39:37 +10001814 if (res == NULL)
1815 goto error;
1816 isatty = PyObject_IsTrue(res);
1817 Py_DECREF(res);
1818 if (isatty == -1)
1819 goto error;
Victor Stinnerfbca9082018-08-30 00:50:45 +02001820 if (!buffered_stdio)
Serhiy Storchaka77732be2017-10-04 20:25:40 +03001821 write_through = Py_True;
1822 else
1823 write_through = Py_False;
Jendrik Seipp5b907712020-01-01 23:21:43 +01001824 if (buffered_stdio && (isatty || fd == fileno(stderr)))
Nick Coghland6009512014-11-20 21:39:37 +10001825 line_buffering = Py_True;
1826 else
1827 line_buffering = Py_False;
1828
1829 Py_CLEAR(raw);
1830 Py_CLEAR(text);
1831
1832#ifdef MS_WINDOWS
1833 /* sys.stdin: enable universal newline mode, translate "\r\n" and "\r"
1834 newlines to "\n".
1835 sys.stdout and sys.stderr: translate "\n" to "\r\n". */
1836 newline = NULL;
1837#else
1838 /* sys.stdin: split lines at "\n".
1839 sys.stdout and sys.stderr: don't translate newlines (use "\n"). */
1840 newline = "\n";
1841#endif
1842
Victor Stinner709d23d2019-05-02 14:56:30 -04001843 PyObject *encoding_str = PyUnicode_FromWideChar(encoding, -1);
1844 if (encoding_str == NULL) {
1845 Py_CLEAR(buf);
1846 goto error;
1847 }
1848
1849 PyObject *errors_str = PyUnicode_FromWideChar(errors, -1);
1850 if (errors_str == NULL) {
1851 Py_CLEAR(buf);
1852 Py_CLEAR(encoding_str);
1853 goto error;
1854 }
1855
1856 stream = _PyObject_CallMethodId(io, &PyId_TextIOWrapper, "OOOsOO",
1857 buf, encoding_str, errors_str,
Serhiy Storchaka77732be2017-10-04 20:25:40 +03001858 newline, line_buffering, write_through);
Nick Coghland6009512014-11-20 21:39:37 +10001859 Py_CLEAR(buf);
Victor Stinner709d23d2019-05-02 14:56:30 -04001860 Py_CLEAR(encoding_str);
1861 Py_CLEAR(errors_str);
Nick Coghland6009512014-11-20 21:39:37 +10001862 if (stream == NULL)
1863 goto error;
1864
1865 if (write_mode)
1866 mode = "w";
1867 else
1868 mode = "r";
1869 text = PyUnicode_FromString(mode);
1870 if (!text || _PyObject_SetAttrId(stream, &PyId_mode, text) < 0)
1871 goto error;
1872 Py_CLEAR(text);
1873 return stream;
1874
1875error:
1876 Py_XDECREF(buf);
1877 Py_XDECREF(stream);
1878 Py_XDECREF(text);
1879 Py_XDECREF(raw);
Nick Coghland6009512014-11-20 21:39:37 +10001880
Victor Stinner874dbe82015-09-04 17:29:57 +02001881 if (PyErr_ExceptionMatches(PyExc_OSError) && !is_valid_fd(fd)) {
1882 /* Issue #24891: the file descriptor was closed after the first
1883 is_valid_fd() check was called. Ignore the OSError and set the
1884 stream to None. */
1885 PyErr_Clear();
1886 Py_RETURN_NONE;
1887 }
1888 return NULL;
Nick Coghland6009512014-11-20 21:39:37 +10001889}
1890
Victor Stinnere0c9ab82019-11-22 16:19:14 +01001891/* Set builtins.open to io.OpenWrapper */
1892static PyStatus
Andy Lester75cd5bf2020-03-12 02:49:05 -05001893init_set_builtins_open(void)
Victor Stinnere0c9ab82019-11-22 16:19:14 +01001894{
1895 PyObject *iomod = NULL, *wrapper;
1896 PyObject *bimod = NULL;
1897 PyStatus res = _PyStatus_OK();
1898
1899 if (!(iomod = PyImport_ImportModule("io"))) {
1900 goto error;
1901 }
1902
1903 if (!(bimod = PyImport_ImportModule("builtins"))) {
1904 goto error;
1905 }
1906
1907 if (!(wrapper = PyObject_GetAttrString(iomod, "OpenWrapper"))) {
1908 goto error;
1909 }
1910
1911 /* Set builtins.open */
1912 if (PyObject_SetAttrString(bimod, "open", wrapper) == -1) {
1913 Py_DECREF(wrapper);
1914 goto error;
1915 }
1916 Py_DECREF(wrapper);
1917 goto done;
1918
1919error:
1920 res = _PyStatus_ERR("can't initialize io.open");
1921
1922done:
1923 Py_XDECREF(bimod);
1924 Py_XDECREF(iomod);
1925 return res;
1926}
1927
1928
Nick Coghland6009512014-11-20 21:39:37 +10001929/* Initialize sys.stdin, stdout, stderr and builtins.open */
Victor Stinner331a6a52019-05-27 16:39:22 +02001930static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +02001931init_sys_streams(PyThreadState *tstate)
Nick Coghland6009512014-11-20 21:39:37 +10001932{
Victor Stinnere0c9ab82019-11-22 16:19:14 +01001933 PyObject *iomod = NULL;
Nick Coghland6009512014-11-20 21:39:37 +10001934 PyObject *std = NULL;
Victor Stinnera7368ac2017-11-15 18:11:45 -08001935 int fd;
Nick Coghland6009512014-11-20 21:39:37 +10001936 PyObject * encoding_attr;
Victor Stinner331a6a52019-05-27 16:39:22 +02001937 PyStatus res = _PyStatus_OK();
Victor Stinnerda7933e2020-04-13 03:04:28 +02001938 const PyConfig *config = _PyInterpreterState_GetConfig(tstate->interp);
Victor Stinnerdfe0dc72018-08-29 11:47:29 +02001939
Victor Stinnerbf4ac2d2019-01-22 17:39:03 +01001940 /* Check that stdin is not a directory
1941 Using shell redirection, you can redirect stdin to a directory,
1942 crashing the Python interpreter. Catch this common mistake here
1943 and output a useful error message. Note that under MS Windows,
1944 the shell already prevents that. */
1945#ifndef MS_WINDOWS
1946 struct _Py_stat_struct sb;
1947 if (_Py_fstat_noraise(fileno(stdin), &sb) == 0 &&
1948 S_ISDIR(sb.st_mode)) {
Victor Stinner331a6a52019-05-27 16:39:22 +02001949 return _PyStatus_ERR("<stdin> is a directory, cannot continue");
Victor Stinnerbf4ac2d2019-01-22 17:39:03 +01001950 }
1951#endif
1952
Nick Coghland6009512014-11-20 21:39:37 +10001953 if (!(iomod = PyImport_ImportModule("io"))) {
1954 goto error;
1955 }
Nick Coghland6009512014-11-20 21:39:37 +10001956
Nick Coghland6009512014-11-20 21:39:37 +10001957 /* Set sys.stdin */
1958 fd = fileno(stdin);
1959 /* Under some conditions stdin, stdout and stderr may not be connected
1960 * and fileno() may point to an invalid file descriptor. For example
1961 * GUI apps don't have valid standard streams by default.
1962 */
Victor Stinnerfbca9082018-08-30 00:50:45 +02001963 std = create_stdio(config, iomod, fd, 0, "<stdin>",
Victor Stinnerdfe0dc72018-08-29 11:47:29 +02001964 config->stdio_encoding,
1965 config->stdio_errors);
Victor Stinner874dbe82015-09-04 17:29:57 +02001966 if (std == NULL)
1967 goto error;
Nick Coghland6009512014-11-20 21:39:37 +10001968 PySys_SetObject("__stdin__", std);
1969 _PySys_SetObjectId(&PyId_stdin, std);
1970 Py_DECREF(std);
1971
1972 /* Set sys.stdout */
1973 fd = fileno(stdout);
Victor Stinnerfbca9082018-08-30 00:50:45 +02001974 std = create_stdio(config, iomod, fd, 1, "<stdout>",
Victor Stinnerdfe0dc72018-08-29 11:47:29 +02001975 config->stdio_encoding,
1976 config->stdio_errors);
Victor Stinner874dbe82015-09-04 17:29:57 +02001977 if (std == NULL)
1978 goto error;
Nick Coghland6009512014-11-20 21:39:37 +10001979 PySys_SetObject("__stdout__", std);
1980 _PySys_SetObjectId(&PyId_stdout, std);
1981 Py_DECREF(std);
1982
1983#if 1 /* Disable this if you have trouble debugging bootstrap stuff */
1984 /* Set sys.stderr, replaces the preliminary stderr */
1985 fd = fileno(stderr);
Victor Stinnerfbca9082018-08-30 00:50:45 +02001986 std = create_stdio(config, iomod, fd, 1, "<stderr>",
Victor Stinnerdfe0dc72018-08-29 11:47:29 +02001987 config->stdio_encoding,
Victor Stinner709d23d2019-05-02 14:56:30 -04001988 L"backslashreplace");
Victor Stinner874dbe82015-09-04 17:29:57 +02001989 if (std == NULL)
1990 goto error;
Nick Coghland6009512014-11-20 21:39:37 +10001991
1992 /* Same as hack above, pre-import stderr's codec to avoid recursion
1993 when import.c tries to write to stderr in verbose mode. */
1994 encoding_attr = PyObject_GetAttrString(std, "encoding");
1995 if (encoding_attr != NULL) {
Serhiy Storchaka85b0f5b2016-11-20 10:16:47 +02001996 const char *std_encoding = PyUnicode_AsUTF8(encoding_attr);
Nick Coghland6009512014-11-20 21:39:37 +10001997 if (std_encoding != NULL) {
1998 PyObject *codec_info = _PyCodec_Lookup(std_encoding);
1999 Py_XDECREF(codec_info);
2000 }
2001 Py_DECREF(encoding_attr);
2002 }
Victor Stinnerb45d2592019-06-20 00:05:23 +02002003 _PyErr_Clear(tstate); /* Not a fatal error if codec isn't available */
Nick Coghland6009512014-11-20 21:39:37 +10002004
2005 if (PySys_SetObject("__stderr__", std) < 0) {
2006 Py_DECREF(std);
2007 goto error;
2008 }
2009 if (_PySys_SetObjectId(&PyId_stderr, std) < 0) {
2010 Py_DECREF(std);
2011 goto error;
2012 }
2013 Py_DECREF(std);
2014#endif
2015
Victor Stinnera7368ac2017-11-15 18:11:45 -08002016 goto done;
Nick Coghland6009512014-11-20 21:39:37 +10002017
Victor Stinnera7368ac2017-11-15 18:11:45 -08002018error:
Victor Stinner331a6a52019-05-27 16:39:22 +02002019 res = _PyStatus_ERR("can't initialize sys standard streams");
Victor Stinnera7368ac2017-11-15 18:11:45 -08002020
2021done:
Victor Stinner124b9eb2018-08-29 01:29:06 +02002022 _Py_ClearStandardStreamEncoding();
Nick Coghland6009512014-11-20 21:39:37 +10002023 Py_XDECREF(iomod);
Victor Stinnera7368ac2017-11-15 18:11:45 -08002024 return res;
Nick Coghland6009512014-11-20 21:39:37 +10002025}
2026
2027
Victor Stinner10dc4842015-03-24 12:01:30 +01002028static void
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002029_Py_FatalError_DumpTracebacks(int fd, PyInterpreterState *interp,
2030 PyThreadState *tstate)
Victor Stinner10dc4842015-03-24 12:01:30 +01002031{
Victor Stinner10dc4842015-03-24 12:01:30 +01002032 fputc('\n', stderr);
2033 fflush(stderr);
2034
2035 /* display the current Python stack */
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002036 _Py_DumpTracebackThreads(fd, interp, tstate);
Victor Stinner10dc4842015-03-24 12:01:30 +01002037}
Victor Stinner791da1c2016-03-14 16:53:12 +01002038
2039/* Print the current exception (if an exception is set) with its traceback,
2040 or display the current Python stack.
2041
2042 Don't call PyErr_PrintEx() and the except hook, because Py_FatalError() is
2043 called on catastrophic cases.
2044
2045 Return 1 if the traceback was displayed, 0 otherwise. */
2046
2047static int
Andy Lester75cd5bf2020-03-12 02:49:05 -05002048_Py_FatalError_PrintExc(PyThreadState *tstate)
Victor Stinner791da1c2016-03-14 16:53:12 +01002049{
2050 PyObject *ferr, *res;
2051 PyObject *exception, *v, *tb;
2052 int has_tb;
2053
Victor Stinnerb45d2592019-06-20 00:05:23 +02002054 _PyErr_Fetch(tstate, &exception, &v, &tb);
Victor Stinner791da1c2016-03-14 16:53:12 +01002055 if (exception == NULL) {
2056 /* No current exception */
2057 return 0;
2058 }
2059
2060 ferr = _PySys_GetObjectId(&PyId_stderr);
2061 if (ferr == NULL || ferr == Py_None) {
2062 /* sys.stderr is not set yet or set to None,
2063 no need to try to display the exception */
2064 return 0;
2065 }
2066
Victor Stinnerb45d2592019-06-20 00:05:23 +02002067 _PyErr_NormalizeException(tstate, &exception, &v, &tb);
Victor Stinner791da1c2016-03-14 16:53:12 +01002068 if (tb == NULL) {
2069 tb = Py_None;
2070 Py_INCREF(tb);
2071 }
2072 PyException_SetTraceback(v, tb);
2073 if (exception == NULL) {
2074 /* PyErr_NormalizeException() failed */
2075 return 0;
2076 }
2077
2078 has_tb = (tb != Py_None);
2079 PyErr_Display(exception, v, tb);
2080 Py_XDECREF(exception);
2081 Py_XDECREF(v);
2082 Py_XDECREF(tb);
2083
2084 /* sys.stderr may be buffered: call sys.stderr.flush() */
Jeroen Demeyer762f93f2019-07-08 10:19:25 +02002085 res = _PyObject_CallMethodIdNoArgs(ferr, &PyId_flush);
Victor Stinnerb45d2592019-06-20 00:05:23 +02002086 if (res == NULL) {
2087 _PyErr_Clear(tstate);
2088 }
2089 else {
Victor Stinner791da1c2016-03-14 16:53:12 +01002090 Py_DECREF(res);
Victor Stinnerb45d2592019-06-20 00:05:23 +02002091 }
Victor Stinner791da1c2016-03-14 16:53:12 +01002092
2093 return has_tb;
2094}
2095
Nick Coghland6009512014-11-20 21:39:37 +10002096/* Print fatal error message and abort */
2097
Victor Stinner8d5a3aa2017-10-04 09:50:12 -07002098#ifdef MS_WINDOWS
2099static void
2100fatal_output_debug(const char *msg)
2101{
2102 /* buffer of 256 bytes allocated on the stack */
2103 WCHAR buffer[256 / sizeof(WCHAR)];
2104 size_t buflen = Py_ARRAY_LENGTH(buffer) - 1;
2105 size_t msglen;
2106
2107 OutputDebugStringW(L"Fatal Python error: ");
2108
2109 msglen = strlen(msg);
2110 while (msglen) {
2111 size_t i;
2112
2113 if (buflen > msglen) {
2114 buflen = msglen;
2115 }
2116
2117 /* Convert the message to wchar_t. This uses a simple one-to-one
2118 conversion, assuming that the this error message actually uses
2119 ASCII only. If this ceases to be true, we will have to convert. */
2120 for (i=0; i < buflen; ++i) {
2121 buffer[i] = msg[i];
2122 }
2123 buffer[i] = L'\0';
2124 OutputDebugStringW(buffer);
2125
2126 msg += buflen;
2127 msglen -= buflen;
2128 }
2129 OutputDebugStringW(L"\n");
2130}
2131#endif
2132
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002133
2134static void
2135fatal_error_dump_runtime(FILE *stream, _PyRuntimeState *runtime)
2136{
2137 fprintf(stream, "Python runtime state: ");
Victor Stinner7b3c2522020-03-07 00:24:23 +01002138 PyThreadState *finalizing = _PyRuntimeState_GetFinalizing(runtime);
2139 if (finalizing) {
2140 fprintf(stream, "finalizing (tstate=%p)", finalizing);
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002141 }
2142 else if (runtime->initialized) {
2143 fprintf(stream, "initialized");
2144 }
2145 else if (runtime->core_initialized) {
2146 fprintf(stream, "core initialized");
2147 }
2148 else if (runtime->preinitialized) {
2149 fprintf(stream, "preinitialized");
2150 }
2151 else if (runtime->preinitializing) {
2152 fprintf(stream, "preinitializing");
2153 }
2154 else {
2155 fprintf(stream, "unknown");
2156 }
2157 fprintf(stream, "\n");
2158 fflush(stream);
2159}
2160
2161
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002162static inline void _Py_NO_RETURN
2163fatal_error_exit(int status)
Nick Coghland6009512014-11-20 21:39:37 +10002164{
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002165 if (status < 0) {
2166#if defined(MS_WINDOWS) && defined(_DEBUG)
2167 DebugBreak();
2168#endif
2169 abort();
2170 }
2171 else {
2172 exit(status);
2173 }
2174}
2175
2176
2177static void _Py_NO_RETURN
2178fatal_error(FILE *stream, int header, const char *prefix, const char *msg,
2179 int status)
2180{
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002181 const int fd = fileno(stream);
Victor Stinner53345a42015-03-25 01:55:14 +01002182 static int reentrant = 0;
Victor Stinner53345a42015-03-25 01:55:14 +01002183
2184 if (reentrant) {
2185 /* Py_FatalError() caused a second fatal error.
2186 Example: flush_std_files() raises a recursion error. */
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002187 fatal_error_exit(status);
Victor Stinner53345a42015-03-25 01:55:14 +01002188 }
2189 reentrant = 1;
Nick Coghland6009512014-11-20 21:39:37 +10002190
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002191 if (header) {
2192 fprintf(stream, "Fatal Python error: ");
2193 if (prefix) {
2194 fputs(prefix, stream);
2195 fputs(": ", stream);
2196 }
2197 if (msg) {
2198 fputs(msg, stream);
2199 }
2200 else {
2201 fprintf(stream, "<message not set>");
2202 }
2203 fputs("\n", stream);
2204 fflush(stream);
Victor Stinnerf7e5b562017-11-15 15:48:08 -08002205 }
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002206
2207 _PyRuntimeState *runtime = &_PyRuntime;
2208 fatal_error_dump_runtime(stream, runtime);
2209
2210 PyThreadState *tstate = _PyRuntimeState_GetThreadState(runtime);
2211 PyInterpreterState *interp = NULL;
2212 if (tstate != NULL) {
2213 interp = tstate->interp;
2214 }
Victor Stinner10dc4842015-03-24 12:01:30 +01002215
Victor Stinner3a228ab2018-11-01 00:26:41 +01002216 /* Check if the current thread has a Python thread state
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002217 and holds the GIL.
Victor Stinner3a228ab2018-11-01 00:26:41 +01002218
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002219 tss_tstate is NULL if Py_FatalError() is called from a C thread which
2220 has no Python thread state.
2221
2222 tss_tstate != tstate if the current Python thread does not hold the GIL.
2223 */
2224 PyThreadState *tss_tstate = PyGILState_GetThisThreadState();
2225 int has_tstate_and_gil = (tss_tstate != NULL && tss_tstate == tstate);
Victor Stinner3a228ab2018-11-01 00:26:41 +01002226 if (has_tstate_and_gil) {
2227 /* If an exception is set, print the exception with its traceback */
Andy Lester75cd5bf2020-03-12 02:49:05 -05002228 if (!_Py_FatalError_PrintExc(tss_tstate)) {
Victor Stinner3a228ab2018-11-01 00:26:41 +01002229 /* No exception is set, or an exception is set without traceback */
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002230 _Py_FatalError_DumpTracebacks(fd, interp, tss_tstate);
Victor Stinner3a228ab2018-11-01 00:26:41 +01002231 }
2232 }
2233 else {
Victor Stinner1ce16fb2019-09-18 01:35:33 +02002234 _Py_FatalError_DumpTracebacks(fd, interp, tss_tstate);
Victor Stinner8d5a3aa2017-10-04 09:50:12 -07002235 }
Victor Stinner10dc4842015-03-24 12:01:30 +01002236
Victor Stinner8d5a3aa2017-10-04 09:50:12 -07002237 /* The main purpose of faulthandler is to display the traceback.
2238 This function already did its best to display a traceback.
2239 Disable faulthandler to prevent writing a second traceback
2240 on abort(). */
Victor Stinner2025d782016-03-16 23:19:15 +01002241 _PyFaulthandler_Fini();
2242
Victor Stinner791da1c2016-03-14 16:53:12 +01002243 /* Check if the current Python thread hold the GIL */
Victor Stinner3a228ab2018-11-01 00:26:41 +01002244 if (has_tstate_and_gil) {
Victor Stinner791da1c2016-03-14 16:53:12 +01002245 /* Flush sys.stdout and sys.stderr */
2246 flush_std_files();
2247 }
Victor Stinnere0deff32015-03-24 13:46:18 +01002248
Nick Coghland6009512014-11-20 21:39:37 +10002249#ifdef MS_WINDOWS
Victor Stinner8d5a3aa2017-10-04 09:50:12 -07002250 fatal_output_debug(msg);
Victor Stinner53345a42015-03-25 01:55:14 +01002251#endif /* MS_WINDOWS */
2252
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002253 fatal_error_exit(status);
Victor Stinnerf7e5b562017-11-15 15:48:08 -08002254}
2255
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002256
Victor Stinner9e5d30c2020-03-07 00:54:20 +01002257#undef Py_FatalError
2258
Victor Stinner19760862017-12-20 01:41:59 +01002259void _Py_NO_RETURN
Victor Stinnerf7e5b562017-11-15 15:48:08 -08002260Py_FatalError(const char *msg)
2261{
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002262 fatal_error(stderr, 1, NULL, msg, -1);
Victor Stinnerf7e5b562017-11-15 15:48:08 -08002263}
2264
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002265
Victor Stinner19760862017-12-20 01:41:59 +01002266void _Py_NO_RETURN
Victor Stinner9e5d30c2020-03-07 00:54:20 +01002267_Py_FatalErrorFunc(const char *func, const char *msg)
2268{
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002269 fatal_error(stderr, 1, func, msg, -1);
Victor Stinner9e5d30c2020-03-07 00:54:20 +01002270}
2271
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002272
2273void _Py_NO_RETURN
2274_Py_FatalErrorFormat(const char *func, const char *format, ...)
2275{
2276 static int reentrant = 0;
2277 if (reentrant) {
2278 /* _Py_FatalErrorFormat() caused a second fatal error */
2279 fatal_error_exit(-1);
2280 }
2281 reentrant = 1;
2282
2283 FILE *stream = stderr;
2284 fprintf(stream, "Fatal Python error: ");
2285 if (func) {
2286 fputs(func, stream);
2287 fputs(": ", stream);
2288 }
2289 fflush(stream);
2290
2291 va_list vargs;
2292#ifdef HAVE_STDARG_PROTOTYPES
2293 va_start(vargs, format);
2294#else
2295 va_start(vargs);
2296#endif
2297 vfprintf(stream, format, vargs);
2298 va_end(vargs);
2299
2300 fputs("\n", stream);
2301 fflush(stream);
2302
2303 fatal_error(stream, 0, NULL, NULL, -1);
2304}
2305
2306
Victor Stinner9e5d30c2020-03-07 00:54:20 +01002307void _Py_NO_RETURN
Victor Stinner331a6a52019-05-27 16:39:22 +02002308Py_ExitStatusException(PyStatus status)
Victor Stinnerf7e5b562017-11-15 15:48:08 -08002309{
Victor Stinner331a6a52019-05-27 16:39:22 +02002310 if (_PyStatus_IS_EXIT(status)) {
2311 exit(status.exitcode);
Victor Stinnerdbacfc22019-05-16 16:39:26 +02002312 }
Victor Stinner331a6a52019-05-27 16:39:22 +02002313 else if (_PyStatus_IS_ERROR(status)) {
Victor Stinner87d3b9d2020-03-25 19:27:36 +01002314 fatal_error(stderr, 1, status.func, status.err_msg, 1);
Victor Stinnerdfe88472019-03-01 12:14:41 +01002315 }
2316 else {
Victor Stinner331a6a52019-05-27 16:39:22 +02002317 Py_FatalError("Py_ExitStatusException() must not be called on success");
Victor Stinnerdfe88472019-03-01 12:14:41 +01002318 }
Nick Coghland6009512014-11-20 21:39:37 +10002319}
2320
2321/* Clean up and exit */
2322
Nick Coghland6009512014-11-20 21:39:37 +10002323/* For the atexit module. */
Marcel Plch776407f2017-12-20 11:17:58 +01002324void _Py_PyAtExit(void (*func)(PyObject *), PyObject *module)
Nick Coghland6009512014-11-20 21:39:37 +10002325{
Victor Stinner81a7be32020-04-14 15:14:01 +02002326 PyInterpreterState *is = _PyInterpreterState_GET();
Marcel Plch776407f2017-12-20 11:17:58 +01002327
Antoine Pitroufc5db952017-12-13 02:29:07 +01002328 /* Guard against API misuse (see bpo-17852) */
Marcel Plch776407f2017-12-20 11:17:58 +01002329 assert(is->pyexitfunc == NULL || is->pyexitfunc == func);
2330
2331 is->pyexitfunc = func;
2332 is->pyexitmodule = module;
Nick Coghland6009512014-11-20 21:39:37 +10002333}
2334
2335static void
Victor Stinnerb45d2592019-06-20 00:05:23 +02002336call_py_exitfuncs(PyThreadState *tstate)
Nick Coghland6009512014-11-20 21:39:37 +10002337{
Victor Stinnerb45d2592019-06-20 00:05:23 +02002338 PyInterpreterState *interp = tstate->interp;
2339 if (interp->pyexitfunc == NULL)
Nick Coghland6009512014-11-20 21:39:37 +10002340 return;
2341
Victor Stinnerb45d2592019-06-20 00:05:23 +02002342 (*interp->pyexitfunc)(interp->pyexitmodule);
2343 _PyErr_Clear(tstate);
Nick Coghland6009512014-11-20 21:39:37 +10002344}
2345
2346/* Wait until threading._shutdown completes, provided
2347 the threading module was imported in the first place.
2348 The shutdown routine will wait until all non-daemon
2349 "threading" threads have completed. */
2350static void
Victor Stinnerb45d2592019-06-20 00:05:23 +02002351wait_for_thread_shutdown(PyThreadState *tstate)
Nick Coghland6009512014-11-20 21:39:37 +10002352{
Nick Coghland6009512014-11-20 21:39:37 +10002353 _Py_IDENTIFIER(_shutdown);
2354 PyObject *result;
Eric Snow3f9eee62017-09-15 16:35:20 -06002355 PyObject *threading = _PyImport_GetModuleId(&PyId_threading);
Nick Coghland6009512014-11-20 21:39:37 +10002356 if (threading == NULL) {
Victor Stinnerb45d2592019-06-20 00:05:23 +02002357 if (_PyErr_Occurred(tstate)) {
Stefan Krah027b09c2019-03-25 21:50:58 +01002358 PyErr_WriteUnraisable(NULL);
2359 }
2360 /* else: threading not imported */
Nick Coghland6009512014-11-20 21:39:37 +10002361 return;
2362 }
Jeroen Demeyer762f93f2019-07-08 10:19:25 +02002363 result = _PyObject_CallMethodIdNoArgs(threading, &PyId__shutdown);
Nick Coghland6009512014-11-20 21:39:37 +10002364 if (result == NULL) {
2365 PyErr_WriteUnraisable(threading);
2366 }
2367 else {
2368 Py_DECREF(result);
2369 }
2370 Py_DECREF(threading);
Nick Coghland6009512014-11-20 21:39:37 +10002371}
2372
2373#define NEXITFUNCS 32
Nick Coghland6009512014-11-20 21:39:37 +10002374int Py_AtExit(void (*func)(void))
2375{
Eric Snow2ebc5ce2017-09-07 23:51:28 -06002376 if (_PyRuntime.nexitfuncs >= NEXITFUNCS)
Nick Coghland6009512014-11-20 21:39:37 +10002377 return -1;
Eric Snow2ebc5ce2017-09-07 23:51:28 -06002378 _PyRuntime.exitfuncs[_PyRuntime.nexitfuncs++] = func;
Nick Coghland6009512014-11-20 21:39:37 +10002379 return 0;
2380}
2381
2382static void
Victor Stinner8e91c242019-04-24 17:24:01 +02002383call_ll_exitfuncs(_PyRuntimeState *runtime)
Nick Coghland6009512014-11-20 21:39:37 +10002384{
Victor Stinner8e91c242019-04-24 17:24:01 +02002385 while (runtime->nexitfuncs > 0) {
Victor Stinner87d23a02019-04-26 05:49:26 +02002386 /* pop last function from the list */
2387 runtime->nexitfuncs--;
2388 void (*exitfunc)(void) = runtime->exitfuncs[runtime->nexitfuncs];
2389 runtime->exitfuncs[runtime->nexitfuncs] = NULL;
2390
2391 exitfunc();
Victor Stinner8e91c242019-04-24 17:24:01 +02002392 }
Nick Coghland6009512014-11-20 21:39:37 +10002393
2394 fflush(stdout);
2395 fflush(stderr);
2396}
2397
Victor Stinnercfc88312018-08-01 16:41:25 +02002398void _Py_NO_RETURN
Nick Coghland6009512014-11-20 21:39:37 +10002399Py_Exit(int sts)
2400{
Martin Panterb4ce1fc2015-11-30 03:18:29 +00002401 if (Py_FinalizeEx() < 0) {
2402 sts = 120;
2403 }
Nick Coghland6009512014-11-20 21:39:37 +10002404
2405 exit(sts);
2406}
2407
Victor Stinner331a6a52019-05-27 16:39:22 +02002408static PyStatus
Victor Stinnerb45d2592019-06-20 00:05:23 +02002409init_signals(PyThreadState *tstate)
Nick Coghland6009512014-11-20 21:39:37 +10002410{
2411#ifdef SIGPIPE
2412 PyOS_setsig(SIGPIPE, SIG_IGN);
2413#endif
2414#ifdef SIGXFZ
2415 PyOS_setsig(SIGXFZ, SIG_IGN);
2416#endif
2417#ifdef SIGXFSZ
2418 PyOS_setsig(SIGXFSZ, SIG_IGN);
2419#endif
Victor Stinner400e1db2020-03-31 19:13:10 +02002420 PyOS_InitInterrupts(); /* May imply init_signals() */
Victor Stinnerb45d2592019-06-20 00:05:23 +02002421 if (_PyErr_Occurred(tstate)) {
Victor Stinner331a6a52019-05-27 16:39:22 +02002422 return _PyStatus_ERR("can't import signal");
Nick Coghland6009512014-11-20 21:39:37 +10002423 }
Victor Stinner331a6a52019-05-27 16:39:22 +02002424 return _PyStatus_OK();
Nick Coghland6009512014-11-20 21:39:37 +10002425}
2426
2427
2428/* Restore signals that the interpreter has called SIG_IGN on to SIG_DFL.
2429 *
2430 * All of the code in this function must only use async-signal-safe functions,
2431 * listed at `man 7 signal` or
2432 * http://www.opengroup.org/onlinepubs/009695399/functions/xsh_chap02_04.html.
Victor Stinnerefc28bb2020-03-05 18:13:56 +01002433 *
2434 * If this function is updated, update also _posix_spawn() of subprocess.py.
Nick Coghland6009512014-11-20 21:39:37 +10002435 */
2436void
2437_Py_RestoreSignals(void)
2438{
2439#ifdef SIGPIPE
2440 PyOS_setsig(SIGPIPE, SIG_DFL);
2441#endif
2442#ifdef SIGXFZ
2443 PyOS_setsig(SIGXFZ, SIG_DFL);
2444#endif
2445#ifdef SIGXFSZ
2446 PyOS_setsig(SIGXFSZ, SIG_DFL);
2447#endif
2448}
2449
2450
2451/*
2452 * The file descriptor fd is considered ``interactive'' if either
2453 * a) isatty(fd) is TRUE, or
2454 * b) the -i flag was given, and the filename associated with
2455 * the descriptor is NULL or "<stdin>" or "???".
2456 */
2457int
2458Py_FdIsInteractive(FILE *fp, const char *filename)
2459{
2460 if (isatty((int)fileno(fp)))
2461 return 1;
2462 if (!Py_InteractiveFlag)
2463 return 0;
2464 return (filename == NULL) ||
2465 (strcmp(filename, "<stdin>") == 0) ||
2466 (strcmp(filename, "???") == 0);
2467}
2468
2469
Nick Coghland6009512014-11-20 21:39:37 +10002470/* Wrappers around sigaction() or signal(). */
2471
2472PyOS_sighandler_t
2473PyOS_getsig(int sig)
2474{
2475#ifdef HAVE_SIGACTION
2476 struct sigaction context;
2477 if (sigaction(sig, NULL, &context) == -1)
2478 return SIG_ERR;
2479 return context.sa_handler;
2480#else
2481 PyOS_sighandler_t handler;
2482/* Special signal handling for the secure CRT in Visual Studio 2005 */
2483#if defined(_MSC_VER) && _MSC_VER >= 1400
2484 switch (sig) {
2485 /* Only these signals are valid */
2486 case SIGINT:
2487 case SIGILL:
2488 case SIGFPE:
2489 case SIGSEGV:
2490 case SIGTERM:
2491 case SIGBREAK:
2492 case SIGABRT:
2493 break;
2494 /* Don't call signal() with other values or it will assert */
2495 default:
2496 return SIG_ERR;
2497 }
2498#endif /* _MSC_VER && _MSC_VER >= 1400 */
2499 handler = signal(sig, SIG_IGN);
2500 if (handler != SIG_ERR)
2501 signal(sig, handler);
2502 return handler;
2503#endif
2504}
2505
2506/*
2507 * All of the code in this function must only use async-signal-safe functions,
2508 * listed at `man 7 signal` or
2509 * http://www.opengroup.org/onlinepubs/009695399/functions/xsh_chap02_04.html.
2510 */
2511PyOS_sighandler_t
2512PyOS_setsig(int sig, PyOS_sighandler_t handler)
2513{
2514#ifdef HAVE_SIGACTION
2515 /* Some code in Modules/signalmodule.c depends on sigaction() being
2516 * used here if HAVE_SIGACTION is defined. Fix that if this code
2517 * changes to invalidate that assumption.
2518 */
2519 struct sigaction context, ocontext;
2520 context.sa_handler = handler;
2521 sigemptyset(&context.sa_mask);
2522 context.sa_flags = 0;
2523 if (sigaction(sig, &context, &ocontext) == -1)
2524 return SIG_ERR;
2525 return ocontext.sa_handler;
2526#else
2527 PyOS_sighandler_t oldhandler;
2528 oldhandler = signal(sig, handler);
2529#ifdef HAVE_SIGINTERRUPT
2530 siginterrupt(sig, 1);
2531#endif
2532 return oldhandler;
2533#endif
2534}
2535
2536#ifdef __cplusplus
2537}
2538#endif