This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Restore "Tweak our hash bucket splitting rules"
[perl5.git] / perl.c
CommitLineData
4b88f280 1#line 2 "perl.c"
a0d0e21e
LW
2/* perl.c
3 *
737f4459 4 * Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001
2eee27d7 5 * 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
f3e2e262 6 * 2013, 2014, 2015, 2016, 2017 by Larry Wall and others
a687059c 7 *
352d5a3a
LW
8 * You may distribute under the terms of either the GNU General Public
9 * License or the Artistic License, as specified in the README file.
a687059c 10 *
8d063cd8
LW
11 */
12
a0d0e21e 13/*
4ac71550
TC
14 * A ship then new they built for him
15 * of mithril and of elven-glass
cdad3b53 16 * --from Bilbo's song of Eärendil
4ac71550
TC
17 *
18 * [p.236 of _The Lord of the Rings_, II/i: "Many Meetings"]
a0d0e21e 19 */
45d8adaa 20
166f8a29
DM
21/* This file contains the top-level functions that are used to create, use
22 * and destroy a perl interpreter, plus the functions used by XS code to
23 * call back into perl. Note that it does not contain the actual main()
ddfa107c 24 * function of the interpreter; that can be found in perlmain.c
a1b69980
DM
25 *
26 * Note that at build time this file is also linked to as perlmini.c,
27 * and perlmini.o is then built with PERL_IS_MINIPERL defined, which is
28 * then used to create the miniperl executable, rather than perl.o.
166f8a29
DM
29 */
30
c44493f1 31#if defined(PERL_IS_MINIPERL) && !defined(USE_SITECUSTOMIZE)
43c0c913
NC
32# define USE_SITECUSTOMIZE
33#endif
34
378cc40b 35#include "EXTERN.h"
864dbfa3 36#define PERL_IN_PERL_C
378cc40b 37#include "perl.h"
e3321bb0 38#include "patchlevel.h" /* for local_patches */
4a5df386 39#include "XSUB.h"
378cc40b 40
011f1a1a
JH
41#ifdef NETWARE
42#include "nwutil.h"
011f1a1a
JH
43#endif
44
2aa47728 45#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
bf357333
NC
46# ifdef I_SYSUIO
47# include <sys/uio.h>
48# endif
49
50union control_un {
51 struct cmsghdr cm;
52 char control[CMSG_SPACE(sizeof(int))];
53};
54
2aa47728
NC
55#endif
56
5311654c
JH
57#ifndef HZ
58# ifdef CLK_TCK
59# define HZ CLK_TCK
60# else
61# define HZ 60
62# endif
63#endif
64
7114a2d2 65#if !defined(STANDARD_C) && !defined(HAS_GETENV_PROTOTYPE) && !defined(PERL_MICRO)
20ce7b12 66char *getenv (char *); /* Usually in <stdlib.h> */
54310121
PP
67#endif
68
acfe0abc 69static I32 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen);
0cb96387 70
cc69b689 71#ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
b24bc095 72# define validate_suid(rsfp) NOOP
cc69b689 73#else
b24bc095 74# define validate_suid(rsfp) S_validate_suid(aTHX_ rsfp)
a687059c 75#endif
8d063cd8 76
d6f07c05
AL
77#define CALL_BODY_SUB(myop) \
78 if (PL_op == (myop)) \
139d0ce6 79 PL_op = PL_ppaddr[OP_ENTERSUB](aTHX); \
d6f07c05
AL
80 if (PL_op) \
81 CALLRUNOPS(aTHX);
82
83#define CALL_LIST_BODY(cv) \
84 PUSHMARK(PL_stack_sp); \
9a8aa25b 85 call_sv(MUTABLE_SV((cv)), G_EVAL|G_DISCARD|G_VOID);
d6f07c05 86
e6827a76 87static void
daa7d858 88S_init_tls_and_interp(PerlInterpreter *my_perl)
e6827a76 89{
27da23d5 90 dVAR;
e6827a76
NC
91 if (!PL_curinterp) {
92 PERL_SET_INTERP(my_perl);
3db8f154 93#if defined(USE_ITHREADS)
e6827a76
NC
94 INIT_THREADS;
95 ALLOC_THREAD_KEY;
96 PERL_SET_THX(my_perl);
97 OP_REFCNT_INIT;
e8570548 98 OP_CHECK_MUTEX_INIT;
71ad1b0c 99 HINTS_REFCNT_INIT;
929e1213 100 LOCALE_INIT;
e6827a76 101 MUTEX_INIT(&PL_dollarzero_mutex);
016af4f1
DM
102 MUTEX_INIT(&PL_my_ctx_mutex);
103# endif
e6827a76 104 }
c0bce9aa
NC
105#if defined(USE_ITHREADS)
106 else
107#else
108 /* This always happens for non-ithreads */
109#endif
110 {
e6827a76
NC
111 PERL_SET_THX(my_perl);
112 }
113}
06d86050 114
cbec8ebe
DM
115
116/* these implement the PERL_SYS_INIT, PERL_SYS_INIT3, PERL_SYS_TERM macros */
117
118void
119Perl_sys_init(int* argc, char*** argv)
120{
4fc0badb 121 dVAR;
7918f24d
NC
122
123 PERL_ARGS_ASSERT_SYS_INIT;
124
cbec8ebe
DM
125 PERL_UNUSED_ARG(argc); /* may not be used depending on _BODY macro */
126 PERL_UNUSED_ARG(argv);
127 PERL_SYS_INIT_BODY(argc, argv);
128}
129
130void
131Perl_sys_init3(int* argc, char*** argv, char*** env)
132{
4fc0badb 133 dVAR;
7918f24d
NC
134
135 PERL_ARGS_ASSERT_SYS_INIT3;
136
cbec8ebe
DM
137 PERL_UNUSED_ARG(argc); /* may not be used depending on _BODY macro */
138 PERL_UNUSED_ARG(argv);
139 PERL_UNUSED_ARG(env);
140 PERL_SYS_INIT3_BODY(argc, argv, env);
141}
142
143void
88772978 144Perl_sys_term(void)
cbec8ebe 145{
4fc0badb 146 dVAR;
bf81751b
DM
147 if (!PL_veto_cleanup) {
148 PERL_SYS_TERM_BODY();
149 }
cbec8ebe
DM
150}
151
152
32e30700
GS
153#ifdef PERL_IMPLICIT_SYS
154PerlInterpreter *
7766f137
GS
155perl_alloc_using(struct IPerlMem* ipM, struct IPerlMem* ipMS,
156 struct IPerlMem* ipMP, struct IPerlEnv* ipE,
32e30700
GS
157 struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
158 struct IPerlDir* ipD, struct IPerlSock* ipS,
159 struct IPerlProc* ipP)
160{
161 PerlInterpreter *my_perl;
7918f24d
NC
162
163 PERL_ARGS_ASSERT_PERL_ALLOC_USING;
164
9f653bb5 165 /* Newx() needs interpreter, so call malloc() instead */
32e30700 166 my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
e6827a76 167 S_init_tls_and_interp(my_perl);
32e30700
GS
168 Zero(my_perl, 1, PerlInterpreter);
169 PL_Mem = ipM;
7766f137
GS
170 PL_MemShared = ipMS;
171 PL_MemParse = ipMP;
32e30700
GS
172 PL_Env = ipE;
173 PL_StdIO = ipStd;
174 PL_LIO = ipLIO;
175 PL_Dir = ipD;
176 PL_Sock = ipS;
177 PL_Proc = ipP;
7cb608b5 178 INIT_TRACK_MEMPOOL(PL_memory_debug_header, my_perl);
7766f137 179
32e30700
GS
180 return my_perl;
181}
182#else
954c1994
GS
183
184/*
ccfc67b7
JH
185=head1 Embedding Functions
186
954c1994
GS
187=for apidoc perl_alloc
188
189Allocates a new Perl interpreter. See L<perlembed>.
190
191=cut
192*/
193
93a17b20 194PerlInterpreter *
cea2e8a9 195perl_alloc(void)
79072805 196{
cea2e8a9 197 PerlInterpreter *my_perl;
79072805 198
9f653bb5 199 /* Newx() needs interpreter, so call malloc() instead */
e8ee3774 200 my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
ba869deb 201
e6827a76 202 S_init_tls_and_interp(my_perl);
7cb608b5 203#ifndef PERL_TRACK_MEMPOOL
07409e01 204 return (PerlInterpreter *) ZeroD(my_perl, 1, PerlInterpreter);
7cb608b5
NC
205#else
206 Zero(my_perl, 1, PerlInterpreter);
207 INIT_TRACK_MEMPOOL(PL_memory_debug_header, my_perl);
208 return my_perl;
209#endif
79072805 210}
32e30700 211#endif /* PERL_IMPLICIT_SYS */
79072805 212
954c1994
GS
213/*
214=for apidoc perl_construct
215
216Initializes a new Perl interpreter. See L<perlembed>.
217
218=cut
219*/
220
0927ade0 221static void
222S_fixup_platform_bugs(void)
223{
224#if defined(__GLIBC__) && IVSIZE == 8 \
225 && ( __GLIBC__ < 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ < 8))
226 {
227 IV l = 3;
228 IV r = -10;
229 /* Cannot do this check with inlined IV constants since
230 * that seems to work correctly even with the buggy glibc. */
231 if (l % r == -3) {
232 dTHX;
233 /* Yikes, we have the bug.
234 * Patch in the workaround version. */
235 PL_ppaddr[OP_I_MODULO] = &Perl_pp_i_modulo_glibc_bugfix;
236 }
237 }
238#endif
239}
240
79072805 241void
0cb96387 242perl_construct(pTHXx)
79072805 243{
27da23d5 244 dVAR;
7918f24d
NC
245
246 PERL_ARGS_ASSERT_PERL_CONSTRUCT;
247
8990e307 248#ifdef MULTIPLICITY
54aff467 249 init_interp();
ac27b0f5 250 PL_perl_destruct_level = 1;
54aff467 251#else
7918f24d 252 PERL_UNUSED_ARG(my_perl);
54aff467
GS
253 if (PL_perl_destruct_level > 0)
254 init_interp();
255#endif
34caed6d
DM
256 PL_curcop = &PL_compiling; /* needed by ckWARN, right away */
257
75d476e2
SM
258#ifdef PERL_TRACE_OPS
259 Zero(PL_op_exec_cnt, OP_max+2, UV);
260#endif
261
0d96b528 262 init_constants();
34caed6d
DM
263
264 SvREADONLY_on(&PL_sv_placeholder);
fe54beba 265 SvREFCNT(&PL_sv_placeholder) = SvREFCNT_IMMORTAL;
34caed6d
DM
266
267 PL_sighandlerp = (Sighandler_t) Perl_sighandler;
ca0c25f6 268#ifdef PERL_USES_PL_PIDSTATUS
34caed6d 269 PL_pidstatus = newHV();
ca0c25f6 270#endif
79072805 271
396482e1 272 PL_rs = newSVpvs("\n");
dc92893f 273
cea2e8a9 274 init_stacks();
79072805 275
748a9306 276 init_ids();
a5f75d66 277
0927ade0 278 S_fixup_platform_bugs();
279
312caa8e 280 JMPENV_BOOTSTRAP;
f86702cc
PP
281 STATUS_ALL_SUCCESS;
282
0672f40e 283 init_i18nl10n(1);
0b5b802d 284
ab821d7f 285#if defined(LOCAL_PATCH_COUNT)
3280af22 286 PL_localpatches = local_patches; /* For possible -v */
ab821d7f
PP
287#endif
288
52853b95
GS
289#ifdef HAVE_INTERP_INTERN
290 sys_intern_init();
291#endif
292
3a1ee7e8 293 PerlIO_init(aTHX); /* Hook to IO system */
760ac839 294
3280af22
NIS
295 PL_fdpid = newAV(); /* for remembering popen pids by fd */
296 PL_modglobal = newHV(); /* pointers to per-interpreter module globals */
396482e1 297 PL_errors = newSVpvs("");
854da30f
YO
298 SvPVCLEAR(PERL_DEBUG_PAD(0)); /* For regex debugging. */
299 SvPVCLEAR(PERL_DEBUG_PAD(1)); /* ext/re needs these */
300 SvPVCLEAR(PERL_DEBUG_PAD(2)); /* even without DEBUGGING. */
1fcf4c12 301#ifdef USE_ITHREADS
402d2eb1
NC
302 /* First entry is a list of empty elements. It needs to be initialised
303 else all hell breaks loose in S_find_uninit_var(). */
304 Perl_av_create_and_push(aTHX_ &PL_regex_padav, newSVpvs(""));
13137afc 305 PL_regex_pad = AvARRAY(PL_regex_padav);
d4d03940 306 Newxz(PL_stashpad, PL_stashpadmax, HV *);
1fcf4c12 307#endif
e5dd39fc 308#ifdef USE_REENTRANT_API
59bd0823 309 Perl_reentrant_init(aTHX);
e5dd39fc 310#endif
eba287cb 311#if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT)
e6a172f3
YO
312 /* [perl #22371] Algorimic Complexity Attack on Perl 5.6.1, 5.8.0
313 * This MUST be done before any hash stores or fetches take place.
314 * If you set PL_hash_seed (and presumably also PL_hash_seed_set)
315 * yourself, it is your responsibility to provide a good random seed!
316 * You can also define PERL_HASH_SEED in compile time, see hv.h.
317 *
318 * XXX: fix this comment */
319 if (PL_hash_seed_set == FALSE) {
7dc86639 320 Perl_get_hash_seed(aTHX_ PL_hash_seed);
a3bf60fb
YO
321 PL_hash_seed_set= TRUE;
322 }
e6a172f3
YO
323#endif /* #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) */
324
3d47000e
AB
325 /* Note that strtab is a rather special HV. Assumptions are made
326 about not iterating on it, and not adding tie magic to it.
327 It is properly deallocated in perl_destruct() */
328 PL_strtab = newHV();
329
3d47000e 330 HvSHAREKEYS_off(PL_strtab); /* mandatory */
e6a172f3 331 hv_ksplit(PL_strtab, 512);
3d47000e 332
a38ab475
RZ
333 Zero(PL_sv_consts, SV_CONSTS_COUNT, SV*);
334
2f42fcb0
JH
335#ifndef PERL_MICRO
336# ifdef USE_ENVIRON_ARRAY
0631ea03 337 PL_origenviron = environ;
2f42fcb0 338# endif
0631ea03
AB
339#endif
340
5311654c 341 /* Use sysconf(_SC_CLK_TCK) if available, if not
dbc1d986 342 * available or if the sysconf() fails, use the HZ.
27da23d5
JH
343 * The HZ if not originally defined has been by now
344 * been defined as CLK_TCK, if available. */
b6c36746 345#if defined(HAS_SYSCONF) && defined(_SC_CLK_TCK)
5311654c
JH
346 PL_clocktick = sysconf(_SC_CLK_TCK);
347 if (PL_clocktick <= 0)
348#endif
349 PL_clocktick = HZ;
350
081fc587
AB
351 PL_stashcache = newHV();
352
e8e3635e 353 PL_patchlevel = newSVpvs("v" PERL_VERSION_STRING);
d7aa5382 354
27da23d5
JH
355#ifdef HAS_MMAP
356 if (!PL_mmap_page_size) {
357#if defined(HAS_SYSCONF) && (defined(_SC_PAGESIZE) || defined(_SC_MMAP_PAGE_SIZE))
358 {
359 SETERRNO(0, SS_NORMAL);
360# ifdef _SC_PAGESIZE
361 PL_mmap_page_size = sysconf(_SC_PAGESIZE);
362# else
363 PL_mmap_page_size = sysconf(_SC_MMAP_PAGE_SIZE);
364# endif
365 if ((long) PL_mmap_page_size < 0) {
366 if (errno) {
44f8325f 367 SV * const error = ERRSV;
d4c19fe8 368 SvUPGRADE(error, SVt_PV);
0510663f 369 Perl_croak(aTHX_ "panic: sysconf: %s", SvPV_nolen_const(error));
27da23d5
JH
370 }
371 else
372 Perl_croak(aTHX_ "panic: sysconf: pagesize unknown");
373 }
374 }
375#else
376# ifdef HAS_GETPAGESIZE
377 PL_mmap_page_size = getpagesize();
378# else
379# if defined(I_SYS_PARAM) && defined(PAGESIZE)
380 PL_mmap_page_size = PAGESIZE; /* compiletime, bad */
381# endif
382# endif
383#endif
384 if (PL_mmap_page_size <= 0)
385 Perl_croak(aTHX_ "panic: bad pagesize %" IVdf,
386 (IV) PL_mmap_page_size);
387 }
388#endif /* HAS_MMAP */
389
390#if defined(HAS_TIMES) && defined(PERL_NEED_TIMESBASE)
391 PL_timesbase.tms_utime = 0;
392 PL_timesbase.tms_stime = 0;
393 PL_timesbase.tms_cutime = 0;
394 PL_timesbase.tms_cstime = 0;
395#endif
396
7d113631
NC
397 PL_osname = Perl_savepvn(aTHX_ STR_WITH_LEN(OSNAME));
398
a3e6e81e 399 PL_registered_mros = newHV();
9e169432
NC
400 /* Start with 1 bucket, for DFS. It's unlikely we'll need more. */
401 HvMAX(PL_registered_mros) = 0;
a3e6e81e 402
7b8dd5f4
KW
403 PL_XPosix_ptrs[_CC_ASCII] = _new_invlist_C_array(ASCII_invlist);
404 PL_XPosix_ptrs[_CC_ALPHANUMERIC] = _new_invlist_C_array(XPosixAlnum_invlist);
405 PL_XPosix_ptrs[_CC_ALPHA] = _new_invlist_C_array(XPosixAlpha_invlist);
406 PL_XPosix_ptrs[_CC_BLANK] = _new_invlist_C_array(XPosixBlank_invlist);
407 PL_XPosix_ptrs[_CC_CASED] = _new_invlist_C_array(Cased_invlist);
408 PL_XPosix_ptrs[_CC_CNTRL] = _new_invlist_C_array(XPosixCntrl_invlist);
409 PL_XPosix_ptrs[_CC_DIGIT] = _new_invlist_C_array(XPosixDigit_invlist);
410 PL_XPosix_ptrs[_CC_GRAPH] = _new_invlist_C_array(XPosixGraph_invlist);
411 PL_XPosix_ptrs[_CC_LOWER] = _new_invlist_C_array(XPosixLower_invlist);
412 PL_XPosix_ptrs[_CC_PRINT] = _new_invlist_C_array(XPosixPrint_invlist);
413 PL_XPosix_ptrs[_CC_PUNCT] = _new_invlist_C_array(XPosixPunct_invlist);
414 PL_XPosix_ptrs[_CC_SPACE] = _new_invlist_C_array(XPerlSpace_invlist);
7b8dd5f4
KW
415 PL_XPosix_ptrs[_CC_UPPER] = _new_invlist_C_array(XPosixUpper_invlist);
416 PL_XPosix_ptrs[_CC_VERTSPACE] = _new_invlist_C_array(VertSpace_invlist);
417 PL_XPosix_ptrs[_CC_WORDCHAR] = _new_invlist_C_array(XPosixWord_invlist);
418 PL_XPosix_ptrs[_CC_XDIGIT] = _new_invlist_C_array(XPosixXDigit_invlist);
02f811dd 419 PL_GCB_invlist = _new_invlist_C_array(_Perl_GCB_invlist);
bf4268fa
KW
420 PL_SB_invlist = _new_invlist_C_array(_Perl_SB_invlist);
421 PL_WB_invlist = _new_invlist_C_array(_Perl_WB_invlist);
6b659339 422 PL_LB_invlist = _new_invlist_C_array(_Perl_LB_invlist);
9e7ded3f 423 PL_Assigned_invlist = _new_invlist_C_array(Assigned_invlist);
6ebbc862
KW
424#ifdef USE_THREAD_SAFE_LOCALE
425 PL_C_locale_obj = newlocale(LC_ALL_MASK, "C", NULL);
426#endif
7b8dd5f4 427
8990e307 428 ENTER;
79072805
LW
429}
430
954c1994 431/*
62375a60
NIS
432=for apidoc nothreadhook
433
434Stub that provides thread hook for perl_destruct when there are
435no threads.
436
437=cut
438*/
439
440int
4e9e3734 441Perl_nothreadhook(pTHX)
62375a60 442{
96a5add6 443 PERL_UNUSED_CONTEXT;
62375a60
NIS
444 return 0;
445}
446
41e4abd8
NC
447#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
448void
449Perl_dump_sv_child(pTHX_ SV *sv)
450{
451 ssize_t got;
bf357333
NC
452 const int sock = PL_dumper_fd;
453 const int debug_fd = PerlIO_fileno(Perl_debug_log);
bf357333
NC
454 union control_un control;
455 struct msghdr msg;
808ad2d0 456 struct iovec vec[2];
bf357333 457 struct cmsghdr *cmptr;
808ad2d0
NC
458 int returned_errno;
459 unsigned char buffer[256];
41e4abd8 460
7918f24d
NC
461 PERL_ARGS_ASSERT_DUMP_SV_CHILD;
462
bf357333 463 if(sock == -1 || debug_fd == -1)
41e4abd8
NC
464 return;
465
466 PerlIO_flush(Perl_debug_log);
467
bf357333
NC
468 /* All these shenanigans are to pass a file descriptor over to our child for
469 it to dump out to. We can't let it hold open the file descriptor when it
470 forks, as the file descriptor it will dump to can turn out to be one end
471 of pipe that some other process will wait on for EOF. (So as it would
b293a5f8 472 be open, the wait would be forever.) */
bf357333
NC
473
474 msg.msg_control = control.control;
475 msg.msg_controllen = sizeof(control.control);
476 /* We're a connected socket so we don't need a destination */
477 msg.msg_name = NULL;
478 msg.msg_namelen = 0;
479 msg.msg_iov = vec;
808ad2d0 480 msg.msg_iovlen = 1;
bf357333
NC
481
482 cmptr = CMSG_FIRSTHDR(&msg);
483 cmptr->cmsg_len = CMSG_LEN(sizeof(int));
484 cmptr->cmsg_level = SOL_SOCKET;
485 cmptr->cmsg_type = SCM_RIGHTS;
486 *((int *)CMSG_DATA(cmptr)) = 1;
487
488 vec[0].iov_base = (void*)&sv;
489 vec[0].iov_len = sizeof(sv);
490 got = sendmsg(sock, &msg, 0);
41e4abd8
NC
491
492 if(got < 0) {
bf357333 493 perror("Debug leaking scalars parent sendmsg failed");
41e4abd8
NC
494 abort();
495 }
bf357333
NC
496 if(got < sizeof(sv)) {
497 perror("Debug leaking scalars parent short sendmsg");
41e4abd8
NC
498 abort();
499 }
500
808ad2d0
NC
501 /* Return protocol is
502 int: errno value
503 unsigned char: length of location string (0 for empty)
504 unsigned char*: string (not terminated)
505 */
506 vec[0].iov_base = (void*)&returned_errno;
507 vec[0].iov_len = sizeof(returned_errno);
508 vec[1].iov_base = buffer;
509 vec[1].iov_len = 1;
510
511 got = readv(sock, vec, 2);
41e4abd8
NC
512
513 if(got < 0) {
514 perror("Debug leaking scalars parent read failed");
808ad2d0 515 PerlIO_flush(PerlIO_stderr());
41e4abd8
NC
516 abort();
517 }
808ad2d0 518 if(got < sizeof(returned_errno) + 1) {
41e4abd8 519 perror("Debug leaking scalars parent short read");
808ad2d0 520 PerlIO_flush(PerlIO_stderr());
41e4abd8
NC
521 abort();
522 }
523
808ad2d0
NC
524 if (*buffer) {
525 got = read(sock, buffer + 1, *buffer);
526 if(got < 0) {
527 perror("Debug leaking scalars parent read 2 failed");
528 PerlIO_flush(PerlIO_stderr());
529 abort();
530 }
531
532 if(got < *buffer) {
533 perror("Debug leaking scalars parent short read 2");
534 PerlIO_flush(PerlIO_stderr());
535 abort();
536 }
537 }
538
539 if (returned_errno || *buffer) {
540 Perl_warn(aTHX_ "Debug leaking scalars child failed%s%.*s with errno"
541 " %d: %s", (*buffer ? " at " : ""), (int) *buffer, buffer + 1,
0c0d42ff 542 returned_errno, Strerror(returned_errno));
41e4abd8
NC
543 }
544}
545#endif
546
62375a60 547/*
954c1994
GS
548=for apidoc perl_destruct
549
550Shuts down a Perl interpreter. See L<perlembed>.
551
552=cut
553*/
554
31d77e54 555int
0cb96387 556perl_destruct(pTHXx)
79072805 557{
27da23d5 558 dVAR;
be2ea8ed 559 VOL signed char destruct_level; /* see possible values in intrpvar.h */
a0d0e21e 560 HV *hv;
2aa47728 561#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
2aa47728
NC
562 pid_t child;
563#endif
9c0b6888 564 int i;
8990e307 565
7918f24d
NC
566 PERL_ARGS_ASSERT_PERL_DESTRUCT;
567#ifndef MULTIPLICITY
ed6c66dd 568 PERL_UNUSED_ARG(my_perl);
7918f24d 569#endif
9d4ba2ae 570
3d22c4f0
GG
571 assert(PL_scopestack_ix == 1);
572
7766f137
GS
573 /* wait for all pseudo-forked children to finish */
574 PERL_WAIT_FOR_CHILDREN;
575
3280af22 576 destruct_level = PL_perl_destruct_level;
36e77d41 577#if defined(DEBUGGING) || defined(PERL_TRACK_MEMPOOL)
4633a7c4 578 {
9d4ba2ae
AL
579 const char * const s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL");
580 if (s) {
96e440d2
JH
581 int i;
582 if (strEQ(s, "-1")) { /* Special case: modperl folklore. */
583 i = -1;
584 } else {
22ff3130
HS
585 UV uv;
586 if (grok_atoUV(s, &uv, NULL) && uv <= INT_MAX)
587 i = (int)uv;
588 else
589 i = 0;
96e440d2 590 }
36e77d41
DD
591#ifdef DEBUGGING
592 if (destruct_level < i) destruct_level = i;
593#endif
594#ifdef PERL_TRACK_MEMPOOL
f5199772
KW
595 /* RT #114496, for perl_free */
596 PL_perl_destruct_level = i;
36e77d41 597#endif
5f05dabc 598 }
4633a7c4
LW
599 }
600#endif
601
27da23d5 602 if (PL_exit_flags & PERL_EXIT_DESTRUCT_END) {
f3faeb53
AB
603 dJMPENV;
604 int x = 0;
605
606 JMPENV_PUSH(x);
1b6737cc 607 PERL_UNUSED_VAR(x);
9ebf26ad 608 if (PL_endav && !PL_minus_c) {
ca7b837b 609 PERL_SET_PHASE(PERL_PHASE_END);
f3faeb53 610 call_list(PL_scopestack_ix, PL_endav);
9ebf26ad 611 }
f3faeb53 612 JMPENV_POP;
26f423df 613 }
f3faeb53 614 LEAVE;
a0d0e21e 615 FREETMPS;
3d22c4f0 616 assert(PL_scopestack_ix == 0);
a0d0e21e 617
e00b64d4 618 /* Need to flush since END blocks can produce output */
8abddda3
TC
619 /* flush stdout separately, since we can identify it */
620#ifdef USE_PERLIO
621 {
622 PerlIO *stdo = PerlIO_stdout();
623 if (*stdo && PerlIO_flush(stdo)) {
624 PerlIO_restore_errno(stdo);
675c73ca
MB
625 if (errno)
626 PerlIO_printf(PerlIO_stderr(), "Unable to flush stdout: %s",
627 Strerror(errno));
8abddda3
TC
628 if (!STATUS_UNIX)
629 STATUS_ALL_FAILURE;
630 }
631 }
632#endif
f13a2bc0 633 my_fflush_all();
e00b64d4 634
75d476e2 635#ifdef PERL_TRACE_OPS
e71f25b3
JC
636 /* dump OP-counts if $ENV{PERL_TRACE_OPS} > 0 */
637 {
638 const char * const ptoenv = PerlEnv_getenv("PERL_TRACE_OPS");
639 UV uv;
640
641 if (!ptoenv || !Perl_grok_atoUV(ptoenv, &uv, NULL)
642 || !(uv > 0))
643 goto no_trace_out;
644 }
75d476e2
SM
645 PerlIO_printf(Perl_debug_log, "Trace of all OPs executed:\n");
646 for (i = 0; i <= OP_max; ++i) {
e71f25b3 647 if (PL_op_exec_cnt[i])
147e3846 648 PerlIO_printf(Perl_debug_log, " %s: %" UVuf "\n", PL_op_name[i], PL_op_exec_cnt[i]);
75d476e2
SM
649 }
650 /* Utility slot for easily doing little tracing experiments in the runloop: */
651 if (PL_op_exec_cnt[OP_max+1] != 0)
147e3846 652 PerlIO_printf(Perl_debug_log, " SPECIAL: %" UVuf "\n", PL_op_exec_cnt[OP_max+1]);
75d476e2 653 PerlIO_printf(Perl_debug_log, "\n");
e71f25b3 654 no_trace_out:
75d476e2
SM
655#endif
656
657
16c91539 658 if (PL_threadhook(aTHX)) {
62375a60 659 /* Threads hook has vetoed further cleanup */
c301d606 660 PL_veto_cleanup = TRUE;
37038d91 661 return STATUS_EXIT;
62375a60
NIS
662 }
663
2aa47728
NC
664#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
665 if (destruct_level != 0) {
666 /* Fork here to create a child. Our child's job is to preserve the
667 state of scalars prior to destruction, so that we can instruct it
668 to dump any scalars that we later find have leaked.
669 There's no subtlety in this code - it assumes POSIX, and it doesn't
670 fail gracefully */
671 int fd[2];
672
673 if(socketpair(AF_UNIX, SOCK_STREAM, 0, fd)) {
674 perror("Debug leaking scalars socketpair failed");
675 abort();
676 }
677
678 child = fork();
679 if(child == -1) {
680 perror("Debug leaking scalars fork failed");
681 abort();
682 }
683 if (!child) {
684 /* We are the child */
3125a5a4
NC
685 const int sock = fd[1];
686 const int debug_fd = PerlIO_fileno(Perl_debug_log);
687 int f;
808ad2d0
NC
688 const char *where;
689 /* Our success message is an integer 0, and a char 0 */
b61433a9 690 static const char success[sizeof(int) + 1] = {0};
3125a5a4 691
2aa47728 692 close(fd[0]);
2aa47728 693
3125a5a4
NC
694 /* We need to close all other file descriptors otherwise we end up
695 with interesting hangs, where the parent closes its end of a
696 pipe, and sits waiting for (another) child to terminate. Only
697 that child never terminates, because it never gets EOF, because
bf357333
NC
698 we also have the far end of the pipe open. We even need to
699 close the debugging fd, because sometimes it happens to be one
700 end of a pipe, and a process is waiting on the other end for
701 EOF. Normally it would be closed at some point earlier in
702 destruction, but if we happen to cause the pipe to remain open,
703 EOF never occurs, and we get an infinite hang. Hence all the
704 games to pass in a file descriptor if it's actually needed. */
3125a5a4
NC
705
706 f = sysconf(_SC_OPEN_MAX);
707 if(f < 0) {
808ad2d0
NC
708 where = "sysconf failed";
709 goto abort;
3125a5a4
NC
710 }
711 while (f--) {
712 if (f == sock)
713 continue;
3125a5a4
NC
714 close(f);
715 }
716
2aa47728
NC
717 while (1) {
718 SV *target;
bf357333
NC
719 union control_un control;
720 struct msghdr msg;
721 struct iovec vec[1];
722 struct cmsghdr *cmptr;
723 ssize_t got;
724 int got_fd;
725
726 msg.msg_control = control.control;
727 msg.msg_controllen = sizeof(control.control);
728 /* We're a connected socket so we don't need a source */
729 msg.msg_name = NULL;
730 msg.msg_namelen = 0;
731 msg.msg_iov = vec;
c3caa5c3 732 msg.msg_iovlen = C_ARRAY_LENGTH(vec);
bf357333
NC
733
734 vec[0].iov_base = (void*)&target;
735 vec[0].iov_len = sizeof(target);
736
737 got = recvmsg(sock, &msg, 0);
2aa47728
NC
738
739 if(got == 0)
740 break;
741 if(got < 0) {
808ad2d0
NC
742 where = "recv failed";
743 goto abort;
2aa47728
NC
744 }
745 if(got < sizeof(target)) {
808ad2d0
NC
746 where = "short recv";
747 goto abort;
2aa47728 748 }
bf357333 749
808ad2d0
NC
750 if(!(cmptr = CMSG_FIRSTHDR(&msg))) {
751 where = "no cmsg";
752 goto abort;
753 }
754 if(cmptr->cmsg_len != CMSG_LEN(sizeof(int))) {
755 where = "wrong cmsg_len";
756 goto abort;
757 }
758 if(cmptr->cmsg_level != SOL_SOCKET) {
759 where = "wrong cmsg_level";
760 goto abort;
761 }
762 if(cmptr->cmsg_type != SCM_RIGHTS) {
763 where = "wrong cmsg_type";
764 goto abort;
765 }
bf357333
NC
766
767 got_fd = *(int*)CMSG_DATA(cmptr);
768 /* For our last little bit of trickery, put the file descriptor
769 back into Perl_debug_log, as if we never actually closed it
770 */
808ad2d0
NC
771 if(got_fd != debug_fd) {
772 if (dup2(got_fd, debug_fd) == -1) {
773 where = "dup2";
774 goto abort;
775 }
776 }
2aa47728 777 sv_dump(target);
bf357333 778
2aa47728
NC
779 PerlIO_flush(Perl_debug_log);
780
808ad2d0 781 got = write(sock, &success, sizeof(success));
2aa47728
NC
782
783 if(got < 0) {
808ad2d0
NC
784 where = "write failed";
785 goto abort;
2aa47728 786 }
808ad2d0
NC
787 if(got < sizeof(success)) {
788 where = "short write";
789 goto abort;
2aa47728
NC
790 }
791 }
792 _exit(0);
808ad2d0
NC
793 abort:
794 {
795 int send_errno = errno;
796 unsigned char length = (unsigned char) strlen(where);
797 struct iovec failure[3] = {
798 {(void*)&send_errno, sizeof(send_errno)},
799 {&length, 1},
800 {(void*)where, length}
801 };
802 int got = writev(sock, failure, 3);
803 /* Bad news travels fast. Faster than data. We'll get a SIGPIPE
804 in the parent if we try to read from the socketpair after the
805 child has exited, even if there was data to read.
806 So sleep a bit to give the parent a fighting chance of
807 reading the data. */
808 sleep(2);
809 _exit((got == -1) ? errno : 0);
810 }
bf357333 811 /* End of child. */
2aa47728 812 }
41e4abd8 813 PL_dumper_fd = fd[0];
2aa47728
NC
814 close(fd[1]);
815 }
816#endif
817
ff0cee69
PP
818 /* We must account for everything. */
819
820 /* Destroy the main CV and syntax tree */
37e77c23
FC
821 /* Set PL_curcop now, because destroying ops can cause new SVs
822 to be generated in Perl_pad_swipe, and when running with
823 -DDEBUG_LEAKING_SCALARS they expect PL_curcop to point to a valid
824 op from which the filename structure member is copied. */
17fbfdf6 825 PL_curcop = &PL_compiling;
3280af22 826 if (PL_main_root) {
4e380990
DM
827 /* ensure comppad/curpad to refer to main's pad */
828 if (CvPADLIST(PL_main_cv)) {
829 PAD_SET_CUR_NOSAVE(CvPADLIST(PL_main_cv), 1);
325e1816 830 PL_comppad_name = PadlistNAMES(CvPADLIST(PL_main_cv));
4e380990 831 }
3280af22 832 op_free(PL_main_root);
5f66b61c 833 PL_main_root = NULL;
a0d0e21e 834 }
5f66b61c 835 PL_main_start = NULL;
aac9d523
DM
836 /* note that PL_main_cv isn't usually actually freed at this point,
837 * due to the CvOUTSIDE refs from subs compiled within it. It will
838 * get freed once all the subs are freed in sv_clean_all(), for
839 * destruct_level > 0 */
3280af22 840 SvREFCNT_dec(PL_main_cv);
601f1833 841 PL_main_cv = NULL;
ca7b837b 842 PERL_SET_PHASE(PERL_PHASE_DESTRUCT);
ff0cee69 843
13621cfb
NIS
844 /* Tell PerlIO we are about to tear things apart in case
845 we have layers which are using resources that should
846 be cleaned up now.
847 */
848
849 PerlIO_destruct(aTHX);
850
ddf23d4a
SM
851 /*
852 * Try to destruct global references. We do this first so that the
853 * destructors and destructees still exist. Some sv's might remain.
854 * Non-referenced objects are on their own.
855 */
856 sv_clean_objs();
8990e307 857
5cd24f17 858 /* unhook hooks which will soon be, or use, destroyed data */
3280af22 859 SvREFCNT_dec(PL_warnhook);
a0714e2c 860 PL_warnhook = NULL;
3280af22 861 SvREFCNT_dec(PL_diehook);
a0714e2c 862 PL_diehook = NULL;
5cd24f17 863
4b556e6c 864 /* call exit list functions */
3280af22 865 while (PL_exitlistlen-- > 0)
acfe0abc 866 PL_exitlist[PL_exitlistlen].fn(aTHX_ PL_exitlist[PL_exitlistlen].ptr);
4b556e6c 867
3280af22 868 Safefree(PL_exitlist);
4b556e6c 869
1c4916e5
CB
870 PL_exitlist = NULL;
871 PL_exitlistlen = 0;
872
a3e6e81e
NC
873 SvREFCNT_dec(PL_registered_mros);
874
551a8b83 875 /* jettison our possibly duplicated environment */
4b647fb0
DM
876 /* if PERL_USE_SAFE_PUTENV is defined environ will not have been copied
877 * so we certainly shouldn't free it here
878 */
2f42fcb0 879#ifndef PERL_MICRO
4b647fb0 880#if defined(USE_ENVIRON_ARRAY) && !defined(PERL_USE_SAFE_PUTENV)
50acdf95 881 if (environ != PL_origenviron && !PL_use_safe_putenv
4efc5df6
GS
882#ifdef USE_ITHREADS
883 /* only main thread can free environ[0] contents */
884 && PL_curinterp == aTHX
885#endif
886 )
887 {
551a8b83
JH
888 I32 i;
889
890 for (i = 0; environ[i]; i++)
4b420006 891 safesysfree(environ[i]);
0631ea03 892
4b420006
JH
893 /* Must use safesysfree() when working with environ. */
894 safesysfree(environ);
551a8b83
JH
895
896 environ = PL_origenviron;
897 }
898#endif
2f42fcb0 899#endif /* !PERL_MICRO */
551a8b83 900
30985c42
JH
901 if (destruct_level == 0) {
902
903 DEBUG_P(debprofdump());
904
905#if defined(PERLIO_LAYERS)
906 /* No more IO - including error messages ! */
907 PerlIO_cleanup(aTHX);
908#endif
909
910 CopFILE_free(&PL_compiling);
30985c42
JH
911
912 /* The exit() function will do everything that needs doing. */
913 return STATUS_EXIT;
914 }
915
9fa9f06b
KW
916 /* Below, do clean up for when PERL_DESTRUCT_LEVEL is not 0 */
917
5f8cb046
DM
918#ifdef USE_ITHREADS
919 /* the syntax tree is shared between clones
920 * so op_free(PL_main_root) only ReREFCNT_dec's
921 * REGEXPs in the parent interpreter
922 * we need to manually ReREFCNT_dec for the clones
923 */
0547a729
DM
924 {
925 I32 i = AvFILLp(PL_regex_padav);
926 SV **ary = AvARRAY(PL_regex_padav);
927
928 for (; i; i--) {
929 SvREFCNT_dec(ary[i]);
930 ary[i] = &PL_sv_undef;
931 }
932 }
5f8cb046
DM
933#endif
934
0547a729 935
ad64d0ec 936 SvREFCNT_dec(MUTABLE_SV(PL_stashcache));
081fc587
AB
937 PL_stashcache = NULL;
938
5f05dabc
PP
939 /* loosen bonds of global variables */
940
2f9285f8
DM
941 /* XXX can PL_parser still be non-null here? */
942 if(PL_parser && PL_parser->rsfp) {
943 (void)PerlIO_close(PL_parser->rsfp);
944 PL_parser->rsfp = NULL;
8ebc5c01
PP
945 }
946
84386e14
RGS
947 if (PL_minus_F) {
948 Safefree(PL_splitstr);
949 PL_splitstr = NULL;
950 }
951
8ebc5c01 952 /* switches */
3280af22
NIS
953 PL_minus_n = FALSE;
954 PL_minus_p = FALSE;
955 PL_minus_l = FALSE;
956 PL_minus_a = FALSE;
957 PL_minus_F = FALSE;
958 PL_doswitches = FALSE;
599cee73 959 PL_dowarn = G_WARN_OFF;
1a904fc8 960#ifdef PERL_SAWAMPERSAND
d3b97530 961 PL_sawampersand = 0; /* must save all match strings */
1a904fc8 962#endif
3280af22
NIS
963 PL_unsafe = FALSE;
964
965 Safefree(PL_inplace);
bd61b366 966 PL_inplace = NULL;
a7cb1f99 967 SvREFCNT_dec(PL_patchlevel);
3280af22
NIS
968
969 if (PL_e_script) {
970 SvREFCNT_dec(PL_e_script);
a0714e2c 971 PL_e_script = NULL;
8ebc5c01
PP
972 }
973
bf9cdc68
RG
974 PL_perldb = 0;
975
8ebc5c01
PP
976 /* magical thingies */
977
e23d9e2f
CS
978 SvREFCNT_dec(PL_ofsgv); /* *, */
979 PL_ofsgv = NULL;
5f05dabc 980
7889fe52 981 SvREFCNT_dec(PL_ors_sv); /* $\ */
a0714e2c 982 PL_ors_sv = NULL;
8ebc5c01 983
3280af22 984 SvREFCNT_dec(PL_rs); /* $/ */
a0714e2c 985 PL_rs = NULL;
dc92893f 986
d33b2eba 987 Safefree(PL_osname); /* $^O */
bd61b366 988 PL_osname = NULL;
5f05dabc 989
3280af22 990 SvREFCNT_dec(PL_statname);
a0714e2c
SS
991 PL_statname = NULL;
992 PL_statgv = NULL;
5f05dabc 993
8ebc5c01
PP
994 /* defgv, aka *_ should be taken care of elsewhere */
995
7d5ea4e7
GS
996 /* float buffer */
997 Safefree(PL_efloatbuf);
bd61b366 998 PL_efloatbuf = NULL;
7d5ea4e7
GS
999 PL_efloatsize = 0;
1000
8ebc5c01 1001 /* startup and shutdown function lists */
3280af22 1002 SvREFCNT_dec(PL_beginav);
5a837c8f 1003 SvREFCNT_dec(PL_beginav_save);
3280af22 1004 SvREFCNT_dec(PL_endav);
7d30b5c4 1005 SvREFCNT_dec(PL_checkav);
ece599bd 1006 SvREFCNT_dec(PL_checkav_save);
3c10abe3
AG
1007 SvREFCNT_dec(PL_unitcheckav);
1008 SvREFCNT_dec(PL_unitcheckav_save);
3280af22 1009 SvREFCNT_dec(PL_initav);
7d49f689
NC
1010 PL_beginav = NULL;
1011 PL_beginav_save = NULL;
1012 PL_endav = NULL;
1013 PL_checkav = NULL;
1014 PL_checkav_save = NULL;
3c10abe3
AG
1015 PL_unitcheckav = NULL;
1016 PL_unitcheckav_save = NULL;
7d49f689 1017 PL_initav = NULL;
5618dfe8 1018
8ebc5c01 1019 /* shortcuts just get cleared */
a0714e2c
SS
1020 PL_hintgv = NULL;
1021 PL_errgv = NULL;
a0714e2c
SS
1022 PL_argvoutgv = NULL;
1023 PL_stdingv = NULL;
1024 PL_stderrgv = NULL;
1025 PL_last_in_gv = NULL;
a0714e2c
SS
1026 PL_DBsingle = NULL;
1027 PL_DBtrace = NULL;
1028 PL_DBsignal = NULL;
a6d69523
TC
1029 PL_DBsingle_iv = 0;
1030 PL_DBtrace_iv = 0;
1031 PL_DBsignal_iv = 0;
601f1833 1032 PL_DBcv = NULL;
7d49f689 1033 PL_dbargs = NULL;
5c284bb0 1034 PL_debstash = NULL;
8ebc5c01 1035
cf93a474 1036 SvREFCNT_dec(PL_envgv);
f03015cd 1037 SvREFCNT_dec(PL_incgv);
722fa0e9 1038 SvREFCNT_dec(PL_argvgv);
475b1e90 1039 SvREFCNT_dec(PL_replgv);
8cece913
FC
1040 SvREFCNT_dec(PL_DBgv);
1041 SvREFCNT_dec(PL_DBline);
1042 SvREFCNT_dec(PL_DBsub);
cf93a474 1043 PL_envgv = NULL;
f03015cd 1044 PL_incgv = NULL;
722fa0e9 1045 PL_argvgv = NULL;
475b1e90 1046 PL_replgv = NULL;
8cece913
FC
1047 PL_DBgv = NULL;
1048 PL_DBline = NULL;
1049 PL_DBsub = NULL;
1050
7a1c5554 1051 SvREFCNT_dec(PL_argvout_stack);
7d49f689 1052 PL_argvout_stack = NULL;
8ebc5c01 1053
5c831c24 1054 SvREFCNT_dec(PL_modglobal);
5c284bb0 1055 PL_modglobal = NULL;
5c831c24 1056 SvREFCNT_dec(PL_preambleav);
7d49f689 1057 PL_preambleav = NULL;
5c831c24 1058 SvREFCNT_dec(PL_subname);
a0714e2c 1059 PL_subname = NULL;
ca0c25f6 1060#ifdef PERL_USES_PL_PIDSTATUS
5c831c24 1061 SvREFCNT_dec(PL_pidstatus);
5c284bb0 1062 PL_pidstatus = NULL;
ca0c25f6 1063#endif
5c831c24 1064 SvREFCNT_dec(PL_toptarget);
a0714e2c 1065 PL_toptarget = NULL;
5c831c24 1066 SvREFCNT_dec(PL_bodytarget);
a0714e2c
SS
1067 PL_bodytarget = NULL;
1068 PL_formtarget = NULL;
5c831c24 1069
d33b2eba 1070 /* free locale stuff */
b9582b6a 1071#ifdef USE_LOCALE_COLLATE
d33b2eba 1072 Safefree(PL_collation_name);
bd61b366 1073 PL_collation_name = NULL;
b9582b6a 1074#endif
d33b2eba 1075
b9582b6a 1076#ifdef USE_LOCALE_NUMERIC
d33b2eba 1077 Safefree(PL_numeric_name);
bd61b366 1078 PL_numeric_name = NULL;
a453c169 1079 SvREFCNT_dec(PL_numeric_radix_sv);
a0714e2c 1080 PL_numeric_radix_sv = NULL;
b9582b6a 1081#endif
d33b2eba 1082
9c0b6888
KW
1083 /* clear character classes */
1084 for (i = 0; i < POSIX_SWASH_COUNT; i++) {
1085 SvREFCNT_dec(PL_utf8_swash_ptrs[i]);
1086 PL_utf8_swash_ptrs[i] = NULL;
1087 }
5c831c24
GS
1088 SvREFCNT_dec(PL_utf8_mark);
1089 SvREFCNT_dec(PL_utf8_toupper);
4dbdbdc2 1090 SvREFCNT_dec(PL_utf8_totitle);
5c831c24 1091 SvREFCNT_dec(PL_utf8_tolower);
b4e400f9 1092 SvREFCNT_dec(PL_utf8_tofold);
82686b01
JH
1093 SvREFCNT_dec(PL_utf8_idstart);
1094 SvREFCNT_dec(PL_utf8_idcont);
c60f4405 1095 SvREFCNT_dec(PL_utf8_foldable);
2726813d 1096 SvREFCNT_dec(PL_utf8_foldclosures);
9fa9f06b 1097 SvREFCNT_dec(PL_AboveLatin1);
e0a1ff7a 1098 SvREFCNT_dec(PL_InBitmap);
9fa9f06b
KW
1099 SvREFCNT_dec(PL_UpperLatin1);
1100 SvREFCNT_dec(PL_Latin1);
1101 SvREFCNT_dec(PL_NonL1NonFinalFold);
1102 SvREFCNT_dec(PL_HasMultiCharFold);
5b7de470 1103#ifdef USE_LOCALE_CTYPE
780fcc9f 1104 SvREFCNT_dec(PL_warn_locale);
5b7de470 1105#endif
a0714e2c
SS
1106 PL_utf8_mark = NULL;
1107 PL_utf8_toupper = NULL;
1108 PL_utf8_totitle = NULL;
1109 PL_utf8_tolower = NULL;
1110 PL_utf8_tofold = NULL;
1111 PL_utf8_idstart = NULL;
1112 PL_utf8_idcont = NULL;
2726813d 1113 PL_utf8_foldclosures = NULL;
9fa9f06b 1114 PL_AboveLatin1 = NULL;
e0a1ff7a 1115 PL_InBitmap = NULL;
9fa9f06b 1116 PL_HasMultiCharFold = NULL;
5b7de470 1117#ifdef USE_LOCALE_CTYPE
780fcc9f 1118 PL_warn_locale = NULL;
5b7de470 1119#endif
9fa9f06b
KW
1120 PL_Latin1 = NULL;
1121 PL_NonL1NonFinalFold = NULL;
1122 PL_UpperLatin1 = NULL;
86f72d56 1123 for (i = 0; i < POSIX_CC_COUNT; i++) {
cac6e0ca
KW
1124 SvREFCNT_dec(PL_XPosix_ptrs[i]);
1125 PL_XPosix_ptrs[i] = NULL;
86f72d56 1126 }
64935bc6 1127 PL_GCB_invlist = NULL;
6b659339 1128 PL_LB_invlist = NULL;
06ae2722 1129 PL_SB_invlist = NULL;
ae3bb8ea 1130 PL_WB_invlist = NULL;
9e7ded3f 1131 PL_Assigned_invlist = NULL;
5c831c24 1132
971a9dd3 1133 if (!specialWARN(PL_compiling.cop_warnings))
72dc9ed5 1134 PerlMemShared_free(PL_compiling.cop_warnings);
a0714e2c 1135 PL_compiling.cop_warnings = NULL;
20439bc7
Z
1136 cophh_free(CopHINTHASH_get(&PL_compiling));
1137 CopHINTHASH_set(&PL_compiling, cophh_new_empty());
05ec9bb3 1138 CopFILE_free(&PL_compiling);
5c831c24 1139
a0d0e21e 1140 /* Prepare to destruct main symbol table. */
5f05dabc 1141
3280af22 1142 hv = PL_defstash;
ca556bcd 1143 /* break ref loop *:: <=> %:: */
854da30f 1144 (void)hv_deletes(hv, "main::", G_DISCARD);
3280af22 1145 PL_defstash = 0;
a0d0e21e 1146 SvREFCNT_dec(hv);
5c831c24 1147 SvREFCNT_dec(PL_curstname);
a0714e2c 1148 PL_curstname = NULL;
a0d0e21e 1149
5a844595
GS
1150 /* clear queued errors */
1151 SvREFCNT_dec(PL_errors);
a0714e2c 1152 PL_errors = NULL;
5a844595 1153
dd69841b
BB
1154 SvREFCNT_dec(PL_isarev);
1155
a0d0e21e 1156 FREETMPS;
9b387841 1157 if (destruct_level >= 2) {
3280af22 1158 if (PL_scopestack_ix != 0)
9b387841
NC
1159 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
1160 "Unbalanced scopes: %ld more ENTERs than LEAVEs\n",
1161 (long)PL_scopestack_ix);
3280af22 1162 if (PL_savestack_ix != 0)
9b387841
NC
1163 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
1164 "Unbalanced saves: %ld more saves than restores\n",
1165 (long)PL_savestack_ix);
3280af22 1166 if (PL_tmps_floor != -1)
9b387841
NC
1167 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced tmps: %ld more allocs than frees\n",
1168 (long)PL_tmps_floor + 1);
a0d0e21e 1169 if (cxstack_ix != -1)
9b387841
NC
1170 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced context: %ld more PUSHes than POPs\n",
1171 (long)cxstack_ix + 1);
a0d0e21e 1172 }
8990e307 1173
0547a729
DM
1174#ifdef USE_ITHREADS
1175 SvREFCNT_dec(PL_regex_padav);
1176 PL_regex_padav = NULL;
1177 PL_regex_pad = NULL;
1178#endif
1179
776df701 1180#ifdef PERL_IMPLICIT_CONTEXT
57bb2458
JH
1181 /* the entries in this list are allocated via SV PVX's, so get freed
1182 * in sv_clean_all */
1183 Safefree(PL_my_cxt_list);
776df701 1184#endif
57bb2458 1185
8990e307 1186 /* Now absolutely destruct everything, somehow or other, loops or no. */
5226ed68
JH
1187
1188 /* the 2 is for PL_fdpid and PL_strtab */
d17ea597 1189 while (sv_clean_all() > 2)
5226ed68
JH
1190 ;
1191
23083432
FC
1192#ifdef USE_ITHREADS
1193 Safefree(PL_stashpad); /* must come after sv_clean_all */
1194#endif
1195
d4777f27
GS
1196 AvREAL_off(PL_fdpid); /* no surviving entries */
1197 SvREFCNT_dec(PL_fdpid); /* needed in io_close() */
7d49f689 1198 PL_fdpid = NULL;
d33b2eba 1199
6c644e78
GS
1200#ifdef HAVE_INTERP_INTERN
1201 sys_intern_clear();
1202#endif
1203
a38ab475
RZ
1204 /* constant strings */
1205 for (i = 0; i < SV_CONSTS_COUNT; i++) {
1206 SvREFCNT_dec(PL_sv_consts[i]);
1207 PL_sv_consts[i] = NULL;
1208 }
1209
6e72f9df
PP
1210 /* Destruct the global string table. */
1211 {
1212 /* Yell and reset the HeVAL() slots that are still holding refcounts,
1213 * so that sv_free() won't fail on them.
80459961
NC
1214 * Now that the global string table is using a single hunk of memory
1215 * for both HE and HEK, we either need to explicitly unshare it the
1216 * correct way, or actually free things here.
6e72f9df 1217 */
80459961
NC
1218 I32 riter = 0;
1219 const I32 max = HvMAX(PL_strtab);
c4420975 1220 HE * const * const array = HvARRAY(PL_strtab);
80459961
NC
1221 HE *hent = array[0];
1222
6e72f9df 1223 for (;;) {
0453d815 1224 if (hent && ckWARN_d(WARN_INTERNAL)) {
44f8325f 1225 HE * const next = HeNEXT(hent);
9014280d 1226 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
44f8325f 1227 "Unbalanced string table refcount: (%ld) for \"%s\"",
de616631 1228 (long)hent->he_valu.hent_refcount, HeKEY(hent));
80459961
NC
1229 Safefree(hent);
1230 hent = next;
6e72f9df
PP
1231 }
1232 if (!hent) {
1233 if (++riter > max)
1234 break;
1235 hent = array[riter];
1236 }
1237 }
80459961
NC
1238
1239 Safefree(array);
1240 HvARRAY(PL_strtab) = 0;
1241 HvTOTALKEYS(PL_strtab) = 0;
6e72f9df 1242 }
3280af22 1243 SvREFCNT_dec(PL_strtab);
6e72f9df 1244
e652bb2f 1245#ifdef USE_ITHREADS
c21d1a0f 1246 /* free the pointer tables used for cloning */
a0739874 1247 ptr_table_free(PL_ptr_table);
bf9cdc68 1248 PL_ptr_table = (PTR_TBL_t*)NULL;
53186e96 1249#endif
a0739874 1250
d33b2eba
GS
1251 /* free special SVs */
1252
1253 SvREFCNT(&PL_sv_yes) = 0;
1254 sv_clear(&PL_sv_yes);
1255 SvANY(&PL_sv_yes) = NULL;
4c5e2b0d 1256 SvFLAGS(&PL_sv_yes) = 0;
d33b2eba
GS
1257
1258 SvREFCNT(&PL_sv_no) = 0;
1259 sv_clear(&PL_sv_no);
1260 SvANY(&PL_sv_no) = NULL;
4c5e2b0d 1261 SvFLAGS(&PL_sv_no) = 0;
01724ea0 1262
9f375a43
DM
1263 {
1264 int i;
1265 for (i=0; i<=2; i++) {
1266 SvREFCNT(PERL_DEBUG_PAD(i)) = 0;
1267 sv_clear(PERL_DEBUG_PAD(i));
1268 SvANY(PERL_DEBUG_PAD(i)) = NULL;
1269 SvFLAGS(PERL_DEBUG_PAD(i)) = 0;
1270 }
1271 }
1272
0453d815 1273 if (PL_sv_count != 0 && ckWARN_d(WARN_INTERNAL))
9014280d 1274 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Scalars leaked: %ld\n", (long)PL_sv_count);
6e72f9df 1275
eba0f806
DM
1276#ifdef DEBUG_LEAKING_SCALARS
1277 if (PL_sv_count != 0) {
1278 SV* sva;
1279 SV* sv;
eb578fdb 1280 SV* svend;
eba0f806 1281
ad64d0ec 1282 for (sva = PL_sv_arenaroot; sva; sva = MUTABLE_SV(SvANY(sva))) {
eba0f806
DM
1283 svend = &sva[SvREFCNT(sva)];
1284 for (sv = sva + 1; sv < svend; ++sv) {
e4787c0c 1285 if (SvTYPE(sv) != (svtype)SVTYPEMASK) {
a548cda8 1286 PerlIO_printf(Perl_debug_log, "leaked: sv=0x%p"
61b61456 1287 " flags=0x%"UVxf
fd0854ff 1288 " refcnt=%"UVuf pTHX__FORMAT "\n"
147e3846
KW
1289 "\tallocated at %s:%d %s %s (parent 0x%" UVxf ");"
1290 "serial %" UVuf "\n",
574b8821
NC
1291 (void*)sv, (UV)sv->sv_flags, (UV)sv->sv_refcnt
1292 pTHX__VALUE,
fd0854ff
DM
1293 sv->sv_debug_file ? sv->sv_debug_file : "(unknown)",
1294 sv->sv_debug_line,
1295 sv->sv_debug_inpad ? "for" : "by",
1296 sv->sv_debug_optype ?
1297 PL_op_name[sv->sv_debug_optype]: "(none)",
cd676548 1298 PTR2UV(sv->sv_debug_parent),
cbe56f1d 1299 sv->sv_debug_serial
fd0854ff 1300 );
2aa47728 1301#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
41e4abd8 1302 Perl_dump_sv_child(aTHX_ sv);
2aa47728 1303#endif
eba0f806
DM
1304 }
1305 }
1306 }
1307 }
2aa47728
NC
1308#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
1309 {
1310 int status;
1311 fd_set rset;
1312 /* Wait for up to 4 seconds for child to terminate.
1313 This seems to be the least effort way of timing out on reaping
1314 its exit status. */
1315 struct timeval waitfor = {4, 0};
41e4abd8 1316 int sock = PL_dumper_fd;
2aa47728
NC
1317
1318 shutdown(sock, 1);
1319 FD_ZERO(&rset);
1320 FD_SET(sock, &rset);
1321 select(sock + 1, &rset, NULL, NULL, &waitfor);
1322 waitpid(child, &status, WNOHANG);
1323 close(sock);
1324 }
1325#endif
eba0f806 1326#endif
77abb4c6
NC
1327#ifdef DEBUG_LEAKING_SCALARS_ABORT
1328 if (PL_sv_count)
1329 abort();
1330#endif
bf9cdc68 1331 PL_sv_count = 0;
eba0f806 1332
56a2bab7 1333#if defined(PERLIO_LAYERS)
3a1ee7e8
NIS
1334 /* No more IO - including error messages ! */
1335 PerlIO_cleanup(aTHX);
1336#endif
1337
9f4bd222 1338 /* sv_undef needs to stay immortal until after PerlIO_cleanup
a0714e2c 1339 as currently layers use it rather than NULL as a marker
9f4bd222
NIS
1340 for no arg - and will try and SvREFCNT_dec it.
1341 */
1342 SvREFCNT(&PL_sv_undef) = 0;
1343 SvREADONLY_off(&PL_sv_undef);
1344
3280af22 1345 Safefree(PL_origfilename);
bd61b366 1346 PL_origfilename = NULL;
43c5f42d 1347 Safefree(PL_reg_curpm);
dd28f7bb 1348 free_tied_hv_pool();
3280af22 1349 Safefree(PL_op_mask);
cf36064f 1350 Safefree(PL_psig_name);
bf9cdc68 1351 PL_psig_name = (SV**)NULL;
d525a7b2 1352 PL_psig_ptr = (SV**)NULL;
31c91b43
LR
1353 {
1354 /* We need to NULL PL_psig_pend first, so that
1355 signal handlers know not to use it */
1356 int *psig_save = PL_psig_pend;
1357 PL_psig_pend = (int*)NULL;
1358 Safefree(psig_save);
1359 }
6e72f9df 1360 nuke_stacks();
284167a5
SM
1361 TAINTING_set(FALSE);
1362 TAINT_WARN_set(FALSE);
3280af22 1363 PL_hints = 0; /* Reset hints. Should hints be per-interpreter ? */
ac27b0f5 1364
a0d0e21e 1365 DEBUG_P(debprofdump());
d33b2eba 1366
b173165c
FC
1367 PL_debug = 0;
1368
e5dd39fc 1369#ifdef USE_REENTRANT_API
10bc17b6 1370 Perl_reentrant_free(aTHX);
e5dd39fc
AB
1371#endif
1372
a24da70b
NC
1373 /* These all point to HVs that are about to be blown away.
1374 Code in core and on CPAN assumes that if the interpreter is re-started
1375 that they will be cleanly NULL or pointing to a valid HV. */
1376 PL_custom_op_names = NULL;
1377 PL_custom_op_descs = NULL;
1378 PL_custom_ops = NULL;
1379
612f20c3
GS
1380 sv_free_arenas();
1381
5d9a96ca
DM
1382 while (PL_regmatch_slab) {
1383 regmatch_slab *s = PL_regmatch_slab;
1384 PL_regmatch_slab = PL_regmatch_slab->next;
1385 Safefree(s);
1386 }
1387
fc36a67e
PP
1388 /* As the absolutely last thing, free the non-arena SV for mess() */
1389
3280af22 1390 if (PL_mess_sv) {
f350b448
NC
1391 /* we know that type == SVt_PVMG */
1392
9c63abab 1393 /* it could have accumulated taint magic */
f350b448
NC
1394 MAGIC* mg;
1395 MAGIC* moremagic;
1396 for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
1397 moremagic = mg->mg_moremagic;
1398 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
1399 && mg->mg_len >= 0)
1400 Safefree(mg->mg_ptr);
1401 Safefree(mg);
9c63abab 1402 }
f350b448 1403
fc36a67e 1404 /* we know that type >= SVt_PV */
8bd4d4c5 1405 SvPV_free(PL_mess_sv);
3280af22
NIS
1406 Safefree(SvANY(PL_mess_sv));
1407 Safefree(PL_mess_sv);
a0714e2c 1408 PL_mess_sv = NULL;
fc36a67e 1409 }
37038d91 1410 return STATUS_EXIT;
79072805
LW
1411}
1412
954c1994
GS
1413/*
1414=for apidoc perl_free
1415
1416Releases a Perl interpreter. See L<perlembed>.
1417
1418=cut
1419*/
1420
79072805 1421void
0cb96387 1422perl_free(pTHXx)
79072805 1423{
5174512c
NC
1424 dVAR;
1425
7918f24d
NC
1426 PERL_ARGS_ASSERT_PERL_FREE;
1427
c301d606
DM
1428 if (PL_veto_cleanup)
1429 return;
1430
7cb608b5 1431#ifdef PERL_TRACK_MEMPOOL
55ef9aae
MHM
1432 {
1433 /*
1434 * Don't free thread memory if PERL_DESTRUCT_LEVEL is set to a non-zero
1435 * value as we're probably hunting memory leaks then
1436 */
36e77d41 1437 if (PL_perl_destruct_level == 0) {
4fd0a9b8 1438 const U32 old_debug = PL_debug;
55ef9aae
MHM
1439 /* Emulate the PerlHost behaviour of free()ing all memory allocated in this
1440 thread at thread exit. */
4fd0a9b8
NC
1441 if (DEBUG_m_TEST) {
1442 PerlIO_puts(Perl_debug_log, "Disabling memory debugging as we "
1443 "free this thread's memory\n");
1444 PL_debug &= ~ DEBUG_m_FLAG;
1445 }
6edcbed6
DD
1446 while(aTHXx->Imemory_debug_header.next != &(aTHXx->Imemory_debug_header)){
1447 char * next = (char *)(aTHXx->Imemory_debug_header.next);
1448 Malloc_t ptr = PERL_MEMORY_DEBUG_HEADER_SIZE + next;
1449 safesysfree(ptr);
1450 }
4fd0a9b8 1451 PL_debug = old_debug;
55ef9aae
MHM
1452 }
1453 }
7cb608b5
NC
1454#endif
1455
acfe0abc 1456#if defined(WIN32) || defined(NETWARE)
ce3e5b80 1457# if defined(PERL_IMPLICIT_SYS)
b36c9a52 1458 {
acfe0abc 1459# ifdef NETWARE
7af12a34 1460 void *host = nw_internal_host;
7af12a34 1461 PerlMem_free(aTHXx);
7af12a34 1462 nw_delete_internal_host(host);
acfe0abc 1463# else
bdb50480
NC
1464 void *host = w32_internal_host;
1465 PerlMem_free(aTHXx);
7af12a34 1466 win32_delete_internal_host(host);
acfe0abc 1467# endif
7af12a34 1468 }
1c0ca838
GS
1469# else
1470 PerlMem_free(aTHXx);
1471# endif
acfe0abc
GS
1472#else
1473 PerlMem_free(aTHXx);
76e3520e 1474#endif
79072805
LW
1475}
1476
b7f7fff6 1477#if defined(USE_ITHREADS)
aebd1ac7
GA
1478/* provide destructors to clean up the thread key when libperl is unloaded */
1479#ifndef WIN32 /* handled during DLL_PROCESS_DETACH in win32/perllib.c */
1480
826955bd 1481#if defined(__hpux) && !(defined(__ux_version) && __ux_version <= 1020) && !defined(__GNUC__)
aebd1ac7 1482#pragma fini "perl_fini"
666ad1ec
GA
1483#elif defined(__sun) && !defined(__GNUC__)
1484#pragma fini (perl_fini)
aebd1ac7
GA
1485#endif
1486
0dbb1585
AL
1487static void
1488#if defined(__GNUC__)
1489__attribute__((destructor))
aebd1ac7 1490#endif
de009b76 1491perl_fini(void)
aebd1ac7 1492{
27da23d5 1493 dVAR;
5c64bffd
NC
1494 if (
1495#ifdef PERL_GLOBAL_STRUCT_PRIVATE
1496 my_vars &&
1497#endif
1498 PL_curinterp && !PL_veto_cleanup)
aebd1ac7
GA
1499 FREE_THREAD_KEY;
1500}
1501
1502#endif /* WIN32 */
1503#endif /* THREADS */
1504
4b556e6c 1505void
864dbfa3 1506Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
4b556e6c 1507{
3280af22
NIS
1508 Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
1509 PL_exitlist[PL_exitlistlen].fn = fn;
1510 PL_exitlist[PL_exitlistlen].ptr = ptr;
1511 ++PL_exitlistlen;
4b556e6c
JD
1512}
1513
954c1994
GS
1514/*
1515=for apidoc perl_parse
1516
1517Tells a Perl interpreter to parse a Perl script. See L<perlembed>.
1518
1519=cut
1520*/
1521
03d9f026
FC
1522#define SET_CURSTASH(newstash) \
1523 if (PL_curstash != newstash) { \
1524 SvREFCNT_dec(PL_curstash); \
1525 PL_curstash = (HV *)SvREFCNT_inc(newstash); \
1526 }
1527
79072805 1528int
0cb96387 1529perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
8d063cd8 1530{
27da23d5 1531 dVAR;
6224f72b 1532 I32 oldscope;
6224f72b 1533 int ret;
db36c5a1 1534 dJMPENV;
8d063cd8 1535
7918f24d
NC
1536 PERL_ARGS_ASSERT_PERL_PARSE;
1537#ifndef MULTIPLICITY
ed6c66dd 1538 PERL_UNUSED_ARG(my_perl);
7918f24d 1539#endif
eba287cb 1540#if (defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) || defined(USE_HASH_SEED_DEBUG)) && !defined(NO_PERL_HASH_SEED_DEBUG)
b0891165 1541 {
7dc86639
YO
1542 const char * const s = PerlEnv_getenv("PERL_HASH_SEED_DEBUG");
1543
22ff3130 1544 if (s && strEQ(s, "1")) {
25c1b134
TC
1545 const unsigned char *seed= PERL_HASH_SEED;
1546 const unsigned char *seed_end= PERL_HASH_SEED + PERL_HASH_SEED_BYTES;
7dc86639
YO
1547 PerlIO_printf(Perl_debug_log, "HASH_FUNCTION = %s HASH_SEED = 0x", PERL_HASH_FUNC);
1548 while (seed < seed_end) {
1549 PerlIO_printf(Perl_debug_log, "%02x", *seed++);
1550 }
6a5b4183
YO
1551#ifdef PERL_HASH_RANDOMIZE_KEYS
1552 PerlIO_printf(Perl_debug_log, " PERTURB_KEYS = %d (%s)",
1553 PL_HASH_RAND_BITS_ENABLED,
1554 PL_HASH_RAND_BITS_ENABLED == 0 ? "NO" : PL_HASH_RAND_BITS_ENABLED == 1 ? "RANDOM" : "DETERMINISTIC");
1555#endif
7dc86639
YO
1556 PerlIO_printf(Perl_debug_log, "\n");
1557 }
b0891165 1558 }
eba287cb 1559#endif /* #if (defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) ... */
43238333 1560
ea34f6bd 1561#ifdef __amigaos4__
43238333
AB
1562 {
1563 struct NameTranslationInfo nti;
1564 __translate_amiga_to_unix_path_name(&argv[0],&nti);
1565 }
1566#endif
1567
3280af22 1568 PL_origargc = argc;
e2975953 1569 PL_origargv = argv;
a0d0e21e 1570
a2722ac9
GA
1571 if (PL_origalen != 0) {
1572 PL_origalen = 1; /* don't use old PL_origalen if perl_parse() is called again */
1573 }
1574 else {
3cb9023d
JH
1575 /* Set PL_origalen be the sum of the contiguous argv[]
1576 * elements plus the size of the env in case that it is
e9137a8e 1577 * contiguous with the argv[]. This is used in mg.c:Perl_magic_set()
3cb9023d
JH
1578 * as the maximum modifiable length of $0. In the worst case
1579 * the area we are able to modify is limited to the size of
43c32782 1580 * the original argv[0]. (See below for 'contiguous', though.)
3cb9023d 1581 * --jhi */
e1ec3a88 1582 const char *s = NULL;
b7249aaf 1583 const UV mask = ~(UV)(PTRSIZE-1);
43c32782 1584 /* Do the mask check only if the args seem like aligned. */
1b6737cc 1585 const UV aligned =
43c32782
JH
1586 (mask < ~(UV)0) && ((PTR2UV(argv[0]) & mask) == PTR2UV(argv[0]));
1587
1588 /* See if all the arguments are contiguous in memory. Note
1589 * that 'contiguous' is a loose term because some platforms
1590 * align the argv[] and the envp[]. If the arguments look
1591 * like non-aligned, assume that they are 'strictly' or
1592 * 'traditionally' contiguous. If the arguments look like
1593 * aligned, we just check that they are within aligned
1594 * PTRSIZE bytes. As long as no system has something bizarre
1595 * like the argv[] interleaved with some other data, we are
1596 * fine. (Did I just evoke Murphy's Law?) --jhi */
c8941eeb 1597 if (PL_origargv && PL_origargc >= 1 && (s = PL_origargv[0])) {
19742f39 1598 int i;
c8941eeb
JH
1599 while (*s) s++;
1600 for (i = 1; i < PL_origargc; i++) {
1601 if ((PL_origargv[i] == s + 1
43c32782 1602#ifdef OS2
c8941eeb 1603 || PL_origargv[i] == s + 2
43c32782 1604#endif
c8941eeb
JH
1605 )
1606 ||
1607 (aligned &&
1608 (PL_origargv[i] > s &&
1609 PL_origargv[i] <=
1610 INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1611 )
1612 {
1613 s = PL_origargv[i];
1614 while (*s) s++;
1615 }
1616 else
1617 break;
54bfe034 1618 }
54bfe034 1619 }
a4a109c2
JD
1620
1621#ifndef PERL_USE_SAFE_PUTENV
3cb9023d 1622 /* Can we grab env area too to be used as the area for $0? */
a4a109c2 1623 if (s && PL_origenviron && !PL_use_safe_putenv) {
9d419b5f 1624 if ((PL_origenviron[0] == s + 1)
43c32782
JH
1625 ||
1626 (aligned &&
1627 (PL_origenviron[0] > s &&
1628 PL_origenviron[0] <=
1629 INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1630 )
1631 {
19742f39 1632 int i;
9d419b5f 1633#ifndef OS2 /* ENVIRON is read by the kernel too. */
43c32782
JH
1634 s = PL_origenviron[0];
1635 while (*s) s++;
1636#endif
bd61b366 1637 my_setenv("NoNe SuCh", NULL);
43c32782
JH
1638 /* Force copy of environment. */
1639 for (i = 1; PL_origenviron[i]; i++) {
1640 if (PL_origenviron[i] == s + 1
1641 ||
1642 (aligned &&
1643 (PL_origenviron[i] > s &&
1644 PL_origenviron[i] <=
1645 INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1646 )
1647 {
1648 s = PL_origenviron[i];
1649 while (*s) s++;
1650 }
1651 else
1652 break;
54bfe034 1653 }
43c32782 1654 }
54bfe034 1655 }
a4a109c2
JD
1656#endif /* !defined(PERL_USE_SAFE_PUTENV) */
1657
2d2af554 1658 PL_origalen = s ? s - PL_origargv[0] + 1 : 0;
54bfe034
JH
1659 }
1660
3280af22 1661 if (PL_do_undump) {
a0d0e21e
LW
1662
1663 /* Come here if running an undumped a.out. */
1664
3280af22
NIS
1665 PL_origfilename = savepv(argv[0]);
1666 PL_do_undump = FALSE;
a0d0e21e 1667 cxstack_ix = -1; /* start label stack again */
748a9306 1668 init_ids();
284167a5 1669 assert (!TAINT_get);
b7975bdd 1670 TAINT;
e2051532 1671 set_caret_X();
b7975bdd 1672 TAINT_NOT;
a0d0e21e
LW
1673 init_postdump_symbols(argc,argv,env);
1674 return 0;
1675 }
1676
3280af22 1677 if (PL_main_root) {
3280af22 1678 op_free(PL_main_root);
5f66b61c 1679 PL_main_root = NULL;
ff0cee69 1680 }
5f66b61c 1681 PL_main_start = NULL;
3280af22 1682 SvREFCNT_dec(PL_main_cv);
601f1833 1683 PL_main_cv = NULL;
79072805 1684
3280af22
NIS
1685 time(&PL_basetime);
1686 oldscope = PL_scopestack_ix;
599cee73 1687 PL_dowarn = G_WARN_OFF;
f86702cc 1688
14dd3ad8 1689 JMPENV_PUSH(ret);
6224f72b 1690 switch (ret) {
312caa8e 1691 case 0:
14dd3ad8 1692 parse_body(env,xsinit);
9ebf26ad 1693 if (PL_unitcheckav) {
3c10abe3 1694 call_list(oldscope, PL_unitcheckav);
9ebf26ad
FR
1695 }
1696 if (PL_checkav) {
ca7b837b 1697 PERL_SET_PHASE(PERL_PHASE_CHECK);
7d30b5c4 1698 call_list(oldscope, PL_checkav);
9ebf26ad 1699 }
14dd3ad8
GS
1700 ret = 0;
1701 break;
6224f72b
GS
1702 case 1:
1703 STATUS_ALL_FAILURE;
924ba076 1704 /* FALLTHROUGH */
6224f72b
GS
1705 case 2:
1706 /* my_exit() was called */
3280af22 1707 while (PL_scopestack_ix > oldscope)
6224f72b
GS
1708 LEAVE;
1709 FREETMPS;
03d9f026 1710 SET_CURSTASH(PL_defstash);
9ebf26ad 1711 if (PL_unitcheckav) {
3c10abe3 1712 call_list(oldscope, PL_unitcheckav);
9ebf26ad
FR
1713 }
1714 if (PL_checkav) {
ca7b837b 1715 PERL_SET_PHASE(PERL_PHASE_CHECK);
7d30b5c4 1716 call_list(oldscope, PL_checkav);
9ebf26ad 1717 }
37038d91 1718 ret = STATUS_EXIT;
14dd3ad8 1719 break;
6224f72b 1720 case 3:
bf49b057 1721 PerlIO_printf(Perl_error_log, "panic: top_env\n");
14dd3ad8
GS
1722 ret = 1;
1723 break;
6224f72b 1724 }
14dd3ad8
GS
1725 JMPENV_POP;
1726 return ret;
1727}
1728
4a5df386
NC
1729/* This needs to stay in perl.c, as perl.c is compiled with different flags for
1730 miniperl, and we need to see those flags reflected in the values here. */
1731
1732/* What this returns is subject to change. Use the public interface in Config.
1733 */
1734static void
1735S_Internals_V(pTHX_ CV *cv)
1736{
1737 dXSARGS;
1738#ifdef LOCAL_PATCH_COUNT
1739 const int local_patch_count = LOCAL_PATCH_COUNT;
1740#else
1741 const int local_patch_count = 0;
1742#endif
2dc296d2 1743 const int entries = 3 + local_patch_count;
4a5df386 1744 int i;
fe1c5936 1745 static const char non_bincompat_options[] =
4a5df386
NC
1746# ifdef DEBUGGING
1747 " DEBUGGING"
1748# endif
1749# ifdef NO_MATHOMS
0d311fbe 1750 " NO_MATHOMS"
4a5df386 1751# endif
59b86f4b
DM
1752# ifdef NO_HASH_SEED
1753 " NO_HASH_SEED"
1754# endif
3b0e4ee2
MB
1755# ifdef NO_TAINT_SUPPORT
1756 " NO_TAINT_SUPPORT"
1757# endif
cb26ef7a
MB
1758# ifdef PERL_BOOL_AS_CHAR
1759 " PERL_BOOL_AS_CHAR"
1760# endif
93c10d60
FC
1761# ifdef PERL_COPY_ON_WRITE
1762 " PERL_COPY_ON_WRITE"
1763# endif
4a5df386
NC
1764# ifdef PERL_DISABLE_PMC
1765 " PERL_DISABLE_PMC"
1766# endif
1767# ifdef PERL_DONT_CREATE_GVSV
1768 " PERL_DONT_CREATE_GVSV"
1769# endif
9a044a43
NC
1770# ifdef PERL_EXTERNAL_GLOB
1771 " PERL_EXTERNAL_GLOB"
1772# endif
59b86f4b
DM
1773# ifdef PERL_HASH_FUNC_SIPHASH
1774 " PERL_HASH_FUNC_SIPHASH"
1775# endif
1776# ifdef PERL_HASH_FUNC_SDBM
1777 " PERL_HASH_FUNC_SDBM"
1778# endif
1779# ifdef PERL_HASH_FUNC_DJB2
1780 " PERL_HASH_FUNC_DJB2"
1781# endif
1782# ifdef PERL_HASH_FUNC_SUPERFAST
1783 " PERL_HASH_FUNC_SUPERFAST"
1784# endif
1785# ifdef PERL_HASH_FUNC_MURMUR3
1786 " PERL_HASH_FUNC_MURMUR3"
1787# endif
1788# ifdef PERL_HASH_FUNC_ONE_AT_A_TIME
1789 " PERL_HASH_FUNC_ONE_AT_A_TIME"
1790# endif
1791# ifdef PERL_HASH_FUNC_ONE_AT_A_TIME_HARD
1792 " PERL_HASH_FUNC_ONE_AT_A_TIME_HARD"
1793# endif
1794# ifdef PERL_HASH_FUNC_ONE_AT_A_TIME_OLD
1795 " PERL_HASH_FUNC_ONE_AT_A_TIME_OLD"
1796# endif
4a5df386
NC
1797# ifdef PERL_IS_MINIPERL
1798 " PERL_IS_MINIPERL"
1799# endif
1800# ifdef PERL_MALLOC_WRAP
1801 " PERL_MALLOC_WRAP"
1802# endif
1803# ifdef PERL_MEM_LOG
1804 " PERL_MEM_LOG"
1805# endif
1806# ifdef PERL_MEM_LOG_NOIMPL
1807 " PERL_MEM_LOG_NOIMPL"
1808# endif
4e499636
DM
1809# ifdef PERL_OP_PARENT
1810 " PERL_OP_PARENT"
1811# endif
59b86f4b
DM
1812# ifdef PERL_PERTURB_KEYS_DETERMINISTIC
1813 " PERL_PERTURB_KEYS_DETERMINISTIC"
1814# endif
1815# ifdef PERL_PERTURB_KEYS_DISABLED
1816 " PERL_PERTURB_KEYS_DISABLED"
1817# endif
1818# ifdef PERL_PERTURB_KEYS_RANDOM
1819 " PERL_PERTURB_KEYS_RANDOM"
1820# endif
c3cf41ec
NC
1821# ifdef PERL_PRESERVE_IVUV
1822 " PERL_PRESERVE_IVUV"
1823# endif
c051e30b
NC
1824# ifdef PERL_RELOCATABLE_INCPUSH
1825 " PERL_RELOCATABLE_INCPUSH"
1826# endif
4a5df386
NC
1827# ifdef PERL_USE_DEVEL
1828 " PERL_USE_DEVEL"
1829# endif
1830# ifdef PERL_USE_SAFE_PUTENV
1831 " PERL_USE_SAFE_PUTENV"
1832# endif
102b7877
YO
1833# ifdef SILENT_NO_TAINT_SUPPORT
1834 " SILENT_NO_TAINT_SUPPORT"
1835# endif
a3749cf3
NC
1836# ifdef UNLINK_ALL_VERSIONS
1837 " UNLINK_ALL_VERSIONS"
1838# endif
de618ee4
NC
1839# ifdef USE_ATTRIBUTES_FOR_PERLIO
1840 " USE_ATTRIBUTES_FOR_PERLIO"
1841# endif
4a5df386
NC
1842# ifdef USE_FAST_STDIO
1843 " USE_FAST_STDIO"
1844# endif
eba287cb
YO
1845# ifdef USE_HASH_SEED_EXPLICIT
1846 " USE_HASH_SEED_EXPLICIT"
1847# endif
98548bdf
NC
1848# ifdef USE_LOCALE
1849 " USE_LOCALE"
1850# endif
98548bdf
NC
1851# ifdef USE_LOCALE_CTYPE
1852 " USE_LOCALE_CTYPE"
1853# endif
6937817d
DD
1854# ifdef WIN32_NO_REGISTRY
1855 " USE_NO_REGISTRY"
1856# endif
5a8d8935
NC
1857# ifdef USE_PERL_ATOF
1858 " USE_PERL_ATOF"
1859# endif
0d311fbe
NC
1860# ifdef USE_SITECUSTOMIZE
1861 " USE_SITECUSTOMIZE"
1862# endif
4a5df386
NC
1863 ;
1864 PERL_UNUSED_ARG(cv);
d3db1514 1865 PERL_UNUSED_VAR(items);
4a5df386
NC
1866
1867 EXTEND(SP, entries);
1868
1869 PUSHs(sv_2mortal(newSVpv(PL_bincompat_options, 0)));
1870 PUSHs(Perl_newSVpvn_flags(aTHX_ non_bincompat_options,
1871 sizeof(non_bincompat_options) - 1, SVs_TEMP));
1872
6baa8dbd
NT
1873#ifndef PERL_BUILD_DATE
1874# ifdef __DATE__
1875# ifdef __TIME__
1876# define PERL_BUILD_DATE __DATE__ " " __TIME__
1877# else
1878# define PERL_BUILD_DATE __DATE__
1879# endif
1880# endif
1881#endif
1882
1883#ifdef PERL_BUILD_DATE
4a5df386 1884 PUSHs(Perl_newSVpvn_flags(aTHX_
6baa8dbd 1885 STR_WITH_LEN("Compiled at " PERL_BUILD_DATE),
4a5df386 1886 SVs_TEMP));
4a5df386
NC
1887#else
1888 PUSHs(&PL_sv_undef);
1889#endif
1890
4a5df386
NC
1891 for (i = 1; i <= local_patch_count; i++) {
1892 /* This will be an undef, if PL_localpatches[i] is NULL. */
1893 PUSHs(sv_2mortal(newSVpv(PL_localpatches[i], 0)));
1894 }
1895
1896 XSRETURN(entries);
1897}
1898
be71fc8f
NC
1899#define INCPUSH_UNSHIFT 0x01
1900#define INCPUSH_ADD_OLD_VERS 0x02
1901#define INCPUSH_ADD_VERSIONED_SUB_DIRS 0x04
1902#define INCPUSH_ADD_ARCHONLY_SUB_DIRS 0x08
1903#define INCPUSH_NOT_BASEDIR 0x10
1904#define INCPUSH_CAN_RELOCATE 0x20
1e3208d8
NC
1905#define INCPUSH_ADD_SUB_DIRS \
1906 (INCPUSH_ADD_VERSIONED_SUB_DIRS|INCPUSH_ADD_ARCHONLY_SUB_DIRS)
e28f3139 1907
312caa8e 1908STATIC void *
14dd3ad8 1909S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
312caa8e 1910{
27da23d5 1911 dVAR;
2f9285f8 1912 PerlIO *rsfp;
312caa8e 1913 int argc = PL_origargc;
8f42b153 1914 char **argv = PL_origargv;
e1ec3a88 1915 const char *scriptname = NULL;
402582ca 1916 bool dosearch = FALSE;
eb578fdb 1917 char c;
737c24fc 1918 bool doextract = FALSE;
bd61b366 1919 const char *cddir = NULL;
ab019eaa 1920#ifdef USE_SITECUSTOMIZE
20ef40cf 1921 bool minus_f = FALSE;
ab019eaa 1922#endif
95670bde 1923 SV *linestr_sv = NULL;
5486870f 1924 bool add_read_e_script = FALSE;
87606032 1925 U32 lex_start_flags = 0;
009d90df 1926
ca7b837b 1927 PERL_SET_PHASE(PERL_PHASE_START);
9ebf26ad 1928
6224f72b 1929 init_main_stash();
54310121 1930
c7030b81
NC
1931 {
1932 const char *s;
6224f72b
GS
1933 for (argc--,argv++; argc > 0; argc--,argv++) {
1934 if (argv[0][0] != '-' || !argv[0][1])
1935 break;
6224f72b
GS
1936 s = argv[0]+1;
1937 reswitch:
47f56822 1938 switch ((c = *s)) {
729a02f2 1939 case 'C':
1d5472a9
GS
1940#ifndef PERL_STRICT_CR
1941 case '\r':
1942#endif
6224f72b
GS
1943 case ' ':
1944 case '0':
1945 case 'F':
1946 case 'a':
1947 case 'c':
1948 case 'd':
1949 case 'D':
1950 case 'h':
1951 case 'i':
1952 case 'l':
1953 case 'M':
1954 case 'm':
1955 case 'n':
1956 case 'p':
1957 case 's':
1958 case 'u':
1959 case 'U':
1960 case 'v':
599cee73
PM
1961 case 'W':
1962 case 'X':
6224f72b 1963 case 'w':
97bd5664 1964 if ((s = moreswitches(s)))
6224f72b
GS
1965 goto reswitch;
1966 break;
33b78306 1967
1dbad523 1968 case 't':
dc6d7f5c 1969#if defined(SILENT_NO_TAINT_SUPPORT)
284167a5 1970 /* silently ignore */
dc6d7f5c 1971#elif defined(NO_TAINT_SUPPORT)
3231f579 1972 Perl_croak_nocontext("This perl was compiled without taint support. "
284167a5
SM
1973 "Cowardly refusing to run with -t or -T flags");
1974#else
22f7c9c9 1975 CHECK_MALLOC_TOO_LATE_FOR('t');
284167a5
SM
1976 if( !TAINTING_get ) {
1977 TAINT_WARN_set(TRUE);
1978 TAINTING_set(TRUE);
317ea90d 1979 }
284167a5 1980#endif
317ea90d
MS
1981 s++;
1982 goto reswitch;
6224f72b 1983 case 'T':
dc6d7f5c 1984#if defined(SILENT_NO_TAINT_SUPPORT)
284167a5 1985 /* silently ignore */
dc6d7f5c 1986#elif defined(NO_TAINT_SUPPORT)
3231f579 1987 Perl_croak_nocontext("This perl was compiled without taint support. "
284167a5
SM
1988 "Cowardly refusing to run with -t or -T flags");
1989#else
22f7c9c9 1990 CHECK_MALLOC_TOO_LATE_FOR('T');
284167a5
SM
1991 TAINTING_set(TRUE);
1992 TAINT_WARN_set(FALSE);
1993#endif
6224f72b
GS
1994 s++;
1995 goto reswitch;
f86702cc 1996
bc9b29db
RH
1997 case 'E':
1998 PL_minus_E = TRUE;
924ba076 1999 /* FALLTHROUGH */
6224f72b 2000 case 'e':
f20b2998 2001 forbid_setid('e', FALSE);
3280af22 2002 if (!PL_e_script) {
396482e1 2003 PL_e_script = newSVpvs("");
5486870f 2004 add_read_e_script = TRUE;
6224f72b
GS
2005 }
2006 if (*++s)
3280af22 2007 sv_catpv(PL_e_script, s);
6224f72b 2008 else if (argv[1]) {
3280af22 2009 sv_catpv(PL_e_script, argv[1]);
6224f72b
GS
2010 argc--,argv++;
2011 }
2012 else
47f56822 2013 Perl_croak(aTHX_ "No code specified for -%c", c);
396482e1 2014 sv_catpvs(PL_e_script, "\n");
6224f72b 2015 break;
afe37c7d 2016
20ef40cf 2017 case 'f':
f5542d3a 2018#ifdef USE_SITECUSTOMIZE
20ef40cf 2019 minus_f = TRUE;
f5542d3a 2020#endif
20ef40cf
GA
2021 s++;
2022 goto reswitch;
2023
6224f72b 2024 case 'I': /* -I handled both here and in moreswitches() */
f20b2998 2025 forbid_setid('I', FALSE);
bd61b366 2026 if (!*++s && (s=argv[1]) != NULL) {
6224f72b
GS
2027 argc--,argv++;
2028 }
6224f72b 2029 if (s && *s) {
0df16ed7 2030 STRLEN len = strlen(s);
55b4bc1c 2031 incpush(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS);
0df16ed7
GS
2032 }
2033 else
a67e862a 2034 Perl_croak(aTHX_ "No directory specified for -I");
6224f72b 2035 break;
6224f72b 2036 case 'S':
f20b2998 2037 forbid_setid('S', FALSE);
6224f72b
GS
2038 dosearch = TRUE;
2039 s++;
2040 goto reswitch;
2041 case 'V':
7edfd0ef
NC
2042 {
2043 SV *opts_prog;
2044
7edfd0ef 2045 if (*++s != ':') {
37ca4a5b 2046 opts_prog = newSVpvs("use Config; Config::_V()");
7edfd0ef
NC
2047 }
2048 else {
2049 ++s;
2050 opts_prog = Perl_newSVpvf(aTHX_
37ca4a5b 2051 "use Config; Config::config_vars(qw%c%s%c)",
7edfd0ef
NC
2052 0, s, 0);
2053 s += strlen(s);
2054 }
37ca4a5b 2055 Perl_av_create_and_push(aTHX_ &PL_preambleav, opts_prog);
7edfd0ef
NC
2056 /* don't look for script or read stdin */
2057 scriptname = BIT_BUCKET;
2058 goto reswitch;
6224f72b 2059 }
6224f72b 2060 case 'x':
737c24fc 2061 doextract = TRUE;
6224f72b 2062 s++;
304334da 2063 if (*s)
f4c556ac 2064 cddir = s;
6224f72b
GS
2065 break;
2066 case 0:
2067 break;
2068 case '-':
2069 if (!*++s || isSPACE(*s)) {
2070 argc--,argv++;
2071 goto switch_end;
2072 }
ee8bc8b7
NC
2073 /* catch use of gnu style long options.
2074 Both of these exit immediately. */
2075 if (strEQ(s, "version"))
2076 minus_v();
2077 if (strEQ(s, "help"))
2078 usage();
6224f72b 2079 s--;
924ba076 2080 /* FALLTHROUGH */
6224f72b 2081 default:
cea2e8a9 2082 Perl_croak(aTHX_ "Unrecognized switch: -%s (-h will show valid options)",s);
8d063cd8
LW
2083 }
2084 }
c7030b81
NC
2085 }
2086
6224f72b 2087 switch_end:
54310121 2088
c7030b81
NC
2089 {
2090 char *s;
2091
f675dbe5
CB
2092 if (
2093#ifndef SECURE_INTERNAL_GETENV
284167a5 2094 !TAINTING_get &&
f675dbe5 2095#endif
cf756827 2096 (s = PerlEnv_getenv("PERL5OPT")))
0df16ed7 2097 {
9e0b0d62
KW
2098 /* s points to static memory in getenv(), which may be overwritten at
2099 * any time; use a mortal copy instead */
2100 s = SvPVX(sv_2mortal(newSVpv(s, 0)));
2101
74288ac8
GS
2102 while (isSPACE(*s))
2103 s++;
317ea90d 2104 if (*s == '-' && *(s+1) == 'T') {
dc6d7f5c 2105#if defined(SILENT_NO_TAINT_SUPPORT)
284167a5 2106 /* silently ignore */
dc6d7f5c 2107#elif defined(NO_TAINT_SUPPORT)
3231f579 2108 Perl_croak_nocontext("This perl was compiled without taint support. "
284167a5
SM
2109 "Cowardly refusing to run with -t or -T flags");
2110#else
22f7c9c9 2111 CHECK_MALLOC_TOO_LATE_FOR('T');
284167a5
SM
2112 TAINTING_set(TRUE);
2113 TAINT_WARN_set(FALSE);
2114#endif
317ea90d 2115 }
74288ac8 2116 else {
bd61b366 2117 char *popt_copy = NULL;
74288ac8 2118 while (s && *s) {
54913509 2119 const char *d;
74288ac8
GS
2120 while (isSPACE(*s))
2121 s++;
2122 if (*s == '-') {
2123 s++;
2124 if (isSPACE(*s))
2125 continue;
2126 }
4ea8f8fb 2127 d = s;
74288ac8
GS
2128 if (!*s)
2129 break;
2b622f1a 2130 if (!strchr("CDIMUdmtwW", *s))
cea2e8a9 2131 Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
4ea8f8fb
MS
2132 while (++s && *s) {
2133 if (isSPACE(*s)) {
cf756827 2134 if (!popt_copy) {
bfa6c418
NC
2135 popt_copy = SvPVX(sv_2mortal(newSVpv(d,0)));
2136 s = popt_copy + (s - d);
2137 d = popt_copy;
cf756827 2138 }
4ea8f8fb
MS
2139 *s++ = '\0';
2140 break;
2141 }
2142 }
1c4db469 2143 if (*d == 't') {
dc6d7f5c 2144#if defined(SILENT_NO_TAINT_SUPPORT)
284167a5 2145 /* silently ignore */
dc6d7f5c 2146#elif defined(NO_TAINT_SUPPORT)
3231f579 2147 Perl_croak_nocontext("This perl was compiled without taint support. "
284167a5
SM
2148 "Cowardly refusing to run with -t or -T flags");
2149#else
2150 if( !TAINTING_get) {
2151 TAINT_WARN_set(TRUE);
2152 TAINTING_set(TRUE);
317ea90d 2153 }
284167a5 2154#endif
1c4db469 2155 } else {
97bd5664 2156 moreswitches(d);
1c4db469 2157 }
6224f72b 2158 }
6224f72b
GS
2159 }
2160 }
c7030b81 2161 }
a0d0e21e 2162
c29067d7
CH
2163 /* Set $^X early so that it can be used for relocatable paths in @INC */
2164 /* and for SITELIB_EXP in USE_SITECUSTOMIZE */
284167a5 2165 assert (!TAINT_get);
c29067d7 2166 TAINT;
e2051532 2167 set_caret_X();
c29067d7
CH
2168 TAINT_NOT;
2169
43c0c913 2170#if defined(USE_SITECUSTOMIZE)
20ef40cf 2171 if (!minus_f) {
43c0c913 2172 /* The games with local $! are to avoid setting errno if there is no
fc81b718
NC
2173 sitecustomize script. "q%c...%c", 0, ..., 0 becomes "q\0...\0",
2174 ie a q() operator with a NUL byte as a the delimiter. This avoids
2175 problems with pathnames containing (say) ' */
43c0c913
NC
2176# ifdef PERL_IS_MINIPERL
2177 AV *const inc = GvAV(PL_incgv);
2178 SV **const inc0 = inc ? av_fetch(inc, 0, FALSE) : NULL;
2179
2180 if (inc0) {
15870c5c
NC
2181 /* if lib/buildcustomize.pl exists, it should not fail. If it does,
2182 it should be reported immediately as a build failure. */
43c0c913
NC
2183 (void)Perl_av_create_and_unshift_one(aTHX_ &PL_preambleav,
2184 Perl_newSVpvf(aTHX_
147e3846 2185 "BEGIN { my $f = q%c%s%" SVf "/buildcustomize.pl%c; "
af26e4f2
FC
2186 "do {local $!; -f $f }"
2187 " and do $f || die $@ || qq '$f: $!' }",
5de87db5 2188 0, (TAINTING_get ? "./" : ""), SVfARG(*inc0), 0));
43c0c913
NC
2189 }
2190# else
2191 /* SITELIB_EXP is a function call on Win32. */
c29067d7 2192 const char *const raw_sitelib = SITELIB_EXP;
bac5c4fc
JD
2193 if (raw_sitelib) {
2194 /* process .../.. if PERL_RELOCATABLE_INC is defined */
2195 SV *sitelib_sv = mayberelocate(raw_sitelib, strlen(raw_sitelib),
2196 INCPUSH_CAN_RELOCATE);
2197 const char *const sitelib = SvPVX(sitelib_sv);
2198 (void)Perl_av_create_and_unshift_one(aTHX_ &PL_preambleav,
2199 Perl_newSVpvf(aTHX_
2200 "BEGIN { do {local $!; -f q%c%s/sitecustomize.pl%c} && do q%c%s/sitecustomize.pl%c }",
c1f6cd39
BF
2201 0, SVfARG(sitelib), 0,
2202 0, SVfARG(sitelib), 0));
bac5c4fc
JD
2203 assert (SvREFCNT(sitelib_sv) == 1);
2204 SvREFCNT_dec(sitelib_sv);
2205 }
43c0c913 2206# endif
20ef40cf
GA
2207 }
2208#endif
2209
6224f72b
GS
2210 if (!scriptname)
2211 scriptname = argv[0];
3280af22 2212 if (PL_e_script) {
6224f72b
GS
2213 argc++,argv--;
2214 scriptname = BIT_BUCKET; /* don't look for script or read stdin */
2215 }
bd61b366 2216 else if (scriptname == NULL) {
6224f72b
GS
2217#ifdef MSDOS
2218 if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
97bd5664 2219 moreswitches("h");
6224f72b
GS
2220#endif
2221 scriptname = "-";
2222 }
2223
284167a5 2224 assert (!TAINT_get);
2cace6ac 2225 init_perllib();
6224f72b 2226
a52eba0e 2227 {
f20b2998 2228 bool suidscript = FALSE;
829372d3 2229
8d113837 2230 rsfp = open_script(scriptname, dosearch, &suidscript);
c0b3891a
NC
2231 if (!rsfp) {
2232 rsfp = PerlIO_stdin();
87606032 2233 lex_start_flags = LEX_DONT_CLOSE_RSFP;
c0b3891a 2234 }
6224f72b 2235
b24bc095 2236 validate_suid(rsfp);
6224f72b 2237
64ca3a65 2238#ifndef PERL_MICRO
a52eba0e
NC
2239# if defined(SIGCHLD) || defined(SIGCLD)
2240 {
2241# ifndef SIGCHLD
2242# define SIGCHLD SIGCLD
2243# endif
2244 Sighandler_t sigstate = rsignal_state(SIGCHLD);
2245 if (sigstate == (Sighandler_t) SIG_IGN) {
a2a5de95
NC
2246 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
2247 "Can't ignore signal CHLD, forcing to default");
a52eba0e
NC
2248 (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
2249 }
0b5b802d 2250 }
a52eba0e 2251# endif
64ca3a65 2252#endif
0b5b802d 2253
737c24fc 2254 if (doextract) {
faef540c 2255
f20b2998 2256 /* This will croak if suidscript is true, as -x cannot be used with
faef540c
NC
2257 setuid scripts. */
2258 forbid_setid('x', suidscript);
f20b2998 2259 /* Hence you can't get here if suidscript is true */
faef540c 2260
95670bde
NC
2261 linestr_sv = newSV_type(SVt_PV);
2262 lex_start_flags |= LEX_START_COPIED;
2f9285f8 2263 find_beginning(linestr_sv, rsfp);
a52eba0e
NC
2264 if (cddir && PerlDir_chdir( (char *)cddir ) < 0)
2265 Perl_croak(aTHX_ "Can't chdir to %s",cddir);
2266 }
f4c556ac 2267 }
6224f72b 2268
ea726b52 2269 PL_main_cv = PL_compcv = MUTABLE_CV(newSV_type(SVt_PVCV));
3280af22
NIS
2270 CvUNIQUE_on(PL_compcv);
2271
eacbb379 2272 CvPADLIST_set(PL_compcv, pad_new(0));
6224f72b 2273
dd69841b
BB
2274 PL_isarev = newHV();
2275
0c4f7ff0 2276 boot_core_PerlIO();
6224f72b 2277 boot_core_UNIVERSAL();
e1a479c5 2278 boot_core_mro();
4a5df386 2279 newXS("Internals::V", S_Internals_V, __FILE__);
6224f72b
GS
2280
2281 if (xsinit)
acfe0abc 2282 (*xsinit)(aTHX); /* in case linked C routines want magical variables */
64ca3a65 2283#ifndef PERL_MICRO
739a0b84 2284#if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(SYMBIAN)
c5be433b 2285 init_os_extras();
6224f72b 2286#endif
64ca3a65 2287#endif
6224f72b 2288
29209bc5 2289#ifdef USE_SOCKS
1b9c9cf5
DH
2290# ifdef HAS_SOCKS5_INIT
2291 socks5_init(argv[0]);
2292# else
29209bc5 2293 SOCKSinit(argv[0]);
1b9c9cf5 2294# endif
ac27b0f5 2295#endif
29209bc5 2296
6224f72b
GS
2297 init_predump_symbols();
2298 /* init_postdump_symbols not currently designed to be called */
2299 /* more than once (ENV isn't cleared first, for example) */
2300 /* But running with -u leaves %ENV & @ARGV undefined! XXX */
3280af22 2301 if (!PL_do_undump)
6224f72b
GS
2302 init_postdump_symbols(argc,argv,env);
2303
27da23d5
JH
2304 /* PL_unicode is turned on by -C, or by $ENV{PERL_UNICODE},
2305 * or explicitly in some platforms.
73e1bd1a 2306 * PL_utf8locale is conditionally turned on by
085a54d9 2307 * locale.c:Perl_init_i18nl10n() if the environment
a05d7ebb 2308 * look like the user wants to use UTF-8. */
a0fd4948 2309#if defined(__SYMBIAN32__)
27da23d5
JH
2310 PL_unicode = PERL_UNICODE_STD_FLAG; /* See PERL_SYMBIAN_CONSOLE_UTF8. */
2311#endif
e27b5b51 2312# ifndef PERL_IS_MINIPERL
06e66572
JH
2313 if (PL_unicode) {
2314 /* Requires init_predump_symbols(). */
a05d7ebb 2315 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
06e66572
JH
2316 IO* io;
2317 PerlIO* fp;
2318 SV* sv;
2319
a05d7ebb 2320 /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
06e66572 2321 * and the default open disciplines. */
a05d7ebb
JH
2322 if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
2323 PL_stdingv && (io = GvIO(PL_stdingv)) &&
2324 (fp = IoIFP(io)))
2325 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2326 if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
2327 PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
2328 (fp = IoOFP(io)))
2329 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2330 if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
2331 PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
2332 (fp = IoOFP(io)))
2333 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2334 if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
fafc274c
NC
2335 (sv = GvSV(gv_fetchpvs("\017PEN", GV_ADD|GV_NOTQUAL,
2336 SVt_PV)))) {
a05d7ebb
JH
2337 U32 in = PL_unicode & PERL_UNICODE_IN_FLAG;
2338 U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
2339 if (in) {
2340 if (out)
76f68e9b 2341 sv_setpvs(sv, ":utf8\0:utf8");
a05d7ebb 2342 else
76f68e9b 2343 sv_setpvs(sv, ":utf8\0");
a05d7ebb
JH
2344 }
2345 else if (out)
76f68e9b 2346 sv_setpvs(sv, "\0:utf8");
a05d7ebb
JH
2347 SvSETMAGIC(sv);
2348 }
b310b053
JH
2349 }
2350 }
e27b5b51 2351#endif
b310b053 2352
c7030b81
NC
2353 {
2354 const char *s;
4ffa73a3
JH
2355 if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
2356 if (strEQ(s, "unsafe"))
2357 PL_signals |= PERL_SIGNALS_UNSAFE_FLAG;
2358 else if (strEQ(s, "safe"))
2359 PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
2360 else
2361 Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
2362 }
c7030b81 2363 }
4ffa73a3 2364
81d86705 2365
87606032 2366 lex_start(linestr_sv, rsfp, lex_start_flags);
d2687c98 2367 SvREFCNT_dec(linestr_sv);
95670bde 2368
219f7226 2369 PL_subname = newSVpvs("main");
6224f72b 2370
5486870f
DM
2371 if (add_read_e_script)
2372 filter_add(read_e_script, NULL);
2373
6224f72b
GS
2374 /* now parse the script */
2375
93189314 2376 SETERRNO(0,SS_NORMAL);
28ac2b49 2377 if (yyparse(GRAMPROG) || PL_parser->error_count) {
c77da5ff 2378 abort_execution("", PL_origfilename);
6224f72b 2379 }
57843af0 2380 CopLINE_set(PL_curcop, 0);
03d9f026 2381 SET_CURSTASH(PL_defstash);
3280af22
NIS
2382 if (PL_e_script) {
2383 SvREFCNT_dec(PL_e_script);
a0714e2c 2384 PL_e_script = NULL;
6224f72b
GS
2385 }
2386
3280af22 2387 if (PL_do_undump)
6224f72b
GS
2388 my_unexec();
2389
57843af0
GS
2390 if (isWARN_ONCE) {
2391 SAVECOPFILE(PL_curcop);
2392 SAVECOPLINE(PL_curcop);
3280af22 2393 gv_check(PL_defstash);
57843af0 2394 }
6224f72b
GS
2395
2396 LEAVE;
2397 FREETMPS;
2398
2399#ifdef MYMALLOC
f6a607bc
RGS
2400 {
2401 const char *s;
22ff3130
HS
2402 UV uv;
2403 s = PerlEnv_getenv("PERL_DEBUG_MSTATS");
2404 if (s && grok_atoUV(s, &uv, NULL) && uv >= 2)
96e440d2 2405 dump_mstats("after compilation:");
f6a607bc 2406 }
6224f72b
GS
2407#endif
2408
2409 ENTER;
febb3a6d 2410 PL_restartjmpenv = NULL;
3280af22 2411 PL_restartop = 0;
312caa8e 2412 return NULL;
6224f72b
GS
2413}
2414
954c1994
GS
2415/*
2416=for apidoc perl_run
2417
2418Tells a Perl interpreter to run. See L<perlembed>.
2419
2420=cut
2421*/
2422
6224f72b 2423int
0cb96387 2424perl_run(pTHXx)
6224f72b 2425{
6224f72b 2426 I32 oldscope;
14dd3ad8 2427 int ret = 0;
db36c5a1 2428 dJMPENV;
6224f72b 2429
7918f24d
NC
2430 PERL_ARGS_ASSERT_PERL_RUN;
2431#ifndef MULTIPLICITY
ed6c66dd 2432 PERL_UNUSED_ARG(my_perl);
7918f24d 2433#endif
9d4ba2ae 2434
3280af22 2435 oldscope = PL_scopestack_ix;
96e176bf
CL
2436#ifdef VMS
2437 VMSISH_HUSHED = 0;
2438#endif
6224f72b 2439
14dd3ad8 2440 JMPENV_PUSH(ret);
6224f72b
GS
2441 switch (ret) {
2442 case 1:
2443 cxstack_ix = -1; /* start context stack again */
312caa8e 2444 goto redo_body;
14dd3ad8 2445 case 0: /* normal completion */
14dd3ad8
GS
2446 redo_body:
2447 run_body(oldscope);
924ba076 2448 /* FALLTHROUGH */
14dd3ad8 2449 case 2: /* my_exit() */
3280af22 2450 while (PL_scopestack_ix > oldscope)
6224f72b
GS
2451 LEAVE;
2452 FREETMPS;
03d9f026 2453 SET_CURSTASH(PL_defstash);
3a1ee7e8 2454 if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
9ebf26ad 2455 PL_endav && !PL_minus_c) {
ca7b837b 2456 PERL_SET_PHASE(PERL_PHASE_END);
31d77e54 2457 call_list(oldscope, PL_endav);
9ebf26ad 2458 }
6224f72b
GS
2459#ifdef MYMALLOC
2460 if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
2461 dump_mstats("after execution: ");
2462#endif
37038d91 2463 ret = STATUS_EXIT;
14dd3ad8 2464 break;
6224f72b 2465 case 3:
312caa8e
CS
2466 if (PL_restartop) {
2467 POPSTACK_TO(PL_mainstack);
2468 goto redo_body;
6224f72b 2469 }
5637ef5b 2470 PerlIO_printf(Perl_error_log, "panic: restartop in perl_run\n");
312caa8e 2471 FREETMPS;
14dd3ad8
GS
2472 ret = 1;
2473 break;
6224f72b
GS
2474 }
2475
14dd3ad8
GS
2476 JMPENV_POP;
2477 return ret;
312caa8e
CS
2478}
2479
dd374669 2480STATIC void
14dd3ad8
GS
2481S_run_body(pTHX_ I32 oldscope)
2482{
d3b97530
DM
2483 DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support (0x%x).\n",
2484 PL_sawampersand ? "Enabling" : "Omitting",
2485 (unsigned int)(PL_sawampersand)));
6224f72b 2486
3280af22 2487 if (!PL_restartop) {
cf2782cd 2488#ifdef DEBUGGING
f0e3f042
CS
2489 if (DEBUG_x_TEST || DEBUG_B_TEST)
2490 dump_all_perl(!DEBUG_B_TEST);
ecae49c0
NC
2491 if (!DEBUG_q_TEST)
2492 PERL_DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
cf2782cd 2493#endif
6224f72b 2494
3280af22 2495 if (PL_minus_c) {
bf49b057 2496 PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
6224f72b
GS
2497 my_exit(0);
2498 }
3280af22 2499 if (PERLDB_SINGLE && PL_DBsingle)
a6d69523 2500 PL_DBsingle_iv = 1;
9ebf26ad 2501 if (PL_initav) {
ca7b837b 2502 PERL_SET_PHASE(PERL_PHASE_INIT);
3280af22 2503 call_list(oldscope, PL_initav);
9ebf26ad 2504 }
f1fac472 2505#ifdef PERL_DEBUG_READONLY_OPS
3107b51f
FC
2506 if (PL_main_root && PL_main_root->op_slabbed)
2507 Slab_to_ro(OpSLAB(PL_main_root));
f1fac472 2508#endif
6224f72b
GS
2509 }
2510
2511 /* do it */
2512
ca7b837b 2513 PERL_SET_PHASE(PERL_PHASE_RUN);
9ebf26ad 2514
3280af22 2515 if (PL_restartop) {
febb3a6d 2516 PL_restartjmpenv = NULL;
533c011a 2517 PL_op = PL_restartop;
3280af22 2518 PL_restartop = 0;
cea2e8a9 2519 CALLRUNOPS(aTHX);
6224f72b 2520 }
3280af22
NIS
2521 else if (PL_main_start) {
2522 CvDEPTH(PL_main_cv) = 1;
533c011a 2523 PL_op = PL_main_start;
cea2e8a9 2524 CALLRUNOPS(aTHX);
6224f72b 2525 }
f6b3007c 2526 my_exit(0);
e5964223 2527 NOT_REACHED; /* NOTREACHED */
6224f72b
GS
2528}
2529
954c1994 2530/*
ccfc67b7
JH
2531=head1 SV Manipulation Functions
2532
954c1994
GS
2533=for apidoc p||get_sv
2534
64ace3f8 2535Returns the SV of the specified Perl scalar. C<flags> are passed to
72d33970 2536C<gv_fetchpv>. If C<GV_ADD> is set and the
64ace3f8
NC
2537Perl variable does not exist then it will be created. If C<flags> is zero
2538and the variable does not exist then NULL is returned.
954c1994
GS
2539
2540=cut
2541*/
2542
6224f72b 2543SV*
64ace3f8 2544Perl_get_sv(pTHX_ const char *name, I32 flags)
6224f72b
GS
2545{
2546 GV *gv;
7918f24d
NC
2547
2548 PERL_ARGS_ASSERT_GET_SV;
2549
64ace3f8 2550 gv = gv_fetchpv(name, flags, SVt_PV);
6224f72b
GS
2551 if (gv)
2552 return GvSV(gv);
a0714e2c 2553 return NULL;
6224f72b
GS
2554}
2555
954c1994 2556/*
ccfc67b7
JH
2557=head1 Array Manipulation Functions
2558
954c1994
GS
2559=for apidoc p||get_av
2560
f0b90de1
SF
2561Returns the AV of the specified Perl global or package array with the given
2562name (so it won't work on lexical variables). C<flags> are passed
72d33970 2563to C<gv_fetchpv>. If C<GV_ADD> is set and the
cbfd0a87
NC
2564Perl variable does not exist then it will be created. If C<flags> is zero
2565and the variable does not exist then NULL is returned.
954c1994 2566
f0b90de1
SF
2567Perl equivalent: C<@{"$name"}>.
2568
954c1994
GS
2569=cut
2570*/
2571
6224f72b 2572AV*
cbfd0a87 2573Perl_get_av(pTHX_ const char *name, I32 flags)
6224f72b 2574{
cbfd0a87 2575 GV* const gv = gv_fetchpv(name, flags, SVt_PVAV);
7918f24d
NC
2576
2577 PERL_ARGS_ASSERT_GET_AV;
2578
cbfd0a87 2579 if (flags)
6224f72b
GS
2580 return GvAVn(gv);
2581 if (gv)
2582 return GvAV(gv);
7d49f689 2583 return NULL;
6224f72b
GS
2584}
2585
954c1994 2586/*
ccfc67b7
JH
2587=head1 Hash Manipulation Functions
2588
954c1994
GS
2589=for apidoc p||get_hv
2590
6673a63c 2591Returns the HV of the specified Perl hash. C<flags> are passed to
72d33970 2592C<gv_fetchpv>. If C<GV_ADD> is set and the
6673a63c 2593Perl variable does not exist then it will be created. If C<flags> is zero
796b6530 2594and the variable does not exist then C<NULL> is returned.
954c1994
GS
2595
2596=cut
2597*/
2598
6224f72b 2599HV*
6673a63c 2600Perl_get_hv(pTHX_ const char *name, I32 flags)
6224f72b 2601{
6673a63c 2602 GV* const gv = gv_fetchpv(name, flags, SVt_PVHV);
7918f24d
NC
2603
2604 PERL_ARGS_ASSERT_GET_HV;
2605
6673a63c 2606 if (flags)
a0d0e21e
LW
2607 return GvHVn(gv);
2608 if (gv)
2609 return GvHV(gv);
5c284bb0 2610 return NULL;
a0d0e21e
LW
2611}
2612
954c1994 2613/*
ccfc67b7
JH
2614=head1 CV Manipulation Functions
2615
780a5241
NC
2616=for apidoc p||get_cvn_flags
2617
2618Returns the CV of the specified Perl subroutine. C<flags> are passed to
72d33970 2619C<gv_fetchpvn_flags>. If C<GV_ADD> is set and the Perl subroutine does not
780a5241
NC
2620exist then it will be declared (which has the same effect as saying
2621C<sub name;>). If C<GV_ADD> is not set and the subroutine does not exist
2622then NULL is returned.
2623
954c1994
GS
2624=for apidoc p||get_cv
2625
780a5241 2626Uses C<strlen> to get the length of C<name>, then calls C<get_cvn_flags>.
954c1994
GS
2627
2628=cut
2629*/
2630
a0d0e21e 2631CV*
780a5241 2632Perl_get_cvn_flags(pTHX_ const char *name, STRLEN len, I32 flags)
a0d0e21e 2633{
780a5241 2634 GV* const gv = gv_fetchpvn_flags(name, len, flags, SVt_PVCV);
7918f24d
NC
2635
2636 PERL_ARGS_ASSERT_GET_CVN_FLAGS;
2637
334dda80
FC
2638 /* XXX this is probably not what they think they're getting.
2639 * It has the same effect as "sub name;", i.e. just a forward
2640 * declaration! */
780a5241 2641 if ((flags & ~GV_NOADD_MASK) && !GvCVu(gv)) {
186a5ba8 2642 return newSTUB(gv,0);
780a5241 2643 }
a0d0e21e 2644 if (gv)
8ebc5c01 2645 return GvCVu(gv);
601f1833 2646 return NULL;
a0d0e21e
LW
2647}
2648
2c67934f
NC
2649/* Nothing in core calls this now, but we can't replace it with a macro and
2650 move it to mathoms.c as a macro would evaluate name twice. */
780a5241
NC
2651CV*
2652Perl_get_cv(pTHX_ const char *name, I32 flags)
2653{
7918f24d
NC
2654 PERL_ARGS_ASSERT_GET_CV;
2655
780a5241
NC
2656 return get_cvn_flags(name, strlen(name), flags);
2657}
2658
79072805
LW
2659/* Be sure to refetch the stack pointer after calling these routines. */
2660
954c1994 2661/*
ccfc67b7
JH
2662
2663=head1 Callback Functions
2664
954c1994
GS
2665=for apidoc p||call_argv
2666
f0b90de1 2667Performs a callback to the specified named and package-scoped Perl subroutine
796b6530 2668with C<argv> (a C<NULL>-terminated array of strings) as arguments. See
72d33970 2669L<perlcall>.
f0b90de1
SF
2670
2671Approximate Perl equivalent: C<&{"$sub_name"}(@$argv)>.
954c1994
GS
2672
2673=cut
2674*/
2675
a0d0e21e 2676I32
5aaab254 2677Perl_call_argv(pTHX_ const char *sub_name, I32 flags, char **argv)
ac27b0f5 2678
8ac85365
NIS
2679 /* See G_* flags in cop.h */
2680 /* null terminated arg list */
8990e307 2681{
a0d0e21e 2682 dSP;
8990e307 2683
7918f24d
NC
2684 PERL_ARGS_ASSERT_CALL_ARGV;
2685
924508f0 2686 PUSHMARK(SP);
3dc78631
DM
2687 while (*argv) {
2688 mXPUSHs(newSVpv(*argv,0));
2689 argv++;
8990e307 2690 }
3dc78631 2691 PUTBACK;
864dbfa3 2692 return call_pv(sub_name, flags);
8990e307
LW
2693}
2694
954c1994
GS
2695/*
2696=for apidoc p||call_pv
2697
2698Performs a callback to the specified Perl sub. See L<perlcall>.
2699
2700=cut
2701*/
2702
a0d0e21e 2703I32
864dbfa3 2704Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
8ac85365
NIS
2705 /* name of the subroutine */
2706 /* See G_* flags in cop.h */
a0d0e21e 2707{
7918f24d
NC
2708 PERL_ARGS_ASSERT_CALL_PV;
2709
0da0e728 2710 return call_sv(MUTABLE_SV(get_cv(sub_name, GV_ADD)), flags);
a0d0e21e
LW
2711}
2712
954c1994
GS
2713/*
2714=for apidoc p||call_method
2715
2716Performs a callback to the specified Perl method. The blessed object must
2717be on the stack. See L<perlcall>.
2718
2719=cut
2720*/
2721
a0d0e21e 2722I32
864dbfa3 2723Perl_call_method(pTHX_ const char *methname, I32 flags)
8ac85365
NIS
2724 /* name of the subroutine */
2725 /* See G_* flags in cop.h */
a0d0e21e 2726{
46ca9bac 2727 STRLEN len;
c106c2be 2728 SV* sv;
7918f24d
NC
2729 PERL_ARGS_ASSERT_CALL_METHOD;
2730
46ca9bac 2731 len = strlen(methname);
c106c2be
RZ
2732 sv = flags & G_METHOD_NAMED
2733 ? sv_2mortal(newSVpvn_share(methname, len,0))
2734 : newSVpvn_flags(methname, len, SVs_TEMP);
46ca9bac 2735
c106c2be 2736 return call_sv(sv, flags | G_METHOD);
a0d0e21e
LW
2737}
2738
2739/* May be called with any of a CV, a GV, or an SV containing the name. */
954c1994
GS
2740/*
2741=for apidoc p||call_sv
2742
078e2213
TC
2743Performs a callback to the Perl sub specified by the SV.
2744
7c0c544c 2745If neither the C<G_METHOD> nor C<G_METHOD_NAMED> flag is supplied, the
078e2213
TC
2746SV may be any of a CV, a GV, a reference to a CV, a reference to a GV
2747or C<SvPV(sv)> will be used as the name of the sub to call.
2748
2749If the C<G_METHOD> flag is supplied, the SV may be a reference to a CV or
2750C<SvPV(sv)> will be used as the name of the method to call.
2751
2752If the C<G_METHOD_NAMED> flag is supplied, C<SvPV(sv)> will be used as
2753the name of the method to call.
2754
2755Some other values are treated specially for internal use and should
2756not be depended on.
2757
2758See L<perlcall>.
954c1994
GS
2759
2760=cut
2761*/
2762
a0d0e21e 2763I32
001d637e 2764Perl_call_sv(pTHX_ SV *sv, VOL I32 flags)
8ac85365 2765 /* See G_* flags in cop.h */
a0d0e21e 2766{
5b434c73 2767 dVAR;
a0d0e21e 2768 LOGOP myop; /* fake syntax tree node */
b46e009d 2769 METHOP method_op;
aa689395 2770 I32 oldmark;
8ea43dc8 2771 VOL I32 retval = 0;
54310121 2772 bool oldcatch = CATCH_GET;
6224f72b 2773 int ret;
c4420975 2774 OP* const oldop = PL_op;
db36c5a1 2775 dJMPENV;
1e422769 2776
7918f24d
NC
2777 PERL_ARGS_ASSERT_CALL_SV;
2778
a0d0e21e
LW
2779 if (flags & G_DISCARD) {
2780 ENTER;
2781 SAVETMPS;
2782 }
2f8edad0
NC
2783 if (!(flags & G_WANT)) {
2784 /* Backwards compatibility - as G_SCALAR was 0, it could be omitted.
2785 */
2786 flags |= G_SCALAR;
2787 }
a0d0e21e 2788
aa689395 2789 Zero(&myop, 1, LOGOP);
f51d4af5 2790 if (!(flags & G_NOARGS))
aa689395 2791 myop.op_flags |= OPf_STACKED;
4f911530 2792 myop.op_flags |= OP_GIMME_REVERSE(flags);
462e5cf6 2793 SAVEOP();
533c011a 2794 PL_op = (OP*)&myop;
aa689395 2795
8c9009ad 2796 if (!(flags & G_METHOD_NAMED)) {
5b434c73
DD
2797 dSP;
2798 EXTEND(SP, 1);
8c9009ad
DD
2799 PUSHs(sv);
2800 PUTBACK;
5b434c73 2801 }
aa689395 2802 oldmark = TOPMARK;
a0d0e21e 2803
3280af22 2804 if (PERLDB_SUB && PL_curstash != PL_debstash
36477c24 2805 /* Handle first BEGIN of -d. */
3280af22 2806 && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
36477c24
PP
2807 /* Try harder, since this may have been a sighandler, thus
2808 * curstash may be meaningless. */
ea726b52 2809 && (SvTYPE(sv) != SVt_PVCV || CvSTASH((const CV *)sv) != PL_debstash)
491527d0 2810 && !(flags & G_NODEBUG))
5ff48db8 2811 myop.op_private |= OPpENTERSUB_DB;
a0d0e21e 2812
c106c2be 2813 if (flags & (G_METHOD|G_METHOD_NAMED)) {
b46e009d 2814 Zero(&method_op, 1, METHOP);
2815 method_op.op_next = (OP*)&myop;
2816 PL_op = (OP*)&method_op;
c106c2be 2817 if ( flags & G_METHOD_NAMED ) {
b46e009d 2818 method_op.op_ppaddr = PL_ppaddr[OP_METHOD_NAMED];
2819 method_op.op_type = OP_METHOD_NAMED;
2820 method_op.op_u.op_meth_sv = sv;
c106c2be 2821 } else {
b46e009d 2822 method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
2823 method_op.op_type = OP_METHOD;
c106c2be
RZ
2824 }
2825 myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
2826 myop.op_type = OP_ENTERSUB;
968b3946
GS
2827 }
2828
312caa8e 2829 if (!(flags & G_EVAL)) {
0cdb2077 2830 CATCH_SET(TRUE);
d6f07c05 2831 CALL_BODY_SUB((OP*)&myop);
312caa8e 2832 retval = PL_stack_sp - (PL_stack_base + oldmark);
0253cb41 2833 CATCH_SET(oldcatch);
312caa8e
CS
2834 }
2835 else {
8e90e786 2836 I32 old_cxix;
d78bda3d 2837 myop.op_other = (OP*)&myop;
101d6365 2838 (void)POPMARK;
8e90e786 2839 old_cxix = cxstack_ix;
274ed8ae 2840 create_eval_scope(NULL, flags|G_FAKINGEVAL);
c318a6ee 2841 INCMARK;
a0d0e21e 2842
14dd3ad8 2843 JMPENV_PUSH(ret);
edb2152a 2844
6224f72b
GS
2845 switch (ret) {
2846 case 0:
14dd3ad8 2847 redo_body:
d6f07c05 2848 CALL_BODY_SUB((OP*)&myop);
312caa8e 2849 retval = PL_stack_sp - (PL_stack_base + oldmark);
8433848b 2850 if (!(flags & G_KEEPERR)) {
ab69dbc2 2851 CLEAR_ERRSV();
8433848b 2852 }
a0d0e21e 2853 break;
6224f72b 2854 case 1:
f86702cc 2855 STATUS_ALL_FAILURE;
924ba076 2856 /* FALLTHROUGH */
6224f72b 2857 case 2:
a0d0e21e 2858 /* my_exit() was called */
03d9f026 2859 SET_CURSTASH(PL_defstash);
a0d0e21e 2860 FREETMPS;
14dd3ad8 2861 JMPENV_POP;
f86702cc 2862 my_exit_jump();
e5964223 2863 NOT_REACHED; /* NOTREACHED */
6224f72b 2864 case 3:
3280af22 2865 if (PL_restartop) {
febb3a6d 2866 PL_restartjmpenv = NULL;
533c011a 2867 PL_op = PL_restartop;
3280af22 2868 PL_restartop = 0;
312caa8e 2869 goto redo_body;
a0d0e21e 2870 }
3280af22 2871 PL_stack_sp = PL_stack_base + oldmark;
51ce5529 2872 if ((flags & G_WANT) == G_ARRAY)
a0d0e21e
LW
2873 retval = 0;
2874 else {
2875 retval = 1;
3280af22 2876 *++PL_stack_sp = &PL_sv_undef;
a0d0e21e 2877 }
312caa8e 2878 break;
a0d0e21e 2879 }
a0d0e21e 2880
8e90e786
DM
2881 /* if we croaked, depending on how we croaked the eval scope
2882 * may or may not have already been popped */
2883 if (cxstack_ix > old_cxix) {
2884 assert(cxstack_ix == old_cxix + 1);
4ebe6e95 2885 assert(CxTYPE(CX_CUR()) == CXt_EVAL);
edb2152a 2886 delete_eval_scope();
8e90e786 2887 }
14dd3ad8 2888 JMPENV_POP;
a0d0e21e 2889 }
1e422769 2890
a0d0e21e 2891 if (flags & G_DISCARD) {
3280af22 2892 PL_stack_sp = PL_stack_base + oldmark;
a0d0e21e
LW
2893 retval = 0;
2894 FREETMPS;
2895 LEAVE;
2896 }
533c011a 2897 PL_op = oldop;
a0d0e21e
LW
2898 return retval;
2899}
2900
6e72f9df 2901/* Eval a string. The G_EVAL flag is always assumed. */
8990e307 2902
954c1994
GS
2903/*
2904=for apidoc p||eval_sv
2905
72d33970 2906Tells Perl to C<eval> the string in the SV. It supports the same flags
796b6530 2907as C<call_sv>, with the obvious exception of C<G_EVAL>. See L<perlcall>.
954c1994
GS
2908
2909=cut
2910*/
2911
a0d0e21e 2912I32
864dbfa3 2913Perl_eval_sv(pTHX_ SV *sv, I32 flags)
ac27b0f5 2914
8ac85365 2915 /* See G_* flags in cop.h */
a0d0e21e 2916{
97aff369 2917 dVAR;
a0d0e21e 2918 UNOP myop; /* fake syntax tree node */
5b434c73 2919 VOL I32 oldmark;
8ea43dc8 2920 VOL I32 retval = 0;
6224f72b 2921 int ret;
c4420975 2922 OP* const oldop = PL_op;
db36c5a1 2923 dJMPENV;
84902520 2924
7918f24d
NC
2925 PERL_ARGS_ASSERT_EVAL_SV;
2926
4633a7c4
LW
2927 if (flags & G_DISCARD) {
2928 ENTER;
2929 SAVETMPS;
2930 }
2931
462e5cf6 2932 SAVEOP();
533c011a 2933 PL_op = (OP*)&myop;
5ff48db8 2934 Zero(&myop, 1, UNOP);
5b434c73
DD
2935 {
2936 dSP;
2937 oldmark = SP - PL_stack_base;
2938 EXTEND(SP, 1);
2939 PUSHs(sv);
2940 PUTBACK;
2941 }
79072805 2942
4633a7c4
LW
2943 if (!(flags & G_NOARGS))
2944 myop.op_flags = OPf_STACKED;
6e72f9df 2945 myop.op_type = OP_ENTEREVAL;
4f911530 2946 myop.op_flags |= OP_GIMME_REVERSE(flags);
6e72f9df
PP
2947 if (flags & G_KEEPERR)
2948 myop.op_flags |= OPf_SPECIAL;
a1941760
DM
2949
2950 if (flags & G_RE_REPARSING)
2951 myop.op_private = (OPpEVAL_COPHH | OPpEVAL_RE_REPARSING);
4633a7c4 2952
dedbcade 2953 /* fail now; otherwise we could fail after the JMPENV_PUSH but
13febba5 2954 * before a cx_pusheval(), which corrupts the stack after a croak */
dedbcade
DM
2955 TAINT_PROPER("eval_sv()");
2956
14dd3ad8 2957 JMPENV_PUSH(ret);
6224f72b
GS
2958 switch (ret) {
2959 case 0:
14dd3ad8 2960 redo_body:
2ba65d5f
DM
2961 if (PL_op == (OP*)(&myop)) {
2962 PL_op = PL_ppaddr[OP_ENTEREVAL](aTHX);
2963 if (!PL_op)
2964 goto fail; /* failed in compilation */
2965 }
4aca2f62 2966 CALLRUNOPS(aTHX);
312caa8e 2967 retval = PL_stack_sp - (PL_stack_base + oldmark);
8433848b 2968 if (!(flags & G_KEEPERR)) {
ab69dbc2 2969 CLEAR_ERRSV();
8433848b 2970 }
4633a7c4 2971 break;
6224f72b 2972 case 1:
f86702cc 2973 STATUS_ALL_FAILURE;
924ba076 2974 /* FALLTHROUGH */
6224f72b 2975 case 2:
4633a7c4 2976 /* my_exit() was called */
03d9f026 2977 SET_CURSTASH(PL_defstash);
4633a7c4 2978 FREETMPS;
14dd3ad8 2979 JMPENV_POP;
f86702cc 2980 my_exit_jump();
e5964223 2981 NOT_REACHED; /* NOTREACHED */
6224f72b 2982 case 3:
3280af22 2983 if (PL_restartop) {
febb3a6d 2984 PL_restartjmpenv = NULL;
533c011a 2985 PL_op = PL_restartop;
3280af22 2986 PL_restartop = 0;
312caa8e 2987 goto redo_body;
4633a7c4 2988 }
4aca2f62 2989 fail:
3280af22 2990 PL_stack_sp = PL_stack_base + oldmark;
51ce5529 2991 if ((flags & G_WANT) == G_ARRAY)
4633a7c4
LW
2992 retval = 0;
2993 else {
2994 retval = 1;
3280af22 2995 *++PL_stack_sp = &PL_sv_undef;
4633a7c4 2996 }
312caa8e 2997 break;
4633a7c4
LW
2998 }
2999
14dd3ad8 3000 JMPENV_POP;
4633a7c4 3001 if (flags & G_DISCARD) {
3280af22 3002 PL_stack_sp = PL_stack_base + oldmark;
4633a7c4
LW
3003 retval = 0;
3004 FREETMPS;
3005 LEAVE;
3006 }
533c011a 3007 PL_op = oldop;
4633a7c4
LW
3008 return retval;
3009}
3010
954c1994
GS
3011/*
3012=for apidoc p||eval_pv
3013
422791e4 3014Tells Perl to C<eval> the given string in scalar context and return an SV* result.
954c1994
GS
3015
3016=cut
3017*/
3018
137443ea 3019SV*
864dbfa3 3020Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
137443ea 3021{
137443ea
PP
3022 SV* sv = newSVpv(p, 0);
3023
7918f24d
NC
3024 PERL_ARGS_ASSERT_EVAL_PV;
3025
864dbfa3 3026 eval_sv(sv, G_SCALAR);
137443ea
PP
3027 SvREFCNT_dec(sv);
3028
ed1786ad
DD
3029 {
3030 dSP;
3031 sv = POPs;
3032 PUTBACK;
3033 }
137443ea 3034
eed484f9
DD
3035 /* just check empty string or undef? */
3036 if (croak_on_error) {
3037 SV * const errsv = ERRSV;
3038 if(SvTRUE_NN(errsv))
3039 /* replace with croak_sv? */
3040 Perl_croak_nocontext("%s", SvPV_nolen_const(errsv));
2d8e6c8d 3041 }
137443ea
PP
3042
3043 return sv;
3044}
3045
4633a7c4
LW
3046/* Require a module. */
3047
954c1994 3048/*
ccfc67b7
JH
3049=head1 Embedding Functions
3050
954c1994
GS
3051=for apidoc p||require_pv
3052
7d3fb230
BS
3053Tells Perl to C<require> the file named by the string argument. It is
3054analogous to the Perl code C<eval "require '$file'">. It's even
2307c6d0 3055implemented that way; consider using load_module instead.
954c1994 3056
7d3fb230 3057=cut */
954c1994 3058
4633a7c4 3059void
864dbfa3 3060Perl_require_pv(pTHX_ const char *pv)
4633a7c4 3061{
d3acc0f7 3062 dSP;
97aff369 3063 SV* sv;
7918f24d
NC
3064
3065 PERL_ARGS_ASSERT_REQUIRE_PV;
3066
e788e7d3 3067 PUSHSTACKi(PERLSI_REQUIRE);
be41e5d9
NC
3068 sv = Perl_newSVpvf(aTHX_ "require q%c%s%c", 0, pv, 0);
3069 eval_sv(sv_2mortal(sv), G_DISCARD);
d3acc0f7 3070 POPSTACK;
79072805
LW
3071}
3072
76e3520e 3073STATIC void
b6f82619 3074S_usage(pTHX) /* XXX move this out into a module ? */
4633a7c4 3075{
ab821d7f 3076 /* This message really ought to be max 23 lines.
75c72d73 3077 * Removed -h because the user already knows that option. Others? */
fb73857a 3078
1566c39d
NC
3079 /* Grouped as 6 lines per C string literal, to keep under the ANSI C 89
3080 minimum of 509 character string literals. */
27da23d5 3081 static const char * const usage_msg[] = {
1566c39d
NC
3082" -0[octal] specify record separator (\\0, if no argument)\n"
3083" -a autosplit mode with -n or -p (splits $_ into @F)\n"
3084" -C[number/list] enables the listed Unicode features\n"
3085" -c check syntax only (runs BEGIN and CHECK blocks)\n"
3086" -d[:debugger] run program under debugger\n"
3087" -D[number/list] set debugging flags (argument is a bit mask or alphabets)\n",
3088" -e program one line of program (several -e's allowed, omit programfile)\n"
3089" -E program like -e, but enables all optional features\n"
3090" -f don't do $sitelib/sitecustomize.pl at startup\n"
3091" -F/pattern/ split() pattern for -a switch (//'s are optional)\n"
3092" -i[extension] edit <> files in place (makes backup if extension supplied)\n"
3093" -Idirectory specify @INC/#include directory (several -I's allowed)\n",
3094" -l[octal] enable line ending processing, specifies line terminator\n"
3095" -[mM][-]module execute \"use/no module...\" before executing program\n"
3096" -n assume \"while (<>) { ... }\" loop around program\n"
3097" -p assume loop like -n but print line also, like sed\n"
3098" -s enable rudimentary parsing for switches after programfile\n"
3099" -S look for programfile using PATH environment variable\n",
3100" -t enable tainting warnings\n"
3101" -T enable tainting checks\n"
3102" -u dump core after parsing program\n"
3103" -U allow unsafe operations\n"
3104" -v print version, patchlevel and license\n"
3105" -V[:variable] print configuration summary (or a single Config.pm variable)\n",
60eaec42 3106" -w enable many useful warnings\n"
1566c39d
NC
3107" -W enable all warnings\n"
3108" -x[directory] ignore text before #!perl line (optionally cd to directory)\n"
3109" -X disable all warnings\n"
3110" \n"
3111"Run 'perldoc perl' for more help with Perl.\n\n",
fb73857a
PP
3112NULL
3113};
27da23d5 3114 const char * const *p = usage_msg;
1566c39d 3115 PerlIO *out = PerlIO_stdout();
fb73857a 3116
1566c39d
NC
3117 PerlIO_printf(out,
3118 "\nUsage: %s [switches] [--] [programfile] [arguments]\n",
b6f82619 3119 PL_origargv[0]);
fb73857a 3120 while (*p)
1566c39d 3121 PerlIO_puts(out, *p++);
b6f82619 3122 my_exit(0);
4633a7c4
LW
3123}
3124
b4ab917c
DM
3125/* convert a string of -D options (or digits) into an int.
3126 * sets *s to point to the char after the options */
3127
3128#ifdef DEBUGGING
3129int
e1ec3a88 3130Perl_get_debug_opts(pTHX_ const char **s, bool givehelp)
b4ab917c 3131{
27da23d5 3132 static const char * const usage_msgd[] = {
651b8f1a
NC
3133 " Debugging flag values: (see also -d)\n"
3134 " p Tokenizing and parsing (with v, displays parse stack)\n"
3135 " s Stack snapshots (with v, displays all stacks)\n"
3136 " l Context (loop) stack processing\n"
3137 " t Trace execution\n"
3138 " o Method and overloading resolution\n",
3139 " c String/numeric conversions\n"
3140 " P Print profiling info, source file input state\n"
3141 " m Memory and SV allocation\n"
3142 " f Format processing\n"
3143 " r Regular expression parsing and execution\n"
3144 " x Syntax tree dump\n",
3145 " u Tainting checks\n"
3146 " H Hash dump -- usurps values()\n"
3147 " X Scratchpad allocation\n"
3148 " D Cleaning up\n"
56967202 3149 " S Op slab allocation\n"
651b8f1a
NC
3150 " T Tokenising\n"
3151 " R Include reference counts of dumped variables (eg when using -Ds)\n",
3152 " J Do not s,t,P-debug (Jump over) opcodes within package DB\n"
3153 " v Verbose: use in conjunction with other flags\n"
3154 " C Copy On Write\n"
3155 " A Consistency checks on internal structures\n"
3156 " q quiet - currently only suppresses the 'EXECUTING' message\n"
3157 " M trace smart match resolution\n"
3158 " B dump suBroutine definitions, including special Blocks like BEGIN\n",
69014004 3159 " L trace some locale setting information--for Perl core development\n",
e17bc05a 3160 " i trace PerlIO layer processing\n",
e6e64d9b
JC
3161 NULL
3162 };
22ff3130 3163 UV uv = 0;
7918f24d
NC
3164
3165 PERL_ARGS_ASSERT_GET_DEBUG_OPTS;
3166
b4ab917c
DM
3167 if (isALPHA(**s)) {
3168 /* if adding extra options, remember to update DEBUG_MASK */
e17bc05a 3169 static const char debopts[] = "psltocPmfrxuUHXDSTRJvCAqMBLi";
b4ab917c 3170
0eb30aeb 3171 for (; isWORDCHAR(**s); (*s)++) {
c4420975 3172 const char * const d = strchr(debopts,**s);
b4ab917c 3173 if (d)
22ff3130 3174 uv |= 1 << (d - debopts);
b4ab917c 3175 else if (ckWARN_d(WARN_DEBUGGING))
e6e64d9b
JC
3176 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3177 "invalid option -D%c, use -D'' to see choices\n", **s);
b4ab917c
DM
3178 }
3179 }
e6e64d9b 3180 else if (isDIGIT(**s)) {
96e440d2 3181 const char* e;
22ff3130 3182 if (grok_atoUV(*s, &uv, &e))
96e440d2 3183 *s = e;
0eb30aeb 3184 for (; isWORDCHAR(**s); (*s)++) ;
b4ab917c 3185 }
ddcf8bc1 3186 else if (givehelp) {
06e869a4 3187 const char *const *p = usage_msgd;
651b8f1a 3188 while (*p) PerlIO_puts(PerlIO_stdout(), *p++);
e6e64d9b 3189 }
22ff3130 3190 return (int)uv; /* ignore any UV->int conversion loss */
b4ab917c
DM
3191}
3192#endif
3193
79072805
LW
3194/* This routine handles any switches that can be given during run */
3195
c7030b81
NC
3196const char *
3197Perl_moreswitches(pTHX_ const char *s)
79072805 3198{
27da23d5 3199 dVAR;
84c133a0 3200 UV rschar;
0544e6df 3201 const char option = *s; /* used to remember option in -m/-M code */
79072805 3202
7918f24d
NC
3203 PERL_ARGS_ASSERT_MORESWITCHES;
3204
79072805
LW
3205 switch (*s) {
3206 case '0':
a863c7d1 3207 {
f2095865 3208 I32 flags = 0;
a3b680e6 3209 STRLEN numlen;
f2095865
JH
3210
3211 SvREFCNT_dec(PL_rs);
3212 if (s[1] == 'x' && s[2]) {
a3b680e6 3213 const char *e = s+=2;
f2095865
JH
3214 U8 *tmps;
3215
a3b680e6
AL
3216 while (*e)
3217 e++;
f2095865
JH
3218 numlen = e - s;
3219 flags = PERL_SCAN_SILENT_ILLDIGIT;
3220 rschar = (U32)grok_hex(s, &numlen, &flags, NULL);
3221 if (s + numlen < e) {
3222 rschar = 0; /* Grandfather -0xFOO as -0 -xFOO. */
3223 numlen = 0;
3224 s--;
3225 }
396482e1 3226 PL_rs = newSVpvs("");
10656159 3227 tmps = (U8*) SvGROW(PL_rs, (STRLEN)(UVCHR_SKIP(rschar) + 1));
f2095865 3228 uvchr_to_utf8(tmps, rschar);
5f560d8a 3229 SvCUR_set(PL_rs, UVCHR_SKIP(rschar));
f2095865
JH
3230 SvUTF8_on(PL_rs);
3231 }
3232 else {
3233 numlen = 4;
3234 rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
3235 if (rschar & ~((U8)~0))
3236 PL_rs = &PL_sv_undef;
3237 else if (!rschar && numlen >= 2)
396482e1 3238 PL_rs = newSVpvs("");
f2095865
JH
3239 else {
3240 char ch = (char)rschar;
3241 PL_rs = newSVpvn(&ch, 1);
3242 }
3243 }
64ace3f8 3244 sv_setsv(get_sv("/", GV_ADD), PL_rs);
f2095865 3245 return s + numlen;
a863c7d1 3246 }
46487f74 3247 case 'C':
a05d7ebb 3248 s++;
dd374669 3249 PL_unicode = parse_unicode_opts( (const char **)&s );
5a22a2bb
NC
3250 if (PL_unicode & PERL_UNICODE_UTF8CACHEASSERT_FLAG)
3251 PL_utf8cache = -1;
46487f74 3252 return s;
2304df62 3253 case 'F':
5fc691f1 3254 PL_minus_a = TRUE;
3280af22 3255 PL_minus_F = TRUE;
24ffa309 3256 PL_minus_n = TRUE;
ebce5377
RGS
3257 PL_splitstr = ++s;
3258 while (*s && !isSPACE(*s)) ++s;
e49e380e 3259 PL_splitstr = savepvn(PL_splitstr, s - PL_splitstr);
2304df62 3260 return s;
79072805 3261 case 'a':
3280af22 3262 PL_minus_a = TRUE;
24ffa309 3263 PL_minus_n = TRUE;
79072805
LW
3264 s++;
3265 return s;
3266 case 'c':
3280af22 3267 PL_minus_c = TRUE;
79072805
LW
3268 s++;
3269 return s;
3270 case 'd':
f20b2998 3271 forbid_setid('d', FALSE);
4633a7c4 3272 s++;
2cbb2ee1
RGS
3273
3274 /* -dt indicates to the debugger that threads will be used */
0eb30aeb 3275 if (*s == 't' && !isWORDCHAR(s[1])) {
2cbb2ee1
RGS
3276 ++s;
3277 my_setenv("PERL5DB_THREADED", "1");
3278 }
3279
70c94a19
RR
3280 /* The following permits -d:Mod to accepts arguments following an =
3281 in the fashion that -MSome::Mod does. */
3282 if (*s == ':' || *s == '=') {
b19934fb
NC
3283 const char *start;
3284 const char *end;
3285 SV *sv;
3286
3287 if (*++s == '-') {
3288 ++s;
3289 sv = newSVpvs("no Devel::");
3290 } else {
3291 sv = newSVpvs("use Devel::");
3292 }
3293
3294 start = s;
3295 end = s + strlen(s);
f85893a1 3296
b19934fb 3297 /* We now allow -d:Module=Foo,Bar and -d:-Module */
0eb30aeb 3298 while(isWORDCHAR(*s) || *s==':') ++s;
70c94a19 3299 if (*s != '=')
f85893a1 3300 sv_catpvn(sv, start, end - start);
70c94a19
RR
3301 else {
3302 sv_catpvn(sv, start, s-start);
95a2b409
RGS
3303 /* Don't use NUL as q// delimiter here, this string goes in the
3304 * environment. */
3305 Perl_sv_catpvf(aTHX_ sv, " split(/,/,q{%s});", ++s);
70c94a19 3306 }
f85893a1 3307 s = end;
184f32ec 3308 my_setenv("PERL5DB", SvPV_nolen_const(sv));
c4db126b 3309 SvREFCNT_dec(sv);
4633a7c4 3310 }
ed094faf 3311 if (!PL_perldb) {
3280af22 3312 PL_perldb = PERLDB_ALL;
a0d0e21e 3313 init_debugger();
ed094faf 3314 }
79072805
LW
3315 return s;
3316 case 'D':
0453d815 3317 {
79072805 3318#ifdef DEBUGGING
f20b2998 3319 forbid_setid('D', FALSE);
b4ab917c 3320 s++;
dd374669 3321 PL_debug = get_debug_opts( (const char **)&s, 1) | DEBUG_TOP_FLAG;
12a43e32 3322#else /* !DEBUGGING */
0453d815 3323 if (ckWARN_d(WARN_DEBUGGING))
9014280d 3324 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
e6e64d9b 3325 "Recompile perl with -DDEBUGGING to use -D switch (did you mean -d ?)\n");
0eb30aeb 3326 for (s++; isWORDCHAR(*s); s++) ;
79072805 3327#endif
79072805 3328 return s;
2b5060ae 3329 NOT_REACHED; /* NOTREACHED */
0453d815 3330 }
4633a7c4 3331 case 'h':
b6f82619 3332 usage();
2b5060ae
DM
3333 NOT_REACHED; /* NOTREACHED */
3334
79072805 3335 case 'i':
43c5f42d 3336 Safefree(PL_inplace);
c030f24b
GH
3337#if defined(__CYGWIN__) /* do backup extension automagically */
3338 if (*(s+1) == '\0') {
c86a4f2e 3339 PL_inplace = savepvs(".bak");
c030f24b
GH
3340 return s+1;
3341 }
3342#endif /* __CYGWIN__ */
5ef5d758 3343 {
d4c19fe8 3344 const char * const start = ++s;
5ef5d758
NC
3345 while (*s && !isSPACE(*s))
3346 ++s;
3347
3348 PL_inplace = savepvn(start, s - start);
3349 }
fb73857a 3350 return s;
4e49a025 3351 case 'I': /* -I handled both here and in parse_body() */
f20b2998 3352 forbid_setid('I', FALSE);
fb73857a
PP
3353 ++s;
3354 while (*s && isSPACE(*s))
3355 ++s;
3356 if (*s) {
c7030b81 3357 const char *e, *p;
0df16ed7
GS
3358 p = s;
3359 /* ignore trailing spaces (possibly followed by other switches) */
3360 do {
3361 for (e = p; *e && !isSPACE(*e); e++) ;
3362 p = e;
3363 while (isSPACE(*p))
3364 p++;
3365 } while (*p && *p != '-');
55b4bc1c 3366 incpush(s, e-s,
e28f3139 3367 INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS|INCPUSH_UNSHIFT);
0df16ed7
GS
3368 s = p;
3369 if (*s == '-')
3370 s++;
79072805
LW
3371 }
3372 else
a67e862a 3373 Perl_croak(aTHX_ "No directory specified for -I");
fb73857a 3374 return s;
79072805 3375 case 'l':
3280af22 3376 PL_minus_l = TRUE;
79072805 3377 s++;
7889fe52
NIS
3378 if (PL_ors_sv) {
3379 SvREFCNT_dec(PL_ors_sv);
a0714e2c 3380 PL_ors_sv = NULL;
7889fe52 3381 }
79072805 3382 if (isDIGIT(*s)) {
53305cf1 3383 I32 flags = 0;
a3b680e6 3384 STRLEN numlen;
396482e1 3385 PL_ors_sv = newSVpvs("\n");
53305cf1
NC
3386 numlen = 3 + (*s == '0');
3387 *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
79072805
LW
3388 s += numlen;
3389 }
3390 else {
8bfdd7d9 3391 if (RsPARA(PL_rs)) {
396482e1 3392 PL_ors_sv = newSVpvs("\n\n");
7889fe52
NIS
3393 }
3394 else {
8bfdd7d9 3395 PL_ors_sv = newSVsv(PL_rs);
c07a80fd 3396 }
79072805
LW
3397 }
3398 return s;
1a30305b 3399 case 'M':
f20b2998 3400 forbid_setid('M', FALSE); /* XXX ? */
924ba076 3401 /* FALLTHROUGH */
1a30305b 3402 case 'm':
f20b2998 3403 forbid_setid('m', FALSE); /* XXX ? */
1a30305b 3404 if (*++s) {
c7030b81 3405 const char *start;
b64cb68c 3406 const char *end;
11343788 3407 SV *sv;
e1ec3a88 3408 const char *use = "use ";
0544e6df 3409 bool colon = FALSE;
a5f75d66 3410 /* -M-foo == 'no foo' */
d0043bd1
NC
3411 /* Leading space on " no " is deliberate, to make both
3412 possibilities the same length. */
3413 if (*s == '-') { use = " no "; ++s; }
3414 sv = newSVpvn(use,4);
a5f75d66 3415 start = s;
1a30305b 3416 /* We allow -M'Module qw(Foo Bar)' */
0eb30aeb 3417 while(isWORDCHAR(*s) || *s==':') {
0544e6df
RB
3418 if( *s++ == ':' ) {
3419 if( *s == ':' )
3420 s++;
3421 else
3422 colon = TRUE;
3423 }
3424 }
3425 if (s == start)
3426 Perl_croak(aTHX_ "Module name required with -%c option",
3427 option);
3428 if (colon)
3429 Perl_croak(aTHX_ "Invalid module name %.*s with -%c option: "
3430 "contains single ':'",
63da6837 3431 (int)(s - start), start, option);
b64cb68c 3432 end = s + strlen(s);
c07a80fd 3433 if (*s != '=') {
b64cb68c 3434 sv_catpvn(sv, start, end - start);
0544e6df 3435 if (option == 'm') {
c07a80fd 3436 if (*s != '\0')
cea2e8a9 3437 Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
396482e1 3438 sv_catpvs( sv, " ()");
c07a80fd
PP
3439 }
3440 } else {
11343788 3441 sv_catpvn(sv, start, s-start);
b64cb68c
NC
3442 /* Use NUL as q''-delimiter. */
3443 sv_catpvs(sv, " split(/,/,q\0");
3444 ++s;
3445 sv_catpvn(sv, s, end - s);
396482e1 3446 sv_catpvs(sv, "\0)");
c07a80fd 3447 }
b64cb68c 3448 s = end;
29a861e7 3449 Perl_av_create_and_push(aTHX_ &PL_preambleav, sv);
1a30305b
PP
3450 }
3451 else
0544e6df 3452 Perl_croak(aTHX_ "Missing argument to -%c", option);
1a30305b 3453 return s;
79072805 3454 case 'n':
3280af22 3455 PL_minus_n = TRUE;
79072805
LW
3456 s++;
3457 return s;
3458 case 'p':
3280af22 3459 PL_minus_p = TRUE;
79072805
LW
3460 s++;
3461 return s;
3462 case 's':
f20b2998 3463 forbid_setid('s', FALSE);
3280af22 3464 PL_doswitches = TRUE;
79072805
LW
3465 s++;
3466 return s;
6537fe72 3467 case 't':
27a6968b 3468 case 'T':
dc6d7f5c 3469#if defined(SILENT_NO_TAINT_SUPPORT)
284167a5 3470 /* silently ignore */
dc6d7f5c 3471#elif defined(NO_TAINT_SUPPORT)