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