This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
printf type-matching.
[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
PP
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
PP
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
7db6405c
FC
393 assert(!(SvTYPE(sv) == SVt_PVAV && AvPAD_NAMELIST(sv)));
394
39de7f53
FR
395 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
396 if (mg->mg_type == type && (!flags || mg->mg_virtual == vtbl)) {
397 return mg;
398 }
399 }
400 }
401
402 return NULL;
403}
404
954c1994
GS
405/*
406=for apidoc mg_find
407
408Finds the magic pointer for type matching the SV. See C<sv_magic>.
409
410=cut
411*/
412
93a17b20 413MAGIC*
ddeaf645 414Perl_mg_find(const SV *sv, int type)
93a17b20 415{
ddeaf645 416 return S_mg_findext_flags(sv, type, NULL, 0);
39de7f53
FR
417}
418
419/*
420=for apidoc mg_findext
421
422Finds the magic pointer of C<type> with the given C<vtbl> for the C<SV>. See
423C<sv_magicext>.
424
425=cut
426*/
427
428MAGIC*
ddeaf645 429Perl_mg_findext(const SV *sv, int type, const MGVTBL *vtbl)
39de7f53 430{
ddeaf645 431 return S_mg_findext_flags(sv, type, vtbl, 1);
93a17b20
LW
432}
433
96c2a8ff
FC
434MAGIC *
435Perl_mg_find_mglob(pTHX_ SV *sv)
436{
437 PERL_ARGS_ASSERT_MG_FIND_MGLOB;
438 if (SvTYPE(sv) == SVt_PVLV && LvTYPE(sv) == 'y') {
439 /* This sv is only a delegate. //g magic must be attached to
440 its target. */
441 vivify_defelem(sv);
442 sv = LvTARG(sv);
443 }
444 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
ddeaf645 445 return S_mg_findext_flags(sv, PERL_MAGIC_regex_global, 0, 0);
96c2a8ff
FC
446 return NULL;
447}
448
954c1994
GS
449/*
450=for apidoc mg_copy
451
452Copies the magic from one SV to another. See C<sv_magic>.
453
454=cut
455*/
456
79072805 457int
864dbfa3 458Perl_mg_copy(pTHX_ SV *sv, SV *nsv, const char *key, I32 klen)
79072805 459{
463ee0b2 460 int count = 0;
79072805 461 MAGIC* mg;
7918f24d
NC
462
463 PERL_ARGS_ASSERT_MG_COPY;
464
463ee0b2 465 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
35a4481c 466 const MGVTBL* const vtbl = mg->mg_virtual;
68795e93 467 if ((mg->mg_flags & MGf_COPY) && vtbl->svt_copy){
16c91539 468 count += vtbl->svt_copy(aTHX_ sv, mg, nsv, key, klen);
68795e93 469 }
823a54a3
AL
470 else {
471 const char type = mg->mg_type;
1e73acc8 472 if (isUPPER(type) && type != PERL_MAGIC_uvar) {
823a54a3
AL
473 sv_magic(nsv,
474 (type == PERL_MAGIC_tied)
475 ? SvTIED_obj(sv, mg)
476 : (type == PERL_MAGIC_regdata && mg->mg_obj)
477 ? sv
478 : mg->mg_obj,
479 toLOWER(type), key, klen);
480 count++;
481 }
79072805 482 }
79072805 483 }
463ee0b2 484 return count;
79072805
LW
485}
486
954c1994 487/*
0cbee0a4
DM
488=for apidoc mg_localize
489
9711599e 490Copy some of the magic from an existing SV to new localized version of that
154e47c8
FC
491SV. Container magic (eg %ENV, $1, tie)
492gets copied, value magic doesn't (eg
9711599e
CS
493taint, pos).
494
af7df257 495If setmagic is false then no set magic will be called on the new (empty) SV.
9711599e
CS
496This typically means that assignment will soon follow (e.g. 'local $x = $y'),
497and that will handle the magic.
0cbee0a4
DM
498
499=cut
500*/
501
502void
af7df257 503Perl_mg_localize(pTHX_ SV *sv, SV *nsv, bool setmagic)
0cbee0a4
DM
504{
505 MAGIC *mg;
7918f24d
NC
506
507 PERL_ARGS_ASSERT_MG_LOCALIZE;
508
658a9f31
JD
509 if (nsv == DEFSV)
510 return;
511
0cbee0a4 512 for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
2b1b43ea 513 const MGVTBL* const vtbl = mg->mg_virtual;
e0a73de4 514 if (PERL_MAGIC_TYPE_IS_VALUE_MAGIC(mg->mg_type))
0cbee0a4 515 continue;
0cbee0a4 516
a5063e7c 517 if ((mg->mg_flags & MGf_LOCAL) && vtbl->svt_local)
16c91539 518 (void)vtbl->svt_local(aTHX_ nsv, mg);
a5063e7c 519 else
0cbee0a4
DM
520 sv_magicext(nsv, mg->mg_obj, mg->mg_type, vtbl,
521 mg->mg_ptr, mg->mg_len);
a5063e7c 522
0cbee0a4 523 /* container types should remain read-only across localization */
9ff3e6d8 524 SvFLAGS(nsv) |= SvREADONLY(sv);
0cbee0a4
DM
525 }
526
527 if (SvTYPE(nsv) >= SVt_PVMG && SvMAGIC(nsv)) {
528 SvFLAGS(nsv) |= SvMAGICAL(sv);
af7df257 529 if (setmagic) {
9711599e
CS
530 PL_localizing = 1;
531 SvSETMAGIC(nsv);
532 PL_localizing = 0;
533 }
0cbee0a4
DM
534 }
535}
536
d9088386
Z
537#define mg_free_struct(sv, mg) S_mg_free_struct(aTHX_ sv, mg)
538static void
539S_mg_free_struct(pTHX_ SV *sv, MAGIC *mg)
540{
541 const MGVTBL* const vtbl = mg->mg_virtual;
542 if (vtbl && vtbl->svt_free)
543 vtbl->svt_free(aTHX_ sv, mg);
544 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
545 if (mg->mg_len > 0 || mg->mg_type == PERL_MAGIC_utf8)
546 Safefree(mg->mg_ptr);
547 else if (mg->mg_len == HEf_SVKEY)
548 SvREFCNT_dec(MUTABLE_SV(mg->mg_ptr));
549 }
550 if (mg->mg_flags & MGf_REFCOUNTED)
551 SvREFCNT_dec(mg->mg_obj);
552 Safefree(mg);
553}
554
0cbee0a4 555/*
954c1994
GS
556=for apidoc mg_free
557
558Free any magic storage used by the SV. See C<sv_magic>.
559
560=cut
561*/
562
79072805 563int
864dbfa3 564Perl_mg_free(pTHX_ SV *sv)
79072805
LW
565{
566 MAGIC* mg;
567 MAGIC* moremagic;
7918f24d
NC
568
569 PERL_ARGS_ASSERT_MG_FREE;
570
79072805 571 for (mg = SvMAGIC(sv); mg; mg = moremagic) {
79072805 572 moremagic = mg->mg_moremagic;
d9088386 573 mg_free_struct(sv, mg);
c826f41b 574 SvMAGIC_set(sv, moremagic);
79072805 575 }
b162af07 576 SvMAGIC_set(sv, NULL);
68f8932e 577 SvMAGICAL_off(sv);
79072805
LW
578 return 0;
579}
580
d9088386
Z
581/*
582=for apidoc Am|void|mg_free_type|SV *sv|int how
583
584Remove any magic of type I<how> from the SV I<sv>. See L</sv_magic>.
585
586=cut
587*/
588
589void
590Perl_mg_free_type(pTHX_ SV *sv, int how)
591{
592 MAGIC *mg, *prevmg, *moremg;
593 PERL_ARGS_ASSERT_MG_FREE_TYPE;
594 for (prevmg = NULL, mg = SvMAGIC(sv); mg; prevmg = mg, mg = moremg) {
595 MAGIC *newhead;
596 moremg = mg->mg_moremagic;
597 if (mg->mg_type == how) {
598 /* temporarily move to the head of the magic chain, in case
599 custom free code relies on this historical aspect of mg_free */
600 if (prevmg) {
601 prevmg->mg_moremagic = moremg;
602 mg->mg_moremagic = SvMAGIC(sv);
603 SvMAGIC_set(sv, mg);
604 }
605 newhead = mg->mg_moremagic;
606 mg_free_struct(sv, mg);
607 SvMAGIC_set(sv, newhead);
608 mg = prevmg;
609 }
610 }
611 mg_magical(sv);
612}
613
79072805 614#include <signal.h>
79072805 615
942e002e 616U32
864dbfa3 617Perl_magic_regdata_cnt(pTHX_ SV *sv, MAGIC *mg)
6cef1e77 618{
8772537c 619 PERL_UNUSED_ARG(sv);
6cef1e77 620
7918f24d
NC
621 PERL_ARGS_ASSERT_MAGIC_REGDATA_CNT;
622
0bd48802 623 if (PL_curpm) {
eb578fdb 624 const REGEXP * const rx = PM_GETRE(PL_curpm);
0bd48802 625 if (rx) {
a678b0e4
YO
626 if (mg->mg_obj) { /* @+ */
627 /* return the number possible */
07bc277f 628 return RX_NPARENS(rx);
a678b0e4 629 } else { /* @- */
07bc277f 630 I32 paren = RX_LASTPAREN(rx);
a678b0e4
YO
631
632 /* return the last filled */
f46c4081 633 while ( paren >= 0
07bc277f
NC
634 && (RX_OFFS(rx)[paren].start == -1
635 || RX_OFFS(rx)[paren].end == -1) )
f46c4081 636 paren--;
a678b0e4
YO
637 return (U32)paren;
638 }
0bd48802 639 }
8f580fb8 640 }
ac27b0f5 641
942e002e 642 return (U32)-1;
6cef1e77
IZ
643}
644
6502e081
DM
645/* @-, @+ */
646
6cef1e77 647int
864dbfa3 648Perl_magic_regdatum_get(pTHX_ SV *sv, MAGIC *mg)
6cef1e77 649{
7918f24d
NC
650 PERL_ARGS_ASSERT_MAGIC_REGDATUM_GET;
651
0bd48802 652 if (PL_curpm) {
eb578fdb 653 const REGEXP * const rx = PM_GETRE(PL_curpm);
0bd48802 654 if (rx) {
eb578fdb 655 const I32 paren = mg->mg_len;
a10eae29
FC
656 SSize_t s;
657 SSize_t t;
0bd48802
AL
658 if (paren < 0)
659 return 0;
07bc277f
NC
660 if (paren <= (I32)RX_NPARENS(rx) &&
661 (s = RX_OFFS(rx)[paren].start) != -1 &&
662 (t = RX_OFFS(rx)[paren].end) != -1)
0bd48802 663 {
a10eae29 664 SSize_t i;
0bd48802
AL
665 if (mg->mg_obj) /* @+ */
666 i = t;
667 else /* @- */
668 i = s;
669
a10eae29 670 if (RX_MATCH_UTF8(rx)) {
07bc277f 671 const char * const b = RX_SUBBEG(rx);
0bd48802 672 if (b)
6502e081
DM
673 i = RX_SUBCOFFSET(rx) +
674 utf8_length((U8*)b,
675 (U8*)(b-RX_SUBOFFSET(rx)+i));
0bd48802 676 }
727405f8 677
a10eae29 678 sv_setuv(sv, i);
232af1f8 679 return 0;
1aa99e6b 680 }
0bd48802 681 }
6cef1e77 682 }
232af1f8 683 sv_setsv(sv, NULL);
6cef1e77
IZ
684 return 0;
685}
686
6502e081
DM
687/* @-, @+ */
688
e4b89193 689int
a29d06ed
MG
690Perl_magic_regdatum_set(pTHX_ SV *sv, MAGIC *mg)
691{
7918f24d 692 PERL_ARGS_ASSERT_MAGIC_REGDATUM_SET;
dc3bf405 693 PERL_UNUSED_CONTEXT;
d4c19fe8
AL
694 PERL_UNUSED_ARG(sv);
695 PERL_UNUSED_ARG(mg);
cb077ed2 696 Perl_croak_no_modify();
0dbb1585 697 NORETURN_FUNCTION_END;
a29d06ed
MG
698}
699
ad3296c6 700#define SvRTRIM(sv) STMT_START { \
eae92ea0
GA
701 if (SvPOK(sv)) { \
702 STRLEN len = SvCUR(sv); \
703 char * const p = SvPVX(sv); \
8e6b4db6
PC
704 while (len > 0 && isSPACE(p[len-1])) \
705 --len; \
706 SvCUR_set(sv, len); \
707 p[len] = '\0'; \
708 } \
ad3296c6
SH
709} STMT_END
710
8b850bd5
NC
711void
712Perl_emulate_cop_io(pTHX_ const COP *const c, SV *const sv)
713{
7918f24d
NC
714 PERL_ARGS_ASSERT_EMULATE_COP_IO;
715
8b850bd5
NC
716 if (!(CopHINTS_get(c) & (HINT_LEXICAL_IO_IN|HINT_LEXICAL_IO_OUT)))
717 sv_setsv(sv, &PL_sv_undef);
718 else {
719 sv_setpvs(sv, "");
720 SvUTF8_off(sv);
721 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_IN)) {
20439bc7 722 SV *const value = cop_hints_fetch_pvs(c, "open<", 0);
8b850bd5
NC
723 assert(value);
724 sv_catsv(sv, value);
725 }
726 sv_catpvs(sv, "\0");
727 if ((CopHINTS_get(c) & HINT_LEXICAL_IO_OUT)) {
20439bc7 728 SV *const value = cop_hints_fetch_pvs(c, "open>", 0);
8b850bd5
NC
729 assert(value);
730 sv_catsv(sv, value);
731 }
732 }
733}
734
d9fe7d23
KW
735STATIC void
736S_fixup_errno_string(pTHX_ SV* sv)
737{
738 /* Do what is necessary to fixup the non-empty string in 'sv' for return to
739 * Perl space. */
740
741 PERL_ARGS_ASSERT_FIXUP_ERRNO_STRING;
742
743 assert(SvOK(sv));
b35e4f8b
KW
744
745 if(strEQ(SvPVX(sv), "")) {
746 sv_catpv(sv, UNKNOWN_ERRNO_MSG);
747 }
748 else {
d9fe7d23 749
d3c0b317
KW
750 /* In some locales the error string may come back as UTF-8, in which
751 * case we should turn on that flag. This didn't use to happen, and to
5320b60d
KW
752 * avoid as many possible backward compatibility issues as possible, we
753 * don't turn on the flag unless we have to. So the flag stays off for
9f10db87
KW
754 * an entirely invariant string. We assume that if the string looks
755 * like UTF-8, it really is UTF-8: "text in any other encoding that
756 * uses bytes with the high bit set is extremely unlikely to pass a
757 * UTF-8 validity test"
758 * (http://en.wikipedia.org/wiki/Charset_detection). There is a
759 * potential that we will get it wrong however, especially on short
760 * error message text. (If it turns out to be necessary, we could also
761 * keep track if the current LC_MESSAGES locale is UTF-8) */
d3c0b317 762 if (! IN_BYTES /* respect 'use bytes' */
9f10db87 763 && ! is_invariant_string((U8*) SvPVX_const(sv), SvCUR(sv))
d3c0b317
KW
764 && is_utf8_string((U8*) SvPVX_const(sv), SvCUR(sv)))
765 {
766 SvUTF8_on(sv);
767 }
b35e4f8b 768 }
d9fe7d23
KW
769}
770
ad2de1b2
KW
771SV*
772Perl__get_encoding(pTHX)
773{
3e669301
KW
774 /* For core Perl use only: Returns the $^ENCODING or 'use encoding' in
775 * effect; NULL if none.
776 *
777 * $^ENCODING maps to PL_encoding, and is the old way to do things, and is
778 * retained for backwards compatibility. Now, there is a shadow variable
779 * ${^E_NCODING} set only by the encoding pragma, used to give this pragma
780 * lexical scope, unlike the global scope it (shudder) used to have. This
781 * variable maps to PL_lex_encoding. Again for backwards compatibility,
782 * PL_encoding has precedence over PL_lex_encoding. The hints hash is used
783 * to determine if PL_lex_encoding is in scope, and hence valid. The hints
784 * hash only accepts simple values, so we can't put an Encode object into
785 * it, so we put the object into the global, and put a simple boolean into
786 * the hints hash giving whether the global is valid or not */
787
c79dccf4 788 dVAR;
3e669301
KW
789 SV *is_encoding;
790
791 if (PL_encoding) {
792 return PL_encoding;
793 }
794
795 if (! PL_lex_encoding) {
796 return NULL;
797 }
798
799 is_encoding = cop_hints_fetch_pvs(PL_curcop, "encoding", 0);
800 if ( is_encoding
801 && is_encoding != &PL_sv_placeholder
802 && SvIOK(is_encoding)
803 && SvIV(is_encoding)) /* non-zero mean valid */
804 {
805 return PL_lex_encoding;
806 }
ad2de1b2 807
3e669301 808 return NULL;
ad2de1b2
KW
809}
810
25bbd826
CB
811#ifdef VMS
812#include <descrip.h>
813#include <starlet.h>
814#endif
815
79072805 816int
864dbfa3 817Perl_magic_get(pTHX_ SV *sv, MAGIC *mg)
79072805 818{
eb578fdb
KW
819 I32 paren;
820 const char *s = NULL;
821 REGEXP *rx;
823a54a3 822 const char * const remaining = mg->mg_ptr + 1;
e91d8259 823 char nextchar;
79072805 824
7918f24d
NC
825 PERL_ARGS_ASSERT_MAGIC_GET;
826
e91d8259 827 if (!mg->mg_ptr) {
e91d8259 828 paren = mg->mg_len;
e91d8259 829 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
a6d0b1b5 830 do_numbuf_fetch:
e91d8259
NC
831 CALLREG_NUMBUF_FETCH(rx,paren,sv);
832 } else {
833 sv_setsv(sv,&PL_sv_undef);
834 }
835 return 0;
836 }
837
838 nextchar = *remaining;
79072805 839 switch (*mg->mg_ptr) {
748a9306 840 case '\001': /* ^A */
f2da823f
FC
841 if (SvOK(PL_bodytarget)) sv_copypv(sv, PL_bodytarget);
842 else sv_setsv(sv, &PL_sv_undef);
125b9982
NT
843 if (SvTAINTED(PL_bodytarget))
844 SvTAINTED_on(sv);
748a9306 845 break;
e5218da5 846 case '\003': /* ^C, ^CHILD_ERROR_NATIVE */
823a54a3 847 if (nextchar == '\0') {
e5218da5
GA
848 sv_setiv(sv, (IV)PL_minus_c);
849 }
823a54a3 850 else if (strEQ(remaining, "HILD_ERROR_NATIVE")) {
e5218da5
GA
851 sv_setiv(sv, (IV)STATUS_NATIVE);
852 }
49460fe6
NIS
853 break;
854
79072805 855 case '\004': /* ^D */
aea4f609 856 sv_setiv(sv, (IV)(PL_debug & DEBUG_MASK));
79072805 857 break;
28f23441 858 case '\005': /* ^E */
6c6eab55
KW
859 if (nextchar != '\0') {
860 if (strEQ(remaining, "NCODING"))
ad2de1b2 861 sv_setsv(sv, _get_encoding());
199670db
FC
862 else if (strEQ(remaining, "_NCODING"))
863 sv_setsv(sv, NULL);
4f4ff3a7 864 break;
6c6eab55 865 }
4f4ff3a7
KW
866
867#if defined(VMS) || defined(OS2) || defined(WIN32)
868# if defined(VMS)
2a99ff86
KW
869 {
870 char msg[255];
871 $DESCRIPTOR(msgdsc,msg);
872 sv_setnv(sv,(NV) vaxc$errno);
873 if (sys$getmsg(vaxc$errno,&msgdsc.dsc$w_length,&msgdsc,0,0) & 1)
874 sv_setpvn(sv,msgdsc.dsc$a_pointer,msgdsc.dsc$w_length);
875 else
876 sv_setpvs(sv,"");
877 }
4b645107 878#elif defined(OS2)
2a99ff86
KW
879 if (!(_emx_env & 0x200)) { /* Under DOS */
880 sv_setnv(sv, (NV)errno);
2c6ee1a7 881 sv_setpv(sv, errno ? my_strerror(errno) : "");
2a99ff86
KW
882 } else {
883 if (errno != errno_isOS2) {
884 const int tmp = _syserrno();
885 if (tmp) /* 2nd call to _syserrno() makes it 0 */
886 Perl_rc = tmp;
887 }
888 sv_setnv(sv, (NV)Perl_rc);
889 sv_setpv(sv, os2error(Perl_rc));
890 }
1534c6f5 891 if (SvOK(sv) && strNE(SvPVX(sv), "")) {
99461a73
KW
892 fixup_errno_string(sv);
893 }
4f4ff3a7 894# elif defined(WIN32)
2a99ff86
KW
895 {
896 const DWORD dwErr = GetLastError();
897 sv_setnv(sv, (NV)dwErr);
898 if (dwErr) {
899 PerlProc_GetOSError(sv, dwErr);
2efab60d 900 fixup_errno_string(sv);
2a99ff86
KW
901 }
902 else
903 sv_setpvs(sv, "");
904 SetLastError(dwErr);
905 }
4f4ff3a7
KW
906# else
907# error Missing code for platform
908# endif
2a99ff86
KW
909 SvRTRIM(sv);
910 SvNOK_on(sv); /* what a wonderful hack! */
911 break;
4f4ff3a7
KW
912#endif /* End of platforms with special handling for $^E; others just fall
913 through to $! */
46f3e16c
KW
914
915 case '!':
916 {
5f1b979d 917 dSAVE_ERRNO;
46f3e16c 918#ifdef VMS
5f1b979d 919 sv_setnv(sv, (NV)((errno == EVMSERR) ? vaxc$errno : errno));
46f3e16c 920#else
5f1b979d 921 sv_setnv(sv, (NV)errno);
46f3e16c
KW
922#endif
923#ifdef OS2
5f1b979d
KW
924 if (errno == errno_isOS2 || errno == errno_isOS2_set)
925 sv_setpv(sv, os2error(Perl_rc));
926 else
46f3e16c 927#endif
5f1b979d
KW
928 if (! errno) {
929 sv_setpvs(sv, "");
46f3e16c 930 }
5f1b979d
KW
931 else {
932
933 /* Strerror can return NULL on some platforms, which will
934 * result in 'sv' not being considered SvOK. The SvNOK_on()
935 * below will cause just the number part to be valid */
2c6ee1a7 936 sv_setpv(sv, my_strerror(errno));
5f1b979d
KW
937 if (SvOK(sv)) {
938 fixup_errno_string(sv);
939 }
940 }
941 RESTORE_ERRNO;
46f3e16c
KW
942 }
943
944 SvRTRIM(sv);
945 SvNOK_on(sv); /* what a wonderful hack! */
946 break;
947
79072805 948 case '\006': /* ^F */
3280af22 949 sv_setiv(sv, (IV)PL_maxsysfd);
79072805 950 break;
9ebf26ad
FR
951 case '\007': /* ^GLOBAL_PHASE */
952 if (strEQ(remaining, "LOBAL_PHASE")) {
953 sv_setpvn(sv, PL_phase_names[PL_phase],
954 strlen(PL_phase_names[PL_phase]));
955 }
956 break;
a0d0e21e 957 case '\010': /* ^H */
3280af22 958 sv_setiv(sv, (IV)PL_hints);
a0d0e21e 959 break;
9d116dd7 960 case '\011': /* ^I */ /* NOT \t in EBCDIC */
120f7abe 961 sv_setpv(sv, PL_inplace); /* Will undefine sv if PL_inplace is NULL */
79072805 962 break;
8561ea1d
FC
963 case '\014': /* ^LAST_FH */
964 if (strEQ(remaining, "AST_FH")) {
965 if (PL_last_in_gv) {
966 assert(isGV_with_GP(PL_last_in_gv));
967 SV_CHECK_THINKFIRST_COW_DROP(sv);
968 prepare_SV_for_RV(sv);
969 SvOK_off(sv);
970 SvRV_set(sv, SvREFCNT_inc_simple_NN(PL_last_in_gv));
971 SvROK_on(sv);
972 sv_rvweaken(sv);
973 }
974 else sv_setsv_nomg(sv, NULL);
975 }
976 break;
ac27b0f5 977 case '\017': /* ^O & ^OPEN */
823a54a3 978 if (nextchar == '\0') {
ac27b0f5 979 sv_setpv(sv, PL_osname);
3511154c
DM
980 SvTAINTED_off(sv);
981 }
823a54a3 982 else if (strEQ(remaining, "PEN")) {
8b850bd5 983 Perl_emulate_cop_io(aTHX_ &PL_compiling, sv);
ac27b0f5 984 }
28f23441 985 break;
9ebf26ad 986 case '\020':
a6d0b1b5 987 sv_setiv(sv, (IV)PL_perldb);
79072805 988 break;
fb73857a 989 case '\023': /* ^S */
a6d0b1b5 990 {
bc177e6b 991 if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING)
0c34ef67 992 SvOK_off(sv);
3280af22 993 else if (PL_in_eval)
6dc8a9e4 994 sv_setiv(sv, PL_in_eval & ~(EVAL_INREQUIRE));
a4268c0a
AMS
995 else
996 sv_setiv(sv, 0);
d58bf5aa 997 }
fb73857a 998 break;
79072805 999 case '\024': /* ^T */
823a54a3 1000 if (nextchar == '\0') {
88e89b8a 1001#ifdef BIG_TIME
7c36658b 1002 sv_setnv(sv, PL_basetime);
88e89b8a 1003#else
7c36658b 1004 sv_setiv(sv, (IV)PL_basetime);
88e89b8a 1005#endif
7c36658b 1006 }
823a54a3 1007 else if (strEQ(remaining, "AINT"))
284167a5
SM
1008 sv_setiv(sv, TAINTING_get
1009 ? (TAINT_WARN_get || PL_unsafe ? -1 : 1)
9aa05f58 1010 : 0);
7c36658b 1011 break;
e07ea26a 1012 case '\025': /* $^UNICODE, $^UTF8LOCALE, $^UTF8CACHE */
823a54a3 1013 if (strEQ(remaining, "NICODE"))
a05d7ebb 1014 sv_setuv(sv, (UV) PL_unicode);
823a54a3 1015 else if (strEQ(remaining, "TF8LOCALE"))
7cebcbc0 1016 sv_setuv(sv, (UV) PL_utf8locale);
e07ea26a
NC
1017 else if (strEQ(remaining, "TF8CACHE"))
1018 sv_setiv(sv, (IV) PL_utf8cache);
fde18df1
JH
1019 break;
1020 case '\027': /* ^W & $^WARNING_BITS */
823a54a3 1021 if (nextchar == '\0')
4438c4b7 1022 sv_setiv(sv, (IV)((PL_dowarn & G_WARN_ON) ? TRUE : FALSE));
823a54a3 1023 else if (strEQ(remaining, "ARNING_BITS")) {
013b78e8 1024 if (PL_compiling.cop_warnings == pWARN_NONE) {
4438c4b7 1025 sv_setpvn(sv, WARN_NONEstring, WARNsize) ;
013b78e8
RGS
1026 }
1027 else if (PL_compiling.cop_warnings == pWARN_STD) {
7e4f0450
FC
1028 sv_setsv(sv, &PL_sv_undef);
1029 break;
013b78e8 1030 }
d3a7d8c7 1031 else if (PL_compiling.cop_warnings == pWARN_ALL) {
75b6c4ca
RGS
1032 /* Get the bit mask for $warnings::Bits{all}, because
1033 * it could have been extended by warnings::register */
4bac9ae4
CS
1034 HV * const bits = get_hv("warnings::Bits", 0);
1035 SV ** const bits_all = bits ? hv_fetchs(bits, "all", FALSE) : NULL;
1036 if (bits_all)
1037 sv_copypv(sv, *bits_all);
1038 else
1039 sv_setpvn(sv, WARN_ALLstring, WARNsize);
ac27b0f5 1040 }
4438c4b7 1041 else {
72dc9ed5
NC
1042 sv_setpvn(sv, (char *) (PL_compiling.cop_warnings + 1),
1043 *PL_compiling.cop_warnings);
ac27b0f5 1044 }
4438c4b7 1045 }
79072805 1046 break;
79072805 1047 case '+':
aaa362c4 1048 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2c7b5d76
DM
1049 paren = RX_LASTPAREN(rx);
1050 if (paren)
1051 goto do_numbuf_fetch;
79072805 1052 }
3280af22 1053 sv_setsv(sv,&PL_sv_undef);
79072805 1054 break;
a01268b5
JH
1055 case '\016': /* ^N */
1056 if (PL_curpm && (rx = PM_GETRE(PL_curpm))) {
2c7b5d76
DM
1057 paren = RX_LASTCLOSEPAREN(rx);
1058 if (paren)
1059 goto do_numbuf_fetch;
a01268b5
JH
1060 }
1061 sv_setsv(sv,&PL_sv_undef);
1062 break;
79072805 1063 case '.':
3280af22 1064 if (GvIO(PL_last_in_gv)) {
357c8808 1065 sv_setiv(sv, (IV)IoLINES(GvIOp(PL_last_in_gv)));
79072805 1066 }
79072805
LW
1067 break;
1068 case '?':
809a5acc 1069 {
809a5acc 1070 sv_setiv(sv, (IV)STATUS_CURRENT);
ff0cee69 1071#ifdef COMPLEX_STATUS
41cb7b2b 1072 SvUPGRADE(sv, SVt_PVLV);
6b88bc9c
GS
1073 LvTARGOFF(sv) = PL_statusvalue;
1074 LvTARGLEN(sv) = PL_statusvalue_vms;
ff0cee69 1075#endif
809a5acc 1076 }
79072805
LW
1077 break;
1078 case '^':
acbe1b9d 1079 if (GvIOp(PL_defoutgv))
099be4f1 1080 s = IoTOP_NAME(GvIOp(PL_defoutgv));
79072805
LW
1081 if (s)
1082 sv_setpv(sv,s);
1083 else {
3280af22 1084 sv_setpv(sv,GvENAME(PL_defoutgv));
cb421d5e 1085 sv_catpvs(sv,"_TOP");
79072805
LW
1086 }
1087 break;
1088 case '~':
acbe1b9d 1089 if (GvIOp(PL_defoutgv))
0daa599b 1090 s = IoFMT_NAME(GvIOp(PL_defoutgv));
79072805 1091 if (!s)
3280af22 1092 s = GvENAME(PL_defoutgv);
79072805
LW
1093 sv_setpv(sv,s);
1094 break;
79072805 1095 case '=':
099be4f1 1096 if (GvIO(PL_defoutgv))
0daa599b 1097 sv_setiv(sv, (IV)IoPAGE_LEN(GvIOp(PL_defoutgv)));
79072805
LW
1098 break;
1099 case '-':
099be4f1 1100 if (GvIO(PL_defoutgv))
0daa599b 1101 sv_setiv(sv, (IV)IoLINES_LEFT(GvIOp(PL_defoutgv)));
79072805
LW
1102 break;
1103 case '%':
099be4f1 1104 if (GvIO(PL_defoutgv))
0daa599b 1105 sv_setiv(sv, (IV)IoPAGE(GvIOp(PL_defoutgv)));
79072805 1106 break;
79072805
LW
1107 case ':':
1108 break;
1109 case '/':
1110 break;
1111 case '[':
e1dccc0d 1112 sv_setiv(sv, 0);
79072805
LW
1113 break;
1114 case '|':
099be4f1 1115 if (GvIO(PL_defoutgv))
0daa599b 1116 sv_setiv(sv, (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0 );
79072805 1117 break;
79072805 1118 case '\\':
b2ce0fda 1119 if (PL_ors_sv)
f28098ff 1120 sv_copypv(sv, PL_ors_sv);
4bac9ae4
CS
1121 else
1122 sv_setsv(sv, &PL_sv_undef);
79072805 1123 break;
0e219455 1124 case '$': /* $$ */
9cdac2a2
FC
1125 {
1126 IV const pid = (IV)PerlProc_getpid();
19db9fb7 1127 if (isGV(mg->mg_obj) || SvIV(mg->mg_obj) != pid) {
9cdac2a2
FC
1128 /* never set manually, or at least not since last fork */
1129 sv_setiv(sv, pid);
19db9fb7
Z
1130 /* never unsafe, even if reading in a tainted expression */
1131 SvTAINTED_off(sv);
1132 }
9cdac2a2
FC
1133 /* else a value has been assigned manually, so do nothing */
1134 }
0e219455 1135 break;
79072805 1136 case '<':
dfff4baf 1137 sv_setuid(sv, PerlProc_getuid());
79072805
LW
1138 break;
1139 case '>':
dfff4baf 1140 sv_setuid(sv, PerlProc_geteuid());
79072805
LW
1141 break;
1142 case '(':
dfff4baf 1143 sv_setgid(sv, PerlProc_getgid());
79072805
LW
1144 goto add_groups;
1145 case ')':
dfff4baf 1146 sv_setgid(sv, PerlProc_getegid());
79072805 1147 add_groups:
79072805 1148#ifdef HAS_GETGROUPS
79072805 1149 {
57d7c65e 1150 Groups_t *gary = NULL;
375ed12a
JH
1151 I32 i;
1152 I32 num_groups = getgroups(0, gary);
1153 if (num_groups > 0) {
1154 Newx(gary, num_groups, Groups_t);
1155 num_groups = getgroups(num_groups, gary);
1156 for (i = 0; i < num_groups; i++)
1157 Perl_sv_catpvf(aTHX_ sv, " %"IVdf, (IV)gary[i]);
1158 Safefree(gary);
1159 }
79072805 1160 }
155aba94 1161 (void)SvIOK_on(sv); /* what a wonderful hack! */
cd70abae 1162#endif
79072805 1163 break;
79072805
LW
1164 case '0':
1165 break;
1166 }
a0d0e21e 1167 return 0;
79072805
LW
1168}
1169
1170int
864dbfa3 1171Perl_magic_getuvar(pTHX_ SV *sv, MAGIC *mg)
79072805 1172{
8772537c 1173 struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
79072805 1174
7918f24d
NC
1175 PERL_ARGS_ASSERT_MAGIC_GETUVAR;
1176
79072805 1177 if (uf && uf->uf_val)
24f81a43 1178 (*uf->uf_val)(aTHX_ uf->uf_index, sv);
79072805
LW
1179 return 0;
1180}
1181
1182int
864dbfa3 1183Perl_magic_setenv(pTHX_ SV *sv, MAGIC *mg)
79072805 1184{
9ae3433d 1185 STRLEN len = 0, klen;
12033064 1186 const char * const key = MgPV_const(mg,klen);
888a67f6 1187 const char *s = "";
1e422769 1188
7918f24d
NC
1189 PERL_ARGS_ASSERT_MAGIC_SETENV;
1190
613c63b4 1191 SvGETMAGIC(sv);
12033064 1192 if (SvOK(sv)) {
613c63b4
CS
1193 /* defined environment variables are byte strings; unfortunately
1194 there is no SvPVbyte_force_nomg(), so we must do this piecewise */
1195 (void)SvPV_force_nomg_nolen(sv);
1196 sv_utf8_downgrade(sv, /* fail_ok */ TRUE);
1197 if (SvUTF8(sv)) {
1198 Perl_ck_warner_d(aTHX_ packWARN(WARN_UTF8), "Wide character in %s", "setenv");
1199 SvUTF8_off(sv);
1200 }
1201 s = SvPVX(sv);
1202 len = SvCUR(sv);
12033064
CS
1203 }
1204 my_setenv(key, s); /* does the deed */
1205
a0d0e21e
LW
1206#ifdef DYNAMIC_ENV_FETCH
1207 /* We just undefd an environment var. Is a replacement */
1208 /* waiting in the wings? */
1209 if (!len) {
6bd66ee9 1210 SV ** const valp = hv_fetch(GvHVn(PL_envgv), key, klen, FALSE);
fabdb6c0 1211 if (valp)
4ab59fcc 1212 s = SvOK(*valp) ? SvPV_const(*valp, len) : "";
a0d0e21e
LW
1213 }
1214#endif
1e422769 1215
39e571d4 1216#if !defined(OS2) && !defined(AMIGAOS) && !defined(WIN32) && !defined(MSDOS)
79072805
LW
1217 /* And you'll never guess what the dog had */
1218 /* in its mouth... */
284167a5 1219 if (TAINTING_get) {
1e422769
PP
1220 MgTAINTEDDIR_off(mg);
1221#ifdef VMS
6bd66ee9 1222 if (s && klen == 8 && strEQ(key, "DCL$PATH")) {
b8ffc8df 1223 char pathbuf[256], eltbuf[256], *cp, *elt;
1e422769
PP
1224 int i = 0, j = 0;
1225
6fca0082 1226 my_strlcpy(eltbuf, s, sizeof(eltbuf));
b8ffc8df 1227 elt = eltbuf;
1e422769
PP
1228 do { /* DCL$PATH may be a search list */
1229 while (1) { /* as may dev portion of any element */
1230 if ( ((cp = strchr(elt,'[')) || (cp = strchr(elt,'<'))) ) {
1231 if ( *(cp+1) == '.' || *(cp+1) == '-' ||
1232 cando_by_name(S_IWUSR,0,elt) ) {
1233 MgTAINTEDDIR_on(mg);
1234 return 0;
1235 }
1236 }
bd61b366 1237 if ((cp = strchr(elt, ':')) != NULL)
1e422769
PP
1238 *cp = '\0';
1239 if (my_trnlnm(elt, eltbuf, j++))
1240 elt = eltbuf;
1241 else
1242 break;
1243 }
1244 j = 0;
1245 } while (my_trnlnm(s, pathbuf, i++) && (elt = pathbuf));
1246 }
1247#endif /* VMS */
12033064 1248 if (s && klen == 4 && strEQ(key,"PATH")) {
8772537c 1249 const char * const strend = s + len;
463ee0b2
LW
1250
1251 while (s < strend) {
96827780 1252 char tmpbuf[256];
c623ac67 1253 Stat_t st;
5f74f29c 1254 I32 i;
f5a63d97
AL
1255#ifdef VMS /* Hmm. How do we get $Config{path_sep} from C? */
1256 const char path_sep = '|';
1257#else
1258 const char path_sep = ':';
1259#endif
96827780 1260 s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf,
427eaa01 1261 s, strend, path_sep, &i);
463ee0b2 1262 s++;
bb7a0f54 1263 if (i >= (I32)sizeof tmpbuf /* too long -- assume the worst */
326b5008
CB
1264#ifdef VMS
1265 || !strchr(tmpbuf, ':') /* no colon thus no device name -- assume relative path */
1266#else
1267 || *tmpbuf != '/' /* no starting slash -- assume relative path */
1268#endif
c6ed36e1 1269 || (PerlLIO_stat(tmpbuf, &st) == 0 && (st.st_mode & 2)) ) {
8990e307 1270 MgTAINTEDDIR_on(mg);
1e422769
PP
1271 return 0;
1272 }
463ee0b2 1273 }
79072805
LW
1274 }
1275 }
39e571d4 1276#endif /* neither OS2 nor AMIGAOS nor WIN32 nor MSDOS */
1e422769 1277
79072805
LW
1278 return 0;
1279}
1280
1281int
864dbfa3 1282Perl_magic_clearenv(pTHX_ SV *sv, MAGIC *mg)
85e6fe83 1283{
7918f24d 1284 PERL_ARGS_ASSERT_MAGIC_CLEARENV;
8772537c 1285 PERL_UNUSED_ARG(sv);
bd61b366 1286 my_setenv(MgPV_nolen_const(mg),NULL);
85e6fe83
LW
1287 return 0;
1288}
1289
88e89b8a 1290int
864dbfa3 1291Perl_magic_set_all_env(pTHX_ SV *sv, MAGIC *mg)
fb73857a 1292{
7918f24d 1293 PERL_ARGS_ASSERT_MAGIC_SET_ALL_ENV;
65e66c80 1294 PERL_UNUSED_ARG(mg);
b0269e46 1295#if defined(VMS)
cea2e8a9 1296 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
fb73857a 1297#else
3280af22 1298 if (PL_localizing) {
fb73857a 1299 HE* entry;
b0269e46 1300 my_clearenv();
85fbaab2
NC
1301 hv_iterinit(MUTABLE_HV(sv));
1302 while ((entry = hv_iternext(MUTABLE_HV(sv)))) {
fb73857a
PP
1303 I32 keylen;
1304 my_setenv(hv_iterkey(entry, &keylen),
85fbaab2 1305 SvPV_nolen_const(hv_iterval(MUTABLE_HV(sv), entry)));
fb73857a
PP
1306 }
1307 }
1308#endif
1309 return 0;
1310}
1311
1312int
864dbfa3 1313Perl_magic_clear_all_env(pTHX_ SV *sv, MAGIC *mg)
66b1d557 1314{
7918f24d 1315 PERL_ARGS_ASSERT_MAGIC_CLEAR_ALL_ENV;
8772537c
AL
1316 PERL_UNUSED_ARG(sv);
1317 PERL_UNUSED_ARG(mg);
b0269e46
AB
1318#if defined(VMS)
1319 Perl_die(aTHX_ "Can't make list assignment to %%ENV on this system");
1320#else
1321 my_clearenv();
1322#endif
3e3baf6d 1323 return 0;
66b1d557
HM
1324}
1325
64ca3a65 1326#ifndef PERL_MICRO
2d4fcd5e
AJ
1327#ifdef HAS_SIGPROCMASK
1328static void
1329restore_sigmask(pTHX_ SV *save_sv)
1330{
0bd48802 1331 const sigset_t * const ossetp = (const sigset_t *) SvPV_nolen_const( save_sv );
f5a63d97 1332 (void)sigprocmask(SIG_SETMASK, ossetp, NULL);
2d4fcd5e
AJ
1333}
1334#endif
66b1d557 1335int
864dbfa3 1336Perl_magic_getsig(pTHX_ SV *sv, MAGIC *mg)
88e89b8a 1337{
88e89b8a 1338 /* Are we fetching a signal entry? */
708854f2 1339 int i = (I16)mg->mg_private;
7918f24d
NC
1340
1341 PERL_ARGS_ASSERT_MAGIC_GETSIG;
1342
708854f2 1343 if (!i) {
84c7b88c
BF
1344 STRLEN siglen;
1345 const char * sig = MgPV_const(mg, siglen);
1346 mg->mg_private = i = whichsig_pvn(sig, siglen);
708854f2
NC
1347 }
1348
e02bfb16 1349 if (i > 0) {
22c35a8c
GS
1350 if(PL_psig_ptr[i])
1351 sv_setsv(sv,PL_psig_ptr[i]);
88e89b8a 1352 else {
46da273f 1353 Sighandler_t sigstate = rsignal_state(i);
23ada85b 1354#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
46da273f
AL
1355 if (PL_sig_handlers_initted && PL_sig_ignoring[i])
1356 sigstate = SIG_IGN;
2e34cc90
CL
1357#endif
1358#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
46da273f
AL
1359 if (PL_sig_handlers_initted && PL_sig_defaulting[i])
1360 sigstate = SIG_DFL;
85b332e2 1361#endif
88e89b8a 1362 /* cache state so we don't fetch it again */
8aad04aa 1363 if(sigstate == (Sighandler_t) SIG_IGN)
6502358f 1364 sv_setpvs(sv,"IGNORE");
88e89b8a 1365 else
3280af22 1366 sv_setsv(sv,&PL_sv_undef);
46da273f 1367 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
88e89b8a
PP
1368 SvTEMP_off(sv);
1369 }
1370 }
1371 return 0;
1372}
1373int
864dbfa3 1374Perl_magic_clearsig(pTHX_ SV *sv, MAGIC *mg)
88e89b8a 1375{
7918f24d 1376 PERL_ARGS_ASSERT_MAGIC_CLEARSIG;
179c85a2 1377
38a124f0 1378 magic_setsig(NULL, mg);
179c85a2 1379 return sv_unmagic(sv, mg->mg_type);
88e89b8a 1380}
3d37d572 1381
0a8e0eff 1382Signal_t
8aad04aa 1383#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
b6455c53 1384Perl_csighandler(int sig, siginfo_t *sip PERL_UNUSED_DECL, void *uap PERL_UNUSED_DECL)
8aad04aa 1385#else
0a8e0eff 1386Perl_csighandler(int sig)
8aad04aa 1387#endif
0a8e0eff 1388{
1018e26f
NIS
1389#ifdef PERL_GET_SIG_CONTEXT
1390 dTHXa(PERL_GET_SIG_CONTEXT);
1391#else
85b332e2
CL
1392 dTHX;
1393#endif
ffb6256b
JH
1394#if defined(__cplusplus) && defined(__GNUC__)
1395 /* g++ doesn't support PERL_UNUSED_DECL, so the sip and uap
1396 * parameters would be warned about. */
1397 PERL_UNUSED_ARG(sip);
1398 PERL_UNUSED_ARG(uap);
1399#endif
23ada85b 1400#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
5c1546dc 1401 (void) rsignal(sig, PL_csighandlerp);
27da23d5 1402 if (PL_sig_ignoring[sig]) return;
85b332e2 1403#endif
2e34cc90 1404#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
27da23d5 1405 if (PL_sig_defaulting[sig])
2e34cc90
CL
1406#ifdef KILL_BY_SIGPRC
1407 exit((Perl_sig_to_vmscondition(sig)&STS$M_COND_ID)|STS$K_SEVERE|STS$M_INHIB_MSG);
1408#else
1409 exit(1);
1410#endif
1411#endif
406878dd 1412 if (
853d2c32
RGS
1413#ifdef SIGILL
1414 sig == SIGILL ||
1415#endif
1416#ifdef SIGBUS
1417 sig == SIGBUS ||
1418#endif
1419#ifdef SIGSEGV
1420 sig == SIGSEGV ||
1421#endif
1422 (PL_signals & PERL_SIGNALS_UNSAFE_FLAG))
4ffa73a3 1423 /* Call the perl level handler now--
31c91b43 1424 * with risk we may be in malloc() or being destructed etc. */
6e324d09 1425#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
80626cf1 1426 (*PL_sighandlerp)(sig, NULL, NULL);
6e324d09
CB
1427#else
1428 (*PL_sighandlerp)(sig);
92807b6d 1429#endif
406878dd 1430 else {
31c91b43 1431 if (!PL_psig_pend) return;
406878dd
GA
1432 /* Set a flag to say this signal is pending, that is awaiting delivery after
1433 * the current Perl opcode completes */
1434 PL_psig_pend[sig]++;
1435
1436#ifndef SIG_PENDING_DIE_COUNT
1437# define SIG_PENDING_DIE_COUNT 120
1438#endif
fe13d51d 1439 /* Add one to say _a_ signal is pending */
406878dd
GA
1440 if (++PL_sig_pending >= SIG_PENDING_DIE_COUNT)
1441 Perl_croak(aTHX_ "Maximal count of pending signals (%lu) exceeded",
1442 (unsigned long)SIG_PENDING_DIE_COUNT);
1443 }
0a8e0eff
NIS
1444}
1445
2e34cc90
CL
1446#if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
1447void
1448Perl_csighandler_init(void)
1449{
1450 int sig;
27da23d5 1451 if (PL_sig_handlers_initted) return;
2e34cc90
CL
1452
1453 for (sig = 1; sig < SIG_SIZE; sig++) {
1454#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
218fdd94 1455 dTHX;
27da23d5 1456 PL_sig_defaulting[sig] = 1;
5c1546dc 1457 (void) rsignal(sig, PL_csighandlerp);
2e34cc90
CL
1458#endif
1459#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
27da23d5 1460 PL_sig_ignoring[sig] = 0;
2e34cc90
CL
1461#endif
1462 }
27da23d5 1463 PL_sig_handlers_initted = 1;
2e34cc90
CL
1464}
1465#endif
1466
7fe50b8b
LT
1467#if defined HAS_SIGPROCMASK
1468static void
1469unblock_sigmask(pTHX_ void* newset)
1470{
dc3bf405 1471 PERL_UNUSED_CONTEXT;
7fe50b8b
LT
1472 sigprocmask(SIG_UNBLOCK, (sigset_t*)newset, NULL);
1473}
1474#endif
1475
0a8e0eff
NIS
1476void
1477Perl_despatch_signals(pTHX)
1478{
1479 int sig;
1480 PL_sig_pending = 0;
1481 for (sig = 1; sig < SIG_SIZE; sig++) {
1482 if (PL_psig_pend[sig]) {
d0166017 1483 dSAVE_ERRNO;
7fe50b8b 1484#ifdef HAS_SIGPROCMASK
55534442
LT
1485 /* From sigaction(2) (FreeBSD man page):
1486 * | Signal routines normally execute with the signal that
1487 * | caused their invocation blocked, but other signals may
1488 * | yet occur.
1489 * Emulation of this behavior (from within Perl) is enabled
1490 * using sigprocmask
1491 */
1492 int was_blocked;
1493 sigset_t newset, oldset;
1494
1495 sigemptyset(&newset);
1496 sigaddset(&newset, sig);
1497 sigprocmask(SIG_BLOCK, &newset, &oldset);
1498 was_blocked = sigismember(&oldset, sig);
7fe50b8b
LT
1499 if (!was_blocked) {
1500 SV* save_sv = newSVpvn((char *)(&newset), sizeof(sigset_t));
1501 ENTER;
1502 SAVEFREESV(save_sv);
1503 SAVEDESTRUCTOR_X(unblock_sigmask, SvPV_nolen(save_sv));
1504 }
55534442 1505#endif
25da4428 1506 PL_psig_pend[sig] = 0;
6e324d09 1507#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
80626cf1 1508 (*PL_sighandlerp)(sig, NULL, NULL);
6e324d09
CB
1509#else
1510 (*PL_sighandlerp)(sig);
92807b6d 1511#endif
7fe50b8b 1512#ifdef HAS_SIGPROCMASK
55534442 1513 if (!was_blocked)
7fe50b8b 1514 LEAVE;
55534442 1515#endif
d0166017 1516 RESTORE_ERRNO;
0a8e0eff
NIS
1517 }
1518 }
1519}
1520
38a124f0 1521/* sv of NULL signifies that we're acting as magic_clearsig. */
85e6fe83 1522int
864dbfa3 1523Perl_magic_setsig(pTHX_ SV *sv, MAGIC *mg)
79072805 1524{
27da23d5 1525 dVAR;
79072805 1526 I32 i;
cbbf8932 1527 SV** svp = NULL;
2d4fcd5e
AJ
1528 /* Need to be careful with SvREFCNT_dec(), because that can have side
1529 * effects (due to closures). We must make sure that the new disposition
1530 * is in place before it is called.
1531 */
cbbf8932 1532 SV* to_dec = NULL;
e72dc28c 1533 STRLEN len;
2d4fcd5e
AJ
1534#ifdef HAS_SIGPROCMASK
1535 sigset_t set, save;
1536 SV* save_sv;
1537#endif
eb578fdb 1538 const char *s = MgPV_const(mg,len);
7918f24d
NC
1539
1540 PERL_ARGS_ASSERT_MAGIC_SETSIG;
1541
748a9306 1542 if (*s == '_') {
84c7b88c 1543 if (memEQs(s, len, "__DIE__"))
3280af22 1544 svp = &PL_diehook;
84c7b88c 1545 else if (memEQs(s, len, "__WARN__")
38a124f0
NC
1546 && (sv ? 1 : PL_warnhook != PERL_WARNHOOK_FATAL)) {
1547 /* Merge the existing behaviours, which are as follows:
1548 magic_setsig, we always set svp to &PL_warnhook
1549 (hence we always change the warnings handler)
1550 For magic_clearsig, we don't change the warnings handler if it's
1551 set to the &PL_warnhook. */
3280af22 1552 svp = &PL_warnhook;
84c7b88c
BF
1553 } else if (sv) {
1554 SV *tmp = sv_newmortal();
1555 Perl_croak(aTHX_ "No such hook: %s",
1556 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1557 }
748a9306 1558 i = 0;
38a124f0 1559 if (svp && *svp) {
9289f461
RGS
1560 if (*svp != PERL_WARNHOOK_FATAL)
1561 to_dec = *svp;
cbbf8932 1562 *svp = NULL;
4633a7c4 1563 }
748a9306
LW
1564 }
1565 else {
708854f2
NC
1566 i = (I16)mg->mg_private;
1567 if (!i) {
84c7b88c 1568 i = whichsig_pvn(s, len); /* ...no, a brick */
58a26b12 1569 mg->mg_private = (U16)i;
708854f2 1570 }
86d86cad 1571 if (i <= 0) {
84c7b88c
BF
1572 if (sv) {
1573 SV *tmp = sv_newmortal();
1574 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL), "No such signal: SIG%s",
1575 pv_pretty(tmp, s, len, 0, NULL, NULL, 0));
1576 }
748a9306
LW
1577 return 0;
1578 }
2d4fcd5e
AJ
1579#ifdef HAS_SIGPROCMASK
1580 /* Avoid having the signal arrive at a bad time, if possible. */
1581 sigemptyset(&set);
1582 sigaddset(&set,i);
1583 sigprocmask(SIG_BLOCK, &set, &save);
1584 ENTER;
9ff8e806 1585 save_sv = newSVpvn((char *)(&save), sizeof(sigset_t));
2d4fcd5e
AJ
1586 SAVEFREESV(save_sv);
1587 SAVEDESTRUCTOR_X(restore_sigmask, save_sv);
1588#endif
1589 PERL_ASYNC_CHECK();
2e34cc90 1590#if defined(FAKE_PERSISTENT_SIGNAL_HANDLERS) || defined(FAKE_DEFAULT_SIGNAL_HANDLERS)
27da23d5 1591 if (!PL_sig_handlers_initted) Perl_csighandler_init();
2e34cc90 1592#endif
23ada85b 1593#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
27da23d5 1594 PL_sig_ignoring[i] = 0;
85b332e2 1595#endif
2e34cc90 1596#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
27da23d5 1597 PL_sig_defaulting[i] = 0;
2e34cc90 1598#endif
2d4fcd5e 1599 to_dec = PL_psig_ptr[i];
38a124f0
NC
1600 if (sv) {
1601 PL_psig_ptr[i] = SvREFCNT_inc_simple_NN(sv);
1602 SvTEMP_off(sv); /* Make sure it doesn't go away on us */
79fd3822
NC
1603
1604 /* Signals don't change name during the program's execution, so once
1605 they're cached in the appropriate slot of PL_psig_name, they can
1606 stay there.
1607
1608 Ideally we'd find some way of making SVs at (C) compile time, or
1609 at least, doing most of the work. */
1610 if (!PL_psig_name[i]) {
1611 PL_psig_name[i] = newSVpvn(s, len);
1612 SvREADONLY_on(PL_psig_name[i]);
1613 }
38a124f0 1614 } else {
79fd3822 1615 SvREFCNT_dec(PL_psig_name[i]);
38a124f0
NC
1616 PL_psig_name[i] = NULL;
1617 PL_psig_ptr[i] = NULL;
1618 }
748a9306 1619 }
38a124f0 1620 if (sv && (isGV_with_GP(sv) || SvROK(sv))) {
2d4fcd5e 1621 if (i) {
5c1546dc 1622 (void)rsignal(i, PL_csighandlerp);
2d4fcd5e 1623 }
748a9306 1624 else
b37c2d43 1625 *svp = SvREFCNT_inc_simple_NN(sv);
38a124f0 1626 } else {
9dfa190b
NC
1627 if (sv && SvOK(sv)) {
1628 s = SvPV_force(sv, len);
1629 } else {
1630 sv = NULL;
1631 }
84c7b88c 1632 if (sv && memEQs(s, len,"IGNORE")) {
9dfa190b 1633 if (i) {
23ada85b 1634#ifdef FAKE_PERSISTENT_SIGNAL_HANDLERS
9dfa190b
NC
1635 PL_sig_ignoring[i] = 1;
1636 (void)rsignal(i, PL_csighandlerp);
85b332e2 1637#else
9dfa190b 1638 (void)rsignal(i, (Sighandler_t) SIG_IGN);
85b332e2 1639#endif
9dfa190b 1640 }
2d4fcd5e 1641 }
84c7b88c 1642 else if (!sv || memEQs(s, len,"DEFAULT") || !len) {
9dfa190b 1643 if (i) {
2e34cc90 1644#ifdef FAKE_DEFAULT_SIGNAL_HANDLERS
9dfa190b
NC
1645 PL_sig_defaulting[i] = 1;
1646 (void)rsignal(i, PL_csighandlerp);
2e34cc90 1647#else
9dfa190b 1648 (void)rsignal(i, (Sighandler_t) SIG_DFL);
2e34cc90 1649#endif
9dfa190b
NC
1650 }
1651 }
1652 else {
1653 /*
1654 * We should warn if HINT_STRICT_REFS, but without
1655 * access to a known hint bit in a known OP, we can't
1656 * tell whether HINT_STRICT_REFS is in force or not.
1657 */
1658 if (!strchr(s,':') && !strchr(s,'\''))
1659 Perl_sv_insert_flags(aTHX_ sv, 0, 0, STR_WITH_LEN("main::"),
1660 SV_GMAGIC);
1661 if (i)
1662 (void)rsignal(i, PL_csighandlerp);
1663 else
1664 *svp = SvREFCNT_inc_simple_NN(sv);
136e0459 1665 }
748a9306 1666 }
9dfa190b 1667
2d4fcd5e
AJ
1668#ifdef HAS_SIGPROCMASK
1669 if(i)
1670 LEAVE;
1671#endif
ef8d46e8 1672 SvREFCNT_dec(to_dec);
79072805
LW
1673 return 0;
1674}
64ca3a65 1675#endif /* !PERL_MICRO */
79072805
LW
1676
1677int
864dbfa3 1678Perl_magic_setisa(pTHX_ SV *sv, MAGIC *mg)
79072805 1679{
7918f24d 1680 PERL_ARGS_ASSERT_MAGIC_SETISA;
8772537c 1681 PERL_UNUSED_ARG(sv);
e1a479c5 1682
89c14e2e 1683 /* Skip _isaelem because _isa will handle it shortly */
354b0578 1684 if (PL_delaymagic & DM_ARRAY_ISA && mg->mg_type == PERL_MAGIC_isaelem)
89c14e2e
BB
1685 return 0;
1686
0e446081 1687 return magic_clearisa(NULL, mg);
463ee0b2
LW
1688}
1689
0e446081 1690/* sv of NULL signifies that we're acting as magic_setisa. */
463ee0b2 1691int
52b45067
RD
1692Perl_magic_clearisa(pTHX_ SV *sv, MAGIC *mg)
1693{
52b45067 1694 HV* stash;
7918f24d
NC
1695 PERL_ARGS_ASSERT_MAGIC_CLEARISA;
1696
52b45067 1697 /* Bail out if destruction is going on */
627364f1 1698 if(PL_phase == PERL_PHASE_DESTRUCT) return 0;
52b45067 1699
0e446081
NC
1700 if (sv)
1701 av_clear(MUTABLE_AV(sv));
52b45067 1702
6624142a
FC
1703 if (SvTYPE(mg->mg_obj) != SVt_PVGV && SvSMAGICAL(mg->mg_obj))
1704 /* This occurs with setisa_elem magic, which calls this
1705 same function. */
1706 mg = mg_find(mg->mg_obj, PERL_MAGIC_isa);
1707
316ebaf2 1708 assert(mg);
6624142a
FC
1709 if (SvTYPE(mg->mg_obj) == SVt_PVAV) { /* multiple stashes */
1710 SV **svp = AvARRAY((AV *)mg->mg_obj);
1711 I32 items = AvFILLp((AV *)mg->mg_obj) + 1;
1712 while (items--) {
1713 stash = GvSTASH((GV *)*svp++);
1714 if (stash && HvENAME(stash)) mro_isa_changed_in(stash);
1715 }
1716
1717 return 0;
1718 }
1719
52b45067 1720 stash = GvSTASH(
6624142a 1721 (const GV *)mg->mg_obj
52b45067
RD
1722 );
1723
00169e2c
FC
1724 /* The stash may have been detached from the symbol table, so check its
1725 name before doing anything. */
1726 if (stash && HvENAME_get(stash))
5562fa71 1727 mro_isa_changed_in(stash);
52b45067
RD
1728
1729 return 0;
1730}
1731
1732int
864dbfa3 1733Perl_magic_getnkeys(pTHX_ SV *sv, MAGIC *mg)
6ff81951 1734{
85fbaab2 1735 HV * const hv = MUTABLE_HV(LvTARG(sv));
6ff81951 1736 I32 i = 0;
7918f24d
NC
1737
1738 PERL_ARGS_ASSERT_MAGIC_GETNKEYS;
8772537c 1739 PERL_UNUSED_ARG(mg);
7719e241 1740
6ff81951 1741 if (hv) {
497b47a8 1742 (void) hv_iterinit(hv);
ad64d0ec 1743 if (! SvTIED_mg((const SV *)hv, PERL_MAGIC_tied))
1b95d04f 1744 i = HvUSEDKEYS(hv);
497b47a8
JH
1745 else {
1746 while (hv_iternext(hv))
1747 i++;
1748 }
6ff81951
GS
1749 }
1750
1751 sv_setiv(sv, (IV)i);
1752 return 0;
1753}
1754
1755int
864dbfa3 1756Perl_magic_setnkeys(pTHX_ SV *sv, MAGIC *mg)
946ec16e 1757{
7918f24d 1758 PERL_ARGS_ASSERT_MAGIC_SETNKEYS;
8772537c 1759 PERL_UNUSED_ARG(mg);
946ec16e 1760 if (LvTARG(sv)) {
85fbaab2 1761 hv_ksplit(MUTABLE_HV(LvTARG(sv)), SvIV(sv));
946ec16e
PP
1762 }
1763 return 0;
ac27b0f5 1764}
946ec16e 1765
efaf3674
DM
1766/*
1767=for apidoc magic_methcall
1768
1769Invoke a magic method (like FETCH).
1770
2baee27b
FC
1771C<sv> and C<mg> are the tied thingy and the tie magic.
1772
1773C<meth> is the name of the method to call.
1774
1775C<argc> is the number of args (in addition to $self) to pass to the method.
1776
1777The C<flags> can be:
1778
1779 G_DISCARD invoke method with G_DISCARD flag and don't
1780 return a value
1781 G_UNDEF_FILL fill the stack with argc pointers to
1782 PL_sv_undef
1783
1784The arguments themselves are any values following the C<flags> argument.
efaf3674
DM
1785
1786Returns the SV (if any) returned by the method, or NULL on failure.
1787
1788
1789=cut
1790*/
1791
1792SV*
36925d9e 1793Perl_magic_methcall(pTHX_ SV *sv, const MAGIC *mg, SV *meth, U32 flags,
046b0c7d 1794 U32 argc, ...)
a0d0e21e
LW
1795{
1796 dSP;
efaf3674 1797 SV* ret = NULL;
463ee0b2 1798
7918f24d
NC
1799 PERL_ARGS_ASSERT_MAGIC_METHCALL;
1800
efaf3674 1801 ENTER;
d1d7a15d
NC
1802
1803 if (flags & G_WRITING_TO_STDERR) {
1804 SAVETMPS;
1805
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
PP
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
PP
2350 /* somebody else defined it for us */
2351 SvREFCNT_dec(LvTARG(sv));
b37c2d43 2352 LvTARG(sv) = SvREFCNT_inc_simple_NN(targ);
68dc0745
PP
2353 LvTARGLEN(sv) = 0;
2354 SvREFCNT_dec(mg->mg_obj);
a0714e2c 2355 mg->mg_obj = NULL;
68dc0745
PP
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
PP
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
PP
2379 vivify_defelem(sv);
2380 if (LvTARG(sv)) {
5f05dabc 2381 sv_setsv(LvTARG(sv), sv);
68dc0745
PP
2382 SvSETMAGIC(LvTARG(sv));
2383 }
5f05dabc
PP
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
PP
2415 }
2416 }
b37c2d43 2417 SvREFCNT_inc_simple_void(value);
68dc0745
PP
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
PP
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
PP
2481 * and vanished with a faint plop.
2482 */
96a5add6 2483 PERL_UNUSED_CONTEXT;
8772537c 2484 PERL_UNUSED_ARG(sv);
7a4c00b4
PP
2485 if (mg->mg_ptr) {
2486 Safefree(mg->mg_ptr);
2487 mg->mg_ptr = NULL;
565764a8 2488 mg->mg_len = -1;
7a4c00b4 2489 }
bbce6d69
PP
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:
2550 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 }
72dc9ed5 2777 /* Yuck. I can't see how to abstract this: */
2f3f0b56
KW
2778 else if (isWARN_on(
2779 ((STRLEN *)SvPV_nolen_const(sv)) - 1,
2780 WARN_ALL)
2781 && !any_fatals)
2782 {
4243c432
NC
2783 if (!specialWARN(PL_compiling.cop_warnings))
2784 PerlMemShared_free(PL_compiling.cop_warnings);
f4fc7782
JH
2785 PL_compiling.cop_warnings = pWARN_ALL;
2786 PL_dowarn |= G_WARN_ONCE ;
727405f8 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 {
ee0ba734 2871 /* diag_listed_as: Setting $/ to %s reference is forbidden */
a48e4205
FC
2872 Perl_croak(aTHX_ "Setting $/ to a%s %s reference is forbidden",
2873 *reftype == 'A' ? "n" : "", reftype);
1ab48e3a
YO
2874 }
2875 }
b3a2acfa 2876 SvREFCNT_dec(PL_rs);
1ab48e3a 2877 PL_rs = newSVsv(tmpsv);
b3a2acfa 2878 }
79072805
LW
2879 break;
2880 case '\\':
ef8d46e8 2881 SvREFCNT_dec(PL_ors_sv);
6bc2995b 2882 if (SvOK(sv)) {
7889fe52 2883 PL_ors_sv = newSVsv(sv);
009c130f 2884 }
e3c19b7b 2885 else {
a0714e2c 2886 PL_ors_sv = NULL;
e3c19b7b 2887 }
79072805 2888 break;
7d69d4a6
FC
2889 case '[':
2890 if (SvIV(sv) != 0)
2891 Perl_croak(aTHX_ "Assigning non-zero to $[ is no longer possible");
2892 break;
79072805 2893 case '?':
ff0cee69 2894#ifdef COMPLEX_STATUS
6b88bc9c 2895 if (PL_localizing == 2) {
41cb7b2b 2896 SvUPGRADE(sv, SVt_PVLV);
6b88bc9c
GS
2897 PL_statusvalue = LvTARGOFF(sv);
2898 PL_statusvalue_vms = LvTARGLEN(sv);
ff0cee69
PP
2899 }
2900 else
2901#endif
2902#ifdef VMSISH_STATUS
2903 if (VMSISH_STATUS)
fb38d079 2904 STATUS_NATIVE_CHILD_SET((U32)SvIV(sv));
ff0cee69
PP
2905 else
2906#endif
38ab35f8 2907 STATUS_UNIX_EXIT_SET(SvIV(sv));
79072805
LW
2908 break;
2909 case '!':
93189314
JH
2910 {
2911#ifdef VMS
2912# define PERL_VMS_BANG vaxc$errno
2913#else
2914# define PERL_VMS_BANG 0
2915#endif
27329181 2916#if defined(WIN32) && ! defined(UNDER_CE)
c9beaf97
SH
2917 SETERRNO(win32_get_errno(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0),
2918 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
2919#else
91487cfc 2920 SETERRNO(SvIOK(sv) ? SvIVX(sv) : SvOK(sv) ? sv_2iv(sv) : 0,
93189314 2921 (SvIV(sv) == EVMSERR) ? 4 : PERL_VMS_BANG);
c9beaf97 2922#endif
93189314 2923 }
79072805
LW
2924 break;
2925 case '<':
985213f2 2926 {
b469f1e0 2927 /* XXX $< currently silently ignores failures */
dfff4baf 2928 const Uid_t new_uid = SvUID(sv);
985213f2 2929 PL_delaymagic_uid = new_uid;
3280af22
NIS
2930 if (PL_delaymagic) {
2931 PL_delaymagic |= DM_RUID;
79072805
LW
2932 break; /* don't do magic till later */
2933 }
2934#ifdef HAS_SETRUID
b469f1e0 2935 PERL_UNUSED_RESULT(setruid(new_uid));
79072805
LW
2936#else
2937#ifdef HAS_SETREUID
b469f1e0 2938 PERL_UNUSED_RESULT(setreuid(new_uid, (Uid_t)-1));
748a9306 2939#else
85e6fe83 2940#ifdef HAS_SETRESUID
b469f1e0 2941 PERL_UNUSED_RESULT(setresuid(new_uid, (Uid_t)-1, (Uid_t)-1));
79072805 2942#else
985213f2 2943 if (new_uid == PerlProc_geteuid()) { /* special case $< = $> */
75870ed3 2944#ifdef PERL_DARWIN
2945 /* workaround for Darwin's setuid peculiarity, cf [perl #24122] */
985213f2 2946 if (new_uid != 0 && PerlProc_getuid() == 0)
b469f1e0 2947 PERL_UNUSED_RESULT(PerlProc_setuid(0));
75870ed3 2948#endif
b469f1e0 2949 PERL_UNUSED_RESULT(PerlProc_setuid(new_uid));
75870ed3 2950 } else {
cea2e8a9 2951 Perl_croak(aTHX_ "setruid() not implemented");
a0d0e21e 2952 }
79072805
LW
2953#endif
2954#endif
85e6fe83 2955#endif
79072805 2956 break;
985213f2 2957 }
79072805 2958 case '>':
985213f2 2959 {
b469f1e0 2960 /* XXX $> currently silently ignores failures */
dfff4baf 2961 const Uid_t new_euid = SvUID(sv);
985213f2 2962 PL_delaymagic_euid = new_euid;
3280af22
NIS
2963 if (PL_delaymagic) {
2964 PL_delaymagic |= DM_EUID;
79072805
LW
2965 break; /* don't do magic till later */
2966 }
2967#ifdef HAS_SETEUID
b469f1e0 2968 PERL_UNUSED_RESULT(seteuid(new_euid));
79072805
LW
2969#else
2970#ifdef HAS_SETREUID
b469f1e0 2971 PERL_UNUSED_RESULT(setreuid((Uid_t)-1, new_euid));
85e6fe83
LW
2972#else
2973#ifdef HAS_SETRESUID
b469f1e0 2974 PERL_UNUSED_RESULT(setresuid((Uid_t)-1, new_euid, (Uid_t)-1));
79072805 2975#else
985213f2 2976 if (new_euid == PerlProc_getuid()) /* special case $> = $< */
b469f1e0 2977 PERL_UNUSED_RESULT(PerlProc_setuid(new_euid));
a0d0e21e 2978 else {
cea2e8a9 2979 Perl_croak(aTHX_ "seteuid() not implemented");
a0d0e21e 2980 }
79072805
LW
2981#endif
2982#endif
85e6fe83 2983#endif
79072805 2984 break;
985213f2 2985 }
79072805 2986 case '(':
985213f2 2987 {
b469f1e0 2988 /* XXX $( currently silently ignores failures */
dfff4baf 2989 const Gid_t new_gid = SvGID(sv);
985213f2 2990 PL_delaymagic_gid = new_gid;
3280af22
NIS
2991 if (PL_delaymagic) {
2992 PL_delaymagic |= DM_RGID;
79072805
LW
2993 break; /* don't do magic till later */
2994 }
2995#ifdef HAS_SETRGID
b469f1e0 2996 PERL_UNUSED_RESULT(setrgid(new_gid));
79072805
LW
2997#else
2998#ifdef HAS_SETREGID
b469f1e0 2999 PERL_UNUSED_RESULT(setregid(new_gid, (Gid_t)-1));
85e6fe83
LW
3000#else
3001#ifdef HAS_SETRESGID
b469f1e0 3002 PERL_UNUSED_RESULT(setresgid(new_gid, (Gid_t)-1, (Gid_t) -1));
79072805 3003#else
985213f2 3004 if (new_gid == PerlProc_getegid()) /* special case $( = $) */
b469f1e0 3005 PERL_UNUSED_RESULT(PerlProc_setgid(new_gid));
748a9306 3006 else {
cea2e8a9 3007 Perl_croak(aTHX_ "setrgid() not implemented");
748a9306 3008 }
79072805
LW
3009#endif
3010#endif
85e6fe83 3011#endif
79072805 3012 break;
985213f2 3013 }
79072805 3014 case ')':
985213f2 3015 {
b469f1e0 3016 /* XXX $) currently silently ignores failures */
dfff4baf 3017 Gid_t new_egid;
5cd24f17
PP
3018#ifdef HAS_SETGROUPS
3019 {
b83604b4 3020 const char *p = SvPV_const(sv, len);
757f63d8 3021 Groups_t *gary = NULL;
fdadaf77 3022 const char* endptr;
fb4089e0 3023#ifdef _SC_NGROUPS_MAX
3024 int maxgrp = sysconf(_SC_NGROUPS_MAX);
3025
3026 if (maxgrp < 0)
3027 maxgrp = NGROUPS;
3028#else
3029 int maxgrp = NGROUPS;
3030#endif
757f63d8
SP
3031
3032 while (isSPACE(*p))
3033 ++p;
fdadaf77 3034 new_egid = (Gid_t)grok_atou(p, &endptr);
fb4089e0 3035 for (i = 0; i < maxgrp; ++i) {
fdadaf77
JH
3036 if (endptr == NULL)
3037 break;
3038 p = endptr;
757f63d8
SP
3039 while (isSPACE(*p))
3040 ++p;
3041 if (!*p)
3042 break;
fdadaf77 3043 if (!gary)
757f63d8
SP
3044 Newx(gary, i + 1, Groups_t);
3045 else
3046 Renew(gary, i + 1, Groups_t);
fdadaf77 3047 gary[i] = (Groups_t)grok_atou(p, &endptr);
757f63d8
SP
3048 }
3049 if (i)
b469f1e0 3050 PERL_UNUSED_RESULT(setgroups(i, gary));
f5a63d97 3051 Safefree(gary);
5cd24f17
PP
3052 }
3053#else /* HAS_SETGROUPS */
dfff4baf 3054 new_egid = SvGID(sv);
5cd24f17 3055#endif /* HAS_SETGROUPS */
985213f2 3056 PL_delaymagic_egid = new_egid;
3280af22
NIS
3057 if (PL_delaymagic) {
3058 PL_delaymagic |= DM_EGID;
79072805
LW
3059 break; /* don't do magic till later */
3060 }
3061#ifdef HAS_SETEGID
b469f1e0 3062 PERL_UNUSED_RESULT(setegid(new_egid));
79072805
LW
3063#else
3064#ifdef HAS_SETREGID
b469f1e0 3065 PERL_UNUSED_RESULT(setregid((Gid_t)-1, new_egid));
85e6fe83
LW
3066#else
3067#ifdef HAS_SETRESGID
b469f1e0 3068 PERL_UNUSED_RESULT(setresgid((Gid_t)-1, new_egid, (Gid_t)-1));
79072805 3069#else
985213f2 3070 if (new_egid == PerlProc_getgid()) /* special case $) = $( */
b469f1e0 3071 PERL_UNUSED_RESULT(PerlProc_setgid(new_egid));
748a9306 3072 else {
cea2e8a9 3073 Perl_croak(aTHX_ "setegid() not implemented");
748a9306 3074 }
79072805
LW
3075#endif
3076#endif
85e6fe83 3077#endif
79072805 3078 break;
985213f2 3079 }
79072805 3080 case ':':
2d8e6c8d 3081 PL_chopset = SvPV_force(sv,len);
79072805 3082 break;
9cdac2a2
FC
3083 case '$': /* $$ */
3084 /* Store the pid in mg->mg_obj so we can tell when a fork has
3085 occurred. mg->mg_obj points to *$ by default, so clear it. */
3086 if (isGV(mg->mg_obj)) {
3087 if (mg->mg_flags & MGf_REFCOUNTED) /* probably never true */
3088 SvREFCNT_dec(mg->mg_obj);
3089 mg->mg_flags |= MGf_REFCOUNTED;
3090 mg->mg_obj = newSViv((IV)PerlProc_getpid());
3091 }
3092 else sv_setiv(mg->mg_obj, (IV)PerlProc_getpid());
3093 break;
79072805 3094 case '0':
e2975953 3095 LOCK_DOLLARZERO_MUTEX;
4bc88a62
PS
3096#ifdef HAS_SETPROCTITLE
3097 /* The BSDs don't show the argv[] in ps(1) output, they
3098 * show a string from the process struct and provide
3099 * the setproctitle() routine to manipulate that. */
a2722ac9 3100 if (PL_origalen != 1) {
b83604b4 3101 s = SvPV_const(sv, len);
98b76f99 3102# if __FreeBSD_version > 410001
9aad2c0e 3103 /* The leading "-" removes the "perl: " prefix,
4bc88a62
PS
3104 * but not the "(perl) suffix from the ps(1)
3105 * output, because that's what ps(1) shows if the
3106 * argv[] is modified. */
6f2ad931 3107 setproctitle("-%s", s);
9aad2c0e 3108# else /* old FreeBSDs, NetBSD, OpenBSD, anyBSD */
4bc88a62
PS
3109 /* This doesn't really work if you assume that
3110 * $0 = 'foobar'; will wipe out 'perl' from the $0
3111 * because in ps(1) output the result will be like
3112 * sprintf("perl: %s (perl)", s)
3113 * I guess this is a security feature:
3114 * one (a user process) cannot get rid of the original name.
3115 * --jhi */
3116 setproctitle("%s", s);
3117# endif
3118 }
9d3968b2 3119#elif defined(__hpux) && defined(PSTAT_SETCMD)
a2722ac9 3120 if (PL_origalen != 1) {
17aa7f3d 3121 union pstun un;
b83604b4 3122 s = SvPV_const(sv, len);
6867be6d 3123 un.pst_command = (char *)s;
17aa7f3d
JH
3124 pstat(PSTAT_SETCMD, un, len, 0, 0);
3125 }
9d3968b2 3126#else
2d2af554
GA
3127 if (PL_origalen > 1) {
3128 /* PL_origalen is set in perl_parse(). */
3129 s = SvPV_force(sv,len);
3130 if (len >= (STRLEN)PL_origalen-1) {
3131 /* Longer than original, will be truncated. We assume that
3132 * PL_origalen bytes are available. */
3133 Copy(s, PL_origargv[0], PL_origalen-1, char);
3134 }
3135 else {
3136 /* Shorter than original, will be padded. */
235ac35d 3137#ifdef PERL_DARWIN
60777a0d
JH
3138 /* Special case for Mac OS X: see [perl #38868] */
3139 const int pad = 0;
235ac35d 3140#else
8a89a4f1
MB
3141 /* Is the space counterintuitive? Yes.
3142 * (You were expecting \0?)
3143 * Does it work? Seems to. (In Linux 2.4.20 at least.)
3144 * --jhi */
60777a0d 3145 const int pad = ' ';
235ac35d 3146#endif
60777a0d
JH
3147 Copy(s, PL_origargv[0], len, char);
3148 PL_origargv[0][len] = 0;
3149 memset(PL_origargv[0] + len + 1,
3150 pad, PL_origalen - len - 1);
2d2af554
GA
3151 }
3152 PL_origargv[0][PL_origalen-1] = 0;
3153 for (i = 1; i < PL_origargc; i++)
3154 PL_origargv[i] = 0;
7636ea95
AB
3155#ifdef HAS_PRCTL_SET_NAME
3156 /* Set the legacy process name in addition to the POSIX name on Linux */
3157 if (prctl(PR_SET_NAME, (unsigned long)s, 0, 0, 0) != 0) {
3158 /* diag_listed_as: SKIPME */
3159 Perl_croak(aTHX_ "Can't set $0 with prctl(): %s", Strerror(errno));
3160 }
3161#endif
79072805 3162 }
9d3968b2 3163#endif
e2975953 3164 UNLOCK_DOLLARZERO_MUTEX;
79072805
LW
3165 break;
3166 }
3167 return 0;
3168}
3169
3170I32
84c7b88c
BF
3171Perl_whichsig_sv(pTHX_ SV *sigsv)
3172{
3173 const char *sigpv;
3174 STRLEN siglen;
3175 PERL_ARGS_ASSERT_WHICHSIG_SV;
84c7b88c
BF
3176 sigpv = SvPV_const(sigsv, siglen);
3177 return whichsig_pvn(sigpv, siglen);
3178}
3179
3180I32
3181Perl_whichsig_pv(pTHX_ const char *sig)
3182{
3183 PERL_ARGS_ASSERT_WHICHSIG_PV;
84c7b88c
BF
3184 return whichsig_pvn(sig, strlen(sig));
3185}
3186
3187I32
3188Perl_whichsig_pvn(pTHX_ const char *sig, STRLEN len)
79072805 3189{
eb578fdb 3190 char* const* sigv;
7918f24d 3191
84c7b88c 3192 PERL_ARGS_ASSERT_WHICHSIG_PVN;
96a5add6 3193 PERL_UNUSED_CONTEXT;
79072805 3194
aadb217d 3195 for (sigv = (char* const*)PL_sig_name; *sigv; sigv++)
84c7b88c 3196 if (strlen(*sigv) == len && memEQ(sig,*sigv, len))
aadb217d 3197 return PL_sig_num[sigv - (char* const*)PL_sig_name];
79072805 3198#ifdef SIGCLD
84c7b88c 3199 if (memEQs(sig, len, "CHLD"))
79072805
LW
3200 return SIGCLD;
3201#endif
3202#ifdef SIGCHLD
84c7b88c 3203 if (memEQs(sig, len, "CLD"))
79072805
LW
3204 return SIGCHLD;
3205#endif
7f1236c0 3206 return -1;
79072805
LW
3207}
3208
ecfc5424 3209Signal_t
1e82f5a6 3210#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
b3dbdd48 3211Perl_sighandler(int sig, siginfo_t *sip, void *uap)
1e82f5a6
SH
3212#else
3213Perl_sighandler(int sig)
3214#endif
79072805 3215{
1018e26f
NIS
3216#ifdef PERL_GET_SIG_CONTEXT
3217 dTHXa(PERL_GET_SIG_CONTEXT);
71d280e3 3218#else
cea2e8a9 3219 dTHX;
71d280e3 3220#endif
79072805 3221 dSP;
a0714e2c
SS
3222 GV *gv = NULL;
3223 SV *sv = NULL;
8772537c 3224 SV * const tSv = PL_Sv;
601f1833 3225 CV *cv = NULL;
533c011a 3226 OP *myop = PL_op;
84902520 3227 U32 flags = 0;
8772537c 3228 XPV * const tXpv = PL_Xpv;
0c4d3b5e 3229 I32 old_ss_ix = PL_savestack_ix;
100c03aa 3230 SV *errsv_save = NULL;
71d280e3 3231
84902520 3232
727405f8 3233 if (!PL_psig_ptr[sig]) {
99ef548b 3234 PerlIO_printf(Perl_error_log, "Signal SIG%s received, but no signal handler set.\n",
727405f8
NIS
3235 PL_sig_name[sig]);
3236 exit(sig);
3237 }
ff0cee69 3238
a0d63a7b
DM
3239 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3240 /* Max number of items pushed there is 3*n or 4. We cannot fix
3241 infinity, so we fix 4 (in fact 5): */
3242 if (PL_savestack_ix + 15 <= PL_savestack_max) {
3243 flags |= 1;
3244 PL_savestack_ix += 5; /* Protect save in progress. */
3245 SAVEDESTRUCTOR_X(S_unwind_handler_stack, NULL);
3246 }
84902520 3247 }
84902520 3248 /* sv_2cv is too complicated, try a simpler variant first: */
ea726b52 3249 if (!SvROK(PL_psig_ptr[sig]) || !(cv = MUTABLE_CV(SvRV(PL_psig_ptr[sig])))
8772537c
AL
3250 || SvTYPE(cv) != SVt_PVCV) {
3251 HV *st;
f2c0649b 3252 cv = sv_2cv(PL_psig_ptr[sig], &st, &gv, GV_ADD);
8772537c 3253 }
84902520 3254
a0d0e21e 3255 if (!cv || !CvROOT(cv)) {
07c325bb 3256 const HEK * const hek = gv
1d6bb9ae
FC
3257 ? GvENAME_HEK(gv)
3258 : cv && CvNAMED(cv)
3259 ? CvNAME_HEK(cv)
07c325bb
FC
3260 : cv && CvGV(cv) ? GvENAME_HEK(CvGV(cv)) : NULL;
3261 if (hek)
3262 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3263 "SIG%s handler \"%"HEKf"\" not defined.\n",
3264 PL_sig_name[sig], hek);
3265 /* diag_listed_as: SIG%s handler "%s" not defined */
3266 else Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
3267 "SIG%s handler \"__ANON__\" not defined.\n",
3268 PL_sig_name[sig]);
00d579c5 3269 goto cleanup;
79072805
LW
3270 }
3271
0c4d3b5e
DM
3272 sv = PL_psig_name[sig]
3273 ? SvREFCNT_inc_NN(PL_psig_name[sig])
3274 : newSVpv(PL_sig_name[sig],0);
72048cfe 3275 flags |= 8;
0c4d3b5e
DM
3276 SAVEFREESV(sv);
3277
a0d63a7b
DM
3278 if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG) {
3279 /* make sure our assumption about the size of the SAVEs are correct:
3280 * 3 for SAVEDESTRUCTOR_X, 2 for SAVEFREESV */
3281 assert(old_ss_ix + 2 + ((flags & 1) ? 3+5 : 0) == PL_savestack_ix);
3282 }
e336de0d 3283
e788e7d3 3284 PUSHSTACKi(PERLSI_SIGNAL);
924508f0 3285 PUSHMARK(SP);
79072805 3286 PUSHs(sv);
8aad04aa
JH
3287#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
3288 {
3289 struct sigaction oact;
3290
3291 if (sigaction(sig, 0, &oact) == 0 && oact.sa_flags & SA_SIGINFO) {
8aad04aa
JH
3292 if (sip) {
3293 HV *sih = newHV();
ad64d0ec 3294 SV *rv = newRV_noinc(MUTABLE_SV(sih));
8aad04aa
JH
3295 /* The siginfo fields signo, code, errno, pid, uid,
3296 * addr, status, and band are defined by POSIX/SUSv3. */
85771703
NC
3297 (void)hv_stores(sih, "signo", newSViv(sip->si_signo));
3298 (void)hv_stores(sih, "code", newSViv(sip->si_code));
79dec0f4 3299#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
3300 hv_stores(sih, "errno", newSViv(sip->si_errno));
3301 hv_stores(sih, "status", newSViv(sip->si_status));
3302 hv_stores(sih, "uid", newSViv(sip->si_uid));
3303 hv_stores(sih, "pid", newSViv(sip->si_pid));
3304 hv_stores(sih, "addr", newSVuv(PTR2UV(sip->si_addr)));
3305 hv_stores(sih, "band", newSViv(sip->si_band));
79dec0f4 3306#endif
8aad04aa 3307 EXTEND(SP, 2);
ad64d0ec 3308 PUSHs(rv);
22f1178f 3309 mPUSHp((char *)sip, sizeof(*sip));
8aad04aa 3310 }
b4552a27 3311
8aad04aa
JH
3312 }
3313 }
3314#endif
79072805 3315 PUTBACK;
a0d0e21e 3316
100c03aa
JL
3317 errsv_save = newSVsv(ERRSV);
3318
ad64d0ec 3319 call_sv(MUTABLE_SV(cv), G_DISCARD|G_EVAL);
79072805 3320
d3acc0f7 3321 POPSTACK;
eed484f9
DD
3322 {
3323 SV * const errsv = ERRSV;
3324 if (SvTRUE_NN(errsv)) {
3325 SvREFCNT_dec(errsv_save);
c22d665b 3326#ifndef PERL_MICRO
1b266415
NIS
3327 /* Handler "died", for example to get out of a restart-able read().
3328 * Before we re-do that on its behalf re-enable the signal which was
3329 * blocked by the system when we entered.
3330 */
c22d665b 3331#ifdef HAS_SIGPROCMASK
d488af49 3332#if defined(HAS_SIGACTION) && defined(SA_SIGINFO)
eed484f9 3333 if (sip || uap)
c22d665b 3334#endif
eed484f9
DD
3335 {
3336 sigset_t set;
3337 sigemptyset(&set);
3338 sigaddset(&set,sig);
3339 sigprocmask(SIG_UNBLOCK, &set, NULL);
3340 }
c22d665b 3341#else
eed484f9
DD
3342 /* Not clear if this will work */
3343 (void)rsignal(sig, SIG_IGN);
3344 (void)rsignal(sig, PL_csighandlerp);
c22d665b
LT
3345#endif
3346#endif /* !PERL_MICRO */
eed484f9
DD
3347 die_sv(errsv);
3348 }
3349 else {
3350 sv_setsv(errsv, errsv_save);
3351 SvREFCNT_dec(errsv_save);
3352 }
100c03aa
JL
3353 }
3354
00d579c5 3355cleanup:
0c4d3b5e
DM
3356 /* pop any of SAVEFREESV, SAVEDESTRUCTOR_X and "save in progress" */
3357 PL_savestack_ix = old_ss_ix;
72048cfe 3358 if (flags & 8)
2357bae7 3359 SvREFCNT_dec_NN(sv);
533c011a 3360 PL_op = myop; /* Apparently not needed... */
ac27b0f5 3361
3280af22
NIS
3362 PL_Sv = tSv; /* Restore global temporaries. */
3363 PL_Xpv = tXpv;
53bb94e2 3364 return;
79072805 3365}
4e35701f
NIS
3366
3367
51371543 3368static void
8772537c 3369S_restore_magic(pTHX_ const void *p)
51371543 3370{
8772537c
AL
3371 MGS* const mgs = SSPTR(PTR2IV(p), MGS*);
3372 SV* const sv = mgs->mgs_sv;
150b625d 3373 bool bumped;
51371543
GS
3374
3375 if (!sv)
3376 return;
3377
4bac9ae4
CS
3378 if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
3379 SvTEMP_off(sv); /* if it's still magical, this value isn't temporary */
f8c7b90f 3380#ifdef PERL_OLD_COPY_ON_WRITE
f9701176
NC
3381 /* While magic was saved (and off) sv_setsv may well have seen
3382 this SV as a prime candidate for COW. */
3383 if (SvIsCOW(sv))
e424a81e 3384 sv_force_normal_flags(sv, 0);
f9701176 3385#endif
a623f893
FC
3386 if (mgs->mgs_flags)
3387 SvFLAGS(sv) |= mgs->mgs_flags;
51371543
GS
3388 else
3389 mg_magical(sv);
51371543
GS
3390 }
3391
150b625d 3392 bumped = mgs->mgs_bumped;
51371543
GS
3393 mgs->mgs_sv = NULL; /* mark the MGS structure as restored */
3394
3395 /* If we're still on top of the stack, pop us off. (That condition
3396 * will be satisfied if restore_magic was called explicitly, but *not*
3397 * if it's being called via leave_scope.)
3398 * The reason for doing this is that otherwise, things like sv_2cv()
3399 * may leave alloc gunk on the savestack, and some code
3400 * (e.g. sighandler) doesn't expect that...
3401 */
3402 if (PL_savestack_ix == mgs->mgs_ss_ix)
3403 {
1be36ce0
NC
3404 UV popval = SSPOPUV;
3405 assert(popval == SAVEt_DESTRUCTOR_X);
51371543 3406 PL_savestack_ix -= 2;
1be36ce0
NC
3407 popval = SSPOPUV;
3408 assert((popval & SAVE_MASK) == SAVEt_ALLOC);
3409 PL_savestack_ix -= popval >> SAVE_TIGHT_SHIFT;
51371543 3410 }
150b625d
DM
3411 if (bumped) {
3412 if (SvREFCNT(sv) == 1) {
3413 /* We hold the last reference to this SV, which implies that the
3414 SV was deleted as a side effect of the routines we called.
3415 So artificially keep it alive a bit longer.
3416 We avoid turning on the TEMP flag, which can cause the SV's
3417 buffer to get stolen (and maybe other stuff). */
150b625d 3418 sv_2mortal(sv);
4bac9ae4 3419 SvTEMP_off(sv);
8985fe98 3420 }
150b625d 3421 else
2357bae7 3422 SvREFCNT_dec_NN(sv); /* undo the inc in S_save_magic() */
8985fe98 3423 }
51371543
GS
3424}
3425
0c4d3b5e
DM
3426/* clean up the mess created by Perl_sighandler().
3427 * Note that this is only called during an exit in a signal handler;
3428 * a die is trapped by the call_sv() and the SAVEDESTRUCTOR_X manually
9a7f166c 3429 * skipped over. */
0c4d3b5e 3430
51371543 3431static void
8772537c 3432S_unwind_handler_stack(pTHX_ const void *p)
51371543 3433{
0c4d3b5e 3434 PERL_UNUSED_ARG(p);
7918f24d 3435
0c4d3b5e 3436 PL_savestack_ix -= 5; /* Unprotect save in progress. */
51371543 3437}
1018e26f 3438
66610fdd 3439/*
b3ca2e83
NC
3440=for apidoc magic_sethint
3441
3442Triggered by a store to %^H, records the key/value pair to
c28fe1ec
NC
3443C<PL_compiling.cop_hints_hash>. It is assumed that hints aren't storing
3444anything that would need a deep copy. Maybe we should warn if we find a
3445reference.
b3ca2e83
NC
3446
3447=cut
3448*/
3449int
3450Perl_magic_sethint(pTHX_ SV *sv, MAGIC *mg)
3451{
ad64d0ec 3452 SV *key = (mg->mg_len == HEf_SVKEY) ? MUTABLE_SV(mg->mg_ptr)
59cd0e26 3453 : newSVpvn_flags(mg->mg_ptr, mg->mg_len, SVs_TEMP);
b3ca2e83 3454
7918f24d
NC
3455 PERL_ARGS_ASSERT_MAGIC_SETHINT;
3456
e6e3e454
NC
3457 /* mg->mg_obj isn't being used. If needed, it would be possible to store
3458 an alternative leaf in there, with PL_compiling.cop_hints being used if
3459 it's NULL. If needed for threads, the alternative could lock a mutex,
3460 or take other more complex action. */
3461
5b9c0671
NC
3462 /* Something changed in %^H, so it will need to be restored on scope exit.
3463 Doing this here saves a lot of doing it manually in perl code (and
3464 forgetting to do it, and consequent subtle errors. */
3465 PL_hints |= HINT_LOCALIZE_HH;
20439bc7
Z
3466 CopHINTHASH_set(&PL_compiling,
3467 cophh_store_sv(CopHINTHASH_get(&PL_compiling), key, 0, sv, 0));
b3ca2e83
NC
3468 return 0;
3469}
3470
3471/*
f175cff5 3472=for apidoc magic_clearhint
b3ca2e83 3473
c28fe1ec
NC
3474Triggered by a delete from %^H, records the key to
3475C<PL_compiling.cop_hints_hash>.
b3ca2e83
NC
3476
3477=cut
3478*/
3479int
3480Perl_magic_clearhint(pTHX_ SV *sv, MAGIC *mg)
3481{
7918f24d