3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4 * 2000, 2001, 2002, 2003, 2004, 2005 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."
17 =head1 Magical Functions
19 "Magic" is special data attached to SV structures in order to give them
20 "magical" properties. When any Perl code tries to read from, or assign to,
21 an SV marked as magical, it calls the 'get' or 'set' function associated
22 with that SV's magic. A get is called prior to reading an SV, in order to
23 give it a chance to update its internal value (get on $. writes the line
24 number of the last read filehandle into to the SV's IV slot), while
25 set is called after an SV has been written to, in order to allow it to make
26 use of its changed value (set on $/ copies the SV's new value to the
27 PL_rs global variable).
29 Magic is implemented as a linked list of MAGIC structures attached to the
30 SV. Each MAGIC struct holds the type of the magic, a pointer to an array
31 of functions that implement the get(), set(), length() etc functions,
32 plus space for some flags and pointers. For example, a tied variable has
33 a MAGIC structure that contains a pointer to the object associated with the
42 #if defined(HAS_GETGROUPS) || defined(HAS_SETGROUPS)
52 # include <sys/pstat.h>
55 Signal_t Perl_csighandler(int sig);
57 static void restore_magic(pTHX_ const void *p);
58 static void unwind_handler_stack(pTHX_ const void *p);
61 /* Missing protos on LynxOS */
62 void setruid(uid_t id);
63 void seteuid(uid_t id);
64 void setrgid(uid_t id);
65 void setegid(uid_t id);
69 * Use the "DESTRUCTOR" scope cleanup to reinstate magic.
77 /* MGS is typedef'ed to struct magic_state in perl.h */
80 S_save_magic(pTHX_ I32 mgs_ix, SV *sv)
83 assert(SvMAGICAL(sv));
84 #ifdef PERL_OLD_COPY_ON_WRITE
85 /* Turning READONLY off for a copy-on-write scalar is a bad idea. */
90 SAVEDESTRUCTOR_X(restore_magic, INT2PTR(void*, (IV)mgs_ix));
92 mgs = SSPTR(mgs_ix, MGS*);
94 mgs->mgs_flags = SvMAGICAL(sv) | SvREADONLY(sv);
95 mgs->mgs_ss_ix = PL_savestack_ix; /* points after the saved destructor */
99 SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_NOK|SVp_POK)) >> PRIVSHIFT;
103 =for apidoc mg_magical
105 Turns on the magical status of an SV. See C<sv_magic>.
111 Perl_mg_magical(pTHX_ SV *sv)
114 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
115 const MGVTBL* const vtbl = mg->mg_virtual;
117 if (vtbl->svt_get && !(mg->mg_flags & MGf_GSKIP))
121 if (!(SvFLAGS(sv) & (SVs_GMG|SVs_SMG)) || vtbl->svt_clear)
130 Do magic after a value is retrieved from the SV. See C<sv_magic>.
136 Perl_mg_get(pTHX_ SV *sv)
138 const I32 mgs_ix = SSNEW(sizeof(MGS));
139 const bool was_temp = (bool)SvTEMP(sv);
141 MAGIC *newmg, *head, *cur, *mg;
142 /* guard against sv having being freed midway by holding a private
145 /* sv_2mortal has this side effect of turning on the TEMP flag, which can
146 cause the SV's buffer to get stolen (and maybe other stuff).
149 sv_2mortal(SvREFCNT_inc(sv));
154 save_magic(mgs_ix, sv);
156 /* We must call svt_get(sv, mg) for each valid entry in the linked
157 list of magic. svt_get() may delete the current entry, add new
158 magic to the head of the list, or upgrade the SV. AMS 20010810 */
160 newmg = cur = head = mg = SvMAGIC(sv);
162 const MGVTBL * const vtbl = mg->mg_virtual;
164 if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
165 CALL_FPTR(vtbl->svt_get)(aTHX_ sv, mg);
167 /* guard against magic having been deleted - eg FETCH calling
172 /* Don't restore the flags for this entry if it was deleted. */
173 if (mg->mg_flags & MGf_GSKIP)
174 (SSPTR(mgs_ix, MGS *))->mgs_flags = 0;
177 mg = mg->mg_moremagic;
180 /* Have we finished with the new entries we saw? Start again
181 where we left off (unless there are more new entries). */
189 /* Were any new entries added? */
190 if (!have_new && (newmg = SvMAGIC(sv)) != head) {
197 restore_magic(aTHX_ INT2PTR(void *, (IV)mgs_ix));
199 if (SvREFCNT(sv) == 1) {
200 /* We hold the last reference to this SV, which implies that the
201 SV was deleted as a side effect of the routines we called. */
210 Do magic after a value is assigned to the SV. See C<sv_magic>.
216 Perl_mg_set(pTHX_ SV *sv)
218 const I32 mgs_ix = SSNEW(sizeof(MGS));
222 save_magic(mgs_ix, sv);
224 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
225 const MGVTBL* vtbl = mg->mg_virtual;
226 nextmg = mg->mg_moremagic; /* it may delete itself */
227 if (mg->mg_flags & MGf_GSKIP) {
228 mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
229 (SSPTR(mgs_ix, MGS*))->mgs_flags = 0;
231 if (vtbl && vtbl->svt_set)
232 CALL_FPTR(vtbl->svt_set)(aTHX_ sv, mg);
235 restore_magic(aTHX_ INT2PTR(void*, (IV)mgs_ix));
240 =for apidoc mg_length
242 Report on the SV's length. See C<sv_magic>.
248 Perl_mg_length(pTHX_ SV *sv)
253 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
254 const MGVTBL * const vtbl = mg->mg_virtual;
255 if (vtbl && vtbl->svt_len) {
256 const I32 mgs_ix = SSNEW(sizeof(MGS));
257 save_magic(mgs_ix, sv);
258 /* omit MGf_GSKIP -- not changed here */
259 len = CALL_FPTR(vtbl->svt_len)(aTHX_ sv, mg);
260 restore_magic(aTHX_ INT2PTR(void*, (IV)mgs_ix));
266 const U8 *s = (U8*)SvPV_const(sv, len);
267 len = Perl_utf8_length(aTHX_ s, s + len);
270 (void)SvPV_const(sv, len);
275 Perl_mg_size(pTHX_ SV *sv)
279 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
280 const MGVTBL* const vtbl = mg->mg_virtual;
281 if (vtbl && vtbl->svt_len) {
282 const I32 mgs_ix = SSNEW(sizeof(MGS));
284 save_magic(mgs_ix, sv);
285 /* omit MGf_GSKIP -- not changed here */
286 len = CALL_FPTR(vtbl->svt_len)(aTHX_ sv, mg);
287 restore_magic(aTHX_ INT2PTR(void*, (IV)mgs_ix));
294 return AvFILLp((AV *) sv); /* Fallback to non-tied array */
298 Perl_croak(aTHX_ "Size magic not implemented");
307 Clear something magical that the SV represents. See C<sv_magic>.
313 Perl_mg_clear(pTHX_ SV *sv)
315 const I32 mgs_ix = SSNEW(sizeof(MGS));
318 save_magic(mgs_ix, sv);
320 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
321 const MGVTBL* const vtbl = mg->mg_virtual;
322 /* omit GSKIP -- never set here */
324 if (vtbl && vtbl->svt_clear)
325 CALL_FPTR(vtbl->svt_clear)(aTHX_ sv, mg);
328 restore_magic(aTHX_ INT2PTR(void*, (IV)mgs_ix));
335 Finds the magic pointer for type matching the SV. See C<sv_magic>.
341 Perl_mg_find(pTHX_ const SV *sv, int type)
345 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
346 if (mg->mg_type == type)
356 Copies the magic from one SV to another. See C<sv_magic>.
362 Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
366 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
367 const MGVTBL* const vtbl = mg->mg_virtual;
368 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
369 count += CALL_FPTR(vtbl->svt_copy)(aTHX_ sv, mg, nsv, key, klen);
371 else if (isUPPER(mg->mg_type)) {
373 mg->mg_type == PERL_MAGIC_tied ? SvTIED_obj(sv, mg) :
374 (mg->mg_type == PERL_MAGIC_regdata && mg->mg_obj)
376 toLOWER(mg->mg_type), key, klen);
386 Free any magic storage used by the SV. See C<sv_magic>.
392 Perl_mg_free(pTHX_ SV *sv)
396 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
397 const MGVTBL* const vtbl = mg->mg_virtual;
398 moremagic = mg->mg_moremagic;
399 if (vtbl && vtbl->svt_free)
400 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
401 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
402 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
403 Safefree(mg->mg_ptr);
404 else if (mg->mg_len == HEf_SVKEY)
405 SvREFCNT_dec((SV*)mg->mg_ptr);
407 if (mg->mg_flags & MGf_REFCOUNTED)
408 SvREFCNT_dec(mg->mg_obj);
411 SvMAGIC_set(sv, NULL);
418 Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
420 register const REGEXP *rx;
423 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
424 if (mg->mg_obj) /* @+ */
427 return rx->lastparen;
434 Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
438 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
439 register const I32 paren = mg->mg_len;
444 if (paren <= (I32)rx->nparens &&
445 (s = rx->startp[paren]) != -1 &&
446 (t = rx->endp[paren]) != -1)
449 if (mg->mg_obj) /* @+ */
454 if (i > 0 && RX_MATCH_UTF8(rx)) {
455 char *b = rx->subbeg;
457 i = Perl_utf8_length(aTHX_ (U8*)b, (U8*)(b+i));
467 Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
470 Perl_croak(aTHX_ PL_no_modify);
471 NORETURN_FUNCTION_END;
475 Perl_magic_len(pTHX_ SV *sv, MAGIC *mg)
479 register const REGEXP *rx;
482 switch (*mg->mg_ptr) {
483 case '1': case '2': case '3': case '4':
484 case '5': case '6': case '7': case '8': case '9': case '&':
485 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
487 paren = atoi(mg->mg_ptr); /* $& is in [0] */
489 if (paren <= (I32)rx->nparens &&
490 (s1 = rx->startp[paren]) != -1 &&
491 (t1 = rx->endp[paren]) != -1)
495 if (i > 0 && RX_MATCH_UTF8(rx)) {
496 char *s = rx->subbeg + s1;
501 if (is_utf8_string_loclen((U8*)s, i, &ep, &el))
505 Perl_croak(aTHX_ "panic: magic_len: %"IVdf, (IV)i);
509 if (ckWARN(WARN_UNINITIALIZED))
514 if (ckWARN(WARN_UNINITIALIZED))
519 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
520 paren = rx->lastparen;
525 case '\016': /* ^N */
526 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
527 paren = rx->lastcloseparen;
533 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
534 if (rx->startp[0] != -1) {
545 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
546 if (rx->endp[0] != -1) {
547 i = rx->sublen - rx->endp[0];
558 if (!SvPOK(sv) && SvNIOK(sv)) {
567 Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
571 register char *s = NULL;
575 switch (*mg->mg_ptr) {
576 case '\001': /* ^A */
577 sv_setsv(sv, PL_bodytarget);
579 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
580 if (*(mg->mg_ptr+1) == '\0') {
581 sv_setiv(sv, (IV)PL_minus_c);
583 else if (strEQ(mg->mg_ptr, "\003HILD_ERROR_NATIVE")) {
584 sv_setiv(sv, (IV)STATUS_NATIVE);
588 case '\004': /* ^D */
589 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
591 case '\005': /* ^E */
592 if (*(mg->mg_ptr+1) == '\0') {
593 #ifdef MACOS_TRADITIONAL
597 sv_setnv(sv,(double)gMacPerl_OSErr);
598 sv_setpv(sv, gMacPerl_OSErr ? GetSysErrText(gMacPerl_OSErr, msg) : "");
603 # include <descrip.h>
604 # include <starlet.h>
606 $DESCRIPTOR(msgdsc,msg);
607 sv_setnv(sv,(NV) vaxc$errno);
608 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
609 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
615 if (!(_emx_env & 0x200)) { /* Under DOS */
616 sv_setnv(sv, (NV)errno);
617 sv_setpv(sv, errno ? Strerror(errno) : "");
619 if (errno != errno_isOS2) {
620 int tmp = _syserrno();
621 if (tmp) /* 2nd call to _syserrno() makes it 0 */
624 sv_setnv(sv, (NV)Perl_rc);
625 sv_setpv(sv, os2error(Perl_rc));
630 DWORD dwErr = GetLastError();
631 sv_setnv(sv, (NV)dwErr);
634 PerlProc_GetOSError(sv, dwErr);
637 sv_setpvn(sv, "", 0);
642 int saveerrno = errno;
643 sv_setnv(sv, (NV)errno);
644 sv_setpv(sv, errno ? Strerror(errno) : "");
651 SvNOK_on(sv); /* what a wonderful hack! */
653 else if (strEQ(mg->mg_ptr+1, "NCODING"))
654 sv_setsv(sv, PL_encoding);
656 case '\006': /* ^F */
657 sv_setiv(sv, (IV)PL_maxsysfd);
659 case '\010': /* ^H */
660 sv_setiv(sv, (IV)PL_hints);
662 case '\011': /* ^I */ /* NOT \t in EBCDIC */
664 sv_setpv(sv, PL_inplace);
666 sv_setsv(sv, &PL_sv_undef);
668 case '\017': /* ^O & ^OPEN */
669 if (*(mg->mg_ptr+1) == '\0') {
670 sv_setpv(sv, PL_osname);
673 else if (strEQ(mg->mg_ptr, "\017PEN")) {
674 if (!PL_compiling.cop_io)
675 sv_setsv(sv, &PL_sv_undef);
677 sv_setsv(sv, PL_compiling.cop_io);
681 case '\020': /* ^P */
682 sv_setiv(sv, (IV)PL_perldb);
684 case '\023': /* ^S */
685 if (*(mg->mg_ptr+1) == '\0') {
686 if (PL_lex_state != LEX_NOTPARSING)
689 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
694 case '\024': /* ^T */
695 if (*(mg->mg_ptr+1) == '\0') {
697 sv_setnv(sv, PL_basetime);
699 sv_setiv(sv, (IV)PL_basetime);
702 else if (strEQ(mg->mg_ptr, "\024AINT"))
703 sv_setiv(sv, PL_tainting
704 ? (PL_taint_warn || PL_unsafe ? -1 : 1)
707 case '\025': /* $^UNICODE, $^UTF8LOCALE */
708 if (strEQ(mg->mg_ptr, "\025NICODE"))
709 sv_setuv(sv, (UV) PL_unicode);
710 else if (strEQ(mg->mg_ptr, "\025TF8LOCALE"))
711 sv_setuv(sv, (UV) PL_utf8locale);
713 case '\027': /* ^W & $^WARNING_BITS */
714 if (*(mg->mg_ptr+1) == '\0')
715 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
716 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
717 if (PL_compiling.cop_warnings == pWARN_NONE ||
718 PL_compiling.cop_warnings == pWARN_STD)
720 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
722 else if (PL_compiling.cop_warnings == pWARN_ALL) {
723 /* Get the bit mask for $warnings::Bits{all}, because
724 * it could have been extended by warnings::register */
726 HV *bits=get_hv("warnings::Bits", FALSE);
727 if (bits && (bits_all=hv_fetch(bits, "all", 3, FALSE))) {
728 sv_setsv(sv, *bits_all);
731 sv_setpvn(sv, WARN_ALLstring, WARNsize) ;
735 sv_setsv(sv, PL_compiling.cop_warnings);
740 case '1': case '2': case '3': case '4':
741 case '5': case '6': case '7': case '8': case '9': case '&':
742 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
746 * Pre-threads, this was paren = atoi(GvENAME((GV*)mg->mg_obj));
747 * XXX Does the new way break anything?
749 paren = atoi(mg->mg_ptr); /* $& is in [0] */
751 if (paren <= (I32)rx->nparens &&
752 (s1 = rx->startp[paren]) != -1 &&
753 (t1 = rx->endp[paren]) != -1)
763 if (RX_MATCH_UTF8(rx) && is_utf8_string((U8*)s, i))
768 if (RX_MATCH_TAINTED(rx)) {
769 MAGIC* mg = SvMAGIC(sv);
772 SvMAGIC_set(sv, mg->mg_moremagic);
774 if ((mgt = SvMAGIC(sv))) {
775 mg->mg_moremagic = mgt;
785 sv_setsv(sv,&PL_sv_undef);
788 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
789 paren = rx->lastparen;
793 sv_setsv(sv,&PL_sv_undef);
795 case '\016': /* ^N */
796 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
797 paren = rx->lastcloseparen;
801 sv_setsv(sv,&PL_sv_undef);
804 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
805 if ((s = rx->subbeg) && rx->startp[0] != -1) {
810 sv_setsv(sv,&PL_sv_undef);
813 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
814 if (rx->subbeg && rx->endp[0] != -1) {
815 s = rx->subbeg + rx->endp[0];
816 i = rx->sublen - rx->endp[0];
820 sv_setsv(sv,&PL_sv_undef);
823 if (GvIO(PL_last_in_gv)) {
824 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
829 sv_setiv(sv, (IV)STATUS_CURRENT);
830 #ifdef COMPLEX_STATUS
831 LvTARGOFF(sv) = PL_statusvalue;
832 LvTARGLEN(sv) = PL_statusvalue_vms;
837 if (GvIOp(PL_defoutgv))
838 s = IoTOP_NAME(GvIOp(PL_defoutgv));
842 sv_setpv(sv,GvENAME(PL_defoutgv));
847 if (GvIOp(PL_defoutgv))
848 s = IoFMT_NAME(GvIOp(PL_defoutgv));
850 s = GvENAME(PL_defoutgv);
854 if (GvIOp(PL_defoutgv))
855 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
858 if (GvIOp(PL_defoutgv))
859 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
862 if (GvIOp(PL_defoutgv))
863 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
870 WITH_THR(sv_setiv(sv, (IV)PL_curcop->cop_arybase));
873 if (GvIOp(PL_defoutgv))
874 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
880 sv_copypv(sv, PL_ors_sv);
883 sv_setpv(sv,PL_ofmt);
887 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
888 sv_setpv(sv, errno ? Strerror(errno) : "");
891 int saveerrno = errno;
892 sv_setnv(sv, (NV)errno);
894 if (errno == errno_isOS2 || errno == errno_isOS2_set)
895 sv_setpv(sv, os2error(Perl_rc));
898 sv_setpv(sv, errno ? Strerror(errno) : "");
902 SvNOK_on(sv); /* what a wonderful hack! */
905 sv_setiv(sv, (IV)PL_uid);
908 sv_setiv(sv, (IV)PL_euid);
911 sv_setiv(sv, (IV)PL_gid);
913 Perl_sv_setpvf(aTHX_ sv, "%"Gid_t_f, (long unsigned int)PL_gid);
917 sv_setiv(sv, (IV)PL_egid);
919 Perl_sv_setpvf(aTHX_ sv, "%"Gid_t_f, (long unsigned int)PL_egid);
924 Groups_t gary[NGROUPS];
925 I32 j = getgroups(NGROUPS,gary);
927 Perl_sv_catpvf(aTHX_ sv, " %"Gid_t_f, (long unsigned int)gary[j]);
930 (void)SvIOK_on(sv); /* what a wonderful hack! */
932 #ifndef MACOS_TRADITIONAL
941 Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
943 struct ufuncs *uf = (struct ufuncs *)mg->mg_ptr;
945 if (uf && uf->uf_val)
946 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
951 Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
958 s = SvPV_const(sv,len);
959 ptr = MgPV_const(mg,klen);
962 #ifdef DYNAMIC_ENV_FETCH
963 /* We just undefd an environment var. Is a replacement */
964 /* waiting in the wings? */
967 if ((valp = hv_fetch(GvHVn(PL_envgv), ptr, klen, FALSE)))
968 s = SvPV_const(*valp, len);
972 #if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
973 /* And you'll never guess what the dog had */
974 /* in its mouth... */
976 MgTAINTEDDIR_off(mg);
978 if (s && klen == 8 && strEQ(ptr, "DCL$PATH")) {
979 char pathbuf[256], eltbuf[256], *cp, *elt = s;
983 do { /* DCL$PATH may be a search list */
984 while (1) { /* as may dev portion of any element */
985 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
986 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
987 cando_by_name(S_IWUSR,0,elt) ) {
992 if ((cp = strchr(elt, ':')) != Nullch)
994 if (my_trnlnm(elt, eltbuf, j++))
1000 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1003 if (s && klen == 4 && strEQ(ptr,"PATH")) {
1004 const char *strend = s + len;
1006 while (s < strend) {
1010 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
1011 s, strend, ':', &i);
1013 if (i >= sizeof tmpbuf /* too long -- assume the worst */
1015 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
1016 MgTAINTEDDIR_on(mg);
1022 #endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1028 Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
1031 my_setenv(MgPV_nolen_const(mg),Nullch);
1036 Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
1038 #if defined(VMS) || defined(EPOC) || defined(SYMBIAN)
1039 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1041 if (PL_localizing) {
1043 magic_clear_all_env(sv,mg);
1044 hv_iterinit((HV*)sv);
1045 while ((entry = hv_iternext((HV*)sv))) {
1047 my_setenv(hv_iterkey(entry, &keylen),
1048 SvPV_nolen_const(hv_iterval((HV*)sv, entry)));
1056 Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
1060 #if defined(VMS) || defined(EPOC) || defined(SYMBIAN)
1061 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1063 # if defined(PERL_IMPLICIT_SYS) || defined(WIN32)
1066 # ifdef USE_ENVIRON_ARRAY
1067 # if defined(USE_ITHREADS)
1068 /* only the parent thread can clobber the process environment */
1069 if (PL_curinterp == aTHX)
1072 # ifndef PERL_USE_SAFE_PUTENV
1073 if (!PL_use_safe_putenv) {
1076 if (environ == PL_origenviron)
1077 environ = (char**)safesysmalloc(sizeof(char*));
1079 for (i = 0; environ[i]; i++)
1080 safesysfree(environ[i]);
1082 # endif /* PERL_USE_SAFE_PUTENV */
1084 environ[0] = Nullch;
1086 # endif /* USE_ENVIRON_ARRAY */
1087 # endif /* PERL_IMPLICIT_SYS || WIN32 */
1088 #endif /* VMS || EPOC */
1089 #endif /* !PERL_MICRO */
1096 #ifdef HAS_SIGPROCMASK
1098 restore_sigmask(pTHX_ SV *save_sv)
1100 const sigset_t *ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
1101 (void)sigprocmask(SIG_SETMASK, ossetp, (sigset_t *)0);
1105 Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
1108 /* Are we fetching a signal entry? */
1109 i = whichsig(MgPV_nolen_const(mg));
1112 sv_setsv(sv,PL_psig_ptr[i]);
1114 Sighandler_t sigstate;
1115 sigstate = rsignal_state(i);
1116 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1117 if (PL_sig_handlers_initted && PL_sig_ignoring[i]) sigstate = SIG_IGN;
1119 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1120 if (PL_sig_handlers_initted && PL_sig_defaulting[i]) sigstate = SIG_DFL;
1122 /* cache state so we don't fetch it again */
1123 if(sigstate == SIG_IGN)
1124 sv_setpv(sv,"IGNORE");
1126 sv_setsv(sv,&PL_sv_undef);
1127 PL_psig_ptr[i] = SvREFCNT_inc(sv);
1134 Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
1136 /* XXX Some of this code was copied from Perl_magic_setsig. A little
1137 * refactoring might be in order.
1140 register const char *s = MgPV_nolen_const(mg);
1144 if (strEQ(s,"__DIE__"))
1146 else if (strEQ(s,"__WARN__"))
1149 Perl_croak(aTHX_ "No such hook: %s", s);
1153 SvREFCNT_dec(to_dec);
1158 /* Are we clearing a signal entry? */
1161 #ifdef HAS_SIGPROCMASK
1164 /* Avoid having the signal arrive at a bad time, if possible. */
1167 sigprocmask(SIG_BLOCK, &set, &save);
1169 save_sv = newSVpv((char *)(&save), sizeof(sigset_t));
1170 SAVEFREESV(save_sv);
1171 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1174 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1175 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1177 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1178 PL_sig_defaulting[i] = 1;
1179 (void)rsignal(i, PL_csighandlerp);
1181 (void)rsignal(i, SIG_DFL);
1183 if(PL_psig_name[i]) {
1184 SvREFCNT_dec(PL_psig_name[i]);
1187 if(PL_psig_ptr[i]) {
1188 SV *to_dec=PL_psig_ptr[i];
1191 SvREFCNT_dec(to_dec);
1201 S_raise_signal(pTHX_ int sig)
1203 /* Set a flag to say this signal is pending */
1204 PL_psig_pend[sig]++;
1205 /* And one to say _a_ signal is pending */
1210 Perl_csighandler(int sig)
1212 #ifdef PERL_GET_SIG_CONTEXT
1213 dTHXa(PERL_GET_SIG_CONTEXT);
1217 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1218 (void) rsignal(sig, PL_csighandlerp);
1219 if (PL_sig_ignoring[sig]) return;
1221 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1222 if (PL_sig_defaulting[sig])
1223 #ifdef KILL_BY_SIGPRC
1224 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1229 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG)
1230 /* Call the perl level handler now--
1231 * with risk we may be in malloc() etc. */
1232 (*PL_sighandlerp)(sig);
1234 S_raise_signal(aTHX_ sig);
1237 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1239 Perl_csighandler_init(void)
1242 if (PL_sig_handlers_initted) return;
1244 for (sig = 1; sig < SIG_SIZE; sig++) {
1245 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1247 PL_sig_defaulting[sig] = 1;
1248 (void) rsignal(sig, PL_csighandlerp);
1250 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1251 PL_sig_ignoring[sig] = 0;
1254 PL_sig_handlers_initted = 1;
1259 Perl_despatch_signals(pTHX)
1263 for (sig = 1; sig < SIG_SIZE; sig++) {
1264 if (PL_psig_pend[sig]) {
1265 PERL_BLOCKSIG_ADD(set, sig);
1266 PL_psig_pend[sig] = 0;
1267 PERL_BLOCKSIG_BLOCK(set);
1268 (*PL_sighandlerp)(sig);
1269 PERL_BLOCKSIG_UNBLOCK(set);
1275 Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
1280 /* Need to be careful with SvREFCNT_dec(), because that can have side
1281 * effects (due to closures). We must make sure that the new disposition
1282 * is in place before it is called.
1286 #ifdef HAS_SIGPROCMASK
1291 register const char *s = MgPV_const(mg,len);
1293 if (strEQ(s,"__DIE__"))
1295 else if (strEQ(s,"__WARN__"))
1298 Perl_croak(aTHX_ "No such hook: %s", s);
1306 i = whichsig(s); /* ...no, a brick */
1308 if (ckWARN(WARN_SIGNAL))
1309 Perl_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s", s);
1312 #ifdef HAS_SIGPROCMASK
1313 /* Avoid having the signal arrive at a bad time, if possible. */
1316 sigprocmask(SIG_BLOCK, &set, &save);
1318 save_sv = newSVpv((char *)(&save), sizeof(sigset_t));
1319 SAVEFREESV(save_sv);
1320 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1323 #if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1324 if (!PL_sig_handlers_initted) Perl_csighandler_init();
1326 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1327 PL_sig_ignoring[i] = 0;
1329 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1330 PL_sig_defaulting[i] = 0;
1332 SvREFCNT_dec(PL_psig_name[i]);
1333 to_dec = PL_psig_ptr[i];
1334 PL_psig_ptr[i] = SvREFCNT_inc(sv);
1335 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
1336 PL_psig_name[i] = newSVpvn(s, len);
1337 SvREADONLY_on(PL_psig_name[i]);
1339 if (SvTYPE(sv) == SVt_PVGV || SvROK(sv)) {
1341 (void)rsignal(i, PL_csighandlerp);
1342 #ifdef HAS_SIGPROCMASK
1347 *svp = SvREFCNT_inc(sv);
1349 SvREFCNT_dec(to_dec);
1352 s = SvPV_force(sv,len);
1353 if (strEQ(s,"IGNORE")) {
1355 #ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
1356 PL_sig_ignoring[i] = 1;
1357 (void)rsignal(i, PL_csighandlerp);
1359 (void)rsignal(i, SIG_IGN);
1363 else if (strEQ(s,"DEFAULT") || !*s) {
1365 #ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
1367 PL_sig_defaulting[i] = 1;
1368 (void)rsignal(i, PL_csighandlerp);
1371 (void)rsignal(i, SIG_DFL);
1376 * We should warn if HINT_STRICT_REFS, but without
1377 * access to a known hint bit in a known OP, we can't
1378 * tell whether HINT_STRICT_REFS is in force or not.
1380 if (!strchr(s,':') && !strchr(s,'\''))
1381 sv_insert(sv, 0, 0, "main::", 6);
1383 (void)rsignal(i, PL_csighandlerp);
1385 *svp = SvREFCNT_inc(sv);
1387 #ifdef HAS_SIGPROCMASK
1392 SvREFCNT_dec(to_dec);
1395 #endif /* !PERL_MICRO */
1398 Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
1402 PL_sub_generation++;
1407 Perl_magic_setamagic(pTHX_ SV *sv, MAGIC *mg)
1411 /* HV_badAMAGIC_on(Sv_STASH(sv)); */
1412 PL_amagic_generation++;
1418 Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
1420 HV * const hv = (HV*)LvTARG(sv);
1425 (void) hv_iterinit(hv);
1426 if (! SvTIED_mg((SV*)hv, PERL_MAGIC_tied))
1429 while (hv_iternext(hv))
1434 sv_setiv(sv, (IV)i);
1439 Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
1443 hv_ksplit((HV*)LvTARG(sv), SvIV(sv));
1448 /* caller is responsible for stack switching/cleanup */
1450 S_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, const char *meth, I32 flags, int n, SV *val)
1456 PUSHs(SvTIED_obj(sv, mg));
1459 if (mg->mg_len >= 0)
1460 PUSHs(sv_2mortal(newSVpvn(mg->mg_ptr, mg->mg_len)));
1461 else if (mg->mg_len == HEf_SVKEY)
1462 PUSHs((SV*)mg->mg_ptr);
1464 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
1465 PUSHs(sv_2mortal(newSViv(mg->mg_len)));
1473 return call_method(meth, flags);
1477 S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, const char *meth)
1483 PUSHSTACKi(PERLSI_MAGIC);
1485 if (magic_methcall(sv, mg, meth, G_SCALAR, 2, NULL)) {
1486 sv_setsv(sv, *PL_stack_sp--);
1496 Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
1499 mg->mg_flags |= MGf_GSKIP;
1500 magic_methpack(sv,mg,"FETCH");
1505 Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
1509 PUSHSTACKi(PERLSI_MAGIC);
1510 magic_methcall(sv, mg, "STORE", G_SCALAR|G_DISCARD, 3, sv);
1517 Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
1519 return magic_methpack(sv,mg,"DELETE");
1524 Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
1531 PUSHSTACKi(PERLSI_MAGIC);
1532 if (magic_methcall(sv, mg, "FETCHSIZE", G_SCALAR, 2, NULL)) {
1533 sv = *PL_stack_sp--;
1534 retval = (U32) SvIV(sv)-1;
1543 Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
1548 PUSHSTACKi(PERLSI_MAGIC);
1550 XPUSHs(SvTIED_obj(sv, mg));
1552 call_method("CLEAR", G_SCALAR|G_DISCARD);
1560 Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
1563 const char * const meth = SvOK(key) ? "NEXTKEY" : "FIRSTKEY";
1567 PUSHSTACKi(PERLSI_MAGIC);
1570 PUSHs(SvTIED_obj(sv, mg));
1575 if (call_method(meth, G_SCALAR))
1576 sv_setsv(key, *PL_stack_sp--);
1585 Perl_magic_existspack(pTHX_ SV *sv, MAGIC *mg)
1587 return magic_methpack(sv,mg,"EXISTS");
1591 Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1594 SV *retval = &PL_sv_undef;
1595 SV *tied = SvTIED_obj((SV*)hv, mg);
1596 HV *pkg = SvSTASH((SV*)SvRV(tied));
1598 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1600 if (HvEITER_get(hv))
1601 /* we are in an iteration so the hash cannot be empty */
1603 /* no xhv_eiter so now use FIRSTKEY */
1604 key = sv_newmortal();
1605 magic_nextpack((SV*)hv, mg, key);
1606 HvEITER_set(hv, NULL); /* need to reset iterator */
1607 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
1610 /* there is a SCALAR method that we can call */
1612 PUSHSTACKi(PERLSI_MAGIC);
1618 if (call_method("SCALAR", G_SCALAR))
1619 retval = *PL_stack_sp--;
1626 Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
1635 svp = av_fetch(GvAV(gv),
1636 atoi(MgPV_nolen_const(mg)), FALSE);
1637 if (svp && SvIOKp(*svp) && (o = INT2PTR(OP*,SvIVX(*svp)))) {
1638 /* set or clear breakpoint in the relevant control op */
1640 o->op_flags |= OPf_SPECIAL;
1642 o->op_flags &= ~OPf_SPECIAL;
1648 Perl_magic_getarylen(pTHX_ SV *sv, MAGIC *mg)
1650 sv_setiv(sv, AvFILL((AV*)mg->mg_obj) + PL_curcop->cop_arybase);
1655 Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
1657 av_fill((AV*)mg->mg_obj, SvIV(sv) - PL_curcop->cop_arybase);
1662 Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
1664 SV* lsv = LvTARG(sv);
1666 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv)) {
1667 mg = mg_find(lsv, PERL_MAGIC_regex_global);
1668 if (mg && mg->mg_len >= 0) {
1671 sv_pos_b2u(lsv, &i);
1672 sv_setiv(sv, i + PL_curcop->cop_arybase);
1681 Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
1683 SV* lsv = LvTARG(sv);
1690 if (SvTYPE(lsv) >= SVt_PVMG && SvMAGIC(lsv))
1691 mg = mg_find(lsv, PERL_MAGIC_regex_global);
1695 sv_magic(lsv, (SV*)0, PERL_MAGIC_regex_global, Nullch, 0);
1696 mg = mg_find(lsv, PERL_MAGIC_regex_global);
1698 else if (!SvOK(sv)) {
1702 len = SvPOK(lsv) ? SvCUR(lsv) : sv_len(lsv);
1704 pos = SvIV(sv) - PL_curcop->cop_arybase;
1707 ulen = sv_len_utf8(lsv);
1717 else if (pos > (SSize_t)len)
1722 sv_pos_u2b(lsv, &p, 0);
1727 mg->mg_flags &= ~MGf_MINMATCH;
1733 Perl_magic_getglob(pTHX_ SV *sv, MAGIC *mg)
1736 if (SvFAKE(sv)) { /* FAKE globs can get coerced */
1738 gv_efullname3(sv,((GV*)sv), "*");
1742 gv_efullname3(sv,((GV*)sv), "*"); /* a gv value, be nice */
1747 Perl_magic_setglob(pTHX_ SV *sv, MAGIC *mg)
1754 gv = gv_fetchsv(sv,TRUE, SVt_PVGV);
1759 GvGP(sv) = gp_ref(GvGP(gv));
1764 Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
1767 SV * const lsv = LvTARG(sv);
1768 const char * const tmps = SvPV_const(lsv,len);
1769 I32 offs = LvTARGOFF(sv);
1770 I32 rem = LvTARGLEN(sv);
1774 sv_pos_u2b(lsv, &offs, &rem);
1775 if (offs > (I32)len)
1777 if (rem + offs > (I32)len)
1779 sv_setpvn(sv, tmps + offs, (STRLEN)rem);
1786 Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
1789 const char *tmps = SvPV_const(sv, len);
1790 SV * const lsv = LvTARG(sv);
1791 I32 lvoff = LvTARGOFF(sv);
1792 I32 lvlen = LvTARGLEN(sv);
1796 sv_utf8_upgrade(lsv);
1797 sv_pos_u2b(lsv, &lvoff, &lvlen);
1798 sv_insert(lsv, lvoff, lvlen, tmps, len);
1799 LvTARGLEN(sv) = sv_len_utf8(sv);
1802 else if (lsv && SvUTF8(lsv)) {
1803 sv_pos_u2b(lsv, &lvoff, &lvlen);
1804 LvTARGLEN(sv) = len;
1805 tmps = (char*)bytes_to_utf8((U8*)tmps, &len);
1806 sv_insert(lsv, lvoff, lvlen, tmps, len);
1810 sv_insert(lsv, lvoff, lvlen, tmps, len);
1811 LvTARGLEN(sv) = len;
1819 Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
1821 TAINT_IF((mg->mg_len & 1) ||
1822 ((mg->mg_len & 2) && mg->mg_obj == sv)); /* kludge */
1827 Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
1830 if (PL_localizing) {
1831 if (PL_localizing == 1)
1836 else if (PL_tainted)
1844 Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
1846 SV * const lsv = LvTARG(sv);
1854 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
1859 Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
1862 do_vecset(sv); /* XXX slurp this routine */
1867 Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
1870 if (LvTARGLEN(sv)) {
1872 SV *ahv = LvTARG(sv);
1873 HE *he = hv_fetch_ent((HV*)ahv, mg->mg_obj, FALSE, 0);
1878 AV* av = (AV*)LvTARG(sv);
1879 if ((I32)LvTARGOFF(sv) <= AvFILL(av))
1880 targ = AvARRAY(av)[LvTARGOFF(sv)];
1882 if (targ && targ != &PL_sv_undef) {
1883 /* somebody else defined it for us */
1884 SvREFCNT_dec(LvTARG(sv));
1885 LvTARG(sv) = SvREFCNT_inc(targ);
1887 SvREFCNT_dec(mg->mg_obj);
1888 mg->mg_obj = Nullsv;
1889 mg->mg_flags &= ~MGf_REFCOUNTED;
1894 sv_setsv(sv, targ ? targ : &PL_sv_undef);
1899 Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
1905 sv_setsv(LvTARG(sv), sv);
1906 SvSETMAGIC(LvTARG(sv));
1912 Perl_vivify_defelem(pTHX_ SV *sv)
1917 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
1920 SV *ahv = LvTARG(sv);
1921 HE *he = hv_fetch_ent((HV*)ahv, mg->mg_obj, TRUE, 0);
1924 if (!value || value == &PL_sv_undef)
1925 Perl_croak(aTHX_ PL_no_helem_sv, mg->mg_obj);
1928 AV* av = (AV*)LvTARG(sv);
1929 if ((I32)LvTARGLEN(sv) < 0 && (I32)LvTARGOFF(sv) > AvFILL(av))
1930 LvTARG(sv) = Nullsv; /* array can't be extended */
1932 SV** svp = av_fetch(av, LvTARGOFF(sv), TRUE);
1933 if (!svp || (value = *svp) == &PL_sv_undef)
1934 Perl_croak(aTHX_ PL_no_aelem, (I32)LvTARGOFF(sv));
1937 (void)SvREFCNT_inc(value);
1938 SvREFCNT_dec(LvTARG(sv));
1941 SvREFCNT_dec(mg->mg_obj);
1942 mg->mg_obj = Nullsv;
1943 mg->mg_flags &= ~MGf_REFCOUNTED;
1947 Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
1949 AV *av = (AV*)mg->mg_obj;
1950 SV **svp = AvARRAY(av);
1951 I32 i = AvFILLp(av);
1956 if (!SvWEAKREF(svp[i]))
1957 Perl_croak(aTHX_ "panic: magic_killbackrefs");
1958 /* XXX Should we check that it hasn't changed? */
1959 SvRV_set(svp[i], 0);
1961 SvWEAKREF_off(svp[i]);
1966 SvREFCNT_dec(av); /* remove extra count added by sv_add_backref() */
1971 Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
1979 Perl_magic_setbm(pTHX_ SV *sv, MAGIC *mg)
1982 sv_unmagic(sv, PERL_MAGIC_bm);
1988 Perl_magic_setfm(pTHX_ SV *sv, MAGIC *mg)
1991 sv_unmagic(sv, PERL_MAGIC_fm);
1997 Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
1999 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
2001 if (uf && uf->uf_set)
2002 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
2007 Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2010 sv_unmagic(sv, PERL_MAGIC_qr);
2015 Perl_magic_freeregexp(pTHX_ SV *sv, MAGIC *mg)
2017 regexp *re = (regexp *)mg->mg_obj;
2023 #ifdef USE_LOCALE_COLLATE
2025 Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
2028 * RenE<eacute> Descartes said "I think not."
2029 * and vanished with a faint plop.
2033 Safefree(mg->mg_ptr);
2039 #endif /* USE_LOCALE_COLLATE */
2041 /* Just clear the UTF-8 cache data. */
2043 Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2046 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
2048 mg->mg_len = -1; /* The mg_len holds the len cache. */
2053 Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
2055 register const char *s;
2058 switch (*mg->mg_ptr) {
2059 case '\001': /* ^A */
2060 sv_setsv(PL_bodytarget, sv);
2062 case '\003': /* ^C */
2063 PL_minus_c = (bool)(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2066 case '\004': /* ^D */
2068 s = SvPV_nolen_const(sv);
2069 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
2070 DEBUG_x(dump_all());
2072 PL_debug = (SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv)) | DEBUG_TOP_FLAG;
2075 case '\005': /* ^E */
2076 if (*(mg->mg_ptr+1) == '\0') {
2077 #ifdef MACOS_TRADITIONAL
2078 gMacPerl_OSErr = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2081 set_vaxc_errno(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2084 SetLastError( SvIV(sv) );
2087 os2_setsyserrno(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2089 /* will anyone ever use this? */
2090 SETERRNO(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv), 4);
2096 else if (strEQ(mg->mg_ptr+1, "NCODING")) {
2098 SvREFCNT_dec(PL_encoding);
2099 if (SvOK(sv) || SvGMAGICAL(sv)) {
2100 PL_encoding = newSVsv(sv);
2103 PL_encoding = Nullsv;
2107 case '\006': /* ^F */
2108 PL_maxsysfd = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2110 case '\010': /* ^H */
2111 PL_hints = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2113 case '\011': /* ^I */ /* NOT \t in EBCDIC */
2115 Safefree(PL_inplace);
2117 PL_inplace = savesvpv(sv);
2119 PL_inplace = Nullch;
2121 case '\017': /* ^O */
2122 if (*(mg->mg_ptr+1) == '\0') {
2124 Safefree(PL_osname);
2128 TAINT_PROPER("assigning to $^O");
2129 PL_osname = savesvpv(sv);
2132 else if (strEQ(mg->mg_ptr, "\017PEN")) {
2133 if (!PL_compiling.cop_io)
2134 PL_compiling.cop_io = newSVsv(sv);
2136 sv_setsv(PL_compiling.cop_io,sv);
2139 case '\020': /* ^P */
2140 PL_perldb = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2141 if (PL_perldb && !PL_DBsingle)
2144 case '\024': /* ^T */
2146 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
2148 PL_basetime = (Time_t)(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2151 case '\027': /* ^W & $^WARNING_BITS */
2152 if (*(mg->mg_ptr+1) == '\0') {
2153 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2154 i = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2155 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
2156 | (i ? G_WARN_ON : G_WARN_OFF) ;
2159 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
2160 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
2161 if (!SvPOK(sv) && PL_localizing) {
2162 sv_setpvn(sv, WARN_NONEstring, WARNsize);
2163 PL_compiling.cop_warnings = pWARN_NONE;
2168 int accumulate = 0 ;
2169 int any_fatals = 0 ;
2170 const char * const ptr = SvPV_const(sv, len) ;
2171 for (i = 0 ; i < len ; ++i) {
2172 accumulate |= ptr[i] ;
2173 any_fatals |= (ptr[i] & 0xAA) ;
2176 PL_compiling.cop_warnings = pWARN_NONE;
2177 else if (isWARN_on(sv, WARN_ALL) && !any_fatals) {
2178 PL_compiling.cop_warnings = pWARN_ALL;
2179 PL_dowarn |= G_WARN_ONCE ;
2182 if (specialWARN(PL_compiling.cop_warnings))
2183 PL_compiling.cop_warnings = newSVsv(sv) ;
2185 sv_setsv(PL_compiling.cop_warnings, sv);
2186 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2187 PL_dowarn |= G_WARN_ONCE ;
2195 if (PL_localizing) {
2196 if (PL_localizing == 1)
2197 SAVESPTR(PL_last_in_gv);
2199 else if (SvOK(sv) && GvIO(PL_last_in_gv))
2200 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
2203 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2204 s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2205 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv,TRUE, SVt_PVIO);
2208 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2209 s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2210 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv,TRUE, SVt_PVIO);
2213 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2216 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2217 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
2218 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
2221 IoPAGE(GvIOp(PL_defoutgv)) = (SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2225 IO *io = GvIOp(PL_defoutgv);
2228 if ((SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv)) == 0)
2229 IoFLAGS(io) &= ~IOf_FLUSH;
2231 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2232 PerlIO *ofp = IoOFP(io);
2234 (void)PerlIO_flush(ofp);
2235 IoFLAGS(io) |= IOf_FLUSH;
2241 SvREFCNT_dec(PL_rs);
2242 PL_rs = newSVsv(sv);
2246 SvREFCNT_dec(PL_ors_sv);
2247 if (SvOK(sv) || SvGMAGICAL(sv)) {
2248 PL_ors_sv = newSVsv(sv);
2256 SvREFCNT_dec(PL_ofs_sv);
2257 if (SvOK(sv) || SvGMAGICAL(sv)) {
2258 PL_ofs_sv = newSVsv(sv);
2267 PL_ofmt = savesvpv(sv);
2270 PL_compiling.cop_arybase = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2273 #ifdef COMPLEX_STATUS
2274 if (PL_localizing == 2) {
2275 PL_statusvalue = LvTARGOFF(sv);
2276 PL_statusvalue_vms = LvTARGLEN(sv);
2280 #ifdef VMSISH_STATUS
2282 STATUS_NATIVE_SET((U32)(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv)));
2285 STATUS_UNIX_SET(SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv));
2290 # define PERL_VMS_BANG vaxc$errno
2292 # define PERL_VMS_BANG 0
2294 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
2295 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2299 PL_uid = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2300 if (PL_delaymagic) {
2301 PL_delaymagic |= DM_RUID;
2302 break; /* don't do magic till later */
2305 (void)setruid((Uid_t)PL_uid);
2308 (void)setreuid((Uid_t)PL_uid, (Uid_t)-1);
2310 #ifdef HAS_SETRESUID
2311 (void)setresuid((Uid_t)PL_uid, (Uid_t)-1, (Uid_t)-1);
2313 if (PL_uid == PL_euid) { /* special case $< = $> */
2315 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
2316 if (PL_uid != 0 && PerlProc_getuid() == 0)
2317 (void)PerlProc_setuid(0);
2319 (void)PerlProc_setuid(PL_uid);
2321 PL_uid = PerlProc_getuid();
2322 Perl_croak(aTHX_ "setruid() not implemented");
2327 PL_uid = PerlProc_getuid();
2328 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2331 PL_euid = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2332 if (PL_delaymagic) {
2333 PL_delaymagic |= DM_EUID;
2334 break; /* don't do magic till later */
2337 (void)seteuid((Uid_t)PL_euid);
2340 (void)setreuid((Uid_t)-1, (Uid_t)PL_euid);
2342 #ifdef HAS_SETRESUID
2343 (void)setresuid((Uid_t)-1, (Uid_t)PL_euid, (Uid_t)-1);
2345 if (PL_euid == PL_uid) /* special case $> = $< */
2346 PerlProc_setuid(PL_euid);
2348 PL_euid = PerlProc_geteuid();
2349 Perl_croak(aTHX_ "seteuid() not implemented");
2354 PL_euid = PerlProc_geteuid();
2355 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2358 PL_gid = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2359 if (PL_delaymagic) {
2360 PL_delaymagic |= DM_RGID;
2361 break; /* don't do magic till later */
2364 (void)setrgid((Gid_t)PL_gid);
2367 (void)setregid((Gid_t)PL_gid, (Gid_t)-1);
2369 #ifdef HAS_SETRESGID
2370 (void)setresgid((Gid_t)PL_gid, (Gid_t)-1, (Gid_t) 1);
2372 if (PL_gid == PL_egid) /* special case $( = $) */
2373 (void)PerlProc_setgid(PL_gid);
2375 PL_gid = PerlProc_getgid();
2376 Perl_croak(aTHX_ "setrgid() not implemented");
2381 PL_gid = PerlProc_getgid();
2382 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2385 #ifdef HAS_SETGROUPS
2387 const char *p = SvPV_const(sv, len);
2388 Groups_t gary[NGROUPS];
2393 for (i = 0; i < NGROUPS; ++i) {
2394 while (*p && !isSPACE(*p))
2403 (void)setgroups(i, gary);
2405 #else /* HAS_SETGROUPS */
2406 PL_egid = SvIOK(sv) ? SvIVX(sv) : sv_2iv(sv);
2407 #endif /* HAS_SETGROUPS */
2408 if (PL_delaymagic) {
2409 PL_delaymagic |= DM_EGID;
2410 break; /* don't do magic till later */
2413 (void)setegid((Gid_t)PL_egid);
2416 (void)setregid((Gid_t)-1, (Gid_t)PL_egid);
2418 #ifdef HAS_SETRESGID
2419 (void)setresgid((Gid_t)-1, (Gid_t)PL_egid, (Gid_t)-1);
2421 if (PL_egid == PL_gid) /* special case $) = $( */
2422 (void)PerlProc_setgid(PL_egid);
2424 PL_egid = PerlProc_getegid();
2425 Perl_croak(aTHX_ "setegid() not implemented");
2430 PL_egid = PerlProc_getegid();
2431 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
2434 PL_chopset = SvPV_force(sv,len);
2436 #ifndef MACOS_TRADITIONAL
2438 LOCK_DOLLARZERO_MUTEX;
2439 #ifdef HAS_SETPROCTITLE
2440 /* The BSDs don't show the argv[] in ps(1) output, they
2441 * show a string from the process struct and provide
2442 * the setproctitle() routine to manipulate that. */
2444 s = SvPV_const(sv, len);
2445 # if __FreeBSD_version > 410001
2446 /* The leading "-" removes the "perl: " prefix,
2447 * but not the "(perl) suffix from the ps(1)
2448 * output, because that's what ps(1) shows if the
2449 * argv[] is modified. */
2450 setproctitle("-%s", s);
2451 # else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
2452 /* This doesn't really work if you assume that
2453 * $0 = 'foobar'; will wipe out 'perl' from the $0
2454 * because in ps(1) output the result will be like
2455 * sprintf("perl: %s (perl)", s)
2456 * I guess this is a security feature:
2457 * one (a user process) cannot get rid of the original name.
2459 setproctitle("%s", s);
2463 #if defined(__hpux) && defined(PSTAT_SETCMD)
2466 s = SvPV_const(sv, len);
2467 un.pst_command = (char *)s;
2468 pstat(PSTAT_SETCMD, un, len, 0, 0);
2471 /* PL_origalen is set in perl_parse(). */
2472 s = SvPV_force(sv,len);
2473 if (len >= (STRLEN)PL_origalen-1) {
2474 /* Longer than original, will be truncated. We assume that
2475 * PL_origalen bytes are available. */
2476 Copy(s, PL_origargv[0], PL_origalen-1, char);
2479 /* Shorter than original, will be padded. */
2480 Copy(s, PL_origargv[0], len, char);
2481 PL_origargv[0][len] = 0;
2482 memset(PL_origargv[0] + len + 1,
2483 /* Is the space counterintuitive? Yes.
2484 * (You were expecting \0?)
2485 * Does it work? Seems to. (In Linux 2.4.20 at least.)
2488 PL_origalen - len - 1);
2490 PL_origargv[0][PL_origalen-1] = 0;
2491 for (i = 1; i < PL_origargc; i++)
2493 UNLOCK_DOLLARZERO_MUTEX;
2501 Perl_whichsig(pTHX_ const char *sig)
2503 register char* const* sigv;
2505 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
2506 if (strEQ(sig,*sigv))
2507 return PL_sig_num[sigv - (char* const*)PL_sig_name];
2509 if (strEQ(sig,"CHLD"))
2513 if (strEQ(sig,"CLD"))
2520 Perl_sighandler(int sig)
2522 #ifdef PERL_GET_SIG_CONTEXT
2523 dTHXa(PERL_GET_SIG_CONTEXT);
2530 SV *sv = Nullsv, *tSv = PL_Sv;
2536 if (PL_savestack_ix + 15 <= PL_savestack_max)
2538 if (PL_markstack_ptr < PL_markstack_max - 2)
2540 if (PL_scopestack_ix < PL_scopestack_max - 3)
2543 if (!PL_psig_ptr[sig]) {
2544 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
2549 /* Max number of items pushed there is 3*n or 4. We cannot fix
2550 infinity, so we fix 4 (in fact 5): */
2552 PL_savestack_ix += 5; /* Protect save in progress. */
2553 SAVEDESTRUCTOR_X(unwind_handler_stack, (void*)&flags);
2556 PL_markstack_ptr++; /* Protect mark. */
2558 PL_scopestack_ix += 1;
2559 /* sv_2cv is too complicated, try a simpler variant first: */
2560 if (!SvROK(PL_psig_ptr[sig]) || !(cv = (CV*)SvRV(PL_psig_ptr[sig]))
2561 || SvTYPE(cv) != SVt_PVCV)
2562 cv = sv_2cv(PL_psig_ptr[sig],&st,&gv,TRUE);
2564 if (!cv || !CvROOT(cv)) {
2565 if (ckWARN(WARN_SIGNAL))
2566 Perl_warner(aTHX_ packWARN(WARN_SIGNAL), "SIG%s handler \"%s\" not defined.\n",
2567 PL_sig_name[sig], (gv ? GvENAME(gv)
2574 if(PL_psig_name[sig]) {
2575 sv = SvREFCNT_inc(PL_psig_name[sig]);
2577 #if !defined(PERL_IMPLICIT_CONTEXT)
2581 sv = sv_newmortal();
2582 sv_setpv(sv,PL_sig_name[sig]);
2585 PUSHSTACKi(PERLSI_SIGNAL);
2590 call_sv((SV*)cv, G_DISCARD|G_EVAL);
2593 if (SvTRUE(ERRSV)) {
2595 #ifdef HAS_SIGPROCMASK
2596 /* Handler "died", for example to get out of a restart-able read().
2597 * Before we re-do that on its behalf re-enable the signal which was
2598 * blocked by the system when we entered.
2602 sigaddset(&set,sig);
2603 sigprocmask(SIG_UNBLOCK, &set, NULL);
2605 /* Not clear if this will work */
2606 (void)rsignal(sig, SIG_IGN);
2607 (void)rsignal(sig, PL_csighandlerp);
2609 #endif /* !PERL_MICRO */
2614 PL_savestack_ix -= 8; /* Unprotect save in progress. */
2618 PL_scopestack_ix -= 1;
2621 PL_op = myop; /* Apparently not needed... */
2623 PL_Sv = tSv; /* Restore global temporaries. */
2630 restore_magic(pTHX_ const void *p)
2632 MGS* mgs = SSPTR(PTR2IV(p), MGS*);
2633 SV* sv = mgs->mgs_sv;
2638 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
2640 #ifdef PERL_OLD_COPY_ON_WRITE
2641 /* While magic was saved (and off) sv_setsv may well have seen
2642 this SV as a prime candidate for COW. */
2644 sv_force_normal(sv);
2648 SvFLAGS(sv) |= mgs->mgs_flags;
2652 SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
2655 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
2657 /* If we're still on top of the stack, pop us off. (That condition
2658 * will be satisfied if restore_magic was called explicitly, but *not*
2659 * if it's being called via leave_scope.)
2660 * The reason for doing this is that otherwise, things like sv_2cv()
2661 * may leave alloc gunk on the savestack, and some code
2662 * (e.g. sighandler) doesn't expect that...
2664 if (PL_savestack_ix == mgs->mgs_ss_ix)
2666 I32 popval = SSPOPINT;
2667 assert(popval == SAVEt_DESTRUCTOR_X);
2668 PL_savestack_ix -= 2;
2670 assert(popval == SAVEt_ALLOC);
2672 PL_savestack_ix -= popval;
2678 unwind_handler_stack(pTHX_ const void *p)
2681 const U32 flags = *(const U32*)p;
2684 PL_savestack_ix -= 5; /* Unprotect save in progress. */
2685 /* cxstack_ix-- Not needed, die already unwound it. */
2686 #if !defined(PERL_IMPLICIT_CONTEXT)
2688 SvREFCNT_dec(PL_sig_sv);
2694 * c-indentation-style: bsd
2696 * indent-tabs-mode: t
2699 * ex: set ts=8 sts=4 sw=4 noet: