1 #define PERL_NO_GET_CONTEXT
6 /* Magic signature for Thread's mg_private is "Th" */
7 #define Thread_MAGIC_SIGNATURE 0x5468
16 static int sig_pipe[2];
18 #ifndef THREAD_RET_TYPE
19 #define THREAD_RET_TYPE void *
20 #define THREAD_RET_CAST(x) ((THREAD_RET_TYPE) x)
24 remove_thread(pTHX_ Thread t)
27 DEBUG_S(WITH_THR(PerlIO_printf(Perl_debug_log,
28 "%p: remove_thread %p\n", thr, t)));
29 MUTEX_LOCK(&PL_threads_mutex);
30 MUTEX_DESTROY(&t->mutex);
32 t->prev->next = t->next;
33 t->next->prev = t->prev;
34 SvREFCNT_dec(t->oursv);
35 COND_BROADCAST(&PL_nthreads_cond);
36 MUTEX_UNLOCK(&PL_threads_mutex);
40 static THREAD_RET_TYPE
41 threadstart(void *arg)
45 Thread savethread = thr;
48 I32 oldscope = PL_scopestack_ix;
53 DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p starting at %s\n",
57 thr->prev = thr->prev_run = savethread;
58 thr->next = savethread->next;
59 thr->next_run = savethread->next_run;
60 savethread->next = savethread->next_run = thr;
64 /* Now duplicate most of perl_call_sv but with a few twists */
66 Zero(PL_op, 1, LOGOP);
67 myop.op_flags = OPf_STACKED;
68 myop.op_next = Nullop;
69 myop.op_flags |= OPf_KNOW;
70 myop.op_flags |= OPf_WANT_LIST;
71 PL_op = pp_entersub(ARGS);
73 PerlIO_printf(Perl_debug_log, "thread starts at Nullop\n"));
75 * When this thread is next scheduled, we start in the right
76 * place. When the thread runs off the end of the sub, perl.c
77 * handles things, using savemark to figure out how much of the
78 * stack is the return value for any join.
80 thr = savethread; /* back to the old thread */
83 Thread thr = (Thread) arg;
85 I32 oldmark = TOPMARK;
91 #if defined(MULTIPLICITY)
92 PERL_SET_INTERP(thr->interp);
95 DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p waiting to start\n",
99 * Wait until our creator releases us. If we didn't do this, then
100 * it would be potentially possible for out thread to carry on and
101 * do stuff before our creator fills in our "self" field. For example,
102 * if we went and created another thread which tried to JOIN with us,
103 * then we'd be in a mess.
105 MUTEX_LOCK(&thr->mutex);
106 MUTEX_UNLOCK(&thr->mutex);
109 * It's safe to wait until now to set the thread-specific pointer
110 * from our pthread_t structure to our struct perl_thread, since
111 * we're the only thread who can get at it anyway.
115 DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p starting at %s\n",
123 perl_call_sv(sv, G_ARRAY|G_EVAL);
125 retval = SP - (PL_stack_base + oldmark);
126 SP = PL_stack_base + oldmark + 1;
127 if (SvCUR(thr->errsv)) {
128 MUTEX_LOCK(&thr->mutex);
129 thr->flags |= THRf_DID_DIE;
130 MUTEX_UNLOCK(&thr->mutex);
131 av_store(av, 0, &PL_sv_no);
132 av_store(av, 1, newSVsv(thr->errsv));
133 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p died: %s\n",
134 thr, SvPV(thr->errsv, PL_na)));
138 for (i = 1; i <= retval; i++) {
139 PerlIO_printf(Perl_debug_log, "%p return[%d] = %s\n",
140 thr, i, SvPEEK(SP[i - 1]));
143 av_store(av, 0, &PL_sv_yes);
144 for (i = 1; i <= retval; i++, SP++)
145 sv_setsv(*av_fetch(av, i, TRUE), SvREFCNT_inc(*SP));
151 /* removed for debug */
152 SvREFCNT_dec(PL_curstack);
154 SvREFCNT_dec(thr->cvcache);
155 SvREFCNT_dec(thr->threadsv);
156 SvREFCNT_dec(thr->specific);
157 SvREFCNT_dec(thr->errsv);
159 /*Safefree(cxstack);*/
160 while (PL_curstackinfo->si_next)
161 PL_curstackinfo = PL_curstackinfo->si_next;
162 while (PL_curstackinfo) {
163 PERL_SI *p = PL_curstackinfo->si_prev;
164 SvREFCNT_dec(PL_curstackinfo->si_stack);
165 Safefree(PL_curstackinfo->si_cxstack);
166 Safefree(PL_curstackinfo);
169 Safefree(PL_markstack);
170 Safefree(PL_scopestack);
171 Safefree(PL_savestack);
172 Safefree(PL_retstack);
173 Safefree(PL_tmps_stack);
174 SvREFCNT_dec(PL_ofs_sv);
177 SvREFCNT_dec(PL_nrs);
178 SvREFCNT_dec(PL_statname);
179 SvREFCNT_dec(PL_errors);
180 Safefree(PL_screamfirst);
181 Safefree(PL_screamnext);
182 Safefree(PL_reg_start_tmp);
183 SvREFCNT_dec(PL_lastscream);
184 SvREFCNT_dec(PL_defoutgv);
185 Safefree(PL_reg_poscache);
187 MUTEX_LOCK(&thr->mutex);
189 DEBUG_S(PerlIO_printf(Perl_debug_log,
190 "%p: threadstart finishing: state is %u\n",
191 thr, ThrSTATE(thr)));
192 switch (ThrSTATE(thr)) {
193 case THRf_R_JOINABLE:
194 ThrSETSTATE(thr, THRf_ZOMBIE);
195 MUTEX_UNLOCK(&thr->mutex);
196 DEBUG_S(PerlIO_printf(Perl_debug_log,
197 "%p: R_JOINABLE thread finished\n", thr));
200 ThrSETSTATE(thr, THRf_DEAD);
201 MUTEX_UNLOCK(&thr->mutex);
202 remove_thread(aTHX_ thr);
203 DEBUG_S(PerlIO_printf(Perl_debug_log,
204 "%p: R_JOINED thread finished\n", thr));
206 case THRf_R_DETACHED:
207 ThrSETSTATE(thr, THRf_DEAD);
208 MUTEX_UNLOCK(&thr->mutex);
210 DEBUG_S(PerlIO_printf(Perl_debug_log,
211 "%p: DETACHED thread finished\n", thr));
212 remove_thread(aTHX_ thr); /* This might trigger main thread to finish */
215 MUTEX_UNLOCK(&thr->mutex);
216 croak("panic: illegal state %u at end of threadstart", ThrSTATE(thr));
219 return THREAD_RET_CAST(av); /* Available for anyone to join with */
220 /* us unless we're detached, in which */
221 /* case noone sees the value anyway. */
224 return THREAD_RET_CAST(NULL);
229 newthread (pTHX_ SV *startsv, AV *initargs, char *classname)
237 #ifndef THREAD_CREATE
238 static pthread_attr_t attr;
239 static int attr_inited = 0;
240 sigset_t fullmask, oldmask;
241 static int attr_joinable = PTHREAD_CREATE_JOINABLE;
245 thr = new_struct_thread(thr);
246 /* temporarily pretend to be the child thread in case the
247 * XPUSHs() below want to grow the child's stack. This is
248 * safe, since the other thread is not yet created, and we
249 * are the only ones who know about it */
252 DEBUG_S(PerlIO_printf(Perl_debug_log,
253 "%p: newthread (%p), tid is %u, preparing stack\n",
254 savethread, thr, thr->tid));
255 /* The following pushes the arg list and startsv onto the *new* stack */
257 /* Could easily speed up the following greatly */
258 for (i = 0; i <= AvFILL(initargs); i++)
259 XPUSHs(SvREFCNT_inc(*av_fetch(initargs, i, FALSE)));
260 XPUSHs(SvREFCNT_inc(startsv));
263 /* On your marks... */
264 PERL_SET_THX(savethread);
265 MUTEX_LOCK(&thr->mutex);
268 err = THREAD_CREATE(thr, threadstart);
271 sigfillset(&fullmask);
272 if (sigprocmask(SIG_SETMASK, &fullmask, &oldmask) == -1)
273 croak("panic: sigprocmask");
277 err = pthread_attr_init(&attr);
278 # ifdef THREAD_CREATE_NEEDS_STACK
280 err = pthread_attr_setstacksize(&attr, THREAD_CREATE_NEEDS_STACK);
282 croak("panic: pthread_attr_setstacksize failed");
284 # ifdef PTHREAD_ATTR_SETDETACHSTATE
286 err = PTHREAD_ATTR_SETDETACHSTATE(&attr, attr_joinable);
288 croak("panic: pthread_attr_setdetachstate failed");
290 croak("panic: can't pthread_attr_setdetachstate");
294 err = PTHREAD_CREATE(&thr->self, attr, threadstart, (void*) thr);
298 MUTEX_UNLOCK(&thr->mutex);
299 DEBUG_S(PerlIO_printf(Perl_debug_log,
300 "%p: create of %p failed %d\n",
301 savethread, thr, err));
302 /* Thread creation failed--clean up */
303 SvREFCNT_dec(thr->cvcache);
304 remove_thread(aTHX_ thr);
305 for (i = 0; i <= AvFILL(initargs); i++)
306 SvREFCNT_dec(*av_fetch(initargs, i, FALSE));
307 SvREFCNT_dec(startsv);
311 #ifdef THREAD_POST_CREATE
312 THREAD_POST_CREATE(thr);
314 if (sigprocmask(SIG_SETMASK, &oldmask, 0))
315 croak("panic: sigprocmask");
318 sv = newSViv(thr->tid);
319 sv_magic(sv, thr->oursv, '~', 0, 0);
320 SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
321 sv = sv_bless(newRV_noinc(sv), gv_stashpv(classname, TRUE));
324 MUTEX_UNLOCK(&thr->mutex);
329 croak("This perl was built for \"ithreads\", which currently does not support Thread.pm.\n"
330 "Run \"perldoc Thread\" for more information");
332 croak("This perl was not built with support for 5.005-style threads.\n"
333 "Run \"perldoc Thread\" for more information");
339 static Signal_t handle_thread_signal (int sig);
342 handle_thread_signal(int sig)
344 unsigned char c = (unsigned char) sig;
346 * We're not really allowed to call fprintf in a signal handler
347 * so don't be surprised if this isn't robust while debugging
350 DEBUG_S(PerlIO_printf(Perl_debug_log,
351 "handle_thread_signal: got signal %d\n", sig););
352 write(sig_pipe[1], &c, 1);
355 MODULE = Thread PACKAGE = Thread
359 new(classname, startsv, ...)
362 AV * av = av_make(items - 2, &ST(2));
364 XPUSHs(sv_2mortal(newthread(aTHX_ startsv, av, classname)));
374 croak("Attempt to join self");
375 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: joining %p (state %u)\n",
376 thr, t, ThrSTATE(t)););
377 MUTEX_LOCK(&t->mutex);
378 switch (ThrSTATE(t)) {
379 case THRf_R_JOINABLE:
381 ThrSETSTATE(t, THRf_R_JOINED);
382 MUTEX_UNLOCK(&t->mutex);
385 ThrSETSTATE(t, THRf_DEAD);
386 MUTEX_UNLOCK(&t->mutex);
387 remove_thread(aTHX_ t);
390 MUTEX_UNLOCK(&t->mutex);
391 croak("can't join with thread");
398 if (SvTRUE(*av_fetch(av, 0, FALSE))) {
399 /* Could easily speed up the following if necessary */
400 for (i = 1; i <= AvFILL(av); i++)
401 XPUSHs(*av_fetch(av, i, FALSE));
405 char *mess = SvPV(*av_fetch(av, 1, FALSE), n_a);
406 DEBUG_S(PerlIO_printf(Perl_debug_log,
407 "%p: join propagating die message: %s\n",
418 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: detaching %p (state %u)\n",
419 thr, t, ThrSTATE(t)););
420 MUTEX_LOCK(&t->mutex);
421 switch (ThrSTATE(t)) {
422 case THRf_R_JOINABLE:
423 ThrSETSTATE(t, THRf_R_DETACHED);
425 case THRf_R_DETACHED:
427 MUTEX_UNLOCK(&t->mutex);
430 ThrSETSTATE(t, THRf_DEAD);
432 MUTEX_UNLOCK(&t->mutex);
433 remove_thread(aTHX_ t);
436 MUTEX_UNLOCK(&t->mutex);
437 croak("can't detach thread");
447 PUSHs((t1 == t2) ? &PL_sv_yes : &PL_sv_no);
454 PUSHs(sv_2mortal(newSViv(t->flags)));
462 PUSHs(t->thr_done ? &PL_sv_yes : &PL_sv_no);
472 sv = newSViv(thr->tid);
473 sv_magic(sv, thr->oursv, '~', 0, 0);
474 SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
475 PUSHs(sv_2mortal(sv_bless(newRV_noinc(sv),
476 gv_stashpv(classname, TRUE))));
484 MUTEX_LOCK(&t->mutex);
486 MUTEX_UNLOCK(&t->mutex);
497 PUSHs(t ? &PL_sv_yes : &PL_sv_no);
517 mg = condpair_magic(sv);
518 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_wait %p\n", thr, sv));
519 MUTEX_LOCK(MgMUTEXP(mg));
520 if (MgOWNER(mg) != thr) {
521 MUTEX_UNLOCK(MgMUTEXP(mg));
522 croak("cond_wait for lock that we don't own\n");
525 COND_SIGNAL(MgOWNERCONDP(mg));
526 COND_WAIT(MgCONDP(mg), MgMUTEXP(mg));
528 COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
530 MUTEX_UNLOCK(MgMUTEXP(mg));
542 mg = condpair_magic(sv);
543 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_signal %p\n",thr,sv));
544 MUTEX_LOCK(MgMUTEXP(mg));
545 if (MgOWNER(mg) != thr) {
546 MUTEX_UNLOCK(MgMUTEXP(mg));
547 croak("cond_signal for lock that we don't own\n");
549 COND_SIGNAL(MgCONDP(mg));
550 MUTEX_UNLOCK(MgMUTEXP(mg));
562 mg = condpair_magic(sv);
563 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_broadcast %p\n",
565 MUTEX_LOCK(MgMUTEXP(mg));
566 if (MgOWNER(mg) != thr) {
567 MUTEX_UNLOCK(MgMUTEXP(mg));
568 croak("cond_broadcast for lock that we don't own\n");
570 COND_BROADCAST(MgCONDP(mg));
571 MUTEX_UNLOCK(MgMUTEXP(mg));
586 * Iterate until we have enough dynamic storage for all threads.
587 * We mustn't do any allocation while holding threads_mutex though.
589 MUTEX_LOCK(&PL_threads_mutex);
592 MUTEX_UNLOCK(&PL_threads_mutex);
593 if (AvFILL(av) < n - 1) {
595 for (i = AvFILL(av); i < n - 1; i++) {
596 SV *sv = newSViv(0); /* fill in tid later */
597 sv_magic(sv, 0, '~', 0, 0); /* fill in other magic later */
598 av_push(av, sv_bless(newRV_noinc(sv),
599 gv_stashpv(classname, TRUE)));
603 MUTEX_LOCK(&PL_threads_mutex);
604 } while (n < PL_nthreads);
605 n = PL_nthreads; /* Get the final correct value */
608 * At this point, there's enough room to fill in av.
609 * Note that we are holding threads_mutex so the list
610 * won't change out from under us but all the remaining
611 * processing is "fast" (no blocking, malloc etc.)
616 SV *sv = (SV*)SvRV(*svp);
617 sv_setiv(sv, t->tid);
618 SvMAGIC(sv)->mg_obj = SvREFCNT_inc(t->oursv);
619 SvMAGIC(sv)->mg_flags |= MGf_REFCOUNTED;
620 SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
625 MUTEX_UNLOCK(&PL_threads_mutex);
626 /* Truncate any unneeded slots in av */
628 /* Finally, push all the new objects onto the stack and drop av */
630 for (svp = AvARRAY(av); n > 0; n--, svp++)
632 (void)sv_2mortal((SV*)av);
636 MODULE = Thread PACKAGE = Thread::Signal
639 kill_sighandler_thread()
641 write(sig_pipe[1], "\0", 1);
645 init_thread_signals()
647 PL_sighandlerp = handle_thread_signal;
648 if (pipe(sig_pipe) == -1)
659 ret = read(sig_pipe[0], &c, 1);
660 } while (ret == -1 && errno == EINTR);
662 croak("panic: await_signal");
663 ST(0) = sv_newmortal();
665 sv_setsv(ST(0), c ? PL_psig_ptr[c] : &PL_sv_no);
666 DEBUG_S(PerlIO_printf(Perl_debug_log,
667 "await_signal returning %s\n", SvPEEK(ST(0))););
669 MODULE = Thread PACKAGE = Thread::Specific
672 data(classname = "Thread::Specific")
676 if (AvFILL(thr->specific) == -1) {
677 GV *gv = gv_fetchpv("Thread::Specific::FIELDS", TRUE, SVt_PVHV);
678 av_store(thr->specific, 0, newRV((SV*)GvHV(gv)));
680 XPUSHs(sv_bless(newRV((SV*)thr->specific),gv_stashpv(classname,TRUE)));