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