perl.c

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