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