This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlbug bug - shows dates reversed
[perl5.git] / pp_hot.c
1 /*    pp_hot.c
2  *
3  *    Copyright (c) 1991-1997, Larry Wall
4  *
5  *    You may distribute under the terms of either the GNU General Public
6  *    License or the Artistic License, as specified in the README file.
7  *
8  */
9
10 /*
11  * Then he heard Merry change the note, and up went the Horn-cry of Buckland,
12  * shaking the air.
13  *
14  *            Awake!  Awake!  Fear, Fire, Foes!  Awake!
15  *                     Fire, Foes!  Awake!
16  */
17
18 #include "EXTERN.h"
19 #include "perl.h"
20
21 #ifdef I_UNISTD
22 #include <unistd.h>
23 #endif
24 #ifdef I_FCNTL
25 #include <fcntl.h>
26 #endif
27 #ifdef I_SYS_FILE
28 #include <sys/file.h>
29 #endif
30
31 #define HOP(pos,off) (IN_UTF8 ? utf8_hop(pos, off) : (pos + off))
32
33 /* Hot code. */
34
35 #ifdef USE_THREADS
36 static void
37 unset_cvowner(void *cvarg)
38 {
39     register CV* cv = (CV *) cvarg;
40 #ifdef DEBUGGING
41     dTHR;
42 #endif /* DEBUGGING */
43
44     DEBUG_S((PerlIO_printf(PerlIO_stderr(), "%p unsetting CvOWNER of %p:%s\n",
45                            thr, cv, SvPEEK((SV*)cv))));
46     MUTEX_LOCK(CvMUTEXP(cv));
47     DEBUG_S(if (CvDEPTH(cv) != 0)
48                 PerlIO_printf(PerlIO_stderr(), "depth %ld != 0\n",
49                               CvDEPTH(cv)););
50     assert(thr == CvOWNER(cv));
51     CvOWNER(cv) = 0;
52     MUTEX_UNLOCK(CvMUTEXP(cv));
53     SvREFCNT_dec(cv);
54 }
55 #endif /* USE_THREADS */
56
57 PP(pp_const)
58 {
59     djSP;
60     XPUSHs(cSVOP->op_sv);
61     RETURN;
62 }
63
64 PP(pp_nextstate)
65 {
66     PL_curcop = (COP*)PL_op;
67     TAINT_NOT;          /* Each statement is presumed innocent */
68     PL_stack_sp = PL_stack_base + cxstack[cxstack_ix].blk_oldsp;
69     FREETMPS;
70     return NORMAL;
71 }
72
73 PP(pp_gvsv)
74 {
75     djSP;
76     EXTEND(SP,1);
77     if (PL_op->op_private & OPpLVAL_INTRO)
78         PUSHs(save_scalar(cGVOP->op_gv));
79     else
80         PUSHs(GvSV(cGVOP->op_gv));
81     RETURN;
82 }
83
84 PP(pp_null)
85 {
86     return NORMAL;
87 }
88
89 PP(pp_pushmark)
90 {
91     PUSHMARK(PL_stack_sp);
92     return NORMAL;
93 }
94
95 PP(pp_stringify)
96 {
97     djSP; dTARGET;
98     STRLEN len;
99     char *s;
100     s = SvPV(TOPs,len);
101     sv_setpvn(TARG,s,len);
102     SETTARG;
103     RETURN;
104 }
105
106 PP(pp_gv)
107 {
108     djSP;
109     XPUSHs((SV*)cGVOP->op_gv);
110     RETURN;
111 }
112
113 PP(pp_and)
114 {
115     djSP;
116     if (!SvTRUE(TOPs))
117         RETURN;
118     else {
119         --SP;
120         RETURNOP(cLOGOP->op_other);
121     }
122 }
123
124 PP(pp_sassign)
125 {
126     djSP; dPOPTOPssrl;
127     MAGIC *mg;
128
129     if (PL_op->op_private & OPpASSIGN_BACKWARDS) {
130         SV *temp;
131         temp = left; left = right; right = temp;
132     }
133     if (PL_tainting && PL_tainted && !SvTAINTED(left))
134         TAINT_NOT;
135     SvSetMagicSV(right, left);
136     SETs(right);
137     RETURN;
138 }
139
140 PP(pp_cond_expr)
141 {
142     djSP;
143     if (SvTRUEx(POPs))
144         RETURNOP(cCONDOP->op_true);
145     else
146         RETURNOP(cCONDOP->op_false);
147 }
148
149 PP(pp_unstack)
150 {
151     I32 oldsave;
152     TAINT_NOT;          /* Each statement is presumed innocent */
153     PL_stack_sp = PL_stack_base + cxstack[cxstack_ix].blk_oldsp;
154     FREETMPS;
155     oldsave = PL_scopestack[PL_scopestack_ix - 1];
156     LEAVE_SCOPE(oldsave);
157     return NORMAL;
158 }
159
160 PP(pp_concat)
161 {
162   djSP; dATARGET; tryAMAGICbin(concat,opASSIGN);
163   {
164     dPOPTOPssrl;
165     STRLEN len;
166     char *s;
167     if (TARG != left) {
168         s = SvPV(left,len);
169         sv_setpvn(TARG,s,len);
170     }
171     else if (SvGMAGICAL(TARG))
172         mg_get(TARG);
173     else if (!SvOK(TARG) && SvTYPE(TARG) <= SVt_PVMG) {
174         sv_setpv(TARG, "");     /* Suppress warning. */
175         s = SvPV_force(TARG, len);
176     }
177     s = SvPV(right,len);
178     if (SvOK(TARG))
179         sv_catpvn(TARG,s,len);
180     else
181         sv_setpvn(TARG,s,len);  /* suppress warning */
182     SETTARG;
183     RETURN;
184   }
185 }
186
187 PP(pp_padsv)
188 {
189     djSP; dTARGET;
190     XPUSHs(TARG);
191     if (PL_op->op_flags & OPf_MOD) {
192         if (PL_op->op_private & OPpLVAL_INTRO)
193             SAVECLEARSV(PL_curpad[PL_op->op_targ]);
194         else if (PL_op->op_private & OPpDEREF) {
195             PUTBACK;
196             vivify_ref(PL_curpad[PL_op->op_targ], PL_op->op_private & OPpDEREF);
197             SPAGAIN;
198         }
199     }
200     RETURN;
201 }
202
203 PP(pp_readline)
204 {
205     tryAMAGICunTARGET(iter, 0);
206     PL_last_in_gv = (GV*)(*PL_stack_sp--);
207     if (PL_op->op_flags & OPf_SPECIAL) {        /* Are called as <$var> */
208         if (SvROK(PL_last_in_gv)) {
209             if (SvTYPE(SvRV(PL_last_in_gv)) != SVt_PVGV) 
210                 goto hard_way;
211             PL_last_in_gv = (GV*)SvRV(PL_last_in_gv);
212         } else if (SvTYPE(PL_last_in_gv) != SVt_PVGV) {
213           hard_way: {
214             dSP;
215             XPUSHs((SV*)PL_last_in_gv);
216             PUTBACK;
217             pp_rv2gv(ARGS);
218             PL_last_in_gv = (GV*)(*PL_stack_sp--);
219           }
220         }
221     }
222     return do_readline();
223 }
224
225 PP(pp_eq)
226 {
227     djSP; tryAMAGICbinSET(eq,0); 
228     {
229       dPOPnv;
230       SETs(boolSV(TOPn == value));
231       RETURN;
232     }
233 }
234
235 PP(pp_preinc)
236 {
237     djSP;
238     if (SvREADONLY(TOPs) || SvTYPE(TOPs) > SVt_PVLV)
239         croak(PL_no_modify);
240     if (SvIOK(TOPs) && !SvNOK(TOPs) && !SvPOK(TOPs) &&
241         SvIVX(TOPs) != IV_MAX)
242     {
243         ++SvIVX(TOPs);
244         SvFLAGS(TOPs) &= ~(SVp_NOK|SVp_POK);
245     }
246     else
247         sv_inc(TOPs);
248     SvSETMAGIC(TOPs);
249     return NORMAL;
250 }
251
252 PP(pp_or)
253 {
254     djSP;
255     if (SvTRUE(TOPs))
256         RETURN;
257     else {
258         --SP;
259         RETURNOP(cLOGOP->op_other);
260     }
261 }
262
263 PP(pp_add)
264 {
265     djSP; dATARGET; tryAMAGICbin(add,opASSIGN); 
266     {
267       dPOPTOPnnrl_ul;
268       SETn( left + right );
269       RETURN;
270     }
271 }
272
273 PP(pp_aelemfast)
274 {
275     djSP;
276     AV *av = GvAV((GV*)cSVOP->op_sv);
277     U32 lval = PL_op->op_flags & OPf_MOD;
278     SV** svp = av_fetch(av, PL_op->op_private, lval);
279     SV *sv = (svp ? *svp : &PL_sv_undef);
280     EXTEND(SP, 1);
281     if (!lval && SvGMAGICAL(sv))        /* see note in pp_helem() */
282         sv = sv_mortalcopy(sv);
283     PUSHs(sv);
284     RETURN;
285 }
286
287 PP(pp_join)
288 {
289     djSP; dMARK; dTARGET;
290     MARK++;
291     do_join(TARG, *MARK, MARK, SP);
292     SP = MARK;
293     SETs(TARG);
294     RETURN;
295 }
296
297 PP(pp_pushre)
298 {
299     djSP;
300 #ifdef DEBUGGING
301     /*
302      * We ass_u_me that LvTARGOFF() comes first, and that two STRLENs
303      * will be enough to hold an OP*.
304      */
305     SV* sv = sv_newmortal();
306     sv_upgrade(sv, SVt_PVLV);
307     LvTYPE(sv) = '/';
308     Copy(&PL_op, &LvTARGOFF(sv), 1, OP*);
309     XPUSHs(sv);
310 #else
311     XPUSHs((SV*)PL_op);
312 #endif
313     RETURN;
314 }
315
316 /* Oversized hot code. */
317
318 PP(pp_print)
319 {
320     djSP; dMARK; dORIGMARK;
321     GV *gv;
322     IO *io;
323     register PerlIO *fp;
324     MAGIC *mg;
325     STRLEN n_a;
326
327     if (PL_op->op_flags & OPf_STACKED)
328         gv = (GV*)*++MARK;
329     else
330         gv = PL_defoutgv;
331     if (mg = SvTIED_mg((SV*)gv, 'q')) {
332         if (MARK == ORIGMARK) {
333             /* If using default handle then we need to make space to 
334              * pass object as 1st arg, so move other args up ...
335              */
336             MEXTEND(SP, 1);
337             ++MARK;
338             Move(MARK, MARK + 1, (SP - MARK) + 1, SV*);
339             ++SP;
340         }
341         PUSHMARK(MARK - 1);
342         *MARK = SvTIED_obj((SV*)gv, mg);
343         PUTBACK;
344         ENTER;
345         perl_call_method("PRINT", G_SCALAR);
346         LEAVE;
347         SPAGAIN;
348         MARK = ORIGMARK + 1;
349         *MARK = *SP;
350         SP = MARK;
351         RETURN;
352     }
353     if (!(io = GvIO(gv))) {
354         if (ckWARN(WARN_UNOPENED)) {
355             SV* sv = sv_newmortal();
356             gv_fullname3(sv, gv, Nullch);
357             warner(WARN_UNOPENED, "Filehandle %s never opened", SvPV(sv,n_a));
358         }
359
360         SETERRNO(EBADF,RMS$_IFI);
361         goto just_say_no;
362     }
363     else if (!(fp = IoOFP(io))) {
364         if (ckWARN2(WARN_CLOSED, WARN_IO))  {
365             SV* sv = sv_newmortal();
366             gv_fullname3(sv, gv, Nullch);
367             if (IoIFP(io))
368                 warner(WARN_IO, "Filehandle %s opened only for input", 
369                                 SvPV(sv,n_a));
370             else if (ckWARN(WARN_CLOSED))
371                 warner(WARN_CLOSED, "print on closed filehandle %s", 
372                                 SvPV(sv,n_a));
373         }
374         SETERRNO(EBADF,IoIFP(io)?RMS$_FAC:RMS$_IFI);
375         goto just_say_no;
376     }
377     else {
378         MARK++;
379         if (PL_ofslen) {
380             while (MARK <= SP) {
381                 if (!do_print(*MARK, fp))
382                     break;
383                 MARK++;
384                 if (MARK <= SP) {
385                     if (PerlIO_write(fp, PL_ofs, PL_ofslen) == 0 || PerlIO_error(fp)) {
386                         MARK--;
387                         break;
388                     }
389                 }
390             }
391         }
392         else {
393             while (MARK <= SP) {
394                 if (!do_print(*MARK, fp))
395                     break;
396                 MARK++;
397             }
398         }
399         if (MARK <= SP)
400             goto just_say_no;
401         else {
402             if (PL_orslen)
403                 if (PerlIO_write(fp, PL_ors, PL_orslen) == 0 || PerlIO_error(fp))
404                     goto just_say_no;
405
406             if (IoFLAGS(io) & IOf_FLUSH)
407                 if (PerlIO_flush(fp) == EOF)
408                     goto just_say_no;
409         }
410     }
411     SP = ORIGMARK;
412     PUSHs(&PL_sv_yes);
413     RETURN;
414
415   just_say_no:
416     SP = ORIGMARK;
417     PUSHs(&PL_sv_undef);
418     RETURN;
419 }
420
421 PP(pp_rv2av)
422 {
423     djSP; dTOPss;
424     AV *av;
425
426     if (SvROK(sv)) {
427       wasref:
428         tryAMAGICunDEREF(to_av);
429
430         av = (AV*)SvRV(sv);
431         if (SvTYPE(av) != SVt_PVAV)
432             DIE("Not an ARRAY reference");
433         if (PL_op->op_flags & OPf_REF) {
434             SETs((SV*)av);
435             RETURN;
436         }
437     }
438     else {
439         if (SvTYPE(sv) == SVt_PVAV) {
440             av = (AV*)sv;
441             if (PL_op->op_flags & OPf_REF) {
442                 SETs((SV*)av);
443                 RETURN;
444             }
445         }
446         else {
447             GV *gv;
448             
449             if (SvTYPE(sv) != SVt_PVGV) {
450                 char *sym;
451                 STRLEN n_a;
452
453                 if (SvGMAGICAL(sv)) {
454                     mg_get(sv);
455                     if (SvROK(sv))
456                         goto wasref;
457                 }
458                 if (!SvOK(sv)) {
459                     if (PL_op->op_flags & OPf_REF ||
460                       PL_op->op_private & HINT_STRICT_REFS)
461                         DIE(PL_no_usym, "an ARRAY");
462                     if (ckWARN(WARN_UNINITIALIZED))
463                         warner(WARN_UNINITIALIZED, PL_warn_uninit);
464                     if (GIMME == G_ARRAY) {
465                         (void)POPs;
466                         RETURN;
467                     }
468                     RETSETUNDEF;
469                 }
470                 sym = SvPV(sv,n_a);
471                 if (PL_op->op_private & HINT_STRICT_REFS)
472                     DIE(PL_no_symref, sym, "an ARRAY");
473                 gv = (GV*)gv_fetchpv(sym, TRUE, SVt_PVAV);
474             } else {
475                 gv = (GV*)sv;
476             }
477             av = GvAVn(gv);
478             if (PL_op->op_private & OPpLVAL_INTRO)
479                 av = save_ary(gv);
480             if (PL_op->op_flags & OPf_REF) {
481                 SETs((SV*)av);
482                 RETURN;
483             }
484         }
485     }
486
487     if (GIMME == G_ARRAY) {
488         I32 maxarg = AvFILL(av) + 1;
489         (void)POPs;                     /* XXXX May be optimized away? */
490         EXTEND(SP, maxarg);          
491         if (SvRMAGICAL(av)) {
492             U32 i; 
493             for (i=0; i < maxarg; i++) {
494                 SV **svp = av_fetch(av, i, FALSE);
495                 SP[i+1] = (svp) ? *svp : &PL_sv_undef;
496             }
497         } 
498         else {
499             Copy(AvARRAY(av), SP+1, maxarg, SV*);
500         }
501         SP += maxarg;
502     }
503     else {
504         dTARGET;
505         I32 maxarg = AvFILL(av) + 1;
506         SETi(maxarg);
507     }
508     RETURN;
509 }
510
511 PP(pp_rv2hv)
512 {
513     djSP; dTOPss;
514     HV *hv;
515
516     if (SvROK(sv)) {
517       wasref:
518         tryAMAGICunDEREF(to_hv);
519
520         hv = (HV*)SvRV(sv);
521         if (SvTYPE(hv) != SVt_PVHV && SvTYPE(hv) != SVt_PVAV)
522             DIE("Not a HASH reference");
523         if (PL_op->op_flags & OPf_REF) {
524             SETs((SV*)hv);
525             RETURN;
526         }
527     }
528     else {
529         if (SvTYPE(sv) == SVt_PVHV || SvTYPE(sv) == SVt_PVAV) {
530             hv = (HV*)sv;
531             if (PL_op->op_flags & OPf_REF) {
532                 SETs((SV*)hv);
533                 RETURN;
534             }
535         }
536         else {
537             GV *gv;
538             
539             if (SvTYPE(sv) != SVt_PVGV) {
540                 char *sym;
541                 STRLEN n_a;
542
543                 if (SvGMAGICAL(sv)) {
544                     mg_get(sv);
545                     if (SvROK(sv))
546                         goto wasref;
547                 }
548                 if (!SvOK(sv)) {
549                     if (PL_op->op_flags & OPf_REF ||
550                       PL_op->op_private & HINT_STRICT_REFS)
551                         DIE(PL_no_usym, "a HASH");
552                     if (ckWARN(WARN_UNINITIALIZED))
553                         warner(WARN_UNINITIALIZED, PL_warn_uninit);
554                     if (GIMME == G_ARRAY) {
555                         SP--;
556                         RETURN;
557                     }
558                     RETSETUNDEF;
559                 }
560                 sym = SvPV(sv,n_a);
561                 if (PL_op->op_private & HINT_STRICT_REFS)
562                     DIE(PL_no_symref, sym, "a HASH");
563                 gv = (GV*)gv_fetchpv(sym, TRUE, SVt_PVHV);
564             } else {
565                 gv = (GV*)sv;
566             }
567             hv = GvHVn(gv);
568             if (PL_op->op_private & OPpLVAL_INTRO)
569                 hv = save_hash(gv);
570             if (PL_op->op_flags & OPf_REF) {
571                 SETs((SV*)hv);
572                 RETURN;
573             }
574         }
575     }
576
577     if (GIMME == G_ARRAY) { /* array wanted */
578         *PL_stack_sp = (SV*)hv;
579         return do_kv(ARGS);
580     }
581     else {
582         dTARGET;
583         if (SvTYPE(hv) == SVt_PVAV)
584             hv = avhv_keys((AV*)hv);
585         if (HvFILL(hv))
586             sv_setpvf(TARG, "%ld/%ld",
587                       (long)HvFILL(hv), (long)HvMAX(hv) + 1);
588         else
589             sv_setiv(TARG, 0);
590         
591         SETTARG;
592         RETURN;
593     }
594 }
595
596 PP(pp_aassign)
597 {
598     djSP;
599     SV **lastlelem = PL_stack_sp;
600     SV **lastrelem = PL_stack_base + POPMARK;
601     SV **firstrelem = PL_stack_base + POPMARK + 1;
602     SV **firstlelem = lastrelem + 1;
603
604     register SV **relem;
605     register SV **lelem;
606
607     register SV *sv;
608     register AV *ary;
609
610     I32 gimme;
611     HV *hash;
612     I32 i;
613     int magic;
614
615     PL_delaymagic = DM_DELAY;           /* catch simultaneous items */
616
617     /* If there's a common identifier on both sides we have to take
618      * special care that assigning the identifier on the left doesn't
619      * clobber a value on the right that's used later in the list.
620      */
621     if (PL_op->op_private & OPpASSIGN_COMMON) {
622         EXTEND_MORTAL(lastrelem - firstrelem + 1);
623         for (relem = firstrelem; relem <= lastrelem; relem++) {
624             /*SUPPRESS 560*/
625             if (sv = *relem) {
626                 TAINT_NOT;      /* Each item is independent */
627                 *relem = sv_mortalcopy(sv);
628             }
629         }
630     }
631
632     relem = firstrelem;
633     lelem = firstlelem;
634     ary = Null(AV*);
635     hash = Null(HV*);
636     while (lelem <= lastlelem) {
637         TAINT_NOT;              /* Each item stands on its own, taintwise. */
638         sv = *lelem++;
639         switch (SvTYPE(sv)) {
640         case SVt_PVAV:
641             ary = (AV*)sv;
642             magic = SvMAGICAL(ary) != 0;
643             
644             av_clear(ary);
645             av_extend(ary, lastrelem - relem);
646             i = 0;
647             while (relem <= lastrelem) {        /* gobble up all the rest */
648                 SV **didstore;
649                 sv = NEWSV(28,0);
650                 assert(*relem);
651                 sv_setsv(sv,*relem);
652                 *(relem++) = sv;
653                 didstore = av_store(ary,i++,sv);
654                 if (magic) {
655                     if (SvSMAGICAL(sv))
656                         mg_set(sv);
657                     if (!didstore)
658                         SvREFCNT_dec(sv);
659                 }
660                 TAINT_NOT;
661             }
662             break;
663         case SVt_PVHV: {
664                 SV *tmpstr;
665
666                 hash = (HV*)sv;
667                 magic = SvMAGICAL(hash) != 0;
668                 hv_clear(hash);
669
670                 while (relem < lastrelem) {     /* gobble up all the rest */
671                     HE *didstore;
672                     if (*relem)
673                         sv = *(relem++);
674                     else
675                         sv = &PL_sv_no, relem++;
676                     tmpstr = NEWSV(29,0);
677                     if (*relem)
678                         sv_setsv(tmpstr,*relem);        /* value */
679                     *(relem++) = tmpstr;
680                     didstore = hv_store_ent(hash,sv,tmpstr,0);
681                     if (magic) {
682                         if (SvSMAGICAL(tmpstr))
683                             mg_set(tmpstr);
684                         if (!didstore)
685                             SvREFCNT_dec(tmpstr);
686                     }
687                     TAINT_NOT;
688                 }
689                 if (relem == lastrelem) {
690                     if (*relem) {
691                         HE *didstore;
692                         if (ckWARN(WARN_UNSAFE)) {
693                             if (relem == firstrelem &&
694                                 SvROK(*relem) &&
695                                 ( SvTYPE(SvRV(*relem)) == SVt_PVAV ||
696                                   SvTYPE(SvRV(*relem)) == SVt_PVHV ) )
697                                 warner(WARN_UNSAFE, "Reference found where even-sized list expected");
698                             else
699                                 warner(WARN_UNSAFE, "Odd number of elements in hash assignment");
700                         }
701                         tmpstr = NEWSV(29,0);
702                         didstore = hv_store_ent(hash,*relem,tmpstr,0);
703                         if (magic) {
704                             if (SvSMAGICAL(tmpstr))
705                                 mg_set(tmpstr);
706                             if (!didstore)
707                                 SvREFCNT_dec(tmpstr);
708                         }
709                         TAINT_NOT;
710                     }
711                     relem++;
712                 }
713             }
714             break;
715         default:
716             if (SvTHINKFIRST(sv)) {
717                 if (SvREADONLY(sv) && PL_curcop != &PL_compiling) {
718                     if (!SvIMMORTAL(sv))
719                         DIE(PL_no_modify);
720                     if (relem <= lastrelem)
721                         relem++;
722                     break;
723                 }
724                 if (SvROK(sv))
725                     sv_unref(sv);
726             }
727             if (relem <= lastrelem) {
728                 sv_setsv(sv, *relem);
729                 *(relem++) = sv;
730             }
731             else
732                 sv_setsv(sv, &PL_sv_undef);
733             SvSETMAGIC(sv);
734             break;
735         }
736     }
737     if (PL_delaymagic & ~DM_DELAY) {
738         if (PL_delaymagic & DM_UID) {
739 #ifdef HAS_SETRESUID
740             (void)setresuid(PL_uid,PL_euid,(Uid_t)-1);
741 #else
742 #  ifdef HAS_SETREUID
743             (void)setreuid(PL_uid,PL_euid);
744 #  else
745 #    ifdef HAS_SETRUID
746             if ((PL_delaymagic & DM_UID) == DM_RUID) {
747                 (void)setruid(PL_uid);
748                 PL_delaymagic &= ~DM_RUID;
749             }
750 #    endif /* HAS_SETRUID */
751 #    ifdef HAS_SETEUID
752             if ((PL_delaymagic & DM_UID) == DM_EUID) {
753                 (void)seteuid(PL_uid);
754                 PL_delaymagic &= ~DM_EUID;
755             }
756 #    endif /* HAS_SETEUID */
757             if (PL_delaymagic & DM_UID) {
758                 if (PL_uid != PL_euid)
759                     DIE("No setreuid available");
760                 (void)PerlProc_setuid(PL_uid);
761             }
762 #  endif /* HAS_SETREUID */
763 #endif /* HAS_SETRESUID */
764             PL_uid = (int)PerlProc_getuid();
765             PL_euid = (int)PerlProc_geteuid();
766         }
767         if (PL_delaymagic & DM_GID) {
768 #ifdef HAS_SETRESGID
769             (void)setresgid(PL_gid,PL_egid,(Gid_t)-1);
770 #else
771 #  ifdef HAS_SETREGID
772             (void)setregid(PL_gid,PL_egid);
773 #  else
774 #    ifdef HAS_SETRGID
775             if ((PL_delaymagic & DM_GID) == DM_RGID) {
776                 (void)setrgid(PL_gid);
777                 PL_delaymagic &= ~DM_RGID;
778             }
779 #    endif /* HAS_SETRGID */
780 #    ifdef HAS_SETEGID
781             if ((PL_delaymagic & DM_GID) == DM_EGID) {
782                 (void)setegid(PL_gid);
783                 PL_delaymagic &= ~DM_EGID;
784             }
785 #    endif /* HAS_SETEGID */
786             if (PL_delaymagic & DM_GID) {
787                 if (PL_gid != PL_egid)
788                     DIE("No setregid available");
789                 (void)PerlProc_setgid(PL_gid);
790             }
791 #  endif /* HAS_SETREGID */
792 #endif /* HAS_SETRESGID */
793             PL_gid = (int)PerlProc_getgid();
794             PL_egid = (int)PerlProc_getegid();
795         }
796         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
797     }
798     PL_delaymagic = 0;
799
800     gimme = GIMME_V;
801     if (gimme == G_VOID)
802         SP = firstrelem - 1;
803     else if (gimme == G_SCALAR) {
804         dTARGET;
805         SP = firstrelem;
806         SETi(lastrelem - firstrelem + 1);
807     }
808     else {
809         if (ary || hash)
810             SP = lastrelem;
811         else
812             SP = firstrelem + (lastlelem - firstlelem);
813         lelem = firstlelem + (relem - firstrelem);
814         while (relem <= SP)
815             *relem++ = (lelem <= lastlelem) ? *lelem++ : &PL_sv_undef;
816     }
817     RETURN;
818 }
819
820 PP(pp_qr)
821 {
822     djSP;
823     register PMOP *pm = cPMOP;
824     SV *rv = sv_newmortal();
825     SV *sv = newSVrv(rv, "Regexp");
826     sv_magic(sv,(SV*)ReREFCNT_inc(pm->op_pmregexp),'r',0,0);
827     RETURNX(PUSHs(rv));
828 }
829
830 PP(pp_match)
831 {
832     djSP; dTARG;
833     register PMOP *pm = cPMOP;
834     register char *t;
835     register char *s;
836     char *strend;
837     I32 global;
838     I32 r_flags;
839     char *truebase;
840     register REGEXP *rx = pm->op_pmregexp;
841     bool rxtainted;
842     I32 gimme = GIMME;
843     STRLEN len;
844     I32 minmatch = 0;
845     I32 oldsave = PL_savestack_ix;
846     I32 update_minmatch = 1;
847
848     if (PL_op->op_flags & OPf_STACKED)
849         TARG = POPs;
850     else {
851         TARG = DEFSV;
852         EXTEND(SP,1);
853     }
854     PUTBACK;                            /* EVAL blocks need stack_sp. */
855     s = SvPV(TARG, len);
856     strend = s + len;
857     if (!s)
858         DIE("panic: do_match");
859     rxtainted = ((pm->op_pmdynflags & PMdf_TAINTED) ||
860                  (PL_tainted && (pm->op_pmflags & PMf_RETAINT)));
861     TAINT_NOT;
862
863     if (pm->op_pmdynflags & PMdf_USED) {
864       failure:
865         if (gimme == G_ARRAY)
866             RETURN;
867         RETPUSHNO;
868     }
869
870     if (!rx->prelen && PL_curpm) {
871         pm = PL_curpm;
872         rx = pm->op_pmregexp;
873     }
874     if (rx->minlen > len) goto failure;
875
876     truebase = t = s;
877     if (global = pm->op_pmflags & PMf_GLOBAL) {
878         rx->startp[0] = 0;
879         if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG)) {
880             MAGIC* mg = mg_find(TARG, 'g');
881             if (mg && mg->mg_len >= 0) {
882                 rx->endp[0] = rx->startp[0] = s + mg->mg_len; 
883                 minmatch = (mg->mg_flags & MGf_MINMATCH);
884                 update_minmatch = 0;
885             }
886         }
887     }
888     r_flags = ((gimme != G_ARRAY && !global && rx->nparens)
889                 || SvTEMP(TARG) || PL_sawampersand)
890                 ? REXEC_COPY_STR : 0;
891     if (SvSCREAM(TARG) && rx->check_substr
892         && SvTYPE(rx->check_substr) == SVt_PVBM
893         && SvVALID(rx->check_substr)) 
894         r_flags |= REXEC_SCREAM;
895
896     if (pm->op_pmflags & (PMf_MULTILINE|PMf_SINGLELINE)) {
897         SAVEINT(PL_multiline);
898         PL_multiline = pm->op_pmflags & PMf_MULTILINE;
899     }
900
901 play_it_again:
902     if (global && rx->startp[0]) {
903         t = s = rx->endp[0];
904         if ((s + rx->minlen) > strend)
905             goto nope;
906         if (update_minmatch++)
907             minmatch = (s == rx->startp[0]);
908     }
909     if (rx->check_substr) {
910         if (!(rx->reganch & ROPT_NOSCAN)) { /* Floating checkstring. */
911             if (r_flags & REXEC_SCREAM) {
912                 I32 p = -1;
913                 char *b;
914                 
915                 if (PL_screamfirst[BmRARE(rx->check_substr)] < 0)
916                     goto nope;
917
918                 b = (char*)HOP((U8*)s, rx->check_offset_min);
919                 if (!(s = screaminstr(TARG, rx->check_substr, b - s, 0, &p, 0)))
920                     goto nope;
921
922                 if ((rx->reganch & ROPT_CHECK_ALL)
923                          && !PL_sawampersand && !SvTAIL(rx->check_substr))
924                     goto yup;
925             }
926             else if (!(s = fbm_instr((unsigned char*)HOP((U8*)s, rx->check_offset_min),
927                                      (unsigned char*)strend, 
928                                      rx->check_substr, 0)))
929                 goto nope;
930             else if ((rx->reganch & ROPT_CHECK_ALL) && !PL_sawampersand)
931                 goto yup;
932             if (s && rx->check_offset_max < s - t) {
933                 ++BmUSEFUL(rx->check_substr);
934                 s = (char*)HOP((U8*)s, -rx->check_offset_max);
935             }
936             else
937                 s = t;
938         }
939         /* Now checkstring is fixed, i.e. at fixed offset from the
940            beginning of match, and the match is anchored at s. */
941         else if (!PL_multiline) {       /* Anchored near beginning of string. */
942             I32 slen;
943             char *b = (char*)HOP((U8*)s, rx->check_offset_min);
944             if (*SvPVX(rx->check_substr) != *b
945                 || ((slen = SvCUR(rx->check_substr)) > 1
946                     && memNE(SvPVX(rx->check_substr), b, slen)))
947                 goto nope;
948         }
949         if (!(rx->reganch & ROPT_NAUGHTY) && --BmUSEFUL(rx->check_substr) < 0
950             && rx->check_substr == rx->float_substr) {
951             SvREFCNT_dec(rx->check_substr);
952             rx->check_substr = Nullsv;  /* opt is being useless */
953             rx->float_substr = Nullsv;
954         }
955     }
956     if (CALLREGEXEC(rx, s, strend, truebase, minmatch, TARG, NULL, r_flags))
957     {
958         PL_curpm = pm;
959         if (pm->op_pmflags & PMf_ONCE)
960             pm->op_pmdynflags |= PMdf_USED;
961         goto gotcha;
962     }
963     else
964         goto ret_no;
965     /*NOTREACHED*/
966
967   gotcha:
968     if (rxtainted)
969         RX_MATCH_TAINTED_on(rx);
970     TAINT_IF(RX_MATCH_TAINTED(rx));
971     if (gimme == G_ARRAY) {
972         I32 iters, i, len;
973
974         iters = rx->nparens;
975         if (global && !iters)
976             i = 1;
977         else
978             i = 0;
979         SPAGAIN;                        /* EVAL blocks could move the stack. */
980         EXTEND(SP, iters + i);
981         EXTEND_MORTAL(iters + i);
982         for (i = !i; i <= iters; i++) {
983             PUSHs(sv_newmortal());
984             /*SUPPRESS 560*/
985             if ((s = rx->startp[i]) && rx->endp[i] ) {
986                 len = rx->endp[i] - s;
987                 sv_setpvn(*SP, s, len);
988             }
989         }
990         if (global) {
991             truebase = rx->subbeg;
992             strend = rx->subend;
993             if (rx->startp[0] && rx->startp[0] == rx->endp[0])
994                 ++rx->endp[0];
995             PUTBACK;                    /* EVAL blocks may use stack */
996             goto play_it_again;
997         }
998         else if (!iters)
999             XPUSHs(&PL_sv_yes);
1000         LEAVE_SCOPE(oldsave);
1001         RETURN;
1002     }
1003     else {
1004         if (global) {
1005             MAGIC* mg = 0;
1006             if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG))
1007                 mg = mg_find(TARG, 'g');
1008             if (!mg) {
1009                 sv_magic(TARG, (SV*)0, 'g', Nullch, 0);
1010                 mg = mg_find(TARG, 'g');
1011             }
1012             if (rx->startp[0]) {
1013                 mg->mg_len = rx->endp[0] - rx->subbeg;
1014                 if (rx->startp[0] == rx->endp[0])
1015                     mg->mg_flags |= MGf_MINMATCH;
1016                 else
1017                     mg->mg_flags &= ~MGf_MINMATCH;
1018             }
1019         }
1020         LEAVE_SCOPE(oldsave);
1021         RETPUSHYES;
1022     }
1023
1024 yup:                                    /* Confirmed by check_substr */
1025     if (rxtainted)
1026         RX_MATCH_TAINTED_on(rx);
1027     TAINT_IF(RX_MATCH_TAINTED(rx));
1028     ++BmUSEFUL(rx->check_substr);
1029     PL_curpm = pm;
1030     if (pm->op_pmflags & PMf_ONCE)
1031         pm->op_pmdynflags |= PMdf_USED;
1032     Safefree(rx->subbase);
1033     rx->subbase = Nullch;
1034     if (global) {
1035         rx->subbeg = truebase;
1036         rx->subend = strend;
1037         rx->startp[0] = s;
1038         rx->endp[0] = s + SvCUR(rx->check_substr);
1039         goto gotcha;
1040     }
1041     if (PL_sawampersand) {
1042         char *tmps;
1043
1044         tmps = rx->subbase = savepvn(t, strend-t);
1045         rx->subbeg = tmps;
1046         rx->subend = tmps + (strend-t);
1047         tmps = rx->startp[0] = tmps + (s - t);
1048         rx->endp[0] = tmps + SvCUR(rx->check_substr);
1049     }
1050     LEAVE_SCOPE(oldsave);
1051     RETPUSHYES;
1052
1053 nope:
1054     if (rx->check_substr)
1055         ++BmUSEFUL(rx->check_substr);
1056
1057 ret_no:
1058     if (global && !(pm->op_pmflags & PMf_CONTINUE)) {
1059         if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG)) {
1060             MAGIC* mg = mg_find(TARG, 'g');
1061             if (mg)
1062                 mg->mg_len = -1;
1063         }
1064     }
1065     LEAVE_SCOPE(oldsave);
1066     if (gimme == G_ARRAY)
1067         RETURN;
1068     RETPUSHNO;
1069 }
1070
1071 OP *
1072 do_readline(void)
1073 {
1074     dSP; dTARGETSTACKED;
1075     register SV *sv;
1076     STRLEN tmplen = 0;
1077     STRLEN offset;
1078     PerlIO *fp;
1079     register IO *io = GvIO(PL_last_in_gv);
1080     register I32 type = PL_op->op_type;
1081     I32 gimme = GIMME_V;
1082     MAGIC *mg;
1083
1084     if (mg = SvTIED_mg((SV*)PL_last_in_gv, 'q')) {
1085         PUSHMARK(SP);
1086         XPUSHs(SvTIED_obj((SV*)PL_last_in_gv, mg));
1087         PUTBACK;
1088         ENTER;
1089         perl_call_method("READLINE", gimme);
1090         LEAVE;
1091         SPAGAIN;
1092         if (gimme == G_SCALAR)
1093             SvSetMagicSV_nosteal(TARG, TOPs);
1094         RETURN;
1095     }
1096     fp = Nullfp;
1097     if (io) {
1098         fp = IoIFP(io);
1099         if (!fp) {
1100             if (IoFLAGS(io) & IOf_ARGV) {
1101                 if (IoFLAGS(io) & IOf_START) {
1102                     IoFLAGS(io) &= ~IOf_START;
1103                     IoLINES(io) = 0;
1104                     if (av_len(GvAVn(PL_last_in_gv)) < 0) {
1105                         do_open(PL_last_in_gv,"-",1,FALSE,O_RDONLY,0,Nullfp);
1106                         sv_setpvn(GvSV(PL_last_in_gv), "-", 1);
1107                         SvSETMAGIC(GvSV(PL_last_in_gv));
1108                         fp = IoIFP(io);
1109                         goto have_fp;
1110                     }
1111                 }
1112                 fp = nextargv(PL_last_in_gv);
1113                 if (!fp) { /* Note: fp != IoIFP(io) */
1114                     (void)do_close(PL_last_in_gv, FALSE); /* now it does*/
1115                     IoFLAGS(io) |= IOf_START;
1116                 }
1117             }
1118             else if (type == OP_GLOB) {
1119                 SV *tmpcmd = NEWSV(55, 0);
1120                 SV *tmpglob = POPs;
1121                 ENTER;
1122                 SAVEFREESV(tmpcmd);
1123 #ifdef VMS /* expand the wildcards right here, rather than opening a pipe, */
1124            /* since spawning off a process is a real performance hit */
1125                 {
1126 #include <descrip.h>
1127 #include <lib$routines.h>
1128 #include <nam.h>
1129 #include <rmsdef.h>
1130                     char rslt[NAM$C_MAXRSS+1+sizeof(unsigned short int)] = {'\0','\0'};
1131                     char vmsspec[NAM$C_MAXRSS+1];
1132                     char *rstr = rslt + sizeof(unsigned short int), *begin, *end, *cp;
1133                     char tmpfnam[L_tmpnam] = "SYS$SCRATCH:";
1134                     $DESCRIPTOR(dfltdsc,"SYS$DISK:[]*.*;");
1135                     PerlIO *tmpfp;
1136                     STRLEN i;
1137                     struct dsc$descriptor_s wilddsc
1138                        = {0, DSC$K_DTYPE_T, DSC$K_CLASS_S, 0};
1139                     struct dsc$descriptor_vs rsdsc
1140                        = {sizeof rslt, DSC$K_DTYPE_VT, DSC$K_CLASS_VS, rslt};
1141                     unsigned long int cxt = 0, sts = 0, ok = 1, hasdir = 0, hasver = 0, isunix = 0;
1142
1143                     /* We could find out if there's an explicit dev/dir or version
1144                        by peeking into lib$find_file's internal context at
1145                        ((struct NAM *)((struct FAB *)cxt)->fab$l_nam)->nam$l_fnb
1146                        but that's unsupported, so I don't want to do it now and
1147                        have it bite someone in the future. */
1148                     strcat(tmpfnam,PerlLIO_tmpnam(NULL));
1149                     cp = SvPV(tmpglob,i);
1150                     for (; i; i--) {
1151                        if (cp[i] == ';') hasver = 1;
1152                        if (cp[i] == '.') {
1153                            if (sts) hasver = 1;
1154                            else sts = 1;
1155                        }
1156                        if (cp[i] == '/') {
1157                           hasdir = isunix = 1;
1158                           break;
1159                        }
1160                        if (cp[i] == ']' || cp[i] == '>' || cp[i] == ':') {
1161                            hasdir = 1;
1162                            break;
1163                        }
1164                     }
1165                     if ((tmpfp = PerlIO_open(tmpfnam,"w+","fop=dlt")) != NULL) {
1166                         Stat_t st;
1167                         if (!PerlLIO_stat(SvPVX(tmpglob),&st) && S_ISDIR(st.st_mode))
1168                           ok = ((wilddsc.dsc$a_pointer = tovmspath(SvPVX(tmpglob),vmsspec)) != NULL);
1169                         else ok = ((wilddsc.dsc$a_pointer = tovmsspec(SvPVX(tmpglob),vmsspec)) != NULL);
1170                         if (ok) wilddsc.dsc$w_length = (unsigned short int) strlen(wilddsc.dsc$a_pointer);
1171                         while (ok && ((sts = lib$find_file(&wilddsc,&rsdsc,&cxt,
1172                                                     &dfltdsc,NULL,NULL,NULL))&1)) {
1173                             end = rstr + (unsigned long int) *rslt;
1174                             if (!hasver) while (*end != ';') end--;
1175                             *(end++) = '\n';  *end = '\0';
1176                             for (cp = rstr; *cp; cp++) *cp = _tolower(*cp);
1177                             if (hasdir) {
1178                               if (isunix) trim_unixpath(rstr,SvPVX(tmpglob),1);
1179                               begin = rstr;
1180                             }
1181                             else {
1182                                 begin = end;
1183                                 while (*(--begin) != ']' && *begin != '>') ;
1184                                 ++begin;
1185                             }
1186                             ok = (PerlIO_puts(tmpfp,begin) != EOF);
1187                         }
1188                         if (cxt) (void)lib$find_file_end(&cxt);
1189                         if (ok && sts != RMS$_NMF &&
1190                             sts != RMS$_DNF && sts != RMS$_FNF) ok = 0;
1191                         if (!ok) {
1192                             if (!(sts & 1)) {
1193                               SETERRNO((sts == RMS$_SYN ? EINVAL : EVMSERR),sts);
1194                             }
1195                             PerlIO_close(tmpfp);
1196                             fp = NULL;
1197                         }
1198                         else {
1199                            PerlIO_rewind(tmpfp);
1200                            IoTYPE(io) = '<';
1201                            IoIFP(io) = fp = tmpfp;
1202                            IoFLAGS(io) &= ~IOf_UNTAINT;  /* maybe redundant */
1203                         }
1204                     }
1205                 }
1206 #else /* !VMS */
1207 #ifdef DOSISH
1208 #ifdef OS2
1209                 sv_setpv(tmpcmd, "for a in ");
1210                 sv_catsv(tmpcmd, tmpglob);
1211                 sv_catpv(tmpcmd, "; do echo \"$a\\0\\c\"; done |");
1212 #else
1213 #ifdef DJGPP
1214                 sv_setpv(tmpcmd, "/dev/dosglob/"); /* File System Extension */
1215                 sv_catsv(tmpcmd, tmpglob);
1216 #else
1217                 sv_setpv(tmpcmd, "perlglob ");
1218                 sv_catsv(tmpcmd, tmpglob);
1219                 sv_catpv(tmpcmd, " |");
1220 #endif /* !DJGPP */
1221 #endif /* !OS2 */
1222 #else /* !DOSISH */
1223 #if defined(CSH)
1224                 sv_setpvn(tmpcmd, PL_cshname, PL_cshlen);
1225                 sv_catpv(tmpcmd, " -cf 'set nonomatch; glob ");
1226                 sv_catsv(tmpcmd, tmpglob);
1227                 sv_catpv(tmpcmd, "' 2>/dev/null |");
1228 #else
1229                 sv_setpv(tmpcmd, "echo ");
1230                 sv_catsv(tmpcmd, tmpglob);
1231 #if 'z' - 'a' == 25
1232                 sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\012\\012\\012\\012'|");
1233 #else
1234                 sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\n\\n\\n\\n'|");
1235 #endif
1236 #endif /* !CSH */
1237 #endif /* !DOSISH */
1238                 (void)do_open(PL_last_in_gv, SvPVX(tmpcmd), SvCUR(tmpcmd),
1239                               FALSE, O_RDONLY, 0, Nullfp);
1240                 fp = IoIFP(io);
1241 #endif /* !VMS */
1242                 LEAVE;
1243             }
1244         }
1245         else if (type == OP_GLOB)
1246             SP--;
1247     }
1248     if (!fp) {
1249         if (ckWARN(WARN_CLOSED) && io && !(IoFLAGS(io) & IOf_START))
1250             warner(WARN_CLOSED,
1251                    "Read on closed filehandle <%s>", GvENAME(PL_last_in_gv));
1252         if (gimme == G_SCALAR) {
1253             (void)SvOK_off(TARG);
1254             PUSHTARG;
1255         }
1256         RETURN;
1257     }
1258   have_fp:
1259     if (gimme == G_SCALAR) {
1260         sv = TARG;
1261         if (SvROK(sv))
1262             sv_unref(sv);
1263         (void)SvUPGRADE(sv, SVt_PV);
1264         tmplen = SvLEN(sv);     /* remember if already alloced */
1265         if (!tmplen)
1266             Sv_Grow(sv, 80);    /* try short-buffering it */
1267         if (type == OP_RCATLINE)
1268             offset = SvCUR(sv);
1269         else
1270             offset = 0;
1271     }
1272     else {
1273         sv = sv_2mortal(NEWSV(57, 80));
1274         offset = 0;
1275     }
1276     for (;;) {
1277         if (!sv_gets(sv, fp, offset)) {
1278             PerlIO_clearerr(fp);
1279             if (IoFLAGS(io) & IOf_ARGV) {
1280                 fp = nextargv(PL_last_in_gv);
1281                 if (fp)
1282                     continue;
1283                 (void)do_close(PL_last_in_gv, FALSE);
1284                 IoFLAGS(io) |= IOf_START;
1285             }
1286             else if (type == OP_GLOB) {
1287                 if (!do_close(PL_last_in_gv, FALSE) && ckWARN(WARN_CLOSED)) {
1288                     warner(WARN_CLOSED,
1289                            "glob failed (child exited with status %d%s)",
1290                            STATUS_CURRENT >> 8,
1291                            (STATUS_CURRENT & 0x80) ? ", core dumped" : "");
1292                 }
1293             }
1294             if (gimme == G_SCALAR) {
1295                 (void)SvOK_off(TARG);
1296                 PUSHTARG;
1297             }
1298             RETURN;
1299         }
1300         /* This should not be marked tainted if the fp is marked clean */
1301         if (!(IoFLAGS(io) & IOf_UNTAINT)) {
1302             TAINT;
1303             SvTAINTED_on(sv);
1304         }
1305         IoLINES(io)++;
1306         SvSETMAGIC(sv);
1307         XPUSHs(sv);
1308         if (type == OP_GLOB) {
1309             char *tmps;
1310
1311             if (SvCUR(sv) > 0 && SvCUR(PL_rs) > 0) {
1312                 tmps = SvEND(sv) - 1;
1313                 if (*tmps == *SvPVX(PL_rs)) {
1314                     *tmps = '\0';
1315                     SvCUR(sv)--;
1316                 }
1317             }
1318             for (tmps = SvPVX(sv); *tmps; tmps++)
1319                 if (!isALPHA(*tmps) && !isDIGIT(*tmps) &&
1320                     strchr("$&*(){}[]'\";\\|?<>~`", *tmps))
1321                         break;
1322             if (*tmps && PerlLIO_stat(SvPVX(sv), &PL_statbuf) < 0) {
1323                 (void)POPs;             /* Unmatched wildcard?  Chuck it... */
1324                 continue;
1325             }
1326         }
1327         if (gimme == G_ARRAY) {
1328             if (SvLEN(sv) - SvCUR(sv) > 20) {
1329                 SvLEN_set(sv, SvCUR(sv)+1);
1330                 Renew(SvPVX(sv), SvLEN(sv), char);
1331             }
1332             sv = sv_2mortal(NEWSV(58, 80));
1333             continue;
1334         }
1335         else if (gimme == G_SCALAR && !tmplen && SvLEN(sv) - SvCUR(sv) > 80) {
1336             /* try to reclaim a bit of scalar space (only on 1st alloc) */
1337             if (SvCUR(sv) < 60)
1338                 SvLEN_set(sv, 80);
1339             else
1340                 SvLEN_set(sv, SvCUR(sv)+40);    /* allow some slop */
1341             Renew(SvPVX(sv), SvLEN(sv), char);
1342         }
1343         RETURN;
1344     }
1345 }
1346
1347 PP(pp_enter)
1348 {
1349     djSP;
1350     register PERL_CONTEXT *cx;
1351     I32 gimme = OP_GIMME(PL_op, -1);
1352
1353     if (gimme == -1) {
1354         if (cxstack_ix >= 0)
1355             gimme = cxstack[cxstack_ix].blk_gimme;
1356         else
1357             gimme = G_SCALAR;
1358     }
1359
1360     ENTER;
1361
1362     SAVETMPS;
1363     PUSHBLOCK(cx, CXt_BLOCK, SP);
1364
1365     RETURN;
1366 }
1367
1368 PP(pp_helem)
1369 {
1370     djSP;
1371     HE* he;
1372     SV **svp;
1373     SV *keysv = POPs;
1374     HV *hv = (HV*)POPs;
1375     U32 lval = PL_op->op_flags & OPf_MOD;
1376     U32 defer = PL_op->op_private & OPpLVAL_DEFER;
1377     SV *sv;
1378
1379     if (SvTYPE(hv) == SVt_PVHV) {
1380         he = hv_fetch_ent(hv, keysv, lval && !defer, 0);
1381         svp = he ? &HeVAL(he) : 0;
1382     }
1383     else if (SvTYPE(hv) == SVt_PVAV) {
1384         if (PL_op->op_private & OPpLVAL_INTRO)
1385             DIE("Can't localize pseudo-hash element");
1386         svp = avhv_fetch_ent((AV*)hv, keysv, lval && !defer, 0);
1387     }
1388     else {
1389         RETPUSHUNDEF;
1390     }
1391     if (lval) {
1392         if (!svp || *svp == &PL_sv_undef) {
1393             SV* lv;
1394             SV* key2;
1395             if (!defer) {
1396                 STRLEN n_a;
1397                 DIE(PL_no_helem, SvPV(keysv, n_a));
1398             }
1399             lv = sv_newmortal();
1400             sv_upgrade(lv, SVt_PVLV);
1401             LvTYPE(lv) = 'y';
1402             sv_magic(lv, key2 = newSVsv(keysv), 'y', Nullch, 0);
1403             SvREFCNT_dec(key2); /* sv_magic() increments refcount */
1404             LvTARG(lv) = SvREFCNT_inc(hv);
1405             LvTARGLEN(lv) = 1;
1406             PUSHs(lv);
1407             RETURN;
1408         }
1409         if (PL_op->op_private & OPpLVAL_INTRO) {
1410             if (HvNAME(hv) && isGV(*svp))
1411                 save_gp((GV*)*svp, !(PL_op->op_flags & OPf_SPECIAL));
1412             else
1413                 save_helem(hv, keysv, svp);
1414         }
1415         else if (PL_op->op_private & OPpDEREF)
1416             vivify_ref(*svp, PL_op->op_private & OPpDEREF);
1417     }
1418     sv = (svp ? *svp : &PL_sv_undef);
1419     /* This makes C<local $tied{foo} = $tied{foo}> possible.
1420      * Pushing the magical RHS on to the stack is useless, since
1421      * that magic is soon destined to be misled by the local(),
1422      * and thus the later pp_sassign() will fail to mg_get() the
1423      * old value.  This should also cure problems with delayed
1424      * mg_get()s.  GSAR 98-07-03 */
1425     if (!lval && SvGMAGICAL(sv))
1426         sv = sv_mortalcopy(sv);
1427     PUSHs(sv);
1428     RETURN;
1429 }
1430
1431 PP(pp_leave)
1432 {
1433     djSP;
1434     register PERL_CONTEXT *cx;
1435     register SV **mark;
1436     SV **newsp;
1437     PMOP *newpm;
1438     I32 gimme;
1439
1440     if (PL_op->op_flags & OPf_SPECIAL) {
1441         cx = &cxstack[cxstack_ix];
1442         cx->blk_oldpm = PL_curpm;       /* fake block should preserve $1 et al */
1443     }
1444
1445     POPBLOCK(cx,newpm);
1446
1447     gimme = OP_GIMME(PL_op, -1);
1448     if (gimme == -1) {
1449         if (cxstack_ix >= 0)
1450             gimme = cxstack[cxstack_ix].blk_gimme;
1451         else
1452             gimme = G_SCALAR;
1453     }
1454
1455     TAINT_NOT;
1456     if (gimme == G_VOID)
1457         SP = newsp;
1458     else if (gimme == G_SCALAR) {
1459         MARK = newsp + 1;
1460         if (MARK <= SP)
1461             if (SvFLAGS(TOPs) & (SVs_PADTMP|SVs_TEMP))
1462                 *MARK = TOPs;
1463             else
1464                 *MARK = sv_mortalcopy(TOPs);
1465         else {
1466             MEXTEND(mark,0);
1467             *MARK = &PL_sv_undef;
1468         }
1469         SP = MARK;
1470     }
1471     else if (gimme == G_ARRAY) {
1472         /* in case LEAVE wipes old return values */
1473         for (mark = newsp + 1; mark <= SP; mark++) {
1474             if (!(SvFLAGS(*mark) & (SVs_PADTMP|SVs_TEMP))) {
1475                 *mark = sv_mortalcopy(*mark);
1476                 TAINT_NOT;      /* Each item is independent */
1477             }
1478         }
1479     }
1480     PL_curpm = newpm;   /* Don't pop $1 et al till now */
1481
1482     LEAVE;
1483
1484     RETURN;
1485 }
1486
1487 PP(pp_iter)
1488 {
1489     djSP;
1490     register PERL_CONTEXT *cx;
1491     SV* sv;
1492     AV* av;
1493
1494     EXTEND(SP, 1);
1495     cx = &cxstack[cxstack_ix];
1496     if (CxTYPE(cx) != CXt_LOOP)
1497         DIE("panic: pp_iter");
1498
1499     av = cx->blk_loop.iterary;
1500     if (SvTYPE(av) != SVt_PVAV) {
1501         /* iterate ($min .. $max) */
1502         if (cx->blk_loop.iterlval) {
1503             /* string increment */
1504             register SV* cur = cx->blk_loop.iterlval;
1505             STRLEN maxlen;
1506             char *max = SvPV((SV*)av, maxlen);
1507             if (!SvNIOK(cur) && SvCUR(cur) <= maxlen) {
1508 #ifndef USE_THREADS                       /* don't risk potential race */
1509                 if (SvREFCNT(*cx->blk_loop.itervar) == 1
1510                     && !SvMAGICAL(*cx->blk_loop.itervar))
1511                 {
1512                     /* safe to reuse old SV */
1513                     sv_setsv(*cx->blk_loop.itervar, cur);
1514                 }
1515                 else 
1516 #endif
1517                 {
1518                     /* we need a fresh SV every time so that loop body sees a
1519                      * completely new SV for closures/references to work as
1520                      * they used to */
1521                     SvREFCNT_dec(*cx->blk_loop.itervar);
1522                     *cx->blk_loop.itervar = newSVsv(cur);
1523                 }
1524                 if (strEQ(SvPVX(cur), max))
1525                     sv_setiv(cur, 0); /* terminate next time */
1526                 else
1527                     sv_inc(cur);
1528                 RETPUSHYES;
1529             }
1530             RETPUSHNO;
1531         }
1532         /* integer increment */
1533         if (cx->blk_loop.iterix > cx->blk_loop.itermax)
1534             RETPUSHNO;
1535
1536 #ifndef USE_THREADS                       /* don't risk potential race */
1537         if (SvREFCNT(*cx->blk_loop.itervar) == 1
1538             && !SvMAGICAL(*cx->blk_loop.itervar))
1539         {
1540             /* safe to reuse old SV */
1541             sv_setiv(*cx->blk_loop.itervar, cx->blk_loop.iterix++);
1542         }
1543         else 
1544 #endif
1545         {
1546             /* we need a fresh SV every time so that loop body sees a
1547              * completely new SV for closures/references to work as they
1548              * used to */
1549             SvREFCNT_dec(*cx->blk_loop.itervar);
1550             *cx->blk_loop.itervar = newSViv(cx->blk_loop.iterix++);
1551         }
1552         RETPUSHYES;
1553     }
1554
1555     /* iterate array */
1556     if (cx->blk_loop.iterix >= (av == PL_curstack ? cx->blk_oldsp : AvFILL(av)))
1557         RETPUSHNO;
1558
1559     SvREFCNT_dec(*cx->blk_loop.itervar);
1560
1561     if (sv = (SvMAGICAL(av)) 
1562             ? *av_fetch(av, ++cx->blk_loop.iterix, FALSE) 
1563             : AvARRAY(av)[++cx->blk_loop.iterix])
1564         SvTEMP_off(sv);
1565     else
1566         sv = &PL_sv_undef;
1567     if (av != PL_curstack && SvIMMORTAL(sv)) {
1568         SV *lv = cx->blk_loop.iterlval;
1569         if (lv && SvREFCNT(lv) > 1) {
1570             SvREFCNT_dec(lv);
1571             lv = Nullsv;
1572         }
1573         if (lv)
1574             SvREFCNT_dec(LvTARG(lv));
1575         else {
1576             lv = cx->blk_loop.iterlval = NEWSV(26, 0);
1577             sv_upgrade(lv, SVt_PVLV);
1578             LvTYPE(lv) = 'y';
1579             sv_magic(lv, Nullsv, 'y', Nullch, 0);
1580         }
1581         LvTARG(lv) = SvREFCNT_inc(av);
1582         LvTARGOFF(lv) = cx->blk_loop.iterix;
1583         LvTARGLEN(lv) = (UV) -1;
1584         sv = (SV*)lv;
1585     }
1586
1587     *cx->blk_loop.itervar = SvREFCNT_inc(sv);
1588     RETPUSHYES;
1589 }
1590
1591 PP(pp_subst)
1592 {
1593     djSP; dTARG;
1594     register PMOP *pm = cPMOP;
1595     PMOP *rpm = pm;
1596     register SV *dstr;
1597     register char *s;
1598     char *strend;
1599     register char *m;
1600     char *c;
1601     register char *d;
1602     STRLEN clen;
1603     I32 iters = 0;
1604     I32 maxiters;
1605     register I32 i;
1606     bool once;
1607     bool rxtainted;
1608     char *orig;
1609     I32 r_flags;
1610     register REGEXP *rx = pm->op_pmregexp;
1611     STRLEN len;
1612     int force_on_match = 0;
1613     I32 oldsave = PL_savestack_ix;
1614     I32 update_minmatch = 1;
1615
1616     /* known replacement string? */
1617     dstr = (pm->op_pmflags & PMf_CONST) ? POPs : Nullsv;
1618     if (PL_op->op_flags & OPf_STACKED)
1619         TARG = POPs;
1620     else {
1621         TARG = DEFSV;
1622         EXTEND(SP,1);
1623     }                  
1624     if (SvREADONLY(TARG)
1625         || (SvTYPE(TARG) > SVt_PVLV
1626             && !(SvTYPE(TARG) == SVt_PVGV && SvFAKE(TARG))))
1627         croak(PL_no_modify);
1628     PUTBACK;
1629
1630     s = SvPV(TARG, len);
1631     if (!SvPOKp(TARG) || SvTYPE(TARG) == SVt_PVGV)
1632         force_on_match = 1;
1633     rxtainted = ((pm->op_pmdynflags & PMdf_TAINTED) ||
1634                  (PL_tainted && (pm->op_pmflags & PMf_RETAINT)));
1635     if (PL_tainted)
1636         rxtainted |= 2;
1637     TAINT_NOT;
1638
1639   force_it:
1640     if (!pm || !s)
1641         DIE("panic: do_subst");
1642
1643     strend = s + len;
1644     maxiters = 2*(strend - s) + 10;     /* We can match twice at each 
1645                                            position, once with zero-length,
1646                                            second time with non-zero. */
1647
1648     if (!rx->prelen && PL_curpm) {
1649         pm = PL_curpm;
1650         rx = pm->op_pmregexp;
1651     }
1652     r_flags = (rx->nparens || SvTEMP(TARG) || PL_sawampersand)
1653                 ? REXEC_COPY_STR : 0;
1654     if (SvSCREAM(TARG) && rx->check_substr
1655                   && SvTYPE(rx->check_substr) == SVt_PVBM
1656                   && SvVALID(rx->check_substr))
1657         r_flags |= REXEC_SCREAM;
1658     if (pm->op_pmflags & (PMf_MULTILINE|PMf_SINGLELINE)) {
1659         SAVEINT(PL_multiline);
1660         PL_multiline = pm->op_pmflags & PMf_MULTILINE;
1661     }
1662     orig = m = s;
1663     if (rx->check_substr) {
1664         if (!(rx->reganch & ROPT_NOSCAN)) { /* It floats. */
1665             if (r_flags & REXEC_SCREAM) {
1666                 I32 p = -1;
1667                 char *b;
1668                 
1669                 if (PL_screamfirst[BmRARE(rx->check_substr)] < 0)
1670                     goto nope;
1671
1672                 b = (char*)HOP((U8*)s, rx->check_offset_min);
1673                 if (!(s = screaminstr(TARG, rx->check_substr, b - s, 0, &p, 0)))
1674                     goto nope;
1675             }
1676             else if (!(s = fbm_instr((unsigned char*)HOP((U8*)s, rx->check_offset_min), 
1677                                      (unsigned char*)strend,
1678                                      rx->check_substr, 0)))
1679                 goto nope;
1680             if (s && rx->check_offset_max < s - m) {
1681                 ++BmUSEFUL(rx->check_substr);
1682                 s = (char*)HOP((U8*)s, -rx->check_offset_max);
1683             }
1684             else
1685                 s = m;
1686         }
1687         /* Now checkstring is fixed, i.e. at fixed offset from the
1688            beginning of match, and the match is anchored at s. */
1689         else if (!PL_multiline) { /* Anchored at beginning of string. */
1690             I32 slen;
1691             char *b = (char*)HOP((U8*)s, rx->check_offset_min);
1692             if (*SvPVX(rx->check_substr) != *b
1693                 || ((slen = SvCUR(rx->check_substr)) > 1
1694                     && memNE(SvPVX(rx->check_substr), b, slen)))
1695                 goto nope;
1696         }
1697         if (!(rx->reganch & ROPT_NAUGHTY) && --BmUSEFUL(rx->check_substr) < 0
1698             && rx->check_substr == rx->float_substr) {
1699             SvREFCNT_dec(rx->check_substr);
1700             rx->check_substr = Nullsv;  /* opt is being useless */
1701             rx->float_substr = Nullsv;
1702         }
1703     }
1704
1705     /* only replace once? */
1706     once = !(rpm->op_pmflags & PMf_GLOBAL);
1707
1708     /* known replacement string? */
1709     c = dstr ? SvPV(dstr, clen) : Nullch;
1710
1711     /* can do inplace substitution? */
1712     if (c && clen <= rx->minlen && (once || !(r_flags & REXEC_COPY_STR))
1713         && !(rx->reganch & ROPT_LOOKBEHIND_SEEN)) {
1714         if (!CALLREGEXEC(rx, s, strend, orig, 0, TARG, NULL, r_flags)) {
1715             SPAGAIN;
1716             PUSHs(&PL_sv_no);
1717             LEAVE_SCOPE(oldsave);
1718             RETURN;
1719         }
1720         if (force_on_match) {
1721             force_on_match = 0;
1722             s = SvPV_force(TARG, len);
1723             goto force_it;
1724         }
1725         d = s;
1726         PL_curpm = pm;
1727         SvSCREAM_off(TARG);     /* disable possible screamer */
1728         if (once) {
1729             rxtainted |= RX_MATCH_TAINTED(rx);
1730             if (rx->subbase) {
1731                 m = orig + (rx->startp[0] - rx->subbase);
1732                 d = orig + (rx->endp[0] - rx->subbase);
1733             } else {
1734                 m = rx->startp[0];
1735                 d = rx->endp[0];
1736             }
1737             s = orig;
1738             if (m - s > strend - d) {  /* faster to shorten from end */
1739                 if (clen) {
1740                     Copy(c, m, clen, char);
1741                     m += clen;
1742                 }
1743                 i = strend - d;
1744                 if (i > 0) {
1745                     Move(d, m, i, char);
1746                     m += i;
1747                 }
1748                 *m = '\0';
1749                 SvCUR_set(TARG, m - s);
1750             }
1751             /*SUPPRESS 560*/
1752             else if (i = m - s) {       /* faster from front */
1753                 d -= clen;
1754                 m = d;
1755                 sv_chop(TARG, d-i);
1756                 s += i;
1757                 while (i--)
1758                     *--d = *--s;
1759                 if (clen)
1760                     Copy(c, m, clen, char);
1761             }
1762             else if (clen) {
1763                 d -= clen;
1764                 sv_chop(TARG, d);
1765                 Copy(c, d, clen, char);
1766             }
1767             else {
1768                 sv_chop(TARG, d);
1769             }
1770             TAINT_IF(rxtainted & 1);
1771             SPAGAIN;
1772             PUSHs(&PL_sv_yes);
1773         }
1774         else {
1775             do {
1776                 if (iters++ > maxiters)
1777                     DIE("Substitution loop");
1778                 rxtainted |= RX_MATCH_TAINTED(rx);
1779                 m = rx->startp[0];
1780                 /*SUPPRESS 560*/
1781                 if (i = m - s) {
1782                     if (s != d)
1783                         Move(s, d, i, char);
1784                     d += i;
1785                 }
1786                 if (clen) {
1787                     Copy(c, d, clen, char);
1788                     d += clen;
1789                 }
1790                 s = rx->endp[0];
1791             } while (CALLREGEXEC(rx, s, strend, orig, s == m,
1792                               Nullsv, NULL, 0)); /* don't match same null twice */
1793             if (s != d) {
1794                 i = strend - s;
1795                 SvCUR_set(TARG, d - SvPVX(TARG) + i);
1796                 Move(s, d, i+1, char);          /* include the NUL */
1797             }
1798             TAINT_IF(rxtainted & 1);
1799             SPAGAIN;
1800             PUSHs(sv_2mortal(newSViv((I32)iters)));
1801         }
1802         (void)SvPOK_only(TARG);
1803         TAINT_IF(rxtainted);
1804         if (SvSMAGICAL(TARG)) {
1805             PUTBACK;
1806             mg_set(TARG);
1807             SPAGAIN;
1808         }
1809         SvTAINT(TARG);
1810         LEAVE_SCOPE(oldsave);
1811         RETURN;
1812     }
1813
1814     if (CALLREGEXEC(rx, s, strend, orig, 0, TARG, NULL, r_flags)) {
1815         if (force_on_match) {
1816             force_on_match = 0;
1817             s = SvPV_force(TARG, len);
1818             goto force_it;
1819         }
1820         rxtainted |= RX_MATCH_TAINTED(rx);
1821         dstr = NEWSV(25, len);
1822         sv_setpvn(dstr, m, s-m);
1823         PL_curpm = pm;
1824         if (!c) {
1825             register PERL_CONTEXT *cx;
1826             SPAGAIN;
1827             PUSHSUBST(cx);
1828             RETURNOP(cPMOP->op_pmreplroot);
1829         }
1830         do {
1831             if (iters++ > maxiters)
1832                 DIE("Substitution loop");
1833             rxtainted |= RX_MATCH_TAINTED(rx);
1834             if (rx->subbase && rx->subbase != orig) {
1835                 m = s;
1836                 s = orig;
1837                 orig = rx->subbase;
1838                 s = orig + (m - s);
1839                 strend = s + (strend - m);
1840             }
1841             m = rx->startp[0];
1842             sv_catpvn(dstr, s, m-s);
1843             s = rx->endp[0];
1844             if (clen)
1845                 sv_catpvn(dstr, c, clen);
1846             if (once)
1847                 break;
1848         } while (CALLREGEXEC(rx, s, strend, orig, s == m, Nullsv, NULL, r_flags));
1849         sv_catpvn(dstr, s, strend - s);
1850
1851         (void)SvOOK_off(TARG);
1852         Safefree(SvPVX(TARG));
1853         SvPVX(TARG) = SvPVX(dstr);
1854         SvCUR_set(TARG, SvCUR(dstr));
1855         SvLEN_set(TARG, SvLEN(dstr));
1856         SvPVX(dstr) = 0;
1857         sv_free(dstr);
1858
1859         TAINT_IF(rxtainted & 1);
1860         SPAGAIN;
1861         PUSHs(sv_2mortal(newSViv((I32)iters)));
1862
1863         (void)SvPOK_only(TARG);
1864         TAINT_IF(rxtainted);
1865         SvSETMAGIC(TARG);
1866         SvTAINT(TARG);
1867         LEAVE_SCOPE(oldsave);
1868         RETURN;
1869     }
1870     goto ret_no;
1871
1872 nope:
1873     ++BmUSEFUL(rx->check_substr);
1874
1875 ret_no:         
1876     SPAGAIN;
1877     PUSHs(&PL_sv_no);
1878     LEAVE_SCOPE(oldsave);
1879     RETURN;
1880 }
1881
1882 PP(pp_grepwhile)
1883 {
1884     djSP;
1885
1886     if (SvTRUEx(POPs))
1887         PL_stack_base[PL_markstack_ptr[-1]++] = PL_stack_base[*PL_markstack_ptr];
1888     ++*PL_markstack_ptr;
1889     LEAVE;                                      /* exit inner scope */
1890
1891     /* All done yet? */
1892     if (PL_stack_base + *PL_markstack_ptr > SP) {
1893         I32 items;
1894         I32 gimme = GIMME_V;
1895
1896         LEAVE;                                  /* exit outer scope */
1897         (void)POPMARK;                          /* pop src */
1898         items = --*PL_markstack_ptr - PL_markstack_ptr[-1];
1899         (void)POPMARK;                          /* pop dst */
1900         SP = PL_stack_base + POPMARK;           /* pop original mark */
1901         if (gimme == G_SCALAR) {
1902             dTARGET;
1903             XPUSHi(items);
1904         }
1905         else if (gimme == G_ARRAY)
1906             SP += items;
1907         RETURN;
1908     }
1909     else {
1910         SV *src;
1911
1912         ENTER;                                  /* enter inner scope */
1913         SAVESPTR(PL_curpm);
1914
1915         src = PL_stack_base[*PL_markstack_ptr];
1916         SvTEMP_off(src);
1917         DEFSV = src;
1918
1919         RETURNOP(cLOGOP->op_other);
1920     }
1921 }
1922
1923 PP(pp_leavesub)
1924 {
1925     djSP;
1926     SV **mark;
1927     SV **newsp;
1928     PMOP *newpm;
1929     I32 gimme;
1930     register PERL_CONTEXT *cx;
1931     struct block_sub cxsub;
1932
1933     POPBLOCK(cx,newpm);
1934     POPSUB1(cx);        /* Delay POPSUB2 until stack values are safe */
1935  
1936     TAINT_NOT;
1937     if (gimme == G_SCALAR) {
1938         MARK = newsp + 1;
1939         if (MARK <= SP) {
1940             if (cxsub.cv && CvDEPTH(cxsub.cv) > 1) {
1941                 if (SvTEMP(TOPs)) {
1942                     *MARK = SvREFCNT_inc(TOPs);
1943                     FREETMPS;
1944                     sv_2mortal(*MARK);
1945                 } else {
1946                     FREETMPS;
1947                     *MARK = sv_mortalcopy(TOPs);
1948                 }
1949             } else
1950                 *MARK = SvTEMP(TOPs) ? TOPs : sv_mortalcopy(TOPs);
1951         } else {
1952             MEXTEND(MARK, 0);
1953             *MARK = &PL_sv_undef;
1954         }
1955         SP = MARK;
1956     }
1957     else if (gimme == G_ARRAY) {
1958         for (MARK = newsp + 1; MARK <= SP; MARK++) {
1959             if (!SvTEMP(*MARK)) {
1960                 *MARK = sv_mortalcopy(*MARK);
1961                 TAINT_NOT;      /* Each item is independent */
1962             }
1963         }
1964     }
1965     PUTBACK;
1966     
1967     POPSUB2();          /* Stack values are safe: release CV and @_ ... */
1968     PL_curpm = newpm;   /* ... and pop $1 et al */
1969
1970     LEAVE;
1971     return pop_return();
1972 }
1973
1974 STATIC CV *
1975 get_db_sub(SV **svp, CV *cv)
1976 {
1977     dTHR;
1978     SV *dbsv = GvSV(PL_DBsub);
1979
1980     if (!PERLDB_SUB_NN) {
1981         GV *gv = CvGV(cv);
1982
1983         save_item(dbsv);
1984         if ( (CvFLAGS(cv) & (CVf_ANON | CVf_CLONED))
1985              || strEQ(GvNAME(gv), "END") 
1986              || ((GvCV(gv) != cv) && /* Could be imported, and old sub redefined. */
1987                  !( (SvTYPE(*svp) == SVt_PVGV) && (GvCV((GV*)*svp) == cv)
1988                     && (gv = (GV*)*svp) ))) {
1989             /* Use GV from the stack as a fallback. */
1990             /* GV is potentially non-unique, or contain different CV. */
1991             sv_setsv(dbsv, newRV((SV*)cv));
1992         }
1993         else {
1994             gv_efullname3(dbsv, gv, Nullch);
1995         }
1996     }
1997     else {
1998         SvUPGRADE(dbsv, SVt_PVIV);
1999         SvIOK_on(dbsv);
2000         SAVEIV(SvIVX(dbsv));
2001         SvIVX(dbsv) = (IV)cv;           /* Do it the quickest way  */
2002     }
2003
2004     if (CvXSUB(cv))
2005         PL_curcopdb = PL_curcop;
2006     cv = GvCV(PL_DBsub);
2007     return cv;
2008 }
2009
2010 PP(pp_entersub)
2011 {
2012     djSP; dPOPss;
2013     GV *gv;
2014     HV *stash;
2015     register CV *cv;
2016     register PERL_CONTEXT *cx;
2017     I32 gimme;
2018     bool hasargs = (PL_op->op_flags & OPf_STACKED) != 0;
2019
2020     if (!sv)
2021         DIE("Not a CODE reference");
2022     switch (SvTYPE(sv)) {
2023     default:
2024         if (!SvROK(sv)) {
2025             char *sym;
2026             STRLEN n_a;
2027
2028             if (sv == &PL_sv_yes) {             /* unfound import, ignore */
2029                 if (hasargs)
2030                     SP = PL_stack_base + POPMARK;
2031                 RETURN;
2032             }
2033             if (SvGMAGICAL(sv)) {
2034                 mg_get(sv);
2035                 sym = SvPOKp(sv) ? SvPVX(sv) : Nullch;
2036             }
2037             else
2038                 sym = SvPV(sv, n_a);
2039             if (!sym)
2040                 DIE(PL_no_usym, "a subroutine");
2041             if (PL_op->op_private & HINT_STRICT_REFS)
2042                 DIE(PL_no_symref, sym, "a subroutine");
2043             cv = perl_get_cv(sym, TRUE);
2044             break;
2045         }
2046         {
2047             SV **sp = &sv;              /* Used in tryAMAGICunDEREF macro. */
2048             tryAMAGICunDEREF(to_cv);
2049         }       
2050         cv = (CV*)SvRV(sv);
2051         if (SvTYPE(cv) == SVt_PVCV)
2052             break;
2053         /* FALL THROUGH */
2054     case SVt_PVHV:
2055     case SVt_PVAV:
2056         DIE("Not a CODE reference");
2057     case SVt_PVCV:
2058         cv = (CV*)sv;
2059         break;
2060     case SVt_PVGV:
2061         if (!(cv = GvCVu((GV*)sv)))
2062             cv = sv_2cv(sv, &stash, &gv, TRUE);
2063         break;
2064     }
2065
2066     ENTER;
2067     SAVETMPS;
2068
2069   retry:
2070     if (!cv)
2071         DIE("Not a CODE reference");
2072
2073     if (!CvROOT(cv) && !CvXSUB(cv)) {
2074         GV* autogv;
2075         SV* sub_name;
2076
2077         /* anonymous or undef'd function leaves us no recourse */
2078         if (CvANON(cv) || !(gv = CvGV(cv)))
2079             DIE("Undefined subroutine called");
2080         /* autoloaded stub? */
2081         if (cv != GvCV(gv)) {
2082             cv = GvCV(gv);
2083             goto retry;
2084         }
2085         /* should call AUTOLOAD now? */
2086         if ((autogv = gv_autoload4(GvSTASH(gv), GvNAME(gv), GvNAMELEN(gv),
2087                                    FALSE)))
2088         {
2089             cv = GvCV(autogv);
2090             goto retry;
2091         }
2092         /* sorry */
2093         sub_name = sv_newmortal();
2094         gv_efullname3(sub_name, gv, Nullch);
2095         DIE("Undefined subroutine &%s called", SvPVX(sub_name));
2096     }
2097
2098     gimme = GIMME_V;
2099     if ((PL_op->op_private & OPpENTERSUB_DB) && GvCV(PL_DBsub) && !CvNODEBUG(cv))
2100         cv = get_db_sub(&sv, cv);
2101     if (!cv)
2102         DIE("No DBsub routine");
2103
2104 #ifdef USE_THREADS
2105     /*
2106      * First we need to check if the sub or method requires locking.
2107      * If so, we gain a lock on the CV, the first argument or the
2108      * stash (for static methods), as appropriate. This has to be
2109      * inline because for FAKE_THREADS, COND_WAIT inlines code to
2110      * reschedule by returning a new op.
2111      */
2112     MUTEX_LOCK(CvMUTEXP(cv));
2113     if (CvFLAGS(cv) & CVf_LOCKED) {
2114         MAGIC *mg;      
2115         if (CvFLAGS(cv) & CVf_METHOD) {
2116             if (SP > PL_stack_base + TOPMARK)
2117                 sv = *(PL_stack_base + TOPMARK + 1);
2118             else {
2119                 MUTEX_UNLOCK(CvMUTEXP(cv));
2120                 croak("no argument for locked method call");
2121             }
2122             if (SvROK(sv))
2123                 sv = SvRV(sv);
2124             else {              
2125                 STRLEN len;
2126                 char *stashname = SvPV(sv, len);
2127                 sv = (SV*)gv_stashpvn(stashname, len, TRUE);
2128             }
2129         }
2130         else {
2131             sv = (SV*)cv;
2132         }
2133         MUTEX_UNLOCK(CvMUTEXP(cv));
2134         mg = condpair_magic(sv);
2135         MUTEX_LOCK(MgMUTEXP(mg));
2136         if (MgOWNER(mg) == thr)
2137             MUTEX_UNLOCK(MgMUTEXP(mg));
2138         else {
2139             while (MgOWNER(mg))
2140                 COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
2141             MgOWNER(mg) = thr;
2142             DEBUG_S(PerlIO_printf(PerlIO_stderr(), "%p: pp_entersub lock %p\n",
2143                                   thr, sv);)
2144             MUTEX_UNLOCK(MgMUTEXP(mg));
2145             save_destructor(unlock_condpair, sv);
2146         }
2147         MUTEX_LOCK(CvMUTEXP(cv));
2148     }
2149     /*
2150      * Now we have permission to enter the sub, we must distinguish
2151      * four cases. (0) It's an XSUB (in which case we don't care
2152      * about ownership); (1) it's ours already (and we're recursing);
2153      * (2) it's free (but we may already be using a cached clone);
2154      * (3) another thread owns it. Case (1) is easy: we just use it.
2155      * Case (2) means we look for a clone--if we have one, use it
2156      * otherwise grab ownership of cv. Case (3) means we look for a
2157      * clone (for non-XSUBs) and have to create one if we don't
2158      * already have one.
2159      * Why look for a clone in case (2) when we could just grab
2160      * ownership of cv straight away? Well, we could be recursing,
2161      * i.e. we originally tried to enter cv while another thread
2162      * owned it (hence we used a clone) but it has been freed up
2163      * and we're now recursing into it. It may or may not be "better"
2164      * to use the clone but at least CvDEPTH can be trusted.
2165      */
2166     if (CvOWNER(cv) == thr || CvXSUB(cv))
2167         MUTEX_UNLOCK(CvMUTEXP(cv));
2168     else {
2169         /* Case (2) or (3) */
2170         SV **svp;
2171         
2172         /*
2173          * XXX Might it be better to release CvMUTEXP(cv) while we
2174          * do the hv_fetch? We might find someone has pinched it
2175          * when we look again, in which case we would be in case
2176          * (3) instead of (2) so we'd have to clone. Would the fact
2177          * that we released the mutex more quickly make up for this?
2178          */
2179         if ((svp = hv_fetch(thr->cvcache, (char *)cv, sizeof(cv), FALSE)))
2180         {
2181             /* We already have a clone to use */
2182             MUTEX_UNLOCK(CvMUTEXP(cv));
2183             cv = *(CV**)svp;
2184             DEBUG_S(PerlIO_printf(PerlIO_stderr(),
2185                                   "entersub: %p already has clone %p:%s\n",
2186                                   thr, cv, SvPEEK((SV*)cv)));
2187             CvOWNER(cv) = thr;
2188             SvREFCNT_inc(cv);
2189             if (CvDEPTH(cv) == 0)
2190                 SAVEDESTRUCTOR(unset_cvowner, (void*) cv);
2191         }
2192         else {
2193             /* (2) => grab ownership of cv. (3) => make clone */
2194             if (!CvOWNER(cv)) {
2195                 CvOWNER(cv) = thr;
2196                 SvREFCNT_inc(cv);
2197                 MUTEX_UNLOCK(CvMUTEXP(cv));
2198                 DEBUG_S(PerlIO_printf(PerlIO_stderr(),
2199                             "entersub: %p grabbing %p:%s in stash %s\n",
2200                             thr, cv, SvPEEK((SV*)cv), CvSTASH(cv) ?
2201                                 HvNAME(CvSTASH(cv)) : "(none)"));
2202             } else {
2203                 /* Make a new clone. */
2204                 CV *clonecv;
2205                 SvREFCNT_inc(cv); /* don't let it vanish from under us */
2206                 MUTEX_UNLOCK(CvMUTEXP(cv));
2207                 DEBUG_S((PerlIO_printf(PerlIO_stderr(),
2208                                        "entersub: %p cloning %p:%s\n",
2209                                        thr, cv, SvPEEK((SV*)cv))));
2210                 /*
2211                  * We're creating a new clone so there's no race
2212                  * between the original MUTEX_UNLOCK and the
2213                  * SvREFCNT_inc since no one will be trying to undef
2214                  * it out from underneath us. At least, I don't think
2215                  * there's a race...
2216                  */
2217                 clonecv = cv_clone(cv);
2218                 SvREFCNT_dec(cv); /* finished with this */
2219                 hv_store(thr->cvcache, (char*)cv, sizeof(cv), (SV*)clonecv,0);
2220                 CvOWNER(clonecv) = thr;
2221                 cv = clonecv;
2222                 SvREFCNT_inc(cv);
2223             }
2224             DEBUG_S(if (CvDEPTH(cv) != 0)
2225                         PerlIO_printf(PerlIO_stderr(), "depth %ld != 0\n",
2226                                       CvDEPTH(cv)););
2227             SAVEDESTRUCTOR(unset_cvowner, (void*) cv);
2228         }
2229     }
2230 #endif /* USE_THREADS */
2231
2232     if (CvXSUB(cv)) {
2233         if (CvOLDSTYLE(cv)) {
2234             I32 (*fp3)_((int,int,int));
2235             dMARK;
2236             register I32 items = SP - MARK;
2237                                         /* We dont worry to copy from @_. */
2238             while (SP > mark) {
2239                 SP[1] = SP[0];
2240                 SP--;
2241             }
2242             PL_stack_sp = mark + 1;
2243             fp3 = (I32(*)_((int,int,int)))CvXSUB(cv);
2244             items = (*fp3)(CvXSUBANY(cv).any_i32, 
2245                            MARK - PL_stack_base + 1,
2246                            items);
2247             PL_stack_sp = PL_stack_base + items;
2248         }
2249         else {
2250             I32 markix = TOPMARK;
2251
2252             PUTBACK;
2253
2254             if (!hasargs) {
2255                 /* Need to copy @_ to stack. Alternative may be to
2256                  * switch stack to @_, and copy return values
2257                  * back. This would allow popping @_ in XSUB, e.g.. XXXX */
2258                 AV* av;
2259                 I32 items;
2260 #ifdef USE_THREADS
2261                 av = (AV*)PL_curpad[0];
2262 #else
2263                 av = GvAV(PL_defgv);
2264 #endif /* USE_THREADS */                
2265                 items = AvFILLp(av) + 1;   /* @_ is not tieable */
2266
2267                 if (items) {
2268                     /* Mark is at the end of the stack. */
2269                     EXTEND(SP, items);
2270                     Copy(AvARRAY(av), SP + 1, items, SV*);
2271                     SP += items;
2272                     PUTBACK ;               
2273                 }
2274             }
2275             if (PL_curcopdb) {          /* We assume that the first
2276                                            XSUB in &DB::sub is the
2277                                            called one. */
2278                 SAVESPTR(PL_curcop);
2279                 PL_curcop = PL_curcopdb;
2280                 PL_curcopdb = NULL;
2281             }
2282             /* Do we need to open block here? XXXX */
2283             (void)(*CvXSUB(cv))(cv _PERL_OBJECT_THIS);
2284
2285             /* Enforce some sanity in scalar context. */
2286             if (gimme == G_SCALAR && ++markix != PL_stack_sp - PL_stack_base ) {
2287                 if (markix > PL_stack_sp - PL_stack_base)
2288                     *(PL_stack_base + markix) = &PL_sv_undef;
2289                 else
2290                     *(PL_stack_base + markix) = *PL_stack_sp;
2291                 PL_stack_sp = PL_stack_base + markix;
2292             }
2293         }
2294         LEAVE;
2295         return NORMAL;
2296     }
2297     else {
2298         dMARK;
2299         register I32 items = SP - MARK;
2300         AV* padlist = CvPADLIST(cv);
2301         SV** svp = AvARRAY(padlist);
2302         push_return(PL_op->op_next);
2303         PUSHBLOCK(cx, CXt_SUB, MARK);
2304         PUSHSUB(cx);
2305         CvDEPTH(cv)++;
2306         /* XXX This would be a natural place to set C<PL_compcv = cv> so
2307          * that eval'' ops within this sub know the correct lexical space.
2308          * Owing the speed considerations, we choose to search for the cv
2309          * in doeval() instead.
2310          */
2311         if (CvDEPTH(cv) < 2)
2312             (void)SvREFCNT_inc(cv);
2313         else {  /* save temporaries on recursion? */
2314             if (CvDEPTH(cv) > AvFILLp(padlist)) {
2315                 AV *av;
2316                 AV *newpad = newAV();
2317                 SV **oldpad = AvARRAY(svp[CvDEPTH(cv)-1]);
2318                 I32 ix = AvFILLp((AV*)svp[1]);
2319                 svp = AvARRAY(svp[0]);
2320                 for ( ;ix > 0; ix--) {
2321                     if (svp[ix] != &PL_sv_undef) {
2322                         char *name = SvPVX(svp[ix]);
2323                         if ((SvFLAGS(svp[ix]) & SVf_FAKE) /* outer lexical? */
2324                             || *name == '&')              /* anonymous code? */
2325                         {
2326                             av_store(newpad, ix, SvREFCNT_inc(oldpad[ix]));
2327                         }
2328                         else {                          /* our own lexical */
2329                             if (*name == '@')
2330                                 av_store(newpad, ix, sv = (SV*)newAV());
2331                             else if (*name == '%')
2332                                 av_store(newpad, ix, sv = (SV*)newHV());
2333                             else
2334                                 av_store(newpad, ix, sv = NEWSV(0,0));
2335                             SvPADMY_on(sv);
2336                         }
2337                     }
2338                     else {
2339                         av_store(newpad, ix, sv = NEWSV(0,0));
2340                         SvPADTMP_on(sv);
2341                     }
2342                 }
2343                 av = newAV();           /* will be @_ */
2344                 av_extend(av, 0);
2345                 av_store(newpad, 0, (SV*)av);
2346                 AvFLAGS(av) = AVf_REIFY;
2347                 av_store(padlist, CvDEPTH(cv), (SV*)newpad);
2348                 AvFILLp(padlist) = CvDEPTH(cv);
2349                 svp = AvARRAY(padlist);
2350             }
2351         }
2352 #ifdef USE_THREADS
2353         if (!hasargs) {
2354             AV* av = (AV*)PL_curpad[0];
2355
2356             items = AvFILLp(av) + 1;
2357             if (items) {
2358                 /* Mark is at the end of the stack. */
2359                 EXTEND(SP, items);
2360                 Copy(AvARRAY(av), SP + 1, items, SV*);
2361                 SP += items;
2362                 PUTBACK ;                   
2363             }
2364         }
2365 #endif /* USE_THREADS */                
2366         SAVESPTR(PL_curpad);
2367         PL_curpad = AvARRAY((AV*)svp[CvDEPTH(cv)]);
2368 #ifndef USE_THREADS
2369         if (hasargs)
2370 #endif /* USE_THREADS */
2371         {
2372             AV* av;
2373             SV** ary;
2374
2375 #if 0
2376             DEBUG_S(PerlIO_printf(PerlIO_stderr(),
2377                                   "%p entersub preparing @_\n", thr));
2378 #endif
2379             av = (AV*)PL_curpad[0];
2380             if (AvREAL(av)) {
2381                 av_clear(av);
2382                 AvREAL_off(av);
2383             }
2384 #ifndef USE_THREADS
2385             cx->blk_sub.savearray = GvAV(PL_defgv);
2386             GvAV(PL_defgv) = (AV*)SvREFCNT_inc(av);
2387 #endif /* USE_THREADS */
2388             cx->blk_sub.argarray = av;
2389             ++MARK;
2390
2391             if (items > AvMAX(av) + 1) {
2392                 ary = AvALLOC(av);
2393                 if (AvARRAY(av) != ary) {
2394                     AvMAX(av) += AvARRAY(av) - AvALLOC(av);
2395                     SvPVX(av) = (char*)ary;
2396                 }
2397                 if (items > AvMAX(av) + 1) {
2398                     AvMAX(av) = items - 1;
2399                     Renew(ary,items,SV*);
2400                     AvALLOC(av) = ary;
2401                     SvPVX(av) = (char*)ary;
2402                 }
2403             }
2404             Copy(MARK,AvARRAY(av),items,SV*);
2405             AvFILLp(av) = items - 1;
2406             
2407             while (items--) {
2408                 if (*MARK)
2409                     SvTEMP_off(*MARK);
2410                 MARK++;
2411             }
2412         }
2413         /* warning must come *after* we fully set up the context
2414          * stuff so that __WARN__ handlers can safely dounwind()
2415          * if they want to
2416          */
2417         if (CvDEPTH(cv) == 100 && ckWARN(WARN_RECURSION)
2418             && !(PERLDB_SUB && cv == GvCV(PL_DBsub)))
2419             sub_crush_depth(cv);
2420 #if 0
2421         DEBUG_S(PerlIO_printf(PerlIO_stderr(),
2422                               "%p entersub returning %p\n", thr, CvSTART(cv)));
2423 #endif
2424         RETURNOP(CvSTART(cv));
2425     }
2426 }
2427
2428 void
2429 sub_crush_depth(CV *cv)
2430 {
2431     if (CvANON(cv))
2432         warner(WARN_RECURSION, "Deep recursion on anonymous subroutine");
2433     else {
2434         SV* tmpstr = sv_newmortal();
2435         gv_efullname3(tmpstr, CvGV(cv), Nullch);
2436         warner(WARN_RECURSION, "Deep recursion on subroutine \"%s\"", 
2437                 SvPVX(tmpstr));
2438     }
2439 }
2440
2441 PP(pp_aelem)
2442 {
2443     djSP;
2444     SV** svp;
2445     I32 elem = POPi;
2446     AV* av = (AV*)POPs;
2447     U32 lval = PL_op->op_flags & OPf_MOD;
2448     U32 defer = (PL_op->op_private & OPpLVAL_DEFER) && (elem > AvFILL(av));
2449     SV *sv;
2450
2451     if (elem > 0)
2452         elem -= PL_curcop->cop_arybase;
2453     if (SvTYPE(av) != SVt_PVAV)
2454         RETPUSHUNDEF;
2455     svp = av_fetch(av, elem, lval && !defer);
2456     if (lval) {
2457         if (!svp || *svp == &PL_sv_undef) {
2458             SV* lv;
2459             if (!defer)
2460                 DIE(PL_no_aelem, elem);
2461             lv = sv_newmortal();
2462             sv_upgrade(lv, SVt_PVLV);
2463             LvTYPE(lv) = 'y';
2464             sv_magic(lv, Nullsv, 'y', Nullch, 0);
2465             LvTARG(lv) = SvREFCNT_inc(av);
2466             LvTARGOFF(lv) = elem;
2467             LvTARGLEN(lv) = 1;
2468             PUSHs(lv);
2469             RETURN;
2470         }
2471         if (PL_op->op_private & OPpLVAL_INTRO)
2472             save_aelem(av, elem, svp);
2473         else if (PL_op->op_private & OPpDEREF)
2474             vivify_ref(*svp, PL_op->op_private & OPpDEREF);
2475     }
2476     sv = (svp ? *svp : &PL_sv_undef);
2477     if (!lval && SvGMAGICAL(sv))        /* see note in pp_helem() */
2478         sv = sv_mortalcopy(sv);
2479     PUSHs(sv);
2480     RETURN;
2481 }
2482
2483 void
2484 vivify_ref(SV *sv, U32 to_what)
2485 {
2486     if (SvGMAGICAL(sv))
2487         mg_get(sv);
2488     if (!SvOK(sv)) {
2489         if (SvREADONLY(sv))
2490             croak(PL_no_modify);
2491         if (SvTYPE(sv) < SVt_RV)
2492             sv_upgrade(sv, SVt_RV);
2493         else if (SvTYPE(sv) >= SVt_PV) {
2494             (void)SvOOK_off(sv);
2495             Safefree(SvPVX(sv));
2496             SvLEN(sv) = SvCUR(sv) = 0;
2497         }
2498         switch (to_what) {
2499         case OPpDEREF_SV:
2500             SvRV(sv) = NEWSV(355,0);
2501             break;
2502         case OPpDEREF_AV:
2503             SvRV(sv) = (SV*)newAV();
2504             break;
2505         case OPpDEREF_HV:
2506             SvRV(sv) = (SV*)newHV();
2507             break;
2508         }
2509         SvROK_on(sv);
2510         SvSETMAGIC(sv);
2511     }
2512 }
2513
2514 PP(pp_method)
2515 {
2516     djSP;
2517     SV* sv;
2518     SV* ob;
2519     GV* gv;
2520     HV* stash;
2521     char* name;
2522     char* packname;
2523     STRLEN packlen;
2524
2525     if (SvROK(TOPs)) {
2526         sv = SvRV(TOPs);
2527         if (SvTYPE(sv) == SVt_PVCV) {
2528             SETs(sv);
2529             RETURN;
2530         }
2531     }
2532
2533     name = SvPV(TOPs, packlen);
2534     sv = *(PL_stack_base + TOPMARK + 1);
2535     
2536     if (SvGMAGICAL(sv))
2537         mg_get(sv);
2538     if (SvROK(sv))
2539         ob = (SV*)SvRV(sv);
2540     else {
2541         GV* iogv;
2542
2543         packname = Nullch;
2544         if (!SvOK(sv) ||
2545             !(packname = SvPV(sv, packlen)) ||
2546             !(iogv = gv_fetchpv(packname, FALSE, SVt_PVIO)) ||
2547             !(ob=(SV*)GvIO(iogv)))
2548         {
2549             if (!packname || 
2550                 ((*(U8*)packname >= 0xc0 && IN_UTF8)
2551                     ? !isIDFIRST_utf8((U8*)packname)
2552                     : !isIDFIRST(*packname)
2553                 ))
2554             {
2555                 DIE("Can't call method \"%s\" %s", name,
2556                     SvOK(sv)? "without a package or object reference"
2557                             : "on an undefined value");
2558             }
2559             stash = gv_stashpvn(packname, packlen, TRUE);
2560             goto fetch;
2561         }
2562         *(PL_stack_base + TOPMARK + 1) = sv_2mortal(newRV((SV*)iogv));
2563     }
2564
2565     if (!ob || !SvOBJECT(ob))
2566         DIE("Can't call method \"%s\" on unblessed reference", name);
2567
2568     stash = SvSTASH(ob);
2569
2570   fetch:
2571     gv = gv_fetchmethod(stash, name);
2572     if (!gv) {
2573         char* leaf = name;
2574         char* sep = Nullch;
2575         char* p;
2576
2577         for (p = name; *p; p++) {
2578             if (*p == '\'')
2579                 sep = p, leaf = p + 1;
2580             else if (*p == ':' && *(p + 1) == ':')
2581                 sep = p, leaf = p + 2;
2582         }
2583         if (!sep || ((sep - name) == 5 && strnEQ(name, "SUPER", 5))) {
2584             packname = HvNAME(sep ? PL_curcop->cop_stash : stash);
2585             packlen = strlen(packname);
2586         }
2587         else {
2588             packname = name;
2589             packlen = sep - name;
2590         }
2591         DIE("Can't locate object method \"%s\" via package \"%.*s\"",
2592             leaf, (int)packlen, packname);
2593     }
2594     SETs(isGV(gv) ? (SV*)GvCV(gv) : (SV*)gv);
2595     RETURN;
2596 }
2597