perl.c

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