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