Upper.xs

   1 /* This file is part of the Scope::Upper Perl module.
   2  * See http://search.cpan.org/dist/Scope-Upper/ */
   3
   4 #define PERL_NO_GET_CONTEXT
   5 #include "EXTERN.h"
   6 #include "perl.h"
   7 #include "XSUB.h"
   8
   9 #define __PACKAGE__ "Scope::Upper"
  10
  11 #ifndef SU_DEBUG
  12 # define SU_DEBUG 0
  13 #endif
  14
  15 /* --- Compatibility ------------------------------------------------------- */
  16
  17 #ifndef NOOP
  18 # define NOOP
  19 #endif
  20
  21 #ifndef dNOOP
  22 # define dNOOP
  23 #endif
  24
  25 #ifndef dVAR
  26 # define dVAR dNOOP
  27 #endif
  28
  29 #ifndef MUTABLE_SV
  30 # define MUTABLE_SV(S) ((SV *) (S))
  31 #endif
  32
  33 #ifndef MUTABLE_AV
  34 # define MUTABLE_AV(A) ((AV *) (A))
  35 #endif
  36
  37 #ifndef MUTABLE_CV
  38 # define MUTABLE_CV(C) ((CV *) (C))
  39 #endif
  40
  41 #ifndef PERL_UNUSED_VAR
  42 # define PERL_UNUSED_VAR(V)
  43 #endif
  44
  45 #ifndef STMT_START
  46 # define STMT_START do
  47 #endif
  48
  49 #ifndef STMT_END
  50 # define STMT_END while (0)
  51 #endif
  52
  53 #if SU_DEBUG
  54 # define SU_D(X) STMT_START X STMT_END
  55 #else
  56 # define SU_D(X)
  57 #endif
  58
  59 #ifndef Newx
  60 # define Newx(v, n, c) New(0, v, n, c)
  61 #endif
  62
  63 #ifdef DEBUGGING
  64 # ifdef PoisonNew
  65 #  define SU_POISON(D, N, T) PoisonNew((D), (N), T)
  66 # elif defined(Poison)
  67 #  define SU_POISON(D, N, T) Poison((D), (N), T)
  68 # endif
  69 #endif
  70 #ifndef SU_POISON
  71 # define SU_POISON(D, N, T) NOOP
  72 #endif
  73
  74 #ifndef newSV_type
  75 STATIC SV *su_newSV_type(pTHX_ svtype t) {
  76  SV *sv = newSV(0);
  77  SvUPGRADE(sv, t);
  78  return sv;
  79 }
  80 # define newSV_type(T) su_newSV_type(aTHX_ (T))
  81 #endif
  82
  83 #ifndef SvPV_const
  84 # define SvPV_const(S, L) SvPV(S, L)
  85 #endif
  86
  87 #ifndef SvPVX_const
  88 # define SvPVX_const(S) SvPVX(S)
  89 #endif
  90
  91 #ifndef SvPV_nolen_const
  92 # define SvPV_nolen_const(S) SvPV_nolen(S)
  93 #endif
  94
  95 #ifndef SvREFCNT_inc_simple_void
  96 # define SvREFCNT_inc_simple_void(sv) ((void) SvREFCNT_inc(sv))
  97 #endif
  98
  99 #ifndef mPUSHi
 100 # define mPUSHi(I) PUSHs(sv_2mortal(newSViv(I)))
 101 #endif
 102
 103 #ifndef GvCV_set
 104 # define GvCV_set(G, C) (GvCV(G) = (C))
 105 #endif
 106
 107 #ifndef CvGV_set
 108 # define CvGV_set(C, G) (CvGV(C) = (G))
 109 #endif
 110
 111 #ifndef CvSTASH_set
 112 # define CvSTASH_set(C, S) (CvSTASH(C) = (S))
 113 #endif
 114
 115 #ifndef CvISXSUB
 116 # define CvISXSUB(C) CvXSUB(C)
 117 #endif
 118
 119 #ifndef CxHASARGS
 120 # define CxHASARGS(C) ((C)->blk_sub.hasargs)
 121 #endif
 122
 123 #ifndef HvNAME_get
 124 # define HvNAME_get(H) HvNAME(H)
 125 #endif
 126
 127 #ifndef gv_fetchpvn_flags
 128 # define gv_fetchpvn_flags(A, B, C, D) gv_fetchpv((A), (C), (D))
 129 #endif
 130
 131 #ifndef PERL_MAGIC_tied
 132 # define PERL_MAGIC_tied 'P'
 133 #endif
 134
 135 #ifndef PERL_MAGIC_env
 136 # define PERL_MAGIC_env 'E'
 137 #endif
 138
 139 #ifndef NEGATIVE_INDICES_VAR
 140 # define NEGATIVE_INDICES_VAR "NEGATIVE_INDICES"
 141 #endif
 142
 143 #define SU_HAS_PERL(R, V, S) (PERL_REVISION > (R) || (PERL_REVISION == (R) && (PERL_VERSION > (V) || (PERL_VERSION == (V) && (PERL_SUBVERSION >= (S))))))
 144 #define SU_HAS_PERL_EXACT(R, V, S) ((PERL_REVISION == (R)) && (PERL_VERSION == (V)) && (PERL_SUBVERSION == (S)))
 145
 146 /* --- Threads and multiplicity -------------------------------------------- */
 147
 148 #ifndef SU_MULTIPLICITY
 149 # if defined(MULTIPLICITY) || defined(PERL_IMPLICIT_CONTEXT)
 150 #  define SU_MULTIPLICITY 1
 151 # else
 152 #  define SU_MULTIPLICITY 0
 153 # endif
 154 #endif
 155 #if SU_MULTIPLICITY && !defined(tTHX)
 156 # define tTHX PerlInterpreter*
 157 #endif
 158
 159 #if SU_MULTIPLICITY && defined(USE_ITHREADS) && defined(dMY_CXT) && defined(MY_CXT) && defined(START_MY_CXT) && defined(MY_CXT_INIT) && (defined(MY_CXT_CLONE) || defined(dMY_CXT_SV))
 160 # define SU_THREADSAFE 1
 161 # ifndef MY_CXT_CLONE
 162 #  define MY_CXT_CLONE \
 163     dMY_CXT_SV;                                                      \
 164     my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1)); \
 165     Copy(INT2PTR(my_cxt_t*, SvUV(my_cxt_sv)), my_cxtp, 1, my_cxt_t); \
 166     sv_setuv(my_cxt_sv, PTR2UV(my_cxtp))
 167 # endif
 168 #else
 169 # define SU_THREADSAFE 0
 170 # undef  dMY_CXT
 171 # define dMY_CXT      dNOOP
 172 # undef  MY_CXT
 173 # define MY_CXT       su_globaldata
 174 # undef  START_MY_CXT
 175 # define START_MY_CXT STATIC my_cxt_t MY_CXT;
 176 # undef  MY_CXT_INIT
 177 # define MY_CXT_INIT  NOOP
 178 # undef  MY_CXT_CLONE
 179 # define MY_CXT_CLONE NOOP
 180 #endif
 181
 182 /* --- unwind() global storage --------------------------------------------- */
 183
 184 typedef struct {
 185  I32      cxix;
 186  I32      items;
 187  SV     **savesp;
 188  LISTOP   return_op;
 189  OP       proxy_op;
 190 } su_unwind_storage;
 191
 192 /* --- uplevel() data tokens and global storage ---------------------------- */
 193
 194 typedef struct {
 195  void *next;
 196
 197  I32  cxix;
 198  bool died;
 199
 200  CV  *target;
 201  I32  target_depth;
 202
 203  CV  *callback;
 204  CV  *renamed;
 205  AV  *args;
 206
 207  PERL_SI *si;
 208  PERL_SI *old_curstackinfo;
 209  AV      *old_mainstack;
 210
 211  COP *old_curcop;
 212
 213  bool old_catch;
 214  OP  *old_op;
 215
 216  OP  *goto_op;
 217  CV  *goto_code;
 218  U32  goto_perldb;
 219 } su_uplevel_ud;
 220
 221 STATIC su_uplevel_ud *su_uplevel_ud_new(pTHX) {
 222 #define su_uplevel_ud_new() su_uplevel_ud_new(aTHX)
 223  su_uplevel_ud *sud;
 224  PERL_SI       *si;
 225
 226  Newx(sud, 1, su_uplevel_ud);
 227  sud->next = NULL;
 228
 229  Newx(si, 1, PERL_SI);
 230  si->si_stack   = newAV();
 231  AvREAL_off(si->si_stack);
 232  si->si_cxstack = NULL;
 233  si->si_cxmax   = 0;
 234
 235  sud->si = si;
 236
 237  return sud;
 238 }
 239
 240 STATIC void su_uplevel_ud_delete(pTHX_ su_uplevel_ud *sud) {
 241 #define su_uplevel_ud_delete(S) su_uplevel_ud_delete(aTHX_ (S))
 242  PERL_SI *si = sud->si;
 243
 244  Safefree(si->si_cxstack);
 245  SvREFCNT_dec(si->si_stack);
 246  Safefree(si);
 247  Safefree(sud);
 248
 249  return;
 250 }
 251
 252 typedef struct {
 253  su_uplevel_ud *root;
 254  I32            count;
 255 } su_uplevel_storage;
 256
 257 #ifndef SU_UPLEVEL_STORAGE_SIZE
 258 # define SU_UPLEVEL_STORAGE_SIZE 4
 259 #endif
 260
 261 /* --- Global data --------------------------------------------------------- */
 262
 263 #define MY_CXT_KEY __PACKAGE__ "::_guts" XS_VERSION
 264
 265 typedef struct {
 266  char               *stack_placeholder;
 267  su_unwind_storage   unwind_storage;
 268  su_uplevel_storage  uplevel_storage;
 269 } my_cxt_t;
 270
 271 START_MY_CXT
 272
 273 /* --- Stack manipulations ------------------------------------------------- */
 274
 275 #define SU_SAVE_PLACEHOLDER() save_pptr(&MY_CXT.stack_placeholder)
 276
 277 #define SU_SAVE_DESTRUCTOR_SIZE  3
 278 #define SU_SAVE_PLACEHOLDER_SIZE 3
 279
 280 #define SU_SAVE_SCALAR_SIZE 3
 281
 282 #define SU_SAVE_ARY_SIZE      3
 283 #define SU_SAVE_AELEM_SIZE    4
 284 #ifdef SAVEADELETE
 285 # define SU_SAVE_ADELETE_SIZE 3
 286 #else
 287 # define SU_SAVE_ADELETE_SIZE SU_SAVE_DESTRUCTOR_SIZE
 288 #endif
 289 #if SU_SAVE_AELEM_SIZE < SU_SAVE_ADELETE_SIZE
 290 # define SU_SAVE_AELEM_OR_ADELETE_SIZE SU_SAVE_ADELETE_SIZE
 291 #else
 292 # define SU_SAVE_AELEM_OR_ADELETE_SIZE SU_SAVE_AELEM_SIZE
 293 #endif
 294
 295 #define SU_SAVE_HASH_SIZE    3
 296 #define SU_SAVE_HELEM_SIZE   4
 297 #define SU_SAVE_HDELETE_SIZE 4
 298 #if SU_SAVE_HELEM_SIZE < SU_SAVE_HDELETE_SIZE
 299 # define SU_SAVE_HELEM_OR_HDELETE_SIZE SU_SAVE_HDELETE_SIZE
 300 #else
 301 # define SU_SAVE_HELEM_OR_HDELETE_SIZE SU_SAVE_HELEM_SIZE
 302 #endif
 303
 304 #define SU_SAVE_GVCV_SIZE SU_SAVE_DESTRUCTOR_SIZE
 305
 306 #if !SU_HAS_PERL(5, 8, 9)
 307 # define SU_SAVE_GP_SIZE 6
 308 #elif !SU_HAS_PERL(5, 13, 0) || (SU_RELEASE && SU_HAS_PERL_EXACT(5, 13, 0))
 309 # define SU_SAVE_GP_SIZE 3
 310 #elif !SU_HAS_PERL(5, 13, 8)
 311 # define SU_SAVE_GP_SIZE 4
 312 #else
 313 # define SU_SAVE_GP_SIZE 3
 314 #endif
 315
 316 #ifndef SvCANEXISTDELETE
 317 # define SvCANEXISTDELETE(sv) \
 318   (!SvRMAGICAL(sv)            \
 319    || ((mg = mg_find((SV *) sv, PERL_MAGIC_tied))            \
 320        && (stash = SvSTASH(SvRV(SvTIED_obj((SV *) sv, mg)))) \
 321        && gv_fetchmethod_autoload(stash, "EXISTS", TRUE)     \
 322        && gv_fetchmethod_autoload(stash, "DELETE", TRUE)     \
 323       )                       \
 324    )
 325 #endif
 326
 327 /* ... Saving array elements ............................................... */
 328
 329 STATIC I32 su_av_key2idx(pTHX_ AV *av, I32 key) {
 330 #define su_av_key2idx(A, K) su_av_key2idx(aTHX_ (A), (K))
 331  I32 idx;
 332
 333  if (key >= 0)
 334   return key;
 335
 336 /* Added by MJD in perl-5.8.1 with 6f12eb6d2a1dfaf441504d869b27d2e40ef4966a */
 337 #if SU_HAS_PERL(5, 8, 1)
 338  if (SvRMAGICAL(av)) {
 339   const MAGIC * const tied_magic = mg_find((SV *) av, PERL_MAGIC_tied);
 340   if (tied_magic) {
 341    SV * const * const negative_indices_glob =
 342                     hv_fetch(SvSTASH(SvRV(SvTIED_obj((SV *) (av), tied_magic))),
 343                              NEGATIVE_INDICES_VAR, 16, 0);
 344    if (negative_indices_glob && SvTRUE(GvSV(*negative_indices_glob)))
 345     return key;
 346   }
 347  }
 348 #endif
 349
 350  idx = key + av_len(av) + 1;
 351  if (idx < 0)
 352   return key;
 353
 354  return idx;
 355 }
 356
 357 #ifndef SAVEADELETE
 358
 359 typedef struct {
 360  AV *av;
 361  I32 idx;
 362 } su_ud_adelete;
 363
 364 STATIC void su_adelete(pTHX_ void *ud_) {
 365  su_ud_adelete *ud = (su_ud_adelete *) ud_;
 366
 367  av_delete(ud->av, ud->idx, G_DISCARD);
 368  SvREFCNT_dec(ud->av);
 369
 370  Safefree(ud);
 371 }
 372
 373 STATIC void su_save_adelete(pTHX_ AV *av, I32 idx) {
 374 #define su_save_adelete(A, K) su_save_adelete(aTHX_ (A), (K))
 375  su_ud_adelete *ud;
 376
 377  Newx(ud, 1, su_ud_adelete);
 378  ud->av  = av;
 379  ud->idx = idx;
 380  SvREFCNT_inc_simple_void(av);
 381
 382  SAVEDESTRUCTOR_X(su_adelete, ud);
 383 }
 384
 385 #define SAVEADELETE(A, K) su_save_adelete((A), (K))
 386
 387 #endif /* SAVEADELETE */
 388
 389 STATIC void su_save_aelem(pTHX_ AV *av, SV *key, SV *val) {
 390 #define su_save_aelem(A, K, V) su_save_aelem(aTHX_ (A), (K), (V))
 391  I32 idx;
 392  I32 preeminent = 1;
 393  SV **svp;
 394  HV *stash;
 395  MAGIC *mg;
 396
 397  idx = su_av_key2idx(av, SvIV(key));
 398
 399  if (SvCANEXISTDELETE(av))
 400   preeminent = av_exists(av, idx);
 401
 402  svp = av_fetch(av, idx, 1);
 403  if (!svp || *svp == &PL_sv_undef) croak(PL_no_aelem, idx);
 404
 405  if (preeminent)
 406   save_aelem(av, idx, svp);
 407  else
 408   SAVEADELETE(av, idx);
 409
 410  if (val) { /* local $x[$idx] = $val; */
 411   SvSetMagicSV(*svp, val);
 412  } else {   /* local $x[$idx]; delete $x[$idx]; */
 413   av_delete(av, idx, G_DISCARD);
 414  }
 415 }
 416
 417 /* ... Saving hash elements ................................................ */
 418
 419 STATIC void su_save_helem(pTHX_ HV *hv, SV *keysv, SV *val) {
 420 #define su_save_helem(H, K, V) su_save_helem(aTHX_ (H), (K), (V))
 421  I32 preeminent = 1;
 422  HE *he;
 423  SV **svp;
 424  HV *stash;
 425  MAGIC *mg;
 426
 427  if (SvCANEXISTDELETE(hv) || mg_find((SV *) hv, PERL_MAGIC_env))
 428   preeminent = hv_exists_ent(hv, keysv, 0);
 429
 430  he  = hv_fetch_ent(hv, keysv, 1, 0);
 431  svp = he ? &HeVAL(he) : NULL;
 432  if (!svp || *svp == &PL_sv_undef) croak("Modification of non-creatable hash value attempted, subscript \"%s\"", SvPV_nolen_const(*svp));
 433
 434  if (HvNAME_get(hv) && isGV(*svp)) {
 435   save_gp((GV *) *svp, 0);
 436   return;
 437  }
 438
 439  if (preeminent)
 440   save_helem(hv, keysv, svp);
 441  else {
 442   STRLEN keylen;
 443   const char * const key = SvPV_const(keysv, keylen);
 444   SAVEDELETE(hv, savepvn(key, keylen),
 445                  SvUTF8(keysv) ? -(I32)keylen : (I32)keylen);
 446  }
 447
 448  if (val) { /* local $x{$keysv} = $val; */
 449   SvSetMagicSV(*svp, val);
 450  } else {   /* local $x{$keysv}; delete $x{$keysv}; */
 451   (void)hv_delete_ent(hv, keysv, G_DISCARD, HeHASH(he));
 452  }
 453 }
 454
 455 /* ... Saving code slots from a glob ....................................... */
 456
 457 #if !SU_HAS_PERL(5, 10, 0) && !defined(mro_method_changed_in)
 458 # define mro_method_changed_in(G) PL_sub_generation++
 459 #endif
 460
 461 typedef struct {
 462  GV *gv;
 463  CV *old_cv;
 464 } su_save_gvcv_ud;
 465
 466 STATIC void su_restore_gvcv(pTHX_ void *ud_) {
 467  su_save_gvcv_ud *ud = ud_;
 468  GV              *gv = ud->gv;
 469
 470  GvCV_set(gv, ud->old_cv);
 471  GvCVGEN(gv) = 0;
 472  mro_method_changed_in(GvSTASH(gv));
 473
 474  Safefree(ud);
 475 }
 476
 477 STATIC void su_save_gvcv(pTHX_ GV *gv) {
 478 #define su_save_gvcv(G) su_save_gvcv(aTHX_ (G))
 479  su_save_gvcv_ud *ud;
 480
 481  Newx(ud, 1, su_save_gvcv_ud);
 482  ud->gv     = gv;
 483  ud->old_cv = GvCV(gv);
 484
 485  GvCV_set(gv, NULL);
 486  GvCVGEN(gv) = 0;
 487  mro_method_changed_in(GvSTASH(gv));
 488
 489  SAVEDESTRUCTOR_X(su_restore_gvcv, ud);
 490 }
 491
 492 /* --- Actions ------------------------------------------------------------- */
 493
 494 typedef struct {
 495  I32 depth;
 496  I32 pad;
 497  I32 *origin;
 498  void (*handler)(pTHX_ void *);
 499 } su_ud_common;
 500
 501 #define SU_UD_DEPTH(U)   (((su_ud_common *) (U))->depth)
 502 #define SU_UD_PAD(U)     (((su_ud_common *) (U))->pad)
 503 #define SU_UD_ORIGIN(U)  (((su_ud_common *) (U))->origin)
 504 #define SU_UD_HANDLER(U) (((su_ud_common *) (U))->handler)
 505
 506 #define SU_UD_FREE(U) STMT_START { \
 507  if (SU_UD_ORIGIN(U)) Safefree(SU_UD_ORIGIN(U)); \
 508  Safefree(U); \
 509 } STMT_END
 510
 511 /* ... Reap ................................................................ */
 512
 513 typedef struct {
 514  su_ud_common ci;
 515  SV *cb;
 516 } su_ud_reap;
 517
 518 STATIC void su_call(pTHX_ void *ud_) {
 519  su_ud_reap *ud = (su_ud_reap *) ud_;
 520 #if SU_HAS_PERL(5, 9, 5)
 521  PERL_CONTEXT saved_cx;
 522  I32 cxix;
 523 #endif
 524
 525  dSP;
 526
 527  SU_D({
 528   PerlIO_printf(Perl_debug_log,
 529                 "%p: @@@ call\n%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
 530                  ud, ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
 531  });
 532
 533  ENTER;
 534  SAVETMPS;
 535
 536  PUSHMARK(SP);
 537  PUTBACK;
 538
 539  /* If the recently popped context isn't saved there, it will be overwritten by
 540   * the sub scope from call_sv, although it's still needed in our caller. */
 541
 542 #if SU_HAS_PERL(5, 9, 5)
 543  if (cxstack_ix < cxstack_max)
 544   cxix = cxstack_ix + 1;
 545  else
 546   cxix = Perl_cxinc(aTHX);
 547  saved_cx = cxstack[cxix];
 548 #endif
 549
 550  call_sv(ud->cb, G_VOID);
 551
 552 #if SU_HAS_PERL(5, 9, 5)
 553  cxstack[cxix] = saved_cx;
 554 #endif
 555
 556  PUTBACK;
 557
 558  FREETMPS;
 559  LEAVE;
 560
 561  SvREFCNT_dec(ud->cb);
 562  SU_UD_FREE(ud);
 563 }
 564
 565 STATIC void su_reap(pTHX_ void *ud) {
 566 #define su_reap(U) su_reap(aTHX_ (U))
 567  SU_D({
 568   PerlIO_printf(Perl_debug_log,
 569                 "%p: === reap\n%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
 570                  ud, ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
 571  });
 572
 573  SAVEDESTRUCTOR_X(su_call, ud);
 574 }
 575
 576 /* ... Localize & localize array/hash element .............................. */
 577
 578 typedef struct {
 579  su_ud_common ci;
 580  SV    *sv;
 581  SV    *val;
 582  SV    *elem;
 583  svtype type;
 584 } su_ud_localize;
 585
 586 #define SU_UD_LOCALIZE_FREE(U) STMT_START { \
 587  SvREFCNT_dec((U)->elem); \
 588  SvREFCNT_dec((U)->val);  \
 589  SvREFCNT_dec((U)->sv);   \
 590  SU_UD_FREE(U);           \
 591 } STMT_END
 592
 593 STATIC I32 su_ud_localize_init(pTHX_ su_ud_localize *ud, SV *sv, SV *val, SV *elem) {
 594 #define su_ud_localize_init(UD, S, V, E) su_ud_localize_init(aTHX_ (UD), (S), (V), (E))
 595  UV deref = 0;
 596  svtype t = SVt_NULL;
 597  I32 size;
 598
 599  SvREFCNT_inc_simple_void(sv);
 600
 601  if (SvTYPE(sv) >= SVt_PVGV) {
 602   if (!val || !SvROK(val)) { /* local *x; or local *x = $val; */
 603    t = SVt_PVGV;
 604   } else {                   /* local *x = \$val; */
 605    t = SvTYPE(SvRV(val));
 606    deref = 1;
 607   }
 608  } else if (SvROK(sv)) {
 609   croak("Invalid %s reference as the localization target",
 610                  sv_reftype(SvRV(sv), 0));
 611  } else {
 612   STRLEN len, l;
 613   const char *p = SvPV_const(sv, len), *s;
 614   for (s = p, l = len; l > 0 && isSPACE(*s); ++s, --l) { }
 615   if (!l) {
 616    l = len;
 617    s = p;
 618   }
 619   switch (*s) {
 620    case '$': t = SVt_PV;   break;
 621    case '@': t = SVt_PVAV; break;
 622    case '%': t = SVt_PVHV; break;
 623    case '&': t = SVt_PVCV; break;
 624    case '*': t = SVt_PVGV; break;
 625   }
 626   if (t != SVt_NULL) {
 627    ++s;
 628    --l;
 629   } else if (val) { /* t == SVt_NULL, type can't be inferred from the sigil */
 630    if (SvROK(val) && !sv_isobject(val)) {
 631     t = SvTYPE(SvRV(val));
 632     deref = 1;
 633    } else {
 634     t = SvTYPE(val);
 635    }
 636   }
 637   SvREFCNT_dec(sv);
 638   sv = newSVpvn(s, l);
 639  }
 640
 641  switch (t) {
 642   case SVt_PVAV:
 643    size  = elem ? SU_SAVE_AELEM_OR_ADELETE_SIZE
 644                 : SU_SAVE_ARY_SIZE;
 645    deref = 0;
 646    break;
 647   case SVt_PVHV:
 648    size  = elem ? SU_SAVE_HELEM_OR_HDELETE_SIZE
 649                 : SU_SAVE_HASH_SIZE;
 650    deref = 0;
 651    break;
 652   case SVt_PVGV:
 653    size  = SU_SAVE_GP_SIZE;
 654    deref = 0;
 655    break;
 656   case SVt_PVCV:
 657    size  = SU_SAVE_GVCV_SIZE;
 658    deref = 0;
 659    break;
 660   default:
 661    size = SU_SAVE_SCALAR_SIZE;
 662    break;
 663  }
 664  /* When deref is set, val isn't NULL */
 665
 666  ud->sv   = sv;
 667  ud->val  = val ? newSVsv(deref ? SvRV(val) : val) : NULL;
 668  ud->elem = SvREFCNT_inc(elem);
 669  ud->type = t;
 670
 671  return size;
 672 }
 673
 674 STATIC void su_localize(pTHX_ void *ud_) {
 675 #define su_localize(U) su_localize(aTHX_ (U))
 676  su_ud_localize *ud = (su_ud_localize *) ud_;
 677  SV *sv   = ud->sv;
 678  SV *val  = ud->val;
 679  SV *elem = ud->elem;
 680  svtype t = ud->type;
 681  GV *gv;
 682
 683  if (SvTYPE(sv) >= SVt_PVGV) {
 684   gv = (GV *) sv;
 685  } else {
 686 #ifdef gv_fetchsv
 687   gv = gv_fetchsv(sv, GV_ADDMULTI, t);
 688 #else
 689   STRLEN len;
 690   const char *name = SvPV_const(sv, len);
 691   gv = gv_fetchpvn_flags(name, len, GV_ADDMULTI, t);
 692 #endif
 693  }
 694
 695  SU_D({
 696   SV *z = newSV(0);
 697   SvUPGRADE(z, t);
 698   PerlIO_printf(Perl_debug_log, "%p: === localize a %s\n",ud, sv_reftype(z, 0));
 699   PerlIO_printf(Perl_debug_log,
 700                 "%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
 701                  ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
 702   SvREFCNT_dec(z);
 703  });
 704
 705  /* Inspired from Alias.pm */
 706  switch (t) {
 707   case SVt_PVAV:
 708    if (elem) {
 709     su_save_aelem(GvAV(gv), elem, val);
 710     goto done;
 711    } else
 712     save_ary(gv);
 713    break;
 714   case SVt_PVHV:
 715    if (elem) {
 716     su_save_helem(GvHV(gv), elem, val);
 717     goto done;
 718    } else
 719     save_hash(gv);
 720    break;
 721   case SVt_PVGV:
 722    save_gp(gv, 1); /* hide previous entry in symtab */
 723    break;
 724   case SVt_PVCV:
 725    su_save_gvcv(gv);
 726    break;
 727   default:
 728    gv = (GV *) save_scalar(gv);
 729    break;
 730  }
 731
 732  if (val)
 733   SvSetMagicSV((SV *) gv, val);
 734
 735 done:
 736  SU_UD_LOCALIZE_FREE(ud);
 737 }
 738
 739 /* --- Pop a context back -------------------------------------------------- */
 740
 741 #if SU_DEBUG
 742 # ifdef DEBUGGING
 743 #  define SU_CXNAME PL_block_type[CxTYPE(&cxstack[cxstack_ix])]
 744 # else
 745 #  define SU_CXNAME "XXX"
 746 # endif
 747 #endif
 748
 749 STATIC void su_pop(pTHX_ void *ud) {
 750 #define su_pop(U) su_pop(aTHX_ (U))
 751  I32 depth, base, mark, *origin;
 752  depth = SU_UD_DEPTH(ud);
 753
 754  SU_D(
 755   PerlIO_printf(Perl_debug_log,
 756    "%p: --- pop a %s\n"
 757    "%p: leave scope     at depth=%2d scope_ix=%2d cur_top=%2d cur_base=%2d\n",
 758     ud, SU_CXNAME,
 759     ud, depth, PL_scopestack_ix,PL_savestack_ix,PL_scopestack[PL_scopestack_ix])
 760  );
 761
 762  origin = SU_UD_ORIGIN(ud);
 763  mark   = origin[depth];
 764  base   = origin[depth - 1];
 765
 766  SU_D(PerlIO_printf(Perl_debug_log,
 767                     "%p: original scope was %*c top=%2d     base=%2d\n",
 768                      ud,                24, ' ',    mark,        base));
 769
 770  if (base < mark) {
 771   SU_D(PerlIO_printf(Perl_debug_log, "%p: clear leftovers\n", ud));
 772   PL_savestack_ix = mark;
 773   leave_scope(base);
 774  }
 775  PL_savestack_ix = base;
 776
 777  SU_UD_DEPTH(ud) = --depth;
 778
 779  if (depth > 0) {
 780   I32 pad;
 781
 782   if ((pad = SU_UD_PAD(ud))) {
 783    dMY_CXT;
 784    do {
 785     SU_D(PerlIO_printf(Perl_debug_log,
 786           "%p: push a pad slot at depth=%2d scope_ix=%2d save_ix=%2d\n",
 787            ud,                       depth, PL_scopestack_ix, PL_savestack_ix));
 788     SU_SAVE_PLACEHOLDER();
 789    } while (--pad);
 790   }
 791
 792   SU_D(PerlIO_printf(Perl_debug_log,
 793           "%p: push destructor at depth=%2d scope_ix=%2d save_ix=%2d\n",
 794            ud,                       depth, PL_scopestack_ix, PL_savestack_ix));
 795   SAVEDESTRUCTOR_X(su_pop, ud);
 796  } else {
 797   SU_UD_HANDLER(ud)(aTHX_ ud);
 798  }
 799
 800  SU_D(PerlIO_printf(Perl_debug_log,
 801                     "%p: --- end pop: cur_top=%2d == cur_base=%2d\n",
 802                      ud, PL_savestack_ix, PL_scopestack[PL_scopestack_ix]));
 803 }
 804
 805 /* --- Initialize the stack and the action userdata ------------------------ */
 806
 807 STATIC I32 su_init(pTHX_ void *ud, I32 cxix, I32 size) {
 808 #define su_init(U, C, S) su_init(aTHX_ (U), (C), (S))
 809  I32 i, depth = 1, pad, offset, *origin;
 810
 811  SU_D(PerlIO_printf(Perl_debug_log, "%p: ### init for cx %d\n", ud, cxix));
 812
 813  if (size <= SU_SAVE_DESTRUCTOR_SIZE)
 814   pad = 0;
 815  else {
 816   I32 extra = size - SU_SAVE_DESTRUCTOR_SIZE;
 817   pad = extra / SU_SAVE_PLACEHOLDER_SIZE;
 818   if (extra % SU_SAVE_PLACEHOLDER_SIZE)
 819    ++pad;
 820  }
 821  offset = SU_SAVE_DESTRUCTOR_SIZE + SU_SAVE_PLACEHOLDER_SIZE * pad;
 822
 823  SU_D(PerlIO_printf(Perl_debug_log, "%p: size=%d pad=%d offset=%d\n",
 824                                      ud,    size,   pad,   offset));
 825
 826  for (i = cxstack_ix; i > cxix; --i) {
 827   PERL_CONTEXT *cx = cxstack + i;
 828   switch (CxTYPE(cx)) {
 829 #if SU_HAS_PERL(5, 10, 0)
 830    case CXt_BLOCK:
 831     SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is block\n", ud, i));
 832     /* Given and when blocks are actually followed by a simple block, so skip
 833      * it if needed. */
 834     if (cxix > 0) { /* Implies i > 0 */
 835      PERL_CONTEXT *next = cx - 1;
 836      if (CxTYPE(next) == CXt_GIVEN || CxTYPE(next) == CXt_WHEN)
 837       --cxix;
 838     }
 839     depth++;
 840     break;
 841 #endif
 842 #if SU_HAS_PERL(5, 11, 0)
 843    case CXt_LOOP_FOR:
 844    case CXt_LOOP_PLAIN:
 845    case CXt_LOOP_LAZYSV:
 846    case CXt_LOOP_LAZYIV:
 847 #else
 848    case CXt_LOOP:
 849 #endif
 850     SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is loop\n", ud, i));
 851     depth += 2;
 852     break;
 853    default:
 854     SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is other\n", ud, i));
 855     depth++;
 856     break;
 857   }
 858  }
 859  SU_D(PerlIO_printf(Perl_debug_log, "%p: going down to depth %d\n", ud, depth));
 860
 861  Newx(origin, depth + 1, I32);
 862  origin[0] = PL_scopestack[PL_scopestack_ix - depth];
 863  PL_scopestack[PL_scopestack_ix - depth] += size;
 864  for (i = depth - 1; i >= 1; --i) {
 865   I32 j = PL_scopestack_ix - i;
 866   origin[depth - i] = PL_scopestack[j];
 867   PL_scopestack[j] += offset;
 868  }
 869  origin[depth] = PL_savestack_ix;
 870
 871  SU_UD_ORIGIN(ud) = origin;
 872  SU_UD_DEPTH(ud)  = depth;
 873  SU_UD_PAD(ud)    = pad;
 874
 875  /* Make sure the first destructor fires by pushing enough fake slots on the
 876   * stack. */
 877  if (PL_savestack_ix + SU_SAVE_DESTRUCTOR_SIZE
 878                                        <= PL_scopestack[PL_scopestack_ix - 1]) {
 879   dMY_CXT;
 880   do {
 881    SU_D(PerlIO_printf(Perl_debug_log,
 882                   "%p: push a fake slot      at scope_ix=%2d  save_ix=%2d\n",
 883                    ud,                      PL_scopestack_ix, PL_savestack_ix));
 884    SU_SAVE_PLACEHOLDER();
 885   } while (PL_savestack_ix + SU_SAVE_DESTRUCTOR_SIZE
 886                                         <= PL_scopestack[PL_scopestack_ix - 1]);
 887  }
 888  SU_D(PerlIO_printf(Perl_debug_log,
 889                   "%p: push first destructor at scope_ix=%2d  save_ix=%2d\n",
 890                    ud,                      PL_scopestack_ix, PL_savestack_ix));
 891  SAVEDESTRUCTOR_X(su_pop, ud);
 892
 893  SU_D({
 894   for (i = 0; i <= depth; ++i) {
 895    I32 j = PL_scopestack_ix  - i;
 896    PerlIO_printf(Perl_debug_log,
 897                  "%p: depth=%2d scope_ix=%2d saved_floor=%2d new_floor=%2d\n",
 898                   ud,        i, j, origin[depth - i],
 899                                    i == 0 ? PL_savestack_ix : PL_scopestack[j]);
 900   }
 901  });
 902
 903  return depth;
 904 }
 905
 906 /* --- Unwind stack -------------------------------------------------------- */
 907
 908 STATIC void su_unwind(pTHX_ void *ud_) {
 909  dMY_CXT;
 910  I32 cxix    = MY_CXT.unwind_storage.cxix;
 911  I32 items   = MY_CXT.unwind_storage.items - 1;
 912  SV **savesp = MY_CXT.unwind_storage.savesp;
 913  I32 mark;
 914
 915  PERL_UNUSED_VAR(ud_);
 916
 917  if (savesp)
 918   PL_stack_sp = savesp;
 919
 920  if (cxstack_ix > cxix)
 921   dounwind(cxix);
 922
 923  /* Hide the level */
 924  if (items >= 0)
 925   PL_stack_sp--;
 926
 927  mark = PL_markstack[cxstack[cxix].blk_oldmarksp];
 928  *PL_markstack_ptr = PL_stack_sp - PL_stack_base - items;
 929
 930  SU_D({
 931   I32 gimme = GIMME_V;
 932   PerlIO_printf(Perl_debug_log,
 933                 "%p: cx=%d gimme=%s items=%d sp=%d oldmark=%d mark=%d\n",
 934                 &MY_CXT, cxix,
 935                 gimme == G_VOID ? "void" : gimme == G_ARRAY ? "list" : "scalar",
 936                 items, PL_stack_sp - PL_stack_base, *PL_markstack_ptr, mark);
 937  });
 938
 939  PL_op = (OP *) &(MY_CXT.unwind_storage.return_op);
 940  PL_op = PL_op->op_ppaddr(aTHX);
 941
 942  *PL_markstack_ptr = mark;
 943
 944  MY_CXT.unwind_storage.proxy_op.op_next = PL_op;
 945  PL_op = &(MY_CXT.unwind_storage.proxy_op);
 946 }
 947
 948 /* --- Uplevel ------------------------------------------------------------- */
 949
 950 #ifndef OP_GIMME_REVERSE
 951 STATIC U8 su_op_gimme_reverse(U8 gimme) {
 952  switch (gimme) {
 953   case G_VOID:
 954    return OPf_WANT_VOID;
 955   case G_ARRAY:
 956    return OPf_WANT_LIST;
 957   default:
 958    break;
 959  }
 960
 961  return OPf_WANT_SCALAR;
 962 }
 963 #define OP_GIMME_REVERSE(G) su_op_gimme_reverse(G)
 964 #endif
 965
 966 #define SU_UPLEVEL_SAVE(f, t) STMT_START { sud->old_##f = PL_##f; PL_##f = (t); } STMT_END
 967 #define SU_UPLEVEL_RESTORE(f) STMT_START { PL_##f = sud->old_##f; } STMT_END
 968
 969 STATIC su_uplevel_ud *su_uplevel_storage_new(pTHX) {
 970 #define su_uplevel_storage_new() su_uplevel_storage_new(aTHX)
 971  su_uplevel_ud *sud;
 972  dMY_CXT;
 973
 974  sud = MY_CXT.uplevel_storage.root;
 975  if (sud) {
 976   MY_CXT.uplevel_storage.root = sud->next;
 977   MY_CXT.uplevel_storage.count--;
 978  } else {
 979   sud = su_uplevel_ud_new();
 980  }
 981
 982  return sud;
 983 }
 984
 985 STATIC void su_uplevel_storage_delete(pTHX_ su_uplevel_ud *sud) {
 986 #define su_uplevel_storage_delete(S) su_uplevel_storage_delete(aTHX_ (S))
 987  dMY_CXT;
 988
 989  if (MY_CXT.uplevel_storage.count >= SU_UPLEVEL_STORAGE_SIZE) {
 990   su_uplevel_ud_delete(sud);
 991  } else {
 992   sud->next = MY_CXT.uplevel_storage.root;
 993   MY_CXT.uplevel_storage.root = sud;
 994   MY_CXT.uplevel_storage.count++;
 995  }
 996 }
 997
 998 #define SU_HAS_EXT_MAGIC SU_HAS_PERL(5, 8, 0)
 999
1000 #if SU_HAS_EXT_MAGIC && !SU_HAS_PERL(5, 13, 7)
1001
1002 STATIC int su_uplevel_restore_free(pTHX_ SV *sv, MAGIC *mg) {
1003  su_uplevel_storage_delete((su_uplevel_ud *) mg->mg_ptr);
1004
1005  return 0;
1006 }
1007
1008 STATIC MGVTBL su_uplevel_restore_vtbl = {
1009  0,
1010  0,
1011  0,
1012  0,
1013  su_uplevel_restore_free
1014 };
1015
1016 #endif /* SU_HAS_EXT_MAGIC && !SU_HAS_PERL(5, 13, 7) */
1017
1018 #define su_at_underscore(C) AvARRAY(AvARRAY(CvPADLIST(C))[CvDEPTH(C)])[0]
1019
1020 STATIC void su_uplevel_restore(pTHX_ void *sus_) {
1021  su_uplevel_ud *sud = sus_;
1022  PERL_SI *cur = sud->old_curstackinfo;
1023  PERL_SI *si  = sud->si;
1024
1025  if (sud->callback) {
1026   PERL_CONTEXT *cx = cxstack + sud->cxix;
1027   AV     *argarray = MUTABLE_AV(su_at_underscore(sud->callback));
1028
1029   /* We have to fix the pad entry for @_ in the original callback because it
1030    * may have been reified. */
1031   if (AvREAL(argarray)) {
1032    const I32 fill = AvFILLp(argarray);
1033    SvREFCNT_dec(argarray);
1034    argarray = newAV();
1035    AvREAL_off(argarray);
1036    AvREIFY_on(argarray);
1037    av_extend(argarray, fill);
1038    su_at_underscore(sud->callback) = MUTABLE_SV(argarray);
1039   } else {
1040    CLEAR_ARGARRAY(argarray);
1041   }
1042
1043   /* If the old cv member is our renamed CV, it means that this place has been
1044    * reached without a goto() happening, and the old argarray member is
1045    * actually our fake argarray. Destroy it properly in that case. */
1046   if (cx->blk_sub.cv == sud->renamed) {
1047    SvREFCNT_dec(cx->blk_sub.argarray);
1048    cx->blk_sub.argarray = argarray;
1049   }
1050
1051   CvDEPTH(sud->callback)--;
1052   SvREFCNT_dec(sud->callback);
1053  }
1054
1055  /* Free the renamed CV. We must do it ourselves so that we can force the
1056   * depth to be 0, or perl would complain about it being "still in use".
1057   * But we *know* that it cannot be so. */
1058  if (sud->renamed) {
1059   CvDEPTH(sud->renamed)   = 0;
1060   CvPADLIST(sud->renamed) = NULL;
1061   SvREFCNT_dec(sud->renamed);
1062  }
1063
1064  CATCH_SET(sud->old_catch);
1065
1066  SU_UPLEVEL_RESTORE(op);
1067
1068  /* stack_grow() wants PL_curstack so restore the old stack first */
1069  if (PL_curstackinfo == si) {
1070   PL_curstack = cur->si_stack;
1071   if (sud->old_mainstack)
1072    SU_UPLEVEL_RESTORE(mainstack);
1073   SU_UPLEVEL_RESTORE(curstackinfo);
1074
1075   if (sud->died) {
1076    CV *target = sud->target;
1077    I32 levels = 0, i;
1078
1079    /* When we die, the depth of the target CV is not updated because of the
1080     * stack switcheroo. So we have to look at all the frames between the
1081     * uplevel call and the catch block to count how many call frames to the
1082     * target CV were skipped. */
1083    for (i = cur->si_cxix; i > sud->cxix; i--) {
1084     register const PERL_CONTEXT *cx = cxstack + i;
1085
1086     if (CxTYPE(cx) == CXt_SUB) {
1087      if (cx->blk_sub.cv == target)
1088       ++levels;
1089     }
1090    }
1091
1092    /* If we died, the replacement stack was already unwinded to the first
1093     * eval frame, and all the contexts down there were popped. We don't have
1094     * to pop manually any context of the original stack, because they must
1095     * have been in the replacement stack as well (since the second was copied
1096     * from the first). Thus we only have to make sure the original stack index
1097     * points to the context just below the first eval scope under the target
1098     * frame. */
1099    for (; i >= 0; i--) {
1100     register const PERL_CONTEXT *cx = cxstack + i;
1101
1102     switch (CxTYPE(cx)) {
1103      case CXt_SUB:
1104       if (cx->blk_sub.cv == target)
1105        ++levels;
1106       break;
1107      case CXt_EVAL:
1108       goto found_it;
1109       break;
1110      default:
1111       break;
1112     }
1113    }
1114
1115 found_it:
1116    CvDEPTH(target) = sud->target_depth - levels;
1117    PL_curstackinfo->si_cxix = i - 1;
1118
1119 #if !SU_HAS_PERL(5, 13, 1)
1120    /* Since $@ was maybe localized between the target frame and the uplevel
1121     * call, we forcefully flush the save stack to get rid of it and then
1122     * reset $@ to its proper value. Note that the the call to
1123     * su_uplevel_restore() must happen before the "reset $@" item of the save
1124     * stack is processed, as uplevel was called after the localization.
1125     * Andrew's changes to how $@ was handled, which were mainly integrated
1126     * between perl 5.13.0 and 5.13.1, fixed this. */
1127    if (ERRSV && SvTRUE(ERRSV)) {
1128     register const PERL_CONTEXT *cx = cxstack + i; /* This is the eval scope */
1129     SV *errsv = SvREFCNT_inc(ERRSV);
1130     PL_scopestack_ix = cx->blk_oldscopesp;
1131     leave_scope(PL_scopestack[PL_scopestack_ix]);
1132     sv_setsv(ERRSV, errsv);
1133     SvREFCNT_dec(errsv);
1134    }
1135 #endif
1136   }
1137  }
1138
1139  SU_UPLEVEL_RESTORE(curcop);
1140
1141  SvREFCNT_dec(sud->target);
1142
1143  PL_stack_base = AvARRAY(cur->si_stack);
1144  PL_stack_sp   = PL_stack_base + AvFILLp(cur->si_stack);
1145  PL_stack_max  = PL_stack_base + AvMAX(cur->si_stack);
1146
1147  /* When an exception is thrown from the uplevel'd subroutine,
1148   * su_uplevel_restore() may be called by the LEAVE in die_unwind() (renamed
1149   * die_where() in more recent perls), which has the sad habit of keeping a
1150   * pointer to the current context frame across this call. This means that we
1151   * can't free the temporary context stack we used for the uplevel call right
1152   * now, or that pointer upwards would point to garbage. */
1153 #if SU_HAS_PERL(5, 13, 7)
1154  /* This issue has been fixed in perl with commit 8f89e5a9, which was made
1155   * public in perl 5.13.7. */
1156  su_uplevel_storage_delete(sud);
1157 #elif SU_HAS_EXT_MAGIC
1158  /* If 'ext' magic is available, we work around this by attaching the state
1159   * data to a scalar that will be freed "soon". */
1160  {
1161   SV *sv = sv_newmortal();
1162
1163   sv_magicext(sv, NULL, PERL_MAGIC_ext, &su_uplevel_restore_vtbl,
1164                         (const char *) sud, 0);
1165  }
1166 #else
1167  /* Otherwise, we just enqueue it back in the global storage list. */
1168  {
1169   dMY_CXT;
1170
1171   sud->next = MY_CXT.uplevel_storage.root;
1172   MY_CXT.uplevel_storage.root = sud;
1173   MY_CXT.uplevel_storage.count++;
1174  }
1175 #endif
1176
1177  return;
1178 }
1179
1180 STATIC CV *su_cv_clone(pTHX_ CV *proto, GV *gv) {
1181 #define su_cv_clone(P, G) su_cv_clone(aTHX_ (P), (G))
1182  dVAR;
1183  CV *cv;
1184
1185  cv = MUTABLE_CV(newSV_type(SvTYPE(proto)));
1186
1187  CvFLAGS(cv)  = CvFLAGS(proto);
1188 #ifdef CVf_CVGV_RC
1189  CvFLAGS(cv) &= ~CVf_CVGV_RC;
1190 #endif
1191  CvDEPTH(cv)  = CvDEPTH(proto);
1192 #ifdef USE_ITHREADS
1193  CvFILE(cv)   = CvISXSUB(proto) ? CvFILE(proto) : savepv(CvFILE(proto));
1194 #else
1195  CvFILE(cv)   = CvFILE(proto);
1196 #endif
1197
1198  CvGV_set(cv, gv);
1199  CvSTASH_set(cv, CvSTASH(proto));
1200  /* Commit 4c74a7df, publicized with perl 5.13.3, began to add backrefs to
1201   * stashes. CvSTASH_set() started to do it as well with commit c68d95645
1202   * (which was part of perl 5.13.7). */
1203 #if SU_HAS_PERL(5, 13, 3) && !SU_HAS_PERL(5, 13, 7)
1204  if (CvSTASH(proto))
1205   Perl_sv_add_backref(aTHX_ CvSTASH(proto), MUTABLE_SV(cv));
1206 #endif
1207
1208  if (CvISXSUB(proto)) {
1209   CvXSUB(cv)       = CvXSUB(proto);
1210   CvXSUBANY(cv)    = CvXSUBANY(proto);
1211  } else {
1212   OP_REFCNT_LOCK;
1213   CvROOT(cv)       = OpREFCNT_inc(CvROOT(proto));
1214   OP_REFCNT_UNLOCK;
1215   CvSTART(cv)      = CvSTART(proto);
1216  }
1217  CvOUTSIDE(cv)     = CvOUTSIDE(proto);
1218 #ifdef CVf_WEAKOUTSIDE
1219  if (!(CvFLAGS(proto) & CVf_WEAKOUTSIDE))
1220 #endif
1221   SvREFCNT_inc_simple_void(CvOUTSIDE(cv));
1222  CvPADLIST(cv)     = CvPADLIST(proto);
1223 #ifdef CvOUTSIDE_SEQ
1224  CvOUTSIDE_SEQ(cv) = CvOUTSIDE_SEQ(proto);
1225 #endif
1226
1227  if (SvPOK(proto))
1228   sv_setpvn(MUTABLE_SV(cv), SvPVX_const(proto), SvCUR(proto));
1229
1230 #ifdef CvCONST
1231  if (CvCONST(cv))
1232   CvCONST_off(cv);
1233 #endif
1234
1235  return cv;
1236 }
1237
1238 #if SU_HAS_PERL(5, 8, 0)
1239
1240 STATIC int su_uplevel_guard_free(pTHX_ SV *sv, MAGIC *mg) {
1241  MAGIC         *omg = (MAGIC *)          mg->mg_ptr;
1242  su_uplevel_ud *sud = (su_uplevel_ud *) omg->mg_ptr;
1243  AV *args;
1244
1245  /* This code should be triggered by the FREETMPS in the first
1246   * nextstate/dbstate op of the goto'd code. Its job is to reset the sub
1247   * arguments to what the uplevel'd code was called with. */
1248
1249  if (PL_op != CvSTART(sud->goto_code))
1250   croak("su_uplevel_guard_free() was called at an incorrect time");
1251  sud->goto_code = NULL;
1252
1253  /* get_db_sub() has called save_item() on the SV member of the fake GV we
1254   * used to replace PL_DBsub, so we can't kill it yet. Since set magic will
1255   * be called when the item is restored, we save the fake GV so that we can
1256   * correctly drop its refcount just after the restore. */
1257  omg->mg_obj = MUTABLE_SV(PL_DBsub);
1258  PL_DBsub    = NULL;
1259
1260  args = sud->args;
1261  if (args) {
1262   PERL_CONTEXT *cx;
1263   I32 items = AvFILLp(args);
1264   AV *argarray;
1265   dSP;
1266
1267   EXTEND(SP, items + 2);
1268   Copy(AvARRAY(args), SP + 1, items + 1, SV *);
1269
1270   cx       = cxstack + cxstack_ix;
1271   argarray = cx->blk_sub.argarray;
1272   av_extend(argarray, items);
1273   Copy(AvARRAY(args), AvARRAY(argarray), items + 1, SV *);
1274   AvFILLp(argarray) = items;
1275  }
1276
1277  return 0;
1278 }
1279
1280 STATIC MGVTBL su_uplevel_guard_vtbl = {
1281  0,
1282  0,
1283  0,
1284  0,
1285  su_uplevel_guard_free
1286 };
1287
1288 STATIC int su_uplevel_dbsv_get(pTHX_ SV *sv, MAGIC *mg) {
1289  su_uplevel_ud *sud = (su_uplevel_ud *) mg->mg_ptr;
1290  SV *guard;
1291
1292  /* This code should be called at the very end of pp_goto, after the
1293   * SAVETMPS enclosing the sub was isseud and the blk_sub.cv member is set.
1294   * It creates a magical mortal guard that will be destroyed soon at the next
1295   * FREETMPS. */
1296
1297  if (PL_op != sud->goto_op)
1298   croak("su_uplevel_dbsv_get() was called at an incorrect time");
1299  sud->goto_op   = NULL;
1300
1301  sud->goto_code = cxstack[cxstack_ix].blk_sub.cv;
1302  PL_perldb      = sud->goto_perldb;
1303
1304  guard = sv_newmortal();
1305  sv_magicext(guard, 0, PERL_MAGIC_ext, &su_uplevel_guard_vtbl,
1306                        (const char *) mg, 0);
1307
1308  return 0;
1309 }
1310
1311 STATIC int su_uplevel_dbsv_set(pTHX_ SV *sv, MAGIC *mg) {
1312  su_uplevel_ud *sud = (su_uplevel_ud *) mg->mg_ptr;
1313  SV *guard;
1314
1315  /* This handler is supposed to be executed when the saved GvSV(PL_DBsub)
1316   * is restored, which happens when the goto'd code terminates. Its aim is
1317   * just to clean up after our hack. */
1318
1319  if (sud->goto_op)
1320   croak("su_uplevel_dbsv_set() called before su_uplevel_dbsv_get");
1321  if (sud->goto_code)
1322   croak("su_uplevel_dbsv_set() called before su_uplevel_goto_2_free");
1323
1324  /* Don't free the current magical SV right now, because the mg_*() calls above
1325   * us may still need it. */
1326  sv_2mortal(sv);
1327  SvREFCNT_dec(mg->mg_obj);
1328
1329  return 0;
1330 }
1331
1332 STATIC MGVTBL su_uplevel_dbsv_vtbl = {
1333  su_uplevel_dbsv_get,
1334  su_uplevel_dbsv_set,
1335  0,
1336  0,
1337  0
1338 };
1339
1340 #ifndef GvSVn
1341 # ifdef PERL_DONT_CREATE_GVSV
1342 #  define GvSVn(gv)       (*(GvGP(gv)->gp_sv ? \
1343                            &(GvGP(gv)->gp_sv) : \
1344                            &(GvGP(gv_SVadd(gv))->gp_sv)))
1345 # else
1346 #  define GvSVn(gv)       GvSV(gv)
1347 # endif
1348 #endif
1349
1350 STATIC void su_uplevel_goto_handler(pTHX_ void *ud_) {
1351  su_uplevel_ud *sud = ud_;
1352
1353  if (PL_op && PL_op->op_type == OP_GOTO && !PL_DBsub) {
1354   SV *dbsv;
1355
1356   sud->goto_op     = PL_op;
1357   sud->goto_code   = NULL;
1358   sud->goto_perldb = PL_perldb;
1359
1360   PL_DBsub  = (GV *) newSV(0);
1361   gv_init(PL_DBsub, NULL, "", 0, 0);
1362   PL_perldb = PERLDBf_SUB;
1363
1364   dbsv = GvSVn(PL_DBsub);
1365   sv_magicext(dbsv, NULL, PERL_MAGIC_ext, &su_uplevel_dbsv_vtbl,
1366                           (const char *) sud, 0);
1367   SvREFCNT_inc(dbsv);
1368  }
1369 }
1370
1371 #else /* SU_HAS_PERL(5, 8, 0) */
1372
1373 STATIC void su_uplevel_goto_handler(pTHX_ void *ud_) {
1374  su_uplevel_ud *sud = ud_;
1375
1376  if (PL_op && PL_op->op_type == OP_GOTO) {
1377   /* Don't let the last sub context in an mixed state while we throw an
1378    * exception, as this may cause double free errors (the blk_sub.cv member
1379    * is still the renamed CV). Let our su_uplevel_restore() properly handle the
1380    * destruction. */
1381   cxstack[cxstack_ix].blk_sub.cv = NULL;
1382   croak("Can't goto to an uplevel'd stack frame on perl 5.6");
1383  }
1384 }
1385
1386 #endif /* !SU_HAS_PERL(5, 8, 0) */
1387
1388 STATIC I32 su_uplevel(pTHX_ CV *callback, I32 cxix, I32 args) {
1389 #define su_uplevel(C, I, A) su_uplevel(aTHX_ (C), (I), (A))
1390  su_uplevel_ud *sud;
1391  const PERL_CONTEXT *cx = cxstack + cxix;
1392  PERL_SI *si;
1393  PERL_SI *cur = PL_curstackinfo;
1394  SV **old_stack_sp;
1395  CV  *target;
1396  CV  *renamed;
1397  UNOP sub_op;
1398  I32  gimme;
1399  I32  old_mark, new_mark;
1400  I32  ret;
1401  dSP;
1402
1403  ENTER;
1404
1405  gimme = GIMME_V;
1406  /* Make PL_stack_sp point just before the CV. */
1407  PL_stack_sp -= args + 1;
1408  old_mark = AvFILLp(PL_curstack) = PL_stack_sp - PL_stack_base;
1409  SPAGAIN;
1410
1411  sud = su_uplevel_storage_new();
1412
1413  sud->cxix     = cxix;
1414  sud->died     = 1;
1415  sud->callback = NULL;
1416  sud->renamed  = NULL;
1417  sud->args     = NULL;
1418  SAVEDESTRUCTOR_X(su_uplevel_restore, sud);
1419
1420  si = sud->si;
1421
1422  si->si_type    = cur->si_type;
1423  si->si_next    = NULL;
1424  si->si_prev    = cur->si_prev;
1425 #ifdef DEBUGGING
1426  si->si_markoff = cx->blk_oldmarksp;
1427 #endif
1428
1429  /* Allocate enough space for all the elements of the original stack up to the
1430   * target context, plus the forthcoming arguments. */
1431  new_mark = cx->blk_oldsp;
1432  av_extend(si->si_stack, new_mark + 1 + args + 1);
1433  Copy(PL_curstack, AvARRAY(si->si_stack), new_mark + 1, SV *);
1434  AvFILLp(si->si_stack) = new_mark;
1435  SU_POISON(AvARRAY(si->si_stack) + new_mark + 1, args + 1, SV *);
1436
1437  /* Specialized SWITCHSTACK() */
1438  PL_stack_base = AvARRAY(si->si_stack);
1439  old_stack_sp  = PL_stack_sp;
1440  PL_stack_sp   = PL_stack_base + AvFILLp(si->si_stack);
1441  PL_stack_max  = PL_stack_base + AvMAX(si->si_stack);
1442  SPAGAIN;
1443
1444  /* Copy the context stack up to the context just below the target. */
1445  si->si_cxix = (cxix < 0) ? -1 : (cxix - 1);
1446  if (si->si_cxmax < cxix) {
1447   /* The max size must be at least two so that GROW(max) = (max*3)/2 > max */
1448   si->si_cxmax = (cxix < 4) ? 4 : cxix;
1449   Renew(si->si_cxstack, si->si_cxmax + 1, PERL_CONTEXT);
1450  }
1451  Copy(cur->si_cxstack, si->si_cxstack, cxix, PERL_CONTEXT);
1452  SU_POISON(si->si_cxstack + cxix, si->si_cxmax + 1 - cxix, PERL_CONTEXT);
1453
1454  target            = cx->blk_sub.cv;
1455  sud->target       = (CV *) SvREFCNT_inc(target);
1456  sud->target_depth = CvDEPTH(target);
1457
1458  /* blk_oldcop is essentially needed for caller() and stack traces. It has no
1459   * run-time implication, since PL_curcop will be overwritten as soon as we
1460   * enter a sub (a sub starts by a nextstate/dbstate). Hence it's safe to just
1461   * make it point to the blk_oldcop for the target frame, so that caller()
1462   * reports the right file name, line number and lexical hints. */
1463  SU_UPLEVEL_SAVE(curcop, cx->blk_oldcop);
1464  /* Don't reset PL_markstack_ptr, or we would overwrite the mark stack below
1465   * this point. Don't reset PL_curpm either, we want the most recent matches. */
1466
1467  SU_UPLEVEL_SAVE(curstackinfo, si);
1468  /* If those two are equal, we need to fool POPSTACK_TO() */
1469  if (PL_mainstack == PL_curstack)
1470   SU_UPLEVEL_SAVE(mainstack, si->si_stack);
1471  else
1472   sud->old_mainstack = NULL;
1473  PL_curstack = si->si_stack;
1474
1475  renamed      = su_cv_clone(callback, CvGV(target));
1476  sud->renamed = renamed;
1477
1478  PUSHMARK(SP);
1479  /* Both SP and old_stack_sp point just before the CV. */
1480  Copy(old_stack_sp + 2, SP + 1, args, SV *);
1481  SP += args;
1482  PUSHs((SV *) renamed);
1483  PUTBACK;
1484
1485  Zero(&sub_op, 1, UNOP);
1486  sub_op.op_type  = OP_ENTERSUB;
1487  sub_op.op_next  = NULL;
1488  sub_op.op_flags = OP_GIMME_REVERSE(gimme) | OPf_STACKED;
1489  if (PL_DBsub)
1490   sub_op.op_flags |= OPpENTERSUB_DB;
1491
1492  SU_UPLEVEL_SAVE(op, (OP *) &sub_op);
1493
1494  sud->old_catch = CATCH_GET;
1495  CATCH_SET(TRUE);
1496
1497  if ((PL_op = PL_ppaddr[OP_ENTERSUB](aTHX))) {
1498   PERL_CONTEXT *sub_cx = cxstack + cxstack_ix;
1499
1500   /* If pp_entersub() returns a non-null OP, it means that the callback is not
1501    * an XSUB. */
1502
1503   sud->callback = MUTABLE_CV(SvREFCNT_inc(callback));
1504   CvDEPTH(callback)++;
1505
1506   if (CxHASARGS(cx) && cx->blk_sub.argarray) {
1507    /* The call to pp_entersub() has saved the current @_ (in XS terms,
1508     * GvAV(PL_defgv)) in the savearray member, and has created a new argarray
1509     * with what we put on the stack. But we want to fake up the same arguments
1510     * as the ones in use at the context we uplevel to, so we replace the
1511     * argarray with an unreal copy of the original @_. */
1512    AV *av = newAV();
1513    AvREAL_off(av);
1514    AvREIFY_on(av);
1515    av_extend(av, AvMAX(cx->blk_sub.argarray));
1516    AvFILLp(av) = AvFILLp(cx->blk_sub.argarray);
1517    Copy(AvARRAY(cx->blk_sub.argarray), AvARRAY(av), AvFILLp(av) + 1, SV *);
1518    sub_cx->blk_sub.argarray = av;
1519   } else {
1520    SvREFCNT_inc_simple_void(sub_cx->blk_sub.argarray);
1521   }
1522   sud->args = GvAV(PL_defgv);
1523
1524   SAVEDESTRUCTOR_X(su_uplevel_goto_handler, sud);
1525
1526   CALLRUNOPS(aTHX);
1527  }
1528
1529  sud->died = 0;
1530
1531  ret = PL_stack_sp - (PL_stack_base + new_mark);
1532  if (ret > 0) {
1533   AV *old_stack = sud->old_curstackinfo->si_stack;
1534
1535   if (old_mark + ret > AvMAX(old_stack)) {
1536    /* Specialized EXTEND(old_sp, ret) */
1537    av_extend(old_stack, old_mark + ret + 1);
1538    old_stack_sp = AvARRAY(old_stack) + old_mark;
1539   }
1540
1541   Copy(PL_stack_sp - ret + 1, old_stack_sp + 1, ret, SV *);
1542   PL_stack_sp        += ret;
1543   AvFILLp(old_stack) += ret;
1544  }
1545
1546  LEAVE;
1547
1548  return ret;
1549 }
1550
1551 /* --- Interpreter setup/teardown ------------------------------------------ */
1552
1553 STATIC void su_teardown(pTHX_ void *param) {
1554  su_uplevel_ud *cur;
1555  dMY_CXT;
1556
1557  cur = MY_CXT.uplevel_storage.root;
1558  if (cur) {
1559   su_uplevel_ud *prev;
1560   do {
1561    prev = cur;
1562    cur  = prev->next;
1563    su_uplevel_ud_delete(prev);
1564   } while (cur);
1565  }
1566
1567  return;
1568 }
1569
1570 STATIC void su_setup(pTHX) {
1571 #define su_setup() su_setup(aTHX)
1572  MY_CXT_INIT;
1573
1574  MY_CXT.stack_placeholder = NULL;
1575
1576  /* NewOp() calls calloc() which just zeroes the memory with memset(). */
1577  Zero(&(MY_CXT.unwind_storage.return_op), 1, LISTOP);
1578  MY_CXT.unwind_storage.return_op.op_type   = OP_RETURN;
1579  MY_CXT.unwind_storage.return_op.op_ppaddr = PL_ppaddr[OP_RETURN];
1580
1581  Zero(&(MY_CXT.unwind_storage.proxy_op), 1, OP);
1582  MY_CXT.unwind_storage.proxy_op.op_type   = OP_STUB;
1583  MY_CXT.unwind_storage.proxy_op.op_ppaddr = NULL;
1584
1585  MY_CXT.uplevel_storage.root  = NULL;
1586  MY_CXT.uplevel_storage.count = 0;
1587
1588  call_atexit(su_teardown, NULL);
1589
1590  return;
1591 }
1592
1593 /* --- XS ------------------------------------------------------------------ */
1594
1595 #if SU_HAS_PERL(5, 8, 9)
1596 # define SU_SKIP_DB_MAX 2
1597 #else
1598 # define SU_SKIP_DB_MAX 3
1599 #endif
1600
1601 /* Skip context sequences of 1 to SU_SKIP_DB_MAX (included) block contexts
1602  * followed by a DB sub */
1603
1604 #define SU_SKIP_DB(C) \
1605  STMT_START {         \
1606   I32 skipped = 0;    \
1607   PERL_CONTEXT *base = cxstack;      \
1608   PERL_CONTEXT *cx   = base + (C);   \
1609   while (cx >= base && (C) > skipped && CxTYPE(cx) == CXt_BLOCK) \
1610    --cx, ++skipped;                  \
1611   if (cx >= base && (C) > skipped) { \
1612    switch (CxTYPE(cx)) {  \
1613     case CXt_SUB:         \
1614      if (skipped <= SU_SKIP_DB_MAX && cx->blk_sub.cv == GvCV(PL_DBsub)) \
1615       (C) -= skipped + 1; \
1616       break;              \
1617     default:              \
1618      break;               \
1619    }                      \
1620   }                       \
1621  } STMT_END
1622
1623 #define SU_GET_CONTEXT(A, B)   \
1624  STMT_START {                  \
1625   if (items > A) {             \
1626    SV *csv = ST(B);            \
1627    if (!SvOK(csv))             \
1628     goto default_cx;           \
1629    cxix = SvIV(csv);           \
1630    if (cxix < 0)               \
1631     cxix = 0;                  \
1632    else if (cxix > cxstack_ix) \
1633     cxix = cxstack_ix;         \
1634   } else {                     \
1635 default_cx:                    \
1636    cxix = cxstack_ix;          \
1637    if (PL_DBsub)               \
1638     SU_SKIP_DB(cxix);          \
1639   }                            \
1640  } STMT_END
1641
1642 #define SU_GET_LEVEL(A, B) \
1643  STMT_START {              \
1644   level = 0;               \
1645   if (items > 0) {         \
1646    SV *lsv = ST(B);        \
1647    if (SvOK(lsv)) {        \
1648     level = SvIV(lsv);     \
1649     if (level < 0)         \
1650      level = 0;            \
1651    }                       \
1652   }                        \
1653  } STMT_END
1654
1655 XS(XS_Scope__Upper_unwind); /* prototype to pass -Wmissing-prototypes */
1656
1657 XS(XS_Scope__Upper_unwind) {
1658 #ifdef dVAR
1659  dVAR; dXSARGS;
1660 #else
1661  dXSARGS;
1662 #endif
1663  dMY_CXT;
1664  I32 cxix;
1665
1666  PERL_UNUSED_VAR(cv); /* -W */
1667  PERL_UNUSED_VAR(ax); /* -Wall */
1668
1669  SU_GET_CONTEXT(0, items - 1);
1670  do {
1671   PERL_CONTEXT *cx = cxstack + cxix;
1672   switch (CxTYPE(cx)) {
1673    case CXt_SUB:
1674     if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
1675      continue;
1676    case CXt_EVAL:
1677    case CXt_FORMAT:
1678     MY_CXT.unwind_storage.cxix  = cxix;
1679     MY_CXT.unwind_storage.items = items;
1680     /* pp_entersub will want to sanitize the stack after returning from there
1681      * Screw that, we're insane */
1682     if (GIMME_V == G_SCALAR) {
1683      MY_CXT.unwind_storage.savesp = PL_stack_sp;
1684      /* dXSARGS calls POPMARK, so we need to match PL_markstack_ptr[1] */
1685      PL_stack_sp = PL_stack_base + PL_markstack_ptr[1] + 1;
1686     } else {
1687      MY_CXT.unwind_storage.savesp = NULL;
1688     }
1689     SAVEDESTRUCTOR_X(su_unwind, NULL);
1690     return;
1691    default:
1692     break;
1693   }
1694  } while (--cxix >= 0);
1695  croak("Can't return outside a subroutine");
1696 }
1697
1698 MODULE = Scope::Upper            PACKAGE = Scope::Upper
1699
1700 PROTOTYPES: ENABLE
1701
1702 BOOT:
1703 {
1704  HV *stash;
1705
1706  stash = gv_stashpv(__PACKAGE__, 1);
1707  newCONSTSUB(stash, "TOP",           newSViv(0));
1708  newCONSTSUB(stash, "SU_THREADSAFE", newSVuv(SU_THREADSAFE));
1709
1710  newXSproto("Scope::Upper::unwind", XS_Scope__Upper_unwind, file, NULL);
1711
1712  su_setup();
1713 }
1714
1715 #if SU_THREADSAFE
1716
1717 void
1718 CLONE(...)
1719 PROTOTYPE: DISABLE
1720 PPCODE:
1721  {
1722   MY_CXT_CLONE;
1723   MY_CXT.uplevel_storage.root  = NULL;
1724   MY_CXT.uplevel_storage.count = 0;
1725  }
1726  XSRETURN(0);
1727
1728 #endif /* SU_THREADSAFE */
1729
1730 void
1731 HERE()
1732 PROTOTYPE:
1733 PREINIT:
1734  I32 cxix = cxstack_ix;
1735 PPCODE:
1736  if (PL_DBsub)
1737   SU_SKIP_DB(cxix);
1738  EXTEND(SP, 1);
1739  mPUSHi(cxix);
1740  XSRETURN(1);
1741
1742 void
1743 UP(...)
1744 PROTOTYPE: ;$
1745 PREINIT:
1746  I32 cxix;
1747 PPCODE:
1748  SU_GET_CONTEXT(0, 0);
1749  if (--cxix < 0)
1750   cxix = 0;
1751  if (PL_DBsub)
1752   SU_SKIP_DB(cxix);
1753  EXTEND(SP, 1);
1754  mPUSHi(cxix);
1755  XSRETURN(1);
1756
1757 void
1758 SUB(...)
1759 PROTOTYPE: ;$
1760 PREINIT:
1761  I32 cxix;
1762 PPCODE:
1763  SU_GET_CONTEXT(0, 0);
1764  EXTEND(SP, 1);
1765  for (; cxix >= 0; --cxix) {
1766   PERL_CONTEXT *cx = cxstack + cxix;
1767   switch (CxTYPE(cx)) {
1768    default:
1769     continue;
1770    case CXt_SUB:
1771     if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
1772      continue;
1773     mPUSHi(cxix);
1774     XSRETURN(1);
1775   }
1776  }
1777  XSRETURN_UNDEF;
1778
1779 void
1780 EVAL(...)
1781 PROTOTYPE: ;$
1782 PREINIT:
1783  I32 cxix;
1784 PPCODE:
1785  SU_GET_CONTEXT(0, 0);
1786  EXTEND(SP, 1);
1787  for (; cxix >= 0; --cxix) {
1788   PERL_CONTEXT *cx = cxstack + cxix;
1789   switch (CxTYPE(cx)) {
1790    default:
1791     continue;
1792    case CXt_EVAL:
1793     mPUSHi(cxix);
1794     XSRETURN(1);
1795   }
1796  }
1797  XSRETURN_UNDEF;
1798
1799 void
1800 SCOPE(...)
1801 PROTOTYPE: ;$
1802 PREINIT:
1803  I32 cxix, level;
1804 PPCODE:
1805  SU_GET_LEVEL(0, 0);
1806  cxix = cxstack_ix;
1807  if (PL_DBsub) {
1808   SU_SKIP_DB(cxix);
1809   while (cxix > 0) {
1810    if (--level < 0)
1811     break;
1812    --cxix;
1813    SU_SKIP_DB(cxix);
1814   }
1815  } else {
1816   cxix -= level;
1817   if (cxix < 0)
1818    cxix = 0;
1819  }
1820  EXTEND(SP, 1);
1821  mPUSHi(cxix);
1822  XSRETURN(1);
1823
1824 void
1825 CALLER(...)
1826 PROTOTYPE: ;$
1827 PREINIT:
1828  I32 cxix, level;
1829 PPCODE:
1830  SU_GET_LEVEL(0, 0);
1831  for (cxix = cxstack_ix; cxix > 0; --cxix) {
1832   PERL_CONTEXT *cx = cxstack + cxix;
1833   switch (CxTYPE(cx)) {
1834    case CXt_SUB:
1835     if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
1836      continue;
1837    case CXt_EVAL:
1838    case CXt_FORMAT:
1839     if (--level < 0)
1840      goto done;
1841     break;
1842   }
1843  }
1844 done:
1845  EXTEND(SP, 1);
1846  mPUSHi(cxix);
1847  XSRETURN(1);
1848
1849 void
1850 want_at(...)
1851 PROTOTYPE: ;$
1852 PREINIT:
1853  I32 cxix;
1854 PPCODE:
1855  SU_GET_CONTEXT(0, 0);
1856  EXTEND(SP, 1);
1857  while (cxix > 0) {
1858   PERL_CONTEXT *cx = cxstack + cxix--;
1859   switch (CxTYPE(cx)) {
1860    case CXt_SUB:
1861    case CXt_EVAL:
1862    case CXt_FORMAT: {
1863     I32 gimme = cx->blk_gimme;
1864     switch (gimme) {
1865      case G_VOID:   XSRETURN_UNDEF; break;
1866      case G_SCALAR: XSRETURN_NO;    break;
1867      case G_ARRAY:  XSRETURN_YES;   break;
1868     }
1869     break;
1870    }
1871   }
1872  }
1873  XSRETURN_UNDEF;
1874
1875 void
1876 reap(SV *hook, ...)
1877 PROTOTYPE: &;$
1878 PREINIT:
1879  I32 cxix;
1880  su_ud_reap *ud;
1881 CODE:
1882  SU_GET_CONTEXT(1, 1);
1883  Newx(ud, 1, su_ud_reap);
1884  SU_UD_ORIGIN(ud)  = NULL;
1885  SU_UD_HANDLER(ud) = su_reap;
1886  ud->cb = newSVsv(hook);
1887  su_init(ud, cxix, SU_SAVE_DESTRUCTOR_SIZE);
1888
1889 void
1890 localize(SV *sv, SV *val, ...)
1891 PROTOTYPE: $$;$
1892 PREINIT:
1893  I32 cxix;
1894  I32 size;
1895  su_ud_localize *ud;
1896 CODE:
1897  SU_GET_CONTEXT(2, 2);
1898  Newx(ud, 1, su_ud_localize);
1899  SU_UD_ORIGIN(ud)  = NULL;
1900  SU_UD_HANDLER(ud) = su_localize;
1901  size = su_ud_localize_init(ud, sv, val, NULL);
1902  su_init(ud, cxix, size);
1903
1904 void
1905 localize_elem(SV *sv, SV *elem, SV *val, ...)
1906 PROTOTYPE: $$$;$
1907 PREINIT:
1908  I32 cxix;
1909  I32 size;
1910  su_ud_localize *ud;
1911 CODE:
1912  if (SvTYPE(sv) >= SVt_PVGV)
1913   croak("Can't infer the element localization type from a glob and the value");
1914  SU_GET_CONTEXT(3, 3);
1915  Newx(ud, 1, su_ud_localize);
1916  SU_UD_ORIGIN(ud)  = NULL;
1917  SU_UD_HANDLER(ud) = su_localize;
1918  size = su_ud_localize_init(ud, sv, val, elem);
1919  if (ud->type != SVt_PVAV && ud->type != SVt_PVHV) {
1920   SU_UD_LOCALIZE_FREE(ud);
1921   croak("Can't localize an element of something that isn't an array or a hash");
1922  }
1923  su_init(ud, cxix, size);
1924
1925 void
1926 localize_delete(SV *sv, SV *elem, ...)
1927 PROTOTYPE: $$;$
1928 PREINIT:
1929  I32 cxix;
1930  I32 size;
1931  su_ud_localize *ud;
1932 CODE:
1933  SU_GET_CONTEXT(2, 2);
1934  Newx(ud, 1, su_ud_localize);
1935  SU_UD_ORIGIN(ud)  = NULL;
1936  SU_UD_HANDLER(ud) = su_localize;
1937  size = su_ud_localize_init(ud, sv, NULL, elem);
1938  su_init(ud, cxix, size);
1939
1940 void
1941 uplevel(SV *code, ...)
1942 PROTOTYPE: &@
1943 PREINIT:
1944  I32 cxix, ret, args = 0;
1945 PPCODE:
1946  if (SvROK(code))
1947   code = SvRV(code);
1948  if (SvTYPE(code) < SVt_PVCV)
1949   croak("First argument to uplevel must be a code reference");
1950  SU_GET_CONTEXT(1, items - 1);
1951  do {
1952   PERL_CONTEXT *cx = cxstack + cxix;
1953   switch (CxTYPE(cx)) {
1954    case CXt_EVAL:
1955     croak("Can't uplevel to an eval frame");
1956    case CXt_FORMAT:
1957     croak("Can't uplevel to a format frame");
1958    case CXt_SUB:
1959     if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
1960      continue;
1961     if (items > 1) {
1962      PL_stack_sp--;
1963      args = items - 2;
1964     }
1965     /* su_uplevel() takes care of extending the stack if needed. */
1966     ret = su_uplevel((CV *) code, cxix, args);
1967     XSRETURN(ret);
1968    default:
1969     break;
1970   }
1971  } while (--cxix >= 0);
1972  croak("Can't uplevel outside a subroutine");