This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlpodspec: Finish EBCDIC updates
[perl5.git] / mg.c
CommitLineData
a0d0e21e 1/* mg.c
79072805 2 *
1129b882
NC
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
79072805
LW
5 *
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.
8 *
a0d0e21e
LW
9 */
10
11/*
4ac71550
TC
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.
14 *
15 * [p.363 of _The Lord of the Rings_, II/vii: "The Mirror of Galadriel"]
79072805
LW
16 */
17
ccfc67b7
JH
18/*
19=head1 Magical Functions
166f8a29
DM
20"Magic" is special data attached to SV structures in order to give them
21"magical" properties. When any Perl code tries to read from, or assign to,
22an SV marked as magical, it calls the 'get' or 'set' function associated
154e47c8 23with that SV's magic. A get is called prior to reading an SV, in order to
ddfa107c 24give it a chance to update its internal value (get on $. writes the line
b53c43bf 25number of the last read filehandle into the SV's IV slot), while
166f8a29 26set is called after an SV has been written to, in order to allow it to make
ddfa107c 27use of its changed value (set on $/ copies the SV's new value to the
166f8a29
DM
28PL_rs global variable).
29
30Magic is implemented as a linked list of MAGIC structures attached to the
154e47c8 31SV. Each MAGIC struct holds the type of the magic, a pointer to an array
166f8a29 32of functions that implement the get(), set(), length() etc functions,
154e47c8 33plus space for some flags and pointers. For example, a tied variable has
166f8a29
DM
34a MAGIC structure that contains a pointer to the object associated with the
35tie.
36
7fefc6c1
KW
37=cut
38
ccfc67b7
JH
39*/
40
79072805 41#include "EXTERN.h"
864dbfa3 42#define PERL_IN_MG_C
79072805
LW
43#include "perl.h"
44
5cd24f17 45#if defined(HAS_GETGROUPS) || defined(HAS_SETGROUPS)
b7953727
JH
46# ifdef I_GRP
47# include <grp.h>
48# endif
188ea221
CS
49#endif
50
757f63d8
SP
51#if defined(HAS_SETGROUPS)
52# ifndef NGROUPS
53# define NGROUPS 32
54# endif
55#endif
56
17aa7f3d
JH
57#ifdef __hpux
58# include <sys/pstat.h>
59#endif
60
7636ea95
AB
61#ifdef HAS_PRCTL_SET_NAME
62# include <sys/prctl.h>
63#endif
64
8aad04aa 65#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
b6455c53 66Signal_t Perl_csighandler(int sig, siginfo_t *, void *);
8aad04aa 67#else
e69880a5 68Signal_t Perl_csighandler(int sig);
8aad04aa 69#endif
e69880a5 70
9cffb111
OS
71#ifdef __Lynx__
72/* Missing protos on LynxOS */
73void setruid(uid_t id);
74void seteuid(uid_t id);
75void setrgid(uid_t id);
76void setegid(uid_t id);
77#endif
78
c07a80fd 79/*
4bac9ae4 80 * Pre-magic setup and post-magic takedown.
c07a80fd 81 * Use the "DESTRUCTOR" scope cleanup to reinstate magic.
82 */
83
84struct magic_state {
85 SV* mgs_sv;
455ece5e 86 I32 mgs_ss_ix;
a623f893 87 U32 mgs_flags;
150b625d 88 bool mgs_bumped;
c07a80fd 89};
455ece5e 90/* MGS is typedef'ed to struct magic_state in perl.h */
76e3520e
GS
91
92STATIC void
ff44333e 93S_save_magic_flags(pTHX_ I32 mgs_ix, SV *sv, U32 flags)
c07a80fd 94{
455ece5e 95 MGS* mgs;
150b625d 96 bool bumped = FALSE;
7918f24d 97
ff44333e 98 PERL_ARGS_ASSERT_SAVE_MAGIC_FLAGS;
7918f24d 99
4bac9ae4
CS
100 assert(SvMAGICAL(sv));
101
150b625d
DM
102 /* we shouldn't really be called here with RC==0, but it can sometimes
103 * happen via mg_clear() (which also shouldn't be called when RC==0,
104 * but it can happen). Handle this case gracefully(ish) by not RC++
105 * and thus avoiding the resultant double free */
106 if (SvREFCNT(sv) > 0) {
107 /* guard against sv getting freed midway through the mg clearing,
108 * by holding a private reference for the duration. */
109 SvREFCNT_inc_simple_void_NN(sv);
110 bumped = TRUE;
111 }
8985fe98 112
8772537c 113 SAVEDESTRUCTOR_X(S_restore_magic, INT2PTR(void*, (IV)mgs_ix));
455ece5e
AD
114
115 mgs = SSPTR(mgs_ix, MGS*);
c07a80fd 116 mgs->mgs_sv = sv;
a623f893 117 mgs->mgs_flags = SvMAGICAL(sv) | SvREADONLY(sv);
455ece5e 118 mgs->mgs_ss_ix = PL_savestack_ix; /* points after the saved destructor */
150b625d 119 mgs->mgs_bumped = bumped;
c07a80fd 120
ff44333e 121 SvFLAGS(sv) &= ~flags;
3805b5fb 122 SvREADONLY_off(sv);
c07a80fd 123}
124
ff44333e
FC
125#define save_magic(a,b) save_magic_flags(a,b,SVs_GMG|SVs_SMG|SVs_RMG)
126
954c1994
GS
127/*
128=for apidoc mg_magical
129
130Turns on the magical status of an SV. See C<sv_magic>.
131
132=cut
133*/
134
8990e307 135void
ddeaf645 136Perl_mg_magical(SV *sv)
8990e307 137{
e1ec3a88 138 const MAGIC* mg;
7918f24d 139 PERL_ARGS_ASSERT_MG_MAGICAL;
f9c6fee5
CS
140
141 SvMAGICAL_off(sv);
218787bd 142 if ((mg = SvMAGIC(sv))) {
218787bd
VP
143 do {
144 const MGVTBL* const vtbl = mg->mg_virtual;
145 if (vtbl) {
146 if (vtbl->svt_get && !(mg->mg_flags & MGf_GSKIP))
147 SvGMAGICAL_on(sv);
148 if (vtbl->svt_set)
149 SvSMAGICAL_on(sv);
150 if (vtbl->svt_clear)
151 SvRMAGICAL_on(sv);
152 }
153 } while ((mg = mg->mg_moremagic));
154 if (!(SvFLAGS(sv) & (SVs_GMG|SVs_SMG)))
155 SvRMAGICAL_on(sv);
8990e307
LW
156 }
157}
158
954c1994
GS
159/*
160=for apidoc mg_get
161
4b1e7f06 162Do magic before a value is retrieved from the SV. The type of SV must
72d33970 163be >= SVt_PVMG. See C<sv_magic>.
954c1994
GS
164
165=cut
166*/
167
79072805 168int
864dbfa3 169Perl_mg_get(pTHX_ SV *sv)
79072805 170{
35a4481c 171 const I32 mgs_ix = SSNEW(sizeof(MGS));
a9844598 172 bool saved = FALSE;
f9c6fee5 173 bool have_new = 0;
ff76feab 174 MAGIC *newmg, *head, *cur, *mg;
6683b158 175
7918f24d
NC
176 PERL_ARGS_ASSERT_MG_GET;
177
407287f9
FC
178 if (PL_localizing == 1 && sv == DEFSV) return 0;
179
ff76feab
AMS
180 /* We must call svt_get(sv, mg) for each valid entry in the linked
181 list of magic. svt_get() may delete the current entry, add new
182 magic to the head of the list, or upgrade the SV. AMS 20010810 */
183
184 newmg = cur = head = mg = SvMAGIC(sv);
185 while (mg) {
35a4481c 186 const MGVTBL * const vtbl = mg->mg_virtual;
f9c6fee5 187 MAGIC * const nextmg = mg->mg_moremagic; /* it may delete itself */
ff76feab 188
2b260de0 189 if (!(mg->mg_flags & MGf_GSKIP) && vtbl && vtbl->svt_get) {
a9844598
CS
190
191 /* taint's mg get is so dumb it doesn't need flag saving */
192 if (!saved && mg->mg_type != PERL_MAGIC_taint) {
193 save_magic(mgs_ix, sv);
194 saved = TRUE;
195 }
196
16c91539 197 vtbl->svt_get(aTHX_ sv, mg);
b77f7d40 198
58f82c5c
DM
199 /* guard against magic having been deleted - eg FETCH calling
200 * untie */
f9c6fee5 201 if (!SvMAGIC(sv)) {
a623f893
FC
202 /* recalculate flags */
203 (SSPTR(mgs_ix, MGS *))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
58f82c5c 204 break;
f9c6fee5 205 }
b77f7d40 206
f9c6fee5 207 /* recalculate flags if this entry was deleted. */
ff76feab 208 if (mg->mg_flags & MGf_GSKIP)
a623f893
FC
209 (SSPTR(mgs_ix, MGS *))->mgs_flags &=
210 ~(SVs_GMG|SVs_SMG|SVs_RMG);
a0d0e21e 211 }
7d1328bb
FC
212 else if (vtbl == &PL_vtbl_utf8) {
213 /* get-magic can reallocate the PV */
214 magic_setutf8(sv, mg);
215 }
ff76feab 216
f9c6fee5 217 mg = nextmg;
ff76feab 218
0723351e 219 if (have_new) {
ff76feab
AMS
220 /* Have we finished with the new entries we saw? Start again
221 where we left off (unless there are more new entries). */
222 if (mg == head) {
0723351e 223 have_new = 0;
ff76feab
AMS
224 mg = cur;
225 head = newmg;
226 }
227 }
228
229 /* Were any new entries added? */
0723351e
NC
230 if (!have_new && (newmg = SvMAGIC(sv)) != head) {
231 have_new = 1;
ff76feab
AMS
232 cur = mg;
233 mg = newmg;
a623f893
FC
234 /* recalculate flags */
235 (SSPTR(mgs_ix, MGS *))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
760ac839 236 }
79072805 237 }
463ee0b2 238
a9844598
CS
239 if (saved)
240 restore_magic(INT2PTR(void *, (IV)mgs_ix));
241
79072805
LW
242 return 0;
243}
244
954c1994
GS
245/*
246=for apidoc mg_set
247
248Do magic after a value is assigned to the SV. See C<sv_magic>.
249
250=cut
251*/
252
79072805 253int
864dbfa3 254Perl_mg_set(pTHX_ SV *sv)
79072805 255{
35a4481c 256 const I32 mgs_ix = SSNEW(sizeof(MGS));
79072805 257 MAGIC* mg;
463ee0b2
LW
258 MAGIC* nextmg;
259
7918f24d
NC
260 PERL_ARGS_ASSERT_MG_SET;
261
b5ed8c44
FC
262 if (PL_localizing == 2 && sv == DEFSV) return 0;
263
ff44333e 264 save_magic_flags(mgs_ix, sv, SVs_GMG|SVs_SMG); /* leave SVs_RMG on */
463ee0b2
LW
265
266 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
e1ec3a88 267 const MGVTBL* vtbl = mg->mg_virtual;
463ee0b2 268 nextmg = mg->mg_moremagic; /* it may delete itself */
a0d0e21e
LW
269 if (mg->mg_flags & MGf_GSKIP) {
270 mg->mg_flags &= ~MGf_GSKIP; /* setting requires another read */
a623f893 271 (SSPTR(mgs_ix, MGS*))->mgs_flags &= ~(SVs_GMG|SVs_SMG|SVs_RMG);
a0d0e21e 272 }
e0a73de4 273 if (PL_localizing == 2
b5ed8c44 274 && PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
e7cbf6c6 275 continue;
2b260de0 276 if (vtbl && vtbl->svt_set)
16c91539 277 vtbl->svt_set(aTHX_ sv, mg);
79072805 278 }
463ee0b2 279
8772537c 280 restore_magic(INT2PTR(void*, (IV)mgs_ix));
79072805
LW
281 return 0;
282}
283
954c1994
GS
284/*
285=for apidoc mg_length
286
d4e99c76 287Reports on the SV's length in bytes, calling length magic if available,
bd8446cf
FC
288but does not set the UTF8 flag on the sv. It will fall back to 'get'
289magic if there is no 'length' magic, but with no indication as to
290whether it called 'get' magic. It assumes the sv is a PVMG or
291higher. Use sv_len() instead.
954c1994
GS
292
293=cut
294*/
295
79072805 296U32
864dbfa3 297Perl_mg_length(pTHX_ SV *sv)
79072805
LW
298{
299 MAGIC* mg;
463ee0b2 300 STRLEN len;
463ee0b2 301
7918f24d
NC
302 PERL_ARGS_ASSERT_MG_LENGTH;
303
79072805 304 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
35a4481c 305 const MGVTBL * const vtbl = mg->mg_virtual;
2b260de0 306 if (vtbl && vtbl->svt_len) {
35a4481c 307 const I32 mgs_ix = SSNEW(sizeof(MGS));
455ece5e 308 save_magic(mgs_ix, sv);
a0d0e21e 309 /* omit MGf_GSKIP -- not changed here */
16c91539 310 len = vtbl->svt_len(aTHX_ sv, mg);
8772537c 311 restore_magic(INT2PTR(void*, (IV)mgs_ix));
85e6fe83
LW
312 return len;
313 }
314 }
315
bd8446cf 316 (void)SvPV_const(sv, len);
463ee0b2 317 return len;
79072805
LW
318}
319
8fb26106 320I32
864dbfa3 321Perl_mg_size(pTHX_ SV *sv)
93965878
NIS
322{
323 MAGIC* mg;
ac27b0f5 324
7918f24d
NC
325 PERL_ARGS_ASSERT_MG_SIZE;
326
93965878 327 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
35a4481c 328 const MGVTBL* const vtbl = mg->mg_virtual;
2b260de0 329 if (vtbl && vtbl->svt_len) {
35a4481c
AL
330 const I32 mgs_ix = SSNEW(sizeof(MGS));
331 I32 len;
455ece5e 332 save_magic(mgs_ix, sv);
93965878 333 /* omit MGf_GSKIP -- not changed here */
16c91539 334 len = vtbl->svt_len(aTHX_ sv, mg);
8772537c 335 restore_magic(INT2PTR(void*, (IV)mgs_ix));
93965878
NIS
336 return len;
337 }
338 }
339
340 switch(SvTYPE(sv)) {
341 case SVt_PVAV:
502c6561 342 return AvFILLp((const AV *) sv); /* Fallback to non-tied array */
93965878
NIS
343 case SVt_PVHV:
344 /* FIXME */
345 default:
cea2e8a9 346 Perl_croak(aTHX_ "Size magic not implemented");
81d52ecd 347
93965878 348 }
a25b5927 349 NOT_REACHED; /* NOTREACHED */
93965878
NIS
350}
351
954c1994
GS
352/*
353=for apidoc mg_clear
354
355Clear something magical that the SV represents. See C<sv_magic>.
356
357=cut
358*/
359
79072805 360int
864dbfa3 361Perl_mg_clear(pTHX_ SV *sv)
79072805 362{
35a4481c 363 const I32 mgs_ix = SSNEW(sizeof(MGS));
79072805 364 MAGIC* mg;
8ac77ac9 365 MAGIC *nextmg;
463ee0b2 366
7918f24d
NC
367 PERL_ARGS_ASSERT_MG_CLEAR;
368
455ece5e 369 save_magic(mgs_ix, sv);
463ee0b2 370
8ac77ac9 371 for (mg = SvMAGIC(sv); mg; mg = nextmg) {
35a4481c 372 const MGVTBL* const vtbl = mg->mg_virtual;
a0d0e21e 373 /* omit GSKIP -- never set here */
727405f8 374
8ac77ac9
NC
375 nextmg = mg->mg_moremagic; /* it may delete itself */
376
2b260de0 377 if (vtbl && vtbl->svt_clear)
16c91539 378 vtbl->svt_clear(aTHX_ sv, mg);
79072805 379 }
463ee0b2 380
8772537c 381 restore_magic(INT2PTR(void*, (IV)mgs_ix));
79072805
LW
382 return 0;
383}
384
ed624ca8 385static MAGIC*
ddeaf645 386S_mg_findext_flags(const SV *sv, int type, const MGVTBL *vtbl, U32 flags)
39de7f53 387{
39de7f53
FR
388 assert(flags <= 1);
389
390 if (sv) {
391 MAGIC *mg;
392
393 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
394 if (mg->mg_type == type && (!flags || mg->mg_virtual == vtbl)) {
395 return mg;
396 }
397 }
398 }
399
400 return NULL;
401}
402
954c1994
GS
403/*
404=for apidoc mg_find
405
406Finds the magic pointer for type matching the SV. See C<sv_magic>.
407
408=cut
409*/
410
93a17b20 411MAGIC*
ddeaf645 412Perl_mg_find(const SV *sv, int type)
93a17b20 413{
ddeaf645 414 return S_mg_findext_flags(sv, type, NULL, 0);
39de7f53
FR
415}
416
417/*
418=for apidoc mg_findext
419
420Finds the magic pointer of C<type> with the given C<vtbl> for the C<SV>. See
421C<sv_magicext>.
422
423=cut
424*/
425
426MAGIC*
ddeaf645 427Perl_mg_findext(const SV *sv, int type, const MGVTBL *vtbl)
39de7f53 428{
ddeaf645 429 return S_mg_findext_flags(sv, type, vtbl, 1);
93a17b20
LW
430}
431
96c2a8ff
FC
432MAGIC *
433Perl_mg_find_mglob(pTHX_ SV *sv)
434{
435 PERL_ARGS_ASSERT_MG_FIND_MGLOB;
436 if (SvTYPE(sv) == SVt_PVLV && LvTYPE(sv) == 'y') {
437 /* This sv is only a delegate. //g magic must be attached to
438 its target. */
439 vivify_defelem(sv);
440 sv = LvTARG(sv);
441 }
442 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
ddeaf645 443 return S_mg_findext_flags(sv, PERL_MAGIC_regex_global, 0, 0);
96c2a8ff
FC
444 return NULL;
445}
446
954c1994
GS
447/*
448=for apidoc mg_copy
449
450Copies the magic from one SV to another. See C<sv_magic>.
451
452=cut
453*/
454
79072805 455int
864dbfa3 456Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
79072805 457{
463ee0b2 458 int count = 0;
79072805 459 MAGIC* mg;
7918f24d
NC
460
461 PERL_ARGS_ASSERT_MG_COPY;
462
463ee0b2 463 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
35a4481c 464 const MGVTBL* const vtbl = mg->mg_virtual;
68795e93 465 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
16c91539 466 count += vtbl->svt_copy(aTHX_ sv, mg, nsv, key, klen);
68795e93 467 }
823a54a3
AL
468 else {
469 const char type = mg->mg_type;
1e73acc8 470 if (isUPPER(type) && type != PERL_MAGIC_uvar) {
823a54a3
AL
471 sv_magic(nsv,
472 (type == PERL_MAGIC_tied)
473 ? SvTIED_obj(sv, mg)
474 : (type == PERL_MAGIC_regdata && mg->mg_obj)
475 ? sv
476 : mg->mg_obj,
477 toLOWER(type), key, klen);
478 count++;
479 }
79072805 480 }
79072805 481 }
463ee0b2 482 return count;
79072805
LW
483}
484
954c1994 485/*
0cbee0a4
DM
486=for apidoc mg_localize
487
9711599e 488Copy some of the magic from an existing SV to new localized version of that
154e47c8
FC
489SV. Container magic (eg %ENV, $1, tie)
490gets copied, value magic doesn't (eg
9711599e
CS
491taint, pos).
492
af7df257 493If setmagic is false then no set magic will be called on the new (empty) SV.
9711599e
CS
494This typically means that assignment will soon follow (e.g. 'local $x = $y'),
495and that will handle the magic.
0cbee0a4
DM
496
497=cut
498*/
499
500void
af7df257 501Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
0cbee0a4
DM
502{
503 MAGIC *mg;
7918f24d
NC
504
505 PERL_ARGS_ASSERT_MG_LOCALIZE;
506
658a9f31
JD
507 if (nsv == DEFSV)
508 return;
509
0cbee0a4 510 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
2b1b43ea 511 const MGVTBL* const vtbl = mg->mg_virtual;
e0a73de4 512 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
0cbee0a4 513 continue;
0cbee0a4 514
a5063e7c 515 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
16c91539 516 (void)vtbl->svt_local(aTHX_ nsv, mg);
a5063e7c 517 else
0cbee0a4
DM
518 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
519 mg->mg_ptr, mg->mg_len);
a5063e7c 520
0cbee0a4 521 /* container types should remain read-only across localization */
9ff3e6d8 522 SvFLAGS(nsv) |= SvREADONLY(sv);
0cbee0a4
DM
523 }
524
525 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
526 SvFLAGS(nsv) |= SvMAGICAL(sv);
af7df257 527 if (setmagic) {
9711599e
CS
528 PL_localizing = 1;
529 SvSETMAGIC(nsv);
530 PL_localizing = 0;
531 }
0cbee0a4
DM
532 }
533}
534
d9088386
Z
535#define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
536static void
537S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
538{
539 const MGVTBL* const vtbl = mg->mg_virtual;
540 if (vtbl && vtbl->svt_free)
541 vtbl->svt_free(aTHX_ sv, mg);
542 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
543 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
544 Safefree(mg->mg_ptr);
545 else if (mg->mg_len == HEf_SVKEY)
546 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
547 }
548 if (mg->mg_flags & MGf_REFCOUNTED)
549 SvREFCNT_dec(mg->mg_obj);
550 Safefree(mg);
551}
552
0cbee0a4 553/*
954c1994
GS
554=for apidoc mg_free
555
556Free any magic storage used by the SV. See C<sv_magic>.
557
558=cut
559*/
560
79072805 561int
864dbfa3 562Perl_mg_free(pTHX_ SV *sv)
79072805
LW
563{
564 MAGIC* mg;
565 MAGIC* moremagic;
7918f24d
NC
566
567 PERL_ARGS_ASSERT_MG_FREE;
568
79072805 569 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
79072805 570 moremagic = mg->mg_moremagic;
d9088386 571 mg_free_struct(sv, mg);
c826f41b 572 SvMAGIC_set(sv, moremagic);
79072805 573 }
b162af07 574 SvMAGIC_set(sv, NULL);
68f8932e 575 SvMAGICAL_off(sv);
79072805
LW
576 return 0;
577}
578
d9088386
Z
579/*
580=for apidoc Am|void|mg_free_type|SV *sv|int how
581
582Remove any magic of type I<how> from the SV I<sv>. See L</sv_magic>.
583
584=cut
585*/
586
587void
588Perl_mg_free_type(pTHX_ SV *sv, int how)
589{
590 MAGIC *mg, *prevmg, *moremg;
591 PERL_ARGS_ASSERT_MG_FREE_TYPE;
592 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
593 MAGIC *newhead;
594 moremg = mg->mg_moremagic;
595 if (mg->mg_type == how) {
596 /* temporarily move to the head of the magic chain, in case
597 custom free code relies on this historical aspect of mg_free */
598 if (prevmg) {
599 prevmg->mg_moremagic = moremg;
600 mg->mg_moremagic = SvMAGIC(sv);
601 SvMAGIC_set(sv, mg);
602 }
603 newhead = mg->mg_moremagic;
604 mg_free_struct(sv, mg);
605 SvMAGIC_set(sv, newhead);
606 mg = prevmg;
607 }
608 }
609 mg_magical(sv);
610}
611
79072805 612#include <signal.h>
79072805 613
942e002e 614U32
864dbfa3 615Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
6cef1e77 616{
8772537c 617 PERL_UNUSED_ARG(sv);
6cef1e77 618
7918f24d
NC
619 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
620
0bd48802 621 if (PL_curpm) {
eb578fdb 622 const REGEXP * const rx = PM_GETRE(PL_curpm);
0bd48802 623 if (rx) {
a678b0e4
YO
624 if (mg->mg_obj) { /* @+ */
625 /* return the number possible */
07bc277f 626 return RX_NPARENS(rx);
a678b0e4 627 } else { /* @- */
07bc277f 628 I32 paren = RX_LASTPAREN(rx);
a678b0e4
YO
629
630 /* return the last filled */
f46c4081 631 while ( paren >= 0
07bc277f
NC
632 && (RX_OFFS(rx)[paren].start == -1
633 || RX_OFFS(rx)[paren].end == -1) )
f46c4081 634 paren--;
a678b0e4
YO
635 return (U32)paren;
636 }
0bd48802 637 }
8f580fb8 638 }
ac27b0f5 639
942e002e 640 return (U32)-1;
6cef1e77
IZ
641}
642
6502e081
DM
643/* @-, @+ */
644
6cef1e77 645int
864dbfa3 646Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
6cef1e77 647{
7918f24d
NC
648 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
649
0bd48802 650 if (PL_curpm) {
eb578fdb 651 const REGEXP * const rx = PM_GETRE(PL_curpm);
0bd48802 652 if (rx) {
eb578fdb 653 const I32 paren = mg->mg_len;
a10eae29
FC
654 SSize_t s;
655 SSize_t t;
0bd48802
AL
656 if (paren < 0)
657 return 0;
07bc277f
NC
658 if (paren <= (I32)RX_NPARENS(rx) &&
659 (s = RX_OFFS(rx)[paren].start) != -1 &&
660 (t = RX_OFFS(rx)[paren].end) != -1)
0bd48802 661 {
a10eae29 662 SSize_t i;
0bd48802
AL
663 if (mg->mg_obj) /* @+ */
664 i = t;
665 else /* @- */
666 i = s;
667
a10eae29 668 if (RX_MATCH_UTF8(rx)) {
07bc277f 669 const char * const b = RX_SUBBEG(rx);
0bd48802 670 if (b)
6502e081
DM
671 i = RX_SUBCOFFSET(rx) +
672 utf8_length((U8*)b,
673 (U8*)(b-RX_SUBOFFSET(rx)+i));
0bd48802 674 }
727405f8 675
a10eae29 676 sv_setuv(sv, i);
232af1f8 677 return 0;
1aa99e6b 678 }
0bd48802 679 }
6cef1e77 680 }
232af1f8 681 sv_setsv(sv, NULL);
6cef1e77
IZ
682 return 0;
683}
684
6502e081
DM
685/* @-, @+ */
686
e4b89193 687int
a29d06ed
MG
688Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
689{
7918f24d 690 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
dc3bf405 691 PERL_UNUSED_CONTEXT;
d4c19fe8
AL
692 PERL_UNUSED_ARG(sv);
693 PERL_UNUSED_ARG(mg);
cb077ed2 694 Perl_croak_no_modify();
0dbb1585 695 NORETURN_FUNCTION_END;
a29d06ed
MG
696}
697
ad3296c6 698#define SvRTRIM(sv) STMT_START { \
eae92ea0
GA
699 if (SvPOK(sv)) { \
700 STRLEN len = SvCUR(sv); \
701 char * const p = SvPVX(sv); \
8e6b4db6
PC
702 while (len > 0 && isSPACE(p[len-1])) \
703 --len; \
704 SvCUR_set(sv, len); \
705 p[len] = '\0'; \
706 } \
ad3296c6
SH
707} STMT_END
708
8b850bd5
NC
709void
710Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
711{
7918f24d
NC
712 PERL_ARGS_ASSERT_EMULATE_COP_IO;
713
8b850bd5
NC
714 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
715 sv_setsv(sv, &PL_sv_undef);
716 else {
717 sv_setpvs(sv, "");
718 SvUTF8_off(sv);
719 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
20439bc7 720 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
8b850bd5
NC
721 assert(value);
722 sv_catsv(sv, value);
723 }
724 sv_catpvs(sv, "\0");
725 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
20439bc7 726 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
8b850bd5
NC
727 assert(value);
728 sv_catsv(sv, value);
729 }
730 }
731}
732
d9fe7d23
KW
733STATIC void
734S_fixup_errno_string(pTHX_ SV* sv)
735{
736 /* Do what is necessary to fixup the non-empty string in 'sv' for return to
737 * Perl space. */
738
739 PERL_ARGS_ASSERT_FIXUP_ERRNO_STRING;
740
741 assert(SvOK(sv));
b35e4f8b
KW
742
743 if(strEQ(SvPVX(sv), "")) {
744 sv_catpv(sv, UNKNOWN_ERRNO_MSG);
745 }
746 else {
d9fe7d23 747
d3c0b317
KW
748 /* In some locales the error string may come back as UTF-8, in which
749 * case we should turn on that flag. This didn't use to happen, and to
5320b60d
KW
750 * avoid as many possible backward compatibility issues as possible, we
751 * don't turn on the flag unless we have to. So the flag stays off for
9f10db87
KW
752 * an entirely invariant string. We assume that if the string looks
753 * like UTF-8, it really is UTF-8: "text in any other encoding that
754 * uses bytes with the high bit set is extremely unlikely to pass a
755 * UTF-8 validity test"
756 * (http://en.wikipedia.org/wiki/Charset_detection). There is a
757 * potential that we will get it wrong however, especially on short
758 * error message text. (If it turns out to be necessary, we could also
759 * keep track if the current LC_MESSAGES locale is UTF-8) */
d3c0b317 760 if (! IN_BYTES /* respect 'use bytes' */
9f10db87 761 && ! is_invariant_string((U8*) SvPVX_const(sv), SvCUR(sv))
d3c0b317
KW
762 && is_utf8_string((U8*) SvPVX_const(sv), SvCUR(sv)))
763 {
764 SvUTF8_on(sv);
765 }
b35e4f8b 766 }
d9fe7d23
KW
767}
768
ad2de1b2
KW
769SV*
770Perl__get_encoding(pTHX)
771{
3e669301
KW
772 /* For core Perl use only: Returns the $^ENCODING or 'use encoding' in
773 * effect; NULL if none.
774 *
775 * $^ENCODING maps to PL_encoding, and is the old way to do things, and is
776 * retained for backwards compatibility. Now, there is a shadow variable
777 * ${^E_NCODING} set only by the encoding pragma, used to give this pragma
778 * lexical scope, unlike the global scope it (shudder) used to have. This
779 * variable maps to PL_lex_encoding. Again for backwards compatibility,
780 * PL_encoding has precedence over PL_lex_encoding. The hints hash is used
781 * to determine if PL_lex_encoding is in scope, and hence valid. The hints
782 * hash only accepts simple values, so we can't put an Encode object into
783 * it, so we put the object into the global, and put a simple boolean into
784 * the hints hash giving whether the global is valid or not */
785
c79dccf4 786 dVAR;
3e669301
KW
787 SV *is_encoding;
788
789 if (PL_encoding) {
790 return PL_encoding;
791 }
792
793 if (! PL_lex_encoding) {
794 return NULL;
795 }
796
797 is_encoding = cop_hints_fetch_pvs(PL_curcop, "encoding", 0);
798 if ( is_encoding
799 && is_encoding != &PL_sv_placeholder
800 && SvIOK(is_encoding)
801 && SvIV(is_encoding)) /* non-zero mean valid */
802 {
803 return PL_lex_encoding;
804 }
ad2de1b2 805
3e669301 806 return NULL;
ad2de1b2
KW
807}
808
25bbd826
CB
809#ifdef VMS
810#include <descrip.h>
811#include <starlet.h>
812#endif
813
79072805 814int
864dbfa3 815Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
79072805 816{
eb578fdb
KW
817 I32 paren;
818 const char *s = NULL;
819 REGEXP *rx;
823a54a3 820 const char * const remaining = mg->mg_ptr + 1;
e91d8259 821 char nextchar;
79072805 822
7918f24d
NC
823 PERL_ARGS_ASSERT_MAGIC_GET;
824
e91d8259 825 if (!mg->mg_ptr) {
e91d8259 826 paren = mg->mg_len;
e91d8259 827 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
a6d0b1b5 828 do_numbuf_fetch:
e91d8259
NC
829 CALLREG_NUMBUF_FETCH(rx,paren,sv);
830 } else {
831 sv_setsv(sv,&PL_sv_undef);
832 }
833 return 0;
834 }
835
836 nextchar = *remaining;
79072805 837 switch (*mg->mg_ptr) {
748a9306 838 case '\001': /* ^A */
f2da823f
FC
839 if (SvOK(PL_bodytarget)) sv_copypv(sv, PL_bodytarget);
840 else sv_setsv(sv, &PL_sv_undef);
125b9982
NT
841 if (SvTAINTED(PL_bodytarget))
842 SvTAINTED_on(sv);
748a9306 843 break;
e5218da5 844 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
823a54a3 845 if (nextchar == '\0') {
e5218da5
GA
846 sv_setiv(sv, (IV)PL_minus_c);
847 }
823a54a3 848 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
e5218da5
GA
849 sv_setiv(sv, (IV)STATUS_NATIVE);
850 }
49460fe6
NIS
851 break;
852
79072805 853 case '\004': /* ^D */
aea4f609 854 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
79072805 855 break;
28f23441 856 case '\005': /* ^E */
6c6eab55
KW
857 if (nextchar != '\0') {
858 if (strEQ(remaining, "NCODING"))
ad2de1b2 859 sv_setsv(sv, _get_encoding());
199670db
FC
860 else if (strEQ(remaining, "_NCODING"))
861 sv_setsv(sv, NULL);
4f4ff3a7 862 break;
6c6eab55 863 }
4f4ff3a7
KW
864
865#if defined(VMS) || defined(OS2) || defined(WIN32)
866# if defined(VMS)
2a99ff86
KW
867 {
868 char msg[255];
869 $DESCRIPTOR(msgdsc,msg);
870 sv_setnv(sv,(NV) vaxc$errno);
871 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
872 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
873 else
874 sv_setpvs(sv,"");
875 }
4b645107 876#elif defined(OS2)
2a99ff86
KW
877 if (!(_emx_env & 0x200)) { /* Under DOS */
878 sv_setnv(sv, (NV)errno);
2c6ee1a7 879 sv_setpv(sv, errno ? my_strerror(errno) : "");
2a99ff86
KW
880 } else {
881 if (errno != errno_isOS2) {
882 const int tmp = _syserrno();
883 if (tmp) /* 2nd call to _syserrno() makes it 0 */
884 Perl_rc = tmp;
885 }
886 sv_setnv(sv, (NV)Perl_rc);
887 sv_setpv(sv, os2error(Perl_rc));
888 }
1534c6f5 889 if (SvOK(sv) && strNE(SvPVX(sv), "")) {
99461a73
KW
890 fixup_errno_string(sv);
891 }
4f4ff3a7 892# elif defined(WIN32)
2a99ff86
KW
893 {
894 const DWORD dwErr = GetLastError();
895 sv_setnv(sv, (NV)dwErr);
896 if (dwErr) {
897 PerlProc_GetOSError(sv, dwErr);
2efab60d 898 fixup_errno_string(sv);
2a99ff86
KW
899 }
900 else
901 sv_setpvs(sv, "");
902 SetLastError(dwErr);
903 }
4f4ff3a7
KW
904# else
905# error Missing code for platform
906# endif
2a99ff86
KW
907 SvRTRIM(sv);
908 SvNOK_on(sv); /* what a wonderful hack! */
909 break;
4f4ff3a7
KW
910#endif /* End of platforms with special handling for $^E; others just fall
911 through to $! */
46f3e16c
KW
912
913 case '!':
914 {
5f1b979d 915 dSAVE_ERRNO;
46f3e16c 916#ifdef VMS
5f1b979d 917 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
46f3e16c 918#else
5f1b979d 919 sv_setnv(sv, (NV)errno);
46f3e16c
KW
920#endif
921#ifdef OS2
5f1b979d
KW
922 if (errno == errno_isOS2 || errno == errno_isOS2_set)
923 sv_setpv(sv, os2error(Perl_rc));
924 else
46f3e16c 925#endif
5f1b979d
KW
926 if (! errno) {
927 sv_setpvs(sv, "");
46f3e16c 928 }
5f1b979d
KW
929 else {
930
931 /* Strerror can return NULL on some platforms, which will
932 * result in 'sv' not being considered SvOK. The SvNOK_on()
933 * below will cause just the number part to be valid */
2c6ee1a7 934 sv_setpv(sv, my_strerror(errno));
5f1b979d
KW
935 if (SvOK(sv)) {
936 fixup_errno_string(sv);
937 }
938 }
939 RESTORE_ERRNO;
46f3e16c
KW
940 }
941
942 SvRTRIM(sv);
943 SvNOK_on(sv); /* what a wonderful hack! */
944 break;
945
79072805 946 case '\006': /* ^F */
3280af22 947 sv_setiv(sv, (IV)PL_maxsysfd);
79072805 948 break;
9ebf26ad
FR
949 case '\007': /* ^GLOBAL_PHASE */
950 if (strEQ(remaining, "LOBAL_PHASE")) {
951 sv_setpvn(sv, PL_phase_names[PL_phase],
952 strlen(PL_phase_names[PL_phase]));
953 }
954 break;
a0d0e21e 955 case '\010': /* ^H */
3280af22 956 sv_setiv(sv, (IV)PL_hints);
a0d0e21e 957 break;
9d116dd7 958 case '\011': /* ^I */ /* NOT \t in EBCDIC */
120f7abe 959 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
79072805 960 break;
8561ea1d
FC
961 case '\014': /* ^LAST_FH */
962 if (strEQ(remaining, "AST_FH")) {
963 if (PL_last_in_gv) {
964 assert(isGV_with_GP(PL_last_in_gv));
965 SV_CHECK_THINKFIRST_COW_DROP(sv);
966 prepare_SV_for_RV(sv);
967 SvOK_off(sv);
968 SvRV_set(sv, SvREFCNT_inc_simple_NN(PL_last_in_gv));
969 SvROK_on(sv);
970 sv_rvweaken(sv);
971 }
972 else sv_setsv_nomg(sv, NULL);
973 }
974 break;
ac27b0f5 975 case '\017': /* ^O & ^OPEN */
823a54a3 976 if (nextchar == '\0') {
ac27b0f5 977 sv_setpv(sv, PL_osname);
3511154c
DM
978 SvTAINTED_off(sv);
979 }
823a54a3 980 else if (strEQ(remaining, "PEN")) {
8b850bd5 981 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
ac27b0f5 982 }
28f23441 983 break;
9ebf26ad 984 case '\020':
a6d0b1b5 985 sv_setiv(sv, (IV)PL_perldb);
79072805 986 break;
fb73857a 987 case '\023': /* ^S */
a6d0b1b5 988 {
bc177e6b 989 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
0c34ef67 990 SvOK_off(sv);
3280af22 991 else if (PL_in_eval)
6dc8a9e4 992 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
a4268c0a
AMS
993 else
994 sv_setiv(sv, 0);
d58bf5aa 995 }
fb73857a 996 break;
79072805 997 case '\024': /* ^T */
823a54a3 998 if (nextchar == '\0') {
88e89b8a 999#ifdef BIG_TIME
7c36658b 1000 sv_setnv(sv, PL_basetime);
88e89b8a 1001#else
7c36658b 1002 sv_setiv(sv, (IV)PL_basetime);
88e89b8a 1003#endif
7c36658b 1004 }
823a54a3 1005 else if (strEQ(remaining, "AINT"))
284167a5
S
1006 sv_setiv(sv, TAINTING_get
1007 ? (TAINT_WARN_get || PL_unsafe ? -1 : 1)
9aa05f58 1008 : 0);
7c36658b 1009 break;
e07ea26a 1010 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
823a54a3 1011 if (strEQ(remaining, "NICODE"))
a05d7ebb 1012 sv_setuv(sv, (UV) PL_unicode);
823a54a3 1013 else if (strEQ(remaining, "TF8LOCALE"))
7cebcbc0 1014 sv_setuv(sv, (UV) PL_utf8locale);
e07ea26a
NC
1015 else if (strEQ(remaining, "TF8CACHE"))
1016 sv_setiv(sv, (IV) PL_utf8cache);
fde18df1
JH
1017 break;
1018 case '\027': /* ^W & $^WARNING_BITS */
823a54a3 1019 if (nextchar == '\0')
4438c4b7 1020 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
823a54a3 1021 else if (strEQ(remaining, "ARNING_BITS")) {
013b78e8 1022 if (PL_compiling.cop_warnings == pWARN_NONE) {
4438c4b7 1023 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
013b78e8
RGS
1024 }
1025 else if (PL_compiling.cop_warnings == pWARN_STD) {
7e4f0450
FC
1026 sv_setsv(sv, &PL_sv_undef);
1027 break;
013b78e8 1028 }
d3a7d8c7 1029 else if (PL_compiling.cop_warnings == pWARN_ALL) {
75b6c4ca
RGS
1030 /* Get the bit mask for $warnings::Bits{all}, because
1031 * it could have been extended by warnings::register */
4bac9ae4
CS
1032 HV * const bits = get_hv("warnings::Bits", 0);
1033 SV ** const bits_all = bits ? hv_fetchs(bits, "all", FALSE) : NULL;
1034 if (bits_all)
1035 sv_copypv(sv, *bits_all);
1036 else
1037 sv_setpvn(sv, WARN_ALLstring, WARNsize);
ac27b0f5 1038 }
4438c4b7 1039 else {
72dc9ed5
NC
1040 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
1041 *PL_compiling.cop_warnings);
ac27b0f5 1042 }
4438c4b7 1043 }
79072805 1044 break;
79072805 1045 case '+':
aaa362c4 1046 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2c7b5d76
DM
1047 paren = RX_LASTPAREN(rx);
1048 if (paren)
1049 goto do_numbuf_fetch;
79072805 1050 }
3280af22 1051 sv_setsv(sv,&PL_sv_undef);
79072805 1052 break;
a01268b5
JH
1053 case '\016': /* ^N */
1054 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2c7b5d76
DM
1055 paren = RX_LASTCLOSEPAREN(rx);
1056 if (paren)
1057 goto do_numbuf_fetch;
a01268b5
JH
1058 }
1059 sv_setsv(sv,&PL_sv_undef);
1060 break;
79072805 1061 case '.':
3280af22 1062 if (GvIO(PL_last_in_gv)) {
357c8808 1063 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
79072805 1064 }
79072805
LW
1065 break;
1066 case '?':
809a5acc 1067 {
809a5acc 1068 sv_setiv(sv, (IV)STATUS_CURRENT);
ff0cee69 1069#ifdef COMPLEX_STATUS
41cb7b2b 1070 SvUPGRADE(sv, SVt_PVLV);
6b88bc9c
GS
1071 LvTARGOFF(sv) = PL_statusvalue;
1072 LvTARGLEN(sv) = PL_statusvalue_vms;
ff0cee69 1073#endif
809a5acc 1074 }
79072805
LW
1075 break;
1076 case '^':
acbe1b9d 1077 if (GvIOp(PL_defoutgv))
099be4f1 1078 s = IoTOP_NAME(GvIOp(PL_defoutgv));
79072805
LW
1079 if (s)
1080 sv_setpv(sv,s);
1081 else {
3280af22 1082 sv_setpv(sv,GvENAME(PL_defoutgv));
cb421d5e 1083 sv_catpvs(sv,"_TOP");
79072805
LW
1084 }
1085 break;
1086 case '~':
acbe1b9d 1087 if (GvIOp(PL_defoutgv))
0daa599b 1088 s = IoFMT_NAME(GvIOp(PL_defoutgv));
79072805 1089 if (!s)
3280af22 1090 s = GvENAME(PL_defoutgv);
79072805
LW
1091 sv_setpv(sv,s);
1092 break;
79072805 1093 case '=':
099be4f1 1094 if (GvIO(PL_defoutgv))
0daa599b 1095 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
79072805
LW
1096 break;
1097 case '-':
099be4f1 1098 if (GvIO(PL_defoutgv))
0daa599b 1099 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
79072805
LW
1100 break;
1101 case '%':
099be4f1 1102 if (GvIO(PL_defoutgv))
0daa599b 1103 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
79072805 1104 break;
79072805 1105 case ':':
79072805
LW
1106 case '/':
1107 break;
1108 case '[':
e1dccc0d 1109 sv_setiv(sv, 0);
79072805
LW
1110 break;
1111 case '|':
099be4f1 1112 if (GvIO(PL_defoutgv))
0daa599b 1113 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
79072805 1114 break;
79072805 1115 case '\\':
b2ce0fda 1116 if (PL_ors_sv)
f28098ff 1117 sv_copypv(sv, PL_ors_sv);
4bac9ae4
CS
1118 else
1119 sv_setsv(sv, &PL_sv_undef);
79072805 1120 break;
0e219455 1121 case '$': /* $$ */
9cdac2a2
FC
1122 {
1123 IV const pid = (IV)PerlProc_getpid();
19db9fb7 1124 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid) {
9cdac2a2
FC
1125 /* never set manually, or at least not since last fork */
1126 sv_setiv(sv, pid);
19db9fb7
Z
1127 /* never unsafe, even if reading in a tainted expression */
1128 SvTAINTED_off(sv);
1129 }
9cdac2a2
FC
1130 /* else a value has been assigned manually, so do nothing */
1131 }
0e219455 1132 break;
79072805 1133 case '<':
dfff4baf 1134 sv_setuid(sv, PerlProc_getuid());
79072805
LW
1135 break;
1136 case '>':
dfff4baf 1137 sv_setuid(sv, PerlProc_geteuid());
79072805
LW
1138 break;
1139 case '(':
dfff4baf 1140 sv_setgid(sv, PerlProc_getgid());
79072805
LW
1141 goto add_groups;
1142 case ')':
dfff4baf 1143 sv_setgid(sv, PerlProc_getegid());
79072805 1144 add_groups:
79072805 1145#ifdef HAS_GETGROUPS
79072805 1146 {
57d7c65e 1147 Groups_t *gary = NULL;
375ed12a
JH
1148 I32 i;
1149 I32 num_groups = getgroups(0, gary);
1150 if (num_groups > 0) {
1151 Newx(gary, num_groups, Groups_t);
1152 num_groups = getgroups(num_groups, gary);
1153 for (i = 0; i < num_groups; i++)
1154 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1155 Safefree(gary);
1156 }
79072805 1157 }
155aba94 1158 (void)SvIOK_on(sv); /* what a wonderful hack! */
cd70abae 1159#endif
79072805 1160 break;
79072805
LW
1161 case '0':
1162 break;
1163 }
a0d0e21e 1164 return 0;
79072805
LW
1165}
1166
1167int
864dbfa3 1168Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
79072805 1169{
8772537c 1170 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
79072805 1171
7918f24d
NC
1172 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1173
79072805 1174 if (uf && uf->uf_val)
24f81a43 1175 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
79072805
LW
1176 return 0;
1177}
1178
1179int
864dbfa3 1180Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
79072805 1181{
9ae3433d 1182 STRLEN len = 0, klen;
12033064 1183 const char * const key = MgPV_const(mg,klen);
888a67f6 1184 const char *s = "";
1e422769 1185
7918f24d
NC
1186 PERL_ARGS_ASSERT_MAGIC_SETENV;
1187
613c63b4 1188 SvGETMAGIC(sv);
12033064 1189 if (SvOK(sv)) {
613c63b4
CS
1190 /* defined environment variables are byte strings; unfortunately
1191 there is no SvPVbyte_force_nomg(), so we must do this piecewise */
1192 (void)SvPV_force_nomg_nolen(sv);
1193 sv_utf8_downgrade(sv, /* fail_ok */ TRUE);
1194 if (SvUTF8(sv)) {
1195 Perl_ck_warner_d(aTHX_ packWARN(WARN_UTF8), "Wide character in %s", "setenv");
1196 SvUTF8_off(sv);
1197 }
1198 s = SvPVX(sv);
1199 len = SvCUR(sv);
12033064
CS
1200 }
1201 my_setenv(key, s); /* does the deed */
1202
a0d0e21e
LW
1203#ifdef DYNAMIC_ENV_FETCH
1204 /* We just undefd an environment var. Is a replacement */
1205 /* waiting in the wings? */
1206 if (!len) {
6bd66ee9 1207 SV ** const valp = hv_fetch(GvHVn(PL_envgv), key, klen, FALSE);
fabdb6c0 1208 if (valp)
4ab59fcc 1209 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
a0d0e21e
LW
1210 }
1211#endif
1e422769 1212
39e571d4 1213#if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
79072805
LW
1214 /* And you'll never guess what the dog had */
1215 /* in its mouth... */
284167a5 1216 if (TAINTING_get) {
1e422769 1217 MgTAINTEDDIR_off(mg);
1218#ifdef VMS
6bd66ee9 1219 if (s && klen == 8 && strEQ(key, "DCL$PATH")) {
b8ffc8df 1220 char pathbuf[256], eltbuf[256], *cp, *elt;
1e422769 1221 int i = 0, j = 0;
1222
6fca0082 1223 my_strlcpy(eltbuf, s, sizeof(eltbuf));
b8ffc8df 1224 elt = eltbuf;
1e422769 1225 do { /* DCL$PATH may be a search list */
1226 while (1) { /* as may dev portion of any element */
1227 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1228 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1229 cando_by_name(S_IWUSR,0,elt) ) {
1230 MgTAINTEDDIR_on(mg);
1231 return 0;
1232 }
1233 }
bd61b366 1234 if ((cp = strchr(elt, ':')) != NULL)
1e422769 1235 *cp = '\0';
1236 if (my_trnlnm(elt, eltbuf, j++))
1237 elt = eltbuf;
1238 else
1239 break;
1240 }
1241 j = 0;
1242 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1243 }
1244#endif /* VMS */
12033064 1245 if (s && klen == 4 && strEQ(key,"PATH")) {
8772537c 1246 const char * const strend = s + len;
463ee0b2
LW
1247
1248 while (s < strend) {
96827780 1249 char tmpbuf[256];
c623ac67 1250 Stat_t st;
5f74f29c 1251 I32 i;
f5a63d97
AL
1252#ifdef VMS /* Hmm. How do we get $Config{path_sep} from C? */
1253 const char path_sep = '|';
1254#else
1255 const char path_sep = ':';
1256#endif
96827780 1257 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
427eaa01 1258 s, strend, path_sep, &i);
463ee0b2 1259 s++;
bb7a0f54 1260 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
326b5008
CB
1261#ifdef VMS
1262 || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1263#else
1264 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1265#endif
c6ed36e1 1266 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
8990e307 1267 MgTAINTEDDIR_on(mg);
1e422769 1268 return 0;
1269 }
463ee0b2 1270 }
79072805
LW
1271 }
1272 }
39e571d4 1273#endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1e422769 1274
79072805
LW
1275 return 0;
1276}
1277
1278int
864dbfa3 1279Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
85e6fe83 1280{
7918f24d 1281 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
8772537c 1282 PERL_UNUSED_ARG(sv);
bd61b366 1283 my_setenv(MgPV_nolen_const(mg),NULL);
85e6fe83
LW
1284 return 0;
1285}
1286
88e89b8a 1287int
864dbfa3 1288Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
fb73857a 1289{
7918f24d 1290 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
65e66c80 1291 PERL_UNUSED_ARG(mg);
b0269e46 1292#if defined(VMS)
cea2e8a9 1293 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
fb73857a 1294#else
3280af22 1295 if (PL_localizing) {
fb73857a 1296 HE* entry;
b0269e46 1297 my_clearenv();
85fbaab2
NC
1298 hv_iterinit(MUTABLE_HV(sv));
1299 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
fb73857a 1300 I32 keylen;
1301 my_setenv(hv_iterkey(entry, &keylen),
85fbaab2 1302 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
fb73857a 1303 }
1304 }
1305#endif
1306 return 0;
1307}
1308
1309int
864dbfa3 1310Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
66b1d557 1311{
7918f24d 1312 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
8772537c
AL
1313 PERL_UNUSED_ARG(sv);
1314 PERL_UNUSED_ARG(mg);
b0269e46
AB
1315#if defined(VMS)
1316 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1317#else
1318 my_clearenv();
1319#endif
3e3baf6d 1320 return 0;
66b1d557
HM
1321}
1322
64ca3a65 1323#ifndef PERL_MICRO
2d4fcd5e
AJ
1324#ifdef HAS_SIGPROCMASK
1325static void
1326restore_sigmask(pTHX_ SV *save_sv)
1327{
0bd48802 1328 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
f5a63d97 1329 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
2d4fcd5e
AJ
1330}
1331#endif
66b1d557 1332int
864dbfa3 1333Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
88e89b8a 1334{
88e89b8a 1335 /* Are we fetching a signal entry? */
708854f2 1336 int i = (I16)mg->mg_private;
7918f24d
NC
1337
1338 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1339
708854f2 1340 if (!i) {
84c7b88c
BF
1341 STRLEN siglen;
1342 const char * sig = MgPV_const(mg, siglen);
1343 mg->mg_private = i = whichsig_pvn(sig, siglen);
708854f2
NC
1344 }
1345
e02bfb16 1346 if (i > 0) {
22c35a8c
GS
1347 if(PL_psig_ptr[i])
1348 sv_setsv(sv,PL_psig_ptr[i]);
88e89b8a 1349 else {
46da273f 1350 Sighandler_t sigstate = rsignal_state(i);
23ada85b 1351#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
46da273f
AL
1352 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1353 sigstate = SIG_IGN;
2e34cc90
CL
1354#endif
1355#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
46da273f
AL
1356 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1357 sigstate = SIG_DFL;
85b332e2 1358#endif
88e89b8a 1359 /* cache state so we don't fetch it again */
8aad04aa 1360 if(sigstate == (Sighandler_t) SIG_IGN)
6502358f 1361 sv_setpvs(sv,"IGNORE");
88e89b8a 1362 else
3280af22 1363 sv_setsv(sv,&PL_sv_undef);
46da273f 1364 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
88e89b8a 1365 SvTEMP_off(sv);
1366 }
1367 }
1368 return 0;
1369}
1370int
864dbfa3 1371Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
88e89b8a 1372{
7918f24d 1373 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
179c85a2 1374
38a124f0 1375 magic_setsig(NULL, mg);
179c85a2 1376 return sv_unmagic(sv, mg->mg_type);
88e89b8a 1377}
3d37d572 1378
0a8e0eff 1379Signal_t
8aad04aa 1380#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
b6455c53 1381Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
8aad04aa 1382#else
0a8e0eff 1383Perl_csighandler(int sig)
8aad04aa 1384#endif
0a8e0eff 1385{
1018e26f
NIS
1386#ifdef PERL_GET_SIG_CONTEXT
1387 dTHXa(PERL_GET_SIG_CONTEXT);
1388#else
85b332e2
CL
1389 dTHX;
1390#endif
1271a1be 1391#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
ffb6256b
JH
1392#if defined(__cplusplus) && defined(__GNUC__)
1393 /* g++ doesn't support PERL_UNUSED_DECL, so the sip and uap
1394 * parameters would be warned about. */
1395 PERL_UNUSED_ARG(sip);
1396 PERL_UNUSED_ARG(uap);
1397#endif
1271a1be 1398#endif
23ada85b 1399#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
5c1546dc 1400 (void) rsignal(sig, PL_csighandlerp);
27da23d5 1401 if (PL_sig_ignoring[sig]) return;
85b332e2 1402#endif
2e34cc90 1403#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
27da23d5 1404 if (PL_sig_defaulting[sig])
2e34cc90
CL
1405#ifdef KILL_BY_SIGPRC
1406 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1407#else
1408 exit(1);
1409#endif
1410#endif
406878dd 1411 if (
853d2c32
RGS
1412#ifdef SIGILL
1413 sig == SIGILL ||
1414#endif
1415#ifdef SIGBUS
1416 sig == SIGBUS ||
1417#endif
1418#ifdef SIGSEGV
1419 sig == SIGSEGV ||
1420#endif
1421 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
4ffa73a3 1422 /* Call the perl level handler now--
31c91b43 1423 * with risk we may be in malloc() or being destructed etc. */
6e324d09 1424#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
80626cf1 1425 (*PL_sighandlerp)(sig, NULL, NULL);
6e324d09
CB
1426#else
1427 (*PL_sighandlerp)(sig);
92807b6d 1428#endif
406878dd 1429 else {
31c91b43 1430 if (!PL_psig_pend) return;
406878dd
GA
1431 /* Set a flag to say this signal is pending, that is awaiting delivery after
1432 * the current Perl opcode completes */
1433 PL_psig_pend[sig]++;
1434
1435#ifndef SIG_PENDING_DIE_COUNT
1436# define SIG_PENDING_DIE_COUNT 120
1437#endif
fe13d51d 1438 /* Add one to say _a_ signal is pending */
406878dd
GA
1439 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1440 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1441 (unsigned long)SIG_PENDING_DIE_COUNT);
1442 }
0a8e0eff
NIS
1443}
1444
2e34cc90
CL
1445#if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1446void
1447Perl_csighandler_init(void)
1448{
1449 int sig;
27da23d5 1450 if (PL_sig_handlers_initted) return;
2e34cc90
CL
1451
1452 for (sig = 1; sig < SIG_SIZE; sig++) {
1453#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
218fdd94 1454 dTHX;
27da23d5 1455 PL_sig_defaulting[sig] = 1;
5c1546dc 1456 (void) rsignal(sig, PL_csighandlerp);
2e34cc90
CL
1457#endif
1458#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
27da23d5 1459 PL_sig_ignoring[sig] = 0;
2e34cc90
CL
1460#endif
1461 }
27da23d5 1462 PL_sig_handlers_initted = 1;
2e34cc90
CL
1463}
1464#endif
1465
7fe50b8b
LT
1466#if defined HAS_SIGPROCMASK
1467static void
1468unblock_sigmask(pTHX_ void* newset)
1469{
dc3bf405 1470 PERL_UNUSED_CONTEXT;
7fe50b8b
LT
1471 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1472}
1473#endif
1474
0a8e0eff
NIS
1475void
1476Perl_despatch_signals(pTHX)
1477{
1478 int sig;
1479 PL_sig_pending = 0;
1480 for (sig = 1; sig < SIG_SIZE; sig++) {
1481 if (PL_psig_pend[sig]) {
d0166017 1482 dSAVE_ERRNO;
7fe50b8b 1483#ifdef HAS_SIGPROCMASK
55534442
LT
1484 /* From sigaction(2) (FreeBSD man page):
1485 * | Signal routines normally execute with the signal that
1486 * | caused their invocation blocked, but other signals may
1487 * | yet occur.
1488 * Emulation of this behavior (from within Perl) is enabled
1489 * using sigprocmask
1490 */
1491 int was_blocked;
1492 sigset_t newset, oldset;
1493
1494 sigemptyset(&newset);
1495 sigaddset(&newset, sig);
1496 sigprocmask(SIG_BLOCK, &newset, &oldset);
1497 was_blocked = sigismember(&oldset, sig);
7fe50b8b
LT
1498 if (!was_blocked) {
1499 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1500 ENTER;
1501 SAVEFREESV(save_sv);
1502 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1503 }
55534442 1504#endif
25da4428 1505 PL_psig_pend[sig] = 0;
6e324d09 1506#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
80626cf1 1507 (*PL_sighandlerp)(sig, NULL, NULL);
6e324d09
CB
1508#else
1509 (*PL_sighandlerp)(sig);
92807b6d 1510#endif
7fe50b8b 1511#ifdef HAS_SIGPROCMASK
55534442 1512 if (!was_blocked)
7fe50b8b 1513 LEAVE;
55534442 1514#endif
d0166017 1515 RESTORE_ERRNO;
0a8e0eff
NIS
1516 }
1517 }
1518}
1519
38a124f0 1520/* sv of NULL signifies that we're acting as magic_clearsig. */
85e6fe83 1521int
864dbfa3 1522Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
79072805 1523{
27da23d5 1524 dVAR;
79072805 1525 I32 i;
cbbf8932 1526 SV** svp = NULL;
2d4fcd5e
AJ
1527 /* Need to be careful with SvREFCNT_dec(), because that can have side
1528 * effects (due to closures). We must make sure that the new disposition
1529 * is in place before it is called.
1530 */
cbbf8932 1531 SV* to_dec = NULL;
e72dc28c 1532 STRLEN len;
2d4fcd5e
AJ
1533#ifdef HAS_SIGPROCMASK
1534 sigset_t set, save;
1535 SV* save_sv;
1536#endif
eb578fdb 1537 const char *s = MgPV_const(mg,len);
7918f24d
NC
1538
1539 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1540
748a9306 1541 if (*s == '_') {
84c7b88c 1542 if (memEQs(s, len, "__DIE__"))
3280af22 1543 svp = &PL_diehook;
84c7b88c 1544 else if (memEQs(s, len, "__WARN__")
38a124f0
NC
1545 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1546 /* Merge the existing behaviours, which are as follows:
1547 magic_setsig, we always set svp to &PL_warnhook
1548 (hence we always change the warnings handler)
1549 For magic_clearsig, we don't change the warnings handler if it's
1550 set to the &PL_warnhook. */
3280af22 1551 svp = &PL_warnhook;
84c7b88c
BF
1552 } else if (sv) {
1553 SV *tmp = sv_newmortal();
1554 Perl_croak(aTHX_ "No such hook: %s",
1555 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1556 }
748a9306 1557 i = 0;
38a124f0 1558 if (svp && *svp) {
9289f461
RGS
1559 if (*svp != PERL_WARNHOOK_FATAL)
1560 to_dec = *svp;
cbbf8932 1561 *svp = NULL;
4633a7c4 1562 }
748a9306
LW
1563 }
1564 else {
708854f2
NC
1565 i = (I16)mg->mg_private;
1566 if (!i) {
84c7b88c 1567 i = whichsig_pvn(s, len); /* ...no, a brick */
58a26b12 1568 mg->mg_private = (U16)i;
708854f2 1569 }
86d86cad 1570 if (i <= 0) {
84c7b88c
BF
1571 if (sv) {
1572 SV *tmp = sv_newmortal();
1573 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1574 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1575 }
748a9306
LW
1576 return 0;
1577 }
2d4fcd5e
AJ
1578#ifdef HAS_SIGPROCMASK
1579 /* Avoid having the signal arrive at a bad time, if possible. */
1580 sigemptyset(&set);
1581 sigaddset(&set,i);
1582 sigprocmask(SIG_BLOCK, &set, &save);
1583 ENTER;
9ff8e806 1584 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
2d4fcd5e
AJ
1585 SAVEFREESV(save_sv);
1586 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1587#endif
1588 PERL_ASYNC_CHECK();
2e34cc90 1589#if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
27da23d5 1590 if (!PL_sig_handlers_initted) Perl_csighandler_init();
2e34cc90 1591#endif
23ada85b 1592#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
27da23d5 1593 PL_sig_ignoring[i] = 0;
85b332e2 1594#endif
2e34cc90 1595#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
27da23d5 1596 PL_sig_defaulting[i] = 0;
2e34cc90 1597#endif
2d4fcd5e 1598 to_dec = PL_psig_ptr[i];
38a124f0
NC
1599 if (sv) {
1600 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1601 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
79fd3822
NC
1602
1603 /* Signals don't change name during the program's execution, so once
1604 they're cached in the appropriate slot of PL_psig_name, they can
1605 stay there.
1606
1607 Ideally we'd find some way of making SVs at (C) compile time, or
1608 at least, doing most of the work. */
1609 if (!PL_psig_name[i]) {
1610 PL_psig_name[i] = newSVpvn(s, len);
1611 SvREADONLY_on(PL_psig_name[i]);
1612 }
38a124f0 1613 } else {
79fd3822 1614 SvREFCNT_dec(PL_psig_name[i]);
38a124f0
NC
1615 PL_psig_name[i] = NULL;
1616 PL_psig_ptr[i] = NULL;
1617 }
748a9306 1618 }
38a124f0 1619 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
2d4fcd5e 1620 if (i) {
5c1546dc 1621 (void)rsignal(i, PL_csighandlerp);
2d4fcd5e 1622 }
748a9306 1623 else
b37c2d43 1624 *svp = SvREFCNT_inc_simple_NN(sv);
38a124f0 1625 } else {
9dfa190b
NC
1626 if (sv && SvOK(sv)) {
1627 s = SvPV_force(sv, len);
1628 } else {
1629 sv = NULL;
1630 }
84c7b88c 1631 if (sv && memEQs(s, len,"IGNORE")) {
9dfa190b 1632 if (i) {
23ada85b 1633#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
9dfa190b
NC
1634 PL_sig_ignoring[i] = 1;
1635 (void)rsignal(i, PL_csighandlerp);
85b332e2 1636#else
9dfa190b 1637 (void)rsignal(i, (Sighandler_t) SIG_IGN);
85b332e2 1638#endif
9dfa190b 1639 }
2d4fcd5e 1640 }
84c7b88c 1641 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
9dfa190b 1642 if (i) {
2e34cc90 1643#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
9dfa190b
NC
1644 PL_sig_defaulting[i] = 1;
1645 (void)rsignal(i, PL_csighandlerp);
2e34cc90 1646#else
9dfa190b 1647 (void)rsignal(i, (Sighandler_t) SIG_DFL);
2e34cc90 1648#endif
9dfa190b
NC
1649 }
1650 }
1651 else {
1652 /*
1653 * We should warn if HINT_STRICT_REFS, but without
1654 * access to a known hint bit in a known OP, we can't
1655 * tell whether HINT_STRICT_REFS is in force or not.
1656 */
1657 if (!strchr(s,':') && !strchr(s,'\''))
1658 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1659 SV_GMAGIC);
1660 if (i)
1661 (void)rsignal(i, PL_csighandlerp);
1662 else
1663 *svp = SvREFCNT_inc_simple_NN(sv);
136e0459 1664 }
748a9306 1665 }
9dfa190b 1666
2d4fcd5e
AJ
1667#ifdef HAS_SIGPROCMASK
1668 if(i)
1669 LEAVE;
1670#endif
ef8d46e8 1671 SvREFCNT_dec(to_dec);
79072805
LW
1672 return 0;
1673}
64ca3a65 1674#endif /* !PERL_MICRO */
79072805
LW
1675
1676int
864dbfa3 1677Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
79072805 1678{
7918f24d 1679 PERL_ARGS_ASSERT_MAGIC_SETISA;
8772537c 1680 PERL_UNUSED_ARG(sv);
e1a479c5 1681
89c14e2e 1682 /* Skip _isaelem because _isa will handle it shortly */
354b0578 1683 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
89c14e2e
BB
1684 return 0;
1685
0e446081 1686 return magic_clearisa(NULL, mg);
463ee0b2
LW
1687}
1688
0e446081 1689/* sv of NULL signifies that we're acting as magic_setisa. */
463ee0b2 1690int
52b45067
RD
1691Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1692{
52b45067 1693 HV* stash;
7918f24d
NC
1694 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1695
52b45067 1696 /* Bail out if destruction is going on */
627364f1 1697 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
52b45067 1698
0e446081
NC
1699 if (sv)
1700 av_clear(MUTABLE_AV(sv));
52b45067 1701
6624142a
FC
1702 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1703 /* This occurs with setisa_elem magic, which calls this
1704 same function. */
1705 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1706
316ebaf2 1707 assert(mg);
6624142a
FC
1708 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1709 SV **svp = AvARRAY((AV *)mg->mg_obj);
1710 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1711 while (items--) {
1712 stash = GvSTASH((GV *)*svp++);
1713 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1714 }
1715
1716 return 0;
1717 }
1718
52b45067 1719 stash = GvSTASH(
6624142a 1720 (const GV *)mg->mg_obj
52b45067
RD
1721 );
1722
00169e2c
FC
1723 /* The stash may have been detached from the symbol table, so check its
1724 name before doing anything. */
1725 if (stash && HvENAME_get(stash))
5562fa71 1726 mro_isa_changed_in(stash);
52b45067
RD
1727
1728 return 0;
1729}
1730
1731int
864dbfa3 1732Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
6ff81951 1733{
85fbaab2 1734 HV * const hv = MUTABLE_HV(LvTARG(sv));
6ff81951 1735 I32 i = 0;
7918f24d
NC
1736
1737 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
8772537c 1738 PERL_UNUSED_ARG(mg);
7719e241 1739
6ff81951 1740 if (hv) {
497b47a8 1741 (void) hv_iterinit(hv);
ad64d0ec 1742 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1b95d04f 1743 i = HvUSEDKEYS(hv);
497b47a8
JH
1744 else {
1745 while (hv_iternext(hv))
1746 i++;
1747 }
6ff81951
GS
1748 }
1749
1750 sv_setiv(sv, (IV)i);
1751 return 0;
1752}
1753
1754int
864dbfa3 1755Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
946ec16e 1756{
7918f24d 1757 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
8772537c 1758 PERL_UNUSED_ARG(mg);
946ec16e 1759 if (LvTARG(sv)) {
85fbaab2 1760 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
946ec16e 1761 }
1762 return 0;
ac27b0f5 1763}
946ec16e 1764
efaf3674
DM
1765/*
1766=for apidoc magic_methcall
1767
1768Invoke a magic method (like FETCH).
1769
2baee27b
FC
1770C<sv> and C<mg> are the tied thingy and the tie magic.
1771
1772C<meth> is the name of the method to call.
1773
1774C<argc> is the number of args (in addition to $self) to pass to the method.
1775
1776The C<flags> can be:
1777
1778 G_DISCARD invoke method with G_DISCARD flag and don't
1779 return a value
1780 G_UNDEF_FILL fill the stack with argc pointers to
1781 PL_sv_undef
1782
1783The arguments themselves are any values following the C<flags> argument.
efaf3674
DM
1784
1785Returns the SV (if any) returned by the method, or NULL on failure.
1786
1787
1788=cut
1789*/
1790
1791SV*
36925d9e 1792Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
046b0c7d 1793 U32 argc, ...)
a0d0e21e
LW
1794{
1795 dSP;
efaf3674 1796 SV* ret = NULL;
463ee0b2 1797
7918f24d
NC
1798 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1799
efaf3674 1800 ENTER;
d1d7a15d
NC
1801
1802 if (flags & G_WRITING_TO_STDERR) {
1803 SAVETMPS;
1804
2782061f 1805 save_re_context();
d1d7a15d
NC
1806 SAVESPTR(PL_stderrgv);
1807 PL_stderrgv = NULL;
1808 }
1809
efaf3674 1810 PUSHSTACKi(PERLSI_MAGIC);
924508f0 1811 PUSHMARK(SP);
efaf3674 1812
67549bd2
NC
1813 EXTEND(SP, argc+1);
1814 PUSHs(SvTIED_obj(sv, mg));
1815 if (flags & G_UNDEF_FILL) {
1816 while (argc--) {
efaf3674 1817 PUSHs(&PL_sv_undef);
93965878 1818 }
67549bd2 1819 } else if (argc > 0) {
046b0c7d
NC
1820 va_list args;
1821 va_start(args, argc);
1822
1823 do {
1824 SV *const sv = va_arg(args, SV *);
1825 PUSHs(sv);
1826 } while (--argc);
1827
1828 va_end(args);
88e89b8a 1829 }
463ee0b2 1830 PUTBACK;
efaf3674 1831 if (flags & G_DISCARD) {
36925d9e 1832 call_sv(meth, G_SCALAR|G_DISCARD|G_METHOD_NAMED);
efaf3674
DM
1833 }
1834 else {
36925d9e 1835 if (call_sv(meth, G_SCALAR|G_METHOD_NAMED))
efaf3674
DM
1836 ret = *PL_stack_sp--;
1837 }
1838 POPSTACK;
d1d7a15d
NC
1839 if (flags & G_WRITING_TO_STDERR)
1840 FREETMPS;
efaf3674
DM
1841 LEAVE;
1842 return ret;
1843}
1844
efaf3674 1845/* wrapper for magic_methcall that creates the first arg */
463ee0b2 1846
efaf3674 1847STATIC SV*
36925d9e 1848S_magic_methcall1(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
efaf3674
DM
1849 int n, SV *val)
1850{
efaf3674
DM
1851 SV* arg1 = NULL;
1852
1853 PERL_ARGS_ASSERT_MAGIC_METHCALL1;
1854
1855 if (mg->mg_ptr) {
1856 if (mg->mg_len >= 0) {
db4b3a1d 1857 arg1 = newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
efaf3674
DM
1858 }
1859 else if (mg->mg_len == HEf_SVKEY)
1860 arg1 = MUTABLE_SV(mg->mg_ptr);
1861 }
1862 else if (mg->mg_type == PERL_MAGIC_tiedelem) {
db4b3a1d 1863 arg1 = newSViv((IV)(mg->mg_len));
efaf3674
DM
1864 sv_2mortal(arg1);
1865 }
1866 if (!arg1) {
046b0c7d 1867 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n - 1, val);
efaf3674 1868 }
046b0c7d 1869 return Perl_magic_methcall(aTHX_ sv, mg, meth, flags, n, arg1, val);
946ec16e 1870}
1871
76e3520e 1872STATIC int
36925d9e 1873S_magic_methpack(pTHX_ SV *sv, const MAGIC *mg, SV *meth)
a0d0e21e 1874{
efaf3674 1875 SV* ret;
463ee0b2 1876
7918f24d
NC
1877 PERL_ARGS_ASSERT_MAGIC_METHPACK;
1878
efaf3674
DM
1879 ret = magic_methcall1(sv, mg, meth, 0, 1, NULL);
1880 if (ret)
1881 sv_setsv(sv, ret);
a0d0e21e
LW
1882 return 0;
1883}
463ee0b2 1884
a0d0e21e 1885int
864dbfa3 1886Perl_magic_getpack(pTHX_ SV *sv, MAGIC *mg)
a0d0e21e 1887{
7918f24d
NC
1888 PERL_ARGS_ASSERT_MAGIC_GETPACK;
1889
fd69380d 1890 if (mg->mg_type == PERL_MAGIC_tiedelem)
a0d0e21e 1891 mg->mg_flags |= MGf_GSKIP;
36925d9e 1892 magic_methpack(sv,mg,SV_CONST(FETCH));
463ee0b2
LW
1893 return 0;
1894}
1895
1896int
864dbfa3 1897Perl_magic_setpack(pTHX_ SV *sv, MAGIC *mg)
e336de0d 1898{
b112cff9
DM
1899 MAGIC *tmg;
1900 SV *val;
7918f24d
NC
1901
1902 PERL_ARGS_ASSERT_MAGIC_SETPACK;
1903
b112cff9
DM
1904 /* in the code C<$tied{foo} = $val>, the "thing" that gets passed to
1905 * STORE() is not $val, but rather a PVLV (the sv in this call), whose
1906 * public flags indicate its value based on copying from $val. Doing
1907 * mg_set() on the PVLV temporarily does SvMAGICAL_off(), then calls us.
1908 * So STORE()'s $_[2] arg is a temporarily disarmed PVLV. This goes
1909 * wrong if $val happened to be tainted, as sv hasn't got magic
1910 * enabled, even though taint magic is in the chain. In which case,
1911 * fake up a temporary tainted value (this is easier than temporarily
1912 * re-enabling magic on sv). */
1913
284167a5 1914 if (TAINTING_get && (tmg = mg_find(sv, PERL_MAGIC_taint))
b112cff9
DM
1915 && (tmg->mg_len & 1))
1916 {
1917 val = sv_mortalcopy(sv);
1918 SvTAINTED_on(val);
1919 }
1920 else
1921 val = sv;
1922
36925d9e 1923 magic_methcall1(sv, mg, SV_CONST(STORE), G_DISCARD, 2, val);
463ee0b2
LW
1924 return 0;
1925}
1926
1927int
864dbfa3 1928Perl_magic_clearpack(pTHX_ SV *sv, MAGIC *mg)
463ee0b2 1929{
7918f24d
NC
1930 PERL_ARGS_ASSERT_MAGIC_CLEARPACK;
1931
4c13be3f 1932 if (mg->mg_type == PERL_MAGIC_tiedscalar) return 0;
36925d9e 1933 return magic_methpack(sv,mg,SV_CONST(DELETE));
a0d0e21e 1934}
463ee0b2 1935
93965878
NIS
1936
1937U32
864dbfa3 1938Perl_magic_sizepack(pTHX_ SV *sv, MAGIC *mg)
ac27b0f5 1939{
22846ab4 1940 I32 retval = 0;
efaf3674 1941 SV* retsv;
93965878 1942
7918f24d
NC
1943 PERL_ARGS_ASSERT_MAGIC_SIZEPACK;
1944
36925d9e 1945 retsv = magic_methcall1(sv, mg, SV_CONST(FETCHSIZE), 0, 1, NULL);
efaf3674
DM
1946 if (retsv) {
1947 retval = SvIV(retsv)-1;
22846ab4
AB
1948 if (retval < -1)
1949 Perl_croak(aTHX_ "FETCHSIZE returned a negative value");
93965878 1950 }
22846ab4 1951 return (U32) retval;
93965878
NIS
1952}
1953
cea2e8a9
GS
1954int
1955Perl_magic_wipepack(pTHX_ SV *sv, MAGIC *mg)
a0d0e21e 1956{
7918f24d
NC
1957 PERL_ARGS_ASSERT_MAGIC_WIPEPACK;
1958
36925d9e 1959 Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(CLEAR), G_DISCARD, 0);
463ee0b2
LW
1960 return 0;
1961}
1962
1963int
864dbfa3 1964Perl_magic_nextpack(pTHX_ SV *sv, MAGIC *mg, SV *key)
463ee0b2 1965{
efaf3674 1966 SV* ret;
463ee0b2 1967
7918f24d
NC
1968 PERL_ARGS_ASSERT_MAGIC_NEXTPACK;
1969
36925d9e
RZ
1970 ret = SvOK(key) ? Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(NEXTKEY), 0, 1, key)
1971 : Perl_magic_methcall(aTHX_ sv, mg, SV_CONST(FIRSTKEY), 0, 0);
efaf3674
DM
1972 if (ret)
1973 sv_setsv(key,ret);
79072805
LW
1974 return 0;
1975}
1976
1977int
1146e912 1978Perl_magic_existspack(pTHX_ SV *sv, const MAGIC *mg)
a0d0e21e 1979{
7918f24d
NC
1980 PERL_ARGS_ASSERT_MAGIC_EXISTSPACK;
1981
36925d9e 1982 return magic_methpack(sv,mg,SV_CONST(EXISTS));
ac27b0f5 1983}
a0d0e21e 1984
a3bcc51e
TP
1985SV *
1986Perl_magic_scalarpack(pTHX_ HV *hv, MAGIC *mg)
1987{
5fcbf73d 1988 SV *retval;
ad64d0ec
NC
1989 SV * const tied = SvTIED_obj(MUTABLE_SV(hv), mg);
1990 HV * const pkg = SvSTASH((const SV *)SvRV(tied));
a3bcc51e 1991
7918f24d
NC
1992 PERL_ARGS_ASSERT_MAGIC_SCALARPACK;
1993
a3bcc51e
TP
1994 if (!gv_fetchmethod_autoload(pkg, "SCALAR", FALSE)) {
1995 SV *key;
bfcb3514 1996 if (HvEITER_get(hv))
a3bcc51e
TP
1997 /* we are in an iteration so the hash cannot be empty */
1998 return &PL_sv_yes;
1999 /* no xhv_eiter so now use FIRSTKEY */
2000 key = sv_newmortal();
ad64d0ec 2001 magic_nextpack(MUTABLE_SV(hv), mg, key);
bfcb3514 2002 HvEITER_set(hv, NULL); /* need to reset iterator */
a3bcc51e
TP
2003 return SvOK(key) ? &PL_sv_yes : &PL_sv_no;
2004 }
2005
2006 /* there is a SCALAR method that we can call */
36925d9e 2007 retval = Perl_magic_methcall(aTHX_ MUTABLE_SV(hv), mg, SV_CONST(SCALAR), 0, 0);
efaf3674 2008 if (!retval)
5fcbf73d 2009 retval = &PL_sv_undef;
a3bcc51e
TP
2010 return retval;
2011}
2012
a0d0e21e 2013int
864dbfa3 2014Perl_magic_setdbline(pTHX_ SV *sv, MAGIC *mg)
79072805 2015{
089b5c60 2016 SV **svp;
7918f24d
NC
2017
2018 PERL_ARGS_ASSERT_MAGIC_SETDBLINE;
2019
089b5c60
NC
2020 /* The magic ptr/len for the debugger's hash should always be an SV. */
2021 if (UNLIKELY(mg->mg_len != HEf_SVKEY)) {
2022 Perl_croak(aTHX_ "panic: magic_setdbline len=%"IVdf", ptr='%s'",
7b0eb0b8 2023 (IV)mg->mg_len, mg->mg_ptr);
089b5c60
NC
2024 }
2025
2026 /* Use sv_2iv instead of SvIV() as the former generates smaller code, and
2027 setting/clearing debugger breakpoints is not a hot path. */
43e4250a
FC
2028 svp = av_fetch(MUTABLE_AV(mg->mg_obj),
2029 sv_2iv(MUTABLE_SV((mg)->mg_ptr)), FALSE);
089b5c60 2030
8772537c 2031 if (svp && SvIOKp(*svp)) {
88df5f01
FC
2032 OP * const o = INT2PTR(OP*,SvIVX(*svp));
2033 if (o) {
2034#ifdef PERL_DEBUG_READONLY_OPS
2035 Slab_to_rw(OpSLAB(o));
2036#endif
2037 /* set or clear breakpoint in the relevant control op */
089b5c60 2038 if (SvTRUE(sv))
88df5f01 2039 o->op_flags |= OPf_SPECIAL;
8772537c 2040 else
88df5f01
FC
2041 o->op_flags &= ~OPf_SPECIAL;
2042#ifdef PERL_DEBUG_READONLY_OPS
2043 Slab_to_ro(OpSLAB(o));
2044#endif
8772537c 2045 }
5df8de69 2046 }
79072805
LW
2047 return 0;
2048}
2049
2050int
8772537c 2051Perl_magic_getarylen(pTHX_ SV *sv, const MAGIC *mg)
79072805 2052{
502c6561 2053 AV * const obj = MUTABLE_AV(mg->mg_obj);
7918f24d
NC
2054
2055 PERL_ARGS_ASSERT_MAGIC_GETARYLEN;
2056
83bf042f 2057 if (obj) {
e1dccc0d 2058 sv_setiv(sv, AvFILL(obj));
83bf042f 2059 } else {
d4a823b3 2060 sv_setsv(sv, NULL);
83bf042f 2061 }
79072805
LW
2062 return 0;
2063}
2064
2065int
864dbfa3 2066Perl_magic_setarylen(pTHX_ SV *sv, MAGIC *mg)
79072805 2067{
502c6561 2068 AV * const obj = MUTABLE_AV(mg->mg_obj);
7918f24d
NC
2069
2070 PERL_ARGS_ASSERT_MAGIC_SETARYLEN;
2071
83bf042f 2072 if (obj) {
e1dccc0d 2073 av_fill(obj, SvIV(sv));
83bf042f 2074 } else {
a2a5de95
NC
2075 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
2076 "Attempt to set length of freed array");
83bf042f
NC
2077 }
2078 return 0;
2079}
2080
2081int
83f29afa
VP
2082Perl_magic_cleararylen_p(pTHX_ SV *sv, MAGIC *mg)
2083{
83f29afa
VP
2084 PERL_ARGS_ASSERT_MAGIC_CLEARARYLEN_P;
2085 PERL_UNUSED_ARG(sv);
dc3bf405 2086 PERL_UNUSED_CONTEXT;
83f29afa
VP
2087
2088 /* Reset the iterator when the array is cleared */
3565fbf3
VP
2089#if IVSIZE == I32SIZE
2090 *((IV *) &(mg->mg_len)) = 0;
2091#else
83f29afa
VP
2092 if (mg->mg_ptr)
2093 *((IV *) mg->mg_ptr) = 0;
3565fbf3 2094#endif
83f29afa
VP
2095
2096 return 0;
2097}
2098
2099int
83bf042f
NC
2100Perl_magic_freearylen_p(pTHX_ SV *sv, MAGIC *mg)
2101{
7918f24d 2102 PERL_ARGS_ASSERT_MAGIC_FREEARYLEN_P;
53c1dcc0 2103 PERL_UNUSED_ARG(sv);
7918f24d 2104
94f3782b
DM
2105 /* during global destruction, mg_obj may already have been freed */
2106 if (PL_in_clean_all)
1ea47f64 2107 return 0;
94f3782b 2108
83bf042f
NC
2109 mg = mg_find (mg->mg_obj, PERL_MAGIC_arylen);
2110
2111 if (mg) {
2112 /* arylen scalar holds a pointer back to the array, but doesn't own a
2113 reference. Hence the we (the array) are about to go away with it
2114 still pointing at us. Clear its pointer, else it would be pointing
2115 at free memory. See the comment in sv_magic about reference loops,
2116 and why it can't own a reference to us. */
2117 mg->mg_obj = 0;
2118 }
a0d0e21e
LW
2119 return 0;
2120}
2121
2122int
864dbfa3 2123Perl_magic_getpos(pTHX_ SV *sv, MAGIC *mg)
a0d0e21e 2124{
16eb5365 2125 SV* const lsv = LvTARG(sv);
96c2a8ff 2126 MAGIC * const found = mg_find_mglob(lsv);
7918f24d
NC
2127
2128 PERL_ARGS_ASSERT_MAGIC_GETPOS;
16eb5365 2129 PERL_UNUSED_ARG(mg);
ac27b0f5 2130
6174b39a
FC
2131 if (found && found->mg_len != -1) {
2132 STRLEN i = found->mg_len;
25fdce4a 2133 if (found->mg_flags & MGf_BYTES && DO_UTF8(lsv))
6174b39a
FC
2134 i = sv_pos_b2u_flags(lsv, i, SV_GMAGIC|SV_CONST_RETURN);
2135 sv_setuv(sv, i);
a0d0e21e 2136 return 0;
a0d0e21e 2137 }
35995e5c 2138 sv_setsv(sv,NULL);
a0d0e21e
LW
2139 return 0;
2140}
2141
2142int
864dbfa3 2143Perl_magic_setpos(pTHX_ SV *sv, MAGIC *mg)
a0d0e21e 2144{
16eb5365 2145 SV* const lsv = LvTARG(sv);
a0d0e21e
LW
2146 SSize_t pos;
2147 STRLEN len;
c00206c8 2148 STRLEN ulen = 0;
53d44271 2149 MAGIC* found;
aec43834 2150 const char *s;
a0d0e21e 2151
7918f24d 2152 PERL_ARGS_ASSERT_MAGIC_SETPOS;
16eb5365 2153 PERL_UNUSED_ARG(mg);
ac27b0f5 2154
96c2a8ff 2155 found = mg_find_mglob(lsv);
3881461a 2156 if (!found) {
a0d0e21e
LW
2157 if (!SvOK(sv))
2158 return 0;
96c2a8ff 2159 found = sv_magicext_mglob(lsv);
a0d0e21e
LW
2160 }
2161 else if (!SvOK(sv)) {
3881461a 2162 found->mg_len = -1;
a0d0e21e
LW
2163 return 0;
2164 }
aec43834 2165 s = SvPV_const(lsv, len);
a0d0e21e 2166
e1dccc0d 2167 pos = SvIV(sv);
a0ed51b3 2168
7e2040f0 2169 if (DO_UTF8(lsv)) {
aec43834 2170 ulen = sv_or_pv_len_utf8(lsv, s, len);
a0ed51b3
LW
2171 if (ulen)
2172 len = ulen;
a0ed51b3
LW
2173 }
2174
a0d0e21e
LW
2175 if (pos < 0) {
2176 pos += len;
2177 if (pos < 0)
2178 pos = 0;
2179 }
eb160463 2180 else if (pos > (SSize_t)len)
a0d0e21e 2181 pos = len;
a0ed51b3 2182
3881461a 2183 found->mg_len = pos;
25fdce4a 2184 found->mg_flags &= ~(MGf_MINMATCH|MGf_BYTES);
a0d0e21e 2185
79072805
LW
2186 return 0;
2187}
2188
2189int
864dbfa3 2190Perl_magic_getsubstr(pTHX_ SV *sv, MAGIC *mg)
6ff81951
GS
2191{
2192 STRLEN len;
35a4481c 2193 SV * const lsv = LvTARG(sv);
b83604b4 2194 const char * const tmps = SvPV_const(lsv,len);
777f7c56
EB
2195 STRLEN offs = LvTARGOFF(sv);
2196 STRLEN rem = LvTARGLEN(sv);
83f78d1a
FC
2197 const bool negoff = LvFLAGS(sv) & 1;
2198 const bool negrem = LvFLAGS(sv) & 2;
7918f24d
NC
2199
2200 PERL_ARGS_ASSERT_MAGIC_GETSUBSTR;
8772537c 2201 PERL_UNUSED_ARG(mg);
6ff81951 2202
83f78d1a 2203 if (!translate_substr_offsets(
4ddea69a 2204 SvUTF8(lsv) ? sv_or_pv_len_utf8(lsv, tmps, len) : len,
83f78d1a
FC
2205 negoff ? -(IV)offs : (IV)offs, !negoff,
2206 negrem ? -(IV)rem : (IV)rem, !negrem, &offs, &rem
2207 )) {
2208 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR), "substr outside of string");
2209 sv_setsv_nomg(sv, &PL_sv_undef);
2210 return 0;
2211 }
2212
9aa983d2 2213 if (SvUTF8(lsv))
4ddea69a 2214 offs = sv_or_pv_pos_u2b(lsv, tmps, offs, &rem);
1c900557 2215 sv_setpvn(sv, tmps + offs, rem);
9aa983d2 2216 if (SvUTF8(lsv))
2ef4b674 2217 SvUTF8_on(sv);
6ff81951
GS
2218 return 0;
2219}
2220
2221int
864dbfa3 2222Perl_magic_setsubstr(pTHX_ SV *sv, MAGIC *mg)
79072805 2223{
83f78d1a 2224 STRLEN len, lsv_len, oldtarglen, newtarglen;
5fcbf73d 2225 const char * const tmps = SvPV_const(sv, len);
dd374669 2226 SV * const lsv = LvTARG(sv);
777f7c56
EB
2227 STRLEN lvoff = LvTARGOFF(sv);
2228 STRLEN lvlen = LvTARGLEN(sv);
83f78d1a
FC
2229 const bool negoff = LvFLAGS(sv) & 1;
2230 const bool neglen = LvFLAGS(sv) & 2;
7918f24d
NC
2231
2232 PERL_ARGS_ASSERT_MAGIC_SETSUBSTR;
8772537c 2233 PERL_UNUSED_ARG(mg);
075a4a2b 2234
a74fb2cd
FC
2235 SvGETMAGIC(lsv);
2236 if (SvROK(lsv))
2237 Perl_ck_warner(aTHX_ packWARN(WARN_SUBSTR),
2238 "Attempt to use reference as lvalue in substr"
2239 );
fc061ed8
FC
2240 SvPV_force_nomg(lsv,lsv_len);
2241 if (SvUTF8(lsv)) lsv_len = sv_len_utf8_nomg(lsv);
83f78d1a
FC
2242 if (!translate_substr_offsets(
2243 lsv_len,
2244 negoff ? -(IV)lvoff : (IV)lvoff, !negoff,
2245 neglen ? -(IV)lvlen : (IV)lvlen, !neglen, &lvoff, &lvlen
2246 ))
2247 Perl_croak(aTHX_ "substr outside of string");
2248 oldtarglen = lvlen;
1aa99e6b 2249 if (DO_UTF8(sv)) {
73a087f0 2250 sv_utf8_upgrade_nomg(lsv);
d931b1be 2251 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
a74fb2cd 2252 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
7a385470 2253 newtarglen = sv_or_pv_len_utf8(sv, tmps, len);
9aa983d2
JH
2254 SvUTF8_on(lsv);
2255 }
0d336106 2256 else if (SvUTF8(lsv)) {
5fcbf73d 2257 const char *utf8;
d931b1be 2258 lvoff = sv_pos_u2b_flags(lsv, lvoff, &lvlen, SV_CONST_RETURN);
83f78d1a 2259 newtarglen = len;
5fcbf73d 2260 utf8 = (char*)bytes_to_utf8((U8*)tmps, &len);
a74fb2cd 2261 sv_insert_flags(lsv, lvoff, lvlen, utf8, len, 0);
5fcbf73d 2262 Safefree(utf8);
1aa99e6b 2263 }
b76f3ce2 2264 else {
a74fb2cd 2265 sv_insert_flags(lsv, lvoff, lvlen, tmps, len, 0);
83f78d1a 2266 newtarglen = len;
b76f3ce2 2267 }
83f78d1a
FC
2268 if (!neglen) LvTARGLEN(sv) = newtarglen;
2269 if (negoff) LvTARGOFF(sv) += newtarglen - oldtarglen;
b76f3ce2 2270
79072805
LW
2271 return 0;
2272}
2273
2274int
864dbfa3 2275Perl_magic_gettaint(pTHX_ SV *sv, MAGIC *mg)
463ee0b2 2276{
7918f24d 2277 PERL_ARGS_ASSERT_MAGIC_GETTAINT;
8772537c 2278 PERL_UNUSED_ARG(sv);
9a9b5ec9
DM
2279#ifdef NO_TAINT_SUPPORT
2280 PERL_UNUSED_ARG(mg);
2281#endif
7918f24d 2282
64ff300b 2283 TAINT_IF((PL_localizing != 1) && (mg->mg_len & 1) && IN_PERL_RUNTIME);
463ee0b2
LW
2284 return 0;
2285}
2286
2287int
864dbfa3 2288Perl_magic_settaint(pTHX_ SV *sv, MAGIC *mg)
463ee0b2 2289{
7918f24d 2290 PERL_ARGS_ASSERT_MAGIC_SETTAINT;
8772537c 2291 PERL_UNUSED_ARG(sv);
7918f24d 2292
b01e650a 2293 /* update taint status */
284167a5 2294 if (TAINT_get)
b01e650a
DM
2295 mg->mg_len |= 1;
2296 else
2297 mg->mg_len &= ~1;
463ee0b2
LW
2298 return 0;
2299}
2300
2301int
864dbfa3 2302Perl_magic_getvec(pTHX_ SV *sv, MAGIC *mg)
6ff81951 2303{
35a4481c 2304 SV * const lsv = LvTARG(sv);
7918f24d
NC
2305
2306 PERL_ARGS_ASSERT_MAGIC_GETVEC;
8772537c 2307 PERL_UNUSED_ARG(mg);
6ff81951 2308
2e9e14dd 2309 sv_setuv(sv, do_vecget(lsv, LvTARGOFF(sv), LvTARGLEN(sv)));
6ff81951 2310
6ff81951
GS
2311 return 0;
2312}
2313
2314int
864dbfa3 2315Perl_magic_setvec(pTHX_ SV *sv, MAGIC *mg)
79072805 2316{
7918f24d 2317 PERL_ARGS_ASSERT_MAGIC_SETVEC;
8772537c 2318 PERL_UNUSED_ARG(mg);
79072805
LW
2319 do_vecset(sv); /* XXX slurp this routine */
2320 return 0;
2321}
2322
13733cde
FC
2323SV *
2324Perl_defelem_target(pTHX_ SV *sv, MAGIC *mg)
5f05dabc 2325{
a0714e2c 2326 SV *targ = NULL;
13733cde
FC
2327 PERL_ARGS_ASSERT_DEFELEM_TARGET;
2328 if (!mg) mg = mg_find(sv, PERL_MAGIC_defelem);
2329 assert(mg);
5f05dabc 2330 if (LvTARGLEN(sv)) {
68dc0745 2331 if (mg->mg_obj) {
8772537c 2332 SV * const ahv = LvTARG(sv);
85fbaab2 2333 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, FALSE, 0);
6d822dc4
MS
2334 if (he)
2335 targ = HeVAL(he);
68dc0745 2336 }
bbfdc870 2337 else if (LvSTARGOFF(sv) >= 0) {
502c6561 2338 AV *const av = MUTABLE_AV(LvTARG(sv));
bbfdc870 2339 if (LvSTARGOFF(sv) <= AvFILL(av))
ca58dfd9
FC
2340 {
2341 if (SvRMAGICAL(av)) {
2342 SV * const * const svp = av_fetch(av, LvSTARGOFF(sv), 0);
2343 targ = svp ? *svp : NULL;
2344 }
2345 else
bbfdc870 2346 targ = AvARRAY(av)[LvSTARGOFF(sv)];
ca58dfd9 2347 }
68dc0745 2348 }
46da273f 2349 if (targ && (targ != &PL_sv_undef)) {
68dc0745 2350 /* somebody else defined it for us */
2351 SvREFCNT_dec(LvTARG(sv));
b37c2d43 2352 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
68dc0745 2353 LvTARGLEN(sv) = 0;
2354 SvREFCNT_dec(mg->mg_obj);
a0714e2c 2355 mg->mg_obj = NULL;
68dc0745 2356 mg->mg_flags &= ~MGf_REFCOUNTED;
2357 }
13733cde 2358 return targ;
5f05dabc 2359 }
71be2cbc 2360 else
13733cde
FC
2361 return LvTARG(sv);
2362}
2363
2364int
2365Perl_magic_getdefelem(pTHX_ SV *sv, MAGIC *mg)
2366{
2367 PERL_ARGS_ASSERT_MAGIC_GETDEFELEM;
2368
2369 sv_setsv(sv, defelem_target(sv, mg));
71be2cbc 2370 return 0;
2371}
2372
2373int
864dbfa3 2374Perl_magic_setdefelem(pTHX_ SV *sv, MAGIC *mg)
71be2cbc 2375{
7918f24d 2376 PERL_ARGS_ASSERT_MAGIC_SETDEFELEM;
8772537c 2377 PERL_UNUSED_ARG(mg);
71be2cbc 2378 if (LvTARGLEN(sv))
68dc0745 2379 vivify_defelem(sv);
2380 if (LvTARG(sv)) {
5f05dabc 2381 sv_setsv(LvTARG(sv), sv);
68dc0745 2382 SvSETMAGIC(LvTARG(sv));
2383 }
5f05dabc 2384 return 0;
2385}
2386
71be2cbc 2387void
864dbfa3 2388Perl_vivify_defelem(pTHX_ SV *sv)
71be2cbc 2389{
74e13ce4 2390 MAGIC *mg;
a0714e2c 2391 SV *value = NULL;
71be2cbc 2392
7918f24d
NC
2393 PERL_ARGS_ASSERT_VIVIFY_DEFELEM;
2394
14befaf4 2395 if (!LvTARGLEN(sv) || !(mg = mg_find(sv, PERL_MAGIC_defelem)))
71be2cbc 2396 return;
68dc0745 2397 if (mg->mg_obj) {
8772537c 2398 SV * const ahv = LvTARG(sv);
85fbaab2 2399 HE * const he = hv_fetch_ent(MUTABLE_HV(ahv), mg->mg_obj, TRUE, 0);
6d822dc4
MS
2400 if (he)
2401 value = HeVAL(he);
3280af22 2402 if (!value || value == &PL_sv_undef)
be2597df 2403 Perl_croak(aTHX_ PL_no_helem_sv, SVfARG(mg->mg_obj));
71be2cbc 2404 }
bbfdc870
FC
2405 else if (LvSTARGOFF(sv) < 0)
2406 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
68dc0745 2407 else {
502c6561 2408 AV *const av = MUTABLE_AV(LvTARG(sv));
bbfdc870 2409 if ((I32)LvTARGLEN(sv) < 0 && LvSTARGOFF(sv) > AvFILL(av))
a0714e2c 2410 LvTARG(sv) = NULL; /* array can't be extended */
68dc0745 2411 else {
bbfdc870 2412 SV* const * const svp = av_fetch(av, LvSTARGOFF(sv), TRUE);
031c6d82 2413 if (!svp || !(value = *svp))
bbfdc870 2414 Perl_croak(aTHX_ PL_no_aelem, LvSTARGOFF(sv));
68dc0745 2415 }
2416 }
b37c2d43 2417 SvREFCNT_inc_simple_void(value);
68dc0745 2418 SvREFCNT_dec(LvTARG(sv));
2419 LvTARG(sv) = value;
71be2cbc 2420 LvTARGLEN(sv) = 0;
68dc0745 2421 SvREFCNT_dec(mg->mg_obj);
a0714e2c 2422 mg->mg_obj = NULL;
68dc0745 2423 mg->mg_flags &= ~MGf_REFCOUNTED;
5f05dabc 2424}
2425
2426int
864dbfa3 2427Perl_magic_killbackrefs(pTHX_ SV *sv, MAGIC *mg)
810b8aa5 2428{
7918f24d 2429 PERL_ARGS_ASSERT_MAGIC_KILLBACKREFS;
5648c0ae
DM
2430 Perl_sv_kill_backrefs(aTHX_ sv, MUTABLE_AV(mg->mg_obj));
2431 return 0;
810b8aa5
GS
2432}
2433
2434int
864dbfa3 2435Perl_magic_setmglob(pTHX_ SV *sv, MAGIC *mg)
93a17b20 2436{
7918f24d 2437 PERL_ARGS_ASSERT_MAGIC_SETMGLOB;
96a5add6 2438 PERL_UNUSED_CONTEXT;
0177730e 2439 PERL_UNUSED_ARG(sv);
565764a8 2440 mg->mg_len = -1;
93a17b20
LW
2441 return 0;
2442}
2443
2444int
864dbfa3 2445Perl_magic_setuvar(pTHX_ SV *sv, MAGIC *mg)
79072805 2446{
35a4481c 2447 const struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
79072805 2448
7918f24d
NC
2449 PERL_ARGS_ASSERT_MAGIC_SETUVAR;
2450
79072805 2451 if (uf && uf->uf_set)
24f81a43 2452 (*uf->uf_set)(aTHX_ uf->uf_index, sv);
79072805
LW
2453 return 0;
2454}
2455
c277df42 2456int
faf82a0b
AE
2457Perl_magic_setregexp(pTHX_ SV *sv, MAGIC *mg)
2458{
488344d2 2459 const char type = mg->mg_type;
7918f24d
NC
2460
2461 PERL_ARGS_ASSERT_MAGIC_SETREGEXP;
2462
488344d2
NC
2463 if (type == PERL_MAGIC_qr) {
2464 } else if (type == PERL_MAGIC_bm) {
2465 SvTAIL_off(sv);
2466 SvVALID_off(sv);
2467 } else {
2468 assert(type == PERL_MAGIC_fm);
488344d2
NC
2469 }
2470 return sv_unmagic(sv, type);
faf82a0b
AE
2471}
2472
7a4c00b4 2473#ifdef USE_LOCALE_COLLATE
79072805 2474int
864dbfa3 2475Perl_magic_setcollxfrm(pTHX_ SV *sv, MAGIC *mg)
bbce6d69 2476{
7918f24d
NC
2477 PERL_ARGS_ASSERT_MAGIC_SETCOLLXFRM;
2478
bbce6d69 2479 /*
838b5b74 2480 * RenE<eacute> Descartes said "I think not."
bbce6d69 2481 * and vanished with a faint plop.
2482 */
96a5add6 2483 PERL_UNUSED_CONTEXT;
8772537c 2484 PERL_UNUSED_ARG(sv);
7a4c00b4 2485 if (mg->mg_ptr) {
2486 Safefree(mg->mg_ptr);
2487 mg->mg_ptr = NULL;
565764a8 2488 mg->mg_len = -1;
7a4c00b4 2489 }
bbce6d69 2490 return 0;
2491}
7a4c00b4 2492#endif /* USE_LOCALE_COLLATE */
bbce6d69 2493
7e8c5dac
HS
2494/* Just clear the UTF-8 cache data. */
2495int
2496Perl_magic_setutf8(pTHX_ SV *sv, MAGIC *mg)
2497{
7918f24d 2498 PERL_ARGS_ASSERT_MAGIC_SETUTF8;
96a5add6 2499 PERL_UNUSED_CONTEXT;
8772537c 2500 PERL_UNUSED_ARG(sv);
7e8c5dac 2501 Safefree(mg->mg_ptr); /* The mg_ptr holds the pos cache. */
3881461a 2502 mg->mg_ptr = NULL;
7e8c5dac
HS
2503 mg->mg_len = -1; /* The mg_len holds the len cache. */
2504 return 0;
2505}
2506
bbce6d69 2507int
9cce4f9a
FC
2508Perl_magic_setlvref(pTHX_ SV *sv, MAGIC *mg)
2509{
9782ce69 2510 const char *bad = NULL;
9cce4f9a 2511 PERL_ARGS_ASSERT_MAGIC_SETLVREF;
26a50d99 2512 if (!SvROK(sv)) Perl_croak(aTHX_ "Assigned value is not a reference");
9782ce69
FC
2513 switch (mg->mg_private & OPpLVREF_TYPE) {
2514 case OPpLVREF_SV:
2515 if (SvTYPE(SvRV(sv)) > SVt_PVLV)
2516 bad = " SCALAR";
2517 break;
2518 case OPpLVREF_AV:
2519 if (SvTYPE(SvRV(sv)) != SVt_PVAV)
2520 bad = "n ARRAY";
2521 break;
2522 case OPpLVREF_HV:
2523 if (SvTYPE(SvRV(sv)) != SVt_PVHV)
2524 bad = " HASH";
2525 break;
2526 case OPpLVREF_CV:
2527 if (SvTYPE(SvRV(sv)) != SVt_PVCV)
2528 bad = " CODE";
2529 }
2530 if (bad)
26a50d99 2531 /* diag_listed_as: Assigned value is not %s reference */
9782ce69 2532 Perl_croak(aTHX_ "Assigned value is not a%s reference", bad);
c146a62a
FC
2533 switch (mg->mg_obj ? SvTYPE(mg->mg_obj) : 0) {
2534 case 0:
2535 {
2536 SV * const old = PAD_SV(mg->mg_len);
2537 PAD_SETSV(mg->mg_len, SvREFCNT_inc_NN(SvRV(sv)));
2538 SvREFCNT_dec(old);
2539 break;
2540 }
2541 case SVt_PVGV:
2542 gv_setref(mg->mg_obj, sv);
2543 SvSETMAGIC(mg->mg_obj);
6102323a
FC
2544 break;
2545 case SVt_PVAV:
2546 av_store((AV *)mg->mg_obj, SvIV((SV *)mg->mg_ptr),
2547 SvREFCNT_inc_simple_NN(SvRV(sv)));
5f94141d
FC
2548 break;
2549 case SVt_PVHV:
7fcb36d5
JH
2550 (void)hv_store_ent((HV *)mg->mg_obj, (SV *)mg->mg_ptr,
2551 SvREFCNT_inc_simple_NN(SvRV(sv)), 0);
c146a62a 2552 }
d39c26a6
FC
2553 if (mg->mg_flags & MGf_PERSIST)
2554 NOOP; /* This sv is in use as an iterator var and will be reused,
2555 so we must leave the magic. */
2556 else
2557 /* This sv could be returned by the assignment op, so clear the
2558 magic, as lvrefs are an implementation detail that must not be
2559 leaked to the user. */
2560 sv_unmagic(sv, PERL_MAGIC_lvref);
9cce4f9a
FC
2561 return 0;
2562}
2563
2564int
864dbfa3 2565Perl_magic_set(pTHX_ SV *sv, MAGIC *mg)
79072805 2566{
20b7effb 2567#ifdef USE_ITHREADS
97aff369 2568 dVAR;
20b7effb 2569#endif
eb578fdb
KW
2570 const char *s;
2571 I32 paren;
2572 const REGEXP * rx;
79072805 2573 I32 i;
8990e307 2574 STRLEN len;
125b9982 2575 MAGIC *tmg;
2fdbfb4d 2576
7918f24d
NC
2577 PERL_ARGS_ASSERT_MAGIC_SET;
2578
e91d8259 2579 if (!mg->mg_ptr) {
960b831f 2580 paren = mg->mg_len;
1e05feb3 2581 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
e91d8259 2582 setparen_got_rx:
2fdbfb4d 2583 CALLREG_NUMBUF_STORE((REGEXP * const)rx,paren,sv);
1e05feb3 2584 } else {
2fdbfb4d
AB
2585 /* Croak with a READONLY error when a numbered match var is
2586 * set without a previous pattern match. Unless it's C<local $1>
2587 */
e91d8259 2588 croakparen:
2fdbfb4d 2589 if (!PL_localizing) {
cb077ed2 2590 Perl_croak_no_modify();
2fdbfb4d
AB
2591 }
2592 }
e91d8259
NC
2593 return 0;
2594 }
2595
2596 switch (*mg->mg_ptr) {
748a9306 2597 case '\001': /* ^A */
f2da823f
FC
2598 if (SvOK(sv)) sv_copypv(PL_bodytarget, sv);
2599 else SvOK_off(PL_bodytarget);
64eff8b7
DM
2600 FmLINES(PL_bodytarget) = 0;
2601 if (SvPOK(PL_bodytarget)) {
2602 char *s = SvPVX(PL_bodytarget);
2603 while ( ((s = strchr(s, '\n'))) ) {
2604 FmLINES(PL_bodytarget)++;
2605 s++;
2606 }
2607 }
125b9982 2608 /* mg_set() has temporarily made sv non-magical */
284167a5 2609 if (TAINTING_get) {
125b9982
NT
2610 if ((tmg = mg_find(sv,PERL_MAGIC_taint)) && tmg->mg_len & 1)
2611 SvTAINTED_on(PL_bodytarget);
2612 else
2613 SvTAINTED_off(PL_bodytarget);
2614 }
748a9306 2615 break;
49460fe6 2616 case '\003': /* ^C */
f2338a2e 2617 PL_minus_c = cBOOL(SvIV(sv));
49460fe6
NIS
2618 break;
2619
79072805 2620 case '\004': /* ^D */
b4ab917c 2621#ifdef DEBUGGING
b83604b4 2622 s = SvPV_nolen_const(sv);
ddcf8bc1 2623 PL_debug = get_debug_opts(&s, 0) | DEBUG_TOP_FLAG;
a58fb6f9
CS
2624 if (DEBUG_x_TEST || DEBUG_B_TEST)
2625 dump_all_perl(!DEBUG_B_TEST);
b4ab917c 2626#else
38ab35f8 2627 PL_debug = (SvIV(sv)) | DEBUG_TOP_FLAG;
b4ab917c 2628#endif
79072805 2629 break;
28f23441 2630 case '\005': /* ^E */
d0063567 2631 if (*(mg->mg_ptr+1) == '\0') {
e37778c2 2632#ifdef VMS
38ab35f8 2633 set_vaxc_errno(SvIV(sv));
e37778c2
NC
2634#else
2635# ifdef WIN32
d0063567 2636 SetLastError( SvIV(sv) );
e37778c2
NC
2637# else
2638# ifdef OS2
38ab35f8 2639 os2_setsyserrno(SvIV(sv));
e37778c2 2640# else
d0063567 2641 /* will anyone ever use this? */
38ab35f8 2642 SETERRNO(SvIV(sv), 4);
048c1ddf
IZ
2643# endif
2644# endif
22fae026 2645#endif
d0063567 2646 }
3e669301
KW
2647 else {
2648 unsigned int offset = 1;
2649 bool lex = FALSE;
2650
2651 /* It may be the shadow variable ${E_NCODING} which has lexical
2652 * scope. See comments at Perl__get_encoding in this file */
2653 if (*(mg->mg_ptr + 1) == '_') {
199670db
FC
2654 if (CopSTASH(PL_curcop) != get_hv("encoding::",0))
2655 Perl_croak_no_modify();
3e669301
KW
2656 lex = TRUE;
2657 offset++;
2658 }
2659 if (strEQ(mg->mg_ptr + offset, "NCODING")) {
2660 if (lex) { /* Use the shadow global */
2661 SvREFCNT_dec(PL_lex_encoding);
2662 if (SvOK(sv) || SvGMAGICAL(sv)) {
2663 PL_lex_encoding = newSVsv(sv);
2664 }
2665 else {
2666 PL_lex_encoding = NULL;
2667 }
2668 }
2669 else { /* Use the regular global */
050e2cbf
KW
2670 SvREFCNT_dec(PL_encoding);
2671 if (SvOK(sv) || SvGMAGICAL(sv)) {
d5b4785c
DIM
2672 if (PL_localizing != 2) {
2673 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
2674 "Setting ${^ENCODING} is deprecated");
2675 }
050e2cbf
KW
2676 PL_encoding = newSVsv(sv);
2677 }
2678 else {
2679 PL_encoding = NULL;
2680 }
2681 }
3e669301
KW
2682 }
2683 }
d0063567 2684 break;
79072805 2685 case '\006': /* ^F */
38ab35f8 2686 PL_maxsysfd = SvIV(sv);
79072805 2687 break;
a0d0e21e 2688 case '\010': /* ^H */
38ab35f8 2689 PL_hints = SvIV(sv);
a0d0e21e 2690 break;
9d116dd7 2691 case '\011': /* ^I */ /* NOT \t in EBCDIC */
43c5f42d 2692 Safefree(PL_inplace);
bd61b366 2693 PL_inplace = SvOK(sv) ? savesvpv(sv) : NULL;
da78da6e 2694 break;
d9bad346
FC
2695 case '\016': /* ^N */
2696 if (PL_curpm && (rx = PM_GETRE(PL_curpm))
2697 && (paren = RX_LASTCLOSEPAREN(rx))) goto setparen_got_rx;
2698 goto croakparen;
28f23441 2699 case '\017': /* ^O */
ac27b0f5 2700 if (*(mg->mg_ptr+1) == '\0') {
43c5f42d 2701 Safefree(PL_osname);
bd61b366 2702 PL_osname = NULL;
3511154c
DM
2703 if (SvOK(sv)) {
2704 TAINT_PROPER("assigning to $^O");
2e0de35c 2705 PL_osname = savesvpv(sv);
3511154c 2706 }
ac27b0f5
NIS
2707 }
2708 else if (strEQ(mg->mg_ptr, "\017PEN")) {
8b850bd5
NC
2709 STRLEN len;
2710 const char *const start = SvPV(sv, len);
b54fc2b6 2711 const char *out = (const char*)memchr(start, '\0', len);
8b850bd5 2712 SV *tmp;
8b850bd5
NC
2713
2714
2715 PL_compiling.cop_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
f747ebd6 2716 PL_hints |= HINT_LEXICAL_IO_IN | HINT_LEXICAL_IO_OUT;
8b850bd5
NC
2717
2718 /* Opening for input is more common than opening for output, so
2719 ensure that hints for input are sooner on linked list. */
59cd0e26 2720 tmp = out ? newSVpvn_flags(out + 1, start + len - out - 1,
f747ebd6
Z
2721 SvUTF8(sv))
2722 : newSVpvs_flags("", SvUTF8(sv));
2723 (void)hv_stores(GvHV(PL_hintgv), "open>", tmp);
2724 mg_set(tmp);
8b850bd5 2725
f747ebd6
Z
2726 tmp = newSVpvn_flags(start, out ? (STRLEN)(out - start) : len,
2727 SvUTF8(sv));
2728 (void)hv_stores(GvHV(PL_hintgv), "open<", tmp);
2729 mg_set(tmp);
ac27b0f5 2730 }
28f23441 2731 break;
79072805 2732 case '\020': /* ^P */
2fdbfb4d
AB
2733 PL_perldb = SvIV(sv);
2734 if (PL_perldb && !PL_DBsingle)
2735 init_debugger();
9b9e0be4 2736 break;
79072805 2737 case '\024': /* ^T */
88e89b8a 2738#ifdef BIG_TIME
6b88bc9c 2739 PL_basetime = (Time_t)(SvNOK(sv) ? SvNVX(sv) : sv_2nv(sv));
88e89b8a 2740#else
38ab35f8 2741 PL_basetime = (Time_t)SvIV(sv);
88e89b8a 2742#endif
79072805 2743 break;
e07ea26a
NC
2744 case '\025': /* ^UTF8CACHE */
2745 if (strEQ(mg->mg_ptr+1, "TF8CACHE")) {
2746 PL_utf8cache = (signed char) sv_2iv(sv);
2747 }
2748 break;
fde18df1 2749 case '\027': /* ^W & $^WARNING_BITS */
4438c4b7
JH
2750 if (*(mg->mg_ptr+1) == '\0') {
2751 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
38ab35f8 2752 i = SvIV(sv);
ac27b0f5 2753 PL_dowarn = (PL_dowarn & ~G_WARN_ON)
0453d815 2754 | (i ? G_WARN_ON : G_WARN_OFF) ;
4438c4b7 2755 }
599cee73 2756 }
0a378802 2757 else if (strEQ(mg->mg_ptr+1, "ARNING_BITS")) {
4438c4b7 2758 if ( ! (PL_dowarn & G_WARN_ALL_MASK)) {
7e4f0450
FC
2759 if (!SvPOK(sv)) {
2760 PL_compiling.cop_warnings = pWARN_STD;
d775746e
GS
2761 break;
2762 }
f4fc7782 2763 {
b5477537 2764 STRLEN len, i;
d3a7d8c7 2765 int accumulate = 0 ;
f4fc7782 2766 int any_fatals = 0 ;
b83604b4 2767 const char * const ptr = SvPV_const(sv, len) ;
f4fc7782
JH
2768 for (i = 0 ; i < len ; ++i) {
2769 accumulate |= ptr[i] ;
2770 any_fatals |= (ptr[i] & 0xAA) ;
2771 }
4243c432
NC
2772 if (!accumulate) {
2773 if (!specialWARN(PL_compiling.cop_warnings))
2774 PerlMemShared_free(PL_compiling.cop_warnings);
2775 PL_compiling.cop_warnings = pWARN_NONE;
2776 }
3c3f8cd6
AB
2777 /* Yuck. I can't see how to abstract this: */
2778 else if (isWARN_on(
2779 ((STRLEN *)SvPV_nolen_const(sv)) - 1,
2780 WARN_ALL)
2781 && !any_fatals)
2782 {
2783 if (!specialWARN(PL_compiling.cop_warnings))
2784 PerlMemShared_free(PL_compiling.cop_warnings);
2785 PL_compiling.cop_warnings = pWARN_ALL;
2786 PL_dowarn |= G_WARN_ONCE ;
2787 }
d3a7d8c7 2788 else {
72dc9ed5
NC
2789 STRLEN len;
2790 const char *const p = SvPV_const(sv, len);
2791
2792 PL_compiling.cop_warnings
8ee4cf24 2793 = Perl_new_warnings_bitfield(aTHX_ PL_compiling.cop_warnings,
72dc9ed5
NC
2794 p, len);
2795
d3a7d8c7
GS
2796 if (isWARN_on(PL_compiling.cop_warnings, WARN_ONCE))
2797 PL_dowarn |= G_WARN_ONCE ;
2798 }
f4fc7782 2799
d3a7d8c7 2800 }
4438c4b7 2801 }
971a9dd3 2802 }
79072805
LW
2803 break;
2804 case '.':
3280af22
NIS
2805 if (PL_localizing) {
2806 if (PL_localizing == 1)
7766f137 2807 SAVESPTR(PL_last_in_gv);
748a9306 2808 }
3280af22 2809 else if (SvOK(sv) && GvIO(PL_last_in_gv))
632db599 2810 IoLINES(GvIOp(PL_last_in_gv)) = SvIV(sv);
79072805
LW
2811 break;
2812 case '^':
acbe1b9d
FC
2813 Safefree(IoTOP_NAME(GvIOp(PL_defoutgv)));
2814 s = IoTOP_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2815 IoTOP_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
79072805
LW
2816 break;
2817 case '~':
acbe1b9d
FC
2818 Safefree(IoFMT_NAME(GvIOp(PL_defoutgv)));
2819 s = IoFMT_NAME(GvIOp(PL_defoutgv)) = savesvpv(sv);
2820 IoFMT_GV(GvIOp(PL_defoutgv)) = gv_fetchsv(sv, GV_ADD, SVt_PVIO);
79072805
LW
2821 break;
2822 case '=':
acbe1b9d 2823 IoPAGE_LEN(GvIOp(PL_defoutgv)) = (SvIV(sv));
79072805
LW
2824 break;
2825 case '-':
acbe1b9d
FC
2826 IoLINES_LEFT(GvIOp(PL_defoutgv)) = (SvIV(sv));
2827 if (IoLINES_LEFT(GvIOp(PL_defoutgv)) < 0L)
099be4f1 2828 IoLINES_LEFT(GvIOp(PL_defoutgv)) = 0L;
79072805
LW
2829 break;
2830 case '%':
acbe1b9d 2831 IoPAGE(GvIOp(PL_defoutgv)) = (SvIV(sv));
79072805
LW
2832 break;
2833 case '|':
4b65379b 2834 {
099be4f1 2835 IO * const io = GvIO(PL_defoutgv);
720f287d
AB
2836 if(!io)
2837 break;
38ab35f8 2838 if ((SvIV(sv)) == 0)
4b65379b
CS
2839 IoFLAGS(io) &= ~IOf_FLUSH;
2840 else {
2841 if (!(IoFLAGS(io) & IOf_FLUSH)) {
2842 PerlIO *ofp = IoOFP(io);
2843 if (ofp)
2844 (void)PerlIO_flush(ofp);
2845 IoFLAGS(io) |= IOf_FLUSH;
2846 }
2847 }
79072805
LW
2848 }
2849 break;
79072805 2850 case '/':
1ab48e3a
YO
2851 {
2852 SV *tmpsv= sv;
2853 if (SvROK(sv)) {
2854 SV *referent= SvRV(sv);
2855 const char *reftype= sv_reftype(referent, 0);
2856 /* XXX: dodgy type check: This leaves me feeling dirty, but the alternative
2857 * is to copy pretty much the entire sv_reftype() into this routine, or to do
2858 * a full string comparison on the return of sv_reftype() both of which
2859 * make me feel worse! NOTE, do not modify this comment without reviewing the
2860 * corresponding comment in sv_reftype(). - Yves */
2861 if (reftype[0] == 'S' || reftype[0] == 'L') {
2862 IV val= SvIV(referent);
2863 if (val <= 0) {
2864 tmpsv= &PL_sv_undef;
ddc3d23f 2865 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
1ab48e3a
YO
2866 "Setting $/ to a reference to %s as a form of slurp is deprecated, treating as undef",
2867 SvIV(SvRV(sv)) < 0 ? "a negative integer" : "zero"
2868 );
2869 }
2870 } else {
ddce084a 2871 sv_setsv(sv, PL_rs);
ee0ba734 2872 /* diag_listed_as: Setting $/ to %s reference is forbidden */
a48e4205
FC
2873 Perl_croak(aTHX_ "Setting $/ to a%s %s reference is forbidden",
2874 *reftype == 'A' ? "n" : "", reftype);
1ab48e3a
YO
2875 }
2876 }
b3a2acfa 2877 SvREFCNT_dec(PL_rs);
1ab48e3a 2878 PL_rs = newSVsv(tmpsv);
b3a2acfa 2879 }
79072805
LW
2880 break;
2881 case '\\':
ef8d46e8 2882 SvREFCNT_dec(PL_ors_sv);
6bc2995b 2883 if (SvOK(sv)) {
7889fe52 2884 PL_ors_sv = newSVsv(sv);
009c130f 2885 }
e3c19b7b 2886 else {
a0714e2c 2887 PL_ors_sv = NULL;
e3c19b7b 2888 }
79072805 2889 break;
7d69d4a6
FC
2890 case '[':
2891 if (SvIV(sv) != 0)
2892 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2893 break;
79072805 2894 case '?':
ff0cee69 2895#ifdef COMPLEX_STATUS
6b88bc9c 2896 if (PL_localizing == 2) {
41cb7b2b 2897 SvUPGRADE(sv, SVt_PVLV);
6b88bc9c
GS
2898 PL_statusvalue = LvTARGOFF(sv);
2899 PL_statusvalue_vms = LvTARGLEN(sv);
ff0cee69 2900 }
2901 else
2902#endif
2903#ifdef VMSISH_STATUS
2904 if (VMSISH_STATUS)
fb38d079 2905 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
ff0cee69 2906 else
2907#endif
38ab35f8 2908 STATUS_UNIX_EXIT_SET(SvIV(sv));
79072805
LW
2909 break;
2910 case '!':
93189314
JH
2911 {
2912#ifdef VMS
2913# define PERL_VMS_BANG vaxc$errno
2914#else
2915# define PERL_VMS_BANG 0
2916#endif
27329181 2917#if defined(WIN32) && ! defined(UNDER_CE)
c9beaf97
SH
2918 SETERRNO(win32_get_errno(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0),
2919 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2920#else
91487cfc 2921 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
93189314 2922 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
c9beaf97 2923#endif
93189314 2924 }
79072805
LW
2925 break;
2926 case '<':
985213f2 2927 {
b469f1e0 2928 /* XXX $< currently silently ignores failures */
dfff4baf 2929 const Uid_t new_uid = SvUID(sv);
985213f2 2930 PL_delaymagic_uid = new_uid;
3280af22
NIS
2931 if (PL_delaymagic) {
2932 PL_delaymagic |= DM_RUID;
79072805
LW
2933 break; /* don't do magic till later */
2934 }
2935#ifdef HAS_SETRUID
b469f1e0 2936 PERL_UNUSED_RESULT(setruid(new_uid));
79072805
LW
2937#else
2938#ifdef HAS_SETREUID
b469f1e0 2939 PERL_UNUSED_RESULT(setreuid(new_uid, (Uid_t)-1));
748a9306 2940#else
85e6fe83 2941#ifdef HAS_SETRESUID
b469f1e0 2942 PERL_UNUSED_RESULT(setresuid(new_uid, (Uid_t)-1, (Uid_t)-1));
79072805 2943#else
985213f2 2944 if (new_uid == PerlProc_geteuid()) { /* special case $< = $> */
75870ed3 2945#ifdef PERL_DARWIN
2946 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
985213f2 2947 if (new_uid != 0 && PerlProc_getuid() == 0)
b469f1e0 2948 PERL_UNUSED_RESULT(PerlProc_setuid(0));
75870ed3 2949#endif
b469f1e0 2950 PERL_UNUSED_RESULT(PerlProc_setuid(new_uid));
75870ed3 2951 } else {
cea2e8a9 2952 Perl_croak(aTHX_ "setruid() not implemented");
a0d0e21e 2953 }
79072805
LW
2954#endif
2955#endif
85e6fe83 2956#endif
79072805 2957 break;
985213f2 2958 }
79072805 2959 case '>':
985213f2 2960 {
b469f1e0 2961 /* XXX $> currently silently ignores failures */
dfff4baf 2962 const Uid_t new_euid = SvUID(sv);
985213f2 2963 PL_delaymagic_euid = new_euid;
3280af22
NIS
2964 if (PL_delaymagic) {
2965 PL_delaymagic |= DM_EUID;
79072805
LW
2966 break; /* don't do magic till later */
2967 }
2968#ifdef HAS_SETEUID
b469f1e0 2969 PERL_UNUSED_RESULT(seteuid(new_euid));
79072805
LW
2970#else
2971#ifdef HAS_SETREUID
b469f1e0 2972 PERL_UNUSED_RESULT(setreuid((Uid_t)-1, new_euid));
85e6fe83
LW
2973#else
2974#ifdef HAS_SETRESUID
b469f1e0 2975 PERL_UNUSED_RESULT(setresuid((Uid_t)-1, new_euid, (Uid_t)-1));
79072805 2976#else
985213f2 2977 if (new_euid == PerlProc_getuid()) /* special case $> = $< */
b469f1e0 2978 PERL_UNUSED_RESULT(PerlProc_setuid(new_euid));
a0d0e21e 2979 else {
cea2e8a9 2980 Perl_croak(aTHX_ "seteuid() not implemented");
a0d0e21e 2981 }
79072805
LW
2982#endif
2983#endif
85e6fe83 2984#endif
79072805 2985 break;
985213f2 2986 }
79072805 2987 case '(':
985213f2 2988 {
b469f1e0 2989 /* XXX $( currently silently ignores failures */
dfff4baf 2990 const Gid_t new_gid = SvGID(sv);
985213f2 2991 PL_delaymagic_gid = new_gid;
3280af22
NIS
2992 if (PL_delaymagic) {
2993 PL_delaymagic |= DM_RGID;
79072805
LW
2994 break; /* don't do magic till later */
2995 }
2996#ifdef HAS_SETRGID
b469f1e0 2997 PERL_UNUSED_RESULT(setrgid(new_gid));
79072805
LW
2998#else
2999#ifdef HAS_SETREGID
b469f1e0 3000 PERL_UNUSED_RESULT(setregid(new_gid, (Gid_t)-1));
85e6fe83
LW
3001#else
3002#ifdef HAS_SETRESGID
b469f1e0 3003 PERL_UNUSED_RESULT(setresgid(new_gid, (Gid_t)-1, (Gid_t) -1));
79072805 3004#else
985213f2 3005 if (new_gid == PerlProc_getegid()) /* special case $( = $) */
b469f1e0 3006 PERL_UNUSED_RESULT(PerlProc_setgid(new_gid));
748a9306 3007 else {
cea2e8a9 3008 Perl_croak(aTHX_ "setrgid() not implemented");
748a9306 3009 }
79072805
LW
3010#endif
3011#endif
85e6fe83 3012#endif
79072805 3013 break;
985213f2 3014 }
79072805 3015 case ')':
985213f2 3016 {
0635704a
HS
3017/* (hv) best guess: maybe we'll need configure probes to do a better job,
3018 * but you can override it if you need to.
3019 */
3020#ifndef INVALID_GID
3021#define INVALID_GID ((Gid_t)-1)
3022#endif
b469f1e0 3023 /* XXX $) currently silently ignores failures */
dfff4baf 3024 Gid_t new_egid;
5cd24f17 3025#ifdef HAS_SETGROUPS
3026 {
b83604b4 3027 const char *p = SvPV_const(sv, len);
757f63d8 3028 Groups_t *gary = NULL;
fdadaf77 3029 const char* endptr;
22ff3130 3030 UV uv;
fb4089e0 3031#ifdef _SC_NGROUPS_MAX
3032 int maxgrp = sysconf(_SC_NGROUPS_MAX);
3033
3034 if (maxgrp < 0)
3035 maxgrp = NGROUPS;
3036#else
3037 int maxgrp = NGROUPS;
3038#endif
757f63d8
SP
3039
3040 while (isSPACE(*p))
3041 ++p;
22ff3130
HS
3042 if (grok_atoUV(p, &uv, &endptr))
3043 new_egid = (Gid_t)uv;
3044 else {
0635704a 3045 new_egid = INVALID_GID;
22ff3130
HS
3046 endptr = NULL;
3047 }
fb4089e0 3048 for (i = 0; i < maxgrp; ++i) {
fdadaf77
JH
3049 if (endptr == NULL)
3050 break;
3051 p = endptr;
757f63d8
SP
3052 while (isSPACE(*p))
3053 ++p;
3054 if (!*p)
3055 break;
fdadaf77 3056 if (!gary)
757f63d8
SP
3057 Newx(gary, i + 1, Groups_t);
3058 else
3059 Renew(gary, i + 1, Groups_t);
22ff3130
HS
3060 if (grok_atoUV(p, &uv, &endptr))
3061 gary[i] = (Groups_t)uv;
3062 else {
0635704a 3063 gary[i] = INVALID_GID;
22ff3130
HS
3064 endptr = NULL;
3065 }
757f63d8
SP
3066 }
3067 if (i)
b469f1e0 3068 PERL_UNUSED_RESULT(setgroups(i, gary));
f5a63d97 3069 Safefree(gary);
5cd24f17 3070 }
3071#else /* HAS_SETGROUPS */
dfff4baf 3072 new_egid = SvGID(sv);
5cd24f17 3073#endif /* HAS_SETGROUPS */
985213f2 3074 PL_delaymagic_egid = new_egid;
3280af22
NIS
3075 if (PL_delaymagic) {
3076 PL_delaymagic |= DM_EGID;
79072805
LW
3077 break; /* don't do magic till later */
3078 }
3079#ifdef HAS_SETEGID
b469f1e0 3080 PERL_UNUSED_RESULT(setegid(new_egid));
79072805
LW
3081#else
3082#ifdef HAS_SETREGID
b469f1e0 3083 PERL_UNUSED_RESULT(setregid((Gid_t)-1, new_egid));
85e6fe83
LW
3084#else
3085#ifdef HAS_SETRESGID
b469f1e0 3086 PERL_UNUSED_RESULT(setresgid((Gid_t)-1, new_egid, (Gid_t)-1));
79072805 3087#else
985213f2 3088 if (new_egid == PerlProc_getgid()) /* special case $) = $( */
b469f1e0 3089 PERL_UNUSED_RESULT(PerlProc_setgid(new_egid));
748a9306 3090 else {
cea2e8a9 3091 Perl_croak(aTHX_ "setegid() not implemented");
748a9306 3092 }
79072805
LW
3093#endif
3094#endif
85e6fe83 3095#endif
79072805 3096 break;
985213f2 3097 }
79072805 3098 case ':':
2d8e6c8d 3099 PL_chopset = SvPV_force(sv,len);
79072805 3100 break;
9cdac2a2
FC
3101 case '$': /* $$ */
3102 /* Store the pid in mg->mg_obj so we can tell when a fork has
3103 occurred. mg->mg_obj points to *$ by default, so clear it. */
3104 if (isGV(mg->mg_obj)) {
3105 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
3106 SvREFCNT_dec(mg->mg_obj);
3107 mg->mg_flags |= MGf_REFCOUNTED;
3108 mg->mg_obj = newSViv((IV)PerlProc_getpid());
3109 }
3110 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
3111 break;
79072805 3112 case '0':
e2975953 3113 LOCK_DOLLARZERO_MUTEX;
4bc88a62
PS
3114#ifdef HAS_SETPROCTITLE
3115 /* The BSDs don't show the argv[] in ps(1) output, they
3116 * show a string from the process struct and provide
3117 * the setproctitle() routine to manipulate that. */
a2722ac9 3118 if (PL_origalen != 1) {
b83604b4 3119 s = SvPV_const(sv, len);
98b76f99 3120# if __FreeBSD_version > 410001
9aad2c0e 3121 /* The leading "-" removes the "perl: " prefix,
4bc88a62
PS
3122 * but not the "(perl) suffix from the ps(1)
3123 * output, because that's what ps(1) shows if the
3124 * argv[] is modified. */
6f2ad931 3125 setproctitle("-%s", s);
9aad2c0e 3126# else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
4bc88a62
PS
3127 /* This doesn't really work if you assume that
3128 * $0 = 'foobar'; will wipe out 'perl' from the $0
3129 * because in ps(1) output the result will be like
3130 * sprintf("perl: %s (perl)", s)
3131 * I guess this is a security feature:
3132 * one (a user process) cannot get rid of the original name.
3133 * --jhi */
3134 setproctitle("%s", s);
3135# endif
3136 }
9d3968b2 3137#elif defined(__hpux) && defined(PSTAT_SETCMD)
a2722ac9 3138 if (PL_origalen != 1) {
17aa7f3d 3139 union pstun un;
b83604b4 3140 s = SvPV_const(sv, len);
6867be6d 3141 un.pst_command = (char *)s;
17aa7f3d
JH
3142 pstat(PSTAT_SETCMD, un, len, 0, 0);
3143 }
9d3968b2 3144#else
2d2af554
GA
3145 if (PL_origalen > 1) {
3146 /* PL_origalen is set in perl_parse(). */
3147 s = SvPV_force(sv,len);
3148 if (len >= (STRLEN)PL_origalen-1) {
3149 /* Longer than original, will be truncated. We assume that
3150 * PL_origalen bytes are available. */
3151 Copy(s, PL_origargv[0], PL_origalen-1, char);
3152 }
3153 else {
3154 /* Shorter than original, will be padded. */
235ac35d 3155#ifdef PERL_DARWIN
60777a0d
JH
3156 /* Special case for Mac OS X: see [perl #38868] */
3157 const int pad = 0;
235ac35d 3158#else
8a89a4f1
MB
3159 /* Is the space counterintuitive? Yes.
3160 * (You were expecting \0?)
3161 * Does it work? Seems to. (In Linux 2.4.20 at least.)
3162 * --jhi */
60777a0d 3163 const int pad = ' ';
235ac35d 3164#endif
60777a0d
JH
3165 Copy(s, PL_origargv[0], len, char);
3166 PL_origargv[0][len] = 0;
3167 memset(PL_origargv[0] + len + 1,
3168 pad, PL_origalen - len - 1);
2d2af554
GA
3169 }
3170 PL_origargv[0][PL_origalen-1] = 0;
3171 for (i = 1; i < PL_origargc; i++)
3172 PL_origargv[i] = 0;
7636ea95
AB
3173#ifdef HAS_PRCTL_SET_NAME
3174 /* Set the legacy process name in addition to the POSIX name on Linux */
3175 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
3176 /* diag_listed_as: SKIPME */
3177 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
3178 }
3179#endif
79072805 3180 }
9d3968b2 3181#endif
e2975953 3182 UNLOCK_DOLLARZERO_MUTEX;
79072805
LW
3183 break;
3184 }
3185 return 0;
3186}
3187
3188I32
84c7b88c
BF
3189Perl_whichsig_sv(pTHX_ SV *sigsv)
3190{
3191 const char *sigpv;
3192 STRLEN siglen;
3193 PERL_ARGS_ASSERT_WHICHSIG_SV;
84c7b88c
BF
3194 sigpv = SvPV_const(sigsv, siglen);
3195 return whichsig_pvn(sigpv, siglen);
3196}
3197
3198I32
3199Perl_whichsig_pv(pTHX_ const char *sig)
3200{
3201 PERL_ARGS_ASSERT_WHICHSIG_PV;
84c7b88c
BF
3202 return whichsig_pvn(sig, strlen(sig));
3203}
3204
3205I32
3206Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
79072805 3207{
eb578fdb 3208 char* const* sigv;
7918f24d 3209
84c7b88c 3210 PERL_ARGS_ASSERT_WHICHSIG_PVN;
96a5add6 3211 PERL_UNUSED_CONTEXT;
79072805 3212
aadb217d 3213 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
84c7b88c 3214 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
aadb217d 3215 return PL_sig_num[sigv - (char* const*)PL_sig_name];
79072805 3216#ifdef SIGCLD
84c7b88c 3217 if (memEQs(sig, len, "CHLD"))
79072805
LW
3218 return SIGCLD;
3219#endif
3220#ifdef SIGCHLD
84c7b88c 3221 if (memEQs(sig, len, "CLD"))
79072805
LW
3222 return SIGCHLD;
3223#endif
7f1236c0 3224 return -1;
79072805
LW
3225}
3226
ecfc5424 3227Signal_t
1e82f5a6 3228#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
b3dbdd48 3229Perl_sighandler(int sig, siginfo_t *sip, void *uap)
1e82f5a6
SH
3230#else
3231Perl_sighandler(int sig)
3232#endif
79072805 3233{
1018e26f
NIS
3234#ifdef PERL_GET_SIG_CONTEXT
3235 dTHXa(PERL_GET_SIG_CONTEXT);
71d280e3 3236#else
cea2e8a9 3237 dTHX;
71d280e3 3238#endif
79072805 3239 dSP;
a0714e2c
SS
3240 GV *gv = NULL;
3241 SV *sv = NULL;
8772537c 3242 SV * const tSv = PL_Sv;
601f1833 3243 CV *cv = NULL;
533c011a 3244 OP *myop = PL_op;
84902520 3245 U32 flags = 0;
8772537c 3246 XPV * const tXpv = PL_Xpv;
0c4d3b5e 3247 I32 old_ss_ix = PL_savestack_ix;
100c03aa 3248 SV *errsv_save = NULL;
71d280e3 3249
84902520 3250
727405f8 3251 if (!PL_psig_ptr[sig]) {
99ef548b 3252 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
727405f8
NIS
3253 PL_sig_name[sig]);
3254 exit(sig);
3255 }
ff0cee69 3256
a0d63a7b
DM
3257 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3258 /* Max number of items pushed there is 3*n or 4. We cannot fix
3259 infinity, so we fix 4 (in fact 5): */
3260 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3261 flags |= 1;
3262 PL_savestack_ix += 5; /* Protect save in progress. */
3263 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3264 }
84902520 3265 }
84902520 3266 /* sv_2cv is too complicated, try a simpler variant first: */
ea726b52 3267 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
8772537c
AL
3268 || SvTYPE(cv) != SVt_PVCV) {
3269 HV *st;
f2c0649b 3270 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
8772537c 3271 }
84902520 3272
a0d0e21e 3273 if (!cv || !CvROOT(cv)) {
07c325bb 3274 const HEK * const hek = gv
1d6bb9ae
FC
3275 ? GvENAME_HEK(gv)
3276 : cv && CvNAMED(cv)
3277 ? CvNAME_HEK(cv)
07c325bb
FC
3278 : cv && CvGV(cv) ? GvENAME_HEK(CvGV(cv)) : NULL;
3279 if (hek)
3280 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3281 "SIG%s handler \"%"HEKf"\" not defined.\n",
3282 PL_sig_name[sig], hek);
3283 /* diag_listed_as: SIG%s handler "%s" not defined */
3284 else Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3285 "SIG%s handler \"__ANON__\" not defined.\n",
3286 PL_sig_name[sig]);
00d579c5 3287 goto cleanup;
79072805
LW
3288 }
3289
0c4d3b5e
DM
3290 sv = PL_psig_name[sig]
3291 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3292 : newSVpv(PL_sig_name[sig],0);
72048cfe 3293 flags |= 8;
0c4d3b5e
DM
3294 SAVEFREESV(sv);
3295
a0d63a7b
DM
3296 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3297 /* make sure our assumption about the size of the SAVEs are correct:
3298 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3299 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3300 }
e336de0d 3301
e788e7d3 3302 PUSHSTACKi(PERLSI_SIGNAL);
924508f0 3303 PUSHMARK(SP);
79072805 3304 PUSHs(sv);
8aad04aa
JH
3305#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3306 {
3307 struct sigaction oact;
3308
3309 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
8aad04aa
JH
3310 if (sip) {
3311 HV *sih = newHV();
ad64d0ec 3312 SV *rv = newRV_noinc(MUTABLE_SV(sih));
8aad04aa
JH
3313 /* The siginfo fields signo, code, errno, pid, uid,
3314 * addr, status, and band are defined by POSIX/SUSv3. */
85771703
NC
3315 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3316 (void)hv_stores(sih, "code", newSViv(sip->si_code));
79dec0f4 3317#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. */
85771703
NC
3318 hv_stores(sih, "errno", newSViv(sip->si_errno));
3319 hv_stores(sih, "status", newSViv(sip->si_status));
3320 hv_stores(sih, "uid", newSViv(sip->si_uid));
3321 hv_stores(sih, "pid", newSViv(sip->si_pid));
3322 hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3323 hv_stores(sih, "band", newSViv(sip->si_band));
79dec0f4 3324#endif
8aad04aa 3325 EXTEND(SP, 2);
ad64d0ec 3326 PUSHs(rv);
22f1178f 3327 mPUSHp((char *)sip, sizeof(*sip));
8aad04aa 3328 }
b4552a27 3329
8aad04aa
JH
3330 }
3331 }
3332#endif
79072805 3333 PUTBACK;
a0d0e21e 3334
100c03aa
JL
3335 errsv_save = newSVsv(ERRSV);
3336
ad64d0ec 3337 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
79072805 3338
d3acc0f7 3339 POPSTACK;
eed484f9
DD
3340 {
3341 SV * const errsv = ERRSV;
3342 if (SvTRUE_NN(errsv)) {
3343 SvREFCNT_dec(errsv_save);
c22d665b 3344#ifndef PERL_MICRO
1b266415
NIS
3345 /* Handler "died", for example to get out of a restart-able read().
3346 * Before we re-do that on its behalf re-enable the signal which was
3347 * blocked by the system when we entered.
3348 */
c22d665b 3349#ifdef HAS_SIGPROCMASK
d488af49 3350#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
eed484f9 3351 if (sip || uap)
c22d665b 3352#endif
eed484f9
DD
3353 {
3354 sigset_t set;
3355 sigemptyset(&set);
3356 sigaddset(&set,sig);
3357 sigprocmask(SIG_UNBLOCK, &set, NULL);
3358 }
c22d665b 3359#else
eed484f9
DD
3360 /* Not clear if this will work */
3361 (void)rsignal(sig, SIG_IGN);
3362 (void)rsignal(sig, PL_csighandlerp);
c22d665b
LT
3363#endif
3364#endif /* !PERL_MICRO */
eed484f9
DD
3365 die_sv(errsv);
3366 }
3367 else {
3368 sv_setsv(errsv, errsv_save);
3369 SvREFCNT_dec(errsv_save);
3370 }
100c03aa
JL
3371 }
3372
7b52d656 3373 cleanup:
0c4d3b5e
DM
3374 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3375 PL_savestack_ix = old_ss_ix;
72048cfe 3376 if (flags & 8)
2357bae7 3377 SvREFCNT_dec_NN(sv);
533c011a 3378 PL_op = myop; /* Apparently not needed... */
ac27b0f5 3379
3280af22
NIS
3380 PL_Sv = tSv; /* Restore global temporaries. */
3381 PL_Xpv = tXpv;
53bb94e2 3382 return;
79072805 3383}
4e35701f
NIS
3384
3385
51371543 3386static void
8772537c 3387S_restore_magic(pTHX_ const void *p)
51371543 3388{
8772537c
AL
3389 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3390 SV* const sv = mgs->mgs_sv;
150b625d 3391 bool bumped;
51371543
GS
3392
3393 if (!sv)
3394 return;
3395
4bac9ae4
CS
3396 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
3397 SvTEMP_off(sv); /* if it's still magical, this value isn't temporary */
f8c7b90f 3398#ifdef PERL_OLD_COPY_ON_WRITE
f9701176
NC
3399 /* While magic was saved (and off) sv_setsv may well have seen
3400 this SV as a prime candidate for COW. */
3401 if (SvIsCOW(sv))
e424a81e 3402 sv_force_normal_flags(sv, 0);
f9701176 3403#endif
a623f893
FC
3404 if (mgs->mgs_flags)
3405 SvFLAGS(sv) |= mgs->mgs_flags;
51371543
GS
3406 else
3407 mg_magical(sv);
51371543
GS
3408 }
3409
150b625d 3410 bumped = mgs->mgs_bumped;
51371543
GS
3411 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3412
3413 /* If we're still on top of the stack, pop us off. (That condition
3414 * will be satisfied if restore_magic was called explicitly, but *not*
3415 * if it's being called via leave_scope.)
3416 * The reason for doing this is that otherwise, things like sv_2cv()
3417 * may leave alloc gunk on the savestack, and some code
3418 * (e.g. sighandler) doesn't expect that...
3419 */
3420 if (PL_savestack_ix == mgs->mgs_ss_ix)
3421 {
1be36ce0
NC
3422 UV popval = SSPOPUV;
3423 assert(popval == SAVEt_DESTRUCTOR_X);
51371543 3424 PL_savestack_ix -= 2;
1be36ce0
NC
3425 popval = SSPOPUV;
3426 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3427 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
51371543 3428 }
150b625d
DM
3429 if (bumped) {
3430 if (SvREFCNT(sv) == 1) {
3431 /* We hold the last reference to this SV, which implies that the
3432 SV was deleted as a side effect of the routines we called.
3433 So artificially keep it alive a bit longer.
3434 We avoid turning on the TEMP flag, which can cause the SV's
3435 buffer to get stolen (and maybe other stuff). */
150b625d 3436 sv_2mortal(sv);
4bac9ae4 3437 SvTEMP_off(sv);
8985fe98 3438 }
150b625d 3439 else
2357bae7 3440 SvREFCNT_dec_NN(sv); /* undo the inc in S_save_magic() */
8985fe98 3441 }
51371543
GS
3442}
3443
0c4d3b5e
DM
3444/* clean up the mess created by Perl_sighandler().
3445 * Note that this is only called during an exit in a signal handler;
3446 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
9a7f166c 3447 * skipped over. */
0c4d3b5e 3448
51371543 3449static void
8772537c 3450S_unwind_handler_stack(pTHX_ const void *p)
51371543 3451{
0c4d3b5e 3452 PERL_UNUSED_ARG(p);
7918f24d 3453
0c4d3b5e 3454 PL_savestack_ix -= 5; /* Unprotect save in progress. */
51371543 3455}
1018e26f 3456
66610fdd 3457/*
b3ca2e83
NC
3458=for apidoc magic_sethint
3459
3460Triggered by a store to %^H, records the key/value pair to
c28fe1ec
NC
3461C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3462anything that would need a deep copy. Maybe we should warn if we find a
3463reference.
b3ca2e83
NC
3464
3465=cut
3466*/
3467int
3468Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3469{
ad64d0ec 3470 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
59cd0e26 3471 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
b3ca2e83 3472
7918f24d
NC
3473 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3474
e6e3e454
NC
3475 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3476 an alternative leaf in there, with PL_compiling.cop_hints being used if
3477 it's NULL. If needed for threads, the alternative could lock a mutex,
3478 or take other more complex action. */
3479
5b9c0671
NC
3480 /* Something changed in %^H, so it will need to be restored on scope exit.
3481 Doing this here saves a lot of doing it manually in perl code (and
3482 forgetting to do it, and consequent subtle errors. */
3483 PL_hints |= HINT_LOCALIZE_HH;
20439bc7
Z
3484 CopHINTHASH_set(&PL_compiling,
3485 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
b3ca2e83
NC
3486 return 0;
3487}
3488
3489/*
f175cff5 3490=for apidoc magic_clearhint
b3ca2e83 3491
c28fe1ec
NC
3492Triggered by a delete from %^H, records the key to
3493C<PL_compiling.cop_hints_hash>.
b3ca2e83
NC
3494
3495=cut
3496*/
3497int
3498Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3499{
7918f24d 3500 PERL_ARGS_ASSERT_MAGIC_CLEARHINT;
f5a63d97
AL
3501 PERL_UNUSED_ARG(sv);
3502
5b9c0671 3503 PL_hints |= HINT_LOCALIZE_HH;
20439bc7 3504 CopHINTHASH_set(&PL_compiling,
e3352591
FC
3505 mg->mg_len == HEf_SVKEY
3506 ? cophh_delete_sv(CopHINTHASH_get(&PL_compiling),
3507 MUTABLE_SV(mg->mg_ptr), 0, 0)
3508 : cophh_delete_pvn(CopHINTHASH_get(&PL_compiling),
3509 mg->mg_ptr, mg->mg_len, 0, 0));
b3ca2e83
NC
3510 return 0;
3511}
3512
3513/*
f747ebd6
Z
3514=for apidoc magic_clearhints
3515
3516Triggered by clearing %^H, resets C<PL_compiling.cop_hints_hash>.
3517
3518=cut
3519*/
3520int
3521Perl_magic_clearhints(pTHX_ SV *sv, MAGIC *mg)
3522{
3523 PERL_ARGS_ASSERT_MAGIC_CLEARHINTS;
3524 PERL_UNUSED_ARG(sv);
3525 PERL_UNUSED_ARG(mg);
20439bc7
Z
3526 cophh_free(CopHINTHASH_get(&PL_compiling));
3527 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
f747ebd6
Z
3528 return 0;
3529}
3530
09fb282d
FC
3531int
3532Perl_magic_copycallchecker(pTHX_ SV *sv, MAGIC *mg, SV *nsv,
3533 const char *name, I32 namlen)
3534{
3535 MAGIC *nmg;
3536
3537 PERL_ARGS_ASSERT_MAGIC_COPYCALLCHECKER;
4f8dbb2d 3538 PERL_UNUSED_ARG(sv);
09fb282d
FC
3539 PERL_UNUSED_ARG(name);
3540 PERL_UNUSED_ARG(namlen);
3541
3542 sv_magic(nsv, &PL_sv_undef, mg->mg_type, NULL, 0);
3543 nmg = mg_find(nsv, mg->mg_type);
316ebaf2 3544 assert(nmg);
09fb282d
FC
3545 if (nmg->mg_flags & MGf_REFCOUNTED) SvREFCNT_dec(nmg->mg_obj);
3546 nmg->mg_ptr = mg->mg_ptr;
3547 nmg->mg_obj = SvREFCNT_inc_simple(mg->mg_obj);
3548 nmg->mg_flags |= MGf_REFCOUNTED;
3549 return 1;
3550}
3551
a6d69523
TC
3552int
3553Perl_magic_setdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3554 PERL_ARGS_ASSERT_MAGIC_SETDEBUGVAR;
3555
23270f96
DM
3556#if DBVARMG_SINGLE != 0
3557 assert(mg->mg_private >= DBVARMG_SINGLE);
3558#endif
3559 assert(mg->mg_private < DBVARMG_COUNT);
a6d69523
TC
3560
3561 PL_DBcontrol[mg->mg_private] = SvIV_nomg(sv);
3562
3563 return 1;
3564}
3565
3566int
3567Perl_magic_getdebugvar(pTHX_ SV *sv, MAGIC *mg) {
3568 PERL_ARGS_ASSERT_MAGIC_GETDEBUGVAR;
3569
23270f96
DM
3570#if DBVARMG_SINGLE != 0
3571 assert(mg->mg_private >= DBVARMG_SINGLE);
3572#endif
3573 assert(mg->mg_private < DBVARMG_COUNT);
a6d69523
TC
3574 sv_setiv(sv, PL_DBcontrol[mg->mg_private]);
3575
3576 return 0;
3577}
3578
f747ebd6 3579/*
14d04a33 3580 * ex: set ts=8 sts=4 sw=4 et:
37442d52 3581 */