blob: aeff38a6e72524eba3b7963b66753ab93699f95c [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* System module */
3
4/*
5Various bits of information used by the interpreter are collected in
6module 'sys'.
Guido van Rossum3f5da241990-12-20 15:06:42 +00007Function member:
Guido van Rossumcc8914f1995-03-20 15:09:40 +00008- exit(sts): raise SystemExit
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00009Data members:
10- stdin, stdout, stderr: standard file objects
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000011- modules: the table of modules (dictionary)
Guido van Rossum3f5da241990-12-20 15:06:42 +000012- path: module search path (list of strings)
13- argv: script arguments (list of strings)
14- ps1, ps2: optional primary and secondary prompts (strings)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000015*/
16
Guido van Rossum65bf9f21997-04-29 18:33:38 +000017#include "Python.h"
Christian Heimesf31b69f2008-01-14 03:42:48 +000018#include "structseq.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +000019#include "code.h"
Barry Warsawb6a54d22000-12-06 21:47:46 +000020#include "frameobject.h"
Guido van Rossuma12fe4e2003-04-09 19:06:21 +000021#include "eval.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000022
Guido van Rossume2437a11992-03-23 18:20:18 +000023#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000024
Mark Hammond8696ebc2002-10-08 02:44:31 +000025#ifdef MS_WINDOWS
26#define WIN32_LEAN_AND_MEAN
27#include "windows.h"
28#endif /* MS_WINDOWS */
29
Guido van Rossum9b38a141996-09-11 23:12:24 +000030#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000031extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000032/* A string loaded from the DLL at startup: */
33extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000034#endif
35
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +000036#ifdef __VMS
37#include <unixlib.h>
38#endif
39
Martin v. Löwis5467d4c2003-05-10 07:10:12 +000040#ifdef MS_WINDOWS
41#include <windows.h>
42#endif
43
44#ifdef HAVE_LANGINFO_H
45#include <locale.h>
46#include <langinfo.h>
47#endif
48
Guido van Rossum65bf9f21997-04-29 18:33:38 +000049PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000050PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000051{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000052 PyThreadState *tstate = PyThreadState_GET();
53 PyObject *sd = tstate->interp->sysdict;
54 if (sd == NULL)
55 return NULL;
56 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000057}
58
59FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000060PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000061{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000062 FILE *fp = NULL;
63 PyObject *v = PySys_GetObject(name);
64 if (v != NULL && PyFile_Check(v))
65 fp = PyFile_AsFile(v);
66 if (fp == NULL)
67 fp = def;
68 return fp;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000069}
70
71int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000072PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000073{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000074 PyThreadState *tstate = PyThreadState_GET();
75 PyObject *sd = tstate->interp->sysdict;
76 if (v == NULL) {
77 if (PyDict_GetItemString(sd, name) == NULL)
78 return 0;
79 else
80 return PyDict_DelItemString(sd, name);
81 }
82 else
83 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000084}
85
Guido van Rossum65bf9f21997-04-29 18:33:38 +000086static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000087sys_displayhook(PyObject *self, PyObject *o)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000088{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000089 PyObject *outf;
90 PyInterpreterState *interp = PyThreadState_GET()->interp;
91 PyObject *modules = interp->modules;
92 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000093
Antoine Pitrouc83ea132010-05-09 14:46:46 +000094 if (builtins == NULL) {
95 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
96 return NULL;
97 }
Moshe Zadka03897ea2001-07-23 13:32:43 +000098
Antoine Pitrouc83ea132010-05-09 14:46:46 +000099 /* Print value except if None */
100 /* After printing, also assign to '_' */
101 /* Before, set '_' to None to avoid recursion */
102 if (o == Py_None) {
103 Py_INCREF(Py_None);
104 return Py_None;
105 }
106 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
107 return NULL;
108 if (Py_FlushLine() != 0)
109 return NULL;
110 outf = PySys_GetObject("stdout");
111 if (outf == NULL) {
112 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
113 return NULL;
114 }
115 if (PyFile_WriteObject(o, outf, 0) != 0)
116 return NULL;
117 PyFile_SoftSpace(outf, 1);
118 if (Py_FlushLine() != 0)
119 return NULL;
120 if (PyObject_SetAttrString(builtins, "_", o) != 0)
121 return NULL;
122 Py_INCREF(Py_None);
123 return Py_None;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000124}
125
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000126PyDoc_STRVAR(displayhook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000127"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000128"\n"
Florent Xicluna8af970a2010-03-03 11:49:53 +0000129"Print an object to sys.stdout and also save it in __builtin__._\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000130);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000131
132static PyObject *
133sys_excepthook(PyObject* self, PyObject* args)
134{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000135 PyObject *exc, *value, *tb;
136 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
137 return NULL;
138 PyErr_Display(exc, value, tb);
139 Py_INCREF(Py_None);
140 return Py_None;
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000141}
142
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000143PyDoc_STRVAR(excepthook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000144"excepthook(exctype, value, traceback) -> None\n"
145"\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000146"Handle an exception by displaying it with a traceback on sys.stderr.\n"
147);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000148
149static PyObject *
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000150sys_exc_info(PyObject *self, PyObject *noargs)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000151{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000152 PyThreadState *tstate;
153 tstate = PyThreadState_GET();
154 return Py_BuildValue(
155 "(OOO)",
156 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
157 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
158 tstate->exc_traceback != NULL ?
159 tstate->exc_traceback : Py_None);
Guido van Rossuma027efa1997-05-05 20:56:21 +0000160}
161
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000162PyDoc_STRVAR(exc_info_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000163"exc_info() -> (type, value, traceback)\n\
164\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000165Return information about the most recent exception caught by an except\n\
166clause in the current stack frame or in an older stack frame."
167);
168
169static PyObject *
170sys_exc_clear(PyObject *self, PyObject *noargs)
171{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000172 PyThreadState *tstate;
173 PyObject *tmp_type, *tmp_value, *tmp_tb;
Georg Brandl5a444242008-03-21 20:11:46 +0000174
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000175 if (PyErr_WarnPy3k("sys.exc_clear() not supported in 3.x; "
176 "use except clauses", 1) < 0)
177 return NULL;
Georg Brandl5a444242008-03-21 20:11:46 +0000178
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000179 tstate = PyThreadState_GET();
180 tmp_type = tstate->exc_type;
181 tmp_value = tstate->exc_value;
182 tmp_tb = tstate->exc_traceback;
183 tstate->exc_type = NULL;
184 tstate->exc_value = NULL;
185 tstate->exc_traceback = NULL;
186 Py_XDECREF(tmp_type);
187 Py_XDECREF(tmp_value);
188 Py_XDECREF(tmp_tb);
189 /* For b/w compatibility */
190 PySys_SetObject("exc_type", Py_None);
191 PySys_SetObject("exc_value", Py_None);
192 PySys_SetObject("exc_traceback", Py_None);
193 Py_INCREF(Py_None);
194 return Py_None;
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000195}
196
197PyDoc_STRVAR(exc_clear_doc,
198"exc_clear() -> None\n\
199\n\
200Clear global information on the current exception. Subsequent calls to\n\
201exc_info() will return (None,None,None) until another exception is raised\n\
202in the current thread or the execution stack returns to a frame where\n\
203another exception is being handled."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000204);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000205
Guido van Rossuma027efa1997-05-05 20:56:21 +0000206static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000207sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000208{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000209 PyObject *exit_code = 0;
210 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
211 return NULL;
212 /* Raise SystemExit so callers may catch it or clean up. */
213 PyErr_SetObject(PyExc_SystemExit, exit_code);
214 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000215}
216
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000217PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000218"exit([status])\n\
219\n\
220Exit the interpreter by raising SystemExit(status).\n\
221If the status is omitted or None, it defaults to zero (i.e., success).\n\
Ezio Melotti08350fb2013-08-26 14:00:39 +0300222If the status is an integer, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000223If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000224exit status will be one (i.e., failure)."
225);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000226
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000227#ifdef Py_USING_UNICODE
228
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000229static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000230sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000231{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000232 return PyString_FromString(PyUnicode_GetDefaultEncoding());
Fred Drake8b4d01d2000-05-09 19:57:01 +0000233}
234
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000235PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000236"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000237\n\
238Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000239implementation."
240);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000241
242static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000243sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000244{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000245 char *encoding;
246 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
247 return NULL;
248 if (PyUnicode_SetDefaultEncoding(encoding))
249 return NULL;
250 Py_INCREF(Py_None);
251 return Py_None;
Fred Drake8b4d01d2000-05-09 19:57:01 +0000252}
253
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000254PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000255"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000256\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000257Set the current default string encoding used by the Unicode implementation."
258);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000259
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000260static PyObject *
261sys_getfilesystemencoding(PyObject *self)
262{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000263 if (Py_FileSystemDefaultEncoding)
264 return PyString_FromString(Py_FileSystemDefaultEncoding);
265 Py_INCREF(Py_None);
266 return Py_None;
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000267}
268
269PyDoc_STRVAR(getfilesystemencoding_doc,
270"getfilesystemencoding() -> string\n\
271\n\
272Return the encoding used to convert Unicode filenames in\n\
273operating system filenames."
274);
275
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000276#endif
277
Fred Drake5755ce62001-06-27 19:19:46 +0000278/*
279 * Cached interned string objects used for calling the profile and
280 * trace functions. Initialized by trace_init().
281 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000282static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000283
284static int
285trace_init(void)
286{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000287 static char *whatnames[7] = {"call", "exception", "line", "return",
288 "c_call", "c_exception", "c_return"};
289 PyObject *name;
290 int i;
291 for (i = 0; i < 7; ++i) {
292 if (whatstrings[i] == NULL) {
293 name = PyString_InternFromString(whatnames[i]);
294 if (name == NULL)
295 return -1;
296 whatstrings[i] = name;
297 }
298 }
299 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000300}
301
302
303static PyObject *
304call_trampoline(PyThreadState *tstate, PyObject* callback,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000305 PyFrameObject *frame, int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000306{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000307 PyObject *args = PyTuple_New(3);
308 PyObject *whatstr;
309 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000310
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000311 if (args == NULL)
312 return NULL;
313 Py_INCREF(frame);
314 whatstr = whatstrings[what];
315 Py_INCREF(whatstr);
316 if (arg == NULL)
317 arg = Py_None;
318 Py_INCREF(arg);
319 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
320 PyTuple_SET_ITEM(args, 1, whatstr);
321 PyTuple_SET_ITEM(args, 2, arg);
Fred Drake5755ce62001-06-27 19:19:46 +0000322
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000323 /* call the Python-level function */
324 PyFrame_FastToLocals(frame);
325 result = PyEval_CallObject(callback, args);
326 PyFrame_LocalsToFast(frame, 1);
327 if (result == NULL)
328 PyTraceBack_Here(frame);
Fred Drake5755ce62001-06-27 19:19:46 +0000329
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000330 /* cleanup */
331 Py_DECREF(args);
332 return result;
Fred Drake5755ce62001-06-27 19:19:46 +0000333}
334
335static int
336profile_trampoline(PyObject *self, PyFrameObject *frame,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000337 int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000338{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000339 PyThreadState *tstate = frame->f_tstate;
340 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000341
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000342 if (arg == NULL)
343 arg = Py_None;
344 result = call_trampoline(tstate, self, frame, what, arg);
345 if (result == NULL) {
346 PyEval_SetProfile(NULL, NULL);
347 return -1;
348 }
349 Py_DECREF(result);
350 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000351}
352
353static int
354trace_trampoline(PyObject *self, PyFrameObject *frame,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000355 int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000356{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000357 PyThreadState *tstate = frame->f_tstate;
358 PyObject *callback;
359 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000360
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000361 if (what == PyTrace_CALL)
362 callback = self;
363 else
364 callback = frame->f_trace;
365 if (callback == NULL)
366 return 0;
367 result = call_trampoline(tstate, callback, frame, what, arg);
368 if (result == NULL) {
369 PyEval_SetTrace(NULL, NULL);
Serhiy Storchaka98a97222014-02-09 13:14:04 +0200370 Py_CLEAR(frame->f_trace);
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000371 return -1;
372 }
373 if (result != Py_None) {
374 PyObject *temp = frame->f_trace;
375 frame->f_trace = NULL;
376 Py_XDECREF(temp);
377 frame->f_trace = result;
378 }
379 else {
380 Py_DECREF(result);
381 }
382 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000383}
Fred Draked0838392001-06-16 21:02:31 +0000384
Fred Drake8b4d01d2000-05-09 19:57:01 +0000385static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000386sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000387{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000388 if (trace_init() == -1)
389 return NULL;
390 if (args == Py_None)
391 PyEval_SetTrace(NULL, NULL);
392 else
393 PyEval_SetTrace(trace_trampoline, args);
394 Py_INCREF(Py_None);
395 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000396}
397
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000398PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000399"settrace(function)\n\
400\n\
401Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000402function call. See the debugger chapter in the library manual."
403);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000404
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000405static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000406sys_gettrace(PyObject *self, PyObject *args)
407{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000408 PyThreadState *tstate = PyThreadState_GET();
409 PyObject *temp = tstate->c_traceobj;
Georg Brandl56112892008-01-20 13:59:46 +0000410
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000411 if (temp == NULL)
412 temp = Py_None;
413 Py_INCREF(temp);
414 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000415}
416
417PyDoc_STRVAR(gettrace_doc,
418"gettrace()\n\
419\n\
420Return the global debug tracing function set with sys.settrace.\n\
421See the debugger chapter in the library manual."
422);
423
424static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000425sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000426{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000427 if (trace_init() == -1)
428 return NULL;
429 if (args == Py_None)
430 PyEval_SetProfile(NULL, NULL);
431 else
432 PyEval_SetProfile(profile_trampoline, args);
433 Py_INCREF(Py_None);
434 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000435}
436
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000437PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000438"setprofile(function)\n\
439\n\
440Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000441and return. See the profiler chapter in the library manual."
442);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000443
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000444static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000445sys_getprofile(PyObject *self, PyObject *args)
446{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000447 PyThreadState *tstate = PyThreadState_GET();
448 PyObject *temp = tstate->c_profileobj;
Georg Brandl56112892008-01-20 13:59:46 +0000449
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000450 if (temp == NULL)
451 temp = Py_None;
452 Py_INCREF(temp);
453 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000454}
455
456PyDoc_STRVAR(getprofile_doc,
457"getprofile()\n\
458\n\
459Return the profiling function set with sys.setprofile.\n\
460See the profiler chapter in the library manual."
461);
462
463static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000464sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000465{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000466 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
467 return NULL;
Raymond Hettinger19b851d2011-06-01 18:21:42 -0700468 _Py_Ticker = _Py_CheckInterval;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000469 Py_INCREF(Py_None);
470 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000471}
472
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000473PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000474"setcheckinterval(n)\n\
475\n\
476Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000477n instructions. This also affects how often thread switches occur."
478);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000479
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000480static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000481sys_getcheckinterval(PyObject *self, PyObject *args)
482{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000483 return PyInt_FromLong(_Py_CheckInterval);
Tim Peterse5e065b2003-07-06 18:36:54 +0000484}
485
486PyDoc_STRVAR(getcheckinterval_doc,
487"getcheckinterval() -> current check interval; see setcheckinterval()."
488);
489
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000490#ifdef WITH_TSC
491static PyObject *
492sys_settscdump(PyObject *self, PyObject *args)
493{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000494 int bool;
495 PyThreadState *tstate = PyThreadState_Get();
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000496
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000497 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
498 return NULL;
499 if (bool)
500 tstate->interp->tscdump = 1;
501 else
502 tstate->interp->tscdump = 0;
503 Py_INCREF(Py_None);
504 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000505
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000506}
507
Tim Peters216b78b2006-01-06 02:40:53 +0000508PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000509"settscdump(bool)\n\
510\n\
511If true, tell the Python interpreter to dump VM measurements to\n\
512stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000513processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000514);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000515#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000516
Tim Peterse5e065b2003-07-06 18:36:54 +0000517static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000518sys_setrecursionlimit(PyObject *self, PyObject *args)
519{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000520 int new_limit;
521 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
522 return NULL;
523 if (new_limit <= 0) {
524 PyErr_SetString(PyExc_ValueError,
525 "recursion limit must be positive");
526 return NULL;
527 }
528 Py_SetRecursionLimit(new_limit);
529 Py_INCREF(Py_None);
530 return Py_None;
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000531}
532
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000533PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000534"setrecursionlimit(n)\n\
535\n\
536Set the maximum depth of the Python interpreter stack to n. This\n\
537limit prevents infinite recursion from causing an overflow of the C\n\
538stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000539dependent."
540);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000541
542static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000543sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000544{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000545 return PyInt_FromLong(Py_GetRecursionLimit());
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000546}
547
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000548PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000549"getrecursionlimit()\n\
550\n\
551Return the current value of the recursion limit, the maximum depth\n\
552of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000553recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000554);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000555
Mark Hammond8696ebc2002-10-08 02:44:31 +0000556#ifdef MS_WINDOWS
557PyDoc_STRVAR(getwindowsversion_doc,
558"getwindowsversion()\n\
559\n\
Eric Smithee931b72010-01-27 00:28:29 +0000560Return information about the running version of Windows as a named tuple.\n\
561The members are named: major, minor, build, platform, service_pack,\n\
562service_pack_major, service_pack_minor, suite_mask, and product_type. For\n\
Ezio Melotti24b07bc2011-03-15 18:55:01 +0200563backward compatibility, only the first 5 items are available by indexing.\n\
Eric Smithee931b72010-01-27 00:28:29 +0000564All elements are numbers, except service_pack which is a string. Platform\n\
565may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP/Vista/7,\n\
5663 for Windows CE. Product_type may be 1 for a workstation, 2 for a domain\n\
567controller, 3 for a server."
Mark Hammond8696ebc2002-10-08 02:44:31 +0000568);
569
Eric Smithee931b72010-01-27 00:28:29 +0000570static PyTypeObject WindowsVersionType = {0, 0, 0, 0, 0, 0};
571
572static PyStructSequence_Field windows_version_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000573 {"major", "Major version number"},
574 {"minor", "Minor version number"},
575 {"build", "Build number"},
576 {"platform", "Operating system platform"},
577 {"service_pack", "Latest Service Pack installed on the system"},
578 {"service_pack_major", "Service Pack major version number"},
579 {"service_pack_minor", "Service Pack minor version number"},
580 {"suite_mask", "Bit mask identifying available product suites"},
581 {"product_type", "System product type"},
582 {0}
Eric Smithee931b72010-01-27 00:28:29 +0000583};
584
585static PyStructSequence_Desc windows_version_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000586 "sys.getwindowsversion", /* name */
587 getwindowsversion_doc, /* doc */
588 windows_version_fields, /* fields */
589 5 /* For backward compatibility,
590 only the first 5 items are accessible
591 via indexing, the rest are name only */
Eric Smithee931b72010-01-27 00:28:29 +0000592};
593
Mark Hammond8696ebc2002-10-08 02:44:31 +0000594static PyObject *
595sys_getwindowsversion(PyObject *self)
596{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000597 PyObject *version;
598 int pos = 0;
599 OSVERSIONINFOEX ver;
600 ver.dwOSVersionInfoSize = sizeof(ver);
601 if (!GetVersionEx((OSVERSIONINFO*) &ver))
602 return PyErr_SetFromWindowsErr(0);
Eric Smithee931b72010-01-27 00:28:29 +0000603
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000604 version = PyStructSequence_New(&WindowsVersionType);
605 if (version == NULL)
606 return NULL;
Eric Smithee931b72010-01-27 00:28:29 +0000607
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000608 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMajorVersion));
609 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMinorVersion));
610 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwBuildNumber));
611 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwPlatformId));
612 PyStructSequence_SET_ITEM(version, pos++, PyString_FromString(ver.szCSDVersion));
613 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMajor));
614 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMinor));
615 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wSuiteMask));
616 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wProductType));
Eric Smithee931b72010-01-27 00:28:29 +0000617
Serhiy Storchaka15df36b2013-12-17 15:09:45 +0200618 if (PyErr_Occurred()) {
619 Py_DECREF(version);
620 return NULL;
621 }
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000622 return version;
Mark Hammond8696ebc2002-10-08 02:44:31 +0000623}
624
625#endif /* MS_WINDOWS */
626
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000627#ifdef HAVE_DLOPEN
628static PyObject *
629sys_setdlopenflags(PyObject *self, PyObject *args)
630{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000631 int new_val;
632 PyThreadState *tstate = PyThreadState_GET();
633 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
634 return NULL;
635 if (!tstate)
636 return NULL;
637 tstate->interp->dlopenflags = new_val;
638 Py_INCREF(Py_None);
639 return Py_None;
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000640}
641
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000642PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000643"setdlopenflags(n) -> None\n\
644\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000645Set the flags used by the interpreter for dlopen calls, such as when the\n\
646interpreter loads extension modules. Among other things, this will enable\n\
647a lazy resolving of symbols when importing a module, if called as\n\
648sys.setdlopenflags(0). To share symbols across extension modules, call as\n\
649sys.setdlopenflags(ctypes.RTLD_GLOBAL). Symbolic names for the flag modules\n\
650can be either found in the ctypes module, or in the DLFCN module. If DLFCN\n\
651is not available, it can be generated from /usr/include/dlfcn.h using the\n\
652h2py script.");
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000653
654static PyObject *
655sys_getdlopenflags(PyObject *self, PyObject *args)
656{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000657 PyThreadState *tstate = PyThreadState_GET();
658 if (!tstate)
659 return NULL;
660 return PyInt_FromLong(tstate->interp->dlopenflags);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000661}
662
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000663PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000664"getdlopenflags() -> int\n\
665\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000666Return the current value of the flags that are used for dlopen calls.\n\
667The flag constants are defined in the ctypes and DLFCN modules.");
668
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000669#endif /* HAVE_DLOPEN */
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000670
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000671#ifdef USE_MALLOPT
672/* Link with -lmalloc (or -lmpc) on an SGI */
673#include <malloc.h>
674
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000675static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000676sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000677{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000678 int flag;
679 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
680 return NULL;
681 mallopt(M_DEBUG, flag);
682 Py_INCREF(Py_None);
683 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000684}
685#endif /* USE_MALLOPT */
686
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300687size_t
688_PySys_GetSizeOf(PyObject *o)
Robert Schuppenies51df0642008-06-01 16:16:17 +0000689{
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300690 static PyObject *str__sizeof__ = NULL;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000691 PyObject *res = NULL;
Serhiy Storchakaf9b2aa22014-11-15 13:21:01 +0200692 Py_ssize_t size;
Robert Schuppenies47629022008-07-10 17:13:55 +0000693
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000694 /* Make sure the type is initialized. float gets initialized late */
695 if (PyType_Ready(Py_TYPE(o)) < 0)
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300696 return (size_t)-1;
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000697
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000698 /* Instance of old-style class */
699 if (PyInstance_Check(o))
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300700 size = PyInstance_Type.tp_basicsize;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000701 /* all other objects */
702 else {
703 PyObject *method = _PyObject_LookupSpecial(o, "__sizeof__",
704 &str__sizeof__);
705 if (method == NULL) {
706 if (!PyErr_Occurred())
707 PyErr_Format(PyExc_TypeError,
708 "Type %.100s doesn't define __sizeof__",
709 Py_TYPE(o)->tp_name);
710 }
711 else {
712 res = PyObject_CallFunctionObjArgs(method, NULL);
713 Py_DECREF(method);
714 }
Robert Schuppenies47629022008-07-10 17:13:55 +0000715
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300716 if (res == NULL)
717 return (size_t)-1;
718
719 size = (size_t)PyInt_AsSsize_t(res);
720 Py_DECREF(res);
Serhiy Storchakaf9b2aa22014-11-15 13:21:01 +0200721 if (size == -1 && PyErr_Occurred())
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300722 return (size_t)-1;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000723 }
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000724
Serhiy Storchakaf9b2aa22014-11-15 13:21:01 +0200725 if (size < 0) {
726 PyErr_SetString(PyExc_ValueError, "__sizeof__() should return >= 0");
727 return (size_t)-1;
728 }
729
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000730 /* add gc_head size */
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300731 if (PyObject_IS_GC(o))
Serhiy Storchakaf9b2aa22014-11-15 13:21:01 +0200732 return ((size_t)size) + sizeof(PyGC_Head);
733 return (size_t)size;
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300734}
735
736static PyObject *
737sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
738{
739 static char *kwlist[] = {"object", "default", 0};
740 size_t size;
741 PyObject *o, *dflt = NULL;
742
743 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
744 kwlist, &o, &dflt))
745 return NULL;
746
747 size = _PySys_GetSizeOf(o);
748
749 if (size == (size_t)-1 && PyErr_Occurred()) {
750 /* Has a default value been given */
751 if (dflt != NULL && PyErr_ExceptionMatches(PyExc_TypeError)) {
752 PyErr_Clear();
753 Py_INCREF(dflt);
754 return dflt;
755 }
756 else
757 return NULL;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000758 }
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300759
760 return PyInt_FromSize_t(size);
Robert Schuppenies51df0642008-06-01 16:16:17 +0000761}
762
763PyDoc_STRVAR(getsizeof_doc,
Robert Schuppenies47629022008-07-10 17:13:55 +0000764"getsizeof(object, default) -> int\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +0000765\n\
766Return the size of object in bytes.");
767
768static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000769sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000770{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000771 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000772}
773
Tim Peters4be93d02002-07-07 19:59:50 +0000774#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000775static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000776sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000777{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000778 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000779}
Armin Rigoe1709372006-04-12 17:06:05 +0000780#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000781
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000782PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000783"getrefcount(object) -> integer\n\
784\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000785Return the reference count of object. The count returned is generally\n\
786one higher than you might expect, because it includes the (temporary)\n\
787reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000788);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000789
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000790#ifdef COUNT_ALLOCS
791static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000792sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000793{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000794 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000795
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000796 return get_counts();
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000797}
798#endif
799
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000800PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000801"_getframe([depth]) -> frameobject\n\
802\n\
803Return a frame object from the call stack. If optional integer depth is\n\
804given, return the frame object that many calls below the top of the stack.\n\
805If that is deeper than the call stack, ValueError is raised. The default\n\
806for depth is zero, returning the frame at the top of the call stack.\n\
807\n\
808This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000809purposes only."
810);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000811
812static PyObject *
813sys_getframe(PyObject *self, PyObject *args)
814{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000815 PyFrameObject *f = PyThreadState_GET()->frame;
816 int depth = -1;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000817
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000818 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
819 return NULL;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000820
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000821 while (depth > 0 && f != NULL) {
822 f = f->f_back;
823 --depth;
824 }
825 if (f == NULL) {
826 PyErr_SetString(PyExc_ValueError,
827 "call stack is not deep enough");
828 return NULL;
829 }
830 Py_INCREF(f);
831 return (PyObject*)f;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000832}
833
Tim Peters32a83612006-07-10 21:08:24 +0000834PyDoc_STRVAR(current_frames_doc,
835"_current_frames() -> dictionary\n\
836\n\
837Return a dictionary mapping each current thread T's thread id to T's\n\
838current stack frame.\n\
839\n\
840This function should be used for specialized purposes only."
841);
842
843static PyObject *
844sys_current_frames(PyObject *self, PyObject *noargs)
845{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000846 return _PyThread_CurrentFrames();
Tim Peters32a83612006-07-10 21:08:24 +0000847}
848
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000849PyDoc_STRVAR(call_tracing_doc,
850"call_tracing(func, args) -> object\n\
851\n\
852Call func(*args), while tracing is enabled. The tracing state is\n\
853saved, and restored afterwards. This is intended to be called from\n\
854a debugger from a checkpoint, to recursively debug some other code."
855);
856
857static PyObject *
858sys_call_tracing(PyObject *self, PyObject *args)
859{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000860 PyObject *func, *funcargs;
861 if (!PyArg_ParseTuple(args, "OO!:call_tracing", &func, &PyTuple_Type, &funcargs))
862 return NULL;
863 return _PyEval_CallTracing(func, funcargs);
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000864}
865
Jeremy Hylton985eba52003-02-05 23:13:00 +0000866PyDoc_STRVAR(callstats_doc,
867"callstats() -> tuple of integers\n\
868\n\
869Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
870when Python was built. Otherwise, return None.\n\
871\n\
872When enabled, this function returns detailed, implementation-specific\n\
873details about the number of function calls executed. The return value is\n\
874a 11-tuple where the entries in the tuple are counts of:\n\
8750. all function calls\n\
8761. calls to PyFunction_Type objects\n\
8772. PyFunction calls that do not create an argument tuple\n\
8783. PyFunction calls that do not create an argument tuple\n\
879 and bypass PyEval_EvalCodeEx()\n\
8804. PyMethod calls\n\
8815. PyMethod calls on bound methods\n\
8826. PyType calls\n\
8837. PyCFunction calls\n\
8848. generator calls\n\
8859. All other calls\n\
88610. Number of stack pops performed by call_function()"
887);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000888
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000889#ifdef __cplusplus
890extern "C" {
891#endif
892
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000893#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000894/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000895extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000896#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000897
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000898#ifdef DYNAMIC_EXECUTION_PROFILE
899/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000900extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000901#endif
902
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000903#ifdef __cplusplus
904}
905#endif
906
Christian Heimes422051a2008-02-04 18:00:12 +0000907static PyObject *
908sys_clear_type_cache(PyObject* self, PyObject* args)
909{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000910 PyType_ClearCache();
911 Py_RETURN_NONE;
Christian Heimes422051a2008-02-04 18:00:12 +0000912}
913
914PyDoc_STRVAR(sys_clear_type_cache__doc__,
915"_clear_type_cache() -> None\n\
916Clear the internal type lookup cache.");
917
918
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000919static PyMethodDef sys_methods[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000920 /* Might as well keep this in alphabetic order */
921 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
922 callstats_doc},
923 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
924 sys_clear_type_cache__doc__},
925 {"_current_frames", sys_current_frames, METH_NOARGS,
926 current_frames_doc},
927 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
928 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
929 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
930 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
931 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000932#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000933 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
934 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000935#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000936#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000937 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
938 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000939#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000940#ifdef COUNT_ALLOCS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000941 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000942#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000943#ifdef DYNAMIC_EXECUTION_PROFILE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000944 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000945#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000946#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000947 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
948 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000949#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000950#ifdef Py_TRACE_REFS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000951 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000952#endif
953#ifdef Py_REF_DEBUG
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000954 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000955#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000956 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
957 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
958 getrecursionlimit_doc},
959 {"getsizeof", (PyCFunction)sys_getsizeof,
960 METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
961 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000962#ifdef MS_WINDOWS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000963 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
964 getwindowsversion_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000965#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000966#ifdef USE_MALLOPT
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000967 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000968#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000969#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000970 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
971 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000972#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000973 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
974 setcheckinterval_doc},
975 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
976 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000977#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000978 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
979 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000980#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000981 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
982 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
983 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
984 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000985#ifdef WITH_TSC
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000986 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000987#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000988 {"settrace", sys_settrace, METH_O, settrace_doc},
989 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
990 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
991 {NULL, NULL} /* sentinel */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000992};
993
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000994static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000995list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000996{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000997 PyObject *list = PyList_New(0);
998 int i;
999 if (list == NULL)
1000 return NULL;
1001 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
1002 PyObject *name = PyString_FromString(
1003 PyImport_Inittab[i].name);
1004 if (name == NULL)
1005 break;
1006 PyList_Append(list, name);
1007 Py_DECREF(name);
1008 }
1009 if (PyList_Sort(list) != 0) {
1010 Py_DECREF(list);
1011 list = NULL;
1012 }
1013 if (list) {
1014 PyObject *v = PyList_AsTuple(list);
1015 Py_DECREF(list);
1016 list = v;
1017 }
1018 return list;
Guido van Rossum34679b71993-01-26 13:33:44 +00001019}
1020
Guido van Rossum23fff912000-12-15 22:02:05 +00001021static PyObject *warnoptions = NULL;
1022
1023void
1024PySys_ResetWarnOptions(void)
1025{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001026 if (warnoptions == NULL || !PyList_Check(warnoptions))
1027 return;
1028 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
Guido van Rossum23fff912000-12-15 22:02:05 +00001029}
1030
1031void
1032PySys_AddWarnOption(char *s)
1033{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001034 PyObject *str;
Guido van Rossum23fff912000-12-15 22:02:05 +00001035
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001036 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
1037 Py_XDECREF(warnoptions);
1038 warnoptions = PyList_New(0);
1039 if (warnoptions == NULL)
1040 return;
1041 }
1042 str = PyString_FromString(s);
1043 if (str != NULL) {
1044 PyList_Append(warnoptions, str);
1045 Py_DECREF(str);
1046 }
Guido van Rossum23fff912000-12-15 22:02:05 +00001047}
1048
Brett Cannone9746892008-04-12 23:44:07 +00001049int
1050PySys_HasWarnOptions(void)
1051{
Brett Cannon40f0a872008-04-13 00:18:44 +00001052 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +00001053}
1054
Guido van Rossum40552d01998-08-06 03:34:39 +00001055/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
1056 Two literals concatenated works just fine. If you have a K&R compiler
1057 or other abomination that however *does* understand longer strings,
1058 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001059PyDoc_VAR(sys_doc) =
1060PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001061"This module provides access to some objects used or maintained by the\n\
1062interpreter and to functions that interact strongly with the interpreter.\n\
1063\n\
1064Dynamic objects:\n\
1065\n\
1066argv -- command line arguments; argv[0] is the script pathname if known\n\
1067path -- module search path; path[0] is the script directory, else ''\n\
1068modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001069\n\
1070displayhook -- called to show results in an interactive session\n\
1071excepthook -- called to handle any uncaught exception other than SystemExit\n\
1072 To customize printing in an interactive session or to install a custom\n\
1073 top-level exception handler, assign other functions to replace these.\n\
1074\n\
1075exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
1076 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001077\n\
1078stdin -- standard input file object; used by raw_input() and input()\n\
1079stdout -- standard output file object; used by the print statement\n\
1080stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001081 By assigning other file objects (or objects that behave like files)\n\
1082 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001083\n\
1084last_type -- type of last uncaught exception\n\
1085last_value -- value of last uncaught exception\n\
1086last_traceback -- traceback of last uncaught exception\n\
1087 These three are only available in an interactive session after a\n\
1088 traceback has been printed.\n\
1089\n\
1090exc_type -- type of exception currently being handled\n\
1091exc_value -- value of exception currently being handled\n\
1092exc_traceback -- traceback of exception currently being handled\n\
1093 The function exc_info() should be used instead of these three,\n\
1094 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001095"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001096)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001097/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001098PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001099"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001100Static objects:\n\
1101\n\
Mark Dickinsonefc82f72009-03-20 15:51:55 +00001102float_info -- a dict with information about the float inplementation.\n\
1103long_info -- a struct sequence with information about the long implementation.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001104maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwis4dd019f2008-05-20 08:11:19 +00001105maxsize -- the largest supported length of containers.\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001106maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +00001107builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001108version -- the version of this interpreter as a string\n\
Eric Smith81fe0932009-02-06 00:48:26 +00001109version_info -- version information as a named tuple\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001110hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001111copyright -- copyright notice pertaining to this interpreter\n\
1112platform -- platform identifier\n\
Petri Lehtinenfe6f9d02012-02-02 21:11:28 +02001113executable -- absolute path of the executable binary of the Python interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001114prefix -- prefix used to find the Python library\n\
1115exec_prefix -- prefix used to find the machine-specific Python library\n\
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001116float_repr_style -- string indicating the style of repr() output for floats\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001117"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001118)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001119#ifdef MS_WINDOWS
1120/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001121PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001122"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001123winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001124"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001125)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001126#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001127PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001128"__stdin__ -- the original stdin; don't touch!\n\
1129__stdout__ -- the original stdout; don't touch!\n\
1130__stderr__ -- the original stderr; don't touch!\n\
1131__displayhook__ -- the original displayhook; don't touch!\n\
1132__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001133\n\
1134Functions:\n\
1135\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001136displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001137excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001138exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001139exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001140exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001141getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001142getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001143getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001144getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +00001145getsizeof() -- return the size of an object in bytes\n\
Georg Brandl56112892008-01-20 13:59:46 +00001146gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001147setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001148setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001149setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001150setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001151settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001152"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001153)
Fred Drakeccede592000-08-14 20:59:57 +00001154/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001155
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001156static int
1157_check_and_flush (FILE *stream)
1158{
1159 int prev_fail = ferror (stream);
1160 return fflush (stream) || prev_fail ? EOF : 0;
1161}
1162
Martin v. Löwis43b57802006-01-05 23:38:54 +00001163/* Subversion branch and revision management */
Martin v. Löwis43b57802006-01-05 23:38:54 +00001164static int svn_initialized;
1165static char patchlevel_revision[50]; /* Just the number */
1166static char branch[50];
1167static char shortbranch[50];
1168static const char *svn_revision;
1169
Tim Peterse86e7a52006-01-06 02:42:46 +00001170static void
1171svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001172{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001173 if (svn_initialized)
1174 return;
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001175 svn_initialized = 1;
Benjamin Peterson7859d402011-03-25 16:57:30 -05001176 *patchlevel_revision = '\0';
1177 strcpy(branch, "");
1178 strcpy(shortbranch, "unknown");
1179 svn_revision = "";
1180 return;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001181}
1182
1183/* Return svnversion output if available.
1184 Else return Revision of patchlevel.h if on branch.
1185 Else return empty string */
1186const char*
1187Py_SubversionRevision()
1188{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001189 svnversion_init();
1190 return svn_revision;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001191}
1192
1193const char*
1194Py_SubversionShortBranch()
1195{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001196 svnversion_init();
1197 return shortbranch;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001198}
1199
Christian Heimesf31b69f2008-01-14 03:42:48 +00001200
1201PyDoc_STRVAR(flags__doc__,
1202"sys.flags\n\
1203\n\
1204Flags provided through command line arguments or environment vars.");
1205
Christian Heimes796fc312008-01-30 18:58:29 +00001206static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001207
1208static PyStructSequence_Field flags_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001209 {"debug", "-d"},
1210 {"py3k_warning", "-3"},
1211 {"division_warning", "-Q"},
1212 {"division_new", "-Qnew"},
1213 {"inspect", "-i"},
1214 {"interactive", "-i"},
1215 {"optimize", "-O or -OO"},
1216 {"dont_write_bytecode", "-B"},
1217 {"no_user_site", "-s"},
1218 {"no_site", "-S"},
1219 {"ignore_environment", "-E"},
1220 {"tabcheck", "-t or -tt"},
1221 {"verbose", "-v"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001222#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001223 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001224#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001225 /* {"unbuffered", "-u"}, */
1226 {"unicode", "-U"},
1227 /* {"skip_first", "-x"}, */
1228 {"bytes_warning", "-b"},
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001229 {"hash_randomization", "-R"},
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001230 {0}
Christian Heimesf31b69f2008-01-14 03:42:48 +00001231};
1232
1233static PyStructSequence_Desc flags_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001234 "sys.flags", /* name */
1235 flags__doc__, /* doc */
1236 flags_fields, /* fields */
Christian Heimesf31b69f2008-01-14 03:42:48 +00001237#ifdef RISCOS
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001238 17
Christian Heimesf31b69f2008-01-14 03:42:48 +00001239#else
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001240 16
Christian Heimesf31b69f2008-01-14 03:42:48 +00001241#endif
1242};
1243
1244static PyObject*
1245make_flags(void)
1246{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001247 int pos = 0;
1248 PyObject *seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001249
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001250 seq = PyStructSequence_New(&FlagsType);
1251 if (seq == NULL)
1252 return NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001253
1254#define SetFlag(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001255 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
Christian Heimesf31b69f2008-01-14 03:42:48 +00001256
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001257 SetFlag(Py_DebugFlag);
1258 SetFlag(Py_Py3kWarningFlag);
1259 SetFlag(Py_DivisionWarningFlag);
1260 SetFlag(_Py_QnewFlag);
1261 SetFlag(Py_InspectFlag);
1262 SetFlag(Py_InteractiveFlag);
1263 SetFlag(Py_OptimizeFlag);
1264 SetFlag(Py_DontWriteBytecodeFlag);
1265 SetFlag(Py_NoUserSiteDirectory);
1266 SetFlag(Py_NoSiteFlag);
1267 SetFlag(Py_IgnoreEnvironmentFlag);
1268 SetFlag(Py_TabcheckFlag);
1269 SetFlag(Py_VerboseFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001270#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001271 SetFlag(Py_RISCOSWimpFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001272#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001273 /* SetFlag(saw_unbuffered_flag); */
1274 SetFlag(Py_UnicodeFlag);
1275 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001276 SetFlag(Py_BytesWarningFlag);
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001277 SetFlag(Py_HashRandomizationFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001278#undef SetFlag
1279
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001280 if (PyErr_Occurred()) {
Serhiy Storchaka05854182013-12-17 14:59:29 +02001281 Py_DECREF(seq);
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001282 return NULL;
1283 }
1284 return seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001285}
1286
Eric Smith81fe0932009-02-06 00:48:26 +00001287PyDoc_STRVAR(version_info__doc__,
1288"sys.version_info\n\
1289\n\
1290Version information as a named tuple.");
1291
1292static PyTypeObject VersionInfoType = {0, 0, 0, 0, 0, 0};
1293
1294static PyStructSequence_Field version_info_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001295 {"major", "Major release number"},
1296 {"minor", "Minor release number"},
1297 {"micro", "Patch release number"},
Ned Deily0caaa6c2016-11-04 17:05:59 -04001298 {"releaselevel", "'alpha', 'beta', 'candidate', or 'final'"},
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001299 {"serial", "Serial release number"},
1300 {0}
Eric Smith81fe0932009-02-06 00:48:26 +00001301};
1302
1303static PyStructSequence_Desc version_info_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001304 "sys.version_info", /* name */
1305 version_info__doc__, /* doc */
1306 version_info_fields, /* fields */
1307 5
Eric Smith81fe0932009-02-06 00:48:26 +00001308};
1309
1310static PyObject *
1311make_version_info(void)
1312{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001313 PyObject *version_info;
1314 char *s;
1315 int pos = 0;
Eric Smith81fe0932009-02-06 00:48:26 +00001316
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001317 version_info = PyStructSequence_New(&VersionInfoType);
1318 if (version_info == NULL) {
1319 return NULL;
1320 }
Eric Smith81fe0932009-02-06 00:48:26 +00001321
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001322 /*
1323 * These release level checks are mutually exclusive and cover
1324 * the field, so don't get too fancy with the pre-processor!
1325 */
Eric Smith81fe0932009-02-06 00:48:26 +00001326#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001327 s = "alpha";
Eric Smith81fe0932009-02-06 00:48:26 +00001328#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001329 s = "beta";
Eric Smith81fe0932009-02-06 00:48:26 +00001330#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001331 s = "candidate";
Eric Smith81fe0932009-02-06 00:48:26 +00001332#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001333 s = "final";
Eric Smith81fe0932009-02-06 00:48:26 +00001334#endif
1335
1336#define SetIntItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001337 PyStructSequence_SET_ITEM(version_info, pos++, PyInt_FromLong(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001338#define SetStrItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001339 PyStructSequence_SET_ITEM(version_info, pos++, PyString_FromString(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001340
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001341 SetIntItem(PY_MAJOR_VERSION);
1342 SetIntItem(PY_MINOR_VERSION);
1343 SetIntItem(PY_MICRO_VERSION);
1344 SetStrItem(s);
1345 SetIntItem(PY_RELEASE_SERIAL);
Eric Smith81fe0932009-02-06 00:48:26 +00001346#undef SetIntItem
1347#undef SetStrItem
1348
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001349 if (PyErr_Occurred()) {
1350 Py_CLEAR(version_info);
1351 return NULL;
1352 }
1353 return version_info;
Eric Smith81fe0932009-02-06 00:48:26 +00001354}
1355
Guido van Rossum25ce5661997-08-02 03:10:38 +00001356PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001357_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001358{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001359 PyObject *m, *v, *sysdict;
1360 PyObject *sysin, *sysout, *syserr;
1361 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001362
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001363 m = Py_InitModule3("sys", sys_methods, sys_doc);
1364 if (m == NULL)
1365 return NULL;
1366 sysdict = PyModule_GetDict(m);
1367#define SET_SYS_FROM_STRING(key, value) \
1368 v = value; \
1369 if (v != NULL) \
1370 PyDict_SetItemString(sysdict, key, v); \
1371 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001372
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001373 /* Check that stdin is not a directory
1374 Using shell redirection, you can redirect stdin to a directory,
1375 crashing the Python interpreter. Catch this common mistake here
1376 and output a useful error message. Note that under MS Windows,
1377 the shell already prevents that. */
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001378#if !defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001379 {
1380 struct stat sb;
1381 if (fstat(fileno(stdin), &sb) == 0 &&
1382 S_ISDIR(sb.st_mode)) {
1383 /* There's nothing more we can do. */
1384 /* Py_FatalError() will core dump, so just exit. */
1385 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1386 exit(EXIT_FAILURE);
1387 }
1388 }
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001389#endif
Neal Norwitz11bd1192005-10-03 00:54:56 +00001390
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001391 /* Closing the standard FILE* if sys.std* goes aways causes problems
1392 * for embedded Python usages. Closing them when somebody explicitly
1393 * invokes .close() might be possible, but the FAQ promises they get
1394 * never closed. However, we still need to get write errors when
1395 * writing fails (e.g. because stdout is redirected), so we flush the
1396 * streams and check for errors before the file objects are deleted.
1397 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1398 * from that procedure.
1399 */
1400 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
1401 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1402 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
1403 if (PyErr_Occurred())
1404 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001405
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001406 PyDict_SetItemString(sysdict, "stdin", sysin);
1407 PyDict_SetItemString(sysdict, "stdout", sysout);
1408 PyDict_SetItemString(sysdict, "stderr", syserr);
1409 /* Make backup copies for cleanup */
1410 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1411 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1412 PyDict_SetItemString(sysdict, "__stderr__", syserr);
1413 PyDict_SetItemString(sysdict, "__displayhook__",
1414 PyDict_GetItemString(sysdict, "displayhook"));
1415 PyDict_SetItemString(sysdict, "__excepthook__",
1416 PyDict_GetItemString(sysdict, "excepthook"));
1417 Py_XDECREF(sysin);
1418 Py_XDECREF(sysout);
1419 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001420
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001421 SET_SYS_FROM_STRING("version",
1422 PyString_FromString(Py_GetVersion()));
1423 SET_SYS_FROM_STRING("hexversion",
1424 PyInt_FromLong(PY_VERSION_HEX));
1425 svnversion_init();
1426 SET_SYS_FROM_STRING("subversion",
1427 Py_BuildValue("(ssz)", "CPython", branch,
1428 svn_revision));
Georg Brandl3a5508e2011-03-06 10:42:21 +01001429 SET_SYS_FROM_STRING("_mercurial",
1430 Py_BuildValue("(szz)", "CPython", _Py_hgidentifier(),
1431 _Py_hgversion()));
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001432 SET_SYS_FROM_STRING("dont_write_bytecode",
1433 PyBool_FromLong(Py_DontWriteBytecodeFlag));
1434 SET_SYS_FROM_STRING("api_version",
1435 PyInt_FromLong(PYTHON_API_VERSION));
1436 SET_SYS_FROM_STRING("copyright",
1437 PyString_FromString(Py_GetCopyright()));
1438 SET_SYS_FROM_STRING("platform",
1439 PyString_FromString(Py_GetPlatform()));
1440 SET_SYS_FROM_STRING("executable",
1441 PyString_FromString(Py_GetProgramFullPath()));
1442 SET_SYS_FROM_STRING("prefix",
1443 PyString_FromString(Py_GetPrefix()));
1444 SET_SYS_FROM_STRING("exec_prefix",
1445 PyString_FromString(Py_GetExecPrefix()));
1446 SET_SYS_FROM_STRING("maxsize",
1447 PyInt_FromSsize_t(PY_SSIZE_T_MAX));
1448 SET_SYS_FROM_STRING("maxint",
1449 PyInt_FromLong(PyInt_GetMax()));
1450 SET_SYS_FROM_STRING("py3kwarning",
1451 PyBool_FromLong(Py_Py3kWarningFlag));
1452 SET_SYS_FROM_STRING("float_info",
1453 PyFloat_GetInfo());
1454 SET_SYS_FROM_STRING("long_info",
1455 PyLong_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001456#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001457 SET_SYS_FROM_STRING("maxunicode",
1458 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001459#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001460 SET_SYS_FROM_STRING("builtin_module_names",
1461 list_builtin_module_names());
1462 {
1463 /* Assumes that longs are at least 2 bytes long.
1464 Should be safe! */
1465 unsigned long number = 1;
1466 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001467
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001468 s = (char *) &number;
1469 if (s[0] == 0)
1470 value = "big";
1471 else
1472 value = "little";
1473 SET_SYS_FROM_STRING("byteorder",
1474 PyString_FromString(value));
1475 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001476#ifdef MS_COREDLL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001477 SET_SYS_FROM_STRING("dllhandle",
1478 PyLong_FromVoidPtr(PyWin_DLLhModule));
1479 SET_SYS_FROM_STRING("winver",
1480 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001481#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001482 if (warnoptions == NULL) {
1483 warnoptions = PyList_New(0);
1484 }
1485 else {
1486 Py_INCREF(warnoptions);
1487 }
1488 if (warnoptions != NULL) {
1489 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
1490 }
Tim Peters216b78b2006-01-06 02:40:53 +00001491
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001492 /* version_info */
1493 if (VersionInfoType.tp_name == 0)
1494 PyStructSequence_InitType(&VersionInfoType, &version_info_desc);
1495 SET_SYS_FROM_STRING("version_info", make_version_info());
1496 /* prevent user from creating new instances */
1497 VersionInfoType.tp_init = NULL;
1498 VersionInfoType.tp_new = NULL;
Eric Smith81fe0932009-02-06 00:48:26 +00001499
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001500 /* flags */
1501 if (FlagsType.tp_name == 0)
1502 PyStructSequence_InitType(&FlagsType, &flags_desc);
1503 SET_SYS_FROM_STRING("flags", make_flags());
1504 /* prevent user from creating new instances */
1505 FlagsType.tp_init = NULL;
1506 FlagsType.tp_new = NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001507
Eric Smithee931b72010-01-27 00:28:29 +00001508
1509#if defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001510 /* getwindowsversion */
1511 if (WindowsVersionType.tp_name == 0)
1512 PyStructSequence_InitType(&WindowsVersionType, &windows_version_desc);
1513 /* prevent user from creating new instances */
1514 WindowsVersionType.tp_init = NULL;
1515 WindowsVersionType.tp_new = NULL;
Eric Smithee931b72010-01-27 00:28:29 +00001516#endif
1517
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001518 /* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001519#ifndef PY_NO_SHORT_FLOAT_REPR
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001520 SET_SYS_FROM_STRING("float_repr_style",
1521 PyString_FromString("short"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001522#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001523 SET_SYS_FROM_STRING("float_repr_style",
1524 PyString_FromString("legacy"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001525#endif
1526
Christian Heimes0d924432008-01-30 17:21:22 +00001527#undef SET_SYS_FROM_STRING
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001528 if (PyErr_Occurred())
1529 return NULL;
1530 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001531}
1532
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001533static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001534makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001535{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001536 int i, n;
1537 char *p;
1538 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001539
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001540 n = 1;
1541 p = path;
1542 while ((p = strchr(p, delim)) != NULL) {
1543 n++;
1544 p++;
1545 }
1546 v = PyList_New(n);
1547 if (v == NULL)
1548 return NULL;
1549 for (i = 0; ; i++) {
1550 p = strchr(path, delim);
1551 if (p == NULL)
1552 p = strchr(path, '\0'); /* End of string */
1553 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
1554 if (w == NULL) {
1555 Py_DECREF(v);
1556 return NULL;
1557 }
1558 PyList_SetItem(v, i, w);
1559 if (*p == '\0')
1560 break;
1561 path = p+1;
1562 }
1563 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001564}
1565
1566void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001567PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001568{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001569 PyObject *v;
1570 if ((v = makepathobject(path, DELIM)) == NULL)
1571 Py_FatalError("can't create sys.path");
1572 if (PySys_SetObject("path", v) != 0)
1573 Py_FatalError("can't assign sys.path");
1574 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001575}
1576
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001577static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001578makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001579{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001580 PyObject *av;
1581 if (argc <= 0 || argv == NULL) {
1582 /* Ensure at least one (empty) argument is seen */
1583 static char *empty_argv[1] = {""};
1584 argv = empty_argv;
1585 argc = 1;
1586 }
1587 av = PyList_New(argc);
1588 if (av != NULL) {
1589 int i;
1590 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001591#ifdef __VMS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001592 PyObject *v;
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001593
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001594 /* argv[0] is the script pathname if known */
1595 if (i == 0) {
1596 char* fn = decc$translate_vms(argv[0]);
1597 if ((fn == (char *)0) || fn == (char *)-1)
1598 v = PyString_FromString(argv[0]);
1599 else
1600 v = PyString_FromString(
1601 decc$translate_vms(argv[0]));
1602 } else
1603 v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001604#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001605 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001606#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001607 if (v == NULL) {
1608 Py_DECREF(av);
1609 av = NULL;
1610 break;
1611 }
1612 PyList_SetItem(av, i, v);
1613 }
1614 }
1615 return av;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001616}
1617
1618void
Antoine Pitrou6a265602010-05-21 17:12:38 +00001619PySys_SetArgvEx(int argc, char **argv, int updatepath)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001620{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001621#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001622 char fullpath[MAXPATHLEN];
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001623#elif defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001624 char fullpath[MAX_PATH];
Thomas Heller27bb71e2003-01-08 14:33:48 +00001625#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001626 PyObject *av = makeargvobject(argc, argv);
1627 PyObject *path = PySys_GetObject("path");
1628 if (av == NULL)
1629 Py_FatalError("no mem for sys.argv");
1630 if (PySys_SetObject("argv", av) != 0)
1631 Py_FatalError("can't assign sys.argv");
Antoine Pitrou6a265602010-05-21 17:12:38 +00001632 if (updatepath && path != NULL) {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001633 char *argv0 = argv[0];
1634 char *p = NULL;
1635 Py_ssize_t n = 0;
1636 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001637#ifdef HAVE_READLINK
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001638 char link[MAXPATHLEN+1];
1639 char argv0copy[2*MAXPATHLEN+1];
1640 int nr = 0;
1641 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
1642 nr = readlink(argv0, link, MAXPATHLEN);
1643 if (nr > 0) {
1644 /* It's a symlink */
1645 link[nr] = '\0';
1646 if (link[0] == SEP)
1647 argv0 = link; /* Link to absolute path */
1648 else if (strchr(link, SEP) == NULL)
1649 ; /* Link without path */
1650 else {
1651 /* Must join(dirname(argv0), link) */
1652 char *q = strrchr(argv0, SEP);
1653 if (q == NULL)
1654 argv0 = link; /* argv0 without path */
1655 else {
1656 /* Must make a copy */
1657 strcpy(argv0copy, argv0);
1658 q = strrchr(argv0copy, SEP);
1659 strcpy(q+1, link);
1660 argv0 = argv0copy;
1661 }
1662 }
1663 }
Guido van Rossumc474dea1997-04-25 15:38:31 +00001664#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001665#if SEP == '\\' /* Special case for MS filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001666 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
1667 char *q;
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001668#if defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001669 /* This code here replaces the first element in argv with the full
1670 path that it represents. Under CE, there are no relative paths so
1671 the argument must be the full path anyway. */
1672 char *ptemp;
1673 if (GetFullPathName(argv0,
1674 sizeof(fullpath),
1675 fullpath,
1676 &ptemp)) {
1677 argv0 = fullpath;
1678 }
Thomas Heller27bb71e2003-01-08 14:33:48 +00001679#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001680 p = strrchr(argv0, SEP);
1681 /* Test for alternate separator */
1682 q = strrchr(p ? p : argv0, '/');
1683 if (q != NULL)
1684 p = q;
1685 if (p != NULL) {
1686 n = p + 1 - argv0;
1687 if (n > 1 && p[-1] != ':')
1688 n--; /* Drop trailing separator */
1689 }
1690 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001691#else /* All other filename syntaxes */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001692 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001693#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001694 if (realpath(argv0, fullpath)) {
1695 argv0 = fullpath;
1696 }
Guido van Rossum162e38c2003-02-19 15:25:10 +00001697#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001698 p = strrchr(argv0, SEP);
1699 }
1700 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001701#ifndef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001702 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001703#else /* don't include trailing separator */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001704 n = p - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001705#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001706#if SEP == '/' /* Special case for Unix filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001707 if (n > 1)
1708 n--; /* Drop trailing separator */
Guido van Rossumcc883411996-09-10 14:44:21 +00001709#endif /* Unix */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001710 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001711#endif /* All others */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001712 a = PyString_FromStringAndSize(argv0, n);
1713 if (a == NULL)
1714 Py_FatalError("no mem for sys.path insertion");
1715 if (PyList_Insert(path, 0, a) < 0)
1716 Py_FatalError("sys.path.insert(0) failed");
1717 Py_DECREF(a);
1718 }
1719 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001720}
Guido van Rossuma890e681998-05-12 14:59:24 +00001721
Antoine Pitrou6a265602010-05-21 17:12:38 +00001722void
1723PySys_SetArgv(int argc, char **argv)
1724{
1725 PySys_SetArgvEx(argc, argv, 1);
1726}
1727
Guido van Rossuma890e681998-05-12 14:59:24 +00001728
1729/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1730 Adapted from code submitted by Just van Rossum.
1731
1732 PySys_WriteStdout(format, ...)
1733 PySys_WriteStderr(format, ...)
1734
1735 The first function writes to sys.stdout; the second to sys.stderr. When
1736 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001737 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001738
1739 Both take a printf-style format string as their first argument followed
1740 by a variable length argument list determined by the format string.
1741
1742 *** WARNING ***
1743
1744 The format should limit the total size of the formatted output string to
1745 1000 bytes. In particular, this means that no unrestricted "%s" formats
1746 should occur; these should be limited using "%.<N>s where <N> is a
1747 decimal number calculated so that <N> plus the maximum size of other
1748 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1749 which can print hundreds of digits for very large numbers.
1750
1751 */
1752
1753static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001754mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001755{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001756 PyObject *file;
1757 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001758
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001759 PyErr_Fetch(&error_type, &error_value, &error_traceback);
1760 file = PySys_GetObject(name);
1761 if (file == NULL || PyFile_AsFile(file) == fp)
1762 vfprintf(fp, format, va);
1763 else {
1764 char buffer[1001];
1765 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1766 format, va);
1767 if (PyFile_WriteString(buffer, file) != 0) {
1768 PyErr_Clear();
1769 fputs(buffer, fp);
1770 }
1771 if (written < 0 || (size_t)written >= sizeof(buffer)) {
1772 const char *truncated = "... truncated";
1773 if (PyFile_WriteString(truncated, file) != 0) {
1774 PyErr_Clear();
1775 fputs(truncated, fp);
1776 }
1777 }
1778 }
1779 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001780}
1781
1782void
Guido van Rossuma890e681998-05-12 14:59:24 +00001783PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001784{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001785 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001786
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001787 va_start(va, format);
1788 mywrite("stdout", stdout, format, va);
1789 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001790}
1791
1792void
Guido van Rossuma890e681998-05-12 14:59:24 +00001793PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001794{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001795 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001796
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001797 va_start(va, format);
1798 mywrite("stderr", stderr, format, va);
1799 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001800}