Include/pystate.h

   1
   2 /* Thread and interpreter state structures and their interfaces */
   3
   4
   5 #ifndef Py_PYSTATE_H
   6 #define Py_PYSTATE_H
   7 #ifdef __cplusplus
   8 extern "C" {
   9 #endif
  10
  11 /* State shared between threads */
  12
  13 struct _ts; /* Forward */
  14 struct _is; /* Forward */
  15
  16 typedef struct _is {
  17
  18     struct _is *next;
  19     struct _ts *tstate_head;
  20
  21     PyObject *modules;
  22     PyObject *sysdict;
  23     PyObject *builtins;
  24
  25 #ifdef HAVE_DLOPEN
  26     int dlopenflags;
  27 #endif
  28
  29 } PyInterpreterState;
  30
  31
  32 /* State unique per thread */
  33
  34 struct _frame; /* Avoid including frameobject.h */
  35
  36 /* Py_tracefunc return -1 when raising an exception, or 0 for success. */
  37 typedef int (*Py_tracefunc)(PyObject *, struct _frame *, int, PyObject *);
  38
  39 /* The following values are used for 'what' for tracefunc functions: */
  40 #define PyTrace_CALL 0
  41 #define PyTrace_EXCEPTION 1
  42 #define PyTrace_LINE 2
  43 #define PyTrace_RETURN 3
  44
  45 typedef struct _ts {
  46
  47     struct _ts *next;
  48     PyInterpreterState *interp;
  49
  50     struct _frame *frame;
  51     int recursion_depth;
  52     int tracing;
  53     int use_tracing;
  54
  55     Py_tracefunc c_profilefunc;
  56     Py_tracefunc c_tracefunc;
  57     PyObject *c_profileobj;
  58     PyObject *c_traceobj;
  59
  60     PyObject *curexc_type;
  61     PyObject *curexc_value;
  62     PyObject *curexc_traceback;
  63
  64     PyObject *exc_type;
  65     PyObject *exc_value;
  66     PyObject *exc_traceback;
  67
  68     PyObject *dict;
  69
  70     int tick_counter;
  71
  72     /* XXX signal handlers should also be here */
  73
  74 } PyThreadState;
  75
  76
  77 PyAPI_FUNC(PyInterpreterState *) PyInterpreterState_New(void);
  78 PyAPI_FUNC(void) PyInterpreterState_Clear(PyInterpreterState *);
  79 PyAPI_FUNC(void) PyInterpreterState_Delete(PyInterpreterState *);
  80
  81 PyAPI_FUNC(PyThreadState *) PyThreadState_New(PyInterpreterState *);
  82 PyAPI_FUNC(void) PyThreadState_Clear(PyThreadState *);
  83 PyAPI_FUNC(void) PyThreadState_Delete(PyThreadState *);
  84 #ifdef WITH_THREAD
  85 PyAPI_FUNC(void) PyThreadState_DeleteCurrent(void);
  86 #endif
  87
  88 PyAPI_FUNC(PyThreadState *) PyThreadState_Get(void);
  89 PyAPI_FUNC(PyThreadState *) PyThreadState_Swap(PyThreadState *);
  90 PyAPI_FUNC(PyObject *) PyThreadState_GetDict(void);
  91
  92
  93 /* Variable and macro for in-line access to current thread state */
  94
  95 PyAPI_DATA(PyThreadState *) _PyThreadState_Current;
  96
  97 #ifdef Py_DEBUG
  98 #define PyThreadState_GET() PyThreadState_Get()
  99 #else
 100 #define PyThreadState_GET() (_PyThreadState_Current)
 101 #endif
 102
 103 /* Routines for advanced debuggers, requested by David Beazley.
 104    Don't use unless you know what you are doing! */
 105 PyAPI_FUNC(PyInterpreterState *) PyInterpreterState_Head(void);
 106 PyAPI_FUNC(PyInterpreterState *) PyInterpreterState_Next(PyInterpreterState *);
 107 PyAPI_FUNC(PyThreadState *) PyInterpreterState_ThreadHead(PyInterpreterState *);
 108 PyAPI_FUNC(PyThreadState *) PyThreadState_Next(PyThreadState *);
 109
 110 typedef struct _frame *(*PyThreadFrameGetter)(PyThreadState *self_);
 111
 112 /* hook for PyEval_GetFrame(), requested for Psyco */
 113 PyAPI_DATA(PyThreadFrameGetter) _PyThreadState_GetFrame;
 114
 115 #ifdef __cplusplus
 116 }
 117 #endif
 118 #endif /* !Py_PYSTATE_H */