This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Deparse.t: To-do test for #115066
[perl5.git] / perl.c
1 #line 2 "perl.c"
2 /*    perl.c
3  *
4  *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001
5  *    2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
6  *     by Larry Wall and others
7  *
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.
10  *
11  */
12
13 /*
14  *      A ship then new they built for him
15  *      of mithril and of elven-glass
16  *              --from Bilbo's song of EƤrendil
17  *
18  *     [p.236 of _The Lord of the Rings_, II/i: "Many Meetings"]
19  */
20
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()
24  * function of the interpreter; that can be found in perlmain.c
25  */
26
27 #if defined(PERL_IS_MINIPERL) && !defined(USE_SITECUSTOMIZE)
28 #  define USE_SITECUSTOMIZE
29 #endif
30
31 #include "EXTERN.h"
32 #define PERL_IN_PERL_C
33 #include "perl.h"
34 #include "patchlevel.h"                 /* for local_patches */
35 #include "XSUB.h"
36 #include "charclass_invlists.h"
37
38 #ifdef NETWARE
39 #include "nwutil.h"     
40 #endif
41
42 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
43 #  ifdef I_SYSUIO
44 #    include <sys/uio.h>
45 #  endif
46
47 union control_un {
48   struct cmsghdr cm;
49   char control[CMSG_SPACE(sizeof(int))];
50 };
51
52 #endif
53
54 #ifndef HZ
55 #  ifdef CLK_TCK
56 #    define HZ CLK_TCK
57 #  else
58 #    define HZ 60
59 #  endif
60 #endif
61
62 #if !defined(STANDARD_C) && !defined(HAS_GETENV_PROTOTYPE) && !defined(PERL_MICRO)
63 char *getenv (char *); /* Usually in <stdlib.h> */
64 #endif
65
66 static I32 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen);
67
68 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
69 #  define validate_suid(rsfp) NOOP
70 #else
71 #  define validate_suid(rsfp) S_validate_suid(aTHX_ rsfp)
72 #endif
73
74 #define CALL_BODY_SUB(myop) \
75     if (PL_op == (myop)) \
76         PL_op = PL_ppaddr[OP_ENTERSUB](aTHX); \
77     if (PL_op) \
78         CALLRUNOPS(aTHX);
79
80 #define CALL_LIST_BODY(cv) \
81     PUSHMARK(PL_stack_sp); \
82     call_sv(MUTABLE_SV((cv)), G_EVAL|G_DISCARD|G_VOID);
83
84 static void
85 S_init_tls_and_interp(PerlInterpreter *my_perl)
86 {
87     dVAR;
88     if (!PL_curinterp) {                        
89         PERL_SET_INTERP(my_perl);
90 #if defined(USE_ITHREADS)
91         INIT_THREADS;
92         ALLOC_THREAD_KEY;
93         PERL_SET_THX(my_perl);
94         OP_REFCNT_INIT;
95         OP_CHECK_MUTEX_INIT;
96         HINTS_REFCNT_INIT;
97         MUTEX_INIT(&PL_dollarzero_mutex);
98         MUTEX_INIT(&PL_my_ctx_mutex);
99 #  endif
100     }
101 #if defined(USE_ITHREADS)
102     else
103 #else
104     /* This always happens for non-ithreads  */
105 #endif
106     {
107         PERL_SET_THX(my_perl);
108     }
109 }
110
111
112 /* these implement the PERL_SYS_INIT, PERL_SYS_INIT3, PERL_SYS_TERM macros */
113
114 void
115 Perl_sys_init(int* argc, char*** argv)
116 {
117     dVAR;
118
119     PERL_ARGS_ASSERT_SYS_INIT;
120
121     PERL_UNUSED_ARG(argc); /* may not be used depending on _BODY macro */
122     PERL_UNUSED_ARG(argv);
123     PERL_SYS_INIT_BODY(argc, argv);
124 }
125
126 void
127 Perl_sys_init3(int* argc, char*** argv, char*** env)
128 {
129     dVAR;
130
131     PERL_ARGS_ASSERT_SYS_INIT3;
132
133     PERL_UNUSED_ARG(argc); /* may not be used depending on _BODY macro */
134     PERL_UNUSED_ARG(argv);
135     PERL_UNUSED_ARG(env);
136     PERL_SYS_INIT3_BODY(argc, argv, env);
137 }
138
139 void
140 Perl_sys_term(void)
141 {
142     dVAR;
143     if (!PL_veto_cleanup) {
144         PERL_SYS_TERM_BODY();
145     }
146 }
147
148
149 #ifdef PERL_IMPLICIT_SYS
150 PerlInterpreter *
151 perl_alloc_using(struct IPerlMem* ipM, struct IPerlMem* ipMS,
152                  struct IPerlMem* ipMP, struct IPerlEnv* ipE,
153                  struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
154                  struct IPerlDir* ipD, struct IPerlSock* ipS,
155                  struct IPerlProc* ipP)
156 {
157     PerlInterpreter *my_perl;
158
159     PERL_ARGS_ASSERT_PERL_ALLOC_USING;
160
161     /* Newx() needs interpreter, so call malloc() instead */
162     my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
163     S_init_tls_and_interp(my_perl);
164     Zero(my_perl, 1, PerlInterpreter);
165     PL_Mem = ipM;
166     PL_MemShared = ipMS;
167     PL_MemParse = ipMP;
168     PL_Env = ipE;
169     PL_StdIO = ipStd;
170     PL_LIO = ipLIO;
171     PL_Dir = ipD;
172     PL_Sock = ipS;
173     PL_Proc = ipP;
174     INIT_TRACK_MEMPOOL(PL_memory_debug_header, my_perl);
175
176     return my_perl;
177 }
178 #else
179
180 /*
181 =head1 Embedding Functions
182
183 =for apidoc perl_alloc
184
185 Allocates a new Perl interpreter.  See L<perlembed>.
186
187 =cut
188 */
189
190 PerlInterpreter *
191 perl_alloc(void)
192 {
193     PerlInterpreter *my_perl;
194
195     /* Newx() needs interpreter, so call malloc() instead */
196     my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
197
198     S_init_tls_and_interp(my_perl);
199 #ifndef PERL_TRACK_MEMPOOL
200     return (PerlInterpreter *) ZeroD(my_perl, 1, PerlInterpreter);
201 #else
202     Zero(my_perl, 1, PerlInterpreter);
203     INIT_TRACK_MEMPOOL(PL_memory_debug_header, my_perl);
204     return my_perl;
205 #endif
206 }
207 #endif /* PERL_IMPLICIT_SYS */
208
209 /*
210 =for apidoc perl_construct
211
212 Initializes a new Perl interpreter.  See L<perlembed>.
213
214 =cut
215 */
216
217 void
218 perl_construct(pTHXx)
219 {
220     dVAR;
221
222     PERL_ARGS_ASSERT_PERL_CONSTRUCT;
223
224 #ifdef MULTIPLICITY
225     init_interp();
226     PL_perl_destruct_level = 1;
227 #else
228     PERL_UNUSED_ARG(my_perl);
229    if (PL_perl_destruct_level > 0)
230        init_interp();
231 #endif
232     PL_curcop = &PL_compiling;  /* needed by ckWARN, right away */
233
234 #ifdef PERL_TRACE_OPS
235     Zero(PL_op_exec_cnt, OP_max+2, UV);
236 #endif
237
238     init_constants();
239
240     SvREADONLY_on(&PL_sv_placeholder);
241     SvREFCNT(&PL_sv_placeholder) = SvREFCNT_IMMORTAL;
242
243     PL_sighandlerp = (Sighandler_t) Perl_sighandler;
244 #ifdef PERL_USES_PL_PIDSTATUS
245     PL_pidstatus = newHV();
246 #endif
247
248     PL_rs = newSVpvs("\n");
249
250     init_stacks();
251
252     init_ids();
253
254     JMPENV_BOOTSTRAP;
255     STATUS_ALL_SUCCESS;
256
257     init_i18nl10n(1);
258
259 #if defined(LOCAL_PATCH_COUNT)
260     PL_localpatches = local_patches;    /* For possible -v */
261 #endif
262
263 #ifdef HAVE_INTERP_INTERN
264     sys_intern_init();
265 #endif
266
267     PerlIO_init(aTHX);                  /* Hook to IO system */
268
269     PL_fdpid = newAV();                 /* for remembering popen pids by fd */
270     PL_modglobal = newHV();             /* pointers to per-interpreter module globals */
271     PL_errors = newSVpvs("");
272     sv_setpvs(PERL_DEBUG_PAD(0), "");   /* For regex debugging. */
273     sv_setpvs(PERL_DEBUG_PAD(1), "");   /* ext/re needs these */
274     sv_setpvs(PERL_DEBUG_PAD(2), "");   /* even without DEBUGGING. */
275 #ifdef USE_ITHREADS
276     /* First entry is a list of empty elements. It needs to be initialised
277        else all hell breaks loose in S_find_uninit_var().  */
278     Perl_av_create_and_push(aTHX_ &PL_regex_padav, newSVpvs(""));
279     PL_regex_pad = AvARRAY(PL_regex_padav);
280     Newxz(PL_stashpad, PL_stashpadmax, HV *);
281 #endif
282 #ifdef USE_REENTRANT_API
283     Perl_reentrant_init(aTHX);
284 #endif
285 #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT)
286         /* [perl #22371] Algorimic Complexity Attack on Perl 5.6.1, 5.8.0
287          * This MUST be done before any hash stores or fetches take place.
288          * If you set PL_hash_seed (and presumably also PL_hash_seed_set)
289          * yourself, it is your responsibility to provide a good random seed!
290          * You can also define PERL_HASH_SEED in compile time, see hv.h.
291          *
292          * XXX: fix this comment */
293     if (PL_hash_seed_set == FALSE) {
294         Perl_get_hash_seed(aTHX_ PL_hash_seed);
295         PL_hash_seed_set= TRUE;
296     }
297 #endif /* #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) */
298
299     /* Note that strtab is a rather special HV.  Assumptions are made
300        about not iterating on it, and not adding tie magic to it.
301        It is properly deallocated in perl_destruct() */
302     PL_strtab = newHV();
303
304     HvSHAREKEYS_off(PL_strtab);                 /* mandatory */
305     hv_ksplit(PL_strtab, 512);
306
307     Zero(PL_sv_consts, SV_CONSTS_COUNT, SV*);
308
309 #ifndef PERL_MICRO
310 #   ifdef  USE_ENVIRON_ARRAY
311     PL_origenviron = environ;
312 #   endif
313 #endif
314
315     /* Use sysconf(_SC_CLK_TCK) if available, if not
316      * available or if the sysconf() fails, use the HZ.
317      * The HZ if not originally defined has been by now
318      * been defined as CLK_TCK, if available. */
319 #if defined(HAS_SYSCONF) && defined(_SC_CLK_TCK)
320     PL_clocktick = sysconf(_SC_CLK_TCK);
321     if (PL_clocktick <= 0)
322 #endif
323          PL_clocktick = HZ;
324
325     PL_stashcache = newHV();
326
327     PL_patchlevel = newSVpvs("v" PERL_VERSION_STRING);
328
329 #ifdef HAS_MMAP
330     if (!PL_mmap_page_size) {
331 #if defined(HAS_SYSCONF) && (defined(_SC_PAGESIZE) || defined(_SC_MMAP_PAGE_SIZE))
332       {
333         SETERRNO(0, SS_NORMAL);
334 #   ifdef _SC_PAGESIZE
335         PL_mmap_page_size = sysconf(_SC_PAGESIZE);
336 #   else
337         PL_mmap_page_size = sysconf(_SC_MMAP_PAGE_SIZE);
338 #   endif
339         if ((long) PL_mmap_page_size < 0) {
340           if (errno) {
341             SV * const error = ERRSV;
342             SvUPGRADE(error, SVt_PV);
343             Perl_croak(aTHX_ "panic: sysconf: %s", SvPV_nolen_const(error));
344           }
345           else
346             Perl_croak(aTHX_ "panic: sysconf: pagesize unknown");
347         }
348       }
349 #else
350 #   ifdef HAS_GETPAGESIZE
351       PL_mmap_page_size = getpagesize();
352 #   else
353 #       if defined(I_SYS_PARAM) && defined(PAGESIZE)
354       PL_mmap_page_size = PAGESIZE;       /* compiletime, bad */
355 #       endif
356 #   endif
357 #endif
358       if (PL_mmap_page_size <= 0)
359         Perl_croak(aTHX_ "panic: bad pagesize %" IVdf,
360                    (IV) PL_mmap_page_size);
361     }
362 #endif /* HAS_MMAP */
363
364 #if defined(HAS_TIMES) && defined(PERL_NEED_TIMESBASE)
365     PL_timesbase.tms_utime  = 0;
366     PL_timesbase.tms_stime  = 0;
367     PL_timesbase.tms_cutime = 0;
368     PL_timesbase.tms_cstime = 0;
369 #endif
370
371     PL_osname = Perl_savepvn(aTHX_ STR_WITH_LEN(OSNAME));
372
373     PL_registered_mros = newHV();
374     /* Start with 1 bucket, for DFS.  It's unlikely we'll need more.  */
375     HvMAX(PL_registered_mros) = 0;
376
377     PL_XPosix_ptrs[_CC_ASCII] = _new_invlist_C_array(ASCII_invlist);
378     PL_XPosix_ptrs[_CC_ALPHANUMERIC] = _new_invlist_C_array(XPosixAlnum_invlist);
379     PL_XPosix_ptrs[_CC_ALPHA] = _new_invlist_C_array(XPosixAlpha_invlist);
380     PL_XPosix_ptrs[_CC_BLANK] = _new_invlist_C_array(XPosixBlank_invlist);
381     PL_XPosix_ptrs[_CC_CASED] =  _new_invlist_C_array(Cased_invlist);
382     PL_XPosix_ptrs[_CC_CNTRL] = _new_invlist_C_array(XPosixCntrl_invlist);
383     PL_XPosix_ptrs[_CC_DIGIT] = _new_invlist_C_array(XPosixDigit_invlist);
384     PL_XPosix_ptrs[_CC_GRAPH] = _new_invlist_C_array(XPosixGraph_invlist);
385     PL_XPosix_ptrs[_CC_LOWER] = _new_invlist_C_array(XPosixLower_invlist);
386     PL_XPosix_ptrs[_CC_PRINT] = _new_invlist_C_array(XPosixPrint_invlist);
387     PL_XPosix_ptrs[_CC_PUNCT] = _new_invlist_C_array(XPosixPunct_invlist);
388     PL_XPosix_ptrs[_CC_SPACE] = _new_invlist_C_array(XPerlSpace_invlist);
389     PL_XPosix_ptrs[_CC_PSXSPC] = _new_invlist_C_array(XPosixSpace_invlist);
390     PL_XPosix_ptrs[_CC_UPPER] = _new_invlist_C_array(XPosixUpper_invlist);
391     PL_XPosix_ptrs[_CC_VERTSPACE] = _new_invlist_C_array(VertSpace_invlist);
392     PL_XPosix_ptrs[_CC_WORDCHAR] = _new_invlist_C_array(XPosixWord_invlist);
393     PL_XPosix_ptrs[_CC_XDIGIT] = _new_invlist_C_array(XPosixXDigit_invlist);
394
395     ENTER;
396 }
397
398 /*
399 =for apidoc nothreadhook
400
401 Stub that provides thread hook for perl_destruct when there are
402 no threads.
403
404 =cut
405 */
406
407 int
408 Perl_nothreadhook(pTHX)
409 {
410     PERL_UNUSED_CONTEXT;
411     return 0;
412 }
413
414 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
415 void
416 Perl_dump_sv_child(pTHX_ SV *sv)
417 {
418     ssize_t got;
419     const int sock = PL_dumper_fd;
420     const int debug_fd = PerlIO_fileno(Perl_debug_log);
421     union control_un control;
422     struct msghdr msg;
423     struct iovec vec[2];
424     struct cmsghdr *cmptr;
425     int returned_errno;
426     unsigned char buffer[256];
427
428     PERL_ARGS_ASSERT_DUMP_SV_CHILD;
429
430     if(sock == -1 || debug_fd == -1)
431         return;
432
433     PerlIO_flush(Perl_debug_log);
434
435     /* All these shenanigans are to pass a file descriptor over to our child for
436        it to dump out to.  We can't let it hold open the file descriptor when it
437        forks, as the file descriptor it will dump to can turn out to be one end
438        of pipe that some other process will wait on for EOF. (So as it would
439        be open, the wait would be forever.)  */
440
441     msg.msg_control = control.control;
442     msg.msg_controllen = sizeof(control.control);
443     /* We're a connected socket so we don't need a destination  */
444     msg.msg_name = NULL;
445     msg.msg_namelen = 0;
446     msg.msg_iov = vec;
447     msg.msg_iovlen = 1;
448
449     cmptr = CMSG_FIRSTHDR(&msg);
450     cmptr->cmsg_len = CMSG_LEN(sizeof(int));
451     cmptr->cmsg_level = SOL_SOCKET;
452     cmptr->cmsg_type = SCM_RIGHTS;
453     *((int *)CMSG_DATA(cmptr)) = 1;
454
455     vec[0].iov_base = (void*)&sv;
456     vec[0].iov_len = sizeof(sv);
457     got = sendmsg(sock, &msg, 0);
458
459     if(got < 0) {
460         perror("Debug leaking scalars parent sendmsg failed");
461         abort();
462     }
463     if(got < sizeof(sv)) {
464         perror("Debug leaking scalars parent short sendmsg");
465         abort();
466     }
467
468     /* Return protocol is
469        int:             errno value
470        unsigned char:   length of location string (0 for empty)
471        unsigned char*:  string (not terminated)
472     */
473     vec[0].iov_base = (void*)&returned_errno;
474     vec[0].iov_len = sizeof(returned_errno);
475     vec[1].iov_base = buffer;
476     vec[1].iov_len = 1;
477
478     got = readv(sock, vec, 2);
479
480     if(got < 0) {
481         perror("Debug leaking scalars parent read failed");
482         PerlIO_flush(PerlIO_stderr());
483         abort();
484     }
485     if(got < sizeof(returned_errno) + 1) {
486         perror("Debug leaking scalars parent short read");
487         PerlIO_flush(PerlIO_stderr());
488         abort();
489     }
490
491     if (*buffer) {
492         got = read(sock, buffer + 1, *buffer);
493         if(got < 0) {
494             perror("Debug leaking scalars parent read 2 failed");
495             PerlIO_flush(PerlIO_stderr());
496             abort();
497         }
498
499         if(got < *buffer) {
500             perror("Debug leaking scalars parent short read 2");
501             PerlIO_flush(PerlIO_stderr());
502             abort();
503         }
504     }
505
506     if (returned_errno || *buffer) {
507         Perl_warn(aTHX_ "Debug leaking scalars child failed%s%.*s with errno"
508                   " %d: %s", (*buffer ? " at " : ""), (int) *buffer, buffer + 1,
509                   returned_errno, Strerror(returned_errno));
510     }
511 }
512 #endif
513
514 /*
515 =for apidoc perl_destruct
516
517 Shuts down a Perl interpreter.  See L<perlembed>.
518
519 =cut
520 */
521
522 int
523 perl_destruct(pTHXx)
524 {
525     dVAR;
526     VOL signed char destruct_level;  /* see possible values in intrpvar.h */
527     HV *hv;
528 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
529     pid_t child;
530 #endif
531     int i;
532
533     PERL_ARGS_ASSERT_PERL_DESTRUCT;
534 #ifndef MULTIPLICITY
535     PERL_UNUSED_ARG(my_perl);
536 #endif
537
538     assert(PL_scopestack_ix == 1);
539
540     /* wait for all pseudo-forked children to finish */
541     PERL_WAIT_FOR_CHILDREN;
542
543     destruct_level = PL_perl_destruct_level;
544 #if defined(DEBUGGING) || defined(PERL_TRACK_MEMPOOL)
545     {
546         const char * const s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL");
547         if (s) {
548             int i;
549             if (strEQ(s, "-1")) { /* Special case: modperl folklore. */
550                 i = -1;
551             } else {
552                 i = grok_atou(s, NULL);
553             }
554 #ifdef DEBUGGING
555             if (destruct_level < i) destruct_level = i;
556 #endif
557 #ifdef PERL_TRACK_MEMPOOL
558             /* RT #114496, for perl_free */
559             PL_perl_destruct_level = i;
560 #endif
561         }
562     }
563 #endif
564
565     if (PL_exit_flags & PERL_EXIT_DESTRUCT_END) {
566         dJMPENV;
567         int x = 0;
568
569         JMPENV_PUSH(x);
570         PERL_UNUSED_VAR(x);
571         if (PL_endav && !PL_minus_c) {
572             PERL_SET_PHASE(PERL_PHASE_END);
573             call_list(PL_scopestack_ix, PL_endav);
574         }
575         JMPENV_POP;
576     }
577     LEAVE;
578     FREETMPS;
579     assert(PL_scopestack_ix == 0);
580
581     /* Need to flush since END blocks can produce output */
582     my_fflush_all();
583
584 #ifdef PERL_TRACE_OPS
585     /* If we traced all Perl OP usage, report and clean up */
586     PerlIO_printf(Perl_debug_log, "Trace of all OPs executed:\n");
587     for (i = 0; i <= OP_max; ++i) {
588         PerlIO_printf(Perl_debug_log, "  %s: %"UVuf"\n", PL_op_name[i], PL_op_exec_cnt[i]);
589         PL_op_exec_cnt[i] = 0;
590     }
591     /* Utility slot for easily doing little tracing experiments in the runloop: */
592     if (PL_op_exec_cnt[OP_max+1] != 0)
593         PerlIO_printf(Perl_debug_log, "  SPECIAL: %"UVuf"\n", PL_op_exec_cnt[OP_max+1]);
594     PerlIO_printf(Perl_debug_log, "\n");
595 #endif
596
597
598     if (PL_threadhook(aTHX)) {
599         /* Threads hook has vetoed further cleanup */
600         PL_veto_cleanup = TRUE;
601         return STATUS_EXIT;
602     }
603
604 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
605     if (destruct_level != 0) {
606         /* Fork here to create a child. Our child's job is to preserve the
607            state of scalars prior to destruction, so that we can instruct it
608            to dump any scalars that we later find have leaked.
609            There's no subtlety in this code - it assumes POSIX, and it doesn't
610            fail gracefully  */
611         int fd[2];
612
613         if(socketpair(AF_UNIX, SOCK_STREAM, 0, fd)) {
614             perror("Debug leaking scalars socketpair failed");
615             abort();
616         }
617
618         child = fork();
619         if(child == -1) {
620             perror("Debug leaking scalars fork failed");
621             abort();
622         }
623         if (!child) {
624             /* We are the child */
625             const int sock = fd[1];
626             const int debug_fd = PerlIO_fileno(Perl_debug_log);
627             int f;
628             const char *where;
629             /* Our success message is an integer 0, and a char 0  */
630             static const char success[sizeof(int) + 1] = {0};
631
632             close(fd[0]);
633
634             /* We need to close all other file descriptors otherwise we end up
635                with interesting hangs, where the parent closes its end of a
636                pipe, and sits waiting for (another) child to terminate. Only
637                that child never terminates, because it never gets EOF, because
638                we also have the far end of the pipe open.  We even need to
639                close the debugging fd, because sometimes it happens to be one
640                end of a pipe, and a process is waiting on the other end for
641                EOF. Normally it would be closed at some point earlier in
642                destruction, but if we happen to cause the pipe to remain open,
643                EOF never occurs, and we get an infinite hang. Hence all the
644                games to pass in a file descriptor if it's actually needed.  */
645
646             f = sysconf(_SC_OPEN_MAX);
647             if(f < 0) {
648                 where = "sysconf failed";
649                 goto abort;
650             }
651             while (f--) {
652                 if (f == sock)
653                     continue;
654                 close(f);
655             }
656
657             while (1) {
658                 SV *target;
659                 union control_un control;
660                 struct msghdr msg;
661                 struct iovec vec[1];
662                 struct cmsghdr *cmptr;
663                 ssize_t got;
664                 int got_fd;
665
666                 msg.msg_control = control.control;
667                 msg.msg_controllen = sizeof(control.control);
668                 /* We're a connected socket so we don't need a source  */
669                 msg.msg_name = NULL;
670                 msg.msg_namelen = 0;
671                 msg.msg_iov = vec;
672                 msg.msg_iovlen = C_ARRAY_LENGTH(vec);
673
674                 vec[0].iov_base = (void*)&target;
675                 vec[0].iov_len = sizeof(target);
676       
677                 got = recvmsg(sock, &msg, 0);
678
679                 if(got == 0)
680                     break;
681                 if(got < 0) {
682                     where = "recv failed";
683                     goto abort;
684                 }
685                 if(got < sizeof(target)) {
686                     where = "short recv";
687                     goto abort;
688                 }
689
690                 if(!(cmptr = CMSG_FIRSTHDR(&msg))) {
691                     where = "no cmsg";
692                     goto abort;
693                 }
694                 if(cmptr->cmsg_len != CMSG_LEN(sizeof(int))) {
695                     where = "wrong cmsg_len";
696                     goto abort;
697                 }
698                 if(cmptr->cmsg_level != SOL_SOCKET) {
699                     where = "wrong cmsg_level";
700                     goto abort;
701                 }
702                 if(cmptr->cmsg_type != SCM_RIGHTS) {
703                     where = "wrong cmsg_type";
704                     goto abort;
705                 }
706
707                 got_fd = *(int*)CMSG_DATA(cmptr);
708                 /* For our last little bit of trickery, put the file descriptor
709                    back into Perl_debug_log, as if we never actually closed it
710                 */
711                 if(got_fd != debug_fd) {
712                     if (dup2(got_fd, debug_fd) == -1) {
713                         where = "dup2";
714                         goto abort;
715                     }
716                 }
717                 sv_dump(target);
718
719                 PerlIO_flush(Perl_debug_log);
720
721                 got = write(sock, &success, sizeof(success));
722
723                 if(got < 0) {
724                     where = "write failed";
725                     goto abort;
726                 }
727                 if(got < sizeof(success)) {
728                     where = "short write";
729                     goto abort;
730                 }
731             }
732             _exit(0);
733         abort:
734             {
735                 int send_errno = errno;
736                 unsigned char length = (unsigned char) strlen(where);
737                 struct iovec failure[3] = {
738                     {(void*)&send_errno, sizeof(send_errno)},
739                     {&length, 1},
740                     {(void*)where, length}
741                 };
742                 int got = writev(sock, failure, 3);
743                 /* Bad news travels fast. Faster than data. We'll get a SIGPIPE
744                    in the parent if we try to read from the socketpair after the
745                    child has exited, even if there was data to read.
746                    So sleep a bit to give the parent a fighting chance of
747                    reading the data.  */
748                 sleep(2);
749                 _exit((got == -1) ? errno : 0);
750             }
751             /* End of child.  */
752         }
753         PL_dumper_fd = fd[0];
754         close(fd[1]);
755     }
756 #endif
757     
758     /* We must account for everything.  */
759
760     /* Destroy the main CV and syntax tree */
761     /* Set PL_curcop now, because destroying ops can cause new SVs
762        to be generated in Perl_pad_swipe, and when running with
763       -DDEBUG_LEAKING_SCALARS they expect PL_curcop to point to a valid
764        op from which the filename structure member is copied.  */
765     PL_curcop = &PL_compiling;
766     if (PL_main_root) {
767         /* ensure comppad/curpad to refer to main's pad */
768         if (CvPADLIST(PL_main_cv)) {
769             PAD_SET_CUR_NOSAVE(CvPADLIST(PL_main_cv), 1);
770             PL_comppad_name = PadlistNAMES(CvPADLIST(PL_main_cv));
771         }
772         op_free(PL_main_root);
773         PL_main_root = NULL;
774     }
775     PL_main_start = NULL;
776     /* note that  PL_main_cv isn't usually actually freed at this point,
777      * due to the CvOUTSIDE refs from subs compiled within it. It will
778      * get freed once all the subs are freed in sv_clean_all(), for
779      * destruct_level > 0 */
780     SvREFCNT_dec(PL_main_cv);
781     PL_main_cv = NULL;
782     PERL_SET_PHASE(PERL_PHASE_DESTRUCT);
783
784     /* Tell PerlIO we are about to tear things apart in case
785        we have layers which are using resources that should
786        be cleaned up now.
787      */
788
789     PerlIO_destruct(aTHX);
790
791     /*
792      * Try to destruct global references.  We do this first so that the
793      * destructors and destructees still exist.  Some sv's might remain.
794      * Non-referenced objects are on their own.
795      */
796     sv_clean_objs();
797
798     /* unhook hooks which will soon be, or use, destroyed data */
799     SvREFCNT_dec(PL_warnhook);
800     PL_warnhook = NULL;
801     SvREFCNT_dec(PL_diehook);
802     PL_diehook = NULL;
803
804     /* call exit list functions */
805     while (PL_exitlistlen-- > 0)
806         PL_exitlist[PL_exitlistlen].fn(aTHX_ PL_exitlist[PL_exitlistlen].ptr);
807
808     Safefree(PL_exitlist);
809
810     PL_exitlist = NULL;
811     PL_exitlistlen = 0;
812
813     SvREFCNT_dec(PL_registered_mros);
814
815     /* jettison our possibly duplicated environment */
816     /* if PERL_USE_SAFE_PUTENV is defined environ will not have been copied
817      * so we certainly shouldn't free it here
818      */
819 #ifndef PERL_MICRO
820 #if defined(USE_ENVIRON_ARRAY) && !defined(PERL_USE_SAFE_PUTENV)
821     if (environ != PL_origenviron && !PL_use_safe_putenv
822 #ifdef USE_ITHREADS
823         /* only main thread can free environ[0] contents */
824         && PL_curinterp == aTHX
825 #endif
826         )
827     {
828         I32 i;
829
830         for (i = 0; environ[i]; i++)
831             safesysfree(environ[i]);
832
833         /* Must use safesysfree() when working with environ. */
834         safesysfree(environ);           
835
836         environ = PL_origenviron;
837     }
838 #endif
839 #endif /* !PERL_MICRO */
840
841     if (destruct_level == 0) {
842
843         DEBUG_P(debprofdump());
844
845 #if defined(PERLIO_LAYERS)
846         /* No more IO - including error messages ! */
847         PerlIO_cleanup(aTHX);
848 #endif
849
850         CopFILE_free(&PL_compiling);
851
852         /* The exit() function will do everything that needs doing. */
853         return STATUS_EXIT;
854     }
855
856     /* Below, do clean up for when PERL_DESTRUCT_LEVEL is not 0 */
857
858 #ifdef USE_ITHREADS
859     /* the syntax tree is shared between clones
860      * so op_free(PL_main_root) only ReREFCNT_dec's
861      * REGEXPs in the parent interpreter
862      * we need to manually ReREFCNT_dec for the clones
863      */
864     {
865         I32 i = AvFILLp(PL_regex_padav);
866         SV **ary = AvARRAY(PL_regex_padav);
867
868         for (; i; i--) {
869             SvREFCNT_dec(ary[i]);
870             ary[i] = &PL_sv_undef;
871         }
872     }
873 #endif
874
875
876     SvREFCNT_dec(MUTABLE_SV(PL_stashcache));
877     PL_stashcache = NULL;
878
879     /* loosen bonds of global variables */
880
881     /* XXX can PL_parser still be non-null here? */
882     if(PL_parser && PL_parser->rsfp) {
883         (void)PerlIO_close(PL_parser->rsfp);
884         PL_parser->rsfp = NULL;
885     }
886
887     if (PL_minus_F) {
888         Safefree(PL_splitstr);
889         PL_splitstr = NULL;
890     }
891
892     /* switches */
893     PL_minus_n      = FALSE;
894     PL_minus_p      = FALSE;
895     PL_minus_l      = FALSE;
896     PL_minus_a      = FALSE;
897     PL_minus_F      = FALSE;
898     PL_doswitches   = FALSE;
899     PL_dowarn       = G_WARN_OFF;
900 #ifdef PERL_SAWAMPERSAND
901     PL_sawampersand = 0;        /* must save all match strings */
902 #endif
903     PL_unsafe       = FALSE;
904
905     Safefree(PL_inplace);
906     PL_inplace = NULL;
907     SvREFCNT_dec(PL_patchlevel);
908
909     if (PL_e_script) {
910         SvREFCNT_dec(PL_e_script);
911         PL_e_script = NULL;
912     }
913
914     PL_perldb = 0;
915
916     /* magical thingies */
917
918     SvREFCNT_dec(PL_ofsgv);     /* *, */
919     PL_ofsgv = NULL;
920
921     SvREFCNT_dec(PL_ors_sv);    /* $\ */
922     PL_ors_sv = NULL;
923
924     SvREFCNT_dec(PL_rs);        /* $/ */
925     PL_rs = NULL;
926
927     Safefree(PL_osname);        /* $^O */
928     PL_osname = NULL;
929
930     SvREFCNT_dec(PL_statname);
931     PL_statname = NULL;
932     PL_statgv = NULL;
933
934     /* defgv, aka *_ should be taken care of elsewhere */
935
936     /* float buffer */
937     Safefree(PL_efloatbuf);
938     PL_efloatbuf = NULL;
939     PL_efloatsize = 0;
940
941     /* startup and shutdown function lists */
942     SvREFCNT_dec(PL_beginav);
943     SvREFCNT_dec(PL_beginav_save);
944     SvREFCNT_dec(PL_endav);
945     SvREFCNT_dec(PL_checkav);
946     SvREFCNT_dec(PL_checkav_save);
947     SvREFCNT_dec(PL_unitcheckav);
948     SvREFCNT_dec(PL_unitcheckav_save);
949     SvREFCNT_dec(PL_initav);
950     PL_beginav = NULL;
951     PL_beginav_save = NULL;
952     PL_endav = NULL;
953     PL_checkav = NULL;
954     PL_checkav_save = NULL;
955     PL_unitcheckav = NULL;
956     PL_unitcheckav_save = NULL;
957     PL_initav = NULL;
958
959     /* shortcuts just get cleared */
960     PL_hintgv = NULL;
961     PL_errgv = NULL;
962     PL_argvoutgv = NULL;
963     PL_stdingv = NULL;
964     PL_stderrgv = NULL;
965     PL_last_in_gv = NULL;
966     PL_DBsingle = NULL;
967     PL_DBtrace = NULL;
968     PL_DBsignal = NULL;
969     PL_DBsingle_iv = 0;
970     PL_DBtrace_iv = 0;
971     PL_DBsignal_iv = 0;
972     PL_DBcv = NULL;
973     PL_dbargs = NULL;
974     PL_debstash = NULL;
975
976     SvREFCNT_dec(PL_envgv);
977     SvREFCNT_dec(PL_incgv);
978     SvREFCNT_dec(PL_argvgv);
979     SvREFCNT_dec(PL_replgv);
980     SvREFCNT_dec(PL_DBgv);
981     SvREFCNT_dec(PL_DBline);
982     SvREFCNT_dec(PL_DBsub);
983     PL_envgv = NULL;
984     PL_incgv = NULL;
985     PL_argvgv = NULL;
986     PL_replgv = NULL;
987     PL_DBgv = NULL;
988     PL_DBline = NULL;
989     PL_DBsub = NULL;
990
991     SvREFCNT_dec(PL_argvout_stack);
992     PL_argvout_stack = NULL;
993
994     SvREFCNT_dec(PL_modglobal);
995     PL_modglobal = NULL;
996     SvREFCNT_dec(PL_preambleav);
997     PL_preambleav = NULL;
998     SvREFCNT_dec(PL_subname);
999     PL_subname = NULL;
1000 #ifdef PERL_USES_PL_PIDSTATUS
1001     SvREFCNT_dec(PL_pidstatus);
1002     PL_pidstatus = NULL;
1003 #endif
1004     SvREFCNT_dec(PL_toptarget);
1005     PL_toptarget = NULL;
1006     SvREFCNT_dec(PL_bodytarget);
1007     PL_bodytarget = NULL;
1008     PL_formtarget = NULL;
1009
1010     /* free locale stuff */
1011 #ifdef USE_LOCALE_COLLATE
1012     Safefree(PL_collation_name);
1013     PL_collation_name = NULL;
1014 #endif
1015
1016 #ifdef USE_LOCALE_NUMERIC
1017     Safefree(PL_numeric_name);
1018     PL_numeric_name = NULL;
1019     SvREFCNT_dec(PL_numeric_radix_sv);
1020     PL_numeric_radix_sv = NULL;
1021 #endif
1022
1023     /* clear character classes  */
1024     for (i = 0; i < POSIX_SWASH_COUNT; i++) {
1025         SvREFCNT_dec(PL_utf8_swash_ptrs[i]);
1026         PL_utf8_swash_ptrs[i] = NULL;
1027     }
1028     SvREFCNT_dec(PL_utf8_mark);
1029     SvREFCNT_dec(PL_utf8_toupper);
1030     SvREFCNT_dec(PL_utf8_totitle);
1031     SvREFCNT_dec(PL_utf8_tolower);
1032     SvREFCNT_dec(PL_utf8_tofold);
1033     SvREFCNT_dec(PL_utf8_idstart);
1034     SvREFCNT_dec(PL_utf8_idcont);
1035     SvREFCNT_dec(PL_utf8_foldable);
1036     SvREFCNT_dec(PL_utf8_foldclosures);
1037     SvREFCNT_dec(PL_AboveLatin1);
1038     SvREFCNT_dec(PL_InBitmap);
1039     SvREFCNT_dec(PL_UpperLatin1);
1040     SvREFCNT_dec(PL_Latin1);
1041     SvREFCNT_dec(PL_NonL1NonFinalFold);
1042     SvREFCNT_dec(PL_HasMultiCharFold);
1043     PL_utf8_mark        = NULL;
1044     PL_utf8_toupper     = NULL;
1045     PL_utf8_totitle     = NULL;
1046     PL_utf8_tolower     = NULL;
1047     PL_utf8_tofold      = NULL;
1048     PL_utf8_idstart     = NULL;
1049     PL_utf8_idcont      = NULL;
1050     PL_utf8_foldclosures = NULL;
1051     PL_AboveLatin1       = NULL;
1052     PL_InBitmap          = NULL;
1053     PL_HasMultiCharFold  = NULL;
1054     PL_Latin1            = NULL;
1055     PL_NonL1NonFinalFold = NULL;
1056     PL_UpperLatin1       = NULL;
1057     for (i = 0; i < POSIX_CC_COUNT; i++) {
1058         SvREFCNT_dec(PL_XPosix_ptrs[i]);
1059         PL_XPosix_ptrs[i] = NULL;
1060     }
1061
1062     if (!specialWARN(PL_compiling.cop_warnings))
1063         PerlMemShared_free(PL_compiling.cop_warnings);
1064     PL_compiling.cop_warnings = NULL;
1065     cophh_free(CopHINTHASH_get(&PL_compiling));
1066     CopHINTHASH_set(&PL_compiling, cophh_new_empty());
1067     CopFILE_free(&PL_compiling);
1068
1069     /* Prepare to destruct main symbol table.  */
1070
1071     hv = PL_defstash;
1072     /* break ref loop  *:: <=> %:: */
1073     (void)hv_delete(hv, "main::", 6, G_DISCARD);
1074     PL_defstash = 0;
1075     SvREFCNT_dec(hv);
1076     SvREFCNT_dec(PL_curstname);
1077     PL_curstname = NULL;
1078
1079     /* clear queued errors */
1080     SvREFCNT_dec(PL_errors);
1081     PL_errors = NULL;
1082
1083     SvREFCNT_dec(PL_isarev);
1084
1085     FREETMPS;
1086     if (destruct_level >= 2) {
1087         if (PL_scopestack_ix != 0)
1088             Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
1089                              "Unbalanced scopes: %ld more ENTERs than LEAVEs\n",
1090                              (long)PL_scopestack_ix);
1091         if (PL_savestack_ix != 0)
1092             Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
1093                              "Unbalanced saves: %ld more saves than restores\n",
1094                              (long)PL_savestack_ix);
1095         if (PL_tmps_floor != -1)
1096             Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced tmps: %ld more allocs than frees\n",
1097                              (long)PL_tmps_floor + 1);
1098         if (cxstack_ix != -1)
1099             Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced context: %ld more PUSHes than POPs\n",
1100                              (long)cxstack_ix + 1);
1101     }
1102
1103 #ifdef USE_ITHREADS
1104     SvREFCNT_dec(PL_regex_padav);
1105     PL_regex_padav = NULL;
1106     PL_regex_pad = NULL;
1107 #endif
1108
1109 #ifdef PERL_IMPLICIT_CONTEXT
1110     /* the entries in this list are allocated via SV PVX's, so get freed
1111      * in sv_clean_all */
1112     Safefree(PL_my_cxt_list);
1113 #endif
1114
1115     /* Now absolutely destruct everything, somehow or other, loops or no. */
1116
1117     /* the 2 is for PL_fdpid and PL_strtab */
1118     while (sv_clean_all() > 2)
1119         ;
1120
1121 #ifdef USE_ITHREADS
1122     Safefree(PL_stashpad); /* must come after sv_clean_all */
1123 #endif
1124
1125     AvREAL_off(PL_fdpid);               /* no surviving entries */
1126     SvREFCNT_dec(PL_fdpid);             /* needed in io_close() */
1127     PL_fdpid = NULL;
1128
1129 #ifdef HAVE_INTERP_INTERN
1130     sys_intern_clear();
1131 #endif
1132
1133     /* constant strings */
1134     for (i = 0; i < SV_CONSTS_COUNT; i++) {
1135         SvREFCNT_dec(PL_sv_consts[i]);
1136         PL_sv_consts[i] = NULL;
1137     }
1138
1139     /* Destruct the global string table. */
1140     {
1141         /* Yell and reset the HeVAL() slots that are still holding refcounts,
1142          * so that sv_free() won't fail on them.
1143          * Now that the global string table is using a single hunk of memory
1144          * for both HE and HEK, we either need to explicitly unshare it the
1145          * correct way, or actually free things here.
1146          */
1147         I32 riter = 0;
1148         const I32 max = HvMAX(PL_strtab);
1149         HE * const * const array = HvARRAY(PL_strtab);
1150         HE *hent = array[0];
1151
1152         for (;;) {
1153             if (hent && ckWARN_d(WARN_INTERNAL)) {
1154                 HE * const next = HeNEXT(hent);
1155                 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
1156                      "Unbalanced string table refcount: (%ld) for \"%s\"",
1157                      (long)hent->he_valu.hent_refcount, HeKEY(hent));
1158                 Safefree(hent);
1159                 hent = next;
1160             }
1161             if (!hent) {
1162                 if (++riter > max)
1163                     break;
1164                 hent = array[riter];
1165             }
1166         }
1167
1168         Safefree(array);
1169         HvARRAY(PL_strtab) = 0;
1170         HvTOTALKEYS(PL_strtab) = 0;
1171     }
1172     SvREFCNT_dec(PL_strtab);
1173
1174 #ifdef USE_ITHREADS
1175     /* free the pointer tables used for cloning */
1176     ptr_table_free(PL_ptr_table);
1177     PL_ptr_table = (PTR_TBL_t*)NULL;
1178 #endif
1179
1180     /* free special SVs */
1181
1182     SvREFCNT(&PL_sv_yes) = 0;
1183     sv_clear(&PL_sv_yes);
1184     SvANY(&PL_sv_yes) = NULL;
1185     SvFLAGS(&PL_sv_yes) = 0;
1186
1187     SvREFCNT(&PL_sv_no) = 0;
1188     sv_clear(&PL_sv_no);
1189     SvANY(&PL_sv_no) = NULL;
1190     SvFLAGS(&PL_sv_no) = 0;
1191
1192     {
1193         int i;
1194         for (i=0; i<=2; i++) {
1195             SvREFCNT(PERL_DEBUG_PAD(i)) = 0;
1196             sv_clear(PERL_DEBUG_PAD(i));
1197             SvANY(PERL_DEBUG_PAD(i)) = NULL;
1198             SvFLAGS(PERL_DEBUG_PAD(i)) = 0;
1199         }
1200     }
1201
1202     if (PL_sv_count != 0 && ckWARN_d(WARN_INTERNAL))
1203         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Scalars leaked: %ld\n", (long)PL_sv_count);
1204
1205 #ifdef DEBUG_LEAKING_SCALARS
1206     if (PL_sv_count != 0) {
1207         SV* sva;
1208         SV* sv;
1209         SV* svend;
1210
1211         for (sva = PL_sv_arenaroot; sva; sva = MUTABLE_SV(SvANY(sva))) {
1212             svend = &sva[SvREFCNT(sva)];
1213             for (sv = sva + 1; sv < svend; ++sv) {
1214                 if (SvTYPE(sv) != (svtype)SVTYPEMASK) {
1215                     PerlIO_printf(Perl_debug_log, "leaked: sv=0x%p"
1216                         " flags=0x%"UVxf
1217                         " refcnt=%"UVuf pTHX__FORMAT "\n"
1218                         "\tallocated at %s:%d %s %s (parent 0x%"UVxf");"
1219                         "serial %"UVuf"\n",
1220                         (void*)sv, (UV)sv->sv_flags, (UV)sv->sv_refcnt
1221                         pTHX__VALUE,
1222                         sv->sv_debug_file ? sv->sv_debug_file : "(unknown)",
1223                         sv->sv_debug_line,
1224                         sv->sv_debug_inpad ? "for" : "by",
1225                         sv->sv_debug_optype ?
1226                             PL_op_name[sv->sv_debug_optype]: "(none)",
1227                         PTR2UV(sv->sv_debug_parent),
1228                         sv->sv_debug_serial
1229                     );
1230 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
1231                     Perl_dump_sv_child(aTHX_ sv);
1232 #endif
1233                 }
1234             }
1235         }
1236     }
1237 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
1238     {
1239         int status;
1240         fd_set rset;
1241         /* Wait for up to 4 seconds for child to terminate.
1242            This seems to be the least effort way of timing out on reaping
1243            its exit status.  */
1244         struct timeval waitfor = {4, 0};
1245         int sock = PL_dumper_fd;
1246
1247         shutdown(sock, 1);
1248         FD_ZERO(&rset);
1249         FD_SET(sock, &rset);
1250         select(sock + 1, &rset, NULL, NULL, &waitfor);
1251         waitpid(child, &status, WNOHANG);
1252         close(sock);
1253     }
1254 #endif
1255 #endif
1256 #ifdef DEBUG_LEAKING_SCALARS_ABORT
1257     if (PL_sv_count)
1258         abort();
1259 #endif
1260     PL_sv_count = 0;
1261
1262 #if defined(PERLIO_LAYERS)
1263     /* No more IO - including error messages ! */
1264     PerlIO_cleanup(aTHX);
1265 #endif
1266
1267     /* sv_undef needs to stay immortal until after PerlIO_cleanup
1268        as currently layers use it rather than NULL as a marker
1269        for no arg - and will try and SvREFCNT_dec it.
1270      */
1271     SvREFCNT(&PL_sv_undef) = 0;
1272     SvREADONLY_off(&PL_sv_undef);
1273
1274     Safefree(PL_origfilename);
1275     PL_origfilename = NULL;
1276     Safefree(PL_reg_curpm);
1277     free_tied_hv_pool();
1278     Safefree(PL_op_mask);
1279     Safefree(PL_psig_name);
1280     PL_psig_name = (SV**)NULL;
1281     PL_psig_ptr = (SV**)NULL;
1282     {
1283         /* We need to NULL PL_psig_pend first, so that
1284            signal handlers know not to use it */
1285         int *psig_save = PL_psig_pend;
1286         PL_psig_pend = (int*)NULL;
1287         Safefree(psig_save);
1288     }
1289     nuke_stacks();
1290     TAINTING_set(FALSE);
1291     TAINT_WARN_set(FALSE);
1292     PL_hints = 0;               /* Reset hints. Should hints be per-interpreter ? */
1293     PL_debug = 0;
1294
1295     DEBUG_P(debprofdump());
1296
1297 #ifdef USE_REENTRANT_API
1298     Perl_reentrant_free(aTHX);
1299 #endif
1300
1301     sv_free_arenas();
1302
1303     while (PL_regmatch_slab) {
1304         regmatch_slab  *s = PL_regmatch_slab;
1305         PL_regmatch_slab = PL_regmatch_slab->next;
1306         Safefree(s);
1307     }
1308
1309     /* As the absolutely last thing, free the non-arena SV for mess() */
1310
1311     if (PL_mess_sv) {
1312         /* we know that type == SVt_PVMG */
1313
1314         /* it could have accumulated taint magic */
1315         MAGIC* mg;
1316         MAGIC* moremagic;
1317         for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
1318             moremagic = mg->mg_moremagic;
1319             if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
1320                 && mg->mg_len >= 0)
1321                 Safefree(mg->mg_ptr);
1322             Safefree(mg);
1323         }
1324
1325         /* we know that type >= SVt_PV */
1326         SvPV_free(PL_mess_sv);
1327         Safefree(SvANY(PL_mess_sv));
1328         Safefree(PL_mess_sv);
1329         PL_mess_sv = NULL;
1330     }
1331     return STATUS_EXIT;
1332 }
1333
1334 /*
1335 =for apidoc perl_free
1336
1337 Releases a Perl interpreter.  See L<perlembed>.
1338
1339 =cut
1340 */
1341
1342 void
1343 perl_free(pTHXx)
1344 {
1345     dVAR;
1346
1347     PERL_ARGS_ASSERT_PERL_FREE;
1348
1349     if (PL_veto_cleanup)
1350         return;
1351
1352 #ifdef PERL_TRACK_MEMPOOL
1353     {
1354         /*
1355          * Don't free thread memory if PERL_DESTRUCT_LEVEL is set to a non-zero
1356          * value as we're probably hunting memory leaks then
1357          */
1358         if (PL_perl_destruct_level == 0) {
1359             const U32 old_debug = PL_debug;
1360             /* Emulate the PerlHost behaviour of free()ing all memory allocated in this
1361                thread at thread exit.  */
1362             if (DEBUG_m_TEST) {
1363                 PerlIO_puts(Perl_debug_log, "Disabling memory debugging as we "
1364                             "free this thread's memory\n");
1365                 PL_debug &= ~ DEBUG_m_FLAG;
1366             }
1367             while(aTHXx->Imemory_debug_header.next != &(aTHXx->Imemory_debug_header))
1368                 safesysfree(PERL_MEMORY_DEBUG_HEADER_SIZE + (char *)(aTHXx->Imemory_debug_header.next));
1369             PL_debug = old_debug;
1370         }
1371     }
1372 #endif
1373
1374 #if defined(WIN32) || defined(NETWARE)
1375 #  if defined(PERL_IMPLICIT_SYS)
1376     {
1377 #    ifdef NETWARE
1378         void *host = nw_internal_host;
1379         PerlMem_free(aTHXx);
1380         nw_delete_internal_host(host);
1381 #    else
1382         void *host = w32_internal_host;
1383         PerlMem_free(aTHXx);
1384         win32_delete_internal_host(host);
1385 #    endif
1386     }
1387 #  else
1388     PerlMem_free(aTHXx);
1389 #  endif
1390 #else
1391     PerlMem_free(aTHXx);
1392 #endif
1393 }
1394
1395 #if defined(USE_ITHREADS)
1396 /* provide destructors to clean up the thread key when libperl is unloaded */
1397 #ifndef WIN32 /* handled during DLL_PROCESS_DETACH in win32/perllib.c */
1398
1399 #if defined(__hpux) && !(defined(__ux_version) && __ux_version <= 1020) && !defined(__GNUC__)
1400 #pragma fini "perl_fini"
1401 #elif defined(__sun) && !defined(__GNUC__)
1402 #pragma fini (perl_fini)
1403 #endif
1404
1405 static void
1406 #if defined(__GNUC__)
1407 __attribute__((destructor))
1408 #endif
1409 perl_fini(void)
1410 {
1411     dVAR;
1412     if (
1413 #ifdef PERL_GLOBAL_STRUCT_PRIVATE
1414         my_vars &&
1415 #endif
1416         PL_curinterp && !PL_veto_cleanup)
1417         FREE_THREAD_KEY;
1418 }
1419
1420 #endif /* WIN32 */
1421 #endif /* THREADS */
1422
1423 void
1424 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
1425 {
1426     Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
1427     PL_exitlist[PL_exitlistlen].fn = fn;
1428     PL_exitlist[PL_exitlistlen].ptr = ptr;
1429     ++PL_exitlistlen;
1430 }
1431
1432 /*
1433 =for apidoc perl_parse
1434
1435 Tells a Perl interpreter to parse a Perl script.  See L<perlembed>.
1436
1437 =cut
1438 */
1439
1440 #define SET_CURSTASH(newstash)                       \
1441         if (PL_curstash != newstash) {                \
1442             SvREFCNT_dec(PL_curstash);                 \
1443             PL_curstash = (HV *)SvREFCNT_inc(newstash); \
1444         }
1445
1446 int
1447 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
1448 {
1449     dVAR;
1450     I32 oldscope;
1451     int ret;
1452     dJMPENV;
1453
1454     PERL_ARGS_ASSERT_PERL_PARSE;
1455 #ifndef MULTIPLICITY
1456     PERL_UNUSED_ARG(my_perl);
1457 #endif
1458 #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) || defined(USE_HASH_SEED_DEBUG)
1459     {
1460         const char * const s = PerlEnv_getenv("PERL_HASH_SEED_DEBUG");
1461
1462         if (s && (grok_atou(s, NULL) == 1)) {
1463             unsigned char *seed= PERL_HASH_SEED;
1464             unsigned char *seed_end= PERL_HASH_SEED + PERL_HASH_SEED_BYTES;
1465             PerlIO_printf(Perl_debug_log, "HASH_FUNCTION = %s HASH_SEED = 0x", PERL_HASH_FUNC);
1466             while (seed < seed_end) {
1467                 PerlIO_printf(Perl_debug_log, "%02x", *seed++);
1468             }
1469 #ifdef PERL_HASH_RANDOMIZE_KEYS
1470             PerlIO_printf(Perl_debug_log, " PERTURB_KEYS = %d (%s)",
1471                     PL_HASH_RAND_BITS_ENABLED,
1472                     PL_HASH_RAND_BITS_ENABLED == 0 ? "NO" : PL_HASH_RAND_BITS_ENABLED == 1 ? "RANDOM" : "DETERMINISTIC");
1473 #endif
1474             PerlIO_printf(Perl_debug_log, "\n");
1475         }
1476     }
1477 #endif /* #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) */
1478     PL_origargc = argc;
1479     PL_origargv = argv;
1480
1481     if (PL_origalen != 0) {
1482         PL_origalen = 1; /* don't use old PL_origalen if perl_parse() is called again */
1483     }
1484     else {
1485         /* Set PL_origalen be the sum of the contiguous argv[]
1486          * elements plus the size of the env in case that it is
1487          * contiguous with the argv[].  This is used in mg.c:Perl_magic_set()
1488          * as the maximum modifiable length of $0.  In the worst case
1489          * the area we are able to modify is limited to the size of
1490          * the original argv[0].  (See below for 'contiguous', though.)
1491          * --jhi */
1492          const char *s = NULL;
1493          int i;
1494          const UV mask = ~(UV)(PTRSIZE-1);
1495          /* Do the mask check only if the args seem like aligned. */
1496          const UV aligned =
1497            (mask < ~(UV)0) && ((PTR2UV(argv[0]) & mask) == PTR2UV(argv[0]));
1498
1499          /* See if all the arguments are contiguous in memory.  Note
1500           * that 'contiguous' is a loose term because some platforms
1501           * align the argv[] and the envp[].  If the arguments look
1502           * like non-aligned, assume that they are 'strictly' or
1503           * 'traditionally' contiguous.  If the arguments look like
1504           * aligned, we just check that they are within aligned
1505           * PTRSIZE bytes.  As long as no system has something bizarre
1506           * like the argv[] interleaved with some other data, we are
1507           * fine.  (Did I just evoke Murphy's Law?)  --jhi */
1508          if (PL_origargv && PL_origargc >= 1 && (s = PL_origargv[0])) {
1509               while (*s) s++;
1510               for (i = 1; i < PL_origargc; i++) {
1511                    if ((PL_origargv[i] == s + 1
1512 #ifdef OS2
1513                         || PL_origargv[i] == s + 2
1514 #endif 
1515                             )
1516                        ||
1517                        (aligned &&
1518                         (PL_origargv[i] >  s &&
1519                          PL_origargv[i] <=
1520                          INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1521                         )
1522                    {
1523                         s = PL_origargv[i];
1524                         while (*s) s++;
1525                    }
1526                    else
1527                         break;
1528               }
1529          }
1530
1531 #ifndef PERL_USE_SAFE_PUTENV
1532          /* Can we grab env area too to be used as the area for $0? */
1533          if (s && PL_origenviron && !PL_use_safe_putenv) {
1534               if ((PL_origenviron[0] == s + 1)
1535                   ||
1536                   (aligned &&
1537                    (PL_origenviron[0] >  s &&
1538                     PL_origenviron[0] <=
1539                     INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1540                  )
1541               {
1542 #ifndef OS2             /* ENVIRON is read by the kernel too. */
1543                    s = PL_origenviron[0];
1544                    while (*s) s++;
1545 #endif
1546                    my_setenv("NoNe  SuCh", NULL);
1547                    /* Force copy of environment. */
1548                    for (i = 1; PL_origenviron[i]; i++) {
1549                         if (PL_origenviron[i] == s + 1
1550                             ||
1551                             (aligned &&
1552                              (PL_origenviron[i] >  s &&
1553                               PL_origenviron[i] <=
1554                               INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1555                            )
1556                         {
1557                              s = PL_origenviron[i];
1558                              while (*s) s++;
1559                         }
1560                         else
1561                              break;
1562                    }
1563               }
1564          }
1565 #endif /* !defined(PERL_USE_SAFE_PUTENV) */
1566
1567          PL_origalen = s ? s - PL_origargv[0] + 1 : 0;
1568     }
1569
1570     if (PL_do_undump) {
1571
1572         /* Come here if running an undumped a.out. */
1573
1574         PL_origfilename = savepv(argv[0]);
1575         PL_do_undump = FALSE;
1576         cxstack_ix = -1;                /* start label stack again */
1577         init_ids();
1578         assert (!TAINT_get);
1579         TAINT;
1580         set_caret_X();
1581         TAINT_NOT;
1582         init_postdump_symbols(argc,argv,env);
1583         return 0;
1584     }
1585
1586     if (PL_main_root) {
1587         op_free(PL_main_root);
1588         PL_main_root = NULL;
1589     }
1590     PL_main_start = NULL;
1591     SvREFCNT_dec(PL_main_cv);
1592     PL_main_cv = NULL;
1593
1594     time(&PL_basetime);
1595     oldscope = PL_scopestack_ix;
1596     PL_dowarn = G_WARN_OFF;
1597
1598     JMPENV_PUSH(ret);
1599     switch (ret) {
1600     case 0:
1601         parse_body(env,xsinit);
1602         if (PL_unitcheckav) {
1603             call_list(oldscope, PL_unitcheckav);
1604         }
1605         if (PL_checkav) {
1606             PERL_SET_PHASE(PERL_PHASE_CHECK);
1607             call_list(oldscope, PL_checkav);
1608         }
1609         ret = 0;
1610         break;
1611     case 1:
1612         STATUS_ALL_FAILURE;
1613         /* FALLTHROUGH */
1614     case 2:
1615         /* my_exit() was called */
1616         while (PL_scopestack_ix > oldscope)
1617             LEAVE;
1618         FREETMPS;
1619         SET_CURSTASH(PL_defstash);
1620         if (PL_unitcheckav) {
1621             call_list(oldscope, PL_unitcheckav);
1622         }
1623         if (PL_checkav) {
1624             PERL_SET_PHASE(PERL_PHASE_CHECK);
1625             call_list(oldscope, PL_checkav);
1626         }
1627         ret = STATUS_EXIT;
1628         break;
1629     case 3:
1630         PerlIO_printf(Perl_error_log, "panic: top_env\n");
1631         ret = 1;
1632         break;
1633     }
1634     JMPENV_POP;
1635     return ret;
1636 }
1637
1638 /* This needs to stay in perl.c, as perl.c is compiled with different flags for
1639    miniperl, and we need to see those flags reflected in the values here.  */
1640
1641 /* What this returns is subject to change.  Use the public interface in Config.
1642  */
1643 static void
1644 S_Internals_V(pTHX_ CV *cv)
1645 {
1646     dXSARGS;
1647 #ifdef LOCAL_PATCH_COUNT
1648     const int local_patch_count = LOCAL_PATCH_COUNT;
1649 #else
1650     const int local_patch_count = 0;
1651 #endif
1652     const int entries = 3 + local_patch_count;
1653     int i;
1654     static const char non_bincompat_options[] = 
1655 #  ifdef DEBUGGING
1656                              " DEBUGGING"
1657 #  endif
1658 #  ifdef NO_MATHOMS
1659                              " NO_MATHOMS"
1660 #  endif
1661 #  ifdef NO_HASH_SEED
1662                              " NO_HASH_SEED"
1663 #  endif
1664 #  ifdef NO_TAINT_SUPPORT
1665                              " NO_TAINT_SUPPORT"
1666 #  endif
1667 #  ifdef PERL_BOOL_AS_CHAR
1668                              " PERL_BOOL_AS_CHAR"
1669 #  endif
1670 #  ifdef PERL_DISABLE_PMC
1671                              " PERL_DISABLE_PMC"
1672 #  endif
1673 #  ifdef PERL_DONT_CREATE_GVSV
1674                              " PERL_DONT_CREATE_GVSV"
1675 #  endif
1676 #  ifdef PERL_EXTERNAL_GLOB
1677                              " PERL_EXTERNAL_GLOB"
1678 #  endif
1679 #  ifdef PERL_HASH_FUNC_SIPHASH
1680                              " PERL_HASH_FUNC_SIPHASH"
1681 #  endif
1682 #  ifdef PERL_HASH_FUNC_SDBM
1683                              " PERL_HASH_FUNC_SDBM"
1684 #  endif
1685 #  ifdef PERL_HASH_FUNC_DJB2
1686                              " PERL_HASH_FUNC_DJB2"
1687 #  endif
1688 #  ifdef PERL_HASH_FUNC_SUPERFAST
1689                              " PERL_HASH_FUNC_SUPERFAST"
1690 #  endif
1691 #  ifdef PERL_HASH_FUNC_MURMUR3
1692                              " PERL_HASH_FUNC_MURMUR3"
1693 #  endif
1694 #  ifdef PERL_HASH_FUNC_ONE_AT_A_TIME
1695                              " PERL_HASH_FUNC_ONE_AT_A_TIME"
1696 #  endif
1697 #  ifdef PERL_HASH_FUNC_ONE_AT_A_TIME_HARD
1698                              " PERL_HASH_FUNC_ONE_AT_A_TIME_HARD"
1699 #  endif
1700 #  ifdef PERL_HASH_FUNC_ONE_AT_A_TIME_OLD
1701                              " PERL_HASH_FUNC_ONE_AT_A_TIME_OLD"
1702 #  endif
1703 #  ifdef PERL_IS_MINIPERL
1704                              " PERL_IS_MINIPERL"
1705 #  endif
1706 #  ifdef PERL_MALLOC_WRAP
1707                              " PERL_MALLOC_WRAP"
1708 #  endif
1709 #  ifdef PERL_MEM_LOG
1710                              " PERL_MEM_LOG"
1711 #  endif
1712 #  ifdef PERL_MEM_LOG_NOIMPL
1713                              " PERL_MEM_LOG_NOIMPL"
1714 #  endif
1715 #  ifdef PERL_NEW_COPY_ON_WRITE
1716                              " PERL_NEW_COPY_ON_WRITE"
1717 #  endif
1718 #  ifdef PERL_PERTURB_KEYS_DETERMINISTIC
1719                              " PERL_PERTURB_KEYS_DETERMINISTIC"
1720 #  endif
1721 #  ifdef PERL_PERTURB_KEYS_DISABLED
1722                              " PERL_PERTURB_KEYS_DISABLED"
1723 #  endif
1724 #  ifdef PERL_PERTURB_KEYS_RANDOM
1725                              " PERL_PERTURB_KEYS_RANDOM"
1726 #  endif
1727 #  ifdef PERL_PRESERVE_IVUV
1728                              " PERL_PRESERVE_IVUV"
1729 #  endif
1730 #  ifdef PERL_RELOCATABLE_INCPUSH
1731                              " PERL_RELOCATABLE_INCPUSH"
1732 #  endif
1733 #  ifdef PERL_USE_DEVEL
1734                              " PERL_USE_DEVEL"
1735 #  endif
1736 #  ifdef PERL_USE_SAFE_PUTENV
1737                              " PERL_USE_SAFE_PUTENV"
1738 #  endif
1739 #  ifdef UNLINK_ALL_VERSIONS
1740                              " UNLINK_ALL_VERSIONS"
1741 #  endif
1742 #  ifdef USE_ATTRIBUTES_FOR_PERLIO
1743                              " USE_ATTRIBUTES_FOR_PERLIO"
1744 #  endif
1745 #  ifdef USE_FAST_STDIO
1746                              " USE_FAST_STDIO"
1747 #  endif               
1748 #  ifdef USE_HASH_SEED_EXPLICIT
1749                              " USE_HASH_SEED_EXPLICIT"
1750 #  endif
1751 #  ifdef USE_LOCALE
1752                              " USE_LOCALE"
1753 #  endif
1754 #  ifdef USE_LOCALE_CTYPE
1755                              " USE_LOCALE_CTYPE"
1756 #  endif
1757 #  ifdef USE_PERL_ATOF
1758                              " USE_PERL_ATOF"
1759 #  endif               
1760 #  ifdef USE_SITECUSTOMIZE
1761                              " USE_SITECUSTOMIZE"
1762 #  endif               
1763         ;
1764     PERL_UNUSED_ARG(cv);
1765     PERL_UNUSED_ARG(items);
1766
1767     EXTEND(SP, entries);
1768
1769     PUSHs(sv_2mortal(newSVpv(PL_bincompat_options, 0)));
1770     PUSHs(Perl_newSVpvn_flags(aTHX_ non_bincompat_options,
1771                               sizeof(non_bincompat_options) - 1, SVs_TEMP));
1772
1773 #ifdef __DATE__
1774 #  ifdef __TIME__
1775     PUSHs(Perl_newSVpvn_flags(aTHX_
1776                               STR_WITH_LEN("Compiled at " __DATE__ " " __TIME__),
1777                               SVs_TEMP));
1778 #  else
1779     PUSHs(Perl_newSVpvn_flags(aTHX_ STR_WITH_LEN("Compiled on " __DATE__),
1780                               SVs_TEMP));
1781 #  endif
1782 #else
1783     PUSHs(&PL_sv_undef);
1784 #endif
1785
1786     for (i = 1; i <= local_patch_count; i++) {
1787         /* This will be an undef, if PL_localpatches[i] is NULL.  */
1788         PUSHs(sv_2mortal(newSVpv(PL_localpatches[i], 0)));
1789     }
1790
1791     XSRETURN(entries);
1792 }
1793
1794 #define INCPUSH_UNSHIFT                 0x01
1795 #define INCPUSH_ADD_OLD_VERS            0x02
1796 #define INCPUSH_ADD_VERSIONED_SUB_DIRS  0x04
1797 #define INCPUSH_ADD_ARCHONLY_SUB_DIRS   0x08
1798 #define INCPUSH_NOT_BASEDIR             0x10
1799 #define INCPUSH_CAN_RELOCATE            0x20
1800 #define INCPUSH_ADD_SUB_DIRS    \
1801     (INCPUSH_ADD_VERSIONED_SUB_DIRS|INCPUSH_ADD_ARCHONLY_SUB_DIRS)
1802
1803 STATIC void *
1804 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
1805 {
1806     dVAR;
1807     PerlIO *rsfp;
1808     int argc = PL_origargc;
1809     char **argv = PL_origargv;
1810     const char *scriptname = NULL;
1811     VOL bool dosearch = FALSE;
1812     char c;
1813     bool doextract = FALSE;
1814     const char *cddir = NULL;
1815 #ifdef USE_SITECUSTOMIZE
1816     bool minus_f = FALSE;
1817 #endif
1818     SV *linestr_sv = NULL;
1819     bool add_read_e_script = FALSE;
1820     U32 lex_start_flags = 0;
1821
1822     PERL_SET_PHASE(PERL_PHASE_START);
1823
1824     init_main_stash();
1825
1826     {
1827         const char *s;
1828     for (argc--,argv++; argc > 0; argc--,argv++) {
1829         if (argv[0][0] != '-' || !argv[0][1])
1830             break;
1831         s = argv[0]+1;
1832       reswitch:
1833         switch ((c = *s)) {
1834         case 'C':
1835 #ifndef PERL_STRICT_CR
1836         case '\r':
1837 #endif
1838         case ' ':
1839         case '0':
1840         case 'F':
1841         case 'a':
1842         case 'c':
1843         case 'd':
1844         case 'D':
1845         case 'h':
1846         case 'i':
1847         case 'l':
1848         case 'M':
1849         case 'm':
1850         case 'n':
1851         case 'p':
1852         case 's':
1853         case 'u':
1854         case 'U':
1855         case 'v':
1856         case 'W':
1857         case 'X':
1858         case 'w':
1859             if ((s = moreswitches(s)))
1860                 goto reswitch;
1861             break;
1862
1863         case 't':
1864 #if defined(SILENT_NO_TAINT_SUPPORT)
1865             /* silently ignore */
1866 #elif defined(NO_TAINT_SUPPORT)
1867             Perl_croak_nocontext("This perl was compiled without taint support. "
1868                        "Cowardly refusing to run with -t or -T flags");
1869 #else
1870             CHECK_MALLOC_TOO_LATE_FOR('t');
1871             if( !TAINTING_get ) {
1872                  TAINT_WARN_set(TRUE);
1873                  TAINTING_set(TRUE);
1874             }
1875 #endif
1876             s++;
1877             goto reswitch;
1878         case 'T':
1879 #if defined(SILENT_NO_TAINT_SUPPORT)
1880             /* silently ignore */
1881 #elif defined(NO_TAINT_SUPPORT)
1882             Perl_croak_nocontext("This perl was compiled without taint support. "
1883                        "Cowardly refusing to run with -t or -T flags");
1884 #else
1885             CHECK_MALLOC_TOO_LATE_FOR('T');
1886             TAINTING_set(TRUE);
1887             TAINT_WARN_set(FALSE);
1888 #endif
1889             s++;
1890             goto reswitch;
1891
1892         case 'E':
1893             PL_minus_E = TRUE;
1894             /* FALLTHROUGH */
1895         case 'e':
1896             forbid_setid('e', FALSE);
1897             if (!PL_e_script) {
1898                 PL_e_script = newSVpvs("");
1899                 add_read_e_script = TRUE;
1900             }
1901             if (*++s)
1902                 sv_catpv(PL_e_script, s);
1903             else if (argv[1]) {
1904                 sv_catpv(PL_e_script, argv[1]);
1905                 argc--,argv++;
1906             }
1907             else
1908                 Perl_croak(aTHX_ "No code specified for -%c", c);
1909             sv_catpvs(PL_e_script, "\n");
1910             break;
1911
1912         case 'f':
1913 #ifdef USE_SITECUSTOMIZE
1914             minus_f = TRUE;
1915 #endif
1916             s++;
1917             goto reswitch;
1918
1919         case 'I':       /* -I handled both here and in moreswitches() */
1920             forbid_setid('I', FALSE);
1921             if (!*++s && (s=argv[1]) != NULL) {
1922                 argc--,argv++;
1923             }
1924             if (s && *s) {
1925                 STRLEN len = strlen(s);
1926                 incpush(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS);
1927             }
1928             else
1929                 Perl_croak(aTHX_ "No directory specified for -I");
1930             break;
1931         case 'S':
1932             forbid_setid('S', FALSE);
1933             dosearch = TRUE;
1934             s++;
1935             goto reswitch;
1936         case 'V':
1937             {
1938                 SV *opts_prog;
1939
1940                 if (*++s != ':')  {
1941                     opts_prog = newSVpvs("use Config; Config::_V()");
1942                 }
1943                 else {
1944                     ++s;
1945                     opts_prog = Perl_newSVpvf(aTHX_
1946                                               "use Config; Config::config_vars(qw%c%s%c)",
1947                                               0, s, 0);
1948                     s += strlen(s);
1949                 }
1950                 Perl_av_create_and_push(aTHX_ &PL_preambleav, opts_prog);
1951                 /* don't look for script or read stdin */
1952                 scriptname = BIT_BUCKET;
1953                 goto reswitch;
1954             }
1955         case 'x':
1956             doextract = TRUE;
1957             s++;
1958             if (*s)
1959                 cddir = s;
1960             break;
1961         case 0:
1962             break;
1963         case '-':
1964             if (!*++s || isSPACE(*s)) {
1965                 argc--,argv++;
1966                 goto switch_end;
1967             }
1968             /* catch use of gnu style long options.
1969                Both of these exit immediately.  */
1970             if (strEQ(s, "version"))
1971                 minus_v();
1972             if (strEQ(s, "help"))
1973                 usage();
1974             s--;
1975             /* FALLTHROUGH */
1976         default:
1977             Perl_croak(aTHX_ "Unrecognized switch: -%s  (-h will show valid options)",s);
1978         }
1979     }
1980     }
1981
1982   switch_end:
1983
1984     {
1985         char *s;
1986
1987     if (
1988 #ifndef SECURE_INTERNAL_GETENV
1989         !TAINTING_get &&
1990 #endif
1991         (s = PerlEnv_getenv("PERL5OPT")))
1992     {
1993         while (isSPACE(*s))
1994             s++;
1995         if (*s == '-' && *(s+1) == 'T') {
1996 #if defined(SILENT_NO_TAINT_SUPPORT)
1997             /* silently ignore */
1998 #elif defined(NO_TAINT_SUPPORT)
1999             Perl_croak_nocontext("This perl was compiled without taint support. "
2000                        "Cowardly refusing to run with -t or -T flags");
2001 #else
2002             CHECK_MALLOC_TOO_LATE_FOR('T');
2003             TAINTING_set(TRUE);
2004             TAINT_WARN_set(FALSE);
2005 #endif
2006         }
2007         else {
2008             char *popt_copy = NULL;
2009             while (s && *s) {
2010                 const char *d;
2011                 while (isSPACE(*s))
2012                     s++;
2013                 if (*s == '-') {
2014                     s++;
2015                     if (isSPACE(*s))
2016                         continue;
2017                 }
2018                 d = s;
2019                 if (!*s)
2020                     break;
2021                 if (!strchr("CDIMUdmtwW", *s))
2022                     Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
2023                 while (++s && *s) {
2024                     if (isSPACE(*s)) {
2025                         if (!popt_copy) {
2026                             popt_copy = SvPVX(sv_2mortal(newSVpv(d,0)));
2027                             s = popt_copy + (s - d);
2028                             d = popt_copy;
2029                         }
2030                         *s++ = '\0';
2031                         break;
2032                     }
2033                 }
2034                 if (*d == 't') {
2035 #if defined(SILENT_NO_TAINT_SUPPORT)
2036             /* silently ignore */
2037 #elif defined(NO_TAINT_SUPPORT)
2038                     Perl_croak_nocontext("This perl was compiled without taint support. "
2039                                "Cowardly refusing to run with -t or -T flags");
2040 #else
2041                     if( !TAINTING_get) {
2042                         TAINT_WARN_set(TRUE);
2043                         TAINTING_set(TRUE);
2044                     }
2045 #endif
2046                 } else {
2047                     moreswitches(d);
2048                 }
2049             }
2050         }
2051     }
2052     }
2053
2054     /* Set $^X early so that it can be used for relocatable paths in @INC  */
2055     /* and for SITELIB_EXP in USE_SITECUSTOMIZE                            */
2056     assert (!TAINT_get);
2057     TAINT;
2058     set_caret_X();
2059     TAINT_NOT;
2060
2061 #if defined(USE_SITECUSTOMIZE)
2062     if (!minus_f) {
2063         /* The games with local $! are to avoid setting errno if there is no
2064            sitecustomize script.  "q%c...%c", 0, ..., 0 becomes "q\0...\0",
2065            ie a q() operator with a NUL byte as a the delimiter. This avoids
2066            problems with pathnames containing (say) '  */
2067 #  ifdef PERL_IS_MINIPERL
2068         AV *const inc = GvAV(PL_incgv);
2069         SV **const inc0 = inc ? av_fetch(inc, 0, FALSE) : NULL;
2070
2071         if (inc0) {
2072             /* if lib/buildcustomize.pl exists, it should not fail. If it does,
2073                it should be reported immediately as a build failure.  */
2074             (void)Perl_av_create_and_unshift_one(aTHX_ &PL_preambleav,
2075                                                  Perl_newSVpvf(aTHX_
2076                 "BEGIN { my $f = q%c%s%"SVf"/buildcustomize.pl%c; "
2077                         "do {local $!; -f $f }"
2078                         " and do $f || die $@ || qq '$f: $!' }",
2079                                 0, (TAINTING_get ? "./" : ""), SVfARG(*inc0), 0));
2080         }
2081 #  else
2082         /* SITELIB_EXP is a function call on Win32.  */
2083         const char *const raw_sitelib = SITELIB_EXP;
2084         if (raw_sitelib) {
2085             /* process .../.. if PERL_RELOCATABLE_INC is defined */
2086             SV *sitelib_sv = mayberelocate(raw_sitelib, strlen(raw_sitelib),
2087                                            INCPUSH_CAN_RELOCATE);
2088             const char *const sitelib = SvPVX(sitelib_sv);
2089             (void)Perl_av_create_and_unshift_one(aTHX_ &PL_preambleav,
2090                                                  Perl_newSVpvf(aTHX_
2091                                                                "BEGIN { do {local $!; -f q%c%s/sitecustomize.pl%c} && do q%c%s/sitecustomize.pl%c }",
2092                                                                0, SVfARG(sitelib), 0,
2093                                                                0, SVfARG(sitelib), 0));
2094             assert (SvREFCNT(sitelib_sv) == 1);
2095             SvREFCNT_dec(sitelib_sv);
2096         }
2097 #  endif
2098     }
2099 #endif
2100
2101     if (!scriptname)
2102         scriptname = argv[0];
2103     if (PL_e_script) {
2104         argc++,argv--;
2105         scriptname = BIT_BUCKET;        /* don't look for script or read stdin */
2106     }
2107     else if (scriptname == NULL) {
2108 #ifdef MSDOS
2109         if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
2110             moreswitches("h");
2111 #endif
2112         scriptname = "-";
2113     }
2114
2115     assert (!TAINT_get);
2116     init_perllib();
2117
2118     {
2119         bool suidscript = FALSE;
2120
2121         rsfp = open_script(scriptname, dosearch, &suidscript);
2122         if (!rsfp) {
2123             rsfp = PerlIO_stdin();
2124             lex_start_flags = LEX_DONT_CLOSE_RSFP;
2125         }
2126
2127         validate_suid(rsfp);
2128
2129 #ifndef PERL_MICRO
2130 #  if defined(SIGCHLD) || defined(SIGCLD)
2131         {
2132 #  ifndef SIGCHLD
2133 #    define SIGCHLD SIGCLD
2134 #  endif
2135             Sighandler_t sigstate = rsignal_state(SIGCHLD);
2136             if (sigstate == (Sighandler_t) SIG_IGN) {
2137                 Perl_ck_warner(aTHX_ packWARN(WARN_SIGNAL),
2138                                "Can't ignore signal CHLD, forcing to default");
2139                 (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
2140             }
2141         }
2142 #  endif
2143 #endif
2144
2145         if (doextract) {
2146
2147             /* This will croak if suidscript is true, as -x cannot be used with
2148                setuid scripts.  */
2149             forbid_setid('x', suidscript);
2150             /* Hence you can't get here if suidscript is true */
2151
2152             linestr_sv = newSV_type(SVt_PV);
2153             lex_start_flags |= LEX_START_COPIED;
2154             find_beginning(linestr_sv, rsfp);
2155             if (cddir && PerlDir_chdir( (char *)cddir ) < 0)
2156                 Perl_croak(aTHX_ "Can't chdir to %s",cddir);
2157         }
2158     }
2159
2160     PL_main_cv = PL_compcv = MUTABLE_CV(newSV_type(SVt_PVCV));
2161     CvUNIQUE_on(PL_compcv);
2162
2163     CvPADLIST_set(PL_compcv, pad_new(0));
2164
2165     PL_isarev = newHV();
2166
2167     boot_core_PerlIO();
2168     boot_core_UNIVERSAL();
2169     boot_core_mro();
2170     newXS("Internals::V", S_Internals_V, __FILE__);
2171
2172     if (xsinit)
2173         (*xsinit)(aTHX);        /* in case linked C routines want magical variables */
2174 #ifndef PERL_MICRO
2175 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(SYMBIAN)
2176     init_os_extras();
2177 #endif
2178 #endif
2179
2180 #ifdef USE_SOCKS
2181 #   ifdef HAS_SOCKS5_INIT
2182     socks5_init(argv[0]);
2183 #   else
2184     SOCKSinit(argv[0]);
2185 #   endif
2186 #endif
2187
2188     init_predump_symbols();
2189     /* init_postdump_symbols not currently designed to be called */
2190     /* more than once (ENV isn't cleared first, for example)     */
2191     /* But running with -u leaves %ENV & @ARGV undefined!    XXX */
2192     if (!PL_do_undump)
2193         init_postdump_symbols(argc,argv,env);
2194
2195     /* PL_unicode is turned on by -C, or by $ENV{PERL_UNICODE},
2196      * or explicitly in some platforms.
2197      * locale.c:Perl_init_i18nl10n() if the environment
2198      * look like the user wants to use UTF-8. */
2199 #if defined(__SYMBIAN32__)
2200     PL_unicode = PERL_UNICODE_STD_FLAG; /* See PERL_SYMBIAN_CONSOLE_UTF8. */
2201 #endif
2202 #  ifndef PERL_IS_MINIPERL
2203     if (PL_unicode) {
2204          /* Requires init_predump_symbols(). */
2205          if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
2206               IO* io;
2207               PerlIO* fp;
2208               SV* sv;
2209
2210               /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
2211                * and the default open disciplines. */
2212               if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
2213                   PL_stdingv  && (io = GvIO(PL_stdingv)) &&
2214                   (fp = IoIFP(io)))
2215                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2216               if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
2217                   PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
2218                   (fp = IoOFP(io)))
2219                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2220               if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
2221                   PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
2222                   (fp = IoOFP(io)))
2223                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2224               if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
2225                   (sv = GvSV(gv_fetchpvs("\017PEN", GV_ADD|GV_NOTQUAL,
2226                                          SVt_PV)))) {
2227                    U32 in  = PL_unicode & PERL_UNICODE_IN_FLAG;
2228                    U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
2229                    if (in) {
2230                         if (out)
2231                              sv_setpvs(sv, ":utf8\0:utf8");
2232                         else
2233                              sv_setpvs(sv, ":utf8\0");
2234                    }
2235                    else if (out)
2236                         sv_setpvs(sv, "\0:utf8");
2237                    SvSETMAGIC(sv);
2238               }
2239          }
2240     }
2241 #endif
2242
2243     {
2244         const char *s;
2245     if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
2246          if (strEQ(s, "unsafe"))
2247               PL_signals |=  PERL_SIGNALS_UNSAFE_FLAG;
2248          else if (strEQ(s, "safe"))
2249               PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
2250          else
2251               Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
2252     }
2253     }
2254
2255
2256     lex_start(linestr_sv, rsfp, lex_start_flags);
2257     SvREFCNT_dec(linestr_sv);
2258
2259     PL_subname = newSVpvs("main");
2260
2261     if (add_read_e_script)
2262         filter_add(read_e_script, NULL);
2263
2264     /* now parse the script */
2265
2266     SETERRNO(0,SS_NORMAL);
2267     if (yyparse(GRAMPROG) || PL_parser->error_count) {
2268         if (PL_minus_c)
2269             Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
2270         else {
2271             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
2272                        PL_origfilename);
2273         }
2274     }
2275     CopLINE_set(PL_curcop, 0);
2276     SET_CURSTASH(PL_defstash);
2277     if (PL_e_script) {
2278         SvREFCNT_dec(PL_e_script);
2279         PL_e_script = NULL;
2280     }
2281
2282     if (PL_do_undump)
2283         my_unexec();
2284
2285     if (isWARN_ONCE) {
2286         SAVECOPFILE(PL_curcop);
2287         SAVECOPLINE(PL_curcop);
2288         gv_check(PL_defstash);
2289     }
2290
2291     LEAVE;
2292     FREETMPS;
2293
2294 #ifdef MYMALLOC
2295     {
2296         const char *s;
2297         if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && grok_atou(s, NULL) >= 2)
2298             dump_mstats("after compilation:");
2299     }
2300 #endif
2301
2302     ENTER;
2303     PL_restartjmpenv = NULL;
2304     PL_restartop = 0;
2305     return NULL;
2306 }
2307
2308 /*
2309 =for apidoc perl_run
2310
2311 Tells a Perl interpreter to run.  See L<perlembed>.
2312
2313 =cut
2314 */
2315
2316 int
2317 perl_run(pTHXx)
2318 {
2319     I32 oldscope;
2320     int ret = 0;
2321     dJMPENV;
2322
2323     PERL_ARGS_ASSERT_PERL_RUN;
2324 #ifndef MULTIPLICITY
2325     PERL_UNUSED_ARG(my_perl);
2326 #endif
2327
2328     oldscope = PL_scopestack_ix;
2329 #ifdef VMS
2330     VMSISH_HUSHED = 0;
2331 #endif
2332
2333     JMPENV_PUSH(ret);
2334     switch (ret) {
2335     case 1:
2336         cxstack_ix = -1;                /* start context stack again */
2337         goto redo_body;
2338     case 0:                             /* normal completion */
2339  redo_body:
2340         run_body(oldscope);
2341         /* FALLTHROUGH */
2342     case 2:                             /* my_exit() */
2343         while (PL_scopestack_ix > oldscope)
2344             LEAVE;
2345         FREETMPS;
2346         SET_CURSTASH(PL_defstash);
2347         if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
2348             PL_endav && !PL_minus_c) {
2349             PERL_SET_PHASE(PERL_PHASE_END);
2350             call_list(oldscope, PL_endav);
2351         }
2352 #ifdef MYMALLOC
2353         if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
2354             dump_mstats("after execution:  ");
2355 #endif
2356         ret = STATUS_EXIT;
2357         break;
2358     case 3:
2359         if (PL_restartop) {
2360             POPSTACK_TO(PL_mainstack);
2361             goto redo_body;
2362         }
2363         PerlIO_printf(Perl_error_log, "panic: restartop in perl_run\n");
2364         FREETMPS;
2365         ret = 1;
2366         break;
2367     }
2368
2369     JMPENV_POP;
2370     return ret;
2371 }
2372
2373 STATIC void
2374 S_run_body(pTHX_ I32 oldscope)
2375 {
2376     DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support (0x%x).\n",
2377                     PL_sawampersand ? "Enabling" : "Omitting",
2378                     (unsigned int)(PL_sawampersand)));
2379
2380     if (!PL_restartop) {
2381 #ifdef DEBUGGING
2382         if (DEBUG_x_TEST || DEBUG_B_TEST)
2383             dump_all_perl(!DEBUG_B_TEST);
2384         if (!DEBUG_q_TEST)
2385           PERL_DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
2386 #endif
2387
2388         if (PL_minus_c) {
2389             PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
2390             my_exit(0);
2391         }
2392         if (PERLDB_SINGLE && PL_DBsingle)
2393             PL_DBsingle_iv = 1;
2394         if (PL_initav) {
2395             PERL_SET_PHASE(PERL_PHASE_INIT);
2396             call_list(oldscope, PL_initav);
2397         }
2398 #ifdef PERL_DEBUG_READONLY_OPS
2399         if (PL_main_root && PL_main_root->op_slabbed)
2400             Slab_to_ro(OpSLAB(PL_main_root));
2401 #endif
2402     }
2403
2404     /* do it */
2405
2406     PERL_SET_PHASE(PERL_PHASE_RUN);
2407
2408     if (PL_restartop) {
2409         PL_restartjmpenv = NULL;
2410         PL_op = PL_restartop;
2411         PL_restartop = 0;
2412         CALLRUNOPS(aTHX);
2413     }
2414     else if (PL_main_start) {
2415         CvDEPTH(PL_main_cv) = 1;
2416         PL_op = PL_main_start;
2417         CALLRUNOPS(aTHX);
2418     }
2419     my_exit(0);
2420     assert(0); /* NOTREACHED */
2421 }
2422
2423 /*
2424 =head1 SV Manipulation Functions
2425
2426 =for apidoc p||get_sv
2427
2428 Returns the SV of the specified Perl scalar.  C<flags> are passed to
2429 C<gv_fetchpv>.  If C<GV_ADD> is set and the
2430 Perl variable does not exist then it will be created.  If C<flags> is zero
2431 and the variable does not exist then NULL is returned.
2432
2433 =cut
2434 */
2435
2436 SV*
2437 Perl_get_sv(pTHX_ const char *name, I32 flags)
2438 {
2439     GV *gv;
2440
2441     PERL_ARGS_ASSERT_GET_SV;
2442
2443     gv = gv_fetchpv(name, flags, SVt_PV);
2444     if (gv)
2445         return GvSV(gv);
2446     return NULL;
2447 }
2448
2449 /*
2450 =head1 Array Manipulation Functions
2451
2452 =for apidoc p||get_av
2453
2454 Returns the AV of the specified Perl global or package array with the given
2455 name (so it won't work on lexical variables).  C<flags> are passed 
2456 to C<gv_fetchpv>.  If C<GV_ADD> is set and the
2457 Perl variable does not exist then it will be created.  If C<flags> is zero
2458 and the variable does not exist then NULL is returned.
2459
2460 Perl equivalent: C<@{"$name"}>.
2461
2462 =cut
2463 */
2464
2465 AV*
2466 Perl_get_av(pTHX_ const char *name, I32 flags)
2467 {
2468     GV* const gv = gv_fetchpv(name, flags, SVt_PVAV);
2469
2470     PERL_ARGS_ASSERT_GET_AV;
2471
2472     if (flags)
2473         return GvAVn(gv);
2474     if (gv)
2475         return GvAV(gv);
2476     return NULL;
2477 }
2478
2479 /*
2480 =head1 Hash Manipulation Functions
2481
2482 =for apidoc p||get_hv
2483
2484 Returns the HV of the specified Perl hash.  C<flags> are passed to
2485 C<gv_fetchpv>.  If C<GV_ADD> is set and the
2486 Perl variable does not exist then it will be created.  If C<flags> is zero
2487 and the variable does not exist then NULL is returned.
2488
2489 =cut
2490 */
2491
2492 HV*
2493 Perl_get_hv(pTHX_ const char *name, I32 flags)
2494 {
2495     GV* const gv = gv_fetchpv(name, flags, SVt_PVHV);
2496
2497     PERL_ARGS_ASSERT_GET_HV;
2498
2499     if (flags)
2500         return GvHVn(gv);
2501     if (gv)
2502         return GvHV(gv);
2503     return NULL;
2504 }
2505
2506 /*
2507 =head1 CV Manipulation Functions
2508
2509 =for apidoc p||get_cvn_flags
2510
2511 Returns the CV of the specified Perl subroutine.  C<flags> are passed to
2512 C<gv_fetchpvn_flags>.  If C<GV_ADD> is set and the Perl subroutine does not
2513 exist then it will be declared (which has the same effect as saying
2514 C<sub name;>).  If C<GV_ADD> is not set and the subroutine does not exist
2515 then NULL is returned.
2516
2517 =for apidoc p||get_cv
2518
2519 Uses C<strlen> to get the length of C<name>, then calls C<get_cvn_flags>.
2520
2521 =cut
2522 */
2523
2524 CV*
2525 Perl_get_cvn_flags(pTHX_ const char *name, STRLEN len, I32 flags)
2526 {
2527     GV* const gv = gv_fetchpvn_flags(name, len, flags, SVt_PVCV);
2528
2529     PERL_ARGS_ASSERT_GET_CVN_FLAGS;
2530
2531     /* XXX this is probably not what they think they're getting.
2532      * It has the same effect as "sub name;", i.e. just a forward
2533      * declaration! */
2534     if ((flags & ~GV_NOADD_MASK) && !GvCVu(gv)) {
2535         return newSTUB(gv,0);
2536     }
2537     if (gv)
2538         return GvCVu(gv);
2539     return NULL;
2540 }
2541
2542 /* Nothing in core calls this now, but we can't replace it with a macro and
2543    move it to mathoms.c as a macro would evaluate name twice.  */
2544 CV*
2545 Perl_get_cv(pTHX_ const char *name, I32 flags)
2546 {
2547     PERL_ARGS_ASSERT_GET_CV;
2548
2549     return get_cvn_flags(name, strlen(name), flags);
2550 }
2551
2552 /* Be sure to refetch the stack pointer after calling these routines. */
2553
2554 /*
2555
2556 =head1 Callback Functions
2557
2558 =for apidoc p||call_argv
2559
2560 Performs a callback to the specified named and package-scoped Perl subroutine 
2561 with C<argv> (a NULL-terminated array of strings) as arguments.  See
2562 L<perlcall>.
2563
2564 Approximate Perl equivalent: C<&{"$sub_name"}(@$argv)>.
2565
2566 =cut
2567 */
2568
2569 I32
2570 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, char **argv)
2571
2572                         /* See G_* flags in cop.h */
2573                         /* null terminated arg list */
2574 {
2575     dSP;
2576
2577     PERL_ARGS_ASSERT_CALL_ARGV;
2578
2579     PUSHMARK(SP);
2580     if (argv) {
2581         while (*argv) {
2582             mXPUSHs(newSVpv(*argv,0));
2583             argv++;
2584         }
2585         PUTBACK;
2586     }
2587     return call_pv(sub_name, flags);
2588 }
2589
2590 /*
2591 =for apidoc p||call_pv
2592
2593 Performs a callback to the specified Perl sub.  See L<perlcall>.
2594
2595 =cut
2596 */
2597
2598 I32
2599 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
2600                         /* name of the subroutine */
2601                         /* See G_* flags in cop.h */
2602 {
2603     PERL_ARGS_ASSERT_CALL_PV;
2604
2605     return call_sv(MUTABLE_SV(get_cv(sub_name, GV_ADD)), flags);
2606 }
2607
2608 /*
2609 =for apidoc p||call_method
2610
2611 Performs a callback to the specified Perl method.  The blessed object must
2612 be on the stack.  See L<perlcall>.
2613
2614 =cut
2615 */
2616
2617 I32
2618 Perl_call_method(pTHX_ const char *methname, I32 flags)
2619                         /* name of the subroutine */
2620                         /* See G_* flags in cop.h */
2621 {
2622     STRLEN len;
2623     SV* sv;
2624     PERL_ARGS_ASSERT_CALL_METHOD;
2625
2626     len = strlen(methname);
2627     sv = flags & G_METHOD_NAMED
2628         ? sv_2mortal(newSVpvn_share(methname, len,0))
2629         : newSVpvn_flags(methname, len, SVs_TEMP);
2630
2631     return call_sv(sv, flags | G_METHOD);
2632 }
2633
2634 /* May be called with any of a CV, a GV, or an SV containing the name. */
2635 /*
2636 =for apidoc p||call_sv
2637
2638 Performs a callback to the Perl sub whose name is in the SV.  See
2639 L<perlcall>.
2640
2641 =cut
2642 */
2643
2644 I32
2645 Perl_call_sv(pTHX_ SV *sv, VOL I32 flags)
2646                         /* See G_* flags in cop.h */
2647 {
2648     dVAR; dSP;
2649     LOGOP myop;         /* fake syntax tree node */
2650     METHOP method_op;
2651     I32 oldmark;
2652     VOL I32 retval = 0;
2653     I32 oldscope;
2654     bool oldcatch = CATCH_GET;
2655     int ret;
2656     OP* const oldop = PL_op;
2657     dJMPENV;
2658
2659     PERL_ARGS_ASSERT_CALL_SV;
2660
2661     if (flags & G_DISCARD) {
2662         ENTER;
2663         SAVETMPS;
2664     }
2665     if (!(flags & G_WANT)) {
2666         /* Backwards compatibility - as G_SCALAR was 0, it could be omitted.
2667          */
2668         flags |= G_SCALAR;
2669     }
2670
2671     Zero(&myop, 1, LOGOP);
2672     if (!(flags & G_NOARGS))
2673         myop.op_flags |= OPf_STACKED;
2674     myop.op_flags |= OP_GIMME_REVERSE(flags);
2675     SAVEOP();
2676     PL_op = (OP*)&myop;
2677
2678     EXTEND(PL_stack_sp, 1);
2679     if (!(flags & G_METHOD_NAMED))
2680         *++PL_stack_sp = sv;
2681     oldmark = TOPMARK;
2682     oldscope = PL_scopestack_ix;
2683
2684     if (PERLDB_SUB && PL_curstash != PL_debstash
2685            /* Handle first BEGIN of -d. */
2686           && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
2687            /* Try harder, since this may have been a sighandler, thus
2688             * curstash may be meaningless. */
2689           && (SvTYPE(sv) != SVt_PVCV || CvSTASH((const CV *)sv) != PL_debstash)
2690           && !(flags & G_NODEBUG))
2691         myop.op_private |= OPpENTERSUB_DB;
2692
2693     if (flags & (G_METHOD|G_METHOD_NAMED)) {
2694         Zero(&method_op, 1, METHOP);
2695         method_op.op_next = (OP*)&myop;
2696         PL_op = (OP*)&method_op;
2697         if ( flags & G_METHOD_NAMED ) {
2698             method_op.op_ppaddr = PL_ppaddr[OP_METHOD_NAMED];
2699             method_op.op_type = OP_METHOD_NAMED;
2700             method_op.op_u.op_meth_sv = sv;
2701         } else {
2702             method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
2703             method_op.op_type = OP_METHOD;
2704         }
2705         myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
2706         myop.op_type = OP_ENTERSUB;
2707     }
2708
2709     if (!(flags & G_EVAL)) {
2710         CATCH_SET(TRUE);
2711         CALL_BODY_SUB((OP*)&myop);
2712         retval = PL_stack_sp - (PL_stack_base + oldmark);
2713         CATCH_SET(oldcatch);
2714     }
2715     else {
2716         myop.op_other = (OP*)&myop;
2717         PL_markstack_ptr--;
2718         create_eval_scope(flags|G_FAKINGEVAL);
2719         PL_markstack_ptr++;
2720
2721         JMPENV_PUSH(ret);
2722
2723         switch (ret) {
2724         case 0:
2725  redo_body:
2726             CALL_BODY_SUB((OP*)&myop);
2727             retval = PL_stack_sp - (PL_stack_base + oldmark);
2728             if (!(flags & G_KEEPERR)) {
2729                 CLEAR_ERRSV();
2730             }
2731             break;
2732         case 1:
2733             STATUS_ALL_FAILURE;
2734             /* FALLTHROUGH */
2735         case 2:
2736             /* my_exit() was called */
2737             SET_CURSTASH(PL_defstash);
2738             FREETMPS;
2739             JMPENV_POP;
2740             my_exit_jump();
2741             assert(0); /* NOTREACHED */
2742         case 3:
2743             if (PL_restartop) {
2744                 PL_restartjmpenv = NULL;
2745                 PL_op = PL_restartop;
2746                 PL_restartop = 0;
2747                 goto redo_body;
2748             }
2749             PL_stack_sp = PL_stack_base + oldmark;
2750             if ((flags & G_WANT) == G_ARRAY)
2751                 retval = 0;
2752             else {
2753                 retval = 1;
2754                 *++PL_stack_sp = &PL_sv_undef;
2755             }
2756             break;
2757         }
2758
2759         if (PL_scopestack_ix > oldscope)
2760             delete_eval_scope();
2761         JMPENV_POP;
2762     }
2763
2764     if (flags & G_DISCARD) {
2765         PL_stack_sp = PL_stack_base + oldmark;
2766         retval = 0;
2767         FREETMPS;
2768         LEAVE;
2769     }
2770     PL_op = oldop;
2771     return retval;
2772 }
2773
2774 /* Eval a string. The G_EVAL flag is always assumed. */
2775
2776 /*
2777 =for apidoc p||eval_sv
2778
2779 Tells Perl to C<eval> the string in the SV.  It supports the same flags
2780 as C<call_sv>, with the obvious exception of G_EVAL.  See L<perlcall>.
2781
2782 =cut
2783 */
2784
2785 I32
2786 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
2787
2788                         /* See G_* flags in cop.h */
2789 {
2790     dVAR;
2791     dSP;
2792     UNOP myop;          /* fake syntax tree node */
2793     VOL I32 oldmark = SP - PL_stack_base;
2794     VOL I32 retval = 0;
2795     int ret;
2796     OP* const oldop = PL_op;
2797     dJMPENV;
2798
2799     PERL_ARGS_ASSERT_EVAL_SV;
2800
2801     if (flags & G_DISCARD) {
2802         ENTER;
2803         SAVETMPS;
2804     }
2805
2806     SAVEOP();
2807     PL_op = (OP*)&myop;
2808     Zero(&myop, 1, UNOP);
2809     EXTEND(PL_stack_sp, 1);
2810     *++PL_stack_sp = sv;
2811
2812     if (!(flags & G_NOARGS))
2813         myop.op_flags = OPf_STACKED;
2814     myop.op_type = OP_ENTEREVAL;
2815     myop.op_flags |= OP_GIMME_REVERSE(flags);
2816     if (flags & G_KEEPERR)
2817         myop.op_flags |= OPf_SPECIAL;
2818
2819     if (flags & G_RE_REPARSING)
2820         myop.op_private = (OPpEVAL_COPHH | OPpEVAL_RE_REPARSING);
2821
2822     /* fail now; otherwise we could fail after the JMPENV_PUSH but
2823      * before a PUSHEVAL, which corrupts the stack after a croak */
2824     TAINT_PROPER("eval_sv()");
2825
2826     JMPENV_PUSH(ret);
2827     switch (ret) {
2828     case 0:
2829  redo_body:
2830         if (PL_op == (OP*)(&myop)) {
2831             PL_op = PL_ppaddr[OP_ENTEREVAL](aTHX);
2832             if (!PL_op)
2833                 goto fail; /* failed in compilation */
2834         }
2835         CALLRUNOPS(aTHX);
2836         retval = PL_stack_sp - (PL_stack_base + oldmark);
2837         if (!(flags & G_KEEPERR)) {
2838             CLEAR_ERRSV();
2839         }
2840         break;
2841     case 1:
2842         STATUS_ALL_FAILURE;
2843         /* FALLTHROUGH */
2844     case 2:
2845         /* my_exit() was called */
2846         SET_CURSTASH(PL_defstash);
2847         FREETMPS;
2848         JMPENV_POP;
2849         my_exit_jump();
2850         assert(0); /* NOTREACHED */
2851     case 3:
2852         if (PL_restartop) {
2853             PL_restartjmpenv = NULL;
2854             PL_op = PL_restartop;
2855             PL_restartop = 0;
2856             goto redo_body;
2857         }
2858       fail:
2859         PL_stack_sp = PL_stack_base + oldmark;
2860         if ((flags & G_WANT) == G_ARRAY)
2861             retval = 0;
2862         else {
2863             retval = 1;
2864             *++PL_stack_sp = &PL_sv_undef;
2865         }
2866         break;
2867     }
2868
2869     JMPENV_POP;
2870     if (flags & G_DISCARD) {
2871         PL_stack_sp = PL_stack_base + oldmark;
2872         retval = 0;
2873         FREETMPS;
2874         LEAVE;
2875     }
2876     PL_op = oldop;
2877     return retval;
2878 }
2879
2880 /*
2881 =for apidoc p||eval_pv
2882
2883 Tells Perl to C<eval> the given string in scalar context and return an SV* result.
2884
2885 =cut
2886 */
2887
2888 SV*
2889 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
2890 {
2891     SV* sv = newSVpv(p, 0);
2892
2893     PERL_ARGS_ASSERT_EVAL_PV;
2894
2895     eval_sv(sv, G_SCALAR);
2896     SvREFCNT_dec(sv);
2897
2898     {
2899         dSP;
2900         sv = POPs;
2901         PUTBACK;
2902     }
2903
2904     /* just check empty string or undef? */
2905     if (croak_on_error) {
2906         SV * const errsv = ERRSV;
2907         if(SvTRUE_NN(errsv))
2908             /* replace with croak_sv? */
2909             Perl_croak_nocontext("%s", SvPV_nolen_const(errsv));
2910     }
2911
2912     return sv;
2913 }
2914
2915 /* Require a module. */
2916
2917 /*
2918 =head1 Embedding Functions
2919
2920 =for apidoc p||require_pv
2921
2922 Tells Perl to C<require> the file named by the string argument.  It is
2923 analogous to the Perl code C<eval "require '$file'">.  It's even
2924 implemented that way; consider using load_module instead.
2925
2926 =cut */
2927
2928 void
2929 Perl_require_pv(pTHX_ const char *pv)
2930 {
2931     dSP;
2932     SV* sv;
2933
2934     PERL_ARGS_ASSERT_REQUIRE_PV;
2935
2936     PUSHSTACKi(PERLSI_REQUIRE);
2937     sv = Perl_newSVpvf(aTHX_ "require q%c%s%c", 0, pv, 0);
2938     eval_sv(sv_2mortal(sv), G_DISCARD);
2939     POPSTACK;
2940 }
2941
2942 STATIC void
2943 S_usage(pTHX)           /* XXX move this out into a module ? */
2944 {
2945     /* This message really ought to be max 23 lines.
2946      * Removed -h because the user already knows that option. Others? */
2947
2948     /* Grouped as 6 lines per C string literal, to keep under the ANSI C 89
2949        minimum of 509 character string literals.  */
2950     static const char * const usage_msg[] = {
2951 "  -0[octal]         specify record separator (\\0, if no argument)\n"
2952 "  -a                autosplit mode with -n or -p (splits $_ into @F)\n"
2953 "  -C[number/list]   enables the listed Unicode features\n"
2954 "  -c                check syntax only (runs BEGIN and CHECK blocks)\n"
2955 "  -d[:debugger]     run program under debugger\n"
2956 "  -D[number/list]   set debugging flags (argument is a bit mask or alphabets)\n",
2957 "  -e program        one line of program (several -e's allowed, omit programfile)\n"
2958 "  -E program        like -e, but enables all optional features\n"
2959 "  -f                don't do $sitelib/sitecustomize.pl at startup\n"
2960 "  -F/pattern/       split() pattern for -a switch (//'s are optional)\n"
2961 "  -i[extension]     edit <> files in place (makes backup if extension supplied)\n"
2962 "  -Idirectory       specify @INC/#include directory (several -I's allowed)\n",
2963 "  -l[octal]         enable line ending processing, specifies line terminator\n"
2964 "  -[mM][-]module    execute \"use/no module...\" before executing program\n"
2965 "  -n                assume \"while (<>) { ... }\" loop around program\n"
2966 "  -p                assume loop like -n but print line also, like sed\n"
2967 "  -s                enable rudimentary parsing for switches after programfile\n"
2968 "  -S                look for programfile using PATH environment variable\n",
2969 "  -t                enable tainting warnings\n"
2970 "  -T                enable tainting checks\n"
2971 "  -u                dump core after parsing program\n"
2972 "  -U                allow unsafe operations\n"
2973 "  -v                print version, patchlevel and license\n"
2974 "  -V[:variable]     print configuration summary (or a single Config.pm variable)\n",
2975 "  -w                enable many useful warnings\n"
2976 "  -W                enable all warnings\n"
2977 "  -x[directory]     ignore text before #!perl line (optionally cd to directory)\n"
2978 "  -X                disable all warnings\n"
2979 "  \n"
2980 "Run 'perldoc perl' for more help with Perl.\n\n",
2981 NULL
2982 };
2983     const char * const *p = usage_msg;
2984     PerlIO *out = PerlIO_stdout();
2985
2986     PerlIO_printf(out,
2987                   "\nUsage: %s [switches] [--] [programfile] [arguments]\n",
2988                   PL_origargv[0]);
2989     while (*p)
2990         PerlIO_puts(out, *p++);
2991     my_exit(0);
2992 }
2993
2994 /* convert a string of -D options (or digits) into an int.
2995  * sets *s to point to the char after the options */
2996
2997 #ifdef DEBUGGING
2998 int
2999 Perl_get_debug_opts(pTHX_ const char **s, bool givehelp)
3000 {
3001     static const char * const usage_msgd[] = {
3002       " Debugging flag values: (see also -d)\n"
3003       "  p  Tokenizing and parsing (with v, displays parse stack)\n"
3004       "  s  Stack snapshots (with v, displays all stacks)\n"
3005       "  l  Context (loop) stack processing\n"
3006       "  t  Trace execution\n"
3007       "  o  Method and overloading resolution\n",
3008       "  c  String/numeric conversions\n"
3009       "  P  Print profiling info, source file input state\n"
3010       "  m  Memory and SV allocation\n"
3011       "  f  Format processing\n"
3012       "  r  Regular expression parsing and execution\n"
3013       "  x  Syntax tree dump\n",
3014       "  u  Tainting checks\n"
3015       "  H  Hash dump -- usurps values()\n"
3016       "  X  Scratchpad allocation\n"
3017       "  D  Cleaning up\n"
3018       "  S  Op slab allocation\n"
3019       "  T  Tokenising\n"
3020       "  R  Include reference counts of dumped variables (eg when using -Ds)\n",
3021       "  J  Do not s,t,P-debug (Jump over) opcodes within package DB\n"
3022       "  v  Verbose: use in conjunction with other flags\n"
3023       "  C  Copy On Write\n"
3024       "  A  Consistency checks on internal structures\n"
3025       "  q  quiet - currently only suppresses the 'EXECUTING' message\n"
3026       "  M  trace smart match resolution\n"
3027       "  B  dump suBroutine definitions, including special Blocks like BEGIN\n",
3028       "  L  trace some locale setting information--for Perl core development\n",
3029       NULL
3030     };
3031     int i = 0;
3032
3033     PERL_ARGS_ASSERT_GET_DEBUG_OPTS;
3034
3035     if (isALPHA(**s)) {
3036         /* if adding extra options, remember to update DEBUG_MASK */
3037         static const char debopts[] = "psltocPmfrxuUHXDSTRJvCAqMBL";
3038
3039         for (; isWORDCHAR(**s); (*s)++) {
3040             const char * const d = strchr(debopts,**s);
3041             if (d)
3042                 i |= 1 << (d - debopts);
3043             else if (ckWARN_d(WARN_DEBUGGING))
3044                 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3045                     "invalid option -D%c, use -D'' to see choices\n", **s);
3046         }
3047     }
3048     else if (isDIGIT(**s)) {
3049         const char* e;
3050         i = grok_atou(*s, &e);
3051         if (e)
3052             *s = e;
3053         for (; isWORDCHAR(**s); (*s)++) ;
3054     }
3055     else if (givehelp) {
3056       const char *const *p = usage_msgd;
3057       while (*p) PerlIO_puts(PerlIO_stdout(), *p++);
3058     }
3059 #  ifdef EBCDIC
3060     if ((i & DEBUG_p_FLAG) && ckWARN_d(WARN_DEBUGGING))
3061         Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3062                 "-Dp not implemented on this platform\n");
3063 #  endif
3064     return i;
3065 }
3066 #endif
3067
3068 /* This routine handles any switches that can be given during run */
3069
3070 const char *
3071 Perl_moreswitches(pTHX_ const char *s)
3072 {
3073     dVAR;
3074     UV rschar;
3075     const char option = *s; /* used to remember option in -m/-M code */
3076
3077     PERL_ARGS_ASSERT_MORESWITCHES;
3078
3079     switch (*s) {
3080     case '0':
3081     {
3082          I32 flags = 0;
3083          STRLEN numlen;
3084
3085          SvREFCNT_dec(PL_rs);
3086          if (s[1] == 'x' && s[2]) {
3087               const char *e = s+=2;
3088               U8 *tmps;
3089
3090               while (*e)
3091                 e++;
3092               numlen = e - s;
3093               flags = PERL_SCAN_SILENT_ILLDIGIT;
3094               rschar = (U32)grok_hex(s, &numlen, &flags, NULL);
3095               if (s + numlen < e) {
3096                    rschar = 0; /* Grandfather -0xFOO as -0 -xFOO. */
3097                    numlen = 0;
3098                    s--;
3099               }
3100               PL_rs = newSVpvs("");
3101               SvGROW(PL_rs, (STRLEN)(UNISKIP(rschar) + 1));
3102               tmps = (U8*)SvPVX(PL_rs);
3103               uvchr_to_utf8(tmps, rschar);
3104               SvCUR_set(PL_rs, UNISKIP(rschar));
3105               SvUTF8_on(PL_rs);
3106          }
3107          else {
3108               numlen = 4;
3109               rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
3110               if (rschar & ~((U8)~0))
3111                    PL_rs = &PL_sv_undef;
3112               else if (!rschar && numlen >= 2)
3113                    PL_rs = newSVpvs("");
3114               else {
3115                    char ch = (char)rschar;
3116                    PL_rs = newSVpvn(&ch, 1);
3117               }
3118          }
3119          sv_setsv(get_sv("/", GV_ADD), PL_rs);
3120          return s + numlen;
3121     }
3122     case 'C':
3123         s++;
3124         PL_unicode = parse_unicode_opts( (const char **)&s );
3125         if (PL_unicode & PERL_UNICODE_UTF8CACHEASSERT_FLAG)
3126             PL_utf8cache = -1;
3127         return s;
3128     case 'F':
3129         PL_minus_a = TRUE;
3130         PL_minus_F = TRUE;
3131         PL_minus_n = TRUE;
3132         PL_splitstr = ++s;
3133         while (*s && !isSPACE(*s)) ++s;
3134         PL_splitstr = savepvn(PL_splitstr, s - PL_splitstr);
3135         return s;
3136     case 'a':
3137         PL_minus_a = TRUE;
3138         PL_minus_n = TRUE;
3139         s++;
3140         return s;
3141     case 'c':
3142         PL_minus_c = TRUE;
3143         s++;
3144         return s;
3145     case 'd':
3146         forbid_setid('d', FALSE);
3147         s++;
3148
3149         /* -dt indicates to the debugger that threads will be used */
3150         if (*s == 't' && !isWORDCHAR(s[1])) {
3151             ++s;
3152             my_setenv("PERL5DB_THREADED", "1");
3153         }
3154
3155         /* The following permits -d:Mod to accepts arguments following an =
3156            in the fashion that -MSome::Mod does. */
3157         if (*s == ':' || *s == '=') {
3158             const char *start;
3159             const char *end;
3160             SV *sv;
3161
3162             if (*++s == '-') {
3163                 ++s;
3164                 sv = newSVpvs("no Devel::");
3165             } else {
3166                 sv = newSVpvs("use Devel::");
3167             }
3168
3169             start = s;
3170             end = s + strlen(s);
3171
3172             /* We now allow -d:Module=Foo,Bar and -d:-Module */
3173             while(isWORDCHAR(*s) || *s==':') ++s;
3174             if (*s != '=')
3175                 sv_catpvn(sv, start, end - start);
3176             else {
3177                 sv_catpvn(sv, start, s-start);
3178                 /* Don't use NUL as q// delimiter here, this string goes in the
3179                  * environment. */
3180                 Perl_sv_catpvf(aTHX_ sv, " split(/,/,q{%s});", ++s);
3181             }
3182             s = end;
3183             my_setenv("PERL5DB", SvPV_nolen_const(sv));
3184             SvREFCNT_dec(sv);
3185         }
3186         if (!PL_perldb) {
3187             PL_perldb = PERLDB_ALL;
3188             init_debugger();
3189         }
3190         return s;
3191     case 'D':
3192     {   
3193 #ifdef DEBUGGING
3194         forbid_setid('D', FALSE);
3195         s++;
3196         PL_debug = get_debug_opts( (const char **)&s, 1) | DEBUG_TOP_FLAG;
3197 #else /* !DEBUGGING */
3198         if (ckWARN_d(WARN_DEBUGGING))
3199             Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3200                    "Recompile perl with -DDEBUGGING to use -D switch (did you mean -d ?)\n");
3201         for (s++; isWORDCHAR(*s); s++) ;
3202 #endif
3203         return s;
3204     }   
3205     case 'h':
3206         usage();
3207     case 'i':
3208         Safefree(PL_inplace);
3209 #if defined(__CYGWIN__) /* do backup extension automagically */
3210         if (*(s+1) == '\0') {
3211         PL_inplace = savepvs(".bak");
3212         return s+1;
3213         }
3214 #endif /* __CYGWIN__ */
3215         {
3216             const char * const start = ++s;
3217             while (*s && !isSPACE(*s))
3218                 ++s;
3219
3220             PL_inplace = savepvn(start, s - start);
3221         }
3222         if (*s) {
3223             ++s;
3224             if (*s == '-')      /* Additional switches on #! line. */
3225                 s++;
3226         }
3227         return s;
3228     case 'I':   /* -I handled both here and in parse_body() */
3229         forbid_setid('I', FALSE);
3230         ++s;
3231         while (*s && isSPACE(*s))
3232             ++s;
3233         if (*s) {
3234             const char *e, *p;
3235             p = s;
3236             /* ignore trailing spaces (possibly followed by other switches) */
3237             do {
3238                 for (e = p; *e && !isSPACE(*e); e++) ;
3239                 p = e;
3240                 while (isSPACE(*p))
3241                     p++;
3242             } while (*p && *p != '-');
3243             incpush(s, e-s,
3244                     INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS|INCPUSH_UNSHIFT);
3245             s = p;
3246             if (*s == '-')
3247                 s++;
3248         }
3249         else
3250             Perl_croak(aTHX_ "No directory specified for -I");
3251         return s;
3252     case 'l':
3253         PL_minus_l = TRUE;
3254         s++;
3255         if (PL_ors_sv) {
3256             SvREFCNT_dec(PL_ors_sv);
3257             PL_ors_sv = NULL;
3258         }
3259         if (isDIGIT(*s)) {
3260             I32 flags = 0;
3261             STRLEN numlen;
3262             PL_ors_sv = newSVpvs("\n");
3263             numlen = 3 + (*s == '0');
3264             *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
3265             s += numlen;
3266         }
3267         else {
3268             if (RsPARA(PL_rs)) {
3269                 PL_ors_sv = newSVpvs("\n\n");
3270             }
3271             else {
3272                 PL_ors_sv = newSVsv(PL_rs);
3273             }
3274         }
3275         return s;
3276     case 'M':
3277         forbid_setid('M', FALSE);       /* XXX ? */
3278         /* FALLTHROUGH */
3279     case 'm':
3280         forbid_setid('m', FALSE);       /* XXX ? */
3281         if (*++s) {
3282             const char *start;
3283             const char *end;
3284             SV *sv;
3285             const char *use = "use ";
3286             bool colon = FALSE;
3287             /* -M-foo == 'no foo'       */
3288             /* Leading space on " no " is deliberate, to make both
3289                possibilities the same length.  */
3290             if (*s == '-') { use = " no "; ++s; }
3291             sv = newSVpvn(use,4);
3292             start = s;
3293             /* We allow -M'Module qw(Foo Bar)'  */
3294             while(isWORDCHAR(*s) || *s==':') {
3295                 if( *s++ == ':' ) {
3296                     if( *s == ':' ) 
3297                         s++;
3298                     else
3299                         colon = TRUE;
3300                 }
3301             }
3302             if (s == start)
3303                 Perl_croak(aTHX_ "Module name required with -%c option",
3304                                     option);
3305             if (colon) 
3306                 Perl_croak(aTHX_ "Invalid module name %.*s with -%c option: "
3307                                     "contains single ':'",
3308                                     (int)(s - start), start, option);
3309             end = s + strlen(s);
3310             if (*s != '=') {
3311                 sv_catpvn(sv, start, end - start);
3312                 if (option == 'm') {
3313                     if (*s != '\0')
3314                         Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
3315                     sv_catpvs( sv, " ()");
3316                 }
3317             } else {
3318                 sv_catpvn(sv, start, s-start);
3319                 /* Use NUL as q''-delimiter.  */
3320                 sv_catpvs(sv, " split(/,/,q\0");
3321                 ++s;
3322                 sv_catpvn(sv, s, end - s);
3323                 sv_catpvs(sv,  "\0)");
3324             }
3325             s = end;
3326             Perl_av_create_and_push(aTHX_ &PL_preambleav, sv);
3327         }
3328         else
3329             Perl_croak(aTHX_ "Missing argument to -%c", option);
3330         return s;
3331     case 'n':
3332         PL_minus_n = TRUE;
3333         s++;
3334         return s;
3335     case 'p':
3336         PL_minus_p = TRUE;
3337         s++;
3338         return s;
3339     case 's':
3340         forbid_setid('s', FALSE);
3341         PL_doswitches = TRUE;
3342         s++;
3343         return s;
3344     case 't':
3345     case 'T':
3346 #if defined(SILENT_NO_TAINT_SUPPORT)
3347             /* silently ignore */
3348 #elif defined(NO_TAINT_SUPPORT)
3349         Perl_croak_nocontext("This perl was compiled without taint support. "
3350                    "Cowardly refusing to run with -t or -T flags");
3351 #else
3352         if (!TAINTING_get)
3353             TOO_LATE_FOR(*s);
3354 #endif
3355         s++;
3356         return s;
3357     case 'u':
3358         PL_do_undump = TRUE;
3359         s++;
3360         return s;
3361     case 'U':
3362         PL_unsafe = TRUE;
3363         s++;
3364         return s;
3365     case 'v':
3366         minus_v();
3367     case 'w':
3368         if (! (PL_dowarn & G_WARN_ALL_MASK)) {
3369             PL_dowarn |= G_WARN_ON;
3370         }
3371         s++;
3372         return s;
3373     case 'W':
3374         PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
3375         if (!specialWARN(PL_compiling.cop_warnings))
3376             PerlMemShared_free(PL_compiling.cop_warnings);
3377         PL_compiling.cop_warnings = pWARN_ALL ;
3378         s++;
3379         return s;
3380     case 'X':
3381         PL_dowarn = G_WARN_ALL_OFF;
3382         if (!specialWARN(PL_compiling.cop_warnings))
3383             PerlMemShared_free(PL_compiling.cop_warnings);
3384         PL_compiling.cop_warnings = pWARN_NONE ;
3385         s++;
3386         return s;
3387     case '*':
3388     case ' ':
3389         while( *s == ' ' )
3390           ++s;
3391         if (s[0] == '-')        /* Additional switches on #! line. */
3392             return s+1;
3393         break;
3394     case '-':
3395     case 0:
3396 #if defined(WIN32) || !defined(PERL_STRICT_CR)
3397     case '\r':
3398 #endif
3399     case '\n':
3400     case '\t':
3401         break;
3402 #ifdef ALTERNATE_SHEBANG
3403     case 'S':                   /* OS/2 needs -S on "extproc" line. */
3404         break;
3405 #endif
3406     case 'e': case 'f': case 'x': case 'E':
3407 #ifndef ALTERNATE_SHEBANG
3408     case 'S':
3409 #endif
3410     case 'V':
3411         Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
3412     default:
3413         Perl_croak(aTHX_
3414             "Unrecognized switch: -%.1s  (-h will show valid options)",s
3415         );
3416     }
3417     return NULL;
3418 }
3419
3420
3421 STATIC void
3422 S_minus_v(pTHX)
3423 {
3424         PerlIO * PIO_stdout;
3425         {
3426             const char * const level_str = "v" PERL_VERSION_STRING;
3427             const STRLEN level_len = sizeof("v" PERL_VERSION_STRING)-1;
3428 #ifdef PERL_PATCHNUM
3429             SV* level;
3430 #  ifdef PERL_GIT_UNCOMMITTED_CHANGES
3431             static const char num [] = PERL_PATCHNUM "*";
3432 #  else
3433             static const char num [] = PERL_PATCHNUM;
3434 #  endif
3435             {
3436                 const STRLEN num_len = sizeof(num)-1;
3437                 /* A very advanced compiler would fold away the strnEQ
3438                    and this whole conditional, but most (all?) won't do it.
3439                    SV level could also be replaced by with preprocessor
3440                    catenation.
3441                 */
3442                 if (num_len >= level_len && strnEQ(num,level_str,level_len)) {
3443                     /* per 46807d8e80, PERL_PATCHNUM is outside of the control
3444                        of the interp so it might contain format characters
3445                     */
3446                     level = newSVpvn(num, num_len);
3447                 } else {
3448                     level = Perl_newSVpvf_nocontext("%s (%s)", level_str, num);
3449                 }
3450             }
3451 #else
3452         SV* level = newSVpvn(level_str, level_len);
3453 #endif /* #ifdef PERL_PATCHNUM */
3454         PIO_stdout =  PerlIO_stdout();
3455             PerlIO_printf(PIO_stdout,
3456                 "\nThis is perl "       STRINGIFY(PERL_REVISION)
3457                 ", version "            STRINGIFY(PERL_VERSION)
3458                 ", subversion "         STRINGIFY(PERL_SUBVERSION)
3459                 " (%"SVf") built for "  ARCHNAME, SVfARG(level)
3460                 );
3461             SvREFCNT_dec_NN(level);
3462         }
3463 #if defined(LOCAL_PATCH_COUNT)
3464         if (LOCAL_PATCH_COUNT > 0)
3465             PerlIO_printf(PIO_stdout,
3466                           "\n(with %d registered patch%s, "
3467                           "see perl -V for more detail)",
3468                           LOCAL_PATCH_COUNT,
3469                           (LOCAL_PATCH_COUNT!=1) ? "es" : "");
3470 #endif
3471
3472         PerlIO_printf(PIO_stdout,
3473                       "\n\nCopyright 1987-2014, Larry Wall\n");
3474 #ifdef MSDOS
3475         PerlIO_printf(PIO_stdout,
3476                       "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
3477 #endif
3478 #ifdef DJGPP
3479         PerlIO_printf(PIO_stdout,
3480                       "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
3481                       "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
3482 #endif
3483 #ifdef OS2
3484         PerlIO_printf(PIO_stdout,
3485                       "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
3486                       "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
3487 #endif
3488 #ifdef OEMVS
3489         PerlIO_printf(PIO_stdout,
3490                       "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
3491 #endif
3492 #ifdef __VOS__
3493         PerlIO_printf(PIO_stdout,
3494                       "Stratus OpenVOS port by Paul.Green@stratus.com, 1997-2013\n");
3495 #endif
3496 #ifdef POSIX_BC
3497         PerlIO_printf(PIO_stdout,
3498                       "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
3499 #endif
3500 #ifdef UNDER_CE
3501         PerlIO_printf(PIO_stdout,
3502                         "WINCE port by Rainer Keuchel, 2001-2002\n"
3503                         "Built on " __DATE__ " " __TIME__ "\n\n");
3504         wce_hitreturn();
3505 #endif
3506 #ifdef __SYMBIAN32__
3507         PerlIO_printf(PIO_stdout,
3508                       "Symbian port by Nokia, 2004-2005\n");
3509 #endif
3510 #ifdef BINARY_BUILD_NOTICE
3511         BINARY_BUILD_NOTICE;
3512 #endif
3513         PerlIO_printf(PIO_stdout,
3514                       "\n\
3515 Perl may be copied only under the terms of either the Artistic License or the\n\
3516 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
3517 Complete documentation for Perl, including FAQ lists, should be found on\n\
3518 this system using \"man perl\" or \"perldoc perl\".  If you have access to the\n\
3519 Internet, point your browser at http://www.perl.org/, the Perl Home Page.\n\n");
3520         my_exit(0);
3521 }
3522
3523 /* compliments of Tom Christiansen */
3524
3525 /* unexec() can be found in the Gnu emacs distribution */
3526 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
3527
3528 #ifdef VMS
3529 #include <lib$routines.h>
3530 #endif
3531
3532 void
3533 Perl_my_unexec(pTHX)
3534 {
3535 #ifdef UNEXEC
3536     SV *    prog = newSVpv(BIN_EXP, 0);
3537     SV *    file = newSVpv(PL_origfilename, 0);
3538     int    status = 1;
3539     extern int etext;
3540
3541     sv_catpvs(prog, "/perl");
3542     sv_catpvs(file, ".perldump");
3543
3544     unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
3545     /* unexec prints msg to stderr in case of failure */
3546     PerlProc_exit(status);
3547 #else
3548     PERL_UNUSED_CONTEXT;
3549 #  ifdef VMS
3550      lib$signal(SS$_DEBUG);  /* ssdef.h #included from vmsish.h */
3551 #  elif defined(WIN32) || defined(__CYGWIN__)
3552     Perl_croak_nocontext("dump is not supported");
3553 #  else
3554     ABORT();            /* for use with undump */
3555 #  endif
3556 #endif
3557 }
3558
3559 /* initialize curinterp */
3560 STATIC void
3561 S_init_interp(pTHX)
3562 {
3563 #ifdef MULTIPLICITY
3564 #  define PERLVAR(prefix,var,type)
3565 #  define PERLVARA(prefix,var,n,type)
3566 #  if defined(PERL_IMPLICIT_CONTEXT)
3567 #    define PERLVARI(prefix,var,type,init)      aTHX->prefix##var = init;
3568 #    define PERLVARIC(prefix,var,type,init)     aTHX->prefix##var = init;
3569 #  else
3570 #    define PERLVARI(prefix,var,type,init)      PERL_GET_INTERP->var = init;
3571 #    define PERLVARIC(prefix,var,type,init)     PERL_GET_INTERP->var = init;
3572 #  endif
3573 #  include "intrpvar.h"
3574 #  undef PERLVAR
3575 #  undef PERLVARA
3576 #  undef PERLVARI
3577 #  undef PERLVARIC
3578 #else
3579 #  define PERLVAR(prefix,var,type)
3580 #  define PERLVARA(prefix,var,n,type)
3581 #  define PERLVARI(prefix,var,type,init)        PL_##var = init;
3582 #  define PERLVARIC(prefix,var,type,init)       PL_##var = init;
3583 #  include "intrpvar.h"
3584 #  undef PERLVAR
3585 #  undef PERLVARA
3586 #  undef PERLVARI
3587 #  undef PERLVARIC
3588 #endif
3589
3590 }
3591
3592 STATIC void
3593 S_init_main_stash(pTHX)
3594 {
3595     GV *gv;
3596
3597     PL_curstash = PL_defstash = (HV *)SvREFCNT_inc_simple_NN(newHV());
3598     /* We know that the string "main" will be in the global shared string
3599        table, so it's a small saving to use it rather than allocate another
3600        8 bytes.  */
3601     PL_curstname = newSVpvs_share("main");
3602     gv = gv_fetchpvs("main::", GV_ADD|GV_NOTQUAL, SVt_PVHV);
3603     /* If we hadn't caused another reference to "main" to be in the shared
3604        string table above, then it would be worth reordering these two,
3605        because otherwise all we do is delete "main" from it as a consequence
3606        of the SvREFCNT_dec, only to add it again with hv_name_set */
3607     SvREFCNT_dec(GvHV(gv));
3608     hv_name_set(PL_defstash, "main", 4, 0);
3609     GvHV(gv) = MUTABLE_HV(SvREFCNT_inc_simple(PL_defstash));
3610     SvREADONLY_on(gv);
3611     PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpvs("INC", GV_ADD|GV_NOTQUAL,
3612                                              SVt_PVAV)));
3613     SvREFCNT_inc_simple_void(PL_incgv); /* Don't allow it to be freed */
3614     GvMULTI_on(PL_incgv);
3615     PL_hintgv = gv_fetchpvs("\010", GV_ADD|GV_NOTQUAL, SVt_PV); /* ^H */
3616     SvREFCNT_inc_simple_void(PL_hintgv);
3617     GvMULTI_on(PL_hintgv);
3618     PL_defgv = gv_fetchpvs("_", GV_ADD|GV_NOTQUAL, SVt_PVAV);
3619     SvREFCNT_inc_simple_void(PL_defgv);
3620     PL_errgv = gv_fetchpvs("@", GV_ADD|GV_NOTQUAL, SVt_PV);
3621     SvREFCNT_inc_simple_void(PL_errgv);
3622     GvMULTI_on(PL_errgv);
3623     PL_replgv = gv_fetchpvs("\022", GV_ADD|GV_NOTQUAL, SVt_PV); /* ^R */
3624     SvREFCNT_inc_simple_void(PL_replgv);
3625     GvMULTI_on(PL_replgv);
3626     (void)Perl_form(aTHX_ "%240s","");  /* Preallocate temp - for immediate signals. */
3627 #ifdef PERL_DONT_CREATE_GVSV
3628     gv_SVadd(PL_errgv);
3629 #endif
3630     sv_grow(ERRSV, 240);        /* Preallocate - for immediate signals. */
3631     CLEAR_ERRSV();
3632     SET_CURSTASH(PL_defstash);
3633     CopSTASH_set(&PL_compiling, PL_defstash);
3634     PL_debstash = GvHV(gv_fetchpvs("DB::", GV_ADDMULTI, SVt_PVHV));
3635     PL_globalstash = GvHV(gv_fetchpvs("CORE::GLOBAL::", GV_ADDMULTI,
3636                                       SVt_PVHV));
3637     /* We must init $/ before switches are processed. */
3638     sv_setpvs(get_sv("/", GV_ADD), "\n");
3639 }
3640
3641 STATIC PerlIO *
3642 S_open_script(pTHX_ const char *scriptname, bool dosearch, bool *suidscript)
3643 {
3644     int fdscript = -1;
3645     PerlIO *rsfp = NULL;
3646     Stat_t tmpstatbuf;
3647     int fd;
3648
3649     PERL_ARGS_ASSERT_OPEN_SCRIPT;
3650
3651     if (PL_e_script) {
3652         PL_origfilename = savepvs("-e");
3653     }
3654     else {
3655         /* if find_script() returns, it returns a malloc()-ed value */
3656         scriptname = PL_origfilename = find_script(scriptname, dosearch, NULL, 1);
3657
3658         if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
3659             const char *s = scriptname + 8;
3660             const char* e;
3661             fdscript = grok_atou(s, &e);
3662             s = e;
3663             if (*s) {
3664                 /* PSz 18 Feb 04
3665                  * Tell apart "normal" usage of fdscript, e.g.
3666                  * with bash on FreeBSD:
3667                  *   perl <( echo '#!perl -DA'; echo 'print "$0\n"')
3668                  * from usage in suidperl.
3669                  * Does any "normal" usage leave garbage after the number???
3670                  * Is it a mistake to use a similar /dev/fd/ construct for
3671                  * suidperl?
3672                  */
3673                 *suidscript = TRUE;
3674                 /* PSz 20 Feb 04  
3675                  * Be supersafe and do some sanity-checks.
3676                  * Still, can we be sure we got the right thing?
3677                  */
3678                 if (*s != '/') {
3679                     Perl_croak(aTHX_ "Wrong syntax (suid) fd script name \"%s\"\n", s);
3680                 }
3681                 if (! *(s+1)) {
3682                     Perl_croak(aTHX_ "Missing (suid) fd script name\n");
3683                 }
3684                 scriptname = savepv(s + 1);
3685                 Safefree(PL_origfilename);
3686                 PL_origfilename = (char *)scriptname;
3687             }
3688         }
3689     }
3690
3691     CopFILE_free(PL_curcop);
3692     CopFILE_set(PL_curcop, PL_origfilename);
3693     if (*PL_origfilename == '-' && PL_origfilename[1] == '\0')
3694         scriptname = (char *)"";
3695     if (fdscript >= 0) {
3696         rsfp = PerlIO_fdopen(fdscript,PERL_SCRIPT_MODE);
3697     }
3698     else if (!*scriptname) {
3699         forbid_setid(0, *suidscript);
3700         return NULL;
3701     }
3702     else {
3703 #ifdef FAKE_BIT_BUCKET
3704         /* This hack allows one not to have /dev/null (or BIT_BUCKET as it
3705          * is called) and still have the "-e" work.  (Believe it or not,
3706          * a /dev/null is required for the "-e" to work because source
3707          * filter magic is used to implement it. ) This is *not* a general
3708          * replacement for a /dev/null.  What we do here is create a temp
3709          * file (an empty file), open up that as the script, and then
3710          * immediately close and unlink it.  Close enough for jazz. */ 
3711 #define FAKE_BIT_BUCKET_PREFIX "/tmp/perlnull-"
3712 #define FAKE_BIT_BUCKET_SUFFIX "XXXXXXXX"
3713 #define FAKE_BIT_BUCKET_TEMPLATE FAKE_BIT_BUCKET_PREFIX FAKE_BIT_BUCKET_SUFFIX
3714         char tmpname[sizeof(FAKE_BIT_BUCKET_TEMPLATE)] = {
3715             FAKE_BIT_BUCKET_TEMPLATE
3716         };
3717         const char * const err = "Failed to create a fake bit bucket";
3718         if (strEQ(scriptname, BIT_BUCKET)) {
3719 #ifdef HAS_MKSTEMP /* Hopefully mkstemp() is safe here. */
3720             int old_umask = umask(0600);
3721             int tmpfd = mkstemp(tmpname);
3722             umask(old_umask);
3723             if (tmpfd > -1) {
3724                 scriptname = tmpname;
3725                 close(tmpfd);
3726             } else
3727                 Perl_croak(aTHX_ err);
3728 #else
3729 #  ifdef HAS_MKTEMP
3730             scriptname = mktemp(tmpname);
3731             if (!scriptname)
3732                 Perl_croak(aTHX_ err);
3733 #  endif
3734 #endif
3735         }
3736 #endif
3737         rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
3738 #ifdef FAKE_BIT_BUCKET
3739         if (memEQ(scriptname, FAKE_BIT_BUCKET_PREFIX,
3740                   sizeof(FAKE_BIT_BUCKET_PREFIX) - 1)
3741             && strlen(scriptname) == sizeof(tmpname) - 1) {
3742             unlink(scriptname);
3743         }
3744         scriptname = BIT_BUCKET;
3745 #endif
3746     }
3747     if (!rsfp) {
3748         /* PSz 16 Sep 03  Keep neat error message */
3749         if (PL_e_script)
3750             Perl_croak(aTHX_ "Can't open "BIT_BUCKET": %s\n", Strerror(errno));
3751         else
3752             Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
3753                     CopFILE(PL_curcop), Strerror(errno));
3754     }
3755     fd = PerlIO_fileno(rsfp);
3756 #if defined(HAS_FCNTL) && defined(F_SETFD)
3757     if (fd >= 0) {
3758         /* ensure close-on-exec */
3759         if (fcntl(fd, F_SETFD, 1) < 0) {
3760             Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
3761                        CopFILE(PL_curcop), Strerror(errno));
3762         }
3763     }
3764 #endif
3765
3766     if (fd < 0 ||
3767         (PerlLIO_fstat(fd, &tmpstatbuf) >= 0
3768          && S_ISDIR(tmpstatbuf.st_mode)))
3769         Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
3770             CopFILE(PL_curcop),
3771             Strerror(EISDIR));
3772
3773     return rsfp;
3774 }
3775
3776 /* Mention
3777  * I_SYSSTATVFS HAS_FSTATVFS
3778  * I_SYSMOUNT
3779  * I_STATFS     HAS_FSTATFS     HAS_GETFSSTAT
3780  * I_MNTENT     HAS_GETMNTENT   HAS_HASMNTOPT
3781  * here so that metaconfig picks them up. */
3782
3783
3784 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
3785 /* Don't even need this function.  */
3786 #else
3787 STATIC void
3788 S_validate_suid(pTHX_ PerlIO *rsfp)
3789 {
3790     const Uid_t  my_uid = PerlProc_getuid();
3791     const Uid_t my_euid = PerlProc_geteuid();
3792     const Gid_t  my_gid = PerlProc_getgid();
3793     const Gid_t my_egid = PerlProc_getegid();
3794
3795     PERL_ARGS_ASSERT_VALIDATE_SUID;
3796
3797     if (my_euid != my_uid || my_egid != my_gid) {       /* (suidperl doesn't exist, in fact) */
3798         dVAR;
3799         int fd = PerlIO_fileno(rsfp);
3800         if (fd < 0) {
3801             Perl_croak(aTHX_ "Illegal suidscript");
3802         } else {
3803             if (PerlLIO_fstat(fd, &PL_statbuf) < 0) {   /* may be either wrapped or real suid */
3804                 Perl_croak(aTHX_ "Illegal suidscript");
3805             }
3806         }
3807         if ((my_euid != my_uid && my_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3808             ||
3809             (my_egid != my_gid && my_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3810             )
3811             if (!PL_do_undump)
3812                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3813 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3814         /* not set-id, must be wrapped */
3815     }
3816 }
3817 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3818
3819 STATIC void
3820 S_find_beginning(pTHX_ SV* linestr_sv, PerlIO *rsfp)
3821 {
3822     const char *s;
3823     const char *s2;
3824
3825     PERL_ARGS_ASSERT_FIND_BEGINNING;
3826
3827     /* skip forward in input to the real script? */
3828
3829     do {
3830         if ((s = sv_gets(linestr_sv, rsfp, 0)) == NULL)
3831             Perl_croak(aTHX_ "No Perl script found in input\n");
3832         s2 = s;
3833     } while (!(*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))));
3834     PerlIO_ungetc(rsfp, '\n');          /* to keep line count right */
3835     while (*s && !(isSPACE (*s) || *s == '#')) s++;
3836     s2 = s;
3837     while (*s == ' ' || *s == '\t') s++;
3838     if (*s++ == '-') {
3839         while (isDIGIT(s2[-1]) || s2[-1] == '-' || s2[-1] == '.'
3840                || s2[-1] == '_') s2--;
3841         if (strnEQ(s2-4,"perl",4))
3842             while ((s = moreswitches(s)))
3843                 ;
3844     }
3845 }
3846
3847
3848 STATIC void
3849 S_init_ids(pTHX)
3850 {
3851     /* no need to do anything here any more if we don't
3852      * do tainting. */
3853 #ifndef NO_TAINT_SUPPORT
3854     const Uid_t my_uid = PerlProc_getuid();
3855     const Uid_t my_euid = PerlProc_geteuid();
3856     const Gid_t my_gid = PerlProc_getgid();
3857     const Gid_t my_egid = PerlProc_getegid();
3858
3859     PERL_UNUSED_CONTEXT;
3860
3861     /* Should not happen: */
3862     CHECK_MALLOC_TAINT(my_uid && (my_euid != my_uid || my_egid != my_gid));
3863     TAINTING_set( TAINTING_get | (my_uid && (my_euid != my_uid || my_egid != my_gid)) );
3864 #endif
3865     /* BUG */
3866     /* PSz 27 Feb 04
3867      * Should go by suidscript, not uid!=euid: why disallow
3868      * system("ls") in scripts run from setuid things?
3869      * Or, is this run before we check arguments and set suidscript?
3870      * What about SETUID_SCRIPTS_ARE_SECURE_NOW: could we use fdscript then?
3871      * (We never have suidscript, can we be sure to have fdscript?)
3872      * Or must then go by UID checks? See comments in forbid_setid also.
3873      */
3874 }
3875
3876 /* This is used very early in the lifetime of the program,
3877  * before even the options are parsed, so PL_tainting has
3878  * not been initialized properly.  */
3879 bool
3880 Perl_doing_taint(int argc, char *argv[], char *envp[])
3881 {
3882 #ifndef PERL_IMPLICIT_SYS
3883     /* If we have PERL_IMPLICIT_SYS we can't call getuid() et alia
3884      * before we have an interpreter-- and the whole point of this
3885      * function is to be called at such an early stage.  If you are on
3886      * a system with PERL_IMPLICIT_SYS but you do have a concept of
3887      * "tainted because running with altered effective ids', you'll
3888      * have to add your own checks somewhere in here.  The two most
3889      * known samples of 'implicitness' are Win32 and NetWare, neither
3890      * of which has much of concept of 'uids'. */
3891     Uid_t uid  = PerlProc_getuid();
3892     Uid_t euid = PerlProc_geteuid();
3893     Gid_t gid  = PerlProc_getgid();
3894     Gid_t egid = PerlProc_getegid();
3895     (void)envp;
3896
3897 #ifdef VMS
3898     uid  |=  gid << 16;
3899     euid |= egid << 16;
3900 #endif
3901     if (uid && (euid != uid || egid != gid))
3902         return 1;
3903 #endif /* !PERL_IMPLICIT_SYS */
3904     /* This is a really primitive check; environment gets ignored only
3905      * if -T are the first chars together; otherwise one gets
3906      *  "Too late" message. */
3907     if ( argc > 1 && argv[1][0] == '-'
3908          && isALPHA_FOLD_EQ(argv[1][1], 't'))
3909         return 1;
3910     return 0;
3911 }
3912
3913 /* Passing the flag as a single char rather than a string is a slight space
3914    optimisation.  The only message that isn't /^-.$/ is
3915    "program input from stdin", which is substituted in place of '\0', which
3916    could never be a command line flag.  */
3917 STATIC void
3918 S_forbid_setid(pTHX_ const char flag, const bool suidscript) /* g */
3919 {
3920     char string[3] = "-x";
3921     const char *message = "program input from stdin";
3922
3923     PERL_UNUSED_CONTEXT;
3924     if (flag) {
3925         string[1] = flag;
3926         message = string;
3927     }
3928
3929 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
3930     if (PerlProc_getuid() != PerlProc_geteuid())
3931         Perl_croak(aTHX_ "No %s allowed while running setuid", message);
3932     if (PerlProc_getgid() != PerlProc_getegid())
3933         Perl_croak(aTHX_ "No %s allowed while running setgid", message);
3934 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3935     if (suidscript)
3936         Perl_croak(aTHX_ "No %s allowed with (suid) fdscript", message);
3937 }
3938
3939 void
3940 Perl_init_dbargs(pTHX)
3941 {
3942     AV *const args = PL_dbargs = GvAV(gv_AVadd((gv_fetchpvs("DB::args",
3943                                                             GV_ADDMULTI,
3944                                                             SVt_PVAV))));
3945
3946     if (AvREAL(args)) {
3947         /* Someone has already created it.
3948            It might have entries, and if we just turn off AvREAL(), they will
3949            "leak" until global destruction.  */
3950         av_clear(args);
3951         if (SvTIED_mg((const SV *)args, PERL_MAGIC_tied))
3952             Perl_croak(aTHX_ "Cannot set tied @DB::args");
3953     }
3954     AvREIFY_only(PL_dbargs);
3955 }
3956
3957 void
3958 Perl_init_debugger(pTHX)
3959 {
3960     HV * const ostash = PL_curstash;
3961     MAGIC *mg;
3962
3963     PL_curstash = (HV *)SvREFCNT_inc_simple(PL_debstash);
3964
3965     Perl_init_dbargs(aTHX);
3966     PL_DBgv = MUTABLE_GV(
3967         SvREFCNT_inc(gv_fetchpvs("DB::DB", GV_ADDMULTI, SVt_PVGV))
3968     );
3969     PL_DBline = MUTABLE_GV(
3970         SvREFCNT_inc(gv_fetchpvs("DB::dbline", GV_ADDMULTI, SVt_PVAV))
3971     );
3972     PL_DBsub = MUTABLE_GV(SvREFCNT_inc(
3973         gv_HVadd(gv_fetchpvs("DB::sub", GV_ADDMULTI, SVt_PVHV))
3974     ));
3975     PL_DBsingle = GvSV((gv_fetchpvs("DB::single", GV_ADDMULTI, SVt_PV)));
3976     if (!SvIOK(PL_DBsingle))
3977         sv_setiv(PL_DBsingle, 0);
3978     mg = sv_magicext(PL_DBsingle, NULL, PERL_MAGIC_debugvar, &PL_vtbl_debugvar, 0, 0);
3979     mg->mg_private = DBVARMG_SINGLE;
3980     SvSETMAGIC(PL_DBsingle);
3981
3982     PL_DBtrace = GvSV((gv_fetchpvs("DB::trace", GV_ADDMULTI, SVt_PV)));
3983     if (!SvIOK(PL_DBtrace))
3984         sv_setiv(PL_DBtrace, 0);
3985     mg = sv_magicext(PL_DBtrace, NULL, PERL_MAGIC_debugvar, &PL_vtbl_debugvar, 0, 0);
3986     mg->mg_private = DBVARMG_TRACE;
3987     SvSETMAGIC(PL_DBtrace);
3988
3989     PL_DBsignal = GvSV((gv_fetchpvs("DB::signal", GV_ADDMULTI, SVt_PV)));
3990     if (!SvIOK(PL_DBsignal))
3991         sv_setiv(PL_DBsignal, 0);
3992     mg = sv_magicext(PL_DBsignal, NULL, PERL_MAGIC_debugvar, &PL_vtbl_debugvar, 0, 0);
3993     mg->mg_private = DBVARMG_SIGNAL;
3994     SvSETMAGIC(PL_DBsignal);
3995
3996     SvREFCNT_dec(PL_curstash);
3997     PL_curstash = ostash;
3998 }
3999
4000 #ifndef STRESS_REALLOC
4001 #define REASONABLE(size) (size)
4002 #define REASONABLE_but_at_least(size,min) (size)
4003 #else
4004 #define REASONABLE(size) (1) /* unreasonable */
4005 #define REASONABLE_but_at_least(size,min) (min)
4006 #endif
4007
4008 void
4009 Perl_init_stacks(pTHX)
4010 {
4011     /* start with 128-item stack and 8K cxstack */
4012     PL_curstackinfo = new_stackinfo(REASONABLE(128),
4013                                  REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
4014     PL_curstackinfo->si_type = PERLSI_MAIN;
4015     PL_curstack = PL_curstackinfo->si_stack;
4016     PL_mainstack = PL_curstack;         /* remember in case we switch stacks */
4017
4018     PL_stack_base = AvARRAY(PL_curstack);
4019     PL_stack_sp = PL_stack_base;
4020     PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
4021
4022     Newx(PL_tmps_stack,REASONABLE(128),SV*);
4023     PL_tmps_floor = -1;
4024     PL_tmps_ix = -1;
4025     PL_tmps_max = REASONABLE(128);
4026
4027     Newx(PL_markstack,REASONABLE(32),I32);
4028     PL_markstack_ptr = PL_markstack;
4029     PL_markstack_max = PL_markstack + REASONABLE(32);
4030
4031     SET_MARK_OFFSET;
4032
4033     Newx(PL_scopestack,REASONABLE(32),I32);
4034 #ifdef DEBUGGING
4035     Newx(PL_scopestack_name,REASONABLE(32),const char*);
4036 #endif
4037     PL_scopestack_ix = 0;
4038     PL_scopestack_max = REASONABLE(32);
4039
4040     Newx(PL_savestack,REASONABLE_but_at_least(128,SS_MAXPUSH),ANY);
4041     PL_savestack_ix = 0;
4042     PL_savestack_max = REASONABLE_but_at_least(128,SS_MAXPUSH);
4043 }
4044
4045 #undef REASONABLE
4046
4047 STATIC void
4048 S_nuke_stacks(pTHX)
4049 {
4050     while (PL_curstackinfo->si_next)
4051         PL_curstackinfo = PL_curstackinfo->si_next;
4052     while (PL_curstackinfo) {
4053         PERL_SI *p = PL_curstackinfo->si_prev;
4054         /* curstackinfo->si_stack got nuked by sv_free_arenas() */
4055         Safefree(PL_curstackinfo->si_cxstack);
4056         Safefree(PL_curstackinfo);
4057         PL_curstackinfo = p;
4058     }
4059     Safefree(PL_tmps_stack);
4060     Safefree(PL_markstack);
4061     Safefree(PL_scopestack);
4062 #ifdef DEBUGGING
4063     Safefree(PL_scopestack_name);
4064 #endif
4065     Safefree(PL_savestack);
4066 }
4067
4068 void
4069 Perl_populate_isa(pTHX_ const char *name, STRLEN len, ...)
4070 {
4071     GV *const gv = gv_fetchpvn(name, len, GV_ADD | GV_ADDMULTI, SVt_PVAV);
4072     AV *const isa = GvAVn(gv);
4073     va_list args;
4074
4075     PERL_ARGS_ASSERT_POPULATE_ISA;
4076
4077     if(AvFILLp(isa) != -1)
4078         return;
4079
4080     /* NOTE: No support for tied ISA */
4081
4082     va_start(args, len);
4083     do {
4084         const char *const parent = va_arg(args, const char*);
4085         size_t parent_len;
4086
4087         if (!parent)
4088             break;
4089         parent_len = va_arg(args, size_t);
4090
4091         /* Arguments are supplied with a trailing ::  */
4092         assert(parent_len > 2);
4093         assert(parent[parent_len - 1] == ':');
4094         assert(parent[parent_len - 2] == ':');
4095         av_push(isa, newSVpvn(parent, parent_len - 2));
4096         (void) gv_fetchpvn(parent, parent_len, GV_ADD, SVt_PVGV);
4097     } while (1);
4098     va_end(args);
4099 }
4100
4101
4102 STATIC void
4103 S_init_predump_symbols(pTHX)
4104 {
4105     GV *tmpgv;
4106     IO *io;
4107
4108     sv_setpvs(get_sv("\"", GV_ADD), " ");
4109     PL_ofsgv = (GV*)SvREFCNT_inc(gv_fetchpvs(",", GV_ADD|GV_NOTQUAL, SVt_PV));
4110
4111
4112     /* Historically, PVIOs were blessed into IO::Handle, unless
4113        FileHandle was loaded, in which case they were blessed into
4114        that. Action at a distance.
4115        However, if we simply bless into IO::Handle, we break code
4116        that assumes that PVIOs will have (among others) a seek
4117        method. IO::File inherits from IO::Handle and IO::Seekable,
4118        and provides the needed methods. But if we simply bless into
4119        it, then we break code that assumed that by loading
4120        IO::Handle, *it* would work.
4121        So a compromise is to set up the correct @IO::File::ISA,
4122        so that code that does C<use IO::Handle>; will still work.
4123     */
4124                    
4125     Perl_populate_isa(aTHX_ STR_WITH_LEN("IO::File::ISA"),
4126                       STR_WITH_LEN("IO::Handle::"),
4127                       STR_WITH_LEN("IO::Seekable::"),
4128                       STR_WITH_LEN("Exporter::"),
4129                       NULL);
4130
4131     PL_stdingv = gv_fetchpvs("STDIN", GV_ADD|GV_NOTQUAL, SVt_PVIO);
4132     GvMULTI_on(PL_stdingv);
4133     io = GvIOp(PL_stdingv);
4134     IoTYPE(io) = IoTYPE_RDONLY;
4135     IoIFP(io) = PerlIO_stdin();
4136     tmpgv = gv_fetchpvs("stdin", GV_ADD|GV_NOTQUAL, SVt_PV);
4137     GvMULTI_on(tmpgv);
4138     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
4139
4140     tmpgv = gv_fetchpvs("STDOUT", GV_ADD|GV_NOTQUAL, SVt_PVIO);
4141     GvMULTI_on(tmpgv);
4142     io = GvIOp(tmpgv);
4143     IoTYPE(io) = IoTYPE_WRONLY;
4144     IoOFP(io) = IoIFP(io) = PerlIO_stdout();
4145     setdefout(tmpgv);
4146     tmpgv = gv_fetchpvs("stdout", GV_ADD|GV_NOTQUAL, SVt_PV);
4147     GvMULTI_on(tmpgv);
4148     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
4149
4150     PL_stderrgv = gv_fetchpvs("STDERR", GV_ADD|GV_NOTQUAL, SVt_PVIO);
4151     GvMULTI_on(PL_stderrgv);
4152     io = GvIOp(PL_stderrgv);
4153     IoTYPE(io) = IoTYPE_WRONLY;
4154     IoOFP(io) = IoIFP(io) = PerlIO_stderr();
4155     tmpgv = gv_fetchpvs("stderr", GV_ADD|GV_NOTQUAL, SVt_PV);
4156     GvMULTI_on(tmpgv);
4157     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
4158
4159     PL_statname = newSVpvs("");         /* last filename we did stat on */
4160 }
4161
4162 void
4163 Perl_init_argv_symbols(pTHX_ int argc, char **argv)
4164 {
4165     PERL_ARGS_ASSERT_INIT_ARGV_SYMBOLS;
4166
4167     argc--,argv++;      /* skip name of script */
4168     if (PL_doswitches) {
4169         for (; argc > 0 && **argv == '-'; argc--,argv++) {
4170             char *s;
4171             if (!argv[0][1])
4172                 break;
4173             if (argv[0][1] == '-' && !argv[0][2]) {
4174                 argc--,argv++;
4175                 break;
4176             }
4177             if ((s = strchr(argv[0], '='))) {
4178                 const char *const start_name = argv[0] + 1;
4179                 sv_setpv(GvSV(gv_fetchpvn_flags(start_name, s - start_name,
4180                                                 TRUE, SVt_PV)), s + 1);
4181             }
4182             else
4183                 sv_setiv(GvSV(gv_fetchpv(argv[0]+1, GV_ADD, SVt_PV)),1);
4184         }
4185     }
4186     if ((PL_argvgv = gv_fetchpvs("ARGV", GV_ADD|GV_NOTQUAL, SVt_PVAV))) {
4187         SvREFCNT_inc_simple_void_NN(PL_argvgv);
4188         GvMULTI_on(PL_argvgv);
4189         av_clear(GvAVn(PL_argvgv));
4190         for (; argc > 0; argc--,argv++) {
4191             SV * const sv = newSVpv(argv[0],0);
4192             av_push(GvAV(PL_argvgv),sv);
4193             if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
4194                  if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
4195                       SvUTF8_on(sv);
4196             }
4197             if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
4198                  (void)sv_utf8_decode(sv);
4199         }
4200     }
4201
4202     if (PL_inplace && (!PL_argvgv || AvFILL(GvAV(PL_argvgv)) == -1))
4203         Perl_ck_warner_d(aTHX_ packWARN(WARN_INPLACE),
4204                          "-i used with no filenames on the command line, "
4205                          "reading from STDIN");
4206 }
4207
4208 STATIC void
4209 S_init_postdump_symbols(pTHX_ int argc, char **argv, char **env)
4210 {
4211 #ifdef USE_ITHREADS
4212     dVAR;
4213 #endif
4214     GV* tmpgv;
4215
4216     PERL_ARGS_ASSERT_INIT_POSTDUMP_SYMBOLS;
4217
4218     PL_toptarget = newSV_type(SVt_PVIV);
4219     sv_setpvs(PL_toptarget, "");
4220     PL_bodytarget = newSV_type(SVt_PVIV);
4221     sv_setpvs(PL_bodytarget, "");
4222     PL_formtarget = PL_bodytarget;
4223
4224     TAINT;
4225
4226     init_argv_symbols(argc,argv);
4227
4228     if ((tmpgv = gv_fetchpvs("0", GV_ADD|GV_NOTQUAL, SVt_PV))) {
4229         sv_setpv(GvSV(tmpgv),PL_origfilename);
4230     }
4231     if ((PL_envgv = gv_fetchpvs("ENV", GV_ADD|GV_NOTQUAL, SVt_PVHV))) {
4232         HV *hv;
4233         bool env_is_not_environ;
4234         SvREFCNT_inc_simple_void_NN(PL_envgv);
4235         GvMULTI_on(PL_envgv);
4236         hv = GvHVn(PL_envgv);
4237         hv_magic(hv, NULL, PERL_MAGIC_env);
4238 #ifndef PERL_MICRO
4239 #ifdef USE_ENVIRON_ARRAY
4240         /* Note that if the supplied env parameter is actually a copy
4241            of the global environ then it may now point to free'd memory
4242            if the environment has been modified since. To avoid this
4243            problem we treat env==NULL as meaning 'use the default'
4244         */
4245         if (!env)
4246             env = environ;
4247         env_is_not_environ = env != environ;
4248         if (env_is_not_environ
4249 #  ifdef USE_ITHREADS
4250             && PL_curinterp == aTHX
4251 #  endif
4252            )
4253         {
4254             environ[0] = NULL;
4255         }
4256         if (env) {
4257           char *s, *old_var;
4258           SV *sv;
4259           for (; *env; env++) {
4260             old_var = *env;
4261
4262             if (!(s = strchr(old_var,'=')) || s == old_var)
4263                 continue;
4264
4265 #if defined(MSDOS) && !defined(DJGPP)
4266             *s = '\0';
4267             (void)strupr(old_var);
4268             *s = '=';
4269 #endif
4270             sv = newSVpv(s+1, 0);
4271             (void)hv_store(hv, old_var, s - old_var, sv, 0);
4272             if (env_is_not_environ)
4273                 mg_set(sv);
4274           }
4275       }
4276 #endif /* USE_ENVIRON_ARRAY */
4277 #endif /* !PERL_MICRO */
4278     }
4279     TAINT_NOT;
4280
4281     /* touch @F array to prevent spurious warnings 20020415 MJD */
4282     if (PL_minus_a) {
4283       (void) get_av("main::F", GV_ADD | GV_ADDMULTI);
4284     }
4285 }
4286
4287 STATIC void
4288 S_init_perllib(pTHX)
4289 {
4290 #ifndef VMS
4291     const char *perl5lib = NULL;
4292 #endif
4293     const char *s;
4294 #if defined(WIN32) && !defined(PERL_IS_MINIPERL)
4295     STRLEN len;
4296 #endif
4297
4298     if (!TAINTING_get) {
4299 #ifndef VMS
4300         perl5lib = PerlEnv_getenv("PERL5LIB");
4301 /*
4302  * It isn't possible to delete an environment variable with
4303  * PERL_USE_SAFE_PUTENV set unless unsetenv() is also available, so in that
4304  * case we treat PERL5LIB as undefined if it has a zero-length value.
4305  */
4306 #if defined(PERL_USE_SAFE_PUTENV) && ! defined(HAS_UNSETENV)
4307         if (perl5lib && *perl5lib != '\0')
4308 #else
4309         if (perl5lib)
4310 #endif
4311             incpush_use_sep(perl5lib, 0, INCPUSH_ADD_SUB_DIRS);
4312         else {
4313             s = PerlEnv_getenv("PERLLIB");
4314             if (s)
4315                 incpush_use_sep(s, 0, 0);
4316         }
4317 #else /* VMS */
4318         /* Treat PERL5?LIB as a possible search list logical name -- the
4319          * "natural" VMS idiom for a Unix path string.  We allow each
4320          * element to be a set of |-separated directories for compatibility.
4321          */
4322         char buf[256];
4323         int idx = 0;
4324         if (my_trnlnm("PERL5LIB",buf,0))
4325             do {
4326                 incpush_use_sep(buf, 0, INCPUSH_ADD_SUB_DIRS);
4327             } while (my_trnlnm("PERL5LIB",buf,++idx));
4328         else {
4329             while (my_trnlnm("PERLLIB",buf,idx++))
4330                 incpush_use_sep(buf, 0, 0);
4331         }
4332 #endif /* VMS */
4333     }
4334
4335 #ifndef PERL_IS_MINIPERL
4336     /* miniperl gets just -I..., the split of $ENV{PERL5LIB}, and "." in @INC
4337        (and not the architecture specific directories from $ENV{PERL5LIB}) */
4338
4339 /* Use the ~-expanded versions of APPLLIB (undocumented),
4340     SITEARCH, SITELIB, VENDORARCH, VENDORLIB, ARCHLIB and PRIVLIB
4341 */
4342 #ifdef APPLLIB_EXP
4343     S_incpush_use_sep(aTHX_ STR_WITH_LEN(APPLLIB_EXP),
4344                       INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4345 #endif
4346
4347 #ifdef SITEARCH_EXP
4348     /* sitearch is always relative to sitelib on Windows for
4349      * DLL-based path intuition to work correctly */
4350 #  if !defined(WIN32)
4351         S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITEARCH_EXP),
4352                           INCPUSH_CAN_RELOCATE);
4353 #  endif
4354 #endif
4355
4356 #ifdef SITELIB_EXP
4357 #  if defined(WIN32)
4358     /* this picks up sitearch as well */
4359         s = win32_get_sitelib(PERL_FS_VERSION, &len);
4360         if (s)
4361             incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4362 #  else
4363         S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITELIB_EXP), INCPUSH_CAN_RELOCATE);
4364 #  endif
4365 #endif
4366
4367 #ifdef PERL_VENDORARCH_EXP
4368     /* vendorarch is always relative to vendorlib on Windows for
4369      * DLL-based path intuition to work correctly */
4370 #  if !defined(WIN32)
4371     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORARCH_EXP),
4372                       INCPUSH_CAN_RELOCATE);
4373 #  endif
4374 #endif
4375
4376 #ifdef PERL_VENDORLIB_EXP
4377 #  if defined(WIN32)
4378     /* this picks up vendorarch as well */
4379         s = win32_get_vendorlib(PERL_FS_VERSION, &len);
4380         if (s)
4381             incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4382 #  else
4383         S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORLIB_EXP),
4384                           INCPUSH_CAN_RELOCATE);
4385 #  endif
4386 #endif
4387
4388 #ifdef ARCHLIB_EXP
4389     S_incpush_use_sep(aTHX_ STR_WITH_LEN(ARCHLIB_EXP), INCPUSH_CAN_RELOCATE);
4390 #endif
4391
4392 #ifndef PRIVLIB_EXP
4393 #  define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
4394 #endif
4395
4396 #if defined(WIN32)
4397     s = win32_get_privlib(PERL_FS_VERSION, &len);
4398     if (s)
4399         incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4400 #else
4401 #  ifdef NETWARE
4402     S_incpush_use_sep(aTHX_ PRIVLIB_EXP, 0, INCPUSH_CAN_RELOCATE);
4403 #  else
4404     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PRIVLIB_EXP), INCPUSH_CAN_RELOCATE);
4405 #  endif
4406 #endif
4407
4408 #ifdef PERL_OTHERLIBDIRS
4409     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_OTHERLIBDIRS),
4410                       INCPUSH_ADD_VERSIONED_SUB_DIRS|INCPUSH_NOT_BASEDIR
4411                       |INCPUSH_CAN_RELOCATE);
4412 #endif
4413
4414     if (!TAINTING_get) {
4415 #ifndef VMS
4416 /*
4417  * It isn't possible to delete an environment variable with
4418  * PERL_USE_SAFE_PUTENV set unless unsetenv() is also available, so in that
4419  * case we treat PERL5LIB as undefined if it has a zero-length value.
4420  */
4421 #if defined(PERL_USE_SAFE_PUTENV) && ! defined(HAS_UNSETENV)
4422         if (perl5lib && *perl5lib != '\0')
4423 #else
4424         if (perl5lib)
4425 #endif
4426             incpush_use_sep(perl5lib, 0,
4427                             INCPUSH_ADD_OLD_VERS|INCPUSH_NOT_BASEDIR);
4428 #else /* VMS */
4429         /* Treat PERL5?LIB as a possible search list logical name -- the
4430          * "natural" VMS idiom for a Unix path string.  We allow each
4431          * element to be a set of |-separated directories for compatibility.
4432          */
4433         char buf[256];
4434         int idx = 0;
4435         if (my_trnlnm("PERL5LIB",buf,0))
4436             do {
4437                 incpush_use_sep(buf, 0,
4438                                 INCPUSH_ADD_OLD_VERS|INCPUSH_NOT_BASEDIR);
4439             } while (my_trnlnm("PERL5LIB",buf,++idx));
4440 #endif /* VMS */
4441     }
4442
4443 /* Use the ~-expanded versions of APPLLIB (undocumented),
4444     SITELIB and VENDORLIB for older versions
4445 */
4446 #ifdef APPLLIB_EXP
4447     S_incpush_use_sep(aTHX_ STR_WITH_LEN(APPLLIB_EXP), INCPUSH_ADD_OLD_VERS
4448                       |INCPUSH_NOT_BASEDIR|INCPUSH_CAN_RELOCATE);
4449 #endif
4450
4451 #if defined(SITELIB_STEM) && defined(PERL_INC_VERSION_LIST)
4452     /* Search for version-specific dirs below here */
4453     S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITELIB_STEM),
4454                       INCPUSH_ADD_OLD_VERS|INCPUSH_CAN_RELOCATE);
4455 #endif
4456
4457
4458 #if defined(PERL_VENDORLIB_STEM) && defined(PERL_INC_VERSION_LIST)
4459     /* Search for version-specific dirs below here */
4460     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORLIB_STEM),
4461                       INCPUSH_ADD_OLD_VERS|INCPUSH_CAN_RELOCATE);
4462 #endif
4463
4464 #ifdef PERL_OTHERLIBDIRS
4465     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_OTHERLIBDIRS),
4466                       INCPUSH_ADD_OLD_VERS|INCPUSH_ADD_ARCHONLY_SUB_DIRS
4467                       |INCPUSH_CAN_RELOCATE);
4468 #endif
4469 #endif /* !PERL_IS_MINIPERL */
4470
4471     if (!TAINTING_get)
4472         S_incpush(aTHX_ STR_WITH_LEN("."), 0);
4473 }
4474
4475 #if defined(DOSISH) || defined(__SYMBIAN32__)
4476 #    define PERLLIB_SEP ';'
4477 #else
4478 #  if defined(VMS)
4479 #    define PERLLIB_SEP '|'
4480 #  else
4481 #    define PERLLIB_SEP ':'
4482 #  endif
4483 #endif
4484 #ifndef PERLLIB_MANGLE
4485 #  define PERLLIB_MANGLE(s,n) (s)
4486 #endif
4487
4488 #ifndef PERL_IS_MINIPERL
4489 /* Push a directory onto @INC if it exists.
4490    Generate a new SV if we do this, to save needing to copy the SV we push
4491    onto @INC  */
4492 STATIC SV *
4493 S_incpush_if_exists(pTHX_ AV *const av, SV *dir, SV *const stem)
4494 {
4495     Stat_t tmpstatbuf;
4496
4497     PERL_ARGS_ASSERT_INCPUSH_IF_EXISTS;
4498
4499     if (PerlLIO_stat(SvPVX_const(dir), &tmpstatbuf) >= 0 &&
4500         S_ISDIR(tmpstatbuf.st_mode)) {
4501         av_push(av, dir);
4502         dir = newSVsv(stem);
4503     } else {
4504         /* Truncate dir back to stem.  */
4505         SvCUR_set(dir, SvCUR(stem));
4506     }
4507     return dir;
4508 }
4509 #endif
4510
4511 STATIC SV *
4512 S_mayberelocate(pTHX_ const char *const dir, STRLEN len, U32 flags)
4513 {
4514     const U8 canrelocate = (U8)flags & INCPUSH_CAN_RELOCATE;
4515     SV *libdir;
4516
4517     PERL_ARGS_ASSERT_MAYBERELOCATE;
4518     assert(len > 0);
4519
4520     /* I am not convinced that this is valid when PERLLIB_MANGLE is
4521        defined to so something (in os2/os2.c), but the code has been
4522        this way, ignoring any possible changed of length, since
4523        760ac839baf413929cd31cc32ffd6dba6b781a81 (5.003_02) so I'll leave
4524        it be.  */
4525     libdir = newSVpvn(PERLLIB_MANGLE(dir, len), len);
4526
4527 #ifdef VMS
4528     {
4529         char *unix;
4530
4531         if ((unix = tounixspec_ts(SvPV(libdir,len),NULL)) != NULL) {
4532             len = strlen(unix);
4533             while (len > 1 && unix[len-1] == '/') len--;  /* Cosmetic */
4534             sv_usepvn(libdir,unix,len);
4535         }
4536         else
4537             PerlIO_printf(Perl_error_log,
4538                           "Failed to unixify @INC element \"%s\"\n",
4539                           SvPV_nolen_const(libdir));
4540     }
4541 #endif
4542
4543         /* Do the if() outside the #ifdef to avoid warnings about an unused
4544            parameter.  */
4545         if (canrelocate) {
4546 #ifdef PERL_RELOCATABLE_INC
4547         /*
4548          * Relocatable include entries are marked with a leading .../
4549          *
4550          * The algorithm is
4551          * 0: Remove that leading ".../"
4552          * 1: Remove trailing executable name (anything after the last '/')
4553          *    from the perl path to give a perl prefix
4554          * Then
4555          * While the @INC element starts "../" and the prefix ends with a real
4556          * directory (ie not . or ..) chop that real directory off the prefix
4557          * and the leading "../" from the @INC element. ie a logical "../"
4558          * cleanup
4559          * Finally concatenate the prefix and the remainder of the @INC element
4560          * The intent is that /usr/local/bin/perl and .../../lib/perl5
4561          * generates /usr/local/lib/perl5
4562          */
4563             const char *libpath = SvPVX(libdir);
4564             STRLEN libpath_len = SvCUR(libdir);
4565             if (libpath_len >= 4 && memEQ (libpath, ".../", 4)) {
4566                 /* Game on!  */
4567                 SV * const caret_X = get_sv("\030", 0);
4568                 /* Going to use the SV just as a scratch buffer holding a C
4569                    string:  */
4570                 SV *prefix_sv;
4571                 char *prefix;
4572                 char *lastslash;
4573
4574                 /* $^X is *the* source of taint if tainting is on, hence
4575                    SvPOK() won't be true.  */
4576                 assert(caret_X);
4577                 assert(SvPOKp(caret_X));
4578                 prefix_sv = newSVpvn_flags(SvPVX(caret_X), SvCUR(caret_X),
4579                                            SvUTF8(caret_X));
4580                 /* Firstly take off the leading .../
4581                    If all else fail we'll do the paths relative to the current
4582                    directory.  */
4583                 sv_chop(libdir, libpath + 4);
4584                 /* Don't use SvPV as we're intentionally bypassing taining,
4585                    mortal copies that the mg_get of tainting creates, and
4586                    corruption that seems to come via the save stack.
4587                    I guess that the save stack isn't correctly set up yet.  */
4588                 libpath = SvPVX(libdir);
4589                 libpath_len = SvCUR(libdir);
4590
4591                 /* This would work more efficiently with memrchr, but as it's
4592                    only a GNU extension we'd need to probe for it and
4593                    implement our own. Not hard, but maybe not worth it?  */
4594
4595                 prefix = SvPVX(prefix_sv);
4596                 lastslash = strrchr(prefix, '/');
4597
4598                 /* First time in with the *lastslash = '\0' we just wipe off
4599                    the trailing /perl from (say) /usr/foo/bin/perl
4600                 */
4601                 if (lastslash) {
4602                     SV *tempsv;
4603                     while ((*lastslash = '\0'), /* Do that, come what may.  */
4604                            (libpath_len >= 3 && memEQ(libpath, "../", 3)
4605                             && (lastslash = strrchr(prefix, '/')))) {
4606                         if (lastslash[1] == '\0'
4607                             || (lastslash[1] == '.'
4608                                 && (lastslash[2] == '/' /* ends "/."  */
4609                                     || (lastslash[2] == '/'
4610                                         && lastslash[3] == '/' /* or "/.."  */
4611                                         )))) {
4612                             /* Prefix ends "/" or "/." or "/..", any of which
4613                                are fishy, so don't do any more logical cleanup.
4614                             */
4615                             break;
4616                         }
4617                         /* Remove leading "../" from path  */
4618                         libpath += 3;
4619                         libpath_len -= 3;
4620                         /* Next iteration round the loop removes the last
4621                            directory name from prefix by writing a '\0' in
4622                            the while clause.  */
4623                     }
4624                     /* prefix has been terminated with a '\0' to the correct
4625                        length. libpath points somewhere into the libdir SV.
4626                        We need to join the 2 with '/' and drop the result into
4627                        libdir.  */
4628                     tempsv = Perl_newSVpvf(aTHX_ "%s/%s", prefix, libpath);
4629                     SvREFCNT_dec(libdir);
4630                     /* And this is the new libdir.  */
4631                     libdir = tempsv;
4632                     if (TAINTING_get &&
4633                         (PerlProc_getuid() != PerlProc_geteuid() ||
4634                          PerlProc_getgid() != PerlProc_getegid())) {
4635                         /* Need to taint relocated paths if running set ID  */
4636                         SvTAINTED_on(libdir);
4637                     }
4638                 }
4639                 SvREFCNT_dec(prefix_sv);
4640             }
4641 #endif
4642         }
4643     return libdir;
4644 }
4645
4646 STATIC void
4647 S_incpush(pTHX_ const char *const dir, STRLEN len, U32 flags)
4648 {
4649 #ifndef PERL_IS_MINIPERL
4650     const U8 using_sub_dirs
4651         = (U8)flags & (INCPUSH_ADD_VERSIONED_SUB_DIRS
4652                        |INCPUSH_ADD_ARCHONLY_SUB_DIRS|INCPUSH_ADD_OLD_VERS);
4653     const U8 add_versioned_sub_dirs
4654         = (U8)flags & INCPUSH_ADD_VERSIONED_SUB_DIRS;
4655     const U8 add_archonly_sub_dirs
4656         = (U8)flags & INCPUSH_ADD_ARCHONLY_SUB_DIRS;
4657 #ifdef PERL_INC_VERSION_LIST
4658     const U8 addoldvers  = (U8)flags & INCPUSH_ADD_OLD_VERS;
4659 #endif
4660 #endif
4661     const U8 unshift     = (U8)flags & INCPUSH_UNSHIFT;
4662     const U8 push_basedir = (flags & INCPUSH_NOT_BASEDIR) ? 0 : 1;
4663     AV *const inc = GvAVn(PL_incgv);
4664
4665     PERL_ARGS_ASSERT_INCPUSH;
4666     assert(len > 0);
4667
4668     /* Could remove this vestigial extra block, if we don't mind a lot of
4669        re-indenting diff noise.  */
4670     {
4671         SV *const libdir = mayberelocate(dir, len, flags);
4672         /* Change 20189146be79a0596543441fa369c6bf7f85103f, to fix RT#6665,
4673            arranged to unshift #! line -I onto the front of @INC. However,
4674            -I can add version and architecture specific libraries, and they
4675            need to go first. The old code assumed that it was always
4676            pushing. Hence to make it work, need to push the architecture
4677            (etc) libraries onto a temporary array, then "unshift" that onto
4678            the front of @INC.  */
4679 #ifndef PERL_IS_MINIPERL
4680         AV *const av = (using_sub_dirs) ? (unshift ? newAV() : inc) : NULL;
4681
4682         /*
4683          * BEFORE pushing libdir onto @INC we may first push version- and
4684          * archname-specific sub-directories.
4685          */
4686         if (using_sub_dirs) {
4687             SV *subdir = newSVsv(libdir);
4688 #ifdef PERL_INC_VERSION_LIST
4689             /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
4690             const char * const incverlist[] = { PERL_INC_VERSION_LIST };
4691             const char * const *incver;
4692 #endif
4693
4694             if (add_versioned_sub_dirs) {
4695                 /* .../version/archname if -d .../version/archname */
4696                 sv_catpvs(subdir, "/" PERL_FS_VERSION "/" ARCHNAME);
4697                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4698
4699                 /* .../version if -d .../version */
4700                 sv_catpvs(subdir, "/" PERL_FS_VERSION);
4701                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4702             }
4703
4704 #ifdef PERL_INC_VERSION_LIST
4705             if (addoldvers) {
4706                 for (incver = incverlist; *incver; incver++) {
4707                     /* .../xxx if -d .../xxx */
4708                     Perl_sv_catpvf(aTHX_ subdir, "/%s", *incver);
4709                     subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4710                 }
4711             }
4712 #endif
4713
4714             if (add_archonly_sub_dirs) {
4715                 /* .../archname if -d .../archname */
4716                 sv_catpvs(subdir, "/" ARCHNAME);
4717                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4718
4719             }
4720
4721             assert (SvREFCNT(subdir) == 1);
4722             SvREFCNT_dec(subdir);
4723         }
4724 #endif /* !PERL_IS_MINIPERL */
4725         /* finally add this lib directory at the end of @INC */
4726         if (unshift) {
4727 #ifdef PERL_IS_MINIPERL
4728             const Size_t extra = 0;
4729 #else
4730             Size_t extra = av_tindex(av) + 1;
4731 #endif
4732             av_unshift(inc, extra + push_basedir);
4733             if (push_basedir)
4734                 av_store(inc, extra, libdir);
4735 #ifndef PERL_IS_MINIPERL
4736             while (extra--) {
4737                 /* av owns a reference, av_store() expects to be donated a
4738                    reference, and av expects to be sane when it's cleared.
4739                    If I wanted to be naughty and wrong, I could peek inside the
4740                    implementation of av_clear(), realise that it uses
4741                    SvREFCNT_dec() too, so av's array could be a run of NULLs,
4742                    and so directly steal from it (with a memcpy() to inc, and
4743                    then memset() to NULL them out. But people copy code from the
4744                    core expecting it to be best practise, so let's use the API.
4745                    Although studious readers will note that I'm not checking any
4746                    return codes.  */
4747                 av_store(inc, extra, SvREFCNT_inc(*av_fetch(av, extra, FALSE)));
4748             }
4749             SvREFCNT_dec(av);
4750 #endif
4751         }
4752         else if (push_basedir) {
4753             av_push(inc, libdir);
4754         }
4755
4756         if (!push_basedir) {
4757             assert (SvREFCNT(libdir) == 1);
4758             SvREFCNT_dec(libdir);
4759         }
4760     }
4761 }
4762
4763 STATIC void
4764 S_incpush_use_sep(pTHX_ const char *p, STRLEN len, U32 flags)
4765 {
4766     const char *s;
4767     const char *end;
4768     /* This logic has been broken out from S_incpush(). It may be possible to
4769        simplify it.  */
4770
4771     PERL_ARGS_ASSERT_INCPUSH_USE_SEP;
4772
4773     /* perl compiled with -DPERL_RELOCATABLE_INCPUSH will ignore the len
4774      * argument to incpush_use_sep.  This allows creation of relocatable
4775      * Perl distributions that patch the binary at install time.  Those
4776      * distributions will have to provide their own relocation tools; this
4777      * is not a feature otherwise supported by core Perl.
4778      */
4779 #ifndef PERL_RELOCATABLE_INCPUSH
4780     if (!len)
4781 #endif
4782         len = strlen(p);
4783
4784     end = p + len;
4785
4786     /* Break at all separators */
4787     while ((s = (const char*)memchr(p, PERLLIB_SEP, end - p))) {
4788         if (s == p) {
4789             /* skip any consecutive separators */
4790
4791             /* Uncomment the next line for PATH semantics */
4792             /* But you'll need to write tests */
4793             /* av_push(GvAVn(PL_incgv), newSVpvs(".")); */
4794         } else {
4795             incpush(p, (STRLEN)(s - p), flags);
4796         }
4797         p = s + 1;
4798     }
4799     if (p != end)
4800         incpush(p, (STRLEN)(end - p), flags);
4801
4802 }
4803
4804 void
4805 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
4806 {
4807     SV *atsv;
4808     volatile const line_t oldline = PL_curcop ? CopLINE(PL_curcop) : 0;
4809     CV *cv;
4810     STRLEN len;
4811     int ret;
4812     dJMPENV;
4813
4814     PERL_ARGS_ASSERT_CALL_LIST;
4815
4816     while (av_tindex(paramList) >= 0) {
4817         cv = MUTABLE_CV(av_shift(paramList));
4818         if (PL_savebegin) {
4819             if (paramList == PL_beginav) {
4820                 /* save PL_beginav for compiler */
4821                 Perl_av_create_and_push(aTHX_ &PL_beginav_save, MUTABLE_SV(cv));
4822             }
4823             else if (paramList == PL_checkav) {
4824                 /* save PL_checkav for compiler */
4825                 Perl_av_create_and_push(aTHX_ &PL_checkav_save, MUTABLE_SV(cv));
4826             }
4827             else if (paramList == PL_unitcheckav) {
4828                 /* save PL_unitcheckav for compiler */
4829                 Perl_av_create_and_push(aTHX_ &PL_unitcheckav_save, MUTABLE_SV(cv));
4830             }
4831         } else {
4832             SAVEFREESV(cv);
4833         }
4834         JMPENV_PUSH(ret);
4835      &nbs