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