3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4 * 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * For the fashion of Minas Tirith was such that it was built on seven
15 * [p.751 of _The Lord of the Rings_, V/i: "Minas Tirith"]
18 /* This file contains functions to manipulate several of Perl's stacks;
19 * in particular it contains code to push various types of things onto
20 * the savestack, then to pop them off and perform the correct restorative
21 * action for each one. This corresponds to the cleanup Perl does at
26 #define PERL_IN_SCOPE_C
31 Perl_stack_grow(pTHX_ SV **sp, SV **p, SSize_t n)
34 SSize_t current = (p - PL_stack_base);
36 PERL_ARGS_ASSERT_STACK_GROW;
40 "panic: stack_grow() negative count (%" IVdf ")", (IV)n);
49 /* If the total might wrap, panic instead. This is really testing
50 * that (current + n + extra < SSize_t_MAX), but done in a way that
52 if (UNLIKELY( current > SSize_t_MAX - extra
53 || current + extra > SSize_t_MAX - n
55 /* diag_listed_as: Out of memory during %s extend */
56 Perl_croak(aTHX_ "Out of memory during stack extend");
58 av_extend(PL_curstack, current + n + extra);
60 PL_curstackinfo->si_stack_hwm = current + n + extra;
66 #ifndef STRESS_REALLOC
67 #define GROW(old) ((old) * 3 / 2)
69 #define GROW(old) ((old) + 1)
73 Perl_new_stackinfo(pTHX_ I32 stitems, I32 cxitems)
77 si->si_stack = newAV();
78 AvREAL_off(si->si_stack);
79 av_extend(si->si_stack, stitems > 0 ? stitems-1 : 0);
80 AvALLOC(si->si_stack)[0] = &PL_sv_undef;
81 AvFILLp(si->si_stack) = 0;
84 si->si_cxmax = cxitems - 1;
87 si->si_type = PERLSI_UNDEF;
88 Newx(si->si_cxstack, cxitems, PERL_CONTEXT);
89 /* Without any kind of initialising CX_PUSHSUBST()
90 * in pp_subst() will read uninitialised heap. */
91 PoisonNew(si->si_cxstack, cxitems, PERL_CONTEXT);
98 const IV old_max = cxstack_max;
99 const IV new_max = GROW(cxstack_max);
100 Renew(cxstack, new_max + 1, PERL_CONTEXT);
101 cxstack_max = new_max;
102 /* Without any kind of initialising deep enough recursion
103 * will end up reading uninitialised PERL_CONTEXTs. */
104 PoisonNew(cxstack + old_max + 1, new_max - old_max, PERL_CONTEXT);
105 return cxstack_ix + 1;
109 Perl_push_scope(pTHX)
111 if (UNLIKELY(PL_scopestack_ix == PL_scopestack_max)) {
112 const IV new_max = GROW(PL_scopestack_max);
113 Renew(PL_scopestack, new_max, I32);
115 Renew(PL_scopestack_name, new_max, const char*);
117 PL_scopestack_max = new_max;
120 PL_scopestack_name[PL_scopestack_ix] = "unknown";
122 PL_scopestack[PL_scopestack_ix++] = PL_savestack_ix;
129 const I32 oldsave = PL_scopestack[--PL_scopestack_ix];
130 LEAVE_SCOPE(oldsave);
134 Perl_markstack_grow(pTHX)
136 const I32 oldmax = PL_markstack_max - PL_markstack;
137 const I32 newmax = GROW(oldmax);
139 Renew(PL_markstack, newmax, I32);
140 PL_markstack_max = PL_markstack + newmax;
141 PL_markstack_ptr = PL_markstack + oldmax;
142 DEBUG_s(DEBUG_v(PerlIO_printf(Perl_debug_log,
143 "MARK grow %p %" IVdf " by %" IVdf "\n",
144 PL_markstack_ptr, (IV)*PL_markstack_ptr, (IV)oldmax)));
145 return PL_markstack_ptr;
149 Perl_savestack_grow(pTHX)
152 #ifdef STRESS_REALLOC
153 new_max = PL_savestack_max + SS_MAXPUSH;
155 new_max = GROW(PL_savestack_max);
157 /* Note that we allocate SS_MAXPUSH slots higher than ss_max
158 * so that SS_ADD_END(), SSGROW() etc can do a simper check */
159 Renew(PL_savestack, new_max + SS_MAXPUSH, ANY);
160 PL_savestack_max = new_max;
164 Perl_savestack_grow_cnt(pTHX_ I32 need)
166 const IV new_max = PL_savestack_ix + need;
167 /* Note that we allocate SS_MAXPUSH slots higher than ss_max
168 * so that SS_ADD_END(), SSGROW() etc can do a simper check */
169 Renew(PL_savestack, new_max + SS_MAXPUSH, ANY);
170 PL_savestack_max = new_max;
175 /* The original function was called Perl_tmps_grow and was removed from public
176 API, Perl_tmps_grow_p is the replacement and it used in public macros but
179 Perl_tmps_grow_p takes a proposed ix. A proposed ix is PL_tmps_ix + extend_by,
180 where the result of (PL_tmps_ix + extend_by) is >= PL_tmps_max
181 Upon return, PL_tmps_stack[ix] will be a valid address. For machine code
182 optimization and register usage reasons, the proposed ix passed into
183 tmps_grow is returned to the caller which the caller can then use to write
184 an SV * to PL_tmps_stack[ix]. If the caller was using tmps_grow in
185 pre-extend mode (EXTEND_MORTAL macro), then it ignores the return value of
186 tmps_grow. Note, tmps_grow DOES NOT write ix to PL_tmps_ix, the caller
187 must assign ix or ret val of tmps_grow to PL_temps_ix themselves if that is
188 appropriate. The assignment to PL_temps_ix can happen before or after
189 tmps_grow call since tmps_grow doesn't look at PL_tmps_ix.
193 Perl_tmps_grow_p(pTHX_ SSize_t ix)
195 SSize_t extend_to = ix;
196 #ifndef STRESS_REALLOC
197 if (ix - PL_tmps_max < 128)
198 extend_to += (PL_tmps_max < 512) ? 128 : 512;
200 Renew(PL_tmps_stack, extend_to + 1, SV*);
201 PL_tmps_max = extend_to + 1;
209 /* XXX should tmps_floor live in cxstack? */
210 const SSize_t myfloor = PL_tmps_floor;
211 while (PL_tmps_ix > myfloor) { /* clean up after last statement */
212 SV* const sv = PL_tmps_stack[PL_tmps_ix--];
214 PoisonWith(PL_tmps_stack + PL_tmps_ix + 1, 1, SV *, 0xAB);
218 SvREFCNT_dec_NN(sv); /* note, can modify tmps_ix!!! */
224 S_save_scalar_at(pTHX_ SV **sptr, const U32 flags)
229 PERL_ARGS_ASSERT_SAVE_SCALAR_AT;
232 if (flags & SAVEf_KEEPOLDELEM)
235 sv = (*sptr = newSV(0));
236 if (SvTYPE(osv) >= SVt_PVMG && SvMAGIC(osv))
237 mg_localize(osv, sv, cBOOL(flags & SAVEf_SETMAGIC));
244 Perl_save_pushptrptr(pTHX_ void *const ptr1, void *const ptr2, const int type)
254 Perl_save_scalar(pTHX_ GV *gv)
256 SV ** const sptr = &GvSVn(gv);
258 PERL_ARGS_ASSERT_SAVE_SCALAR;
260 if (UNLIKELY(SvGMAGICAL(*sptr))) {
265 save_pushptrptr(SvREFCNT_inc_simple(gv), SvREFCNT_inc(*sptr), SAVEt_SV);
266 return save_scalar_at(sptr, SAVEf_SETMAGIC); /* XXX - FIXME - see #60360 */
269 /* Like save_sptr(), but also SvREFCNT_dec()s the new value. Can be used to
270 * restore a global SV to its prior contents, freeing new value. */
272 Perl_save_generic_svref(pTHX_ SV **sptr)
274 PERL_ARGS_ASSERT_SAVE_GENERIC_SVREF;
276 save_pushptrptr(sptr, SvREFCNT_inc(*sptr), SAVEt_GENERIC_SVREF);
279 /* Like save_pptr(), but also Safefree()s the new value if it is different
280 * from the old one. Can be used to restore a global char* to its prior
281 * contents, freeing new value. */
283 Perl_save_generic_pvref(pTHX_ char **str)
285 PERL_ARGS_ASSERT_SAVE_GENERIC_PVREF;
287 save_pushptrptr(*str, str, SAVEt_GENERIC_PVREF);
290 /* Like save_generic_pvref(), but uses PerlMemShared_free() rather than Safefree().
291 * Can be used to restore a shared global char* to its prior
292 * contents, freeing new value. */
294 Perl_save_shared_pvref(pTHX_ char **str)
296 PERL_ARGS_ASSERT_SAVE_SHARED_PVREF;
298 save_pushptrptr(str, *str, SAVEt_SHARED_PVREF);
301 /* set the SvFLAGS specified by mask to the values in val */
304 Perl_save_set_svflags(pTHX_ SV* sv, U32 mask, U32 val)
308 PERL_ARGS_ASSERT_SAVE_SET_SVFLAGS;
313 SS_ADD_UV(SAVEt_SET_SVFLAGS);
323 Saves the current GP of gv on the save stack to be restored on scope exit.
325 If empty is true, replace the GP with a new GP.
327 If empty is false, mark gv with GVf_INTRO so the next reference
328 assigned is localized, which is how C< local *foo = $someref; > works.
334 Perl_save_gp(pTHX_ GV *gv, I32 empty)
336 PERL_ARGS_ASSERT_SAVE_GP;
338 /* XXX For now, we just upgrade any coderef in the stash to a full GV
339 during localisation. Maybe at some point we could make localis-
340 ation work without needing the upgrade. (In which case our
341 callers should probably call a different function, not save_gp.)
344 assert(isGV_or_RVCV(gv));
345 (void)CvGV(SvRV((SV *)gv)); /* CvGV does the upgrade */
349 save_pushptrptr(SvREFCNT_inc(gv), GvGP(gv), SAVEt_GP);
352 GP *gp = Perl_newGP(aTHX_ gv);
353 HV * const stash = GvSTASH(gv);
354 bool isa_changed = 0;
356 if (stash && HvENAME(stash)) {
357 if (memEQs(GvNAME(gv), GvNAMELEN(gv), "ISA"))
360 /* taking a method out of circulation ("local")*/
361 mro_method_changed_in(stash);
363 if (GvIOp(gv) && (IoFLAGS(GvIOp(gv)) & IOf_ARGV)) {
365 IoFLAGS(gp->gp_io) |= IOf_ARGV|IOf_START;
368 if (isa_changed) mro_isa_changed_in(stash);
377 Perl_save_ary(pTHX_ GV *gv)
379 AV * const oav = GvAVn(gv);
382 PERL_ARGS_ASSERT_SAVE_ARY;
384 if (UNLIKELY(!AvREAL(oav) && AvREIFY(oav)))
386 save_pushptrptr(SvREFCNT_inc_simple_NN(gv), oav, SAVEt_AV);
390 if (UNLIKELY(SvMAGIC(oav)))
391 mg_localize(MUTABLE_SV(oav), MUTABLE_SV(av), TRUE);
396 Perl_save_hash(pTHX_ GV *gv)
400 PERL_ARGS_ASSERT_SAVE_HASH;
403 SvREFCNT_inc_simple_NN(gv), (ohv = GvHVn(gv)), SAVEt_HV
408 if (UNLIKELY(SvMAGIC(ohv)))
409 mg_localize(MUTABLE_SV(ohv), MUTABLE_SV(hv), TRUE);
414 Perl_save_item(pTHX_ SV *item)
416 SV * const sv = newSVsv(item);
418 PERL_ARGS_ASSERT_SAVE_ITEM;
420 save_pushptrptr(item, /* remember the pointer */
421 sv, /* remember the value */
426 Perl_save_bool(pTHX_ bool *boolp)
430 PERL_ARGS_ASSERT_SAVE_BOOL;
433 SS_ADD_UV(SAVEt_BOOL | (*boolp << 8));
438 Perl_save_pushi32ptr(pTHX_ const I32 i, void *const ptr, const int type)
449 Perl_save_int(pTHX_ int *intp)
452 UV type = ((UV)((UV)i << SAVE_TIGHT_SHIFT) | SAVEt_INT_SMALL);
456 PERL_ARGS_ASSERT_SAVE_INT;
458 if (UNLIKELY((int)(type >> SAVE_TIGHT_SHIFT) != i)) {
469 Perl_save_I8(pTHX_ I8 *bytep)
473 PERL_ARGS_ASSERT_SAVE_I8;
476 SS_ADD_UV(SAVEt_I8 | ((UV)*bytep << 8));
481 Perl_save_I16(pTHX_ I16 *intp)
485 PERL_ARGS_ASSERT_SAVE_I16;
488 SS_ADD_UV(SAVEt_I16 | ((UV)*intp << 8));
493 Perl_save_I32(pTHX_ I32 *intp)
496 UV type = ((I32)((U32)i << SAVE_TIGHT_SHIFT) | SAVEt_I32_SMALL);
500 PERL_ARGS_ASSERT_SAVE_I32;
502 if (UNLIKELY((I32)(type >> SAVE_TIGHT_SHIFT) != i)) {
513 Perl_save_strlen(pTHX_ STRLEN *ptr)
517 PERL_ARGS_ASSERT_SAVE_STRLEN;
521 SS_ADD_UV(SAVEt_STRLEN);
526 Perl_save_iv(pTHX_ IV *ivp)
528 PERL_ARGS_ASSERT_SAVE_IV;
536 /* Cannot use save_sptr() to store a char* since the SV** cast will
537 * force word-alignment and we'll miss the pointer.
540 Perl_save_pptr(pTHX_ char **pptr)
542 PERL_ARGS_ASSERT_SAVE_PPTR;
544 save_pushptrptr(*pptr, pptr, SAVEt_PPTR);
548 Perl_save_vptr(pTHX_ void *ptr)
550 PERL_ARGS_ASSERT_SAVE_VPTR;
552 save_pushptrptr(*(char**)ptr, ptr, SAVEt_VPTR);
556 Perl_save_sptr(pTHX_ SV **sptr)
558 PERL_ARGS_ASSERT_SAVE_SPTR;
560 save_pushptrptr(*sptr, sptr, SAVEt_SPTR);
564 Perl_save_padsv_and_mortalize(pTHX_ PADOFFSET off)
568 ASSERT_CURPAD_ACTIVE("save_padsv");
569 SS_ADD_PTR(SvREFCNT_inc_simple_NN(PL_curpad[off]));
570 SS_ADD_PTR(PL_comppad);
572 SS_ADD_UV(SAVEt_PADSV_AND_MORTALIZE);
577 Perl_save_hptr(pTHX_ HV **hptr)
579 PERL_ARGS_ASSERT_SAVE_HPTR;
581 save_pushptrptr(*hptr, hptr, SAVEt_HPTR);
585 Perl_save_aptr(pTHX_ AV **aptr)
587 PERL_ARGS_ASSERT_SAVE_APTR;
589 save_pushptrptr(*aptr, aptr, SAVEt_APTR);
593 Perl_save_pushptr(pTHX_ void *const ptr, const int type)
602 Perl_save_clearsv(pTHX_ SV **svp)
604 const UV offset = svp - PL_curpad;
605 const UV offset_shifted = offset << SAVE_TIGHT_SHIFT;
607 PERL_ARGS_ASSERT_SAVE_CLEARSV;
609 ASSERT_CURPAD_ACTIVE("save_clearsv");
610 SvPADSTALE_off(*svp); /* mark lexical as active */
611 if (UNLIKELY((offset_shifted >> SAVE_TIGHT_SHIFT) != offset)) {
612 Perl_croak(aTHX_ "panic: pad offset %" UVuf " out of range (%p-%p)",
613 offset, svp, PL_curpad);
618 SS_ADD_UV(offset_shifted | SAVEt_CLEARSV);
624 Perl_save_delete(pTHX_ HV *hv, char *key, I32 klen)
626 PERL_ARGS_ASSERT_SAVE_DELETE;
628 save_pushptri32ptr(key, klen, SvREFCNT_inc_simple(hv), SAVEt_DELETE);
632 Perl_save_hdelete(pTHX_ HV *hv, SV *keysv)
638 PERL_ARGS_ASSERT_SAVE_HDELETE;
640 key = SvPV_const(keysv, len);
641 klen = SvUTF8(keysv) ? -(I32)len : (I32)len;
642 SvREFCNT_inc_simple_void_NN(hv);
643 save_pushptri32ptr(savepvn(key, len), klen, hv, SAVEt_DELETE);
647 Perl_save_adelete(pTHX_ AV *av, SSize_t key)
651 PERL_ARGS_ASSERT_SAVE_ADELETE;
653 SvREFCNT_inc_void(av);
656 SS_ADD_IV(SAVEt_ADELETE);
661 Perl_save_destructor(pTHX_ DESTRUCTORFUNC_NOCONTEXT_t f, void* p)
664 PERL_ARGS_ASSERT_SAVE_DESTRUCTOR;
668 SS_ADD_UV(SAVEt_DESTRUCTOR);
673 Perl_save_destructor_x(pTHX_ DESTRUCTORFUNC_t f, void* p)
679 SS_ADD_UV(SAVEt_DESTRUCTOR_X);
684 Perl_save_hints(pTHX)
686 COPHH *save_cophh = cophh_copy(CopHINTHASH_get(&PL_compiling));
687 if (PL_hints & HINT_LOCALIZE_HH) {
688 HV *oldhh = GvHV(PL_hintgv);
689 save_pushptri32ptr(oldhh, PL_hints, save_cophh, SAVEt_HINTS);
690 GvHV(PL_hintgv) = NULL; /* in case copying dies */
691 GvHV(PL_hintgv) = hv_copy_hints_hv(oldhh);
694 save_pushi32ptr(PL_hints, save_cophh, SAVEt_HINTS);
699 S_save_pushptri32ptr(pTHX_ void *const ptr1, const I32 i, void *const ptr2,
711 Perl_save_aelem_flags(pTHX_ AV *av, SSize_t idx, SV **sptr,
717 PERL_ARGS_ASSERT_SAVE_AELEM_FLAGS;
720 SS_ADD_PTR(SvREFCNT_inc_simple(av));
722 SS_ADD_PTR(SvREFCNT_inc(*sptr));
723 SS_ADD_UV(SAVEt_AELEM);
725 /* The array needs to hold a reference count on its new element, so it
727 if (UNLIKELY(!AvREAL(av) && AvREIFY(av)))
729 save_scalar_at(sptr, flags); /* XXX - FIXME - see #60360 */
730 if (flags & SAVEf_KEEPOLDELEM)
733 /* If we're localizing a tied array element, this new sv
734 * won't actually be stored in the array - so it won't get
735 * reaped when the localize ends. Ensure it gets reaped by
736 * mortifying it instead. DAPM */
737 if (UNLIKELY(SvTIED_mg((const SV *)av, PERL_MAGIC_tied)))
742 Perl_save_helem_flags(pTHX_ HV *hv, SV *key, SV **sptr, const U32 flags)
746 PERL_ARGS_ASSERT_SAVE_HELEM_FLAGS;
751 SS_ADD_PTR(SvREFCNT_inc_simple(hv));
752 SS_ADD_PTR(newSVsv(key));
753 SS_ADD_PTR(SvREFCNT_inc(*sptr));
754 SS_ADD_UV(SAVEt_HELEM);
757 save_scalar_at(sptr, flags);
758 if (flags & SAVEf_KEEPOLDELEM)
761 /* If we're localizing a tied hash element, this new sv
762 * won't actually be stored in the hash - so it won't get
763 * reaped when the localize ends. Ensure it gets reaped by
764 * mortifying it instead. DAPM */
765 if (UNLIKELY(SvTIED_mg((const SV *)hv, PERL_MAGIC_tied)))
770 Perl_save_svref(pTHX_ SV **sptr)
772 PERL_ARGS_ASSERT_SAVE_SVREF;
775 save_pushptrptr(sptr, SvREFCNT_inc(*sptr), SAVEt_SVREF);
776 return save_scalar_at(sptr, SAVEf_SETMAGIC); /* XXX - FIXME - see #60360 */
784 SS_ADD_IV(PL_tmps_floor);
785 PL_tmps_floor = PL_tmps_ix;
786 SS_ADD_UV(SAVEt_TMPSFLOOR);
792 Perl_save_alloc(pTHX_ I32 size, I32 pad)
794 const I32 start = pad + ((char*)&PL_savestack[PL_savestack_ix]
795 - (char*)PL_savestack);
796 const UV elems = 1 + ((size + pad - 1) / sizeof(*PL_savestack));
797 const UV elems_shifted = elems << SAVE_TIGHT_SHIFT;
799 if (UNLIKELY((elems_shifted >> SAVE_TIGHT_SHIFT) != elems))
801 "panic: save_alloc elems %" UVuf " out of range (%" IVdf "-%" IVdf ")",
802 elems, (IV)size, (IV)pad);
806 PL_savestack_ix += elems;
807 SSPUSHUV(SAVEt_ALLOC | elems_shifted);
812 static const U8 arg_counts[] = {
814 0, /* SAVEt_CLEARPADRANGE */
815 0, /* SAVEt_CLEARSV */
816 0, /* SAVEt_REGCONTEXT */
817 1, /* SAVEt_TMPSFLOOR */
819 1, /* SAVEt_COMPILE_WARNINGS */
820 1, /* SAVEt_COMPPAD */
821 1, /* SAVEt_FREECOPHH */
822 1, /* SAVEt_FREEOP */
823 1, /* SAVEt_FREEPV */
824 1, /* SAVEt_FREESV */
826 1, /* SAVEt_I32_SMALL */
828 1, /* SAVEt_INT_SMALL */
829 1, /* SAVEt_MORTALIZESV */
832 1, /* SAVEt_PARSER */
833 1, /* SAVEt_STACK_POS */
834 1, /* SAVEt_READONLY_OFF */
835 1, /* SAVEt_FREEPADNAME */
837 2, /* SAVEt_DESTRUCTOR */
838 2, /* SAVEt_DESTRUCTOR_X */
839 2, /* SAVEt_GENERIC_PVREF */
840 2, /* SAVEt_GENERIC_SVREF */
852 2, /* SAVEt_SAVESWITCHSTACK */
853 2, /* SAVEt_SHARED_PVREF */
855 2, /* SAVEt_STRLEN */
859 2, /* SAVEt_ADELETE */
862 3, /* SAVEt_PADSV_AND_MORTALIZE*/
863 3, /* SAVEt_SET_SVFLAGS */
864 3, /* SAVEt_GVSLOT */
871 Perl_leave_scope(pTHX_ I32 base)
873 /* Localise the effects of the TAINT_NOT inside the loop. */
874 bool was = TAINT_get;
876 if (UNLIKELY(base < -1))
877 Perl_croak(aTHX_ "panic: corrupt saved stack index %ld", (long) base);
878 DEBUG_l(Perl_deb(aTHX_ "savestack: releasing items %ld -> %ld\n",
879 (long)PL_savestack_ix, (long)base));
880 while (PL_savestack_ix > base) {
883 ANY *ap; /* arg pointer */
884 ANY a0, a1, a2; /* up to 3 args */
890 I32 ix = PL_savestack_ix - 1;
892 ap = &PL_savestack[ix];
894 type = (U8)uv & SAVE_MASK;
895 argcount = arg_counts[type];
896 PL_savestack_ix = ix - argcount;
901 case SAVEt_ITEM: /* normal string */
902 a0 = ap[0]; a1 = ap[1];
903 sv_replace(a0.any_sv, a1.any_sv);
904 if (UNLIKELY(SvSMAGICAL(a0.any_sv))) {
911 /* This would be a mathom, but Perl_save_svref() calls a static
912 function, S_save_scalar_at(), so has to stay in this file. */
913 case SAVEt_SVREF: /* scalar reference */
914 a0 = ap[0]; a1 = ap[1];
915 a2.any_svp = a0.any_svp;
916 a0.any_sv = NULL; /* what to refcnt_dec */
919 case SAVEt_SV: /* scalar reference */
920 a0 = ap[0]; a1 = ap[1];
921 a2.any_svp = &GvSV(a0.any_gv);
924 /* do *a2.any_svp = a1 and free a0 */
925 SV * const sv = *a2.any_svp;
926 *a2.any_svp = a1.any_sv;
928 if (UNLIKELY(SvSMAGICAL(a1.any_sv))) {
929 /* mg_set could die, skipping the freeing of a0 and
930 * a1; Ensure that they're always freed in that case */
932 SS_ADD_PTR(a1.any_sv);
933 SS_ADD_UV(SAVEt_FREESV);
934 SS_ADD_PTR(a0.any_sv);
935 SS_ADD_UV(SAVEt_FREESV);
942 SvREFCNT_dec_NN(a1.any_sv);
943 SvREFCNT_dec(a0.any_sv);
947 case SAVEt_GENERIC_PVREF: /* generic pv */
948 a0 = ap[0]; a1 = ap[1];
949 if (*a1.any_pvp != a0.any_pv) {
950 Safefree(*a1.any_pvp);
951 *a1.any_pvp = a0.any_pv;
955 case SAVEt_SHARED_PVREF: /* shared pv */
956 a0 = ap[0]; a1 = ap[1];
957 if (*a0.any_pvp != a1.any_pv) {
959 PerlMem_free(*a0.any_pvp);
961 PerlMemShared_free(*a0.any_pvp);
963 *a0.any_pvp = a1.any_pv;
967 case SAVEt_GVSV: /* scalar slot in GV */
968 a0 = ap[0]; a1 = ap[1];
969 a0.any_svp = &GvSV(a0.any_gv);
972 case SAVEt_GENERIC_SVREF: /* generic sv */
973 a0 = ap[0]; a1 = ap[1];
976 /* do *a0.any_svp = a1 */
977 SV * const sv = *a0.any_svp;
978 *a0.any_svp = a1.any_sv;
980 SvREFCNT_dec(a1.any_sv);
984 case SAVEt_GVSLOT: /* any slot in GV */
987 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
988 hv = GvSTASH(a0.any_gv);
989 if (hv && HvENAME(hv) && (
990 (a2.any_sv && SvTYPE(a2.any_sv) == SVt_PVCV)
991 || (*a1.any_svp && SvTYPE(*a1.any_svp) == SVt_PVCV)
994 if ((char *)a1.any_svp < (char *)GvGP(a0.any_gv)
995 || (char *)a1.any_svp > (char *)GvGP(a0.any_gv) + sizeof(struct gp)
996 || GvREFCNT(a0.any_gv) > 2) /* "> 2" to ignore savestack's ref */
998 else mro_method_changed_in(hv);
1000 a0.any_svp = a1.any_svp;
1001 a1.any_sv = a2.any_sv;
1005 case SAVEt_AV: /* array reference */
1006 a0 = ap[0]; a1 = ap[1];
1007 SvREFCNT_dec(GvAV(a0.any_gv));
1008 GvAV(a0.any_gv) = a1.any_av;
1010 if (UNLIKELY(SvSMAGICAL(a1.any_sv))) {
1011 /* mg_set might die, so make sure a0 isn't leaked */
1013 SS_ADD_PTR(a0.any_sv);
1014 SS_ADD_UV(SAVEt_FREESV);
1021 SvREFCNT_dec_NN(a0.any_sv);
1024 case SAVEt_HV: /* hash reference */
1025 a0 = ap[0]; a1 = ap[1];
1026 SvREFCNT_dec(GvHV(a0.any_gv));
1027 GvHV(a0.any_gv) = a1.any_hv;
1030 case SAVEt_INT_SMALL:
1032 *(int*)a0.any_ptr = (int)(uv >> SAVE_TIGHT_SHIFT);
1035 case SAVEt_INT: /* int reference */
1036 a0 = ap[0]; a1 = ap[1];
1037 *(int*)a1.any_ptr = (int)a0.any_i32;
1040 case SAVEt_STRLEN: /* STRLEN/size_t ref */
1041 a0 = ap[0]; a1 = ap[1];
1042 *(STRLEN*)a1.any_ptr = (STRLEN)a0.any_iv;
1045 case SAVEt_TMPSFLOOR: /* restore PL_tmps_floor */
1047 PL_tmps_floor = (SSize_t)a0.any_iv;
1050 case SAVEt_BOOL: /* bool reference */
1052 *(bool*)a0.any_ptr = cBOOL(uv >> 8);
1053 #ifdef NO_TAINT_SUPPORT
1054 PERL_UNUSED_VAR(was);
1056 if (UNLIKELY(a0.any_ptr == &(PL_tainted))) {
1057 /* If we don't update <was>, to reflect what was saved on the
1058 * stack for PL_tainted, then we will overwrite this attempt to
1059 * restore it when we exit this routine. Note that this won't
1060 * work if this value was saved in a wider-than necessary type,
1062 was = *(bool*)a0.any_ptr;
1067 case SAVEt_I32_SMALL:
1069 *(I32*)a0.any_ptr = (I32)(uv >> SAVE_TIGHT_SHIFT);
1072 case SAVEt_I32: /* I32 reference */
1073 a0 = ap[0]; a1 = ap[1];
1074 #ifdef PERL_DEBUG_READONLY_OPS
1075 if (*(I32*)a1.any_ptr != a0.any_i32)
1077 *(I32*)a1.any_ptr = a0.any_i32;
1080 case SAVEt_SPTR: /* SV* reference */
1081 case SAVEt_VPTR: /* random* reference */
1082 case SAVEt_PPTR: /* char* reference */
1083 case SAVEt_HPTR: /* HV* reference */
1084 case SAVEt_APTR: /* AV* reference */
1085 a0 = ap[0]; a1 = ap[1];
1086 *a1.any_svp= a0.any_sv;
1089 case SAVEt_GP: /* scalar reference */
1094 a0 = ap[0]; a1 = ap[1];
1095 /* possibly taking a method out of circulation */
1096 had_method = !!GvCVu(a0.any_gv);
1098 GvGP_set(a0.any_gv, (GP*)a1.any_ptr);
1099 if ((hv=GvSTASH(a0.any_gv)) && HvENAME_get(hv)) {
1100 if (memEQs(GvNAME(a0.any_gv), GvNAMELEN(a0.any_gv), "ISA"))
1101 mro_isa_changed_in(hv);
1102 else if (had_method || GvCVu(a0.any_gv))
1103 /* putting a method back into circulation ("local")*/
1104 gv_method_changed(a0.any_gv);
1106 SvREFCNT_dec_NN(a0.any_gv);
1112 SvREFCNT_dec(a0.any_sv);
1115 case SAVEt_FREEPADNAME:
1117 PadnameREFCNT_dec((PADNAME *)a0.any_ptr);
1120 case SAVEt_FREECOPHH:
1122 cophh_free((COPHH *)a0.any_ptr);
1125 case SAVEt_MORTALIZESV:
1127 sv_2mortal(a0.any_sv);
1132 ASSERT_CURPAD_LEGAL("SAVEt_FREEOP");
1138 Safefree(a0.any_ptr);
1141 case SAVEt_CLEARPADRANGE:
1145 i = (I32)((uv >> SAVE_TIGHT_SHIFT) & OPpPADRANGE_COUNTMASK);
1146 svp = &PL_curpad[uv >>
1147 (OPpPADRANGE_COUNTSHIFT + SAVE_TIGHT_SHIFT)] + i - 1;
1150 svp = &PL_curpad[uv >> SAVE_TIGHT_SHIFT];
1153 for (; i; i--, svp--) {
1156 DEBUG_Xv(PerlIO_printf(Perl_debug_log,
1157 "Pad 0x%" UVxf "[0x%" UVxf "] clearsv: %ld sv=0x%" UVxf "<%" IVdf "> %s\n",
1158 PTR2UV(PL_comppad), PTR2UV(PL_curpad),
1159 (long)(svp-PL_curpad), PTR2UV(sv), (IV)SvREFCNT(sv),
1160 (SvREFCNT(sv) <= 1 && !SvOBJECT(sv)) ? "clear" : "abandon"
1163 /* Can clear pad variable in place? */
1164 if (SvREFCNT(sv) == 1 && !SvOBJECT(sv)) {
1166 /* these flags are the union of all the relevant flags
1167 * in the individual conditions within */
1168 if (UNLIKELY(SvFLAGS(sv) & (
1169 SVf_READONLY|SVf_PROTECT /*for SvREADONLY_off*/
1170 | (SVs_GMG|SVs_SMG|SVs_RMG) /* SvMAGICAL() */
1174 /* if a my variable that was made readonly is
1175 * going out of scope, we want to remove the
1176 * readonlyness so that it can go out of scope
1182 if (SvOOK(sv)) { /* OOK or HvAUX */
1183 if (SvTYPE(sv) == SVt_PVHV)
1184 Perl_hv_kill_backrefs(aTHX_ MUTABLE_HV(sv));
1189 if (SvMAGICAL(sv)) {
1190 /* note that backrefs (either in HvAUX or magic)
1191 * must be removed before other magic */
1192 sv_unmagic(sv, PERL_MAGIC_backref);
1193 if (SvTYPE(sv) != SVt_PVCV)
1196 if (SvTHINKFIRST(sv))
1197 sv_force_normal_flags(sv, SV_IMMEDIATE_UNREF
1201 switch (SvTYPE(sv)) {
1205 av_clear(MUTABLE_AV(sv));
1208 hv_clear(MUTABLE_HV(sv));
1212 HEK *hek = CvGvNAME_HEK(sv);
1214 (void)share_hek_hek(hek);
1216 CvNAME_HEK_set(sv, hek);
1221 /* This looks odd, but these two macros are for use in
1222 expressions and finish with a trailing comma, so
1223 adding a ; after them would be wrong. */
1226 SvFLAGS(sv) &=~ (SVf_OK|SVf_IVisUV|SVf_UTF8);
1230 SvPADSTALE_on(sv); /* mark as no longer live */
1232 else { /* Someone has a claim on this, so abandon it. */
1233 switch (SvTYPE(sv)) { /* Console ourselves with a new value */
1234 case SVt_PVAV: *svp = MUTABLE_SV(newAV()); break;
1235 case SVt_PVHV: *svp = MUTABLE_SV(newHV()); break;
1238 HEK * const hek = CvGvNAME_HEK(sv);
1241 *svp = newSV_type(SVt_PVCV);
1244 CvNAME_HEK_set(*svp,
1245 share_hek_hek(hek));
1249 default: *svp = newSV(0); break;
1251 SvREFCNT_dec_NN(sv); /* Cast current value to the winds. */
1252 /* preserve pad nature, but also mark as not live
1253 * for any closure capturing */
1254 SvFLAGS(*svp) |= SVs_PADSTALE;
1261 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
1262 /* hv_delete could die, so free the key and SvREFCNT_dec the
1263 * hv by pushing new save actions
1265 /* ap[0] is the key */
1266 ap[1].any_uv = SAVEt_FREEPV; /* was len */
1267 /* ap[2] is the hv */
1268 ap[3].any_uv = SAVEt_FREESV; /* was SAVEt_DELETE */
1269 PL_savestack_ix += 4;
1270 (void)hv_delete(a2.any_hv, a0.any_pv, a1.any_i32, G_DISCARD);
1274 a0 = ap[0]; a1 = ap[1];
1275 /* av_delete could die, so SvREFCNT_dec the av by pushing a
1278 ap[0].any_av = a1.any_av;
1279 ap[1].any_uv = SAVEt_FREESV;
1280 PL_savestack_ix += 2;
1281 (void)av_delete(a1.any_av, a0.any_iv, G_DISCARD);
1284 case SAVEt_DESTRUCTOR_X:
1285 a0 = ap[0]; a1 = ap[1];
1286 (*a0.any_dxptr)(aTHX_ a1.any_ptr);
1289 case SAVEt_REGCONTEXT:
1290 /* regexp must have croaked */
1292 PL_savestack_ix -= uv >> SAVE_TIGHT_SHIFT;
1295 case SAVEt_STACK_POS: /* Position on Perl stack */
1297 PL_stack_sp = PL_stack_base + a0.any_i32;
1300 case SAVEt_AELEM: /* array element */
1303 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
1304 svp = av_fetch(a0.any_av, a1.any_iv, 1);
1305 if (UNLIKELY(!AvREAL(a0.any_av) && AvREIFY(a0.any_av))) /* undo reify guard */
1306 SvREFCNT_dec(a2.any_sv);
1308 SV * const sv = *svp;
1309 if (LIKELY(sv && sv != &PL_sv_undef)) {
1310 if (UNLIKELY(SvTIED_mg((const SV *)a0.any_av, PERL_MAGIC_tied)))
1311 SvREFCNT_inc_void_NN(sv);
1312 a1.any_sv = a2.any_sv;
1317 SvREFCNT_dec(a0.any_av);
1318 SvREFCNT_dec(a2.any_sv);
1322 case SAVEt_HELEM: /* hash element */
1326 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
1327 he = hv_fetch_ent(a0.any_hv, a1.any_sv, 1, 0);
1328 SvREFCNT_dec(a1.any_sv);
1330 const SV * const oval = HeVAL(he);
1331 if (LIKELY(oval && oval != &PL_sv_undef)) {
1332 SV **svp = &HeVAL(he);
1333 if (UNLIKELY(SvTIED_mg((const SV *)a0.any_hv, PERL_MAGIC_tied)))
1334 SvREFCNT_inc_void(*svp);
1335 a1.any_sv = a2.any_sv;
1340 SvREFCNT_dec(a0.any_hv);
1341 SvREFCNT_dec(a2.any_sv);
1347 PL_op = (OP*)a0.any_ptr;
1351 a0 = ap[0]; a1 = ap[1];
1352 if ((PL_hints & HINT_LOCALIZE_HH)) {
1353 while (GvHV(PL_hintgv)) {
1354 HV *hv = GvHV(PL_hintgv);
1355 GvHV(PL_hintgv) = NULL;
1356 SvREFCNT_dec(MUTABLE_SV(hv));
1359 cophh_free(CopHINTHASH_get(&PL_compiling));
1360 CopHINTHASH_set(&PL_compiling, (COPHH*)a1.any_ptr);
1361 *(I32*)&PL_hints = a0.any_i32;
1362 if (PL_hints & HINT_LOCALIZE_HH) {
1363 SvREFCNT_dec(MUTABLE_SV(GvHV(PL_hintgv)));
1364 GvHV(PL_hintgv) = MUTABLE_HV(SSPOPPTR);
1366 if (!GvHV(PL_hintgv)) {
1367 /* Need to add a new one manually, else rv2hv can
1368 add one via GvHVn and it won't have the magic set. */
1369 HV *const hv = newHV();
1370 hv_magic(hv, NULL, PERL_MAGIC_hints);
1371 GvHV(PL_hintgv) = hv;
1373 assert(GvHV(PL_hintgv));
1378 PL_comppad = (PAD*)a0.any_ptr;
1379 if (LIKELY(PL_comppad))
1380 PL_curpad = AvARRAY(PL_comppad);
1385 case SAVEt_PADSV_AND_MORTALIZE:
1389 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
1390 assert (a1.any_ptr);
1391 svp = AvARRAY((PAD*)a1.any_ptr) + (PADOFFSET)a2.any_uv;
1392 /* This mortalizing used to be done by CX_POOPLOOP() via
1393 itersave. But as we have all the information here, we
1394 can do it here, save even having to have itersave in
1402 case SAVEt_SAVESWITCHSTACK:
1406 a0 = ap[0]; a1 = ap[1];
1407 SWITCHSTACK(a1.any_av, a0.any_av);
1408 PL_curstackinfo->si_stack = a0.any_av;
1412 case SAVEt_SET_SVFLAGS:
1413 a0 = ap[0]; a1 = ap[1]; a2 = ap[2];
1414 SvFLAGS(a0.any_sv) &= ~(a1.any_u32);
1415 SvFLAGS(a0.any_sv) |= a2.any_u32;
1418 /* These are only saved in mathoms.c */
1421 (void)sv_clear(a0.any_sv);
1424 case SAVEt_LONG: /* long reference */
1425 a0 = ap[0]; a1 = ap[1];
1426 *(long*)a1.any_ptr = a0.any_long;
1429 case SAVEt_IV: /* IV reference */
1430 a0 = ap[0]; a1 = ap[1];
1431 *(IV*)a1.any_ptr = a0.any_iv;
1434 case SAVEt_I16: /* I16 reference */
1436 *(I16*)a0.any_ptr = (I16)(uv >> 8);
1439 case SAVEt_I8: /* I8 reference */
1441 *(I8*)a0.any_ptr = (I8)(uv >> 8);
1444 case SAVEt_DESTRUCTOR:
1445 a0 = ap[0]; a1 = ap[1];
1446 (*a0.any_dptr)(a1.any_ptr);
1449 case SAVEt_COMPILE_WARNINGS:
1451 free_and_set_cop_warnings(&PL_compiling, (STRLEN*) a0.any_ptr);
1456 parser_free((yy_parser *)a0.any_ptr);
1459 case SAVEt_READONLY_OFF:
1461 SvREADONLY_off(a0.any_sv);
1465 Perl_croak(aTHX_ "panic: leave_scope inconsistency %u",
1466 (U8)uv & SAVE_MASK);
1474 Perl_cx_dump(pTHX_ PERL_CONTEXT *cx)
1476 PERL_ARGS_ASSERT_CX_DUMP;
1479 PerlIO_printf(Perl_debug_log, "CX %ld = %s\n", (long)(cx - cxstack), PL_block_type[CxTYPE(cx)]);
1480 if (CxTYPE(cx) != CXt_SUBST) {
1481 const char *gimme_text;
1482 PerlIO_printf(Perl_debug_log, "BLK_OLDSP = %ld\n", (long)cx->blk_oldsp);
1483 PerlIO_printf(Perl_debug_log, "BLK_OLDCOP = 0x%" UVxf "\n",
1484 PTR2UV(cx->blk_oldcop));
1485 PerlIO_printf(Perl_debug_log, "BLK_OLDMARKSP = %ld\n", (long)cx->blk_oldmarksp);
1486 PerlIO_printf(Perl_debug_log, "BLK_OLDSCOPESP = %ld\n", (long)cx->blk_oldscopesp);
1487 PerlIO_printf(Perl_debug_log, "BLK_OLDSAVEIX = %ld\n", (long)cx->blk_oldsaveix);
1488 PerlIO_printf(Perl_debug_log, "BLK_OLDPM = 0x%" UVxf "\n",
1489 PTR2UV(cx->blk_oldpm));
1490 switch (cx->blk_gimme) {
1492 gimme_text = "VOID";
1495 gimme_text = "SCALAR";
1498 gimme_text = "LIST";
1501 gimme_text = "UNKNOWN";
1504 PerlIO_printf(Perl_debug_log, "BLK_GIMME = %s\n", gimme_text);
1506 switch (CxTYPE(cx)) {
1511 PerlIO_printf(Perl_debug_log, "BLK_FORMAT.CV = 0x%" UVxf "\n",
1512 PTR2UV(cx->blk_format.cv));
1513 PerlIO_printf(Perl_debug_log, "BLK_FORMAT.GV = 0x%" UVxf "\n",
1514 PTR2UV(cx->blk_format.gv));
1515 PerlIO_printf(Perl_debug_log, "BLK_FORMAT.DFOUTGV = 0x%" UVxf "\n",
1516 PTR2UV(cx->blk_format.dfoutgv));
1517 PerlIO_printf(Perl_debug_log, "BLK_FORMAT.HASARGS = %d\n",
1518 (int)CxHASARGS(cx));
1519 PerlIO_printf(Perl_debug_log, "BLK_FORMAT.RETOP = 0x%" UVxf "\n",
1520 PTR2UV(cx->blk_format.retop));
1523 PerlIO_printf(Perl_debug_log, "BLK_SUB.CV = 0x%" UVxf "\n",
1524 PTR2UV(cx->blk_sub.cv));
1525 PerlIO_printf(Perl_debug_log, "BLK_SUB.OLDDEPTH = %ld\n",
1526 (long)cx->blk_sub.olddepth);
1527 PerlIO_printf(Perl_debug_log, "BLK_SUB.HASARGS = %d\n",
1528 (int)CxHASARGS(cx));
1529 PerlIO_printf(Perl_debug_log, "BLK_SUB.LVAL = %d\n", (int)CxLVAL(cx));
1530 PerlIO_printf(Perl_debug_log, "BLK_SUB.RETOP = 0x%" UVxf "\n",
1531 PTR2UV(cx->blk_sub.retop));
1534 PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_IN_EVAL = %ld\n",
1535 (long)CxOLD_IN_EVAL(cx));
1536 PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_OP_TYPE = %s (%s)\n",
1537 PL_op_name[CxOLD_OP_TYPE(cx)],
1538 PL_op_desc[CxOLD_OP_TYPE(cx)]);
1539 if (cx->blk_eval.old_namesv)
1540 PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_NAME = %s\n",
1541 SvPVX_const(cx->blk_eval.old_namesv));
1542 PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_EVAL_ROOT = 0x%" UVxf "\n",
1543 PTR2UV(cx->blk_eval.old_eval_root));
1544 PerlIO_printf(Perl_debug_log, "BLK_EVAL.RETOP = 0x%" UVxf "\n",
1545 PTR2UV(cx->blk_eval.retop));
1548 case CXt_LOOP_PLAIN:
1549 case CXt_LOOP_LAZYIV:
1550 case CXt_LOOP_LAZYSV:
1553 PerlIO_printf(Perl_debug_log, "BLK_LOOP.LABEL = %s\n", CxLABEL(cx));
1554 PerlIO_printf(Perl_debug_log, "BLK_LOOP.MY_OP = 0x%" UVxf "\n",
1555 PTR2UV(cx->blk_loop.my_op));
1556 if (CxTYPE(cx) != CXt_LOOP_PLAIN) {
1557 PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERVAR = 0x%" UVxf "\n",
1558 PTR2UV(CxITERVAR(cx)));
1559 PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERSAVE = 0x%" UVxf "\n",
1560 PTR2UV(cx->blk_loop.itersave));
1562 if (CxTYPE(cx) == CXt_LOOP_ARY) {
1563 PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERARY = 0x%" UVxf "\n",
1564 PTR2UV(cx->blk_loop.state_u.ary.ary));
1565 PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERIX = %ld\n",
1566 (long)cx->blk_loop.state_u.ary.ix);
1571 PerlIO_printf(Perl_debug_log, "SB_ITERS = %ld\n",
1572 (long)cx->sb_iters);
1573 PerlIO_printf(Perl_debug_log, "SB_MAXITERS = %ld\n",
1574 (long)cx->sb_maxiters);
1575 PerlIO_printf(Perl_debug_log, "SB_RFLAGS = %ld\n",
1576 (long)cx->sb_rflags);
1577 PerlIO_printf(Perl_debug_log, "SB_ONCE = %ld\n",
1579 PerlIO_printf(Perl_debug_log, "SB_ORIG = %s\n",
1581 PerlIO_printf(Perl_debug_log, "SB_DSTR = 0x%" UVxf "\n",
1582 PTR2UV(cx->sb_dstr));
1583 PerlIO_printf(Perl_debug_log, "SB_TARG = 0x%" UVxf "\n",
1584 PTR2UV(cx->sb_targ));
1585 PerlIO_printf(Perl_debug_log, "SB_S = 0x%" UVxf "\n",
1587 PerlIO_printf(Perl_debug_log, "SB_M = 0x%" UVxf "\n",
1589 PerlIO_printf(Perl_debug_log, "SB_STREND = 0x%" UVxf "\n",
1590 PTR2UV(cx->sb_strend));
1591 PerlIO_printf(Perl_debug_log, "SB_RXRES = 0x%" UVxf "\n",
1592 PTR2UV(cx->sb_rxres));
1596 PERL_UNUSED_CONTEXT;
1597 PERL_UNUSED_ARG(cx);
1598 #endif /* DEBUGGING */
1602 * ex: set ts=8 sts=4 sw=4 et: