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_statname);
 178     SvREFCNT_dec(PL_errors);
 179     Safefree(PL_screamfirst);
 180     Safefree(PL_screamnext);
 181     Safefree(PL_reg_start_tmp);
 182     SvREFCNT_dec(PL_lastscream);
 183     SvREFCNT_dec(PL_defoutgv);
 184     Safefree(PL_reg_poscache);
 185
 186     MUTEX_LOCK(&thr->mutex);
 187     thr->thr_done = 1;
 188     DEBUG_S(PerlIO_printf(Perl_debug_log,
 189                           "%p: threadstart finishing: state is %u\n",
 190                           thr, ThrSTATE(thr)));
 191     switch (ThrSTATE(thr)) {
 192     case THRf_R_JOINABLE:
 193         ThrSETSTATE(thr, THRf_ZOMBIE);
 194         MUTEX_UNLOCK(&thr->mutex);
 195         DEBUG_S(PerlIO_printf(Perl_debug_log,
 196                               "%p: R_JOINABLE thread finished\n", thr));
 197         break;
 198     case THRf_R_JOINED:
 199         ThrSETSTATE(thr, THRf_DEAD);
 200         MUTEX_UNLOCK(&thr->mutex);
 201         remove_thread(aTHX_ thr);
 202         DEBUG_S(PerlIO_printf(Perl_debug_log,
 203                               "%p: R_JOINED thread finished\n", thr));
 204         break;
 205     case THRf_R_DETACHED:
 206         ThrSETSTATE(thr, THRf_DEAD);
 207         MUTEX_UNLOCK(&thr->mutex);
 208         SvREFCNT_dec(av);
 209         DEBUG_S(PerlIO_printf(Perl_debug_log,
 210                               "%p: DETACHED thread finished\n", thr));
 211         remove_thread(aTHX_ thr);       /* This might trigger main thread to finish */
 212         break;
 213     default:
 214         MUTEX_UNLOCK(&thr->mutex);
 215         croak("panic: illegal state %u at end of threadstart", ThrSTATE(thr));
 216         /* NOTREACHED */
 217     }
 218     return THREAD_RET_CAST(av); /* Available for anyone to join with */
 219                                         /* us unless we're detached, in which */
 220                                         /* case noone sees the value anyway. */
 221 #endif
 222 #else
 223     return THREAD_RET_CAST(NULL);
 224 #endif
 225 }
 226
 227 static SV *
 228 newthread (pTHX_ SV *startsv, AV *initargs, char *classname)
 229 {
 230 #ifdef USE_5005THREADS
 231     dSP;
 232     Thread savethread;
 233     int i;
 234     SV *sv;
 235     int err;
 236 #ifndef THREAD_CREATE
 237     static pthread_attr_t attr;
 238     static int attr_inited = 0;
 239     sigset_t fullmask, oldmask;
 240     static int attr_joinable = PTHREAD_CREATE_JOINABLE;
 241 #endif
 242
 243     savethread = thr;
 244     thr = new_struct_thread(thr);
 245     /* temporarily pretend to be the child thread in case the
 246      * XPUSHs() below want to grow the child's stack.  This is
 247      * safe, since the other thread is not yet created, and we
 248      * are the only ones who know about it */
 249     PERL_SET_THX(thr);
 250     SPAGAIN;
 251     DEBUG_S(PerlIO_printf(Perl_debug_log,
 252                           "%p: newthread (%p), tid is %u, preparing stack\n",
 253                           savethread, thr, thr->tid));
 254     /* The following pushes the arg list and startsv onto the *new* stack */
 255     PUSHMARK(SP);
 256     /* Could easily speed up the following greatly */
 257     for (i = 0; i <= AvFILL(initargs); i++)
 258         XPUSHs(SvREFCNT_inc(*av_fetch(initargs, i, FALSE)));
 259     XPUSHs(SvREFCNT_inc(startsv));
 260     PUTBACK;
 261
 262     /* On your marks... */
 263     PERL_SET_THX(savethread);
 264     MUTEX_LOCK(&thr->mutex);
 265
 266 #ifdef THREAD_CREATE
 267     err = THREAD_CREATE(thr, threadstart);
 268 #else
 269     /* Get set...  */
 270     sigfillset(&fullmask);
 271     if (sigprocmask(SIG_SETMASK, &fullmask, &oldmask) == -1)
 272         croak("panic: sigprocmask");
 273     err = 0;
 274     if (!attr_inited) {
 275         attr_inited = 1;
 276         err = pthread_attr_init(&attr);
 277 #  ifdef THREAD_CREATE_NEEDS_STACK
 278        if (err == 0)
 279             err = pthread_attr_setstacksize(&attr, THREAD_CREATE_NEEDS_STACK);
 280        if (err)
 281            croak("panic: pthread_attr_setstacksize failed");
 282 #  endif
 283 #  ifdef PTHREAD_ATTR_SETDETACHSTATE
 284         if (err == 0)
 285             err = PTHREAD_ATTR_SETDETACHSTATE(&attr, attr_joinable);
 286        if (err)
 287            croak("panic: pthread_attr_setdetachstate failed");
 288 #  else
 289         croak("panic: can't pthread_attr_setdetachstate");
 290 #  endif
 291     }
 292     if (err == 0)
 293         err = PTHREAD_CREATE(&thr->self, attr, threadstart, (void*) thr);
 294 #endif
 295
 296     if (err) {
 297         MUTEX_UNLOCK(&thr->mutex);
 298         DEBUG_S(PerlIO_printf(Perl_debug_log,
 299                               "%p: create of %p failed %d\n",
 300                               savethread, thr, err));
 301         /* Thread creation failed--clean up */
 302         SvREFCNT_dec(thr->cvcache);
 303         remove_thread(aTHX_ thr);
 304         for (i = 0; i <= AvFILL(initargs); i++)
 305             SvREFCNT_dec(*av_fetch(initargs, i, FALSE));
 306         SvREFCNT_dec(startsv);
 307         return NULL;
 308     }
 309
 310 #ifdef THREAD_POST_CREATE
 311     THREAD_POST_CREATE(thr);
 312 #else
 313     if (sigprocmask(SIG_SETMASK, &oldmask, 0))
 314         croak("panic: sigprocmask");
 315 #endif
 316
 317     sv = newSViv(thr->tid);
 318     sv_magic(sv, thr->oursv, '~', 0, 0);
 319     SvMAGIC(sv)->mg_private = Thread_MAGIC_SIGNATURE;
 320     sv = sv_bless(newRV_noinc(sv), gv_stashpv(classname, TRUE));
 321
 322     /* Go */
 323     MUTEX_UNLOCK(&thr->mutex);
 324
 325     return sv;
 326 #else
 327 #  ifdef USE_ITHREADS
 328     croak("This perl was built for \"ithreads\", which currently does not support Thread.pm.\n"
 329           "Run \"perldoc Thread\" for more information");
 330 #  else
 331     croak("This perl was not built with support for 5.005-style threads.\n"
 332           "Run \"perldoc Thread\" for more information");
 333 #  endif
 334     return &PL_sv_undef;
 335 #endif
 336 }
 337
 338 static Signal_t handle_thread_signal (int sig);
 339
 340 static Signal_t
 341 handle_thread_signal(int sig)
 342 {
 343     unsigned char c = (unsigned char) sig;
 344     dTHX;
 345     /*
 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
 348      * with -DL.
 349      */
 350     DEBUG_S(PerlIO_printf(Perl_debug_log,
 351             "handle_thread_signal: got signal %d\n", sig));
 352     write(sig_pipe[1], &c, 1);
 353 }
 354
 355 MODULE = Thread         PACKAGE = Thread
 356 PROTOTYPES: DISABLE
 357
 358 void
 359 new(classname, startsv, ...)
 360         char *          classname
 361         SV *            startsv
 362         AV *            av = av_make(items - 2, &ST(2));
 363     PPCODE:
 364         XPUSHs(sv_2mortal(newthread(aTHX_ startsv, av, classname)));
 365
 366 void
 367 join(t)
 368         Thread  t
 369         AV *    av = NO_INIT
 370         int     i = NO_INIT
 371     PPCODE:
 372 #ifdef USE_5005THREADS
 373         if (t == thr)
 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:
 380         case THRf_R_JOINED:
 381             ThrSETSTATE(t, THRf_R_JOINED);
 382             MUTEX_UNLOCK(&t->mutex);
 383             break;
 384         case THRf_ZOMBIE:
 385             ThrSETSTATE(t, THRf_DEAD);
 386             MUTEX_UNLOCK(&t->mutex);
 387             remove_thread(aTHX_ t);
 388             break;
 389         default:
 390             MUTEX_UNLOCK(&t->mutex);
 391             croak("can't join with thread");
 392             /* NOTREACHED */
 393         }
 394         JOIN(t, &av);
 395
 396         sv_2mortal((SV*)av);
 397
 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));
 402         }
 403         else {
 404             STRLEN n_a;
 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",
 408                                   thr, mess));
 409             croak(mess);
 410         }
 411 #endif
 412
 413 void
 414 detach(t)
 415         Thread  t
 416     CODE:
 417 #ifdef USE_5005THREADS
 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);
 424             /* fall through */
 425         case THRf_R_DETACHED:
 426             DETACH(t);
 427             MUTEX_UNLOCK(&t->mutex);
 428             break;
 429         case THRf_ZOMBIE:
 430             ThrSETSTATE(t, THRf_DEAD);
 431             DETACH(t);
 432             MUTEX_UNLOCK(&t->mutex);
 433             remove_thread(aTHX_ t);
 434             break;
 435         default:
 436             MUTEX_UNLOCK(&t->mutex);
 437             croak("can't detach thread");
 438             /* NOTREACHED */
 439         }
 440 #endif
 441
 442 void
 443 equal(t1, t2)
 444         Thread  t1
 445         Thread  t2
 446     PPCODE:
 447         PUSHs((t1 == t2) ? &PL_sv_yes : &PL_sv_no);
 448
 449 void
 450 flags(t)
 451         Thread  t
 452     PPCODE:
 453 #ifdef USE_5005THREADS
 454         PUSHs(sv_2mortal(newSViv(t->flags)));
 455 #endif
 456
 457 void
 458 done(t)
 459         Thread  t
 460     PPCODE:
 461 #ifdef USE_5005THREADS
 462         PUSHs(t->thr_done ? &PL_sv_yes : &PL_sv_no);
 463 #endif
 464
 465 void
 466 self(classname)
 467         char *  classname
 468     PREINIT:
 469         SV *sv;
 470     PPCODE:
 471 #ifdef USE_5005THREADS
 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))));
 477 #endif
 478
 479 U32
 480 tid(t)
 481         Thread  t
 482     CODE:
 483 #ifdef USE_5005THREADS
 484         MUTEX_LOCK(&t->mutex);
 485         RETVAL = t->tid;
 486         MUTEX_UNLOCK(&t->mutex);
 487 #else
 488         RETVAL = 0;
 489 #endif
 490     OUTPUT:
 491         RETVAL
 492
 493 void
 494 DESTROY(t)
 495         SV *    t
 496     PPCODE:
 497         PUSHs(t ? &PL_sv_yes : &PL_sv_no);
 498
 499 void
 500 yield()
 501     CODE:
 502 {
 503 #ifdef USE_5005THREADS
 504         YIELD;
 505 #endif
 506 }
 507
 508 void
 509 cond_wait(sv)
 510         SV *    sv
 511         MAGIC * mg = NO_INIT
 512 CODE:
 513 #ifdef USE_5005THREADS
 514         if (SvROK(sv))
 515             sv = SvRV(sv);
 516
 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");
 523         }
 524         MgOWNER(mg) = 0;
 525         COND_SIGNAL(MgOWNERCONDP(mg));
 526         COND_WAIT(MgCONDP(mg), MgMUTEXP(mg));
 527         while (MgOWNER(mg))
 528             COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
 529         MgOWNER(mg) = thr;
 530         MUTEX_UNLOCK(MgMUTEXP(mg));
 531 #endif
 532
 533 void
 534 cond_signal(sv)
 535         SV *    sv
 536         MAGIC * mg = NO_INIT
 537 CODE:
 538 #ifdef USE_5005THREADS
 539         if (SvROK(sv))
 540             sv = SvRV(sv);
 541
 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");
 548         }
 549         COND_SIGNAL(MgCONDP(mg));
 550         MUTEX_UNLOCK(MgMUTEXP(mg));
 551 #endif
 552
 553 void
 554 cond_broadcast(sv)
 555         SV *    sv
 556         MAGIC * mg = NO_INIT
 557 CODE:
 558 #ifdef USE_5005THREADS
 559         if (SvROK(sv))
 560             sv = SvRV(sv);
 561
 562         mg = condpair_magic(sv);
 563         DEBUG_S(PerlIO_printf(Perl_debug_log, "%p: cond_broadcast %p\n",
 564                               thr, sv));
 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");
 569         }
 570         COND_BROADCAST(MgCONDP(mg));
 571         MUTEX_UNLOCK(MgMUTEXP(mg));
 572 #endif
 573
 574 void
 575 list(classname)
 576         char *  classname
 577     PREINIT:
 578         Thread  t;
 579         AV *    av;
 580         SV **   svp;
 581         int     n = 0;
 582     PPCODE:
 583 #ifdef USE_5005THREADS
 584         av = newAV();
 585         /*
 586          * Iterate until we have enough dynamic storage for all threads.
 587          * We mustn't do any allocation while holding threads_mutex though.
 588          */
 589         MUTEX_LOCK(&PL_threads_mutex);
 590         do {
 591             n = PL_nthreads;
 592             MUTEX_UNLOCK(&PL_threads_mutex);
 593             if (AvFILL(av) < n - 1) {
 594                 int i = AvFILL(av);
 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)));
 600
 601                 }
 602             }
 603             MUTEX_LOCK(&PL_threads_mutex);
 604         } while (n < PL_nthreads);
 605         n = PL_nthreads;        /* Get the final correct value */
 606
 607         /*
 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.)
 612          */
 613         t = thr;
 614         svp = AvARRAY(av);
 615         do {
 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;
 621             t = t->next;
 622             svp++;
 623         } while (t != thr);
 624         /*  */
 625         MUTEX_UNLOCK(&PL_threads_mutex);
 626         /* Truncate any unneeded slots in av */
 627         av_fill(av, n - 1);
 628         /* Finally, push all the new objects onto the stack and drop av */
 629         EXTEND(SP, n);
 630         for (svp = AvARRAY(av); n > 0; n--, svp++)
 631             PUSHs(*svp);
 632         (void)sv_2mortal((SV*)av);
 633 #endif
 634
 635
 636 MODULE = Thread         PACKAGE = Thread::Signal
 637
 638 void
 639 kill_sighandler_thread()
 640     PPCODE:
 641         write(sig_pipe[1], "\0", 1);
 642         PUSHs(&PL_sv_yes);
 643
 644 void
 645 init_thread_signals()
 646     PPCODE:
 647         PL_sighandlerp = handle_thread_signal;
 648         if (pipe(sig_pipe) == -1)
 649             XSRETURN_UNDEF;
 650         PUSHs(&PL_sv_yes);
 651
 652 void
 653 await_signal()
 654     PREINIT:
 655         unsigned char c;
 656         SSize_t ret;
 657     CODE:
 658         do {
 659             ret = read(sig_pipe[0], &c, 1);
 660         } while (ret == -1 && errno == EINTR);
 661         if (ret == -1)
 662             croak("panic: await_signal");
 663         ST(0) = sv_newmortal();
 664         if (ret)
 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))));
 668
 669 MODULE = Thread         PACKAGE = Thread::Specific
 670
 671 void
 672 data(classname = "Thread::Specific")
 673         char *  classname
 674     PPCODE:
 675 #ifdef USE_5005THREADS
 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)));
 679         }
 680         XPUSHs(sv_bless(newRV((SV*)thr->specific),gv_stashpv(classname,TRUE)));
 681 #endif