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)
474 : (type == PERL_MAGIC_regdata && mg->mg_obj)
477 toLOWER(type), key, klen);
486 =for apidoc mg_localize
488 Copy some of the magic from an existing SV to new localized version of that
489 SV. Container magic (I<e.g.>, C<%ENV>, C<$1>, C<tie>)
490 gets copied, value magic doesn't (I<e.g.>,
493 If C<setmagic> is false then no set magic will be called on the new (empty) SV.
494 This typically means that assignment will soon follow (e.g. S<C<'local $x = $y'>>),
495 and that will handle the magic.
501 Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
505 PERL_ARGS_ASSERT_MG_LOCALIZE;
510 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
511 const MGVTBL* const vtbl = mg->mg_virtual;
512 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
515 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
516 (void)vtbl->svt_local(aTHX_ nsv, mg);
518 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
519 mg->mg_ptr, mg->mg_len);
521 /* container types should remain read-only across localization */
522 SvFLAGS(nsv) |= SvREADONLY(sv);
525 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
526 SvFLAGS(nsv) |= SvMAGICAL(sv);
535 #define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
537 S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
539 const MGVTBL* const vtbl = mg->mg_virtual;
540 if (vtbl && vtbl->svt_free)
541 vtbl->svt_free(aTHX_ sv, mg);
542 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
543 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
544 Safefree(mg->mg_ptr);
545 else if (mg->mg_len == HEf_SVKEY)
546 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
548 if (mg->mg_flags & MGf_REFCOUNTED)
549 SvREFCNT_dec(mg->mg_obj);
556 Free any magic storage used by the SV. See C<L</sv_magic>>.
562 Perl_mg_free(pTHX_ SV *sv)
567 PERL_ARGS_ASSERT_MG_FREE;
569 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
570 moremagic = mg->mg_moremagic;
571 mg_free_struct(sv, mg);
572 SvMAGIC_set(sv, moremagic);
574 SvMAGIC_set(sv, NULL);
580 =for apidoc Am|void|mg_free_type|SV *sv|int how
582 Remove any magic of type C<how> from the SV C<sv>. See L</sv_magic>.
588 Perl_mg_free_type(pTHX_ SV *sv, int how)
590 MAGIC *mg, *prevmg, *moremg;
591 PERL_ARGS_ASSERT_MG_FREE_TYPE;
592 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
594 moremg = mg->mg_moremagic;
595 if (mg->mg_type == how) {
596 /* temporarily move to the head of the magic chain, in case
597 custom free code relies on this historical aspect of mg_free */
599 prevmg->mg_moremagic = moremg;
600 mg->mg_moremagic = SvMAGIC(sv);
603 newhead = mg->mg_moremagic;
604 mg_free_struct(sv, mg);
605 SvMAGIC_set(sv, newhead);
615 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
619 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
622 const REGEXP * const rx = PM_GETRE(PL_curpm);
624 if (mg->mg_obj) { /* @+ */
625 /* return the number possible */
626 return RX_NPARENS(rx);
628 I32 paren = RX_LASTPAREN(rx);
630 /* return the last filled */
632 && (RX_OFFS(rx)[paren].start == -1
633 || RX_OFFS(rx)[paren].end == -1) )
646 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
648 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
651 const REGEXP * const rx = PM_GETRE(PL_curpm);
653 const I32 paren = mg->mg_len;
658 if (paren <= (I32)RX_NPARENS(rx) &&
659 (s = RX_OFFS(rx)[paren].start) != -1 &&
660 (t = RX_OFFS(rx)[paren].end) != -1)
663 if (mg->mg_obj) /* @+ */
668 if (RX_MATCH_UTF8(rx)) {
669 const char * const b = RX_SUBBEG(rx);
671 i = RX_SUBCOFFSET(rx) +
673 (U8*)(b-RX_SUBOFFSET(rx)+i));
688 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
690 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
694 Perl_croak_no_modify();
695 NORETURN_FUNCTION_END;
698 #define SvRTRIM(sv) STMT_START { \
700 STRLEN len = SvCUR(sv); \
701 char * const p = SvPVX(sv); \
702 while (len > 0 && isSPACE(p[len-1])) \
704 SvCUR_set(sv, len); \
710 Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
712 PERL_ARGS_ASSERT_EMULATE_COP_IO;
714 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
715 sv_setsv(sv, &PL_sv_undef);
719 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
720 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
725 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
726 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
734 S_fixup_errno_string(pTHX_ SV* sv)
736 /* Do what is necessary to fixup the non-empty string in 'sv' for return to
739 PERL_ARGS_ASSERT_FIXUP_ERRNO_STRING;
743 if(strEQ(SvPVX(sv), "")) {
744 sv_catpv(sv, UNKNOWN_ERRNO_MSG);
748 /* In some locales the error string may come back as UTF-8, in which
749 * case we should turn on that flag. This didn't use to happen, and to
750 * avoid as many possible backward compatibility issues as possible, we
751 * don't turn on the flag unless we have to. So the flag stays off for
752 * an entirely invariant string. We assume that if the string looks
753 * like UTF-8, it really is UTF-8: "text in any other encoding that
754 * uses bytes with the high bit set is extremely unlikely to pass a
755 * UTF-8 validity test"
756 * (http://en.wikipedia.org/wiki/Charset_detection). There is a
757 * potential that we will get it wrong however, especially on short
758 * error message text. (If it turns out to be necessary, we could also
759 * keep track if the current LC_MESSAGES locale is UTF-8) */
760 if (! IN_BYTES /* respect 'use bytes' */
761 && ! is_invariant_string((U8*) SvPVX_const(sv), SvCUR(sv))
762 && is_utf8_string((U8*) SvPVX_const(sv), SvCUR(sv)))
770 Perl__get_encoding(pTHX)
772 /* For core Perl use only: Returns the $^ENCODING or 'use encoding' in
773 * effect; NULL if none.
775 * $^ENCODING maps to PL_encoding, and is the old way to do things, and is
776 * retained for backwards compatibility. Now, there is a shadow variable
777 * ${^E_NCODING} set only by the encoding pragma, used to give this pragma
778 * lexical scope, unlike the global scope it (shudder) used to have. This
779 * variable maps to PL_lex_encoding. Again for backwards compatibility,
780 * PL_encoding has precedence over PL_lex_encoding. The hints hash is used
781 * to determine if PL_lex_encoding is in scope, and hence valid. The hints
782 * hash only accepts simple values, so we can't put an Encode object into
783 * it, so we put the object into the global, and put a simple boolean into
784 * the hints hash giving whether the global is valid or not */
793 if (! PL_lex_encoding) {
797 is_encoding = cop_hints_fetch_pvs(PL_curcop, "encoding", 0);
799 && is_encoding != &PL_sv_placeholder
800 && SvIOK(is_encoding)
801 && SvIV(is_encoding)) /* non-zero mean valid */
803 return PL_lex_encoding;
815 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
818 const char *s = NULL;
820 const char * const remaining = mg->mg_ptr + 1;
823 PERL_ARGS_ASSERT_MAGIC_GET;
827 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
829 CALLREG_NUMBUF_FETCH(rx,paren,sv);
831 sv_setsv(sv,&PL_sv_undef);
836 nextchar = *remaining;
837 switch (*mg->mg_ptr) {
838 case '\001': /* ^A */
839 if (SvOK(PL_bodytarget)) sv_copypv(sv, PL_bodytarget);
840 else sv_setsv(sv, &PL_sv_undef);
841 if (SvTAINTED(PL_bodytarget))
844 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
845 if (nextchar == '\0') {
846 sv_setiv(sv, (IV)PL_minus_c);
848 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
849 sv_setiv(sv, (IV)STATUS_NATIVE);
853 case '\004': /* ^D */
854 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
856 case '\005': /* ^E */
857 if (nextchar != '\0') {
858 if (strEQ(remaining, "NCODING"))
859 sv_setsv(sv, _get_encoding());
860 else if (strEQ(remaining, "_NCODING"))
865 #if defined(VMS) || defined(OS2) || defined(WIN32)
869 $DESCRIPTOR(msgdsc,msg);
870 sv_setnv(sv,(NV) vaxc$errno);
871 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
872 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
877 if (!(_emx_env & 0x200)) { /* Under DOS */
878 sv_setnv(sv, (NV)errno);
879 sv_setpv(sv, errno ? my_strerror(errno) : "");
881 if (errno != errno_isOS2) {
882 const int tmp = _syserrno();
883 if (tmp) /* 2nd call to _syserrno() makes it 0 */
886 sv_setnv(sv, (NV)Perl_rc);
887 sv_setpv(sv, os2error(Perl_rc));
889 if (SvOK(sv) && strNE(SvPVX(sv), "")) {
890 fixup_errno_string(sv);
892 # elif defined(WIN32)
894 const DWORD dwErr = GetLastError();
895 sv_setnv(sv, (NV)dwErr);
897 PerlProc_GetOSError(sv, dwErr);
898 fixup_errno_string(sv);
905 # error Missing code for platform
908 SvNOK_on(sv); /* what a wonderful hack! */
910 #endif /* End of platforms with special handling for $^E; others just fall
917 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
919 sv_setnv(sv, (NV)errno);
922 if (errno == errno_isOS2 || errno == errno_isOS2_set)
923 sv_setpv(sv, os2error(Perl_rc));
931 /* Strerror can return NULL on some platforms, which will
932 * result in 'sv' not being considered SvOK. The SvNOK_on()
933 * below will cause just the number part to be valid */
934 sv_setpv(sv, my_strerror(errno));
936 fixup_errno_string(sv);
943 SvNOK_on(sv); /* what a wonderful hack! */
946 case '\006': /* ^F */
947 sv_setiv(sv, (IV)PL_maxsysfd);
949 case '\007': /* ^GLOBAL_PHASE */
950 if (strEQ(remaining, "LOBAL_PHASE")) {
951 sv_setpvn(sv, PL_phase_names[PL_phase],
952 strlen(PL_phase_names[PL_phase]));
955 case '\010': /* ^H */
956 sv_setiv(sv, (IV)PL_hints);
958 case '\011': /* ^I */ /* NOT \t in EBCDIC */
959 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
961 case '\014': /* ^LAST_FH */
962 if (strEQ(remaining, "AST_FH")) {
964 assert(isGV_with_GP(PL_last_in_gv));
965 SV_CHECK_THINKFIRST_COW_DROP(sv);
966 prepare_SV_for_RV(sv);
968 SvRV_set(sv, SvREFCNT_inc_simple_NN(PL_last_in_gv));
972 else sv_setsv_nomg(sv, NULL);
975 case '\017': /* ^O & ^OPEN */
976 if (nextchar == '\0') {
977 sv_setpv(sv, PL_osname);
980 else if (strEQ(remaining, "PEN")) {
981 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
985 sv_setiv(sv, (IV)PL_perldb);
987 case '\023': /* ^S */
989 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
992 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
997 case '\024': /* ^T */
998 if (nextchar == '\0') {
1000 sv_setnv(sv, PL_basetime);
1002 sv_setiv(sv, (IV)PL_basetime);
1005 else if (strEQ(remaining, "AINT"))
1006 sv_setiv(sv, TAINTING_get
1007 ? (TAINT_WARN_get || PL_unsafe ? -1 : 1)
1010 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
1011 if (strEQ(remaining, "NICODE"))
1012 sv_setuv(sv, (UV) PL_unicode);
1013 else if (strEQ(remaining, "TF8LOCALE"))
1014 sv_setuv(sv, (UV) PL_utf8locale);
1015 else if (strEQ(remaining, "TF8CACHE"))
1016 sv_setiv(sv, (IV) PL_utf8cache);
1018 case '\027': /* ^W & $^WARNING_BITS */
1019 if (nextchar == '\0')
1020 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
1021 else if (strEQ(remaining, "ARNING_BITS")) {
1022 if (PL_compiling.cop_warnings == pWARN_NONE) {
1023 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
1025 else if (PL_compiling.cop_warnings == pWARN_STD) {
1026 sv_setsv(sv, &PL_sv_undef);
1029 else if (PL_compiling.cop_warnings == pWARN_ALL) {
1030 /* Get the bit mask for $warnings::Bits{all}, because
1031 * it could have been extended by warnings::register */
1032 HV * const bits = get_hv("warnings::Bits", 0);
1033 SV ** const bits_all = bits ? hv_fetchs(bits, "all", FALSE) : NULL;
1035 sv_copypv(sv, *bits_all);
1037 sv_setpvn(sv, WARN_ALLstring, WARNsize);
1040 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
1041 *PL_compiling.cop_warnings);
1045 else if (strEQ(remaining, "IN32_SLOPPY_STAT")) {
1046 sv_setiv(sv, w32_sloppystat);
1051 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1052 paren = RX_LASTPAREN(rx);
1054 goto do_numbuf_fetch;
1056 sv_setsv(sv,&PL_sv_undef);
1058 case '\016': /* ^N */
1059 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1060 paren = RX_LASTCLOSEPAREN(rx);
1062 goto do_numbuf_fetch;
1064 sv_setsv(sv,&PL_sv_undef);
1067 if (GvIO(PL_last_in_gv)) {
1068 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
1073 sv_setiv(sv, (IV)STATUS_CURRENT);
1074 #ifdef COMPLEX_STATUS
1075 SvUPGRADE(sv, SVt_PVLV);
1076 LvTARGOFF(sv) = PL_statusvalue;
1077 LvTARGLEN(sv) = PL_statusvalue_vms;
1082 if (GvIOp(PL_defoutgv))
1083 s = IoTOP_NAME(GvIOp(PL_defoutgv));
1087 sv_setpv(sv,GvENAME(PL_defoutgv));
1088 sv_catpvs(sv,"_TOP");
1092 if (GvIOp(PL_defoutgv))
1093 s = IoFMT_NAME(GvIOp(PL_defoutgv));
1095 s = GvENAME(PL_defoutgv);
1099 if (GvIO(PL_defoutgv))
1100 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
1103 if (GvIO(PL_defoutgv))
1104 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
1107 if (GvIO(PL_defoutgv))
1108 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
1117 if (GvIO(PL_defoutgv))
1118 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
1122 sv_copypv(sv, PL_ors_sv);
1124 sv_setsv(sv, &PL_sv_undef);
1128 IV const pid = (IV)PerlProc_getpid();
1129 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid) {
1130 /* never set manually, or at least not since last fork */
1132 /* never unsafe, even if reading in a tainted expression */
1135 /* else a value has been assigned manually, so do nothing */
1139 sv_setuid(sv, PerlProc_getuid());
1142 sv_setuid(sv, PerlProc_geteuid());
1145 sv_setgid(sv, PerlProc_getgid());
1148 sv_setgid(sv, PerlProc_getegid());
1150 #ifdef HAS_GETGROUPS
1152 Groups_t *gary = NULL;
1154 I32 num_groups = getgroups(0, gary);
1155 if (num_groups > 0) {
1156 Newx(gary, num_groups, Groups_t);
1157 num_groups = getgroups(num_groups, gary);
1158 for (i = 0; i < num_groups; i++)
1159 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1163 (void)SvIOK_on(sv); /* what a wonderful hack! */
1173 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
1175 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
1177 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1179 if (uf && uf->uf_val)
1180 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
1185 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
1187 STRLEN len = 0, klen;
1188 const char * const key = MgPV_const(mg,klen);
1191 PERL_ARGS_ASSERT_MAGIC_SETENV;
1195 /* defined environment variables are byte strings; unfortunately
1196 there is no SvPVbyte_force_nomg(), so we must do this piecewise */
1197 (void)SvPV_force_nomg_nolen(sv);
1198 sv_utf8_downgrade(sv, /* fail_ok */ TRUE);
1200 Perl_ck_warner_d(aTHX_ packWARN(WARN_UTF8), "Wide character in %s", "setenv");
1206 my_setenv(key, s); /* does the deed */
1208 #ifdef DYNAMIC_ENV_FETCH
1209 /* We just undefd an environment var. Is a replacement */
1210 /* waiting in the wings? */
1212 SV ** const valp = hv_fetch(GvHVn(PL_envgv), key, klen, FALSE);
1214 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
1218 #if !defined(OS2) && !defined(WIN32) && !defined(MSDOS)
1219 /* And you'll never guess what the dog had */
1220 /* in its mouth... */
1222 MgTAINTEDDIR_off(mg);
1224 if (s && klen == 8 && strEQ(key, "DCL$PATH")) {
1225 char pathbuf[256], eltbuf[256], *cp, *elt;
1228 my_strlcpy(eltbuf, s, sizeof(eltbuf));
1230 do { /* DCL$PATH may be a search list */
1231 while (1) { /* as may dev portion of any element */
1232 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1233 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1234 cando_by_name(S_IWUSR,0,elt) ) {
1235 MgTAINTEDDIR_on(mg);
1239 if ((cp = strchr(elt, ':')) != NULL)
1241 if (my_trnlnm(elt, eltbuf, j++))
1247 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1250 if (s && klen == 4 && strEQ(key,"PATH")) {
1251 const char * const strend = s + len;
1253 while (s < strend) {
1257 #ifdef VMS /* Hmm. How do we get $Config{path_sep} from C? */
1258 const char path_sep = '|';
1260 const char path_sep = ':';
1262 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
1263 s, strend, path_sep, &i);
1265 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
1267 || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1269 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1271 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1272 MgTAINTEDDIR_on(mg);
1278 #endif /* neither OS2 nor WIN32 nor MSDOS */
1284 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1286 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
1287 PERL_UNUSED_ARG(sv);
1288 my_setenv(MgPV_nolen_const(mg),NULL);
1293 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1295 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
1296 PERL_UNUSED_ARG(mg);
1298 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1300 if (PL_localizing) {
1303 hv_iterinit(MUTABLE_HV(sv));
1304 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
1306 my_setenv(hv_iterkey(entry, &keylen),
1307 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
1315 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1317 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
1318 PERL_UNUSED_ARG(sv);
1319 PERL_UNUSED_ARG(mg);
1321 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1329 #ifdef HAS_SIGPROCMASK
1331 restore_sigmask(pTHX_ SV *save_sv)
1333 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1334 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
1338 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1340 /* Are we fetching a signal entry? */
1341 int i = (I16)mg->mg_private;
1343 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1347 const char * sig = MgPV_const(mg, siglen);
1348 mg->mg_private = i = whichsig_pvn(sig, siglen);
1353 sv_setsv(sv,PL_psig_ptr[i]);
1355 Sighandler_t sigstate = rsignal_state(i);
1356 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1357 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1360 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1361 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1364 /* cache state so we don't fetch it again */
1365 if(sigstate == (Sighandler_t) SIG_IGN)
1366 sv_setpvs(sv,"IGNORE");
1368 sv_setsv(sv,&PL_sv_undef);
1369 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1376 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1378 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
1380 magic_setsig(NULL, mg);
1381 return sv_unmagic(sv, mg->mg_type);
1385 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1386 Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
1388 Perl_csighandler(int sig)
1391 #ifdef PERL_GET_SIG_CONTEXT
1392 dTHXa(PERL_GET_SIG_CONTEXT);
1396 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1397 #if defined(__cplusplus) && defined(__GNUC__)
1398 /* g++ doesn't support PERL_UNUSED_DECL, so the sip and uap
1399 * parameters would be warned about. */
1400 PERL_UNUSED_ARG(sip);
1401 PERL_UNUSED_ARG(uap);
1404 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1405 (void) rsignal(sig, PL_csighandlerp);
1406 if (PL_sig_ignoring[sig]) return;
1408 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1409 if (PL_sig_defaulting[sig])
1410 #ifdef KILL_BY_SIGPRC
1411 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1426 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
1427 /* Call the perl level handler now--
1428 * with risk we may be in malloc() or being destructed etc. */
1429 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1430 (*PL_sighandlerp)(sig, NULL, NULL);
1432 (*PL_sighandlerp)(sig);
1435 if (!PL_psig_pend) return;
1436 /* Set a flag to say this signal is pending, that is awaiting delivery after
1437 * the current Perl opcode completes */
1438 PL_psig_pend[sig]++;
1440 #ifndef SIG_PENDING_DIE_COUNT
1441 # define SIG_PENDING_DIE_COUNT 120
1443 /* Add one to say _a_ signal is pending */
1444 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1445 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1446 (unsigned long)SIG_PENDING_DIE_COUNT);
1450 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1452 Perl_csighandler_init(void)
1455 if (PL_sig_handlers_initted) return;
1457 for (sig = 1; sig < SIG_SIZE; sig++) {
1458 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1460 PL_sig_defaulting[sig] = 1;
1461 (void) rsignal(sig, PL_csighandlerp);
1463 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1464 PL_sig_ignoring[sig] = 0;
1467 PL_sig_handlers_initted = 1;
1471 #if defined HAS_SIGPROCMASK
1473 unblock_sigmask(pTHX_ void* newset)
1475 PERL_UNUSED_CONTEXT;
1476 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1481 Perl_despatch_signals(pTHX)
1485 for (sig = 1; sig < SIG_SIZE; sig++) {
1486 if (PL_psig_pend[sig]) {
1488 #ifdef HAS_SIGPROCMASK
1489 /* From sigaction(2) (FreeBSD man page):
1490 * | Signal routines normally execute with the signal that
1491 * | caused their invocation blocked, but other signals may
1493 * Emulation of this behavior (from within Perl) is enabled
1497 sigset_t newset, oldset;
1499 sigemptyset(&newset);
1500 sigaddset(&newset, sig);
1501 sigprocmask(SIG_BLOCK, &newset, &oldset);
1502 was_blocked = sigismember(&oldset, sig);
1504 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1506 SAVEFREESV(save_sv);
1507 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1510 PL_psig_pend[sig] = 0;
1511 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1512 (*PL_sighandlerp)(sig, NULL, NULL);
1514 (*PL_sighandlerp)(sig);
1516 #ifdef HAS_SIGPROCMASK
1525 /* sv of NULL signifies that we're acting as magic_clearsig. */
1527 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1532 /* Need to be careful with SvREFCNT_dec(), because that can have side
1533 * effects (due to closures). We must make sure that the new disposition
1534 * is in place before it is called.
1538 #ifdef HAS_SIGPROCMASK
1542 const char *s = MgPV_const(mg,len);
1544 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1547 if (memEQs(s, len, "__DIE__"))
1549 else if (memEQs(s, len, "__WARN__")
1550 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1551 /* Merge the existing behaviours, which are as follows:
1552 magic_setsig, we always set svp to &PL_warnhook
1553 (hence we always change the warnings handler)
1554 For magic_clearsig, we don't change the warnings handler if it's
1555 set to the &PL_warnhook. */
1558 SV *tmp = sv_newmortal();
1559 Perl_croak(aTHX_ "No such hook: %s",
1560 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1564 if (*svp != PERL_WARNHOOK_FATAL)
1570 i = (I16)mg->mg_private;
1572 i = whichsig_pvn(s, len); /* ...no, a brick */
1573 mg->mg_private = (U16)i;
1577 SV *tmp = sv_newmortal();
1578 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1579 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1583 #ifdef HAS_SIGPROCMASK
1584 /* Avoid having the signal arrive at a bad time, if possible. */
1587 sigprocmask(SIG_BLOCK, &set, &save);
1589 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1590 SAVEFREESV(save_sv);
1591 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1594 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1595 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1597 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1598 PL_sig_ignoring[i] = 0;
1600 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1601 PL_sig_defaulting[i] = 0;
1603 to_dec = PL_psig_ptr[i];
1605 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1606 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1608 /* Signals don't change name during the program's execution, so once
1609 they're cached in the appropriate slot of PL_psig_name, they can
1612 Ideally we'd find some way of making SVs at (C) compile time, or
1613 at least, doing most of the work. */
1614 if (!PL_psig_name[i]) {
1615 PL_psig_name[i] = newSVpvn(s, len);
1616 SvREADONLY_on(PL_psig_name[i]);
1619 SvREFCNT_dec(PL_psig_name[i]);
1620 PL_psig_name[i] = NULL;
1621 PL_psig_ptr[i] = NULL;
1624 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1626 (void)rsignal(i, PL_csighandlerp);
1629 *svp = SvREFCNT_inc_simple_NN(sv);
1631 if (sv && SvOK(sv)) {
1632 s = SvPV_force(sv, len);
1636 if (sv && memEQs(s, len,"IGNORE")) {
1638 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1639 PL_sig_ignoring[i] = 1;
1640 (void)rsignal(i, PL_csighandlerp);
1642 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1646 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
1648 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1649 PL_sig_defaulting[i] = 1;
1650 (void)rsignal(i, PL_csighandlerp);
1652 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1658 * We should warn if HINT_STRICT_REFS, but without
1659 * access to a known hint bit in a known OP, we can't
1660 * tell whether HINT_STRICT_REFS is in force or not.
1662 if (!strchr(s,':') && !strchr(s,'\''))
1663 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1666 (void)rsignal(i, PL_csighandlerp);
1668 *svp = SvREFCNT_inc_simple_NN(sv);
1672 #ifdef HAS_SIGPROCMASK
1676 SvREFCNT_dec(to_dec);
1679 #endif /* !PERL_MICRO */
1682 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1684 PERL_ARGS_ASSERT_MAGIC_SETISA;
1685 PERL_UNUSED_ARG(sv);
1687 /* Skip _isaelem because _isa will handle it shortly */
1688 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
1691 return magic_clearisa(NULL, mg);
1694 /* sv of NULL signifies that we're acting as magic_setisa. */
1696 Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1699 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1701 /* Bail out if destruction is going on */
1702 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
1705 av_clear(MUTABLE_AV(sv));
1707 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1708 /* This occurs with setisa_elem magic, which calls this
1710 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1713 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1714 SV **svp = AvARRAY((AV *)mg->mg_obj);
1715 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1717 stash = GvSTASH((GV *)*svp++);
1718 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1725 (const GV *)mg->mg_obj
1728 /* The stash may have been detached from the symbol table, so check its
1729 name before doing anything. */
1730 if (stash && HvENAME_get(stash))
1731 mro_isa_changed_in(stash);
1737 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1739 HV * const hv = MUTABLE_HV(LvTARG(sv));
1742 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
1743 PERL_UNUSED_ARG(mg);
1746 (void) hv_iterinit(hv);
1747 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1750 while (hv_iternext(hv))
1755 sv_setiv(sv, (IV)i);
1760 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1762 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
1763 PERL_UNUSED_ARG(mg);
1765 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
1771 =for apidoc magic_methcall
1773 Invoke a magic method (like FETCH).
1775 C<sv> and C<mg> are the tied thingy and the tie magic.
1777 C<meth> is the name of the method to call.
1779 C<argc> is the number of args (in addition to $self) to pass to the method.
1781 The C<flags> can be:
1783 G_DISCARD invoke method with G_DISCARD flag and don't
1785 G_UNDEF_FILL fill the stack with argc pointers to
1788 The arguments themselves are any values following the C<flags> argument.
1790 Returns the SV (if any) returned by the method, or C<NULL> on failure.
1797 Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
1803 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1807 if (flags & G_WRITING_TO_STDERR) {
1811 SAVESPTR(PL_stderrgv);
1815 PUSHSTACKi(PERLSI_MAGIC);
1818 /* EXTEND() expects a signed argc; don't wrap when casting */
1819 assert(argc <= I32_MAX);
1820 EXTEND(SP, (I32)argc+1);
1821 PUSHs(SvTIED_obj(sv, mg));
1822 if (flags & G_UNDEF_FILL) {
1824 PUSHs(&PL_sv_undef);
1826 } else if (argc > 0) {
1828 va_start(args, argc);
1831 SV *const sv = va_arg(args, SV *);
1838 if (flags & G_DISCARD) {
1839 call_sv(meth, G_SCALAR|G_DISCARD|G_METHOD_NAMED);
1842 if (call_sv(meth, G_SCALAR|G_METHOD_NAMED))
1843 ret = *PL_stack_sp--;
1846 if (flags & G_WRITING_TO_STDERR)
1852 /* wrapper for magic_methcall that creates the first arg */
1855 S_magic_methcall1(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
1860 PERL_ARGS_ASSERT_MAGIC_METHCALL1;
1863 if (mg->mg_len >= 0) {
1864 arg1 = newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
1866 else if (mg->mg_len == HEf_SVKEY)
1867 arg1 = MUTABLE_SV(mg->mg_ptr);
1869 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1870 arg1 = newSViv((IV)(mg->mg_len));
1874 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n - 1, val);
1876 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n, arg1, val);
1880 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, SV *meth)
1884 PERL_ARGS_ASSERT_MAGIC_METHPACK;
1886 ret = magic_methcall1(sv, mg, meth, 0, 1, NULL);
1893 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1895 PERL_ARGS_ASSERT_MAGIC_GETPACK;
1897 if (mg->mg_type == PERL_MAGIC_tiedelem)
1898 mg->mg_flags |= MGf_GSKIP;
1899 magic_methpack(sv,mg,SV_CONST(FETCH));
1904 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1909 PERL_ARGS_ASSERT_MAGIC_SETPACK;
1911 /* in the code C<$tied{foo} = $val>, the "thing" that gets passed to
1912 * STORE() is not $val, but rather a PVLV (the sv in this call), whose
1913 * public flags indicate its value based on copying from $val. Doing
1914 * mg_set() on the PVLV temporarily does SvMAGICAL_off(), then calls us.
1915 * So STORE()'s $_[2] arg is a temporarily disarmed PVLV. This goes
1916 * wrong if $val happened to be tainted, as sv hasn't got magic
1917 * enabled, even though taint magic is in the chain. In which case,
1918 * fake up a temporary tainted value (this is easier than temporarily
1919 * re-enabling magic on sv). */
1921 if (TAINTING_get && (tmg = mg_find(sv, PERL_MAGIC_taint))
1922 && (tmg->mg_len & 1))
1924 val = sv_mortalcopy(sv);
1930 magic_methcall1(sv, mg, SV_CONST(STORE), G_DISCARD, 2, val);
1935 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1937 PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1939 if (mg->mg_type == PERL_MAGIC_tiedscalar) return 0;
1940 return magic_methpack(sv,mg,SV_CONST(DELETE));
1945 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1950 PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1952 retsv = magic_methcall1(sv, mg, SV_CONST(FETCHSIZE), 0, 1, NULL);
1954 retval = SvIV(retsv)-1;
1956 Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
1958 return (U32) retval;
1962 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1964 PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1966 Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(CLEAR), G_DISCARD, 0);
1971 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1975 PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1977 ret = SvOK(key) ? Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(NEXTKEY), 0, 1, key)
1978 : Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(FIRSTKEY), 0, 0);
1985 Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
1987 PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1989 return magic_methpack(sv,mg,SV_CONST(EXISTS));
1993 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1996 SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1997 HV * const pkg = SvSTASH((const SV *)SvRV(tied));
1999 PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
2001 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
2003 if (HvEITER_get(hv))
2004 /* we are in an iteration so the hash cannot be empty */
2006 /* no xhv_eiter so now use FIRSTKEY */
2007 key = sv_newmortal();
2008 magic_nextpack(MUTABLE_SV(hv), mg, key);
2009 HvEITER_set(hv, NULL); /* need to reset iterator */
2010 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
2013 /* there is a SCALAR method that we can call */
2014 retval = Perl_magic_methcall(aTHX_ MUTABLE_SV(hv), mg, SV_CONST(SCALAR), 0, 0);
2016 retval = &PL_sv_undef;
2021 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
2025 PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
2027 /* The magic ptr/len for the debugger's hash should always be an SV. */
2028 if (UNLIKELY(mg->mg_len != HEf_SVKEY)) {
2029 Perl_croak(aTHX_ "panic: magic_setdbline len=%"IVdf", ptr='%s'",
2030 (IV)mg->mg_len, mg->mg_ptr);
2033 /* Use sv_2iv instead of SvIV() as the former generates smaller code, and
2034 setting/clearing debugger breakpoints is not a hot path. */
2035 svp = av_fetch(MUTABLE_AV(mg->mg_obj),
2036 sv_2iv(MUTABLE_SV((mg)->mg_ptr)), FALSE);
2038 if (svp && SvIOKp(*svp)) {
2039 OP * const o = INT2PTR(OP*,SvIVX(*svp));
2041 #ifdef PERL_DEBUG_READONLY_OPS
2042 Slab_to_rw(OpSLAB(o));
2044 /* set or clear breakpoint in the relevant control op */
2046 o->op_flags |= OPf_SPECIAL;
2048 o->op_flags &= ~OPf_SPECIAL;
2049 #ifdef PERL_DEBUG_READONLY_OPS
2050 Slab_to_ro(OpSLAB(o));
2058 Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
2060 AV * const obj = MUTABLE_AV(mg->mg_obj);
2062 PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
2065 sv_setiv(sv, AvFILL(obj));
2073 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
2075 AV * const obj = MUTABLE_AV(mg->mg_obj);
2077 PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
2080 av_fill(obj, SvIV(sv));
2082 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
2083 "Attempt to set length of freed array");
2089 Perl_magic_cleararylen_p(pTHX_ SV *sv, MAGIC *mg)
2091 PERL_ARGS_ASSERT_MAGIC_CLEARARYLEN_P;
2092 PERL_UNUSED_ARG(sv);
2093 PERL_UNUSED_CONTEXT;
2095 /* Reset the iterator when the array is cleared */
2096 #if IVSIZE == I32SIZE
2097 *((IV *) &(mg->mg_len)) = 0;
2100 *((IV *) mg->mg_ptr) = 0;
2107 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
2109 PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
2110 PERL_UNUSED_ARG(sv);
2112 /* during global destruction, mg_obj may already have been freed */
2113 if (PL_in_clean_all)
2116 mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
2119 /* arylen scalar holds a pointer back to the array, but doesn't own a
2120 reference. Hence the we (the array) are about to go away with it
2121 still pointing at us. Clear its pointer, else it would be pointing
2122 at free memory. See the comment in sv_magic about reference loops,
2123 and why it can't own a reference to us. */
2130 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
2132 SV* const lsv = LvTARG(sv);
2133 MAGIC * const found = mg_find_mglob(lsv);
2135 PERL_ARGS_ASSERT_MAGIC_GETPOS;
2136 PERL_UNUSED_ARG(mg);
2138 if (found && found->mg_len != -1) {
2139 STRLEN i = found->mg_len;
2140 if (found->mg_flags & MGf_BYTES && DO_UTF8(lsv))
2141 i = sv_pos_b2u_flags(lsv, i, SV_GMAGIC|SV_CONST_RETURN);
2150 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
2152 SV* const lsv = LvTARG(sv);
2159 PERL_ARGS_ASSERT_MAGIC_SETPOS;
2160 PERL_UNUSED_ARG(mg);
2162 found = mg_find_mglob(lsv);
2166 found = sv_magicext_mglob(lsv);
2168 else if (!SvOK(sv)) {
2172 s = SvPV_const(lsv, len);
2177 ulen = sv_or_pv_len_utf8(lsv, s, len);
2187 else if (pos > (SSize_t)len)
2190 found->mg_len = pos;
2191 found->mg_flags &= ~(MGf_MINMATCH|MGf_BYTES);
2197 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
2200 SV * const lsv = LvTARG(sv);
2201 const char * const tmps = SvPV_const(lsv,len);
2202 STRLEN offs = LvTARGOFF(sv);
2203 STRLEN rem = LvTARGLEN(sv);
2204 const bool negoff = LvFLAGS(sv) & 1;
2205 const bool negrem = LvFLAGS(sv) & 2;
2207 PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2208 PERL_UNUSED_ARG(mg);
2210 if (!translate_substr_offsets(
2211 SvUTF8(lsv) ? sv_or_pv_len_utf8(lsv, tmps, len) : len,
2212 negoff ? -(IV)offs : (IV)offs, !negoff,
2213 negrem ? -(IV)rem : (IV)rem, !negrem, &offs, &rem
2215 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR), "substr outside of string");
2216 sv_setsv_nomg(sv, &PL_sv_undef);
2221 offs = sv_or_pv_pos_u2b(lsv, tmps, offs, &rem);
2222 sv_setpvn(sv, tmps + offs, rem);
2229 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2231 STRLEN len, lsv_len, oldtarglen, newtarglen;
2232 const char * const tmps = SvPV_const(sv, len);
2233 SV * const lsv = LvTARG(sv);
2234 STRLEN lvoff = LvTARGOFF(sv);
2235 STRLEN lvlen = LvTARGLEN(sv);
2236 const bool negoff = LvFLAGS(sv) & 1;
2237 const bool neglen = LvFLAGS(sv) & 2;
2239 PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2240 PERL_UNUSED_ARG(mg);
2244 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR),
2245 "Attempt to use reference as lvalue in substr"
2247 SvPV_force_nomg(lsv,lsv_len);
2248 if (SvUTF8(lsv)) lsv_len = sv_len_utf8_nomg(lsv);
2249 if (!translate_substr_offsets(
2251 negoff ? -(IV)lvoff : (IV)lvoff, !negoff,
2252 neglen ? -(IV)lvlen : (IV)lvlen, !neglen, &lvoff, &lvlen
2254 Perl_croak(aTHX_ "substr outside of string");
2257 sv_utf8_upgrade_nomg(lsv);
2258 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2259 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2260 newtarglen = sv_or_pv_len_utf8(sv, tmps, len);
2263 else if (SvUTF8(lsv)) {
2265 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2267 utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2268 sv_insert_flags(lsv, lvoff, lvlen, utf8, len, 0);
2272 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2275 if (!neglen) LvTARGLEN(sv) = newtarglen;
2276 if (negoff) LvTARGOFF(sv) += newtarglen - oldtarglen;
2282 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2284 PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2285 PERL_UNUSED_ARG(sv);
2286 #ifdef NO_TAINT_SUPPORT
2287 PERL_UNUSED_ARG(mg);
2290 TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1) && IN_PERL_RUNTIME);
2295 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2297 PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2298 PERL_UNUSED_ARG(sv);
2300 /* update taint status */
2309 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2311 SV * const lsv = LvTARG(sv);
2313 PERL_ARGS_ASSERT_MAGIC_GETVEC;
2314 PERL_UNUSED_ARG(mg);
2316 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2322 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2324 PERL_ARGS_ASSERT_MAGIC_SETVEC;
2325 PERL_UNUSED_ARG(mg);
2326 do_vecset(sv); /* XXX slurp this routine */
2331 Perl_defelem_target(pTHX_ SV *sv, MAGIC *mg)
2334 PERL_ARGS_ASSERT_DEFELEM_TARGET;
2335 if (!mg) mg = mg_find(sv, PERL_MAGIC_defelem);
2337 if (LvTARGLEN(sv)) {
2339 SV * const ahv = LvTARG(sv);
2340 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2344 else if (LvSTARGOFF(sv) >= 0) {
2345 AV *const av = MUTABLE_AV(LvTARG(sv));
2346 if (LvSTARGOFF(sv) <= AvFILL(av))
2348 if (SvRMAGICAL(av)) {
2349 SV * const * const svp = av_fetch(av, LvSTARGOFF(sv), 0);
2350 targ = svp ? *svp : NULL;
2353 targ = AvARRAY(av)[LvSTARGOFF(sv)];
2356 if (targ && (targ != &PL_sv_undef)) {
2357 /* somebody else defined it for us */
2358 SvREFCNT_dec(LvTARG(sv));
2359 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2361 SvREFCNT_dec(mg->mg_obj);
2363 mg->mg_flags &= ~MGf_REFCOUNTED;
2372 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2374 PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2376 sv_setsv(sv, defelem_target(sv, mg));
2381 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2383 PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2384 PERL_UNUSED_ARG(mg);
2388 sv_setsv(LvTARG(sv), sv);
2389 SvSETMAGIC(LvTARG(sv));
2395 Perl_vivify_defelem(pTHX_ SV *sv)
2400 PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2402 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2405 SV * const ahv = LvTARG(sv);
2406 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2409 if (!value || value == &PL_sv_undef)
2410 Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2412 else if (LvSTARGOFF(sv) < 0)
2413 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
2415 AV *const av = MUTABLE_AV(LvTARG(sv));
2416 if ((I32)LvTARGLEN(sv) < 0 && LvSTARGOFF(sv) > AvFILL(av))
2417 LvTARG(sv) = NULL; /* array can't be extended */
2419 SV* const * const svp = av_fetch(av, LvSTARGOFF(sv), TRUE);
2420 if (!svp || !(value = *svp))
2421 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
2424 SvREFCNT_inc_simple_void(value);
2425 SvREFCNT_dec(LvTARG(sv));
2428 SvREFCNT_dec(mg->mg_obj);
2430 mg->mg_flags &= ~MGf_REFCOUNTED;
2434 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2436 PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2437 Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2442 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2444 PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2445 PERL_UNUSED_CONTEXT;
2446 PERL_UNUSED_ARG(sv);
2452 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2454 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2456 PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2458 if (uf && uf->uf_set)
2459 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2464 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2466 const char type = mg->mg_type;
2468 PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2470 if (type == PERL_MAGIC_qr) {
2471 } else if (type == PERL_MAGIC_bm) {
2475 assert(type == PERL_MAGIC_fm);
2477 return sv_unmagic(sv, type);
2480 #ifdef USE_LOCALE_COLLATE
2482 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2484 PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2487 * RenE<eacute> Descartes said "I think not."
2488 * and vanished with a faint plop.
2490 PERL_UNUSED_CONTEXT;
2491 PERL_UNUSED_ARG(sv);
2493 Safefree(mg->mg_ptr);
2499 #endif /* USE_LOCALE_COLLATE */
2501 /* Just clear the UTF-8 cache data. */
2503 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2505 PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2506 PERL_UNUSED_CONTEXT;
2507 PERL_UNUSED_ARG(sv);
2508 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
2510 mg->mg_len = -1; /* The mg_len holds the len cache. */
2515 Perl_magic_setlvref(pTHX_ SV *sv, MAGIC *mg)
2517 const char *bad = NULL;
2518 PERL_ARGS_ASSERT_MAGIC_SETLVREF;
2519 if (!SvROK(sv)) Perl_croak(aTHX_ "Assigned value is not a reference");
2520 switch (mg->mg_private & OPpLVREF_TYPE) {
2522 if (SvTYPE(SvRV(sv)) > SVt_PVLV)
2526 if (SvTYPE(SvRV(sv)) != SVt_PVAV)
2530 if (SvTYPE(SvRV(sv)) != SVt_PVHV)
2534 if (SvTYPE(SvRV(sv)) != SVt_PVCV)
2538 /* diag_listed_as: Assigned value is not %s reference */
2539 Perl_croak(aTHX_ "Assigned value is not a%s reference", bad);
2540 switch (mg->mg_obj ? SvTYPE(mg->mg_obj) : 0) {
2543 SV * const old = PAD_SV(mg->mg_len);
2544 PAD_SETSV(mg->mg_len, SvREFCNT_inc_NN(SvRV(sv)));
2549 gv_setref(mg->mg_obj, sv);
2550 SvSETMAGIC(mg->mg_obj);
2553 av_store((AV *)mg->mg_obj, SvIV((SV *)mg->mg_ptr),
2554 SvREFCNT_inc_simple_NN(SvRV(sv)));
2557 (void)hv_store_ent((HV *)mg->mg_obj, (SV *)mg->mg_ptr,
2558 SvREFCNT_inc_simple_NN(SvRV(sv)), 0);
2560 if (mg->mg_flags & MGf_PERSIST)
2561 NOOP; /* This sv is in use as an iterator var and will be reused,
2562 so we must leave the magic. */
2564 /* This sv could be returned by the assignment op, so clear the
2565 magic, as lvrefs are an implementation detail that must not be
2566 leaked to the user. */
2567 sv_unmagic(sv, PERL_MAGIC_lvref);
2572 S_set_dollarzero(pTHX_ SV *sv)
2573 PERL_TSA_REQUIRES(PL_dollarzero_mutex)
2580 #ifdef HAS_SETPROCTITLE
2581 /* The BSDs don't show the argv[] in ps(1) output, they
2582 * show a string from the process struct and provide
2583 * the setproctitle() routine to manipulate that. */
2584 if (PL_origalen != 1) {
2585 s = SvPV_const(sv, len);
2586 # if __FreeBSD_version > 410001
2587 /* The leading "-" removes the "perl: " prefix,
2588 * but not the "(perl) suffix from the ps(1)
2589 * output, because that's what ps(1) shows if the
2590 * argv[] is modified. */
2591 setproctitle("-%s", s);
2592 # else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2593 /* This doesn't really work if you assume that
2594 * $0 = 'foobar'; will wipe out 'perl' from the $0
2595 * because in ps(1) output the result will be like
2596 * sprintf("perl: %s (perl)", s)
2597 * I guess this is a security feature:
2598 * one (a user process) cannot get rid of the original name.
2600 setproctitle("%s", s);
2603 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2604 if (PL_origalen != 1) {
2606 s = SvPV_const(sv, len);
2607 un.pst_command = (char *)s;
2608 pstat(PSTAT_SETCMD, un, len, 0, 0);
2611 if (PL_origalen > 1) {
2613 /* PL_origalen is set in perl_parse(). */
2614 s = SvPV_force(sv,len);
2615 if (len >= (STRLEN)PL_origalen-1) {
2616 /* Longer than original, will be truncated. We assume that
2617 * PL_origalen bytes are available. */
2618 Copy(s, PL_origargv[0], PL_origalen-1, char);
2621 /* Shorter than original, will be padded. */
2623 /* Special case for Mac OS X: see [perl #38868] */
2626 /* Is the space counterintuitive? Yes.
2627 * (You were expecting \0?)
2628 * Does it work? Seems to. (In Linux 2.4.20 at least.)
2630 const int pad = ' ';
2632 Copy(s, PL_origargv[0], len, char);
2633 PL_origargv[0][len] = 0;
2634 memset(PL_origargv[0] + len + 1,
2635 pad, PL_origalen - len - 1);
2637 PL_origargv[0][PL_origalen-1] = 0;
2638 for (i = 1; i < PL_origargc; i++)
2640 #ifdef HAS_PRCTL_SET_NAME
2641 /* Set the legacy process name in addition to the POSIX name on Linux */
2642 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
2643 /* diag_listed_as: SKIPME */
2644 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
2652 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2663 PERL_ARGS_ASSERT_MAGIC_SET;
2667 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2669 CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2671 /* Croak with a READONLY error when a numbered match var is
2672 * set without a previous pattern match. Unless it's C<local $1>
2675 if (!PL_localizing) {
2676 Perl_croak_no_modify();
2682 switch (*mg->mg_ptr) {
2683 case '\001': /* ^A */
2684 if (SvOK(sv)) sv_copypv(PL_bodytarget, sv);
2685 else SvOK_off(PL_bodytarget);
2686 FmLINES(PL_bodytarget) = 0;
2687 if (SvPOK(PL_bodytarget)) {
2688 char *s = SvPVX(PL_bodytarget);
2689 while ( ((s = strchr(s, '\n'))) ) {
2690 FmLINES(PL_bodytarget)++;
2694 /* mg_set() has temporarily made sv non-magical */
2696 if ((tmg = mg_find(sv,PERL_MAGIC_taint)) && tmg->mg_len & 1)
2697 SvTAINTED_on(PL_bodytarget);
2699 SvTAINTED_off(PL_bodytarget);
2702 case '\003': /* ^C */
2703 PL_minus_c = cBOOL(SvIV(sv));
2706 case '\004': /* ^D */
2709 const char *s = SvPV_nolen_const(sv);
2710 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2711 if (DEBUG_x_TEST || DEBUG_B_TEST)
2712 dump_all_perl(!DEBUG_B_TEST);
2715 PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
2718 case '\005': /* ^E */
2719 if (*(mg->mg_ptr+1) == '\0') {
2721 set_vaxc_errno(SvIV(sv));
2724 SetLastError( SvIV(sv) );
2727 os2_setsyserrno(SvIV(sv));
2729 /* will anyone ever use this? */
2730 SETERRNO(SvIV(sv), 4);
2736 unsigned int offset = 1;
2739 /* It may be the shadow variable ${E_NCODING} which has lexical
2740 * scope. See comments at Perl__get_encoding in this file */
2741 if (*(mg->mg_ptr + 1) == '_') {
2742 if (CopSTASH(PL_curcop) != get_hv("encoding::",0))
2743 Perl_croak_no_modify();
2747 if (strEQ(mg->mg_ptr + offset, "NCODING")) {
2748 if (lex) { /* Use the shadow global */
2749 SvREFCNT_dec(PL_lex_encoding);
2750 if (SvOK(sv) || SvGMAGICAL(sv)) {
2751 PL_lex_encoding = newSVsv(sv);
2754 PL_lex_encoding = NULL;
2757 else { /* Use the regular global */
2758 SvREFCNT_dec(PL_encoding);
2759 if (SvOK(sv) || SvGMAGICAL(sv)) {
2760 if (PL_localizing != 2) {
2761 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
2762 "Setting ${^ENCODING} is deprecated");
2764 PL_encoding = newSVsv(sv);
2773 case '\006': /* ^F */
2774 PL_maxsysfd = SvIV(sv);
2776 case '\010': /* ^H */
2777 PL_hints = SvIV(sv);
2779 case '\011': /* ^I */ /* NOT \t in EBCDIC */
2780 Safefree(PL_inplace);
2781 PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2783 case '\016': /* ^N */
2784 if (PL_curpm && (rx = PM_GETRE(PL_curpm))
2785 && (paren = RX_LASTCLOSEPAREN(rx))) goto setparen_got_rx;
2787 case '\017': /* ^O */
2788 if (*(mg->mg_ptr+1) == '\0') {
2789 Safefree(PL_osname);
2792 TAINT_PROPER("assigning to $^O");
2793 PL_osname = savesvpv(sv);
2796 else if (strEQ(mg->mg_ptr, "\017PEN")) {
2798 const char *const start = SvPV(sv, len);
2799 const char *out = (const char*)memchr(start, '\0', len);
2803 PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2804 PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2806 /* Opening for input is more common than opening for output, so
2807 ensure that hints for input are sooner on linked list. */
2808 tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2810 : newSVpvs_flags("", SvUTF8(sv));
2811 (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2814 tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2816 (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2820 case '\020': /* ^P */
2821 PL_perldb = SvIV(sv);
2822 if (PL_perldb && !PL_DBsingle)
2825 case '\024': /* ^T */
2827 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2829 PL_basetime = (Time_t)SvIV(sv);
2832 case '\025': /* ^UTF8CACHE */
2833 if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2834 PL_utf8cache = (signed char) sv_2iv(sv);
2837 case '\027': /* ^W & $^WARNING_BITS */
2838 if (*(mg->mg_ptr+1) == '\0') {
2839 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2841 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2842 | (i ? G_WARN_ON : G_WARN_OFF) ;
2845 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2846 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2848 PL_compiling.cop_warnings = pWARN_STD;
2853 int accumulate = 0 ;
2854 int any_fatals = 0 ;
2855 const char * const ptr = SvPV_const(sv, len) ;
2856 for (i = 0 ; i < len ; ++i) {
2857 accumulate |= ptr[i] ;
2858 any_fatals |= (ptr[i] & 0xAA) ;
2861 if (!specialWARN(PL_compiling.cop_warnings))
2862 PerlMemShared_free(PL_compiling.cop_warnings);
2863 PL_compiling.cop_warnings = pWARN_NONE;
2865 /* Yuck. I can't see how to abstract this: */
2867 ((STRLEN *)SvPV_nolen_const(sv)) - 1,
2871 if (!specialWARN(PL_compiling.cop_warnings))
2872 PerlMemShared_free(PL_compiling.cop_warnings);
2873 PL_compiling.cop_warnings = pWARN_ALL;
2874 PL_dowarn |= G_WARN_ONCE ;
2878 const char *const p = SvPV_const(sv, len);
2880 PL_compiling.cop_warnings
2881 = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2884 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2885 PL_dowarn |= G_WARN_ONCE ;
2892 else if (strEQ(mg->mg_ptr+1, "IN32_SLOPPY_STAT")) {
2893 w32_sloppystat = (bool)sv_true(sv);
2898 if (PL_localizing) {
2899 if (PL_localizing == 1)
2900 SAVESPTR(PL_last_in_gv);
2902 else if (SvOK(sv) && GvIO(PL_last_in_gv))
2903 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2906 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2907 IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2908 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2911 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2912 IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2913 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2916 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2919 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2920 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2921 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2924 IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2928 IO * const io = GvIO(PL_defoutgv);
2931 if ((SvIV(sv)) == 0)
2932 IoFLAGS(io) &= ~IOf_FLUSH;
2934 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2935 PerlIO *ofp = IoOFP(io);
2937 (void)PerlIO_flush(ofp);
2938 IoFLAGS(io) |= IOf_FLUSH;
2947 SV *referent= SvRV(sv);
2948 const char *reftype= sv_reftype(referent, 0);
2949 /* XXX: dodgy type check: This leaves me feeling dirty, but the alternative
2950 * is to copy pretty much the entire sv_reftype() into this routine, or to do
2951 * a full string comparison on the return of sv_reftype() both of which
2952 * make me feel worse! NOTE, do not modify this comment without reviewing the
2953 * corresponding comment in sv_reftype(). - Yves */
2954 if (reftype[0] == 'S' || reftype[0] == 'L') {
2955 IV val= SvIV(referent);
2957 tmpsv= &PL_sv_undef;
2958 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
2959 "Setting $/ to a reference to %s as a form of slurp is deprecated, treating as undef",
2960 SvIV(SvRV(sv)) < 0 ? "a negative integer" : "zero"
2964 sv_setsv(sv, PL_rs);
2965 /* diag_listed_as: Setting $/ to %s reference is forbidden */
2966 Perl_croak(aTHX_ "Setting $/ to a%s %s reference is forbidden",
2967 *reftype == 'A' ? "n" : "", reftype);
2970 SvREFCNT_dec(PL_rs);
2971 PL_rs = newSVsv(tmpsv);
2975 SvREFCNT_dec(PL_ors_sv);
2977 PL_ors_sv = newSVsv(sv);
2985 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2988 #ifdef COMPLEX_STATUS
2989 if (PL_localizing == 2) {
2990 SvUPGRADE(sv, SVt_PVLV);
2991 PL_statusvalue = LvTARGOFF(sv);
2992 PL_statusvalue_vms = LvTARGLEN(sv);
2996 #ifdef VMSISH_STATUS
2998 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
3001 STATUS_UNIX_EXIT_SET(SvIV(sv));
3006 # define PERL_VMS_BANG vaxc$errno
3008 # define PERL_VMS_BANG 0
3010 #if defined(WIN32) && ! defined(UNDER_CE)
3011 SETERRNO(win32_get_errno(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0),
3012 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
3014 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
3015 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
3021 /* XXX $< currently silently ignores failures */
3022 const Uid_t new_uid = SvUID(sv);
3023 PL_delaymagic_uid = new_uid;
3024 if (PL_delaymagic) {
3025 PL_delaymagic |= DM_RUID;
3026 break; /* don't do magic till later */
3029 PERL_UNUSED_RESULT(setruid(new_uid));
3032 PERL_UNUSED_RESULT(setreuid(new_uid, (Uid_t)-1));
3034 #ifdef HAS_SETRESUID
3035 PERL_UNUSED_RESULT(setresuid(new_uid, (Uid_t)-1, (Uid_t)-1));
3037 if (new_uid == PerlProc_geteuid()) { /* special case $< = $> */
3039 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
3040 if (new_uid != 0 && PerlProc_getuid() == 0)
3041 PERL_UNUSED_RESULT(PerlProc_setuid(0));
3043 PERL_UNUSED_RESULT(PerlProc_setuid(new_uid));
3045 Perl_croak(aTHX_ "setruid() not implemented");
3054 /* XXX $> currently silently ignores failures */
3055 const Uid_t new_euid = SvUID(sv);
3056 PL_delaymagic_euid = new_euid;
3057 if (PL_delaymagic) {
3058 PL_delaymagic |= DM_EUID;
3059 break; /* don't do magic till later */
3062 PERL_UNUSED_RESULT(seteuid(new_euid));
3065 PERL_UNUSED_RESULT(setreuid((Uid_t)-1, new_euid));
3067 #ifdef HAS_SETRESUID
3068 PERL_UNUSED_RESULT(setresuid((Uid_t)-1, new_euid, (Uid_t)-1));
3070 if (new_euid == PerlProc_getuid()) /* special case $> = $< */
3071 PERL_UNUSED_RESULT(PerlProc_setuid(new_euid));
3073 Perl_croak(aTHX_ "seteuid() not implemented");
3082 /* XXX $( currently silently ignores failures */
3083 const Gid_t new_gid = SvGID(sv);
3084 PL_delaymagic_gid = new_gid;
3085 if (PL_delaymagic) {
3086 PL_delaymagic |= DM_RGID;
3087 break; /* don't do magic till later */
3090 PERL_UNUSED_RESULT(setrgid(new_gid));
3093 PERL_UNUSED_RESULT(setregid(new_gid, (Gid_t)-1));
3095 #ifdef HAS_SETRESGID
3096 PERL_UNUSED_RESULT(setresgid(new_gid, (Gid_t)-1, (Gid_t) -1));
3098 if (new_gid == PerlProc_getegid()) /* special case $( = $) */
3099 PERL_UNUSED_RESULT(PerlProc_setgid(new_gid));
3101 Perl_croak(aTHX_ "setrgid() not implemented");
3110 /* (hv) best guess: maybe we'll need configure probes to do a better job,
3111 * but you can override it if you need to.
3114 #define INVALID_GID ((Gid_t)-1)
3116 /* XXX $) currently silently ignores failures */
3118 #ifdef HAS_SETGROUPS
3120 const char *p = SvPV_const(sv, len);
3121 Groups_t *gary = NULL;
3124 #ifdef _SC_NGROUPS_MAX
3125 int maxgrp = sysconf(_SC_NGROUPS_MAX);
3130 int maxgrp = NGROUPS;
3135 if (grok_atoUV(p, &uv, &endptr))
3136 new_egid = (Gid_t)uv;
3138 new_egid = INVALID_GID;
3141 for (i = 0; i < maxgrp; ++i) {
3150 Newx(gary, i + 1, Groups_t);
3152 Renew(gary, i + 1, Groups_t);
3153 if (grok_atoUV(p, &uv, &endptr))
3154 gary[i] = (Groups_t)uv;
3156 gary[i] = INVALID_GID;
3161 PERL_UNUSED_RESULT(setgroups(i, gary));
3164 #else /* HAS_SETGROUPS */
3165 new_egid = SvGID(sv);
3166 #endif /* HAS_SETGROUPS */
3167 PL_delaymagic_egid = new_egid;
3168 if (PL_delaymagic) {
3169 PL_delaymagic |= DM_EGID;
3170 break; /* don't do magic till later */
3173 PERL_UNUSED_RESULT(setegid(new_egid));
3176 PERL_UNUSED_RESULT(setregid((Gid_t)-1, new_egid));
3178 #ifdef HAS_SETRESGID
3179 PERL_UNUSED_RESULT(setresgid((Gid_t)-1, new_egid, (Gid_t)-1));
3181 if (new_egid == PerlProc_getgid()) /* special case $) = $( */
3182 PERL_UNUSED_RESULT(PerlProc_setgid(new_egid));
3184 Perl_croak(aTHX_ "setegid() not implemented");
3192 PL_chopset = SvPV_force(sv,len);
3195 /* Store the pid in mg->mg_obj so we can tell when a fork has
3196 occurred. mg->mg_obj points to *$ by default, so clear it. */
3197 if (isGV(mg->mg_obj)) {
3198 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
3199 SvREFCNT_dec(mg->mg_obj);
3200 mg->mg_flags |= MGf_REFCOUNTED;
3201 mg->mg_obj = newSViv((IV)PerlProc_getpid());
3203 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
3206 LOCK_DOLLARZERO_MUTEX;
3207 S_set_dollarzero(aTHX_ sv);
3208 UNLOCK_DOLLARZERO_MUTEX;
3215 Perl_whichsig_sv(pTHX_ SV *sigsv)
3219 PERL_ARGS_ASSERT_WHICHSIG_SV;
3220 sigpv = SvPV_const(sigsv, siglen);
3221 return whichsig_pvn(sigpv, siglen);
3225 Perl_whichsig_pv(pTHX_ const char *sig)
3227 PERL_ARGS_ASSERT_WHICHSIG_PV;
3228 return whichsig_pvn(sig, strlen(sig));
3232 Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
3236 PERL_ARGS_ASSERT_WHICHSIG_PVN;
3237 PERL_UNUSED_CONTEXT;
3239 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
3240 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
3241 return PL_sig_num[sigv - (char* const*)PL_sig_name];
3243 if (memEQs(sig, len, "CHLD"))
3247 if (memEQs(sig, len, "CLD"))
3254 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3255 Perl_sighandler(int sig, siginfo_t *sip, void *uap)
3257 Perl_sighandler(int sig)
3260 #ifdef PERL_GET_SIG_CONTEXT
3261 dTHXa(PERL_GET_SIG_CONTEXT);
3268 SV * const tSv = PL_Sv;
3272 XPV * const tXpv = PL_Xpv;
3273 I32 old_ss_ix = PL_savestack_ix;
3274 SV *errsv_save = NULL;
3277 if (!PL_psig_ptr[sig]) {
3278 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
3283 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3284 /* Max number of items pushed there is 3*n or 4. We cannot fix
3285 infinity, so we fix 4 (in fact 5): */
3286 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3288 PL_savestack_ix += 5; /* Protect save in progress. */
3289 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3292 /* sv_2cv is too complicated, try a simpler variant first: */
3293 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
3294 || SvTYPE(cv) != SVt_PVCV) {
3296 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
3299 if (!cv || !CvROOT(cv)) {
3300 const HEK * const hek = gv
3304 : cv && CvGV(cv) ? GvENAME_HEK(CvGV(cv)) : NULL;
3306 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3307 "SIG%s handler \"%"HEKf"\" not defined.\n",
3308 PL_sig_name[sig], HEKfARG(hek));
3309 /* diag_listed_as: SIG%s handler "%s" not defined */
3310 else Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3311 "SIG%s handler \"__ANON__\" not defined.\n",
3316 sv = PL_psig_name[sig]
3317 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3318 : newSVpv(PL_sig_name[sig],0);
3322 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3323 /* make sure our assumption about the size of the SAVEs are correct:
3324 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3325 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3328 PUSHSTACKi(PERLSI_SIGNAL);
3331 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3333 struct sigaction oact;
3335 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
3338 SV *rv = newRV_noinc(MUTABLE_SV(sih));
3339 /* The siginfo fields signo, code, errno, pid, uid,
3340 * addr, status, and band are defined by POSIX/SUSv3. */
3341 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3342 (void)hv_stores(sih, "code", newSViv(sip->si_code));
3343 #ifdef HAS_SIGINFO_SI_ERRNO
3344 (void)hv_stores(sih, "errno", newSViv(sip->si_errno));
3346 #ifdef HAS_SIGINFO_SI_STATUS
3347 (void)hv_stores(sih, "status", newSViv(sip->si_status));
3349 #ifdef HAS_SIGINFO_SI_UID
3352 sv_setuid(uid, sip->si_uid);
3353 (void)hv_stores(sih, "uid", uid);
3356 #ifdef HAS_SIGINFO_SI_PID
3357 (void)hv_stores(sih, "pid", newSViv(sip->si_pid));
3359 #ifdef HAS_SIGINFO_SI_ADDR
3360 (void)hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3362 #ifdef HAS_SIGINFO_SI_BAND
3363 (void)hv_stores(sih, "band", newSViv(sip->si_band));
3367 mPUSHp((char *)sip, sizeof(*sip));
3375 errsv_save = newSVsv(ERRSV);
3377 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
3381 SV * const errsv = ERRSV;
3382 if (SvTRUE_NN(errsv)) {
3383 SvREFCNT_dec(errsv_save);
3385 /* Handler "died", for example to get out of a restart-able read().
3386 * Before we re-do that on its behalf re-enable the signal which was
3387 * blocked by the system when we entered.
3389 #ifdef HAS_SIGPROCMASK
3390 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3396 sigaddset(&set,sig);
3397 sigprocmask(SIG_UNBLOCK, &set, NULL);
3400 /* Not clear if this will work */
3401 (void)rsignal(sig, SIG_IGN);
3402 (void)rsignal(sig, PL_csighandlerp);
3404 #endif /* !PERL_MICRO */
3408 sv_setsv(errsv, errsv_save);
3409 SvREFCNT_dec(errsv_save);
3414 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3415 PL_savestack_ix = old_ss_ix;
3417 SvREFCNT_dec_NN(sv);
3418 PL_op = myop; /* Apparently not needed... */
3420 PL_Sv = tSv; /* Restore global temporaries. */
3427 S_restore_magic(pTHX_ const void *p)
3429 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3430 SV* const sv = mgs->mgs_sv;
3436 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
3437 SvTEMP_off(sv); /* if it's still magical, this value isn't temporary */
3439 SvFLAGS(sv) |= mgs->mgs_flags;
3444 bumped = mgs->mgs_bumped;
3445 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3447 /* If we're still on top of the stack, pop us off. (That condition
3448 * will be satisfied if restore_magic was called explicitly, but *not*
3449 * if it's being called via leave_scope.)
3450 * The reason for doing this is that otherwise, things like sv_2cv()
3451 * may leave alloc gunk on the savestack, and some code
3452 * (e.g. sighandler) doesn't expect that...
3454 if (PL_savestack_ix == mgs->mgs_ss_ix)
3456 UV popval = SSPOPUV;
3457 assert(popval == SAVEt_DESTRUCTOR_X);
3458 PL_savestack_ix -= 2;
3460 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3461 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
3464 if (SvREFCNT(sv) == 1) {
3465 /* We hold the last reference to this SV, which implies that the
3466 SV was deleted as a side effect of the routines we called.
3467 So artificially keep it alive a bit longer.
3468 We avoid turning on the TEMP flag, which can cause the SV's
3469 buffer to get stolen (and maybe other stuff). */
3474 SvREFCNT_dec_NN(sv); /* undo the inc in S_save_magic() */
3478 /* clean up the mess created by Perl_sighandler().
3479 * Note that this is only called during an exit in a signal handler;
3480 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
3484 S_unwind_handler_stack(pTHX_ const void *p)
3488 PL_savestack_ix -= 5; /* Unprotect save in progress. */
3492 =for apidoc magic_sethint
3494 Triggered by a store to C<%^H>, records the key/value pair to
3495 C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3496 anything that would need a deep copy. Maybe we should warn if we find a
3502 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3504 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3505 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3507 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3509 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3510 an alternative leaf in there, with PL_compiling.cop_hints being used if
3511 it's NULL. If needed for threads, the alternative could lock a mutex,
3512 or take other more complex action. */
3514 /* Something changed in %^H, so it will need to be restored on scope exit.
3515 Doing this here saves a lot of doing it manually in perl code (and
3516 forgetting to do it, and consequent subtle errors. */
3517 PL_hints |= HINT_LOCALIZE_HH;
3518 CopHINTHASH_set(&PL_compiling,
3519 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
3524 =for apidoc magic_clearhint
3526 Triggered by a delete from C<%^H>, records the key to
3527 C<PL_compiling.cop_hints_hash>.
3532 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3534 PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3535 PERL_UNUSED_ARG(sv);
3537 PL_hints |= HINT_LOCALIZE_HH;
3538 CopHINTHASH_set(&PL_compiling,
3539 mg->mg_len == HEf_SVKEY
3540 ? cophh_delete_sv(CopHINTHASH_get(&PL_compiling),
3541 MUTABLE_SV(mg->mg_ptr), 0, 0)
3542 : cophh_delete_pvn(CopHINTHASH_get(&PL_compiling),
3543 mg->mg_ptr, mg->mg_len, 0, 0));
3548 =for apidoc magic_clearhints
3550 Triggered by clearing C<%^H>, resets C<PL_compiling.cop_hints_hash>.
3555 Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3557 PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3558 PERL_UNUSED_ARG(sv);
3559 PERL_UNUSED_ARG(mg);
3560 cophh_free(CopHINTHASH_get(&PL_compiling));
3561 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
3566 Perl_magic_copycallchecker(pTHX_ SV *sv, MAGIC *mg, SV *nsv,
3567 const char *name, I32 namlen)
3571 PERL_ARGS_ASSERT_MAGIC_COPYCALLCHECKER;
3572 PERL_UNUSED_ARG(sv);
3573 PERL_UNUSED_ARG(name);
3574 PERL_UNUSED_ARG(namlen);
3576 sv_magic(nsv, &PL_sv_undef, mg->mg_type, NULL, 0);
3577 nmg = mg_find(nsv, mg->mg_type);
3579 if (nmg->mg_flags & MGf_REFCOUNTED) SvREFCNT_dec(nmg->mg_obj);
3580 nmg->mg_ptr = mg->mg_ptr;
3581 nmg->mg_obj = SvREFCNT_inc_simple(mg->mg_obj);
3582 nmg->mg_flags |= MGf_REFCOUNTED;
3587 Perl_magic_setdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3588 PERL_ARGS_ASSERT_MAGIC_SETDEBUGVAR;
3590 #if DBVARMG_SINGLE != 0
3591 assert(mg->mg_private >= DBVARMG_SINGLE);
3593 assert(mg->mg_private < DBVARMG_COUNT);
3595 PL_DBcontrol[mg->mg_private] = SvIV_nomg(sv);
3601 Perl_magic_getdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3602 PERL_ARGS_ASSERT_MAGIC_GETDEBUGVAR;
3604 #if DBVARMG_SINGLE != 0
3605 assert(mg->mg_private >= DBVARMG_SINGLE);
3607 assert(mg->mg_private < DBVARMG_COUNT);
3608 sv_setiv(sv, PL_DBcontrol[mg->mg_private]);
3614 * ex: set ts=8 sts=4 sw=4 et: