This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Fix definition of Perl_sighandler following change 25200
[perl5.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     /* Newx() 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     /* Newx() 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 = (Sighandler_t) 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     Safefree(PL_reg_curpm);
1212     Safefree(PL_reg_poscache);
1213     free_tied_hv_pool();
1214     Safefree(PL_op_mask);
1215     Safefree(PL_psig_ptr);
1216     PL_psig_ptr = (SV**)NULL;
1217     Safefree(PL_psig_name);
1218     PL_psig_name = (SV**)NULL;
1219     Safefree(PL_bitcount);
1220     PL_bitcount = Nullch;
1221     Safefree(PL_psig_pend);
1222     PL_psig_pend = (int*)NULL;
1223     PL_formfeed = Nullsv;
1224     nuke_stacks();
1225     PL_tainting = FALSE;
1226     PL_taint_warn = FALSE;
1227     PL_hints = 0;               /* Reset hints. Should hints be per-interpreter ? */
1228     PL_debug = 0;
1229
1230     DEBUG_P(debprofdump());
1231
1232 #ifdef USE_REENTRANT_API
1233     Perl_reentrant_free(aTHX);
1234 #endif
1235
1236     sv_free_arenas();
1237
1238     /* As the absolutely last thing, free the non-arena SV for mess() */
1239
1240     if (PL_mess_sv) {
1241         /* we know that type == SVt_PVMG */
1242
1243         /* it could have accumulated taint magic */
1244         MAGIC* mg;
1245         MAGIC* moremagic;
1246         for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
1247             moremagic = mg->mg_moremagic;
1248             if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
1249                 && mg->mg_len >= 0)
1250                 Safefree(mg->mg_ptr);
1251             Safefree(mg);
1252         }
1253
1254         /* we know that type >= SVt_PV */
1255         SvPV_free(PL_mess_sv);
1256         Safefree(SvANY(PL_mess_sv));
1257         Safefree(PL_mess_sv);
1258         PL_mess_sv = Nullsv;
1259     }
1260     return STATUS_NATIVE_EXPORT;
1261 }
1262
1263 /*
1264 =for apidoc perl_free
1265
1266 Releases a Perl interpreter.  See L<perlembed>.
1267
1268 =cut
1269 */
1270
1271 void
1272 perl_free(pTHXx)
1273 {
1274 #if defined(WIN32) || defined(NETWARE)
1275 #  if defined(PERL_IMPLICIT_SYS)
1276 #    ifdef NETWARE
1277     void *host = nw_internal_host;
1278 #    else
1279     void *host = w32_internal_host;
1280 #    endif
1281     PerlMem_free(aTHXx);
1282 #    ifdef NETWARE
1283     nw_delete_internal_host(host);
1284 #    else
1285     win32_delete_internal_host(host);
1286 #    endif
1287 #  else
1288     PerlMem_free(aTHXx);
1289 #  endif
1290 #else
1291     PerlMem_free(aTHXx);
1292 #endif
1293 }
1294
1295 #if defined(USE_5005THREADS) || defined(USE_ITHREADS)
1296 /* provide destructors to clean up the thread key when libperl is unloaded */
1297 #ifndef WIN32 /* handled during DLL_PROCESS_DETACH in win32/perllib.c */
1298
1299 #if defined(__hpux) && __ux_version > 1020 && !defined(__GNUC__)
1300 #pragma fini "perl_fini"
1301 #endif
1302
1303 static void
1304 #if defined(__GNUC__)
1305 __attribute__((destructor))
1306 #endif
1307 perl_fini(void)
1308 {
1309     dVAR;
1310     if (PL_curinterp)
1311         FREE_THREAD_KEY;
1312 }
1313
1314 #endif /* WIN32 */
1315 #endif /* THREADS */
1316
1317 void
1318 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
1319 {
1320     Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
1321     PL_exitlist[PL_exitlistlen].fn = fn;
1322     PL_exitlist[PL_exitlistlen].ptr = ptr;
1323     ++PL_exitlistlen;
1324 }
1325
1326 #ifdef HAS_PROCSELFEXE
1327 /* This is a function so that we don't hold on to MAXPATHLEN
1328    bytes of stack longer than necessary
1329  */
1330 STATIC void
1331 S_procself_val(pTHX_ SV *sv, const char *arg0)
1332 {
1333     char buf[MAXPATHLEN];
1334     int len = readlink(PROCSELFEXE_PATH, buf, sizeof(buf) - 1);
1335
1336     /* On Playstation2 Linux V1.0 (kernel 2.2.1) readlink(/proc/self/exe)
1337        includes a spurious NUL which will cause $^X to fail in system
1338        or backticks (this will prevent extensions from being built and
1339        many tests from working). readlink is not meant to add a NUL.
1340        Normal readlink works fine.
1341      */
1342     if (len > 0 && buf[len-1] == '\0') {
1343       len--;
1344     }
1345
1346     /* FreeBSD's implementation is acknowledged to be imperfect, sometimes
1347        returning the text "unknown" from the readlink rather than the path
1348        to the executable (or returning an error from the readlink).  Any valid
1349        path has a '/' in it somewhere, so use that to validate the result.
1350        See http://www.freebsd.org/cgi/query-pr.cgi?pr=35703
1351     */
1352     if (len > 0 && memchr(buf, '/', len)) {
1353         sv_setpvn(sv,buf,len);
1354     }
1355     else {
1356         sv_setpv(sv,arg0);
1357     }
1358 }
1359 #endif /* HAS_PROCSELFEXE */
1360
1361 STATIC void
1362 S_set_caret_X(pTHX) {
1363     GV* tmpgv = gv_fetchpv("\030",TRUE, SVt_PV); /* $^X */
1364     if (tmpgv) {
1365 #ifdef HAS_PROCSELFEXE
1366         S_procself_val(aTHX_ GvSV(tmpgv), PL_origargv[0]);
1367 #else
1368 #ifdef OS2
1369         sv_setpv(GvSVn(tmpgv), os2_execname(aTHX));
1370 #else
1371         sv_setpv(GvSVn(tmpgv),PL_origargv[0]);
1372 #endif
1373 #endif
1374     }
1375 }
1376
1377 /*
1378 =for apidoc perl_parse
1379
1380 Tells a Perl interpreter to parse a Perl script.  See L<perlembed>.
1381
1382 =cut
1383 */
1384
1385 int
1386 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
1387 {
1388     dVAR;
1389     I32 oldscope;
1390     int ret;
1391     dJMPENV;
1392
1393     PERL_UNUSED_VAR(my_perl);
1394
1395 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
1396 #ifdef IAMSUID
1397 #undef IAMSUID
1398     Perl_croak(aTHX_ "suidperl is no longer needed since the kernel can now execute\n\
1399 setuid perl scripts securely.\n");
1400 #endif /* IAMSUID */
1401 #endif
1402
1403 #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT)
1404     /* [perl #22371] Algorimic Complexity Attack on Perl 5.6.1, 5.8.0
1405      * This MUST be done before any hash stores or fetches take place.
1406      * If you set PL_rehash_seed (and assumedly also PL_rehash_seed_set)
1407      * yourself, it is your responsibility to provide a good random seed!
1408      * You can also define PERL_HASH_SEED in compile time, see hv.h. */
1409     if (!PL_rehash_seed_set)
1410          PL_rehash_seed = get_hash_seed();
1411     {
1412         const char * const s = PerlEnv_getenv("PERL_HASH_SEED_DEBUG");
1413
1414         if (s && (atoi(s) == 1))
1415             PerlIO_printf(Perl_debug_log, "HASH_SEED = %"UVuf"\n", PL_rehash_seed);
1416     }
1417 #endif /* #if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT) */
1418
1419     PL_origargc = argc;
1420     PL_origargv = argv;
1421
1422     {
1423         /* Set PL_origalen be the sum of the contiguous argv[]
1424          * elements plus the size of the env in case that it is
1425          * contiguous with the argv[].  This is used in mg.c:Perl_magic_set()
1426          * as the maximum modifiable length of $0.  In the worst case
1427          * the area we are able to modify is limited to the size of
1428          * the original argv[0].  (See below for 'contiguous', though.)
1429          * --jhi */
1430          const char *s = NULL;
1431          int i;
1432          const UV mask =
1433            ~(UV)(PTRSIZE == 4 ? 3 : PTRSIZE == 8 ? 7 : PTRSIZE == 16 ? 15 : 0);
1434          /* Do the mask check only if the args seem like aligned. */
1435          const UV aligned =
1436            (mask < ~(UV)0) && ((PTR2UV(argv[0]) & mask) == PTR2UV(argv[0]));
1437
1438          /* See if all the arguments are contiguous in memory.  Note
1439           * that 'contiguous' is a loose term because some platforms
1440           * align the argv[] and the envp[].  If the arguments look
1441           * like non-aligned, assume that they are 'strictly' or
1442           * 'traditionally' contiguous.  If the arguments look like
1443           * aligned, we just check that they are within aligned
1444           * PTRSIZE bytes.  As long as no system has something bizarre
1445           * like the argv[] interleaved with some other data, we are
1446           * fine.  (Did I just evoke Murphy's Law?)  --jhi */
1447          if (PL_origargv && PL_origargc >= 1 && (s = PL_origargv[0])) {
1448               while (*s) s++;
1449               for (i = 1; i < PL_origargc; i++) {
1450                    if ((PL_origargv[i] == s + 1
1451 #ifdef OS2
1452                         || PL_origargv[i] == s + 2
1453 #endif 
1454                             )
1455                        ||
1456                        (aligned &&
1457                         (PL_origargv[i] >  s &&
1458                          PL_origargv[i] <=
1459                          INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1460                         )
1461                    {
1462                         s = PL_origargv[i];
1463                         while (*s) s++;
1464                    }
1465                    else
1466                         break;
1467               }
1468          }
1469          /* Can we grab env area too to be used as the area for $0? */
1470          if (PL_origenviron) {
1471               if ((PL_origenviron[0] == s + 1
1472 #ifdef OS2
1473                    || (PL_origenviron[0] == s + 9 && (s += 8))
1474 #endif 
1475                   )
1476                   ||
1477                   (aligned &&
1478                    (PL_origenviron[0] >  s &&
1479                     PL_origenviron[0] <=
1480                     INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1481                  )
1482               {
1483 #ifndef OS2
1484                    s = PL_origenviron[0];
1485                    while (*s) s++;
1486 #endif
1487                    my_setenv("NoNe  SuCh", Nullch);
1488                    /* Force copy of environment. */
1489                    for (i = 1; PL_origenviron[i]; i++) {
1490                         if (PL_origenviron[i] == s + 1
1491                             ||
1492                             (aligned &&
1493                              (PL_origenviron[i] >  s &&
1494                               PL_origenviron[i] <=
1495                               INT2PTR(char *, PTR2UV(s + PTRSIZE) & mask)))
1496                            )
1497                         {
1498                              s = PL_origenviron[i];
1499                              while (*s) s++;
1500                         }
1501                         else
1502                              break;
1503                    }
1504               }
1505          }
1506          PL_origalen = s - PL_origargv[0] + 1;
1507     }
1508
1509     if (PL_do_undump) {
1510
1511         /* Come here if running an undumped a.out. */
1512
1513         PL_origfilename = savepv(argv[0]);
1514         PL_do_undump = FALSE;
1515         cxstack_ix = -1;                /* start label stack again */
1516         init_ids();
1517         assert (!PL_tainted);
1518         TAINT;
1519         S_set_caret_X(aTHX);
1520         TAINT_NOT;
1521         init_postdump_symbols(argc,argv,env);
1522         return 0;
1523     }
1524
1525     if (PL_main_root) {
1526         op_free(PL_main_root);
1527         PL_main_root = Nullop;
1528     }
1529     PL_main_start = Nullop;
1530     SvREFCNT_dec(PL_main_cv);
1531     PL_main_cv = Nullcv;
1532
1533     time(&PL_basetime);
1534     oldscope = PL_scopestack_ix;
1535     PL_dowarn = G_WARN_OFF;
1536
1537     JMPENV_PUSH(ret);
1538     switch (ret) {
1539     case 0:
1540         parse_body(env,xsinit);
1541         if (PL_checkav)
1542             call_list(oldscope, PL_checkav);
1543         ret = 0;
1544         break;
1545     case 1:
1546         STATUS_ALL_FAILURE;
1547         /* FALL THROUGH */
1548     case 2:
1549         /* my_exit() was called */
1550         while (PL_scopestack_ix > oldscope)
1551             LEAVE;
1552         FREETMPS;
1553         PL_curstash = PL_defstash;
1554         if (PL_checkav)
1555             call_list(oldscope, PL_checkav);
1556         ret = STATUS_NATIVE_EXPORT;
1557         break;
1558     case 3:
1559         PerlIO_printf(Perl_error_log, "panic: top_env\n");
1560         ret = 1;
1561         break;
1562     }
1563     JMPENV_POP;
1564     return ret;
1565 }
1566
1567 STATIC void *
1568 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
1569 {
1570     dVAR;
1571     int argc = PL_origargc;
1572     char **argv = PL_origargv;
1573     const char *scriptname = NULL;
1574     VOL bool dosearch = FALSE;
1575     const char *validarg = "";
1576     register SV *sv;
1577     register char *s;
1578     const char *cddir = Nullch;
1579 #ifdef USE_SITECUSTOMIZE
1580     bool minus_f = FALSE;
1581 #endif
1582
1583     PL_fdscript = -1;
1584     PL_suidscript = -1;
1585     sv_setpvn(PL_linestr,"",0);
1586     sv = newSVpvn("",0);                /* first used for -I flags */
1587     SAVEFREESV(sv);
1588     init_main_stash();
1589
1590     for (argc--,argv++; argc > 0; argc--,argv++) {
1591         if (argv[0][0] != '-' || !argv[0][1])
1592             break;
1593 #ifdef DOSUID
1594     if (*validarg)
1595         validarg = " PHOOEY ";
1596     else
1597         validarg = argv[0];
1598     /*
1599      * Can we rely on the kernel to start scripts with argv[1] set to
1600      * contain all #! line switches (the whole line)? (argv[0] is set to
1601      * the interpreter name, argv[2] to the script name; argv[3] and
1602      * above may contain other arguments.)
1603      */
1604 #endif
1605         s = argv[0]+1;
1606       reswitch:
1607         switch (*s) {
1608         case 'C':
1609 #ifndef PERL_STRICT_CR
1610         case '\r':
1611 #endif
1612         case ' ':
1613         case '0':
1614         case 'F':
1615         case 'a':
1616         case 'c':
1617         case 'd':
1618         case 'D':
1619         case 'h':
1620         case 'i':
1621         case 'l':
1622         case 'M':
1623         case 'm':
1624         case 'n':
1625         case 'p':
1626         case 's':
1627         case 'u':
1628         case 'U':
1629         case 'v':
1630         case 'W':
1631         case 'X':
1632         case 'w':
1633         case 'A':
1634             if ((s = moreswitches(s)))
1635                 goto reswitch;
1636             break;
1637
1638         case 't':
1639             CHECK_MALLOC_TOO_LATE_FOR('t');
1640             if( !PL_tainting ) {
1641                  PL_taint_warn = TRUE;
1642                  PL_tainting = TRUE;
1643             }
1644             s++;
1645             goto reswitch;
1646         case 'T':
1647             CHECK_MALLOC_TOO_LATE_FOR('T');
1648             PL_tainting = TRUE;
1649             PL_taint_warn = FALSE;
1650             s++;
1651             goto reswitch;
1652
1653         case 'e':
1654 #ifdef MACOS_TRADITIONAL
1655             /* ignore -e for Dev:Pseudo argument */
1656             if (argv[1] && !strcmp(argv[1], "Dev:Pseudo"))
1657                 break;
1658 #endif
1659             forbid_setid("-e");
1660             if (!PL_e_script) {
1661                 PL_e_script = newSVpvn("",0);
1662                 filter_add(read_e_script, NULL);
1663             }
1664             if (*++s)
1665                 sv_catpv(PL_e_script, s);
1666             else if (argv[1]) {
1667                 sv_catpv(PL_e_script, argv[1]);
1668                 argc--,argv++;
1669             }
1670             else
1671                 Perl_croak(aTHX_ "No code specified for -e");
1672             sv_catpv(PL_e_script, "\n");
1673             break;
1674
1675         case 'f':
1676 #ifdef USE_SITECUSTOMIZE
1677             minus_f = TRUE;
1678 #endif
1679             s++;
1680             goto reswitch;
1681
1682         case 'I':       /* -I handled both here and in moreswitches() */
1683             forbid_setid("-I");
1684             if (!*++s && (s=argv[1]) != Nullch) {
1685                 argc--,argv++;
1686             }
1687             if (s && *s) {
1688                 STRLEN len = strlen(s);
1689                 const char * const p = savepvn(s, len);
1690                 incpush(p, TRUE, TRUE, FALSE, FALSE);
1691                 sv_catpvn(sv, "-I", 2);
1692                 sv_catpvn(sv, p, len);
1693                 sv_catpvn(sv, " ", 1);
1694                 Safefree(p);
1695             }
1696             else
1697                 Perl_croak(aTHX_ "No directory specified for -I");
1698             break;
1699         case 'P':
1700             forbid_setid("-P");
1701             PL_preprocess = TRUE;
1702             s++;
1703             goto reswitch;
1704         case 'S':
1705             forbid_setid("-S");
1706             dosearch = TRUE;
1707             s++;
1708             goto reswitch;
1709         case 'V':
1710             {
1711                 SV *opts_prog;
1712
1713                 if (!PL_preambleav)
1714                     PL_preambleav = newAV();
1715                 av_push(PL_preambleav,
1716                         newSVpv("use Config;",0));
1717                 if (*++s != ':')  {
1718                     STRLEN opts;
1719                 
1720                     opts_prog = newSVpv("print Config::myconfig(),",0);
1721 #ifdef VMS
1722                     sv_catpv(opts_prog,"\"\\nCharacteristics of this PERLSHR image: \\n\",");
1723 #else
1724                     sv_catpv(opts_prog,"\"\\nCharacteristics of this binary (from libperl): \\n\",");
1725 #endif
1726                     opts = SvCUR(opts_prog);
1727
1728                     sv_catpv(opts_prog,"\"  Compile-time options:");
1729 #  ifdef DEBUGGING
1730                     sv_catpv(opts_prog," DEBUGGING");
1731 #  endif
1732 #  ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
1733                     sv_catpv(opts_prog," DEBUG_LEAKING_SCALARS_FORK_DUMP");
1734 #  endif
1735 #  ifdef FAKE_THREADS
1736                     sv_catpv(opts_prog," FAKE_THREADS");
1737 #  endif
1738 #  ifdef MULTIPLICITY
1739                     sv_catpv(opts_prog," MULTIPLICITY");
1740 #  endif
1741 #  ifdef MYMALLOC
1742                     sv_catpv(opts_prog," MYMALLOC");
1743 #  endif
1744 #  ifdef PERL_DONT_CREATE_GVSV
1745                     sv_catpv(opts_prog," PERL_DONT_CREATE_GVSV");
1746 #  endif
1747 #  ifdef PERL_GLOBAL_STRUCT
1748                     sv_catpv(opts_prog," PERL_GLOBAL_STRUCT");
1749 #  endif
1750 #  ifdef PERL_IMPLICIT_CONTEXT
1751                     sv_catpv(opts_prog," PERL_IMPLICIT_CONTEXT");
1752 #  endif
1753 #  ifdef PERL_IMPLICIT_SYS
1754                     sv_catpv(opts_prog," PERL_IMPLICIT_SYS");
1755 #  endif
1756 #  ifdef PERL_MALLOC_WRAP
1757                     sv_catpv(opts_prog," PERL_MALLOC_WRAP");
1758 #  endif
1759 #  ifdef PERL_NEED_APPCTX
1760                     sv_catpv(opts_prog," PERL_NEED_APPCTX");
1761 #  endif
1762 #  ifdef PERL_NEED_TIMESBASE
1763                     sv_catpv(opts_prog," PERL_NEED_TIMESBASE");
1764 #  endif
1765 #  ifdef PERL_OLD_COPY_ON_WRITE
1766                     sv_catpv(opts_prog," PERL_OLD_COPY_ON_WRITE");
1767 #  endif
1768 #  ifdef PL_OP_SLAB_ALLOC
1769                     sv_catpv(opts_prog," PL_OP_SLAB_ALLOC");
1770 #  endif
1771 #  ifdef THREADS_HAVE_PIDS
1772                     sv_catpv(opts_prog," THREADS_HAVE_PIDS");
1773 #  endif
1774 #  ifdef USE_5005THREADS
1775                     sv_catpv(opts_prog," USE_5005THREADS");
1776 #  endif
1777 #  ifdef USE_64_BIT_ALL
1778                     sv_catpv(opts_prog," USE_64_BIT_ALL");
1779 #  endif
1780 #  ifdef USE_64_BIT_INT
1781                     sv_catpv(opts_prog," USE_64_BIT_INT");
1782 #  endif
1783 #  ifdef USE_ITHREADS
1784                     sv_catpv(opts_prog," USE_ITHREADS");
1785 #  endif
1786 #  ifdef USE_LARGE_FILES
1787                     sv_catpv(opts_prog," USE_LARGE_FILES");
1788 #  endif
1789 #  ifdef USE_LONG_DOUBLE
1790                     sv_catpv(opts_prog," USE_LONG_DOUBLE");
1791 #  endif
1792 #  ifdef USE_PERLIO
1793                     sv_catpv(opts_prog," USE_PERLIO");
1794 #  endif
1795 #  ifdef USE_REENTRANT_API
1796                     sv_catpv(opts_prog," USE_REENTRANT_API");
1797 #  endif
1798 #  ifdef USE_SFIO
1799                     sv_catpv(opts_prog," USE_SFIO");
1800 #  endif
1801 #  ifdef USE_SITECUSTOMIZE
1802                     sv_catpv(opts_prog," USE_SITECUSTOMIZE");
1803 #  endif               
1804 #  ifdef USE_SOCKS
1805                     sv_catpv(opts_prog," USE_SOCKS");
1806 #  endif
1807
1808                     while (SvCUR(opts_prog) > opts+76) {
1809                         /* find last space after "options: " and before col 76
1810                          */
1811
1812                         const char *space;
1813                         char *pv = SvPV_nolen(opts_prog);
1814                         const char c = pv[opts+76];
1815                         pv[opts+76] = '\0';
1816                         space = strrchr(pv+opts+26, ' ');
1817                         pv[opts+76] = c;
1818                         if (!space) break; /* "Can't happen" */
1819
1820                         /* break the line before that space */
1821
1822                         opts = space - pv;
1823                         sv_insert(opts_prog, opts, 0,
1824                                   "\\n                       ", 25);
1825                     }
1826
1827                     sv_catpv(opts_prog,"\\n\",");
1828
1829 #if defined(LOCAL_PATCH_COUNT)
1830                     if (LOCAL_PATCH_COUNT > 0) {
1831                         int i;
1832                         sv_catpv(opts_prog,
1833                                  "\"  Locally applied patches:\\n\",");
1834                         for (i = 1; i <= LOCAL_PATCH_COUNT; i++) {
1835                             if (PL_localpatches[i])
1836                                 Perl_sv_catpvf(aTHX_ opts_prog,"q%c\t%s\n%c,",
1837                                                0, PL_localpatches[i], 0);
1838                         }
1839                     }
1840 #endif
1841                     Perl_sv_catpvf(aTHX_ opts_prog,
1842                                    "\"  Built under %s\\n\"",OSNAME);
1843 #ifdef __DATE__
1844 #  ifdef __TIME__
1845                     Perl_sv_catpvf(aTHX_ opts_prog,
1846                                    ",\"  Compiled at %s %s\\n\"",__DATE__,
1847                                    __TIME__);
1848 #  else
1849                     Perl_sv_catpvf(aTHX_ opts_prog,",\"  Compiled on %s\\n\"",
1850                                    __DATE__);
1851 #  endif
1852 #endif
1853                     sv_catpv(opts_prog, "; $\"=\"\\n    \"; "
1854                              "@env = map { \"$_=\\\"$ENV{$_}\\\"\" } "
1855                              "sort grep {/^PERL/} keys %ENV; ");
1856 #ifdef __CYGWIN__
1857                     sv_catpv(opts_prog,
1858                              "push @env, \"CYGWIN=\\\"$ENV{CYGWIN}\\\"\";");
1859 #endif
1860                     sv_catpv(opts_prog, 
1861                              "print \"  \\%ENV:\\n    @env\\n\" if @env;"
1862                              "print \"  \\@INC:\\n    @INC\\n\";");
1863                 }
1864                 else {
1865                     ++s;
1866                     opts_prog = Perl_newSVpvf(aTHX_
1867                                               "Config::config_vars(qw%c%s%c)",
1868                                               0, s, 0);
1869                     s += strlen(s);
1870                 }
1871                 av_push(PL_preambleav, opts_prog);
1872                 /* don't look for script or read stdin */
1873                 scriptname = BIT_BUCKET;
1874                 goto reswitch;
1875             }
1876         case 'x':
1877             PL_doextract = TRUE;
1878             s++;
1879             if (*s)
1880                 cddir = s;
1881             break;
1882         case 0:
1883             break;
1884         case '-':
1885             if (!*++s || isSPACE(*s)) {
1886                 argc--,argv++;
1887                 goto switch_end;
1888             }
1889             /* catch use of gnu style long options */
1890             if (strEQ(s, "version")) {
1891                 s = (char *)"v";
1892                 goto reswitch;
1893             }
1894             if (strEQ(s, "help")) {
1895                 s = (char *)"h";
1896                 goto reswitch;
1897             }
1898             s--;
1899             /* FALL THROUGH */
1900         default:
1901             Perl_croak(aTHX_ "Unrecognized switch: -%s  (-h will show valid options)",s);
1902         }
1903     }
1904   switch_end:
1905
1906     if (
1907 #ifndef SECURE_INTERNAL_GETENV
1908         !PL_tainting &&
1909 #endif
1910         (s = PerlEnv_getenv("PERL5OPT")))
1911     {
1912         const char *popt = s;
1913         while (isSPACE(*s))
1914             s++;
1915         if (*s == '-' && *(s+1) == 'T') {
1916             CHECK_MALLOC_TOO_LATE_FOR('T');
1917             PL_tainting = TRUE;
1918             PL_taint_warn = FALSE;
1919         }
1920         else {
1921             char *popt_copy = Nullch;
1922             while (s && *s) {
1923                 char *d;
1924                 while (isSPACE(*s))
1925                     s++;
1926                 if (*s == '-') {
1927                     s++;
1928                     if (isSPACE(*s))
1929                         continue;
1930                 }
1931                 d = s;
1932                 if (!*s)
1933                     break;
1934                 if (!strchr("DIMUdmtwA", *s))
1935                     Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
1936                 while (++s && *s) {
1937                     if (isSPACE(*s)) {
1938                         if (!popt_copy) {
1939                             popt_copy = SvPVX(sv_2mortal(newSVpv(popt,0)));
1940                             s = popt_copy + (s - popt);
1941                             d = popt_copy + (d - popt);
1942                         }
1943                         *s++ = '\0';
1944                         break;
1945                     }
1946                 }
1947                 if (*d == 't') {
1948                     if( !PL_tainting ) {
1949                         PL_taint_warn = TRUE;
1950                         PL_tainting = TRUE;
1951                     }
1952                 } else {
1953                     moreswitches(d);
1954                 }
1955             }
1956         }
1957     }
1958
1959 #ifdef USE_SITECUSTOMIZE
1960     if (!minus_f) {
1961         if (!PL_preambleav)
1962             PL_preambleav = newAV();
1963         av_unshift(PL_preambleav, 1);
1964         (void)av_store(PL_preambleav, 0, Perl_newSVpvf(aTHX_ "BEGIN { do '%s/sitecustomize.pl' }", SITELIB_EXP));
1965     }
1966 #endif
1967
1968     if (PL_taint_warn && PL_dowarn != G_WARN_ALL_OFF) {
1969        PL_compiling.cop_warnings = newSVpvn(WARN_TAINTstring, WARNsize);
1970     }
1971
1972     if (!scriptname)
1973         scriptname = argv[0];
1974     if (PL_e_script) {
1975         argc++,argv--;
1976         scriptname = BIT_BUCKET;        /* don't look for script or read stdin */
1977     }
1978     else if (scriptname == Nullch) {
1979 #ifdef MSDOS
1980         if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
1981             moreswitches("h");
1982 #endif
1983         scriptname = "-";
1984     }
1985
1986     /* Set $^X early so that it can be used for relocatable paths in @INC  */
1987     assert (!PL_tainted);
1988     TAINT;
1989     S_set_caret_X(aTHX);
1990     TAINT_NOT;
1991     init_perllib();
1992
1993     open_script(scriptname,dosearch,sv);
1994
1995     validate_suid(validarg, scriptname);
1996
1997 #ifndef PERL_MICRO
1998 #if defined(SIGCHLD) || defined(SIGCLD)
1999     {
2000 #ifndef SIGCHLD
2001 #  define SIGCHLD SIGCLD
2002 #endif
2003         Sighandler_t sigstate = rsignal_state(SIGCHLD);
2004         if (sigstate == (Sighandler_t) SIG_IGN) {
2005             if (ckWARN(WARN_SIGNAL))
2006                 Perl_warner(aTHX_ packWARN(WARN_SIGNAL),
2007                             "Can't ignore signal CHLD, forcing to default");
2008             (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
2009         }
2010     }
2011 #endif
2012 #endif
2013
2014 #ifdef MACOS_TRADITIONAL
2015     if (PL_doextract || gMacPerl_AlwaysExtract) {
2016 #else
2017     if (PL_doextract) {
2018 #endif
2019         find_beginning();
2020         if (cddir && PerlDir_chdir( (char *)cddir ) < 0)
2021             Perl_croak(aTHX_ "Can't chdir to %s",cddir);
2022
2023     }
2024
2025     PL_main_cv = PL_compcv = (CV*)NEWSV(1104,0);
2026     sv_upgrade((SV *)PL_compcv, SVt_PVCV);
2027     CvUNIQUE_on(PL_compcv);
2028
2029     CvPADLIST(PL_compcv) = pad_new(0);
2030 #ifdef USE_5005THREADS
2031     CvOWNER(PL_compcv) = 0;
2032     Newx(CvMUTEXP(PL_compcv), 1, perl_mutex);
2033     MUTEX_INIT(CvMUTEXP(PL_compcv));
2034 #endif /* USE_5005THREADS */
2035
2036     boot_core_PerlIO();
2037     boot_core_UNIVERSAL();
2038     boot_core_xsutils();
2039
2040     if (xsinit)
2041         (*xsinit)(aTHX);        /* in case linked C routines want magical variables */
2042 #ifndef PERL_MICRO
2043 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(EPOC)
2044     init_os_extras();
2045 #endif
2046 #endif
2047
2048 #ifdef USE_SOCKS
2049 #   ifdef HAS_SOCKS5_INIT
2050     socks5_init(argv[0]);
2051 #   else
2052     SOCKSinit(argv[0]);
2053 #   endif
2054 #endif
2055
2056     init_predump_symbols();
2057     /* init_postdump_symbols not currently designed to be called */
2058     /* more than once (ENV isn't cleared first, for example)     */
2059     /* But running with -u leaves %ENV & @ARGV undefined!    XXX */
2060     if (!PL_do_undump)
2061         init_postdump_symbols(argc,argv,env);
2062
2063     /* PL_unicode is turned on by -C, or by $ENV{PERL_UNICODE},
2064      * or explicitly in some platforms.
2065      * locale.c:Perl_init_i18nl10n() if the environment
2066      * look like the user wants to use UTF-8. */
2067 #if defined(SYMBIAN)
2068     PL_unicode = PERL_UNICODE_STD_FLAG; /* See PERL_SYMBIAN_CONSOLE_UTF8. */
2069 #endif
2070     if (PL_unicode) {
2071          /* Requires init_predump_symbols(). */
2072          if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
2073               IO* io;
2074               PerlIO* fp;
2075               SV* sv;
2076
2077               /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
2078                * and the default open disciplines. */
2079               if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
2080                   PL_stdingv  && (io = GvIO(PL_stdingv)) &&
2081                   (fp = IoIFP(io)))
2082                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2083               if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
2084                   PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
2085                   (fp = IoOFP(io)))
2086                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2087               if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
2088                   PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
2089                   (fp = IoOFP(io)))
2090                    PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
2091               if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
2092                   (sv = GvSV(gv_fetchpv("\017PEN", TRUE, SVt_PV)))) {
2093                    U32 in  = PL_unicode & PERL_UNICODE_IN_FLAG;
2094                    U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
2095                    if (in) {
2096                         if (out)
2097                              sv_setpvn(sv, ":utf8\0:utf8", 11);
2098                         else
2099                              sv_setpvn(sv, ":utf8\0", 6);
2100                    }
2101                    else if (out)
2102                         sv_setpvn(sv, "\0:utf8", 6);
2103                    SvSETMAGIC(sv);
2104               }
2105          }
2106     }
2107
2108     if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
2109          if (strEQ(s, "unsafe"))
2110               PL_signals |=  PERL_SIGNALS_UNSAFE_FLAG;
2111          else if (strEQ(s, "safe"))
2112               PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
2113          else
2114               Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
2115     }
2116
2117     init_lexer();
2118
2119     /* now parse the script */
2120
2121     SETERRNO(0,SS_NORMAL);
2122     PL_error_count = 0;
2123 #ifdef MACOS_TRADITIONAL
2124     if (gMacPerl_SyntaxError = (yyparse() || PL_error_count)) {
2125         if (PL_minus_c)
2126             Perl_croak(aTHX_ "%s had compilation errors.\n", MacPerl_MPWFileName(PL_origfilename));
2127         else {
2128             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
2129                        MacPerl_MPWFileName(PL_origfilename));
2130         }
2131     }
2132 #else
2133     if (yyparse() || PL_error_count) {
2134         if (PL_minus_c)
2135             Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
2136         else {
2137             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
2138                        PL_origfilename);
2139         }
2140     }
2141 #endif
2142     CopLINE_set(PL_curcop, 0);
2143     PL_curstash = PL_defstash;
2144     PL_preprocess = FALSE;
2145     if (PL_e_script) {
2146         SvREFCNT_dec(PL_e_script);
2147         PL_e_script = Nullsv;
2148     }
2149
2150     if (PL_do_undump)
2151         my_unexec();
2152
2153     if (isWARN_ONCE) {
2154         SAVECOPFILE(PL_curcop);
2155         SAVECOPLINE(PL_curcop);
2156         gv_check(PL_defstash);
2157     }
2158
2159     LEAVE;
2160     FREETMPS;
2161
2162 #ifdef MYMALLOC
2163     if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && atoi(s) >= 2)
2164         dump_mstats("after compilation:");
2165 #endif
2166
2167     ENTER;
2168     PL_restartop = 0;
2169     return NULL;
2170 }
2171
2172 /*
2173 =for apidoc perl_run
2174
2175 Tells a Perl interpreter to run.  See L<perlembed>.
2176
2177 =cut
2178 */
2179
2180 int
2181 perl_run(pTHXx)
2182 {
2183     I32 oldscope;
2184     int ret = 0;
2185     dJMPENV;
2186
2187     PERL_UNUSED_ARG(my_perl);
2188
2189     oldscope = PL_scopestack_ix;
2190 #ifdef VMS
2191     VMSISH_HUSHED = 0;
2192 #endif
2193
2194     JMPENV_PUSH(ret);
2195     switch (ret) {
2196     case 1:
2197         cxstack_ix = -1;                /* start context stack again */
2198         goto redo_body;
2199     case 0:                             /* normal completion */
2200  redo_body:
2201         run_body(oldscope);
2202         /* FALL THROUGH */
2203     case 2:                             /* my_exit() */
2204         while (PL_scopestack_ix > oldscope)
2205             LEAVE;
2206         FREETMPS;
2207         PL_curstash = PL_defstash;
2208         if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
2209             PL_endav && !PL_minus_c)
2210             call_list(oldscope, PL_endav);
2211 #ifdef MYMALLOC
2212         if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
2213             dump_mstats("after execution:  ");
2214 #endif
2215         ret = STATUS_NATIVE_EXPORT;
2216         break;
2217     case 3:
2218         if (PL_restartop) {
2219             POPSTACK_TO(PL_mainstack);
2220             goto redo_body;
2221         }
2222         PerlIO_printf(Perl_error_log, "panic: restartop\n");
2223         FREETMPS;
2224         ret = 1;
2225         break;
2226     }
2227
2228     JMPENV_POP;
2229     return ret;
2230 }
2231
2232
2233 STATIC void
2234 S_run_body(pTHX_ I32 oldscope)
2235 {
2236     DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support.\n",
2237                     PL_sawampersand ? "Enabling" : "Omitting"));
2238
2239     if (!PL_restartop) {
2240         DEBUG_x(dump_all());
2241         if (!DEBUG_q_TEST)
2242           PERL_DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
2243         DEBUG_S(PerlIO_printf(Perl_debug_log, "main thread is 0x%"UVxf"\n",
2244                               PTR2UV(thr)));
2245
2246         if (PL_minus_c) {
2247 #ifdef MACOS_TRADITIONAL
2248             PerlIO_printf(Perl_error_log, "%s%s syntax OK\n",
2249                 (gMacPerl_ErrorFormat ? "# " : ""),
2250                 MacPerl_MPWFileName(PL_origfilename));
2251 #else
2252             PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
2253 #endif
2254             my_exit(0);
2255         }
2256         if (PERLDB_SINGLE && PL_DBsingle)
2257             sv_setiv(PL_DBsingle, 1);
2258         if (PL_initav)
2259             call_list(oldscope, PL_initav);
2260     }
2261
2262     /* do it */
2263
2264     if (PL_restartop) {
2265         PL_op = PL_restartop;
2266         PL_restartop = 0;
2267         CALLRUNOPS(aTHX);
2268     }
2269     else if (PL_main_start) {
2270         CvDEPTH(PL_main_cv) = 1;
2271         PL_op = PL_main_start;
2272         CALLRUNOPS(aTHX);
2273     }
2274     my_exit(0);
2275     /* NOTREACHED */
2276 }
2277
2278 /*
2279 =head1 SV Manipulation Functions
2280
2281 =for apidoc p||get_sv
2282
2283 Returns the SV of the specified Perl scalar.  If C<create> is set and the
2284 Perl variable does not exist then it will be created.  If C<create> is not
2285 set and the variable does not exist then NULL is returned.
2286
2287 =cut
2288 */
2289
2290 SV*
2291 Perl_get_sv(pTHX_ const char *name, I32 create)
2292 {
2293     GV *gv;
2294 #ifdef USE_5005THREADS
2295     if (name[1] == '\0' && !isALPHA(name[0])) {
2296         PADOFFSET tmp = find_threadsv(name);
2297         if (tmp != NOT_IN_PAD)
2298             return THREADSV(tmp);
2299     }
2300 #endif /* USE_5005THREADS */
2301     gv = gv_fetchpv(name, create, SVt_PV);
2302     if (gv)
2303         return GvSV(gv);
2304     return Nullsv;
2305 }
2306
2307 /*
2308 =head1 Array Manipulation Functions
2309
2310 =for apidoc p||get_av
2311
2312 Returns the AV of the specified Perl array.  If C<create> is set and the
2313 Perl variable does not exist then it will be created.  If C<create> is not
2314 set and the variable does not exist then NULL is returned.
2315
2316 =cut
2317 */
2318
2319 AV*
2320 Perl_get_av(pTHX_ const char *name, I32 create)
2321 {
2322     GV* gv = gv_fetchpv(name, create, SVt_PVAV);
2323     if (create)
2324         return GvAVn(gv);
2325     if (gv)
2326         return GvAV(gv);
2327     return Nullav;
2328 }
2329
2330 /*
2331 =head1 Hash Manipulation Functions
2332
2333 =for apidoc p||get_hv
2334
2335 Returns the HV of the specified Perl hash.  If C<create> is set and the
2336 Perl variable does not exist then it will be created.  If C<create> is not
2337 set and the variable does not exist then NULL is returned.
2338
2339 =cut
2340 */
2341
2342 HV*
2343 Perl_get_hv(pTHX_ const char *name, I32 create)
2344 {
2345     GV* const gv = gv_fetchpv(name, create, SVt_PVHV);
2346     if (create)
2347         return GvHVn(gv);
2348     if (gv)
2349         return GvHV(gv);
2350     return Nullhv;
2351 }
2352
2353 /*
2354 =head1 CV Manipulation Functions
2355
2356 =for apidoc p||get_cv
2357
2358 Returns the CV of the specified Perl subroutine.  If C<create> is set and
2359 the Perl subroutine does not exist then it will be declared (which has the
2360 same effect as saying C<sub name;>).  If C<create> is not set and the
2361 subroutine does not exist then NULL is returned.
2362
2363 =cut
2364 */
2365
2366 CV*
2367 Perl_get_cv(pTHX_ const char *name, I32 create)
2368 {
2369     GV* gv = gv_fetchpv(name, create, SVt_PVCV);
2370     /* XXX unsafe for threads if eval_owner isn't held */
2371     /* XXX this is probably not what they think they're getting.
2372      * It has the same effect as "sub name;", i.e. just a forward
2373      * declaration! */
2374     if (create && !GvCVu(gv))
2375         return newSUB(start_subparse(FALSE, 0),
2376                       newSVOP(OP_CONST, 0, newSVpv(name,0)),
2377                       Nullop,
2378                       Nullop);
2379     if (gv)
2380         return GvCVu(gv);
2381     return Nullcv;
2382 }
2383
2384 /* Be sure to refetch the stack pointer after calling these routines. */
2385
2386 /*
2387
2388 =head1 Callback Functions
2389
2390 =for apidoc p||call_argv
2391
2392 Performs a callback to the specified Perl sub.  See L<perlcall>.
2393
2394 =cut
2395 */
2396
2397 I32
2398 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, register char **argv)
2399
2400                         /* See G_* flags in cop.h */
2401                         /* null terminated arg list */
2402 {
2403     dSP;
2404
2405     PUSHMARK(SP);
2406     if (argv) {
2407         while (*argv) {
2408             XPUSHs(sv_2mortal(newSVpv(*argv,0)));
2409             argv++;
2410         }
2411         PUTBACK;
2412     }
2413     return call_pv(sub_name, flags);
2414 }
2415
2416 /*
2417 =for apidoc p||call_pv
2418
2419 Performs a callback to the specified Perl sub.  See L<perlcall>.
2420
2421 =cut
2422 */
2423
2424 I32
2425 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
2426                         /* name of the subroutine */
2427                         /* See G_* flags in cop.h */
2428 {
2429     return call_sv((SV*)get_cv(sub_name, TRUE), flags);
2430 }
2431
2432 /*
2433 =for apidoc p||call_method
2434
2435 Performs a callback to the specified Perl method.  The blessed object must
2436 be on the stack.  See L<perlcall>.
2437
2438 =cut
2439 */
2440
2441 I32
2442 Perl_call_method(pTHX_ const char *methname, I32 flags)
2443                         /* name of the subroutine */
2444                         /* See G_* flags in cop.h */
2445 {
2446     return call_sv(sv_2mortal(newSVpv(methname,0)), flags | G_METHOD);
2447 }
2448
2449 /* May be called with any of a CV, a GV, or an SV containing the name. */
2450 /*
2451 =for apidoc p||call_sv
2452
2453 Performs a callback to the Perl sub whose name is in the SV.  See
2454 L<perlcall>.
2455
2456 =cut
2457 */
2458
2459 I32
2460 Perl_call_sv(pTHX_ SV *sv, I32 flags)
2461                         /* See G_* flags in cop.h */
2462 {
2463     dVAR; dSP;
2464     LOGOP myop;         /* fake syntax tree node */
2465     UNOP method_op;
2466     I32 oldmark;
2467     volatile I32 retval = 0;
2468     I32 oldscope;
2469     bool oldcatch = CATCH_GET;
2470     int ret;
2471     OP* oldop = PL_op;
2472     dJMPENV;
2473
2474     if (flags & G_DISCARD) {
2475         ENTER;
2476         SAVETMPS;
2477     }
2478
2479     Zero(&myop, 1, LOGOP);
2480     myop.op_next = Nullop;
2481     if (!(flags & G_NOARGS))
2482         myop.op_flags |= OPf_STACKED;
2483     myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
2484                       (flags & G_ARRAY) ? OPf_WANT_LIST :
2485                       OPf_WANT_SCALAR);
2486     SAVEOP();
2487     PL_op = (OP*)&myop;
2488
2489     EXTEND(PL_stack_sp, 1);
2490     *++PL_stack_sp = sv;
2491     oldmark = TOPMARK;
2492     oldscope = PL_scopestack_ix;
2493
2494     if (PERLDB_SUB && PL_curstash != PL_debstash
2495            /* Handle first BEGIN of -d. */
2496           && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
2497            /* Try harder, since this may have been a sighandler, thus
2498             * curstash may be meaningless. */
2499           && (SvTYPE(sv) != SVt_PVCV || CvSTASH((CV*)sv) != PL_debstash)
2500           && !(flags & G_NODEBUG))
2501         PL_op->op_private |= OPpENTERSUB_DB;
2502
2503     if (flags & G_METHOD) {
2504         Zero(&method_op, 1, UNOP);
2505         method_op.op_next = PL_op;
2506         method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
2507         myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
2508         PL_op = (OP*)&method_op;
2509     }
2510
2511     if (!(flags & G_EVAL)) {
2512         CATCH_SET(TRUE);
2513         call_body((OP*)&myop, FALSE);
2514         retval = PL_stack_sp - (PL_stack_base + oldmark);
2515         CATCH_SET(oldcatch);
2516     }
2517     else {
2518         myop.op_other = (OP*)&myop;
2519         PL_markstack_ptr--;
2520         /* we're trying to emulate pp_entertry() here */
2521         {
2522             register PERL_CONTEXT *cx;
2523             const I32 gimme = GIMME_V;
2524         
2525             ENTER;
2526             SAVETMPS;
2527         
2528             PUSHBLOCK(cx, (CXt_EVAL|CXp_TRYBLOCK), PL_stack_sp);
2529             PUSHEVAL(cx, 0, 0);
2530             PL_eval_root = PL_op;             /* Only needed so that goto works right. */
2531         
2532             PL_in_eval = EVAL_INEVAL;
2533             if (flags & G_KEEPERR)
2534                 PL_in_eval |= EVAL_KEEPERR;
2535             else
2536                 sv_setpvn(ERRSV,"",0);
2537         }
2538         PL_markstack_ptr++;
2539
2540         JMPENV_PUSH(ret);
2541         switch (ret) {
2542         case 0:
2543  redo_body:
2544             call_body((OP*)&myop, FALSE);
2545             retval = PL_stack_sp - (PL_stack_base + oldmark);
2546             if (!(flags & G_KEEPERR))
2547                 sv_setpvn(ERRSV,"",0);
2548             break;
2549         case 1:
2550             STATUS_ALL_FAILURE;
2551             /* FALL THROUGH */
2552         case 2:
2553             /* my_exit() was called */
2554             PL_curstash = PL_defstash;
2555             FREETMPS;
2556             JMPENV_POP;
2557             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2558                 Perl_croak(aTHX_ "Callback called exit");
2559             my_exit_jump();
2560             /* NOTREACHED */
2561         case 3:
2562             if (PL_restartop) {
2563                 PL_op = PL_restartop;
2564                 PL_restartop = 0;
2565                 goto redo_body;
2566             }
2567             PL_stack_sp = PL_stack_base + oldmark;
2568             if (flags & G_ARRAY)
2569                 retval = 0;
2570             else {
2571                 retval = 1;
2572                 *++PL_stack_sp = &PL_sv_undef;
2573             }
2574             break;
2575         }
2576
2577         if (PL_scopestack_ix > oldscope) {
2578             SV **newsp;
2579             PMOP *newpm;
2580             I32 gimme;
2581             register PERL_CONTEXT *cx;
2582             I32 optype;
2583
2584             POPBLOCK(cx,newpm);
2585             POPEVAL(cx);
2586             PL_curpm = newpm;
2587             LEAVE;
2588             PERL_UNUSED_VAR(newsp);
2589             PERL_UNUSED_VAR(gimme);
2590             PERL_UNUSED_VAR(optype);
2591         }
2592         JMPENV_POP;
2593     }
2594
2595     if (flags & G_DISCARD) {
2596         PL_stack_sp = PL_stack_base + oldmark;
2597         retval = 0;
2598         FREETMPS;
2599         LEAVE;
2600     }
2601     PL_op = oldop;
2602     return retval;
2603 }
2604
2605 STATIC void
2606 S_call_body(pTHX_ const OP *myop, bool is_eval)
2607 {
2608     if (PL_op == myop) {
2609         if (is_eval)
2610             PL_op = Perl_pp_entereval(aTHX);    /* this doesn't do a POPMARK */
2611         else
2612             PL_op = Perl_pp_entersub(aTHX);     /* this does */
2613     }
2614     if (PL_op)
2615         CALLRUNOPS(aTHX);
2616 }
2617
2618 /* Eval a string. The G_EVAL flag is always assumed. */
2619
2620 /*
2621 =for apidoc p||eval_sv
2622
2623 Tells Perl to C<eval> the string in the SV.
2624
2625 =cut
2626 */
2627
2628 I32
2629 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
2630
2631                         /* See G_* flags in cop.h */
2632 {
2633     dSP;
2634     UNOP myop;          /* fake syntax tree node */
2635     volatile I32 oldmark = SP - PL_stack_base;
2636     volatile I32 retval = 0;
2637     int ret;
2638     OP* oldop = PL_op;
2639     dJMPENV;
2640
2641     if (flags & G_DISCARD) {
2642         ENTER;
2643         SAVETMPS;
2644     }
2645
2646     SAVEOP();
2647     PL_op = (OP*)&myop;
2648     Zero(PL_op, 1, UNOP);
2649     EXTEND(PL_stack_sp, 1);
2650     *++PL_stack_sp = sv;
2651
2652     if (!(flags & G_NOARGS))
2653         myop.op_flags = OPf_STACKED;
2654     myop.op_next = Nullop;
2655     myop.op_type = OP_ENTEREVAL;
2656     myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
2657                       (flags & G_ARRAY) ? OPf_WANT_LIST :
2658                       OPf_WANT_SCALAR);
2659     if (flags & G_KEEPERR)
2660         myop.op_flags |= OPf_SPECIAL;
2661
2662     /* fail now; otherwise we could fail after the JMPENV_PUSH but
2663      * before a PUSHEVAL, which corrupts the stack after a croak */
2664     TAINT_PROPER("eval_sv()");
2665
2666     JMPENV_PUSH(ret);
2667     switch (ret) {
2668     case 0:
2669  redo_body:
2670         call_body((OP*)&myop,TRUE);
2671         retval = PL_stack_sp - (PL_stack_base + oldmark);
2672         if (!(flags & G_KEEPERR))
2673             sv_setpvn(ERRSV,"",0);
2674         break;
2675     case 1:
2676         STATUS_ALL_FAILURE;
2677         /* FALL THROUGH */
2678     case 2:
2679         /* my_exit() was called */
2680         PL_curstash = PL_defstash;
2681         FREETMPS;
2682         JMPENV_POP;
2683         if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2684             Perl_croak(aTHX_ "Callback called exit");
2685         my_exit_jump();
2686         /* NOTREACHED */
2687     case 3:
2688         if (PL_restartop) {
2689             PL_op = PL_restartop;
2690             PL_restartop = 0;
2691             goto redo_body;
2692         }
2693         PL_stack_sp = PL_stack_base + oldmark;
2694         if (flags & G_ARRAY)
2695             retval = 0;
2696         else {
2697             retval = 1;
2698             *++PL_stack_sp = &PL_sv_undef;
2699         }
2700         break;
2701     }
2702
2703     JMPENV_POP;
2704     if (flags & G_DISCARD) {
2705         PL_stack_sp = PL_stack_base + oldmark;
2706         retval = 0;
2707         FREETMPS;
2708         LEAVE;
2709     }
2710     PL_op = oldop;
2711     return retval;
2712 }
2713
2714 /*
2715 =for apidoc p||eval_pv
2716
2717 Tells Perl to C<eval> the given string and return an SV* result.
2718
2719 =cut
2720 */
2721
2722 SV*
2723 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
2724 {
2725     dSP;
2726     SV* sv = newSVpv(p, 0);
2727
2728     eval_sv(sv, G_SCALAR);
2729     SvREFCNT_dec(sv);
2730
2731     SPAGAIN;
2732     sv = POPs;
2733     PUTBACK;
2734
2735     if (croak_on_error && SvTRUE(ERRSV)) {
2736         Perl_croak(aTHX_ SvPVx_nolen_const(ERRSV));
2737     }
2738
2739     return sv;
2740 }
2741
2742 /* Require a module. */
2743
2744 /*
2745 =head1 Embedding Functions
2746
2747 =for apidoc p||require_pv
2748
2749 Tells Perl to C<require> the file named by the string argument.  It is
2750 analogous to the Perl code C<eval "require '$file'">.  It's even
2751 implemented that way; consider using load_module instead.
2752
2753 =cut */
2754
2755 void
2756 Perl_require_pv(pTHX_ const char *pv)
2757 {
2758     SV* sv;
2759     dSP;
2760     PUSHSTACKi(PERLSI_REQUIRE);
2761     PUTBACK;
2762     sv = Perl_newSVpvf(aTHX_ "require q%c%s%c", 0, pv, 0);
2763     eval_sv(sv_2mortal(sv), G_DISCARD);
2764     SPAGAIN;
2765     POPSTACK;
2766 }
2767
2768 void
2769 Perl_magicname(pTHX_ const char *sym, const char *name, I32 namlen)
2770 {
2771     register GV *gv;
2772
2773     if ((gv = gv_fetchpv(sym,TRUE, SVt_PV)))
2774         sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, namlen);
2775 }
2776
2777 STATIC void
2778 S_usage(pTHX_ const char *name)         /* XXX move this out into a module ? */
2779 {
2780     /* This message really ought to be max 23 lines.
2781      * Removed -h because the user already knows that option. Others? */
2782
2783     static const char * const usage_msg[] = {
2784 "-0[octal]         specify record separator (\\0, if no argument)",
2785 "-A[mod][=pattern] activate all/given assertions",
2786 "-a                autosplit mode with -n or -p (splits $_ into @F)",
2787 "-C[number/list]   enables the listed Unicode features",
2788 "-c                check syntax only (runs BEGIN and CHECK blocks)",
2789 "-d[:debugger]     run program under debugger",
2790 "-D[number/list]   set debugging flags (argument is a bit mask or alphabets)",
2791 "-e program        one line of program (several -e's allowed, omit programfile)",
2792 "-f                don't do $sitelib/sitecustomize.pl at startup",
2793 "-F/pattern/       split() pattern for -a switch (//'s are optional)",
2794 "-i[extension]     edit <> files in place (makes backup if extension supplied)",
2795 "-Idirectory       specify @INC/#include directory (several -I's allowed)",
2796 "-l[octal]         enable line ending processing, specifies line terminator",
2797 "-[mM][-]module    execute \"use/no module...\" before executing program",
2798 "-n                assume \"while (<>) { ... }\" loop around program",
2799 "-p                assume loop like -n but print line also, like sed",
2800 "-P                run program through C preprocessor before compilation",
2801 "-s                enable rudimentary parsing for switches after programfile",
2802 "-S                look for programfile using PATH environment variable",
2803 "-t                enable tainting warnings",
2804 "-T                enable tainting checks",
2805 "-u                dump core after parsing program",
2806 "-U                allow unsafe operations",
2807 "-v                print version, subversion (includes VERY IMPORTANT perl info)",
2808 "-V[:variable]     print configuration summary (or a single Config.pm variable)",
2809 "-w                enable many useful warnings (RECOMMENDED)",
2810 "-W                enable all warnings",
2811 "-x[directory]     strip off text before #!perl line and perhaps cd to directory",
2812 "-X                disable all warnings",
2813 "\n",
2814 NULL
2815 };
2816     const char * const *p = usage_msg;
2817
2818     PerlIO_printf(PerlIO_stdout(),
2819                   "\nUsage: %s [switches] [--] [programfile] [arguments]",
2820                   name);
2821     while (*p)
2822         PerlIO_printf(PerlIO_stdout(), "\n  %s", *p++);
2823 }
2824
2825 /* convert a string of -D options (or digits) into an int.
2826  * sets *s to point to the char after the options */
2827
2828 #ifdef DEBUGGING
2829 int
2830 Perl_get_debug_opts(pTHX_ const char **s, bool givehelp)
2831 {
2832     static const char * const usage_msgd[] = {
2833       " Debugging flag values: (see also -d)",
2834       "  p  Tokenizing and parsing (with v, displays parse stack)",
2835       "  s  Stack snapshots (with v, displays all stacks)",
2836       "  l  Context (loop) stack processing",
2837       "  t  Trace execution",
2838       "  o  Method and overloading resolution",
2839       "  c  String/numeric conversions",
2840       "  P  Print profiling info, preprocessor command for -P, source file input state",
2841       "  m  Memory allocation",
2842       "  f  Format processing",
2843       "  r  Regular expression parsing and execution",
2844       "  x  Syntax tree dump",
2845       "  u  Tainting checks",
2846       "  H  Hash dump -- usurps values()",
2847       "  X  Scratchpad allocation",
2848       "  D  Cleaning up",
2849       "  S  Thread synchronization",
2850       "  T  Tokenising",
2851       "  R  Include reference counts of dumped variables (eg when using -Ds)",
2852       "  J  Do not s,t,P-debug (Jump over) opcodes within package DB",
2853       "  v  Verbose: use in conjunction with other flags",
2854       "  C  Copy On Write",
2855       "  A  Consistency checks on internal structures",
2856       "  q  quiet - currently only suppresses the 'EXECUTING' message",
2857       NULL
2858     };
2859     int i = 0;
2860     if (isALPHA(**s)) {
2861         /* if adding extra options, remember to update DEBUG_MASK */
2862         static const char debopts[] = "psltocPmfrxu HXDSTRJvCAq";
2863
2864         for (; isALNUM(**s); (*s)++) {
2865             const char *d = strchr(debopts,**s);
2866             if (d)
2867                 i |= 1 << (d - debopts);
2868             else if (ckWARN_d(WARN_DEBUGGING))
2869                 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2870                     "invalid option -D%c, use -D'' to see choices\n", **s);
2871         }
2872     }
2873     else if (isDIGIT(**s)) {
2874         i = atoi(*s);
2875         for (; isALNUM(**s); (*s)++) ;
2876     }
2877     else if (givehelp) {
2878       char **p = (char **)usage_msgd;
2879       while (*p) PerlIO_printf(PerlIO_stdout(), "%s\n", *p++);
2880     }
2881 #  ifdef EBCDIC
2882     if ((i & DEBUG_p_FLAG) && ckWARN_d(WARN_DEBUGGING))
2883         Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2884                 "-Dp not implemented on this platform\n");
2885 #  endif
2886     return i;
2887 }
2888 #endif
2889
2890 /* This routine handles any switches that can be given during run */
2891
2892 char *
2893 Perl_moreswitches(pTHX_ char *s)
2894 {
2895     dVAR;
2896     UV rschar;
2897
2898     switch (*s) {
2899     case '0':
2900     {
2901          I32 flags = 0;
2902          STRLEN numlen;
2903
2904          SvREFCNT_dec(PL_rs);
2905          if (s[1] == 'x' && s[2]) {
2906               const char *e = s+=2;
2907               U8 *tmps;
2908
2909               while (*e)
2910                 e++;
2911               numlen = e - s;
2912               flags = PERL_SCAN_SILENT_ILLDIGIT;
2913               rschar = (U32)grok_hex(s, &numlen, &flags, NULL);
2914               if (s + numlen < e) {
2915                    rschar = 0; /* Grandfather -0xFOO as -0 -xFOO. */
2916                    numlen = 0;
2917                    s--;
2918               }
2919               PL_rs = newSVpvn("", 0);
2920               SvGROW(PL_rs, (STRLEN)(UNISKIP(rschar) + 1));
2921               tmps = (U8*)SvPVX(PL_rs);
2922               uvchr_to_utf8(tmps, rschar);
2923               SvCUR_set(PL_rs, UNISKIP(rschar));
2924               SvUTF8_on(PL_rs);
2925          }
2926          else {
2927               numlen = 4;
2928               rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
2929               if (rschar & ~((U8)~0))
2930                    PL_rs = &PL_sv_undef;
2931               else if (!rschar && numlen >= 2)
2932                    PL_rs = newSVpvn("", 0);
2933               else {
2934                    char ch = (char)rschar;
2935                    PL_rs = newSVpvn(&ch, 1);
2936               }
2937          }
2938          sv_setsv(get_sv("/", TRUE), PL_rs);
2939          return s + numlen;
2940     }
2941     case 'C':
2942         s++;
2943         PL_unicode = parse_unicode_opts( (const char **)&s );
2944         return s;
2945     case 'F':
2946         PL_minus_F = TRUE;
2947         PL_splitstr = ++s;
2948         while (*s && !isSPACE(*s)) ++s;
2949         *s = '\0';
2950         PL_splitstr = savepv(PL_splitstr);
2951         return s;
2952     case 'a':
2953         PL_minus_a = TRUE;
2954         s++;
2955         return s;
2956     case 'c':
2957         PL_minus_c = TRUE;
2958         s++;
2959         return s;
2960     case 'd':
2961         forbid_setid("-d");
2962         s++;
2963
2964         /* -dt indicates to the debugger that threads will be used */
2965         if (*s == 't' && !isALNUM(s[1])) {
2966             ++s;
2967             my_setenv("PERL5DB_THREADED", "1");
2968         }
2969
2970         /* The following permits -d:Mod to accepts arguments following an =
2971            in the fashion that -MSome::Mod does. */
2972         if (*s == ':' || *s == '=') {
2973             const char *start;
2974             SV *sv;
2975             sv = newSVpv("use Devel::", 0);
2976             start = ++s;
2977             /* We now allow -d:Module=Foo,Bar */
2978             while(isALNUM(*s) || *s==':') ++s;
2979             if (*s != '=')
2980                 sv_catpv(sv, start);
2981             else {
2982                 sv_catpvn(sv, start, s-start);
2983                 Perl_sv_catpvf(aTHX_ sv, " split(/,/,q%c%s%c)", 0, ++s, 0);
2984             }
2985             s += strlen(s);
2986             my_setenv("PERL5DB", SvPV_nolen_const(sv));
2987         }
2988         if (!PL_perldb) {
2989             PL_perldb = PERLDB_ALL;
2990             init_debugger();
2991         }
2992         return s;
2993     case 'D':
2994     {   
2995 #ifdef DEBUGGING
2996         forbid_setid("-D");
2997         s++;
2998         PL_debug = get_debug_opts( (const char **)&s, 1) | DEBUG_TOP_FLAG;
2999 #else /* !DEBUGGING */
3000         if (ckWARN_d(WARN_DEBUGGING))
3001             Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
3002                    "Recompile perl with -DDEBUGGING to use -D switch (did you mean -d ?)\n");
3003         for (s++; isALNUM(*s); s++) ;
3004 #endif
3005         return s;
3006     }   
3007     case 'h':
3008         usage(PL_origargv[0]);
3009         my_exit(0);
3010     case 'i':
3011         Safefree(PL_inplace);
3012 #if defined(__CYGWIN__) /* do backup extension automagically */
3013         if (*(s+1) == '\0') {
3014         PL_inplace = savepv(".bak");
3015         return s+1;
3016         }
3017 #endif /* __CYGWIN__ */
3018         PL_inplace = savepv(s+1);
3019         for (s = PL_inplace; *s && !isSPACE(*s); s++)
3020             ;
3021         if (*s) {
3022             *s++ = '\0';
3023             if (*s == '-')      /* Additional switches on #! line. */
3024                 s++;
3025         }
3026         return s;
3027     case 'I':   /* -I handled both here and in parse_body() */
3028         forbid_setid("-I");
3029         ++s;
3030         while (*s && isSPACE(*s))
3031             ++s;
3032         if (*s) {
3033             char *e, *p;
3034             p = s;
3035             /* ignore trailing spaces (possibly followed by other switches) */
3036             do {
3037                 for (e = p; *e && !isSPACE(*e); e++) ;
3038                 p = e;
3039                 while (isSPACE(*p))
3040                     p++;
3041             } while (*p && *p != '-');
3042             e = savepvn(s, e-s);
3043             incpush(e, TRUE, TRUE, FALSE, FALSE);
3044             Safefree(e);
3045             s = p;
3046             if (*s == '-')
3047                 s++;
3048         }
3049         else
3050             Perl_croak(aTHX_ "No directory specified for -I");
3051         return s;
3052     case 'l':
3053         PL_minus_l = TRUE;
3054         s++;
3055         if (PL_ors_sv) {
3056             SvREFCNT_dec(PL_ors_sv);
3057             PL_ors_sv = Nullsv;
3058         }
3059         if (isDIGIT(*s)) {
3060             I32 flags = 0;
3061             STRLEN numlen;
3062             PL_ors_sv = newSVpvn("\n",1);
3063             numlen = 3 + (*s == '0');
3064             *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
3065             s += numlen;
3066         }
3067         else {
3068             if (RsPARA(PL_rs)) {
3069                 PL_ors_sv = newSVpvn("\n\n",2);
3070             }
3071             else {
3072                 PL_ors_sv = newSVsv(PL_rs);
3073             }
3074         }
3075         return s;
3076     case 'A':
3077         forbid_setid("-A");
3078         if (!PL_preambleav)
3079             PL_preambleav = newAV();
3080         s++;
3081         {
3082             char *start = s;
3083             SV *sv = newSVpv("use assertions::activate", 24);
3084             while(isALNUM(*s) || *s == ':') ++s;
3085             if (s != start) {
3086                 sv_catpvn(sv, "::", 2);
3087                 sv_catpvn(sv, start, s-start);
3088             }
3089             if (*s == '=') {
3090                 Perl_sv_catpvf(aTHX_ sv, " split(/,/,q%c%s%c)", 0, ++s, 0);
3091                 s+=strlen(s);
3092             }
3093             else if (*s != '\0') {
3094                 Perl_croak(aTHX_ "Can't use '%c' after -A%.*s", *s, s-start, start);
3095             }
3096             av_push(PL_preambleav, sv);
3097             return s;
3098         }
3099     case 'M':
3100         forbid_setid("-M");     /* XXX ? */
3101         /* FALL THROUGH */
3102     case 'm':
3103         forbid_setid("-m");     /* XXX ? */
3104         if (*++s) {
3105             char *start;
3106             SV *sv;
3107             const char *use = "use ";
3108             /* -M-foo == 'no foo'       */
3109             /* Leading space on " no " is deliberate, to make both
3110                possibilities the same length.  */
3111             if (*s == '-') { use = " no "; ++s; }
3112             sv = newSVpvn(use,4);
3113             start = s;
3114             /* We allow -M'Module qw(Foo Bar)'  */
3115             while(isALNUM(*s) || *s==':') ++s;
3116             if (*s != '=') {
3117                 sv_catpv(sv, start);
3118                 if (*(start-1) == 'm') {
3119                     if (*s != '\0')
3120                         Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
3121                     sv_catpv( sv, " ()");
3122                 }
3123             } else {
3124                 if (s == start)
3125                     Perl_croak(aTHX_ "Module name required with -%c option",
3126                                s[-1]);
3127                 sv_catpvn(sv, start, s-start);
3128                 sv_catpv(sv, " split(/,/,q");
3129                 sv_catpvn(sv, "\0)", 1);        /* Use NUL as q//-delimiter. */
3130                 sv_catpv(sv, ++s);
3131                 sv_catpvn(sv,  "\0)", 2);
3132             }
3133             s += strlen(s);
3134             if (!PL_preambleav)
3135                 PL_preambleav = newAV();
3136             av_push(PL_preambleav, sv);
3137         }
3138         else
3139             Perl_croak(aTHX_ "Missing argument to -%c", *(s-1));
3140         return s;
3141     case 'n':
3142         PL_minus_n = TRUE;
3143         s++;
3144         return s;
3145     case 'p':
3146         PL_minus_p = TRUE;
3147         s++;
3148         return s;
3149     case 's':
3150         forbid_setid("-s");
3151         PL_doswitches = TRUE;
3152         s++;
3153         return s;
3154     case 't':
3155         if (!PL_tainting)
3156             TOO_LATE_FOR('t');
3157         s++;
3158         return s;
3159     case 'T':
3160         if (!PL_tainting)
3161             TOO_LATE_FOR('T');
3162         s++;
3163         return s;
3164     case 'u':
3165 #ifdef MACOS_TRADITIONAL
3166         Perl_croak(aTHX_ "Believe me, you don't want to use \"-u\" on a Macintosh");
3167 #endif
3168         PL_do_undump = TRUE;
3169         s++;
3170         return s;
3171     case 'U':
3172         PL_unsafe = TRUE;
3173         s++;
3174         return s;
3175     case 'v':
3176         if (!sv_derived_from(PL_patchlevel, "version"))
3177                 (void *)upg_version(PL_patchlevel);
3178 #if !defined(DGUX)
3179         PerlIO_printf(PerlIO_stdout(),
3180                 Perl_form(aTHX_ "\nThis is perl, %"SVf" built for %s",
3181                     vstringify(PL_patchlevel),
3182                     ARCHNAME));
3183 #else /* DGUX */
3184 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
3185         PerlIO_printf(PerlIO_stdout(),
3186                 Perl_form(aTHX_ "\nThis is perl, %"SVf"\n",
3187                     vstringify(PL_patchlevel)));
3188         PerlIO_printf(PerlIO_stdout(),
3189                         Perl_form(aTHX_ "        built under %s at %s %s\n",
3190                                         OSNAME, __DATE__, __TIME__));
3191         PerlIO_printf(PerlIO_stdout(),
3192                         Perl_form(aTHX_ "        OS Specific Release: %s\n",
3193                                         OSVERS));
3194 #endif /* !DGUX */
3195
3196 #if defined(LOCAL_PATCH_COUNT)
3197         if (LOCAL_PATCH_COUNT > 0)
3198             PerlIO_printf(PerlIO_stdout(),
3199                           "\n(with %d registered patch%s, "
3200                           "see perl -V for more detail)",
3201                           (int)LOCAL_PATCH_COUNT,
3202                           (LOCAL_PATCH_COUNT!=1) ? "es" : "");
3203 #endif
3204
3205         PerlIO_printf(PerlIO_stdout(),
3206                       "\n\nCopyright 1987-2005, Larry Wall\n");
3207 #ifdef MACOS_TRADITIONAL
3208         PerlIO_printf(PerlIO_stdout(),
3209                       "\nMac OS port Copyright 1991-2002, Matthias Neeracher;\n"
3210                       "maintained by Chris Nandor\n");
3211 #endif
3212 #ifdef MSDOS
3213         PerlIO_printf(PerlIO_stdout(),
3214                       "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
3215 #endif
3216 #ifdef DJGPP
3217         PerlIO_printf(PerlIO_stdout(),
3218                       "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
3219                       "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
3220 #endif
3221 #ifdef OS2
3222         PerlIO_printf(PerlIO_stdout(),
3223                       "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
3224                       "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
3225 #endif
3226 #ifdef atarist
3227         PerlIO_printf(PerlIO_stdout(),
3228                       "atariST series port, ++jrb  bammi@cadence.com\n");
3229 #endif
3230 #ifdef __BEOS__
3231         PerlIO_printf(PerlIO_stdout(),
3232                       "BeOS port Copyright Tom Spindler, 1997-1999\n");
3233 #endif
3234 #ifdef MPE
3235         PerlIO_printf(PerlIO_stdout(),
3236                       "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2003\n");
3237 #endif
3238 #ifdef OEMVS
3239         PerlIO_printf(PerlIO_stdout(),
3240                       "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
3241 #endif
3242 #ifdef __VOS__
3243         PerlIO_printf(PerlIO_stdout(),
3244                       "Stratus VOS port by Paul.Green@stratus.com, 1997-2002\n");
3245 #endif
3246 #ifdef __OPEN_VM
3247         PerlIO_printf(PerlIO_stdout(),
3248                       "VM/ESA port by Neale Ferguson, 1998-1999\n");
3249 #endif
3250 #ifdef POSIX_BC
3251         PerlIO_printf(PerlIO_stdout(),
3252                       "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
3253 #endif
3254 #ifdef __MINT__
3255         PerlIO_printf(PerlIO_stdout(),
3256                       "MiNT port by Guido Flohr, 1997-1999\n");
3257 #endif
3258 #ifdef EPOC
3259         PerlIO_printf(PerlIO_stdout(),
3260                       "EPOC port by Olaf Flebbe, 1999-2002\n");
3261 #endif
3262 #ifdef UNDER_CE
3263         PerlIO_printf(PerlIO_stdout(),"WINCE port by Rainer Keuchel, 2001-2002\n");
3264         PerlIO_printf(PerlIO_stdout(),"Built on " __DATE__ " " __TIME__ "\n\n");
3265         wce_hitreturn();
3266 #endif
3267 #ifdef SYMBIAN
3268         PerlIO_printf(PerlIO_stdout(),
3269                       "Symbian port by Nokia, 2004-2005\n");
3270 #endif
3271 #ifdef BINARY_BUILD_NOTICE
3272         BINARY_BUILD_NOTICE;
3273 #endif
3274         PerlIO_printf(PerlIO_stdout(),
3275                       "\n\
3276 Perl may be copied only under the terms of either the Artistic License or the\n\
3277 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
3278 Complete documentation for Perl, including FAQ lists, should be found on\n\
3279 this system using \"man perl\" or \"perldoc perl\".  If you have access to the\n\
3280 Internet, point your browser at http://www.perl.org/, the Perl Home Page.\n\n");
3281         my_exit(0);
3282     case 'w':
3283         if (! (PL_dowarn & G_WARN_ALL_MASK))
3284             PL_dowarn |= G_WARN_ON;
3285         s++;
3286         return s;
3287     case 'W':
3288         PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
3289         if (!specialWARN(PL_compiling.cop_warnings))
3290             SvREFCNT_dec(PL_compiling.cop_warnings);
3291         PL_compiling.cop_warnings = pWARN_ALL ;
3292         s++;
3293         return s;
3294     case 'X':
3295         PL_dowarn = G_WARN_ALL_OFF;
3296         if (!specialWARN(PL_compiling.cop_warnings))
3297             SvREFCNT_dec(PL_compiling.cop_warnings);
3298         PL_compiling.cop_warnings = pWARN_NONE ;
3299         s++;
3300         return s;
3301     case '*':
3302     case ' ':
3303         if (s[1] == '-')        /* Additional switches on #! line. */
3304             return s+2;
3305         break;
3306     case '-':
3307     case 0:
3308 #if defined(WIN32) || !defined(PERL_STRICT_CR)
3309     case '\r':
3310 #endif
3311     case '\n':
3312     case '\t':
3313         break;
3314 #ifdef ALTERNATE_SHEBANG
3315     case 'S':                   /* OS/2 needs -S on "extproc" line. */
3316         break;
3317 #endif
3318     case 'P':
3319         if (PL_preprocess)
3320             return s+1;
3321         /* FALL THROUGH */
3322     default:
3323         Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
3324     }
3325     return Nullch;
3326 }
3327
3328 /* compliments of Tom Christiansen */
3329
3330 /* unexec() can be found in the Gnu emacs distribution */
3331 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
3332
3333 void
3334 Perl_my_unexec(pTHX)
3335 {
3336 #ifdef UNEXEC
3337     SV*    prog;
3338     SV*    file;
3339     int    status = 1;
3340     extern int etext;
3341
3342     prog = newSVpv(BIN_EXP, 0);
3343     sv_catpv(prog, "/perl");
3344     file = newSVpv(PL_origfilename, 0);
3345     sv_catpv(file, ".perldump");
3346
3347     unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
3348     /* unexec prints msg to stderr in case of failure */
3349     PerlProc_exit(status);
3350 #else
3351 #  ifdef VMS
3352 #    include <lib$routines.h>
3353      lib$signal(SS$_DEBUG);  /* ssdef.h #included from vmsish.h */
3354 #  else
3355     ABORT();            /* for use with undump */
3356 #  endif
3357 #endif
3358 }
3359
3360 /* initialize curinterp */
3361 STATIC void
3362 S_init_interp(pTHX)
3363 {
3364
3365 #ifdef MULTIPLICITY
3366 #  define PERLVAR(var,type)
3367 #  define PERLVARA(var,n,type)
3368 #  if defined(PERL_IMPLICIT_CONTEXT)
3369 #    if defined(USE_5005THREADS)
3370 #      define PERLVARI(var,type,init)           PERL_GET_INTERP->var = init;
3371 #      define PERLVARIC(var,type,init)          PERL_GET_INTERP->var = init;
3372 #    else /* !USE_5005THREADS */
3373 #      define PERLVARI(var,type,init)           aTHX->var = init;
3374 #      define PERLVARIC(var,type,init)  aTHX->var = init;
3375 #    endif /* USE_5005THREADS */
3376 #  else
3377 #    define PERLVARI(var,type,init)     PERL_GET_INTERP->var = init;
3378 #    define PERLVARIC(var,type,init)    PERL_GET_INTERP->var = init;
3379 #  endif
3380 #  include "intrpvar.h"
3381 #  ifndef USE_5005THREADS
3382 #    include "thrdvar.h"
3383 #  endif
3384 #  undef PERLVAR
3385 #  undef PERLVARA
3386 #  undef PERLVARI
3387 #  undef PERLVARIC
3388 #else
3389 #  define PERLVAR(var,type)
3390 #  define PERLVARA(var,n,type)
3391 #  define PERLVARI(var,type,init)       PL_##var = init;
3392 #  define PERLVARIC(var,type,init)      PL_##var = init;
3393 #  include "intrpvar.h"
3394 #  ifndef USE_5005THREADS
3395 #    include "thrdvar.h"
3396 #  endif
3397 #  undef PERLVAR
3398 #  undef PERLVARA
3399 #  undef PERLVARI
3400 #  undef PERLVARIC
3401 #endif
3402
3403 }
3404
3405 STATIC void
3406 S_init_main_stash(pTHX)
3407 {
3408     GV *gv;
3409
3410     PL_curstash = PL_defstash = newHV();
3411     PL_curstname = newSVpvn("main",4);
3412     gv = gv_fetchpv("main::",TRUE, SVt_PVHV);
3413     SvREFCNT_dec(GvHV(gv));
3414     GvHV(gv) = (HV*)SvREFCNT_inc(PL_defstash);
3415     SvREADONLY_on(gv);
3416     Perl_hv_name_set(aTHX_ PL_defstash, "main", 4, 0);
3417     PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpv("INC",TRUE, SVt_PVAV)));
3418     GvMULTI_on(PL_incgv);
3419     PL_hintgv = gv_fetchpv("\010",TRUE, SVt_PV); /* ^H */
3420     GvMULTI_on(PL_hintgv);
3421     PL_defgv = gv_fetchpv("_",TRUE, SVt_PVAV);
3422     PL_errgv = gv_HVadd(gv_fetchpv("@", TRUE, SVt_PV));
3423     GvMULTI_on(PL_errgv);
3424     PL_replgv = gv_fetchpv("\022", TRUE, SVt_PV); /* ^R */
3425     GvMULTI_on(PL_replgv);
3426     (void)Perl_form(aTHX_ "%240s","");  /* Preallocate temp - for immediate signals. */
3427 #ifdef PERL_DONT_CREATE_GVSV
3428     gv_SVadd(PL_errgv);
3429 #endif
3430     sv_grow(ERRSV, 240);        /* Preallocate - for immediate signals. */
3431     sv_setpvn(ERRSV, "", 0);
3432     PL_curstash = PL_defstash;
3433     CopSTASH_set(&PL_compiling, PL_defstash);
3434     PL_debstash = GvHV(gv_fetchpv("DB::", GV_ADDMULTI, SVt_PVHV));
3435     PL_globalstash = GvHV(gv_fetchpv("CORE::GLOBAL::", GV_ADDMULTI, SVt_PVHV));
3436     /* We must init $/ before switches are processed. */
3437     sv_setpvn(get_sv("/", TRUE), "\n", 1);
3438 }
3439
3440 /* PSz 18 Nov 03  fdscript now global but do not change prototype */
3441 STATIC void
3442 S_open_script(pTHX_ const char *scriptname, bool dosearch, SV *sv)
3443 {
3444 #ifndef IAMSUID
3445     const char *quote;
3446     const char *code;
3447     const char *cpp_discard_flag;
3448     const char *perl;
3449 #endif
3450     dVAR;
3451
3452     PL_fdscript = -1;
3453     PL_suidscript = -1;
3454
3455     if (PL_e_script) {
3456         PL_origfilename = savepvn("-e", 2);
3457     }
3458     else {
3459         /* if find_script() returns, it returns a malloc()-ed value */
3460         scriptname = PL_origfilename = find_script(scriptname, dosearch, NULL, 1);
3461
3462         if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
3463             const char *s = scriptname + 8;
3464             PL_fdscript = atoi(s);
3465             while (isDIGIT(*s))
3466                 s++;
3467             if (*s) {
3468                 /* PSz 18 Feb 04
3469                  * Tell apart "normal" usage of fdscript, e.g.
3470                  * with bash on FreeBSD:
3471                  *   perl <( echo '#!perl -DA'; echo 'print "$0\n"')
3472                  * from usage in suidperl.
3473                  * Does any "normal" usage leave garbage after the number???
3474                  * Is it a mistake to use a similar /dev/fd/ construct for
3475                  * suidperl?
3476                  */
3477                 PL_suidscript = 1;
3478                 /* PSz 20 Feb 04  
3479                  * Be supersafe and do some sanity-checks.
3480                  * Still, can we be sure we got the right thing?
3481                  */
3482                 if (*s != '/') {
3483                     Perl_croak(aTHX_ "Wrong syntax (suid) fd script name \"%s\"\n", s);
3484                 }
3485                 if (! *(s+1)) {
3486                     Perl_croak(aTHX_ "Missing (suid) fd script name\n");
3487                 }
3488                 scriptname = savepv(s + 1);
3489                 Safefree(PL_origfilename);
3490                 PL_origfilename = (char *)scriptname;
3491             }
3492         }
3493     }
3494
3495     CopFILE_free(PL_curcop);
3496     CopFILE_set(PL_curcop, PL_origfilename);
3497     if (*PL_origfilename == '-' && PL_origfilename[1] == '\0')
3498         scriptname = (char *)"";
3499     if (PL_fdscript >= 0) {
3500         PL_rsfp = PerlIO_fdopen(PL_fdscript,PERL_SCRIPT_MODE);
3501 #       if defined(HAS_FCNTL) && defined(F_SETFD)
3502             if (PL_rsfp)
3503                 /* ensure close-on-exec */
3504                 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
3505 #       endif
3506     }
3507 #ifdef IAMSUID
3508     else {
3509         Perl_croak(aTHX_ "sperl needs fd script\n"
3510                    "You should not call sperl directly; do you need to "
3511                    "change a #! line\nfrom sperl to perl?\n");
3512
3513 /* PSz 11 Nov 03
3514  * Do not open (or do other fancy stuff) while setuid.
3515  * Perl does the open, and hands script to suidperl on a fd;
3516  * suidperl only does some checks, sets up UIDs and re-execs
3517  * perl with that fd as it has always done.
3518  */
3519     }
3520     if (PL_suidscript != 1) {
3521         Perl_croak(aTHX_ "suidperl needs (suid) fd script\n");
3522     }
3523 #else /* IAMSUID */
3524     else if (PL_preprocess) {
3525         const char *cpp_cfg = CPPSTDIN;
3526         SV *cpp = newSVpvn("",0);
3527         SV *cmd = NEWSV(0,0);
3528
3529         if (cpp_cfg[0] == 0) /* PERL_MICRO? */
3530              Perl_croak(aTHX_ "Can't run with cpp -P with CPPSTDIN undefined");
3531         if (strEQ(cpp_cfg, "cppstdin"))
3532             Perl_sv_catpvf(aTHX_ cpp, "%s/", BIN_EXP);
3533         sv_catpv(cpp, cpp_cfg);
3534
3535 #       ifndef VMS
3536             sv_catpvn(sv, "-I", 2);
3537             sv_catpv(sv,PRIVLIB_EXP);
3538 #       endif
3539
3540         DEBUG_P(PerlIO_printf(Perl_debug_log,
3541                               "PL_preprocess: scriptname=\"%s\", cpp=\"%s\", sv=\"%s\", CPPMINUS=\"%s\"\n",
3542                               scriptname, SvPVX_const (cpp), SvPVX_const (sv),
3543                               CPPMINUS));
3544
3545 #       if defined(MSDOS) || defined(WIN32) || defined(VMS)
3546             quote = "\"";
3547 #       else
3548             quote = "'";
3549 #       endif
3550
3551 #       ifdef VMS
3552             cpp_discard_flag = "";
3553 #       else
3554             cpp_discard_flag = "-C";
3555 #       endif
3556
3557 #       ifdef OS2
3558             perl = os2_execname(aTHX);
3559 #       else
3560             perl = PL_origargv[0];
3561 #       endif
3562
3563
3564         /* This strips off Perl comments which might interfere with
3565            the C pre-processor, including #!.  #line directives are
3566            deliberately stripped to avoid confusion with Perl's version
3567            of #line.  FWP played some golf with it so it will fit
3568            into VMS's 255 character buffer.
3569         */
3570         if( PL_doextract )
3571             code = "(1../^#!.*perl/i)|/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
3572         else
3573             code = "/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
3574
3575         Perl_sv_setpvf(aTHX_ cmd, "\
3576 %s -ne%s%s%s %s | %"SVf" %s %"SVf" %s",
3577                        perl, quote, code, quote, scriptname, cpp,
3578                        cpp_discard_flag, sv, CPPMINUS);
3579
3580         PL_doextract = FALSE;
3581
3582         DEBUG_P(PerlIO_printf(Perl_debug_log,
3583                               "PL_preprocess: cmd=\"%s\"\n",
3584                               SvPVX_const(cmd)));
3585
3586         PL_rsfp = PerlProc_popen((char *)SvPVX_const(cmd), (char *)"r");
3587         SvREFCNT_dec(cmd);
3588         SvREFCNT_dec(cpp);
3589     }
3590     else if (!*scriptname) {
3591         forbid_setid("program input from stdin");
3592         PL_rsfp = PerlIO_stdin();
3593     }
3594     else {
3595         PL_rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
3596 #       if defined(HAS_FCNTL) && defined(F_SETFD)
3597             if (PL_rsfp)
3598                 /* ensure close-on-exec */
3599                 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
3600 #       endif
3601     }
3602 #endif /* IAMSUID */
3603     if (!PL_rsfp) {
3604         /* PSz 16 Sep 03  Keep neat error message */
3605         Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
3606                 CopFILE(PL_curcop), Strerror(errno));
3607     }
3608 }
3609
3610 /* Mention
3611  * I_SYSSTATVFS HAS_FSTATVFS
3612  * I_SYSMOUNT
3613  * I_STATFS     HAS_FSTATFS     HAS_GETFSSTAT
3614  * I_MNTENT     HAS_GETMNTENT   HAS_HASMNTOPT
3615  * here so that metaconfig picks them up. */
3616
3617 #ifdef IAMSUID
3618 STATIC int
3619 S_fd_on_nosuid_fs(pTHX_ int fd)
3620 {
3621 /* PSz 27 Feb 04
3622  * We used to do this as "plain" user (after swapping UIDs with setreuid);
3623  * but is needed also on machines without setreuid.
3624  * Seems safe enough to run as root.
3625  */
3626     int check_okay = 0; /* able to do all the required sys/libcalls */
3627     int on_nosuid  = 0; /* the fd is on a nosuid fs */
3628     /* PSz 12 Nov 03
3629      * Need to check noexec also: nosuid might not be set, the average
3630      * sysadmin would say that nosuid is irrelevant once he sets noexec.
3631      */
3632     int on_noexec  = 0; /* the fd is on a noexec fs */
3633
3634 /*
3635  * Preferred order: fstatvfs(), fstatfs(), ustat()+getmnt(), getmntent().
3636  * fstatvfs() is UNIX98.
3637  * fstatfs() is 4.3 BSD.
3638  * ustat()+getmnt() is pre-4.3 BSD.
3639  * getmntent() is O(number-of-mounted-filesystems) and can hang on
3640  * an irrelevant filesystem while trying to reach the right one.
3641  */
3642
3643 #undef FD_ON_NOSUID_CHECK_OKAY  /* found the syscalls to do the check? */
3644
3645 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
3646         defined(HAS_FSTATVFS)
3647 #   define FD_ON_NOSUID_CHECK_OKAY
3648     struct statvfs stfs;
3649
3650     check_okay = fstatvfs(fd, &stfs) == 0;
3651     on_nosuid  = check_okay && (stfs.f_flag  & ST_NOSUID);
3652 #ifdef ST_NOEXEC
3653     /* ST_NOEXEC certainly absent on AIX 5.1, and doesn't seem to be documented
3654        on platforms where it is present.  */
3655     on_noexec  = check_okay && (stfs.f_flag  & ST_NOEXEC);
3656 #endif
3657 #   endif /* fstatvfs */
3658
3659 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
3660         defined(PERL_MOUNT_NOSUID)      && \
3661         defined(PERL_MOUNT_NOEXEC)      && \
3662         defined(HAS_FSTATFS)            && \
3663         defined(HAS_STRUCT_STATFS)      && \
3664         defined(HAS_STRUCT_STATFS_F_FLAGS)
3665 #   define FD_ON_NOSUID_CHECK_OKAY
3666     struct statfs  stfs;
3667
3668     check_okay = fstatfs(fd, &stfs)  == 0;
3669     on_nosuid  = check_okay && (stfs.f_flags & PERL_MOUNT_NOSUID);
3670     on_noexec  = check_okay && (stfs.f_flags & PERL_MOUNT_NOEXEC);
3671 #   endif /* fstatfs */
3672
3673 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
3674         defined(PERL_MOUNT_NOSUID)      && \
3675         defined(PERL_MOUNT_NOEXEC)      && \
3676         defined(HAS_FSTAT)              && \
3677         defined(HAS_USTAT)              && \
3678         defined(HAS_GETMNT)             && \
3679         defined(HAS_STRUCT_FS_DATA)     && \
3680         defined(NOSTAT_ONE)
3681 #   define FD_ON_NOSUID_CHECK_OKAY
3682     Stat_t fdst;
3683
3684     if (fstat(fd, &fdst) == 0) {
3685         struct ustat us;
3686         if (ustat(fdst.st_dev, &us) == 0) {
3687             struct fs_data fsd;
3688             /* NOSTAT_ONE here because we're not examining fields which
3689              * vary between that case and STAT_ONE. */
3690             if (getmnt((int*)0, &fsd, (int)0, NOSTAT_ONE, us.f_fname) == 0) {
3691                 size_t cmplen = sizeof(us.f_fname);
3692                 if (sizeof(fsd.fd_req.path) < cmplen)
3693                     cmplen = sizeof(fsd.fd_req.path);
3694                 if (strnEQ(fsd.fd_req.path, us.f_fname, cmplen) &&
3695                     fdst.st_dev == fsd.fd_req.dev) {
3696                         check_okay = 1;
3697                         on_nosuid = fsd.fd_req.flags & PERL_MOUNT_NOSUID;
3698                         on_noexec = fsd.fd_req.flags & PERL_MOUNT_NOEXEC;
3699                     }
3700                 }
3701             }
3702         }
3703     }
3704 #   endif /* fstat+ustat+getmnt */
3705
3706 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
3707         defined(HAS_GETMNTENT)          && \
3708         defined(HAS_HASMNTOPT)          && \
3709         defined(MNTOPT_NOSUID)          && \
3710         defined(MNTOPT_NOEXEC)
3711 #   define FD_ON_NOSUID_CHECK_OKAY
3712     FILE                *mtab = fopen("/etc/mtab", "r");
3713     struct mntent       *entry;
3714     Stat_t              stb, fsb;
3715
3716     if (mtab && (fstat(fd, &stb) == 0)) {
3717         while (entry = getmntent(mtab)) {
3718             if (stat(entry->mnt_dir, &fsb) == 0
3719                 && fsb.st_dev == stb.st_dev)
3720             {
3721                 /* found the filesystem */
3722                 check_okay = 1;
3723                 if (hasmntopt(entry, MNTOPT_NOSUID))
3724                     on_nosuid = 1;
3725                 if (hasmntopt(entry, MNTOPT_NOEXEC))
3726                     on_noexec = 1;
3727                 break;
3728             } /* A single fs may well fail its stat(). */
3729         }
3730     }
3731     if (mtab)
3732         fclose(mtab);
3733 #   endif /* getmntent+hasmntopt */
3734
3735     if (!check_okay)
3736         Perl_croak(aTHX_ "Can't check filesystem of script \"%s\" for nosuid/noexec", PL_origfilename);
3737     if (on_nosuid)
3738         Perl_croak(aTHX_ "Setuid script \"%s\" on nosuid filesystem", PL_origfilename);
3739     if (on_noexec)
3740         Perl_croak(aTHX_ "Setuid script \"%s\" on noexec filesystem", PL_origfilename);
3741     return ((!check_okay) || on_nosuid || on_noexec);
3742 }
3743 #endif /* IAMSUID */
3744
3745 STATIC void
3746 S_validate_suid(pTHX_ const char *validarg, const char *scriptname)
3747 {
3748     dVAR;
3749 #ifdef IAMSUID
3750     /* int which; */
3751 #endif /* IAMSUID */
3752
3753     /* do we need to emulate setuid on scripts? */
3754
3755     /* This code is for those BSD systems that have setuid #! scripts disabled
3756      * in the kernel because of a security problem.  Merely defining DOSUID
3757      * in perl will not fix that problem, but if you have disabled setuid
3758      * scripts in the kernel, this will attempt to emulate setuid and setgid
3759      * on scripts that have those now-otherwise-useless bits set.  The setuid
3760      * root version must be called suidperl or sperlN.NNN.  If regular perl
3761      * discovers that it has opened a setuid script, it calls suidperl with
3762      * the same argv that it had.  If suidperl finds that the script it has
3763      * just opened is NOT setuid root, it sets the effective uid back to the
3764      * uid.  We don't just make perl setuid root because that loses the
3765      * effective uid we had before invoking perl, if it was different from the
3766      * uid.
3767      * PSz 27 Feb 04
3768      * Description/comments above do not match current workings:
3769      *   suidperl must be hardlinked to sperlN.NNN (that is what we exec);
3770      *   suidperl called with script open and name changed to /dev/fd/N/X;
3771      *   suidperl croaks if script is not setuid;
3772      *   making perl setuid would be a huge security risk (and yes, that
3773      *     would lose any euid we might have had).
3774      *
3775      * DOSUID must be defined in both perl and suidperl, and IAMSUID must
3776      * be defined in suidperl only.  suidperl must be setuid root.  The
3777      * Configure script will set this up for you if you want it.
3778      */
3779
3780 #ifdef DOSUID
3781     const char *s, *s2;
3782
3783     if (PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf) < 0)  /* normal stat is insecure */
3784         Perl_croak(aTHX_ "Can't stat script \"%s\"",PL_origfilename);
3785     if (PL_statbuf.st_mode & (S_ISUID|S_ISGID)) {
3786         I32 len;
3787         const char *linestr;
3788
3789 #ifdef IAMSUID
3790         if (PL_fdscript < 0 || PL_suidscript != 1)
3791             Perl_croak(aTHX_ "Need (suid) fdscript in suidperl\n");     /* We already checked this */
3792         /* PSz 11 Nov 03
3793          * Since the script is opened by perl, not suidperl, some of these
3794          * checks are superfluous. Leaving them in probably does not lower
3795          * security(?!).
3796          */
3797         /* PSz 27 Feb 04
3798          * Do checks even for systems with no HAS_SETREUID.
3799          * We used to swap, then re-swap UIDs with
3800 #ifdef HAS_SETREUID
3801             if (setreuid(PL_euid,PL_uid) < 0
3802                 || PerlProc_getuid() != PL_euid || PerlProc_geteuid() != PL_uid)
3803                 Perl_croak(aTHX_ "Can't swap uid and euid");
3804 #endif
3805 #ifdef HAS_SETREUID
3806             if (setreuid(PL_uid,PL_euid) < 0
3807                 || PerlProc_getuid() != PL_uid || PerlProc_geteuid() != PL_euid)
3808                 Perl_croak(aTHX_ "Can't reswap uid and euid");
3809 #endif
3810          */
3811
3812         /* On this access check to make sure the directories are readable,
3813          * there is actually a small window that the user could use to make
3814          * filename point to an accessible directory.  So there is a faint
3815          * chance that someone could execute a setuid script down in a
3816          * non-accessible directory.  I don't know what to do about that.
3817          * But I don't think it's too important.  The manual lies when
3818          * it says access() is useful in setuid programs.
3819          * 
3820          * So, access() is pretty useless... but not harmful... do anyway.
3821          */
3822         if (PerlLIO_access(CopFILE(PL_curcop),1)) { /*double check*/
3823             Perl_croak(aTHX_ "Can't access() script\n");
3824         }
3825
3826         /* If we can swap euid and uid, then we can determine access rights
3827          * with a simple stat of the file, and then compare device and
3828          * inode to make sure we did stat() on the same file we opened.
3829          * Then we just have to make sure he or she can execute it.
3830          * 
3831          * PSz 24 Feb 04
3832          * As the script is opened by perl, not suidperl, we do not need to
3833          * care much about access rights.
3834          * 
3835          * The 'script changed' check is needed, or we can get lied to
3836          * about $0 with e.g.
3837          *  suidperl /dev/fd/4//bin/x 4<setuidscript
3838          * Without HAS_SETREUID, is it safe to stat() as root?
3839          * 
3840          * Are there any operating systems that pass /dev/fd/xxx for setuid
3841          * scripts, as suggested/described in perlsec(1)? Surely they do not
3842          * pass the script name as we do, so the "script changed" test would
3843          * fail for them... but we never get here with
3844          * SETUID_SCRIPTS_ARE_SECURE_NOW defined.
3845          * 
3846          * This is one place where we must "lie" about return status: not
3847          * say if the stat() failed. We are doing this as root, and could
3848          * be tricked into reporting existence or not of files that the
3849          * "plain" user cannot even see.
3850          */
3851         {
3852             Stat_t tmpstatbuf;
3853             if (PerlLIO_stat(CopFILE(PL_curcop),&tmpstatbuf) < 0 ||
3854                 tmpstatbuf.st_dev != PL_statbuf.st_dev ||
3855                 tmpstatbuf.st_ino != PL_statbuf.st_ino) {
3856                 Perl_croak(aTHX_ "Setuid script changed\n");
3857             }
3858
3859         }
3860         if (!cando(S_IXUSR,FALSE,&PL_statbuf))          /* can real uid exec? */
3861             Perl_croak(aTHX_ "Real UID cannot exec script\n");
3862
3863         /* PSz 27 Feb 04
3864          * We used to do this check as the "plain" user (after swapping
3865          * UIDs). But the check for nosuid and noexec filesystem is needed,
3866          * and should be done even without HAS_SETREUID. (Maybe those
3867          * operating systems do not have such mount options anyway...)
3868          * Seems safe enough to do as root.
3869          */
3870 #if !defined(NO_NOSUID_CHECK)
3871         if (fd_on_nosuid_fs(PerlIO_fileno(PL_rsfp))) {
3872             Perl_croak(aTHX_ "Setuid script on nosuid or noexec filesystem\n");
3873         }
3874 #endif
3875 #endif /* IAMSUID */
3876
3877         if (!S_ISREG(PL_statbuf.st_mode)) {
3878             Perl_croak(aTHX_ "Setuid script not plain file\n");
3879         }
3880         if (PL_statbuf.st_mode & S_IWOTH)
3881             Perl_croak(aTHX_ "Setuid/gid script is writable by world");
3882         PL_doswitches = FALSE;          /* -s is insecure in suid */
3883         /* PSz 13 Nov 03  But -s was caught elsewhere ... so unsetting it here is useless(?!) */
3884         CopLINE_inc(PL_curcop);
3885         linestr = SvPV_nolen_const(PL_linestr);
3886         if (sv_gets(PL_linestr, PL_rsfp, 0) == Nullch ||
3887           strnNE(linestr,"#!",2) )      /* required even on Sys V */
3888             Perl_croak(aTHX_ "No #! line");
3889         linestr+=2;
3890         s = linestr;
3891         /* PSz 27 Feb 04 */
3892         /* Sanity check on line length */
3893         if (strlen(s) < 1 || strlen(s) > 4000)
3894             Perl_croak(aTHX_ "Very long #! line");
3895         /* Allow more than a single space after #! */
3896         while (isSPACE(*s)) s++;
3897         /* Sanity check on buffer end */
3898         while ((*s) && !isSPACE(*s)) s++;
3899         for (s2 = s;  (s2 > linestr &&
3900                        (isDIGIT(s2[-1]) || s2[-1] == '.' || s2[-1] == '_'
3901                         || s2[-1] == '-'));  s2--) ;
3902         /* Sanity check on buffer start */
3903         if ( (s2-4 < linestr || strnNE(s2-4,"perl",4)) &&
3904               (s-9 < linestr || strnNE(s-9,"perl",4)) )
3905             Perl_croak(aTHX_ "Not a perl script");
3906         while (*s == ' ' || *s == '\t') s++;
3907         /*
3908          * #! arg must be what we saw above.  They can invoke it by
3909          * mentioning suidperl explicitly, but they may not add any strange
3910          * arguments beyond what #! says if they do invoke suidperl that way.
3911          */
3912         /*
3913          * The way validarg was set up, we rely on the kernel to start
3914          * scripts with argv[1] set to contain all #! line switches (the
3915          * whole line).
3916          */
3917         /*
3918          * Check that we got all the arguments listed in the #! line (not
3919          * just that there are no extraneous arguments). Might not matter
3920          * much, as switches from #! line seem to be acted upon (also), and
3921          * so may be checked and trapped in perl. But, security checks must
3922          * be done in suidperl and not deferred to perl. Note that suidperl
3923          * does not get around to parsing (and checking) the switches on
3924          * the #! line (but execs perl sooner).
3925          * Allow (require) a trailing newline (which may be of two
3926          * characters on some architectures?) (but no other trailing
3927          * whitespace).
3928          */
3929         len = strlen(validarg);
3930         if (strEQ(validarg," PHOOEY ") ||
3931             strnNE(s,validarg,len) || !isSPACE(s[len]) ||
3932             !(strlen(s) == len+1 || (strlen(s) == len+2 && isSPACE(s[len+1]))))
3933             Perl_croak(aTHX_ "Args must match #! line");
3934
3935 #ifndef IAMSUID
3936         if (PL_fdscript < 0 &&
3937             PL_euid != PL_uid && (PL_statbuf.st_mode & S_ISUID) &&
3938             PL_euid == PL_statbuf.st_uid)
3939             if (!PL_do_undump)
3940                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3941 FIX YOUR KERNEL, OR PUT A C WRAPPER AROUND THIS SCRIPT!\n");
3942 #endif /* IAMSUID */
3943
3944         if (PL_fdscript < 0 &&
3945             PL_euid) {  /* oops, we're not the setuid root perl */
3946             /* PSz 18 Feb 04
3947              * When root runs a setuid script, we do not go through the same
3948              * steps of execing sperl and then perl with fd scripts, but
3949              * simply set up UIDs within the same perl invocation; so do
3950              * not have the same checks (on options, whatever) that we have
3951              * for plain users. No problem really: would have to be a script
3952              * that does not actually work for plain users; and if root is
3953              * foolish and can be persuaded to run such an unsafe script, he
3954              * might run also non-setuid ones, and deserves what he gets.
3955              * 
3956              * Or, we might drop the PL_euid check above (and rely just on
3957              * PL_fdscript to avoid loops), and do the execs
3958              * even for root.
3959              */
3960 #ifndef IAMSUID
3961             int which;
3962             /* PSz 11 Nov 03
3963              * Pass fd script to suidperl.
3964              * Exec suidperl, substituting fd script for scriptname.
3965              * Pass script name as "subdir" of fd, which perl will grok;
3966              * in fact will use that to distinguish this from "normal"
3967              * usage, see comments above.
3968              */
3969             PerlIO_rewind(PL_rsfp);
3970             PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0);  /* just in case rewind didn't */
3971             /* PSz 27 Feb 04  Sanity checks on scriptname */
3972             if ((!scriptname) || (!*scriptname) ) {
3973                 Perl_croak(aTHX_ "No setuid script name\n");
3974             }
3975             if (*scriptname == '-') {
3976                 Perl_croak(aTHX_ "Setuid script name may not begin with dash\n");
3977                 /* Or we might confuse it with an option when replacing
3978                  * name in argument list, below (though we do pointer, not
3979                  * string, comparisons).
3980                  */
3981             }
3982             for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;
3983             if (!PL_origargv[which]) {
3984                 Perl_croak(aTHX_ "Can't change argv to have fd script\n");
3985             }
3986             PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",
3987                                           PerlIO_fileno(PL_rsfp), PL_origargv[which]));
3988 #if defined(HAS_FCNTL) && defined(F_SETFD)
3989             fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0);    /* ensure no close-on-exec */
3990 #endif
3991             PERL_FPU_PRE_EXEC
3992             PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
3993                                      (int)PERL_REVISION, (int)PERL_VERSION,
3994                                      (int)PERL_SUBVERSION), PL_origargv);
3995             PERL_FPU_POST_EXEC
3996 #endif /* IAMSUID */
3997             Perl_croak(aTHX_ "Can't do setuid (cannot exec sperl)\n");
3998         }
3999
4000         if (PL_statbuf.st_mode & S_ISGID && PL_statbuf.st_gid != PL_egid) {
4001 /* PSz 26 Feb 04
4002  * This seems back to front: we try HAS_SETEGID first; if not available
4003  * then try HAS_SETREGID; as a last chance we try HAS_SETRESGID. May be OK
4004  * in the sense that we only want to set EGID; but are there any machines
4005  * with either of the latter, but not the former? Same with UID, later.
4006  */
4007 #ifdef HAS_SETEGID
4008             (void)setegid(PL_statbuf.st_gid);
4009 #else
4010 #ifdef HAS_SETREGID
4011            (void)setregid((Gid_t)-1,PL_statbuf.st_gid);
4012 #else
4013 #ifdef HAS_SETRESGID
4014            (void)setresgid((Gid_t)-1,PL_statbuf.st_gid,(Gid_t)-1);
4015 #else
4016             PerlProc_setgid(PL_statbuf.st_gid);
4017 #endif
4018 #endif
4019 #endif
4020             if (PerlProc_getegid() != PL_statbuf.st_gid)
4021                 Perl_croak(aTHX_ "Can't do setegid!\n");
4022         }
4023         if (PL_statbuf.st_mode & S_ISUID) {
4024             if (PL_statbuf.st_uid != PL_euid)
4025 #ifdef HAS_SETEUID
4026                 (void)seteuid(PL_statbuf.st_uid);       /* all that for this */
4027 #else
4028 #ifdef HAS_SETREUID
4029                 (void)setreuid((Uid_t)-1,PL_statbuf.st_uid);
4030 #else
4031 #ifdef HAS_SETRESUID
4032                 (void)setresuid((Uid_t)-1,PL_statbuf.st_uid,(Uid_t)-1);
4033 #else
4034                 PerlProc_setuid(PL_statbuf.st_uid);
4035 #endif
4036 #endif
4037 #endif
4038             if (PerlProc_geteuid() != PL_statbuf.st_uid)
4039                 Perl_croak(aTHX_ "Can't do seteuid!\n");
4040         }
4041         else if (PL_uid) {                      /* oops, mustn't run as root */
4042 #ifdef HAS_SETEUID
4043           (void)seteuid((Uid_t)PL_uid);
4044 #else
4045 #ifdef HAS_SETREUID
4046           (void)setreuid((Uid_t)-1,(Uid_t)PL_uid);
4047 #else
4048 #ifdef HAS_SETRESUID
4049           (void)setresuid((Uid_t)-1,(Uid_t)PL_uid,(Uid_t)-1);
4050 #else
4051           PerlProc_setuid((Uid_t)PL_uid);
4052 #endif
4053 #endif
4054 #endif
4055             if (PerlProc_geteuid() != PL_uid)
4056                 Perl_croak(aTHX_ "Can't do seteuid!\n");
4057         }
4058         init_ids();
4059         if (!cando(S_IXUSR,TRUE,&PL_statbuf))
4060             Perl_croak(aTHX_ "Effective UID cannot exec script\n");     /* they can't do this */
4061     }
4062 #ifdef IAMSUID
4063     else if (PL_preprocess)     /* PSz 13 Nov 03  Caught elsewhere, useless(?!) here */
4064         Perl_croak(aTHX_ "-P not allowed for setuid/setgid script\n");
4065     else if (PL_fdscript < 0 || PL_suidscript != 1)
4066         /* PSz 13 Nov 03  Caught elsewhere, useless(?!) here */
4067         Perl_croak(aTHX_ "(suid) fdscript needed in suidperl\n");
4068     else {
4069 /* PSz 16 Sep 03  Keep neat error message */
4070         Perl_croak(aTHX_ "Script is not setuid/setgid in suidperl\n");
4071     }
4072
4073     /* We absolutely must clear out any saved ids here, so we */
4074     /* exec the real perl, substituting fd script for scriptname. */
4075     /* (We pass script name as "subdir" of fd, which perl will grok.) */
4076     /* 
4077      * It might be thought that using setresgid and/or setresuid (changed to
4078      * set the saved IDs) above might obviate the need to exec, and we could
4079      * go on to "do the perl thing".
4080      * 
4081      * Is there such a thing as "saved GID", and is that set for setuid (but
4082      * not setgid) execution like suidperl? Without exec, it would not be
4083      * cleared for setuid (but not setgid) scripts (or might need a dummy
4084      * setresgid).
4085      * 
4086      * We need suidperl to do the exact same argument checking that perl
4087      * does. Thus it cannot be very small; while it could be significantly
4088      * smaller, it is safer (simpler?) to make it essentially the same
4089      * binary as perl (but they are not identical). - Maybe could defer that
4090      * check to the invoked perl, and suidperl be a tiny wrapper instead;
4091      * but prefer to do thorough checks in suidperl itself. Such deferral
4092      * would make suidperl security rely on perl, a design no-no.
4093      * 
4094      * Setuid things should be short and simple, thus easy to understand and
4095      * verify. They should do their "own thing", without influence by
4096      * attackers. It may help if their internal execution flow is fixed,
4097      * regardless of platform: it may be best to exec anyway.
4098      * 
4099      * Suidperl should at least be conceptually simple: a wrapper only,
4100      * never to do any real perl. Maybe we should put
4101      * #ifdef IAMSUID
4102      *         Perl_croak(aTHX_ "Suidperl should never do real perl\n");
4103      * #endif
4104      * into the perly bits.
4105      */
4106     PerlIO_rewind(PL_rsfp);
4107     PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0);  /* just in case rewind didn't */
4108     /* PSz 11 Nov 03
4109      * Keep original arguments: suidperl already has fd script.
4110      */
4111 /*  for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;  */
4112 /*  if (!PL_origargv[which]) {                                          */
4113 /*      errno = EPERM;                                                  */
4114 /*      Perl_croak(aTHX_ "Permission denied\n");                        */
4115 /*  }                                                                   */
4116 /*  PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",        */
4117 /*                                PerlIO_fileno(PL_rsfp), PL_origargv[which])); */
4118 #if defined(HAS_FCNTL) && defined(F_SETFD)
4119     fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0);    /* ensure no close-on-exec */
4120 #endif
4121     PERL_FPU_PRE_EXEC
4122     PerlProc_execv(Perl_form(aTHX_ "%s/perl"PERL_FS_VER_FMT, BIN_EXP,
4123                              (int)PERL_REVISION, (int)PERL_VERSION,
4124                              (int)PERL_SUBVERSION), PL_origargv);/* try again */
4125     PERL_FPU_POST_EXEC
4126     Perl_croak(aTHX_ "Can't do setuid (suidperl cannot exec perl)\n");
4127 #endif /* IAMSUID */
4128 #else /* !DOSUID */
4129     if (PL_euid != PL_uid || PL_egid != PL_gid) {       /* (suidperl doesn't exist, in fact) */
4130 #ifndef SETUID_SCRIPTS_ARE_SECURE_NOW
4131         PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf);      /* may be either wrapped or real suid */
4132         if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
4133             ||
4134             (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
4135            )
4136             if (!PL_do_undump)
4137                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
4138 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
4139 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
4140         /* not set-id, must be wrapped */
4141     }
4142 #endif /* DOSUID */
4143     (void)validarg;
4144     (void)scriptname;
4145 }
4146
4147 STATIC void
4148 S_find_beginning(pTHX)
4149 {
4150     register char *s;
4151     register const char *s2;
4152 #ifdef MACOS_TRADITIONAL
4153     int maclines = 0;
4154 #endif
4155
4156     /* skip forward in input to the real script? */
4157
4158     forbid_setid("-x");
4159 #ifdef MACOS_TRADITIONAL
4160     /* Since the Mac OS does not honor #! arguments for us, we do it ourselves */
4161
4162     while (PL_doextract || gMacPerl_AlwaysExtract) {
4163         if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
4164             if (!gMacPerl_AlwaysExtract)
4165                 Perl_croak(aTHX_ "No Perl script found in input\n");
4166
4167             if (PL_doextract)                   /* require explicit override ? */
4168                 if (!OverrideExtract(PL_origfilename))
4169                     Perl_croak(aTHX_ "User aborted script\n");
4170                 else
4171                     PL_doextract = FALSE;
4172
4173             /* Pater peccavi, file does not have #! */
4174             PerlIO_rewind(PL_rsfp);
4175
4176             break;
4177         }
4178 #else
4179     while (PL_doextract) {
4180         if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch)
4181             Perl_croak(aTHX_ "No Perl script found in input\n");
4182 #endif
4183         s2 = s;
4184         if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
4185             PerlIO_ungetc(PL_rsfp, '\n');               /* to keep line count right */
4186             PL_doextract = FALSE;
4187             while (*s && !(isSPACE (*s) || *s == '#')) s++;
4188             s2 = s;
4189             while (*s == ' ' || *s == '\t') s++;
4190             if (*s++ == '-') {
4191                 while (isDIGIT(s2[-1]) || s2[-1] == '-' || s2[-1] == '.'
4192                        || s2[-1] == '_') s2--;
4193                 if (strnEQ(s2-4,"perl",4))
4194                     while ((s = moreswitches(s)))
4195                         ;
4196             }
4197 #ifdef MACOS_TRADITIONAL
4198             /* We are always searching for the #!perl line in MacPerl,
4199              * so if we find it, still keep the line count correct
4200              * by counting lines we already skipped over
4201              */
4202             for (; maclines > 0 ; maclines--)
4203                 PerlIO_ungetc(PL_rsfp, '\n');
4204
4205             break;
4206
4207         /* gMacPerl_AlwaysExtract is false in MPW tool */
4208         } else if (gMacPerl_AlwaysExtract) {
4209             ++maclines;
4210 #endif
4211         }
4212     }
4213 }
4214
4215
4216 STATIC void
4217 S_init_ids(pTHX)
4218 {
4219     PL_uid = PerlProc_getuid();
4220     PL_euid = PerlProc_geteuid();
4221     PL_gid = PerlProc_getgid();
4222     PL_egid = PerlProc_getegid();
4223 #ifdef VMS
4224     PL_uid |= PL_gid << 16;
4225     PL_euid |= PL_egid << 16;
4226 #endif
4227     /* Should not happen: */
4228     CHECK_MALLOC_TAINT(PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
4229     PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
4230     /* BUG */
4231     /* PSz 27 Feb 04
4232      * Should go by suidscript, not uid!=euid: why disallow
4233      * system("ls") in scripts run from setuid things?
4234      * Or, is this run before we check arguments and set suidscript?
4235      * What about SETUID_SCRIPTS_ARE_SECURE_NOW: could we use fdscript then?
4236      * (We never have suidscript, can we be sure to have fdscript?)
4237      * Or must then go by UID checks? See comments in forbid_setid also.
4238      */
4239 }
4240
4241 /* This is used very early in the lifetime of the program,
4242  * before even the options are parsed, so PL_tainting has
4243  * not been initialized properly.  */
4244 bool
4245 Perl_doing_taint(int argc, char *argv[], char *envp[])
4246 {
4247 #ifndef PERL_IMPLICIT_SYS
4248     /* If we have PERL_IMPLICIT_SYS we can't call getuid() et alia
4249      * before we have an interpreter-- and the whole point of this
4250      * function is to be called at such an early stage.  If you are on
4251      * a system with PERL_IMPLICIT_SYS but you do have a concept of
4252      * "tainted because running with altered effective ids', you'll
4253      * have to add your own checks somewhere in here.  The two most
4254      * known samples of 'implicitness' are Win32 and NetWare, neither
4255      * of which has much of concept of 'uids'. */
4256     int uid  = PerlProc_getuid();
4257     int euid = PerlProc_geteuid();
4258     int gid  = PerlProc_getgid();
4259     int egid = PerlProc_getegid();
4260     (void)envp;
4261
4262 #ifdef VMS
4263     uid  |=  gid << 16;
4264     euid |= egid << 16;
4265 #endif
4266     if (uid && (euid != uid || egid != gid))
4267         return 1;
4268 #endif /* !PERL_IMPLICIT_SYS */
4269     /* This is a really primitive check; environment gets ignored only
4270      * if -T are the first chars together; otherwise one gets
4271      *  "Too late" message. */
4272     if ( argc > 1 && argv[1][0] == '-'
4273          && (argv[1][1] == 't' || argv[1][1] == 'T') )
4274         return 1;
4275     return 0;
4276 }
4277
4278 STATIC void
4279 S_forbid_setid(pTHX_ const char *s)
4280 {
4281 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
4282     if (PL_euid != PL_uid)
4283         Perl_croak(aTHX_ "No %s allowed while running setuid", s);
4284     if (PL_egid != PL_gid)
4285         Perl_croak(aTHX_ "No %s allowed while running setgid", s);
4286 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
4287     /* PSz 29 Feb 04
4288      * Checks for UID/GID above "wrong": why disallow
4289      *   perl -e 'print "Hello\n"'
4290      * from within setuid things?? Simply drop them: replaced by
4291      * fdscript/suidscript and #ifdef IAMSUID checks below.
4292      * 
4293      * This may be too late for command-line switches. Will catch those on
4294      * the #! line, after finding the script name and setting up
4295      * fdscript/suidscript. Note that suidperl does not get around to
4296      * parsing (and checking) the switches on the #! line, but checks that
4297      * the two sets are identical.
4298      * 
4299      * With SETUID_SCRIPTS_ARE_SECURE_NOW, could we use fdscript, also or
4300      * instead, or would that be "too late"? (We never have suidscript, can
4301      * we be sure to have fdscript?)
4302      * 
4303      * Catch things with suidscript (in descendant of suidperl), even with
4304      * right UID/GID. Was already checked in suidperl, with #ifdef IAMSUID,
4305      * below; but I am paranoid.
4306      * 
4307      * Also see comments about root running a setuid script, elsewhere.
4308      */
4309     if (PL_suidscript >= 0)
4310         Perl_croak(aTHX_ "No %s allowed with (suid) fdscript", s);
4311 #ifdef IAMSUID
4312     /* PSz 11 Nov 03  Catch it in suidperl, always! */
4313     Perl_croak(aTHX_ "No %s allowed in suidperl", s);
4314 #endif /* IAMSUID */
4315 }
4316
4317 void
4318 Perl_init_debugger(pTHX)
4319 {
4320     HV *ostash = PL_curstash;
4321
4322     PL_curstash = PL_debstash;
4323     PL_dbargs = GvAV(gv_AVadd((gv_fetchpv("DB::args", GV_ADDMULTI, SVt_PVAV))));
4324     AvREAL_off(PL_dbargs);
4325     PL_DBgv = gv_fetchpv("DB::DB", GV_ADDMULTI, SVt_PVGV);
4326     PL_DBline = gv_fetchpv("DB::dbline", GV_ADDMULTI, SVt_PVAV);
4327     PL_DBsub = gv_HVadd(gv_fetchpv("DB::sub", GV_ADDMULTI, SVt_PVHV));
4328     PL_DBsingle = GvSV((gv_fetchpv("DB::single", GV_ADDMULTI, SVt_PV)));
4329     sv_setiv(PL_DBsingle, 0);
4330     PL_DBtrace = GvSV((gv_fetchpv("DB::trace", GV_ADDMULTI, SVt_PV)));
4331     sv_setiv(PL_DBtrace, 0);
4332     PL_DBsignal = GvSV((gv_fetchpv("DB::signal", GV_ADDMULTI, SVt_PV)));
4333     sv_setiv(PL_DBsignal, 0);
4334     PL_DBassertion = GvSV((gv_fetchpv("DB::assertion", GV_ADDMULTI, SVt_PV)));
4335     sv_setiv(PL_DBassertion, 0);
4336     PL_curstash = ostash;
4337 }
4338
4339 #ifndef STRESS_REALLOC
4340 #define REASONABLE(size) (size)
4341 #else
4342 #define REASONABLE(size) (1) /* unreasonable */
4343 #endif
4344
4345 void
4346 Perl_init_stacks(pTHX)
4347 {
4348     /* start with 128-item stack and 8K cxstack */
4349     PL_curstackinfo = new_stackinfo(REASONABLE(128),
4350                                  REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
4351     PL_curstackinfo->si_type = PERLSI_MAIN;
4352     PL_curstack = PL_curstackinfo->si_stack;
4353     PL_mainstack = PL_curstack;         /* remember in case we switch stacks */
4354
4355     PL_stack_base = AvARRAY(PL_curstack);
4356     PL_stack_sp = PL_stack_base;
4357     PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
4358
4359     Newx(PL_tmps_stack,REASONABLE(128),SV*);
4360     PL_tmps_floor = -1;
4361     PL_tmps_ix = -1;
4362     PL_tmps_max = REASONABLE(128);
4363
4364     Newx(PL_markstack,REASONABLE(32),I32);
4365     PL_markstack_ptr = PL_markstack;
4366     PL_markstack_max = PL_markstack + REASONABLE(32);
4367
4368     SET_MARK_OFFSET;
4369
4370     Newx(PL_scopestack,REASONABLE(32),I32);
4371     PL_scopestack_ix = 0;
4372     PL_scopestack_max = REASONABLE(32);
4373
4374     Newx(PL_savestack,REASONABLE(128),ANY);
4375     PL_savestack_ix = 0;
4376     PL_savestack_max = REASONABLE(128);
4377 }
4378
4379 #undef REASONABLE
4380
4381 STATIC void
4382 S_nuke_stacks(pTHX)
4383 {
4384     while (PL_curstackinfo->si_next)
4385         PL_curstackinfo = PL_curstackinfo->si_next;
4386     while (PL_curstackinfo) {
4387         PERL_SI *p = PL_curstackinfo->si_prev;
4388         /* curstackinfo->si_stack got nuked by sv_free_arenas() */
4389         Safefree(PL_curstackinfo->si_cxstack);
4390         Safefree(PL_curstackinfo);
4391         PL_curstackinfo = p;
4392     }
4393     Safefree(PL_tmps_stack);
4394     Safefree(PL_markstack);
4395     Safefree(PL_scopestack);
4396     Safefree(PL_savestack);
4397 }
4398
4399 STATIC void
4400 S_init_lexer(pTHX)
4401 {
4402     PerlIO *tmpfp;
4403     tmpfp = PL_rsfp;
4404     PL_rsfp = Nullfp;
4405     lex_start(PL_linestr);
4406     PL_rsfp = tmpfp;
4407     PL_subname = newSVpvn("main",4);
4408 }
4409
4410 STATIC void
4411 S_init_predump_symbols(pTHX)
4412 {
4413     GV *tmpgv;
4414     IO *io;
4415
4416     sv_setpvn(get_sv("\"", TRUE), " ", 1);
4417     PL_stdingv = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
4418     GvMULTI_on(PL_stdingv);
4419     io = GvIOp(PL_stdingv);
4420     IoTYPE(io) = IoTYPE_RDONLY;
4421     IoIFP(io) = PerlIO_stdin();
4422     tmpgv = gv_fetchpv("stdin",TRUE, SVt_PV);
4423     GvMULTI_on(tmpgv);
4424     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
4425
4426     tmpgv = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
4427     GvMULTI_on(tmpgv);
4428     io = GvIOp(tmpgv);
4429     IoTYPE(io) = IoTYPE_WRONLY;
4430     IoOFP(io) = IoIFP(io) = PerlIO_stdout();
4431     setdefout(tmpgv);
4432     tmpgv = gv_fetchpv("stdout",TRUE, SVt_PV);
4433     GvMULTI_on(tmpgv);
4434     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
4435
4436     PL_stderrgv = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
4437     GvMULTI_on(PL_stderrgv);
4438     io = GvIOp(PL_stderrgv);
4439     IoTYPE(io) = IoTYPE_WRONLY;
4440     IoOFP(io) = IoIFP(io) = PerlIO_stderr();
4441     tmpgv = gv_fetchpv("stderr",TRUE, SVt_PV);
4442     GvMULTI_on(tmpgv);
4443     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
4444
4445     PL_statname = NEWSV(66,0);          /* last filename we did stat on */
4446
4447     Safefree(PL_osname);
4448     PL_osname = savepv(OSNAME);
4449 }
4450
4451 void
4452 Perl_init_argv_symbols(pTHX_ register int argc, register char **argv)
4453 {
4454     argc--,argv++;      /* skip name of script */
4455     if (PL_doswitches) {
4456         for (; argc > 0 && **argv == '-'; argc--,argv++) {
4457             char *s;
4458             if (!argv[0][1])
4459                 break;
4460             if (argv[0][1] == '-' && !argv[0][2]) {
4461                 argc--,argv++;
4462                 break;
4463             }
4464             if ((s = strchr(argv[0], '='))) {
4465                 *s++ = '\0';
4466                 sv_setpv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),s);
4467             }
4468             else
4469                 sv_setiv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),1);
4470         }
4471     }
4472     if ((PL_argvgv = gv_fetchpv("ARGV",TRUE, SVt_PVAV))) {
4473         GvMULTI_on(PL_argvgv);
4474         (void)gv_AVadd(PL_argvgv);
4475         av_clear(GvAVn(PL_argvgv));
4476         for (; argc > 0; argc--,argv++) {
4477             SV * const sv = newSVpv(argv[0],0);
4478             av_push(GvAVn(PL_argvgv),sv);
4479             if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
4480                  if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
4481                       SvUTF8_on(sv);
4482             }
4483             if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
4484                  (void)sv_utf8_decode(sv);
4485         }
4486     }
4487 }
4488
4489 STATIC void
4490 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
4491 {
4492     dVAR;
4493     GV* tmpgv;
4494
4495     PL_toptarget = NEWSV(0,0);
4496     sv_upgrade(PL_toptarget, SVt_PVFM);
4497     sv_setpvn(PL_toptarget, "", 0);
4498     PL_bodytarget = NEWSV(0,0);
4499     sv_upgrade(PL_bodytarget, SVt_PVFM);
4500     sv_setpvn(PL_bodytarget, "", 0);
4501     PL_formtarget = PL_bodytarget;
4502
4503     TAINT;
4504
4505     init_argv_symbols(argc,argv);
4506
4507     if ((tmpgv = gv_fetchpv("0",TRUE, SVt_PV))) {
4508 #ifdef MACOS_TRADITIONAL
4509         /* $0 is not majick on a Mac */
4510         sv_setpv(GvSV(tmpgv),MacPerl_MPWFileName(PL_origfilename));
4511 #else
4512         sv_setpv(GvSV(tmpgv),PL_origfilename);
4513         magicname("0", "0", 1);
4514 #endif
4515     }
4516     if ((PL_envgv = gv_fetchpv("ENV",TRUE, SVt_PVHV))) {
4517         HV *hv;
4518         GvMULTI_on(PL_envgv);
4519         hv = GvHVn(PL_envgv);
4520         hv_magic(hv, Nullgv, PERL_MAGIC_env);
4521 #ifndef PERL_MICRO
4522 #ifdef USE_ENVIRON_ARRAY
4523         /* Note that if the supplied env parameter is actually a copy
4524            of the global environ then it may now point to free'd memory
4525            if the environment has been modified since. To avoid this
4526            problem we treat env==NULL as meaning 'use the default'
4527         */
4528         if (!env)
4529             env = environ;
4530         if (env != environ
4531 #  ifdef USE_ITHREADS
4532             && PL_curinterp == aTHX
4533 #  endif
4534            )
4535         {
4536             environ[0] = Nullch;
4537         }
4538         if (env) {
4539           char** origenv = environ;
4540           char *s;
4541           SV *sv;
4542           for (; *env; env++) {
4543             if (!(s = strchr(*env,'=')) || s == *env)
4544                 continue;
4545 #if defined(MSDOS) && !defined(DJGPP)
4546             *s = '\0';
4547             (void)strupr(*env);
4548             *s = '=';
4549 #endif
4550             sv = newSVpv(s+1, 0);
4551             (void)hv_store(hv, *env, s - *env, sv, 0);
4552             if (env != environ)
4553                 mg_set(sv);
4554             if (origenv != environ) {
4555               /* realloc has shifted us */
4556               env = (env - origenv) + environ;
4557               origenv = environ;
4558             }
4559           }
4560       }
4561 #endif /* USE_ENVIRON_ARRAY */
4562 #endif /* !PERL_MICRO */
4563     }
4564     TAINT_NOT;
4565     if ((tmpgv = gv_fetchpv("$",TRUE, SVt_PV))) {
4566         SvREADONLY_off(GvSV(tmpgv));
4567         sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
4568         SvREADONLY_on(GvSV(tmpgv));
4569     }
4570 #ifdef THREADS_HAVE_PIDS
4571     PL_ppid = (IV)getppid();
4572 #endif
4573
4574     /* touch @F array to prevent spurious warnings 20020415 MJD */
4575     if (PL_minus_a) {
4576       (void) get_av("main::F", TRUE | GV_ADDMULTI);
4577     }
4578     /* touch @- and @+ arrays to prevent spurious warnings 20020415 MJD */
4579     (void) get_av("main::-", TRUE | GV_ADDMULTI);
4580     (void) get_av("main::+", TRUE | GV_ADDMULTI);
4581 }
4582
4583 STATIC void
4584 S_init_perllib(pTHX)
4585 {
4586     char *s;
4587     if (!PL_tainting) {
4588 #ifndef VMS
4589         s = PerlEnv_getenv("PERL5LIB");
4590         if (s)
4591             incpush(s, TRUE, TRUE, TRUE, FALSE);
4592         else
4593             incpush(PerlEnv_getenv("PERLLIB"), FALSE, FALSE, TRUE, FALSE);
4594 #else /* VMS */
4595         /* Treat PERL5?LIB as a possible search list logical name -- the
4596          * "natural" VMS idiom for a Unix path string.  We allow each
4597          * element to be a set of |-separated directories for compatibility.
4598          */
4599         char buf[256];
4600         int idx = 0;
4601         if (my_trnlnm("PERL5LIB",buf,0))
4602             do { incpush(buf,TRUE,TRUE,TRUE,FALSE); } while (my_trnlnm("PERL5LIB",buf,++idx));
4603         else
4604             while (my_trnlnm("PERLLIB",buf,idx++)) incpush(buf,FALSE,FALSE,TRUE,FALSE);
4605 #endif /* VMS */
4606     }
4607
4608 /* Use the ~-expanded versions of APPLLIB (undocumented),
4609     ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
4610 */
4611 #ifdef APPLLIB_EXP
4612     incpush(APPLLIB_EXP, TRUE, TRUE, TRUE, TRUE);
4613 #endif
4614
4615 #ifdef ARCHLIB_EXP
4616     incpush(ARCHLIB_EXP, FALSE, FALSE, TRUE, TRUE);
4617 #endif
4618 #ifdef MACOS_TRADITIONAL
4619     {
4620         Stat_t tmpstatbuf;
4621         SV * privdir = NEWSV(55, 0);
4622         char * macperl = PerlEnv_getenv("MACPERL");
4623         
4624         if (!macperl)
4625             macperl = "";
4626         
4627         Perl_sv_setpvf(aTHX_ privdir, "%slib:", macperl);
4628         if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
4629             incpush(SvPVX(privdir), TRUE, FALSE, TRUE, FALSE);
4630         Perl_sv_setpvf(aTHX_ privdir, "%ssite_perl:", macperl);
4631         if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
4632             incpush(SvPVX(privdir), TRUE, FALSE, TRUE, FALSE);
4633         
4634         SvREFCNT_dec(privdir);
4635     }
4636     if (!PL_tainting)
4637         incpush(":", FALSE, FALSE, TRUE, FALSE);
4638 #else
4639 #ifndef PRIVLIB_EXP
4640 #  define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
4641 #endif
4642 #if defined(WIN32)
4643     incpush(PRIVLIB_EXP, TRUE, FALSE, TRUE, TRUE);
4644 #else
4645     incpush(PRIVLIB_EXP, FALSE, FALSE, TRUE, TRUE);
4646 #endif
4647
4648 #ifdef SITEARCH_EXP
4649     /* sitearch is always relative to sitelib on Windows for
4650      * DLL-based path intuition to work correctly */
4651 #  if !defined(WIN32)
4652     incpush(SITEARCH_EXP, FALSE, FALSE, TRUE, TRUE);
4653 #  endif
4654 #endif
4655
4656 #ifdef SITELIB_EXP
4657 #  if defined(WIN32)
4658     /* this picks up sitearch as well */
4659     incpush(SITELIB_EXP, TRUE, FALSE, TRUE, TRUE);
4660 #  else
4661     incpush(SITELIB_EXP, FALSE, FALSE, TRUE, TRUE);
4662 #  endif
4663 #endif
4664
4665 #ifdef SITELIB_STEM /* Search for version-specific dirs below here */
4666     incpush(SITELIB_STEM, FALSE, TRUE, TRUE, TRUE);
4667 #endif
4668
4669 #ifdef PERL_VENDORARCH_EXP
4670     /* vendorarch is always relative to vendorlib on Windows for
4671      * DLL-based path intuition to work correctly */
4672 #  if !defined(WIN32)
4673     incpush(PERL_VENDORARCH_EXP, FALSE, FALSE, TRUE, TRUE);
4674 #  endif
4675 #endif
4676
4677 #ifdef PERL_VENDORLIB_EXP
4678 #  if defined(WIN32)
4679     incpush(PERL_VENDORLIB_EXP, TRUE, FALSE, TRUE, TRUE);       /* this picks up vendorarch as well */
4680 #  else
4681     incpush(PERL_VENDORLIB_EXP, FALSE, FALSE, TRUE, TRUE);
4682 #  endif
4683 #endif
4684
4685 #ifdef PERL_VENDORLIB_STEM /* Search for version-specific dirs below here */
4686     incpush(PERL_VENDORLIB_STEM, FALSE, TRUE, TRUE, TRUE);
4687 #endif
4688
4689 #ifdef PERL_OTHERLIBDIRS
4690     incpush(PERL_OTHERLIBDIRS, TRUE, TRUE, TRUE, TRUE);
4691 #endif
4692
4693     if (!PL_tainting)
4694         incpush(".", FALSE, FALSE, TRUE, FALSE);
4695 #endif /* MACOS_TRADITIONAL */
4696 }
4697
4698 #if defined(DOSISH) || defined(EPOC) || defined(SYMBIAN)
4699 #    define PERLLIB_SEP ';'
4700 #else
4701 #  if defined(VMS)
4702 #    define PERLLIB_SEP '|'
4703 #  else
4704 #    if defined(MACOS_TRADITIONAL)
4705 #      define PERLLIB_SEP ','
4706 #    else
4707 #      define PERLLIB_SEP ':'
4708 #    endif
4709 #  endif
4710 #endif
4711 #ifndef PERLLIB_MANGLE
4712 #  define PERLLIB_MANGLE(s,n) (s)
4713 #endif
4714
4715 /* Push a directory onto @INC if it exists.
4716    Generate a new SV if we do this, to save needing to copy the SV we push
4717    onto @INC  */
4718 STATIC SV *
4719 S_incpush_if_exists(pTHX_ SV *dir)
4720 {
4721     Stat_t tmpstatbuf;
4722     if (PerlLIO_stat(SvPVX_const(dir), &tmpstatbuf) >= 0 &&
4723         S_ISDIR(tmpstatbuf.st_mode)) {
4724         av_push(GvAVn(PL_incgv), dir);
4725         dir = NEWSV(0,0);
4726     }
4727     return dir;
4728 }
4729
4730 STATIC void
4731 S_incpush(pTHX_ const char *dir, bool addsubdirs, bool addoldvers, bool usesep,
4732           bool canrelocate)
4733 {
4734     SV *subdir = Nullsv;
4735     const char *p = dir;
4736
4737     if (!p || !*p)
4738         return;
4739
4740     if (addsubdirs || addoldvers) {
4741         subdir = NEWSV(0,0);
4742     }
4743
4744     /* Break at all separators */
4745     while (p && *p) {
4746         SV *libdir = NEWSV(55,0);
4747         const char *s;
4748
4749         /* skip any consecutive separators */
4750         if (usesep) {
4751             while ( *p == PERLLIB_SEP ) {
4752                 /* Uncomment the next line for PATH semantics */
4753                 /* av_push(GvAVn(PL_incgv), newSVpvn(".", 1)); */
4754                 p++;
4755             }
4756         }
4757
4758         if ( usesep && (s = strchr(p, PERLLIB_SEP)) != Nullch ) {
4759             sv_setpvn(libdir, PERLLIB_MANGLE(p, (STRLEN)(s - p)),
4760                       (STRLEN)(s - p));
4761             p = s + 1;
4762         }
4763         else {
4764             sv_setpv(libdir, PERLLIB_MANGLE(p, 0));
4765             p = Nullch; /* break out */
4766         }
4767 #ifdef MACOS_TRADITIONAL
4768         if (!strchr(SvPVX(libdir), ':')) {
4769             char buf[256];
4770
4771             sv_setpv(libdir, MacPerl_CanonDir(SvPVX(libdir), buf, 0));
4772         }
4773         if (SvPVX(libdir)[SvCUR(libdir)-1] != ':')
4774             sv_catpv(libdir, ":");
4775 #endif
4776
4777         /* Do the if() outside the #ifdef to avoid warnings about an unused
4778            parameter.  */
4779         if (canrelocate) {
4780 #ifdef PERL_RELOCATABLE_INC
4781         /*
4782          * Relocatable include entries are marked with a leading .../
4783          *
4784          * The algorithm is
4785          * 0: Remove that leading ".../"
4786          * 1: Remove trailing executable name (anything after the last '/')
4787          *    from the perl path to give a perl prefix
4788          * Then
4789          * While the @INC element starts "../" and the prefix ends with a real
4790          * directory (ie not . or ..) chop that real directory off the prefix
4791          * and the leading "../" from the @INC element. ie a logical "../"
4792          * cleanup
4793          * Finally concatenate the prefix and the remainder of the @INC element
4794          * The intent is that /usr/local/bin/perl and .../../lib/perl5
4795          * generates /usr/local/lib/perl5
4796          */
4797             const char *libpath = SvPVX(libdir);
4798             STRLEN libpath_len = SvCUR(libdir);
4799             if (libpath_len >= 4 && memEQ (libpath, ".../", 4)) {
4800                 /* Game on!  */
4801                 SV * const caret_X = get_sv("\030", 0);
4802                 /* Going to use the SV just as a scratch buffer holding a C
4803                    string:  */
4804                 SV *prefix_sv;
4805                 char *prefix;
4806                 char *lastslash;
4807
4808                 /* $^X is *the* source of taint if tainting is on, hence
4809                    SvPOK() won't be true.  */
4810                 assert(caret_X);
4811                 assert(SvPOKp(caret_X));
4812                 prefix_sv = newSVpvn(SvPVX(caret_X), SvCUR(caret_X));
4813                 /* Firstly take off the leading .../
4814                    If all else fail we'll do the paths relative to the current
4815                    directory.  */
4816                 sv_chop(libdir, libpath + 4);
4817                 /* Don't use SvPV as we're intentionally bypassing taining,
4818                    mortal copies that the mg_get of tainting creates, and
4819                    corruption that seems to come via the save stack.
4820                    I guess that the save stack isn't correctly set up yet.  */
4821                 libpath = SvPVX(libdir);
4822                 libpath_len = SvCUR(libdir);
4823
4824                 /* This would work more efficiently with memrchr, but as it's
4825                    only a GNU extension we'd need to probe for it and
4826                    implement our own. Not hard, but maybe not worth it?  */
4827
4828                 prefix = SvPVX(prefix_sv);
4829                 lastslash = strrchr(prefix, '/');
4830
4831                 /* First time in with the *lastslash = '\0' we just wipe off
4832                    the trailing /perl from (say) /usr/foo/bin/perl
4833                 */
4834                 if (lastslash) {
4835                     SV *tempsv;
4836                     while ((*lastslash = '\0'), /* Do that, come what may.  */
4837                            (libpath_len >= 3 && memEQ(libpath, "../", 3)
4838                             && (lastslash = strrchr(prefix, '/')))) {
4839                         if (lastslash[1] == '\0'
4840                             || (lastslash[1] == '.'
4841                                 && (lastslash[2] == '/' /* ends "/."  */
4842                                     || (lastslash[2] == '/'
4843                                         && lastslash[3] == '/' /* or "/.."  */
4844                                         )))) {
4845                             /* Prefix ends "/" or "/." or "/..", any of which
4846                                are fishy, so don't do any more logical cleanup.
4847                             */
4848                             break;
4849                         }
4850                         /* Remove leading "../" from path  */
4851                         libpath += 3;
4852                         libpath_len -= 3;
4853                         /* Next iteration round the loop removes the last
4854                            directory name from prefix by writing a '\0' in
4855                            the while clause.  */
4856                     }
4857                     /* prefix has been terminated with a '\0' to the correct
4858                        length. libpath points somewhere into the libdir SV.
4859                        We need to join the 2 with '/' and drop the result into
4860                        libdir.  */
4861                     tempsv = Perl_newSVpvf(aTHX_ "%s/%s", prefix, libpath);
4862                     SvREFCNT_dec(libdir);
4863                     /* And this is the new libdir.  */
4864                     libdir = tempsv;
4865                     if (PL_tainting &&
4866                         (PL_uid != PL_euid || PL_gid != PL_egid)) {
4867                         /* Need to taint reloccated paths if running set ID  */
4868                         SvTAINTED_on(libdir);
4869                     }
4870                 }
4871                 SvREFCNT_dec(prefix_sv);
4872             }
4873 #endif
4874         }
4875         /*
4876          * BEFORE pushing libdir onto @INC we may first push version- and
4877          * archname-specific sub-directories.
4878          */
4879         if (addsubdirs || addoldvers) {
4880 #ifdef PERL_INC_VERSION_LIST
4881             /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
4882             const char *incverlist[] = { PERL_INC_VERSION_LIST };
4883             const char **incver;
4884 #endif
4885 #ifdef VMS
4886             char *unix;
4887             STRLEN len;
4888
4889             if ((unix = tounixspec_ts(SvPV(libdir,len),Nullch)) != Nullch) {
4890                 len = strlen(unix);
4891                 while (unix[len-1] == '/') len--;  /* Cosmetic */
4892                 sv_usepvn(libdir,unix,len);
4893             }
4894             else
4895                 PerlIO_printf(Perl_error_log,
4896                               "Failed to unixify @INC element \"%s\"\n",
4897                               SvPV(libdir,len));
4898 #endif
4899             if (addsubdirs) {
4900 #ifdef MACOS_TRADITIONAL
4901 #define PERL_AV_SUFFIX_FMT      ""
4902 #define PERL_ARCH_FMT           "%s:"
4903 #define PERL_ARCH_FMT_PATH      PERL_FS_VER_FMT PERL_AV_SUFFIX_FMT
4904 #else
4905 #define PERL_AV_SUFFIX_FMT      "/"
4906 #define PERL_ARCH_FMT           "/%s"
4907 #define PERL_ARCH_FMT_PATH      PERL_AV_SUFFIX_FMT PERL_FS_VER_FMT
4908 #endif
4909                 /* .../version/archname if -d .../version/archname */
4910                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH PERL_ARCH_FMT,
4911                                 libdir,
4912                                (int)PERL_REVISION, (int)PERL_VERSION,
4913                                (int)PERL_SUBVERSION, ARCHNAME);
4914                 subdir = S_incpush_if_exists(aTHX_ subdir);
4915
4916                 /* .../version if -d .../version */
4917                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH, libdir,
4918                                (int)PERL_REVISION, (int)PERL_VERSION,
4919                                (int)PERL_SUBVERSION);
4920                 subdir = S_incpush_if_exists(aTHX_ subdir);
4921
4922                 /* .../archname if -d .../archname */
4923                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, ARCHNAME);
4924                 subdir = S_incpush_if_exists(aTHX_ subdir);
4925
4926             }
4927
4928 #ifdef PERL_INC_VERSION_LIST
4929             if (addoldvers) {
4930                 for (incver = incverlist; *incver; incver++) {
4931                     /* .../xxx if -d .../xxx */
4932                     Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, *incver);
4933                     subdir = S_incpush_if_exists(aTHX_ subdir);
4934                 }
4935             }
4936 #endif
4937         }
4938
4939         /* finally push this lib directory on the end of @INC */
4940         av_push(GvAVn(PL_incgv), libdir);
4941     }
4942     if (subdir) {
4943         assert (SvREFCNT(subdir) == 1);
4944         SvREFCNT_dec(subdir);
4945     }
4946 }
4947
4948 #ifdef USE_5005THREADS
4949 STATIC struct perl_thread *
4950 S_init_main_thread(pTHX)
4951 {
4952 #if !defined(PERL_IMPLICIT_CONTEXT)
4953     struct perl_thread *thr;
4954 #endif
4955     XPV *xpv;
4956
4957     Newxz(thr, 1, struct perl_thread);
4958     PL_curcop = &PL_compiling;
4959     thr->interp = PERL_GET_INTERP;
4960     thr->cvcache = newHV();
4961     thr->threadsv = newAV();
4962     /* thr->threadsvp is set when find_threadsv is called */
4963     thr->specific = newAV();
4964     thr->flags = THRf_R_JOINABLE;
4965     MUTEX_INIT(&thr->mutex);
4966     /* Handcraft thrsv similarly to mess_sv */
4967     Newx(PL_thrsv, 1, SV);
4968     Newxz(xpv, 1, XPV);
4969     SvFLAGS(PL_thrsv) = SVt_PV;
4970     SvANY(PL_thrsv) = (void*)xpv;
4971     SvREFCNT(PL_thrsv) = 1 << 30;       /* practically infinite */
4972     SvPV_set(PL_thrsvr, (char*)thr);
4973     SvCUR_set(PL_thrsv, sizeof(thr));
4974     SvLEN_set(PL_thrsv, sizeof(thr));
4975     *SvEND(PL_thrsv) = '\0';    /* in the trailing_nul field */
4976     thr->oursv = PL_thrsv;
4977     PL_chopset = " \n-";
4978     PL_dumpindent = 4;
4979
4980     MUTEX_LOCK(&PL_threads_mutex);
4981     PL_nthreads++;
4982     thr->tid = 0;
4983     thr->next = thr;
4984     thr->prev = thr;
4985     thr->thr_done = 0;
4986     MUTEX_UNLOCK(&PL_threads_mutex);
4987
4988 #ifdef HAVE_THREAD_INTERN
4989     Perl_init_thread_intern(thr);
4990 #endif
4991
4992 #ifdef SET_THREAD_SELF
4993     SET_THREAD_SELF(thr);
4994 #else
4995     thr->self = pthread_self();
4996 #endif /* SET_THREAD_SELF */
4997     PERL_SET_THX(thr);
4998
4999     /*
5000      * These must come after the thread self setting
5001      * because sv_setpvn does SvTAINT and the taint
5002      * fields thread selfness being set.
5003      */
5004     PL_toptarget = NEWSV(0,0);
5005     sv_upgrade(PL_toptarget, SVt_PVFM);
5006     sv_setpvn(PL_toptarget, "", 0);
5007     PL_bodytarget = NEWSV(0,0);
5008     sv_upgrade(PL_bodytarget, SVt_PVFM);
5009     sv_setpvn(PL_bodytarget, "", 0);
5010     PL_formtarget = PL_bodytarget;
5011     thr->errsv = newSVpvn("", 0);
5012     (void) find_threadsv("@");  /* Ensure $@ is initialised early */
5013
5014     PL_maxscream = -1;
5015     PL_peepp = MEMBER_TO_FPTR(Perl_peep);
5016     PL_regcompp = MEMBER_TO_FPTR(Perl_pregcomp);
5017     PL_regexecp = MEMBER_TO_FPTR(Perl_regexec_flags);
5018     PL_regint_start = MEMBER_TO_FPTR(Perl_re_intuit_start);
5019     PL_regint_string = MEMBER_TO_FPTR(Perl_re_intuit_string);
5020     PL_regfree = MEMBER_TO_FPTR(Perl_pregfree);
5021     PL_regindent = 0;
5022     PL_reginterp_cnt = 0;
5023
5024     return thr;
5025 }
5026 #endif /* USE_5005THREADS */
5027
5028 void
5029 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
5030 {
5031     dVAR;
5032     SV *atsv;
5033     const line_t oldline = CopLINE(PL_curcop);
5034     CV *cv;
5035     STRLEN len;
5036     int ret;
5037     dJMPENV;
5038
5039     while (av_len(paramList) >= 0) {
5040         cv = (CV*)av_shift(paramList);
5041         if (PL_savebegin) {
5042             if (paramList == PL_beginav) {
5043                 /* save PL_beginav for compiler */
5044                 if (! PL_beginav_save)
5045                     PL_beginav_save = newAV();
5046                 av_push(PL_beginav_save, (SV*)cv);
5047             }
5048             else if (paramList == PL_checkav) {
5049                 /* save PL_checkav for compiler */
5050                 if (! PL_checkav_save)
5051                     PL_checkav_save = newAV();
5052                 av_push(PL_checkav_save, (SV*)cv);
5053             }
5054         } else {
5055             SAVEFREESV(cv);
5056         }
5057         JMPENV_PUSH(ret);
5058         switch (ret) {
5059         case 0:
5060             call_list_body(cv);
5061             atsv = ERRSV;
5062             (void)SvPV_const(atsv, len);
5063             if (len) {
5064                 PL_curcop = &PL_compiling;
5065                 CopLINE_set(PL_curcop, oldline);
5066                 if (paramList == PL_beginav)
5067                     sv_catpv(atsv, "BEGIN failed--compilation aborted");
5068                 else
5069                     Perl_sv_catpvf(aTHX_ atsv,
5070                                    "%s failed--call queue aborted",
5071                                    paramList == PL_checkav ? "CHECK"
5072                                    : paramList == PL_initav ? "INIT"
5073                                    : "END");
5074                 while (PL_scopestack_ix > oldscope)
5075                     LEAVE;
5076                 JMPENV_POP;
5077                 Perl_croak(aTHX_ "%"SVf"", atsv);
5078             }
5079             break;
5080         case 1:
5081             STATUS_ALL_FAILURE;
5082             /* FALL THROUGH */
5083         case 2:
5084             /* my_exit() was called */
5085             while (PL_scopestack_ix > oldscope)
5086                 LEAVE;
5087             FREETMPS;
5088             PL_curstash = PL_defstash;
5089             PL_curcop = &PL_compiling;
5090             CopLINE_set(PL_curcop, oldline);
5091             JMPENV_POP;
5092             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
5093                 if (paramList == PL_beginav)
5094                     Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
5095                 else
5096                     Perl_croak(aTHX_ "%s failed--call queue aborted",
5097                                paramList == PL_checkav ? "CHECK"
5098                                : paramList == PL_initav ? "INIT"
5099                                : "END");
5100             }
5101             my_exit_jump();
5102             /* NOTREACHED */
5103         case 3:
5104             if (PL_restartop) {
5105                 PL_curcop = &PL_compiling;
5106                 CopLINE_set(PL_curcop, oldline);
5107                 JMPENV_JUMP(3);
5108             }
5109             PerlIO_printf(Perl_error_log, "panic: restartop\n");
5110             FREETMPS;
5111             break;
5112         }
5113         JMPENV_POP;
5114     }
5115 }
5116
5117 STATIC void *
5118 S_call_list_body(pTHX_ CV *cv)
5119 {
5120     PUSHMARK(PL_stack_sp);
5121     call_sv((SV*)cv, G_EVAL|G_DISCARD);
5122     return NULL;
5123 }
5124
5125 void
5126 Perl_my_exit(pTHX_ U32 status)
5127 {
5128     DEBUG_S(PerlIO_printf(Perl_debug_log, "my_exit: thread %p, status %lu\n",
5129                           thr, (unsigned long) status));
5130     switch (status) {
5131     case 0:
5132         STATUS_ALL_SUCCESS;
5133         break;
5134     case 1:
5135         STATUS_ALL_FAILURE;
5136         break;
5137     default:
5138         STATUS_NATIVE_SET(status);
5139         break;
5140     }
5141     my_exit_jump();
5142 }
5143
5144 void
5145 Perl_my_failure_exit(pTHX)
5146 {
5147 #ifdef VMS
5148     if (vaxc$errno & 1) {
5149         if (STATUS_NATIVE & 1)          /* fortuitiously includes "-1" */
5150             STATUS_NATIVE_SET(44);
5151     }
5152     else {
5153         if (!vaxc$errno)                /* unlikely */
5154             STATUS_NATIVE_SET(44);
5155         else
5156             STATUS_NATIVE_SET(vaxc$errno);
5157     }
5158 #else
5159     int exitstatus;
5160     if (errno & 255)
5161         STATUS_UNIX_SET(errno);
5162     else {
5163         exitstatus = STATUS_UNIX >> 8;
5164         if (exitstatus & 255)
5165             STATUS_UNIX_SET(exitstatus);
5166         else
5167             STATUS_UNIX_SET(255);
5168     }
5169 #endif
5170     my_exit_jump();
5171 }
5172
5173 STATIC void
5174 S_my_exit_jump(pTHX)
5175 {
5176     dVAR;
5177     register PERL_CONTEXT *cx;
5178     I32 gimme;
5179     SV **newsp;
5180
5181     if (PL_e_script) {
5182         SvREFCNT_dec(PL_e_script);
5183         PL_e_script = Nullsv;
5184     }
5185
5186     POPSTACK_TO(PL_mainstack);
5187     if (cxstack_ix >= 0) {
5188         if (cxstack_ix > 0)
5189             dounwind(0);
5190         POPBLOCK(cx,PL_curpm);
5191         LEAVE;
5192     }
5193
5194     JMPENV_JUMP(2);
5195     PERL_UNUSED_VAR(gimme);
5196     PERL_UNUSED_VAR(newsp);
5197 }
5198
5199 static I32
5200 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen)
5201 {
5202     const char * const p  = SvPVX_const(PL_e_script);
5203     const char *nl = strchr(p, '\n');
5204
5205     PERL_UNUSED_ARG(idx);
5206     PERL_UNUSED_ARG(maxlen);
5207
5208     nl = (nl) ? nl+1 : SvEND(PL_e_script);
5209     if (nl-p == 0) {
5210         filter_del(read_e_script);
5211         return 0;
5212     }
5213     sv_catpvn(buf_sv, p, nl-p);
5214     sv_chop(PL_e_script, nl);
5215     return 1;
5216 }
5217
5218 /*
5219  * Local variables:
5220  * c-indentation-style: bsd
5221  * c-basic-offset: 4
5222  * indent-tabs-mode: t
5223  * End:
5224  *
5225  * ex: set ts=8 sts=4 sw=4 noet:
5226  */