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