ext/Thread/Thread.xs

   1 #define PERL_NO_GET_CONTEXT
   2 #include "EXTERN.h"
   3 #include "perl.h"
   4 #include "XSUB.h"
   5
   6 /* Magic signature for Thread's mg_private is "Th" */
   7 #define Thread_MAGIC_SIGNATURE 0x5468
   8
   9 #ifdef __cplusplus
  10 #ifdef I_UNISTD
  11 #include <unistd.h>
  12 #endif
  13 #endif
  14 #include <fcntl.h>
  15
  16 static int sig_pipe[2];
  17
  18 #ifndef THREAD_RET_TYPE
  19 #define THREAD_RET_TYPE void *
  20 #define THREAD_RET_CAST(x) ((THREAD_RET_TYPE) x)
  21 #endif
  22
  23 static void
  24 remove_thread(pTHX_ Thread t)
  25 {
  26 #ifdef USE_5005THREADS
  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);
  31     PL_nthreads--;
  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);
  37 #endif
  38 }
  39
  40 static THREAD_RET_TYPE
  41 threadstart(void *arg)
  42 {
  43 #ifdef USE_5005THREADS
  44 #ifdef FAKE_THREADS
  45     Thread savethread = thr;
  46     LOGOP myop;
  47     dSP;
  48     I32 oldscope = PL_scopestack_ix;
  49     I32 retval;
  50     AV *av;
  51     int i;
  52
  53     DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p starting at %s\n",
  54                           thr, SvPEEK(TOPs)));
  55     thr = (Thread) arg;
  56     savemark = TOPMARK;
  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;
  61     thr->wait_queue = 0;
  62     thr->private = 0;
  63
  64     /* Now duplicate most of perl_call_sv but with a few twists */
  65     PL_op = (OP*)&myop;
  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);
  72     DEBUG_S(if (!PL_op)
  73             PerlIO_printf(Perl_debug_log, "thread starts at Nullop\n"));
  74     /*
  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.
  79      */
  80     thr = savethread;           /* back to the old thread */
  81     return 0;
  82 #else
  83     Thread thr = (Thread) arg;
  84     dSP;
  85     I32 oldmark = TOPMARK;
  86     I32 retval;
  87     SV *sv;
  88     AV *av;
  89     int i;
  90
  91 #if defined(MULTIPLICITY)
  92     PERL_SET_INTERP(thr->interp);
  93 #endif
  94
  95     DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p waiting to start\n",
  96                           thr));
  97
  98     /*
  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.
 104      */
 105     MUTEX_LOCK(&thr->mutex);
 106     MUTEX_UNLOCK(&thr->mutex);
 107
 108     /*
 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.
 112      */
 113     PERL_SET_THX(thr);
 114
 115     DEBUG_S(PerlIO_printf(Perl_debug_log, "new thread %p starting at %s\n",
 116                           thr, SvPEEK(TOPs)));
 117
 118     av = newAV();
 119     sv = POPs;
 120     PUTBACK;
 121     ENTER;
 122     SAVETMPS;
 123     perl_call_sv(sv, G_ARRAY|G_EVAL);
 124     SPAGAIN;
 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)));
 135     }
 136     else {
 137         DEBUG_S(STMT_START {
 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]));
 141             }
 142         } STMT_END);
 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));
 146     }
 147     FREETMPS;
 148     LEAVE;
 149
 150 #if 0
 151     /* removed for debug */
 152     SvREFCNT_dec(PL_curstack);
 153 #endif
 154     SvREFCNT_dec(thr->cvcache);
 155     SvREFCNT_dec(thr->threadsv);
 156     SvREFCNT_dec(thr->specific);
 157     SvREFCNT_dec(thr->errsv);
 158
 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);
 167         PL_curstackinfo = p;
 168     }
 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);
 175
 176     SvREFCNT_dec(PL_rs);
 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);
 186
 187     MUTEX_LOCK(&thr->mutex);
 188     thr->thr_done = 1;
 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));
 198         break;
 199     case THRf_R_JOINED:
 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));
 205         break;
 206     case THRf_R_DETACHED:
 207         ThrSETSTATE(thr, THRf_DEAD);
 208         MUTEX_UNLOCK(&thr->mutex);
 209         SvREFCNT_dec(av);
 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 */
 213         break;
 214     default:
 215         MUTEX_UNLOCK(&thr->mutex);
 216         croak("panic: illegal state %u at end of threadstart", ThrSTATE(thr));
 217         /* NOTREACHED */
 218     }
 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. */
 222 #endif
 223 #else
 224     return THREAD_RET_CAST(NULL);
 225 #endif
 226 }
 227
 228 static SV *
 229 newthread (pTHX_ SV *startsv, AV *initargs, char *classname)
 230 {
 231 #ifdef USE_5005THREADS
 232     dSP;
 233     Thread savethread;
 234     int i;
 235     SV *sv;
 236     int err;
 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;
 242 #endif
 243
 244     savethread = thr;
 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 */
 250     PERL_SET_THX(thr);
 251     SPAGAIN;
 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 */
 256     PUSHMARK(SP);
 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));
 261     PUTBACK;
 262
 263     /* On your marks... */
 264     PERL_SET_THX(savethread);
 265     MUTEX_LOCK(&thr->mutex);
 266
 267 #ifdef THREAD_CREATE
 268     err = THREAD_CREATE(thr, threadstart);
 269 #else
 270     /* Get set...  */
 271     sigfillset(&fullmask);
 272     if (sigprocmask(SIG_SETMASK, &fullmask, &oldmask) == -1)
 273         croak("panic: sigprocmask");
 274     err = 0;
 275     if (!attr_inited) {
 276         attr_inited = 1;
 277         err = pthread_attr_init(&attr);
 278 #  ifdef THREAD_CREATE_NEEDS_STACK
 279        if (err == 0)
 280             err = pthread_attr_setstacksize(&attr, THREAD_CREATE_NEEDS_STACK);
 281        if (err)
 282            croak("panic: pthread_attr_setstacksize failed");
 283 #  endif
 284 #  ifdef PTHREAD_ATTR_SETDETACHSTATE
 285         if (err == 0)
 286             err = PTHREAD_ATTR_SETDETACHSTATE(&attr, attr_joinable);
 287        if (err)
 288            croak("panic: pthread_attr_setdetachstate failed");
 289 #  else
 290         croak("panic: can't pthread_attr_setdetachstate");
 291 #  endif
 292     }
 293     if (err == 0)
 294         err = PTHREAD_CREATE(&thr->self, attr, threadstart, (void*) thr);
 295 #endif
 296
 297     if (err) {
 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);
 308         return NULL;
 309     }
 310
 311 #ifdef THREAD_POST_CREATE
 312     THREAD_POST_CREATE(thr);
 313 #else
 314     if (sigprocmask(SIG_SETMASK, &oldmask, 0))
 315         croak("panic: sigprocmask");
 316 #endif
 317
 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));
 322
 323     /* Go */
 324     MUTEX_UNLOCK(&thr->mutex);
 325
 326     return sv;
 327 #else
 328 #  ifdef USE_ITHREADS
 329     croak("This perl was built for \"ithreads\", which currently does not support Thread.pm.\n"
 330           "Run \"perldoc Thread\" for more information");
 331 #  else
 332     croak("This perl was not built with support for 5.005-style threads.\n"
 333           "Run \"perldoc Thread\" for more information");
 334 #  endif
 335     return &PL_sv_undef;
 336 #endif
 337 }
 338
 339 static Signal_t handle_thread_signal (int sig);
 340
 341 static Signal_t
 342 handle_thread_signal(int sig)
 343 {
 344     unsigned char c = (unsigned char) sig;
 345     dTHX;
 346     /*
 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
 349      * with -DL.
 350      */
 351     DEBUG_S(PerlIO_printf(Perl_debug_log,
 352             "handle_thread_signal: got signal %d\n", sig));
 353     write(sig_pipe[1], &c, 1);
 354 }
 355
 356 MODULE = Thread         PACKAGE = Thread
 357 PROTOTYPES: DISABLE
 358
 359 void
 360 new(classname, startsv, ...)
 361         char *          classname
 362         SV *            startsv
 363         AV *            av = av_make(items - 2, &ST(2));
 364     PPCODE:
 365         XPUSHs(sv_2mortal(newthread(aTHX_ startsv, av, classname)));
 366
 367 void
 368 join(t)
 369         Thread  t
 370         AV *    av = NO_INIT
 371         int     i = NO_INIT
 372     PPCODE:
 373 #ifdef USE_5005THREADS
 374         if (t == thr)
 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:
 381         case THRf_R_JOINED:
 382             ThrSETSTATE(t, THRf_R_JOINED);
 383             MUTEX_UNLOCK(&t->mutex);
 384             break;
 385         case THRf_ZOMBIE:
 386             ThrSETSTATE(t, THRf_DEAD);
 387             MUTEX_UNLOCK(&t->mutex);
 388             remove_thread(aTHX_ t);
 389             break;
 390         default:
 391             MUTEX_UNLOCK(&t->mutex);
 392             croak("can't join with thread");
 393             /* NOTREACHED */
 394         }
 395         JOIN(t, &av);
 396
 397         sv_2mortal((SV*)av);
 398
 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));
 403         }
 404         else {
 405             STRLEN n_a;
 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",
 409                                   thr, mess));
 410             croak(mess);
 411         }
 412 #endif
 413
 414 void
 415 detach(t)
 416         Thread  t
 417     CODE:
 418 #ifdef USE_5005THREADS
 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);
 425             /* fall through */
 426         case THRf_R_DETACHED:
 427             DETACH(t);
 428             MUTEX_UNLOCK(&t->mutex);
 429             break;
 430         case THRf_ZOMBIE:
 431             ThrSETSTATE(t, THRf_DEAD);
 432             DETACH(t);
 433             MUTEX_UNLOCK(&t->mutex);
 434             remove_thread(aTHX_ t);
 435             break;
 436         default:
 437             MUTEX_UNLOCK(&t->mutex);
 438             croak("can't detach thread");
 439             /* NOTREACHED */
 440         }
 441 #endif
 442
 443 void
 444 equal(t1, t2)
 445         Thread  t1
 446         Thread  t2
 447     PPCODE:
 448         PUSHs((t1 == t2) ? &PL_sv_yes : &PL_sv_no);
 449
 450 void
 451 flags(t)
 452         Thread  t
 453     PPCODE:
 454 #ifdef USE_5005THREADS
 455         PUSHs(sv_2mortal(newSViv(t->flags)));
 456 #endif
 457
 458 void
 459 done(t)
 460         Thread  t
 461     PPCODE:
 462 #ifdef USE_5005THREADS
 463         PUSHs(t->thr_done ? &PL_sv_yes : &PL_sv_no);
 464 #endif
 465
 466 void
 467 self(classname)
 468         char *  classname
 469     PREINIT:
 470         SV *sv;
 471     PPCODE:
 472 #ifdef USE_5005THREADS
 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))));
 478 #endif
 479
 480 U32
 481 tid(t)
 482         Thread  t
 483     CODE:
 484 #ifdef USE_5005THREADS
 485         MUTEX_LOCK(&t->mutex);
 486         RETVAL = t->tid;
 487         MUTEX_UNLOCK(&t->mutex);
 488 #else
 489         RETVAL = 0;
 490 #endif
 491     OUTPUT:
 492         RETVAL
 493
 494 void
 495 DESTROY(t)
 496         SV *    t
 497     PPCODE:
 498         PUSHs(t ? &PL_sv_yes : &PL_sv_no);
 499
 500 void
 501 yield()
 502     CODE:
 503 {
 504 #ifdef USE_5005THREADS
 505         YIELD;
 506 #endif
 507 }
 508
 509 void
 510 cond_wait(sv)
 511         SV *    sv
 512         MAGIC * mg = NO_INIT
 513 CODE:
 514 #ifdef USE_5005THREADS
 515         if (SvROK(sv))
 516             sv = SvRV(sv);
 517
 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");
 524         }
 525         MgOWNER(mg) = 0;
 526         COND_SIGNAL(MgOWNERCONDP(mg));
 527         COND_WAIT(MgCONDP(mg), MgMUTEXP(mg));
 528         while (MgOWNER(mg))
 529             COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
 530         MgOWNER(mg) = thr;
 531         MUTEX_UNLOCK(MgMUTEXP(mg));
 532 #endif
 533
 534 void
 535 cond_signal(sv)
 536         SV *    sv
 537         MAGIC * mg = NO_INIT
 538 CODE:
 539 #ifdef USE_5005THREADS
 540         if (SvROK(sv))
 541             sv = SvRV(sv);
 542
 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");
 549         }
 550         COND_SIGNAL(MgCONDP(mg));
 551         MUTEX_UNLOCK(MgMUTEXP(mg));
 552 #endif
 553
 554 void
 555 cond_broadcast(sv)
 556         SV *    sv
 557         MAGIC * mg = NO_INIT
 558 CODE:
 559 #ifdef USE_5005THREADS
 560         if (SvROK(sv))
 561             sv = SvRV(sv);
 562
 563         mg = condpair_magic(sv);
 564         DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_broadcast %p\n",
 565                               thr, sv));
 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");
 570         }
 571         COND_BROADCAST(MgCONDP(mg));
 572         MUTEX_UNLOCK(MgMUTEXP(mg));
 573 #endif
 574
 575 void
 576 list(classname)
 577         char *  classname
 578     PREINIT:
 579         Thread  t;
 580         AV *    av;
 581         SV **   svp;
 582         int     n = 0;
 583     PPCODE:
 584 #ifdef USE_5005THREADS
 585         av = newAV();
 586         /*
 587          * Iterate until we have enough dynamic storage for all threads.
 588          * We mustn't do any allocation while holding threads_mutex though.
 589          */
 590         MUTEX_LOCK(&PL_threads_mutex);
 591         do {
 592             n = PL_nthreads;
 593             MUTEX_UNLOCK(&PL_threads_mutex);
 594             if (AvFILL(av) < n - 1) {
 595                 int i = AvFILL(av);
 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)));
 601
 602                 }
 603             }
 604             MUTEX_LOCK(&PL_threads_mutex);
 605         } while (n < PL_nthreads);
 606         n = PL_nthreads;        /* Get the final correct value */
 607
 608         /*
 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.)
 613          */
 614         t = thr;
 615         svp = AvARRAY(av);
 616         do {
 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;
 622             t = t->next;
 623             svp++;
 624         } while (t != thr);
 625         /*  */
 626         MUTEX_UNLOCK(&PL_threads_mutex);
 627         /* Truncate any unneeded slots in av */
 628         av_fill(av, n - 1);
 629         /* Finally, push all the new objects onto the stack and drop av */
 630         EXTEND(SP, n);
 631         for (svp = AvARRAY(av); n > 0; n--, svp++)
 632             PUSHs(*svp);
 633         (void)sv_2mortal((SV*)av);
 634 #endif
 635
 636
 637 MODULE = Thread         PACKAGE = Thread::Signal
 638
 639 void
 640 kill_sighandler_thread()
 641     PPCODE:
 642         write(sig_pipe[1], "\0", 1);
 643         PUSHs(&PL_sv_yes);
 644
 645 void
 646 init_thread_signals()
 647     PPCODE:
 648         PL_sighandlerp = handle_thread_signal;
 649         if (pipe(sig_pipe) == -1)
 650             XSRETURN_UNDEF;
 651         PUSHs(&PL_sv_yes);
 652
 653 void
 654 await_signal()
 655     PREINIT:
 656         unsigned char c;
 657         SSize_t ret;
 658     CODE:
 659         do {
 660             ret = read(sig_pipe[0], &c, 1);
 661         } while (ret == -1 && errno == EINTR);
 662         if (ret == -1)
 663             croak("panic: await_signal");
 664         ST(0) = sv_newmortal();
 665         if (ret)
 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))));
 669
 670 MODULE = Thread         PACKAGE = Thread::Specific
 671
 672 void
 673 data(classname = "Thread::Specific")
 674         char *  classname
 675     PPCODE:
 676 #ifdef USE_5005THREADS
 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)));
 680         }
 681         XPUSHs(sv_bless(newRV((SV*)thr->specific),gv_stashpv(classname,TRUE)));
 682 #endif