perl.c

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