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