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;
347 * We're not really allowed to call fprintf in a signal handler
348 * so don't be surprised if this isn't robust while debugging
351 DEBUG_S(PerlIO_printf(Perl_debug_log,
352 "handle_thread_signal: got signal %d\n", sig));
353 write(sig_pipe[1], &c, 1);
356 MODULE = Thread PACKAGE = Thread
360 new(classname, startsv, ...)
363 AV * av = av_make(items - 2, &ST(2));
365 XPUSHs(sv_2mortal(newthread(aTHX_ startsv, av, classname)));
375 croak("Attempt to join self");
376 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: joining %p (state %u)\n",
377 thr, t, ThrSTATE(t)));
378 MUTEX_LOCK(&t->mutex);
379 switch (ThrSTATE(t)) {
380 case THRf_R_JOINABLE:
382 ThrSETSTATE(t, THRf_R_JOINED);
383 MUTEX_UNLOCK(&t->mutex);
386 ThrSETSTATE(t, THRf_DEAD);
387 MUTEX_UNLOCK(&t->mutex);
388 remove_thread(aTHX_ t);
391 MUTEX_UNLOCK(&t->mutex);
392 croak("can't join with thread");
399 if (SvTRUE(*av_fetch(av, 0, FALSE))) {
400 /* Could easily speed up the following if necessary */
401 for (i = 1; i <= AvFILL(av); i++)
402 XPUSHs(*av_fetch(av, i, FALSE));
406 char *mess = SvPV(*av_fetch(av, 1, FALSE), n_a);
407 DEBUG_S(PerlIO_printf(Perl_debug_log,
408 "%p: join propagating die message: %s\n",
419 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: detaching %p (state %u)\n",
420 thr, t, ThrSTATE(t)));
421 MUTEX_LOCK(&t->mutex);
422 switch (ThrSTATE(t)) {
423 case THRf_R_JOINABLE:
424 ThrSETSTATE(t, THRf_R_DETACHED);
426 case THRf_R_DETACHED:
428 MUTEX_UNLOCK(&t->mutex);
431 ThrSETSTATE(t, THRf_DEAD);
433 MUTEX_UNLOCK(&t->mutex);
434 remove_thread(aTHX_ t);
437 MUTEX_UNLOCK(&t->mutex);
438 croak("can't detach thread");
448 PUSHs((t1 == t2) ? &PL_sv_yes : &PL_sv_no);
455 PUSHs(sv_2mortal(newSViv(t->flags)));
463 PUSHs(t->thr_done ? &PL_sv_yes : &PL_sv_no);
473 sv = newSViv(thr->tid);
474 sv_magic(sv, thr->oursv, '~', 0, 0);
475 SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
476 PUSHs(sv_2mortal(sv_bless(newRV_noinc(sv),
477 gv_stashpv(classname, TRUE))));
485 MUTEX_LOCK(&t->mutex);
487 MUTEX_UNLOCK(&t->mutex);
498 PUSHs(t ? &PL_sv_yes : &PL_sv_no);
518 mg = condpair_magic(sv);
519 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_wait %p\n", thr, sv));
520 MUTEX_LOCK(MgMUTEXP(mg));
521 if (MgOWNER(mg) != thr) {
522 MUTEX_UNLOCK(MgMUTEXP(mg));
523 croak("cond_wait for lock that we don't own\n");
526 COND_SIGNAL(MgOWNERCONDP(mg));
527 COND_WAIT(MgCONDP(mg), MgMUTEXP(mg));
529 COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
531 MUTEX_UNLOCK(MgMUTEXP(mg));
543 mg = condpair_magic(sv);
544 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_signal %p\n",thr,sv));
545 MUTEX_LOCK(MgMUTEXP(mg));
546 if (MgOWNER(mg) != thr) {
547 MUTEX_UNLOCK(MgMUTEXP(mg));
548 croak("cond_signal for lock that we don't own\n");
550 COND_SIGNAL(MgCONDP(mg));
551 MUTEX_UNLOCK(MgMUTEXP(mg));
563 mg = condpair_magic(sv);
564 DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_broadcast %p\n",
566 MUTEX_LOCK(MgMUTEXP(mg));
567 if (MgOWNER(mg) != thr) {
568 MUTEX_UNLOCK(MgMUTEXP(mg));
569 croak("cond_broadcast for lock that we don't own\n");
571 COND_BROADCAST(MgCONDP(mg));
572 MUTEX_UNLOCK(MgMUTEXP(mg));
587 * Iterate until we have enough dynamic storage for all threads.
588 * We mustn't do any allocation while holding threads_mutex though.
590 MUTEX_LOCK(&PL_threads_mutex);
593 MUTEX_UNLOCK(&PL_threads_mutex);
594 if (AvFILL(av) < n - 1) {
596 for (i = AvFILL(av); i < n - 1; i++) {
597 SV *sv = newSViv(0); /* fill in tid later */
598 sv_magic(sv, 0, '~', 0, 0); /* fill in other magic later */
599 av_push(av, sv_bless(newRV_noinc(sv),
600 gv_stashpv(classname, TRUE)));
604 MUTEX_LOCK(&PL_threads_mutex);
605 } while (n < PL_nthreads);
606 n = PL_nthreads; /* Get the final correct value */
609 * At this point, there's enough room to fill in av.
610 * Note that we are holding threads_mutex so the list
611 * won't change out from under us but all the remaining
612 * processing is "fast" (no blocking, malloc etc.)
617 SV *sv = (SV*)SvRV(*svp);
618 sv_setiv(sv, t->tid);
619 SvMAGIC(sv)->mg_obj = SvREFCNT_inc(t->oursv);
620 SvMAGIC(sv)->mg_flags |= MGf_REFCOUNTED;
621 SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
626 MUTEX_UNLOCK(&PL_threads_mutex);
627 /* Truncate any unneeded slots in av */
629 /* Finally, push all the new objects onto the stack and drop av */
631 for (svp = AvARRAY(av); n > 0; n--, svp++)
633 (void)sv_2mortal((SV*)av);
637 MODULE = Thread PACKAGE = Thread::Signal
640 kill_sighandler_thread()
642 write(sig_pipe[1], "\0", 1);
646 init_thread_signals()
648 PL_sighandlerp = handle_thread_signal;
649 if (pipe(sig_pipe) == -1)
660 ret = read(sig_pipe[0], &c, 1);
661 } while (ret == -1 && errno == EINTR);
663 croak("panic: await_signal");
664 ST(0) = sv_newmortal();
666 sv_setsv(ST(0), c ? PL_psig_ptr[c] : &PL_sv_no);
667 DEBUG_S(PerlIO_printf(Perl_debug_log,
668 "await_signal returning %s\n", SvPEEK(ST(0))));
670 MODULE = Thread PACKAGE = Thread::Specific
673 data(classname = "Thread::Specific")
677 if (AvFILL(thr->specific) == -1) {
678 GV *gv = gv_fetchpv("Thread::Specific::FIELDS", TRUE, SVt_PVHV);
679 av_store(thr->specific, 0, newRV((SV*)GvHV(gv)));
681 XPUSHs(sv_bless(newRV((SV*)thr->specific),gv_stashpv(classname,TRUE)));