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 if (PL_localizing == 1 && sv == DEFSV) return 0;
187 save_magic(mgs_ix, sv);
189 /* We must call svt_get(sv, mg) for each valid entry in the linked
190 list of magic. svt_get() may delete the current entry, add new
191 magic to the head of the list, or upgrade the SV. AMS 20010810 */
193 newmg = cur = head = mg = SvMAGIC(sv);
195 const MGVTBL * const vtbl = mg->mg_virtual;
196 MAGIC * const nextmg = mg->mg_moremagic; /* it may delete itself */
198 if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
199 vtbl->svt_get(aTHX_ sv, mg);
201 /* guard against magic having been deleted - eg FETCH calling
204 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0; /* recalculate flags */
208 /* recalculate flags if this entry was deleted. */
209 if (mg->mg_flags & MGf_GSKIP)
210 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0;
216 /* Have we finished with the new entries we saw? Start again
217 where we left off (unless there are more new entries). */
225 /* Were any new entries added? */
226 if (!have_new && (newmg = SvMAGIC(sv)) != head) {
230 (SSPTR(mgs_ix, MGS *))->mgs_magical = 0; /* recalculate flags */
234 restore_magic(INT2PTR(void *, (IV)mgs_ix));
241 Do magic after a value is assigned to the SV. See C<sv_magic>.
247 Perl_mg_set(pTHX_ SV *sv)
250 const I32 mgs_ix = SSNEW(sizeof(MGS));
254 PERL_ARGS_ASSERT_MG_SET;
256 if (PL_localizing == 2 && sv == DEFSV) return 0;
258 save_magic(mgs_ix, sv);
260 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
261 const MGVTBL* vtbl = mg->mg_virtual;
262 nextmg = mg->mg_moremagic; /* it may delete itself */
263 if (mg->mg_flags & MGf_GSKIP) {
264 mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
265 (SSPTR(mgs_ix, MGS*))->mgs_magical = 0;
267 if (PL_localizing == 2
268 && PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
270 if (vtbl && vtbl->svt_set)
271 vtbl->svt_set(aTHX_ sv, mg);
274 restore_magic(INT2PTR(void*, (IV)mgs_ix));
279 =for apidoc mg_length
281 Report on the SV's length. See C<sv_magic>.
287 Perl_mg_length(pTHX_ SV *sv)
293 PERL_ARGS_ASSERT_MG_LENGTH;
295 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
296 const MGVTBL * const vtbl = mg->mg_virtual;
297 if (vtbl && vtbl->svt_len) {
298 const I32 mgs_ix = SSNEW(sizeof(MGS));
299 save_magic(mgs_ix, sv);
300 /* omit MGf_GSKIP -- not changed here */
301 len = vtbl->svt_len(aTHX_ sv, mg);
302 restore_magic(INT2PTR(void*, (IV)mgs_ix));
308 /* You can't know whether it's UTF-8 until you get the string again...
310 const U8 *s = (U8*)SvPV_const(sv, len);
313 len = utf8_length(s, s + len);
320 Perl_mg_size(pTHX_ SV *sv)
324 PERL_ARGS_ASSERT_MG_SIZE;
326 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
327 const MGVTBL* const vtbl = mg->mg_virtual;
328 if (vtbl && vtbl->svt_len) {
329 const I32 mgs_ix = SSNEW(sizeof(MGS));
331 save_magic(mgs_ix, sv);
332 /* omit MGf_GSKIP -- not changed here */
333 len = vtbl->svt_len(aTHX_ sv, mg);
334 restore_magic(INT2PTR(void*, (IV)mgs_ix));
341 return AvFILLp((const AV *) sv); /* Fallback to non-tied array */
345 Perl_croak(aTHX_ "Size magic not implemented");
354 Clear something magical that the SV represents. See C<sv_magic>.
360 Perl_mg_clear(pTHX_ SV *sv)
362 const I32 mgs_ix = SSNEW(sizeof(MGS));
366 PERL_ARGS_ASSERT_MG_CLEAR;
368 save_magic(mgs_ix, sv);
370 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
371 const MGVTBL* const vtbl = mg->mg_virtual;
372 /* omit GSKIP -- never set here */
374 nextmg = mg->mg_moremagic; /* it may delete itself */
376 if (vtbl && vtbl->svt_clear)
377 vtbl->svt_clear(aTHX_ sv, mg);
380 restore_magic(INT2PTR(void*, (IV)mgs_ix));
385 S_mg_findext_flags(pTHX_ const SV *sv, int type, const MGVTBL *vtbl, U32 flags)
394 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
395 if (mg->mg_type == type && (!flags || mg->mg_virtual == vtbl)) {
407 Finds the magic pointer for type matching the SV. See C<sv_magic>.
413 Perl_mg_find(pTHX_ const SV *sv, int type)
415 return S_mg_findext_flags(aTHX_ sv, type, NULL, 0);
419 =for apidoc mg_findext
421 Finds the magic pointer of C<type> with the given C<vtbl> for the C<SV>. See
428 Perl_mg_findext(pTHX_ const SV *sv, int type, const MGVTBL *vtbl)
430 return S_mg_findext_flags(aTHX_ sv, type, vtbl, 1);
436 Copies the magic from one SV to another. See C<sv_magic>.
442 Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
447 PERL_ARGS_ASSERT_MG_COPY;
449 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
450 const MGVTBL* const vtbl = mg->mg_virtual;
451 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
452 count += vtbl->svt_copy(aTHX_ sv, mg, nsv, key, klen);
455 const char type = mg->mg_type;
456 if (isUPPER(type) && type != PERL_MAGIC_uvar) {
458 (type == PERL_MAGIC_tied)
460 : (type == PERL_MAGIC_regdata && mg->mg_obj)
463 toLOWER(type), key, klen);
472 =for apidoc mg_localize
474 Copy some of the magic from an existing SV to new localized version of that
475 SV. Container magic (eg %ENV, $1, tie) gets copied, value magic doesn't (eg
478 If setmagic is false then no set magic will be called on the new (empty) SV.
479 This typically means that assignment will soon follow (e.g. 'local $x = $y'),
480 and that will handle the magic.
486 Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
491 PERL_ARGS_ASSERT_MG_LOCALIZE;
496 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
497 const MGVTBL* const vtbl = mg->mg_virtual;
498 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
501 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
502 (void)vtbl->svt_local(aTHX_ nsv, mg);
504 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
505 mg->mg_ptr, mg->mg_len);
507 /* container types should remain read-only across localization */
508 if (!SvIsCOW(sv)) SvFLAGS(nsv) |= SvREADONLY(sv);
511 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
512 SvFLAGS(nsv) |= SvMAGICAL(sv);
521 #define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
523 S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
525 const MGVTBL* const vtbl = mg->mg_virtual;
526 if (vtbl && vtbl->svt_free)
527 vtbl->svt_free(aTHX_ sv, mg);
528 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
529 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
530 Safefree(mg->mg_ptr);
531 else if (mg->mg_len == HEf_SVKEY)
532 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
534 if (mg->mg_flags & MGf_REFCOUNTED)
535 SvREFCNT_dec(mg->mg_obj);
542 Free any magic storage used by the SV. See C<sv_magic>.
548 Perl_mg_free(pTHX_ SV *sv)
553 PERL_ARGS_ASSERT_MG_FREE;
555 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
556 moremagic = mg->mg_moremagic;
557 mg_free_struct(sv, mg);
558 SvMAGIC_set(sv, moremagic);
560 SvMAGIC_set(sv, NULL);
566 =for apidoc Am|void|mg_free_type|SV *sv|int how
568 Remove any magic of type I<how> from the SV I<sv>. See L</sv_magic>.
574 Perl_mg_free_type(pTHX_ SV *sv, int how)
576 MAGIC *mg, *prevmg, *moremg;
577 PERL_ARGS_ASSERT_MG_FREE_TYPE;
578 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
580 moremg = mg->mg_moremagic;
581 if (mg->mg_type == how) {
582 /* temporarily move to the head of the magic chain, in case
583 custom free code relies on this historical aspect of mg_free */
585 prevmg->mg_moremagic = moremg;
586 mg->mg_moremagic = SvMAGIC(sv);
589 newhead = mg->mg_moremagic;
590 mg_free_struct(sv, mg);
591 SvMAGIC_set(sv, newhead);
601 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
606 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
609 register const REGEXP * const rx = PM_GETRE(PL_curpm);
611 if (mg->mg_obj) { /* @+ */
612 /* return the number possible */
613 return RX_NPARENS(rx);
615 I32 paren = RX_LASTPAREN(rx);
617 /* return the last filled */
619 && (RX_OFFS(rx)[paren].start == -1
620 || RX_OFFS(rx)[paren].end == -1) )
631 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
635 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
638 register const REGEXP * const rx = PM_GETRE(PL_curpm);
640 register const I32 paren = mg->mg_len;
645 if (paren <= (I32)RX_NPARENS(rx) &&
646 (s = RX_OFFS(rx)[paren].start) != -1 &&
647 (t = RX_OFFS(rx)[paren].end) != -1)
650 if (mg->mg_obj) /* @+ */
655 if (i > 0 && RX_MATCH_UTF8(rx)) {
656 const char * const b = RX_SUBBEG(rx);
658 i = utf8_length((U8*)b, (U8*)(b+i));
669 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
671 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
674 Perl_croak_no_modify(aTHX);
675 NORETURN_FUNCTION_END;
679 Perl_magic_len(pTHX_ SV *sv, MAGIC *mg)
684 register const REGEXP * rx;
685 const char * const remaining = mg->mg_ptr + 1;
687 PERL_ARGS_ASSERT_MAGIC_LEN;
689 switch (*mg->mg_ptr) {
691 if (*remaining == '\0') { /* ^P */
693 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
695 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
699 case '\015': /* $^MATCH */
700 if (strEQ(remaining, "ATCH")) {
707 paren = RX_BUFF_IDX_PREMATCH;
711 paren = RX_BUFF_IDX_POSTMATCH;
715 paren = RX_BUFF_IDX_FULLMATCH;
717 case '1': case '2': case '3': case '4':
718 case '5': case '6': case '7': case '8': case '9':
719 paren = atoi(mg->mg_ptr);
721 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
723 i = CALLREG_NUMBUF_LENGTH((REGEXP * const)rx, sv, paren);
726 Perl_croak(aTHX_ "panic: magic_len: %"IVdf, (IV)i);
729 if (ckWARN(WARN_UNINITIALIZED))
734 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
735 paren = RX_LASTPAREN(rx);
740 case '\016': /* ^N */
741 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
742 paren = RX_LASTCLOSEPAREN(rx);
749 if (!SvPOK(sv) && SvNIOK(sv)) {
757 #define SvRTRIM(sv) STMT_START { \
759 STRLEN len = SvCUR(sv); \
760 char * const p = SvPVX(sv); \
761 while (len > 0 && isSPACE(p[len-1])) \
763 SvCUR_set(sv, len); \
769 Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
771 PERL_ARGS_ASSERT_EMULATE_COP_IO;
773 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
774 sv_setsv(sv, &PL_sv_undef);
778 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
779 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
784 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
785 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
793 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
797 register const char *s = NULL;
799 const char * const remaining = mg->mg_ptr + 1;
800 const char nextchar = *remaining;
802 PERL_ARGS_ASSERT_MAGIC_GET;
804 switch (*mg->mg_ptr) {
805 case '\001': /* ^A */
806 sv_setsv(sv, PL_bodytarget);
807 if (SvTAINTED(PL_bodytarget))
810 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
811 if (nextchar == '\0') {
812 sv_setiv(sv, (IV)PL_minus_c);
814 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
815 sv_setiv(sv, (IV)STATUS_NATIVE);
819 case '\004': /* ^D */
820 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
822 case '\005': /* ^E */
823 if (nextchar == '\0') {
826 # include <descrip.h>
827 # include <starlet.h>
829 $DESCRIPTOR(msgdsc,msg);
830 sv_setnv(sv,(NV) vaxc$errno);
831 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
832 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
837 if (!(_emx_env & 0x200)) { /* Under DOS */
838 sv_setnv(sv, (NV)errno);
839 sv_setpv(sv, errno ? Strerror(errno) : "");
841 if (errno != errno_isOS2) {
842 const int tmp = _syserrno();
843 if (tmp) /* 2nd call to _syserrno() makes it 0 */
846 sv_setnv(sv, (NV)Perl_rc);
847 sv_setpv(sv, os2error(Perl_rc));
851 const DWORD dwErr = GetLastError();
852 sv_setnv(sv, (NV)dwErr);
854 PerlProc_GetOSError(sv, dwErr);
863 sv_setnv(sv, (NV)errno);
864 sv_setpv(sv, errno ? Strerror(errno) : "");
869 SvNOK_on(sv); /* what a wonderful hack! */
871 else if (strEQ(remaining, "NCODING"))
872 sv_setsv(sv, PL_encoding);
874 case '\006': /* ^F */
875 sv_setiv(sv, (IV)PL_maxsysfd);
877 case '\007': /* ^GLOBAL_PHASE */
878 if (strEQ(remaining, "LOBAL_PHASE")) {
879 sv_setpvn(sv, PL_phase_names[PL_phase],
880 strlen(PL_phase_names[PL_phase]));
883 case '\010': /* ^H */
884 sv_setiv(sv, (IV)PL_hints);
886 case '\011': /* ^I */ /* NOT \t in EBCDIC */
887 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
889 case '\017': /* ^O & ^OPEN */
890 if (nextchar == '\0') {
891 sv_setpv(sv, PL_osname);
894 else if (strEQ(remaining, "PEN")) {
895 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
899 if (nextchar == '\0') { /* ^P */
900 sv_setiv(sv, (IV)PL_perldb);
901 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
902 goto do_prematch_fetch;
903 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
904 goto do_postmatch_fetch;
907 case '\023': /* ^S */
908 if (nextchar == '\0') {
909 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
912 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
917 case '\024': /* ^T */
918 if (nextchar == '\0') {
920 sv_setnv(sv, PL_basetime);
922 sv_setiv(sv, (IV)PL_basetime);
925 else if (strEQ(remaining, "AINT"))
926 sv_setiv(sv, PL_tainting
927 ? (PL_taint_warn || PL_unsafe ? -1 : 1)
930 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
931 if (strEQ(remaining, "NICODE"))
932 sv_setuv(sv, (UV) PL_unicode);
933 else if (strEQ(remaining, "TF8LOCALE"))
934 sv_setuv(sv, (UV) PL_utf8locale);
935 else if (strEQ(remaining, "TF8CACHE"))
936 sv_setiv(sv, (IV) PL_utf8cache);
938 case '\027': /* ^W & $^WARNING_BITS */
939 if (nextchar == '\0')
940 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
941 else if (strEQ(remaining, "ARNING_BITS")) {
942 if (PL_compiling.cop_warnings == pWARN_NONE) {
943 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
945 else if (PL_compiling.cop_warnings == pWARN_STD) {
946 sv_setsv(sv, &PL_sv_undef);
949 else if (PL_compiling.cop_warnings == pWARN_ALL) {
950 /* Get the bit mask for $warnings::Bits{all}, because
951 * it could have been extended by warnings::register */
952 HV * const bits=get_hv("warnings::Bits", 0);
954 SV ** const bits_all = hv_fetchs(bits, "all", FALSE);
956 sv_setsv(sv, *bits_all);
959 sv_setpvn(sv, WARN_ALLstring, WARNsize) ;
963 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
964 *PL_compiling.cop_warnings);
969 case '\015': /* $^MATCH */
970 if (strEQ(remaining, "ATCH")) {
971 case '1': case '2': case '3': case '4':
972 case '5': case '6': case '7': case '8': case '9': case '&':
973 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
975 * Pre-threads, this was paren = atoi(GvENAME((const GV *)mg->mg_obj));
976 * XXX Does the new way break anything?
978 paren = atoi(mg->mg_ptr); /* $& is in [0] */
979 CALLREG_NUMBUF_FETCH(rx,paren,sv);
982 sv_setsv(sv,&PL_sv_undef);
986 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
987 if (RX_LASTPAREN(rx)) {
988 CALLREG_NUMBUF_FETCH(rx,RX_LASTPAREN(rx),sv);
992 sv_setsv(sv,&PL_sv_undef);
994 case '\016': /* ^N */
995 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
996 if (RX_LASTCLOSEPAREN(rx)) {
997 CALLREG_NUMBUF_FETCH(rx,RX_LASTCLOSEPAREN(rx),sv);
1002 sv_setsv(sv,&PL_sv_undef);
1006 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1007 CALLREG_NUMBUF_FETCH(rx,-2,sv);
1010 sv_setsv(sv,&PL_sv_undef);
1014 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
1015 CALLREG_NUMBUF_FETCH(rx,-1,sv);
1018 sv_setsv(sv,&PL_sv_undef);
1021 if (GvIO(PL_last_in_gv)) {
1022 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
1027 sv_setiv(sv, (IV)STATUS_CURRENT);
1028 #ifdef COMPLEX_STATUS
1029 SvUPGRADE(sv, SVt_PVLV);
1030 LvTARGOFF(sv) = PL_statusvalue;
1031 LvTARGLEN(sv) = PL_statusvalue_vms;
1036 if (GvIOp(PL_defoutgv))
1037 s = IoTOP_NAME(GvIOp(PL_defoutgv));
1041 sv_setpv(sv,GvENAME(PL_defoutgv));
1042 sv_catpvs(sv,"_TOP");
1046 if (GvIOp(PL_defoutgv))
1047 s = IoFMT_NAME(GvIOp(PL_defoutgv));
1049 s = GvENAME(PL_defoutgv);
1053 if (GvIO(PL_defoutgv))
1054 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
1057 if (GvIO(PL_defoutgv))
1058 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
1061 if (GvIO(PL_defoutgv))
1062 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
1072 if (GvIO(PL_defoutgv))
1073 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
1077 sv_copypv(sv, PL_ors_sv);
1081 IV const pid = (IV)PerlProc_getpid();
1082 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid)
1083 /* never set manually, or at least not since last fork */
1085 /* else a value has been assigned manually, so do nothing */
1093 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
1095 sv_setnv(sv, (NV)errno);
1098 if (errno == errno_isOS2 || errno == errno_isOS2_set)
1099 sv_setpv(sv, os2error(Perl_rc));
1102 sv_setpv(sv, errno ? Strerror(errno) : "");
1104 SvPOK_on(sv); /* may have got removed during taint processing */
1109 SvNOK_on(sv); /* what a wonderful hack! */
1112 sv_setiv(sv, (IV)PL_uid);
1115 sv_setiv(sv, (IV)PL_euid);
1118 sv_setiv(sv, (IV)PL_gid);
1121 sv_setiv(sv, (IV)PL_egid);
1123 #ifdef HAS_GETGROUPS
1125 Groups_t *gary = NULL;
1126 I32 i, num_groups = getgroups(0, gary);
1127 Newx(gary, num_groups, Groups_t);
1128 num_groups = getgroups(num_groups, gary);
1129 for (i = 0; i < num_groups; i++)
1130 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1133 (void)SvIOK_on(sv); /* what a wonderful hack! */
1143 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
1145 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
1147 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1149 if (uf && uf->uf_val)
1150 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
1155 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
1158 STRLEN len = 0, klen;
1159 const char *s = SvOK(sv) ? SvPV_const(sv,len) : "";
1160 const char * const ptr = MgPV_const(mg,klen);
1163 PERL_ARGS_ASSERT_MAGIC_SETENV;
1165 #ifdef DYNAMIC_ENV_FETCH
1166 /* We just undefd an environment var. Is a replacement */
1167 /* waiting in the wings? */
1169 SV ** const valp = hv_fetch(GvHVn(PL_envgv), ptr, klen, FALSE);
1171 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
1175 #if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
1176 /* And you'll never guess what the dog had */
1177 /* in its mouth... */
1179 MgTAINTEDDIR_off(mg);
1181 if (s && klen == 8 && strEQ(ptr, "DCL$PATH")) {
1182 char pathbuf[256], eltbuf[256], *cp, *elt;
1185 my_strlcpy(eltbuf, s, sizeof(eltbuf));
1187 do { /* DCL$PATH may be a search list */
1188 while (1) { /* as may dev portion of any element */
1189 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1190 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1191 cando_by_name(S_IWUSR,0,elt) ) {
1192 MgTAINTEDDIR_on(mg);
1196 if ((cp = strchr(elt, ':')) != NULL)
1198 if (my_trnlnm(elt, eltbuf, j++))
1204 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1207 if (s && klen == 4 && strEQ(ptr,"PATH")) {
1208 const char * const strend = s + len;
1210 while (s < strend) {
1214 #ifdef VMS /* Hmm. How do we get $Config{path_sep} from C? */
1215 const char path_sep = '|';
1217 const char path_sep = ':';
1219 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
1220 s, strend, path_sep, &i);
1222 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
1224 || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1226 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1228 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1229 MgTAINTEDDIR_on(mg);
1235 #endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1241 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1243 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
1244 PERL_UNUSED_ARG(sv);
1245 my_setenv(MgPV_nolen_const(mg),NULL);
1250 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1253 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
1254 PERL_UNUSED_ARG(mg);
1256 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1258 if (PL_localizing) {
1261 hv_iterinit(MUTABLE_HV(sv));
1262 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
1264 my_setenv(hv_iterkey(entry, &keylen),
1265 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
1273 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1276 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
1277 PERL_UNUSED_ARG(sv);
1278 PERL_UNUSED_ARG(mg);
1280 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1288 #ifdef HAS_SIGPROCMASK
1290 restore_sigmask(pTHX_ SV *save_sv)
1292 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1293 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
1297 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1300 /* Are we fetching a signal entry? */
1301 int i = (I16)mg->mg_private;
1303 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1307 const char * sig = MgPV_const(mg, siglen);
1308 mg->mg_private = i = whichsig_pvn(sig, siglen);
1313 sv_setsv(sv,PL_psig_ptr[i]);
1315 Sighandler_t sigstate = rsignal_state(i);
1316 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1317 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1320 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1321 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1324 /* cache state so we don't fetch it again */
1325 if(sigstate == (Sighandler_t) SIG_IGN)
1326 sv_setpvs(sv,"IGNORE");
1328 sv_setsv(sv,&PL_sv_undef);
1329 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1336 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1338 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
1340 magic_setsig(NULL, mg);
1341 return sv_unmagic(sv, mg->mg_type);
1345 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1346 Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
1348 Perl_csighandler(int sig)
1351 #ifdef PERL_GET_SIG_CONTEXT
1352 dTHXa(PERL_GET_SIG_CONTEXT);
1356 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1357 (void) rsignal(sig, PL_csighandlerp);
1358 if (PL_sig_ignoring[sig]) return;
1360 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1361 if (PL_sig_defaulting[sig])
1362 #ifdef KILL_BY_SIGPRC
1363 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1378 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
1379 /* Call the perl level handler now--
1380 * with risk we may be in malloc() or being destructed etc. */
1381 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1382 (*PL_sighandlerp)(sig, NULL, NULL);
1384 (*PL_sighandlerp)(sig);
1387 if (!PL_psig_pend) return;
1388 /* Set a flag to say this signal is pending, that is awaiting delivery after
1389 * the current Perl opcode completes */
1390 PL_psig_pend[sig]++;
1392 #ifndef SIG_PENDING_DIE_COUNT
1393 # define SIG_PENDING_DIE_COUNT 120
1395 /* Add one to say _a_ signal is pending */
1396 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1397 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1398 (unsigned long)SIG_PENDING_DIE_COUNT);
1402 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1404 Perl_csighandler_init(void)
1407 if (PL_sig_handlers_initted) return;
1409 for (sig = 1; sig < SIG_SIZE; sig++) {
1410 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1412 PL_sig_defaulting[sig] = 1;
1413 (void) rsignal(sig, PL_csighandlerp);
1415 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1416 PL_sig_ignoring[sig] = 0;
1419 PL_sig_handlers_initted = 1;
1423 #if defined HAS_SIGPROCMASK
1425 unblock_sigmask(pTHX_ void* newset)
1427 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1432 Perl_despatch_signals(pTHX)
1437 for (sig = 1; sig < SIG_SIZE; sig++) {
1438 if (PL_psig_pend[sig]) {
1440 #ifdef HAS_SIGPROCMASK
1441 /* From sigaction(2) (FreeBSD man page):
1442 * | Signal routines normally execute with the signal that
1443 * | caused their invocation blocked, but other signals may
1445 * Emulation of this behavior (from within Perl) is enabled
1449 sigset_t newset, oldset;
1451 sigemptyset(&newset);
1452 sigaddset(&newset, sig);
1453 sigprocmask(SIG_BLOCK, &newset, &oldset);
1454 was_blocked = sigismember(&oldset, sig);
1456 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1458 SAVEFREESV(save_sv);
1459 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1462 PL_psig_pend[sig] = 0;
1463 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
1464 (*PL_sighandlerp)(sig, NULL, NULL);
1466 (*PL_sighandlerp)(sig);
1468 #ifdef HAS_SIGPROCMASK
1477 /* sv of NULL signifies that we're acting as magic_clearsig. */
1479 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1484 /* Need to be careful with SvREFCNT_dec(), because that can have side
1485 * effects (due to closures). We must make sure that the new disposition
1486 * is in place before it is called.
1490 #ifdef HAS_SIGPROCMASK
1494 register const char *s = MgPV_const(mg,len);
1496 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1499 if (memEQs(s, len, "__DIE__"))
1501 else if (memEQs(s, len, "__WARN__")
1502 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1503 /* Merge the existing behaviours, which are as follows:
1504 magic_setsig, we always set svp to &PL_warnhook
1505 (hence we always change the warnings handler)
1506 For magic_clearsig, we don't change the warnings handler if it's
1507 set to the &PL_warnhook. */
1510 SV *tmp = sv_newmortal();
1511 Perl_croak(aTHX_ "No such hook: %s",
1512 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1516 if (*svp != PERL_WARNHOOK_FATAL)
1522 i = (I16)mg->mg_private;
1524 i = whichsig_pvn(s, len); /* ...no, a brick */
1525 mg->mg_private = (U16)i;
1529 SV *tmp = sv_newmortal();
1530 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1531 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1535 #ifdef HAS_SIGPROCMASK
1536 /* Avoid having the signal arrive at a bad time, if possible. */
1539 sigprocmask(SIG_BLOCK, &set, &save);
1541 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
1542 SAVEFREESV(save_sv);
1543 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1546 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1547 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1549 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1550 PL_sig_ignoring[i] = 0;
1552 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1553 PL_sig_defaulting[i] = 0;
1555 to_dec = PL_psig_ptr[i];
1557 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1558 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1560 /* Signals don't change name during the program's execution, so once
1561 they're cached in the appropriate slot of PL_psig_name, they can
1564 Ideally we'd find some way of making SVs at (C) compile time, or
1565 at least, doing most of the work. */
1566 if (!PL_psig_name[i]) {
1567 PL_psig_name[i] = newSVpvn(s, len);
1568 SvREADONLY_on(PL_psig_name[i]);
1571 SvREFCNT_dec(PL_psig_name[i]);
1572 PL_psig_name[i] = NULL;
1573 PL_psig_ptr[i] = NULL;
1576 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
1578 (void)rsignal(i, PL_csighandlerp);
1581 *svp = SvREFCNT_inc_simple_NN(sv);
1583 if (sv && SvOK(sv)) {
1584 s = SvPV_force(sv, len);
1588 if (sv && memEQs(s, len,"IGNORE")) {
1590 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1591 PL_sig_ignoring[i] = 1;
1592 (void)rsignal(i, PL_csighandlerp);
1594 (void)rsignal(i, (Sighandler_t) SIG_IGN);
1598 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
1600 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1601 PL_sig_defaulting[i] = 1;
1602 (void)rsignal(i, PL_csighandlerp);
1604 (void)rsignal(i, (Sighandler_t) SIG_DFL);
1610 * We should warn if HINT_STRICT_REFS, but without
1611 * access to a known hint bit in a known OP, we can't
1612 * tell whether HINT_STRICT_REFS is in force or not.
1614 if (!strchr(s,':') && !strchr(s,'\''))
1615 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1618 (void)rsignal(i, PL_csighandlerp);
1620 *svp = SvREFCNT_inc_simple_NN(sv);
1624 #ifdef HAS_SIGPROCMASK
1628 SvREFCNT_dec(to_dec);
1631 #endif /* !PERL_MICRO */
1634 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1637 PERL_ARGS_ASSERT_MAGIC_SETISA;
1638 PERL_UNUSED_ARG(sv);
1640 /* Skip _isaelem because _isa will handle it shortly */
1641 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
1644 return magic_clearisa(NULL, mg);
1647 /* sv of NULL signifies that we're acting as magic_setisa. */
1649 Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1654 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1656 /* Bail out if destruction is going on */
1657 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
1660 av_clear(MUTABLE_AV(sv));
1662 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1663 /* This occurs with setisa_elem magic, which calls this
1665 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1667 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1668 SV **svp = AvARRAY((AV *)mg->mg_obj);
1669 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1671 stash = GvSTASH((GV *)*svp++);
1672 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1679 (const GV *)mg->mg_obj
1682 /* The stash may have been detached from the symbol table, so check its
1683 name before doing anything. */
1684 if (stash && HvENAME_get(stash))
1685 mro_isa_changed_in(stash);
1691 Perl_magic_setamagic(pTHX_ SV *sv, MAGIC *mg)
1694 PERL_ARGS_ASSERT_MAGIC_SETAMAGIC;
1695 PERL_UNUSED_ARG(sv);
1696 PERL_UNUSED_ARG(mg);
1697 PL_amagic_generation++;
1703 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1705 HV * const hv = MUTABLE_HV(LvTARG(sv));
1708 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
1709 PERL_UNUSED_ARG(mg);
1712 (void) hv_iterinit(hv);
1713 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1716 while (hv_iternext(hv))
1721 sv_setiv(sv, (IV)i);
1726 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1728 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
1729 PERL_UNUSED_ARG(mg);
1731 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
1737 =for apidoc magic_methcall
1739 Invoke a magic method (like FETCH).
1741 C<sv> and C<mg> are the tied thingy and the tie magic.
1743 C<meth> is the name of the method to call.
1745 C<argc> is the number of args (in addition to $self) to pass to the method.
1747 The C<flags> can be:
1749 G_DISCARD invoke method with G_DISCARD flag and don't
1751 G_UNDEF_FILL fill the stack with argc pointers to
1754 The arguments themselves are any values following the C<flags> argument.
1756 Returns the SV (if any) returned by the method, or NULL on failure.
1763 Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, const char *meth, U32 flags,
1770 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1774 if (flags & G_WRITING_TO_STDERR) {
1778 SAVESPTR(PL_stderrgv);
1782 PUSHSTACKi(PERLSI_MAGIC);
1786 PUSHs(SvTIED_obj(sv, mg));
1787 if (flags & G_UNDEF_FILL) {
1789 PUSHs(&PL_sv_undef);
1791 } else if (argc > 0) {
1793 va_start(args, argc);
1796 SV *const sv = va_arg(args, SV *);
1803 if (flags & G_DISCARD) {
1804 call_method(meth, G_SCALAR|G_DISCARD);
1807 if (call_method(meth, G_SCALAR))
1808 ret = *PL_stack_sp--;
1811 if (flags & G_WRITING_TO_STDERR)
1818 /* wrapper for magic_methcall that creates the first arg */
1821 S_magic_methcall1(pTHX_ SV *sv, const MAGIC *mg, const char *meth, U32 flags,
1827 PERL_ARGS_ASSERT_MAGIC_METHCALL1;
1830 if (mg->mg_len >= 0) {
1831 arg1 = newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
1833 else if (mg->mg_len == HEf_SVKEY)
1834 arg1 = MUTABLE_SV(mg->mg_ptr);
1836 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1837 arg1 = newSViv((IV)(mg->mg_len));
1841 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n - 1, val);
1843 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n, arg1, val);
1847 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, const char *meth)
1852 PERL_ARGS_ASSERT_MAGIC_METHPACK;
1854 ret = magic_methcall1(sv, mg, meth, 0, 1, NULL);
1861 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1863 PERL_ARGS_ASSERT_MAGIC_GETPACK;
1865 if (mg->mg_type == PERL_MAGIC_tiedelem)
1866 mg->mg_flags |= MGf_GSKIP;
1867 magic_methpack(sv,mg,"FETCH");
1872 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1878 PERL_ARGS_ASSERT_MAGIC_SETPACK;
1880 /* in the code C<$tied{foo} = $val>, the "thing" that gets passed to
1881 * STORE() is not $val, but rather a PVLV (the sv in this call), whose
1882 * public flags indicate its value based on copying from $val. Doing
1883 * mg_set() on the PVLV temporarily does SvMAGICAL_off(), then calls us.
1884 * So STORE()'s $_[2] arg is a temporarily disarmed PVLV. This goes
1885 * wrong if $val happened to be tainted, as sv hasn't got magic
1886 * enabled, even though taint magic is in the chain. In which case,
1887 * fake up a temporary tainted value (this is easier than temporarily
1888 * re-enabling magic on sv). */
1890 if (PL_tainting && (tmg = mg_find(sv, PERL_MAGIC_taint))
1891 && (tmg->mg_len & 1))
1893 val = sv_mortalcopy(sv);
1899 magic_methcall1(sv, mg, "STORE", G_DISCARD, 2, val);
1904 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1906 PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1908 if (mg->mg_type == PERL_MAGIC_tiedscalar) return 0;
1909 return magic_methpack(sv,mg,"DELETE");
1914 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1920 PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1922 retsv = magic_methcall1(sv, mg, "FETCHSIZE", 0, 1, NULL);
1924 retval = SvIV(retsv)-1;
1926 Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
1928 return (U32) retval;
1932 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1936 PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1938 Perl_magic_methcall(aTHX_ sv, mg, "CLEAR", G_DISCARD, 0);
1943 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1948 PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1950 ret = SvOK(key) ? Perl_magic_methcall(aTHX_ sv, mg, "NEXTKEY", 0, 1, key)
1951 : Perl_magic_methcall(aTHX_ sv, mg, "FIRSTKEY", 0, 0);
1958 Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
1960 PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1962 return magic_methpack(sv,mg,"EXISTS");
1966 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1970 SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1971 HV * const pkg = SvSTASH((const SV *)SvRV(tied));
1973 PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
1975 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1977 if (HvEITER_get(hv))
1978 /* we are in an iteration so the hash cannot be empty */
1980 /* no xhv_eiter so now use FIRSTKEY */
1981 key = sv_newmortal();
1982 magic_nextpack(MUTABLE_SV(hv), mg, key);
1983 HvEITER_set(hv, NULL); /* need to reset iterator */
1984 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
1987 /* there is a SCALAR method that we can call */
1988 retval = Perl_magic_methcall(aTHX_ MUTABLE_SV(hv), mg, "SCALAR", 0, 0);
1990 retval = &PL_sv_undef;
1995 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
1998 GV * const gv = PL_DBline;
1999 const I32 i = SvTRUE(sv);
2000 SV ** const svp = av_fetch(GvAV(gv),
2001 atoi(MgPV_nolen_const(mg)), FALSE);
2003 PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
2005 if (svp && SvIOKp(*svp)) {
2006 OP * const o = INT2PTR(OP*,SvIVX(*svp));
2008 /* set or clear breakpoint in the relevant control op */
2010 o->op_flags |= OPf_SPECIAL;
2012 o->op_flags &= ~OPf_SPECIAL;
2019 Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
2022 AV * const obj = MUTABLE_AV(mg->mg_obj);
2024 PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
2027 sv_setiv(sv, AvFILL(obj));
2035 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
2038 AV * const obj = MUTABLE_AV(mg->mg_obj);
2040 PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
2043 av_fill(obj, SvIV(sv));
2045 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
2046 "Attempt to set length of freed array");
2052 Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
2056 PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
2057 PERL_UNUSED_ARG(sv);
2059 /* during global destruction, mg_obj may already have been freed */
2060 if (PL_in_clean_all)
2063 mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
2066 /* arylen scalar holds a pointer back to the array, but doesn't own a
2067 reference. Hence the we (the array) are about to go away with it
2068 still pointing at us. Clear its pointer, else it would be pointing
2069 at free memory. See the comment in sv_magic about reference loops,
2070 and why it can't own a reference to us. */
2077 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
2080 SV* const lsv = LvTARG(sv);
2082 PERL_ARGS_ASSERT_MAGIC_GETPOS;
2083 PERL_UNUSED_ARG(mg);
2085 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv)) {
2086 MAGIC * const found = mg_find(lsv, PERL_MAGIC_regex_global);
2087 if (found && found->mg_len >= 0) {
2088 I32 i = found->mg_len;
2090 sv_pos_b2u(lsv, &i);
2100 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
2103 SV* const lsv = LvTARG(sv);
2109 PERL_ARGS_ASSERT_MAGIC_SETPOS;
2110 PERL_UNUSED_ARG(mg);
2112 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv))
2113 found = mg_find(lsv, PERL_MAGIC_regex_global);
2119 #ifdef PERL_OLD_COPY_ON_WRITE
2121 sv_force_normal_flags(lsv, 0);
2123 found = sv_magicext(lsv, NULL, PERL_MAGIC_regex_global, &PL_vtbl_mglob,
2126 else if (!SvOK(sv)) {
2130 len = SvPOK(lsv) ? SvCUR(lsv) : sv_len(lsv);
2135 ulen = sv_len_utf8(lsv);
2145 else if (pos > (SSize_t)len)
2150 sv_pos_u2b(lsv, &p, 0);
2154 found->mg_len = pos;
2155 found->mg_flags &= ~MGf_MINMATCH;
2161 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
2164 SV * const lsv = LvTARG(sv);
2165 const char * const tmps = SvPV_const(lsv,len);
2166 STRLEN offs = LvTARGOFF(sv);
2167 STRLEN rem = LvTARGLEN(sv);
2168 const bool negoff = LvFLAGS(sv) & 1;
2169 const bool negrem = LvFLAGS(sv) & 2;
2171 PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
2172 PERL_UNUSED_ARG(mg);
2174 if (!translate_substr_offsets(
2175 SvUTF8(lsv) ? sv_len_utf8(lsv) : len,
2176 negoff ? -(IV)offs : (IV)offs, !negoff,
2177 negrem ? -(IV)rem : (IV)rem, !negrem, &offs, &rem
2179 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR), "substr outside of string");
2180 sv_setsv_nomg(sv, &PL_sv_undef);
2185 offs = sv_pos_u2b_flags(lsv, offs, &rem, SV_CONST_RETURN);
2186 sv_setpvn(sv, tmps + offs, rem);
2193 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
2196 STRLEN len, lsv_len, oldtarglen, newtarglen;
2197 const char * const tmps = SvPV_const(sv, len);
2198 SV * const lsv = LvTARG(sv);
2199 STRLEN lvoff = LvTARGOFF(sv);
2200 STRLEN lvlen = LvTARGLEN(sv);
2201 const bool negoff = LvFLAGS(sv) & 1;
2202 const bool neglen = LvFLAGS(sv) & 2;
2204 PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
2205 PERL_UNUSED_ARG(mg);
2209 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR),
2210 "Attempt to use reference as lvalue in substr"
2212 if (SvUTF8(lsv)) lsv_len = sv_len_utf8(lsv);
2213 else (void)SvPV_nomg(lsv,lsv_len);
2214 if (!translate_substr_offsets(
2216 negoff ? -(IV)lvoff : (IV)lvoff, !negoff,
2217 neglen ? -(IV)lvlen : (IV)lvlen, !neglen, &lvoff, &lvlen
2219 Perl_croak(aTHX_ "substr outside of string");
2222 sv_utf8_upgrade(lsv);
2223 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2224 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2225 newtarglen = sv_len_utf8(sv);
2228 else if (lsv && SvUTF8(lsv)) {
2230 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
2232 utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
2233 sv_insert_flags(lsv, lvoff, lvlen, utf8, len, 0);
2237 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
2240 if (!neglen) LvTARGLEN(sv) = newtarglen;
2241 if (negoff) LvTARGOFF(sv) += newtarglen - oldtarglen;
2247 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
2251 PERL_ARGS_ASSERT_MAGIC_GETTAINT;
2252 PERL_UNUSED_ARG(sv);
2254 TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1));
2259 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
2263 PERL_ARGS_ASSERT_MAGIC_SETTAINT;
2264 PERL_UNUSED_ARG(sv);
2266 /* update taint status */
2275 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
2277 SV * const lsv = LvTARG(sv);
2279 PERL_ARGS_ASSERT_MAGIC_GETVEC;
2280 PERL_UNUSED_ARG(mg);
2283 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
2291 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
2293 PERL_ARGS_ASSERT_MAGIC_SETVEC;
2294 PERL_UNUSED_ARG(mg);
2295 do_vecset(sv); /* XXX slurp this routine */
2300 Perl_magic_setvstring(pTHX_ SV *sv, MAGIC *mg)
2302 PERL_ARGS_ASSERT_MAGIC_SETVSTRING;
2305 SV * const vecsv = sv_newmortal();
2306 scan_vstring(mg->mg_ptr, mg->mg_ptr + mg->mg_len, vecsv);
2307 if (sv_eq_flags(vecsv, sv, 0 /*nomg*/)) return 0;
2309 return sv_unmagic(sv, mg->mg_type);
2313 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2318 PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2320 if (LvTARGLEN(sv)) {
2322 SV * const ahv = LvTARG(sv);
2323 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
2328 AV *const av = MUTABLE_AV(LvTARG(sv));
2329 if ((I32)LvTARGOFF(sv) <= AvFILL(av))
2330 targ = AvARRAY(av)[LvTARGOFF(sv)];
2332 if (targ && (targ != &PL_sv_undef)) {
2333 /* somebody else defined it for us */
2334 SvREFCNT_dec(LvTARG(sv));
2335 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
2337 SvREFCNT_dec(mg->mg_obj);
2339 mg->mg_flags &= ~MGf_REFCOUNTED;
2344 sv_setsv(sv, targ ? targ : &PL_sv_undef);
2349 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
2351 PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
2352 PERL_UNUSED_ARG(mg);
2356 sv_setsv(LvTARG(sv), sv);
2357 SvSETMAGIC(LvTARG(sv));
2363 Perl_vivify_defelem(pTHX_ SV *sv)
2369 PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2371 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
2374 SV * const ahv = LvTARG(sv);
2375 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
2378 if (!value || value == &PL_sv_undef)
2379 Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
2382 AV *const av = MUTABLE_AV(LvTARG(sv));
2383 if ((I32)LvTARGLEN(sv) < 0 && (I32)LvTARGOFF(sv) > AvFILL(av))
2384 LvTARG(sv) = NULL; /* array can't be extended */
2386 SV* const * const svp = av_fetch(av, LvTARGOFF(sv), TRUE);
2387 if (!svp || (value = *svp) == &PL_sv_undef)
2388 Perl_croak(aTHX_ PL_no_aelem, (I32)LvTARGOFF(sv));
2391 SvREFCNT_inc_simple_void(value);
2392 SvREFCNT_dec(LvTARG(sv));
2395 SvREFCNT_dec(mg->mg_obj);
2397 mg->mg_flags &= ~MGf_REFCOUNTED;
2401 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
2403 PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
2404 Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2409 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
2411 PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
2412 PERL_UNUSED_CONTEXT;
2413 PERL_UNUSED_ARG(sv);
2419 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
2421 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2423 PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2425 if (uf && uf->uf_set)
2426 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2431 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2433 const char type = mg->mg_type;
2435 PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2437 if (type == PERL_MAGIC_qr) {
2438 } else if (type == PERL_MAGIC_bm) {
2441 } else if (type == PERL_MAGIC_study) {
2442 if (!isGV_with_GP(sv))
2445 assert(type == PERL_MAGIC_fm);
2447 return sv_unmagic(sv, type);
2450 #ifdef USE_LOCALE_COLLATE
2452 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2454 PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2457 * RenE<eacute> Descartes said "I think not."
2458 * and vanished with a faint plop.
2460 PERL_UNUSED_CONTEXT;
2461 PERL_UNUSED_ARG(sv);
2463 Safefree(mg->mg_ptr);
2469 #endif /* USE_LOCALE_COLLATE */
2471 /* Just clear the UTF-8 cache data. */
2473 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2475 PERL_ARGS_ASSERT_MAGIC_SETUTF8;
2476 PERL_UNUSED_CONTEXT;
2477 PERL_UNUSED_ARG(sv);
2478 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
2480 mg->mg_len = -1; /* The mg_len holds the len cache. */
2485 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2488 register const char *s;
2490 register const REGEXP * rx;
2491 const char * const remaining = mg->mg_ptr + 1;
2496 PERL_ARGS_ASSERT_MAGIC_SET;
2498 switch (*mg->mg_ptr) {
2499 case '\015': /* $^MATCH */
2500 if (strEQ(remaining, "ATCH"))
2502 case '`': /* ${^PREMATCH} caught below */
2504 paren = RX_BUFF_IDX_PREMATCH;
2506 case '\'': /* ${^POSTMATCH} caught below */
2508 paren = RX_BUFF_IDX_POSTMATCH;
2512 paren = RX_BUFF_IDX_FULLMATCH;
2514 case '1': case '2': case '3': case '4':
2515 case '5': case '6': case '7': case '8': case '9':
2516 paren = atoi(mg->mg_ptr);
2518 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2519 CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
2521 /* Croak with a READONLY error when a numbered match var is
2522 * set without a previous pattern match. Unless it's C<local $1>
2524 if (!PL_localizing) {
2525 Perl_croak_no_modify(aTHX);
2529 case '\001': /* ^A */
2530 sv_setsv(PL_bodytarget, sv);
2531 FmLINES(PL_bodytarget) = 0;
2532 if (SvPOK(PL_bodytarget)) {
2533 char *s = SvPVX(PL_bodytarget);
2534 while ( ((s = strchr(s, '\n'))) ) {
2535 FmLINES(PL_bodytarget)++;
2539 /* mg_set() has temporarily made sv non-magical */
2541 if ((tmg = mg_find(sv,PERL_MAGIC_taint)) && tmg->mg_len & 1)
2542 SvTAINTED_on(PL_bodytarget);
2544 SvTAINTED_off(PL_bodytarget);
2547 case '\003': /* ^C */
2548 PL_minus_c = cBOOL(SvIV(sv));
2551 case '\004': /* ^D */
2553 s = SvPV_nolen_const(sv);
2554 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2555 if (DEBUG_x_TEST || DEBUG_B_TEST)
2556 dump_all_perl(!DEBUG_B_TEST);
2558 PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
2561 case '\005': /* ^E */
2562 if (*(mg->mg_ptr+1) == '\0') {
2564 set_vaxc_errno(SvIV(sv));
2567 SetLastError( SvIV(sv) );
2570 os2_setsyserrno(SvIV(sv));
2572 /* will anyone ever use this? */
2573 SETERRNO(SvIV(sv), 4);
2578 else if (strEQ(mg->mg_ptr+1, "NCODING")) {
2579 SvREFCNT_dec(PL_encoding);
2580 if (SvOK(sv) || SvGMAGICAL(sv)) {
2581 PL_encoding = newSVsv(sv);
2588 case '\006': /* ^F */
2589 PL_maxsysfd = SvIV(sv);
2591 case '\010': /* ^H */
2592 PL_hints = SvIV(sv);
2594 case '\011': /* ^I */ /* NOT \t in EBCDIC */
2595 Safefree(PL_inplace);
2596 PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
2598 case '\017': /* ^O */
2599 if (*(mg->mg_ptr+1) == '\0') {
2600 Safefree(PL_osname);
2603 TAINT_PROPER("assigning to $^O");
2604 PL_osname = savesvpv(sv);
2607 else if (strEQ(mg->mg_ptr, "\017PEN")) {
2609 const char *const start = SvPV(sv, len);
2610 const char *out = (const char*)memchr(start, '\0', len);
2614 PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2615 PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
2617 /* Opening for input is more common than opening for output, so
2618 ensure that hints for input are sooner on linked list. */
2619 tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
2621 : newSVpvs_flags("", SvUTF8(sv));
2622 (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2625 tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2627 (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2631 case '\020': /* ^P */
2632 if (*remaining == '\0') { /* ^P */
2633 PL_perldb = SvIV(sv);
2634 if (PL_perldb && !PL_DBsingle)
2637 } else if (strEQ(remaining, "REMATCH")) { /* $^PREMATCH */
2639 } else if (strEQ(remaining, "OSTMATCH")) { /* $^POSTMATCH */
2643 case '\024': /* ^T */
2645 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2647 PL_basetime = (Time_t)SvIV(sv);
2650 case '\025': /* ^UTF8CACHE */
2651 if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2652 PL_utf8cache = (signed char) sv_2iv(sv);
2655 case '\027': /* ^W & $^WARNING_BITS */
2656 if (*(mg->mg_ptr+1) == '\0') {
2657 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2659 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2660 | (i ? G_WARN_ON : G_WARN_OFF) ;
2663 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2664 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2666 PL_compiling.cop_warnings = pWARN_STD;
2671 int accumulate = 0 ;
2672 int any_fatals = 0 ;
2673 const char * const ptr = SvPV_const(sv, len) ;
2674 for (i = 0 ; i < len ; ++i) {
2675 accumulate |= ptr[i] ;
2676 any_fatals |= (ptr[i] & 0xAA) ;
2679 if (!specialWARN(PL_compiling.cop_warnings))
2680 PerlMemShared_free(PL_compiling.cop_warnings);
2681 PL_compiling.cop_warnings = pWARN_NONE;
2683 /* Yuck. I can't see how to abstract this: */
2684 else if (isWARN_on(((STRLEN *)SvPV_nolen_const(sv)) - 1,
2685 WARN_ALL) && !any_fatals) {
2686 if (!specialWARN(PL_compiling.cop_warnings))
2687 PerlMemShared_free(PL_compiling.cop_warnings);
2688 PL_compiling.cop_warnings = pWARN_ALL;
2689 PL_dowarn |= G_WARN_ONCE ;
2693 const char *const p = SvPV_const(sv, len);
2695 PL_compiling.cop_warnings
2696 = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
2699 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2700 PL_dowarn |= G_WARN_ONCE ;
2708 if (PL_localizing) {
2709 if (PL_localizing == 1)
2710 SAVESPTR(PL_last_in_gv);
2712 else if (SvOK(sv) && GvIO(PL_last_in_gv))
2713 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2716 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2717 s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2718 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2721 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2722 s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2723 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
2726 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
2729 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2730 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2731 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2734 IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
2738 IO * const io = GvIO(PL_defoutgv);
2741 if ((SvIV(sv)) == 0)
2742 IoFLAGS(io) &= ~IOf_FLUSH;
2744 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2745 PerlIO *ofp = IoOFP(io);
2747 (void)PerlIO_flush(ofp);
2748 IoFLAGS(io) |= IOf_FLUSH;
2754 SvREFCNT_dec(PL_rs);
2755 PL_rs = newSVsv(sv);
2758 SvREFCNT_dec(PL_ors_sv);
2759 if (SvOK(sv) || SvGMAGICAL(sv)) {
2760 PL_ors_sv = newSVsv(sv);
2768 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2771 #ifdef COMPLEX_STATUS
2772 if (PL_localizing == 2) {
2773 SvUPGRADE(sv, SVt_PVLV);
2774 PL_statusvalue = LvTARGOFF(sv);
2775 PL_statusvalue_vms = LvTARGLEN(sv);
2779 #ifdef VMSISH_STATUS
2781 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
2784 STATUS_UNIX_EXIT_SET(SvIV(sv));
2789 # define PERL_VMS_BANG vaxc$errno
2791 # define PERL_VMS_BANG 0
2793 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2794 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2799 if (PL_delaymagic) {
2800 PL_delaymagic |= DM_RUID;
2801 break; /* don't do magic till later */
2804 (void)setruid((Uid_t)PL_uid);
2807 (void)setreuid((Uid_t)PL_uid, (Uid_t)-1);
2809 #ifdef HAS_SETRESUID
2810 (void)setresuid((Uid_t)PL_uid, (Uid_t)-1, (Uid_t)-1);
2812 if (PL_uid == PL_euid) { /* special case $< = $> */
2814 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2815 if (PL_uid != 0 && PerlProc_getuid() == 0)
2816 (void)PerlProc_setuid(0);
2818 (void)PerlProc_setuid(PL_uid);
2820 PL_uid = PerlProc_getuid();
2821 Perl_croak(aTHX_ "setruid() not implemented");
2826 PL_uid = PerlProc_getuid();
2830 if (PL_delaymagic) {
2831 PL_delaymagic |= DM_EUID;
2832 break; /* don't do magic till later */
2835 (void)seteuid((Uid_t)PL_euid);
2838 (void)setreuid((Uid_t)-1, (Uid_t)PL_euid);
2840 #ifdef HAS_SETRESUID
2841 (void)setresuid((Uid_t)-1, (Uid_t)PL_euid, (Uid_t)-1);
2843 if (PL_euid == PL_uid) /* special case $> = $< */
2844 PerlProc_setuid(PL_euid);
2846 PL_euid = PerlProc_geteuid();
2847 Perl_croak(aTHX_ "seteuid() not implemented");
2852 PL_euid = PerlProc_geteuid();
2856 if (PL_delaymagic) {
2857 PL_delaymagic |= DM_RGID;
2858 break; /* don't do magic till later */
2861 (void)setrgid((Gid_t)PL_gid);
2864 (void)setregid((Gid_t)PL_gid, (Gid_t)-1);
2866 #ifdef HAS_SETRESGID
2867 (void)setresgid((Gid_t)PL_gid, (Gid_t)-1, (Gid_t) -1);
2869 if (PL_gid == PL_egid) /* special case $( = $) */
2870 (void)PerlProc_setgid(PL_gid);
2872 PL_gid = PerlProc_getgid();
2873 Perl_croak(aTHX_ "setrgid() not implemented");
2878 PL_gid = PerlProc_getgid();
2881 #ifdef HAS_SETGROUPS
2883 const char *p = SvPV_const(sv, len);
2884 Groups_t *gary = NULL;
2885 #ifdef _SC_NGROUPS_MAX
2886 int maxgrp = sysconf(_SC_NGROUPS_MAX);
2891 int maxgrp = NGROUPS;
2897 for (i = 0; i < maxgrp; ++i) {
2898 while (*p && !isSPACE(*p))
2905 Newx(gary, i + 1, Groups_t);
2907 Renew(gary, i + 1, Groups_t);
2911 (void)setgroups(i, gary);
2914 #else /* HAS_SETGROUPS */
2916 #endif /* HAS_SETGROUPS */
2917 if (PL_delaymagic) {
2918 PL_delaymagic |= DM_EGID;
2919 break; /* don't do magic till later */
2922 (void)setegid((Gid_t)PL_egid);
2925 (void)setregid((Gid_t)-1, (Gid_t)PL_egid);
2927 #ifdef HAS_SETRESGID
2928 (void)setresgid((Gid_t)-1, (Gid_t)PL_egid, (Gid_t)-1);
2930 if (PL_egid == PL_gid) /* special case $) = $( */
2931 (void)PerlProc_setgid(PL_egid);
2933 PL_egid = PerlProc_getegid();
2934 Perl_croak(aTHX_ "setegid() not implemented");
2939 PL_egid = PerlProc_getegid();
2942 PL_chopset = SvPV_force(sv,len);
2945 /* Store the pid in mg->mg_obj so we can tell when a fork has
2946 occurred. mg->mg_obj points to *$ by default, so clear it. */
2947 if (isGV(mg->mg_obj)) {
2948 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
2949 SvREFCNT_dec(mg->mg_obj);
2950 mg->mg_flags |= MGf_REFCOUNTED;
2951 mg->mg_obj = newSViv((IV)PerlProc_getpid());
2953 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
2956 LOCK_DOLLARZERO_MUTEX;
2957 #ifdef HAS_SETPROCTITLE
2958 /* The BSDs don't show the argv[] in ps(1) output, they
2959 * show a string from the process struct and provide
2960 * the setproctitle() routine to manipulate that. */
2961 if (PL_origalen != 1) {
2962 s = SvPV_const(sv, len);
2963 # if __FreeBSD_version > 410001
2964 /* The leading "-" removes the "perl: " prefix,
2965 * but not the "(perl) suffix from the ps(1)
2966 * output, because that's what ps(1) shows if the
2967 * argv[] is modified. */
2968 setproctitle("-%s", s);
2969 # else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2970 /* This doesn't really work if you assume that
2971 * $0 = 'foobar'; will wipe out 'perl' from the $0
2972 * because in ps(1) output the result will be like
2973 * sprintf("perl: %s (perl)", s)
2974 * I guess this is a security feature:
2975 * one (a user process) cannot get rid of the original name.
2977 setproctitle("%s", s);
2980 #elif defined(__hpux) && defined(PSTAT_SETCMD)
2981 if (PL_origalen != 1) {
2983 s = SvPV_const(sv, len);
2984 un.pst_command = (char *)s;
2985 pstat(PSTAT_SETCMD, un, len, 0, 0);
2988 if (PL_origalen > 1) {
2989 /* PL_origalen is set in perl_parse(). */
2990 s = SvPV_force(sv,len);
2991 if (len >= (STRLEN)PL_origalen-1) {
2992 /* Longer than original, will be truncated. We assume that
2993 * PL_origalen bytes are available. */
2994 Copy(s, PL_origargv[0], PL_origalen-1, char);
2997 /* Shorter than original, will be padded. */
2999 /* Special case for Mac OS X: see [perl #38868] */
3002 /* Is the space counterintuitive? Yes.
3003 * (You were expecting \0?)
3004 * Does it work? Seems to. (In Linux 2.4.20 at least.)
3006 const int pad = ' ';
3008 Copy(s, PL_origargv[0], len, char);
3009 PL_origargv[0][len] = 0;
3010 memset(PL_origargv[0] + len + 1,
3011 pad, PL_origalen - len - 1);
3013 PL_origargv[0][PL_origalen-1] = 0;
3014 for (i = 1; i < PL_origargc; i++)
3016 #ifdef HAS_PRCTL_SET_NAME
3017 /* Set the legacy process name in addition to the POSIX name on Linux */
3018 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
3019 /* diag_listed_as: SKIPME */
3020 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
3025 UNLOCK_DOLLARZERO_MUTEX;
3032 Perl_whichsig_sv(pTHX_ SV *sigsv)
3036 PERL_ARGS_ASSERT_WHICHSIG_SV;
3037 PERL_UNUSED_CONTEXT;
3038 sigpv = SvPV_const(sigsv, siglen);
3039 return whichsig_pvn(sigpv, siglen);
3043 Perl_whichsig_pv(pTHX_ const char *sig)
3045 PERL_ARGS_ASSERT_WHICHSIG_PV;
3046 PERL_UNUSED_CONTEXT;
3047 return whichsig_pvn(sig, strlen(sig));
3051 Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
3053 register char* const* sigv;
3055 PERL_ARGS_ASSERT_WHICHSIG_PVN;
3056 PERL_UNUSED_CONTEXT;
3058 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
3059 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
3060 return PL_sig_num[sigv - (char* const*)PL_sig_name];
3062 if (memEQs(sig, len, "CHLD"))
3066 if (memEQs(sig, len, "CLD"))
3073 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3074 Perl_sighandler(int sig, siginfo_t *sip, void *uap)
3076 Perl_sighandler(int sig)
3079 #ifdef PERL_GET_SIG_CONTEXT
3080 dTHXa(PERL_GET_SIG_CONTEXT);
3087 SV * const tSv = PL_Sv;
3091 XPV * const tXpv = PL_Xpv;
3092 I32 old_ss_ix = PL_savestack_ix;
3095 if (!PL_psig_ptr[sig]) {
3096 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
3101 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3102 /* Max number of items pushed there is 3*n or 4. We cannot fix
3103 infinity, so we fix 4 (in fact 5): */
3104 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3106 PL_savestack_ix += 5; /* Protect save in progress. */
3107 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3110 /* sv_2cv is too complicated, try a simpler variant first: */
3111 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
3112 || SvTYPE(cv) != SVt_PVCV) {
3114 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
3117 if (!cv || !CvROOT(cv)) {
3118 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "SIG%s handler \"%s\" not defined.\n",
3119 PL_sig_name[sig], (gv ? GvENAME(gv)
3126 sv = PL_psig_name[sig]
3127 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3128 : newSVpv(PL_sig_name[sig],0);
3132 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3133 /* make sure our assumption about the size of the SAVEs are correct:
3134 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3135 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3138 PUSHSTACKi(PERLSI_SIGNAL);
3141 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3143 struct sigaction oact;
3145 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
3148 SV *rv = newRV_noinc(MUTABLE_SV(sih));
3149 /* The siginfo fields signo, code, errno, pid, uid,
3150 * addr, status, and band are defined by POSIX/SUSv3. */
3151 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3152 (void)hv_stores(sih, "code", newSViv(sip->si_code));
3153 #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. */
3154 hv_stores(sih, "errno", newSViv(sip->si_errno));
3155 hv_stores(sih, "status", newSViv(sip->si_status));
3156 hv_stores(sih, "uid", newSViv(sip->si_uid));
3157 hv_stores(sih, "pid", newSViv(sip->si_pid));
3158 hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3159 hv_stores(sih, "band", newSViv(sip->si_band));
3163 mPUSHp((char *)sip, sizeof(*sip));
3171 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
3174 if (SvTRUE(ERRSV)) {
3176 /* Handler "died", for example to get out of a restart-able read().
3177 * Before we re-do that on its behalf re-enable the signal which was
3178 * blocked by the system when we entered.
3180 #ifdef HAS_SIGPROCMASK
3181 #if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3187 sigaddset(&set,sig);
3188 sigprocmask(SIG_UNBLOCK, &set, NULL);
3191 /* Not clear if this will work */
3192 (void)rsignal(sig, SIG_IGN);
3193 (void)rsignal(sig, PL_csighandlerp);
3195 #endif /* !PERL_MICRO */
3199 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3200 PL_savestack_ix = old_ss_ix;
3203 PL_op = myop; /* Apparently not needed... */
3205 PL_Sv = tSv; /* Restore global temporaries. */
3212 S_restore_magic(pTHX_ const void *p)
3215 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3216 SV* const sv = mgs->mgs_sv;
3222 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
3224 #ifdef PERL_OLD_COPY_ON_WRITE
3225 /* While magic was saved (and off) sv_setsv may well have seen
3226 this SV as a prime candidate for COW. */
3228 sv_force_normal_flags(sv, 0);
3231 if (mgs->mgs_readonly)
3233 if (mgs->mgs_magical)
3234 SvFLAGS(sv) |= mgs->mgs_magical;
3237 if (SvGMAGICAL(sv)) {
3238 /* downgrade public flags to private,
3239 and discard any other private flags */
3241 const U32 pubflags = SvFLAGS(sv) & (SVf_IOK|SVf_NOK|SVf_POK);
3243 SvFLAGS(sv) &= ~( pubflags | (SVp_IOK|SVp_NOK|SVp_POK) );
3244 SvFLAGS(sv) |= ( pubflags << PRIVSHIFT );
3249 bumped = mgs->mgs_bumped;
3250 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3252 /* If we're still on top of the stack, pop us off. (That condition
3253 * will be satisfied if restore_magic was called explicitly, but *not*
3254 * if it's being called via leave_scope.)
3255 * The reason for doing this is that otherwise, things like sv_2cv()
3256 * may leave alloc gunk on the savestack, and some code
3257 * (e.g. sighandler) doesn't expect that...
3259 if (PL_savestack_ix == mgs->mgs_ss_ix)
3261 UV popval = SSPOPUV;
3262 assert(popval == SAVEt_DESTRUCTOR_X);
3263 PL_savestack_ix -= 2;
3265 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3266 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
3269 if (SvREFCNT(sv) == 1) {
3270 /* We hold the last reference to this SV, which implies that the
3271 SV was deleted as a side effect of the routines we called.
3272 So artificially keep it alive a bit longer.
3273 We avoid turning on the TEMP flag, which can cause the SV's
3274 buffer to get stolen (and maybe other stuff). */
3275 int was_temp = SvTEMP(sv);
3283 SvREFCNT_dec(sv); /* undo the inc in S_save_magic() */
3287 /* clean up the mess created by Perl_sighandler().
3288 * Note that this is only called during an exit in a signal handler;
3289 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
3293 S_unwind_handler_stack(pTHX_ const void *p)
3298 PL_savestack_ix -= 5; /* Unprotect save in progress. */
3302 =for apidoc magic_sethint
3304 Triggered by a store to %^H, records the key/value pair to
3305 C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3306 anything that would need a deep copy. Maybe we should warn if we find a
3312 Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3315 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
3316 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
3318 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3320 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3321 an alternative leaf in there, with PL_compiling.cop_hints being used if
3322 it's NULL. If needed for threads, the alternative could lock a mutex,
3323 or take other more complex action. */
3325 /* Something changed in %^H, so it will need to be restored on scope exit.
3326 Doing this here saves a lot of doing it manually in perl code (and
3327 forgetting to do it, and consequent subtle errors. */
3328 PL_hints |= HINT_LOCALIZE_HH;
3329 CopHINTHASH_set(&PL_compiling,
3330 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
3335 =for apidoc magic_clearhint
3337 Triggered by a delete from %^H, records the key to
3338 C<PL_compiling.cop_hints_hash>.
3343 Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3347 PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
3348 PERL_UNUSED_ARG(sv);
3350 assert(mg->mg_len == HEf_SVKEY);
3352 PERL_UNUSED_ARG(sv);
3354 PL_hints |= HINT_LOCALIZE_HH;
3355 CopHINTHASH_set(&PL_compiling,
3356 cophh_delete_sv(CopHINTHASH_get(&PL_compiling),
3357 MUTABLE_SV(mg->mg_ptr), 0, 0));
3362 =for apidoc magic_clearhints
3364 Triggered by clearing %^H, resets C<PL_compiling.cop_hints_hash>.
3369 Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3371 PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3372 PERL_UNUSED_ARG(sv);
3373 PERL_UNUSED_ARG(mg);
3374 cophh_free(CopHINTHASH_get(&PL_compiling));
3375 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
3381 * c-indentation-style: bsd
3383 * indent-tabs-mode: t
3386 * ex: set ts=8 sts=4 sw=4 noet: