This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
* Remove some end-of-line whitespace from perlebcdic
[perl5.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() or being destructed 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         if (!PL_psig_pend) return;
1327         /* Set a flag to say this signal is pending, that is awaiting delivery after
1328          * the current Perl opcode completes */
1329         PL_psig_pend[sig]++;
1330
1331 #ifndef SIG_PENDING_DIE_COUNT
1332 #  define SIG_PENDING_DIE_COUNT 120
1333 #endif
1334         /* Add one to say _a_ signal is pending */
1335         if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1336             Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1337                        (unsigned long)SIG_PENDING_DIE_COUNT);
1338     }
1339 }
1340
1341 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1342 void
1343 Perl_csighandler_init(void)
1344 {
1345     int sig;
1346     if (PL_sig_handlers_initted) return;
1347
1348     for (sig = 1; sig < SIG_SIZE; sig++) {
1349 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1350         dTHX;
1351         PL_sig_defaulting[sig] = 1;
1352         (void) rsignal(sig, PL_csighandlerp);
1353 #endif
1354 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1355         PL_sig_ignoring[sig] = 0;
1356 #endif
1357     }
1358     PL_sig_handlers_initted = 1;
1359 }
1360 #endif
1361
1362 void
1363 Perl_despatch_signals(pTHX)
1364 {
1365     dVAR;
1366     int sig;
1367     PL_sig_pending = 0;
1368     for (sig = 1; sig < SIG_SIZE; sig++) {
1369         if (PL_psig_pend[sig]) {
1370             PERL_BLOCKSIG_ADD(set, sig);
1371             PL_psig_pend[sig] = 0;
1372             PERL_BLOCKSIG_BLOCK(set);
1373 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1374             (*PL_sighandlerp)(sig, NULL, NULL);
1375 #else
1376             (*PL_sighandlerp)(sig);
1377 #endif
1378             PERL_BLOCKSIG_UNBLOCK(set);
1379         }
1380     }
1381 }
1382
1383 /* sv of NULL signifies that we're acting as magic_clearsig.  */
1384 int
1385 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1386 {
1387     dVAR;
1388     I32 i;
1389     SV** svp = NULL;
1390     /* Need to be careful with SvREFCNT_dec(), because that can have side
1391      * effects (due to closures). We must make sure that the new disposition
1392      * is in place before it is called.
1393      */
1394     SV* to_dec = NULL;
1395     STRLEN len;
1396 #ifdef HAS_SIGPROCMASK
1397     sigset_t set, save;
1398     SV* save_sv;
1399 #endif
1400     register const char *s = MgPV_const(mg,len);
1401
1402     PERL_ARGS_ASSERT_MAGIC_SETSIG;
1403
1404     if (*s == '_') {
1405         if (strEQ(s,"__DIE__"))
1406             svp = &PL_diehook;
1407         else if (strEQ(s,"__WARN__")
1408                  && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1409             /* Merge the existing behaviours, which are as follows:
1410                magic_setsig, we always set svp to &PL_warnhook
1411                (hence we always change the warnings handler)
1412                For magic_clearsig, we don't change the warnings handler if it's
1413                set to the &PL_warnhook.  */
1414             svp = &PL_warnhook;
1415         } else if (sv)
1416             Perl_croak(aTHX_ "No such hook: %s", s);
1417         i = 0;
1418         if (svp && *svp) {
1419             if (*svp != PERL_WARNHOOK_FATAL)
1420                 to_dec = *svp;
1421             *svp = NULL;
1422         }
1423     }
1424     else {
1425         i = (I16)mg->mg_private;
1426         if (!i) {
1427             i = whichsig(s);    /* ...no, a brick */
1428             mg->mg_private = (U16)i;
1429         }
1430         if (i <= 0) {
1431             if (sv)
1432                 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s", s);
1433             return 0;
1434         }
1435 #ifdef HAS_SIGPROCMASK
1436         /* Avoid having the signal arrive at a bad time, if possible. */
1437         sigemptyset(&set);
1438         sigaddset(&set,i);
1439         sigprocmask(SIG_BLOCK, &set, &save);
1440         ENTER;
1441         save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1442         SAVEFREESV(save_sv);
1443         SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1444 #endif
1445         PERL_ASYNC_CHECK();
1446 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1447         if (!PL_sig_handlers_initted) Perl_csighandler_init();
1448 #endif
1449 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1450         PL_sig_ignoring[i] = 0;
1451 #endif
1452 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1453         PL_sig_defaulting[i] = 0;
1454 #endif
1455         to_dec = PL_psig_ptr[i];
1456         if (sv) {
1457             PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1458             SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1459
1460             /* Signals don't change name during the program's execution, so once
1461                they're cached in the appropriate slot of PL_psig_name, they can
1462                stay there.
1463
1464                Ideally we'd find some way of making SVs at (C) compile time, or
1465                at least, doing most of the work.  */
1466             if (!PL_psig_name[i]) {
1467                 PL_psig_name[i] = newSVpvn(s, len);
1468                 SvREADONLY_on(PL_psig_name[i]);
1469             }
1470         } else {
1471             SvREFCNT_dec(PL_psig_name[i]);
1472             PL_psig_name[i] = NULL;
1473             PL_psig_ptr[i] = NULL;
1474         }
1475     }
1476     if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1477         if (i) {
1478             (void)rsignal(i, PL_csighandlerp);
1479         }
1480         else
1481             *svp = SvREFCNT_inc_simple_NN(sv);
1482     } else {
1483         if (sv && SvOK(sv)) {
1484             s = SvPV_force(sv, len);
1485         } else {
1486             sv = NULL;
1487         }
1488         if (sv && strEQ(s,"IGNORE")) {
1489             if (i) {
1490 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1491                 PL_sig_ignoring[i] = 1;
1492                 (void)rsignal(i, PL_csighandlerp);
1493 #else
1494                 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1495 #endif
1496             }
1497         }
1498         else if (!sv || strEQ(s,"DEFAULT") || !len) {
1499             if (i) {
1500 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1501                 PL_sig_defaulting[i] = 1;
1502                 (void)rsignal(i, PL_csighandlerp);
1503 #else
1504                 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1505 #endif
1506             }
1507         }
1508         else {
1509             /*
1510              * We should warn if HINT_STRICT_REFS, but without
1511              * access to a known hint bit in a known OP, we can't
1512              * tell whether HINT_STRICT_REFS is in force or not.
1513              */
1514             if (!strchr(s,':') && !strchr(s,'\''))
1515                 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1516                                      SV_GMAGIC);
1517             if (i)
1518                 (void)rsignal(i, PL_csighandlerp);
1519             else
1520                 *svp = SvREFCNT_inc_simple_NN(sv);
1521         }
1522     }
1523
1524 #ifdef HAS_SIGPROCMASK
1525     if(i)
1526         LEAVE;
1527 #endif
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         Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
1883                        "Attempt to set length of freed array");
1884     }
1885     return 0;
1886 }
1887
1888 int
1889 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
1890 {
1891     dVAR;
1892
1893     PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
1894     PERL_UNUSED_ARG(sv);
1895
1896     /* during global destruction, mg_obj may already have been freed */
1897     if (PL_in_clean_all)
1898         return 0;
1899
1900     mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
1901
1902     if (mg) {
1903         /* arylen scalar holds a pointer back to the array, but doesn't own a
1904            reference. Hence the we (the array) are about to go away with it
1905            still pointing at us. Clear its pointer, else it would be pointing
1906            at free memory. See the comment in sv_magic about reference loops,
1907            and why it can't own a reference to us.  */
1908         mg->mg_obj = 0;
1909     }
1910     return 0;
1911 }
1912
1913 int
1914 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
1915 {
1916     dVAR;
1917     SV* const lsv = LvTARG(sv);
1918
1919     PERL_ARGS_ASSERT_MAGIC_GETPOS;
1920     PERL_UNUSED_ARG(mg);
1921
1922     if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv)) {
1923         MAGIC * const found = mg_find(lsv, PERL_MAGIC_regex_global);
1924         if (found && found->mg_len >= 0) {
1925             I32 i = found->mg_len;
1926             if (DO_UTF8(lsv))
1927                 sv_pos_b2u(lsv, &i);
1928             sv_setiv(sv, i + CopARYBASE_get(PL_curcop));
1929             return 0;
1930         }
1931     }
1932     SvOK_off(sv);
1933     return 0;
1934 }
1935
1936 int
1937 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
1938 {
1939     dVAR;
1940     SV* const lsv = LvTARG(sv);
1941     SSize_t pos;
1942     STRLEN len;
1943     STRLEN ulen = 0;
1944     MAGIC* found;
1945
1946     PERL_ARGS_ASSERT_MAGIC_SETPOS;
1947     PERL_UNUSED_ARG(mg);
1948
1949     if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv))
1950         found = mg_find(lsv, PERL_MAGIC_regex_global);
1951     else
1952         found = NULL;
1953     if (!found) {
1954         if (!SvOK(sv))
1955             return 0;
1956 #ifdef PERL_OLD_COPY_ON_WRITE
1957     if (SvIsCOW(lsv))
1958         sv_force_normal_flags(lsv, 0);
1959 #endif
1960         found = sv_magicext(lsv, NULL, PERL_MAGIC_regex_global, &PL_vtbl_mglob,
1961                             NULL, 0);
1962     }
1963     else if (!SvOK(sv)) {
1964         found->mg_len = -1;
1965         return 0;
1966     }
1967     len = SvPOK(lsv) ? SvCUR(lsv) : sv_len(lsv);
1968
1969     pos = SvIV(sv) - CopARYBASE_get(PL_curcop);
1970
1971     if (DO_UTF8(lsv)) {
1972         ulen = sv_len_utf8(lsv);
1973         if (ulen)
1974             len = ulen;
1975     }
1976
1977     if (pos < 0) {
1978         pos += len;
1979         if (pos < 0)
1980             pos = 0;
1981     }
1982     else if (pos > (SSize_t)len)
1983         pos = len;
1984
1985     if (ulen) {
1986         I32 p = pos;
1987         sv_pos_u2b(lsv, &p, 0);
1988         pos = p;
1989     }
1990
1991     found->mg_len = pos;
1992     found->mg_flags &= ~MGf_MINMATCH;
1993
1994     return 0;
1995 }
1996
1997 int
1998 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
1999 {
2000     STRLEN len;
2001     SV * const lsv = LvTARG(sv);
2002     const char * const tmps = SvPV_const(lsv,len);
2003     I32 offs = LvTARGOFF(sv);
2004     I32 rem = LvTARGLEN(sv);
2005
2006     PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2007     PERL_UNUSED_ARG(mg);
2008
2009     if (SvUTF8(lsv))
2010         sv_pos_u2b(lsv, &offs, &rem);
2011     if (offs > (I32)len)
2012         offs = len;
2013     if (rem + offs > (I32)len)
2014         rem = len - offs;
2015     sv_setpvn(sv, tmps + offs, (STRLEN)rem);
2016     if (SvUTF8(lsv))
2017         SvUTF8_on(sv);
2018     return 0;
2019 }
2020
2021 int
2022 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2023 {
2024     dVAR;
2025     STRLEN len;
2026     const char * const tmps = SvPV_const(sv, len);
2027     SV * const lsv = LvTARG(sv);
2028     I32 lvoff = LvTARGOFF(sv);
2029     I32 lvlen = LvTARGLEN(sv);
2030
2031     PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2032     PERL_UNUSED_ARG(mg);
2033
2034     if (DO_UTF8(sv)) {
2035         sv_utf8_upgrade(lsv);
2036         sv_pos_u2b(lsv, &lvoff, &lvlen);
2037         sv_insert(lsv, lvoff, lvlen, tmps, len);
2038         LvTARGLEN(sv) = sv_len_utf8(sv);
2039         SvUTF8_on(lsv);
2040     }
2041     else if (lsv && SvUTF8(lsv)) {
2042         const char *utf8;
2043         sv_pos_u2b(lsv, &lvoff, &lvlen);
2044         LvTARGLEN(sv) = len;
2045         utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2046         sv_insert(lsv, lvoff, lvlen, utf8, len);
2047         Safefree(utf8);
2048     }
2049     else {
2050         sv_insert(lsv, lvoff, lvlen, tmps, len);
2051         LvTARGLEN(sv) = len;
2052     }
2053
2054
2055     return 0;
2056 }
2057
2058 int
2059 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2060 {
2061     dVAR;
2062
2063     PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2064     PERL_UNUSED_ARG(sv);
2065
2066     TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1));
2067     return 0;
2068 }
2069
2070 int
2071 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2072 {
2073     dVAR;
2074
2075     PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2076     PERL_UNUSED_ARG(sv);
2077
2078     /* update taint status */
2079     if (PL_tainted)
2080         mg->mg_len |= 1;
2081     else
2082         mg->mg_len &= ~1;
2083     return 0;
2084 }
2085
2086 int
2087 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2088 {
2089     SV * const lsv = LvTARG(sv);
2090
2091     PERL_ARGS_ASSERT_MAGIC_GETVEC;
2092     PERL_UNUSED_ARG(mg);
2093
2094     if (lsv)
2095         sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2096     else
2097         SvOK_off(sv);
2098
2099     return 0;
2100 }
2101
2102 int
2103 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2104 {
2105     PERL_ARGS_ASSERT_MAGIC_SETVEC;
2106     PERL_UNUSED_ARG(mg);
2107     do_vecset(sv);      /* XXX slurp this routine */
2108     return 0;
2109 }
2110
2111 int
2112 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2113 {
2114     dVAR;
2115     SV *targ = NULL;
2116
2117     PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2118
2119     if (LvTARGLEN(sv)) {
2120         if (mg->mg_obj) {
2121             SV * const ahv = LvTARG(sv);
2122             HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2123             if (he)
2124                 targ = HeVAL(he);
2125         }
2126         else {
2127             AV *const av = MUTABLE_AV(LvTARG(sv));
2128             if ((I32)LvTARGOFF(sv) <= AvFILL(av))
2129                 targ = AvARRAY(av)[LvTARGOFF(sv)];
2130         }
2131         if (targ && (targ != &PL_sv_undef)) {
2132             /* somebody else defined it for us */
2133             SvREFCNT_dec(LvTARG(sv));
2134             LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2135             LvTARGLEN(sv) = 0;
2136             SvREFCNT_dec(mg->mg_obj);
2137             mg->mg_obj = NULL;
2138             mg->mg_flags &= ~MGf_REFCOUNTED;
2139         }
2140     }
2141     else
2142         targ = LvTARG(sv);
2143     sv_setsv(sv, targ ? targ : &PL_sv_undef);
2144     return 0;
2145 }
2146
2147 int
2148 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2149 {
2150     PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2151     PERL_UNUSED_ARG(mg);
2152     if (LvTARGLEN(sv))
2153         vivify_defelem(sv);
2154     if (LvTARG(sv)) {
2155         sv_setsv(LvTARG(sv), sv);
2156         SvSETMAGIC(LvTARG(sv));
2157     }
2158     return 0;
2159 }
2160
2161 void
2162 Perl_vivify_defelem(pTHX_ SV *sv)
2163 {
2164     dVAR;
2165     MAGIC *mg;
2166     SV *value = NULL;
2167
2168     PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2169
2170     if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2171         return;
2172     if (mg->mg_obj) {
2173         SV * const ahv = LvTARG(sv);
2174         HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2175         if (he)
2176             value = HeVAL(he);
2177         if (!value || value == &PL_sv_undef)
2178             Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2179     }
2180     else {
2181         AV *const av = MUTABLE_AV(LvTARG(sv));
2182         if ((I32)LvTARGLEN(sv) < 0 && (I32)LvTARGOFF(sv) > AvFILL(av))
2183             LvTARG(sv) = NULL;  /* array can't be extended */
2184         else {
2185             SV* const * const svp = av_fetch(av, LvTARGOFF(sv), TRUE);
2186             if (!svp || (value = *svp) == &PL_sv_undef)
2187                 Perl_croak(aTHX_ PL_no_aelem, (I32)LvTARGOFF(sv));
2188         }
2189     }
2190     SvREFCNT_inc_simple_void(value);
2191     SvREFCNT_dec(LvTARG(sv));
2192     LvTARG(sv) = value;
2193     LvTARGLEN(sv) = 0;
2194     SvREFCNT_dec(mg->mg_obj);
2195     mg->mg_obj = NULL;
2196     mg->mg_flags &= ~MGf_REFCOUNTED;
2197 }
2198
2199 int
2200 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2201 {
2202     PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2203     return Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2204 }
2205
2206 int
2207 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2208 {
2209     PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2210     PERL_UNUSED_CONTEXT;
2211     mg->mg_len = -1;
2212     SvSCREAM_off(sv);
2213     return 0;
2214 }
2215
2216 int
2217 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2218 {
2219     const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2220
2221     PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2222
2223     if (uf && uf->uf_set)
2224         (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2225     return 0;
2226 }
2227
2228 int
2229 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2230 {
2231     const char type = mg->mg_type;
2232
2233     PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2234
2235     if (type == PERL_MAGIC_qr) {
2236     } else if (type == PERL_MAGIC_bm) {
2237         SvTAIL_off(sv);
2238         SvVALID_off(sv);
2239     } else {
2240         assert(type == PERL_MAGIC_fm);
2241         SvCOMPILED_off(sv);
2242     }
2243     return sv_unmagic(sv, type);
2244 }
2245
2246 #ifdef USE_LOCALE_COLLATE
2247 int
2248 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2249 {
2250     PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2251
2252     /*
2253      * RenE<eacute> Descartes said "I think not."
2254      * and vanished with a faint plop.
2255      */
2256     PERL_UNUSED_CONTEXT;
2257     PERL_UNUSED_ARG(sv);
2258     if (mg->mg_ptr) {
2259         Safefree(mg->mg_ptr);
2260         mg->mg_ptr = NULL;
2261         mg->mg_len = -1;
2262     }
2263     return 0;
2264 }
2265 #endif /* USE_LOCALE_COLLATE */
2266
2267 /* Just clear the UTF-8 cache data. */
2268 int
2269 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2270 {
2271     PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2272     PERL_UNUSED_CONTEXT;
2273     PERL_UNUSED_ARG(sv);
2274     Safefree(mg->mg_ptr);       /* The mg_ptr holds the pos cache. */
2275     mg->mg_ptr = NULL;
2276     mg->mg_len = -1;            /* The mg_len holds the len cache. */
2277     return 0;
2278 }
2279
2280 int
2281 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2282 {
2283     dVAR;
2284     register const char *s;
2285     register I32 paren;
2286     register const REGEXP * rx;
2287     const char * const remaining = mg->mg_ptr + 1;
2288     I32 i;
2289     STRLEN len;
2290
2291     PERL_ARGS_ASSERT_MAGIC_SET;
2292
2293     switch (*mg->mg_ptr) {
2294     case '\015': /* $^MATCH */
2295       if (strEQ(remaining, "ATCH"))
2296           goto do_match;
2297     case '`': /* ${^PREMATCH} caught below */
2298       do_prematch:
2299       paren = RX_BUFF_IDX_PREMATCH;
2300       goto setparen;
2301     case '\'': /* ${^POSTMATCH} caught below */
2302       do_postmatch:
2303       paren = RX_BUFF_IDX_POSTMATCH;
2304       goto setparen;
2305     case '&':
2306       do_match:
2307       paren = RX_BUFF_IDX_FULLMATCH;
2308       goto setparen;
2309     case '1': case '2': case '3': case '4':
2310     case '5': case '6': case '7': case '8': case '9':
2311       paren = atoi(mg->mg_ptr);
2312       setparen:
2313         if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2314             CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2315             break;
2316         } else {
2317             /* Croak with a READONLY error when a numbered match var is
2318              * set without a previous pattern match. Unless it's C<local $1>
2319              */
2320             if (!PL_localizing) {
2321                 Perl_croak(aTHX_ "%s", PL_no_modify);
2322             }
2323         }
2324     case '\001':        /* ^A */
2325         sv_setsv(PL_bodytarget, sv);
2326         break;
2327     case '\003':        /* ^C */
2328         PL_minus_c = (bool)SvIV(sv);
2329         break;
2330
2331     case '\004':        /* ^D */
2332 #ifdef DEBUGGING
2333         s = SvPV_nolen_const(sv);
2334         PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2335         if (DEBUG_x_TEST || DEBUG_B_TEST)
2336             dump_all_perl(!DEBUG_B_TEST);
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             SvREFCNT_dec(PL_encoding);
2360             if (SvOK(sv) || SvGMAGICAL(sv)) {
2361                 PL_encoding = newSVsv(sv);
2362             }
2363             else {
2364                 PL_encoding = NULL;
2365             }
2366         }
2367         break;
2368     case '\006':        /* ^F */
2369         PL_maxsysfd = SvIV(sv);
2370         break;
2371     case '\010':        /* ^H */
2372         PL_hints = SvIV(sv);
2373         break;
2374     case '\011':        /* ^I */ /* NOT \t in EBCDIC */
2375         Safefree(PL_inplace);
2376         PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2377         break;
2378     case '\017':        /* ^O */
2379         if (*(mg->mg_ptr+1) == '\0') {
2380             Safefree(PL_osname);
2381             PL_osname = NULL;
2382             if (SvOK(sv)) {
2383                 TAINT_PROPER("assigning to $^O");
2384                 PL_osname = savesvpv(sv);
2385             }
2386         }
2387         else if (strEQ(mg->mg_ptr, "\017PEN")) {
2388             STRLEN len;
2389             const char *const start = SvPV(sv, len);
2390             const char *out = (const char*)memchr(start, '\0', len);
2391             SV *tmp;
2392
2393
2394             PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2395             PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2396
2397             /* Opening for input is more common than opening for output, so
2398                ensure that hints for input are sooner on linked list.  */
2399             tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2400                                        SvUTF8(sv))
2401                 : newSVpvs_flags("", SvUTF8(sv));
2402             (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2403             mg_set(tmp);
2404
2405             tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2406                                         SvUTF8(sv));
2407             (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2408             mg_set(tmp);
2409         }
2410         break;
2411     case '\020':        /* ^P */
2412       if (*remaining == '\0') { /* ^P */
2413           PL_perldb = SvIV(sv);
2414           if (PL_perldb && !PL_DBsingle)
2415               init_debugger();
2416           break;
2417       } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
2418           goto do_prematch;
2419       } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
2420           goto do_postmatch;
2421       }
2422     case '\024':        /* ^T */
2423 #ifdef BIG_TIME
2424         PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2425 #else
2426         PL_basetime = (Time_t)SvIV(sv);
2427 #endif
2428         break;
2429     case '\025':        /* ^UTF8CACHE */
2430          if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2431              PL_utf8cache = (signed char) sv_2iv(sv);
2432          }
2433          break;
2434     case '\027':        /* ^W & $^WARNING_BITS */
2435         if (*(mg->mg_ptr+1) == '\0') {
2436             if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2437                 i = SvIV(sv);
2438                 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2439                                 | (i ? G_WARN_ON : G_WARN_OFF) ;
2440             }
2441         }
2442         else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2443             if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2444                 if (!SvPOK(sv) && PL_localizing) {
2445                     sv_setpvn(sv, WARN_NONEstring, WARNsize);
2446                     PL_compiling.cop_warnings = pWARN_NONE;
2447                     break;
2448                 }
2449                 {
2450                     STRLEN len, i;
2451                     int accumulate = 0 ;
2452                     int any_fatals = 0 ;
2453                     const char * const ptr = SvPV_const(sv, len) ;
2454                     for (i = 0 ; i < len ; ++i) {
2455                         accumulate |= ptr[i] ;
2456                         any_fatals |= (ptr[i] & 0xAA) ;
2457                     }
2458                     if (!accumulate) {
2459                         if (!specialWARN(PL_compiling.cop_warnings))
2460                             PerlMemShared_free(PL_compiling.cop_warnings);
2461                         PL_compiling.cop_warnings = pWARN_NONE;
2462                     }
2463                     /* Yuck. I can't see how to abstract this:  */
2464                     else if (isWARN_on(((STRLEN *)SvPV_nolen_const(sv)) - 1,
2465                                        WARN_ALL) && !any_fatals) {
2466                         if (!specialWARN(PL_compiling.cop_warnings))
2467                             PerlMemShared_free(PL_compiling.cop_warnings);
2468                         PL_compiling.cop_warnings = pWARN_ALL;
2469                         PL_dowarn |= G_WARN_ONCE ;
2470                     }
2471                     else {
2472                         STRLEN len;
2473                         const char *const p = SvPV_const(sv, len);
2474
2475                         PL_compiling.cop_warnings
2476                             = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2477                                                          p, len);
2478
2479                         if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2480                             PL_dowarn |= G_WARN_ONCE ;
2481                     }
2482
2483                 }
2484             }
2485         }
2486         break;
2487     case '.':
2488         if (PL_localizing) {
2489             if (PL_localizing == 1)
2490                 SAVESPTR(PL_last_in_gv);
2491         }
2492         else if (SvOK(sv) && GvIO(PL_last_in_gv))
2493             IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2494         break;
2495     case '^':
2496         Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2497         s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2498         IoTOP_GV(GvIOp(PL_defoutgv)) =  gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2499         break;
2500     case '~':
2501         Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2502         s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2503         IoFMT_GV(GvIOp(PL_defoutgv)) =  gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2504         break;
2505     case '=':
2506         IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2507         break;
2508     case '-':
2509         IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2510         if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2511             IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2512         break;
2513     case '%':
2514         IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2515         break;
2516     case '|':
2517         {
2518             IO * const io = GvIOp(PL_defoutgv);
2519             if(!io)
2520               break;
2521             if ((SvIV(sv)) == 0)
2522                 IoFLAGS(io) &= ~IOf_FLUSH;
2523             else {
2524                 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2525                     PerlIO *ofp = IoOFP(io);
2526                     if (ofp)
2527                         (void)PerlIO_flush(ofp);
2528                     IoFLAGS(io) |= IOf_FLUSH;
2529                 }
2530             }
2531         }
2532         break;
2533     case '/':
2534         SvREFCNT_dec(PL_rs);
2535         PL_rs = newSVsv(sv);
2536         break;
2537     case '\\':
2538         SvREFCNT_dec(PL_ors_sv);
2539         if (SvOK(sv) || SvGMAGICAL(sv)) {
2540             PL_ors_sv = newSVsv(sv);
2541         }
2542         else {
2543             PL_ors_sv = NULL;
2544         }
2545         break;
2546     case '[':
2547         CopARYBASE_set(&PL_compiling, SvIV(sv));
2548         break;
2549     case '?':
2550 #ifdef COMPLEX_STATUS
2551         if (PL_localizing == 2) {
2552             SvUPGRADE(sv, SVt_PVLV);
2553             PL_statusvalue = LvTARGOFF(sv);
2554             PL_statusvalue_vms = LvTARGLEN(sv);
2555         }
2556         else
2557 #endif
2558 #ifdef VMSISH_STATUS
2559         if (VMSISH_STATUS)
2560             STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
2561         else
2562 #endif
2563             STATUS_UNIX_EXIT_SET(SvIV(sv));
2564         break;
2565     case '!':
2566         {
2567 #ifdef VMS
2568 #   define PERL_VMS_BANG vaxc$errno
2569 #else
2570 #   define PERL_VMS_BANG 0
2571 #endif
2572         SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2573                  (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2574         }
2575         break;
2576     case '<':
2577         PL_uid = SvIV(sv);
2578         if (PL_delaymagic) {
2579             PL_delaymagic |= DM_RUID;
2580             break;                              /* don't do magic till later */
2581         }
2582 #ifdef HAS_SETRUID
2583         (void)setruid((Uid_t)PL_uid);
2584 #else
2585 #ifdef HAS_SETREUID
2586         (void)setreuid((Uid_t)PL_uid, (Uid_t)-1);
2587 #else
2588 #ifdef HAS_SETRESUID
2589       (void)setresuid((Uid_t)PL_uid, (Uid_t)-1, (Uid_t)-1);
2590 #else
2591         if (PL_uid == PL_euid) {                /* special case $< = $> */
2592 #ifdef PERL_DARWIN
2593             /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2594             if (PL_uid != 0 && PerlProc_getuid() == 0)
2595                 (void)PerlProc_setuid(0);
2596 #endif
2597             (void)PerlProc_setuid(PL_uid);
2598         } else {
2599             PL_uid = PerlProc_getuid();
2600             Perl_croak(aTHX_ "setruid() not implemented");
2601         }
2602 #endif
2603 #endif
2604 #endif
2605         PL_uid = PerlProc_getuid();
2606         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2607         break;
2608     case '>':
2609         PL_euid = SvIV(sv);
2610         if (PL_delaymagic) {
2611             PL_delaymagic |= DM_EUID;
2612             break;                              /* don't do magic till later */
2613         }
2614 #ifdef HAS_SETEUID
2615         (void)seteuid((Uid_t)PL_euid);
2616 #else
2617 #ifdef HAS_SETREUID
2618         (void)setreuid((Uid_t)-1, (Uid_t)PL_euid);
2619 #else
2620 #ifdef HAS_SETRESUID
2621         (void)setresuid((Uid_t)-1, (Uid_t)PL_euid, (Uid_t)-1);
2622 #else
2623         if (PL_euid == PL_uid)          /* special case $> = $< */
2624             PerlProc_setuid(PL_euid);
2625         else {
2626             PL_euid = PerlProc_geteuid();
2627             Perl_croak(aTHX_ "seteuid() not implemented");
2628         }
2629 #endif
2630 #endif
2631 #endif
2632         PL_euid = PerlProc_geteuid();
2633         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2634         break;
2635     case '(':
2636         PL_gid = SvIV(sv);
2637         if (PL_delaymagic) {
2638             PL_delaymagic |= DM_RGID;
2639             break;                              /* don't do magic till later */
2640         }
2641 #ifdef HAS_SETRGID
2642         (void)setrgid((Gid_t)PL_gid);
2643 #else
2644 #ifdef HAS_SETREGID
2645         (void)setregid((Gid_t)PL_gid, (Gid_t)-1);
2646 #else
2647 #ifdef HAS_SETRESGID
2648       (void)setresgid((Gid_t)PL_gid, (Gid_t)-1, (Gid_t) 1);
2649 #else
2650         if (PL_gid == PL_egid)                  /* special case $( = $) */
2651             (void)PerlProc_setgid(PL_gid);
2652         else {
2653             PL_gid = PerlProc_getgid();
2654             Perl_croak(aTHX_ "setrgid() not implemented");
2655         }
2656 #endif
2657 #endif
2658 #endif
2659         PL_gid = PerlProc_getgid();
2660         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2661         break;
2662     case ')':
2663 #ifdef HAS_SETGROUPS
2664         {
2665             const char *p = SvPV_const(sv, len);
2666             Groups_t *gary = NULL;
2667 #ifdef _SC_NGROUPS_MAX
2668            int maxgrp = sysconf(_SC_NGROUPS_MAX);
2669
2670            if (maxgrp < 0)
2671                maxgrp = NGROUPS;
2672 #else
2673            int maxgrp = NGROUPS;
2674 #endif
2675
2676             while (isSPACE(*p))
2677                 ++p;
2678             PL_egid = Atol(p);
2679             for (i = 0; i < maxgrp; ++i) {
2680                 while (*p && !isSPACE(*p))
2681                     ++p;
2682                 while (isSPACE(*p))
2683                     ++p;
2684                 if (!*p)
2685                     break;
2686                 if(!gary)
2687                     Newx(gary, i + 1, Groups_t);
2688                 else
2689                     Renew(gary, i + 1, Groups_t);
2690                 gary[i] = Atol(p);
2691             }
2692             if (i)
2693                 (void)setgroups(i, gary);
2694             Safefree(gary);
2695         }
2696 #else  /* HAS_SETGROUPS */
2697         PL_egid = SvIV(sv);
2698 #endif /* HAS_SETGROUPS */
2699         if (PL_delaymagic) {
2700             PL_delaymagic |= DM_EGID;
2701             break;                              /* don't do magic till later */
2702         }
2703 #ifdef HAS_SETEGID
2704         (void)setegid((Gid_t)PL_egid);
2705 #else
2706 #ifdef HAS_SETREGID
2707         (void)setregid((Gid_t)-1, (Gid_t)PL_egid);
2708 #else
2709 #ifdef HAS_SETRESGID
2710         (void)setresgid((Gid_t)-1, (Gid_t)PL_egid, (Gid_t)-1);
2711 #else
2712         if (PL_egid == PL_gid)                  /* special case $) = $( */
2713             (void)PerlProc_setgid(PL_egid);
2714         else {
2715             PL_egid = PerlProc_getegid();
2716             Perl_croak(aTHX_ "setegid() not implemented");
2717         }
2718 #endif
2719 #endif
2720 #endif
2721         PL_egid = PerlProc_getegid();
2722         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2723         break;
2724     case ':':
2725         PL_chopset = SvPV_force(sv,len);
2726         break;
2727     case '0':
2728         LOCK_DOLLARZERO_MUTEX;
2729 #ifdef HAS_SETPROCTITLE
2730         /* The BSDs don't show the argv[] in ps(1) output, they
2731          * show a string from the process struct and provide
2732          * the setproctitle() routine to manipulate that. */
2733         if (PL_origalen != 1) {
2734             s = SvPV_const(sv, len);
2735 #   if __FreeBSD_version > 410001
2736             /* The leading "-" removes the "perl: " prefix,
2737              * but not the "(perl) suffix from the ps(1)
2738              * output, because that's what ps(1) shows if the
2739              * argv[] is modified. */
2740             setproctitle("-%s", s);
2741 #   else        /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2742             /* This doesn't really work if you assume that
2743              * $0 = 'foobar'; will wipe out 'perl' from the $0
2744              * because in ps(1) output the result will be like
2745              * sprintf("perl: %s (perl)", s)
2746              * I guess this is a security feature:
2747              * one (a user process) cannot get rid of the original name.
2748              * --jhi */
2749             setproctitle("%s", s);
2750 #   endif
2751         }
2752 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2753         if (PL_origalen != 1) {
2754              union pstun un;
2755              s = SvPV_const(sv, len);
2756              un.pst_command = (char *)s;
2757              pstat(PSTAT_SETCMD, un, len, 0, 0);
2758         }
2759 #else
2760         if (PL_origalen > 1) {
2761             /* PL_origalen is set in perl_parse(). */
2762             s = SvPV_force(sv,len);
2763             if (len >= (STRLEN)PL_origalen-1) {
2764                 /* Longer than original, will be truncated. We assume that
2765                  * PL_origalen bytes are available. */
2766                 Copy(s, PL_origargv[0], PL_origalen-1, char);
2767             }
2768             else {
2769                 /* Shorter than original, will be padded. */
2770 #ifdef PERL_DARWIN
2771                 /* Special case for Mac OS X: see [perl #38868] */
2772                 const int pad = 0;
2773 #else
2774                 /* Is the space counterintuitive?  Yes.
2775                  * (You were expecting \0?)
2776                  * Does it work?  Seems to.  (In Linux 2.4.20 at least.)
2777                  * --jhi */
2778                 const int pad = ' ';
2779 #endif
2780                 Copy(s, PL_origargv[0], len, char);
2781                 PL_origargv[0][len] = 0;
2782                 memset(PL_origargv[0] + len + 1,
2783                        pad,  PL_origalen - len - 1);
2784             }
2785             PL_origargv[0][PL_origalen-1] = 0;
2786             for (i = 1; i < PL_origargc; i++)
2787                 PL_origargv[i] = 0;
2788         }
2789 #endif
2790         UNLOCK_DOLLARZERO_MUTEX;
2791         break;
2792     }
2793     return 0;
2794 }
2795
2796 I32
2797 Perl_whichsig(pTHX_ const char *sig)
2798 {
2799     register char* const* sigv;
2800
2801     PERL_ARGS_ASSERT_WHICHSIG;
2802     PERL_UNUSED_CONTEXT;
2803
2804     for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
2805         if (strEQ(sig,*sigv))
2806             return PL_sig_num[sigv - (char* const*)PL_sig_name];
2807 #ifdef SIGCLD
2808     if (strEQ(sig,"CHLD"))
2809         return SIGCLD;
2810 #endif
2811 #ifdef SIGCHLD
2812     if (strEQ(sig,"CLD"))
2813         return SIGCHLD;
2814 #endif
2815     return -1;
2816 }
2817
2818 Signal_t
2819 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
2820 Perl_sighandler(int sig, siginfo_t *sip, void *uap PERL_UNUSED_DECL)
2821 #else
2822 Perl_sighandler(int sig)
2823 #endif
2824 {
2825 #ifdef PERL_GET_SIG_CONTEXT
2826     dTHXa(PERL_GET_SIG_CONTEXT);
2827 #else
2828     dTHX;
2829 #endif
2830     dSP;
2831     GV *gv = NULL;
2832     SV *sv = NULL;
2833     SV * const tSv = PL_Sv;
2834     CV *cv = NULL;
2835     OP *myop = PL_op;
2836     U32 flags = 0;
2837     XPV * const tXpv = PL_Xpv;
2838
2839     if (PL_savestack_ix + 15 <= PL_savestack_max)
2840         flags |= 1;
2841     if (PL_markstack_ptr < PL_markstack_max - 2)
2842         flags |= 4;
2843     if (PL_scopestack_ix < PL_scopestack_max - 3)
2844         flags |= 16;
2845
2846     if (!PL_psig_ptr[sig]) {
2847                 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
2848                                  PL_sig_name[sig]);
2849                 exit(sig);
2850         }
2851
2852     /* Max number of items pushed there is 3*n or 4. We cannot fix
2853        infinity, so we fix 4 (in fact 5): */
2854     if (flags & 1) {
2855         PL_savestack_ix += 5;           /* Protect save in progress. */
2856         SAVEDESTRUCTOR_X(S_unwind_handler_stack, (void*)&flags);
2857     }
2858     if (flags & 4)
2859         PL_markstack_ptr++;             /* Protect mark. */
2860     if (flags & 16)
2861         PL_scopestack_ix += 1;
2862     /* sv_2cv is too complicated, try a simpler variant first: */
2863     if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
2864         || SvTYPE(cv) != SVt_PVCV) {
2865         HV *st;
2866         cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
2867     }
2868
2869     if (!cv || !CvROOT(cv)) {
2870         Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "SIG%s handler \"%s\" not defined.\n",
2871                        PL_sig_name[sig], (gv ? GvENAME(gv)
2872                                           : ((cv && CvGV(cv))
2873                                              ? GvENAME(CvGV(cv))
2874                                              : "__ANON__")));
2875         goto cleanup;
2876     }
2877
2878     if(PL_psig_name[sig]) {
2879         sv = SvREFCNT_inc_NN(PL_psig_name[sig]);
2880         flags |= 64;
2881 #if !defined(PERL_IMPLICIT_CONTEXT)
2882         PL_sig_sv = sv;
2883 #endif
2884     } else {
2885         sv = sv_newmortal();
2886         sv_setpv(sv,PL_sig_name[sig]);
2887     }
2888
2889     PUSHSTACKi(PERLSI_SIGNAL);
2890     PUSHMARK(SP);
2891     PUSHs(sv);
2892 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
2893     {
2894          struct sigaction oact;
2895
2896          if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
2897               if (sip) {
2898                    HV *sih = newHV();
2899                    SV *rv  = newRV_noinc(MUTABLE_SV(sih));
2900                    /* The siginfo fields signo, code, errno, pid, uid,
2901                     * addr, status, and band are defined by POSIX/SUSv3. */
2902                    (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
2903                    (void)hv_stores(sih, "code", newSViv(sip->si_code));
2904 #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. */
2905                    hv_stores(sih, "errno",      newSViv(sip->si_errno));
2906                    hv_stores(sih, "status",     newSViv(sip->si_status));
2907                    hv_stores(sih, "uid",        newSViv(sip->si_uid));
2908                    hv_stores(sih, "pid",        newSViv(sip->si_pid));
2909                    hv_stores(sih, "addr",       newSVuv(PTR2UV(sip->si_addr)));
2910                    hv_stores(sih, "band",       newSViv(sip->si_band));
2911 #endif
2912                    EXTEND(SP, 2);
2913                    PUSHs(rv);
2914                    mPUSHp((char *)sip, sizeof(*sip));
2915               }
2916
2917          }
2918     }
2919 #endif
2920     PUTBACK;
2921
2922     call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
2923
2924     POPSTACK;
2925     if (SvTRUE(ERRSV)) {
2926 #ifndef PERL_MICRO
2927 #ifdef HAS_SIGPROCMASK
2928         /* Handler "died", for example to get out of a restart-able read().
2929          * Before we re-do that on its behalf re-enable the signal which was
2930          * blocked by the system when we entered.
2931          */
2932         sigset_t set;
2933         sigemptyset(&set);
2934         sigaddset(&set,sig);
2935         sigprocmask(SIG_UNBLOCK, &set, NULL);
2936 #else
2937         /* Not clear if this will work */
2938         (void)rsignal(sig, SIG_IGN);
2939         (void)rsignal(sig, PL_csighandlerp);
2940 #endif
2941 #endif /* !PERL_MICRO */
2942         Perl_die(aTHX_ NULL);
2943     }
2944 cleanup:
2945     if (flags & 1)
2946         PL_savestack_ix -= 8; /* Unprotect save in progress. */
2947     if (flags & 4)
2948         PL_markstack_ptr--;
2949     if (flags & 16)
2950         PL_scopestack_ix -= 1;
2951     if (flags & 64)
2952         SvREFCNT_dec(sv);
2953     PL_op = myop;                       /* Apparently not needed... */
2954
2955     PL_Sv = tSv;                        /* Restore global temporaries. */
2956     PL_Xpv = tXpv;
2957     return;
2958 }
2959
2960
2961 static void
2962 S_restore_magic(pTHX_ const void *p)
2963 {
2964     dVAR;
2965     MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
2966     SV* const sv = mgs->mgs_sv;
2967
2968     if (!sv)
2969         return;
2970
2971     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
2972     {
2973 #ifdef PERL_OLD_COPY_ON_WRITE
2974         /* While magic was saved (and off) sv_setsv may well have seen
2975            this SV as a prime candidate for COW.  */
2976         if (SvIsCOW(sv))
2977             sv_force_normal_flags(sv, 0);
2978 #endif
2979
2980         if (mgs->mgs_flags)
2981             SvFLAGS(sv) |= mgs->mgs_flags;
2982         else
2983             mg_magical(sv);
2984         if (SvGMAGICAL(sv)) {
2985             /* downgrade public flags to private,
2986                and discard any other private flags */
2987
2988             const U32 pubflags = SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK);
2989             if (pubflags) {
2990                 SvFLAGS(sv) &= ~( pubflags | (SVp_IOK|SVp_NOK|SVp_POK) );
2991                 SvFLAGS(sv) |= ( pubflags << PRIVSHIFT );
2992             }
2993         }
2994     }
2995
2996     mgs->mgs_sv = NULL;  /* mark the MGS structure as restored */
2997
2998     /* If we're still on top of the stack, pop us off.  (That condition
2999      * will be satisfied if restore_magic was called explicitly, but *not*
3000      * if it's being called via leave_scope.)
3001      * The reason for doing this is that otherwise, things like sv_2cv()
3002      * may leave alloc gunk on the savestack, and some code
3003      * (e.g. sighandler) doesn't expect that...
3004      */
3005     if (PL_savestack_ix == mgs->mgs_ss_ix)
3006     {
3007         I32 popval = SSPOPINT;
3008         assert(popval == SAVEt_DESTRUCTOR_X);
3009         PL_savestack_ix -= 2;
3010         popval = SSPOPINT;
3011         assert(popval == SAVEt_ALLOC);
3012         popval = SSPOPINT;
3013         PL_savestack_ix -= popval;
3014     }
3015
3016 }
3017
3018 static void
3019 S_unwind_handler_stack(pTHX_ const void *p)
3020 {
3021     dVAR;
3022     const U32 flags = *(const U32*)p;
3023
3024     PERL_ARGS_ASSERT_UNWIND_HANDLER_STACK;
3025
3026     if (flags & 1)
3027         PL_savestack_ix -= 5; /* Unprotect save in progress. */
3028 #if !defined(PERL_IMPLICIT_CONTEXT)
3029     if (flags & 64)
3030         SvREFCNT_dec(PL_sig_sv);
3031 #endif
3032 }
3033
3034 /*
3035 =for apidoc magic_sethint
3036
3037 Triggered by a store to %^H, records the key/value pair to
3038 C<PL_compiling.cop_hints_hash>.  It is assumed that hints aren't storing
3039 anything that would need a deep copy.  Maybe we should warn if we find a
3040 reference.
3041
3042 =cut
3043 */
3044 int
3045 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3046 {
3047     dVAR;
3048     SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3049         : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3050
3051     PERL_ARGS_ASSERT_MAGIC_SETHINT;
3052
3053     /* mg->mg_obj isn't being used.  If needed, it would be possible to store
3054        an alternative leaf in there, with PL_compiling.cop_hints being used if
3055        it's NULL. If needed for threads, the alternative could lock a mutex,
3056        or take other more complex action.  */
3057
3058     /* Something changed in %^H, so it will need to be restored on scope exit.
3059        Doing this here saves a lot of doing it manually in perl code (and
3060        forgetting to do it, and consequent subtle errors.  */
3061     PL_hints |= HINT_LOCALIZE_HH;
3062     PL_compiling.cop_hints_hash
3063         = Perl_refcounted_he_new(aTHX_ PL_compiling.cop_hints_hash, key, sv);
3064     return 0;
3065 }
3066
3067 /*
3068 =for apidoc magic_clearhint
3069
3070 Triggered by a delete from %^H, records the key to
3071 C<PL_compiling.cop_hints_hash>.
3072
3073 =cut
3074 */
3075 int
3076 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3077 {
3078     dVAR;
3079
3080     PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3081     PERL_UNUSED_ARG(sv);
3082
3083     assert(mg->mg_len == HEf_SVKEY);
3084
3085     PERL_UNUSED_ARG(sv);
3086
3087     PL_hints |= HINT_LOCALIZE_HH;
3088     PL_compiling.cop_hints_hash
3089         = Perl_refcounted_he_new(aTHX_ PL_compiling.cop_hints_hash,
3090                                  MUTABLE_SV(mg->mg_ptr), &PL_sv_placeholder);
3091     return 0;
3092 }
3093
3094 /*
3095 =for apidoc magic_clearhints
3096
3097 Triggered by clearing %^H, resets C<PL_compiling.cop_hints_hash>.
3098
3099 =cut
3100 */
3101 int
3102 Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3103 {
3104     PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3105     PERL_UNUSED_ARG(sv);
3106     PERL_UNUSED_ARG(mg);
3107     if (PL_compiling.cop_hints_hash) {
3108         Perl_refcounted_he_free(aTHX_ PL_compiling.cop_hints_hash);
3109         PL_compiling.cop_hints_hash = NULL;
3110     }
3111     return 0;
3112 }
3113
3114 /*
3115  * Local variables:
3116  * c-indentation-style: bsd
3117  * c-basic-offset: 4
3118  * indent-tabs-mode: t
3119  * End:
3120  *
3121  * ex: set ts=8 sts=4 sw=4 noet:
3122  */