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