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
21 "Magic" is special data attached to SV structures in order to give them
22 "magical" properties. When any Perl code tries to read from, or assign to,
23 an SV marked as magical, it calls the 'get' or 'set' function associated
24 with that SV's magic. A get is called prior to reading an SV, in order to
25 give it a chance to update its internal value (get on $. writes the line
26 number of the last read filehandle into to the SV's IV slot), while
27 set is called after an SV has been written to, in order to allow it to make
28 use of its changed value (set on $/ copies the SV's new value to the
29 PL_rs global variable).
31 Magic is implemented as a linked list of MAGIC structures attached to the
32 SV. Each MAGIC struct holds the type of the magic, a pointer to an array
33 of functions that implement the get(), set(), length() etc functions,
34 plus space for some flags and pointers. For example, a tied variable has
35 a MAGIC structure that contains a pointer to the object associated with the
44 #if defined(HAS_GETGROUPS) || defined(HAS_SETGROUPS)
50 #if defined(HAS_SETGROUPS)
57 # include <sys/pstat.h>
60 #ifdef HAS_PRCTL_SET_NAME
61 # include <sys/prctl.h>
64 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
65 Signal_t Perl_csighandler(int sig, siginfo_t *, void *);
67 Signal_t Perl_csighandler(int sig);
71 /* Missing protos on LynxOS */
72 void setruid(uid_t id);
73 void seteuid(uid_t id);
74 void setrgid(uid_t id);
75 void setegid(uid_t id);
79 * Use the "DESTRUCTOR" scope cleanup to reinstate magic.
89 /* MGS is typedef'ed to struct magic_state in perl.h */
92 S_save_magic(pTHX_ I32 mgs_ix, SV *sv)
98 PERL_ARGS_ASSERT_SAVE_MAGIC;
100 /* we shouldn't really be called here with RC==0, but it can sometimes
101 * happen via mg_clear() (which also shouldn't be called when RC==0,
102 * but it can happen). Handle this case gracefully(ish) by not RC++
103 * and thus avoiding the resultant double free */
104 if (SvREFCNT(sv) > 0) {
105 /* guard against sv getting freed midway through the mg clearing,
106 * by holding a private reference for the duration. */
107 SvREFCNT_inc_simple_void_NN(sv);
111 assert(SvMAGICAL(sv));
112 /* Turning READONLY off for a copy-on-write scalar (including shared
113 hash keys) is a bad idea. */
115 sv_force_normal_flags(sv, 0);
117 SAVEDESTRUCTOR_X(S_restore_magic, INT2PTR(void*, (IV)mgs_ix));
119 mgs = SSPTR(mgs_ix, MGS*);
121 mgs->mgs_magical = SvMAGICAL(sv);
122 mgs->mgs_readonly = SvREADONLY(sv) != 0;
123 mgs->mgs_ss_ix = PL_savestack_ix; /* points after the saved destructor */
124 mgs->mgs_bumped = bumped;
128 if (!(SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK))) {
129 /* No public flags are set, so promote any private flags to public. */
130 SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
135 =for apidoc mg_magical
137 Turns on the magical status of an SV. See C<sv_magic>.
143 Perl_mg_magical(pTHX_ SV *sv)
146 PERL_ARGS_ASSERT_MG_MAGICAL;
150 if ((mg = SvMAGIC(sv))) {
152 const MGVTBL* const vtbl = mg->mg_virtual;
154 if (vtbl->svt_get && !(mg->mg_flags & MGf_GSKIP))
161 } while ((mg = mg->mg_moremagic));
162 if (!(SvFLAGS(sv) & (SVs_GMG|SVs_SMG)))
170 Do magic after a value is retrieved from the SV. See C<sv_magic>.
176 Perl_mg_get(pTHX_ SV *sv)
179 const I32 mgs_ix = SSNEW(sizeof(MGS));
181 MAGIC *newmg, *head, *cur, *mg;
183 PERL_ARGS_ASSERT_MG_GET;
185 save_magic(mgs_ix, sv);
187 /* We must call svt_get(sv, mg) for each valid entry in the linked
188 list of magic. svt_get() may delete the current entry, add new
189 magic to the head of the list, or upgrade the SV. AMS 20010810 */
191 newmg = cur = head = mg = SvMAGIC(sv);
193 const MGVTBL * const vtbl = mg->mg_virtual;
194 MAGIC * const nextmg = mg->mg_moremagic; /* it may delete itself */
196 if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
197 vtbl->svt_get(aTHX_ sv, mg);
199 /* guard against magic having been deleted - eg FETCH calling
202 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0; /* recalculate flags */
206 /* recalculate flags if this entry was deleted. */
207 if (mg->mg_flags & MGf_GSKIP)
208 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0;
214 /* Have we finished with the new entries we saw? Start again
215 where we left off (unless there are more new entries). */
223 /* Were any new entries added? */
224 if (!have_new && (newmg = SvMAGIC(sv)) != head) {
228 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0; /* recalculate flags */
232 restore_magic(INT2PTR(void *, (IV)mgs_ix));
239 Do magic after a value is assigned to the SV. See C<sv_magic>.
245 Perl_mg_set(pTHX_ SV *sv)
248 const I32 mgs_ix = SSNEW(sizeof(MGS));
252 PERL_ARGS_ASSERT_MG_SET;
254 save_magic(mgs_ix, sv);
256 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
257 const MGVTBL* vtbl = mg->mg_virtual;
258 nextmg = mg->mg_moremagic; /* it may delete itself */
259 if (mg->mg_flags & MGf_GSKIP) {
260 mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
261 (SSPTR(mgs_ix, MGS*))->mgs_magical = 0;
263 if (PL_localizing == 2
264 && (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type) || sv == DEFSV))
266 if (vtbl && vtbl->svt_set)
267 vtbl->svt_set(aTHX_ sv, mg);
270 restore_magic(INT2PTR(void*, (IV)mgs_ix));
275 =for apidoc mg_length
277 Report on the SV's length. See C<sv_magic>.
283 Perl_mg_length(pTHX_ SV *sv)
289 PERL_ARGS_ASSERT_MG_LENGTH;
291 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
292 const MGVTBL * const vtbl = mg->mg_virtual;
293 if (vtbl && vtbl->svt_len) {
294 const I32 mgs_ix = SSNEW(sizeof(MGS));
295 save_magic(mgs_ix, sv);
296 /* omit MGf_GSKIP -- not changed here */
297 len = vtbl->svt_len(aTHX_ sv, mg);
298 restore_magic(INT2PTR(void*, (IV)mgs_ix));
304 /* You can't know whether it's UTF-8 until you get the string again...
306 const U8 *s = (U8*)SvPV_const(sv, len);
309 len = utf8_length(s, s + len);
316 Perl_mg_size(pTHX_ SV *sv)
320 PERL_ARGS_ASSERT_MG_SIZE;
322 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
323 const MGVTBL* const vtbl = mg->mg_virtual;
324 if (vtbl && vtbl->svt_len) {
325 const I32 mgs_ix = SSNEW(sizeof(MGS));
327 save_magic(mgs_ix, sv);
328 /* omit MGf_GSKIP -- not changed here */
329 len = vtbl->svt_len(aTHX_ sv, mg);
330 restore_magic(INT2PTR(void*, (IV)mgs_ix));
337 return AvFILLp((const AV *) sv); /* Fallback to non-tied array */
341 Perl_croak(aTHX_ "Size magic not implemented");
350 Clear something magical that the SV represents. See C<sv_magic>.
356 Perl_mg_clear(pTHX_ SV *sv)
358 const I32 mgs_ix = SSNEW(sizeof(MGS));
362 PERL_ARGS_ASSERT_MG_CLEAR;
364 save_magic(mgs_ix, sv);
366 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
367 const MGVTBL* const vtbl = mg->mg_virtual;
368 /* omit GSKIP -- never set here */
370 nextmg = mg->mg_moremagic; /* it may delete itself */
372 if (vtbl && vtbl->svt_clear)
373 vtbl->svt_clear(aTHX_ sv, mg);
376 restore_magic(INT2PTR(void*, (IV)mgs_ix));
381 S_mg_findext_flags(pTHX_ const SV *sv, int type, const MGVTBL *vtbl, U32 flags)
390 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
391 if (mg->mg_type == type && (!flags || mg->mg_virtual == vtbl)) {
403 Finds the magic pointer for type matching the SV. See C<sv_magic>.
409 Perl_mg_find(pTHX_ const SV *sv, int type)
411 return S_mg_findext_flags(aTHX_ sv, type, NULL, 0);
415 =for apidoc mg_findext
417 Finds the magic pointer of C<type> with the given C<vtbl> for the C<SV>. See
424 Perl_mg_findext(pTHX_ const SV *sv, int type, const MGVTBL *vtbl)
426 return S_mg_findext_flags(aTHX_ sv, type, vtbl, 1);
432 Copies the magic from one SV to another. See C<sv_magic>.
438 Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
443 PERL_ARGS_ASSERT_MG_COPY;
445 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
446 const MGVTBL* const vtbl = mg->mg_virtual;
447 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
448 count += vtbl->svt_copy(aTHX_ sv, mg, nsv, key, klen);
451 const char type = mg->mg_type;
452 if (isUPPER(type) && type != PERL_MAGIC_uvar) {
454 (type == PERL_MAGIC_tied)
456 : (type == PERL_MAGIC_regdata && mg->mg_obj)
459 toLOWER(type), key, klen);
468 =for apidoc mg_localize
470 Copy some of the magic from an existing SV to new localized version of that
471 SV. Container magic (eg %ENV, $1, tie) gets copied, value magic doesn't (eg
474 If setmagic is false then no set magic will be called on the new (empty) SV.
475 This typically means that assignment will soon follow (e.g. 'local $x = $y'),
476 and that will handle the magic.
482 Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
487 PERL_ARGS_ASSERT_MG_LOCALIZE;
492 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
493 const MGVTBL* const vtbl = mg->mg_virtual;
494 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
497 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
498 (void)vtbl->svt_local(aTHX_ nsv, mg);
500 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
501 mg->mg_ptr, mg->mg_len);
503 /* container types should remain read-only across localization */
504 if (!SvIsCOW(sv)) SvFLAGS(nsv) |= SvREADONLY(sv);
507 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
508 SvFLAGS(nsv) |= SvMAGICAL(sv);
517 #define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
519 S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
521 const MGVTBL* const vtbl = mg->mg_virtual;
522 if (vtbl && vtbl->svt_free)
523 vtbl->svt_free(aTHX_ sv, mg);
524 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
525 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
526 Safefree(mg->mg_ptr);
527 else if (mg->mg_len == HEf_SVKEY)
528 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
530 if (mg->mg_flags & MGf_REFCOUNTED)
531 SvREFCNT_dec(mg->mg_obj);
538 Free any magic storage used by the SV. See C<sv_magic>.
544 Perl_mg_free(pTHX_ SV *sv)
549 PERL_ARGS_ASSERT_MG_FREE;
551 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
552 moremagic = mg->mg_moremagic;
553 mg_free_struct(sv, mg);
554 SvMAGIC_set(sv, moremagic);
556 SvMAGIC_set(sv, NULL);
562 =for apidoc Am|void|mg_free_type|SV *sv|int how
564 Remove any magic of type I<how> from the SV I<sv>. See L</sv_magic>.
570 Perl_mg_free_type(pTHX_ SV *sv, int how)
572 MAGIC *mg, *prevmg, *moremg;
573 PERL_ARGS_ASSERT_MG_FREE_TYPE;
574 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
576 moremg = mg->mg_moremagic;
577 if (mg->mg_type == how) {
578 /* temporarily move to the head of the magic chain, in case
579 custom free code relies on this historical aspect of mg_free */
581 prevmg->mg_moremagic = moremg;
582 mg->mg_moremagic = SvMAGIC(sv);
585 newhead = mg->mg_moremagic;
586 mg_free_struct(sv, mg);
587 SvMAGIC_set(sv, newhead);
597 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
602 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
605 register const REGEXP * const rx = PM_GETRE(PL_curpm);
607 if (mg->mg_obj) { /* @+ */
608 /* return the number possible */
609 return RX_NPARENS(rx);
611 I32 paren = RX_LASTPAREN(rx);
613 /* return the last filled */
615 && (RX_OFFS(rx)[paren].start == -1
616 || RX_OFFS(rx)[paren].end == -1) )
627 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
631 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
634 register const REGEXP * const rx = PM_GETRE(PL_curpm);
636 register const I32 paren = mg->mg_len;
641 if (paren <= (I32)RX_NPARENS(rx) &&
642 (s = RX_OFFS(rx)[paren].start) != -1 &&
643 (t = RX_OFFS(rx)[paren].end) != -1)
646 if (mg->mg_obj) /* @+ */
651 if (i > 0 && RX_MATCH_UTF8(rx)) {
652 const char * const b = RX_SUBBEG(rx);
654 i = utf8_length((U8*)b, (U8*)(b+i));
665 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
667 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
670 Perl_croak_no_modify(aTHX);
671 NORETURN_FUNCTION_END;
675 Perl_magic_len(pTHX_ SV *sv, MAGIC *mg)
680 register const REGEXP * rx;
681 const char * const remaining = mg->mg_ptr + 1;
683 PERL_ARGS_ASSERT_MAGIC_LEN;
685 switch (*mg->mg_ptr) {
687 if (*remaining == '\0') { /* ^P */
689 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
691 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
695 case '\015': /* $^MATCH */
696 if (strEQ(remaining, "ATCH")) {
703 paren = RX_BUFF_IDX_PREMATCH;
707 paren = RX_BUFF_IDX_POSTMATCH;
711 paren = RX_BUFF_IDX_FULLMATCH;
713 case '1': case '2': case '3': case '4':
714 case '5': case '6': case '7': case '8': case '9':
715 paren = atoi(mg->mg_ptr);
717 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
719 i = CALLREG_NUMBUF_LENGTH((REGEXP * const)rx, sv, paren);
722 Perl_croak(aTHX_ "panic: magic_len: %"IVdf, (IV)i);
725 if (ckWARN(WARN_UNINITIALIZED))
730 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
731 paren = RX_LASTPAREN(rx);
736 case '\016': /* ^N */
737 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
738 paren = RX_LASTCLOSEPAREN(rx);
745 if (!SvPOK(sv) && SvNIOK(sv)) {
753 #define SvRTRIM(sv) STMT_START { \
755 STRLEN len = SvCUR(sv); \
756 char * const p = SvPVX(sv); \
757 while (len > 0 && isSPACE(p[len-1])) \
759 SvCUR_set(sv, len); \
765 Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
767 PERL_ARGS_ASSERT_EMULATE_COP_IO;
769 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
770 sv_setsv(sv, &PL_sv_undef);
774 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
775 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
780 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
781 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
789 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
793 register const char *s = NULL;
795 const char * const remaining = mg->mg_ptr + 1;
796 const char nextchar = *remaining;
798 PERL_ARGS_ASSERT_MAGIC_GET;
800 switch (*mg->mg_ptr) {
801 case '\001': /* ^A */
802 sv_setsv(sv, PL_bodytarget);
803 if (SvTAINTED(PL_bodytarget))
806 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
807 if (nextchar == '\0') {
808 sv_setiv(sv, (IV)PL_minus_c);
810 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
811 sv_setiv(sv, (IV)STATUS_NATIVE);
815 case '\004': /* ^D */
816 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
818 case '\005': /* ^E */
819 if (nextchar == '\0') {
822 # include <descrip.h>
823 # include <starlet.h>
825 $DESCRIPTOR(msgdsc,msg);
826 sv_setnv(sv,(NV) vaxc$errno);
827 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
828 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
833 if (!(_emx_env & 0x200)) { /* Under DOS */
834 sv_setnv(sv, (NV)errno);
835 sv_setpv(sv, errno ? Strerror(errno) : "");
837 if (errno != errno_isOS2) {
838 const int tmp = _syserrno();
839 if (tmp) /* 2nd call to _syserrno() makes it 0 */
842 sv_setnv(sv, (NV)Perl_rc);
843 sv_setpv(sv, os2error(Perl_rc));
847 const DWORD dwErr = GetLastError();
848 sv_setnv(sv, (NV)dwErr);
850 PerlProc_GetOSError(sv, dwErr);
859 sv_setnv(sv, (NV)errno);
860 sv_setpv(sv, errno ? Strerror(errno) : "");
865 SvNOK_on(sv); /* what a wonderful hack! */
867 else if (strEQ(remaining, "NCODING"))
868 sv_setsv(sv, PL_encoding);
870 case '\006': /* ^F */
871 sv_setiv(sv, (IV)PL_maxsysfd);
873 case '\007': /* ^GLOBAL_PHASE */
874 if (strEQ(remaining, "LOBAL_PHASE")) {
875 sv_setpvn(sv, PL_phase_names[PL_phase],
876 strlen(PL_phase_names[PL_phase]));
879 case '\010': /* ^H */
880 sv_setiv(sv, (IV)PL_hints);
882 case '\011': /* ^I */ /* NOT \t in EBCDIC */
883 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
885 case '\017': /* ^O & ^OPEN */
886 if (nextchar == '\0') {
887 sv_setpv(sv, PL_osname);
890 else if (strEQ(remaining, "PEN")) {
891 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
895 if (nextchar == '\0') { /* ^P */
896 sv_setiv(sv, (IV)PL_perldb);
897 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
898 goto do_prematch_fetch;
899 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
900 goto do_postmatch_fetch;
903 case '\023': /* ^S */
904 if (nextchar == '\0') {
905 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
908 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
913 case '\024': /* ^T */
914 if (nextchar == '\0') {
916 sv_setnv(sv, PL_basetime);
918 sv_setiv(sv, (IV)PL_basetime);
921 else if (strEQ(remaining, "AINT"))
922 sv_setiv(sv, PL_tainting
923 ? (PL_taint_warn || PL_unsafe ? -1 : 1)
926 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
927 if (strEQ(remaining, "NICODE"))
928 sv_setuv(sv, (UV) PL_unicode);
929 else if (strEQ(remaining, "TF8LOCALE"))
930 sv_setuv(sv, (UV) PL_utf8locale);
931 else if (strEQ(remaining, "TF8CACHE"))
932 sv_setiv(sv, (IV) PL_utf8cache);
934 case '\027': /* ^W & $^WARNING_BITS */
935 if (nextchar == '\0')
936 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
937 else if (strEQ(remaining, "ARNING_BITS")) {
938 if (PL_compiling.cop_warnings == pWARN_NONE) {
939 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
941 else if (PL_compiling.cop_warnings == pWARN_STD) {
944 (PL_dowarn & G_WARN_ON) ? WARN_ALLstring : WARN_NONEstring,
948 else if (PL_compiling.cop_warnings == pWARN_ALL) {
949 /* Get the bit mask for $warnings::Bits{all}, because
950 * it could have been extended by warnings::register */
951 HV * const bits=get_hv("warnings::Bits", 0);
953 SV ** const bits_all = hv_fetchs(bits, "all", FALSE);
955 sv_setsv(sv, *bits_all);
958 sv_setpvn(sv, WARN_ALLstring, WARNsize) ;
962 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
963 *PL_compiling.cop_warnings);
968 case '\015': /* $^MATCH */
969 if (strEQ(remaining, "ATCH")) {
970 case '1': case '2': case '3': case '4':
971 case '5': case '6': case '7': case '8': case '9': case '&':
972 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
974 * Pre-threads, this was paren = atoi(GvENAME((const GV *)mg->mg_obj));
975 * XXX Does the new way break anything?
977 paren = atoi(mg->mg_ptr); /* $& is in [0] */
978 CALLREG_NUMBUF_FETCH(rx,paren,sv);
981 sv_setsv(sv,&PL_sv_undef);
985 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
986 if (RX_LASTPAREN(rx)) {
987 CALLREG_NUMBUF_FETCH(rx,RX_LASTPAREN(rx),sv);
991 sv_setsv(sv,&PL_sv_undef);
993 case '\016': /* ^N */
994 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
995 if (RX_LASTCLOSEPAREN(rx)) {
996 CALLREG_NUMBUF_FETCH(rx,RX_LASTCLOSEPAREN(rx),sv);
1001 sv_setsv(sv,&PL_sv_undef);
1005 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1006 CALLREG_NUMBUF_FETCH(rx,-2,sv);
1009 sv_setsv(sv,&PL_sv_undef);
1013 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1014 CALLREG_NUMBUF_FETCH(rx,-1,sv);
1017 sv_setsv(sv,&PL_sv_undef);
1020 if (GvIO(PL_last_in_gv)) {
1021 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
1026 sv_setiv(sv, (IV)STATUS_CURRENT);
1027 #ifdef COMPLEX_STATUS
1028 SvUPGRADE(sv, SVt_PVLV);
1029 LvTARGOFF(sv) = PL_statusvalue;
1030 LvTARGLEN(sv) = PL_statusvalue_vms;
1035 if (GvIOp(PL_defoutgv))
1036 s = IoTOP_NAME(GvIOp(PL_defoutgv));
1040 sv_setpv(sv,GvENAME(PL_defoutgv));
1041 sv_catpvs(sv,"_TOP");
1045 if (GvIOp(PL_defoutgv))
1046 s = IoFMT_NAME(GvIOp(PL_defoutgv));
1048 s = GvENAME(PL_defoutgv);
1052 if (GvIO(PL_defoutgv))
1053 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
1056 if (GvIO(PL_defoutgv))
1057 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
1060 if (GvIO(PL_defoutgv))
1061 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
1071 if (GvIO(PL_defoutgv))
1072 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
1076 sv_copypv(sv, PL_ors_sv);
1080 IV const pid = (IV)PerlProc_getpid();
1081 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid)
1082 /* never set manually, or at least not since last fork */
1084 /* else a value has been assigned manually, so do nothing */
1092 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
1094 sv_setnv(sv, (NV)errno);
1097 if (errno == errno_isOS2 || errno == errno_isOS2_set)
1098 sv_setpv(sv, os2error(Perl_rc));
1101 sv_setpv(sv, errno ? Strerror(errno) : "");
1103 SvPOK_on(sv); /* may have got removed during taint processing */
1108 SvNOK_on(sv); /* what a wonderful hack! */
1111 sv_setiv(sv, (IV)PL_uid);
1114 sv_setiv(sv, (IV)PL_euid);
1117 sv_setiv(sv, (IV)PL_gid);
1120 sv_setiv(sv, (IV)PL_egid);
1122 #ifdef HAS_GETGROUPS
1124 Groups_t *gary = NULL;
1125 I32 i, num_groups = getgroups(0, gary);
1126 Newx(gary, num_groups, Groups_t);
1127 num_groups = getgroups(num_groups, gary);
1128 for (i = 0; i < num_groups; i++)
1129 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1132 (void)SvIOK_on(sv); /* what a wonderful hack! */
1142 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
1144 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
1146 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1148 if (uf && uf->uf_val)
1149 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
1154 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
1157 STRLEN len = 0, klen;
1158 const char *s = SvOK(sv) ? SvPV_const(sv,len) : "";
1159 const char * const ptr = MgPV_const(mg,klen);
1162 PERL_ARGS_ASSERT_MAGIC_SETENV;
1164 #ifdef DYNAMIC_ENV_FETCH
1165 /* We just undefd an environment var. Is a replacement */
1166 /* waiting in the wings? */
1168 SV ** const valp = hv_fetch(GvHVn(PL_envgv), ptr, klen, FALSE);
1170 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
1174 #if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
1175 /* And you'll never guess what the dog had */
1176 /* in its mouth... */
1178 MgTAINTEDDIR_off(mg);
1180 if (s && klen == 8 && strEQ(ptr, "DCL$PATH")) {
1181 char pathbuf[256], eltbuf[256], *cp, *elt;
1184 my_strlcpy(eltbuf, s, sizeof(eltbuf));
1186 do { /* DCL$PATH may be a search list */
1187 while (1) { /* as may dev portion of any element */
1188 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1189 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1190 cando_by_name(S_IWUSR,0,elt) ) {
1191 MgTAINTEDDIR_on(mg);
1195 if ((cp = strchr(elt, ':')) != NULL)
1197 if (my_trnlnm(elt, eltbuf, j++))
1203 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1206 if (s && klen == 4 && strEQ(ptr,"PATH")) {
1207 const char * const strend = s + len;
1209 while (s < strend) {
1213 #ifdef VMS /* Hmm. How do we get $Config{path_sep} from C? */
1214 const char path_sep = '|';
1216 const char path_sep = ':';
1218 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
1219 s, strend, path_sep, &i);
1221 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
1223 || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1225 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1227 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1228 MgTAINTEDDIR_on(mg);
1234 #endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1240 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1242 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
1243 PERL_UNUSED_ARG(sv);
1244 my_setenv(MgPV_nolen_const(mg),NULL);
1249 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1252 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
1253 PERL_UNUSED_ARG(mg);
1255 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1257 if (PL_localizing) {
1260 hv_iterinit(MUTABLE_HV(sv));
1261 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
1263 my_setenv(hv_iterkey(entry, &keylen),
1264 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
1272 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1275 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
1276 PERL_UNUSED_ARG(sv);
1277 PERL_UNUSED_ARG(mg);
1279 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1287 #ifdef HAS_SIGPROCMASK
1289 restore_sigmask(pTHX_ SV *save_sv)
1291 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1292 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
1296 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1299 /* Are we fetching a signal entry? */
1300 int i = (I16)mg->mg_private;
1302 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1306 const char * sig = MgPV_const(mg, siglen);
1307 mg->mg_private = i = whichsig_pvn(sig, siglen);
1312 sv_setsv(sv,PL_psig_ptr[i]);
1314 Sighandler_t sigstate = rsignal_state(i);
1315 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1316 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1319 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1320 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1323 /* cache state so we don't fetch it again */
1324 if(sigstate == (Sighandler_t) SIG_IGN)
1325 sv_setpvs(sv,"IGNORE");
1327 sv_setsv(sv,&PL_sv_undef);
1328 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1335 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1337 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
1339 magic_setsig(NULL, mg);
1340 return sv_unmagic(sv, mg->mg_type);
1344 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1345 Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
1347 Perl_csighandler(int sig)
1350 #ifdef PERL_GET_SIG_CONTEXT
1351 dTHXa(PERL_GET_SIG_CONTEXT);
1355 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1356 (void) rsignal(sig, PL_csighandlerp);
1357 if (PL_sig_ignoring[sig]) return;
1359 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1360 if (PL_sig_defaulting[sig])
1361 #ifdef KILL_BY_SIGPRC
1362 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1377 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
1378 /* Call the perl level handler now--
1379 * with risk we may be in malloc() or being destructed etc. */
1380 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1381 (*PL_sighandlerp)(sig, NULL, NULL);
1383 (*PL_sighandlerp)(sig);
1386 if (!PL_psig_pend) return;
1387 /* Set a flag to say this signal is pending, that is awaiting delivery after
1388 * the current Perl opcode completes */
1389 PL_psig_pend[sig]++;
1391 #ifndef SIG_PENDING_DIE_COUNT
1392 # define SIG_PENDING_DIE_COUNT 120
1394 /* Add one to say _a_ signal is pending */
1395 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1396 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1397 (unsigned long)SIG_PENDING_DIE_COUNT);
1401 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1403 Perl_csighandler_init(void)
1406 if (PL_sig_handlers_initted) return;
1408 for (sig = 1; sig < SIG_SIZE; sig++) {
1409 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1411 PL_sig_defaulting[sig] = 1;
1412 (void) rsignal(sig, PL_csighandlerp);
1414 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1415 PL_sig_ignoring[sig] = 0;
1418 PL_sig_handlers_initted = 1;
1422 #if defined HAS_SIGPROCMASK
1424 unblock_sigmask(pTHX_ void* newset)
1426 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1431 Perl_despatch_signals(pTHX)
1436 for (sig = 1; sig < SIG_SIZE; sig++) {
1437 if (PL_psig_pend[sig]) {
1439 #ifdef HAS_SIGPROCMASK
1440 /* From sigaction(2) (FreeBSD man page):
1441 * | Signal routines normally execute with the signal that
1442 * | caused their invocation blocked, but other signals may
1444 * Emulation of this behavior (from within Perl) is enabled
1448 sigset_t newset, oldset;
1450 sigemptyset(&newset);
1451 sigaddset(&newset, sig);
1452 sigprocmask(SIG_BLOCK, &newset, &oldset);
1453 was_blocked = sigismember(&oldset, sig);
1455 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1457 SAVEFREESV(save_sv);
1458 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1461 PL_psig_pend[sig] = 0;
1462 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1463 (*PL_sighandlerp)(sig, NULL, NULL);
1465 (*PL_sighandlerp)(sig);
1467 #ifdef HAS_SIGPROCMASK
1476 /* sv of NULL signifies that we're acting as magic_clearsig. */
1478 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1483 /* Need to be careful with SvREFCNT_dec(), because that can have side
1484 * effects (due to closures). We must make sure that the new disposition
1485 * is in place before it is called.
1489 #ifdef HAS_SIGPROCMASK
1493 register const char *s = MgPV_const(mg,len);
1495 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1498 if (memEQs(s, len, "__DIE__"))
1500 else if (memEQs(s, len, "__WARN__")
1501 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1502 /* Merge the existing behaviours, which are as follows:
1503 magic_setsig, we always set svp to &PL_warnhook
1504 (hence we always change the warnings handler)
1505 For magic_clearsig, we don't change the warnings handler if it's
1506 set to the &PL_warnhook. */
1509 SV *tmp = sv_newmortal();
1510 Perl_croak(aTHX_ "No such hook: %s",
1511 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1515 if (*svp != PERL_WARNHOOK_FATAL)
1521 i = (I16)mg->mg_private;
1523 i = whichsig_pvn(s, len); /* ...no, a brick */
1524 mg->mg_private = (U16)i;
1528 SV *tmp = sv_newmortal();
1529 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1530 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1534 #ifdef HAS_SIGPROCMASK
1535 /* Avoid having the signal arrive at a bad time, if possible. */
1538 sigprocmask(SIG_BLOCK, &set, &save);
1540 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1541 SAVEFREESV(save_sv);
1542 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1545 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1546 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1548 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1549 PL_sig_ignoring[i] = 0;
1551 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1552 PL_sig_defaulting[i] = 0;
1554 to_dec = PL_psig_ptr[i];
1556 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1557 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1559 /* Signals don't change name during the program's execution, so once
1560 they're cached in the appropriate slot of PL_psig_name, they can
1563 Ideally we'd find some way of making SVs at (C) compile time, or
1564 at least, doing most of the work. */
1565 if (!PL_psig_name[i]) {
1566 PL_psig_name[i] = newSVpvn(s, len);
1567 SvREADONLY_on(PL_psig_name[i]);
1570 SvREFCNT_dec(PL_psig_name[i]);
1571 PL_psig_name[i] = NULL;
1572 PL_psig_ptr[i] = NULL;
1575 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1577 (void)rsignal(i, PL_csighandlerp);
1580 *svp = SvREFCNT_inc_simple_NN(sv);
1582 if (sv && SvOK(sv)) {
1583 s = SvPV_force(sv, len);
1587 if (sv && memEQs(s, len,"IGNORE")) {
1589 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1590 PL_sig_ignoring[i] = 1;
1591 (void)rsignal(i, PL_csighandlerp);
1593 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1597 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
1599 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1600 PL_sig_defaulting[i] = 1;
1601 (void)rsignal(i, PL_csighandlerp);
1603 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1609 * We should warn if HINT_STRICT_REFS, but without
1610 * access to a known hint bit in a known OP, we can't
1611 * tell whether HINT_STRICT_REFS is in force or not.
1613 if (!strchr(s,':') && !strchr(s,'\''))
1614 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1617 (void)rsignal(i, PL_csighandlerp);
1619 *svp = SvREFCNT_inc_simple_NN(sv);
1623 #ifdef HAS_SIGPROCMASK
1627 SvREFCNT_dec(to_dec);
1630 #endif /* !PERL_MICRO */
1633 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1636 PERL_ARGS_ASSERT_MAGIC_SETISA;
1637 PERL_UNUSED_ARG(sv);
1639 /* Skip _isaelem because _isa will handle it shortly */
1640 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
1643 return magic_clearisa(NULL, mg);
1646 /* sv of NULL signifies that we're acting as magic_setisa. */
1648 Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1653 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1655 /* Bail out if destruction is going on */
1656 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
1659 av_clear(MUTABLE_AV(sv));
1661 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1662 /* This occurs with setisa_elem magic, which calls this
1664 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1666 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1667 SV **svp = AvARRAY((AV *)mg->mg_obj);
1668 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1670 stash = GvSTASH((GV *)*svp++);
1671 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1678 (const GV *)mg->mg_obj
1681 /* The stash may have been detached from the symbol table, so check its
1682 name before doing anything. */
1683 if (stash && HvENAME_get(stash))
1684 mro_isa_changed_in(stash);
1690 Perl_magic_setamagic(pTHX_ SV *sv, MAGIC *mg)
1693 PERL_ARGS_ASSERT_MAGIC_SETAMAGIC;
1694 PERL_UNUSED_ARG(sv);
1695 PERL_UNUSED_ARG(mg);
1696 PL_amagic_generation++;
1702 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1704 HV * const hv = MUTABLE_HV(LvTARG(sv));
1707 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
1708 PERL_UNUSED_ARG(mg);
1711 (void) hv_iterinit(hv);
1712 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1715 while (hv_iternext(hv))
1720 sv_setiv(sv, (IV)i);
1725 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1727 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
1728 PERL_UNUSED_ARG(mg);
1730 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
1736 =for apidoc magic_methcall
1738 Invoke a magic method (like FETCH).
1740 C<sv> and C<mg> are the tied thingy and the tie magic.
1742 C<meth> is the name of the method to call.
1744 C<argc> is the number of args (in addition to $self) to pass to the method.
1746 The C<flags> can be:
1748 G_DISCARD invoke method with G_DISCARD flag and don't
1750 G_UNDEF_FILL fill the stack with argc pointers to
1753 The arguments themselves are any values following the C<flags> argument.
1755 Returns the SV (if any) returned by the method, or NULL on failure.
1762 Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, const char *meth, U32 flags,
1769 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1773 if (flags & G_WRITING_TO_STDERR) {
1777 SAVESPTR(PL_stderrgv);
1781 PUSHSTACKi(PERLSI_MAGIC);
1785 PUSHs(SvTIED_obj(sv, mg));
1786 if (flags & G_UNDEF_FILL) {
1788 PUSHs(&PL_sv_undef);
1790 } else if (argc > 0) {
1792 va_start(args, argc);
1795 SV *const sv = va_arg(args, SV *);
1802 if (flags & G_DISCARD) {
1803 call_method(meth, G_SCALAR|G_DISCARD);
1806 if (call_method(meth, G_SCALAR))
1807 ret = *PL_stack_sp--;
1810 if (flags & G_WRITING_TO_STDERR)
1817 /* wrapper for magic_methcall that creates the first arg */
1820 S_magic_methcall1(pTHX_ SV *sv, const MAGIC *mg, const char *meth, U32 flags,
1826 PERL_ARGS_ASSERT_MAGIC_METHCALL1;
1829 if (mg->mg_len >= 0) {
1830 arg1 = newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
1832 else if (mg->mg_len == HEf_SVKEY)
1833 arg1 = MUTABLE_SV(mg->mg_ptr);
1835 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1836 arg1 = newSViv((IV)(mg->mg_len));
1840 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n - 1, val);
1842 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n, arg1, val);
1846 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, const char *meth)
1851 PERL_ARGS_ASSERT_MAGIC_METHPACK;
1853 ret = magic_methcall1(sv, mg, meth, 0, 1, NULL);
1860 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1862 PERL_ARGS_ASSERT_MAGIC_GETPACK;
1864 if (mg->mg_type == PERL_MAGIC_tiedelem)
1865 mg->mg_flags |= MGf_GSKIP;
1866 magic_methpack(sv,mg,"FETCH");
1871 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1877 PERL_ARGS_ASSERT_MAGIC_SETPACK;
1879 /* in the code C<$tied{foo} = $val>, the "thing" that gets passed to
1880 * STORE() is not $val, but rather a PVLV (the sv in this call), whose
1881 * public flags indicate its value based on copying from $val. Doing
1882 * mg_set() on the PVLV temporarily does SvMAGICAL_off(), then calls us.
1883 * So STORE()'s $_[2] arg is a temporarily disarmed PVLV. This goes
1884 * wrong if $val happened to be tainted, as sv hasn't got magic
1885 * enabled, even though taint magic is in the chain. In which case,
1886 * fake up a temporary tainted value (this is easier than temporarily
1887 * re-enabling magic on sv). */
1889 if (PL_tainting && (tmg = mg_find(sv, PERL_MAGIC_taint))
1890 && (tmg->mg_len & 1))
1892 val = sv_mortalcopy(sv);
1898 magic_methcall1(sv, mg, "STORE", G_DISCARD, 2, val);
1903 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1905 PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1907 return magic_methpack(sv,mg,"DELETE");
1912 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1918 PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1920 retsv = magic_methcall1(sv, mg, "FETCHSIZE", 0, 1, NULL);
1922 retval = SvIV(retsv)-1;
1924 Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
1926 return (U32) retval;
1930 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1934 PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1936 Perl_magic_methcall(aTHX_ sv, mg, "CLEAR", G_DISCARD, 0);
1941 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1946 PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1948 ret = SvOK(key) ? Perl_magic_methcall(aTHX_ sv, mg, "NEXTKEY", 0, 1, key)
1949 : Perl_magic_methcall(aTHX_ sv, mg, "FIRSTKEY", 0, 0);
1956 Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
1958 PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1960 return magic_methpack(sv,mg,"EXISTS");
1964 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1968 SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1969 HV * const pkg = SvSTASH((const SV *)SvRV(tied));
1971 PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
1973 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1975 if (HvEITER_get(hv))
1976 /* we are in an iteration so the hash cannot be empty */
1978 /* no xhv_eiter so now use FIRSTKEY */
1979 key = sv_newmortal();
1980 magic_nextpack(MUTABLE_SV(hv), mg, key);
1981 HvEITER_set(hv, NULL); /* need to reset iterator */
1982 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
1985 /* there is a SCALAR method that we can call */
1986 retval = Perl_magic_methcall(aTHX_ MUTABLE_SV(hv), mg, "SCALAR", 0, 0);
1988 retval = &PL_sv_undef;
1993 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
1996 GV * const gv = PL_DBline;
1997 const I32 i = SvTRUE(sv);
1998 SV ** const svp = av_fetch(GvAV(gv),
1999 atoi(MgPV_nolen_const(mg)), FALSE);
2001 PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
2003 if (svp && SvIOKp(*svp)) {
2004 OP * const o = INT2PTR(OP*,SvIVX(*svp));
2006 /* set or clear breakpoint in the relevant control op */
2008 o->op_flags |= OPf_SPECIAL;
2010 o->op_flags &= ~OPf_SPECIAL;
2017 Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
2020 AV * const obj = MUTABLE_AV(mg->mg_obj);
2022 PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
2025 sv_setiv(sv, AvFILL(obj));
2033 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
2036 AV * const obj = MUTABLE_AV(mg->mg_obj);
2038 PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
2041 av_fill(obj, SvIV(sv));
2043 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
2044 "Attempt to set length of freed array");
2050 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
2054 PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
2055 PERL_UNUSED_ARG(sv);
2057 /* during global destruction, mg_obj may already have been freed */
2058 if (PL_in_clean_all)
2061 mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
2064 /* arylen scalar holds a pointer back to the array, but doesn't own a
2065 reference. Hence the we (the array) are about to go away with it
2066 still pointing at us. Clear its pointer, else it would be pointing
2067 at free memory. See the comment in sv_magic about reference loops,
2068 and why it can't own a reference to us. */
2075 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
2078 SV* const lsv = LvTARG(sv);
2080 PERL_ARGS_ASSERT_MAGIC_GETPOS;
2081 PERL_UNUSED_ARG(mg);
2083 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv)) {
2084 MAGIC * const found = mg_find(lsv, PERL_MAGIC_regex_global);
2085 if (found && found->mg_len >= 0) {
2086 I32 i = found->mg_len;
2088 sv_pos_b2u(lsv, &i);
2098 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
2101 SV* const lsv = LvTARG(sv);
2107 PERL_ARGS_ASSERT_MAGIC_SETPOS;
2108 PERL_UNUSED_ARG(mg);
2110 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv))
2111 found = mg_find(lsv, PERL_MAGIC_regex_global);
2117 #ifdef PERL_OLD_COPY_ON_WRITE
2119 sv_force_normal_flags(lsv, 0);
2121 found = sv_magicext(lsv, NULL, PERL_MAGIC_regex_global, &PL_vtbl_mglob,
2124 else if (!SvOK(sv)) {
2128 len = SvPOK(lsv) ? SvCUR(lsv) : sv_len(lsv);
2133 ulen = sv_len_utf8(lsv);
2143 else if (pos > (SSize_t)len)
2148 sv_pos_u2b(lsv, &p, 0);
2152 found->mg_len = pos;
2153 found->mg_flags &= ~MGf_MINMATCH;
2159 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
2162 SV * const lsv = LvTARG(sv);
2163 const char * const tmps = SvPV_const(lsv,len);
2164 STRLEN offs = LvTARGOFF(sv);
2165 STRLEN rem = LvTARGLEN(sv);
2166 const bool negoff = LvFLAGS(sv) & 1;
2167 const bool negrem = LvFLAGS(sv) & 2;
2169 PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2170 PERL_UNUSED_ARG(mg);
2172 if (!translate_substr_offsets(
2173 SvUTF8(lsv) ? sv_len_utf8(lsv) : len,
2174 negoff ? -(IV)offs : (IV)offs, !negoff,
2175 negrem ? -(IV)rem : (IV)rem, !negrem, &offs, &rem
2177 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR), "substr outside of string");
2178 sv_setsv_nomg(sv, &PL_sv_undef);
2183 offs = sv_pos_u2b_flags(lsv, offs, &rem, SV_CONST_RETURN);
2184 sv_setpvn(sv, tmps + offs, rem);
2191 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2194 STRLEN len, lsv_len, oldtarglen, newtarglen;
2195 const char * const tmps = SvPV_const(sv, len);
2196 SV * const lsv = LvTARG(sv);
2197 STRLEN lvoff = LvTARGOFF(sv);
2198 STRLEN lvlen = LvTARGLEN(sv);
2199 const bool negoff = LvFLAGS(sv) & 1;
2200 const bool neglen = LvFLAGS(sv) & 2;
2202 PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2203 PERL_UNUSED_ARG(mg);
2207 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR),
2208 "Attempt to use reference as lvalue in substr"
2210 if (SvUTF8(lsv)) lsv_len = sv_len_utf8(lsv);
2211 else (void)SvPV_nomg(lsv,lsv_len);
2212 if (!translate_substr_offsets(
2214 negoff ? -(IV)lvoff : (IV)lvoff, !negoff,
2215 neglen ? -(IV)lvlen : (IV)lvlen, !neglen, &lvoff, &lvlen
2217 Perl_croak(aTHX_ "substr outside of string");
2220 sv_utf8_upgrade(lsv);
2221 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2222 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2223 newtarglen = sv_len_utf8(sv);
2226 else if (lsv && SvUTF8(lsv)) {
2228 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2230 utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2231 sv_insert_flags(lsv, lvoff, lvlen, utf8, len, 0);
2235 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2238 if (!neglen) LvTARGLEN(sv) = newtarglen;
2239 if (negoff) LvTARGOFF(sv) += newtarglen - oldtarglen;
2245 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2249 PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2250 PERL_UNUSED_ARG(sv);
2252 TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1));
2257 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2261 PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2262 PERL_UNUSED_ARG(sv);
2264 /* update taint status */
2273 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2275 SV * const lsv = LvTARG(sv);
2277 PERL_ARGS_ASSERT_MAGIC_GETVEC;
2278 PERL_UNUSED_ARG(mg);
2281 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2289 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2291 PERL_ARGS_ASSERT_MAGIC_SETVEC;
2292 PERL_UNUSED_ARG(mg);
2293 do_vecset(sv); /* XXX slurp this routine */
2298 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2303 PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2305 if (LvTARGLEN(sv)) {
2307 SV * const ahv = LvTARG(sv);
2308 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2313 AV *const av = MUTABLE_AV(LvTARG(sv));
2314 if ((I32)LvTARGOFF(sv) <= AvFILL(av))
2315 targ = AvARRAY(av)[LvTARGOFF(sv)];
2317 if (targ && (targ != &PL_sv_undef)) {
2318 /* somebody else defined it for us */
2319 SvREFCNT_dec(LvTARG(sv));
2320 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2322 SvREFCNT_dec(mg->mg_obj);
2324 mg->mg_flags &= ~MGf_REFCOUNTED;
2329 sv_setsv(sv, targ ? targ : &PL_sv_undef);
2334 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2336 PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2337 PERL_UNUSED_ARG(mg);
2341 sv_setsv(LvTARG(sv), sv);
2342 SvSETMAGIC(LvTARG(sv));
2348 Perl_vivify_defelem(pTHX_ SV *sv)
2354 PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2356 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2359 SV * const ahv = LvTARG(sv);
2360 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2363 if (!value || value == &PL_sv_undef)
2364 Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2367 AV *const av = MUTABLE_AV(LvTARG(sv));
2368 if ((I32)LvTARGLEN(sv) < 0 && (I32)LvTARGOFF(sv) > AvFILL(av))
2369 LvTARG(sv) = NULL; /* array can't be extended */
2371 SV* const * const svp = av_fetch(av, LvTARGOFF(sv), TRUE);
2372 if (!svp || (value = *svp) == &PL_sv_undef)
2373 Perl_croak(aTHX_ PL_no_aelem, (I32)LvTARGOFF(sv));
2376 SvREFCNT_inc_simple_void(value);
2377 SvREFCNT_dec(LvTARG(sv));
2380 SvREFCNT_dec(mg->mg_obj);
2382 mg->mg_flags &= ~MGf_REFCOUNTED;
2386 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2388 PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2389 Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2394 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2396 PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2397 PERL_UNUSED_CONTEXT;
2398 PERL_UNUSED_ARG(sv);
2404 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2406 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2408 PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2410 if (uf && uf->uf_set)
2411 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2416 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2418 const char type = mg->mg_type;
2420 PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2422 if (type == PERL_MAGIC_qr) {
2423 } else if (type == PERL_MAGIC_bm) {
2426 } else if (type == PERL_MAGIC_study) {
2427 if (!isGV_with_GP(sv))
2430 assert(type == PERL_MAGIC_fm);
2432 return sv_unmagic(sv, type);
2435 #ifdef USE_LOCALE_COLLATE
2437 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2439 PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2442 * RenE<eacute> Descartes said "I think not."
2443 * and vanished with a faint plop.
2445 PERL_UNUSED_CONTEXT;
2446 PERL_UNUSED_ARG(sv);
2448 Safefree(mg->mg_ptr);
2454 #endif /* USE_LOCALE_COLLATE */
2456 /* Just clear the UTF-8 cache data. */
2458 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2460 PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2461 PERL_UNUSED_CONTEXT;
2462 PERL_UNUSED_ARG(sv);
2463 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
2465 mg->mg_len = -1; /* The mg_len holds the len cache. */
2470 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2473 register const char *s;
2475 register const REGEXP * rx;
2476 const char * const remaining = mg->mg_ptr + 1;
2481 PERL_ARGS_ASSERT_MAGIC_SET;
2483 switch (*mg->mg_ptr) {
2484 case '\015': /* $^MATCH */
2485 if (strEQ(remaining, "ATCH"))
2487 case '`': /* ${^PREMATCH} caught below */
2489 paren = RX_BUFF_IDX_PREMATCH;
2491 case '\'': /* ${^POSTMATCH} caught below */
2493 paren = RX_BUFF_IDX_POSTMATCH;
2497 paren = RX_BUFF_IDX_FULLMATCH;
2499 case '1': case '2': case '3': case '4':
2500 case '5': case '6': case '7': case '8': case '9':
2501 paren = atoi(mg->mg_ptr);
2503 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2504 CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2506 /* Croak with a READONLY error when a numbered match var is
2507 * set without a previous pattern match. Unless it's C<local $1>
2509 if (!PL_localizing) {
2510 Perl_croak_no_modify(aTHX);
2514 case '\001': /* ^A */
2515 sv_setsv(PL_bodytarget, sv);
2516 FmLINES(PL_bodytarget) = 0;
2517 if (SvPOK(PL_bodytarget)) {
2518 char *s = SvPVX(PL_bodytarget);
2519 while ( ((s = strchr(s, '\n'))) ) {
2520 FmLINES(PL_bodytarget)++;
2524 /* mg_set() has temporarily made sv non-magical */
2526 if ((tmg = mg_find(sv,PERL_MAGIC_taint)) && tmg->mg_len & 1)
2527 SvTAINTED_on(PL_bodytarget);
2529 SvTAINTED_off(PL_bodytarget);
2532 case '\003': /* ^C */
2533 PL_minus_c = cBOOL(SvIV(sv));
2536 case '\004': /* ^D */
2538 s = SvPV_nolen_const(sv);
2539 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2540 if (DEBUG_x_TEST || DEBUG_B_TEST)
2541 dump_all_perl(!DEBUG_B_TEST);
2543 PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
2546 case '\005': /* ^E */
2547 if (*(mg->mg_ptr+1) == '\0') {
2549 set_vaxc_errno(SvIV(sv));
2552 SetLastError( SvIV(sv) );
2555 os2_setsyserrno(SvIV(sv));
2557 /* will anyone ever use this? */
2558 SETERRNO(SvIV(sv), 4);
2563 else if (strEQ(mg->mg_ptr+1, "NCODING")) {
2564 SvREFCNT_dec(PL_encoding);
2565 if (SvOK(sv) || SvGMAGICAL(sv)) {
2566 PL_encoding = newSVsv(sv);
2573 case '\006': /* ^F */
2574 PL_maxsysfd = SvIV(sv);
2576 case '\010': /* ^H */
2577 PL_hints = SvIV(sv);
2579 case '\011': /* ^I */ /* NOT \t in EBCDIC */
2580 Safefree(PL_inplace);
2581 PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2583 case '\017': /* ^O */
2584 if (*(mg->mg_ptr+1) == '\0') {
2585 Safefree(PL_osname);
2588 TAINT_PROPER("assigning to $^O");
2589 PL_osname = savesvpv(sv);
2592 else if (strEQ(mg->mg_ptr, "\017PEN")) {
2594 const char *const start = SvPV(sv, len);
2595 const char *out = (const char*)memchr(start, '\0', len);
2599 PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2600 PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2602 /* Opening for input is more common than opening for output, so
2603 ensure that hints for input are sooner on linked list. */
2604 tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2606 : newSVpvs_flags("", SvUTF8(sv));
2607 (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2610 tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2612 (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2616 case '\020': /* ^P */
2617 if (*remaining == '\0') { /* ^P */
2618 PL_perldb = SvIV(sv);
2619 if (PL_perldb && !PL_DBsingle)
2622 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
2624 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
2628 case '\024': /* ^T */
2630 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2632 PL_basetime = (Time_t)SvIV(sv);
2635 case '\025': /* ^UTF8CACHE */
2636 if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2637 PL_utf8cache = (signed char) sv_2iv(sv);
2640 case '\027': /* ^W & $^WARNING_BITS */
2641 if (*(mg->mg_ptr+1) == '\0') {
2642 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2644 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2645 | (i ? G_WARN_ON : G_WARN_OFF) ;
2648 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2649 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2650 if (!SvPOK(sv) && PL_localizing) {
2651 sv_setpvn(sv, WARN_NONEstring, WARNsize);
2652 PL_compiling.cop_warnings = pWARN_NONE;
2657 int accumulate = 0 ;
2658 int any_fatals = 0 ;
2659 const char * const ptr = SvPV_const(sv, len) ;
2660 for (i = 0 ; i < len ; ++i) {
2661 accumulate |= ptr[i] ;
2662 any_fatals |= (ptr[i] & 0xAA) ;
2665 if (!specialWARN(PL_compiling.cop_warnings))
2666 PerlMemShared_free(PL_compiling.cop_warnings);
2667 PL_compiling.cop_warnings = pWARN_NONE;
2669 /* Yuck. I can't see how to abstract this: */
2670 else if (isWARN_on(((STRLEN *)SvPV_nolen_const(sv)) - 1,
2671 WARN_ALL) && !any_fatals) {
2672 if (!specialWARN(PL_compiling.cop_warnings))
2673 PerlMemShared_free(PL_compiling.cop_warnings);
2674 PL_compiling.cop_warnings = pWARN_ALL;
2675 PL_dowarn |= G_WARN_ONCE ;
2679 const char *const p = SvPV_const(sv, len);
2681 PL_compiling.cop_warnings
2682 = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2685 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2686 PL_dowarn |= G_WARN_ONCE ;
2694 if (PL_localizing) {
2695 if (PL_localizing == 1)
2696 SAVESPTR(PL_last_in_gv);
2698 else if (SvOK(sv) && GvIO(PL_last_in_gv))
2699 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2702 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2703 s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2704 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2707 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2708 s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2709 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2712 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2715 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2716 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2717 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2720 IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2724 IO * const io = GvIO(PL_defoutgv);
2727 if ((SvIV(sv)) == 0)
2728 IoFLAGS(io) &= ~IOf_FLUSH;
2730 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2731 PerlIO *ofp = IoOFP(io);
2733 (void)PerlIO_flush(ofp);
2734 IoFLAGS(io) |= IOf_FLUSH;
2740 SvREFCNT_dec(PL_rs);
2741 PL_rs = newSVsv(sv);
2744 SvREFCNT_dec(PL_ors_sv);
2745 if (SvOK(sv) || SvGMAGICAL(sv)) {
2746 PL_ors_sv = newSVsv(sv);
2754 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2757 #ifdef COMPLEX_STATUS
2758 if (PL_localizing == 2) {
2759 SvUPGRADE(sv, SVt_PVLV);
2760 PL_statusvalue = LvTARGOFF(sv);
2761 PL_statusvalue_vms = LvTARGLEN(sv);
2765 #ifdef VMSISH_STATUS
2767 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
2770 STATUS_UNIX_EXIT_SET(SvIV(sv));
2775 # define PERL_VMS_BANG vaxc$errno
2777 # define PERL_VMS_BANG 0
2779 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2780 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2785 if (PL_delaymagic) {
2786 PL_delaymagic |= DM_RUID;
2787 break; /* don't do magic till later */
2790 (void)setruid((Uid_t)PL_uid);
2793 (void)setreuid((Uid_t)PL_uid, (Uid_t)-1);
2795 #ifdef HAS_SETRESUID
2796 (void)setresuid((Uid_t)PL_uid, (Uid_t)-1, (Uid_t)-1);
2798 if (PL_uid == PL_euid) { /* special case $< = $> */
2800 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2801 if (PL_uid != 0 && PerlProc_getuid() == 0)
2802 (void)PerlProc_setuid(0);
2804 (void)PerlProc_setuid(PL_uid);
2806 PL_uid = PerlProc_getuid();
2807 Perl_croak(aTHX_ "setruid() not implemented");
2812 PL_uid = PerlProc_getuid();
2816 if (PL_delaymagic) {
2817 PL_delaymagic |= DM_EUID;
2818 break; /* don't do magic till later */
2821 (void)seteuid((Uid_t)PL_euid);
2824 (void)setreuid((Uid_t)-1, (Uid_t)PL_euid);
2826 #ifdef HAS_SETRESUID
2827 (void)setresuid((Uid_t)-1, (Uid_t)PL_euid, (Uid_t)-1);
2829 if (PL_euid == PL_uid) /* special case $> = $< */
2830 PerlProc_setuid(PL_euid);
2832 PL_euid = PerlProc_geteuid();
2833 Perl_croak(aTHX_ "seteuid() not implemented");
2838 PL_euid = PerlProc_geteuid();
2842 if (PL_delaymagic) {
2843 PL_delaymagic |= DM_RGID;
2844 break; /* don't do magic till later */
2847 (void)setrgid((Gid_t)PL_gid);
2850 (void)setregid((Gid_t)PL_gid, (Gid_t)-1);
2852 #ifdef HAS_SETRESGID
2853 (void)setresgid((Gid_t)PL_gid, (Gid_t)-1, (Gid_t) -1);
2855 if (PL_gid == PL_egid) /* special case $( = $) */
2856 (void)PerlProc_setgid(PL_gid);
2858 PL_gid = PerlProc_getgid();
2859 Perl_croak(aTHX_ "setrgid() not implemented");
2864 PL_gid = PerlProc_getgid();
2867 #ifdef HAS_SETGROUPS
2869 const char *p = SvPV_const(sv, len);
2870 Groups_t *gary = NULL;
2871 #ifdef _SC_NGROUPS_MAX
2872 int maxgrp = sysconf(_SC_NGROUPS_MAX);
2877 int maxgrp = NGROUPS;
2883 for (i = 0; i < maxgrp; ++i) {
2884 while (*p && !isSPACE(*p))
2891 Newx(gary, i + 1, Groups_t);
2893 Renew(gary, i + 1, Groups_t);
2897 (void)setgroups(i, gary);
2900 #else /* HAS_SETGROUPS */
2902 #endif /* HAS_SETGROUPS */
2903 if (PL_delaymagic) {
2904 PL_delaymagic |= DM_EGID;
2905 break; /* don't do magic till later */
2908 (void)setegid((Gid_t)PL_egid);
2911 (void)setregid((Gid_t)-1, (Gid_t)PL_egid);
2913 #ifdef HAS_SETRESGID
2914 (void)setresgid((Gid_t)-1, (Gid_t)PL_egid, (Gid_t)-1);
2916 if (PL_egid == PL_gid) /* special case $) = $( */
2917 (void)PerlProc_setgid(PL_egid);
2919 PL_egid = PerlProc_getegid();
2920 Perl_croak(aTHX_ "setegid() not implemented");
2925 PL_egid = PerlProc_getegid();
2928 PL_chopset = SvPV_force(sv,len);
2931 /* Store the pid in mg->mg_obj so we can tell when a fork has
2932 occurred. mg->mg_obj points to *$ by default, so clear it. */
2933 if (isGV(mg->mg_obj)) {
2934 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
2935 SvREFCNT_dec(mg->mg_obj);
2936 mg->mg_flags |= MGf_REFCOUNTED;
2937 mg->mg_obj = newSViv((IV)PerlProc_getpid());
2939 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
2942 LOCK_DOLLARZERO_MUTEX;
2943 #ifdef HAS_SETPROCTITLE
2944 /* The BSDs don't show the argv[] in ps(1) output, they
2945 * show a string from the process struct and provide
2946 * the setproctitle() routine to manipulate that. */
2947 if (PL_origalen != 1) {
2948 s = SvPV_const(sv, len);
2949 # if __FreeBSD_version > 410001
2950 /* The leading "-" removes the "perl: " prefix,
2951 * but not the "(perl) suffix from the ps(1)
2952 * output, because that's what ps(1) shows if the
2953 * argv[] is modified. */
2954 setproctitle("-%s", s);
2955 # else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2956 /* This doesn't really work if you assume that
2957 * $0 = 'foobar'; will wipe out 'perl' from the $0
2958 * because in ps(1) output the result will be like
2959 * sprintf("perl: %s (perl)", s)
2960 * I guess this is a security feature:
2961 * one (a user process) cannot get rid of the original name.
2963 setproctitle("%s", s);
2966 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2967 if (PL_origalen != 1) {
2969 s = SvPV_const(sv, len);
2970 un.pst_command = (char *)s;
2971 pstat(PSTAT_SETCMD, un, len, 0, 0);
2974 if (PL_origalen > 1) {
2975 /* PL_origalen is set in perl_parse(). */
2976 s = SvPV_force(sv,len);
2977 if (len >= (STRLEN)PL_origalen-1) {
2978 /* Longer than original, will be truncated. We assume that
2979 * PL_origalen bytes are available. */
2980 Copy(s, PL_origargv[0], PL_origalen-1, char);
2983 /* Shorter than original, will be padded. */
2985 /* Special case for Mac OS X: see [perl #38868] */
2988 /* Is the space counterintuitive? Yes.
2989 * (You were expecting \0?)
2990 * Does it work? Seems to. (In Linux 2.4.20 at least.)
2992 const int pad = ' ';
2994 Copy(s, PL_origargv[0], len, char);
2995 PL_origargv[0][len] = 0;
2996 memset(PL_origargv[0] + len + 1,
2997 pad, PL_origalen - len - 1);
2999 PL_origargv[0][PL_origalen-1] = 0;
3000 for (i = 1; i < PL_origargc; i++)
3002 #ifdef HAS_PRCTL_SET_NAME
3003 /* Set the legacy process name in addition to the POSIX name on Linux */
3004 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
3005 /* diag_listed_as: SKIPME */
3006 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
3011 UNLOCK_DOLLARZERO_MUTEX;
3018 Perl_whichsig_sv(pTHX_ SV *sigsv)
3022 PERL_ARGS_ASSERT_WHICHSIG_SV;
3023 PERL_UNUSED_CONTEXT;
3024 sigpv = SvPV_const(sigsv, siglen);
3025 return whichsig_pvn(sigpv, siglen);
3029 Perl_whichsig_pv(pTHX_ const char *sig)
3031 PERL_ARGS_ASSERT_WHICHSIG_PV;
3032 PERL_UNUSED_CONTEXT;
3033 return whichsig_pvn(sig, strlen(sig));
3037 Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
3039 register char* const* sigv;
3041 PERL_ARGS_ASSERT_WHICHSIG_PVN;
3042 PERL_UNUSED_CONTEXT;
3044 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
3045 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
3046 return PL_sig_num[sigv - (char* const*)PL_sig_name];
3048 if (memEQs(sig, len, "CHLD"))
3052 if (memEQs(sig, len, "CLD"))
3059 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3060 Perl_sighandler(int sig, siginfo_t *sip, void *uap)
3062 Perl_sighandler(int sig)
3065 #ifdef PERL_GET_SIG_CONTEXT
3066 dTHXa(PERL_GET_SIG_CONTEXT);
3073 SV * const tSv = PL_Sv;
3077 XPV * const tXpv = PL_Xpv;
3078 I32 old_ss_ix = PL_savestack_ix;
3081 if (!PL_psig_ptr[sig]) {
3082 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
3087 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3088 /* Max number of items pushed there is 3*n or 4. We cannot fix
3089 infinity, so we fix 4 (in fact 5): */
3090 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3092 PL_savestack_ix += 5; /* Protect save in progress. */
3093 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3096 /* sv_2cv is too complicated, try a simpler variant first: */
3097 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
3098 || SvTYPE(cv) != SVt_PVCV) {
3100 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
3103 if (!cv || !CvROOT(cv)) {
3104 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "SIG%s handler \"%s\" not defined.\n",
3105 PL_sig_name[sig], (gv ? GvENAME(gv)
3112 sv = PL_psig_name[sig]
3113 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3114 : newSVpv(PL_sig_name[sig],0);
3118 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3119 /* make sure our assumption about the size of the SAVEs are correct:
3120 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3121 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3124 PUSHSTACKi(PERLSI_SIGNAL);
3127 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3129 struct sigaction oact;
3131 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
3134 SV *rv = newRV_noinc(MUTABLE_SV(sih));
3135 /* The siginfo fields signo, code, errno, pid, uid,
3136 * addr, status, and band are defined by POSIX/SUSv3. */
3137 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3138 (void)hv_stores(sih, "code", newSViv(sip->si_code));
3139 #if 0 /* XXX TODO: Configure scan for the existence of these, but even that does not help if the SA_SIGINFO is not implemented according to the spec. */
3140 hv_stores(sih, "errno", newSViv(sip->si_errno));
3141 hv_stores(sih, "status", newSViv(sip->si_status));
3142 hv_stores(sih, "uid", newSViv(sip->si_uid));
3143 hv_stores(sih, "pid", newSViv(sip->si_pid));
3144 hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3145 hv_stores(sih, "band", newSViv(sip->si_band));
3149 mPUSHp((char *)sip, sizeof(*sip));
3157 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
3160 if (SvTRUE(ERRSV)) {
3162 /* Handler "died", for example to get out of a restart-able read().
3163 * Before we re-do that on its behalf re-enable the signal which was
3164 * blocked by the system when we entered.
3166 #ifdef HAS_SIGPROCMASK
3167 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3173 sigaddset(&set,sig);
3174 sigprocmask(SIG_UNBLOCK, &set, NULL);
3177 /* Not clear if this will work */
3178 (void)rsignal(sig, SIG_IGN);
3179 (void)rsignal(sig, PL_csighandlerp);
3181 #endif /* !PERL_MICRO */
3185 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3186 PL_savestack_ix = old_ss_ix;
3189 PL_op = myop; /* Apparently not needed... */
3191 PL_Sv = tSv; /* Restore global temporaries. */
3198 S_restore_magic(pTHX_ const void *p)
3201 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3202 SV* const sv = mgs->mgs_sv;
3208 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
3210 #ifdef PERL_OLD_COPY_ON_WRITE
3211 /* While magic was saved (and off) sv_setsv may well have seen
3212 this SV as a prime candidate for COW. */
3214 sv_force_normal_flags(sv, 0);
3217 if (mgs->mgs_readonly)
3219 if (mgs->mgs_magical)
3220 SvFLAGS(sv) |= mgs->mgs_magical;
3223 if (SvGMAGICAL(sv)) {
3224 /* downgrade public flags to private,
3225 and discard any other private flags */
3227 const U32 pubflags = SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK);
3229 SvFLAGS(sv) &= ~( pubflags | (SVp_IOK|SVp_NOK|SVp_POK) );
3230 SvFLAGS(sv) |= ( pubflags << PRIVSHIFT );
3235 bumped = mgs->mgs_bumped;
3236 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3238 /* If we're still on top of the stack, pop us off. (That condition
3239 * will be satisfied if restore_magic was called explicitly, but *not*
3240 * if it's being called via leave_scope.)
3241 * The reason for doing this is that otherwise, things like sv_2cv()
3242 * may leave alloc gunk on the savestack, and some code
3243 * (e.g. sighandler) doesn't expect that...
3245 if (PL_savestack_ix == mgs->mgs_ss_ix)
3247 UV popval = SSPOPUV;
3248 assert(popval == SAVEt_DESTRUCTOR_X);
3249 PL_savestack_ix -= 2;
3251 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3252 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
3255 if (SvREFCNT(sv) == 1) {
3256 /* We hold the last reference to this SV, which implies that the
3257 SV was deleted as a side effect of the routines we called.
3258 So artificially keep it alive a bit longer.
3259 We avoid turning on the TEMP flag, which can cause the SV's
3260 buffer to get stolen (and maybe other stuff). */
3261 int was_temp = SvTEMP(sv);
3269 SvREFCNT_dec(sv); /* undo the inc in S_save_magic() */
3273 /* clean up the mess created by Perl_sighandler().
3274 * Note that this is only called during an exit in a signal handler;
3275 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
3279 S_unwind_handler_stack(pTHX_ const void *p)
3284 PL_savestack_ix -= 5; /* Unprotect save in progress. */
3288 =for apidoc magic_sethint
3290 Triggered by a store to %^H, records the key/value pair to
3291 C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3292 anything that would need a deep copy. Maybe we should warn if we find a
3298 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3301 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3302 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3304 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3306 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3307 an alternative leaf in there, with PL_compiling.cop_hints being used if
3308 it's NULL. If needed for threads, the alternative could lock a mutex,
3309 or take other more complex action. */
3311 /* Something changed in %^H, so it will need to be restored on scope exit.
3312 Doing this here saves a lot of doing it manually in perl code (and
3313 forgetting to do it, and consequent subtle errors. */
3314 PL_hints |= HINT_LOCALIZE_HH;
3315 CopHINTHASH_set(&PL_compiling,
3316 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
3321 =for apidoc magic_clearhint
3323 Triggered by a delete from %^H, records the key to
3324 C<PL_compiling.cop_hints_hash>.
3329 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3333 PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3334 PERL_UNUSED_ARG(sv);
3336 assert(mg->mg_len == HEf_SVKEY);
3338 PERL_UNUSED_ARG(sv);
3340 PL_hints |= HINT_LOCALIZE_HH;
3341 CopHINTHASH_set(&PL_compiling,
3342 cophh_delete_sv(CopHINTHASH_get(&PL_compiling),
3343 MUTABLE_SV(mg->mg_ptr), 0, 0));
3348 =for apidoc magic_clearhints
3350 Triggered by clearing %^H, resets C<PL_compiling.cop_hints_hash>.
3355 Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3357 PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3358 PERL_UNUSED_ARG(sv);
3359 PERL_UNUSED_ARG(mg);
3360 cophh_free(CopHINTHASH_get(&PL_compiling));
3361 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
3367 * c-indentation-style: bsd
3369 * indent-tabs-mode: t
3372 * ex: set ts=8 sts=4 sw=4 noet: