3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4 * 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * 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.
15 * [p.363 of _The Lord of the Rings_, II/vii: "The Mirror of Galadriel"]
19 =head1 Magical Functions
20 "Magic" is special data attached to SV structures in order to give them
21 "magical" properties. When any Perl code tries to read from, or assign to,
22 an SV marked as magical, it calls the 'get' or 'set' function associated
23 with that SV's magic. A get is called prior to reading an SV, in order to
24 give it a chance to update its internal value (get on $. writes the line
25 number of the last read filehandle into the SV's IV slot), while
26 set is called after an SV has been written to, in order to allow it to make
27 use of its changed value (set on $/ copies the SV's new value to the
28 PL_rs global variable).
30 Magic is implemented as a linked list of MAGIC structures attached to the
31 SV. Each MAGIC struct holds the type of the magic, a pointer to an array
32 of functions that implement the get(), set(), length() etc functions,
33 plus space for some flags and pointers. For example, a tied variable has
34 a MAGIC structure that contains a pointer to the object associated with the
45 #if defined(HAS_GETGROUPS) || defined(HAS_SETGROUPS)
51 #if defined(HAS_SETGROUPS)
58 # include <sys/pstat.h>
61 #ifdef HAS_PRCTL_SET_NAME
62 # include <sys/prctl.h>
65 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
66 Signal_t Perl_csighandler(int sig, siginfo_t *, void *);
68 Signal_t Perl_csighandler(int sig);
72 /* Missing protos on LynxOS */
73 void setruid(uid_t id);
74 void seteuid(uid_t id);
75 void setrgid(uid_t id);
76 void setegid(uid_t id);
80 * Pre-magic setup and post-magic takedown.
81 * Use the "DESTRUCTOR" scope cleanup to reinstate magic.
90 /* MGS is typedef'ed to struct magic_state in perl.h */
93 S_save_magic_flags(pTHX_ I32 mgs_ix, SV *sv, U32 flags)
98 PERL_ARGS_ASSERT_SAVE_MAGIC_FLAGS;
100 assert(SvMAGICAL(sv));
102 /* we shouldn't really be called here with RC==0, but it can sometimes
103 * happen via mg_clear() (which also shouldn't be called when RC==0,
104 * but it can happen). Handle this case gracefully(ish) by not RC++
105 * and thus avoiding the resultant double free */
106 if (SvREFCNT(sv) > 0) {
107 /* guard against sv getting freed midway through the mg clearing,
108 * by holding a private reference for the duration. */
109 SvREFCNT_inc_simple_void_NN(sv);
113 SAVEDESTRUCTOR_X(S_restore_magic, INT2PTR(void*, (IV)mgs_ix));
115 mgs = SSPTR(mgs_ix, MGS*);
117 mgs->mgs_flags = SvMAGICAL(sv) | SvREADONLY(sv);
118 mgs->mgs_ss_ix = PL_savestack_ix; /* points after the saved destructor */
119 mgs->mgs_bumped = bumped;
121 SvFLAGS(sv) &= ~flags;
125 #define save_magic(a,b) save_magic_flags(a,b,SVs_GMG|SVs_SMG|SVs_RMG)
128 =for apidoc mg_magical
130 Turns on the magical status of an SV. See C<L</sv_magic>>.
136 Perl_mg_magical(SV *sv)
139 PERL_ARGS_ASSERT_MG_MAGICAL;
142 if ((mg = SvMAGIC(sv))) {
144 const MGVTBL* const vtbl = mg->mg_virtual;
146 if (vtbl->svt_get && !(mg->mg_flags & MGf_GSKIP))
153 } while ((mg = mg->mg_moremagic));
154 if (!(SvFLAGS(sv) & (SVs_GMG|SVs_SMG)))
162 Do magic before a value is retrieved from the SV. The type of SV must
163 be >= C<SVt_PVMG>. See C<L</sv_magic>>.
169 Perl_mg_get(pTHX_ SV *sv)
171 const I32 mgs_ix = SSNEW(sizeof(MGS));
174 MAGIC *newmg, *head, *cur, *mg;
176 PERL_ARGS_ASSERT_MG_GET;
178 if (PL_localizing == 1 && sv == DEFSV) return 0;
180 /* We must call svt_get(sv, mg) for each valid entry in the linked
181 list of magic. svt_get() may delete the current entry, add new
182 magic to the head of the list, or upgrade the SV. AMS 20010810 */
184 newmg = cur = head = mg = SvMAGIC(sv);
186 const MGVTBL * const vtbl = mg->mg_virtual;
187 MAGIC * const nextmg = mg->mg_moremagic; /* it may delete itself */
189 if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
191 /* taint's mg get is so dumb it doesn't need flag saving */
192 if (!saved && mg->mg_type != PERL_MAGIC_taint) {
193 save_magic(mgs_ix, sv);
197 vtbl->svt_get(aTHX_ sv, mg);
199 /* guard against magic having been deleted - eg FETCH calling
202 /* recalculate flags */
203 (SSPTR(mgs_ix, MGS *))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
207 /* recalculate flags if this entry was deleted. */
208 if (mg->mg_flags & MGf_GSKIP)
209 (SSPTR(mgs_ix, MGS *))->mgs_flags &=
210 ~(SVs_GMG|SVs_SMG|SVs_RMG);
212 else if (vtbl == &PL_vtbl_utf8) {
213 /* get-magic can reallocate the PV */
214 magic_setutf8(sv, mg);
220 /* Have we finished with the new entries we saw? Start again
221 where we left off (unless there are more new entries). */
229 /* Were any new entries added? */
230 if (!have_new && (newmg = SvMAGIC(sv)) != head) {
234 /* recalculate flags */
235 (SSPTR(mgs_ix, MGS *))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
240 restore_magic(INT2PTR(void *, (IV)mgs_ix));
248 Do magic after a value is assigned to the SV. See C<L</sv_magic>>.
254 Perl_mg_set(pTHX_ SV *sv)
256 const I32 mgs_ix = SSNEW(sizeof(MGS));
260 PERL_ARGS_ASSERT_MG_SET;
262 if (PL_localizing == 2 && sv == DEFSV) return 0;
264 save_magic_flags(mgs_ix, sv, SVs_GMG|SVs_SMG); /* leave SVs_RMG on */
266 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
267 const MGVTBL* vtbl = mg->mg_virtual;
268 nextmg = mg->mg_moremagic; /* it may delete itself */
269 if (mg->mg_flags & MGf_GSKIP) {
270 mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
271 (SSPTR(mgs_ix, MGS*))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
273 if (PL_localizing == 2
274 && PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
276 if (vtbl && vtbl->svt_set)
277 vtbl->svt_set(aTHX_ sv, mg);
280 restore_magic(INT2PTR(void*, (IV)mgs_ix));
285 =for apidoc mg_length
287 Reports on the SV's length in bytes, calling length magic if available,
288 but does not set the UTF8 flag on C<sv>. It will fall back to 'get'
289 magic if there is no 'length' magic, but with no indication as to
290 whether it called 'get' magic. It assumes C<sv> is a C<PVMG> or
291 higher. Use C<sv_len()> instead.
297 Perl_mg_length(pTHX_ SV *sv)
302 PERL_ARGS_ASSERT_MG_LENGTH;
304 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
305 const MGVTBL * const vtbl = mg->mg_virtual;
306 if (vtbl && vtbl->svt_len) {
307 const I32 mgs_ix = SSNEW(sizeof(MGS));
308 save_magic(mgs_ix, sv);
309 /* omit MGf_GSKIP -- not changed here */
310 len = vtbl->svt_len(aTHX_ sv, mg);
311 restore_magic(INT2PTR(void*, (IV)mgs_ix));
316 (void)SvPV_const(sv, len);
321 Perl_mg_size(pTHX_ SV *sv)
325 PERL_ARGS_ASSERT_MG_SIZE;
327 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
328 const MGVTBL* const vtbl = mg->mg_virtual;
329 if (vtbl && vtbl->svt_len) {
330 const I32 mgs_ix = SSNEW(sizeof(MGS));
332 save_magic(mgs_ix, sv);
333 /* omit MGf_GSKIP -- not changed here */
334 len = vtbl->svt_len(aTHX_ sv, mg);
335 restore_magic(INT2PTR(void*, (IV)mgs_ix));
342 return AvFILLp((const AV *) sv); /* Fallback to non-tied array */
346 Perl_croak(aTHX_ "Size magic not implemented");
349 NOT_REACHED; /* NOTREACHED */
355 Clear something magical that the SV represents. See C<L</sv_magic>>.
361 Perl_mg_clear(pTHX_ SV *sv)
363 const I32 mgs_ix = SSNEW(sizeof(MGS));
367 PERL_ARGS_ASSERT_MG_CLEAR;
369 save_magic(mgs_ix, sv);
371 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
372 const MGVTBL* const vtbl = mg->mg_virtual;
373 /* omit GSKIP -- never set here */
375 nextmg = mg->mg_moremagic; /* it may delete itself */
377 if (vtbl && vtbl->svt_clear)
378 vtbl->svt_clear(aTHX_ sv, mg);
381 restore_magic(INT2PTR(void*, (IV)mgs_ix));
386 S_mg_findext_flags(const SV *sv, int type, const MGVTBL *vtbl, U32 flags)
393 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
394 if (mg->mg_type == type && (!flags || mg->mg_virtual == vtbl)) {
406 Finds the magic pointer for C<type> matching the SV. See C<L</sv_magic>>.
412 Perl_mg_find(const SV *sv, int type)
414 return S_mg_findext_flags(sv, type, NULL, 0);
418 =for apidoc mg_findext
420 Finds the magic pointer of C<type> with the given C<vtbl> for the C<SV>. See
427 Perl_mg_findext(const SV *sv, int type, const MGVTBL *vtbl)
429 return S_mg_findext_flags(sv, type, vtbl, 1);
433 Perl_mg_find_mglob(pTHX_ SV *sv)
435 PERL_ARGS_ASSERT_MG_FIND_MGLOB;
436 if (SvTYPE(sv) == SVt_PVLV && LvTYPE(sv) == 'y') {
437 /* This sv is only a delegate. //g magic must be attached to
442 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
443 return S_mg_findext_flags(sv, PERL_MAGIC_regex_global, 0, 0);
450 Copies the magic from one SV to another. See C<L</sv_magic>>.
456 Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
461 PERL_ARGS_ASSERT_MG_COPY;
463 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
464 const MGVTBL* const vtbl = mg->mg_virtual;
465 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
466 count += vtbl->svt_copy(aTHX_ sv, mg, nsv, key, klen);
469 const char type = mg->mg_type;
470 if (isUPPER(type) && type != PERL_MAGIC_uvar) {
472 (type == PERL_MAGIC_tied)
475 toLOWER(type), key, klen);
484 =for apidoc mg_localize
486 Copy some of the magic from an existing SV to new localized version of that
487 SV. Container magic (I<e.g.>, C<%ENV>, C<$1>, C<tie>)
488 gets copied, value magic doesn't (I<e.g.>,
491 If C<setmagic> is false then no set magic will be called on the new (empty) SV.
492 This typically means that assignment will soon follow (e.g. S<C<'local $x = $y'>>),
493 and that will handle the magic.
499 Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
503 PERL_ARGS_ASSERT_MG_LOCALIZE;
508 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
509 const MGVTBL* const vtbl = mg->mg_virtual;
510 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
513 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
514 (void)vtbl->svt_local(aTHX_ nsv, mg);
516 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
517 mg->mg_ptr, mg->mg_len);
519 /* container types should remain read-only across localization */
520 SvFLAGS(nsv) |= SvREADONLY(sv);
523 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
524 SvFLAGS(nsv) |= SvMAGICAL(sv);
533 #define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
535 S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
537 const MGVTBL* const vtbl = mg->mg_virtual;
538 if (vtbl && vtbl->svt_free)
539 vtbl->svt_free(aTHX_ sv, mg);
540 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
541 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
542 Safefree(mg->mg_ptr);
543 else if (mg->mg_len == HEf_SVKEY)
544 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
546 if (mg->mg_flags & MGf_REFCOUNTED)
547 SvREFCNT_dec(mg->mg_obj);
554 Free any magic storage used by the SV. See C<L</sv_magic>>.
560 Perl_mg_free(pTHX_ SV *sv)
565 PERL_ARGS_ASSERT_MG_FREE;
567 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
568 moremagic = mg->mg_moremagic;
569 mg_free_struct(sv, mg);
570 SvMAGIC_set(sv, moremagic);
572 SvMAGIC_set(sv, NULL);
578 =for apidoc Am|void|mg_free_type|SV *sv|int how
580 Remove any magic of type C<how> from the SV C<sv>. See L</sv_magic>.
586 Perl_mg_free_type(pTHX_ SV *sv, int how)
588 MAGIC *mg, *prevmg, *moremg;
589 PERL_ARGS_ASSERT_MG_FREE_TYPE;
590 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
592 moremg = mg->mg_moremagic;
593 if (mg->mg_type == how) {
594 /* temporarily move to the head of the magic chain, in case
595 custom free code relies on this historical aspect of mg_free */
597 prevmg->mg_moremagic = moremg;
598 mg->mg_moremagic = SvMAGIC(sv);
601 newhead = mg->mg_moremagic;
602 mg_free_struct(sv, mg);
603 SvMAGIC_set(sv, newhead);
613 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
617 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
620 REGEXP * const rx = PM_GETRE(PL_curpm);
622 UV uv= (UV)mg->mg_obj;
623 if (uv == '+') { /* @+ */
624 /* return the number possible */
625 return RX_NPARENS(rx);
626 } else { /* @- @^CAPTURE @{^CAPTURE} */
627 I32 paren = RX_LASTPAREN(rx);
629 /* return the last filled */
631 && (RX_OFFS(rx)[paren].start == -1
632 || RX_OFFS(rx)[paren].end == -1) )
638 /* @^CAPTURE @{^CAPTURE} */
639 return paren >= 0 ? (U32)(paren-1) : (U32)-1;
651 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
653 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
656 REGEXP * const rx = PM_GETRE(PL_curpm);
658 const UV uv= (UV)mg->mg_obj;
659 /* @{^CAPTURE} does not contain $&, so we need to increment by 1 */
660 const I32 paren = mg->mg_len
661 + (uv == '\003' ? 1 : 0);
666 if (paren <= (I32)RX_NPARENS(rx) &&
667 (s = RX_OFFS(rx)[paren].start) != -1 &&
668 (t = RX_OFFS(rx)[paren].end) != -1)
672 if (uv == '+') /* @+ */
674 else if (uv == '-') /* @- */
676 else { /* @^CAPTURE @{^CAPTURE} */
677 CALLREG_NUMBUF_FETCH(rx,paren,sv);
681 if (RX_MATCH_UTF8(rx)) {
682 const char * const b = RX_SUBBEG(rx);
684 i = RX_SUBCOFFSET(rx) +
686 (U8*)(b-RX_SUBOFFSET(rx)+i));
701 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
703 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
707 Perl_croak_no_modify();
708 NORETURN_FUNCTION_END;
711 #define SvRTRIM(sv) STMT_START { \
713 STRLEN len = SvCUR(sv); \
714 char * const p = SvPVX(sv); \
715 while (len > 0 && isSPACE(p[len-1])) \
717 SvCUR_set(sv, len); \
723 Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
725 PERL_ARGS_ASSERT_EMULATE_COP_IO;
727 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
732 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
733 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
738 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
739 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
747 S_fixup_errno_string(pTHX_ SV* sv)
749 /* Do what is necessary to fixup the non-empty string in 'sv' for return to
752 PERL_ARGS_ASSERT_FIXUP_ERRNO_STRING;
756 if(strEQ(SvPVX(sv), "")) {
757 sv_catpv(sv, UNKNOWN_ERRNO_MSG);
761 /* In some locales the error string may come back as UTF-8, in which
762 * case we should turn on that flag. This didn't use to happen, and to
763 * avoid as many possible backward compatibility issues as possible, we
764 * don't turn on the flag unless we have to. So the flag stays off for
765 * an entirely invariant string. We assume that if the string looks
766 * like UTF-8, it really is UTF-8: "text in any other encoding that
767 * uses bytes with the high bit set is extremely unlikely to pass a
768 * UTF-8 validity test"
769 * (http://en.wikipedia.org/wiki/Charset_detection). There is a
770 * potential that we will get it wrong however, especially on short
771 * error message text. (If it turns out to be necessary, we could also
772 * keep track if the current LC_MESSAGES locale is UTF-8) */
773 if (! IN_BYTES /* respect 'use bytes' */
774 && ! is_utf8_invariant_string((U8*) SvPVX_const(sv), SvCUR(sv))
775 && is_utf8_string((U8*) SvPVX_const(sv), SvCUR(sv)))
788 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
791 const char *s = NULL;
793 const char * const remaining = mg->mg_ptr + 1;
796 PERL_ARGS_ASSERT_MAGIC_GET;
800 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
802 CALLREG_NUMBUF_FETCH(rx,paren,sv);
809 nextchar = *remaining;
810 switch (*mg->mg_ptr) {
811 case '\001': /* ^A */
812 if (SvOK(PL_bodytarget)) sv_copypv(sv, PL_bodytarget);
815 if (SvTAINTED(PL_bodytarget))
818 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
819 if (nextchar == '\0') {
820 sv_setiv(sv, (IV)PL_minus_c);
822 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
823 sv_setiv(sv, (IV)STATUS_NATIVE);
827 case '\004': /* ^D */
828 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
830 case '\005': /* ^E */
831 if (nextchar != '\0') {
832 if (strEQ(remaining, "NCODING"))
837 #if defined(VMS) || defined(OS2) || defined(WIN32)
841 $DESCRIPTOR(msgdsc,msg);
842 sv_setnv(sv,(NV) vaxc$errno);
843 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
844 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
849 if (!(_emx_env & 0x200)) { /* Under DOS */
850 sv_setnv(sv, (NV)errno);
851 sv_setpv(sv, errno ? my_strerror(errno) : "");
853 if (errno != errno_isOS2) {
854 const int tmp = _syserrno();
855 if (tmp) /* 2nd call to _syserrno() makes it 0 */
858 sv_setnv(sv, (NV)Perl_rc);
859 sv_setpv(sv, os2error(Perl_rc));
861 if (SvOK(sv) && strNE(SvPVX(sv), "")) {
862 fixup_errno_string(sv);
864 # elif defined(WIN32)
866 const DWORD dwErr = GetLastError();
867 sv_setnv(sv, (NV)dwErr);
869 PerlProc_GetOSError(sv, dwErr);
870 fixup_errno_string(sv);
877 # error Missing code for platform
880 SvNOK_on(sv); /* what a wonderful hack! */
882 #endif /* End of platforms with special handling for $^E; others just fall
889 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
891 sv_setnv(sv, (NV)errno);
894 if (errno == errno_isOS2 || errno == errno_isOS2_set)
895 sv_setpv(sv, os2error(Perl_rc));
903 /* Strerror can return NULL on some platforms, which will
904 * result in 'sv' not being considered SvOK. The SvNOK_on()
905 * below will cause just the number part to be valid */
906 sv_setpv(sv, my_strerror(errno));
908 fixup_errno_string(sv);
915 SvNOK_on(sv); /* what a wonderful hack! */
918 case '\006': /* ^F */
919 sv_setiv(sv, (IV)PL_maxsysfd);
921 case '\007': /* ^GLOBAL_PHASE */
922 if (strEQ(remaining, "LOBAL_PHASE")) {
923 sv_setpvn(sv, PL_phase_names[PL_phase],
924 strlen(PL_phase_names[PL_phase]));
927 case '\010': /* ^H */
928 sv_setiv(sv, (IV)PL_hints);
930 case '\011': /* ^I */ /* NOT \t in EBCDIC */
931 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
933 case '\014': /* ^LAST_FH */
934 if (strEQ(remaining, "AST_FH")) {
936 assert(isGV_with_GP(PL_last_in_gv));
937 SV_CHECK_THINKFIRST_COW_DROP(sv);
938 prepare_SV_for_RV(sv);
940 SvRV_set(sv, SvREFCNT_inc_simple_NN(PL_last_in_gv));
944 else sv_setsv_nomg(sv, NULL);
947 case '\017': /* ^O & ^OPEN */
948 if (nextchar == '\0') {
949 sv_setpv(sv, PL_osname);
952 else if (strEQ(remaining, "PEN")) {
953 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
957 sv_setiv(sv, (IV)PL_perldb);
959 case '\023': /* ^S */
961 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
964 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
969 case '\024': /* ^T */
970 if (nextchar == '\0') {
972 sv_setnv(sv, PL_basetime);
974 sv_setiv(sv, (IV)PL_basetime);
977 else if (strEQ(remaining, "AINT"))
978 sv_setiv(sv, TAINTING_get
979 ? (TAINT_WARN_get || PL_unsafe ? -1 : 1)
982 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
983 if (strEQ(remaining, "NICODE"))
984 sv_setuv(sv, (UV) PL_unicode);
985 else if (strEQ(remaining, "TF8LOCALE"))
986 sv_setuv(sv, (UV) PL_utf8locale);
987 else if (strEQ(remaining, "TF8CACHE"))
988 sv_setiv(sv, (IV) PL_utf8cache);
990 case '\027': /* ^W & $^WARNING_BITS */
991 if (nextchar == '\0')
992 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
993 else if (strEQ(remaining, "ARNING_BITS")) {
994 if (PL_compiling.cop_warnings == pWARN_NONE) {
995 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
997 else if (PL_compiling.cop_warnings == pWARN_STD) {
1000 else if (PL_compiling.cop_warnings == pWARN_ALL) {
1001 /* Get the bit mask for $warnings::Bits{all}, because
1002 * it could have been extended by warnings::register */
1003 HV * const bits = get_hv("warnings::Bits", 0);
1004 SV ** const bits_all = bits ? hv_fetchs(bits, "all", FALSE) : NULL;
1006 sv_copypv(sv, *bits_all);
1008 sv_setpvn(sv, WARN_ALLstring, WARNsize);
1011 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
1012 *PL_compiling.cop_warnings);
1016 else if (strEQ(remaining, "IN32_SLOPPY_STAT")) {
1017 sv_setiv(sv, w32_sloppystat);
1022 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1023 paren = RX_LASTPAREN(rx);
1025 goto do_numbuf_fetch;
1028 case '\016': /* ^N */
1029 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1030 paren = RX_LASTCLOSEPAREN(rx);
1032 goto do_numbuf_fetch;
1036 if (GvIO(PL_last_in_gv)) {
1037 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
1042 sv_setiv(sv, (IV)STATUS_CURRENT);
1043 #ifdef COMPLEX_STATUS
1044 SvUPGRADE(sv, SVt_PVLV);
1045 LvTARGOFF(sv) = PL_statusvalue;
1046 LvTARGLEN(sv) = PL_statusvalue_vms;
1051 if (GvIOp(PL_defoutgv))
1052 s = IoTOP_NAME(GvIOp(PL_defoutgv));
1056 sv_setpv(sv,GvENAME(PL_defoutgv));
1057 sv_catpvs(sv,"_TOP");
1061 if (GvIOp(PL_defoutgv))
1062 s = IoFMT_NAME(GvIOp(PL_defoutgv));
1064 s = GvENAME(PL_defoutgv);
1068 if (GvIO(PL_defoutgv))
1069 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
1072 if (GvIO(PL_defoutgv))
1073 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
1076 if (GvIO(PL_defoutgv))
1077 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
1086 if (GvIO(PL_defoutgv))
1087 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
1091 sv_copypv(sv, PL_ors_sv);
1097 IV const pid = (IV)PerlProc_getpid();
1098 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid) {
1099 /* never set manually, or at least not since last fork */
1101 /* never unsafe, even if reading in a tainted expression */
1104 /* else a value has been assigned manually, so do nothing */
1108 sv_setuid(sv, PerlProc_getuid());
1111 sv_setuid(sv, PerlProc_geteuid());
1114 sv_setgid(sv, PerlProc_getgid());
1117 sv_setgid(sv, PerlProc_getegid());
1119 #ifdef HAS_GETGROUPS
1121 Groups_t *gary = NULL;
1123 I32 num_groups = getgroups(0, gary);
1124 if (num_groups > 0) {
1125 Newx(gary, num_groups, Groups_t);
1126 num_groups = getgroups(num_groups, gary);
1127 for (i = 0; i < num_groups; i++)
1128 Perl_sv_catpvf(aTHX_ sv, " %" IVdf, (IV)gary[i]);
1132 (void)SvIOK_on(sv); /* what a wonderful hack! */
1146 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
1148 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
1150 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1152 if (uf && uf->uf_val)
1153 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
1158 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
1160 STRLEN len = 0, klen;
1161 const char * const key = MgPV_const(mg,klen);
1164 PERL_ARGS_ASSERT_MAGIC_SETENV;
1168 /* defined environment variables are byte strings; unfortunately
1169 there is no SvPVbyte_force_nomg(), so we must do this piecewise */
1170 (void)SvPV_force_nomg_nolen(sv);
1171 sv_utf8_downgrade(sv, /* fail_ok */ TRUE);
1173 Perl_ck_warner_d(aTHX_ packWARN(WARN_UTF8), "Wide character in %s", "setenv");
1179 my_setenv(key, s); /* does the deed */
1181 #ifdef DYNAMIC_ENV_FETCH
1182 /* We just undefd an environment var. Is a replacement */
1183 /* waiting in the wings? */
1185 SV ** const valp = hv_fetch(GvHVn(PL_envgv), key, klen, FALSE);
1187 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
1191 #if !defined(OS2) && !defined(WIN32) && !defined(MSDOS)
1192 /* And you'll never guess what the dog had */
1193 /* in its mouth... */
1195 MgTAINTEDDIR_off(mg);
1197 if (s && memEQs(key, klen, "DCL$PATH")) {
1198 char pathbuf[256], eltbuf[256], *cp, *elt;
1201 my_strlcpy(eltbuf, s, sizeof(eltbuf));
1203 do { /* DCL$PATH may be a search list */
1204 while (1) { /* as may dev portion of any element */
1205 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1206 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1207 cando_by_name(S_IWUSR,0,elt) ) {
1208 MgTAINTEDDIR_on(mg);
1212 if ((cp = strchr(elt, ':')) != NULL)
1214 if (my_trnlnm(elt, eltbuf, j++))
1220 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1223 if (s && memEQs(key, klen, "PATH")) {
1224 const char * const strend = s + len;
1226 /* set MGf_TAINTEDDIR if any component of the new path is
1227 * relative or world-writeable */
1228 while (s < strend) {
1232 #ifdef __VMS /* Hmm. How do we get $Config{path_sep} from C? */
1233 const char path_sep = PL_perllib_sep;
1235 const char path_sep = ':';
1237 s = delimcpy_no_escape(tmpbuf, tmpbuf + sizeof tmpbuf,
1238 s, strend, path_sep, &i);
1240 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
1242 /* no colon thus no device name -- assume relative path */
1243 || (PL_perllib_sep != ':' && !strchr(tmpbuf, ':'))
1244 /* Using Unix separator, e.g. under bash, so act line Unix */
1245 || (PL_perllib_sep == ':' && *tmpbuf != '/')
1247 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1249 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1250 MgTAINTEDDIR_on(mg);
1256 #endif /* neither OS2 nor WIN32 nor MSDOS */
1262 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1264 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
1265 PERL_UNUSED_ARG(sv);
1266 my_setenv(MgPV_nolen_const(mg),NULL);
1271 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1273 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
1274 PERL_UNUSED_ARG(mg);
1276 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1278 if (PL_localizing) {
1281 hv_iterinit(MUTABLE_HV(sv));
1282 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
1284 my_setenv(hv_iterkey(entry, &keylen),
1285 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
1293 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1295 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
1296 PERL_UNUSED_ARG(sv);
1297 PERL_UNUSED_ARG(mg);
1299 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1307 #ifdef HAS_SIGPROCMASK
1309 restore_sigmask(pTHX_ SV *save_sv)
1311 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1312 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
1316 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1318 /* Are we fetching a signal entry? */
1319 int i = (I16)mg->mg_private;
1321 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1325 const char * sig = MgPV_const(mg, siglen);
1326 mg->mg_private = i = whichsig_pvn(sig, siglen);
1331 sv_setsv(sv,PL_psig_ptr[i]);
1333 Sighandler_t sigstate = rsignal_state(i);
1334 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1335 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1338 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1339 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1342 /* cache state so we don't fetch it again */
1343 if(sigstate == (Sighandler_t) SIG_IGN)
1344 sv_setpvs(sv,"IGNORE");
1347 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1354 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1356 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
1358 magic_setsig(NULL, mg);
1359 return sv_unmagic(sv, mg->mg_type);
1363 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1364 Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
1366 Perl_csighandler(int sig)
1369 #ifdef PERL_GET_SIG_CONTEXT
1370 dTHXa(PERL_GET_SIG_CONTEXT);
1374 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1375 #if defined(__cplusplus) && defined(__GNUC__)
1376 /* g++ doesn't support PERL_UNUSED_DECL, so the sip and uap
1377 * parameters would be warned about. */
1378 PERL_UNUSED_ARG(sip);
1379 PERL_UNUSED_ARG(uap);
1382 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1383 (void) rsignal(sig, PL_csighandlerp);
1384 if (PL_sig_ignoring[sig]) return;
1386 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1387 if (PL_sig_defaulting[sig])
1388 #ifdef KILL_BY_SIGPRC
1389 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1404 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
1405 /* Call the perl level handler now--
1406 * with risk we may be in malloc() or being destructed etc. */
1407 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1408 (*PL_sighandlerp)(sig, NULL, NULL);
1410 (*PL_sighandlerp)(sig);
1413 if (!PL_psig_pend) return;
1414 /* Set a flag to say this signal is pending, that is awaiting delivery after
1415 * the current Perl opcode completes */
1416 PL_psig_pend[sig]++;
1418 #ifndef SIG_PENDING_DIE_COUNT
1419 # define SIG_PENDING_DIE_COUNT 120
1421 /* Add one to say _a_ signal is pending */
1422 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1423 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1424 (unsigned long)SIG_PENDING_DIE_COUNT);
1428 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1430 Perl_csighandler_init(void)
1433 if (PL_sig_handlers_initted) return;
1435 for (sig = 1; sig < SIG_SIZE; sig++) {
1436 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1438 PL_sig_defaulting[sig] = 1;
1439 (void) rsignal(sig, PL_csighandlerp);
1441 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1442 PL_sig_ignoring[sig] = 0;
1445 PL_sig_handlers_initted = 1;
1449 #if defined HAS_SIGPROCMASK
1451 unblock_sigmask(pTHX_ void* newset)
1453 PERL_UNUSED_CONTEXT;
1454 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1459 Perl_despatch_signals(pTHX)
1463 for (sig = 1; sig < SIG_SIZE; sig++) {
1464 if (PL_psig_pend[sig]) {
1466 #ifdef HAS_SIGPROCMASK
1467 /* From sigaction(2) (FreeBSD man page):
1468 * | Signal routines normally execute with the signal that
1469 * | caused their invocation blocked, but other signals may
1471 * Emulation of this behavior (from within Perl) is enabled
1475 sigset_t newset, oldset;
1477 sigemptyset(&newset);
1478 sigaddset(&newset, sig);
1479 sigprocmask(SIG_BLOCK, &newset, &oldset);
1480 was_blocked = sigismember(&oldset, sig);
1482 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1484 SAVEFREESV(save_sv);
1485 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1488 PL_psig_pend[sig] = 0;
1489 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1490 (*PL_sighandlerp)(sig, NULL, NULL);
1492 (*PL_sighandlerp)(sig);
1494 #ifdef HAS_SIGPROCMASK
1503 /* sv of NULL signifies that we're acting as magic_clearsig. */
1505 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1510 /* Need to be careful with SvREFCNT_dec(), because that can have side
1511 * effects (due to closures). We must make sure that the new disposition
1512 * is in place before it is called.
1516 #ifdef HAS_SIGPROCMASK
1520 const char *s = MgPV_const(mg,len);
1522 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1525 if (memEQs(s, len, "__DIE__"))
1527 else if (memEQs(s, len, "__WARN__")
1528 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1529 /* Merge the existing behaviours, which are as follows:
1530 magic_setsig, we always set svp to &PL_warnhook
1531 (hence we always change the warnings handler)
1532 For magic_clearsig, we don't change the warnings handler if it's
1533 set to the &PL_warnhook. */
1536 SV *tmp = sv_newmortal();
1537 Perl_croak(aTHX_ "No such hook: %s",
1538 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1542 if (*svp != PERL_WARNHOOK_FATAL)
1548 i = (I16)mg->mg_private;
1550 i = whichsig_pvn(s, len); /* ...no, a brick */
1551 mg->mg_private = (U16)i;
1555 SV *tmp = sv_newmortal();
1556 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1557 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1561 #ifdef HAS_SIGPROCMASK
1562 /* Avoid having the signal arrive at a bad time, if possible. */
1565 sigprocmask(SIG_BLOCK, &set, &save);
1567 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1568 SAVEFREESV(save_sv);
1569 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1572 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1573 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1575 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1576 PL_sig_ignoring[i] = 0;
1578 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1579 PL_sig_defaulting[i] = 0;
1581 to_dec = PL_psig_ptr[i];
1583 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1584 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1586 /* Signals don't change name during the program's execution, so once
1587 they're cached in the appropriate slot of PL_psig_name, they can
1590 Ideally we'd find some way of making SVs at (C) compile time, or
1591 at least, doing most of the work. */
1592 if (!PL_psig_name[i]) {
1593 PL_psig_name[i] = newSVpvn(s, len);
1594 SvREADONLY_on(PL_psig_name[i]);
1597 SvREFCNT_dec(PL_psig_name[i]);
1598 PL_psig_name[i] = NULL;
1599 PL_psig_ptr[i] = NULL;
1602 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1604 (void)rsignal(i, PL_csighandlerp);
1607 *svp = SvREFCNT_inc_simple_NN(sv);
1609 if (sv && SvOK(sv)) {
1610 s = SvPV_force(sv, len);
1614 if (sv && memEQs(s, len,"IGNORE")) {
1616 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1617 PL_sig_ignoring[i] = 1;
1618 (void)rsignal(i, PL_csighandlerp);
1620 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1624 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
1626 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1627 PL_sig_defaulting[i] = 1;
1628 (void)rsignal(i, PL_csighandlerp);
1630 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1636 * We should warn if HINT_STRICT_REFS, but without
1637 * access to a known hint bit in a known OP, we can't
1638 * tell whether HINT_STRICT_REFS is in force or not.
1640 if (!strchr(s,':') && !strchr(s,'\''))
1641 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1644 (void)rsignal(i, PL_csighandlerp);
1646 *svp = SvREFCNT_inc_simple_NN(sv);
1650 #ifdef HAS_SIGPROCMASK
1654 SvREFCNT_dec(to_dec);
1657 #endif /* !PERL_MICRO */
1660 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1662 PERL_ARGS_ASSERT_MAGIC_SETISA;
1663 PERL_UNUSED_ARG(sv);
1665 /* Skip _isaelem because _isa will handle it shortly */
1666 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
1669 return magic_clearisa(NULL, mg);
1672 /* sv of NULL signifies that we're acting as magic_setisa. */
1674 Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1677 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1679 /* Bail out if destruction is going on */
1680 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
1683 av_clear(MUTABLE_AV(sv));
1685 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1686 /* This occurs with setisa_elem magic, which calls this
1688 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1691 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1692 SV **svp = AvARRAY((AV *)mg->mg_obj);
1693 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1695 stash = GvSTASH((GV *)*svp++);
1696 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1703 (const GV *)mg->mg_obj
1706 /* The stash may have been detached from the symbol table, so check its
1707 name before doing anything. */
1708 if (stash && HvENAME_get(stash))
1709 mro_isa_changed_in(stash);
1715 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1717 HV * const hv = MUTABLE_HV(LvTARG(sv));
1720 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
1721 PERL_UNUSED_ARG(mg);
1724 (void) hv_iterinit(hv);
1725 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1728 while (hv_iternext(hv))
1733 sv_setiv(sv, (IV)i);
1738 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1740 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
1741 PERL_UNUSED_ARG(mg);
1743 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
1749 =for apidoc magic_methcall
1751 Invoke a magic method (like FETCH).
1753 C<sv> and C<mg> are the tied thingy and the tie magic.
1755 C<meth> is the name of the method to call.
1757 C<argc> is the number of args (in addition to $self) to pass to the method.
1759 The C<flags> can be:
1761 G_DISCARD invoke method with G_DISCARD flag and don't
1763 G_UNDEF_FILL fill the stack with argc pointers to
1766 The arguments themselves are any values following the C<flags> argument.
1768 Returns the SV (if any) returned by the method, or C<NULL> on failure.
1775 Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
1781 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1785 if (flags & G_WRITING_TO_STDERR) {
1789 SAVESPTR(PL_stderrgv);
1793 PUSHSTACKi(PERLSI_MAGIC);
1796 /* EXTEND() expects a signed argc; don't wrap when casting */
1797 assert(argc <= I32_MAX);
1798 EXTEND(SP, (I32)argc+1);
1799 PUSHs(SvTIED_obj(sv, mg));
1800 if (flags & G_UNDEF_FILL) {
1802 PUSHs(&PL_sv_undef);
1804 } else if (argc > 0) {
1806 va_start(args, argc);
1809 SV *const sv = va_arg(args, SV *);
1816 if (flags & G_DISCARD) {
1817 call_sv(meth, G_SCALAR|G_DISCARD|G_METHOD_NAMED);
1820 if (call_sv(meth, G_SCALAR|G_METHOD_NAMED))
1821 ret = *PL_stack_sp--;
1824 if (flags & G_WRITING_TO_STDERR)
1830 /* wrapper for magic_methcall that creates the first arg */
1833 S_magic_methcall1(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
1838 PERL_ARGS_ASSERT_MAGIC_METHCALL1;
1841 if (mg->mg_len >= 0) {
1842 arg1 = newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
1844 else if (mg->mg_len == HEf_SVKEY)
1845 arg1 = MUTABLE_SV(mg->mg_ptr);
1847 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1848 arg1 = newSViv((IV)(mg->mg_len));
1852 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n - 1, val);
1854 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n, arg1, val);
1858 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, SV *meth)
1862 PERL_ARGS_ASSERT_MAGIC_METHPACK;
1864 ret = magic_methcall1(sv, mg, meth, 0, 1, NULL);
1871 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1873 PERL_ARGS_ASSERT_MAGIC_GETPACK;
1875 if (mg->mg_type == PERL_MAGIC_tiedelem)
1876 mg->mg_flags |= MGf_GSKIP;
1877 magic_methpack(sv,mg,SV_CONST(FETCH));
1882 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1887 PERL_ARGS_ASSERT_MAGIC_SETPACK;
1889 /* in the code C<$tied{foo} = $val>, the "thing" that gets passed to
1890 * STORE() is not $val, but rather a PVLV (the sv in this call), whose
1891 * public flags indicate its value based on copying from $val. Doing
1892 * mg_set() on the PVLV temporarily does SvMAGICAL_off(), then calls us.
1893 * So STORE()'s $_[2] arg is a temporarily disarmed PVLV. This goes
1894 * wrong if $val happened to be tainted, as sv hasn't got magic
1895 * enabled, even though taint magic is in the chain. In which case,
1896 * fake up a temporary tainted value (this is easier than temporarily
1897 * re-enabling magic on sv). */
1899 if (TAINTING_get && (tmg = mg_find(sv, PERL_MAGIC_taint))
1900 && (tmg->mg_len & 1))
1902 val = sv_mortalcopy(sv);
1908 magic_methcall1(sv, mg, SV_CONST(STORE), G_DISCARD, 2, val);
1913 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1915 PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1917 if (mg->mg_type == PERL_MAGIC_tiedscalar) return 0;
1918 return magic_methpack(sv,mg,SV_CONST(DELETE));
1923 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1928 PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1930 retsv = magic_methcall1(sv, mg, SV_CONST(FETCHSIZE), 0, 1, NULL);
1932 retval = SvIV(retsv)-1;
1934 Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
1936 return (U32) retval;
1940 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1942 PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1944 Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(CLEAR), G_DISCARD, 0);
1949 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1953 PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1955 ret = SvOK(key) ? Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(NEXTKEY), 0, 1, key)
1956 : Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(FIRSTKEY), 0, 0);
1963 Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
1965 PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1967 return magic_methpack(sv,mg,SV_CONST(EXISTS));
1971 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1974 SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1975 HV * const pkg = SvSTASH((const SV *)SvRV(tied));
1977 PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
1979 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1981 if (HvEITER_get(hv))
1982 /* we are in an iteration so the hash cannot be empty */
1984 /* no xhv_eiter so now use FIRSTKEY */
1985 key = sv_newmortal();
1986 magic_nextpack(MUTABLE_SV(hv), mg, key);
1987 HvEITER_set(hv, NULL); /* need to reset iterator */
1988 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
1991 /* there is a SCALAR method that we can call */
1992 retval = Perl_magic_methcall(aTHX_ MUTABLE_SV(hv), mg, SV_CONST(SCALAR), 0, 0);
1994 retval = &PL_sv_undef;
1999 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
2003 PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
2005 /* The magic ptr/len for the debugger's hash should always be an SV. */
2006 if (UNLIKELY(mg->mg_len != HEf_SVKEY)) {
2007 Perl_croak(aTHX_ "panic: magic_setdbline len=%" IVdf ", ptr='%s'",
2008 (IV)mg->mg_len, mg->mg_ptr);
2011 /* Use sv_2iv instead of SvIV() as the former generates smaller code, and
2012 setting/clearing debugger breakpoints is not a hot path. */
2013 svp = av_fetch(MUTABLE_AV(mg->mg_obj),
2014 sv_2iv(MUTABLE_SV((mg)->mg_ptr)), FALSE);
2016 if (svp && SvIOKp(*svp)) {
2017 OP * const o = INT2PTR(OP*,SvIVX(*svp));
2019 #ifdef PERL_DEBUG_READONLY_OPS
2020 Slab_to_rw(OpSLAB(o));
2022 /* set or clear breakpoint in the relevant control op */
2024 o->op_flags |= OPf_SPECIAL;
2026 o->op_flags &= ~OPf_SPECIAL;
2027 #ifdef PERL_DEBUG_READONLY_OPS
2028 Slab_to_ro(OpSLAB(o));
2036 Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
2038 AV * const obj = MUTABLE_AV(mg->mg_obj);
2040 PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
2043 sv_setiv(sv, AvFILL(obj));
2051 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
2053 AV * const obj = MUTABLE_AV(mg->mg_obj);
2055 PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
2058 av_fill(obj, SvIV(sv));
2060 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
2061 "Attempt to set length of freed array");
2067 Perl_magic_cleararylen_p(pTHX_ SV *sv, MAGIC *mg)
2069 PERL_ARGS_ASSERT_MAGIC_CLEARARYLEN_P;
2070 PERL_UNUSED_ARG(sv);
2071 PERL_UNUSED_CONTEXT;
2073 /* Reset the iterator when the array is cleared */
2074 #if IVSIZE == I32SIZE
2075 *((IV *) &(mg->mg_len)) = 0;
2078 *((IV *) mg->mg_ptr) = 0;
2085 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
2087 PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
2088 PERL_UNUSED_ARG(sv);
2090 /* during global destruction, mg_obj may already have been freed */
2091 if (PL_in_clean_all)
2094 mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
2097 /* arylen scalar holds a pointer back to the array, but doesn't own a
2098 reference. Hence the we (the array) are about to go away with it
2099 still pointing at us. Clear its pointer, else it would be pointing
2100 at free memory. See the comment in sv_magic about reference loops,
2101 and why it can't own a reference to us. */
2108 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
2110 SV* const lsv = LvTARG(sv);
2111 MAGIC * const found = mg_find_mglob(lsv);
2113 PERL_ARGS_ASSERT_MAGIC_GETPOS;
2114 PERL_UNUSED_ARG(mg);
2116 if (found && found->mg_len != -1) {
2117 STRLEN i = found->mg_len;
2118 if (found->mg_flags & MGf_BYTES && DO_UTF8(lsv))
2119 i = sv_pos_b2u_flags(lsv, i, SV_GMAGIC|SV_CONST_RETURN);
2128 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
2130 SV* const lsv = LvTARG(sv);
2137 PERL_ARGS_ASSERT_MAGIC_SETPOS;
2138 PERL_UNUSED_ARG(mg);
2140 found = mg_find_mglob(lsv);
2144 found = sv_magicext_mglob(lsv);
2146 else if (!SvOK(sv)) {
2150 s = SvPV_const(lsv, len);
2155 ulen = sv_or_pv_len_utf8(lsv, s, len);
2165 else if (pos > (SSize_t)len)
2168 found->mg_len = pos;
2169 found->mg_flags &= ~(MGf_MINMATCH|MGf_BYTES);
2175 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
2178 SV * const lsv = LvTARG(sv);
2179 const char * const tmps = SvPV_const(lsv,len);
2180 STRLEN offs = LvTARGOFF(sv);
2181 STRLEN rem = LvTARGLEN(sv);
2182 const bool negoff = LvFLAGS(sv) & 1;
2183 const bool negrem = LvFLAGS(sv) & 2;
2185 PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2186 PERL_UNUSED_ARG(mg);
2188 if (!translate_substr_offsets(
2189 SvUTF8(lsv) ? sv_or_pv_len_utf8(lsv, tmps, len) : len,
2190 negoff ? -(IV)offs : (IV)offs, !negoff,
2191 negrem ? -(IV)rem : (IV)rem, !negrem, &offs, &rem
2193 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR), "substr outside of string");
2199 offs = sv_or_pv_pos_u2b(lsv, tmps, offs, &rem);
2200 sv_setpvn(sv, tmps + offs, rem);
2207 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2209 STRLEN len, lsv_len, oldtarglen, newtarglen;
2210 const char * const tmps = SvPV_const(sv, len);
2211 SV * const lsv = LvTARG(sv);
2212 STRLEN lvoff = LvTARGOFF(sv);
2213 STRLEN lvlen = LvTARGLEN(sv);
2214 const bool negoff = LvFLAGS(sv) & 1;
2215 const bool neglen = LvFLAGS(sv) & 2;
2217 PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2218 PERL_UNUSED_ARG(mg);
2222 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR),
2223 "Attempt to use reference as lvalue in substr"
2225 SvPV_force_nomg(lsv,lsv_len);
2226 if (SvUTF8(lsv)) lsv_len = sv_len_utf8_nomg(lsv);
2227 if (!translate_substr_offsets(
2229 negoff ? -(IV)lvoff : (IV)lvoff, !negoff,
2230 neglen ? -(IV)lvlen : (IV)lvlen, !neglen, &lvoff, &lvlen
2232 Perl_croak(aTHX_ "substr outside of string");
2235 sv_utf8_upgrade_nomg(lsv);
2236 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2237 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2238 newtarglen = sv_or_pv_len_utf8(sv, tmps, len);
2241 else if (SvUTF8(lsv)) {
2243 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2245 utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2246 sv_insert_flags(lsv, lvoff, lvlen, utf8, len, 0);
2250 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2253 if (!neglen) LvTARGLEN(sv) = newtarglen;
2254 if (negoff) LvTARGOFF(sv) += newtarglen - oldtarglen;
2260 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2262 PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2263 PERL_UNUSED_ARG(sv);
2264 #ifdef NO_TAINT_SUPPORT
2265 PERL_UNUSED_ARG(mg);
2268 TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1) && IN_PERL_RUNTIME);
2273 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2275 PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2276 PERL_UNUSED_ARG(sv);
2278 /* update taint status */
2287 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2289 SV * const lsv = LvTARG(sv);
2291 PERL_ARGS_ASSERT_MAGIC_GETVEC;
2292 PERL_UNUSED_ARG(mg);
2294 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2300 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2302 PERL_ARGS_ASSERT_MAGIC_SETVEC;
2303 PERL_UNUSED_ARG(mg);
2304 do_vecset(sv); /* XXX slurp this routine */
2309 Perl_defelem_target(pTHX_ SV *sv, MAGIC *mg)
2312 PERL_ARGS_ASSERT_DEFELEM_TARGET;
2313 if (!mg) mg = mg_find(sv, PERL_MAGIC_defelem);
2315 if (LvTARGLEN(sv)) {
2317 SV * const ahv = LvTARG(sv);
2318 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2322 else if (LvSTARGOFF(sv) >= 0) {
2323 AV *const av = MUTABLE_AV(LvTARG(sv));
2324 if (LvSTARGOFF(sv) <= AvFILL(av))
2326 if (SvRMAGICAL(av)) {
2327 SV * const * const svp = av_fetch(av, LvSTARGOFF(sv), 0);
2328 targ = svp ? *svp : NULL;
2331 targ = AvARRAY(av)[LvSTARGOFF(sv)];
2334 if (targ && (targ != &PL_sv_undef)) {
2335 /* somebody else defined it for us */
2336 SvREFCNT_dec(LvTARG(sv));
2337 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2339 SvREFCNT_dec(mg->mg_obj);
2341 mg->mg_flags &= ~MGf_REFCOUNTED;
2350 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2352 PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2354 sv_setsv(sv, defelem_target(sv, mg));
2359 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2361 PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2362 PERL_UNUSED_ARG(mg);
2366 sv_setsv(LvTARG(sv), sv);
2367 SvSETMAGIC(LvTARG(sv));
2373 Perl_vivify_defelem(pTHX_ SV *sv)
2378 PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2380 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2383 SV * const ahv = LvTARG(sv);
2384 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2387 if (!value || value == &PL_sv_undef)
2388 Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2390 else if (LvSTARGOFF(sv) < 0)
2391 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
2393 AV *const av = MUTABLE_AV(LvTARG(sv));
2394 if ((I32)LvTARGLEN(sv) < 0 && LvSTARGOFF(sv) > AvFILL(av))
2395 LvTARG(sv) = NULL; /* array can't be extended */
2397 SV* const * const svp = av_fetch(av, LvSTARGOFF(sv), TRUE);
2398 if (!svp || !(value = *svp))
2399 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
2402 SvREFCNT_inc_simple_void(value);
2403 SvREFCNT_dec(LvTARG(sv));
2406 SvREFCNT_dec(mg->mg_obj);
2408 mg->mg_flags &= ~MGf_REFCOUNTED;
2412 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2414 PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2415 Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2420 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2422 PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2423 PERL_UNUSED_CONTEXT;
2424 PERL_UNUSED_ARG(sv);
2430 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2432 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2434 PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2436 if (uf && uf->uf_set)
2437 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2442 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2444 const char type = mg->mg_type;
2446 PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2448 assert( type == PERL_MAGIC_fm
2449 || type == PERL_MAGIC_qr
2450 || type == PERL_MAGIC_bm);
2451 return sv_unmagic(sv, type);
2454 #ifdef USE_LOCALE_COLLATE
2456 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2458 PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2461 * RenE<eacute> Descartes said "I think not."
2462 * and vanished with a faint plop.
2464 PERL_UNUSED_CONTEXT;
2465 PERL_UNUSED_ARG(sv);
2467 Safefree(mg->mg_ptr);
2473 #endif /* USE_LOCALE_COLLATE */
2475 /* Just clear the UTF-8 cache data. */
2477 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2479 PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2480 PERL_UNUSED_CONTEXT;
2481 PERL_UNUSED_ARG(sv);
2482 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
2484 mg->mg_len = -1; /* The mg_len holds the len cache. */
2489 Perl_magic_setlvref(pTHX_ SV *sv, MAGIC *mg)
2491 const char *bad = NULL;
2492 PERL_ARGS_ASSERT_MAGIC_SETLVREF;
2493 if (!SvROK(sv)) Perl_croak(aTHX_ "Assigned value is not a reference");
2494 switch (mg->mg_private & OPpLVREF_TYPE) {
2496 if (SvTYPE(SvRV(sv)) > SVt_PVLV)
2500 if (SvTYPE(SvRV(sv)) != SVt_PVAV)
2504 if (SvTYPE(SvRV(sv)) != SVt_PVHV)
2508 if (SvTYPE(SvRV(sv)) != SVt_PVCV)
2512 /* diag_listed_as: Assigned value is not %s reference */
2513 Perl_croak(aTHX_ "Assigned value is not a%s reference", bad);
2514 switch (mg->mg_obj ? SvTYPE(mg->mg_obj) : 0) {
2517 SV * const old = PAD_SV(mg->mg_len);
2518 PAD_SETSV(mg->mg_len, SvREFCNT_inc_NN(SvRV(sv)));
2523 gv_setref(mg->mg_obj, sv);
2524 SvSETMAGIC(mg->mg_obj);
2527 av_store((AV *)mg->mg_obj, SvIV((SV *)mg->mg_ptr),
2528 SvREFCNT_inc_simple_NN(SvRV(sv)));
2531 (void)hv_store_ent((HV *)mg->mg_obj, (SV *)mg->mg_ptr,
2532 SvREFCNT_inc_simple_NN(SvRV(sv)), 0);
2534 if (mg->mg_flags & MGf_PERSIST)
2535 NOOP; /* This sv is in use as an iterator var and will be reused,
2536 so we must leave the magic. */
2538 /* This sv could be returned by the assignment op, so clear the
2539 magic, as lvrefs are an implementation detail that must not be
2540 leaked to the user. */
2541 sv_unmagic(sv, PERL_MAGIC_lvref);
2546 S_set_dollarzero(pTHX_ SV *sv)
2547 PERL_TSA_REQUIRES(PL_dollarzero_mutex)
2554 #ifdef HAS_SETPROCTITLE
2555 /* The BSDs don't show the argv[] in ps(1) output, they
2556 * show a string from the process struct and provide
2557 * the setproctitle() routine to manipulate that. */
2558 if (PL_origalen != 1) {
2559 s = SvPV_const(sv, len);
2560 # if __FreeBSD_version > 410001 || defined(__DragonFly__)
2561 /* The leading "-" removes the "perl: " prefix,
2562 * but not the "(perl) suffix from the ps(1)
2563 * output, because that's what ps(1) shows if the
2564 * argv[] is modified. */
2565 setproctitle("-%s", s);
2566 # else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2567 /* This doesn't really work if you assume that
2568 * $0 = 'foobar'; will wipe out 'perl' from the $0
2569 * because in ps(1) output the result will be like
2570 * sprintf("perl: %s (perl)", s)
2571 * I guess this is a security feature:
2572 * one (a user process) cannot get rid of the original name.
2574 setproctitle("%s", s);
2577 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2578 if (PL_origalen != 1) {
2580 s = SvPV_const(sv, len);
2581 un.pst_command = (char *)s;
2582 pstat(PSTAT_SETCMD, un, len, 0, 0);
2585 if (PL_origalen > 1) {
2587 /* PL_origalen is set in perl_parse(). */
2588 s = SvPV_force(sv,len);
2589 if (len >= (STRLEN)PL_origalen-1) {
2590 /* Longer than original, will be truncated. We assume that
2591 * PL_origalen bytes are available. */
2592 Copy(s, PL_origargv[0], PL_origalen-1, char);
2595 /* Shorter than original, will be padded. */
2597 /* Special case for Mac OS X: see [perl #38868] */
2600 /* Is the space counterintuitive? Yes.
2601 * (You were expecting \0?)
2602 * Does it work? Seems to. (In Linux 2.4.20 at least.)
2604 const int pad = ' ';
2606 Copy(s, PL_origargv[0], len, char);
2607 PL_origargv[0][len] = 0;
2608 memset(PL_origargv[0] + len + 1,
2609 pad, PL_origalen - len - 1);
2611 PL_origargv[0][PL_origalen-1] = 0;
2612 for (i = 1; i < PL_origargc; i++)
2614 #ifdef HAS_PRCTL_SET_NAME
2615 /* Set the legacy process name in addition to the POSIX name on Linux */
2616 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
2617 /* diag_listed_as: SKIPME */
2618 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
2626 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2637 PERL_ARGS_ASSERT_MAGIC_SET;
2641 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2643 CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2645 /* Croak with a READONLY error when a numbered match var is
2646 * set without a previous pattern match. Unless it's C<local $1>
2649 if (!PL_localizing) {
2650 Perl_croak_no_modify();
2656 switch (*mg->mg_ptr) {
2657 case '\001': /* ^A */
2658 if (SvOK(sv)) sv_copypv(PL_bodytarget, sv);
2659 else SvOK_off(PL_bodytarget);
2660 FmLINES(PL_bodytarget) = 0;
2661 if (SvPOK(PL_bodytarget)) {
2662 char *s = SvPVX(PL_bodytarget);
2663 while ( ((s = strchr(s, '\n'))) ) {
2664 FmLINES(PL_bodytarget)++;
2668 /* mg_set() has temporarily made sv non-magical */
2670 if ((tmg = mg_find(sv,PERL_MAGIC_taint)) && tmg->mg_len & 1)
2671 SvTAINTED_on(PL_bodytarget);
2673 SvTAINTED_off(PL_bodytarget);
2676 case '\003': /* ^C */
2677 PL_minus_c = cBOOL(SvIV(sv));
2680 case '\004': /* ^D */
2683 const char *s = SvPV_nolen_const(sv);
2684 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2685 if (DEBUG_x_TEST || DEBUG_B_TEST)
2686 dump_all_perl(!DEBUG_B_TEST);
2689 PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
2692 case '\005': /* ^E */
2693 if (*(mg->mg_ptr+1) == '\0') {
2695 set_vaxc_errno(SvIV(sv));
2698 SetLastError( SvIV(sv) );
2701 os2_setsyserrno(SvIV(sv));
2703 /* will anyone ever use this? */
2704 SETERRNO(SvIV(sv), 4);
2710 if (strEQ(mg->mg_ptr + 1, "NCODING") && SvOK(sv))
2711 if (PL_localizing != 2) {
2712 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
2713 "${^ENCODING} is no longer supported");
2717 case '\006': /* ^F */
2718 PL_maxsysfd = SvIV(sv);
2720 case '\010': /* ^H */
2721 PL_hints = SvIV(sv);
2723 case '\011': /* ^I */ /* NOT \t in EBCDIC */
2724 Safefree(PL_inplace);
2725 PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2727 case '\016': /* ^N */
2728 if (PL_curpm && (rx = PM_GETRE(PL_curpm))
2729 && (paren = RX_LASTCLOSEPAREN(rx))) goto setparen_got_rx;
2731 case '\017': /* ^O */
2732 if (*(mg->mg_ptr+1) == '\0') {
2733 Safefree(PL_osname);
2736 TAINT_PROPER("assigning to $^O");
2737 PL_osname = savesvpv(sv);
2740 else if (strEQ(mg->mg_ptr, "\017PEN")) {
2742 const char *const start = SvPV(sv, len);
2743 const char *out = (const char*)memchr(start, '\0', len);
2747 PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2748 PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2750 /* Opening for input is more common than opening for output, so
2751 ensure that hints for input are sooner on linked list. */
2752 tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2754 : newSVpvs_flags("", SvUTF8(sv));
2755 (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2758 tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2760 (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2764 case '\020': /* ^P */
2765 PL_perldb = SvIV(sv);
2766 if (PL_perldb && !PL_DBsingle)
2769 case '\024': /* ^T */
2771 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2773 PL_basetime = (Time_t)SvIV(sv);
2776 case '\025': /* ^UTF8CACHE */
2777 if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2778 PL_utf8cache = (signed char) sv_2iv(sv);
2781 case '\027': /* ^W & $^WARNING_BITS */
2782 if (*(mg->mg_ptr+1) == '\0') {
2783 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2785 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2786 | (i ? G_WARN_ON : G_WARN_OFF) ;
2789 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2790 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2792 PL_compiling.cop_warnings = pWARN_STD;
2797 int accumulate = 0 ;
2798 int any_fatals = 0 ;
2799 const char * const ptr = SvPV_const(sv, len) ;
2800 for (i = 0 ; i < len ; ++i) {
2801 accumulate |= ptr[i] ;
2802 any_fatals |= (ptr[i] & 0xAA) ;
2805 if (!specialWARN(PL_compiling.cop_warnings))
2806 PerlMemShared_free(PL_compiling.cop_warnings);
2807 PL_compiling.cop_warnings = pWARN_NONE;
2809 /* Yuck. I can't see how to abstract this: */
2811 ((STRLEN *)SvPV_nolen_const(sv)) - 1,
2815 if (!specialWARN(PL_compiling.cop_warnings))
2816 PerlMemShared_free(PL_compiling.cop_warnings);
2817 PL_compiling.cop_warnings = pWARN_ALL;
2818 PL_dowarn |= G_WARN_ONCE ;
2822 const char *const p = SvPV_const(sv, len);
2824 PL_compiling.cop_warnings
2825 = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2828 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2829 PL_dowarn |= G_WARN_ONCE ;
2836 else if (strEQ(mg->mg_ptr+1, "IN32_SLOPPY_STAT")) {
2837 w32_sloppystat = (bool)sv_true(sv);
2842 if (PL_localizing) {
2843 if (PL_localizing == 1)
2844 SAVESPTR(PL_last_in_gv);
2846 else if (SvOK(sv) && GvIO(PL_last_in_gv))
2847 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2850 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2851 IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2852 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2855 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2856 IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2857 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2860 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2863 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2864 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2865 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2868 IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2872 IO * const io = GvIO(PL_defoutgv);
2875 if ((SvIV(sv)) == 0)
2876 IoFLAGS(io) &= ~IOf_FLUSH;
2878 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2879 PerlIO *ofp = IoOFP(io);
2881 (void)PerlIO_flush(ofp);
2882 IoFLAGS(io) |= IOf_FLUSH;
2891 SV *referent= SvRV(sv);
2892 const char *reftype= sv_reftype(referent, 0);
2893 /* XXX: dodgy type check: This leaves me feeling dirty, but the alternative
2894 * is to copy pretty much the entire sv_reftype() into this routine, or to do
2895 * a full string comparison on the return of sv_reftype() both of which
2896 * make me feel worse! NOTE, do not modify this comment without reviewing the
2897 * corresponding comment in sv_reftype(). - Yves */
2898 if (reftype[0] == 'S' || reftype[0] == 'L') {
2899 IV val= SvIV(referent);
2901 tmpsv= &PL_sv_undef;
2902 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
2903 "Setting $/ to a reference to %s as a form of slurp is deprecated, treating as undef",
2904 SvIV(SvRV(sv)) < 0 ? "a negative integer" : "zero"
2908 sv_setsv(sv, PL_rs);
2909 /* diag_listed_as: Setting $/ to %s reference is forbidden */
2910 Perl_croak(aTHX_ "Setting $/ to a%s %s reference is forbidden",
2911 *reftype == 'A' ? "n" : "", reftype);
2914 SvREFCNT_dec(PL_rs);
2915 PL_rs = newSVsv(tmpsv);
2919 SvREFCNT_dec(PL_ors_sv);
2921 PL_ors_sv = newSVsv(sv);
2929 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2932 #ifdef COMPLEX_STATUS
2933 if (PL_localizing == 2) {
2934 SvUPGRADE(sv, SVt_PVLV);
2935 PL_statusvalue = LvTARGOFF(sv);
2936 PL_statusvalue_vms = LvTARGLEN(sv);
2940 #ifdef VMSISH_STATUS
2942 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
2945 STATUS_UNIX_EXIT_SET(SvIV(sv));
2950 # define PERL_VMS_BANG vaxc$errno
2952 # define PERL_VMS_BANG 0
2954 #if defined(WIN32) && ! defined(UNDER_CE)
2955 SETERRNO(win32_get_errno(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0),
2956 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2958 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2959 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2965 /* XXX $< currently silently ignores failures */
2966 const Uid_t new_uid = SvUID(sv);
2967 PL_delaymagic_uid = new_uid;
2968 if (PL_delaymagic) {
2969 PL_delaymagic |= DM_RUID;
2970 break; /* don't do magic till later */
2973 PERL_UNUSED_RESULT(setruid(new_uid));
2976 PERL_UNUSED_RESULT(setreuid(new_uid, (Uid_t)-1));
2978 #ifdef HAS_SETRESUID
2979 PERL_UNUSED_RESULT(setresuid(new_uid, (Uid_t)-1, (Uid_t)-1));
2981 if (new_uid == PerlProc_geteuid()) { /* special case $< = $> */
2983 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2984 if (new_uid != 0 && PerlProc_getuid() == 0)
2985 PERL_UNUSED_RESULT(PerlProc_setuid(0));
2987 PERL_UNUSED_RESULT(PerlProc_setuid(new_uid));
2989 Perl_croak(aTHX_ "setruid() not implemented");
2998 /* XXX $> currently silently ignores failures */
2999 const Uid_t new_euid = SvUID(sv);
3000 PL_delaymagic_euid = new_euid;
3001 if (PL_delaymagic) {
3002 PL_delaymagic |= DM_EUID;
3003 break; /* don't do magic till later */
3006 PERL_UNUSED_RESULT(seteuid(new_euid));
3009 PERL_UNUSED_RESULT(setreuid((Uid_t)-1, new_euid));
3011 #ifdef HAS_SETRESUID
3012 PERL_UNUSED_RESULT(setresuid((Uid_t)-1, new_euid, (Uid_t)-1));
3014 if (new_euid == PerlProc_getuid()) /* special case $> = $< */
3015 PERL_UNUSED_RESULT(PerlProc_setuid(new_euid));
3017 Perl_croak(aTHX_ "seteuid() not implemented");
3026 /* XXX $( currently silently ignores failures */
3027 const Gid_t new_gid = SvGID(sv);
3028 PL_delaymagic_gid = new_gid;
3029 if (PL_delaymagic) {
3030 PL_delaymagic |= DM_RGID;
3031 break; /* don't do magic till later */
3034 PERL_UNUSED_RESULT(setrgid(new_gid));
3037 PERL_UNUSED_RESULT(setregid(new_gid, (Gid_t)-1));
3039 #ifdef HAS_SETRESGID
3040 PERL_UNUSED_RESULT(setresgid(new_gid, (Gid_t)-1, (Gid_t) -1));
3042 if (new_gid == PerlProc_getegid()) /* special case $( = $) */
3043 PERL_UNUSED_RESULT(PerlProc_setgid(new_gid));
3045 Perl_croak(aTHX_ "setrgid() not implemented");
3054 /* (hv) best guess: maybe we'll need configure probes to do a better job,
3055 * but you can override it if you need to.
3058 #define INVALID_GID ((Gid_t)-1)
3060 /* XXX $) currently silently ignores failures */
3062 #ifdef HAS_SETGROUPS
3064 const char *p = SvPV_const(sv, len);
3065 Groups_t *gary = NULL;
3068 #ifdef _SC_NGROUPS_MAX
3069 int maxgrp = sysconf(_SC_NGROUPS_MAX);
3074 int maxgrp = NGROUPS;
3079 if (grok_atoUV(p, &uv, &endptr))
3080 new_egid = (Gid_t)uv;
3082 new_egid = INVALID_GID;
3085 for (i = 0; i < maxgrp; ++i) {
3094 Newx(gary, i + 1, Groups_t);
3096 Renew(gary, i + 1, Groups_t);
3097 if (grok_atoUV(p, &uv, &endptr))
3098 gary[i] = (Groups_t)uv;
3100 gary[i] = INVALID_GID;
3105 PERL_UNUSED_RESULT(setgroups(i, gary));
3108 #else /* HAS_SETGROUPS */
3109 new_egid = SvGID(sv);
3110 #endif /* HAS_SETGROUPS */
3111 PL_delaymagic_egid = new_egid;
3112 if (PL_delaymagic) {
3113 PL_delaymagic |= DM_EGID;
3114 break; /* don't do magic till later */
3117 PERL_UNUSED_RESULT(setegid(new_egid));
3120 PERL_UNUSED_RESULT(setregid((Gid_t)-1, new_egid));
3122 #ifdef HAS_SETRESGID
3123 PERL_UNUSED_RESULT(setresgid((Gid_t)-1, new_egid, (Gid_t)-1));
3125 if (new_egid == PerlProc_getgid()) /* special case $) = $( */
3126 PERL_UNUSED_RESULT(PerlProc_setgid(new_egid));
3128 Perl_croak(aTHX_ "setegid() not implemented");
3136 PL_chopset = SvPV_force(sv,len);
3139 /* Store the pid in mg->mg_obj so we can tell when a fork has
3140 occurred. mg->mg_obj points to *$ by default, so clear it. */
3141 if (isGV(mg->mg_obj)) {
3142 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
3143 SvREFCNT_dec(mg->mg_obj);
3144 mg->mg_flags |= MGf_REFCOUNTED;
3145 mg->mg_obj = newSViv((IV)PerlProc_getpid());
3147 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
3150 LOCK_DOLLARZERO_MUTEX;
3151 S_set_dollarzero(aTHX_ sv);
3152 UNLOCK_DOLLARZERO_MUTEX;
3159 Perl_whichsig_sv(pTHX_ SV *sigsv)
3163 PERL_ARGS_ASSERT_WHICHSIG_SV;
3164 sigpv = SvPV_const(sigsv, siglen);
3165 return whichsig_pvn(sigpv, siglen);
3169 Perl_whichsig_pv(pTHX_ const char *sig)
3171 PERL_ARGS_ASSERT_WHICHSIG_PV;
3172 return whichsig_pvn(sig, strlen(sig));
3176 Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
3180 PERL_ARGS_ASSERT_WHICHSIG_PVN;
3181 PERL_UNUSED_CONTEXT;
3183 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
3184 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
3185 return PL_sig_num[sigv - (char* const*)PL_sig_name];
3187 if (memEQs(sig, len, "CHLD"))
3191 if (memEQs(sig, len, "CLD"))
3198 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3199 Perl_sighandler(int sig, siginfo_t *sip, void *uap)
3201 Perl_sighandler(int sig)
3204 #ifdef PERL_GET_SIG_CONTEXT
3205 dTHXa(PERL_GET_SIG_CONTEXT);
3212 SV * const tSv = PL_Sv;
3216 XPV * const tXpv = PL_Xpv;
3217 I32 old_ss_ix = PL_savestack_ix;
3218 SV *errsv_save = NULL;
3221 if (!PL_psig_ptr[sig]) {
3222 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
3227 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3228 /* Max number of items pushed there is 3*n or 4. We cannot fix
3229 infinity, so we fix 4 (in fact 5): */
3230 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3232 PL_savestack_ix += 5; /* Protect save in progress. */
3233 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3236 /* sv_2cv is too complicated, try a simpler variant first: */
3237 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
3238 || SvTYPE(cv) != SVt_PVCV) {
3240 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
3243 if (!cv || !CvROOT(cv)) {
3244 const HEK * const hek = gv
3248 : cv && CvGV(cv) ? GvENAME_HEK(CvGV(cv)) : NULL;
3250 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3251 "SIG%s handler \"%" HEKf "\" not defined.\n",
3252 PL_sig_name[sig], HEKfARG(hek));
3253 /* diag_listed_as: SIG%s handler "%s" not defined */
3254 else Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3255 "SIG%s handler \"__ANON__\" not defined.\n",
3260 sv = PL_psig_name[sig]
3261 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3262 : newSVpv(PL_sig_name[sig],0);
3266 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3267 /* make sure our assumption about the size of the SAVEs are correct:
3268 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3269 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3272 PUSHSTACKi(PERLSI_SIGNAL);
3275 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3277 struct sigaction oact;
3279 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
3282 SV *rv = newRV_noinc(MUTABLE_SV(sih));
3283 /* The siginfo fields signo, code, errno, pid, uid,
3284 * addr, status, and band are defined by POSIX/SUSv3. */
3285 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3286 (void)hv_stores(sih, "code", newSViv(sip->si_code));
3287 #ifdef HAS_SIGINFO_SI_ERRNO
3288 (void)hv_stores(sih, "errno", newSViv(sip->si_errno));
3290 #ifdef HAS_SIGINFO_SI_STATUS
3291 (void)hv_stores(sih, "status", newSViv(sip->si_status));
3293 #ifdef HAS_SIGINFO_SI_UID
3296 sv_setuid(uid, sip->si_uid);
3297 (void)hv_stores(sih, "uid", uid);
3300 #ifdef HAS_SIGINFO_SI_PID
3301 (void)hv_stores(sih, "pid", newSViv(sip->si_pid));
3303 #ifdef HAS_SIGINFO_SI_ADDR
3304 (void)hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3306 #ifdef HAS_SIGINFO_SI_BAND
3307 (void)hv_stores(sih, "band", newSViv(sip->si_band));
3311 mPUSHp((char *)sip, sizeof(*sip));
3319 errsv_save = newSVsv(ERRSV);
3321 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
3325 SV * const errsv = ERRSV;
3326 if (SvTRUE_NN(errsv)) {
3327 SvREFCNT_dec(errsv_save);
3329 /* Handler "died", for example to get out of a restart-able read().
3330 * Before we re-do that on its behalf re-enable the signal which was
3331 * blocked by the system when we entered.
3333 #ifdef HAS_SIGPROCMASK
3334 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3340 sigaddset(&set,sig);
3341 sigprocmask(SIG_UNBLOCK, &set, NULL);
3344 /* Not clear if this will work */
3345 (void)rsignal(sig, SIG_IGN);
3346 (void)rsignal(sig, PL_csighandlerp);
3348 #endif /* !PERL_MICRO */
3352 sv_setsv(errsv, errsv_save);
3353 SvREFCNT_dec(errsv_save);
3358 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3359 PL_savestack_ix = old_ss_ix;
3361 SvREFCNT_dec_NN(sv);
3362 PL_op = myop; /* Apparently not needed... */
3364 PL_Sv = tSv; /* Restore global temporaries. */
3371 S_restore_magic(pTHX_ const void *p)
3373 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3374 SV* const sv = mgs->mgs_sv;
3380 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
3381 SvTEMP_off(sv); /* if it's still magical, this value isn't temporary */
3383 SvFLAGS(sv) |= mgs->mgs_flags;
3388 bumped = mgs->mgs_bumped;
3389 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3391 /* If we're still on top of the stack, pop us off. (That condition
3392 * will be satisfied if restore_magic was called explicitly, but *not*
3393 * if it's being called via leave_scope.)
3394 * The reason for doing this is that otherwise, things like sv_2cv()
3395 * may leave alloc gunk on the savestack, and some code
3396 * (e.g. sighandler) doesn't expect that...
3398 if (PL_savestack_ix == mgs->mgs_ss_ix)
3400 UV popval = SSPOPUV;
3401 assert(popval == SAVEt_DESTRUCTOR_X);
3402 PL_savestack_ix -= 2;
3404 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3405 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
3408 if (SvREFCNT(sv) == 1) {
3409 /* We hold the last reference to this SV, which implies that the
3410 SV was deleted as a side effect of the routines we called.
3411 So artificially keep it alive a bit longer.
3412 We avoid turning on the TEMP flag, which can cause the SV's
3413 buffer to get stolen (and maybe other stuff). */
3418 SvREFCNT_dec_NN(sv); /* undo the inc in S_save_magic() */
3422 /* clean up the mess created by Perl_sighandler().
3423 * Note that this is only called during an exit in a signal handler;
3424 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
3428 S_unwind_handler_stack(pTHX_ const void *p)
3432 PL_savestack_ix -= 5; /* Unprotect save in progress. */
3436 =for apidoc magic_sethint
3438 Triggered by a store to C<%^H>, records the key/value pair to
3439 C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3440 anything that would need a deep copy. Maybe we should warn if we find a
3446 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3448 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3449 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3451 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3453 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3454 an alternative leaf in there, with PL_compiling.cop_hints being used if
3455 it's NULL. If needed for threads, the alternative could lock a mutex,
3456 or take other more complex action. */
3458 /* Something changed in %^H, so it will need to be restored on scope exit.
3459 Doing this here saves a lot of doing it manually in perl code (and
3460 forgetting to do it, and consequent subtle errors. */
3461 PL_hints |= HINT_LOCALIZE_HH;
3462 CopHINTHASH_set(&PL_compiling,
3463 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
3468 =for apidoc magic_clearhint
3470 Triggered by a delete from C<%^H>, records the key to
3471 C<PL_compiling.cop_hints_hash>.
3476 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3478 PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3479 PERL_UNUSED_ARG(sv);
3481 PL_hints |= HINT_LOCALIZE_HH;
3482 CopHINTHASH_set(&PL_compiling,
3483 mg->mg_len == HEf_SVKEY
3484 ? cophh_delete_sv(CopHINTHASH_get(&PL_compiling),
3485 MUTABLE_SV(mg->mg_ptr), 0, 0)
3486 : cophh_delete_pvn(CopHINTHASH_get(&PL_compiling),
3487 mg->mg_ptr, mg->mg_len, 0, 0));
3492 =for apidoc magic_clearhints
3494 Triggered by clearing C<%^H>, resets C<PL_compiling.cop_hints_hash>.
3499 Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3501 PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3502 PERL_UNUSED_ARG(sv);
3503 PERL_UNUSED_ARG(mg);
3504 cophh_free(CopHINTHASH_get(&PL_compiling));
3505 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
3510 Perl_magic_copycallchecker(pTHX_ SV *sv, MAGIC *mg, SV *nsv,
3511 const char *name, I32 namlen)
3515 PERL_ARGS_ASSERT_MAGIC_COPYCALLCHECKER;
3516 PERL_UNUSED_ARG(sv);
3517 PERL_UNUSED_ARG(name);
3518 PERL_UNUSED_ARG(namlen);
3520 sv_magic(nsv, &PL_sv_undef, mg->mg_type, NULL, 0);
3521 nmg = mg_find(nsv, mg->mg_type);
3523 if (nmg->mg_flags & MGf_REFCOUNTED) SvREFCNT_dec(nmg->mg_obj);
3524 nmg->mg_ptr = mg->mg_ptr;
3525 nmg->mg_obj = SvREFCNT_inc_simple(mg->mg_obj);
3526 nmg->mg_flags |= MGf_REFCOUNTED;
3531 Perl_magic_setdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3532 PERL_ARGS_ASSERT_MAGIC_SETDEBUGVAR;
3534 #if DBVARMG_SINGLE != 0
3535 assert(mg->mg_private >= DBVARMG_SINGLE);
3537 assert(mg->mg_private < DBVARMG_COUNT);
3539 PL_DBcontrol[mg->mg_private] = SvIV_nomg(sv);
3545 Perl_magic_getdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3546 PERL_ARGS_ASSERT_MAGIC_GETDEBUGVAR;
3548 #if DBVARMG_SINGLE != 0
3549 assert(mg->mg_private >= DBVARMG_SINGLE);
3551 assert(mg->mg_private < DBVARMG_COUNT);
3552 sv_setiv(sv, PL_DBcontrol[mg->mg_private]);
3558 * ex: set ts=8 sts=4 sw=4 et: