blob: 2c364af0b7bebba37e832bd104e5cdd0d31bc750 [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);
370 Py_XDECREF(frame->f_trace);
371 frame->f_trace = NULL;
372 return -1;
373 }
374 if (result != Py_None) {
375 PyObject *temp = frame->f_trace;
376 frame->f_trace = NULL;
377 Py_XDECREF(temp);
378 frame->f_trace = result;
379 }
380 else {
381 Py_DECREF(result);
382 }
383 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000384}
Fred Draked0838392001-06-16 21:02:31 +0000385
Fred Drake8b4d01d2000-05-09 19:57:01 +0000386static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000387sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000388{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000389 if (trace_init() == -1)
390 return NULL;
391 if (args == Py_None)
392 PyEval_SetTrace(NULL, NULL);
393 else
394 PyEval_SetTrace(trace_trampoline, args);
395 Py_INCREF(Py_None);
396 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000397}
398
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000399PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000400"settrace(function)\n\
401\n\
402Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000403function call. See the debugger chapter in the library manual."
404);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000405
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000406static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000407sys_gettrace(PyObject *self, PyObject *args)
408{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000409 PyThreadState *tstate = PyThreadState_GET();
410 PyObject *temp = tstate->c_traceobj;
Georg Brandl56112892008-01-20 13:59:46 +0000411
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000412 if (temp == NULL)
413 temp = Py_None;
414 Py_INCREF(temp);
415 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000416}
417
418PyDoc_STRVAR(gettrace_doc,
419"gettrace()\n\
420\n\
421Return the global debug tracing function set with sys.settrace.\n\
422See the debugger chapter in the library manual."
423);
424
425static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000426sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000427{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000428 if (trace_init() == -1)
429 return NULL;
430 if (args == Py_None)
431 PyEval_SetProfile(NULL, NULL);
432 else
433 PyEval_SetProfile(profile_trampoline, args);
434 Py_INCREF(Py_None);
435 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000436}
437
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000438PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000439"setprofile(function)\n\
440\n\
441Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000442and return. See the profiler chapter in the library manual."
443);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000444
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000445static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000446sys_getprofile(PyObject *self, PyObject *args)
447{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000448 PyThreadState *tstate = PyThreadState_GET();
449 PyObject *temp = tstate->c_profileobj;
Georg Brandl56112892008-01-20 13:59:46 +0000450
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000451 if (temp == NULL)
452 temp = Py_None;
453 Py_INCREF(temp);
454 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000455}
456
457PyDoc_STRVAR(getprofile_doc,
458"getprofile()\n\
459\n\
460Return the profiling function set with sys.setprofile.\n\
461See the profiler chapter in the library manual."
462);
463
464static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000465sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000466{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000467 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
468 return NULL;
Raymond Hettinger19b851d2011-06-01 18:21:42 -0700469 _Py_Ticker = _Py_CheckInterval;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000470 Py_INCREF(Py_None);
471 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000472}
473
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000474PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000475"setcheckinterval(n)\n\
476\n\
477Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000478n instructions. This also affects how often thread switches occur."
479);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000480
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000481static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000482sys_getcheckinterval(PyObject *self, PyObject *args)
483{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000484 return PyInt_FromLong(_Py_CheckInterval);
Tim Peterse5e065b2003-07-06 18:36:54 +0000485}
486
487PyDoc_STRVAR(getcheckinterval_doc,
488"getcheckinterval() -> current check interval; see setcheckinterval()."
489);
490
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000491#ifdef WITH_TSC
492static PyObject *
493sys_settscdump(PyObject *self, PyObject *args)
494{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000495 int bool;
496 PyThreadState *tstate = PyThreadState_Get();
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000497
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000498 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
499 return NULL;
500 if (bool)
501 tstate->interp->tscdump = 1;
502 else
503 tstate->interp->tscdump = 0;
504 Py_INCREF(Py_None);
505 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000506
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000507}
508
Tim Peters216b78b2006-01-06 02:40:53 +0000509PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000510"settscdump(bool)\n\
511\n\
512If true, tell the Python interpreter to dump VM measurements to\n\
513stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000514processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000515);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000516#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000517
Tim Peterse5e065b2003-07-06 18:36:54 +0000518static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000519sys_setrecursionlimit(PyObject *self, PyObject *args)
520{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000521 int new_limit;
522 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
523 return NULL;
524 if (new_limit <= 0) {
525 PyErr_SetString(PyExc_ValueError,
526 "recursion limit must be positive");
527 return NULL;
528 }
529 Py_SetRecursionLimit(new_limit);
530 Py_INCREF(Py_None);
531 return Py_None;
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000532}
533
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000534PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000535"setrecursionlimit(n)\n\
536\n\
537Set the maximum depth of the Python interpreter stack to n. This\n\
538limit prevents infinite recursion from causing an overflow of the C\n\
539stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000540dependent."
541);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000542
543static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000544sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000545{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000546 return PyInt_FromLong(Py_GetRecursionLimit());
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000547}
548
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000549PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000550"getrecursionlimit()\n\
551\n\
552Return the current value of the recursion limit, the maximum depth\n\
553of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000554recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000555);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000556
Mark Hammond8696ebc2002-10-08 02:44:31 +0000557#ifdef MS_WINDOWS
558PyDoc_STRVAR(getwindowsversion_doc,
559"getwindowsversion()\n\
560\n\
Eric Smithee931b72010-01-27 00:28:29 +0000561Return information about the running version of Windows as a named tuple.\n\
562The members are named: major, minor, build, platform, service_pack,\n\
563service_pack_major, service_pack_minor, suite_mask, and product_type. For\n\
Ezio Melotti24b07bc2011-03-15 18:55:01 +0200564backward compatibility, only the first 5 items are available by indexing.\n\
Eric Smithee931b72010-01-27 00:28:29 +0000565All elements are numbers, except service_pack which is a string. Platform\n\
566may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP/Vista/7,\n\
5673 for Windows CE. Product_type may be 1 for a workstation, 2 for a domain\n\
568controller, 3 for a server."
Mark Hammond8696ebc2002-10-08 02:44:31 +0000569);
570
Eric Smithee931b72010-01-27 00:28:29 +0000571static PyTypeObject WindowsVersionType = {0, 0, 0, 0, 0, 0};
572
573static PyStructSequence_Field windows_version_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000574 {"major", "Major version number"},
575 {"minor", "Minor version number"},
576 {"build", "Build number"},
577 {"platform", "Operating system platform"},
578 {"service_pack", "Latest Service Pack installed on the system"},
579 {"service_pack_major", "Service Pack major version number"},
580 {"service_pack_minor", "Service Pack minor version number"},
581 {"suite_mask", "Bit mask identifying available product suites"},
582 {"product_type", "System product type"},
583 {0}
Eric Smithee931b72010-01-27 00:28:29 +0000584};
585
586static PyStructSequence_Desc windows_version_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000587 "sys.getwindowsversion", /* name */
588 getwindowsversion_doc, /* doc */
589 windows_version_fields, /* fields */
590 5 /* For backward compatibility,
591 only the first 5 items are accessible
592 via indexing, the rest are name only */
Eric Smithee931b72010-01-27 00:28:29 +0000593};
594
Mark Hammond8696ebc2002-10-08 02:44:31 +0000595static PyObject *
596sys_getwindowsversion(PyObject *self)
597{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000598 PyObject *version;
599 int pos = 0;
600 OSVERSIONINFOEX ver;
601 ver.dwOSVersionInfoSize = sizeof(ver);
602 if (!GetVersionEx((OSVERSIONINFO*) &ver))
603 return PyErr_SetFromWindowsErr(0);
Eric Smithee931b72010-01-27 00:28:29 +0000604
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000605 version = PyStructSequence_New(&WindowsVersionType);
606 if (version == NULL)
607 return NULL;
Eric Smithee931b72010-01-27 00:28:29 +0000608
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000609 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMajorVersion));
610 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMinorVersion));
611 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwBuildNumber));
612 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwPlatformId));
613 PyStructSequence_SET_ITEM(version, pos++, PyString_FromString(ver.szCSDVersion));
614 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMajor));
615 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMinor));
616 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wSuiteMask));
617 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wProductType));
Eric Smithee931b72010-01-27 00:28:29 +0000618
Serhiy Storchaka15df36b2013-12-17 15:09:45 +0200619 if (PyErr_Occurred()) {
620 Py_DECREF(version);
621 return NULL;
622 }
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000623 return version;
Mark Hammond8696ebc2002-10-08 02:44:31 +0000624}
625
626#endif /* MS_WINDOWS */
627
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000628#ifdef HAVE_DLOPEN
629static PyObject *
630sys_setdlopenflags(PyObject *self, PyObject *args)
631{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000632 int new_val;
633 PyThreadState *tstate = PyThreadState_GET();
634 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
635 return NULL;
636 if (!tstate)
637 return NULL;
638 tstate->interp->dlopenflags = new_val;
639 Py_INCREF(Py_None);
640 return Py_None;
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000641}
642
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000643PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000644"setdlopenflags(n) -> None\n\
645\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000646Set the flags used by the interpreter for dlopen calls, such as when the\n\
647interpreter loads extension modules. Among other things, this will enable\n\
648a lazy resolving of symbols when importing a module, if called as\n\
649sys.setdlopenflags(0). To share symbols across extension modules, call as\n\
650sys.setdlopenflags(ctypes.RTLD_GLOBAL). Symbolic names for the flag modules\n\
651can be either found in the ctypes module, or in the DLFCN module. If DLFCN\n\
652is not available, it can be generated from /usr/include/dlfcn.h using the\n\
653h2py script.");
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000654
655static PyObject *
656sys_getdlopenflags(PyObject *self, PyObject *args)
657{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000658 PyThreadState *tstate = PyThreadState_GET();
659 if (!tstate)
660 return NULL;
661 return PyInt_FromLong(tstate->interp->dlopenflags);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000662}
663
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000664PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000665"getdlopenflags() -> int\n\
666\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000667Return the current value of the flags that are used for dlopen calls.\n\
668The flag constants are defined in the ctypes and DLFCN modules.");
669
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000670#endif /* HAVE_DLOPEN */
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000671
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000672#ifdef USE_MALLOPT
673/* Link with -lmalloc (or -lmpc) on an SGI */
674#include <malloc.h>
675
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000676static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000677sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000678{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000679 int flag;
680 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
681 return NULL;
682 mallopt(M_DEBUG, flag);
683 Py_INCREF(Py_None);
684 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000685}
686#endif /* USE_MALLOPT */
687
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000688static PyObject *
Robert Schuppenies47629022008-07-10 17:13:55 +0000689sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
Robert Schuppenies51df0642008-06-01 16:16:17 +0000690{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000691 PyObject *res = NULL;
692 static PyObject *str__sizeof__ = NULL, *gc_head_size = NULL;
693 static char *kwlist[] = {"object", "default", 0};
694 PyObject *o, *dflt = NULL;
Robert Schuppenies47629022008-07-10 17:13:55 +0000695
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000696 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
697 kwlist, &o, &dflt))
698 return NULL;
Robert Schuppenies51df0642008-06-01 16:16:17 +0000699
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000700 /* Initialize static variable for GC head size */
701 if (gc_head_size == NULL) {
702 gc_head_size = PyInt_FromSsize_t(sizeof(PyGC_Head));
703 if (gc_head_size == NULL)
704 return NULL;
705 }
Robert Schuppenies47629022008-07-10 17:13:55 +0000706
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000707 /* Make sure the type is initialized. float gets initialized late */
708 if (PyType_Ready(Py_TYPE(o)) < 0)
709 return NULL;
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000710
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000711 /* Instance of old-style class */
712 if (PyInstance_Check(o))
713 res = PyInt_FromSsize_t(PyInstance_Type.tp_basicsize);
714 /* all other objects */
715 else {
716 PyObject *method = _PyObject_LookupSpecial(o, "__sizeof__",
717 &str__sizeof__);
718 if (method == NULL) {
719 if (!PyErr_Occurred())
720 PyErr_Format(PyExc_TypeError,
721 "Type %.100s doesn't define __sizeof__",
722 Py_TYPE(o)->tp_name);
723 }
724 else {
725 res = PyObject_CallFunctionObjArgs(method, NULL);
726 Py_DECREF(method);
727 }
728 }
Robert Schuppenies47629022008-07-10 17:13:55 +0000729
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000730 /* Has a default value been given? */
731 if ((res == NULL) && (dflt != NULL) &&
732 PyErr_ExceptionMatches(PyExc_TypeError))
733 {
734 PyErr_Clear();
735 Py_INCREF(dflt);
736 return dflt;
737 }
738 else if (res == NULL)
739 return res;
740
741 /* add gc_head size */
742 if (PyObject_IS_GC(o)) {
743 PyObject *tmp = res;
744 res = PyNumber_Add(tmp, gc_head_size);
745 Py_DECREF(tmp);
746 }
747 return res;
Robert Schuppenies51df0642008-06-01 16:16:17 +0000748}
749
750PyDoc_STRVAR(getsizeof_doc,
Robert Schuppenies47629022008-07-10 17:13:55 +0000751"getsizeof(object, default) -> int\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +0000752\n\
753Return the size of object in bytes.");
754
755static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000756sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000757{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000758 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000759}
760
Tim Peters4be93d02002-07-07 19:59:50 +0000761#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000762static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000763sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000764{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000765 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000766}
Armin Rigoe1709372006-04-12 17:06:05 +0000767#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000768
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000769PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000770"getrefcount(object) -> integer\n\
771\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000772Return the reference count of object. The count returned is generally\n\
773one higher than you might expect, because it includes the (temporary)\n\
774reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000775);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000776
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000777#ifdef COUNT_ALLOCS
778static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000779sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000780{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000781 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000782
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000783 return get_counts();
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000784}
785#endif
786
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000787PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000788"_getframe([depth]) -> frameobject\n\
789\n\
790Return a frame object from the call stack. If optional integer depth is\n\
791given, return the frame object that many calls below the top of the stack.\n\
792If that is deeper than the call stack, ValueError is raised. The default\n\
793for depth is zero, returning the frame at the top of the call stack.\n\
794\n\
795This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000796purposes only."
797);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000798
799static PyObject *
800sys_getframe(PyObject *self, PyObject *args)
801{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000802 PyFrameObject *f = PyThreadState_GET()->frame;
803 int depth = -1;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000804
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000805 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
806 return NULL;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000807
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000808 while (depth > 0 && f != NULL) {
809 f = f->f_back;
810 --depth;
811 }
812 if (f == NULL) {
813 PyErr_SetString(PyExc_ValueError,
814 "call stack is not deep enough");
815 return NULL;
816 }
817 Py_INCREF(f);
818 return (PyObject*)f;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000819}
820
Tim Peters32a83612006-07-10 21:08:24 +0000821PyDoc_STRVAR(current_frames_doc,
822"_current_frames() -> dictionary\n\
823\n\
824Return a dictionary mapping each current thread T's thread id to T's\n\
825current stack frame.\n\
826\n\
827This function should be used for specialized purposes only."
828);
829
830static PyObject *
831sys_current_frames(PyObject *self, PyObject *noargs)
832{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000833 return _PyThread_CurrentFrames();
Tim Peters32a83612006-07-10 21:08:24 +0000834}
835
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000836PyDoc_STRVAR(call_tracing_doc,
837"call_tracing(func, args) -> object\n\
838\n\
839Call func(*args), while tracing is enabled. The tracing state is\n\
840saved, and restored afterwards. This is intended to be called from\n\
841a debugger from a checkpoint, to recursively debug some other code."
842);
843
844static PyObject *
845sys_call_tracing(PyObject *self, PyObject *args)
846{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000847 PyObject *func, *funcargs;
848 if (!PyArg_ParseTuple(args, "OO!:call_tracing", &func, &PyTuple_Type, &funcargs))
849 return NULL;
850 return _PyEval_CallTracing(func, funcargs);
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000851}
852
Jeremy Hylton985eba52003-02-05 23:13:00 +0000853PyDoc_STRVAR(callstats_doc,
854"callstats() -> tuple of integers\n\
855\n\
856Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
857when Python was built. Otherwise, return None.\n\
858\n\
859When enabled, this function returns detailed, implementation-specific\n\
860details about the number of function calls executed. The return value is\n\
861a 11-tuple where the entries in the tuple are counts of:\n\
8620. all function calls\n\
8631. calls to PyFunction_Type objects\n\
8642. PyFunction calls that do not create an argument tuple\n\
8653. PyFunction calls that do not create an argument tuple\n\
866 and bypass PyEval_EvalCodeEx()\n\
8674. PyMethod calls\n\
8685. PyMethod calls on bound methods\n\
8696. PyType calls\n\
8707. PyCFunction calls\n\
8718. generator calls\n\
8729. All other calls\n\
87310. Number of stack pops performed by call_function()"
874);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000875
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000876#ifdef __cplusplus
877extern "C" {
878#endif
879
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000880#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000881/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000882extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000883#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000884
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000885#ifdef DYNAMIC_EXECUTION_PROFILE
886/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000887extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000888#endif
889
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000890#ifdef __cplusplus
891}
892#endif
893
Christian Heimes422051a2008-02-04 18:00:12 +0000894static PyObject *
895sys_clear_type_cache(PyObject* self, PyObject* args)
896{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000897 PyType_ClearCache();
898 Py_RETURN_NONE;
Christian Heimes422051a2008-02-04 18:00:12 +0000899}
900
901PyDoc_STRVAR(sys_clear_type_cache__doc__,
902"_clear_type_cache() -> None\n\
903Clear the internal type lookup cache.");
904
905
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000906static PyMethodDef sys_methods[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000907 /* Might as well keep this in alphabetic order */
908 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
909 callstats_doc},
910 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
911 sys_clear_type_cache__doc__},
912 {"_current_frames", sys_current_frames, METH_NOARGS,
913 current_frames_doc},
914 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
915 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
916 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
917 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
918 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000919#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000920 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
921 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000922#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000923#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000924 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
925 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000926#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000927#ifdef COUNT_ALLOCS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000928 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000929#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000930#ifdef DYNAMIC_EXECUTION_PROFILE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000931 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000932#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000933#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000934 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
935 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000936#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000937#ifdef Py_TRACE_REFS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000938 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000939#endif
940#ifdef Py_REF_DEBUG
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000941 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000942#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000943 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
944 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
945 getrecursionlimit_doc},
946 {"getsizeof", (PyCFunction)sys_getsizeof,
947 METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
948 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000949#ifdef MS_WINDOWS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000950 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
951 getwindowsversion_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000952#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000953#ifdef USE_MALLOPT
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000954 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000955#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000956#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000957 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
958 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000959#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000960 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
961 setcheckinterval_doc},
962 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
963 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000964#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000965 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
966 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000967#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000968 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
969 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
970 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
971 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000972#ifdef WITH_TSC
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000973 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000974#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000975 {"settrace", sys_settrace, METH_O, settrace_doc},
976 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
977 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
978 {NULL, NULL} /* sentinel */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000979};
980
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000981static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000982list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000983{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000984 PyObject *list = PyList_New(0);
985 int i;
986 if (list == NULL)
987 return NULL;
988 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
989 PyObject *name = PyString_FromString(
990 PyImport_Inittab[i].name);
991 if (name == NULL)
992 break;
993 PyList_Append(list, name);
994 Py_DECREF(name);
995 }
996 if (PyList_Sort(list) != 0) {
997 Py_DECREF(list);
998 list = NULL;
999 }
1000 if (list) {
1001 PyObject *v = PyList_AsTuple(list);
1002 Py_DECREF(list);
1003 list = v;
1004 }
1005 return list;
Guido van Rossum34679b71993-01-26 13:33:44 +00001006}
1007
Guido van Rossum23fff912000-12-15 22:02:05 +00001008static PyObject *warnoptions = NULL;
1009
1010void
1011PySys_ResetWarnOptions(void)
1012{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001013 if (warnoptions == NULL || !PyList_Check(warnoptions))
1014 return;
1015 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
Guido van Rossum23fff912000-12-15 22:02:05 +00001016}
1017
1018void
1019PySys_AddWarnOption(char *s)
1020{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001021 PyObject *str;
Guido van Rossum23fff912000-12-15 22:02:05 +00001022
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001023 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
1024 Py_XDECREF(warnoptions);
1025 warnoptions = PyList_New(0);
1026 if (warnoptions == NULL)
1027 return;
1028 }
1029 str = PyString_FromString(s);
1030 if (str != NULL) {
1031 PyList_Append(warnoptions, str);
1032 Py_DECREF(str);
1033 }
Guido van Rossum23fff912000-12-15 22:02:05 +00001034}
1035
Brett Cannone9746892008-04-12 23:44:07 +00001036int
1037PySys_HasWarnOptions(void)
1038{
Brett Cannon40f0a872008-04-13 00:18:44 +00001039 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +00001040}
1041
Guido van Rossum40552d01998-08-06 03:34:39 +00001042/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
1043 Two literals concatenated works just fine. If you have a K&R compiler
1044 or other abomination that however *does* understand longer strings,
1045 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001046PyDoc_VAR(sys_doc) =
1047PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001048"This module provides access to some objects used or maintained by the\n\
1049interpreter and to functions that interact strongly with the interpreter.\n\
1050\n\
1051Dynamic objects:\n\
1052\n\
1053argv -- command line arguments; argv[0] is the script pathname if known\n\
1054path -- module search path; path[0] is the script directory, else ''\n\
1055modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001056\n\
1057displayhook -- called to show results in an interactive session\n\
1058excepthook -- called to handle any uncaught exception other than SystemExit\n\
1059 To customize printing in an interactive session or to install a custom\n\
1060 top-level exception handler, assign other functions to replace these.\n\
1061\n\
1062exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
1063 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001064\n\
1065stdin -- standard input file object; used by raw_input() and input()\n\
1066stdout -- standard output file object; used by the print statement\n\
1067stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001068 By assigning other file objects (or objects that behave like files)\n\
1069 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001070\n\
1071last_type -- type of last uncaught exception\n\
1072last_value -- value of last uncaught exception\n\
1073last_traceback -- traceback of last uncaught exception\n\
1074 These three are only available in an interactive session after a\n\
1075 traceback has been printed.\n\
1076\n\
1077exc_type -- type of exception currently being handled\n\
1078exc_value -- value of exception currently being handled\n\
1079exc_traceback -- traceback of exception currently being handled\n\
1080 The function exc_info() should be used instead of these three,\n\
1081 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001082"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001083)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001084/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001085PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001086"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001087Static objects:\n\
1088\n\
Mark Dickinsonefc82f72009-03-20 15:51:55 +00001089float_info -- a dict with information about the float inplementation.\n\
1090long_info -- a struct sequence with information about the long implementation.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001091maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwis4dd019f2008-05-20 08:11:19 +00001092maxsize -- the largest supported length of containers.\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001093maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +00001094builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001095version -- the version of this interpreter as a string\n\
Eric Smith81fe0932009-02-06 00:48:26 +00001096version_info -- version information as a named tuple\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001097hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001098copyright -- copyright notice pertaining to this interpreter\n\
1099platform -- platform identifier\n\
Petri Lehtinenfe6f9d02012-02-02 21:11:28 +02001100executable -- absolute path of the executable binary of the Python interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001101prefix -- prefix used to find the Python library\n\
1102exec_prefix -- prefix used to find the machine-specific Python library\n\
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001103float_repr_style -- string indicating the style of repr() output for floats\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001104"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001105)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001106#ifdef MS_WINDOWS
1107/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001108PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001109"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001110winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001111"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001112)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001113#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001114PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001115"__stdin__ -- the original stdin; don't touch!\n\
1116__stdout__ -- the original stdout; don't touch!\n\
1117__stderr__ -- the original stderr; don't touch!\n\
1118__displayhook__ -- the original displayhook; don't touch!\n\
1119__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001120\n\
1121Functions:\n\
1122\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001123displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001124excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001125exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001126exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001127exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001128getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001129getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001130getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001131getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +00001132getsizeof() -- return the size of an object in bytes\n\
Georg Brandl56112892008-01-20 13:59:46 +00001133gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001134setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001135setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001136setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001137setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001138settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001139"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001140)
Fred Drakeccede592000-08-14 20:59:57 +00001141/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001142
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001143static int
1144_check_and_flush (FILE *stream)
1145{
1146 int prev_fail = ferror (stream);
1147 return fflush (stream) || prev_fail ? EOF : 0;
1148}
1149
Martin v. Löwis43b57802006-01-05 23:38:54 +00001150/* Subversion branch and revision management */
Martin v. Löwis43b57802006-01-05 23:38:54 +00001151static int svn_initialized;
1152static char patchlevel_revision[50]; /* Just the number */
1153static char branch[50];
1154static char shortbranch[50];
1155static const char *svn_revision;
1156
Tim Peterse86e7a52006-01-06 02:42:46 +00001157static void
1158svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001159{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001160 if (svn_initialized)
1161 return;
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001162 svn_initialized = 1;
Benjamin Peterson7859d402011-03-25 16:57:30 -05001163 *patchlevel_revision = '\0';
1164 strcpy(branch, "");
1165 strcpy(shortbranch, "unknown");
1166 svn_revision = "";
1167 return;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001168}
1169
1170/* Return svnversion output if available.
1171 Else return Revision of patchlevel.h if on branch.
1172 Else return empty string */
1173const char*
1174Py_SubversionRevision()
1175{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001176 svnversion_init();
1177 return svn_revision;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001178}
1179
1180const char*
1181Py_SubversionShortBranch()
1182{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001183 svnversion_init();
1184 return shortbranch;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001185}
1186
Christian Heimesf31b69f2008-01-14 03:42:48 +00001187
1188PyDoc_STRVAR(flags__doc__,
1189"sys.flags\n\
1190\n\
1191Flags provided through command line arguments or environment vars.");
1192
Christian Heimes796fc312008-01-30 18:58:29 +00001193static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001194
1195static PyStructSequence_Field flags_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001196 {"debug", "-d"},
1197 {"py3k_warning", "-3"},
1198 {"division_warning", "-Q"},
1199 {"division_new", "-Qnew"},
1200 {"inspect", "-i"},
1201 {"interactive", "-i"},
1202 {"optimize", "-O or -OO"},
1203 {"dont_write_bytecode", "-B"},
1204 {"no_user_site", "-s"},
1205 {"no_site", "-S"},
1206 {"ignore_environment", "-E"},
1207 {"tabcheck", "-t or -tt"},
1208 {"verbose", "-v"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001209#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001210 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001211#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001212 /* {"unbuffered", "-u"}, */
1213 {"unicode", "-U"},
1214 /* {"skip_first", "-x"}, */
1215 {"bytes_warning", "-b"},
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001216 {"hash_randomization", "-R"},
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001217 {0}
Christian Heimesf31b69f2008-01-14 03:42:48 +00001218};
1219
1220static PyStructSequence_Desc flags_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001221 "sys.flags", /* name */
1222 flags__doc__, /* doc */
1223 flags_fields, /* fields */
Christian Heimesf31b69f2008-01-14 03:42:48 +00001224#ifdef RISCOS
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001225 17
Christian Heimesf31b69f2008-01-14 03:42:48 +00001226#else
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001227 16
Christian Heimesf31b69f2008-01-14 03:42:48 +00001228#endif
1229};
1230
1231static PyObject*
1232make_flags(void)
1233{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001234 int pos = 0;
1235 PyObject *seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001236
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001237 seq = PyStructSequence_New(&FlagsType);
1238 if (seq == NULL)
1239 return NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001240
1241#define SetFlag(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001242 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
Christian Heimesf31b69f2008-01-14 03:42:48 +00001243
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001244 SetFlag(Py_DebugFlag);
1245 SetFlag(Py_Py3kWarningFlag);
1246 SetFlag(Py_DivisionWarningFlag);
1247 SetFlag(_Py_QnewFlag);
1248 SetFlag(Py_InspectFlag);
1249 SetFlag(Py_InteractiveFlag);
1250 SetFlag(Py_OptimizeFlag);
1251 SetFlag(Py_DontWriteBytecodeFlag);
1252 SetFlag(Py_NoUserSiteDirectory);
1253 SetFlag(Py_NoSiteFlag);
1254 SetFlag(Py_IgnoreEnvironmentFlag);
1255 SetFlag(Py_TabcheckFlag);
1256 SetFlag(Py_VerboseFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001257#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001258 SetFlag(Py_RISCOSWimpFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001259#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001260 /* SetFlag(saw_unbuffered_flag); */
1261 SetFlag(Py_UnicodeFlag);
1262 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001263 SetFlag(Py_BytesWarningFlag);
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001264 SetFlag(Py_HashRandomizationFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001265#undef SetFlag
1266
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001267 if (PyErr_Occurred()) {
Serhiy Storchaka05854182013-12-17 14:59:29 +02001268 Py_DECREF(seq);
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001269 return NULL;
1270 }
1271 return seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001272}
1273
Eric Smith81fe0932009-02-06 00:48:26 +00001274PyDoc_STRVAR(version_info__doc__,
1275"sys.version_info\n\
1276\n\
1277Version information as a named tuple.");
1278
1279static PyTypeObject VersionInfoType = {0, 0, 0, 0, 0, 0};
1280
1281static PyStructSequence_Field version_info_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001282 {"major", "Major release number"},
1283 {"minor", "Minor release number"},
1284 {"micro", "Patch release number"},
1285 {"releaselevel", "'alpha', 'beta', 'candidate', or 'release'"},
1286 {"serial", "Serial release number"},
1287 {0}
Eric Smith81fe0932009-02-06 00:48:26 +00001288};
1289
1290static PyStructSequence_Desc version_info_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001291 "sys.version_info", /* name */
1292 version_info__doc__, /* doc */
1293 version_info_fields, /* fields */
1294 5
Eric Smith81fe0932009-02-06 00:48:26 +00001295};
1296
1297static PyObject *
1298make_version_info(void)
1299{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001300 PyObject *version_info;
1301 char *s;
1302 int pos = 0;
Eric Smith81fe0932009-02-06 00:48:26 +00001303
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001304 version_info = PyStructSequence_New(&VersionInfoType);
1305 if (version_info == NULL) {
1306 return NULL;
1307 }
Eric Smith81fe0932009-02-06 00:48:26 +00001308
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001309 /*
1310 * These release level checks are mutually exclusive and cover
1311 * the field, so don't get too fancy with the pre-processor!
1312 */
Eric Smith81fe0932009-02-06 00:48:26 +00001313#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001314 s = "alpha";
Eric Smith81fe0932009-02-06 00:48:26 +00001315#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001316 s = "beta";
Eric Smith81fe0932009-02-06 00:48:26 +00001317#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001318 s = "candidate";
Eric Smith81fe0932009-02-06 00:48:26 +00001319#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001320 s = "final";
Eric Smith81fe0932009-02-06 00:48:26 +00001321#endif
1322
1323#define SetIntItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001324 PyStructSequence_SET_ITEM(version_info, pos++, PyInt_FromLong(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001325#define SetStrItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001326 PyStructSequence_SET_ITEM(version_info, pos++, PyString_FromString(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001327
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001328 SetIntItem(PY_MAJOR_VERSION);
1329 SetIntItem(PY_MINOR_VERSION);
1330 SetIntItem(PY_MICRO_VERSION);
1331 SetStrItem(s);
1332 SetIntItem(PY_RELEASE_SERIAL);
Eric Smith81fe0932009-02-06 00:48:26 +00001333#undef SetIntItem
1334#undef SetStrItem
1335
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001336 if (PyErr_Occurred()) {
1337 Py_CLEAR(version_info);
1338 return NULL;
1339 }
1340 return version_info;
Eric Smith81fe0932009-02-06 00:48:26 +00001341}
1342
Guido van Rossum25ce5661997-08-02 03:10:38 +00001343PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001344_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001345{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001346 PyObject *m, *v, *sysdict;
1347 PyObject *sysin, *sysout, *syserr;
1348 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001349
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001350 m = Py_InitModule3("sys", sys_methods, sys_doc);
1351 if (m == NULL)
1352 return NULL;
1353 sysdict = PyModule_GetDict(m);
1354#define SET_SYS_FROM_STRING(key, value) \
1355 v = value; \
1356 if (v != NULL) \
1357 PyDict_SetItemString(sysdict, key, v); \
1358 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001359
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001360 /* Check that stdin is not a directory
1361 Using shell redirection, you can redirect stdin to a directory,
1362 crashing the Python interpreter. Catch this common mistake here
1363 and output a useful error message. Note that under MS Windows,
1364 the shell already prevents that. */
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001365#if !defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001366 {
1367 struct stat sb;
1368 if (fstat(fileno(stdin), &sb) == 0 &&
1369 S_ISDIR(sb.st_mode)) {
1370 /* There's nothing more we can do. */
1371 /* Py_FatalError() will core dump, so just exit. */
1372 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1373 exit(EXIT_FAILURE);
1374 }
1375 }
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001376#endif
Neal Norwitz11bd1192005-10-03 00:54:56 +00001377
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001378 /* Closing the standard FILE* if sys.std* goes aways causes problems
1379 * for embedded Python usages. Closing them when somebody explicitly
1380 * invokes .close() might be possible, but the FAQ promises they get
1381 * never closed. However, we still need to get write errors when
1382 * writing fails (e.g. because stdout is redirected), so we flush the
1383 * streams and check for errors before the file objects are deleted.
1384 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1385 * from that procedure.
1386 */
1387 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
1388 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1389 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
1390 if (PyErr_Occurred())
1391 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001392
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001393 PyDict_SetItemString(sysdict, "stdin", sysin);
1394 PyDict_SetItemString(sysdict, "stdout", sysout);
1395 PyDict_SetItemString(sysdict, "stderr", syserr);
1396 /* Make backup copies for cleanup */
1397 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1398 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1399 PyDict_SetItemString(sysdict, "__stderr__", syserr);
1400 PyDict_SetItemString(sysdict, "__displayhook__",
1401 PyDict_GetItemString(sysdict, "displayhook"));
1402 PyDict_SetItemString(sysdict, "__excepthook__",
1403 PyDict_GetItemString(sysdict, "excepthook"));
1404 Py_XDECREF(sysin);
1405 Py_XDECREF(sysout);
1406 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001407
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001408 SET_SYS_FROM_STRING("version",
1409 PyString_FromString(Py_GetVersion()));
1410 SET_SYS_FROM_STRING("hexversion",
1411 PyInt_FromLong(PY_VERSION_HEX));
1412 svnversion_init();
1413 SET_SYS_FROM_STRING("subversion",
1414 Py_BuildValue("(ssz)", "CPython", branch,
1415 svn_revision));
Georg Brandl3a5508e2011-03-06 10:42:21 +01001416 SET_SYS_FROM_STRING("_mercurial",
1417 Py_BuildValue("(szz)", "CPython", _Py_hgidentifier(),
1418 _Py_hgversion()));
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001419 SET_SYS_FROM_STRING("dont_write_bytecode",
1420 PyBool_FromLong(Py_DontWriteBytecodeFlag));
1421 SET_SYS_FROM_STRING("api_version",
1422 PyInt_FromLong(PYTHON_API_VERSION));
1423 SET_SYS_FROM_STRING("copyright",
1424 PyString_FromString(Py_GetCopyright()));
1425 SET_SYS_FROM_STRING("platform",
1426 PyString_FromString(Py_GetPlatform()));
1427 SET_SYS_FROM_STRING("executable",
1428 PyString_FromString(Py_GetProgramFullPath()));
1429 SET_SYS_FROM_STRING("prefix",
1430 PyString_FromString(Py_GetPrefix()));
1431 SET_SYS_FROM_STRING("exec_prefix",
1432 PyString_FromString(Py_GetExecPrefix()));
1433 SET_SYS_FROM_STRING("maxsize",
1434 PyInt_FromSsize_t(PY_SSIZE_T_MAX));
1435 SET_SYS_FROM_STRING("maxint",
1436 PyInt_FromLong(PyInt_GetMax()));
1437 SET_SYS_FROM_STRING("py3kwarning",
1438 PyBool_FromLong(Py_Py3kWarningFlag));
1439 SET_SYS_FROM_STRING("float_info",
1440 PyFloat_GetInfo());
1441 SET_SYS_FROM_STRING("long_info",
1442 PyLong_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001443#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001444 SET_SYS_FROM_STRING("maxunicode",
1445 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001446#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001447 SET_SYS_FROM_STRING("builtin_module_names",
1448 list_builtin_module_names());
1449 {
1450 /* Assumes that longs are at least 2 bytes long.
1451 Should be safe! */
1452 unsigned long number = 1;
1453 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001454
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001455 s = (char *) &number;
1456 if (s[0] == 0)
1457 value = "big";
1458 else
1459 value = "little";
1460 SET_SYS_FROM_STRING("byteorder",
1461 PyString_FromString(value));
1462 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001463#ifdef MS_COREDLL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001464 SET_SYS_FROM_STRING("dllhandle",
1465 PyLong_FromVoidPtr(PyWin_DLLhModule));
1466 SET_SYS_FROM_STRING("winver",
1467 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001468#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001469 if (warnoptions == NULL) {
1470 warnoptions = PyList_New(0);
1471 }
1472 else {
1473 Py_INCREF(warnoptions);
1474 }
1475 if (warnoptions != NULL) {
1476 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
1477 }
Tim Peters216b78b2006-01-06 02:40:53 +00001478
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001479 /* version_info */
1480 if (VersionInfoType.tp_name == 0)
1481 PyStructSequence_InitType(&VersionInfoType, &version_info_desc);
1482 SET_SYS_FROM_STRING("version_info", make_version_info());
1483 /* prevent user from creating new instances */
1484 VersionInfoType.tp_init = NULL;
1485 VersionInfoType.tp_new = NULL;
Eric Smith81fe0932009-02-06 00:48:26 +00001486
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001487 /* flags */
1488 if (FlagsType.tp_name == 0)
1489 PyStructSequence_InitType(&FlagsType, &flags_desc);
1490 SET_SYS_FROM_STRING("flags", make_flags());
1491 /* prevent user from creating new instances */
1492 FlagsType.tp_init = NULL;
1493 FlagsType.tp_new = NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001494
Eric Smithee931b72010-01-27 00:28:29 +00001495
1496#if defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001497 /* getwindowsversion */
1498 if (WindowsVersionType.tp_name == 0)
1499 PyStructSequence_InitType(&WindowsVersionType, &windows_version_desc);
1500 /* prevent user from creating new instances */
1501 WindowsVersionType.tp_init = NULL;
1502 WindowsVersionType.tp_new = NULL;
Eric Smithee931b72010-01-27 00:28:29 +00001503#endif
1504
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001505 /* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001506#ifndef PY_NO_SHORT_FLOAT_REPR
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001507 SET_SYS_FROM_STRING("float_repr_style",
1508 PyString_FromString("short"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001509#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001510 SET_SYS_FROM_STRING("float_repr_style",
1511 PyString_FromString("legacy"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001512#endif
1513
Christian Heimes0d924432008-01-30 17:21:22 +00001514#undef SET_SYS_FROM_STRING
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001515 if (PyErr_Occurred())
1516 return NULL;
1517 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001518}
1519
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001520static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001521makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001522{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001523 int i, n;
1524 char *p;
1525 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001526
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001527 n = 1;
1528 p = path;
1529 while ((p = strchr(p, delim)) != NULL) {
1530 n++;
1531 p++;
1532 }
1533 v = PyList_New(n);
1534 if (v == NULL)
1535 return NULL;
1536 for (i = 0; ; i++) {
1537 p = strchr(path, delim);
1538 if (p == NULL)
1539 p = strchr(path, '\0'); /* End of string */
1540 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
1541 if (w == NULL) {
1542 Py_DECREF(v);
1543 return NULL;
1544 }
1545 PyList_SetItem(v, i, w);
1546 if (*p == '\0')
1547 break;
1548 path = p+1;
1549 }
1550 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001551}
1552
1553void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001554PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001555{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001556 PyObject *v;
1557 if ((v = makepathobject(path, DELIM)) == NULL)
1558 Py_FatalError("can't create sys.path");
1559 if (PySys_SetObject("path", v) != 0)
1560 Py_FatalError("can't assign sys.path");
1561 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001562}
1563
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001564static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001565makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001566{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001567 PyObject *av;
1568 if (argc <= 0 || argv == NULL) {
1569 /* Ensure at least one (empty) argument is seen */
1570 static char *empty_argv[1] = {""};
1571 argv = empty_argv;
1572 argc = 1;
1573 }
1574 av = PyList_New(argc);
1575 if (av != NULL) {
1576 int i;
1577 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001578#ifdef __VMS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001579 PyObject *v;
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001580
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001581 /* argv[0] is the script pathname if known */
1582 if (i == 0) {
1583 char* fn = decc$translate_vms(argv[0]);
1584 if ((fn == (char *)0) || fn == (char *)-1)
1585 v = PyString_FromString(argv[0]);
1586 else
1587 v = PyString_FromString(
1588 decc$translate_vms(argv[0]));
1589 } else
1590 v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001591#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001592 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001593#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001594 if (v == NULL) {
1595 Py_DECREF(av);
1596 av = NULL;
1597 break;
1598 }
1599 PyList_SetItem(av, i, v);
1600 }
1601 }
1602 return av;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001603}
1604
1605void
Antoine Pitrou6a265602010-05-21 17:12:38 +00001606PySys_SetArgvEx(int argc, char **argv, int updatepath)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001607{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001608#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001609 char fullpath[MAXPATHLEN];
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001610#elif defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001611 char fullpath[MAX_PATH];
Thomas Heller27bb71e2003-01-08 14:33:48 +00001612#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001613 PyObject *av = makeargvobject(argc, argv);
1614 PyObject *path = PySys_GetObject("path");
1615 if (av == NULL)
1616 Py_FatalError("no mem for sys.argv");
1617 if (PySys_SetObject("argv", av) != 0)
1618 Py_FatalError("can't assign sys.argv");
Antoine Pitrou6a265602010-05-21 17:12:38 +00001619 if (updatepath && path != NULL) {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001620 char *argv0 = argv[0];
1621 char *p = NULL;
1622 Py_ssize_t n = 0;
1623 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001624#ifdef HAVE_READLINK
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001625 char link[MAXPATHLEN+1];
1626 char argv0copy[2*MAXPATHLEN+1];
1627 int nr = 0;
1628 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
1629 nr = readlink(argv0, link, MAXPATHLEN);
1630 if (nr > 0) {
1631 /* It's a symlink */
1632 link[nr] = '\0';
1633 if (link[0] == SEP)
1634 argv0 = link; /* Link to absolute path */
1635 else if (strchr(link, SEP) == NULL)
1636 ; /* Link without path */
1637 else {
1638 /* Must join(dirname(argv0), link) */
1639 char *q = strrchr(argv0, SEP);
1640 if (q == NULL)
1641 argv0 = link; /* argv0 without path */
1642 else {
1643 /* Must make a copy */
1644 strcpy(argv0copy, argv0);
1645 q = strrchr(argv0copy, SEP);
1646 strcpy(q+1, link);
1647 argv0 = argv0copy;
1648 }
1649 }
1650 }
Guido van Rossumc474dea1997-04-25 15:38:31 +00001651#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001652#if SEP == '\\' /* Special case for MS filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001653 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
1654 char *q;
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001655#if defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001656 /* This code here replaces the first element in argv with the full
1657 path that it represents. Under CE, there are no relative paths so
1658 the argument must be the full path anyway. */
1659 char *ptemp;
1660 if (GetFullPathName(argv0,
1661 sizeof(fullpath),
1662 fullpath,
1663 &ptemp)) {
1664 argv0 = fullpath;
1665 }
Thomas Heller27bb71e2003-01-08 14:33:48 +00001666#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001667 p = strrchr(argv0, SEP);
1668 /* Test for alternate separator */
1669 q = strrchr(p ? p : argv0, '/');
1670 if (q != NULL)
1671 p = q;
1672 if (p != NULL) {
1673 n = p + 1 - argv0;
1674 if (n > 1 && p[-1] != ':')
1675 n--; /* Drop trailing separator */
1676 }
1677 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001678#else /* All other filename syntaxes */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001679 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001680#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001681 if (realpath(argv0, fullpath)) {
1682 argv0 = fullpath;
1683 }
Guido van Rossum162e38c2003-02-19 15:25:10 +00001684#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001685 p = strrchr(argv0, SEP);
1686 }
1687 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001688#ifndef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001689 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001690#else /* don't include trailing separator */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001691 n = p - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001692#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001693#if SEP == '/' /* Special case for Unix filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001694 if (n > 1)
1695 n--; /* Drop trailing separator */
Guido van Rossumcc883411996-09-10 14:44:21 +00001696#endif /* Unix */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001697 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001698#endif /* All others */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001699 a = PyString_FromStringAndSize(argv0, n);
1700 if (a == NULL)
1701 Py_FatalError("no mem for sys.path insertion");
1702 if (PyList_Insert(path, 0, a) < 0)
1703 Py_FatalError("sys.path.insert(0) failed");
1704 Py_DECREF(a);
1705 }
1706 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001707}
Guido van Rossuma890e681998-05-12 14:59:24 +00001708
Antoine Pitrou6a265602010-05-21 17:12:38 +00001709void
1710PySys_SetArgv(int argc, char **argv)
1711{
1712 PySys_SetArgvEx(argc, argv, 1);
1713}
1714
Guido van Rossuma890e681998-05-12 14:59:24 +00001715
1716/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1717 Adapted from code submitted by Just van Rossum.
1718
1719 PySys_WriteStdout(format, ...)
1720 PySys_WriteStderr(format, ...)
1721
1722 The first function writes to sys.stdout; the second to sys.stderr. When
1723 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001724 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001725
1726 Both take a printf-style format string as their first argument followed
1727 by a variable length argument list determined by the format string.
1728
1729 *** WARNING ***
1730
1731 The format should limit the total size of the formatted output string to
1732 1000 bytes. In particular, this means that no unrestricted "%s" formats
1733 should occur; these should be limited using "%.<N>s where <N> is a
1734 decimal number calculated so that <N> plus the maximum size of other
1735 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1736 which can print hundreds of digits for very large numbers.
1737
1738 */
1739
1740static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001741mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001742{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001743 PyObject *file;
1744 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001745
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001746 PyErr_Fetch(&error_type, &error_value, &error_traceback);
1747 file = PySys_GetObject(name);
1748 if (file == NULL || PyFile_AsFile(file) == fp)
1749 vfprintf(fp, format, va);
1750 else {
1751 char buffer[1001];
1752 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1753 format, va);
1754 if (PyFile_WriteString(buffer, file) != 0) {
1755 PyErr_Clear();
1756 fputs(buffer, fp);
1757 }
1758 if (written < 0 || (size_t)written >= sizeof(buffer)) {
1759 const char *truncated = "... truncated";
1760 if (PyFile_WriteString(truncated, file) != 0) {
1761 PyErr_Clear();
1762 fputs(truncated, fp);
1763 }
1764 }
1765 }
1766 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001767}
1768
1769void
Guido van Rossuma890e681998-05-12 14:59:24 +00001770PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001771{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001772 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001773
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001774 va_start(va, format);
1775 mywrite("stdout", stdout, format, va);
1776 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001777}
1778
1779void
Guido van Rossuma890e681998-05-12 14:59:24 +00001780PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001781{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001782 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001783
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001784 va_start(va, format);
1785 mywrite("stderr", stderr, format, va);
1786 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001787}