1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371
|
#ifndef WITH_THREAD
# error "xxx no-thread configuration not tested, please report if you need that"
#endif
#include "pythread.h"
struct cffi_tls_s {
/* The current thread's ThreadCanaryObj. This is only non-null in
case cffi builds the thread state here. It remains null if this
thread had already a thread state provided by CPython. */
struct thread_canary_s *local_thread_canary;
#ifndef USE__THREAD
/* The saved errno. If the C compiler supports '__thread', then
we use that instead. */
int saved_errno;
#endif
#ifdef MS_WIN32
/* The saved lasterror, on Windows. */
int saved_lasterror;
#endif
};
static struct cffi_tls_s *get_cffi_tls(void); /* in misc_thread_posix.h
or misc_win32.h */
/* We try to keep the PyThreadState around in a thread not started by
* Python but where cffi callbacks occur. If we didn't do that, then
* the standard logic in PyGILState_Ensure() and PyGILState_Release()
* would create a new PyThreadState and completely free it for every
* single call. For some applications, this is a huge slow-down.
*
* As shown by issue #362, it is quite messy to do. The current
* solution is to keep the PyThreadState alive by incrementing its
* 'gilstate_counter'. We detect thread shut-down, and we put the
* PyThreadState inside a list of zombies (we can't free it
* immediately because we don't have the GIL at that point in time).
* We also detect other pieces of code (notably Py_Finalize()) which
* clear and free PyThreadStates under our feet, using ThreadCanaryObj.
*/
#define TLS_ZOM_LOCK() PyThread_acquire_lock(cffi_zombie_lock, WAIT_LOCK)
#define TLS_ZOM_UNLOCK() PyThread_release_lock(cffi_zombie_lock)
static PyThread_type_lock cffi_zombie_lock = NULL;
/* A 'canary' object is created in a thread when there is a callback
invoked, and that thread has no PyThreadState so far. It is an
object of reference count equal to 1, which is stored in the
PyThreadState->dict. Two things can occur then:
1. The PyThreadState can be forcefully cleared by Py_Finalize().
Then thread_canary_dealloc() is called, and we have to cancel
the hacks we did to keep the PyThreadState alive.
2. The thread finishes. In that case, we put the canary in a list
of zombies, and at some convenient time later when we have the
GIL, we free all PyThreadStates in the zombie list.
Some more fun comes from the fact that thread_canary_dealloc() can
be called at a point where the canary is in the zombie list already.
Also, the various pieces are freed at specific points in time, and
we must make sure not to access already-freed structures:
- the struct cffi_tls_s is valid until the thread shuts down, and
then it is freed by cffi_thread_shutdown().
- the canary is a normal Python object, but we have a borrowed
reference to it from cffi_tls_s.local_thread_canary.
*/
typedef struct thread_canary_s {
PyObject_HEAD
struct thread_canary_s *zombie_prev, *zombie_next;
PyThreadState *tstate;
struct cffi_tls_s *tls;
} ThreadCanaryObj;
static PyTypeObject ThreadCanary_Type; /* forward */
static ThreadCanaryObj cffi_zombie_head;
static void
_thread_canary_detach_with_lock(ThreadCanaryObj *ob)
{
/* must be called with both the GIL and TLS_ZOM_LOCK. */
ThreadCanaryObj *p, *n;
p = ob->zombie_prev;
n = ob->zombie_next;
p->zombie_next = n;
n->zombie_prev = p;
ob->zombie_prev = NULL;
ob->zombie_next = NULL;
}
static void
thread_canary_dealloc(ThreadCanaryObj *ob)
{
/* this ThreadCanaryObj is being freed: if it is in the zombie
chained list, remove it. Thread-safety: 'zombie_next' amd
'local_thread_canary' accesses need to be protected with
the TLS_ZOM_LOCK.
*/
TLS_ZOM_LOCK();
if (ob->zombie_next != NULL) {
//fprintf(stderr, "thread_canary_dealloc(%p): ZOMBIE\n", ob);
_thread_canary_detach_with_lock(ob);
}
else {
//fprintf(stderr, "thread_canary_dealloc(%p): not a zombie\n", ob);
}
if (ob->tls != NULL) {
//fprintf(stderr, "thread_canary_dealloc(%p): was local_thread_canary\n", ob);
assert(ob->tls->local_thread_canary == ob);
ob->tls->local_thread_canary = NULL;
}
TLS_ZOM_UNLOCK();
PyObject_Del((PyObject *)ob);
}
static void
thread_canary_make_zombie(ThreadCanaryObj *ob)
{
/* This must be called without the GIL, but with the TLS_ZOM_LOCK.
It must be called at most once for a given ThreadCanaryObj. */
ThreadCanaryObj *last;
//fprintf(stderr, "thread_canary_make_zombie(%p)\n", ob);
if (ob->zombie_next)
Py_FatalError("cffi: ThreadCanaryObj is already a zombie");
last = cffi_zombie_head.zombie_prev;
ob->zombie_next = &cffi_zombie_head;
ob->zombie_prev = last;
last->zombie_next = ob;
cffi_zombie_head.zombie_prev = ob;
}
static void
thread_canary_free_zombies(void)
{
/* This must be called with the GIL. */
if (cffi_zombie_head.zombie_next == &cffi_zombie_head)
return; /* fast path */
while (1) {
ThreadCanaryObj *ob;
PyThreadState *tstate = NULL;
TLS_ZOM_LOCK();
ob = cffi_zombie_head.zombie_next;
if (ob != &cffi_zombie_head) {
tstate = ob->tstate;
//fprintf(stderr, "thread_canary_free_zombie(%p) tstate=%p\n", ob, tstate);
_thread_canary_detach_with_lock(ob);
if (tstate == NULL)
Py_FatalError("cffi: invalid ThreadCanaryObj->tstate");
}
TLS_ZOM_UNLOCK();
if (tstate == NULL)
break;
PyThreadState_Clear(tstate); /* calls thread_canary_dealloc on 'ob',
but now ob->zombie_next == NULL. */
PyThreadState_Delete(tstate);
//fprintf(stderr, "thread_canary_free_zombie: cleared and deleted tstate=%p\n", tstate);
}
//fprintf(stderr, "thread_canary_free_zombie: end\n");
}
static void
thread_canary_register(PyThreadState *tstate)
{
/* called with the GIL; 'tstate' is the current PyThreadState. */
ThreadCanaryObj *canary;
PyObject *tdict;
struct cffi_tls_s *tls;
int err;
/* first free the zombies, if any */
thread_canary_free_zombies();
tls = get_cffi_tls();
if (tls == NULL)
goto ignore_error;
tdict = PyThreadState_GetDict();
if (tdict == NULL)
goto ignore_error;
canary = PyObject_New(ThreadCanaryObj, &ThreadCanary_Type);
//fprintf(stderr, "thread_canary_register(%p): tstate=%p tls=%p\n", canary, tstate, tls);
if (canary == NULL)
goto ignore_error;
canary->zombie_prev = NULL;
canary->zombie_next = NULL;
canary->tstate = tstate;
canary->tls = tls;
err = PyDict_SetItemString(tdict, "cffi.thread.canary", (PyObject *)canary);
Py_DECREF(canary);
if (err < 0)
goto ignore_error;
/* thread-safety: we have the GIL here, and 'tstate' is the one that
corresponds to our own thread. We are allocating a new 'canary'
and setting it up for our own thread, both in 'tdict' (which owns
the reference) and in 'tls->local_thread_canary' (which doesn't). */
assert(Py_REFCNT(canary) == 1);
tls->local_thread_canary = canary;
tstate->gilstate_counter++;
/* ^^^ this means 'tstate' will never be automatically freed by
PyGILState_Release() */
return;
ignore_error:
PyErr_Clear();
}
static PyTypeObject ThreadCanary_Type = {
PyVarObject_HEAD_INIT(NULL, 0)
"_cffi_backend.thread_canary",
sizeof(ThreadCanaryObj),
0,
(destructor)thread_canary_dealloc, /* tp_dealloc */
0, /* tp_print */
0, /* tp_getattr */
0, /* tp_setattr */
0, /* tp_compare */
0, /* tp_repr */
0, /* tp_as_number */
0, /* tp_as_sequence */
0, /* tp_as_mapping */
0, /* tp_hash */
0, /* tp_call */
0, /* tp_str */
0, /* tp_getattro */
0, /* tp_setattro */
0, /* tp_as_buffer */
Py_TPFLAGS_DEFAULT, /* tp_flags */
};
static void init_cffi_tls_zombie(void)
{
cffi_zombie_head.zombie_next = &cffi_zombie_head;
cffi_zombie_head.zombie_prev = &cffi_zombie_head;
cffi_zombie_lock = PyThread_allocate_lock();
if (cffi_zombie_lock == NULL)
PyErr_SetString(PyExc_SystemError, "can't allocate cffi_zombie_lock");
}
static void cffi_thread_shutdown(void *p)
{
/* this function is called from misc_thread_posix or misc_win32
when a thread is about to end. */
struct cffi_tls_s *tls = (struct cffi_tls_s *)p;
/* thread-safety: this field 'local_thread_canary' can be reset
to NULL in parallel, protected by TLS_ZOM_LOCK. */
TLS_ZOM_LOCK();
if (tls->local_thread_canary != NULL) {
tls->local_thread_canary->tls = NULL;
thread_canary_make_zombie(tls->local_thread_canary);
}
TLS_ZOM_UNLOCK();
//fprintf(stderr, "thread_shutdown(%p)\n", tls);
free(tls);
}
/* USE__THREAD is defined by setup.py if it finds that it is
syntactically valid to use "__thread" with this C compiler. */
#ifdef USE__THREAD
static __thread int cffi_saved_errno = 0;
static void save_errno_only(void) { cffi_saved_errno = errno; }
static void restore_errno_only(void) { errno = cffi_saved_errno; }
#else
static void save_errno_only(void)
{
int saved = errno;
struct cffi_tls_s *tls = get_cffi_tls();
if (tls != NULL)
tls->saved_errno = saved;
}
static void restore_errno_only(void)
{
struct cffi_tls_s *tls = get_cffi_tls();
if (tls != NULL)
errno = tls->saved_errno;
}
#endif
/* MESS. We can't use PyThreadState_GET(), because that calls
PyThreadState_Get() which fails an assert if the result is NULL.
* in Python 2.7 and <= 3.4, the variable _PyThreadState_Current
is directly available, so use that.
* in Python 3.5, the variable is available too, but it might be
the case that the headers don't define it (this changed in 3.5.1).
In case we're compiling with 3.5.x with x >= 1, we need to
manually define this variable.
* in Python >= 3.6 there is _PyThreadState_UncheckedGet().
It was added in 3.5.2 but should never be used in 3.5.x
because it is not available in 3.5.0 or 3.5.1.
*/
#if PY_VERSION_HEX >= 0x03050100 && PY_VERSION_HEX < 0x03060000
PyAPI_DATA(void *volatile) _PyThreadState_Current;
#endif
static PyThreadState *get_current_ts(void)
{
#if PY_VERSION_HEX >= 0x03060000
return _PyThreadState_UncheckedGet();
#elif defined(_Py_atomic_load_relaxed)
return (PyThreadState*)_Py_atomic_load_relaxed(&_PyThreadState_Current);
#else
return (PyThreadState*)_PyThreadState_Current; /* assume atomic read */
#endif
}
static PyGILState_STATE gil_ensure(void)
{
/* Called at the start of a callback. Replacement for
PyGILState_Ensure().
*/
PyGILState_STATE result;
PyThreadState *ts = PyGILState_GetThisThreadState();
if (ts != NULL) {
ts->gilstate_counter++;
if (ts != get_current_ts()) {
/* common case: 'ts' is our non-current thread state and
we have to make it current and acquire the GIL */
PyEval_RestoreThread(ts);
return PyGILState_UNLOCKED;
}
else {
return PyGILState_LOCKED;
}
}
else {
/* no thread state here so far. */
result = PyGILState_Ensure();
assert(result == PyGILState_UNLOCKED);
ts = PyGILState_GetThisThreadState();
assert(ts != NULL);
assert(ts == get_current_ts());
assert(ts->gilstate_counter >= 1);
/* Use the ThreadCanary mechanism to keep 'ts' alive until the
thread really shuts down */
thread_canary_register(ts);
return result;
}
}
static void gil_release(PyGILState_STATE oldstate)
{
PyGILState_Release(oldstate);
}
|