Move Math-BigRat from lib/ to ext/
[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_name);
1232     PL_psig_name = (SV**)NULL;
1233     PL_psig_ptr = (SV**)NULL;
1234     Safefree(PL_psig_pend);
1235     PL_psig_pend = (int*)NULL;
1236     {
1237         /* We need to NULL PL_psig_pend first, so that
1238            signal handlers know not to use it */
1239         int *psig_save = PL_psig_pend;
1240         PL_psig_pend = (int*)NULL;
1241         Safefree(psig_save);
1242     }
1243     PL_formfeed = NULL;
1244     nuke_stacks();
1245     PL_tainting = FALSE;
1246     PL_taint_warn = FALSE;
1247     PL_hints = 0;               /* Reset hints. Should hints be per-interpreter ? */
1248     PL_debug = 0;
1249
1250     DEBUG_P(debprofdump());
1251
1252 #ifdef USE_REENTRANT_API
1253     Perl_reentrant_free(aTHX);
1254 #endif
1255
1256     sv_free_arenas();
1257
1258     while (PL_regmatch_slab) {
1259         regmatch_slab  *s = PL_regmatch_slab;
1260         PL_regmatch_slab = PL_regmatch_slab->next;
1261         Safefree(s);
1262     }
1263
1264     /* As the absolutely last thing, free the non-arena SV for mess() */
1265
1266     if (PL_mess_sv) {
1267         /* we know that type == SVt_PVMG */
1268
1269         /* it could have accumulated taint magic */
1270         MAGIC* mg;
1271         MAGIC* moremagic;
1272         for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
1273             moremagic = mg->mg_moremagic;
1274             if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
1275                 && mg->mg_len >= 0)
1276                 Safefree(mg->mg_ptr);
1277             Safefree(mg);
1278         }
1279
1280         /* we know that type >= SVt_PV */
1281         SvPV_free(PL_mess_sv);
1282         Safefree(SvANY(PL_mess_sv));
1283         Safefree(PL_mess_sv);
1284         PL_mess_sv = NULL;
1285     }
1286     return STATUS_EXIT;
1287 }
1288
1289 /*
1290 =for apidoc perl_free
1291
1292 Releases a Perl interpreter.  See L<perlembed>.
1293
1294 =cut
1295 */
1296
1297 void
1298 perl_free(pTHXx)
1299 {
1300     dVAR;
1301
1302     PERL_ARGS_ASSERT_PERL_FREE;
1303
1304     if (PL_veto_cleanup)
1305         return;
1306
1307 #ifdef PERL_TRACK_MEMPOOL
1308     {
1309         /*
1310          * Don't free thread memory if PERL_DESTRUCT_LEVEL is set to a non-zero
1311          * value as we're probably hunting memory leaks then
1312          */
1313         const char * const s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL");
1314         if (!s || atoi(s) == 0) {
1315             const U32 old_debug = PL_debug;
1316             /* Emulate the PerlHost behaviour of free()ing all memory allocated in this
1317                thread at thread exit.  */
1318             if (DEBUG_m_TEST) {
1319                 PerlIO_puts(Perl_debug_log, "Disabling memory debugging as we "
1320                             "free this thread's memory\n");
1321                 PL_debug &= ~ DEBUG_m_FLAG;
1322             }
1323             while(aTHXx->Imemory_debug_header.next != &(aTHXx->Imemory_debug_header))
1324                 safesysfree(sTHX + (char *)(aTHXx->Imemory_debug_header.next));
1325             PL_debug = old_debug;
1326         }
1327     }
1328 #endif
1329
1330 #if defined(WIN32) || defined(NETWARE)
1331 #  if defined(PERL_IMPLICIT_SYS)
1332     {
1333 #    ifdef NETWARE
1334         void *host = nw_internal_host;
1335 #    else
1336         void *host = w32_internal_host;
1337 #    endif
1338         PerlMem_free(aTHXx);
1339 #    ifdef NETWARE
1340         nw_delete_internal_host(host);
1341 #    else
1342         win32_delete_internal_host(host);
1343 #    endif
1344     }
1345 #  else
1346     PerlMem_free(aTHXx);
1347 #  endif
1348 #else
1349     PerlMem_free(aTHXx);
1350 #endif
1351 }
1352
1353 #if defined(USE_ITHREADS)
1354 /* provide destructors to clean up the thread key when libperl is unloaded */
1355 #ifndef WIN32 /* handled during DLL_PROCESS_DETACH in win32/perllib.c */
1356
1357 #if defined(__hpux) && !(defined(__ux_version) && __ux_version <= 1020) && !defined(__GNUC__)
1358 #pragma fini "perl_fini"
1359 #elif defined(__sun) && !defined(__GNUC__)
1360 #pragma fini (perl_fini)
1361 #endif
1362
1363 static void
1364 #if defined(__GNUC__)
1365 __attribute__((destructor))
1366 #endif
1367 perl_fini(void)
1368 {
1369     dVAR;
1370     if (PL_curinterp  && !PL_veto_cleanup)
1371         FREE_THREAD_KEY;
1372 }
1373
1374 #endif /* WIN32 */
1375 #endif /* THREADS */
1376
1377 void
1378 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
1379 {
1380     dVAR;
1381     Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
1382     PL_exitlist[PL_exitlistlen].fn = fn;
1383     PL_exitlist[PL_exitlistlen].ptr = ptr;
1384     ++PL_exitlistlen;
1385 }
1386
1387 #ifdef HAS_PROCSELFEXE
1388 /* This is a function so that we don't hold on to MAXPATHLEN
1389    bytes of stack longer than necessary
1390  */
1391 STATIC void
1392 S_procself_val(pTHX_ SV *sv, const char *arg0)
1393 {
1394     char buf[MAXPATHLEN];
1395     int len = readlink(PROCSELFEXE_PATH, buf, sizeof(buf) - 1);
1396
1397     /* On Playstation2 Linux V1.0 (kernel 2.2.1) readlink(/proc/self/exe)
1398        includes a spurious NUL which will cause $^X to fail in system
1399        or backticks (this will prevent extensions from being built and
1400        many tests from working). readlink is not meant to add a NUL.
1401        Normal readlink works fine.
1402      */
1403     if (len > 0 && buf[len-1] == '\0') {
1404       len--;
1405     }
1406
1407     /* FreeBSD's implementation is acknowledged to be imperfect, sometimes
1408        returning the text "unknown" from the readlink rather than the path
1409        to the executable (or returning an error from the readlink).  Any valid
1410        path has a '/' in it somewhere, so use that to validate the result.
1411        See http://www.freebsd.org/cgi/query-pr.cgi?pr=35703
1412     */
1413     if (len > 0 && memchr(buf, '/', len)) {
1414         sv_setpvn(sv,buf,len);
1415     }
1416     else {
1417         sv_setpv(sv,arg0);
1418     }
1419 }
1420 #endif /* HAS_PROCSELFEXE */
1421
1422 STATIC void
1423 S_set_caret_X(pTHX) {
1424     dVAR;
1425     GV* tmpgv = gv_fetchpvs("\030", GV_ADD|GV_NOTQUAL, SVt_PV); /* $^X */
1426     if (tmpgv) {
1427 #ifdef HAS_PROCSELFEXE
1428         S_procself_val(aTHX_ GvSV(tmpgv), PL_origargv[0]);
1429 #else
1430 #ifdef OS2
1431         sv_setpv(GvSVn(tmpgv), os2_execname(aTHX));
1432 #else
1433         sv_setpv(GvSVn(tmpgv),PL_origargv[0]);
1434 #endif
1435 #endif
1436     }
1437 }
1438
1439 /*
1440 =for apidoc perl_parse
1441
1442 Tells a Perl interpreter to parse a Perl script.  See L<perlembed>.
1443
1444 =cut
1445 */
1446
1447 int
1448 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
1449 {
1450     dVAR;
1451     I32 oldscope;
1452     int ret;
1453     dJMPENV;
1454
1455     PERL_ARGS_ASSERT_PERL_PARSE;
1456 #ifndef MULTIPLICITY
1457     PERL_UNUSED_ARG(my_perl);
1458 #endif
1459
1460 #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT)
1461     /* [perl #22371] Algorimic Complexity Attack on Perl 5.6.1, 5.8.0
1462      * This MUST be done before any hash stores or fetches take place.
1463      * If you set PL_rehash_seed (and assumedly also PL_rehash_seed_set)
1464      * yourself, it is your responsibility to provide a good random seed!
1465      * You can also define PERL_HASH_SEED in compile time, see hv.h. */
1466     if (!PL_rehash_seed_set)
1467          PL_rehash_seed = get_hash_seed();
1468     {
1469         const char * const s = PerlEnv_getenv("PERL_HASH_SEED_DEBUG");
1470
1471         if (s && (atoi(s) == 1))
1472             PerlIO_printf(Perl_debug_log, "HASH_SEED = %"UVuf"\n", PL_rehash_seed);
1473     }
1474 #endif /* #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) */
1475
1476     PL_origargc = argc;
1477     PL_origargv = argv;
1478
1479     if (PL_origalen != 0) {
1480         PL_origalen = 1; /* don't use old PL_origalen if perl_parse() is called again */
1481     }
1482     else {
1483         /* Set PL_origalen be the sum of the contiguous argv[]
1484          * elements plus the size of the env in case that it is
1485          * contiguous with the argv[].  This is used in mg.c:Perl_magic_set()
1486          * as the maximum modifiable length of $0.  In the worst case
1487          * the area we are able to modify is limited to the size of
1488          * the original argv[0].  (See below for 'contiguous', though.)
1489          * --jhi */
1490          const char *s = NULL;
1491          int i;
1492          const UV mask =
1493            ~(UV)(PTRSIZE == 4 ? 3 : PTRSIZE == 8 ? 7 : PTRSIZE == 16 ? 15 : 0);
1494          /* Do the mask check only if the args seem like aligned. */
1495          const UV aligned =
1496            (mask < ~(UV)0) && ((PTR2UV(argv[0]) & mask) == PTR2UV(argv[0]));
1497
1498          /* See if all the arguments are contiguous in memory.  Note
1499           * that 'contiguous' is a loose term because some platforms
1500           * align the argv[] and the envp[].  If the arguments look
1501           * like non-aligned, assume that they are 'strictly' or
1502           * 'traditionally' contiguous.  If the arguments look like
1503           * aligned, we just check that they are within aligned
1504           * PTRSIZE bytes.  As long as no system has something bizarre
1505           * like the argv[] interleaved with some other data, we are
1506           * fine.  (Did I just evoke Murphy's Law?)  --jhi */
1507          if (PL_origargv && PL_origargc >= 1 && (s = PL_origargv[0])) {
1508               while (*s) s++;
1509               for (i = 1; i < PL_origargc; i++) {
1510                    if ((PL_origargv[i] == s + 1
1511 #ifdef OS2
1512                         || PL_origargv[i] == s + 2
1513 #endif 
1514                             )
1515                        ||
1516                        (aligned &&
1517                         (PL_origargv[i] >  s &&
1518                          PL_origargv[i] <=
1519                          INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1520                         )
1521                    {
1522                         s = PL_origargv[i];
1523                         while (*s) s++;
1524                    }
1525                    else
1526                         break;
1527               }
1528          }
1529
1530 #ifndef PERL_USE_SAFE_PUTENV
1531          /* Can we grab env area too to be used as the area for $0? */
1532          if (s && PL_origenviron && !PL_use_safe_putenv) {
1533               if ((PL_origenviron[0] == s + 1)
1534                   ||
1535                   (aligned &&
1536                    (PL_origenviron[0] >  s &&
1537                     PL_origenviron[0] <=
1538                     INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1539                  )
1540               {
1541 #ifndef OS2             /* ENVIRON is read by the kernel too. */
1542                    s = PL_origenviron[0];
1543                    while (*s) s++;
1544 #endif
1545                    my_setenv("NoNe  SuCh", NULL);
1546                    /* Force copy of environment. */
1547                    for (i = 1; PL_origenviron[i]; i++) {
1548                         if (PL_origenviron[i] == s + 1
1549                             ||
1550                             (aligned &&
1551                              (PL_origenviron[i] >  s &&
1552                               PL_origenviron[i] <=
1553                               INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1554                            )
1555                         {
1556                              s = PL_origenviron[i];
1557                              while (*s) s++;
1558                         }
1559                         else
1560                              break;
1561                    }
1562               }
1563          }
1564 #endif /* !defined(PERL_USE_SAFE_PUTENV) */
1565
1566          PL_origalen = s ? s - PL_origargv[0] + 1 : 0;
1567     }
1568
1569     if (PL_do_undump) {
1570
1571         /* Come here if running an undumped a.out. */
1572
1573         PL_origfilename = savepv(argv[0]);
1574         PL_do_undump = FALSE;
1575         cxstack_ix = -1;                /* start label stack again */
1576         init_ids();
1577         assert (!PL_tainted);
1578         TAINT;
1579         S_set_caret_X(aTHX);
1580         TAINT_NOT;
1581         init_postdump_symbols(argc,argv,env);
1582         return 0;
1583     }
1584
1585     if (PL_main_root) {
1586         op_free(PL_main_root);
1587         PL_main_root = NULL;
1588     }
1589     PL_main_start = NULL;
1590     SvREFCNT_dec(PL_main_cv);
1591     PL_main_cv = NULL;
1592
1593     time(&PL_basetime);
1594     oldscope = PL_scopestack_ix;
1595     PL_dowarn = G_WARN_OFF;
1596
1597     JMPENV_PUSH(ret);
1598     switch (ret) {
1599     case 0:
1600         parse_body(env,xsinit);
1601         if (PL_unitcheckav)
1602             call_list(oldscope, PL_unitcheckav);
1603         if (PL_checkav)
1604             call_list(oldscope, PL_checkav);
1605         ret = 0;
1606         break;
1607     case 1:
1608         STATUS_ALL_FAILURE;
1609         /* FALL THROUGH */
1610     case 2:
1611         /* my_exit() was called */
1612         while (PL_scopestack_ix > oldscope)
1613             LEAVE;
1614         FREETMPS;
1615         PL_curstash = PL_defstash;
1616         if (PL_unitcheckav)
1617             call_list(oldscope, PL_unitcheckav);
1618         if (PL_checkav)
1619             call_list(oldscope, PL_checkav);
1620         ret = STATUS_EXIT;
1621         break;
1622     case 3:
1623         PerlIO_printf(Perl_error_log, "panic: top_env\n");
1624         ret = 1;
1625         break;
1626     }
1627     JMPENV_POP;
1628     return ret;
1629 }
1630
1631 #define INCPUSH_UNSHIFT                 0x01
1632 #define INCPUSH_ADD_OLD_VERS            0x02
1633 #define INCPUSH_ADD_VERSIONED_SUB_DIRS  0x04
1634 #define INCPUSH_ADD_ARCHONLY_SUB_DIRS   0x08
1635 #define INCPUSH_NOT_BASEDIR             0x10
1636 #define INCPUSH_CAN_RELOCATE            0x20
1637 #define INCPUSH_ADD_SUB_DIRS    \
1638     (INCPUSH_ADD_VERSIONED_SUB_DIRS|INCPUSH_ADD_ARCHONLY_SUB_DIRS)
1639
1640 STATIC void *
1641 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
1642 {
1643     dVAR;
1644     PerlIO *rsfp;
1645     int argc = PL_origargc;
1646     char **argv = PL_origargv;
1647     const char *scriptname = NULL;
1648     VOL bool dosearch = FALSE;
1649     register char c;
1650     const char *cddir = NULL;
1651 #ifdef USE_SITECUSTOMIZE
1652     bool minus_f = FALSE;
1653 #endif
1654     SV *linestr_sv = newSV_type(SVt_PVIV);
1655     bool add_read_e_script = FALSE;
1656
1657     SvGROW(linestr_sv, 80);
1658     sv_setpvs(linestr_sv,"");
1659
1660     init_main_stash();
1661
1662     {
1663         const char *s;
1664     for (argc--,argv++; argc > 0; argc--,argv++) {
1665         if (argv[0][0] != '-' || !argv[0][1])
1666             break;
1667         s = argv[0]+1;
1668       reswitch:
1669         switch ((c = *s)) {
1670         case 'C':
1671 #ifndef PERL_STRICT_CR
1672         case '\r':
1673 #endif
1674         case ' ':
1675         case '0':
1676         case 'F':
1677         case 'a':
1678         case 'c':
1679         case 'd':
1680         case 'D':
1681         case 'h':
1682         case 'i':
1683         case 'l':
1684         case 'M':
1685         case 'm':
1686         case 'n':
1687         case 'p':
1688         case 's':
1689         case 'u':
1690         case 'U':
1691         case 'v':
1692         case 'W':
1693         case 'X':
1694         case 'w':
1695             if ((s = moreswitches(s)))
1696                 goto reswitch;
1697             break;
1698
1699         case 't':
1700             CHECK_MALLOC_TOO_LATE_FOR('t');
1701             if( !PL_tainting ) {
1702                  PL_taint_warn = TRUE;
1703                  PL_tainting = TRUE;
1704             }
1705             s++;
1706             goto reswitch;
1707         case 'T':
1708             CHECK_MALLOC_TOO_LATE_FOR('T');
1709             PL_tainting = TRUE;
1710             PL_taint_warn = FALSE;
1711             s++;
1712             goto reswitch;
1713
1714         case 'E':
1715             PL_minus_E = TRUE;
1716             /* FALL THROUGH */
1717         case 'e':
1718             forbid_setid('e', FALSE);
1719             if (!PL_e_script) {
1720                 PL_e_script = newSVpvs("");
1721                 add_read_e_script = TRUE;
1722             }
1723             if (*++s)
1724                 sv_catpv(PL_e_script, s);
1725             else if (argv[1]) {
1726                 sv_catpv(PL_e_script, argv[1]);
1727                 argc--,argv++;
1728             }
1729             else
1730                 Perl_croak(aTHX_ "No code specified for -%c", c);
1731             sv_catpvs(PL_e_script, "\n");
1732             break;
1733
1734         case 'f':
1735 #ifdef USE_SITECUSTOMIZE
1736             minus_f = TRUE;
1737 #endif
1738             s++;
1739             goto reswitch;
1740
1741         case 'I':       /* -I handled both here and in moreswitches() */
1742             forbid_setid('I', FALSE);
1743             if (!*++s && (s=argv[1]) != NULL) {
1744                 argc--,argv++;
1745             }
1746             if (s && *s) {
1747                 STRLEN len = strlen(s);
1748                 incpush(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS);
1749             }
1750             else
1751                 Perl_croak(aTHX_ "No directory specified for -I");
1752             break;
1753         case 'S':
1754             forbid_setid('S', FALSE);
1755             dosearch = TRUE;
1756             s++;
1757             goto reswitch;
1758         case 'V':
1759             {
1760                 SV *opts_prog;
1761
1762                 Perl_av_create_and_push(aTHX_ &PL_preambleav, newSVpvs("use Config;"));
1763                 if (*++s != ':')  {
1764                     /* Can't do newSVpvs() as that would involve pre-processor
1765                        condititionals inside a macro expansion.  */
1766                     opts_prog = Perl_newSVpv(aTHX_ "$_ = join ' ', sort qw("
1767 #  ifdef DEBUGGING
1768                              " DEBUGGING"
1769 #  endif
1770 #  ifdef NO_MATHOMS
1771                             " NO_MATHOMS"
1772 #  endif
1773 #  ifdef PERL_DISABLE_PMC
1774                              " PERL_DISABLE_PMC"
1775 #  endif
1776 #  ifdef PERL_DONT_CREATE_GVSV
1777                              " PERL_DONT_CREATE_GVSV"
1778 #  endif
1779 #  ifdef PERL_MALLOC_WRAP
1780                              " PERL_MALLOC_WRAP"
1781 #  endif
1782 #  ifdef PERL_MEM_LOG
1783                              " PERL_MEM_LOG"
1784 #  endif
1785 #  ifdef PERL_MEM_LOG_NOIMPL
1786                              " PERL_MEM_LOG_NOIMPL"
1787 #  endif
1788 #  ifdef PERL_USE_DEVEL
1789                              " PERL_USE_DEVEL"
1790 #  endif
1791 #  ifdef PERL_USE_SAFE_PUTENV
1792                              " PERL_USE_SAFE_PUTENV"
1793 #  endif
1794 #  ifdef USE_SITECUSTOMIZE
1795                              " USE_SITECUSTOMIZE"
1796 #  endif               
1797 #  ifdef USE_FAST_STDIO
1798                              " USE_FAST_STDIO"
1799 #  endif               
1800                                              , 0);
1801
1802                     sv_catpv(opts_prog, PL_bincompat_options);
1803                     /* Terminate the qw(, and then wrap at 76 columns.  */
1804                     sv_catpvs(opts_prog, "); s/(?=.{53})(.{1,53}) /$1\\n                        /mg;print Config::myconfig(),");
1805 #ifdef VMS
1806                     sv_catpvs(opts_prog,"\"\\nCharacteristics of this PERLSHR image: \\n");
1807 #else
1808                     sv_catpvs(opts_prog,"\"\\nCharacteristics of this binary (from libperl): \\n");
1809 #endif
1810                     sv_catpvs(opts_prog,"  Compile-time options: $_\\n\",");
1811
1812 #if defined(LOCAL_PATCH_COUNT)
1813                     if (LOCAL_PATCH_COUNT > 0) {
1814                         int i;
1815                         sv_catpvs(opts_prog,
1816                                  "\"  Locally applied patches:\\n\",");
1817                         for (i = 1; i <= LOCAL_PATCH_COUNT; i++) {
1818                             if (PL_localpatches[i])
1819                                 Perl_sv_catpvf(aTHX_ opts_prog,"q%c\t%s\n%c,",
1820                                     0, PL_localpatches[i], 0);
1821                         }
1822                     }
1823 #endif
1824                     Perl_sv_catpvf(aTHX_ opts_prog,
1825                                    "\"  Built under %s\\n",OSNAME);
1826 #ifdef __DATE__
1827 #  ifdef __TIME__
1828                     sv_catpvs(opts_prog,
1829                               "  Compiled at " __DATE__ " " __TIME__ "\\n\"");
1830 #  else
1831                     sv_catpvs(opts_prog, "  Compiled on " __DATE__ "\\n\"");
1832 #  endif
1833 #endif
1834                     sv_catpvs(opts_prog, "; $\"=\"\\n    \"; "
1835                              "@env = map { \"$_=\\\"$ENV{$_}\\\"\" } "
1836                              "sort grep {/^PERL/} keys %ENV; ");
1837 #ifdef __CYGWIN__
1838                     sv_catpvs(opts_prog,
1839                              "push @env, \"CYGWIN=\\\"$ENV{CYGWIN}\\\"\";");
1840 #endif
1841                     sv_catpvs(opts_prog, 
1842                              "print \"  \\%ENV:\\n    @env\\n\" if @env;"
1843                              "print \"  \\@INC:\\n    @INC\\n\";");
1844                 }
1845                 else {
1846                     ++s;
1847                     opts_prog = Perl_newSVpvf(aTHX_
1848                                               "Config::config_vars(qw%c%s%c)",
1849                                               0, s, 0);
1850                     s += strlen(s);
1851                 }
1852                 av_push(PL_preambleav, opts_prog);
1853                 /* don't look for script or read stdin */
1854                 scriptname = BIT_BUCKET;
1855                 goto reswitch;
1856             }
1857         case 'x':
1858             PL_doextract = TRUE;
1859             s++;
1860             if (*s)
1861                 cddir = s;
1862             break;
1863         case 0:
1864             break;
1865         case '-':
1866             if (!*++s || isSPACE(*s)) {
1867                 argc--,argv++;
1868                 goto switch_end;
1869             }
1870             /* catch use of gnu style long options */
1871             if (strEQ(s, "version")) {
1872                 s = (char *)"v";
1873                 goto reswitch;
1874             }
1875             if (strEQ(s, "help")) {
1876                 s = (char *)"h";
1877                 goto reswitch;
1878             }
1879             s--;
1880             /* FALL THROUGH */
1881         default:
1882             Perl_croak(aTHX_ "Unrecognized switch: -%s  (-h will show valid options)",s);
1883         }
1884     }
1885     }
1886
1887   switch_end:
1888
1889     {
1890         char *s;
1891
1892     if (
1893 #ifndef SECURE_INTERNAL_GETENV
1894         !PL_tainting &&
1895 #endif
1896         (s = PerlEnv_getenv("PERL5OPT")))
1897     {
1898         while (isSPACE(*s))
1899             s++;
1900         if (*s == '-' && *(s+1) == 'T') {
1901             CHECK_MALLOC_TOO_LATE_FOR('T');
1902             PL_tainting = TRUE;
1903             PL_taint_warn = FALSE;
1904         }
1905         else {
1906             char *popt_copy = NULL;
1907             while (s && *s) {
1908                 const char *d;
1909                 while (isSPACE(*s))
1910                     s++;
1911                 if (*s == '-') {
1912                     s++;
1913                     if (isSPACE(*s))
1914                         continue;
1915                 }
1916                 d = s;
1917                 if (!*s)
1918                     break;
1919                 if (!strchr("CDIMUdmtwW", *s))
1920                     Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
1921                 while (++s && *s) {
1922                     if (isSPACE(*s)) {
1923                         if (!popt_copy) {
1924                             popt_copy = SvPVX(sv_2mortal(newSVpv(d,0)));
1925                             s = popt_copy + (s - d);
1926                             d = popt_copy;
1927                         }
1928                         *s++ = '\0';
1929                         break;
1930                     }
1931                 }
1932                 if (*d == 't') {
1933                     if( !PL_tainting ) {
1934                         PL_taint_warn = TRUE;
1935                         PL_tainting = TRUE;
1936                     }
1937                 } else {
1938                     moreswitches(d);
1939                 }
1940             }
1941         }
1942     }
1943     }
1944
1945 #ifdef USE_SITECUSTOMIZE
1946     if (!minus_f) {
1947         (void)Perl_av_create_and_unshift_one(aTHX_ &PL_preambleav,
1948                                              Perl_newSVpvf(aTHX_ "BEGIN { do '%s/sitecustomize.pl' }", SITELIB_EXP));
1949     }
1950 #endif
1951
1952     if (!scriptname)
1953         scriptname = argv[0];
1954     if (PL_e_script) {
1955         argc++,argv--;
1956         scriptname = BIT_BUCKET;        /* don't look for script or read stdin */
1957     }
1958     else if (scriptname == NULL) {
1959 #ifdef MSDOS
1960         if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
1961             moreswitches("h");
1962 #endif
1963         scriptname = "-";
1964     }
1965
1966     /* Set $^X early so that it can be used for relocatable paths in @INC  */
1967     assert (!PL_tainted);
1968     TAINT;
1969     S_set_caret_X(aTHX);
1970     TAINT_NOT;
1971     init_perllib();
1972
1973     {
1974         bool suidscript = FALSE;
1975
1976         open_script(scriptname, dosearch, &suidscript, &rsfp);
1977
1978         validate_suid(validarg, scriptname, fdscript, suidscript,
1979                       linestr_sv, rsfp);
1980
1981 #ifndef PERL_MICRO
1982 #  if defined(SIGCHLD) || defined(SIGCLD)
1983         {
1984 #  ifndef SIGCHLD
1985 #    define SIGCHLD SIGCLD
1986 #  endif
1987             Sighandler_t sigstate = rsignal_state(SIGCHLD);
1988             if (sigstate == (Sighandler_t) SIG_IGN) {
1989                 if (ckWARN(WARN_SIGNAL))
1990                     Perl_warner(aTHX_ packWARN(WARN_SIGNAL),
1991                                 "Can't ignore signal CHLD, forcing to default");
1992                 (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
1993             }
1994         }
1995 #  endif
1996 #endif
1997
1998         if (PL_doextract) {
1999
2000             /* This will croak if suidscript is true, as -x cannot be used with
2001                setuid scripts.  */
2002             forbid_setid('x', suidscript);
2003             /* Hence you can't get here if suidscript is true */
2004
2005             find_beginning(linestr_sv, rsfp);
2006             if (cddir && PerlDir_chdir( (char *)cddir ) < 0)
2007                 Perl_croak(aTHX_ "Can't chdir to %s",cddir);
2008         }
2009     }
2010
2011     PL_main_cv = PL_compcv = MUTABLE_CV(newSV_type(SVt_PVCV));
2012     CvUNIQUE_on(PL_compcv);
2013
2014     CvPADLIST(PL_compcv) = pad_new(0);
2015
2016     PL_isarev = newHV();
2017
2018     boot_core_PerlIO();
2019     boot_core_UNIVERSAL();
2020     boot_core_mro();
2021
2022     if (xsinit)
2023         (*xsinit)(aTHX);        /* in case linked C routines want magical variables */
2024 #ifndef PERL_MICRO
2025 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(EPOC) || defined(SYMBIAN)
2026     init_os_extras();
2027 #endif
2028 #endif
2029
2030 #ifdef USE_SOCKS
2031 #   ifdef HAS_SOCKS5_INIT
2032     socks5_init(argv[0]);
2033 #   else
2034     SOCKSinit(argv[0]);
2035 #   endif
2036 #endif
2037
2038     init_predump_symbols();
2039     /* init_postdump_symbols not currently designed to be called */
2040     /* more than once (ENV isn't cleared first, for example)     */
2041     /* But running with -u leaves %ENV & @ARGV undefined!    XXX */
2042     if (!PL_do_undump)
2043         init_postdump_symbols(argc,argv,env);
2044
2045     /* PL_unicode is turned on by -C, or by $ENV{PERL_UNICODE},
2046      * or explicitly in some platforms.
2047      * locale.c:Perl_init_i18nl10n() if the environment
2048      * look like the user wants to use UTF-8. */
2049 #if defined(__SYMBIAN32__)
2050     PL_unicode = PERL_UNICODE_STD_FLAG; /* See PERL_SYMBIAN_CONSOLE_UTF8. */
2051 #endif
2052     if (PL_unicode) {
2053          /* Requires init_predump_symbols(). */
2054          if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
2055               IO* io;
2056               PerlIO* fp;
2057               SV* sv;
2058
2059               /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
2060                * and the default open disciplines. */
2061               if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
2062                   PL_stdingv  && (io = GvIO(PL_stdingv)) &&
2063                   (fp = IoIFP(io)))
2064                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2065               if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
2066                   PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
2067                   (fp = IoOFP(io)))
2068                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2069               if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
2070                   PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
2071                   (fp = IoOFP(io)))
2072                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2073               if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
2074                   (sv = GvSV(gv_fetchpvs("\017PEN", GV_ADD|GV_NOTQUAL,
2075                                          SVt_PV)))) {
2076                    U32 in  = PL_unicode & PERL_UNICODE_IN_FLAG;
2077                    U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
2078                    if (in) {
2079                         if (out)
2080                              sv_setpvs(sv, ":utf8\0:utf8");
2081                         else
2082                              sv_setpvs(sv, ":utf8\0");
2083                    }
2084                    else if (out)
2085                         sv_setpvs(sv, "\0:utf8");
2086                    SvSETMAGIC(sv);
2087               }
2088          }
2089     }
2090
2091     {
2092         const char *s;
2093     if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
2094          if (strEQ(s, "unsafe"))
2095               PL_signals |=  PERL_SIGNALS_UNSAFE_FLAG;
2096          else if (strEQ(s, "safe"))
2097               PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
2098          else
2099               Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
2100     }
2101     }
2102
2103 #ifdef PERL_MAD
2104     {
2105         const char *s;
2106     if ((s = PerlEnv_getenv("PERL_XMLDUMP"))) {
2107         PL_madskills = 1;
2108         PL_minus_c = 1;
2109         if (!s || !s[0])
2110             PL_xmlfp = PerlIO_stdout();
2111         else {
2112             PL_xmlfp = PerlIO_open(s, "w");
2113             if (!PL_xmlfp)
2114                 Perl_croak(aTHX_ "Can't open %s", s);
2115         }
2116         my_setenv("PERL_XMLDUMP", NULL);        /* hide from subprocs */
2117     }
2118     }
2119
2120     {
2121         const char *s;
2122     if ((s = PerlEnv_getenv("PERL_MADSKILLS"))) {
2123         PL_madskills = atoi(s);
2124         my_setenv("PERL_MADSKILLS", NULL);      /* hide from subprocs */
2125     }
2126     }
2127 #endif
2128
2129     lex_start(linestr_sv, rsfp, TRUE);
2130     PL_subname = newSVpvs("main");
2131
2132     if (add_read_e_script)
2133         filter_add(read_e_script, NULL);
2134
2135     /* now parse the script */
2136
2137     SETERRNO(0,SS_NORMAL);
2138     if (yyparse() || PL_parser->error_count) {
2139         if (PL_minus_c)
2140             Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
2141         else {
2142             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
2143                        PL_origfilename);
2144         }
2145     }
2146     CopLINE_set(PL_curcop, 0);
2147     PL_curstash = PL_defstash;
2148     if (PL_e_script) {
2149         SvREFCNT_dec(PL_e_script);
2150         PL_e_script = NULL;
2151     }
2152
2153     if (PL_do_undump)
2154         my_unexec();
2155
2156     if (isWARN_ONCE) {
2157         SAVECOPFILE(PL_curcop);
2158         SAVECOPLINE(PL_curcop);
2159         gv_check(PL_defstash);
2160     }
2161
2162     LEAVE;
2163     FREETMPS;
2164
2165 #ifdef MYMALLOC
2166     {
2167         const char *s;
2168     if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && atoi(s) >= 2)
2169         dump_mstats("after compilation:");
2170     }
2171 #endif
2172
2173     ENTER;
2174     PL_restartop = 0;
2175     return NULL;
2176 }
2177
2178 /*
2179 =for apidoc perl_run
2180
2181 Tells a Perl interpreter to run.  See L<perlembed>.
2182
2183 =cut
2184 */
2185
2186 int
2187 perl_run(pTHXx)
2188 {
2189     dVAR;
2190     I32 oldscope;
2191     int ret = 0;
2192     dJMPENV;
2193
2194     PERL_ARGS_ASSERT_PERL_RUN;
2195 #ifndef MULTIPLICITY
2196     PERL_UNUSED_ARG(my_perl);
2197 #endif
2198
2199     oldscope = PL_scopestack_ix;
2200 #ifdef VMS
2201     VMSISH_HUSHED = 0;
2202 #endif
2203
2204     JMPENV_PUSH(ret);
2205     switch (ret) {
2206     case 1:
2207         cxstack_ix = -1;                /* start context stack again */
2208         goto redo_body;
2209     case 0:                             /* normal completion */
2210  redo_body:
2211         run_body(oldscope);
2212         /* FALL THROUGH */
2213     case 2:                             /* my_exit() */
2214         while (PL_scopestack_ix > oldscope)
2215             LEAVE;
2216         FREETMPS;
2217         PL_curstash = PL_defstash;
2218         if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
2219             PL_endav && !PL_minus_c)
2220             call_list(oldscope, PL_endav);
2221 #ifdef MYMALLOC
2222         if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
2223             dump_mstats("after execution:  ");
2224 #endif
2225         ret = STATUS_EXIT;
2226         break;
2227     case 3:
2228         if (PL_restartop) {
2229             POPSTACK_TO(PL_mainstack);
2230             goto redo_body;
2231         }
2232         PerlIO_printf(Perl_error_log, "panic: restartop\n");
2233         FREETMPS;
2234         ret = 1;
2235         break;
2236     }
2237
2238     JMPENV_POP;
2239     return ret;
2240 }
2241
2242 STATIC void
2243 S_run_body(pTHX_ I32 oldscope)
2244 {
2245     dVAR;
2246     DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support.\n",
2247                     PL_sawampersand ? "Enabling" : "Omitting"));
2248
2249     if (!PL_restartop) {
2250 #ifdef PERL_MAD
2251         if (PL_xmlfp) {
2252             xmldump_all();
2253             exit(0);    /* less likely to core dump than my_exit(0) */
2254         }
2255 #endif
2256 #ifdef DEBUGGING
2257         if (DEBUG_x_TEST || DEBUG_B_TEST)
2258             dump_all_perl(!DEBUG_B_TEST);
2259         if (!DEBUG_q_TEST)
2260           PERL_DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
2261 #endif
2262
2263         if (PL_minus_c) {
2264             PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
2265             my_exit(0);
2266         }
2267         if (PERLDB_SINGLE && PL_DBsingle)
2268             sv_setiv(PL_DBsingle, 1);
2269         if (PL_initav)
2270             call_list(oldscope, PL_initav);
2271 #ifdef PERL_DEBUG_READONLY_OPS
2272         Perl_pending_Slabs_to_ro(aTHX);
2273 #endif
2274     }
2275
2276     /* do it */
2277
2278     if (PL_restartop) {
2279         PL_op = PL_restartop;
2280         PL_restartop = 0;
2281         CALLRUNOPS(aTHX);
2282     }
2283     else if (PL_main_start) {
2284         CvDEPTH(PL_main_cv) = 1;
2285         PL_op = PL_main_start;
2286         CALLRUNOPS(aTHX);
2287     }
2288     my_exit(0);
2289     /* NOTREACHED */
2290 }
2291
2292 /*
2293 =head1 SV Manipulation Functions
2294
2295 =for apidoc p||get_sv
2296
2297 Returns the SV of the specified Perl scalar.  C<flags> are passed to
2298 C<gv_fetchpv>. If C<GV_ADD> is set and the
2299 Perl variable does not exist then it will be created.  If C<flags> is zero
2300 and the variable does not exist then NULL is returned.
2301
2302 =cut
2303 */
2304
2305 SV*
2306 Perl_get_sv(pTHX_ const char *name, I32 flags)
2307 {
2308     GV *gv;
2309
2310     PERL_ARGS_ASSERT_GET_SV;
2311
2312     gv = gv_fetchpv(name, flags, SVt_PV);
2313     if (gv)
2314         return GvSV(gv);
2315     return NULL;
2316 }
2317
2318 /*
2319 =head1 Array Manipulation Functions
2320
2321 =for apidoc p||get_av
2322
2323 Returns the AV of the specified Perl array.  C<flags> are passed to
2324 C<gv_fetchpv>. If C<GV_ADD> is set and the
2325 Perl variable does not exist then it will be created.  If C<flags> is zero
2326 and the variable does not exist then NULL is returned.
2327
2328 =cut
2329 */
2330
2331 AV*
2332 Perl_get_av(pTHX_ const char *name, I32 flags)
2333 {
2334     GV* const gv = gv_fetchpv(name, flags, SVt_PVAV);
2335
2336     PERL_ARGS_ASSERT_GET_AV;
2337
2338     if (flags)
2339         return GvAVn(gv);
2340     if (gv)
2341         return GvAV(gv);
2342     return NULL;
2343 }
2344
2345 /*
2346 =head1 Hash Manipulation Functions
2347
2348 =for apidoc p||get_hv
2349
2350 Returns the HV of the specified Perl hash.  C<flags> are passed to
2351 C<gv_fetchpv>. If C<GV_ADD> is set and the
2352 Perl variable does not exist then it will be created.  If C<flags> is zero
2353 and the variable does not exist then NULL is returned.
2354
2355 =cut
2356 */
2357
2358 HV*
2359 Perl_get_hv(pTHX_ const char *name, I32 flags)
2360 {
2361     GV* const gv = gv_fetchpv(name, flags, SVt_PVHV);
2362
2363     PERL_ARGS_ASSERT_GET_HV;
2364
2365     if (flags)
2366         return GvHVn(gv);
2367     if (gv)
2368         return GvHV(gv);
2369     return NULL;
2370 }
2371
2372 /*
2373 =head1 CV Manipulation Functions
2374
2375 =for apidoc p||get_cvn_flags
2376
2377 Returns the CV of the specified Perl subroutine.  C<flags> are passed to
2378 C<gv_fetchpvn_flags>. If C<GV_ADD> is set and the Perl subroutine does not
2379 exist then it will be declared (which has the same effect as saying
2380 C<sub name;>).  If C<GV_ADD> is not set and the subroutine does not exist
2381 then NULL is returned.
2382
2383 =for apidoc p||get_cv
2384
2385 Uses C<strlen> to get the length of C<name>, then calls C<get_cvn_flags>.
2386
2387 =cut
2388 */
2389
2390 CV*
2391 Perl_get_cvn_flags(pTHX_ const char *name, STRLEN len, I32 flags)
2392 {
2393     GV* const gv = gv_fetchpvn_flags(name, len, flags, SVt_PVCV);
2394     /* XXX this is probably not what they think they're getting.
2395      * It has the same effect as "sub name;", i.e. just a forward
2396      * declaration! */
2397
2398     PERL_ARGS_ASSERT_GET_CVN_FLAGS;
2399
2400     if ((flags & ~GV_NOADD_MASK) && !GvCVu(gv)) {
2401         SV *const sv = newSVpvn_flags(name, len, flags & SVf_UTF8);
2402         return newSUB(start_subparse(FALSE, 0),
2403                       newSVOP(OP_CONST, 0, sv),
2404                       NULL, NULL);
2405     }
2406     if (gv)
2407         return GvCVu(gv);
2408     return NULL;
2409 }
2410
2411 /* Nothing in core calls this now, but we can't replace it with a macro and
2412    move it to mathoms.c as a macro would evaluate name twice.  */
2413 CV*
2414 Perl_get_cv(pTHX_ const char *name, I32 flags)
2415 {
2416     PERL_ARGS_ASSERT_GET_CV;
2417
2418     return get_cvn_flags(name, strlen(name), flags);
2419 }
2420
2421 /* Be sure to refetch the stack pointer after calling these routines. */
2422
2423 /*
2424
2425 =head1 Callback Functions
2426
2427 =for apidoc p||call_argv
2428
2429 Performs a callback to the specified Perl sub.  See L<perlcall>.
2430
2431 =cut
2432 */
2433
2434 I32
2435 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, register char **argv)
2436
2437                         /* See G_* flags in cop.h */
2438                         /* null terminated arg list */
2439 {
2440     dVAR;
2441     dSP;
2442
2443     PERL_ARGS_ASSERT_CALL_ARGV;
2444
2445     PUSHMARK(SP);
2446     if (argv) {
2447         while (*argv) {
2448             mXPUSHs(newSVpv(*argv,0));
2449             argv++;
2450         }
2451         PUTBACK;
2452     }
2453     return call_pv(sub_name, flags);
2454 }
2455
2456 /*
2457 =for apidoc p||call_pv
2458
2459 Performs a callback to the specified Perl sub.  See L<perlcall>.
2460
2461 =cut
2462 */
2463
2464 I32
2465 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
2466                         /* name of the subroutine */
2467                         /* See G_* flags in cop.h */
2468 {
2469     PERL_ARGS_ASSERT_CALL_PV;
2470
2471     return call_sv(MUTABLE_SV(get_cv(sub_name, GV_ADD)), flags);
2472 }
2473
2474 /*
2475 =for apidoc p||call_method
2476
2477 Performs a callback to the specified Perl method.  The blessed object must
2478 be on the stack.  See L<perlcall>.
2479
2480 =cut
2481 */
2482
2483 I32
2484 Perl_call_method(pTHX_ const char *methname, I32 flags)
2485                         /* name of the subroutine */
2486                         /* See G_* flags in cop.h */
2487 {
2488     STRLEN len;
2489     PERL_ARGS_ASSERT_CALL_METHOD;
2490
2491     len = strlen(methname);
2492
2493     /* XXX: sv_2mortal(newSVpvn_share(methname, len)) can be faster */
2494     return call_sv(newSVpvn_flags(methname, len, SVs_TEMP), flags | G_METHOD);
2495 }
2496
2497 /* May be called with any of a CV, a GV, or an SV containing the name. */
2498 /*
2499 =for apidoc p||call_sv
2500
2501 Performs a callback to the Perl sub whose name is in the SV.  See
2502 L<perlcall>.
2503
2504 =cut
2505 */
2506
2507 I32
2508 Perl_call_sv(pTHX_ SV *sv, VOL I32 flags)
2509                         /* See G_* flags in cop.h */
2510 {
2511     dVAR; dSP;
2512     LOGOP myop;         /* fake syntax tree node */
2513     UNOP method_op;
2514     I32 oldmark;
2515     VOL I32 retval = 0;
2516     I32 oldscope;
2517     bool oldcatch = CATCH_GET;
2518     int ret;
2519     OP* const oldop = PL_op;
2520     dJMPENV;
2521
2522     PERL_ARGS_ASSERT_CALL_SV;
2523
2524     if (flags & G_DISCARD) {
2525         ENTER;
2526         SAVETMPS;
2527     }
2528     if (!(flags & G_WANT)) {
2529         /* Backwards compatibility - as G_SCALAR was 0, it could be omitted.
2530          */
2531         flags |= G_SCALAR;
2532     }
2533
2534     Zero(&myop, 1, LOGOP);
2535     myop.op_next = NULL;
2536     if (!(flags & G_NOARGS))
2537         myop.op_flags |= OPf_STACKED;
2538     myop.op_flags |= OP_GIMME_REVERSE(flags);
2539     SAVEOP();
2540     PL_op = (OP*)&myop;
2541
2542     EXTEND(PL_stack_sp, 1);
2543     *++PL_stack_sp = sv;
2544     oldmark = TOPMARK;
2545     oldscope = PL_scopestack_ix;
2546
2547     if (PERLDB_SUB && PL_curstash != PL_debstash
2548            /* Handle first BEGIN of -d. */
2549           && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
2550            /* Try harder, since this may have been a sighandler, thus
2551             * curstash may be meaningless. */
2552           && (SvTYPE(sv) != SVt_PVCV || CvSTASH((const CV *)sv) != PL_debstash)
2553           && !(flags & G_NODEBUG))
2554         PL_op->op_private |= OPpENTERSUB_DB;
2555
2556     if (flags & G_METHOD) {
2557         Zero(&method_op, 1, UNOP);
2558         method_op.op_next = PL_op;
2559         method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
2560         method_op.op_type = OP_METHOD;
2561         myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
2562         myop.op_type = OP_ENTERSUB;
2563         PL_op = (OP*)&method_op;
2564     }
2565
2566     if (!(flags & G_EVAL)) {
2567         CATCH_SET(TRUE);
2568         CALL_BODY_SUB((OP*)&myop);
2569         retval = PL_stack_sp - (PL_stack_base + oldmark);
2570         CATCH_SET(oldcatch);
2571     }
2572     else {
2573         myop.op_other = (OP*)&myop;
2574         PL_markstack_ptr--;
2575         create_eval_scope(flags|G_FAKINGEVAL);
2576         PL_markstack_ptr++;
2577
2578         JMPENV_PUSH(ret);
2579
2580         switch (ret) {
2581         case 0:
2582  redo_body:
2583             CALL_BODY_SUB((OP*)&myop);
2584             retval = PL_stack_sp - (PL_stack_base + oldmark);
2585             if (!(flags & G_KEEPERR)) {
2586                 CLEAR_ERRSV();
2587             }
2588             break;
2589         case 1:
2590             STATUS_ALL_FAILURE;
2591             /* FALL THROUGH */
2592         case 2:
2593             /* my_exit() was called */
2594             PL_curstash = PL_defstash;
2595             FREETMPS;
2596             JMPENV_POP;
2597             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2598                 Perl_croak(aTHX_ "Callback called exit");
2599             my_exit_jump();
2600             /* NOTREACHED */
2601         case 3:
2602             if (PL_restartop) {
2603                 PL_op = PL_restartop;
2604                 PL_restartop = 0;
2605                 goto redo_body;
2606             }
2607             PL_stack_sp = PL_stack_base + oldmark;
2608             if ((flags & G_WANT) == G_ARRAY)
2609                 retval = 0;
2610             else {
2611                 retval = 1;
2612                 *++PL_stack_sp = &PL_sv_undef;
2613             }
2614             break;
2615         }
2616
2617         if (PL_scopestack_ix > oldscope)
2618             delete_eval_scope();
2619         JMPENV_POP;
2620     }
2621
2622     if (flags & G_DISCARD) {
2623         PL_stack_sp = PL_stack_base + oldmark;
2624         retval = 0;
2625         FREETMPS;
2626         LEAVE;
2627     }
2628     PL_op = oldop;
2629     return retval;
2630 }
2631
2632 /* Eval a string. The G_EVAL flag is always assumed. */
2633
2634 /*
2635 =for apidoc p||eval_sv
2636
2637 Tells Perl to C<eval> the string in the SV.
2638
2639 =cut
2640 */
2641
2642 I32
2643 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
2644
2645                         /* See G_* flags in cop.h */
2646 {
2647     dVAR;
2648     dSP;
2649     UNOP myop;          /* fake syntax tree node */
2650     VOL I32 oldmark = SP - PL_stack_base;
2651     VOL I32 retval = 0;
2652     int ret;
2653     OP* const oldop = PL_op;
2654     dJMPENV;
2655
2656     PERL_ARGS_ASSERT_EVAL_SV;
2657
2658     if (flags & G_DISCARD) {
2659         ENTER;
2660         SAVETMPS;
2661     }
2662
2663     SAVEOP();
2664     PL_op = (OP*)&myop;
2665     Zero(PL_op, 1, UNOP);
2666     EXTEND(PL_stack_sp, 1);
2667     *++PL_stack_sp = sv;
2668
2669     if (!(flags & G_NOARGS))
2670         myop.op_flags = OPf_STACKED;
2671     myop.op_next = NULL;
2672     myop.op_type = OP_ENTEREVAL;
2673     myop.op_flags |= OP_GIMME_REVERSE(flags);
2674     if (flags & G_KEEPERR)
2675         myop.op_flags |= OPf_SPECIAL;
2676
2677     /* fail now; otherwise we could fail after the JMPENV_PUSH but
2678      * before a PUSHEVAL, which corrupts the stack after a croak */
2679     TAINT_PROPER("eval_sv()");
2680
2681     JMPENV_PUSH(ret);
2682     switch (ret) {
2683     case 0:
2684  redo_body:
2685         CALL_BODY_EVAL((OP*)&myop);
2686         retval = PL_stack_sp - (PL_stack_base + oldmark);
2687         if (!(flags & G_KEEPERR)) {
2688             CLEAR_ERRSV();
2689         }
2690         break;
2691     case 1:
2692         STATUS_ALL_FAILURE;
2693         /* FALL THROUGH */
2694     case 2:
2695         /* my_exit() was called */
2696         PL_curstash = PL_defstash;
2697         FREETMPS;
2698         JMPENV_POP;
2699         if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2700             Perl_croak(aTHX_ "Callback called exit");
2701         my_exit_jump();
2702         /* NOTREACHED */
2703     case 3:
2704         if (PL_restartop) {
2705             PL_op = PL_restartop;
2706             PL_restartop = 0;
2707             goto redo_body;
2708         }
2709         PL_stack_sp = PL_stack_base + oldmark;
2710         if ((flags & G_WANT) == G_ARRAY)
2711             retval = 0;
2712         else {
2713             retval = 1;
2714             *++PL_stack_sp = &PL_sv_undef;
2715         }
2716         break;
2717     }
2718
2719     JMPENV_POP;
2720     if (flags & G_DISCARD) {
2721         PL_stack_sp = PL_stack_base + oldmark;
2722         retval = 0;
2723         FREETMPS;
2724         LEAVE;
2725     }
2726     PL_op = oldop;
2727     return retval;
2728 }
2729
2730 /*
2731 =for apidoc p||eval_pv
2732
2733 Tells Perl to C<eval> the given string and return an SV* result.
2734
2735 =cut
2736 */
2737
2738 SV*
2739 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
2740 {
2741     dVAR;
2742     dSP;
2743     SV* sv = newSVpv(p, 0);
2744
2745     PERL_ARGS_ASSERT_EVAL_PV;
2746
2747     eval_sv(sv, G_SCALAR);
2748     SvREFCNT_dec(sv);
2749
2750     SPAGAIN;
2751     sv = POPs;
2752     PUTBACK;
2753
2754     if (croak_on_error && SvTRUE(ERRSV)) {
2755         Perl_croak(aTHX_ "%s", SvPVx_nolen_const(ERRSV));
2756     }
2757
2758     return sv;
2759 }
2760
2761 /* Require a module. */
2762
2763 /*
2764 =head1 Embedding Functions
2765
2766 =for apidoc p||require_pv
2767
2768 Tells Perl to C<require> the file named by the string argument.  It is
2769 analogous to the Perl code C<eval "require '$file'">.  It's even
2770 implemented that way; consider using load_module instead.
2771
2772 =cut */
2773
2774 void
2775 Perl_require_pv(pTHX_ const char *pv)
2776 {
2777     dVAR;
2778     dSP;
2779     SV* sv;
2780
2781     PERL_ARGS_ASSERT_REQUIRE_PV;
2782
2783     PUSHSTACKi(PERLSI_REQUIRE);
2784     PUTBACK;
2785     sv = Perl_newSVpvf(aTHX_ "require q%c%s%c", 0, pv, 0);
2786     eval_sv(sv_2mortal(sv), G_DISCARD);
2787     SPAGAIN;
2788     POPSTACK;
2789 }
2790
2791 STATIC void
2792 S_usage(pTHX_ const char *name)         /* XXX move this out into a module ? */
2793 {
2794     /* This message really ought to be max 23 lines.
2795      * Removed -h because the user already knows that option. Others? */
2796
2797     static const char * const usage_msg[] = {
2798 "-0[octal]         specify record separator (\\0, if no argument)",
2799 "-a                autosplit mode with -n or -p (splits $_ into @F)",
2800 "-C[number/list]   enables the listed Unicode features",
2801 "-c                check syntax only (runs BEGIN and CHECK blocks)",
2802 "-d[:debugger]     run program under debugger",
2803 "-D[number/list]   set debugging flags (argument is a bit mask or alphabets)",
2804 "-e program        one line of program (several -e's allowed, omit programfile)",
2805 "-E program        like -e, but enables all optional features",
2806 "-f                don't do $sitelib/sitecustomize.pl at startup",
2807 "-F/pattern/       split() pattern for -a switch (//'s are optional)",
2808 "-i[extension]     edit <> files in place (makes backup if extension supplied)",
2809 "-Idirectory       specify @INC/#include directory (several -I's allowed)",
2810 "-l[octal]         enable line ending processing, specifies line terminator",
2811 "-[mM][-]module    execute \"use/no module...\" before executing program",
2812 "-n                assume \"while (<>) { ... }\" loop around program",
2813 "-p                assume loop like -n but print line also, like sed",
2814 "-s                enable rudimentary parsing for switches after programfile",
2815 "-S                look for programfile using PATH environment variable",
2816 "-t                enable tainting warnings",
2817 "-T                enable tainting checks",
2818 "-u                dump core after parsing program",
2819 "-U                allow unsafe operations",
2820 "-v                print version, subversion (includes VERY IMPORTANT perl info)",
2821 "-V[:variable]     print configuration summary (or a single Config.pm variable)",
2822 "-w                enable many useful warnings (RECOMMENDED)",
2823 "-W                enable all warnings",
2824 "-x[directory]     strip off text before #!perl line and perhaps cd to directory",
2825 "-X                disable all warnings",
2826 "\n",
2827 NULL
2828 };
2829     const char * const *p = usage_msg;
2830
2831     PERL_ARGS_ASSERT_USAGE;
2832
2833     PerlIO_printf(PerlIO_stdout(),
2834                   "\nUsage: %s [switches] [--] [programfile] [arguments]",
2835                   name);
2836     while (*p)
2837         PerlIO_printf(PerlIO_stdout(), "\n  %s", *p++);
2838 }
2839
2840 /* convert a string of -D options (or digits) into an int.
2841  * sets *s to point to the char after the options */
2842
2843 #ifdef DEBUGGING
2844 int
2845 Perl_get_debug_opts(pTHX_ const char **s, bool givehelp)
2846 {
2847     static const char * const usage_msgd[] = {
2848       " Debugging flag values: (see also -d)",
2849       "  p  Tokenizing and parsing (with v, displays parse stack)",
2850       "  s  Stack snapshots (with v, displays all stacks)",
2851       "  l  Context (loop) stack processing",
2852       "  t  Trace execution",
2853       "  o  Method and overloading resolution",
2854       "  c  String/numeric conversions",
2855       "  P  Print profiling info, source file input state",
2856       "  m  Memory and SV allocation",
2857       "  f  Format processing",
2858       "  r  Regular expression parsing and execution",
2859       "  x  Syntax tree dump",
2860       "  u  Tainting checks",
2861       "  H  Hash dump -- usurps values()",
2862       "  X  Scratchpad allocation",
2863       "  D  Cleaning up",
2864       "  T  Tokenising",
2865       "  R  Include reference counts of dumped variables (eg when using -Ds)",
2866       "  J  Do not s,t,P-debug (Jump over) opcodes within package DB",
2867       "  v  Verbose: use in conjunction with other flags",
2868       "  C  Copy On Write",
2869       "  A  Consistency checks on internal structures",
2870       "  q  quiet - currently only suppresses the 'EXECUTING' message",
2871       "  M  trace smart match resolution",
2872       "  B  dump suBroutine definitions, including special Blocks like BEGIN",
2873       NULL
2874     };
2875     int i = 0;
2876
2877     PERL_ARGS_ASSERT_GET_DEBUG_OPTS;
2878
2879     if (isALPHA(**s)) {
2880         /* if adding extra options, remember to update DEBUG_MASK */
2881         static const char debopts[] = "psltocPmfrxuUHXDSTRJvCAqMB";
2882
2883         for (; isALNUM(**s); (*s)++) {
2884             const char * const d = strchr(debopts,**s);
2885             if (d)
2886                 i |= 1 << (d - debopts);
2887             else if (ckWARN_d(WARN_DEBUGGING))
2888                 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2889                     "invalid option -D%c, use -D'' to see choices\n", **s);
2890         }
2891     }
2892     else if (isDIGIT(**s)) {
2893         i = atoi(*s);
2894         for (; isALNUM(**s); (*s)++) ;
2895     }
2896     else if (givehelp) {
2897       const char *const *p = usage_msgd;
2898       while (*p) PerlIO_printf(PerlIO_stdout(), "%s\n", *p++);
2899     }
2900 #  ifdef EBCDIC
2901     if ((i & DEBUG_p_FLAG) && ckWARN_d(WARN_DEBUGGING))
2902         Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2903                 "-Dp not implemented on this platform\n");
2904 #  endif
2905     return i;
2906 }
2907 #endif
2908
2909 /* This routine handles any switches that can be given during run */
2910
2911 const char *
2912 Perl_moreswitches(pTHX_ const char *s)
2913 {
2914     dVAR;
2915     UV rschar;
2916     const char option = *s; /* used to remember option in -m/-M code */
2917
2918     PERL_ARGS_ASSERT_MORESWITCHES;
2919
2920     switch (*s) {
2921     case '0':
2922     {
2923          I32 flags = 0;
2924          STRLEN numlen;
2925
2926          SvREFCNT_dec(PL_rs);
2927          if (s[1] == 'x' && s[2]) {
2928               const char *e = s+=2;
2929               U8 *tmps;
2930
2931               while (*e)
2932                 e++;
2933               numlen = e - s;
2934               flags = PERL_SCAN_SILENT_ILLDIGIT;
2935               rschar = (U32)grok_hex(s, &numlen, &flags, NULL);
2936               if (s + numlen < e) {
2937                    rschar = 0; /* Grandfather -0xFOO as -0 -xFOO. */
2938                    numlen = 0;
2939                    s--;
2940               }
2941               PL_rs = newSVpvs("");
2942               SvGROW(PL_rs, (STRLEN)(UNISKIP(rschar) + 1));
2943               tmps = (U8*)SvPVX(PL_rs);
2944               uvchr_to_utf8(tmps, rschar);
2945               SvCUR_set(PL_rs, UNISKIP(rschar));
2946               SvUTF8_on(PL_rs);
2947          }
2948          else {
2949               numlen = 4;
2950               rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
2951               if (rschar & ~((U8)~0))
2952                    PL_rs = &PL_sv_undef;
2953               else if (!rschar && numlen >= 2)
2954                    PL_rs = newSVpvs("");
2955               else {
2956                    char ch = (char)rschar;
2957                    PL_rs = newSVpvn(&ch, 1);
2958               }
2959          }
2960          sv_setsv(get_sv("/", GV_ADD), PL_rs);
2961          return s + numlen;
2962     }
2963     case 'C':
2964         s++;
2965         PL_unicode = parse_unicode_opts( (const char **)&s );
2966         if (PL_unicode & PERL_UNICODE_UTF8CACHEASSERT_FLAG)
2967             PL_utf8cache = -1;
2968         return s;
2969     case 'F':
2970         PL_minus_F = TRUE;
2971         PL_splitstr = ++s;
2972         while (*s && !isSPACE(*s)) ++s;
2973         PL_splitstr = savepvn(PL_splitstr, s - PL_splitstr);
2974         return s;
2975     case 'a':
2976         PL_minus_a = TRUE;
2977         s++;
2978         return s;
2979     case 'c':
2980         PL_minus_c = TRUE;
2981         s++;
2982         return s;
2983     case 'd':
2984         forbid_setid('d', FALSE);
2985         s++;
2986
2987         /* -dt indicates to the debugger that threads will be used */
2988         if (*s == 't' && !isALNUM(s[1])) {
2989             ++s;
2990             my_setenv("PERL5DB_THREADED", "1");
2991         }
2992
2993         /* The following permits -d:Mod to accepts arguments following an =
2994            in the fashion that -MSome::Mod does. */
2995         if (*s == ':' || *s == '=') {
2996             const char *start = ++s;
2997             const char *const end = s + strlen(s);
2998             SV * const sv = newSVpvs("use Devel::");
2999
3000             /* We now allow -d:Module=Foo,Bar */
3001             while(isALNUM(*s) || *s==':') ++s;
3002             if (*s != '=')
3003                 sv_catpvn(sv, start, end - start);
3004             else {
3005                 sv_catpvn(sv, start, s-start);
3006                 /* Don't use NUL as q// delimiter here, this string goes in the
3007                  * environment. */
3008                 Perl_sv_catpvf(aTHX_ sv, " split(/,/,q{%s});", ++s);
3009             }
3010             s = end;
3011             my_setenv("PERL5DB", SvPV_nolen_const(sv));
3012             SvREFCNT_dec(sv);
3013         }
3014         if (!PL_perldb) {
3015             PL_perldb = PERLDB_ALL;
3016             init_debugger();
3017         }
3018         return s;
3019     case 'D':
3020     {   
3021 #ifdef DEBUGGING
3022         forbid_setid('D', FALSE);
3023         s++;
3024         PL_debug = get_debug_opts( (const char **)&s, 1) | DEBUG_TOP_FLAG;
3025 #else /* !DEBUGGING */
3026         if (ckWARN_d(WARN_DEBUGGING))
3027             Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3028                    "Recompile perl with -DDEBUGGING to use -D switch (did you mean -d ?)\n");
3029         for (s++; isALNUM(*s); s++) ;
3030 #endif
3031         return s;
3032     }   
3033     case 'h':
3034         usage(PL_origargv[0]);
3035         my_exit(0);
3036     case 'i':
3037         Safefree(PL_inplace);
3038 #if defined(__CYGWIN__) /* do backup extension automagically */
3039         if (*(s+1) == '\0') {
3040         PL_inplace = savepvs(".bak");
3041         return s+1;
3042         }
3043 #endif /* __CYGWIN__ */
3044         {
3045             const char * const start = ++s;
3046             while (*s && !isSPACE(*s))
3047                 ++s;
3048
3049             PL_inplace = savepvn(start, s - start);
3050         }
3051         if (*s) {
3052             ++s;
3053             if (*s == '-')      /* Additional switches on #! line. */
3054                 s++;
3055         }
3056         return s;
3057     case 'I':   /* -I handled both here and in parse_body() */
3058         forbid_setid('I', FALSE);
3059         ++s;
3060         while (*s && isSPACE(*s))
3061             ++s;
3062         if (*s) {
3063             const char *e, *p;
3064             p = s;
3065             /* ignore trailing spaces (possibly followed by other switches) */
3066             do {
3067                 for (e = p; *e && !isSPACE(*e); e++) ;
3068                 p = e;
3069                 while (isSPACE(*p))
3070                     p++;
3071             } while (*p && *p != '-');
3072             incpush(s, e-s,
3073                     INCPUSH_ADD_SUB_DIRS|INCPUSH_ADD_OLD_VERS|INCPUSH_UNSHIFT);
3074             s = p;
3075             if (*s == '-')
3076                 s++;
3077         }
3078         else
3079             Perl_croak(aTHX_ "No directory specified for -I");
3080         return s;
3081     case 'l':
3082         PL_minus_l = TRUE;
3083         s++;
3084         if (PL_ors_sv) {
3085             SvREFCNT_dec(PL_ors_sv);
3086             PL_ors_sv = NULL;
3087         }
3088         if (isDIGIT(*s)) {
3089             I32 flags = 0;
3090             STRLEN numlen;
3091             PL_ors_sv = newSVpvs("\n");
3092             numlen = 3 + (*s == '0');
3093             *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
3094             s += numlen;
3095         }
3096         else {
3097             if (RsPARA(PL_rs)) {
3098                 PL_ors_sv = newSVpvs("\n\n");
3099             }
3100             else {
3101                 PL_ors_sv = newSVsv(PL_rs);
3102             }
3103         }
3104         return s;
3105     case 'M':
3106         forbid_setid('M', FALSE);       /* XXX ? */
3107         /* FALL THROUGH */
3108     case 'm':
3109         forbid_setid('m', FALSE);       /* XXX ? */
3110         if (*++s) {
3111             const char *start;
3112             const char *end;
3113             SV *sv;
3114             const char *use = "use ";
3115             bool colon = FALSE;
3116             /* -M-foo == 'no foo'       */
3117             /* Leading space on " no " is deliberate, to make both
3118                possibilities the same length.  */
3119             if (*s == '-') { use = " no "; ++s; }
3120             sv = newSVpvn(use,4);
3121             start = s;
3122             /* We allow -M'Module qw(Foo Bar)'  */
3123             while(isALNUM(*s) || *s==':') {
3124                 if( *s++ == ':' ) {
3125                     if( *s == ':' ) 
3126                         s++;
3127                     else
3128                         colon = TRUE;
3129                 }
3130             }
3131             if (s == start)
3132                 Perl_croak(aTHX_ "Module name required with -%c option",
3133                                     option);
3134             if (colon) 
3135                 Perl_croak(aTHX_ "Invalid module name %.*s with -%c option: "
3136                                     "contains single ':'",
3137                                     (int)(s - start), start, option);
3138             end = s + strlen(s);
3139             if (*s != '=') {
3140                 sv_catpvn(sv, start, end - start);
3141                 if (option == 'm') {
3142                     if (*s != '\0')
3143                         Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
3144                     sv_catpvs( sv, " ()");
3145                 }
3146             } else {
3147                 sv_catpvn(sv, start, s-start);
3148                 /* Use NUL as q''-delimiter.  */
3149                 sv_catpvs(sv, " split(/,/,q\0");
3150                 ++s;
3151                 sv_catpvn(sv, s, end - s);
3152                 sv_catpvs(sv,  "\0)");
3153             }
3154             s = end;
3155             Perl_av_create_and_push(aTHX_ &PL_preambleav, sv);
3156         }
3157         else
3158             Perl_croak(aTHX_ "Missing argument to -%c", option);
3159         return s;
3160     case 'n':
3161         PL_minus_n = TRUE;
3162         s++;
3163         return s;
3164     case 'p':
3165         PL_minus_p = TRUE;
3166         s++;
3167         return s;
3168     case 's':
3169         forbid_setid('s', FALSE);
3170         PL_doswitches = TRUE;
3171         s++;
3172         return s;
3173     case 't':
3174         if (!PL_tainting)
3175             TOO_LATE_FOR('t');
3176         s++;
3177         return s;
3178     case 'T':
3179         if (!PL_tainting)
3180             TOO_LATE_FOR('T');
3181         s++;
3182         return s;
3183     case 'u':
3184         PL_do_undump = TRUE;
3185         s++;
3186         return s;
3187     case 'U':
3188         PL_unsafe = TRUE;
3189         s++;
3190         return s;
3191     case 'v':
3192         if (!sv_derived_from(PL_patchlevel, "version"))
3193             upg_version(PL_patchlevel, TRUE);
3194 #if !defined(DGUX)
3195         {
3196             SV* level= vstringify(PL_patchlevel);
3197 #ifdef PERL_PATCHNUM
3198 #  ifdef PERL_GIT_UNCOMMITTED_CHANGES
3199             SV *num = newSVpvs(PERL_PATCHNUM "*");
3200 #  else
3201             SV *num = newSVpvs(PERL_PATCHNUM);
3202 #  endif
3203
3204             if (sv_len(num)>=sv_len(level) && strnEQ(SvPV_nolen(num),SvPV_nolen(level),sv_len(level))) {
3205                 SvREFCNT_dec(level);
3206                 level= num;
3207             } else {
3208                 Perl_sv_catpvf(aTHX_ level, " (%"SVf")", num);
3209                 SvREFCNT_dec(num);
3210             }
3211  #endif
3212             PerlIO_printf(PerlIO_stdout(),
3213                 "\nThis is perl, %"SVf
3214                 " built for %s",
3215                 level,
3216                 ARCHNAME);
3217             SvREFCNT_dec(level);
3218         }
3219 #else /* DGUX */
3220 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
3221         PerlIO_printf(PerlIO_stdout(),
3222                 Perl_form(aTHX_ "\nThis is perl, %"SVf"\n",
3223                     SVfARG(vstringify(PL_patchlevel))));
3224         PerlIO_printf(PerlIO_stdout(),
3225                         Perl_form(aTHX_ "        built under %s at %s %s\n",
3226                                         OSNAME, __DATE__, __TIME__));
3227         PerlIO_printf(PerlIO_stdout(),
3228                         Perl_form(aTHX_ "        OS Specific Release: %s\n",
3229                                         OSVERS));
3230 #endif /* !DGUX */
3231 #if defined(LOCAL_PATCH_COUNT)
3232         if (LOCAL_PATCH_COUNT > 0)
3233             PerlIO_printf(PerlIO_stdout(),
3234                           "\n(with %d registered patch%s, "
3235                           "see perl -V for more detail)",
3236                           LOCAL_PATCH_COUNT,
3237                           (LOCAL_PATCH_COUNT!=1) ? "es" : "");
3238 #endif
3239
3240         PerlIO_printf(PerlIO_stdout(),
3241                       "\n\nCopyright 1987-2009, Larry Wall\n");
3242 #ifdef MSDOS
3243         PerlIO_printf(PerlIO_stdout(),
3244                       "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
3245 #endif
3246 #ifdef DJGPP
3247         PerlIO_printf(PerlIO_stdout(),
3248                       "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
3249                       "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
3250 #endif
3251 #ifdef OS2
3252         PerlIO_printf(PerlIO_stdout(),
3253                       "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
3254                       "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
3255 #endif
3256 #ifdef atarist
3257         PerlIO_printf(PerlIO_stdout(),
3258                       "atariST series port, ++jrb  bammi@cadence.com\n");
3259 #endif
3260 #ifdef __BEOS__
3261         PerlIO_printf(PerlIO_stdout(),
3262                       "BeOS port Copyright Tom Spindler, 1997-1999\n");
3263 #endif
3264 #ifdef MPE
3265         PerlIO_printf(PerlIO_stdout(),
3266                       "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2003\n");
3267 #endif
3268 #ifdef OEMVS
3269         PerlIO_printf(PerlIO_stdout(),
3270                       "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
3271 #endif
3272 #ifdef __VOS__
3273         PerlIO_printf(PerlIO_stdout(),
3274                       "Stratus VOS port by Paul.Green@stratus.com, 1997-2002\n");
3275 #endif
3276 #ifdef __OPEN_VM
3277         PerlIO_printf(PerlIO_stdout(),
3278                       "VM/ESA port by Neale Ferguson, 1998-1999\n");
3279 #endif
3280 #ifdef POSIX_BC
3281         PerlIO_printf(PerlIO_stdout(),
3282                       "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
3283 #endif
3284 #ifdef EPOC
3285         PerlIO_printf(PerlIO_stdout(),
3286                       "EPOC port by Olaf Flebbe, 1999-2002\n");
3287 #endif
3288 #ifdef UNDER_CE
3289         PerlIO_printf(PerlIO_stdout(),"WINCE port by Rainer Keuchel, 2001-2002\n");
3290         PerlIO_printf(PerlIO_stdout(),"Built on " __DATE__ " " __TIME__ "\n\n");
3291         wce_hitreturn();
3292 #endif
3293 #ifdef __SYMBIAN32__
3294         PerlIO_printf(PerlIO_stdout(),
3295                       "Symbian port by Nokia, 2004-2005\n");
3296 #endif
3297 #ifdef BINARY_BUILD_NOTICE
3298         BINARY_BUILD_NOTICE;
3299 #endif
3300         PerlIO_printf(PerlIO_stdout(),
3301                       "\n\
3302 Perl may be copied only under the terms of either the Artistic License or the\n\
3303 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
3304 Complete documentation for Perl, including FAQ lists, should be found on\n\
3305 this system using \"man perl\" or \"perldoc perl\".  If you have access to the\n\
3306 Internet, point your browser at http://www.perl.org/, the Perl Home Page.\n\n");
3307         my_exit(0);
3308     case 'w':
3309         if (! (PL_dowarn & G_WARN_ALL_MASK)) {
3310             PL_dowarn |= G_WARN_ON;
3311         }
3312         s++;
3313         return s;
3314     case 'W':
3315         PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
3316         if (!specialWARN(PL_compiling.cop_warnings))
3317             PerlMemShared_free(PL_compiling.cop_warnings);
3318         PL_compiling.cop_warnings = pWARN_ALL ;
3319         s++;
3320         return s;
3321     case 'X':
3322         PL_dowarn = G_WARN_ALL_OFF;
3323         if (!specialWARN(PL_compiling.cop_warnings))
3324             PerlMemShared_free(PL_compiling.cop_warnings);
3325         PL_compiling.cop_warnings = pWARN_NONE ;
3326         s++;
3327         return s;
3328     case '*':
3329     case ' ':
3330         while( *s == ' ' )
3331           ++s;
3332         if (s[0] == '-')        /* Additional switches on #! line. */
3333             return s+1;
3334         break;
3335     case '-':
3336     case 0:
3337 #if defined(WIN32) || !defined(PERL_STRICT_CR)
3338     case '\r':
3339 #endif
3340     case '\n':
3341     case '\t':
3342         break;
3343 #ifdef ALTERNATE_SHEBANG
3344     case 'S':                   /* OS/2 needs -S on "extproc" line. */
3345         break;
3346 #endif
3347     default:
3348         Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
3349     }
3350     return NULL;
3351 }
3352
3353 /* compliments of Tom Christiansen */
3354
3355 /* unexec() can be found in the Gnu emacs distribution */
3356 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
3357
3358 void
3359 Perl_my_unexec(pTHX)
3360 {
3361     PERL_UNUSED_CONTEXT;
3362 #ifdef UNEXEC
3363     SV *    prog = newSVpv(BIN_EXP, 0);
3364     SV *    file = newSVpv(PL_origfilename, 0);
3365     int    status = 1;
3366     extern int etext;
3367
3368     sv_catpvs(prog, "/perl");
3369     sv_catpvs(file, ".perldump");
3370
3371     unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
3372     /* unexec prints msg to stderr in case of failure */
3373     PerlProc_exit(status);
3374 #else
3375 #  ifdef VMS
3376 #    include <lib$routines.h>
3377      lib$signal(SS$_DEBUG);  /* ssdef.h #included from vmsish.h */
3378 #  elif defined(WIN32) || defined(__CYGWIN__)
3379     Perl_croak(aTHX_ "dump is not supported");
3380 #  else
3381     ABORT();            /* for use with undump */
3382 #  endif
3383 #endif
3384 }
3385
3386 /* initialize curinterp */
3387 STATIC void
3388 S_init_interp(pTHX)
3389 {
3390     dVAR;
3391 #ifdef MULTIPLICITY
3392 #  define PERLVAR(var,type)
3393 #  define PERLVARA(var,n,type)
3394 #  if defined(PERL_IMPLICIT_CONTEXT)
3395 #    define PERLVARI(var,type,init)             aTHX->var = init;
3396 #    define PERLVARIC(var,type,init)    aTHX->var = init;
3397 #  else
3398 #    define PERLVARI(var,type,init)     PERL_GET_INTERP->var = init;
3399 #    define PERLVARIC(var,type,init)    PERL_GET_INTERP->var = init;
3400 #  endif
3401 #  include "intrpvar.h"
3402 #  undef PERLVAR
3403 #  undef PERLVARA
3404 #  undef PERLVARI
3405 #  undef PERLVARIC
3406 #else
3407 #  define PERLVAR(var,type)
3408 #  define PERLVARA(var,n,type)
3409 #  define PERLVARI(var,type,init)       PL_##var = init;
3410 #  define PERLVARIC(var,type,init)      PL_##var = init;
3411 #  include "intrpvar.h"
3412 #  undef PERLVAR
3413 #  undef PERLVARA
3414 #  undef PERLVARI
3415 #  undef PERLVARIC
3416 #endif
3417
3418     /* As these are inside a structure, PERLVARI isn't capable of initialising
3419        them  */
3420     PL_reg_oldcurpm = PL_reg_curpm = NULL;
3421     PL_reg_poscache = PL_reg_starttry = NULL;
3422 }
3423
3424 STATIC void
3425 S_init_main_stash(pTHX)
3426 {
3427     dVAR;
3428     GV *gv;
3429
3430     PL_curstash = PL_defstash = newHV();
3431     /* We know that the string "main" will be in the global shared string
3432        table, so it's a small saving to use it rather than allocate another
3433        8 bytes.  */
3434     PL_curstname = newSVpvs_share("main");
3435     gv = gv_fetchpvs("main::", GV_ADD|GV_NOTQUAL, SVt_PVHV);
3436     /* If we hadn't caused another reference to "main" to be in the shared
3437        string table above, then it would be worth reordering these two,
3438        because otherwise all we do is delete "main" from it as a consequence
3439        of the SvREFCNT_dec, only to add it again with hv_name_set */
3440     SvREFCNT_dec(GvHV(gv));
3441     hv_name_set(PL_defstash, "main", 4, 0);
3442     GvHV(gv) = MUTABLE_HV(SvREFCNT_inc_simple(PL_defstash));
3443     SvREADONLY_on(gv);
3444     PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpvs("INC", GV_ADD|GV_NOTQUAL,
3445                                              SVt_PVAV)));
3446     SvREFCNT_inc_simple_void(PL_incgv); /* Don't allow it to be freed */
3447     GvMULTI_on(PL_incgv);
3448     PL_hintgv = gv_fetchpvs("\010", GV_ADD|GV_NOTQUAL, SVt_PV); /* ^H */
3449     GvMULTI_on(PL_hintgv);
3450     PL_defgv = gv_fetchpvs("_", GV_ADD|GV_NOTQUAL, SVt_PVAV);
3451     SvREFCNT_inc_simple_void(PL_defgv);
3452     PL_errgv = gv_HVadd(gv_fetchpvs("@", GV_ADD|GV_NOTQUAL, SVt_PV));
3453     SvREFCNT_inc_simple_void(PL_errgv);
3454     GvMULTI_on(PL_errgv);
3455     PL_replgv = gv_fetchpvs("\022", GV_ADD|GV_NOTQUAL, SVt_PV); /* ^R */
3456     GvMULTI_on(PL_replgv);
3457     (void)Perl_form(aTHX_ "%240s","");  /* Preallocate temp - for immediate signals. */
3458 #ifdef PERL_DONT_CREATE_GVSV
3459     gv_SVadd(PL_errgv);
3460 #endif
3461     sv_grow(ERRSV, 240);        /* Preallocate - for immediate signals. */
3462     CLEAR_ERRSV();
3463     PL_curstash = PL_defstash;
3464     CopSTASH_set(&PL_compiling, PL_defstash);
3465     PL_debstash = GvHV(gv_fetchpvs("DB::", GV_ADDMULTI, SVt_PVHV));
3466     PL_globalstash = GvHV(gv_fetchpvs("CORE::GLOBAL::", GV_ADDMULTI,
3467                                       SVt_PVHV));
3468     /* We must init $/ before switches are processed. */
3469     sv_setpvs(get_sv("/", GV_ADD), "\n");
3470 }
3471
3472 STATIC int
3473 S_open_script(pTHX_ const char *scriptname, bool dosearch,
3474               bool *suidscript, PerlIO **rsfpp)
3475 {
3476     int fdscript = -1;
3477     dVAR;
3478
3479     PERL_ARGS_ASSERT_OPEN_SCRIPT;
3480
3481     if (PL_e_script) {
3482         PL_origfilename = savepvs("-e");
3483     }
3484     else {
3485         /* if find_script() returns, it returns a malloc()-ed value */
3486         scriptname = PL_origfilename = find_script(scriptname, dosearch, NULL, 1);
3487
3488         if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
3489             const char *s = scriptname + 8;
3490             fdscript = atoi(s);
3491             while (isDIGIT(*s))
3492                 s++;
3493             if (*s) {
3494                 /* PSz 18 Feb 04
3495                  * Tell apart "normal" usage of fdscript, e.g.
3496                  * with bash on FreeBSD:
3497                  *   perl <( echo '#!perl -DA'; echo 'print "$0\n"')
3498                  * from usage in suidperl.
3499                  * Does any "normal" usage leave garbage after the number???
3500                  * Is it a mistake to use a similar /dev/fd/ construct for
3501                  * suidperl?
3502                  */
3503                 *suidscript = TRUE;
3504                 /* PSz 20 Feb 04  
3505                  * Be supersafe and do some sanity-checks.
3506                  * Still, can we be sure we got the right thing?
3507                  */
3508                 if (*s != '/') {
3509                     Perl_croak(aTHX_ "Wrong syntax (suid) fd script name \"%s\"\n", s);
3510                 }
3511                 if (! *(s+1)) {
3512                     Perl_croak(aTHX_ "Missing (suid) fd script name\n");
3513                 }
3514                 scriptname = savepv(s + 1);
3515                 Safefree(PL_origfilename);
3516                 PL_origfilename = (char *)scriptname;
3517             }
3518         }
3519     }
3520
3521     CopFILE_free(PL_curcop);
3522     CopFILE_set(PL_curcop, PL_origfilename);
3523     if (*PL_origfilename == '-' && PL_origfilename[1] == '\0')
3524         scriptname = (char *)"";
3525     if (fdscript >= 0) {
3526         *rsfpp = PerlIO_fdopen(fdscript,PERL_SCRIPT_MODE);
3527 #       if defined(HAS_FCNTL) && defined(F_SETFD)
3528             if (*rsfpp)
3529                 /* ensure close-on-exec */
3530                 fcntl(PerlIO_fileno(*rsfpp),F_SETFD,1);
3531 #       endif
3532     }
3533     else if (!*scriptname) {
3534         forbid_setid(0, *suidscript);
3535         *rsfpp = PerlIO_stdin();
3536     }
3537     else {
3538 #ifdef FAKE_BIT_BUCKET
3539         /* This hack allows one not to have /dev/null (or BIT_BUCKET as it
3540          * is called) and still have the "-e" work.  (Believe it or not,
3541          * a /dev/null is required for the "-e" to work because source
3542          * filter magic is used to implement it. ) This is *not* a general
3543          * replacement for a /dev/null.  What we do here is create a temp
3544          * file (an empty file), open up that as the script, and then
3545          * immediately close and unlink it.  Close enough for jazz. */ 
3546 #define FAKE_BIT_BUCKET_PREFIX "/tmp/perlnull-"
3547 #define FAKE_BIT_BUCKET_SUFFIX "XXXXXXXX"
3548 #define FAKE_BIT_BUCKET_TEMPLATE FAKE_BIT_BUCKET_PREFIX FAKE_BIT_BUCKET_SUFFIX
3549         char tmpname[sizeof(FAKE_BIT_BUCKET_TEMPLATE)] = {
3550             FAKE_BIT_BUCKET_TEMPLATE
3551         };
3552         const char * const err = "Failed to create a fake bit bucket";
3553         if (strEQ(scriptname, BIT_BUCKET)) {
3554 #ifdef HAS_MKSTEMP /* Hopefully mkstemp() is safe here. */
3555             int tmpfd = mkstemp(tmpname);
3556             if (tmpfd > -1) {
3557                 scriptname = tmpname;
3558                 close(tmpfd);
3559             } else
3560                 Perl_croak(aTHX_ err);
3561 #else
3562 #  ifdef HAS_MKTEMP
3563             scriptname = mktemp(tmpname);
3564             if (!scriptname)
3565                 Perl_croak(aTHX_ err);
3566 #  endif
3567 #endif
3568         }
3569 #endif
3570         *rsfpp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
3571 #ifdef FAKE_BIT_BUCKET
3572         if (memEQ(scriptname, FAKE_BIT_BUCKET_PREFIX,
3573                   sizeof(FAKE_BIT_BUCKET_PREFIX) - 1)
3574             && strlen(scriptname) == sizeof(tmpname) - 1) {
3575             unlink(scriptname);
3576         }
3577         scriptname = BIT_BUCKET;
3578 #endif
3579 #       if defined(HAS_FCNTL) && defined(F_SETFD)
3580             if (*rsfpp)
3581                 /* ensure close-on-exec */
3582                 fcntl(PerlIO_fileno(*rsfpp),F_SETFD,1);
3583 #       endif
3584     }
3585     if (!*rsfpp) {
3586         /* PSz 16 Sep 03  Keep neat error message */
3587         if (PL_e_script)
3588             Perl_croak(aTHX_ "Can't open "BIT_BUCKET": %s\n", Strerror(errno));
3589         else
3590             Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
3591                     CopFILE(PL_curcop), Strerror(errno));
3592     }
3593     return fdscript;
3594 }
3595
3596 /* Mention
3597  * I_SYSSTATVFS HAS_FSTATVFS
3598  * I_SYSMOUNT
3599  * I_STATFS     HAS_FSTATFS     HAS_GETFSSTAT
3600  * I_MNTENT     HAS_GETMNTENT   HAS_HASMNTOPT
3601  * here so that metaconfig picks them up. */
3602
3603
3604 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
3605 /* Don't even need this function.  */
3606 #else
3607 STATIC void
3608 S_validate_suid(pTHX_ PerlIO *rsfp)
3609 {
3610     PERL_ARGS_ASSERT_VALIDATE_SUID;
3611
3612     if (PL_euid != PL_uid || PL_egid != PL_gid) {       /* (suidperl doesn't exist, in fact) */
3613         dVAR;
3614
3615         PerlLIO_fstat(PerlIO_fileno(rsfp),&PL_statbuf); /* may be either wrapped or real suid */
3616         if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3617             ||
3618             (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3619            )
3620             if (!PL_do_undump)
3621                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3622 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3623         /* not set-id, must be wrapped */
3624     }
3625 }
3626 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3627
3628 STATIC void
3629 S_find_beginning(pTHX_ SV* linestr_sv, PerlIO *rsfp)
3630 {
3631     dVAR;
3632     const char *s;
3633     register const char *s2;
3634
3635     PERL_ARGS_ASSERT_FIND_BEGINNING;
3636
3637     /* skip forward in input to the real script? */
3638
3639     while (PL_doextract) {
3640         if ((s = sv_gets(linestr_sv, rsfp, 0)) == NULL)
3641             Perl_croak(aTHX_ "No Perl script found in input\n");
3642         s2 = s;
3643         if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
3644             PerlIO_ungetc(rsfp, '\n');          /* to keep line count right */
3645             PL_doextract = FALSE;
3646             while (*s && !(isSPACE (*s) || *s == '#')) s++;
3647             s2 = s;
3648             while (*s == ' ' || *s == '\t') s++;
3649             if (*s++ == '-') {
3650                 while (isDIGIT(s2[-1]) || s2[-1] == '-' || s2[-1] == '.'
3651                        || s2[-1] == '_') s2--;
3652                 if (strnEQ(s2-4,"perl",4))
3653                     while ((s = moreswitches(s)))
3654                         ;
3655             }
3656         }
3657     }
3658 }
3659
3660
3661 STATIC void
3662 S_init_ids(pTHX)
3663 {
3664     dVAR;
3665     PL_uid = PerlProc_getuid();
3666     PL_euid = PerlProc_geteuid();
3667     PL_gid = PerlProc_getgid();
3668     PL_egid = PerlProc_getegid();
3669 #ifdef VMS
3670     PL_uid |= PL_gid << 16;
3671     PL_euid |= PL_egid << 16;
3672 #endif
3673     /* Should not happen: */
3674     CHECK_MALLOC_TAINT(PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3675     PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3676     /* BUG */
3677     /* PSz 27 Feb 04
3678      * Should go by suidscript, not uid!=euid: why disallow
3679      * system("ls") in scripts run from setuid things?
3680      * Or, is this run before we check arguments and set suidscript?
3681      * What about SETUID_SCRIPTS_ARE_SECURE_NOW: could we use fdscript then?
3682      * (We never have suidscript, can we be sure to have fdscript?)
3683      * Or must then go by UID checks? See comments in forbid_setid also.
3684      */
3685 }
3686
3687 /* This is used very early in the lifetime of the program,
3688  * before even the options are parsed, so PL_tainting has
3689  * not been initialized properly.  */
3690 bool
3691 Perl_doing_taint(int argc, char *argv[], char *envp[])
3692 {
3693 #ifndef PERL_IMPLICIT_SYS
3694     /* If we have PERL_IMPLICIT_SYS we can't call getuid() et alia
3695      * before we have an interpreter-- and the whole point of this
3696      * function is to be called at such an early stage.  If you are on
3697      * a system with PERL_IMPLICIT_SYS but you do have a concept of
3698      * "tainted because running with altered effective ids', you'll
3699      * have to add your own checks somewhere in here.  The two most
3700      * known samples of 'implicitness' are Win32 and NetWare, neither
3701      * of which has much of concept of 'uids'. */
3702     int uid  = PerlProc_getuid();
3703     int euid = PerlProc_geteuid();
3704     int gid  = PerlProc_getgid();
3705     int egid = PerlProc_getegid();
3706     (void)envp;
3707
3708 #ifdef VMS
3709     uid  |=  gid << 16;
3710     euid |= egid << 16;
3711 #endif
3712     if (uid && (euid != uid || egid != gid))
3713         return 1;
3714 #endif /* !PERL_IMPLICIT_SYS */
3715     /* This is a really primitive check; environment gets ignored only
3716      * if -T are the first chars together; otherwise one gets
3717      *  "Too late" message. */
3718     if ( argc > 1 && argv[1][0] == '-'
3719          && (argv[1][1] == 't' || argv[1][1] == 'T') )
3720         return 1;
3721     return 0;
3722 }
3723
3724 /* Passing the flag as a single char rather than a string is a slight space
3725    optimisation.  The only message that isn't /^-.$/ is
3726    "program input from stdin", which is substituted in place of '\0', which
3727    could never be a command line flag.  */
3728 STATIC void
3729 S_forbid_setid(pTHX_ const char flag, const bool suidscript) /* g */
3730 {
3731     dVAR;
3732     char string[3] = "-x";
3733     const char *message = "program input from stdin";
3734
3735     if (flag) {
3736         string[1] = flag;
3737         message = string;
3738     }
3739
3740 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
3741     if (PL_euid != PL_uid)
3742         Perl_croak(aTHX_ "No %s allowed while running setuid", message);
3743     if (PL_egid != PL_gid)
3744         Perl_croak(aTHX_ "No %s allowed while running setgid", message);
3745 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3746     if (suidscript)
3747         Perl_croak(aTHX_ "No %s allowed with (suid) fdscript", message);
3748 }
3749
3750 void
3751 Perl_init_debugger(pTHX)
3752 {
3753     dVAR;
3754     HV * const ostash = PL_curstash;
3755
3756     PL_curstash = PL_debstash;
3757     PL_dbargs = GvAV(gv_AVadd((gv_fetchpvs("DB::args", GV_ADDMULTI,
3758                                            SVt_PVAV))));
3759     AvREAL_off(PL_dbargs);
3760     PL_DBgv = gv_fetchpvs("DB::DB", GV_ADDMULTI, SVt_PVGV);
3761     PL_DBline = gv_fetchpvs("DB::dbline", GV_ADDMULTI, SVt_PVAV);
3762     PL_DBsub = gv_HVadd(gv_fetchpvs("DB::sub", GV_ADDMULTI, SVt_PVHV));
3763     PL_DBsingle = GvSV((gv_fetchpvs("DB::single", GV_ADDMULTI, SVt_PV)));
3764     sv_setiv(PL_DBsingle, 0);
3765     PL_DBtrace = GvSV((gv_fetchpvs("DB::trace", GV_ADDMULTI, SVt_PV)));
3766     sv_setiv(PL_DBtrace, 0);
3767     PL_DBsignal = GvSV((gv_fetchpvs("DB::signal", GV_ADDMULTI, SVt_PV)));
3768     sv_setiv(PL_DBsignal, 0);
3769     PL_curstash = ostash;
3770 }
3771
3772 #ifndef STRESS_REALLOC
3773 #define REASONABLE(size) (size)
3774 #else
3775 #define REASONABLE(size) (1) /* unreasonable */
3776 #endif
3777
3778 void
3779 Perl_init_stacks(pTHX)
3780 {
3781     dVAR;
3782     /* start with 128-item stack and 8K cxstack */
3783     PL_curstackinfo = new_stackinfo(REASONABLE(128),
3784                                  REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
3785     PL_curstackinfo->si_type = PERLSI_MAIN;
3786     PL_curstack = PL_curstackinfo->si_stack;
3787     PL_mainstack = PL_curstack;         /* remember in case we switch stacks */
3788
3789     PL_stack_base = AvARRAY(PL_curstack);
3790     PL_stack_sp = PL_stack_base;
3791     PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
3792
3793     Newx(PL_tmps_stack,REASONABLE(128),SV*);
3794     PL_tmps_floor = -1;
3795     PL_tmps_ix = -1;
3796     PL_tmps_max = REASONABLE(128);
3797
3798     Newx(PL_markstack,REASONABLE(32),I32);
3799     PL_markstack_ptr = PL_markstack;
3800     PL_markstack_max = PL_markstack + REASONABLE(32);
3801
3802     SET_MARK_OFFSET;
3803
3804     Newx(PL_scopestack,REASONABLE(32),I32);
3805     PL_scopestack_ix = 0;
3806     PL_scopestack_max = REASONABLE(32);
3807
3808     Newx(PL_savestack,REASONABLE(128),ANY);
3809     PL_savestack_ix = 0;
3810     PL_savestack_max = REASONABLE(128);
3811 }
3812
3813 #undef REASONABLE
3814
3815 STATIC void
3816 S_nuke_stacks(pTHX)
3817 {
3818     dVAR;
3819     while (PL_curstackinfo->si_next)
3820         PL_curstackinfo = PL_curstackinfo->si_next;
3821     while (PL_curstackinfo) {
3822         PERL_SI *p = PL_curstackinfo->si_prev;
3823         /* curstackinfo->si_stack got nuked by sv_free_arenas() */
3824         Safefree(PL_curstackinfo->si_cxstack);
3825         Safefree(PL_curstackinfo);
3826         PL_curstackinfo = p;
3827     }
3828     Safefree(PL_tmps_stack);
3829     Safefree(PL_markstack);
3830     Safefree(PL_scopestack);
3831     Safefree(PL_savestack);
3832 }
3833
3834
3835 STATIC void
3836 S_init_predump_symbols(pTHX)
3837 {
3838     dVAR;
3839     GV *tmpgv;
3840     IO *io;
3841
3842     sv_setpvs(get_sv("\"", GV_ADD), " ");
3843     PL_ofsgv = (GV*)SvREFCNT_inc(gv_fetchpvs(",", GV_ADD|GV_NOTQUAL, SVt_PV));
3844
3845     PL_stdingv = gv_fetchpvs("STDIN", GV_ADD|GV_NOTQUAL, SVt_PVIO);
3846     GvMULTI_on(PL_stdingv);
3847     io = GvIOp(PL_stdingv);
3848     IoTYPE(io) = IoTYPE_RDONLY;
3849     IoIFP(io) = PerlIO_stdin();
3850     tmpgv = gv_fetchpvs("stdin", GV_ADD|GV_NOTQUAL, SVt_PV);
3851     GvMULTI_on(tmpgv);
3852     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
3853
3854     tmpgv = gv_fetchpvs("STDOUT", GV_ADD|GV_NOTQUAL, SVt_PVIO);
3855     GvMULTI_on(tmpgv);
3856     io = GvIOp(tmpgv);
3857     IoTYPE(io) = IoTYPE_WRONLY;
3858     IoOFP(io) = IoIFP(io) = PerlIO_stdout();
3859     setdefout(tmpgv);
3860     tmpgv = gv_fetchpvs("stdout", GV_ADD|GV_NOTQUAL, SVt_PV);
3861     GvMULTI_on(tmpgv);
3862     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
3863
3864     PL_stderrgv = gv_fetchpvs("STDERR", GV_ADD|GV_NOTQUAL, SVt_PVIO);
3865     GvMULTI_on(PL_stderrgv);
3866     io = GvIOp(PL_stderrgv);
3867     IoTYPE(io) = IoTYPE_WRONLY;
3868     IoOFP(io) = IoIFP(io) = PerlIO_stderr();
3869     tmpgv = gv_fetchpvs("stderr", GV_ADD|GV_NOTQUAL, SVt_PV);
3870     GvMULTI_on(tmpgv);
3871     GvIOp(tmpgv) = MUTABLE_IO(SvREFCNT_inc_simple(io));
3872
3873     PL_statname = newSV(0);             /* last filename we did stat on */
3874
3875     Safefree(PL_osname);
3876     PL_osname = savepv(OSNAME);
3877 }
3878
3879 void
3880 Perl_init_argv_symbols(pTHX_ register int argc, register char **argv)
3881 {
3882     dVAR;
3883
3884     PERL_ARGS_ASSERT_INIT_ARGV_SYMBOLS;
3885
3886     argc--,argv++;      /* skip name of script */
3887     if (PL_doswitches) {
3888         for (; argc > 0 && **argv == '-'; argc--,argv++) {
3889             char *s;
3890             if (!argv[0][1])
3891                 break;
3892             if (argv[0][1] == '-' && !argv[0][2]) {
3893                 argc--,argv++;
3894                 break;
3895             }
3896             if ((s = strchr(argv[0], '='))) {
3897                 const char *const start_name = argv[0] + 1;
3898                 sv_setpv(GvSV(gv_fetchpvn_flags(start_name, s - start_name,
3899                                                 TRUE, SVt_PV)), s + 1);
3900             }
3901             else
3902                 sv_setiv(GvSV(gv_fetchpv(argv[0]+1, GV_ADD, SVt_PV)),1);
3903         }
3904     }
3905     if ((PL_argvgv = gv_fetchpvs("ARGV", GV_ADD|GV_NOTQUAL, SVt_PVAV))) {
3906         GvMULTI_on(PL_argvgv);
3907         (void)gv_AVadd(PL_argvgv);
3908         av_clear(GvAVn(PL_argvgv));
3909         for (; argc > 0; argc--,argv++) {
3910             SV * const sv = newSVpv(argv[0],0);
3911             av_push(GvAVn(PL_argvgv),sv);
3912             if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
3913                  if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
3914                       SvUTF8_on(sv);
3915             }
3916             if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
3917                  (void)sv_utf8_decode(sv);
3918         }
3919     }
3920 }
3921
3922 STATIC void
3923 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
3924 {
3925     dVAR;
3926     GV* tmpgv;
3927
3928     PERL_ARGS_ASSERT_INIT_POSTDUMP_SYMBOLS;
3929
3930     PL_toptarget = newSV_type(SVt_PVFM);
3931     sv_setpvs(PL_toptarget, "");
3932     PL_bodytarget = newSV_type(SVt_PVFM);
3933     sv_setpvs(PL_bodytarget, "");
3934     PL_formtarget = PL_bodytarget;
3935
3936     TAINT;
3937
3938     init_argv_symbols(argc,argv);
3939
3940     if ((tmpgv = gv_fetchpvs("0", GV_ADD|GV_NOTQUAL, SVt_PV))) {
3941         sv_setpv(GvSV(tmpgv),PL_origfilename);
3942     }
3943     if ((PL_envgv = gv_fetchpvs("ENV", GV_ADD|GV_NOTQUAL, SVt_PVHV))) {
3944         HV *hv;
3945         bool env_is_not_environ;
3946         GvMULTI_on(PL_envgv);
3947         hv = GvHVn(PL_envgv);
3948         hv_magic(hv, NULL, PERL_MAGIC_env);
3949 #ifndef PERL_MICRO
3950 #ifdef USE_ENVIRON_ARRAY
3951         /* Note that if the supplied env parameter is actually a copy
3952            of the global environ then it may now point to free'd memory
3953            if the environment has been modified since. To avoid this
3954            problem we treat env==NULL as meaning 'use the default'
3955         */
3956         if (!env)
3957             env = environ;
3958         env_is_not_environ = env != environ;
3959         if (env_is_not_environ
3960 #  ifdef USE_ITHREADS
3961             && PL_curinterp == aTHX
3962 #  endif
3963            )
3964         {
3965             environ[0] = NULL;
3966         }
3967         if (env) {
3968           char *s, *old_var;
3969           SV *sv;
3970           for (; *env; env++) {
3971             old_var = *env;
3972
3973             if (!(s = strchr(old_var,'=')) || s == old_var)
3974                 continue;
3975
3976 #if defined(MSDOS) && !defined(DJGPP)
3977             *s = '\0';
3978             (void)strupr(old_var);
3979             *s = '=';
3980 #endif
3981             sv = newSVpv(s+1, 0);
3982             (void)hv_store(hv, old_var, s - old_var, sv, 0);
3983             if (env_is_not_environ)
3984                 mg_set(sv);
3985           }
3986       }
3987 #endif /* USE_ENVIRON_ARRAY */
3988 #endif /* !PERL_MICRO */
3989     }
3990     TAINT_NOT;
3991     if ((tmpgv = gv_fetchpvs("$", GV_ADD|GV_NOTQUAL, SVt_PV))) {
3992         SvREADONLY_off(GvSV(tmpgv));
3993         sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
3994         SvREADONLY_on(GvSV(tmpgv));
3995     }
3996 #ifdef THREADS_HAVE_PIDS
3997     PL_ppid = (IV)getppid();
3998 #endif
3999
4000     /* touch @F array to prevent spurious warnings 20020415 MJD */
4001     if (PL_minus_a) {
4002       (void) get_av("main::F", GV_ADD | GV_ADDMULTI);
4003     }
4004 }
4005
4006 STATIC void
4007 S_init_perllib(pTHX)
4008 {
4009     dVAR;
4010 #ifndef VMS
4011     const char *perl5lib = NULL;
4012 #endif
4013     const char *s;
4014 #ifdef WIN32
4015     STRLEN len;
4016 #endif
4017
4018     if (!PL_tainting) {
4019 #ifndef VMS
4020         perl5lib = PerlEnv_getenv("PERL5LIB");
4021 /*
4022  * It isn't possible to delete an environment variable with
4023  * PERL_USE_SAFE_PUTENV set unless unsetenv() is also available, so in that
4024  * case we treat PERL5LIB as undefined if it has a zero-length value.
4025  */
4026 #if defined(PERL_USE_SAFE_PUTENV) && ! defined(HAS_UNSETENV)
4027         if (perl5lib && *perl5lib != '\0')
4028 #else
4029         if (perl5lib)
4030 #endif
4031             incpush_use_sep(perl5lib, 0, INCPUSH_ADD_SUB_DIRS);
4032         else {
4033             s = PerlEnv_getenv("PERLLIB");
4034             if (s)
4035                 incpush_use_sep(s, 0, 0);
4036         }
4037 #else /* VMS */
4038         /* Treat PERL5?LIB as a possible search list logical name -- the
4039          * "natural" VMS idiom for a Unix path string.  We allow each
4040          * element to be a set of |-separated directories for compatibility.
4041          */
4042         char buf[256];
4043         int idx = 0;
4044         if (my_trnlnm("PERL5LIB",buf,0))
4045             do {
4046                 incpush_use_sep(buf, 0, INCPUSH_ADD_SUB_DIRS);
4047             } while (my_trnlnm("PERL5LIB",buf,++idx));
4048         else {
4049             while (my_trnlnm("PERLLIB",buf,idx++))
4050                 incpush_use_sep(buf, 0, 0);
4051         }
4052 #endif /* VMS */
4053     }
4054
4055 /* Use the ~-expanded versions of APPLLIB (undocumented),
4056     ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
4057 */
4058 #ifdef APPLLIB_EXP
4059     S_incpush_use_sep(aTHX_ STR_WITH_LEN(APPLLIB_EXP),
4060                       INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4061 #endif
4062
4063 #ifdef SITEARCH_EXP
4064     /* sitearch is always relative to sitelib on Windows for
4065      * DLL-based path intuition to work correctly */
4066 #  if !defined(WIN32)
4067         S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITEARCH_EXP),
4068                           INCPUSH_CAN_RELOCATE);
4069 #  endif
4070 #endif
4071
4072 #ifdef SITELIB_EXP
4073 #  if defined(WIN32)
4074     /* this picks up sitearch as well */
4075         s = win32_get_sitelib(PERL_FS_VERSION, &len);
4076         if (s)
4077             incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4078 #  else
4079         S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITELIB_EXP), INCPUSH_CAN_RELOCATE);
4080 #  endif
4081 #endif
4082
4083 #ifdef PERL_VENDORARCH_EXP
4084     /* vendorarch is always relative to vendorlib on Windows for
4085      * DLL-based path intuition to work correctly */
4086 #  if !defined(WIN32)
4087     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORARCH_EXP),
4088                       INCPUSH_CAN_RELOCATE);
4089 #  endif
4090 #endif
4091
4092 #ifdef PERL_VENDORLIB_EXP
4093 #  if defined(WIN32)
4094     /* this picks up vendorarch as well */
4095         s = win32_get_vendorlib(PERL_FS_VERSION, &len);
4096         if (s)
4097             incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4098 #  else
4099         S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORLIB_EXP),
4100                           INCPUSH_CAN_RELOCATE);
4101 #  endif
4102 #endif
4103
4104 #ifdef ARCHLIB_EXP
4105     S_incpush_use_sep(aTHX_ STR_WITH_LEN(ARCHLIB_EXP), INCPUSH_CAN_RELOCATE);
4106 #endif
4107
4108 #ifndef PRIVLIB_EXP
4109 #  define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
4110 #endif
4111
4112 #if defined(WIN32)
4113     s = win32_get_privlib(PERL_FS_VERSION, &len);
4114     if (s)
4115         incpush_use_sep(s, len, INCPUSH_ADD_SUB_DIRS|INCPUSH_CAN_RELOCATE);
4116 #else
4117 #  ifdef NETWARE
4118     S_incpush_use_sep(aTHX_ PRIVLIB_EXP, 0, INCPUSH_CAN_RELOCATE);
4119 #  else
4120     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PRIVLIB_EXP), INCPUSH_CAN_RELOCATE);
4121 #  endif
4122 #endif
4123
4124 #ifdef PERL_OTHERLIBDIRS
4125     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_OTHERLIBDIRS),
4126                       INCPUSH_ADD_VERSIONED_SUB_DIRS|INCPUSH_NOT_BASEDIR
4127                       |INCPUSH_CAN_RELOCATE);
4128 #endif
4129
4130     if (!PL_tainting) {
4131 #ifndef VMS
4132 /*
4133  * It isn't possible to delete an environment variable with
4134  * PERL_USE_SAFE_PUTENV set unless unsetenv() is also available, so in that
4135  * case we treat PERL5LIB as undefined if it has a zero-length value.
4136  */
4137 #if defined(PERL_USE_SAFE_PUTENV) && ! defined(HAS_UNSETENV)
4138         if (perl5lib && *perl5lib != '\0')
4139 #else
4140         if (perl5lib)
4141 #endif
4142             incpush_use_sep(perl5lib, 0,
4143                             INCPUSH_ADD_OLD_VERS|INCPUSH_NOT_BASEDIR);
4144 #else /* VMS */
4145         /* Treat PERL5?LIB as a possible search list logical name -- the
4146          * "natural" VMS idiom for a Unix path string.  We allow each
4147          * element to be a set of |-separated directories for compatibility.
4148          */
4149         char buf[256];
4150         int idx = 0;
4151         if (my_trnlnm("PERL5LIB",buf,0))
4152             do {
4153                 incpush_use_sep(buf, 0,
4154                                 INCPUSH_ADD_OLD_VERS|INCPUSH_NOT_BASEDIR);
4155             } while (my_trnlnm("PERL5LIB",buf,++idx));
4156 #endif /* VMS */
4157     }
4158
4159 /* Use the ~-expanded versions of APPLLIB (undocumented),
4160     ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
4161 */
4162 #ifdef APPLLIB_EXP
4163     S_incpush_use_sep(aTHX_ STR_WITH_LEN(APPLLIB_EXP), INCPUSH_ADD_OLD_VERS
4164                       |INCPUSH_NOT_BASEDIR|INCPUSH_CAN_RELOCATE);
4165 #endif
4166
4167 #if defined(SITELIB_STEM) && defined(PERL_INC_VERSION_LIST)
4168     /* Search for version-specific dirs below here */
4169     S_incpush_use_sep(aTHX_ STR_WITH_LEN(SITELIB_STEM),
4170                       INCPUSH_ADD_OLD_VERS|INCPUSH_CAN_RELOCATE);
4171 #endif
4172
4173
4174 #if defined(PERL_VENDORLIB_STEM) && defined(PERL_INC_VERSION_LIST)
4175     /* Search for version-specific dirs below here */
4176     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_VENDORLIB_STEM),
4177                       INCPUSH_ADD_OLD_VERS|INCPUSH_CAN_RELOCATE);
4178 #endif
4179
4180 #ifdef PERL_OTHERLIBDIRS
4181     S_incpush_use_sep(aTHX_ STR_WITH_LEN(PERL_OTHERLIBDIRS),
4182                       INCPUSH_ADD_OLD_VERS|INCPUSH_ADD_ARCHONLY_SUB_DIRS
4183                       |INCPUSH_CAN_RELOCATE);
4184 #endif
4185
4186     if (!PL_tainting)
4187         S_incpush(aTHX_ STR_WITH_LEN("."), 0);
4188 }
4189
4190 #if defined(DOSISH) || defined(EPOC) || defined(__SYMBIAN32__)
4191 #    define PERLLIB_SEP ';'
4192 #else
4193 #  if defined(VMS)
4194 #    define PERLLIB_SEP '|'
4195 #  else
4196 #    define PERLLIB_SEP ':'
4197 #  endif
4198 #endif
4199 #ifndef PERLLIB_MANGLE
4200 #  define PERLLIB_MANGLE(s,n) (s)
4201 #endif
4202
4203 /* Push a directory onto @INC if it exists.
4204    Generate a new SV if we do this, to save needing to copy the SV we push
4205    onto @INC  */
4206 STATIC SV *
4207 S_incpush_if_exists(pTHX_ AV *const av, SV *dir, SV *const stem)
4208 {
4209     dVAR;
4210     Stat_t tmpstatbuf;
4211
4212     PERL_ARGS_ASSERT_INCPUSH_IF_EXISTS;
4213
4214     if (PerlLIO_stat(SvPVX_const(dir), &tmpstatbuf) >= 0 &&
4215         S_ISDIR(tmpstatbuf.st_mode)) {
4216         av_push(av, dir);
4217         dir = newSVsv(stem);
4218     } else {
4219         /* Truncate dir back to stem.  */
4220         SvCUR_set(dir, SvCUR(stem));
4221     }
4222     return dir;
4223 }
4224
4225 STATIC void
4226 S_incpush(pTHX_ const char *const dir, STRLEN len, U32 flags)
4227 {
4228     dVAR;
4229     const U8 using_sub_dirs
4230         = (U8)flags & (INCPUSH_ADD_VERSIONED_SUB_DIRS
4231                        |INCPUSH_ADD_ARCHONLY_SUB_DIRS|INCPUSH_ADD_OLD_VERS);
4232     const U8 add_versioned_sub_dirs
4233         = (U8)flags & INCPUSH_ADD_VERSIONED_SUB_DIRS;
4234     const U8 add_archonly_sub_dirs
4235         = (U8)flags & INCPUSH_ADD_ARCHONLY_SUB_DIRS;
4236 #ifdef PERL_INC_VERSION_LIST
4237     const U8 addoldvers  = (U8)flags & INCPUSH_ADD_OLD_VERS;
4238 #endif
4239     const U8 canrelocate = (U8)flags & INCPUSH_CAN_RELOCATE;
4240     const U8 unshift     = (U8)flags & INCPUSH_UNSHIFT;
4241     const U8 push_basedir = (flags & INCPUSH_NOT_BASEDIR) ? 0 : 1;
4242     AV *const inc = GvAVn(PL_incgv);
4243
4244     PERL_ARGS_ASSERT_INCPUSH;
4245     assert(len > 0);
4246
4247     /* Could remove this vestigial extra block, if we don't mind a lot of
4248        re-indenting diff noise.  */
4249     {
4250         SV *libdir;
4251         /* Change 20189146be79a0596543441fa369c6bf7f85103f, to fix RT#6665,
4252            arranged to unshift #! line -I onto the front of @INC. However,
4253            -I can add version and architecture specific libraries, and they
4254            need to go first. The old code assumed that it was always
4255            pushing. Hence to make it work, need to push the architecture
4256            (etc) libraries onto a temporary array, then "unshift" that onto
4257            the front of @INC.  */
4258         AV *const av = (using_sub_dirs) ? (unshift ? newAV() : inc) : NULL;
4259
4260         if (len) {
4261             /* I am not convinced that this is valid when PERLLIB_MANGLE is
4262                defined to so something (in os2/os2.c), but the code has been
4263                this way, ignoring any possible changed of length, since
4264                760ac839baf413929cd31cc32ffd6dba6b781a81 (5.003_02) so I'll leave
4265                it be.  */
4266             libdir = newSVpvn(PERLLIB_MANGLE(dir, len), len);
4267         } else {
4268             libdir = newSVpv(PERLLIB_MANGLE(dir, 0), 0);
4269         }
4270
4271         /* Do the if() outside the #ifdef to avoid warnings about an unused
4272            parameter.  */
4273         if (canrelocate) {
4274 #ifdef PERL_RELOCATABLE_INC
4275         /*
4276          * Relocatable include entries are marked with a leading .../
4277          *
4278          * The algorithm is
4279          * 0: Remove that leading ".../"
4280          * 1: Remove trailing executable name (anything after the last '/')
4281          *    from the perl path to give a perl prefix
4282          * Then
4283          * While the @INC element starts "../" and the prefix ends with a real
4284          * directory (ie not . or ..) chop that real directory off the prefix
4285          * and the leading "../" from the @INC element. ie a logical "../"
4286          * cleanup
4287          * Finally concatenate the prefix and the remainder of the @INC element
4288          * The intent is that /usr/local/bin/perl and .../../lib/perl5
4289          * generates /usr/local/lib/perl5
4290          */
4291             const char *libpath = SvPVX(libdir);
4292             STRLEN libpath_len = SvCUR(libdir);
4293             if (libpath_len >= 4 && memEQ (libpath, ".../", 4)) {
4294                 /* Game on!  */
4295                 SV * const caret_X = get_sv("\030", 0);
4296                 /* Going to use the SV just as a scratch buffer holding a C
4297                    string:  */
4298                 SV *prefix_sv;
4299                 char *prefix;
4300                 char *lastslash;
4301
4302                 /* $^X is *the* source of taint if tainting is on, hence
4303                    SvPOK() won't be true.  */
4304                 assert(caret_X);
4305                 assert(SvPOKp(caret_X));
4306                 prefix_sv = newSVpvn_flags(SvPVX(caret_X), SvCUR(caret_X),
4307                                            SvUTF8(caret_X));
4308                 /* Firstly take off the leading .../
4309                    If all else fail we'll do the paths relative to the current
4310                    directory.  */
4311                 sv_chop(libdir, libpath + 4);
4312                 /* Don't use SvPV as we're intentionally bypassing taining,
4313                    mortal copies that the mg_get of tainting creates, and
4314                    corruption that seems to come via the save stack.
4315                    I guess that the save stack isn't correctly set up yet.  */
4316                 libpath = SvPVX(libdir);
4317                 libpath_len = SvCUR(libdir);
4318
4319                 /* This would work more efficiently with memrchr, but as it's
4320                    only a GNU extension we'd need to probe for it and
4321                    implement our own. Not hard, but maybe not worth it?  */
4322
4323                 prefix = SvPVX(prefix_sv);
4324                 lastslash = strrchr(prefix, '/');
4325
4326                 /* First time in with the *lastslash = '\0' we just wipe off
4327                    the trailing /perl from (say) /usr/foo/bin/perl
4328                 */
4329                 if (lastslash) {
4330                     SV *tempsv;
4331                     while ((*lastslash = '\0'), /* Do that, come what may.  */
4332                            (libpath_len >= 3 && memEQ(libpath, "../", 3)
4333                             && (lastslash = strrchr(prefix, '/')))) {
4334                         if (lastslash[1] == '\0'
4335                             || (lastslash[1] == '.'
4336                                 && (lastslash[2] == '/' /* ends "/."  */
4337                                     || (lastslash[2] == '/'
4338                                         && lastslash[3] == '/' /* or "/.."  */
4339                                         )))) {
4340                             /* Prefix ends "/" or "/." or "/..", any of which
4341                                are fishy, so don't do any more logical cleanup.
4342                             */
4343                             break;
4344                         }
4345                         /* Remove leading "../" from path  */
4346                         libpath += 3;
4347                         libpath_len -= 3;
4348                         /* Next iteration round the loop removes the last
4349                            directory name from prefix by writing a '\0' in
4350                            the while clause.  */
4351                     }
4352                     /* prefix has been terminated with a '\0' to the correct
4353                        length. libpath points somewhere into the libdir SV.
4354                        We need to join the 2 with '/' and drop the result into
4355                        libdir.  */
4356                     tempsv = Perl_newSVpvf(aTHX_ "%s/%s", prefix, libpath);
4357                     SvREFCNT_dec(libdir);
4358                     /* And this is the new libdir.  */
4359                     libdir = tempsv;
4360                     if (PL_tainting &&
4361                         (PL_uid != PL_euid || PL_gid != PL_egid)) {
4362                         /* Need to taint reloccated paths if running set ID  */
4363                         SvTAINTED_on(libdir);
4364                     }
4365                 }
4366                 SvREFCNT_dec(prefix_sv);
4367             }
4368 #endif
4369         }
4370         /*
4371          * BEFORE pushing libdir onto @INC we may first push version- and
4372          * archname-specific sub-directories.
4373          */
4374         if (using_sub_dirs) {
4375             SV *subdir;
4376 #ifdef PERL_INC_VERSION_LIST
4377             /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
4378             const char * const incverlist[] = { PERL_INC_VERSION_LIST };
4379             const char * const *incver;
4380 #endif
4381 #ifdef VMS
4382             char *unix;
4383             STRLEN len;
4384
4385
4386             if ((unix = tounixspec_ts(SvPV(libdir,len),NULL)) != NULL) {
4387                 len = strlen(unix);
4388                 while (unix[len-1] == '/') len--;  /* Cosmetic */
4389                 sv_usepvn(libdir,unix,len);
4390             }
4391             else
4392                 PerlIO_printf(Perl_error_log,
4393                               "Failed to unixify @INC element \"%s\"\n",
4394                               SvPV(libdir,len));
4395 #endif
4396
4397             subdir = newSVsv(libdir);
4398
4399             if (add_versioned_sub_dirs) {
4400                 /* .../version/archname if -d .../version/archname */
4401                 sv_catpvs(subdir, "/" PERL_FS_VERSION "/" ARCHNAME);
4402                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4403
4404                 /* .../version if -d .../version */
4405                 sv_catpvs(subdir, "/" PERL_FS_VERSION);
4406                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4407             }
4408
4409 #ifdef PERL_INC_VERSION_LIST
4410             if (addoldvers) {
4411                 for (incver = incverlist; *incver; incver++) {
4412                     /* .../xxx if -d .../xxx */
4413                     Perl_sv_catpvf(aTHX_ subdir, "/%s", *incver);
4414                     subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4415                 }
4416             }
4417 #endif
4418
4419             if (add_archonly_sub_dirs) {
4420                 /* .../archname if -d .../archname */
4421                 sv_catpvs(subdir, "/" ARCHNAME);
4422                 subdir = S_incpush_if_exists(aTHX_ av, subdir, libdir);
4423
4424             }
4425
4426             assert (SvREFCNT(subdir) == 1);
4427             SvREFCNT_dec(subdir);
4428         }
4429
4430         /* finally add this lib directory at the end of @INC */
4431         if (unshift) {
4432             U32 extra = av_len(av) + 1;
4433             av_unshift(inc, extra + push_basedir);
4434             if (push_basedir)
4435                 av_store(inc, extra, libdir);
4436             while (extra--) {
4437                 /* av owns a reference, av_store() expects to be donated a
4438                    reference, and av expects to be sane when it's cleared.
4439                    If I wanted to be naughty and wrong, I could peek inside the
4440                    implementation of av_clear(), realise that it uses
4441                    SvREFCNT_dec() too, so av's array could be a run of NULLs,
4442                    and so directly steal from it (with a memcpy() to inc, and
4443                    then memset() to NULL them out. But people copy code from the
4444                    core expecting it to be best practise, so let's use the API.
4445                    Although studious readers will note that I'm not checking any
4446                    return codes.  */
4447                 av_store(inc, extra, SvREFCNT_inc(*av_fetch(av, extra, FALSE)));
4448             }
4449             SvREFCNT_dec(av);
4450         }
4451         else if (push_basedir) {
4452             av_push(inc, libdir);
4453         }
4454
4455         if (!push_basedir) {
4456             assert (SvREFCNT(libdir) == 1);
4457             SvREFCNT_dec(libdir);
4458         }
4459     }
4460 }
4461
4462 STATIC void
4463 S_incpush_use_sep(pTHX_ const char *p, STRLEN len, U32 flags)
4464 {
4465     const char *s;
4466     const char *end;
4467     /* This logic has been broken out from S_incpush(). It may be possible to
4468        simplify it.  */
4469
4470     PERL_ARGS_ASSERT_INCPUSH_USE_SEP;
4471
4472     if (!len)
4473         len = strlen(p);
4474
4475     end = p + len;
4476
4477     /* Break at all separators */
4478     while ((s = (const char*)memchr(p, PERLLIB_SEP, end - p))) {
4479         if (s == p) {
4480             /* skip any consecutive separators */
4481
4482             /* Uncomment the next line for PATH semantics */
4483             /* But you'll need to write tests */
4484             /* av_push(GvAVn(PL_incgv), newSVpvs(".")); */
4485         } else {
4486             incpush(p, (STRLEN)(s - p), flags);
4487         }
4488         p = s + 1;
4489     }
4490     if (p != end)
4491         incpush(p, (STRLEN)(end - p), flags);
4492
4493 }
4494
4495 void
4496 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
4497 {
4498     dVAR;
4499     SV *atsv;
4500     volatile const line_t oldline = PL_curcop ? CopLINE(PL_curcop) : 0;
4501     CV *cv;
4502     STRLEN len;
4503     int ret;
4504     dJMPENV;
4505
4506     PERL_ARGS_ASSERT_CALL_LIST;
4507
4508     while (av_len(paramList) >= 0) {
4509         cv = MUTABLE_CV(av_shift(paramList));
4510         if (PL_savebegin) {
4511             if (paramList == PL_beginav) {
4512                 /* save PL_beginav for compiler */
4513                 Perl_av_create_and_push(aTHX_ &PL_beginav_save, MUTABLE_SV(cv));
4514             }
4515             else if (paramList == PL_checkav) {
4516                 /* save PL_checkav for compiler */
4517                 Perl_av_create_and_push(aTHX_ &PL_checkav_save, MUTABLE_SV(cv));
4518             }
4519             else if (paramList == PL_unitcheckav) {
4520                 /* save PL_unitcheckav for compiler */
4521                 Perl_av_create_and_push(aTHX_ &PL_unitcheckav_save, MUTABLE_SV(cv));
4522             }
4523         } else {
4524             if (!PL_madskills)
4525                 SAVEFREESV(cv);
4526         }
4527         JMPENV_PUSH(ret);
4528         switch (ret) {
4529         case 0:
4530 #ifdef PERL_MAD
4531             if (PL_madskills)
4532                 PL_madskills |= 16384;
4533 #endif
4534             CALL_LIST_BODY(cv);
4535 #ifdef PERL_MAD
4536             if (PL_madskills)
4537                 PL_madskills &= ~16384;
4538 #endif
4539             atsv = ERRSV;
4540             (void)SvPV_const(atsv, len);
4541             if (len) {
4542                 PL_curcop = &PL_compiling;
4543                 CopLINE_set(PL_curcop, oldline);
4544                 if (paramList == PL_beginav)
4545                     sv_catpvs(atsv, "BEGIN failed--compilation aborted");
4546                 else
4547                     Perl_sv_catpvf(aTHX_ atsv,
4548                                    "%s failed--call queue aborted",
4549                                    paramList == PL_checkav ? "CHECK"
4550                                    : paramList == PL_initav ? "INIT"
4551                                    : paramList == PL_unitcheckav ? "UNITCHECK"
4552                                    : "END");
4553                 while (PL_scopestack_ix > oldscope)
4554                     LEAVE;
4555                 JMPENV_POP;
4556                 Perl_croak(aTHX_ "%"SVf"", SVfARG(atsv));
4557             }
4558             break;
4559         case 1:
4560             STATUS_ALL_FAILURE;
4561             /* FALL THROUGH */
4562         case 2:
4563             /* my_exit() was called */
4564             while (PL_scopestack_ix > oldscope)
4565                 LEAVE;
4566             FREETMPS;
4567             PL_curstash = PL_defstash;
4568             PL_curcop = &PL_compiling;
4569             CopLINE_set(PL_curcop, oldline);
4570             JMPENV_POP;
4571             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
4572                 if (paramList == PL_beginav)
4573                     Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
4574                 else
4575                     Perl_croak(aTHX_ "%s failed--call queue aborted",
4576                                paramList == PL_checkav ? "CHECK"
4577                                : paramList == PL_initav ? "INIT"
4578                                : paramList == PL_unitcheckav ? "UNITCHECK"
4579                                : "END");
4580             }
4581             my_exit_jump();
4582             /* NOTREACHED */
4583         case 3:
4584             if (PL_restartop) {
4585                 PL_curcop = &PL_compiling;
4586                 CopLINE_set(PL_curcop, oldline);
4587                 JMPENV_JUMP(3);
4588             }
4589             PerlIO_printf(Perl_error_log, "panic: restartop\n");
4590             FREETMPS;
4591             break;
4592         }
4593         JMPENV_POP;
4594     }
4595 }
4596
4597 void
4598 Perl_my_exit(pTHX_ U32 status)
4599 {
4600     dVAR;
4601     switch (status) {
4602     case 0:
4603         STATUS_ALL_SUCCESS;
4604         break;
4605     case 1:
4606         STATUS_ALL_FAILURE;
4607         break;
4608     default:
4609         STATUS_EXIT_SET(status);
4610         break;
4611     }
4612     my_exit_jump();
4613 }
4614
4615 void
4616 Perl_my_failure_exit(pTHX)
4617 {
4618     dVAR;
4619 #ifdef VMS
4620      /* We have been called to fall on our sword.  The desired exit code
4621       * should be already set in STATUS_UNIX, but could be shifted over
4622       * by 8 bits.  STATUS_UNIX_EXIT_SET will handle the cases where a
4623       * that code is set.
4624       *
4625       * If an error code has not been set, then force the issue.
4626       */
4627     if (MY_POSIX_EXIT) {
4628
4629         /* According to the die_exit.t tests, if errno is non-zero */
4630         /* It should be used for the error status. */
4631
4632         if (errno == EVMSERR) {
4633             STATUS_NATIVE = vaxc$errno;
4634         } else {
4635
4636             /* According to die_exit.t tests, if the child_exit code is */
4637             /* also zero, then we need to exit with a code of 255 */
4638             if ((errno != 0) && (errno < 256))
4639                 STATUS_UNIX_EXIT_SET(errno);
4640             else if (STATUS_UNIX < 255) {
4641                 STATUS_UNIX_EXIT_SET(255);
4642             }
4643
4644         }
4645
4646         /* The exit code could have been set by $? or vmsish which
4647          * means that it may not have fatal set.  So convert
4648          * success/warning codes to fatal with out changing
4649          * the POSIX status code.  The severity makes VMS native
4650          * status handling work, while UNIX mode programs use the
4651          * the POSIX exit codes.
4652          */
4653          if ((STATUS_NATIVE & (STS$K_SEVERE|STS$K_ERROR)) == 0) {
4654             STATUS_NATIVE &= STS$M_COND_ID;
4655             STATUS_NATIVE |= STS$K_ERROR | STS$M_INHIB_MSG;
4656          }
4657     }
4658     else {
4659         /* Traditionally Perl on VMS always expects a Fatal Error. */
4660         if (vaxc$errno & 1) {
4661
4662             /* So force success status to failure */
4663             if (STATUS_NATIVE & 1)
4664                 STATUS_ALL_FAILURE;
4665         }
4666         else {
4667             if (!vaxc$errno) {
4668                 STATUS_UNIX = EINTR; /* In case something cares */
4669                 STATUS_ALL_FAILURE;
4670             }
4671             else {
4672                 int severity;
4673                 STATUS_NATIVE = vaxc$errno; /* Should already be this */
4674
4675                 /* Encode the severity code */
4676                 severity = STATUS_NATIVE & STS$M_SEVERITY;
4677                 STATUS_UNIX = (severity ? severity : 1) << 8;
4678
4679                 /* Perl expects this to be a fatal error */
4680                 if (severity != STS$K_SEVERE)
4681                     STATUS_ALL_FAILURE;
4682             }
4683         }
4684     }
4685
4686 #else
4687     int exitstatus;
4688     if (errno & 255)
4689         STATUS_UNIX_SET(errno);
4690     else {
4691         exitstatus = STATUS_UNIX >> 8;
4692         if (exitstatus & 255)
4693             STATUS_UNIX_SET(exitstatus);
4694         else
4695             STATUS_UNIX_SET(255);
4696     }
4697 #endif
4698     my_exit_jump();
4699 }
4700
4701 STATIC void
4702 S_my_exit_jump(pTHX)
4703 {
4704     dVAR;
4705
4706     if (PL_e_script) {
4707         SvREFCNT_dec(PL_e_script);
4708         PL_e_script = NULL;
4709     }
4710
4711     POPSTACK_TO(PL_mainstack);
4712     dounwind(-1);
4713     LEAVE_SCOPE(0);
4714
4715     JMPENV_JUMP(2);
4716 }
4717
4718 static I32
4719 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen)
4720 {
4721     dVAR;
4722     const char * const p  = SvPVX_const(PL_e_script);
4723     const char *nl = strchr(p, '\n');
4724
4725     PERL_UNUSED_ARG(idx);
4726     PERL_UNUSED_ARG(maxlen);
4727
4728     nl = (nl) ? nl+1 : SvEND(PL_e_script);
4729     if (nl-p == 0) {
4730         filter_del(read_e_script);
4731         return 0;
4732     }
4733     sv_catpvn(buf_sv, p, nl-p);
4734     sv_chop(PL_e_script, nl);
4735     return 1;
4736 }
4737
4738 /*
4739  * Local variables:
4740  * c-indentation-style: bsd
4741  * c-basic-offset: 4
4742  * indent-tabs-mode: t
4743  * End:
4744  *
4745  * ex: set ts=8 sts=4 sw=4 noet:
4746  */