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