This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add IO::Zlib in maintainers list
[perl5.git] / scope.c
1 /*    scope.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4  *    2000, 2001, 2002, 2003, 2004, 2005, by Larry Wall and others
5  *
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.
8  *
9  */
10
11 /*
12  * "For the fashion of Minas Tirith was such that it was built on seven
13  * levels..."
14  */
15
16 /* This file contains functions to manipulate several of Perl's stacks;
17  * in particular it contains code to push various types of things onto
18  * the savestack, then to pop them off and perform the correct restorative
19  * action for each one. This corresponds to the cleanup Perl does at
20  * each scope exit.
21  */
22
23 #include "EXTERN.h"
24 #define PERL_IN_SCOPE_C
25 #include "perl.h"
26
27 SV**
28 Perl_stack_grow(pTHX_ SV **sp, SV **p, int n)
29 {
30     PL_stack_sp = sp;
31 #ifndef STRESS_REALLOC
32     av_extend(PL_curstack, (p - PL_stack_base) + (n) + 128);
33 #else
34     av_extend(PL_curstack, (p - PL_stack_base) + (n) + 1);
35 #endif
36     return PL_stack_sp;
37 }
38
39 #ifndef STRESS_REALLOC
40 #define GROW(old) ((old) * 3 / 2)
41 #else
42 #define GROW(old) ((old) + 1)
43 #endif
44
45 PERL_SI *
46 Perl_new_stackinfo(pTHX_ I32 stitems, I32 cxitems)
47 {
48     PERL_SI *si;
49     New(56, si, 1, PERL_SI);
50     si->si_stack = newAV();
51     AvREAL_off(si->si_stack);
52     av_extend(si->si_stack, stitems > 0 ? stitems-1 : 0);
53     AvALLOC(si->si_stack)[0] = &PL_sv_undef;
54     AvFILLp(si->si_stack) = 0;
55     si->si_prev = 0;
56     si->si_next = 0;
57     si->si_cxmax = cxitems - 1;
58     si->si_cxix = -1;
59     si->si_type = PERLSI_UNDEF;
60     New(56, si->si_cxstack, cxitems, PERL_CONTEXT);
61     /* Without any kind of initialising PUSHSUBST()
62      * in pp_subst() will read uninitialised heap. */
63     Poison(si->si_cxstack, cxitems, PERL_CONTEXT);
64     return si;
65 }
66
67 I32
68 Perl_cxinc(pTHX)
69 {
70     const IV old_max = cxstack_max;
71     cxstack_max = GROW(cxstack_max);
72     Renew(cxstack, cxstack_max + 1, PERL_CONTEXT);      /* XXX should fix CXINC macro */
73     /* Without any kind of initialising deep enough recursion
74      * will end up reading uninitialised PERL_CONTEXTs. */
75     Poison(cxstack + old_max + 1, cxstack_max - old_max, PERL_CONTEXT);
76     return cxstack_ix + 1;
77 }
78
79 void
80 Perl_push_scope(pTHX)
81 {
82     if (PL_scopestack_ix == PL_scopestack_max) {
83         PL_scopestack_max = GROW(PL_scopestack_max);
84         Renew(PL_scopestack, PL_scopestack_max, I32);
85     }
86     PL_scopestack[PL_scopestack_ix++] = PL_savestack_ix;
87
88 }
89
90 void
91 Perl_pop_scope(pTHX)
92 {
93     const I32 oldsave = PL_scopestack[--PL_scopestack_ix];
94     LEAVE_SCOPE(oldsave);
95 }
96
97 void
98 Perl_markstack_grow(pTHX)
99 {
100     const I32 oldmax = PL_markstack_max - PL_markstack;
101     const I32 newmax = GROW(oldmax);
102
103     Renew(PL_markstack, newmax, I32);
104     PL_markstack_ptr = PL_markstack + oldmax;
105     PL_markstack_max = PL_markstack + newmax;
106 }
107
108 void
109 Perl_savestack_grow(pTHX)
110 {
111     PL_savestack_max = GROW(PL_savestack_max) + 4;
112     Renew(PL_savestack, PL_savestack_max, ANY);
113 }
114
115 void
116 Perl_savestack_grow_cnt(pTHX_ I32 need)
117 {
118     PL_savestack_max = PL_savestack_ix + need;
119     Renew(PL_savestack, PL_savestack_max, ANY);
120 }
121
122 #undef GROW
123
124 void
125 Perl_tmps_grow(pTHX_ I32 n)
126 {
127 #ifndef STRESS_REALLOC
128     if (n < 128)
129         n = (PL_tmps_max < 512) ? 128 : 512;
130 #endif
131     PL_tmps_max = PL_tmps_ix + n + 1;
132     Renew(PL_tmps_stack, PL_tmps_max, SV*);
133 }
134
135
136 void
137 Perl_free_tmps(pTHX)
138 {
139     /* XXX should tmps_floor live in cxstack? */
140     const I32 myfloor = PL_tmps_floor;
141     while (PL_tmps_ix > myfloor) {      /* clean up after last statement */
142         SV* sv = PL_tmps_stack[PL_tmps_ix];
143         PL_tmps_stack[PL_tmps_ix--] = Nullsv;
144         if (sv && sv != &PL_sv_undef) {
145             SvTEMP_off(sv);
146             SvREFCNT_dec(sv);           /* note, can modify tmps_ix!!! */
147         }
148     }
149 }
150
151 STATIC SV *
152 S_save_scalar_at(pTHX_ SV **sptr)
153 {
154     register SV *sv;
155     SV *osv = *sptr;
156
157     sv = *sptr = NEWSV(0,0);
158     if (SvTYPE(osv) >= SVt_PVMG && SvMAGIC(osv) && SvTYPE(osv) != SVt_PVGV) {
159         MAGIC *mg;
160         sv_upgrade(sv, SvTYPE(osv));
161         if (SvGMAGICAL(osv)) {
162             const bool oldtainted = PL_tainted;
163             mg_get(osv);                /* note, can croak! */
164             if (PL_tainting && PL_tainted &&
165                         (mg = mg_find(osv, PERL_MAGIC_taint))) {
166                 SAVESPTR(mg->mg_obj);
167                 mg->mg_obj = osv;
168             }
169             SvFLAGS(osv) |= (SvFLAGS(osv) &
170                (SVp_NOK|SVp_POK)) >> PRIVSHIFT;
171             PL_tainted = oldtainted;
172         }
173         SvMAGIC_set(sv, SvMAGIC(osv));
174         /* if it's a special scalar or if it has no 'set' magic,
175          * propagate the SvREADONLY flag. --rgs 20030922 */
176         for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
177             if (mg->mg_type == '\0'
178                     || !(mg->mg_virtual && mg->mg_virtual->svt_set))
179             {
180                 SvFLAGS(sv) |= SvREADONLY(osv);
181                 break;
182             }
183         }
184         SvFLAGS(sv) |= SvMAGICAL(osv);
185         /* XXX SvMAGIC() is *shared* between osv and sv.  This can
186          * lead to coredumps when both SVs are destroyed without one
187          * of their SvMAGIC() slots being NULLed. */
188         PL_localizing = 1;
189         SvSETMAGIC(sv);
190         PL_localizing = 0;
191     }
192     return sv;
193 }
194
195 SV *
196 Perl_save_scalar(pTHX_ GV *gv)
197 {
198     SV **sptr = &GvSV(gv);
199     SSCHECK(3);
200     SSPUSHPTR(SvREFCNT_inc(gv));
201     SSPUSHPTR(SvREFCNT_inc(*sptr));
202     SSPUSHINT(SAVEt_SV);
203     return save_scalar_at(sptr);
204 }
205
206 SV*
207 Perl_save_svref(pTHX_ SV **sptr)
208 {
209     SSCHECK(3);
210     SSPUSHPTR(sptr);
211     SSPUSHPTR(SvREFCNT_inc(*sptr));
212     SSPUSHINT(SAVEt_SVREF);
213     return save_scalar_at(sptr);
214 }
215
216 /* Like save_sptr(), but also SvREFCNT_dec()s the new value.  Can be used to
217  * restore a global SV to its prior contents, freeing new value. */
218 void
219 Perl_save_generic_svref(pTHX_ SV **sptr)
220 {
221     SSCHECK(3);
222     SSPUSHPTR(sptr);
223     SSPUSHPTR(SvREFCNT_inc(*sptr));
224     SSPUSHINT(SAVEt_GENERIC_SVREF);
225 }
226
227 /* Like save_pptr(), but also Safefree()s the new value if it is different
228  * from the old one.  Can be used to restore a global char* to its prior
229  * contents, freeing new value. */
230 void
231 Perl_save_generic_pvref(pTHX_ char **str)
232 {
233     SSCHECK(3);
234     SSPUSHPTR(str);
235     SSPUSHPTR(*str);
236     SSPUSHINT(SAVEt_GENERIC_PVREF);
237 }
238
239 /* Like save_generic_pvref(), but uses PerlMemShared_free() rather than Safefree().
240  * Can be used to restore a shared global char* to its prior
241  * contents, freeing new value. */
242 void
243 Perl_save_shared_pvref(pTHX_ char **str)
244 {
245     SSCHECK(3);
246     SSPUSHPTR(str);
247     SSPUSHPTR(*str);
248     SSPUSHINT(SAVEt_SHARED_PVREF);
249 }
250
251 /* set the SvFLAGS specified by mask to the values in val */
252
253 void
254 Perl_save_set_svflags(pTHX_ SV* sv, U32 mask, U32 val)
255 {
256     SSCHECK(4);
257     SSPUSHPTR(sv);
258     SSPUSHINT(mask);
259     SSPUSHINT(val);
260     SSPUSHINT(SAVEt_SET_SVFLAGS);
261 }
262
263 void
264 Perl_save_gp(pTHX_ GV *gv, I32 empty)
265 {
266     SSGROW(6);
267     SSPUSHIV((IV)SvLEN(gv));
268     SvLEN_set(gv, 0); /* forget that anything was allocated here */
269     SSPUSHIV((IV)SvCUR(gv));
270     SSPUSHPTR(SvPVX_const(gv));
271     SvPOK_off(gv);
272     SSPUSHPTR(SvREFCNT_inc(gv));
273     SSPUSHPTR(GvGP(gv));
274     SSPUSHINT(SAVEt_GP);
275
276     if (empty) {
277         register GP *gp;
278
279         Newz(602, gp, 1, GP);
280
281         if (GvCVu(gv))
282             PL_sub_generation++;        /* taking a method out of circulation */
283         if (GvIOp(gv) && (IoFLAGS(GvIOp(gv)) & IOf_ARGV)) {
284             gp->gp_io = newIO();
285             IoFLAGS(gp->gp_io) |= IOf_ARGV|IOf_START;
286         }
287         GvGP(gv) = gp_ref(gp);
288         GvSV(gv) = NEWSV(72,0);
289         GvLINE(gv) = CopLINE(PL_curcop);
290         /* XXX Ideally this cast would be replaced with a change to const char*
291            in the struct.  */
292         GvFILE(gv) = CopFILE(PL_curcop) ? CopFILE(PL_curcop) : (char *) "";
293         GvEGV(gv) = gv;
294     }
295     else {
296         gp_ref(GvGP(gv));
297         GvINTRO_on(gv);
298     }
299 }
300
301 AV *
302 Perl_save_ary(pTHX_ GV *gv)
303 {
304     AV *oav = GvAVn(gv);
305     AV *av;
306
307     if (!AvREAL(oav) && AvREIFY(oav))
308         av_reify(oav);
309     SSCHECK(3);
310     SSPUSHPTR(gv);
311     SSPUSHPTR(oav);
312     SSPUSHINT(SAVEt_AV);
313
314     GvAV(gv) = Null(AV*);
315     av = GvAVn(gv);
316     if (SvMAGIC(oav)) {
317         SvMAGIC_set(av, SvMAGIC(oav));
318         SvFLAGS((SV*)av) |= SvMAGICAL(oav);
319         SvMAGICAL_off(oav);
320         SvMAGIC_set(oav, NULL);
321         PL_localizing = 1;
322         SvSETMAGIC((SV*)av);
323         PL_localizing = 0;
324     }
325     return av;
326 }
327
328 HV *
329 Perl_save_hash(pTHX_ GV *gv)
330 {
331     HV *ohv, *hv;
332
333     SSCHECK(3);
334     SSPUSHPTR(gv);
335     SSPUSHPTR(ohv = GvHVn(gv));
336     SSPUSHINT(SAVEt_HV);
337
338     GvHV(gv) = Null(HV*);
339     hv = GvHVn(gv);
340     if (SvMAGIC(ohv)) {
341         SvMAGIC_set(hv, SvMAGIC(ohv));
342         SvFLAGS((SV*)hv) |= SvMAGICAL(ohv);
343         SvMAGICAL_off(ohv);
344         SvMAGIC_set(ohv, NULL);
345         PL_localizing = 1;
346         SvSETMAGIC((SV*)hv);
347         PL_localizing = 0;
348     }
349     return hv;
350 }
351
352 void
353 Perl_save_item(pTHX_ register SV *item)
354 {
355     register SV *sv = newSVsv(item);
356
357     SSCHECK(3);
358     SSPUSHPTR(item);            /* remember the pointer */
359     SSPUSHPTR(sv);              /* remember the value */
360     SSPUSHINT(SAVEt_ITEM);
361 }
362
363 void
364 Perl_save_int(pTHX_ int *intp)
365 {
366     SSCHECK(3);
367     SSPUSHINT(*intp);
368     SSPUSHPTR(intp);
369     SSPUSHINT(SAVEt_INT);
370 }
371
372 void
373 Perl_save_long(pTHX_ long int *longp)
374 {
375     SSCHECK(3);
376     SSPUSHLONG(*longp);
377     SSPUSHPTR(longp);
378     SSPUSHINT(SAVEt_LONG);
379 }
380
381 void
382 Perl_save_bool(pTHX_ bool *boolp)
383 {
384     SSCHECK(3);
385     SSPUSHBOOL(*boolp);
386     SSPUSHPTR(boolp);
387     SSPUSHINT(SAVEt_BOOL);
388 }
389
390 void
391 Perl_save_I32(pTHX_ I32 *intp)
392 {
393     SSCHECK(3);
394     SSPUSHINT(*intp);
395     SSPUSHPTR(intp);
396     SSPUSHINT(SAVEt_I32);
397 }
398
399 void
400 Perl_save_I16(pTHX_ I16 *intp)
401 {
402     SSCHECK(3);
403     SSPUSHINT(*intp);
404     SSPUSHPTR(intp);
405     SSPUSHINT(SAVEt_I16);
406 }
407
408 void
409 Perl_save_I8(pTHX_ I8 *bytep)
410 {
411     SSCHECK(3);
412     SSPUSHINT(*bytep);
413     SSPUSHPTR(bytep);
414     SSPUSHINT(SAVEt_I8);
415 }
416
417 void
418 Perl_save_iv(pTHX_ IV *ivp)
419 {
420     SSCHECK(3);
421     SSPUSHIV(*ivp);
422     SSPUSHPTR(ivp);
423     SSPUSHINT(SAVEt_IV);
424 }
425
426 /* Cannot use save_sptr() to store a char* since the SV** cast will
427  * force word-alignment and we'll miss the pointer.
428  */
429 void
430 Perl_save_pptr(pTHX_ char **pptr)
431 {
432     SSCHECK(3);
433     SSPUSHPTR(*pptr);
434     SSPUSHPTR(pptr);
435     SSPUSHINT(SAVEt_PPTR);
436 }
437
438 void
439 Perl_save_vptr(pTHX_ void *ptr)
440 {
441     SSCHECK(3);
442     SSPUSHPTR(*(char**)ptr);
443     SSPUSHPTR(ptr);
444     SSPUSHINT(SAVEt_VPTR);
445 }
446
447 void
448 Perl_save_sptr(pTHX_ SV **sptr)
449 {
450     SSCHECK(3);
451     SSPUSHPTR(*sptr);
452     SSPUSHPTR(sptr);
453     SSPUSHINT(SAVEt_SPTR);
454 }
455
456 void
457 Perl_save_padsv(pTHX_ PADOFFSET off)
458 {
459     SSCHECK(4);
460     ASSERT_CURPAD_ACTIVE("save_padsv");
461     SSPUSHPTR(PL_curpad[off]);
462     SSPUSHPTR(PL_comppad);
463     SSPUSHLONG((long)off);
464     SSPUSHINT(SAVEt_PADSV);
465 }
466
467 SV **
468 Perl_save_threadsv(pTHX_ PADOFFSET i)
469 {
470     Perl_croak(aTHX_ "panic: save_threadsv called in non-threaded perl");
471     (void)i;
472     NORETURN_FUNCTION_END;
473 }
474
475 void
476 Perl_save_nogv(pTHX_ GV *gv)
477 {
478     SSCHECK(2);
479     SSPUSHPTR(gv);
480     SSPUSHINT(SAVEt_NSTAB);
481 }
482
483 void
484 Perl_save_hptr(pTHX_ HV **hptr)
485 {
486     SSCHECK(3);
487     SSPUSHPTR(*hptr);
488     SSPUSHPTR(hptr);
489     SSPUSHINT(SAVEt_HPTR);
490 }
491
492 void
493 Perl_save_aptr(pTHX_ AV **aptr)
494 {
495     SSCHECK(3);
496     SSPUSHPTR(*aptr);
497     SSPUSHPTR(aptr);
498     SSPUSHINT(SAVEt_APTR);
499 }
500
501 void
502 Perl_save_freesv(pTHX_ SV *sv)
503 {
504     SSCHECK(2);
505     SSPUSHPTR(sv);
506     SSPUSHINT(SAVEt_FREESV);
507 }
508
509 void
510 Perl_save_mortalizesv(pTHX_ SV *sv)
511 {
512     SSCHECK(2);
513     SSPUSHPTR(sv);
514     SSPUSHINT(SAVEt_MORTALIZESV);
515 }
516
517 void
518 Perl_save_freeop(pTHX_ OP *o)
519 {
520     SSCHECK(2);
521     SSPUSHPTR(o);
522     SSPUSHINT(SAVEt_FREEOP);
523 }
524
525 void
526 Perl_save_freepv(pTHX_ char *pv)
527 {
528     SSCHECK(2);
529     SSPUSHPTR(pv);
530     SSPUSHINT(SAVEt_FREEPV);
531 }
532
533 void
534 Perl_save_clearsv(pTHX_ SV **svp)
535 {
536     ASSERT_CURPAD_ACTIVE("save_clearsv");
537     SSCHECK(2);
538     SSPUSHLONG((long)(svp-PL_curpad));
539     SSPUSHINT(SAVEt_CLEARSV);
540     SvPADSTALE_off(*svp); /* mark lexical as active */
541 }
542
543 void
544 Perl_save_delete(pTHX_ HV *hv, char *key, I32 klen)
545 {
546     SSCHECK(4);
547     SSPUSHINT(klen);
548     SSPUSHPTR(key);
549     SSPUSHPTR(SvREFCNT_inc(hv));
550     SSPUSHINT(SAVEt_DELETE);
551 }
552
553 void
554 Perl_save_list(pTHX_ register SV **sarg, I32 maxsarg)
555 {
556     register SV *sv;
557     register I32 i;
558
559     for (i = 1; i <= maxsarg; i++) {
560         sv = NEWSV(0,0);
561         sv_setsv(sv,sarg[i]);
562         SSCHECK(3);
563         SSPUSHPTR(sarg[i]);             /* remember the pointer */
564         SSPUSHPTR(sv);                  /* remember the value */
565         SSPUSHINT(SAVEt_ITEM);
566     }
567 }
568
569 void
570 Perl_save_destructor(pTHX_ DESTRUCTORFUNC_NOCONTEXT_t f, void* p)
571 {
572     SSCHECK(3);
573     SSPUSHDPTR(f);
574     SSPUSHPTR(p);
575     SSPUSHINT(SAVEt_DESTRUCTOR);
576 }
577
578 void
579 Perl_save_destructor_x(pTHX_ DESTRUCTORFUNC_t f, void* p)
580 {
581     SSCHECK(3);
582     SSPUSHDXPTR(f);
583     SSPUSHPTR(p);
584     SSPUSHINT(SAVEt_DESTRUCTOR_X);
585 }
586
587 void
588 Perl_save_aelem(pTHX_ const AV *av, I32 idx, SV **sptr)
589 {
590     SV *sv;
591     SSCHECK(4);
592     SSPUSHPTR(SvREFCNT_inc(av));
593     SSPUSHINT(idx);
594     SSPUSHPTR(SvREFCNT_inc(*sptr));
595     SSPUSHINT(SAVEt_AELEM);
596     /* if it gets reified later, the restore will have the wrong refcnt */
597     if (!AvREAL(av) && AvREIFY(av))
598         (void)SvREFCNT_inc(*sptr);
599     save_scalar_at(sptr);
600     sv = *sptr;
601     /* If we're localizing a tied array element, this new sv
602      * won't actually be stored in the array - so it won't get
603      * reaped when the localize ends. Ensure it gets reaped by
604      * mortifying it instead. DAPM */
605     if (SvTIED_mg(sv, PERL_MAGIC_tiedelem))
606         sv_2mortal(sv);
607 }
608
609 void
610 Perl_save_helem(pTHX_ HV *hv, SV *key, SV **sptr)
611 {
612     SV *sv;
613     SSCHECK(4);
614     SSPUSHPTR(SvREFCNT_inc(hv));
615     SSPUSHPTR(SvREFCNT_inc(key));
616     SSPUSHPTR(SvREFCNT_inc(*sptr));
617     SSPUSHINT(SAVEt_HELEM);
618     save_scalar_at(sptr);
619     sv = *sptr;
620     /* If we're localizing a tied hash element, this new sv
621      * won't actually be stored in the hash - so it won't get
622      * reaped when the localize ends. Ensure it gets reaped by
623      * mortifying it instead. DAPM */
624     if (SvTIED_mg(sv, PERL_MAGIC_tiedelem))
625         sv_2mortal(sv);
626 }
627
628 void
629 Perl_save_op(pTHX)
630 {
631     SSCHECK(2);
632     SSPUSHPTR(PL_op);
633     SSPUSHINT(SAVEt_OP);
634 }
635
636 I32
637 Perl_save_alloc(pTHX_ I32 size, I32 pad)
638 {
639     register const I32 start = pad + ((char*)&PL_savestack[PL_savestack_ix]
640                                 - (char*)PL_savestack);
641     register const I32 elems = 1 + ((size + pad - 1) / sizeof(*PL_savestack));
642
643     /* SSCHECK may not be good enough */
644     while (PL_savestack_ix + elems + 2 > PL_savestack_max)
645         savestack_grow();
646
647     PL_savestack_ix += elems;
648     SSPUSHINT(elems);
649     SSPUSHINT(SAVEt_ALLOC);
650     return start;
651 }
652
653 void
654 Perl_leave_scope(pTHX_ I32 base)
655 {
656     register SV *sv;
657     register SV *value;
658     register GV *gv;
659     register AV *av;
660     register HV *hv;
661     register void* ptr;
662     register char* str;
663     I32 i;
664
665     if (base < -1)
666         Perl_croak(aTHX_ "panic: corrupt saved stack index");
667     while (PL_savestack_ix > base) {
668         switch (SSPOPINT) {
669         case SAVEt_ITEM:                        /* normal string */
670             value = (SV*)SSPOPPTR;
671             sv = (SV*)SSPOPPTR;
672             sv_replace(sv,value);
673             PL_localizing = 2;
674             SvSETMAGIC(sv);
675             PL_localizing = 0;
676             break;
677         case SAVEt_SV:                          /* scalar reference */
678             value = (SV*)SSPOPPTR;
679             gv = (GV*)SSPOPPTR;
680             ptr = &GvSV(gv);
681             av = (AV*)gv; /* what to refcnt_dec */
682             goto restore_sv;
683         case SAVEt_GENERIC_PVREF:               /* generic pv */
684             str = (char*)SSPOPPTR;
685             ptr = SSPOPPTR;
686             if (*(char**)ptr != str) {
687                 Safefree(*(char**)ptr);
688                 *(char**)ptr = str;
689             }
690             break;
691         case SAVEt_SHARED_PVREF:                /* shared pv */
692             str = (char*)SSPOPPTR;
693             ptr = SSPOPPTR;
694             if (*(char**)ptr != str) {
695 #ifdef NETWARE
696                 PerlMem_free(*(char**)ptr);
697 #else
698                 PerlMemShared_free(*(char**)ptr);
699 #endif
700                 *(char**)ptr = str;
701             }
702             break;
703         case SAVEt_GENERIC_SVREF:               /* generic sv */
704             value = (SV*)SSPOPPTR;
705             ptr = SSPOPPTR;
706             sv = *(SV**)ptr;
707             *(SV**)ptr = value;
708             SvREFCNT_dec(sv);
709             SvREFCNT_dec(value);
710             break;
711         case SAVEt_SVREF:                       /* scalar reference */
712             value = (SV*)SSPOPPTR;
713             ptr = SSPOPPTR;
714             av = Nullav; /* what to refcnt_dec */
715         restore_sv:
716             sv = *(SV**)ptr;
717             DEBUG_S(PerlIO_printf(Perl_debug_log,
718                                   "restore svref: %p %p:%s -> %p:%s\n",
719                                   ptr, sv, SvPEEK(sv), value, SvPEEK(value)));
720             if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv) &&
721                 SvTYPE(sv) != SVt_PVGV)
722             {
723                 SvUPGRADE(value, SvTYPE(sv));
724                 SvMAGIC_set(value, SvMAGIC(sv));
725                 SvFLAGS(value) |= SvMAGICAL(sv);
726                 SvMAGICAL_off(sv);
727                 SvMAGIC_set(sv, 0);
728             }
729             /* XXX This branch is pretty bogus.  This code irretrievably
730              * clears(!) the magic on the SV (either to avoid further
731              * croaking that might ensue when the SvSETMAGIC() below is
732              * called, or to avoid two different SVs pointing at the same
733              * SvMAGIC()).  This needs a total rethink.  --GSAR */
734             else if (SvTYPE(value) >= SVt_PVMG && SvMAGIC(value) &&
735                      SvTYPE(value) != SVt_PVGV)
736             {
737                 SvFLAGS(value) |= (SvFLAGS(value) &
738                                   (SVp_NOK|SVp_POK)) >> PRIVSHIFT;
739                 SvMAGICAL_off(value);
740                 /* XXX this is a leak when we get here because the
741                  * mg_get() in save_scalar_at() croaked */
742                 SvMAGIC_set(value, NULL);
743             }
744             *(SV**)ptr = value;
745             SvREFCNT_dec(sv);
746             PL_localizing = 2;
747             SvSETMAGIC(value);
748             PL_localizing = 0;
749             SvREFCNT_dec(value);
750             if (av) /* actually an av, hv or gv */
751                 SvREFCNT_dec(av);
752             break;
753         case SAVEt_AV:                          /* array reference */
754             av = (AV*)SSPOPPTR;
755             gv = (GV*)SSPOPPTR;
756             if (GvAV(gv)) {
757                 AV * const goner = GvAV(gv);
758                 /* FIXME - this is a temporary hack until we work out what
759                    the correct behaviour for magic should be.  */
760                 sv_unmagic((SV*)goner, PERL_MAGIC_arylen_p);
761                 SvMAGIC_set(av, SvMAGIC(goner));
762                 SvFLAGS((SV*)av) |= SvMAGICAL(goner);
763                 SvMAGICAL_off(goner);
764                 SvMAGIC_set(goner, NULL);
765                 SvREFCNT_dec(goner);
766             }
767             GvAV(gv) = av;
768             if (SvMAGICAL(av)) {
769                 PL_localizing = 2;
770                 SvSETMAGIC((SV*)av);
771                 PL_localizing = 0;
772             }
773             break;
774         case SAVEt_HV:                          /* hash reference */
775             hv = (HV*)SSPOPPTR;
776             gv = (GV*)SSPOPPTR;
777             if (GvHV(gv)) {
778                 HV * const goner = GvHV(gv);
779                 SvMAGIC_set(hv, SvMAGIC(goner));
780                 SvFLAGS(hv) |= SvMAGICAL(goner);
781                 SvMAGICAL_off(goner);
782                 SvMAGIC_set(goner, NULL);
783                 SvREFCNT_dec(goner);
784             }
785             GvHV(gv) = hv;
786             if (SvMAGICAL(hv)) {
787                 PL_localizing = 2;
788                 SvSETMAGIC((SV*)hv);
789                 PL_localizing = 0;
790             }
791             break;
792         case SAVEt_INT:                         /* int reference */
793             ptr = SSPOPPTR;
794             *(int*)ptr = (int)SSPOPINT;
795             break;
796         case SAVEt_LONG:                        /* long reference */
797             ptr = SSPOPPTR;
798             *(long*)ptr = (long)SSPOPLONG;
799             break;
800         case SAVEt_BOOL:                        /* bool reference */
801             ptr = SSPOPPTR;
802             *(bool*)ptr = (bool)SSPOPBOOL;
803             break;
804         case SAVEt_I32:                         /* I32 reference */
805             ptr = SSPOPPTR;
806             *(I32*)ptr = (I32)SSPOPINT;
807             break;
808         case SAVEt_I16:                         /* I16 reference */
809             ptr = SSPOPPTR;
810             *(I16*)ptr = (I16)SSPOPINT;
811             break;
812         case SAVEt_I8:                          /* I8 reference */
813             ptr = SSPOPPTR;
814             *(I8*)ptr = (I8)SSPOPINT;
815             break;
816         case SAVEt_IV:                          /* IV reference */
817             ptr = SSPOPPTR;
818             *(IV*)ptr = (IV)SSPOPIV;
819             break;
820         case SAVEt_SPTR:                        /* SV* reference */
821             ptr = SSPOPPTR;
822             *(SV**)ptr = (SV*)SSPOPPTR;
823             break;
824         case SAVEt_VPTR:                        /* random* reference */
825         case SAVEt_PPTR:                        /* char* reference */
826             ptr = SSPOPPTR;
827             *(char**)ptr = (char*)SSPOPPTR;
828             break;
829         case SAVEt_HPTR:                        /* HV* reference */
830             ptr = SSPOPPTR;
831             *(HV**)ptr = (HV*)SSPOPPTR;
832             break;
833         case SAVEt_APTR:                        /* AV* reference */
834             ptr = SSPOPPTR;
835             *(AV**)ptr = (AV*)SSPOPPTR;
836             break;
837         case SAVEt_NSTAB:
838             gv = (GV*)SSPOPPTR;
839             (void)sv_clear((SV*)gv);
840             break;
841         case SAVEt_GP:                          /* scalar reference */
842             ptr = SSPOPPTR;
843             gv = (GV*)SSPOPPTR;
844             if (SvPVX_const(gv) && SvLEN(gv) > 0) {
845                 Safefree(SvPVX_const(gv));
846             }
847             SvPV_set(gv, (char *)SSPOPPTR);
848             SvCUR_set(gv, (STRLEN)SSPOPIV);
849             SvLEN_set(gv, (STRLEN)SSPOPIV);
850             gp_free(gv);
851             GvGP(gv) = (GP*)ptr;
852             if (GvCVu(gv))
853                 PL_sub_generation++;  /* putting a method back into circulation */
854             SvREFCNT_dec(gv);
855             break;
856         case SAVEt_FREESV:
857             ptr = SSPOPPTR;
858             SvREFCNT_dec((SV*)ptr);
859             break;
860         case SAVEt_MORTALIZESV:
861             ptr = SSPOPPTR;
862             sv_2mortal((SV*)ptr);
863             break;
864         case SAVEt_FREEOP:
865             ptr = SSPOPPTR;
866             ASSERT_CURPAD_LEGAL("SAVEt_FREEOP"); /* XXX DAPM tmp */
867             op_free((OP*)ptr);
868             break;
869         case SAVEt_FREEPV:
870             ptr = SSPOPPTR;
871             Safefree(ptr);
872             break;
873         case SAVEt_CLEARSV:
874             ptr = (void*)&PL_curpad[SSPOPLONG];
875             sv = *(SV**)ptr;
876
877             DEBUG_Xv(PerlIO_printf(Perl_debug_log,
878              "Pad 0x%"UVxf"[0x%"UVxf"] clearsv: %ld sv=0x%"UVxf"<%"IVdf"> %s\n",
879                 PTR2UV(PL_comppad), PTR2UV(PL_curpad),
880                 (long)((SV **)ptr-PL_curpad), PTR2UV(sv), (IV)SvREFCNT(sv),
881                 (SvREFCNT(sv) <= 1 && !SvOBJECT(sv)) ? "clear" : "abandon"
882             ));
883
884             /* Can clear pad variable in place? */
885             if (SvREFCNT(sv) <= 1 && !SvOBJECT(sv)) {
886                 /*
887                  * if a my variable that was made readonly is going out of
888                  * scope, we want to remove the readonlyness so that it can
889                  * go out of scope quietly
890                  */
891                 if (SvPADMY(sv) && !SvFAKE(sv))
892                     SvREADONLY_off(sv);
893
894                 if (SvTHINKFIRST(sv))
895                     sv_force_normal_flags(sv, SV_IMMEDIATE_UNREF);
896                 if (SvMAGICAL(sv))
897                     mg_free(sv);
898
899                 switch (SvTYPE(sv)) {
900                 case SVt_NULL:
901                     break;
902                 case SVt_PVAV:
903                     av_clear((AV*)sv);
904                     break;
905                 case SVt_PVHV:
906                     hv_clear((HV*)sv);
907                     break;
908                 case SVt_PVCV:
909                     Perl_croak(aTHX_ "panic: leave_scope pad code");
910                 default:
911                     SvOK_off(sv);
912                     break;
913                 }
914                 SvPADSTALE_on(sv); /* mark as no longer live */
915             }
916             else {      /* Someone has a claim on this, so abandon it. */
917                 const U32 padflags = SvFLAGS(sv) & (SVs_PADMY|SVs_PADTMP);
918                 switch (SvTYPE(sv)) {   /* Console ourselves with a new value */
919                 case SVt_PVAV:  *(SV**)ptr = (SV*)newAV();      break;
920                 case SVt_PVHV:  *(SV**)ptr = (SV*)newHV();      break;
921                 default:        *(SV**)ptr = NEWSV(0,0);        break;
922                 }
923                 SvREFCNT_dec(sv);       /* Cast current value to the winds. */
924                 /* preserve pad nature, but also mark as not live
925                  * for any closure capturing */
926                 SvFLAGS(*(SV**)ptr) |= padflags | SVs_PADSTALE;
927             }
928             break;
929         case SAVEt_DELETE:
930             ptr = SSPOPPTR;
931             hv = (HV*)ptr;
932             ptr = SSPOPPTR;
933             (void)hv_delete(hv, (char*)ptr, (U32)SSPOPINT, G_DISCARD);
934             SvREFCNT_dec(hv);
935             Safefree(ptr);
936             break;
937         case SAVEt_DESTRUCTOR:
938             ptr = SSPOPPTR;
939             (*SSPOPDPTR)(ptr);
940             break;
941         case SAVEt_DESTRUCTOR_X:
942             ptr = SSPOPPTR;
943             (*SSPOPDXPTR)(aTHX_ ptr);
944             break;
945         case SAVEt_REGCONTEXT:
946         case SAVEt_ALLOC:
947             i = SSPOPINT;
948             PL_savestack_ix -= i;       /* regexp must have croaked */
949             break;
950         case SAVEt_STACK_POS:           /* Position on Perl stack */
951             i = SSPOPINT;
952             PL_stack_sp = PL_stack_base + i;
953             break;
954         case SAVEt_AELEM:               /* array element */
955             value = (SV*)SSPOPPTR;
956             i = SSPOPINT;
957             av = (AV*)SSPOPPTR;
958             if (!AvREAL(av) && AvREIFY(av)) /* undo reify guard */
959                 SvREFCNT_dec(value);
960             ptr = av_fetch(av,i,1);
961             if (ptr) {
962                 sv = *(SV**)ptr;
963                 if (sv && sv != &PL_sv_undef) {
964                     if (SvTIED_mg((SV*)av, PERL_MAGIC_tied))
965                         (void)SvREFCNT_inc(sv);
966                     goto restore_sv;
967                 }
968             }
969             SvREFCNT_dec(av);
970             SvREFCNT_dec(value);
971             break;
972         case SAVEt_HELEM:               /* hash element */
973             value = (SV*)SSPOPPTR;
974             sv = (SV*)SSPOPPTR;
975             hv = (HV*)SSPOPPTR;
976             ptr = hv_fetch_ent(hv, sv, 1, 0);
977             if (ptr) {
978                 const SV * const oval = HeVAL((HE*)ptr);
979                 if (oval && oval != &PL_sv_undef) {
980                     ptr = &HeVAL((HE*)ptr);
981                     if (SvTIED_mg((SV*)hv, PERL_MAGIC_tied))
982                         (void)SvREFCNT_inc(*(SV**)ptr);
983                     SvREFCNT_dec(sv);
984                     av = (AV*)hv; /* what to refcnt_dec */
985                     goto restore_sv;
986                 }
987             }
988             SvREFCNT_dec(hv);
989             SvREFCNT_dec(sv);
990             SvREFCNT_dec(value);
991             break;
992         case SAVEt_OP:
993             PL_op = (OP*)SSPOPPTR;
994             break;
995         case SAVEt_HINTS:
996             if ((PL_hints & HINT_LOCALIZE_HH) && GvHV(PL_hintgv)) {
997                 SvREFCNT_dec((SV*)GvHV(PL_hintgv));
998                 GvHV(PL_hintgv) = NULL;
999             }
1000             *(I32*)&PL_hints = (I32)SSPOPINT;
1001             if (PL_hints & HINT_LOCALIZE_HH) {
1002                 SvREFCNT_dec((SV*)GvHV(PL_hintgv));
1003                 GvHV(PL_hintgv) = (HV*)SSPOPPTR;
1004             }
1005                     
1006             break;
1007         case SAVEt_COMPPAD:
1008             PL_comppad = (PAD*)SSPOPPTR;
1009             if (PL_comppad)
1010                 PL_curpad = AvARRAY(PL_comppad);
1011             else
1012                 PL_curpad = Null(SV**);
1013             break;
1014         case SAVEt_PADSV:
1015             {
1016                 const PADOFFSET off = (PADOFFSET)SSPOPLONG;
1017                 ptr = SSPOPPTR;
1018                 if (ptr)
1019                     AvARRAY((PAD*)ptr)[off] = (SV*)SSPOPPTR;
1020             }
1021             break;
1022         case SAVEt_SAVESWITCHSTACK:
1023             {
1024                 dSP;
1025                 AV* t = (AV*)SSPOPPTR;
1026                 AV* f = (AV*)SSPOPPTR;
1027                 SWITCHSTACK(t,f);
1028                 PL_curstackinfo->si_stack = f;
1029             }
1030             break;
1031         case SAVEt_SET_SVFLAGS:
1032             {
1033                 const U32 val  = (U32)SSPOPINT;
1034                 const U32 mask = (U32)SSPOPINT;
1035                 sv = (SV*)SSPOPPTR;
1036                 SvFLAGS(sv) &= ~mask;
1037                 SvFLAGS(sv) |= val;
1038             }
1039             break;
1040         default:
1041             Perl_croak(aTHX_ "panic: leave_scope inconsistency");
1042         }
1043     }
1044 }
1045
1046 void
1047 Perl_cx_dump(pTHX_ PERL_CONTEXT *cx)
1048 {
1049 #ifdef DEBUGGING
1050     PerlIO_printf(Perl_debug_log, "CX %ld = %s\n", (long)(cx - cxstack), PL_block_type[CxTYPE(cx)]);
1051     if (CxTYPE(cx) != CXt_SUBST) {
1052         PerlIO_printf(Perl_debug_log, "BLK_OLDSP = %ld\n", (long)cx->blk_oldsp);
1053         PerlIO_printf(Perl_debug_log, "BLK_OLDCOP = 0x%"UVxf"\n",
1054                       PTR2UV(cx->blk_oldcop));
1055         PerlIO_printf(Perl_debug_log, "BLK_OLDMARKSP = %ld\n", (long)cx->blk_oldmarksp);
1056         PerlIO_printf(Perl_debug_log, "BLK_OLDSCOPESP = %ld\n", (long)cx->blk_oldscopesp);
1057         PerlIO_printf(Perl_debug_log, "BLK_OLDPM = 0x%"UVxf"\n",
1058                       PTR2UV(cx->blk_oldpm));
1059         PerlIO_printf(Perl_debug_log, "BLK_GIMME = %s\n", cx->blk_gimme ? "LIST" : "SCALAR");
1060     }
1061     switch (CxTYPE(cx)) {
1062     case CXt_NULL:
1063     case CXt_BLOCK:
1064         break;
1065     case CXt_FORMAT:
1066         PerlIO_printf(Perl_debug_log, "BLK_SUB.CV = 0x%"UVxf"\n",
1067                 PTR2UV(cx->blk_sub.cv));
1068         PerlIO_printf(Perl_debug_log, "BLK_SUB.GV = 0x%"UVxf"\n",
1069                 PTR2UV(cx->blk_sub.gv));
1070         PerlIO_printf(Perl_debug_log, "BLK_SUB.DFOUTGV = 0x%"UVxf"\n",
1071                 PTR2UV(cx->blk_sub.dfoutgv));
1072         PerlIO_printf(Perl_debug_log, "BLK_SUB.HASARGS = %d\n",
1073                 (int)cx->blk_sub.hasargs);
1074         PerlIO_printf(Perl_debug_log, "BLK_SUB.RETOP = 0x%"UVxf"\n",
1075                 PTR2UV(cx->blk_sub.retop));
1076         break;
1077     case CXt_SUB:
1078         PerlIO_printf(Perl_debug_log, "BLK_SUB.CV = 0x%"UVxf"\n",
1079                 PTR2UV(cx->blk_sub.cv));
1080         PerlIO_printf(Perl_debug_log, "BLK_SUB.OLDDEPTH = %ld\n",
1081                 (long)cx->blk_sub.olddepth);
1082         PerlIO_printf(Perl_debug_log, "BLK_SUB.HASARGS = %d\n",
1083                 (int)cx->blk_sub.hasargs);
1084         PerlIO_printf(Perl_debug_log, "BLK_SUB.LVAL = %d\n",
1085                 (int)cx->blk_sub.lval);
1086         PerlIO_printf(Perl_debug_log, "BLK_SUB.RETOP = 0x%"UVxf"\n",
1087                 PTR2UV(cx->blk_sub.retop));
1088         break;
1089     case CXt_EVAL:
1090         PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_IN_EVAL = %ld\n",
1091                 (long)cx->blk_eval.old_in_eval);
1092         PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_OP_TYPE = %s (%s)\n",
1093                 PL_op_name[cx->blk_eval.old_op_type],
1094                 PL_op_desc[cx->blk_eval.old_op_type]);
1095         if (cx->blk_eval.old_namesv)
1096             PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_NAME = %s\n",
1097                           SvPVX_const(cx->blk_eval.old_namesv));
1098         PerlIO_printf(Perl_debug_log, "BLK_EVAL.OLD_EVAL_ROOT = 0x%"UVxf"\n",
1099                 PTR2UV(cx->blk_eval.old_eval_root));
1100         PerlIO_printf(Perl_debug_log, "BLK_EVAL.RETOP = 0x%"UVxf"\n",
1101                 PTR2UV(cx->blk_eval.retop));
1102         break;
1103
1104     case CXt_LOOP:
1105         PerlIO_printf(Perl_debug_log, "BLK_LOOP.LABEL = %s\n",
1106                 cx->blk_loop.label);
1107         PerlIO_printf(Perl_debug_log, "BLK_LOOP.RESETSP = %ld\n",
1108                 (long)cx->blk_loop.resetsp);
1109         PerlIO_printf(Perl_debug_log, "BLK_LOOP.REDO_OP = 0x%"UVxf"\n",
1110                 PTR2UV(cx->blk_loop.redo_op));
1111         PerlIO_printf(Perl_debug_log, "BLK_LOOP.NEXT_OP = 0x%"UVxf"\n",
1112                 PTR2UV(cx->blk_loop.next_op));
1113         PerlIO_printf(Perl_debug_log, "BLK_LOOP.LAST_OP = 0x%"UVxf"\n",
1114                 PTR2UV(cx->blk_loop.last_op));
1115         PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERIX = %ld\n",
1116                 (long)cx->blk_loop.iterix);
1117         PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERARY = 0x%"UVxf"\n",
1118                 PTR2UV(cx->blk_loop.iterary));
1119         PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERVAR = 0x%"UVxf"\n",
1120                 PTR2UV(CxITERVAR(cx)));
1121         if (CxITERVAR(cx))
1122             PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERSAVE = 0x%"UVxf"\n",
1123                 PTR2UV(cx->blk_loop.itersave));
1124         PerlIO_printf(Perl_debug_log, "BLK_LOOP.ITERLVAL = 0x%"UVxf"\n",
1125                 PTR2UV(cx->blk_loop.iterlval));
1126         break;
1127
1128     case CXt_SUBST:
1129         PerlIO_printf(Perl_debug_log, "SB_ITERS = %ld\n",
1130                 (long)cx->sb_iters);
1131         PerlIO_printf(Perl_debug_log, "SB_MAXITERS = %ld\n",
1132                 (long)cx->sb_maxiters);
1133         PerlIO_printf(Perl_debug_log, "SB_RFLAGS = %ld\n",
1134                 (long)cx->sb_rflags);
1135         PerlIO_printf(Perl_debug_log, "SB_ONCE = %ld\n",
1136                 (long)cx->sb_once);
1137         PerlIO_printf(Perl_debug_log, "SB_ORIG = %s\n",
1138                 cx->sb_orig);
1139         PerlIO_printf(Perl_debug_log, "SB_DSTR = 0x%"UVxf"\n",
1140                 PTR2UV(cx->sb_dstr));
1141         PerlIO_printf(Perl_debug_log, "SB_TARG = 0x%"UVxf"\n",
1142                 PTR2UV(cx->sb_targ));
1143         PerlIO_printf(Perl_debug_log, "SB_S = 0x%"UVxf"\n",
1144                 PTR2UV(cx->sb_s));
1145         PerlIO_printf(Perl_debug_log, "SB_M = 0x%"UVxf"\n",
1146                 PTR2UV(cx->sb_m));
1147         PerlIO_printf(Perl_debug_log, "SB_STREND = 0x%"UVxf"\n",
1148                 PTR2UV(cx->sb_strend));
1149         PerlIO_printf(Perl_debug_log, "SB_RXRES = 0x%"UVxf"\n",
1150                 PTR2UV(cx->sb_rxres));
1151         break;
1152     }
1153 #endif  /* DEBUGGING */
1154 }
1155
1156 /*
1157  * Local variables:
1158  * c-indentation-style: bsd
1159  * c-basic-offset: 4
1160  * indent-tabs-mode: t
1161  * End:
1162  *
1163  * ex: set ts=8 sts=4 sw=4 noet:
1164  */