Spelling nit
[perl.git] / mg.c
1 /*    mg.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
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  *  Sam sat on the ground and put his head in his hands.  'I wish I had never
13  *  come here, and I don't want to see no more magic,' he said, and fell silent.
14  *
15  *     [p.363 of _The Lord of the Rings_, II/vii: "The Mirror of Galadriel"]
16  */
17
18 /*
19 =head1 Magical Functions
20
21 "Magic" is special data attached to SV structures in order to give them
22 "magical" properties.  When any Perl code tries to read from, or assign to,
23 an SV marked as magical, it calls the 'get' or 'set' function associated
24 with that SV's magic. A get is called prior to reading an SV, in order to
25 give it a chance to update its internal value (get on $. writes the line
26 number of the last read filehandle into to the SV's IV slot), while
27 set is called after an SV has been written to, in order to allow it to make
28 use of its changed value (set on $/ copies the SV's new value to the
29 PL_rs global variable).
30
31 Magic is implemented as a linked list of MAGIC structures attached to the
32 SV. Each MAGIC struct holds the type of the magic, a pointer to an array
33 of functions that implement the get(), set(), length() etc functions,
34 plus space for some flags and pointers. For example, a tied variable has
35 a MAGIC structure that contains a pointer to the object associated with the
36 tie.
37
38 */
39
40 #include "EXTERN.h"
41 #define PERL_IN_MG_C
42 #include "perl.h"
43
44 #if defined(HAS_GETGROUPS) || defined(HAS_SETGROUPS)
45 #  ifdef I_GRP
46 #    include <grp.h>
47 #  endif
48 #endif
49
50 #if defined(HAS_SETGROUPS)
51 #  ifndef NGROUPS
52 #    define NGROUPS 32
53 #  endif
54 #endif
55
56 #ifdef __hpux
57 #  include <sys/pstat.h>
58 #endif
59
60 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
61 Signal_t Perl_csighandler(int sig, siginfo_t *, void *);
62 #else
63 Signal_t Perl_csighandler(int sig);
64 #endif
65
66 #ifdef __Lynx__
67 /* Missing protos on LynxOS */
68 void setruid(uid_t id);
69 void seteuid(uid_t id);
70 void setrgid(uid_t id);
71 void setegid(uid_t id);
72 #endif
73
74 /*
75  * Use the "DESTRUCTOR" scope cleanup to reinstate magic.
76  */
77
78 struct magic_state {
79     SV* mgs_sv;
80     U32 mgs_flags;
81     I32 mgs_ss_ix;
82 };
83 /* MGS is typedef'ed to struct magic_state in perl.h */
84
85 STATIC void
86 S_save_magic(pTHX_ I32 mgs_ix, SV *sv)
87 {
88     dVAR;
89     MGS* mgs;
90
91     PERL_ARGS_ASSERT_SAVE_MAGIC;
92
93     assert(SvMAGICAL(sv));
94     /* Turning READONLY off for a copy-on-write scalar (including shared
95        hash keys) is a bad idea.  */
96     if (SvIsCOW(sv))
97       sv_force_normal_flags(sv, 0);
98
99     SAVEDESTRUCTOR_X(S_restore_magic, INT2PTR(void*, (IV)mgs_ix));
100
101     mgs = SSPTR(mgs_ix, MGS*);
102     mgs->mgs_sv = sv;
103     mgs->mgs_flags = SvMAGICAL(sv) | SvREADONLY(sv);
104     mgs->mgs_ss_ix = PL_savestack_ix;   /* points after the saved destructor */
105
106     SvMAGICAL_off(sv);
107     SvREADONLY_off(sv);
108     if (!(SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK))) {
109         /* No public flags are set, so promote any private flags to public.  */
110         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
111     }
112 }
113
114 /*
115 =for apidoc mg_magical
116
117 Turns on the magical status of an SV.  See C<sv_magic>.
118
119 =cut
120 */
121
122 void
123 Perl_mg_magical(pTHX_ SV *sv)
124 {
125     const MAGIC* mg;
126     PERL_ARGS_ASSERT_MG_MAGICAL;
127     PERL_UNUSED_CONTEXT;
128     if ((mg = SvMAGIC(sv))) {
129         SvRMAGICAL_off(sv);
130         do {
131             const MGVTBL* const vtbl = mg->mg_virtual;
132             if (vtbl) {
133                 if (vtbl->svt_get && !(mg->mg_flags & MGf_GSKIP))
134                     SvGMAGICAL_on(sv);
135                 if (vtbl->svt_set)
136                     SvSMAGICAL_on(sv);
137                 if (vtbl->svt_clear)
138                     SvRMAGICAL_on(sv);
139             }
140         } while ((mg = mg->mg_moremagic));
141         if (!(SvFLAGS(sv) & (SVs_GMG|SVs_SMG)))
142             SvRMAGICAL_on(sv);
143     }
144 }
145
146
147 /* is this container magic (%ENV, $1 etc), or value magic (pos, taint etc)? */
148
149 STATIC bool
150 S_is_container_magic(const MAGIC *mg)
151 {
152     assert(mg);
153     switch (mg->mg_type) {
154     case PERL_MAGIC_bm:
155     case PERL_MAGIC_fm:
156     case PERL_MAGIC_regex_global:
157     case PERL_MAGIC_nkeys:
158 #ifdef USE_LOCALE_COLLATE
159     case PERL_MAGIC_collxfrm:
160 #endif
161     case PERL_MAGIC_qr:
162     case PERL_MAGIC_taint:
163     case PERL_MAGIC_vec:
164     case PERL_MAGIC_vstring:
165     case PERL_MAGIC_utf8:
166     case PERL_MAGIC_substr:
167     case PERL_MAGIC_defelem:
168     case PERL_MAGIC_arylen:
169     case PERL_MAGIC_pos:
170     case PERL_MAGIC_backref:
171     case PERL_MAGIC_arylen_p:
172     case PERL_MAGIC_rhash:
173     case PERL_MAGIC_symtab:
174         return 0;
175     default:
176         return 1;
177     }
178 }
179
180 /*
181 =for apidoc mg_get
182
183 Do magic after a value is retrieved from the SV.  See C<sv_magic>.
184
185 =cut
186 */
187
188 int
189 Perl_mg_get(pTHX_ SV *sv)
190 {
191     dVAR;
192     const I32 mgs_ix = SSNEW(sizeof(MGS));
193     const bool was_temp = (bool)SvTEMP(sv);
194     int have_new = 0;
195     MAGIC *newmg, *head, *cur, *mg;
196     /* guard against sv having being freed midway by holding a private
197        reference. */
198
199     PERL_ARGS_ASSERT_MG_GET;
200
201     /* sv_2mortal has this side effect of turning on the TEMP flag, which can
202        cause the SV's buffer to get stolen (and maybe other stuff).
203        So restore it.
204     */
205     sv_2mortal(SvREFCNT_inc_simple_NN(sv));
206     if (!was_temp) {
207         SvTEMP_off(sv);
208     }
209
210     save_magic(mgs_ix, sv);
211
212     /* We must call svt_get(sv, mg) for each valid entry in the linked
213        list of magic. svt_get() may delete the current entry, add new
214        magic to the head of the list, or upgrade the SV. AMS 20010810 */
215
216     newmg = cur = head = mg = SvMAGIC(sv);
217     while (mg) {
218         const MGVTBL * const vtbl = mg->mg_virtual;
219
220         if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
221             CALL_FPTR(vtbl->svt_get)(aTHX_ sv, mg);
222
223             /* guard against magic having been deleted - eg FETCH calling
224              * untie */
225             if (!SvMAGIC(sv))
226                 break;
227
228             /* Don't restore the flags for this entry if it was deleted. */
229             if (mg->mg_flags & MGf_GSKIP)
230                 (SSPTR(mgs_ix, MGS *))->mgs_flags = 0;
231         }
232
233         mg = mg->mg_moremagic;
234
235         if (have_new) {
236             /* Have we finished with the new entries we saw? Start again
237                where we left off (unless there are more new entries). */
238             if (mg == head) {
239                 have_new = 0;
240                 mg   = cur;
241                 head = newmg;
242             }
243         }
244
245         /* Were any new entries added? */
246         if (!have_new && (newmg = SvMAGIC(sv)) != head) {
247             have_new = 1;
248             cur = mg;
249             mg  = newmg;
250         }
251     }
252
253     restore_magic(INT2PTR(void *, (IV)mgs_ix));
254
255     if (SvREFCNT(sv) == 1) {
256         /* We hold the last reference to this SV, which implies that the
257            SV was deleted as a side effect of the routines we called.  */
258         SvOK_off(sv);
259     }
260     return 0;
261 }
262
263 /*
264 =for apidoc mg_set
265
266 Do magic after a value is assigned to the SV.  See C<sv_magic>.
267
268 =cut
269 */
270
271 int
272 Perl_mg_set(pTHX_ SV *sv)
273 {
274     dVAR;
275     const I32 mgs_ix = SSNEW(sizeof(MGS));
276     MAGIC* mg;
277     MAGIC* nextmg;
278
279     PERL_ARGS_ASSERT_MG_SET;
280
281     save_magic(mgs_ix, sv);
282
283     for (mg = SvMAGIC(sv); mg; mg = nextmg) {
284         const MGVTBL* vtbl = mg->mg_virtual;
285         nextmg = mg->mg_moremagic;      /* it may delete itself */
286         if (mg->mg_flags & MGf_GSKIP) {
287             mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
288             (SSPTR(mgs_ix, MGS*))->mgs_flags = 0;
289         }
290         if (PL_localizing == 2 && !S_is_container_magic(mg))
291             continue;
292         if (vtbl && vtbl->svt_set)
293             CALL_FPTR(vtbl->svt_set)(aTHX_ sv, mg);
294     }
295
296     restore_magic(INT2PTR(void*, (IV)mgs_ix));
297     return 0;
298 }
299
300 /*
301 =for apidoc mg_length
302
303 Report on the SV's length.  See C<sv_magic>.
304
305 =cut
306 */
307
308 U32
309 Perl_mg_length(pTHX_ SV *sv)
310 {
311     dVAR;
312     MAGIC* mg;
313     STRLEN len;
314
315     PERL_ARGS_ASSERT_MG_LENGTH;
316
317     for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
318         const MGVTBL * const vtbl = mg->mg_virtual;
319         if (vtbl && vtbl->svt_len) {
320             const I32 mgs_ix = SSNEW(sizeof(MGS));
321             save_magic(mgs_ix, sv);
322             /* omit MGf_GSKIP -- not changed here */
323             len = CALL_FPTR(vtbl->svt_len)(aTHX_ sv, mg);
324             restore_magic(INT2PTR(void*, (IV)mgs_ix));
325             return len;
326         }
327     }
328
329     {
330         /* You can't know whether it's UTF-8 until you get the string again...
331          */
332         const U8 *s = (U8*)SvPV_const(sv, len);
333
334         if (DO_UTF8(sv)) {
335             len = utf8_length(s, s + len);
336         }
337     }
338     return len;
339 }
340
341 I32
342 Perl_mg_size(pTHX_ SV *sv)
343 {
344     MAGIC* mg;
345
346     PERL_ARGS_ASSERT_MG_SIZE;
347
348     for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
349         const MGVTBL* const vtbl = mg->mg_virtual;
350         if (vtbl && vtbl->svt_len) {
351             const I32 mgs_ix = SSNEW(sizeof(MGS));
352             I32 len;
353             save_magic(mgs_ix, sv);
354             /* omit MGf_GSKIP -- not changed here */
355             len = CALL_FPTR(vtbl->svt_len)(aTHX_ sv, mg);
356             restore_magic(INT2PTR(void*, (IV)mgs_ix));
357             return len;
358         }
359     }
360
361     switch(SvTYPE(sv)) {
362         case SVt_PVAV:
363             return AvFILLp((const AV *) sv); /* Fallback to non-tied array */
364         case SVt_PVHV:
365             /* FIXME */
366         default:
367             Perl_croak(aTHX_ "Size magic not implemented");
368             break;
369     }
370     return 0;
371 }
372
373 /*
374 =for apidoc mg_clear
375
376 Clear something magical that the SV represents.  See C<sv_magic>.
377
378 =cut
379 */
380
381 int
382 Perl_mg_clear(pTHX_ SV *sv)
383 {
384     const I32 mgs_ix = SSNEW(sizeof(MGS));
385     MAGIC* mg;
386     MAGIC *nextmg;
387
388     PERL_ARGS_ASSERT_MG_CLEAR;
389
390     save_magic(mgs_ix, sv);
391
392     for (mg = SvMAGIC(sv); mg; mg = nextmg) {
393         const MGVTBL* const vtbl = mg->mg_virtual;
394         /* omit GSKIP -- never set here */
395
396         nextmg = mg->mg_moremagic; /* it may delete itself */
397
398         if (vtbl && vtbl->svt_clear)
399             CALL_FPTR(vtbl->svt_clear)(aTHX_ sv, mg);
400     }
401
402     restore_magic(INT2PTR(void*, (IV)mgs_ix));
403     return 0;
404 }
405
406 /*
407 =for apidoc mg_find
408
409 Finds the magic pointer for type matching the SV.  See C<sv_magic>.
410
411 =cut
412 */
413
414 MAGIC*
415 Perl_mg_find(pTHX_ const SV *sv, int type)
416 {
417     PERL_UNUSED_CONTEXT;
418     if (sv) {
419         MAGIC *mg;
420         for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
421             if (mg->mg_type == type)
422                 return mg;
423         }
424     }
425     return NULL;
426 }
427
428 /*
429 =for apidoc mg_copy
430
431 Copies the magic from one SV to another.  See C<sv_magic>.
432
433 =cut
434 */
435
436 int
437 Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
438 {
439     int count = 0;
440     MAGIC* mg;
441
442     PERL_ARGS_ASSERT_MG_COPY;
443
444     for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
445         const MGVTBL* const vtbl = mg->mg_virtual;
446         if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
447             count += CALL_FPTR(vtbl->svt_copy)(aTHX_ sv, mg, nsv, key, klen);
448         }
449         else {
450             const char type = mg->mg_type;
451             if (isUPPER(type) && type != PERL_MAGIC_uvar) {
452                 sv_magic(nsv,
453                      (type == PERL_MAGIC_tied)
454                         ? SvTIED_obj(sv, mg)
455                         : (type == PERL_MAGIC_regdata && mg->mg_obj)
456                             ? sv
457                             : mg->mg_obj,
458                      toLOWER(type), key, klen);
459                 count++;
460             }
461         }
462     }
463     return count;
464 }
465
466 /*
467 =for apidoc mg_localize
468
469 Copy some of the magic from an existing SV to new localized version of that
470 SV. Container magic (eg %ENV, $1, tie) gets copied, value magic doesn't (eg
471 taint, pos).
472
473 If setmagic is false then no set magic will be called on the new (empty) SV.
474 This typically means that assignment will soon follow (e.g. 'local $x = $y'),
475 and that will handle the magic.
476
477 =cut
478 */
479
480 void
481 Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
482 {
483     dVAR;
484     MAGIC *mg;
485
486     PERL_ARGS_ASSERT_MG_LOCALIZE;
487
488     for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
489         const MGVTBL* const vtbl = mg->mg_virtual;
490         if (!S_is_container_magic(mg))
491             continue;
492                 
493         if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
494             (void)CALL_FPTR(vtbl->svt_local)(aTHX_ nsv, mg);
495         else
496             sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
497                             mg->mg_ptr, mg->mg_len);
498
499         /* container types should remain read-only across localization */
500         SvFLAGS(nsv) |= SvREADONLY(sv);
501     }
502
503     if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
504         SvFLAGS(nsv) |= SvMAGICAL(sv);
505         if (setmagic) {
506             PL_localizing = 1;
507             SvSETMAGIC(nsv);
508             PL_localizing = 0;
509         }
510     }       
511 }
512
513 /*
514 =for apidoc mg_free
515
516 Free any magic storage used by the SV.  See C<sv_magic>.
517
518 =cut
519 */
520
521 int
522 Perl_mg_free(pTHX_ SV *sv)
523 {
524     MAGIC* mg;
525     MAGIC* moremagic;
526
527     PERL_ARGS_ASSERT_MG_FREE;
528
529     for (mg = SvMAGIC(sv); mg; mg = moremagic) {
530         const MGVTBL* const vtbl = mg->mg_virtual;
531         moremagic = mg->mg_moremagic;
532         if (vtbl && vtbl->svt_free)
533             CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
534         if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
535             if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
536                 Safefree(mg->mg_ptr);
537             else if (mg->mg_len == HEf_SVKEY)
538                 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
539         }
540         if (mg->mg_flags & MGf_REFCOUNTED)
541             SvREFCNT_dec(mg->mg_obj);
542         Safefree(mg);
543         SvMAGIC_set(sv, moremagic);
544     }
545     SvMAGIC_set(sv, NULL);
546     SvMAGICAL_off(sv);
547     return 0;
548 }
549
550 #include <signal.h>
551
552 U32
553 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
554 {
555     dVAR;
556     PERL_UNUSED_ARG(sv);
557
558     PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
559
560     if (PL_curpm) {
561         register const REGEXP * const rx = PM_GETRE(PL_curpm);
562         if (rx) {
563             if (mg->mg_obj) {                   /* @+ */
564                 /* return the number possible */
565                 return RX_NPARENS(rx);
566             } else {                            /* @- */
567                 I32 paren = RX_LASTPAREN(rx);
568
569                 /* return the last filled */
570                 while ( paren >= 0
571                         && (RX_OFFS(rx)[paren].start == -1
572                             || RX_OFFS(rx)[paren].end == -1) )
573                     paren--;
574                 return (U32)paren;
575             }
576         }
577     }
578
579     return (U32)-1;
580 }
581
582 int
583 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
584 {
585     dVAR;
586
587     PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
588
589     if (PL_curpm) {
590         register const REGEXP * const rx = PM_GETRE(PL_curpm);
591         if (rx) {
592             register const I32 paren = mg->mg_len;
593             register I32 s;
594             register I32 t;
595             if (paren < 0)
596                 return 0;
597             if (paren <= (I32)RX_NPARENS(rx) &&
598                 (s = RX_OFFS(rx)[paren].start) != -1 &&
599                 (t = RX_OFFS(rx)[paren].end) != -1)
600                 {
601                     register I32 i;
602                     if (mg->mg_obj)             /* @+ */
603                         i = t;
604                     else                        /* @- */
605                         i = s;
606
607                     if (i > 0 && RX_MATCH_UTF8(rx)) {
608                         const char * const b = RX_SUBBEG(rx);
609                         if (b)
610                             i = utf8_length((U8*)b, (U8*)(b+i));
611                     }
612
613                     sv_setiv(sv, i);
614                 }
615         }
616     }
617     return 0;
618 }
619
620 int
621 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
622 {
623     PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
624     PERL_UNUSED_ARG(sv);
625     PERL_UNUSED_ARG(mg);
626     Perl_croak(aTHX_ "%s", PL_no_modify);
627     NORETURN_FUNCTION_END;
628 }
629
630 U32
631 Perl_magic_len(pTHX_ SV *sv, MAGIC *mg)
632 {
633     dVAR;
634     register I32 paren;
635     register I32 i;
636     register const REGEXP * rx;
637     const char * const remaining = mg->mg_ptr + 1;
638
639     PERL_ARGS_ASSERT_MAGIC_LEN;
640
641     switch (*mg->mg_ptr) {
642     case '\020':                
643       if (*remaining == '\0') { /* ^P */
644           break;
645       } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
646           goto do_prematch;
647       } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
648           goto do_postmatch;
649       }
650       break;
651     case '\015': /* $^MATCH */
652         if (strEQ(remaining, "ATCH")) {
653         goto do_match;
654     } else {
655         break;
656     }
657     case '`':
658       do_prematch:
659       paren = RX_BUFF_IDX_PREMATCH;
660       goto maybegetparen;
661     case '\'':
662       do_postmatch:
663       paren = RX_BUFF_IDX_POSTMATCH;
664       goto maybegetparen;
665     case '&':
666       do_match:
667       paren = RX_BUFF_IDX_FULLMATCH;
668       goto maybegetparen;
669     case '1': case '2': case '3': case '4':
670     case '5': case '6': case '7': case '8': case '9':
671       paren = atoi(mg->mg_ptr);
672     maybegetparen:
673         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
674       getparen:
675         i = CALLREG_NUMBUF_LENGTH((REGEXP * const)rx, sv, paren);
676
677                 if (i < 0)
678                     Perl_croak(aTHX_ "panic: magic_len: %"IVdf, (IV)i);
679                 return i;
680         } else {
681                 if (ckWARN(WARN_UNINITIALIZED))
682                     report_uninit(sv);
683                 return 0;
684         }
685     case '+':
686         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
687             paren = RX_LASTPAREN(rx);
688             if (paren)
689                 goto getparen;
690         }
691         return 0;
692     case '\016': /* ^N */
693         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
694             paren = RX_LASTCLOSEPAREN(rx);
695             if (paren)
696                 goto getparen;
697         }
698         return 0;
699     }
700     magic_get(sv,mg);
701     if (!SvPOK(sv) && SvNIOK(sv)) {
702         sv_2pv(sv, 0);
703     }
704     if (SvPOK(sv))
705         return SvCUR(sv);
706     return 0;
707 }
708
709 #define SvRTRIM(sv) STMT_START { \
710     if (SvPOK(sv)) { \
711         STRLEN len = SvCUR(sv); \
712         char * const p = SvPVX(sv); \
713         while (len > 0 && isSPACE(p[len-1])) \
714            --len; \
715         SvCUR_set(sv, len); \
716         p[len] = '\0'; \
717     } \
718 } STMT_END
719
720 void
721 Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
722 {
723     PERL_ARGS_ASSERT_EMULATE_COP_IO;
724
725     if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
726         sv_setsv(sv, &PL_sv_undef);
727     else {
728         sv_setpvs(sv, "");
729         SvUTF8_off(sv);
730         if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
731             SV *const value = Perl_refcounted_he_fetch(aTHX_
732                                                        c->cop_hints_hash,
733                                                        0, "open<", 5, 0, 0);
734             assert(value);
735             sv_catsv(sv, value);
736         }
737         sv_catpvs(sv, "\0");
738         if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
739             SV *const value = Perl_refcounted_he_fetch(aTHX_
740                                                        c->cop_hints_hash,
741                                                        0, "open>", 5, 0, 0);
742             assert(value);
743             sv_catsv(sv, value);
744         }
745     }
746 }
747
748 int
749 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
750 {
751     dVAR;
752     register I32 paren;
753     register char *s = NULL;
754     register REGEXP *rx;
755     const char * const remaining = mg->mg_ptr + 1;
756     const char nextchar = *remaining;
757
758     PERL_ARGS_ASSERT_MAGIC_GET;
759
760     switch (*mg->mg_ptr) {
761     case '\001':                /* ^A */
762         sv_setsv(sv, PL_bodytarget);
763         break;
764     case '\003':                /* ^C, ^CHILD_ERROR_NATIVE */
765         if (nextchar == '\0') {
766             sv_setiv(sv, (IV)PL_minus_c);
767         }
768         else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
769             sv_setiv(sv, (IV)STATUS_NATIVE);
770         }
771         break;
772
773     case '\004':                /* ^D */
774         sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
775         break;
776     case '\005':  /* ^E */
777          if (nextchar == '\0') {
778 #if defined(VMS)
779              {
780 #                 include <descrip.h>
781 #                 include <starlet.h>
782                   char msg[255];
783                   $DESCRIPTOR(msgdsc,msg);
784                   sv_setnv(sv,(NV) vaxc$errno);
785                   if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
786                        sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
787                   else
788                        sv_setpvs(sv,"");
789              }
790 #elif defined(OS2)
791              if (!(_emx_env & 0x200)) { /* Under DOS */
792                   sv_setnv(sv, (NV)errno);
793                   sv_setpv(sv, errno ? Strerror(errno) : "");
794              } else {
795                   if (errno != errno_isOS2) {
796                        const int tmp = _syserrno();
797                        if (tmp) /* 2nd call to _syserrno() makes it 0 */
798                             Perl_rc = tmp;
799                   }
800                   sv_setnv(sv, (NV)Perl_rc);
801                   sv_setpv(sv, os2error(Perl_rc));
802              }
803 #elif defined(WIN32)
804              {
805                   const DWORD dwErr = GetLastError();
806                   sv_setnv(sv, (NV)dwErr);
807                   if (dwErr) {
808                        PerlProc_GetOSError(sv, dwErr);
809                   }
810                   else
811                        sv_setpvs(sv, "");
812                   SetLastError(dwErr);
813              }
814 #else
815              {
816                  dSAVE_ERRNO;
817                  sv_setnv(sv, (NV)errno);
818                  sv_setpv(sv, errno ? Strerror(errno) : "");
819                  RESTORE_ERRNO;
820              }
821 #endif
822              SvRTRIM(sv);
823              SvNOK_on(sv);      /* what a wonderful hack! */
824          }
825          else if (strEQ(remaining, "NCODING"))
826               sv_setsv(sv, PL_encoding);
827          break;
828     case '\006':                /* ^F */
829         sv_setiv(sv, (IV)PL_maxsysfd);
830         break;
831     case '\010':                /* ^H */
832         sv_setiv(sv, (IV)PL_hints);
833         break;
834     case '\011':                /* ^I */ /* NOT \t in EBCDIC */
835         sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
836         break;
837     case '\017':                /* ^O & ^OPEN */
838         if (nextchar == '\0') {
839             sv_setpv(sv, PL_osname);
840             SvTAINTED_off(sv);
841         }
842         else if (strEQ(remaining, "PEN")) {
843             Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
844         }
845         break;
846     case '\020':                
847         if (nextchar == '\0') {       /* ^P */
848             sv_setiv(sv, (IV)PL_perldb);
849         } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
850             goto do_prematch_fetch;
851         } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
852             goto do_postmatch_fetch;
853         }
854         break;
855     case '\023':                /* ^S */
856         if (nextchar == '\0') {
857             if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
858                 SvOK_off(sv);
859             else if (PL_in_eval)
860                 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
861             else
862                 sv_setiv(sv, 0);
863         }
864         break;
865     case '\024':                /* ^T */
866         if (nextchar == '\0') {
867 #ifdef BIG_TIME
868             sv_setnv(sv, PL_basetime);
869 #else
870             sv_setiv(sv, (IV)PL_basetime);
871 #endif
872         }
873         else if (strEQ(remaining, "AINT"))
874             sv_setiv(sv, PL_tainting
875                     ? (PL_taint_warn || PL_unsafe ? -1 : 1)
876                     : 0);
877         break;
878     case '\025':                /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
879         if (strEQ(remaining, "NICODE"))
880             sv_setuv(sv, (UV) PL_unicode);
881         else if (strEQ(remaining, "TF8LOCALE"))
882             sv_setuv(sv, (UV) PL_utf8locale);
883         else if (strEQ(remaining, "TF8CACHE"))
884             sv_setiv(sv, (IV) PL_utf8cache);
885         break;
886     case '\027':                /* ^W  & $^WARNING_BITS */
887         if (nextchar == '\0')
888             sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
889         else if (strEQ(remaining, "ARNING_BITS")) {
890             if (PL_compiling.cop_warnings == pWARN_NONE) {
891                 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
892             }
893             else if (PL_compiling.cop_warnings == pWARN_STD) {
894                 sv_setpvn(
895                     sv, 
896                     (PL_dowarn & G_WARN_ON) ? WARN_ALLstring : WARN_NONEstring,
897                     WARNsize
898                 );
899             }
900             else if (PL_compiling.cop_warnings == pWARN_ALL) {
901                 /* Get the bit mask for $warnings::Bits{all}, because
902                  * it could have been extended by warnings::register */
903                 HV * const bits=get_hv("warnings::Bits", 0);
904                 if (bits) {
905                     SV ** const bits_all = hv_fetchs(bits, "all", FALSE);
906                     if (bits_all)
907                         sv_setsv(sv, *bits_all);
908                 }
909                 else {
910                     sv_setpvn(sv, WARN_ALLstring, WARNsize) ;
911                 }
912             }
913             else {
914                 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
915                           *PL_compiling.cop_warnings);
916             }
917             SvPOK_only(sv);
918         }
919         break;
920     case '\015': /* $^MATCH */
921         if (strEQ(remaining, "ATCH")) {
922     case '1': case '2': case '3': case '4':
923     case '5': case '6': case '7': case '8': case '9': case '&':
924             if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
925                 /*
926                  * Pre-threads, this was paren = atoi(GvENAME((const GV *)mg->mg_obj));
927                  * XXX Does the new way break anything?
928                  */
929                 paren = atoi(mg->mg_ptr); /* $& is in [0] */
930                 CALLREG_NUMBUF_FETCH(rx,paren,sv);
931                 break;
932             }
933             sv_setsv(sv,&PL_sv_undef);
934         }
935         break;
936     case '+':
937         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
938             if (RX_LASTPAREN(rx)) {
939                 CALLREG_NUMBUF_FETCH(rx,RX_LASTPAREN(rx),sv);
940                 break;
941             }
942         }
943         sv_setsv(sv,&PL_sv_undef);
944         break;
945     case '\016':                /* ^N */
946         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
947             if (RX_LASTCLOSEPAREN(rx)) {
948                 CALLREG_NUMBUF_FETCH(rx,RX_LASTCLOSEPAREN(rx),sv);
949                 break;
950             }
951
952         }
953         sv_setsv(sv,&PL_sv_undef);
954         break;
955     case '`':
956       do_prematch_fetch:
957         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
958             CALLREG_NUMBUF_FETCH(rx,-2,sv);
959             break;
960         }
961         sv_setsv(sv,&PL_sv_undef);
962         break;
963     case '\'':
964       do_postmatch_fetch:
965         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
966             CALLREG_NUMBUF_FETCH(rx,-1,sv);
967             break;
968         }
969         sv_setsv(sv,&PL_sv_undef);
970         break;
971     case '.':
972         if (GvIO(PL_last_in_gv)) {
973             sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
974         }
975         break;
976     case '?':
977         {
978             sv_setiv(sv, (IV)STATUS_CURRENT);
979 #ifdef COMPLEX_STATUS
980             SvUPGRADE(sv, SVt_PVLV);
981             LvTARGOFF(sv) = PL_statusvalue;
982             LvTARGLEN(sv) = PL_statusvalue_vms;
983 #endif
984         }
985         break;
986     case '^':
987         if (GvIOp(PL_defoutgv))
988             s = IoTOP_NAME(GvIOp(PL_defoutgv));
989         if (s)
990             sv_setpv(sv,s);
991         else {
992             sv_setpv(sv,GvENAME(PL_defoutgv));
993             sv_catpvs(sv,"_TOP");
994         }
995         break;
996     case '~':
997         if (GvIOp(PL_defoutgv))
998             s = IoFMT_NAME(GvIOp(PL_defoutgv));
999         if (!s)
1000             s = GvENAME(PL_defoutgv);
1001         sv_setpv(sv,s);
1002         break;
1003     case '=':
1004         if (GvIOp(PL_defoutgv))
1005             sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
1006         break;
1007     case '-':
1008         if (GvIOp(PL_defoutgv))
1009             sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
1010         break;
1011     case '%':
1012         if (GvIOp(PL_defoutgv))
1013             sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
1014         break;
1015     case ':':
1016         break;
1017     case '/':
1018         break;
1019     case '[':
1020         sv_setiv(sv, (IV)CopARYBASE_get(PL_curcop));
1021         break;
1022     case '|':
1023         if (GvIOp(PL_defoutgv))
1024             sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
1025         break;
1026     case '\\':
1027         if (PL_ors_sv)
1028             sv_copypv(sv, PL_ors_sv);
1029         break;
1030     case '!':
1031 #ifdef VMS
1032         sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
1033         sv_setpv(sv, errno ? Strerror(errno) : "");
1034 #else
1035         {
1036         dSAVE_ERRNO;
1037         sv_setnv(sv, (NV)errno);
1038 #ifdef OS2
1039         if (errno == errno_isOS2 || errno == errno_isOS2_set)
1040             sv_setpv(sv, os2error(Perl_rc));
1041         else
1042 #endif
1043         sv_setpv(sv, errno ? Strerror(errno) : "");
1044         RESTORE_ERRNO;
1045         }
1046 #endif
1047         SvRTRIM(sv);
1048         SvNOK_on(sv);   /* what a wonderful hack! */
1049         break;
1050     case '<':
1051         sv_setiv(sv, (IV)PL_uid);
1052         break;
1053     case '>':
1054         sv_setiv(sv, (IV)PL_euid);
1055         break;
1056     case '(':
1057         sv_setiv(sv, (IV)PL_gid);
1058         goto add_groups;
1059     case ')':
1060         sv_setiv(sv, (IV)PL_egid);
1061       add_groups:
1062 #ifdef HAS_GETGROUPS
1063         {
1064             Groups_t *gary = NULL;
1065             I32 i, num_groups = getgroups(0, gary);
1066             Newx(gary, num_groups, Groups_t);
1067             num_groups = getgroups(num_groups, gary);
1068             for (i = 0; i < num_groups; i++)
1069                 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1070             Safefree(gary);
1071         }
1072         (void)SvIOK_on(sv);     /* what a wonderful hack! */
1073 #endif
1074         break;
1075     case '0':
1076         break;
1077     }
1078     return 0;
1079 }
1080
1081 int
1082 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
1083 {
1084     struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
1085
1086     PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1087
1088     if (uf && uf->uf_val)
1089         (*uf->uf_val)(aTHX_ uf->uf_index, sv);
1090     return 0;
1091 }
1092
1093 int
1094 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
1095 {
1096     dVAR;
1097     STRLEN len = 0, klen;
1098     const char *s = SvOK(sv) ? SvPV_const(sv,len) : "";
1099     const char * const ptr = MgPV_const(mg,klen);
1100     my_setenv(ptr, s);
1101
1102     PERL_ARGS_ASSERT_MAGIC_SETENV;
1103
1104 #ifdef DYNAMIC_ENV_FETCH
1105      /* We just undefd an environment var.  Is a replacement */
1106      /* waiting in the wings? */
1107     if (!len) {
1108         SV ** const valp = hv_fetch(GvHVn(PL_envgv), ptr, klen, FALSE);
1109         if (valp)
1110             s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
1111     }
1112 #endif
1113
1114 #if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
1115                             /* And you'll never guess what the dog had */
1116                             /*   in its mouth... */
1117     if (PL_tainting) {
1118         MgTAINTEDDIR_off(mg);
1119 #ifdef VMS
1120         if (s && klen == 8 && strEQ(ptr, "DCL$PATH")) {
1121             char pathbuf[256], eltbuf[256], *cp, *elt;
1122             Stat_t sbuf;
1123             int i = 0, j = 0;
1124
1125             my_strlcpy(eltbuf, s, sizeof(eltbuf));
1126             elt = eltbuf;
1127             do {          /* DCL$PATH may be a search list */
1128                 while (1) {   /* as may dev portion of any element */
1129                     if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1130                         if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1131                              cando_by_name(S_IWUSR,0,elt) ) {
1132                             MgTAINTEDDIR_on(mg);
1133                             return 0;
1134                         }
1135                     }
1136                     if ((cp = strchr(elt, ':')) != NULL)
1137                         *cp = '\0';
1138                     if (my_trnlnm(elt, eltbuf, j++))
1139                         elt = eltbuf;
1140                     else
1141                         break;
1142                 }
1143                 j = 0;
1144             } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1145         }
1146 #endif /* VMS */
1147         if (s && klen == 4 && strEQ(ptr,"PATH")) {
1148             const char * const strend = s + len;
1149
1150             while (s < strend) {
1151                 char tmpbuf[256];
1152                 Stat_t st;
1153                 I32 i;
1154 #ifdef VMS  /* Hmm.  How do we get $Config{path_sep} from C? */
1155                 const char path_sep = '|';
1156 #else
1157                 const char path_sep = ':';
1158 #endif
1159                 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
1160                              s, strend, path_sep, &i);
1161                 s++;
1162                 if (i >= (I32)sizeof tmpbuf   /* too long -- assume the worst */
1163 #ifdef VMS
1164                       || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1165 #else
1166                       || *tmpbuf != '/'       /* no starting slash -- assume relative path */
1167 #endif
1168                       || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1169                     MgTAINTEDDIR_on(mg);
1170                     return 0;
1171                 }
1172             }
1173         }
1174     }
1175 #endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1176
1177     return 0;
1178 }
1179
1180 int
1181 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1182 {
1183     PERL_ARGS_ASSERT_MAGIC_CLEARENV;
1184     PERL_UNUSED_ARG(sv);
1185     my_setenv(MgPV_nolen_const(mg),NULL);
1186     return 0;
1187 }
1188
1189 int
1190 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1191 {
1192     dVAR;
1193     PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
1194     PERL_UNUSED_ARG(mg);
1195 #if defined(VMS)
1196     Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1197 #else
1198     if (PL_localizing) {
1199         HE* entry;
1200         my_clearenv();
1201         hv_iterinit(MUTABLE_HV(sv));
1202         while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
1203             I32 keylen;
1204             my_setenv(hv_iterkey(entry, &keylen),
1205                       SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
1206         }
1207     }
1208 #endif
1209     return 0;
1210 }
1211
1212 int
1213 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1214 {
1215     dVAR;
1216     PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
1217     PERL_UNUSED_ARG(sv);
1218     PERL_UNUSED_ARG(mg);
1219 #if defined(VMS)
1220     Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1221 #else
1222     my_clearenv();
1223 #endif
1224     return 0;
1225 }
1226
1227 #ifndef PERL_MICRO
1228 #ifdef HAS_SIGPROCMASK
1229 static void
1230 restore_sigmask(pTHX_ SV *save_sv)
1231 {
1232     const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1233     (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
1234 }
1235 #endif
1236 int
1237 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1238 {
1239     dVAR;
1240     /* Are we fetching a signal entry? */
1241     int i = (I16)mg->mg_private;
1242
1243     PERL_ARGS_ASSERT_MAGIC_GETSIG;
1244
1245     if (!i) {
1246         mg->mg_private = i = whichsig(MgPV_nolen_const(mg));
1247     }
1248
1249     if (i > 0) {
1250         if(PL_psig_ptr[i])
1251             sv_setsv(sv,PL_psig_ptr[i]);
1252         else {
1253             Sighandler_t sigstate = rsignal_state(i);
1254 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1255             if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1256                 sigstate = SIG_IGN;
1257 #endif
1258 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1259             if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1260                 sigstate = SIG_DFL;
1261 #endif
1262             /* cache state so we don't fetch it again */
1263             if(sigstate == (Sighandler_t) SIG_IGN)
1264                 sv_setpvs(sv,"IGNORE");
1265             else
1266                 sv_setsv(sv,&PL_sv_undef);
1267             PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1268             SvTEMP_off(sv);
1269         }
1270     }
1271     return 0;
1272 }
1273 int
1274 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1275 {
1276     PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
1277     PERL_UNUSED_ARG(sv);
1278
1279     magic_setsig(NULL, mg);
1280     return sv_unmagic(sv, mg->mg_type);
1281 }
1282
1283 Signal_t
1284 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1285 Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
1286 #else
1287 Perl_csighandler(int sig)
1288 #endif
1289 {
1290 #ifdef PERL_GET_SIG_CONTEXT
1291     dTHXa(PERL_GET_SIG_CONTEXT);
1292 #else
1293     dTHX;
1294 #endif
1295 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1296     (void) rsignal(sig, PL_csighandlerp);
1297     if (PL_sig_ignoring[sig]) return;
1298 #endif
1299 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1300     if (PL_sig_defaulting[sig])
1301 #ifdef KILL_BY_SIGPRC
1302             exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1303 #else
1304             exit(1);
1305 #endif
1306 #endif
1307     if (
1308 #ifdef SIGILL
1309            sig == SIGILL ||
1310 #endif
1311 #ifdef SIGBUS
1312            sig == SIGBUS ||
1313 #endif
1314 #ifdef SIGSEGV
1315            sig == SIGSEGV ||
1316 #endif
1317            (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
1318         /* Call the perl level handler now--
1319          * with risk we may be in malloc() etc. */
1320 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1321         (*PL_sighandlerp)(sig, NULL, NULL);
1322 #else
1323         (*PL_sighandlerp)(sig);
1324 #endif
1325     else {
1326         /* Set a flag to say this signal is pending, that is awaiting delivery after
1327          * the current Perl opcode completes */
1328         PL_psig_pend[sig]++;
1329
1330 #ifndef SIG_PENDING_DIE_COUNT
1331 #  define SIG_PENDING_DIE_COUNT 120
1332 #endif
1333         /* And one to say _a_ signal is pending */
1334         if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1335             Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1336                        (unsigned long)SIG_PENDING_DIE_COUNT);
1337     }
1338 }
1339
1340 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1341 void
1342 Perl_csighandler_init(void)
1343 {
1344     int sig;
1345     if (PL_sig_handlers_initted) return;
1346
1347     for (sig = 1; sig < SIG_SIZE; sig++) {
1348 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1349         dTHX;
1350         PL_sig_defaulting[sig] = 1;
1351         (void) rsignal(sig, PL_csighandlerp);
1352 #endif
1353 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1354         PL_sig_ignoring[sig] = 0;
1355 #endif
1356     }
1357     PL_sig_handlers_initted = 1;
1358 }
1359 #endif
1360
1361 void
1362 Perl_despatch_signals(pTHX)
1363 {
1364     dVAR;
1365     int sig;
1366     PL_sig_pending = 0;
1367     for (sig = 1; sig < SIG_SIZE; sig++) {
1368         if (PL_psig_pend[sig]) {
1369             PERL_BLOCKSIG_ADD(set, sig);
1370             PL_psig_pend[sig] = 0;
1371             PERL_BLOCKSIG_BLOCK(set);
1372 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1373             (*PL_sighandlerp)(sig, NULL, NULL);
1374 #else
1375             (*PL_sighandlerp)(sig);
1376 #endif
1377             PERL_BLOCKSIG_UNBLOCK(set);
1378         }
1379     }
1380 }
1381
1382 /* sv of NULL signifies that we're acting as magic_clearsig.  */
1383 int
1384 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1385 {
1386     dVAR;
1387     I32 i;
1388     SV** svp = NULL;
1389     /* Need to be careful with SvREFCNT_dec(), because that can have side
1390      * effects (due to closures). We must make sure that the new disposition
1391      * is in place before it is called.
1392      */
1393     SV* to_dec = NULL;
1394     STRLEN len;
1395 #ifdef HAS_SIGPROCMASK
1396     sigset_t set, save;
1397     SV* save_sv;
1398 #endif
1399     register const char *s = MgPV_const(mg,len);
1400
1401     PERL_ARGS_ASSERT_MAGIC_SETSIG;
1402
1403     if (*s == '_') {
1404         if (strEQ(s,"__DIE__"))
1405             svp = &PL_diehook;
1406         else if (strEQ(s,"__WARN__")
1407                  && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1408             /* Merge the existing behaviours, which are as follows:
1409                magic_setsig, we always set svp to &PL_warnhook
1410                (hence we always change the warnings handler)
1411                For magic_clearsig, we don't change the warnings handler if it's
1412                set to the &PL_warnhook.  */
1413             svp = &PL_warnhook;
1414         } else if (sv)
1415             Perl_croak(aTHX_ "No such hook: %s", s);
1416         i = 0;
1417         if (svp && *svp) {
1418             if (*svp != PERL_WARNHOOK_FATAL)
1419                 to_dec = *svp;
1420             *svp = NULL;
1421         }
1422     }
1423     else {
1424         i = (I16)mg->mg_private;
1425         if (!i) {
1426             i = whichsig(s);    /* ...no, a brick */
1427             mg->mg_private = (U16)i;
1428         }
1429         if (i <= 0) {
1430             if (sv && ckWARN(WARN_SIGNAL))
1431                 Perl_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s", s);
1432             return 0;
1433         }
1434 #ifdef HAS_SIGPROCMASK
1435         /* Avoid having the signal arrive at a bad time, if possible. */
1436         sigemptyset(&set);
1437         sigaddset(&set,i);
1438         sigprocmask(SIG_BLOCK, &set, &save);
1439         ENTER;
1440         save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1441         SAVEFREESV(save_sv);
1442         SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1443 #endif
1444         PERL_ASYNC_CHECK();
1445 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1446         if (!PL_sig_handlers_initted) Perl_csighandler_init();
1447 #endif
1448 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1449         PL_sig_ignoring[i] = 0;
1450 #endif
1451 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1452         PL_sig_defaulting[i] = 0;
1453 #endif
1454         to_dec = PL_psig_ptr[i];
1455         if (sv) {
1456             PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1457             SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1458
1459             /* Signals don't change name during the program's execution, so once
1460                they're cached in the appropriate slot of PL_psig_name, they can
1461                stay there.
1462
1463                Ideally we'd find some way of making SVs at (C) compile time, or
1464                at least, doing most of the work.  */
1465             if (!PL_psig_name[i]) {
1466                 PL_psig_name[i] = newSVpvn(s, len);
1467                 SvREADONLY_on(PL_psig_name[i]);
1468             }
1469         } else {
1470             SvREFCNT_dec(PL_psig_name[i]);
1471             PL_psig_name[i] = NULL;
1472             PL_psig_ptr[i] = NULL;
1473         }
1474     }
1475     if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1476         if (i) {
1477             (void)rsignal(i, PL_csighandlerp);
1478         }
1479         else
1480             *svp = SvREFCNT_inc_simple_NN(sv);
1481     } else {
1482         if (sv && SvOK(sv)) {
1483             s = SvPV_force(sv, len);
1484         } else {
1485             sv = NULL;
1486         }
1487         if (sv && strEQ(s,"IGNORE")) {
1488             if (i) {
1489 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1490                 PL_sig_ignoring[i] = 1;
1491                 (void)rsignal(i, PL_csighandlerp);
1492 #else
1493                 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1494 #endif
1495             }
1496         }
1497         else if (!sv || strEQ(s,"DEFAULT") || !len) {
1498             if (i) {
1499 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1500                 PL_sig_defaulting[i] = 1;
1501                 (void)rsignal(i, PL_csighandlerp);
1502 #else
1503                 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1504 #endif
1505             }
1506         }
1507         else {
1508             /*
1509              * We should warn if HINT_STRICT_REFS, but without
1510              * access to a known hint bit in a known OP, we can't
1511              * tell whether HINT_STRICT_REFS is in force or not.
1512              */
1513             if (!strchr(s,':') && !strchr(s,'\''))
1514                 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1515                                      SV_GMAGIC);
1516             if (i)
1517                 (void)rsignal(i, PL_csighandlerp);
1518             else
1519                 *svp = SvREFCNT_inc_simple_NN(sv);
1520         }
1521     }
1522
1523 #ifdef HAS_SIGPROCMASK
1524     if(i)
1525         LEAVE;
1526 #endif
1527     if(to_dec)
1528         SvREFCNT_dec(to_dec);
1529     return 0;
1530 }
1531 #endif /* !PERL_MICRO */
1532
1533 int
1534 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1535 {
1536     dVAR;
1537     PERL_ARGS_ASSERT_MAGIC_SETISA;
1538     PERL_UNUSED_ARG(sv);
1539
1540     /* Skip _isaelem because _isa will handle it shortly */
1541     if (PL_delaymagic & DM_ARRAY && mg->mg_type == PERL_MAGIC_isaelem)
1542         return 0;
1543
1544     return magic_clearisa(NULL, mg);
1545 }
1546
1547 /* sv of NULL signifies that we're acting as magic_setisa.  */
1548 int
1549 Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1550 {
1551     dVAR;
1552     HV* stash;
1553
1554     PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1555
1556     /* Bail out if destruction is going on */
1557     if(PL_dirty) return 0;
1558
1559     if (sv)
1560         av_clear(MUTABLE_AV(sv));
1561
1562     /* XXX Once it's possible, we need to
1563        detect that our @ISA is aliased in
1564        other stashes, and act on the stashes
1565        of all of the aliases */
1566
1567     /* The first case occurs via setisa,
1568        the second via setisa_elem, which
1569        calls this same magic */
1570     stash = GvSTASH(
1571         SvTYPE(mg->mg_obj) == SVt_PVGV
1572             ? (const GV *)mg->mg_obj
1573             : (const GV *)mg_find(mg->mg_obj, PERL_MAGIC_isa)->mg_obj
1574     );
1575
1576     if (stash)
1577         mro_isa_changed_in(stash);
1578
1579     return 0;
1580 }
1581
1582 int
1583 Perl_magic_setamagic(pTHX_ SV *sv, MAGIC *mg)
1584 {
1585     dVAR;
1586     PERL_ARGS_ASSERT_MAGIC_SETAMAGIC;
1587     PERL_UNUSED_ARG(sv);
1588     PERL_UNUSED_ARG(mg);
1589     PL_amagic_generation++;
1590
1591     return 0;
1592 }
1593
1594 int
1595 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1596 {
1597     HV * const hv = MUTABLE_HV(LvTARG(sv));
1598     I32 i = 0;
1599
1600     PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
1601     PERL_UNUSED_ARG(mg);
1602
1603     if (hv) {
1604          (void) hv_iterinit(hv);
1605          if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1606              i = HvKEYS(hv);
1607          else {
1608              while (hv_iternext(hv))
1609                  i++;
1610          }
1611     }
1612
1613     sv_setiv(sv, (IV)i);
1614     return 0;
1615 }
1616
1617 int
1618 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1619 {
1620     PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
1621     PERL_UNUSED_ARG(mg);
1622     if (LvTARG(sv)) {
1623         hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
1624     }
1625     return 0;
1626 }
1627
1628 /* caller is responsible for stack switching/cleanup */
1629 STATIC int
1630 S_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, const char *meth, I32 flags, int n, SV *val)
1631 {
1632     dVAR;
1633     dSP;
1634
1635     PERL_ARGS_ASSERT_MAGIC_METHCALL;
1636
1637     PUSHMARK(SP);
1638     EXTEND(SP, n);
1639     PUSHs(SvTIED_obj(sv, mg));
1640     if (n > 1) {
1641         if (mg->mg_ptr) {
1642             if (mg->mg_len >= 0)
1643                 mPUSHp(mg->mg_ptr, mg->mg_len);
1644             else if (mg->mg_len == HEf_SVKEY)
1645                 PUSHs(MUTABLE_SV(mg->mg_ptr));
1646         }
1647         else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1648             mPUSHi(mg->mg_len);
1649         }
1650     }
1651     if (n > 2) {
1652         PUSHs(val);
1653     }
1654     PUTBACK;
1655
1656     return call_method(meth, flags);
1657 }
1658
1659 STATIC int
1660 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, const char *meth)
1661 {
1662     dVAR; dSP;
1663
1664     PERL_ARGS_ASSERT_MAGIC_METHPACK;
1665
1666     ENTER;
1667     SAVETMPS;
1668     PUSHSTACKi(PERLSI_MAGIC);
1669
1670     if (magic_methcall(sv, mg, meth, G_SCALAR, 2, NULL)) {
1671         sv_setsv(sv, *PL_stack_sp--);
1672     }
1673
1674     POPSTACK;
1675     FREETMPS;
1676     LEAVE;
1677     return 0;
1678 }
1679
1680 int
1681 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1682 {
1683     PERL_ARGS_ASSERT_MAGIC_GETPACK;
1684
1685     if (mg->mg_ptr)
1686         mg->mg_flags |= MGf_GSKIP;
1687     magic_methpack(sv,mg,"FETCH");
1688     return 0;
1689 }
1690
1691 int
1692 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1693 {
1694     dVAR; dSP;
1695
1696     PERL_ARGS_ASSERT_MAGIC_SETPACK;
1697
1698     ENTER;
1699     PUSHSTACKi(PERLSI_MAGIC);
1700     magic_methcall(sv, mg, "STORE", G_SCALAR|G_DISCARD, 3, sv);
1701     POPSTACK;
1702     LEAVE;
1703     return 0;
1704 }
1705
1706 int
1707 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1708 {
1709     PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1710
1711     return magic_methpack(sv,mg,"DELETE");
1712 }
1713
1714
1715 U32
1716 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1717 {
1718     dVAR; dSP;
1719     I32 retval = 0;
1720
1721     PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1722
1723     ENTER;
1724     SAVETMPS;
1725     PUSHSTACKi(PERLSI_MAGIC);
1726     if (magic_methcall(sv, mg, "FETCHSIZE", G_SCALAR, 2, NULL)) {
1727         sv = *PL_stack_sp--;
1728         retval = SvIV(sv)-1;
1729         if (retval < -1)
1730             Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
1731     }
1732     POPSTACK;
1733     FREETMPS;
1734     LEAVE;
1735     return (U32) retval;
1736 }
1737
1738 int
1739 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1740 {
1741     dVAR; dSP;
1742
1743     PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1744
1745     ENTER;
1746     PUSHSTACKi(PERLSI_MAGIC);
1747     PUSHMARK(SP);
1748     XPUSHs(SvTIED_obj(sv, mg));
1749     PUTBACK;
1750     call_method("CLEAR", G_SCALAR|G_DISCARD);
1751     POPSTACK;
1752     LEAVE;
1753
1754     return 0;
1755 }
1756
1757 int
1758 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1759 {
1760     dVAR; dSP;
1761     const char * const meth = SvOK(key) ? "NEXTKEY" : "FIRSTKEY";
1762
1763     PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1764
1765     ENTER;
1766     SAVETMPS;
1767     PUSHSTACKi(PERLSI_MAGIC);
1768     PUSHMARK(SP);
1769     EXTEND(SP, 2);
1770     PUSHs(SvTIED_obj(sv, mg));
1771     if (SvOK(key))
1772         PUSHs(key);
1773     PUTBACK;
1774
1775     if (call_method(meth, G_SCALAR))
1776         sv_setsv(key, *PL_stack_sp--);
1777
1778     POPSTACK;
1779     FREETMPS;
1780     LEAVE;
1781     return 0;
1782 }
1783
1784 int
1785 Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
1786 {
1787     PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1788
1789     return magic_methpack(sv,mg,"EXISTS");
1790 }
1791
1792 SV *
1793 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1794 {
1795     dVAR; dSP;
1796     SV *retval;
1797     SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1798     HV * const pkg = SvSTASH((const SV *)SvRV(tied));
1799    
1800     PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
1801
1802     if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1803         SV *key;
1804         if (HvEITER_get(hv))
1805             /* we are in an iteration so the hash cannot be empty */
1806             return &PL_sv_yes;
1807         /* no xhv_eiter so now use FIRSTKEY */
1808         key = sv_newmortal();
1809         magic_nextpack(MUTABLE_SV(hv), mg, key);
1810         HvEITER_set(hv, NULL);     /* need to reset iterator */
1811         return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
1812     }
1813    
1814     /* there is a SCALAR method that we can call */
1815     ENTER;
1816     PUSHSTACKi(PERLSI_MAGIC);
1817     PUSHMARK(SP);
1818     EXTEND(SP, 1);
1819     PUSHs(tied);
1820     PUTBACK;
1821
1822     if (call_method("SCALAR", G_SCALAR))
1823         retval = *PL_stack_sp--; 
1824     else
1825         retval = &PL_sv_undef;
1826     POPSTACK;
1827     LEAVE;
1828     return retval;
1829 }
1830
1831 int
1832 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
1833 {
1834     dVAR;
1835     GV * const gv = PL_DBline;
1836     const I32 i = SvTRUE(sv);
1837     SV ** const svp = av_fetch(GvAV(gv),
1838                      atoi(MgPV_nolen_const(mg)), FALSE);
1839
1840     PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
1841
1842     if (svp && SvIOKp(*svp)) {
1843         OP * const o = INT2PTR(OP*,SvIVX(*svp));
1844         if (o) {
1845             /* set or clear breakpoint in the relevant control op */
1846             if (i)
1847                 o->op_flags |= OPf_SPECIAL;
1848             else
1849                 o->op_flags &= ~OPf_SPECIAL;
1850         }
1851     }
1852     return 0;
1853 }
1854
1855 int
1856 Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
1857 {
1858     dVAR;
1859     AV * const obj = MUTABLE_AV(mg->mg_obj);
1860
1861     PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
1862
1863     if (obj) {
1864         sv_setiv(sv, AvFILL(obj) + CopARYBASE_get(PL_curcop));
1865     } else {
1866         SvOK_off(sv);
1867     }
1868     return 0;
1869 }
1870
1871 int
1872 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
1873 {
1874     dVAR;
1875     AV * const obj = MUTABLE_AV(mg->mg_obj);
1876
1877     PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
1878
1879     if (obj) {
1880         av_fill(obj, SvIV(sv) - CopARYBASE_get(PL_curcop));
1881     } else {
1882         if (ckWARN(WARN_MISC))
1883             Perl_warner(aTHX_ packWARN(WARN_MISC),
1884                         "Attempt to set length of freed array");
1885     }
1886     return 0;
1887 }
1888
1889 int
1890 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
1891 {
1892     dVAR;
1893
1894     PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
1895     PERL_UNUSED_ARG(sv);
1896
1897     /* during global destruction, mg_obj may already have been freed */
1898     if (PL_in_clean_all)
1899         return 0;
1900
1901     mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
1902
1903     if (mg) {
1904         /* arylen scalar holds a pointer back to the array, but doesn't own a
1905            reference. Hence the we (the array) are about to go away with it
1906            still pointing at us. Clear its pointer, else it would be pointing
1907            at free memory. See the comment in sv_magic about reference loops,
1908            and why it can't own a reference to us.  */
1909         mg->mg_obj = 0;
1910     }
1911     return 0;
1912 }
1913
1914 int
1915 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
1916 {
1917     dVAR;
1918     SV* const lsv = LvTARG(sv);
1919
1920     PERL_ARGS_ASSERT_MAGIC_GETPOS;
1921     PERL_UNUSED_ARG(mg);
1922
1923     if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv)) {
1924         MAGIC * const found = mg_find(lsv, PERL_MAGIC_regex_global);
1925         if (found && found->mg_len >= 0) {
1926             I32 i = found->mg_len;
1927             if (DO_UTF8(lsv))
1928                 sv_pos_b2u(lsv, &i);
1929             sv_setiv(sv, i + CopARYBASE_get(PL_curcop));
1930             return 0;
1931         }
1932     }
1933     SvOK_off(sv);
1934     return 0;
1935 }
1936
1937 int
1938 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
1939 {
1940     dVAR;
1941     SV* const lsv = LvTARG(sv);
1942     SSize_t pos;
1943     STRLEN len;
1944     STRLEN ulen = 0;
1945     MAGIC* found;
1946
1947     PERL_ARGS_ASSERT_MAGIC_SETPOS;
1948     PERL_UNUSED_ARG(mg);
1949
1950     if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv))
1951         found = mg_find(lsv, PERL_MAGIC_regex_global);
1952     else
1953         found = NULL;
1954     if (!found) {
1955         if (!SvOK(sv))
1956             return 0;
1957 #ifdef PERL_OLD_COPY_ON_WRITE
1958     if (SvIsCOW(lsv))
1959         sv_force_normal_flags(lsv, 0);
1960 #endif
1961         found = sv_magicext(lsv, NULL, PERL_MAGIC_regex_global, &PL_vtbl_mglob,
1962                             NULL, 0);
1963     }
1964     else if (!SvOK(sv)) {
1965         found->mg_len = -1;
1966         return 0;
1967     }
1968     len = SvPOK(lsv) ? SvCUR(lsv) : sv_len(lsv);
1969
1970     pos = SvIV(sv) - CopARYBASE_get(PL_curcop);
1971
1972     if (DO_UTF8(lsv)) {
1973         ulen = sv_len_utf8(lsv);
1974         if (ulen)
1975             len = ulen;
1976     }
1977
1978     if (pos < 0) {
1979         pos += len;
1980         if (pos < 0)
1981             pos = 0;
1982     }
1983     else if (pos > (SSize_t)len)
1984         pos = len;
1985
1986     if (ulen) {
1987         I32 p = pos;
1988         sv_pos_u2b(lsv, &p, 0);
1989         pos = p;
1990     }
1991
1992     found->mg_len = pos;
1993     found->mg_flags &= ~MGf_MINMATCH;
1994
1995     return 0;
1996 }
1997
1998 int
1999 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
2000 {
2001     STRLEN len;
2002     SV * const lsv = LvTARG(sv);
2003     const char * const tmps = SvPV_const(lsv,len);
2004     I32 offs = LvTARGOFF(sv);
2005     I32 rem = LvTARGLEN(sv);
2006
2007     PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2008     PERL_UNUSED_ARG(mg);
2009
2010     if (SvUTF8(lsv))
2011         sv_pos_u2b(lsv, &offs, &rem);
2012     if (offs > (I32)len)
2013         offs = len;
2014     if (rem + offs > (I32)len)
2015         rem = len - offs;
2016     sv_setpvn(sv, tmps + offs, (STRLEN)rem);
2017     if (SvUTF8(lsv))
2018         SvUTF8_on(sv);
2019     return 0;
2020 }
2021
2022 int
2023 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2024 {
2025     dVAR;
2026     STRLEN len;
2027     const char * const tmps = SvPV_const(sv, len);
2028     SV * const lsv = LvTARG(sv);
2029     I32 lvoff = LvTARGOFF(sv);
2030     I32 lvlen = LvTARGLEN(sv);
2031
2032     PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2033     PERL_UNUSED_ARG(mg);
2034
2035     if (DO_UTF8(sv)) {
2036         sv_utf8_upgrade(lsv);
2037         sv_pos_u2b(lsv, &lvoff, &lvlen);
2038         sv_insert(lsv, lvoff, lvlen, tmps, len);
2039         LvTARGLEN(sv) = sv_len_utf8(sv);
2040         SvUTF8_on(lsv);
2041     }
2042     else if (lsv && SvUTF8(lsv)) {
2043         const char *utf8;
2044         sv_pos_u2b(lsv, &lvoff, &lvlen);
2045         LvTARGLEN(sv) = len;
2046         utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2047         sv_insert(lsv, lvoff, lvlen, utf8, len);
2048         Safefree(utf8);
2049     }
2050     else {
2051         sv_insert(lsv, lvoff, lvlen, tmps, len);
2052         LvTARGLEN(sv) = len;
2053     }
2054
2055
2056     return 0;
2057 }
2058
2059 int
2060 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2061 {
2062     dVAR;
2063
2064     PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2065     PERL_UNUSED_ARG(sv);
2066
2067     TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1));
2068     return 0;
2069 }
2070
2071 int
2072 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2073 {
2074     dVAR;
2075
2076     PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2077     PERL_UNUSED_ARG(sv);
2078
2079     /* update taint status */
2080     if (PL_tainted)
2081         mg->mg_len |= 1;
2082     else
2083         mg->mg_len &= ~1;
2084     return 0;
2085 }
2086
2087 int
2088 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2089 {
2090     SV * const lsv = LvTARG(sv);
2091
2092     PERL_ARGS_ASSERT_MAGIC_GETVEC;
2093     PERL_UNUSED_ARG(mg);
2094
2095     if (lsv)
2096         sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2097     else
2098         SvOK_off(sv);
2099
2100     return 0;
2101 }
2102
2103 int
2104 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2105 {
2106     PERL_ARGS_ASSERT_MAGIC_SETVEC;
2107     PERL_UNUSED_ARG(mg);
2108     do_vecset(sv);      /* XXX slurp this routine */
2109     return 0;
2110 }
2111
2112 int
2113 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2114 {
2115     dVAR;
2116     SV *targ = NULL;
2117
2118     PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2119
2120     if (LvTARGLEN(sv)) {
2121         if (mg->mg_obj) {
2122             SV * const ahv = LvTARG(sv);
2123             HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2124             if (he)
2125                 targ = HeVAL(he);
2126         }
2127         else {
2128             AV *const av = MUTABLE_AV(LvTARG(sv));
2129             if ((I32)LvTARGOFF(sv) <= AvFILL(av))
2130                 targ = AvARRAY(av)[LvTARGOFF(sv)];
2131         }
2132         if (targ && (targ != &PL_sv_undef)) {
2133             /* somebody else defined it for us */
2134             SvREFCNT_dec(LvTARG(sv));
2135             LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2136             LvTARGLEN(sv) = 0;
2137             SvREFCNT_dec(mg->mg_obj);
2138             mg->mg_obj = NULL;
2139             mg->mg_flags &= ~MGf_REFCOUNTED;
2140         }
2141     }
2142     else
2143         targ = LvTARG(sv);
2144     sv_setsv(sv, targ ? targ : &PL_sv_undef);
2145     return 0;
2146 }
2147
2148 int
2149 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2150 {
2151     PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2152     PERL_UNUSED_ARG(mg);
2153     if (LvTARGLEN(sv))
2154         vivify_defelem(sv);
2155     if (LvTARG(sv)) {
2156         sv_setsv(LvTARG(sv), sv);
2157         SvSETMAGIC(LvTARG(sv));
2158     }
2159     return 0;
2160 }
2161
2162 void
2163 Perl_vivify_defelem(pTHX_ SV *sv)
2164 {
2165     dVAR;
2166     MAGIC *mg;
2167     SV *value = NULL;
2168
2169     PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2170
2171     if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2172         return;
2173     if (mg->mg_obj) {
2174         SV * const ahv = LvTARG(sv);
2175         HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2176         if (he)
2177             value = HeVAL(he);
2178         if (!value || value == &PL_sv_undef)
2179             Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2180     }
2181     else {
2182         AV *const av = MUTABLE_AV(LvTARG(sv));
2183         if ((I32)LvTARGLEN(sv) < 0 && (I32)LvTARGOFF(sv) > AvFILL(av))
2184             LvTARG(sv) = NULL;  /* array can't be extended */
2185         else {
2186             SV* const * const svp = av_fetch(av, LvTARGOFF(sv), TRUE);
2187             if (!svp || (value = *svp) == &PL_sv_undef)
2188                 Perl_croak(aTHX_ PL_no_aelem, (I32)LvTARGOFF(sv));
2189         }
2190     }
2191     SvREFCNT_inc_simple_void(value);
2192     SvREFCNT_dec(LvTARG(sv));
2193     LvTARG(sv) = value;
2194     LvTARGLEN(sv) = 0;
2195     SvREFCNT_dec(mg->mg_obj);
2196     mg->mg_obj = NULL;
2197     mg->mg_flags &= ~MGf_REFCOUNTED;
2198 }
2199
2200 int
2201 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2202 {
2203     PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2204     return Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2205 }
2206
2207 int
2208 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2209 {
2210     PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2211     PERL_UNUSED_CONTEXT;
2212     mg->mg_len = -1;
2213     SvSCREAM_off(sv);
2214     return 0;
2215 }
2216
2217 int
2218 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2219 {
2220     const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2221
2222     PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2223
2224     if (uf && uf->uf_set)
2225         (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2226     return 0;
2227 }
2228
2229 int
2230 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2231 {
2232     const char type = mg->mg_type;
2233
2234     PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2235
2236     if (type == PERL_MAGIC_qr) {
2237     } else if (type == PERL_MAGIC_bm) {
2238         SvTAIL_off(sv);
2239         SvVALID_off(sv);
2240     } else {
2241         assert(type == PERL_MAGIC_fm);
2242         SvCOMPILED_off(sv);
2243     }
2244     return sv_unmagic(sv, type);
2245 }
2246
2247 #ifdef USE_LOCALE_COLLATE
2248 int
2249 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2250 {
2251     PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2252
2253     /*
2254      * RenE<eacute> Descartes said "I think not."
2255      * and vanished with a faint plop.
2256      */
2257     PERL_UNUSED_CONTEXT;
2258     PERL_UNUSED_ARG(sv);
2259     if (mg->mg_ptr) {
2260         Safefree(mg->mg_ptr);
2261         mg->mg_ptr = NULL;
2262         mg->mg_len = -1;
2263     }
2264     return 0;
2265 }
2266 #endif /* USE_LOCALE_COLLATE */
2267
2268 /* Just clear the UTF-8 cache data. */
2269 int
2270 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2271 {
2272     PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2273     PERL_UNUSED_CONTEXT;
2274     PERL_UNUSED_ARG(sv);
2275     Safefree(mg->mg_ptr);       /* The mg_ptr holds the pos cache. */
2276     mg->mg_ptr = NULL;
2277     mg->mg_len = -1;            /* The mg_len holds the len cache. */
2278     return 0;
2279 }
2280
2281 int
2282 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2283 {
2284     dVAR;
2285     register const char *s;
2286     register I32 paren;
2287     register const REGEXP * rx;
2288     const char * const remaining = mg->mg_ptr + 1;
2289     I32 i;
2290     STRLEN len;
2291
2292     PERL_ARGS_ASSERT_MAGIC_SET;
2293
2294     switch (*mg->mg_ptr) {
2295     case '\015': /* $^MATCH */
2296       if (strEQ(remaining, "ATCH"))
2297           goto do_match;
2298     case '`': /* ${^PREMATCH} caught below */
2299       do_prematch:
2300       paren = RX_BUFF_IDX_PREMATCH;
2301       goto setparen;
2302     case '\'': /* ${^POSTMATCH} caught below */
2303       do_postmatch:
2304       paren = RX_BUFF_IDX_POSTMATCH;
2305       goto setparen;
2306     case '&':
2307       do_match:
2308       paren = RX_BUFF_IDX_FULLMATCH;
2309       goto setparen;
2310     case '1': case '2': case '3': case '4':
2311     case '5': case '6': case '7': case '8': case '9':
2312       paren = atoi(mg->mg_ptr);
2313       setparen:
2314         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2315             CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2316             break;
2317         } else {
2318             /* Croak with a READONLY error when a numbered match var is
2319              * set without a previous pattern match. Unless it's C<local $1>
2320              */
2321             if (!PL_localizing) {
2322                 Perl_croak(aTHX_ "%s", PL_no_modify);
2323             }
2324         }
2325     case '\001':        /* ^A */
2326         sv_setsv(PL_bodytarget, sv);
2327         break;
2328     case '\003':        /* ^C */
2329         PL_minus_c = (bool)SvIV(sv);
2330         break;
2331
2332     case '\004':        /* ^D */
2333 #ifdef DEBUGGING
2334         s = SvPV_nolen_const(sv);
2335         PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2336         DEBUG_x(dump_all());
2337 #else
2338         PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
2339 #endif
2340         break;
2341     case '\005':  /* ^E */
2342         if (*(mg->mg_ptr+1) == '\0') {
2343 #ifdef VMS
2344             set_vaxc_errno(SvIV(sv));
2345 #else
2346 #  ifdef WIN32
2347             SetLastError( SvIV(sv) );
2348 #  else
2349 #    ifdef OS2
2350             os2_setsyserrno(SvIV(sv));
2351 #    else
2352             /* will anyone ever use this? */
2353             SETERRNO(SvIV(sv), 4);
2354 #    endif
2355 #  endif
2356 #endif
2357         }
2358         else if (strEQ(mg->mg_ptr+1, "NCODING")) {
2359             if (PL_encoding)
2360                 SvREFCNT_dec(PL_encoding);
2361             if (SvOK(sv) || SvGMAGICAL(sv)) {
2362                 PL_encoding = newSVsv(sv);
2363             }
2364             else {
2365                 PL_encoding = NULL;
2366             }
2367         }
2368         break;
2369     case '\006':        /* ^F */
2370         PL_maxsysfd = SvIV(sv);
2371         break;
2372     case '\010':        /* ^H */
2373         PL_hints = SvIV(sv);
2374         break;
2375     case '\011':        /* ^I */ /* NOT \t in EBCDIC */
2376         Safefree(PL_inplace);
2377         PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2378         break;
2379     case '\017':        /* ^O */
2380         if (*(mg->mg_ptr+1) == '\0') {
2381             Safefree(PL_osname);
2382             PL_osname = NULL;
2383             if (SvOK(sv)) {
2384                 TAINT_PROPER("assigning to $^O");
2385                 PL_osname = savesvpv(sv);
2386             }
2387         }
2388         else if (strEQ(mg->mg_ptr, "\017PEN")) {
2389             STRLEN len;
2390             const char *const start = SvPV(sv, len);
2391             const char *out = (const char*)memchr(start, '\0', len);
2392             SV *tmp;
2393             struct refcounted_he *tmp_he;
2394
2395
2396             PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2397             PL_hints
2398                 |= HINT_LOCALIZE_HH | HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2399
2400             /* Opening for input is more common than opening for output, so
2401                ensure that hints for input are sooner on linked list.  */
2402             tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2403                                        SVs_TEMP | SvUTF8(sv))
2404                 : newSVpvs_flags("", SVs_TEMP | SvUTF8(sv));
2405
2406             tmp_he
2407                 = Perl_refcounted_he_new(aTHX_ PL_compiling.cop_hints_hash, 
2408                                          newSVpvs_flags("open>", SVs_TEMP),
2409                                          tmp);
2410
2411             /* The UTF-8 setting is carried over  */
2412             sv_setpvn(tmp, start, out ? (STRLEN)(out - start) : len);
2413
2414             PL_compiling.cop_hints_hash
2415                 = Perl_refcounted_he_new(aTHX_ tmp_he,
2416                                          newSVpvs_flags("open<", SVs_TEMP),
2417                                          tmp);
2418         }
2419         break;
2420     case '\020':        /* ^P */
2421       if (*remaining == '\0') { /* ^P */
2422           PL_perldb = SvIV(sv);
2423           if (PL_perldb && !PL_DBsingle)
2424               init_debugger();
2425           break;
2426       } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
2427           goto do_prematch;
2428       } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
2429           goto do_postmatch;
2430       }
2431     case '\024':        /* ^T */
2432 #ifdef BIG_TIME
2433         PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2434 #else
2435         PL_basetime = (Time_t)SvIV(sv);
2436 #endif
2437         break;
2438     case '\025':        /* ^UTF8CACHE */
2439          if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2440              PL_utf8cache = (signed char) sv_2iv(sv);
2441          }
2442          break;
2443     case '\027':        /* ^W & $^WARNING_BITS */
2444         if (*(mg->mg_ptr+1) == '\0') {
2445             if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2446                 i = SvIV(sv);
2447                 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2448                                 | (i ? G_WARN_ON : G_WARN_OFF) ;
2449             }
2450         }
2451         else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2452             if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2453                 if (!SvPOK(sv) && PL_localizing) {
2454                     sv_setpvn(sv, WARN_NONEstring, WARNsize);
2455                     PL_compiling.cop_warnings = pWARN_NONE;
2456                     break;
2457                 }
2458                 {
2459                     STRLEN len, i;
2460                     int accumulate = 0 ;
2461                     int any_fatals = 0 ;
2462                     const char * const ptr = SvPV_const(sv, len) ;
2463                     for (i = 0 ; i < len ; ++i) {
2464                         accumulate |= ptr[i] ;
2465                         any_fatals |= (ptr[i] & 0xAA) ;
2466                     }
2467                     if (!accumulate) {
2468                         if (!specialWARN(PL_compiling.cop_warnings))
2469                             PerlMemShared_free(PL_compiling.cop_warnings);
2470                         PL_compiling.cop_warnings = pWARN_NONE;
2471                     }
2472                     /* Yuck. I can't see how to abstract this:  */
2473                     else if (isWARN_on(((STRLEN *)SvPV_nolen_const(sv)) - 1,
2474                                        WARN_ALL) && !any_fatals) {
2475                         if (!specialWARN(PL_compiling.cop_warnings))
2476                             PerlMemShared_free(PL_compiling.cop_warnings);
2477                         PL_compiling.cop_warnings = pWARN_ALL;
2478                         PL_dowarn |= G_WARN_ONCE ;
2479                     }
2480                     else {
2481                         STRLEN len;
2482                         const char *const p = SvPV_const(sv, len);
2483
2484                         PL_compiling.cop_warnings
2485                             = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2486                                                          p, len);
2487
2488                         if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2489                             PL_dowarn |= G_WARN_ONCE ;
2490                     }
2491
2492                 }
2493             }
2494         }
2495         break;
2496     case '.':
2497         if (PL_localizing) {
2498             if (PL_localizing == 1)
2499                 SAVESPTR(PL_last_in_gv);
2500         }
2501         else if (SvOK(sv) && GvIO(PL_last_in_gv))
2502             IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2503         break;
2504     case '^':
2505         Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2506         s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2507         IoTOP_GV(GvIOp(PL_defoutgv)) =  gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2508         break;
2509     case '~':
2510         Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2511         s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2512         IoFMT_GV(GvIOp(PL_defoutgv)) =  gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2513         break;
2514     case '=':
2515         IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2516         break;
2517     case '-':
2518         IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2519         if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2520             IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2521         break;
2522     case '%':
2523         IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2524         break;
2525     case '|':
2526         {
2527             IO * const io = GvIOp(PL_defoutgv);
2528             if(!io)
2529               break;
2530             if ((SvIV(sv)) == 0)
2531                 IoFLAGS(io) &= ~IOf_FLUSH;
2532             else {
2533                 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2534                     PerlIO *ofp = IoOFP(io);
2535                     if (ofp)
2536                         (void)PerlIO_flush(ofp);
2537                     IoFLAGS(io) |= IOf_FLUSH;
2538                 }
2539             }
2540         }
2541         break;
2542     case '/':
2543         SvREFCNT_dec(PL_rs);
2544         PL_rs = newSVsv(sv);
2545         break;
2546     case '\\':
2547         if (PL_ors_sv)
2548             SvREFCNT_dec(PL_ors_sv);
2549         if (SvOK(sv) || SvGMAGICAL(sv)) {
2550             PL_ors_sv = newSVsv(sv);
2551         }
2552         else {
2553             PL_ors_sv = NULL;
2554         }
2555         break;
2556     case '[':
2557         CopARYBASE_set(&PL_compiling, SvIV(sv));
2558         break;
2559     case '?':
2560 #ifdef COMPLEX_STATUS
2561         if (PL_localizing == 2) {
2562             SvUPGRADE(sv, SVt_PVLV);
2563             PL_statusvalue = LvTARGOFF(sv);
2564             PL_statusvalue_vms = LvTARGLEN(sv);
2565         }
2566         else
2567 #endif
2568 #ifdef VMSISH_STATUS
2569         if (VMSISH_STATUS)
2570             STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
2571         else
2572 #endif
2573             STATUS_UNIX_EXIT_SET(SvIV(sv));
2574         break;
2575     case '!':
2576         {
2577 #ifdef VMS
2578 #   define PERL_VMS_BANG vaxc$errno
2579 #else
2580 #   define PERL_VMS_BANG 0
2581 #endif
2582         SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2583                  (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2584         }
2585         break;
2586     case '<':
2587         PL_uid = SvIV(sv);
2588         if (PL_delaymagic) {
2589             PL_delaymagic |= DM_RUID;
2590             break;                              /* don't do magic till later */
2591         }
2592 #ifdef HAS_SETRUID
2593         (void)setruid((Uid_t)PL_uid);
2594 #else
2595 #ifdef HAS_SETREUID
2596         (void)setreuid((Uid_t)PL_uid, (Uid_t)-1);
2597 #else
2598 #ifdef HAS_SETRESUID
2599       (void)setresuid((Uid_t)PL_uid, (Uid_t)-1, (Uid_t)-1);
2600 #else
2601         if (PL_uid == PL_euid) {                /* special case $< = $> */
2602 #ifdef PERL_DARWIN
2603             /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2604             if (PL_uid != 0 && PerlProc_getuid() == 0)
2605                 (void)PerlProc_setuid(0);
2606 #endif
2607             (void)PerlProc_setuid(PL_uid);
2608         } else {
2609             PL_uid = PerlProc_getuid();
2610             Perl_croak(aTHX_ "setruid() not implemented");
2611         }
2612 #endif
2613 #endif
2614 #endif
2615         PL_uid = PerlProc_getuid();
2616         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2617         break;
2618     case '>':
2619         PL_euid = SvIV(sv);
2620         if (PL_delaymagic) {
2621             PL_delaymagic |= DM_EUID;
2622             break;                              /* don't do magic till later */
2623         }
2624 #ifdef HAS_SETEUID
2625         (void)seteuid((Uid_t)PL_euid);
2626 #else
2627 #ifdef HAS_SETREUID
2628         (void)setreuid((Uid_t)-1, (Uid_t)PL_euid);
2629 #else
2630 #ifdef HAS_SETRESUID
2631         (void)setresuid((Uid_t)-1, (Uid_t)PL_euid, (Uid_t)-1);
2632 #else
2633         if (PL_euid == PL_uid)          /* special case $> = $< */
2634             PerlProc_setuid(PL_euid);
2635         else {
2636             PL_euid = PerlProc_geteuid();
2637             Perl_croak(aTHX_ "seteuid() not implemented");
2638         }
2639 #endif
2640 #endif
2641 #endif
2642         PL_euid = PerlProc_geteuid();
2643         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2644         break;
2645     case '(':
2646         PL_gid = SvIV(sv);
2647         if (PL_delaymagic) {
2648             PL_delaymagic |= DM_RGID;
2649             break;                              /* don't do magic till later */
2650         }
2651 #ifdef HAS_SETRGID
2652         (void)setrgid((Gid_t)PL_gid);
2653 #else
2654 #ifdef HAS_SETREGID
2655         (void)setregid((Gid_t)PL_gid, (Gid_t)-1);
2656 #else
2657 #ifdef HAS_SETRESGID
2658       (void)setresgid((Gid_t)PL_gid, (Gid_t)-1, (Gid_t) 1);
2659 #else
2660         if (PL_gid == PL_egid)                  /* special case $( = $) */
2661             (void)PerlProc_setgid(PL_gid);
2662         else {
2663             PL_gid = PerlProc_getgid();
2664             Perl_croak(aTHX_ "setrgid() not implemented");
2665         }
2666 #endif
2667 #endif
2668 #endif
2669         PL_gid = PerlProc_getgid();
2670         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2671         break;
2672     case ')':
2673 #ifdef HAS_SETGROUPS
2674         {
2675             const char *p = SvPV_const(sv, len);
2676             Groups_t *gary = NULL;
2677
2678             while (isSPACE(*p))
2679                 ++p;
2680             PL_egid = Atol(p);
2681             for (i = 0; i < NGROUPS; ++i) {
2682                 while (*p && !isSPACE(*p))
2683                     ++p;
2684                 while (isSPACE(*p))
2685                     ++p;
2686                 if (!*p)
2687                     break;
2688                 if(!gary)
2689                     Newx(gary, i + 1, Groups_t);
2690                 else
2691                     Renew(gary, i + 1, Groups_t);
2692                 gary[i] = Atol(p);
2693             }
2694             if (i)
2695                 (void)setgroups(i, gary);
2696             Safefree(gary);
2697         }
2698 #else  /* HAS_SETGROUPS */
2699         PL_egid = SvIV(sv);
2700 #endif /* HAS_SETGROUPS */
2701         if (PL_delaymagic) {
2702             PL_delaymagic |= DM_EGID;
2703             break;                              /* don't do magic till later */
2704         }
2705 #ifdef HAS_SETEGID
2706         (void)setegid((Gid_t)PL_egid);
2707 #else
2708 #ifdef HAS_SETREGID
2709         (void)setregid((Gid_t)-1, (Gid_t)PL_egid);
2710 #else
2711 #ifdef HAS_SETRESGID
2712         (void)setresgid((Gid_t)-1, (Gid_t)PL_egid, (Gid_t)-1);
2713 #else
2714         if (PL_egid == PL_gid)                  /* special case $) = $( */
2715             (void)PerlProc_setgid(PL_egid);
2716         else {
2717             PL_egid = PerlProc_getegid();
2718             Perl_croak(aTHX_ "setegid() not implemented");
2719         }
2720 #endif
2721 #endif
2722 #endif
2723         PL_egid = PerlProc_getegid();
2724         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2725         break;
2726     case ':':
2727         PL_chopset = SvPV_force(sv,len);
2728         break;
2729     case '0':
2730         LOCK_DOLLARZERO_MUTEX;
2731 #ifdef HAS_SETPROCTITLE
2732         /* The BSDs don't show the argv[] in ps(1) output, they
2733          * show a string from the process struct and provide
2734          * the setproctitle() routine to manipulate that. */
2735         if (PL_origalen != 1) {
2736             s = SvPV_const(sv, len);
2737 #   if __FreeBSD_version > 410001
2738             /* The leading "-" removes the "perl: " prefix,
2739              * but not the "(perl) suffix from the ps(1)
2740              * output, because that's what ps(1) shows if the
2741              * argv[] is modified. */
2742             setproctitle("-%s", s);
2743 #   else        /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2744             /* This doesn't really work if you assume that
2745              * $0 = 'foobar'; will wipe out 'perl' from the $0
2746              * because in ps(1) output the result will be like
2747              * sprintf("perl: %s (perl)", s)
2748              * I guess this is a security feature:
2749              * one (a user process) cannot get rid of the original name.
2750              * --jhi */
2751             setproctitle("%s", s);
2752 #   endif
2753         }
2754 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2755         if (PL_origalen != 1) {
2756              union pstun un;
2757              s = SvPV_const(sv, len);
2758              un.pst_command = (char *)s;
2759              pstat(PSTAT_SETCMD, un, len, 0, 0);
2760         }
2761 #else
2762         if (PL_origalen > 1) {
2763             /* PL_origalen is set in perl_parse(). */
2764             s = SvPV_force(sv,len);
2765             if (len >= (STRLEN)PL_origalen-1) {
2766                 /* Longer than original, will be truncated. We assume that
2767                  * PL_origalen bytes are available. */
2768                 Copy(s, PL_origargv[0], PL_origalen-1, char);
2769             }
2770             else {
2771                 /* Shorter than original, will be padded. */
2772 #ifdef PERL_DARWIN
2773                 /* Special case for Mac OS X: see [perl #38868] */
2774                 const int pad = 0;
2775 #else
2776                 /* Is the space counterintuitive?  Yes.
2777                  * (You were expecting \0?)
2778                  * Does it work?  Seems to.  (In Linux 2.4.20 at least.)
2779                  * --jhi */
2780                 const int pad = ' ';
2781 #endif
2782                 Copy(s, PL_origargv[0], len, char);
2783                 PL_origargv[0][len] = 0;
2784                 memset(PL_origargv[0] + len + 1,
2785                        pad,  PL_origalen - len - 1);
2786             }
2787             PL_origargv[0][PL_origalen-1] = 0;
2788             for (i = 1; i < PL_origargc; i++)
2789                 PL_origargv[i] = 0;
2790         }
2791 #endif
2792         UNLOCK_DOLLARZERO_MUTEX;
2793         break;
2794     }
2795     return 0;
2796 }
2797
2798 I32
2799 Perl_whichsig(pTHX_ const char *sig)
2800 {
2801     register char* const* sigv;
2802
2803     PERL_ARGS_ASSERT_WHICHSIG;
2804     PERL_UNUSED_CONTEXT;
2805
2806     for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
2807         if (strEQ(sig,*sigv))
2808             return PL_sig_num[sigv - (char* const*)PL_sig_name];
2809 #ifdef SIGCLD
2810     if (strEQ(sig,"CHLD"))
2811         return SIGCLD;
2812 #endif
2813 #ifdef SIGCHLD
2814     if (strEQ(sig,"CLD"))
2815         return SIGCHLD;
2816 #endif
2817     return -1;
2818 }
2819
2820 Signal_t
2821 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
2822 Perl_sighandler(int sig, siginfo_t *sip, void *uap PERL_UNUSED_DECL)
2823 #else
2824 Perl_sighandler(int sig)
2825 #endif
2826 {
2827 #ifdef PERL_GET_SIG_CONTEXT
2828     dTHXa(PERL_GET_SIG_CONTEXT);
2829 #else
2830     dTHX;
2831 #endif
2832     dSP;
2833     GV *gv = NULL;
2834     SV *sv = NULL;
2835     SV * const tSv = PL_Sv;
2836     CV *cv = NULL;
2837     OP *myop = PL_op;
2838     U32 flags = 0;
2839     XPV * const tXpv = PL_Xpv;
2840
2841     if (PL_savestack_ix + 15 <= PL_savestack_max)
2842         flags |= 1;
2843     if (PL_markstack_ptr < PL_markstack_max - 2)
2844         flags |= 4;
2845     if (PL_scopestack_ix < PL_scopestack_max - 3)
2846         flags |= 16;
2847
2848     if (!PL_psig_ptr[sig]) {
2849                 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
2850                                  PL_sig_name[sig]);
2851                 exit(sig);
2852         }
2853
2854     /* Max number of items pushed there is 3*n or 4. We cannot fix
2855        infinity, so we fix 4 (in fact 5): */
2856     if (flags & 1) {
2857         PL_savestack_ix += 5;           /* Protect save in progress. */
2858         SAVEDESTRUCTOR_X(S_unwind_handler_stack, (void*)&flags);
2859     }
2860     if (flags & 4)
2861         PL_markstack_ptr++;             /* Protect mark. */
2862     if (flags & 16)
2863         PL_scopestack_ix += 1;
2864     /* sv_2cv is too complicated, try a simpler variant first: */
2865     if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
2866         || SvTYPE(cv) != SVt_PVCV) {
2867         HV *st;
2868         cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
2869     }
2870
2871     if (!cv || !CvROOT(cv)) {
2872         if (ckWARN(WARN_SIGNAL))
2873             Perl_warner(aTHX_ packWARN(WARN_SIGNAL), "SIG%s handler \"%s\" not defined.\n",
2874                 PL_sig_name[sig], (gv ? GvENAME(gv)
2875                                 : ((cv && CvGV(cv))
2876                                    ? GvENAME(CvGV(cv))
2877                                    : "__ANON__")));
2878         goto cleanup;
2879     }
2880
2881     if(PL_psig_name[sig]) {
2882         sv = SvREFCNT_inc_NN(PL_psig_name[sig]);
2883         flags |= 64;
2884 #if !defined(PERL_IMPLICIT_CONTEXT)
2885         PL_sig_sv = sv;
2886 #endif
2887     } else {
2888         sv = sv_newmortal();
2889         sv_setpv(sv,PL_sig_name[sig]);
2890     }
2891
2892     PUSHSTACKi(PERLSI_SIGNAL);
2893     PUSHMARK(SP);
2894     PUSHs(sv);
2895 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
2896     {
2897          struct sigaction oact;
2898
2899          if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
2900               if (sip) {
2901                    HV *sih = newHV();
2902                    SV *rv  = newRV_noinc(MUTABLE_SV(sih));
2903                    /* The siginfo fields signo, code, errno, pid, uid,
2904                     * addr, status, and band are defined by POSIX/SUSv3. */
2905                    (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
2906                    (void)hv_stores(sih, "code", newSViv(sip->si_code));
2907 #if 0 /* XXX TODO: Configure scan for the existence of these, but even that does not help if the SA_SIGINFO is not implemented according to the spec. */
2908                    hv_stores(sih, "errno",      newSViv(sip->si_errno));
2909                    hv_stores(sih, "status",     newSViv(sip->si_status));
2910                    hv_stores(sih, "uid",        newSViv(sip->si_uid));
2911                    hv_stores(sih, "pid",        newSViv(sip->si_pid));
2912                    hv_stores(sih, "addr",       newSVuv(PTR2UV(sip->si_addr)));
2913                    hv_stores(sih, "band",       newSViv(sip->si_band));
2914 #endif
2915                    EXTEND(SP, 2);
2916                    PUSHs(rv);
2917                    mPUSHp((char *)sip, sizeof(*sip));
2918               }
2919
2920          }
2921     }
2922 #endif
2923     PUTBACK;
2924
2925     call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
2926
2927     POPSTACK;
2928     if (SvTRUE(ERRSV)) {
2929 #ifndef PERL_MICRO
2930 #ifdef HAS_SIGPROCMASK
2931         /* Handler "died", for example to get out of a restart-able read().
2932          * Before we re-do that on its behalf re-enable the signal which was
2933          * blocked by the system when we entered.
2934          */
2935         sigset_t set;
2936         sigemptyset(&set);
2937         sigaddset(&set,sig);
2938         sigprocmask(SIG_UNBLOCK, &set, NULL);
2939 #else
2940         /* Not clear if this will work */
2941         (void)rsignal(sig, SIG_IGN);
2942         (void)rsignal(sig, PL_csighandlerp);
2943 #endif
2944 #endif /* !PERL_MICRO */
2945         Perl_die(aTHX_ NULL);
2946     }
2947 cleanup:
2948     if (flags & 1)
2949         PL_savestack_ix -= 8; /* Unprotect save in progress. */
2950     if (flags & 4)
2951         PL_markstack_ptr--;
2952     if (flags & 16)
2953         PL_scopestack_ix -= 1;
2954     if (flags & 64)
2955         SvREFCNT_dec(sv);
2956     PL_op = myop;                       /* Apparently not needed... */
2957
2958     PL_Sv = tSv;                        /* Restore global temporaries. */
2959     PL_Xpv = tXpv;
2960     return;
2961 }
2962
2963
2964 static void
2965 S_restore_magic(pTHX_ const void *p)
2966 {
2967     dVAR;
2968     MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
2969     SV* const sv = mgs->mgs_sv;
2970
2971     if (!sv)
2972         return;
2973
2974     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
2975     {
2976 #ifdef PERL_OLD_COPY_ON_WRITE
2977         /* While magic was saved (and off) sv_setsv may well have seen
2978            this SV as a prime candidate for COW.  */
2979         if (SvIsCOW(sv))
2980             sv_force_normal_flags(sv, 0);
2981 #endif
2982
2983         if (mgs->mgs_flags)
2984             SvFLAGS(sv) |= mgs->mgs_flags;
2985         else
2986             mg_magical(sv);
2987         if (SvGMAGICAL(sv)) {
2988             /* downgrade public flags to private,
2989                and discard any other private flags */
2990
2991             const U32 pubflags = SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK);
2992             if (pubflags) {
2993                 SvFLAGS(sv) &= ~( pubflags | (SVp_IOK|SVp_NOK|SVp_POK) );
2994                 SvFLAGS(sv) |= ( pubflags << PRIVSHIFT );
2995             }
2996         }
2997     }
2998
2999     mgs->mgs_sv = NULL;  /* mark the MGS structure as restored */
3000
3001     /* If we're still on top of the stack, pop us off.  (That condition
3002      * will be satisfied if restore_magic was called explicitly, but *not*
3003      * if it's being called via leave_scope.)
3004      * The reason for doing this is that otherwise, things like sv_2cv()
3005      * may leave alloc gunk on the savestack, and some code
3006      * (e.g. sighandler) doesn't expect that...
3007      */
3008     if (PL_savestack_ix == mgs->mgs_ss_ix)
3009     {
3010         I32 popval = SSPOPINT;
3011         assert(popval == SAVEt_DESTRUCTOR_X);
3012         PL_savestack_ix -= 2;
3013         popval = SSPOPINT;
3014         assert(popval == SAVEt_ALLOC);
3015         popval = SSPOPINT;
3016         PL_savestack_ix -= popval;
3017     }
3018
3019 }
3020
3021 static void
3022 S_unwind_handler_stack(pTHX_ const void *p)
3023 {
3024     dVAR;
3025     const U32 flags = *(const U32*)p;
3026
3027     PERL_ARGS_ASSERT_UNWIND_HANDLER_STACK;
3028
3029     if (flags & 1)
3030         PL_savestack_ix -= 5; /* Unprotect save in progress. */
3031 #if !defined(PERL_IMPLICIT_CONTEXT)
3032     if (flags & 64)
3033         SvREFCNT_dec(PL_sig_sv);
3034 #endif
3035 }
3036
3037 /*
3038 =for apidoc magic_sethint
3039
3040 Triggered by a store to %^H, records the key/value pair to
3041 C<PL_compiling.cop_hints_hash>.  It is assumed that hints aren't storing
3042 anything that would need a deep copy.  Maybe we should warn if we find a
3043 reference.
3044
3045 =cut
3046 */
3047 int
3048 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3049 {
3050     dVAR;
3051     SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3052         : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3053
3054     PERL_ARGS_ASSERT_MAGIC_SETHINT;
3055
3056     /* mg->mg_obj isn't being used.  If needed, it would be possible to store
3057        an alternative leaf in there, with PL_compiling.cop_hints being used if
3058        it's NULL. If needed for threads, the alternative could lock a mutex,
3059        or take other more complex action.  */
3060
3061     /* Something changed in %^H, so it will need to be restored on scope exit.
3062        Doing this here saves a lot of doing it manually in perl code (and
3063        forgetting to do it, and consequent subtle errors.  */
3064     PL_hints |= HINT_LOCALIZE_HH;
3065     PL_compiling.cop_hints_hash
3066         = Perl_refcounted_he_new(aTHX_ PL_compiling.cop_hints_hash, key, sv);
3067     return 0;
3068 }
3069
3070 /*
3071 =for apidoc magic_clearhint
3072
3073 Triggered by a delete from %^H, records the key to
3074 C<PL_compiling.cop_hints_hash>.
3075
3076 =cut
3077 */
3078 int
3079 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3080 {
3081     dVAR;
3082
3083     PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3084     PERL_UNUSED_ARG(sv);
3085
3086     assert(mg->mg_len == HEf_SVKEY);
3087
3088     PERL_UNUSED_ARG(sv);
3089
3090     PL_hints |= HINT_LOCALIZE_HH;
3091     PL_compiling.cop_hints_hash
3092         = Perl_refcounted_he_new(aTHX_ PL_compiling.cop_hints_hash,
3093                                  MUTABLE_SV(mg->mg_ptr), &PL_sv_placeholder);
3094     return 0;
3095 }
3096
3097 /*
3098  * Local variables:
3099  * c-indentation-style: bsd
3100  * c-basic-offset: 4
3101  * indent-tabs-mode: t
3102  * End:
3103  *
3104  * ex: set ts=8 sts=4 sw=4 noet:
3105  */