3 * Copyright (c) 1987-2003 Larry Wall
5 * You may distribute under the terms of either the GNU General Public
6 * License or the Artistic License, as specified in the README file.
11 * "A ship then new they built for him/of mithril and of elven glass" --Bilbo
15 #define PERL_IN_PERL_C
17 #include "patchlevel.h" /* for local_patches */
21 char *nw_get_sitelib(const char *pl);
24 /* XXX If this causes problems, set i_unistd=undef in the hint file. */
41 #if !defined(STANDARD_C) && !defined(HAS_GETENV_PROTOTYPE) && !defined(PERL_MICRO)
42 char *getenv (char *); /* Usually in <stdlib.h> */
45 static I32 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen);
53 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
59 #if defined(USE_ITHREADS)
60 # define INIT_TLS_AND_INTERP \
62 if (!PL_curinterp) { \
63 PERL_SET_INTERP(my_perl); \
66 PERL_SET_THX(my_perl); \
68 MUTEX_INIT(&PL_dollarzero_mutex); \
71 PERL_SET_THX(my_perl); \
75 # define INIT_TLS_AND_INTERP \
77 if (!PL_curinterp) { \
78 PERL_SET_INTERP(my_perl); \
80 PERL_SET_THX(my_perl); \
84 #ifdef PERL_IMPLICIT_SYS
86 perl_alloc_using(struct IPerlMem* ipM, struct IPerlMem* ipMS,
87 struct IPerlMem* ipMP, struct IPerlEnv* ipE,
88 struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
89 struct IPerlDir* ipD, struct IPerlSock* ipS,
90 struct IPerlProc* ipP)
92 PerlInterpreter *my_perl;
93 /* New() needs interpreter, so call malloc() instead */
94 my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
96 Zero(my_perl, 1, PerlInterpreter);
112 =head1 Embedding Functions
114 =for apidoc perl_alloc
116 Allocates a new Perl interpreter. See L<perlembed>.
124 PerlInterpreter *my_perl;
125 #ifdef USE_5005THREADS
129 /* New() needs interpreter, so call malloc() instead */
130 my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
133 Zero(my_perl, 1, PerlInterpreter);
136 #endif /* PERL_IMPLICIT_SYS */
139 =for apidoc perl_construct
141 Initializes a new Perl interpreter. See L<perlembed>.
147 perl_construct(pTHXx)
151 PL_perl_destruct_level = 1;
153 if (PL_perl_destruct_level > 0)
157 /* Init the real globals (and main thread)? */
159 #ifdef PERL_FLEXIBLE_EXCEPTIONS
160 PL_protect = MEMBER_TO_FPTR(Perl_default_protect); /* for exceptions */
163 PL_curcop = &PL_compiling; /* needed by ckWARN, right away */
165 PL_linestr = NEWSV(65,79);
166 sv_upgrade(PL_linestr,SVt_PVIV);
168 if (!SvREADONLY(&PL_sv_undef)) {
169 /* set read-only and try to insure than we wont see REFCNT==0
172 SvREADONLY_on(&PL_sv_undef);
173 SvREFCNT(&PL_sv_undef) = (~(U32)0)/2;
175 sv_setpv(&PL_sv_no,PL_No);
177 SvREADONLY_on(&PL_sv_no);
178 SvREFCNT(&PL_sv_no) = (~(U32)0)/2;
180 sv_setpv(&PL_sv_yes,PL_Yes);
182 SvREADONLY_on(&PL_sv_yes);
183 SvREFCNT(&PL_sv_yes) = (~(U32)0)/2;
186 PL_sighandlerp = Perl_sighandler;
187 PL_pidstatus = newHV();
190 PL_rs = newSVpvn("\n", 1);
195 PL_lex_state = LEX_NOTPARSING;
201 SET_NUMERIC_STANDARD();
205 PL_patchlevel = NEWSV(0,4);
206 (void)SvUPGRADE(PL_patchlevel, SVt_PVNV);
207 if (PERL_REVISION > 127 || PERL_VERSION > 127 || PERL_SUBVERSION > 127)
208 SvGROW(PL_patchlevel, UTF8_MAXLEN*3+1);
209 s = (U8*)SvPVX(PL_patchlevel);
210 /* Build version strings using "native" characters */
211 s = uvchr_to_utf8(s, (UV)PERL_REVISION);
212 s = uvchr_to_utf8(s, (UV)PERL_VERSION);
213 s = uvchr_to_utf8(s, (UV)PERL_SUBVERSION);
215 SvCUR_set(PL_patchlevel, s - (U8*)SvPVX(PL_patchlevel));
216 SvPOK_on(PL_patchlevel);
217 SvNVX(PL_patchlevel) = (NV)PERL_REVISION +
218 ((NV)PERL_VERSION / (NV)1000) +
219 ((NV)PERL_SUBVERSION / (NV)1000000);
220 SvNOK_on(PL_patchlevel); /* dual valued */
221 SvUTF8_on(PL_patchlevel);
222 SvREADONLY_on(PL_patchlevel);
225 #if defined(LOCAL_PATCH_COUNT)
226 PL_localpatches = local_patches; /* For possible -v */
229 #ifdef HAVE_INTERP_INTERN
233 PerlIO_init(aTHX); /* Hook to IO system */
235 PL_fdpid = newAV(); /* for remembering popen pids by fd */
236 PL_modglobal = newHV(); /* pointers to per-interpreter module globals */
237 PL_errors = newSVpvn("",0);
238 sv_setpvn(PERL_DEBUG_PAD(0), "", 0); /* For regex debugging. */
239 sv_setpvn(PERL_DEBUG_PAD(1), "", 0); /* ext/re needs these */
240 sv_setpvn(PERL_DEBUG_PAD(2), "", 0); /* even without DEBUGGING. */
242 PL_regex_padav = newAV();
243 av_push(PL_regex_padav,(SV*)newAV()); /* First entry is an array of empty elements */
244 PL_regex_pad = AvARRAY(PL_regex_padav);
246 #ifdef USE_REENTRANT_API
247 Perl_reentrant_init(aTHX);
250 /* Note that strtab is a rather special HV. Assumptions are made
251 about not iterating on it, and not adding tie magic to it.
252 It is properly deallocated in perl_destruct() */
255 HvSHAREKEYS_off(PL_strtab); /* mandatory */
256 hv_ksplit(PL_strtab, 512);
258 #if defined(__DYNAMIC__) && (defined(NeXT) || defined(__NeXT__))
259 _dyld_lookup_and_bind
260 ("__environ", (unsigned long *) &environ_pointer, NULL);
263 #ifdef USE_ENVIRON_ARRAY
264 PL_origenviron = environ;
267 /* Use sysconf(_SC_CLK_TCK) if available, if not
268 * available or if the sysconf() fails, use the HZ. */
269 #if defined(HAS_SYSCONF) && defined(_SC_CLK_TCK)
270 PL_clocktick = sysconf(_SC_CLK_TCK);
271 if (PL_clocktick <= 0)
275 PL_stashcache = newHV();
281 =for apidoc nothreadhook
283 Stub that provides thread hook for perl_destruct when there are
290 Perl_nothreadhook(pTHX)
296 =for apidoc perl_destruct
298 Shuts down a Perl interpreter. See L<perlembed>.
306 volatile int destruct_level; /* 0=none, 1=full, 2=full with checks */
308 #ifdef USE_5005THREADS
310 #endif /* USE_5005THREADS */
312 /* wait for all pseudo-forked children to finish */
313 PERL_WAIT_FOR_CHILDREN;
315 destruct_level = PL_perl_destruct_level;
319 if ((s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL"))) {
321 if (destruct_level < i)
328 if(PL_exit_flags & PERL_EXIT_DESTRUCT_END) {
333 if (PL_endav && !PL_minus_c)
334 call_list(PL_scopestack_ix, PL_endav);
340 /* Need to flush since END blocks can produce output */
343 if (CALL_FPTR(PL_threadhook)(aTHX)) {
344 /* Threads hook has vetoed further cleanup */
345 return STATUS_NATIVE_EXPORT;
348 /* We must account for everything. */
350 /* Destroy the main CV and syntax tree */
352 op_free(PL_main_root);
353 PL_main_root = Nullop;
355 PL_curcop = &PL_compiling;
356 PL_main_start = Nullop;
357 SvREFCNT_dec(PL_main_cv);
361 /* Tell PerlIO we are about to tear things apart in case
362 we have layers which are using resources that should
366 PerlIO_destruct(aTHX);
368 if (PL_sv_objcount) {
370 * Try to destruct global references. We do this first so that the
371 * destructors and destructees still exist. Some sv's might remain.
372 * Non-referenced objects are on their own.
377 /* unhook hooks which will soon be, or use, destroyed data */
378 SvREFCNT_dec(PL_warnhook);
379 PL_warnhook = Nullsv;
380 SvREFCNT_dec(PL_diehook);
383 /* call exit list functions */
384 while (PL_exitlistlen-- > 0)
385 PL_exitlist[PL_exitlistlen].fn(aTHX_ PL_exitlist[PL_exitlistlen].ptr);
387 Safefree(PL_exitlist);
392 if (destruct_level == 0){
394 DEBUG_P(debprofdump());
396 #if defined(PERLIO_LAYERS)
397 /* No more IO - including error messages ! */
398 PerlIO_cleanup(aTHX);
401 /* The exit() function will do everything that needs doing. */
402 return STATUS_NATIVE_EXPORT;
405 /* jettison our possibly duplicated environment */
406 /* if PERL_USE_SAFE_PUTENV is defined environ will not have been copied
407 * so we certainly shouldn't free it here
409 #if defined(USE_ENVIRON_ARRAY) && !defined(PERL_USE_SAFE_PUTENV)
410 if (environ != PL_origenviron
412 /* only main thread can free environ[0] contents */
413 && PL_curinterp == aTHX
419 for (i = 0; environ[i]; i++)
420 safesysfree(environ[i]);
422 /* Must use safesysfree() when working with environ. */
423 safesysfree(environ);
425 environ = PL_origenviron;
430 /* the syntax tree is shared between clones
431 * so op_free(PL_main_root) only ReREFCNT_dec's
432 * REGEXPs in the parent interpreter
433 * we need to manually ReREFCNT_dec for the clones
436 I32 i = AvFILLp(PL_regex_padav) + 1;
437 SV **ary = AvARRAY(PL_regex_padav);
441 REGEXP *re = INT2PTR(REGEXP *,SvIVX(resv));
443 if (SvFLAGS(resv) & SVf_BREAK) {
444 /* this is PL_reg_curpm, already freed
445 * flag is set in regexec.c:S_regtry
447 SvFLAGS(resv) &= ~SVf_BREAK;
449 else if(SvREPADTMP(resv)) {
450 SvREPADTMP_off(resv);
457 SvREFCNT_dec(PL_regex_padav);
458 PL_regex_padav = Nullav;
462 SvREFCNT_dec((SV*) PL_stashcache);
463 PL_stashcache = NULL;
465 /* loosen bonds of global variables */
468 (void)PerlIO_close(PL_rsfp);
472 /* Filters for program text */
473 SvREFCNT_dec(PL_rsfp_filters);
474 PL_rsfp_filters = Nullav;
477 PL_preprocess = FALSE;
483 PL_doswitches = FALSE;
484 PL_dowarn = G_WARN_OFF;
485 PL_doextract = FALSE;
486 PL_sawampersand = FALSE; /* must save all match strings */
489 Safefree(PL_inplace);
491 SvREFCNT_dec(PL_patchlevel);
494 SvREFCNT_dec(PL_e_script);
495 PL_e_script = Nullsv;
498 /* magical thingies */
500 SvREFCNT_dec(PL_ofs_sv); /* $, */
503 SvREFCNT_dec(PL_ors_sv); /* $\ */
506 SvREFCNT_dec(PL_rs); /* $/ */
509 PL_multiline = 0; /* $* */
510 Safefree(PL_osname); /* $^O */
513 SvREFCNT_dec(PL_statname);
514 PL_statname = Nullsv;
517 /* defgv, aka *_ should be taken care of elsewhere */
519 /* clean up after study() */
520 SvREFCNT_dec(PL_lastscream);
521 PL_lastscream = Nullsv;
522 Safefree(PL_screamfirst);
524 Safefree(PL_screamnext);
528 Safefree(PL_efloatbuf);
529 PL_efloatbuf = Nullch;
532 /* startup and shutdown function lists */
533 SvREFCNT_dec(PL_beginav);
534 SvREFCNT_dec(PL_beginav_save);
535 SvREFCNT_dec(PL_endav);
536 SvREFCNT_dec(PL_checkav);
537 SvREFCNT_dec(PL_checkav_save);
538 SvREFCNT_dec(PL_initav);
540 PL_beginav_save = Nullav;
543 PL_checkav_save = Nullav;
546 /* shortcuts just get cleared */
552 PL_argvoutgv = Nullgv;
554 PL_stderrgv = Nullgv;
555 PL_last_in_gv = Nullgv;
557 PL_debstash = Nullhv;
559 /* reset so print() ends up where we expect */
562 SvREFCNT_dec(PL_argvout_stack);
563 PL_argvout_stack = Nullav;
565 SvREFCNT_dec(PL_modglobal);
566 PL_modglobal = Nullhv;
567 SvREFCNT_dec(PL_preambleav);
568 PL_preambleav = Nullav;
569 SvREFCNT_dec(PL_subname);
571 SvREFCNT_dec(PL_linestr);
573 SvREFCNT_dec(PL_pidstatus);
574 PL_pidstatus = Nullhv;
575 SvREFCNT_dec(PL_toptarget);
576 PL_toptarget = Nullsv;
577 SvREFCNT_dec(PL_bodytarget);
578 PL_bodytarget = Nullsv;
579 PL_formtarget = Nullsv;
581 /* free locale stuff */
582 #ifdef USE_LOCALE_COLLATE
583 Safefree(PL_collation_name);
584 PL_collation_name = Nullch;
587 #ifdef USE_LOCALE_NUMERIC
588 Safefree(PL_numeric_name);
589 PL_numeric_name = Nullch;
590 SvREFCNT_dec(PL_numeric_radix_sv);
593 /* clear utf8 character classes */
594 SvREFCNT_dec(PL_utf8_alnum);
595 SvREFCNT_dec(PL_utf8_alnumc);
596 SvREFCNT_dec(PL_utf8_ascii);
597 SvREFCNT_dec(PL_utf8_alpha);
598 SvREFCNT_dec(PL_utf8_space);
599 SvREFCNT_dec(PL_utf8_cntrl);
600 SvREFCNT_dec(PL_utf8_graph);
601 SvREFCNT_dec(PL_utf8_digit);
602 SvREFCNT_dec(PL_utf8_upper);
603 SvREFCNT_dec(PL_utf8_lower);
604 SvREFCNT_dec(PL_utf8_print);
605 SvREFCNT_dec(PL_utf8_punct);
606 SvREFCNT_dec(PL_utf8_xdigit);
607 SvREFCNT_dec(PL_utf8_mark);
608 SvREFCNT_dec(PL_utf8_toupper);
609 SvREFCNT_dec(PL_utf8_totitle);
610 SvREFCNT_dec(PL_utf8_tolower);
611 SvREFCNT_dec(PL_utf8_tofold);
612 SvREFCNT_dec(PL_utf8_idstart);
613 SvREFCNT_dec(PL_utf8_idcont);
614 PL_utf8_alnum = Nullsv;
615 PL_utf8_alnumc = Nullsv;
616 PL_utf8_ascii = Nullsv;
617 PL_utf8_alpha = Nullsv;
618 PL_utf8_space = Nullsv;
619 PL_utf8_cntrl = Nullsv;
620 PL_utf8_graph = Nullsv;
621 PL_utf8_digit = Nullsv;
622 PL_utf8_upper = Nullsv;
623 PL_utf8_lower = Nullsv;
624 PL_utf8_print = Nullsv;
625 PL_utf8_punct = Nullsv;
626 PL_utf8_xdigit = Nullsv;
627 PL_utf8_mark = Nullsv;
628 PL_utf8_toupper = Nullsv;
629 PL_utf8_totitle = Nullsv;
630 PL_utf8_tolower = Nullsv;
631 PL_utf8_tofold = Nullsv;
632 PL_utf8_idstart = Nullsv;
633 PL_utf8_idcont = Nullsv;
635 if (!specialWARN(PL_compiling.cop_warnings))
636 SvREFCNT_dec(PL_compiling.cop_warnings);
637 PL_compiling.cop_warnings = Nullsv;
638 if (!specialCopIO(PL_compiling.cop_io))
639 SvREFCNT_dec(PL_compiling.cop_io);
640 PL_compiling.cop_io = Nullsv;
641 CopFILE_free(&PL_compiling);
642 CopSTASH_free(&PL_compiling);
644 /* Prepare to destruct main symbol table. */
649 SvREFCNT_dec(PL_curstname);
650 PL_curstname = Nullsv;
652 /* clear queued errors */
653 SvREFCNT_dec(PL_errors);
657 if (destruct_level >= 2 && ckWARN_d(WARN_INTERNAL)) {
658 if (PL_scopestack_ix != 0)
659 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
660 "Unbalanced scopes: %ld more ENTERs than LEAVEs\n",
661 (long)PL_scopestack_ix);
662 if (PL_savestack_ix != 0)
663 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
664 "Unbalanced saves: %ld more saves than restores\n",
665 (long)PL_savestack_ix);
666 if (PL_tmps_floor != -1)
667 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced tmps: %ld more allocs than frees\n",
668 (long)PL_tmps_floor + 1);
669 if (cxstack_ix != -1)
670 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced context: %ld more PUSHes than POPs\n",
671 (long)cxstack_ix + 1);
674 /* Now absolutely destruct everything, somehow or other, loops or no. */
675 SvFLAGS(PL_fdpid) |= SVTYPEMASK; /* don't clean out pid table now */
676 SvFLAGS(PL_strtab) |= SVTYPEMASK; /* don't clean out strtab now */
678 /* the 2 is for PL_fdpid and PL_strtab */
679 while (PL_sv_count > 2 && sv_clean_all())
682 SvFLAGS(PL_fdpid) &= ~SVTYPEMASK;
683 SvFLAGS(PL_fdpid) |= SVt_PVAV;
684 SvFLAGS(PL_strtab) &= ~SVTYPEMASK;
685 SvFLAGS(PL_strtab) |= SVt_PVHV;
687 AvREAL_off(PL_fdpid); /* no surviving entries */
688 SvREFCNT_dec(PL_fdpid); /* needed in io_close() */
691 #ifdef HAVE_INTERP_INTERN
695 /* Destruct the global string table. */
697 /* Yell and reset the HeVAL() slots that are still holding refcounts,
698 * so that sv_free() won't fail on them.
706 max = HvMAX(PL_strtab);
707 array = HvARRAY(PL_strtab);
710 if (hent && ckWARN_d(WARN_INTERNAL)) {
711 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
712 "Unbalanced string table refcount: (%d) for \"%s\"",
713 HeVAL(hent) - Nullsv, HeKEY(hent));
714 HeVAL(hent) = Nullsv;
724 SvREFCNT_dec(PL_strtab);
727 /* free the pointer table used for cloning */
728 ptr_table_free(PL_ptr_table);
731 /* free special SVs */
733 SvREFCNT(&PL_sv_yes) = 0;
734 sv_clear(&PL_sv_yes);
735 SvANY(&PL_sv_yes) = NULL;
736 SvFLAGS(&PL_sv_yes) = 0;
738 SvREFCNT(&PL_sv_no) = 0;
740 SvANY(&PL_sv_no) = NULL;
741 SvFLAGS(&PL_sv_no) = 0;
745 for (i=0; i<=2; i++) {
746 SvREFCNT(PERL_DEBUG_PAD(i)) = 0;
747 sv_clear(PERL_DEBUG_PAD(i));
748 SvANY(PERL_DEBUG_PAD(i)) = NULL;
749 SvFLAGS(PERL_DEBUG_PAD(i)) = 0;
753 if (PL_sv_count != 0 && ckWARN_d(WARN_INTERNAL))
754 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Scalars leaked: %ld\n", (long)PL_sv_count);
756 #ifdef DEBUG_LEAKING_SCALARS
757 if (PL_sv_count != 0) {
762 for (sva = PL_sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
763 svend = &sva[SvREFCNT(sva)];
764 for (sv = sva + 1; sv < svend; ++sv) {
765 if (SvTYPE(sv) != SVTYPEMASK) {
766 PerlIO_printf(Perl_debug_log, "leaked: 0x%p\n", sv);
774 #if defined(PERLIO_LAYERS)
775 /* No more IO - including error messages ! */
776 PerlIO_cleanup(aTHX);
779 /* sv_undef needs to stay immortal until after PerlIO_cleanup
780 as currently layers use it rather than Nullsv as a marker
781 for no arg - and will try and SvREFCNT_dec it.
783 SvREFCNT(&PL_sv_undef) = 0;
784 SvREADONLY_off(&PL_sv_undef);
786 Safefree(PL_origfilename);
787 Safefree(PL_reg_start_tmp);
789 Safefree(PL_reg_curpm);
790 Safefree(PL_reg_poscache);
791 Safefree(HeKEY_hek(&PL_hv_fetch_ent_mh));
792 Safefree(PL_op_mask);
793 Safefree(PL_psig_ptr);
794 Safefree(PL_psig_name);
795 Safefree(PL_bitcount);
796 Safefree(PL_psig_pend);
798 PL_hints = 0; /* Reset hints. Should hints be per-interpreter ? */
800 DEBUG_P(debprofdump());
802 #ifdef USE_REENTRANT_API
803 Perl_reentrant_free(aTHX);
808 /* As the absolutely last thing, free the non-arena SV for mess() */
811 /* it could have accumulated taint magic */
812 if (SvTYPE(PL_mess_sv) >= SVt_PVMG) {
815 for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
816 moremagic = mg->mg_moremagic;
817 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
819 Safefree(mg->mg_ptr);
823 /* we know that type >= SVt_PV */
824 (void)SvOOK_off(PL_mess_sv);
825 Safefree(SvPVX(PL_mess_sv));
826 Safefree(SvANY(PL_mess_sv));
827 Safefree(PL_mess_sv);
830 return STATUS_NATIVE_EXPORT;
834 =for apidoc perl_free
836 Releases a Perl interpreter. See L<perlembed>.
844 #if defined(WIN32) || defined(NETWARE)
845 # if defined(PERL_IMPLICIT_SYS)
847 void *host = nw_internal_host;
849 void *host = w32_internal_host;
853 nw_delete_internal_host(host);
855 win32_delete_internal_host(host);
866 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
868 Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
869 PL_exitlist[PL_exitlistlen].fn = fn;
870 PL_exitlist[PL_exitlistlen].ptr = ptr;
875 =for apidoc perl_parse
877 Tells a Perl interpreter to parse a Perl script. See L<perlembed>.
883 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
888 #ifdef USE_5005THREADS
892 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
895 Perl_croak(aTHX_ "suidperl is no longer needed since the kernel can now execute\n\
896 setuid perl scripts securely.\n");
905 /* Come here if running an undumped a.out. */
907 PL_origfilename = savepv(argv[0]);
908 PL_do_undump = FALSE;
909 cxstack_ix = -1; /* start label stack again */
911 init_postdump_symbols(argc,argv,env);
916 op_free(PL_main_root);
917 PL_main_root = Nullop;
919 PL_main_start = Nullop;
920 SvREFCNT_dec(PL_main_cv);
924 oldscope = PL_scopestack_ix;
925 PL_dowarn = G_WARN_OFF;
927 #ifdef PERL_FLEXIBLE_EXCEPTIONS
928 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vparse_body), env, xsinit);
934 #ifndef PERL_FLEXIBLE_EXCEPTIONS
935 parse_body(env,xsinit);
938 call_list(oldscope, PL_checkav);
945 /* my_exit() was called */
946 while (PL_scopestack_ix > oldscope)
949 PL_curstash = PL_defstash;
951 call_list(oldscope, PL_checkav);
952 ret = STATUS_NATIVE_EXPORT;
955 PerlIO_printf(Perl_error_log, "panic: top_env\n");
963 #ifdef PERL_FLEXIBLE_EXCEPTIONS
965 S_vparse_body(pTHX_ va_list args)
967 char **env = va_arg(args, char**);
968 XSINIT_t xsinit = va_arg(args, XSINIT_t);
970 return parse_body(env, xsinit);
975 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
977 int argc = PL_origargc;
978 char **argv = PL_origargv;
979 char *scriptname = NULL;
981 VOL bool dosearch = FALSE;
985 char *cddir = Nullch;
987 sv_setpvn(PL_linestr,"",0);
988 sv = newSVpvn("",0); /* first used for -I flags */
992 for (argc--,argv++; argc > 0; argc--,argv++) {
993 if (argv[0][0] != '-' || !argv[0][1])
997 validarg = " PHOOEY ";
1005 #ifndef PERL_STRICT_CR
1030 if ((s = moreswitches(s)))
1035 if( !PL_tainting ) {
1036 PL_taint_warn = TRUE;
1043 PL_taint_warn = FALSE;
1048 #ifdef MACOS_TRADITIONAL
1049 /* ignore -e for Dev:Pseudo argument */
1050 if (argv[1] && !strcmp(argv[1], "Dev:Pseudo"))
1053 if (PL_euid != PL_uid || PL_egid != PL_gid)
1054 Perl_croak(aTHX_ "No -e allowed in setuid scripts");
1056 PL_e_script = newSVpvn("",0);
1057 filter_add(read_e_script, NULL);
1060 sv_catpv(PL_e_script, s);
1062 sv_catpv(PL_e_script, argv[1]);
1066 Perl_croak(aTHX_ "No code specified for -e");
1067 sv_catpv(PL_e_script, "\n");
1070 case 'I': /* -I handled both here and in moreswitches() */
1072 if (!*++s && (s=argv[1]) != Nullch) {
1077 STRLEN len = strlen(s);
1078 p = savepvn(s, len);
1079 incpush(p, TRUE, TRUE, FALSE);
1080 sv_catpvn(sv, "-I", 2);
1081 sv_catpvn(sv, p, len);
1082 sv_catpvn(sv, " ", 1);
1086 Perl_croak(aTHX_ "No directory specified for -I");
1090 PL_preprocess = TRUE;
1100 PL_preambleav = newAV();
1101 av_push(PL_preambleav, newSVpv("use Config qw(myconfig config_vars)",0));
1103 PL_Sv = newSVpv("print myconfig();",0);
1105 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this PERLSHR image: \\n\",");
1107 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this binary (from libperl): \\n\",");
1109 sv_catpv(PL_Sv,"\" Compile-time options:");
1111 sv_catpv(PL_Sv," DEBUGGING");
1113 # ifdef MULTIPLICITY
1114 sv_catpv(PL_Sv," MULTIPLICITY");
1116 # ifdef USE_5005THREADS
1117 sv_catpv(PL_Sv," USE_5005THREADS");
1119 # ifdef USE_ITHREADS
1120 sv_catpv(PL_Sv," USE_ITHREADS");
1122 # ifdef USE_64_BIT_INT
1123 sv_catpv(PL_Sv," USE_64_BIT_INT");
1125 # ifdef USE_64_BIT_ALL
1126 sv_catpv(PL_Sv," USE_64_BIT_ALL");
1128 # ifdef USE_LONG_DOUBLE
1129 sv_catpv(PL_Sv," USE_LONG_DOUBLE");
1131 # ifdef USE_LARGE_FILES
1132 sv_catpv(PL_Sv," USE_LARGE_FILES");
1135 sv_catpv(PL_Sv," USE_SOCKS");
1137 # ifdef PERL_IMPLICIT_CONTEXT
1138 sv_catpv(PL_Sv," PERL_IMPLICIT_CONTEXT");
1140 # ifdef PERL_IMPLICIT_SYS
1141 sv_catpv(PL_Sv," PERL_IMPLICIT_SYS");
1143 sv_catpv(PL_Sv,"\\n\",");
1145 #if defined(LOCAL_PATCH_COUNT)
1146 if (LOCAL_PATCH_COUNT > 0) {
1148 sv_catpv(PL_Sv,"\" Locally applied patches:\\n\",");
1149 for (i = 1; i <= LOCAL_PATCH_COUNT; i++) {
1150 if (PL_localpatches[i])
1151 Perl_sv_catpvf(aTHX_ PL_Sv,"q\" \t%s\n\",",PL_localpatches[i]);
1155 Perl_sv_catpvf(aTHX_ PL_Sv,"\" Built under %s\\n\"",OSNAME);
1158 Perl_sv_catpvf(aTHX_ PL_Sv,",\" Compiled at %s %s\\n\"",__DATE__,__TIME__);
1160 Perl_sv_catpvf(aTHX_ PL_Sv,",\" Compiled on %s\\n\"",__DATE__);
1163 sv_catpv(PL_Sv, "; \
1165 @env = map { \"$_=\\\"$ENV{$_}\\\"\" } sort grep {/^PERL/} keys %ENV; ");
1168 push @env, \"CYGWIN=\\\"$ENV{CYGWIN}\\\"\";");
1171 print \" \\%ENV:\\n @env\\n\" if @env; \
1172 print \" \\@INC:\\n @INC\\n\";");
1175 PL_Sv = newSVpv("config_vars(qw(",0);
1176 sv_catpv(PL_Sv, ++s);
1177 sv_catpv(PL_Sv, "))");
1180 av_push(PL_preambleav, PL_Sv);
1181 scriptname = BIT_BUCKET; /* don't look for script or read stdin */
1184 PL_doextract = TRUE;
1192 if (!*++s || isSPACE(*s)) {
1196 /* catch use of gnu style long options */
1197 if (strEQ(s, "version")) {
1201 if (strEQ(s, "help")) {
1208 Perl_croak(aTHX_ "Unrecognized switch: -%s (-h will show valid options)",s);
1212 sv_setsv(get_sv("/", TRUE), PL_rs);
1215 #ifndef SECURE_INTERNAL_GETENV
1218 (s = PerlEnv_getenv("PERL5OPT")))
1223 if (*s == '-' && *(s+1) == 'T') {
1225 PL_taint_warn = FALSE;
1228 char *popt_copy = Nullch;
1241 if (!strchr("DIMUdmtwA", *s))
1242 Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
1246 popt_copy = SvPVX(sv_2mortal(newSVpv(popt,0)));
1247 s = popt_copy + (s - popt);
1248 d = popt_copy + (d - popt);
1255 if( !PL_tainting ) {
1256 PL_taint_warn = TRUE;
1266 if (PL_taint_warn && PL_dowarn != G_WARN_ALL_OFF) {
1267 PL_compiling.cop_warnings = newSVpvn(WARN_TAINTstring, WARNsize);
1271 scriptname = argv[0];
1274 scriptname = BIT_BUCKET; /* don't look for script or read stdin */
1276 else if (scriptname == Nullch) {
1278 if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
1286 open_script(scriptname,dosearch,sv,&fdscript);
1288 validate_suid(validarg, scriptname,fdscript);
1291 #if defined(SIGCHLD) || defined(SIGCLD)
1294 # define SIGCHLD SIGCLD
1296 Sighandler_t sigstate = rsignal_state(SIGCHLD);
1297 if (sigstate == SIG_IGN) {
1298 if (ckWARN(WARN_SIGNAL))
1299 Perl_warner(aTHX_ packWARN(WARN_SIGNAL),
1300 "Can't ignore signal CHLD, forcing to default");
1301 (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
1307 #ifdef MACOS_TRADITIONAL
1308 if (PL_doextract || gMacPerl_AlwaysExtract) {
1313 if (cddir && PerlDir_chdir(cddir) < 0)
1314 Perl_croak(aTHX_ "Can't chdir to %s",cddir);
1318 PL_main_cv = PL_compcv = (CV*)NEWSV(1104,0);
1319 sv_upgrade((SV *)PL_compcv, SVt_PVCV);
1320 CvUNIQUE_on(PL_compcv);
1322 CvPADLIST(PL_compcv) = pad_new(0);
1323 #ifdef USE_5005THREADS
1324 CvOWNER(PL_compcv) = 0;
1325 New(666, CvMUTEXP(PL_compcv), 1, perl_mutex);
1326 MUTEX_INIT(CvMUTEXP(PL_compcv));
1327 #endif /* USE_5005THREADS */
1330 boot_core_UNIVERSAL();
1332 boot_core_xsutils();
1336 (*xsinit)(aTHX); /* in case linked C routines want magical variables */
1338 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(EPOC)
1344 # ifdef HAS_SOCKS5_INIT
1345 socks5_init(argv[0]);
1351 init_predump_symbols();
1352 /* init_postdump_symbols not currently designed to be called */
1353 /* more than once (ENV isn't cleared first, for example) */
1354 /* But running with -u leaves %ENV & @ARGV undefined! XXX */
1356 init_postdump_symbols(argc,argv,env);
1358 /* PL_unicode is turned on by -C or by $ENV{PERL_UNICODE}.
1359 * PL_utf8locale is conditionally turned on by
1360 * locale.c:Perl_init_i18nl10n() if the environment
1361 * look like the user wants to use UTF-8. */
1363 /* Requires init_predump_symbols(). */
1364 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
1369 /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
1370 * and the default open disciplines. */
1371 if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
1372 PL_stdingv && (io = GvIO(PL_stdingv)) &&
1374 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1375 if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
1376 PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
1378 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1379 if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
1380 PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
1382 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1383 if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
1384 (sv = GvSV(gv_fetchpv("\017PEN", TRUE, SVt_PV)))) {
1385 U32 in = PL_unicode & PERL_UNICODE_IN_FLAG;
1386 U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
1389 sv_setpvn(sv, ":utf8\0:utf8", 11);
1391 sv_setpvn(sv, ":utf8\0", 6);
1394 sv_setpvn(sv, "\0:utf8", 6);
1400 if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
1401 if (strEQ(s, "unsafe"))
1402 PL_signals |= PERL_SIGNALS_UNSAFE_FLAG;
1403 else if (strEQ(s, "safe"))
1404 PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
1406 Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
1411 /* now parse the script */
1413 SETERRNO(0,SS_NORMAL);
1415 #ifdef MACOS_TRADITIONAL
1416 if (gMacPerl_SyntaxError = (yyparse() || PL_error_count)) {
1418 Perl_croak(aTHX_ "%s had compilation errors.\n", MacPerl_MPWFileName(PL_origfilename));
1420 Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1421 MacPerl_MPWFileName(PL_origfilename));
1425 if (yyparse() || PL_error_count) {
1427 Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
1429 Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1434 CopLINE_set(PL_curcop, 0);
1435 PL_curstash = PL_defstash;
1436 PL_preprocess = FALSE;
1438 SvREFCNT_dec(PL_e_script);
1439 PL_e_script = Nullsv;
1446 SAVECOPFILE(PL_curcop);
1447 SAVECOPLINE(PL_curcop);
1448 gv_check(PL_defstash);
1455 if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && atoi(s) >= 2)
1456 dump_mstats("after compilation:");
1465 =for apidoc perl_run
1467 Tells a Perl interpreter to run. See L<perlembed>.
1478 #ifdef USE_5005THREADS
1482 oldscope = PL_scopestack_ix;
1487 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1489 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vrun_body), oldscope);
1495 cxstack_ix = -1; /* start context stack again */
1497 case 0: /* normal completion */
1498 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1503 case 2: /* my_exit() */
1504 while (PL_scopestack_ix > oldscope)
1507 PL_curstash = PL_defstash;
1508 if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
1509 PL_endav && !PL_minus_c)
1510 call_list(oldscope, PL_endav);
1512 if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
1513 dump_mstats("after execution: ");
1515 ret = STATUS_NATIVE_EXPORT;
1519 POPSTACK_TO(PL_mainstack);
1522 PerlIO_printf(Perl_error_log, "panic: restartop\n");
1532 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1534 S_vrun_body(pTHX_ va_list args)
1536 I32 oldscope = va_arg(args, I32);
1538 return run_body(oldscope);
1544 S_run_body(pTHX_ I32 oldscope)
1546 DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support.\n",
1547 PL_sawampersand ? "Enabling" : "Omitting"));
1549 if (!PL_restartop) {
1550 DEBUG_x(dump_all());
1551 DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
1552 DEBUG_S(PerlIO_printf(Perl_debug_log, "main thread is 0x%"UVxf"\n",
1556 #ifdef MACOS_TRADITIONAL
1557 PerlIO_printf(Perl_error_log, "%s%s syntax OK\n",
1558 (gMacPerl_ErrorFormat ? "# " : ""),
1559 MacPerl_MPWFileName(PL_origfilename));
1561 PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
1565 if (PERLDB_SINGLE && PL_DBsingle)
1566 sv_setiv(PL_DBsingle, 1);
1568 call_list(oldscope, PL_initav);
1574 PL_op = PL_restartop;
1578 else if (PL_main_start) {
1579 CvDEPTH(PL_main_cv) = 1;
1580 PL_op = PL_main_start;
1590 =head1 SV Manipulation Functions
1592 =for apidoc p||get_sv
1594 Returns the SV of the specified Perl scalar. If C<create> is set and the
1595 Perl variable does not exist then it will be created. If C<create> is not
1596 set and the variable does not exist then NULL is returned.
1602 Perl_get_sv(pTHX_ const char *name, I32 create)
1605 #ifdef USE_5005THREADS
1606 if (name[1] == '\0' && !isALPHA(name[0])) {
1607 PADOFFSET tmp = find_threadsv(name);
1608 if (tmp != NOT_IN_PAD)
1609 return THREADSV(tmp);
1611 #endif /* USE_5005THREADS */
1612 gv = gv_fetchpv(name, create, SVt_PV);
1619 =head1 Array Manipulation Functions
1621 =for apidoc p||get_av
1623 Returns the AV of the specified Perl array. If C<create> is set and the
1624 Perl variable does not exist then it will be created. If C<create> is not
1625 set and the variable does not exist then NULL is returned.
1631 Perl_get_av(pTHX_ const char *name, I32 create)
1633 GV* gv = gv_fetchpv(name, create, SVt_PVAV);
1642 =head1 Hash Manipulation Functions
1644 =for apidoc p||get_hv
1646 Returns the HV of the specified Perl hash. If C<create> is set and the
1647 Perl variable does not exist then it will be created. If C<create> is not
1648 set and the variable does not exist then NULL is returned.
1654 Perl_get_hv(pTHX_ const char *name, I32 create)
1656 GV* gv = gv_fetchpv(name, create, SVt_PVHV);
1665 =head1 CV Manipulation Functions
1667 =for apidoc p||get_cv
1669 Returns the CV of the specified Perl subroutine. If C<create> is set and
1670 the Perl subroutine does not exist then it will be declared (which has the
1671 same effect as saying C<sub name;>). If C<create> is not set and the
1672 subroutine does not exist then NULL is returned.
1678 Perl_get_cv(pTHX_ const char *name, I32 create)
1680 GV* gv = gv_fetchpv(name, create, SVt_PVCV);
1681 /* XXX unsafe for threads if eval_owner isn't held */
1682 /* XXX this is probably not what they think they're getting.
1683 * It has the same effect as "sub name;", i.e. just a forward
1685 if (create && !GvCVu(gv))
1686 return newSUB(start_subparse(FALSE, 0),
1687 newSVOP(OP_CONST, 0, newSVpv(name,0)),
1695 /* Be sure to refetch the stack pointer after calling these routines. */
1699 =head1 Callback Functions
1701 =for apidoc p||call_argv
1703 Performs a callback to the specified Perl sub. See L<perlcall>.
1709 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, register char **argv)
1711 /* See G_* flags in cop.h */
1712 /* null terminated arg list */
1719 XPUSHs(sv_2mortal(newSVpv(*argv,0)));
1724 return call_pv(sub_name, flags);
1728 =for apidoc p||call_pv
1730 Performs a callback to the specified Perl sub. See L<perlcall>.
1736 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
1737 /* name of the subroutine */
1738 /* See G_* flags in cop.h */
1740 return call_sv((SV*)get_cv(sub_name, TRUE), flags);
1744 =for apidoc p||call_method
1746 Performs a callback to the specified Perl method. The blessed object must
1747 be on the stack. See L<perlcall>.
1753 Perl_call_method(pTHX_ const char *methname, I32 flags)
1754 /* name of the subroutine */
1755 /* See G_* flags in cop.h */
1757 return call_sv(sv_2mortal(newSVpv(methname,0)), flags | G_METHOD);
1760 /* May be called with any of a CV, a GV, or an SV containing the name. */
1762 =for apidoc p||call_sv
1764 Performs a callback to the Perl sub whose name is in the SV. See
1771 Perl_call_sv(pTHX_ SV *sv, I32 flags)
1772 /* See G_* flags in cop.h */
1775 LOGOP myop; /* fake syntax tree node */
1778 volatile I32 retval = 0;
1780 bool oldcatch = CATCH_GET;
1785 if (flags & G_DISCARD) {
1790 Zero(&myop, 1, LOGOP);
1791 myop.op_next = Nullop;
1792 if (!(flags & G_NOARGS))
1793 myop.op_flags |= OPf_STACKED;
1794 myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1795 (flags & G_ARRAY) ? OPf_WANT_LIST :
1800 EXTEND(PL_stack_sp, 1);
1801 *++PL_stack_sp = sv;
1803 oldscope = PL_scopestack_ix;
1805 if (PERLDB_SUB && PL_curstash != PL_debstash
1806 /* Handle first BEGIN of -d. */
1807 && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
1808 /* Try harder, since this may have been a sighandler, thus
1809 * curstash may be meaningless. */
1810 && (SvTYPE(sv) != SVt_PVCV || CvSTASH((CV*)sv) != PL_debstash)
1811 && !(flags & G_NODEBUG))
1812 PL_op->op_private |= OPpENTERSUB_DB;
1814 if (flags & G_METHOD) {
1815 Zero(&method_op, 1, UNOP);
1816 method_op.op_next = PL_op;
1817 method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
1818 myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
1819 PL_op = (OP*)&method_op;
1822 if (!(flags & G_EVAL)) {
1824 call_body((OP*)&myop, FALSE);
1825 retval = PL_stack_sp - (PL_stack_base + oldmark);
1826 CATCH_SET(oldcatch);
1829 myop.op_other = (OP*)&myop;
1831 /* we're trying to emulate pp_entertry() here */
1833 register PERL_CONTEXT *cx;
1834 I32 gimme = GIMME_V;
1839 push_return(Nullop);
1840 PUSHBLOCK(cx, (CXt_EVAL|CXp_TRYBLOCK), PL_stack_sp);
1842 PL_eval_root = PL_op; /* Only needed so that goto works right. */
1844 PL_in_eval = EVAL_INEVAL;
1845 if (flags & G_KEEPERR)
1846 PL_in_eval |= EVAL_KEEPERR;
1852 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1854 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
1861 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1863 call_body((OP*)&myop, FALSE);
1865 retval = PL_stack_sp - (PL_stack_base + oldmark);
1866 if (!(flags & G_KEEPERR))
1873 /* my_exit() was called */
1874 PL_curstash = PL_defstash;
1877 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
1878 Perl_croak(aTHX_ "Callback called exit");
1883 PL_op = PL_restartop;
1887 PL_stack_sp = PL_stack_base + oldmark;
1888 if (flags & G_ARRAY)
1892 *++PL_stack_sp = &PL_sv_undef;
1897 if (PL_scopestack_ix > oldscope) {
1901 register PERL_CONTEXT *cx;
1913 if (flags & G_DISCARD) {
1914 PL_stack_sp = PL_stack_base + oldmark;
1923 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1925 S_vcall_body(pTHX_ va_list args)
1927 OP *myop = va_arg(args, OP*);
1928 int is_eval = va_arg(args, int);
1930 call_body(myop, is_eval);
1936 S_call_body(pTHX_ OP *myop, int is_eval)
1938 if (PL_op == myop) {
1940 PL_op = Perl_pp_entereval(aTHX); /* this doesn't do a POPMARK */
1942 PL_op = Perl_pp_entersub(aTHX); /* this does */
1948 /* Eval a string. The G_EVAL flag is always assumed. */
1951 =for apidoc p||eval_sv
1953 Tells Perl to C<eval> the string in the SV.
1959 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
1961 /* See G_* flags in cop.h */
1964 UNOP myop; /* fake syntax tree node */
1965 volatile I32 oldmark = SP - PL_stack_base;
1966 volatile I32 retval = 0;
1972 if (flags & G_DISCARD) {
1979 Zero(PL_op, 1, UNOP);
1980 EXTEND(PL_stack_sp, 1);
1981 *++PL_stack_sp = sv;
1982 oldscope = PL_scopestack_ix;
1984 if (!(flags & G_NOARGS))
1985 myop.op_flags = OPf_STACKED;
1986 myop.op_next = Nullop;
1987 myop.op_type = OP_ENTEREVAL;
1988 myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1989 (flags & G_ARRAY) ? OPf_WANT_LIST :
1991 if (flags & G_KEEPERR)
1992 myop.op_flags |= OPf_SPECIAL;
1994 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1996 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
2003 #ifndef PERL_FLEXIBLE_EXCEPTIONS
2005 call_body((OP*)&myop,TRUE);
2007 retval = PL_stack_sp - (PL_stack_base + oldmark);
2008 if (!(flags & G_KEEPERR))
2015 /* my_exit() was called */
2016 PL_curstash = PL_defstash;
2019 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2020 Perl_croak(aTHX_ "Callback called exit");
2025 PL_op = PL_restartop;
2029 PL_stack_sp = PL_stack_base + oldmark;
2030 if (flags & G_ARRAY)
2034 *++PL_stack_sp = &PL_sv_undef;
2040 if (flags & G_DISCARD) {
2041 PL_stack_sp = PL_stack_base + oldmark;
2051 =for apidoc p||eval_pv
2053 Tells Perl to C<eval> the given string and return an SV* result.
2059 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
2062 SV* sv = newSVpv(p, 0);
2064 eval_sv(sv, G_SCALAR);
2071 if (croak_on_error && SvTRUE(ERRSV)) {
2073 Perl_croak(aTHX_ SvPVx(ERRSV, n_a));
2079 /* Require a module. */
2082 =head1 Embedding Functions
2084 =for apidoc p||require_pv
2086 Tells Perl to C<require> the file named by the string argument. It is
2087 analogous to the Perl code C<eval "require '$file'">. It's even
2088 implemented that way; consider using load_module instead.
2093 Perl_require_pv(pTHX_ const char *pv)
2097 PUSHSTACKi(PERLSI_REQUIRE);
2099 sv = sv_newmortal();
2100 sv_setpv(sv, "require '");
2103 eval_sv(sv, G_DISCARD);
2109 Perl_magicname(pTHX_ char *sym, char *name, I32 namlen)
2113 if ((gv = gv_fetchpv(sym,TRUE, SVt_PV)))
2114 sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, namlen);
2118 S_usage(pTHX_ char *name) /* XXX move this out into a module ? */
2120 /* This message really ought to be max 23 lines.
2121 * Removed -h because the user already knows that option. Others? */
2123 static char *usage_msg[] = {
2124 "-0[octal] specify record separator (\\0, if no argument)",
2125 "-a autosplit mode with -n or -p (splits $_ into @F)",
2126 "-C enable native wide character system interfaces",
2127 "-c check syntax only (runs BEGIN and CHECK blocks)",
2128 "-d[:debugger] run program under debugger",
2129 "-D[number/list] set debugging flags (argument is a bit mask or alphabets)",
2130 "-e 'command' one line of program (several -e's allowed, omit programfile)",
2131 "-F/pattern/ split() pattern for -a switch (//'s are optional)",
2132 "-i[extension] edit <> files in place (makes backup if extension supplied)",
2133 "-Idirectory specify @INC/#include directory (several -I's allowed)",
2134 "-l[octal] enable line ending processing, specifies line terminator",
2135 "-[mM][-]module execute `use/no module...' before executing program",
2136 "-n assume 'while (<>) { ... }' loop around program",
2137 "-p assume loop like -n but print line also, like sed",
2138 "-P run program through C preprocessor before compilation",
2139 "-s enable rudimentary parsing for switches after programfile",
2140 "-S look for programfile using PATH environment variable",
2141 "-T enable tainting checks",
2142 "-t enable tainting warnings",
2143 "-u dump core after parsing program",
2144 "-U allow unsafe operations",
2145 "-v print version, subversion (includes VERY IMPORTANT perl info)",
2146 "-V[:variable] print configuration summary (or a single Config.pm variable)",
2147 "-w enable many useful warnings (RECOMMENDED)",
2148 "-W enable all warnings",
2149 "-X disable all warnings",
2150 "-x[directory] strip off text before #!perl line and perhaps cd to directory",
2154 char **p = usage_msg;
2156 PerlIO_printf(PerlIO_stdout(),
2157 "\nUsage: %s [switches] [--] [programfile] [arguments]",
2160 PerlIO_printf(PerlIO_stdout(), "\n %s", *p++);
2163 /* This routine handles any switches that can be given during run */
2166 Perl_moreswitches(pTHX_ char *s)
2176 SvREFCNT_dec(PL_rs);
2177 if (s[1] == 'x' && s[2]) {
2181 for (s += 2, e = s; *e; e++);
2183 flags = PERL_SCAN_SILENT_ILLDIGIT;
2184 rschar = (U32)grok_hex(s, &numlen, &flags, NULL);
2185 if (s + numlen < e) {
2186 rschar = 0; /* Grandfather -0xFOO as -0 -xFOO. */
2190 PL_rs = newSVpvn("", 0);
2191 SvGROW(PL_rs, UNISKIP(rschar) + 1);
2192 tmps = (U8*)SvPVX(PL_rs);
2193 uvchr_to_utf8(tmps, rschar);
2194 SvCUR_set(PL_rs, UNISKIP(rschar));
2199 rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
2200 if (rschar & ~((U8)~0))
2201 PL_rs = &PL_sv_undef;
2202 else if (!rschar && numlen >= 2)
2203 PL_rs = newSVpvn("", 0);
2205 char ch = (char)rschar;
2206 PL_rs = newSVpvn(&ch, 1);
2213 PL_unicode = parse_unicode_opts(&s);
2218 while (*s && !isSPACE(*s)) ++s;
2220 PL_splitstr = savepv(PL_splitstr);
2233 /* The following permits -d:Mod to accepts arguments following an =
2234 in the fashion that -MSome::Mod does. */
2235 if (*s == ':' || *s == '=') {
2238 sv = newSVpv("use Devel::", 0);
2240 /* We now allow -d:Module=Foo,Bar */
2241 while(isALNUM(*s) || *s==':') ++s;
2243 sv_catpv(sv, start);
2245 sv_catpvn(sv, start, s-start);
2246 sv_catpv(sv, " split(/,/,q{");
2251 my_setenv("PERL5DB", SvPV(sv, PL_na));
2254 PL_perldb = PERLDB_ALL;
2262 if (isALPHA(s[1])) {
2263 /* if adding extra options, remember to update DEBUG_MASK */
2264 static char debopts[] = "psltocPmfrxu HXDSTRJvC";
2267 for (s++; *s && (d = strchr(debopts,*s)); s++)
2268 PL_debug |= 1 << (d - debopts);
2271 PL_debug = atoi(s+1);
2272 for (s++; isDIGIT(*s); s++) ;
2275 if (DEBUG_p_TEST_ && ckWARN_d(WARN_DEBUGGING))
2276 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2277 "-Dp not implemented on this platform\n");
2279 PL_debug |= DEBUG_TOP_FLAG;
2280 #else /* !DEBUGGING */
2281 if (ckWARN_d(WARN_DEBUGGING))
2282 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2283 "Recompile perl with -DDEBUGGING to use -D switch\n");
2284 for (s++; isALNUM(*s); s++) ;
2290 usage(PL_origargv[0]);
2294 Safefree(PL_inplace);
2295 #if defined(__CYGWIN__) /* do backup extension automagically */
2296 if (*(s+1) == '\0') {
2297 PL_inplace = savepv(".bak");
2300 #endif /* __CYGWIN__ */
2301 PL_inplace = savepv(s+1);
2303 for (s = PL_inplace; *s && !isSPACE(*s); s++) ;
2306 if (*s == '-') /* Additional switches on #! line. */
2310 case 'I': /* -I handled both here and in parse_body() */
2313 while (*s && isSPACE(*s))
2318 /* ignore trailing spaces (possibly followed by other switches) */
2320 for (e = p; *e && !isSPACE(*e); e++) ;
2324 } while (*p && *p != '-');
2325 e = savepvn(s, e-s);
2326 incpush(e, TRUE, TRUE, FALSE);
2333 Perl_croak(aTHX_ "No directory specified for -I");
2339 SvREFCNT_dec(PL_ors_sv);
2344 PL_ors_sv = newSVpvn("\n",1);
2345 numlen = 3 + (*s == '0');
2346 *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
2350 if (RsPARA(PL_rs)) {
2351 PL_ors_sv = newSVpvn("\n\n",2);
2354 PL_ors_sv = newSVsv(PL_rs);
2361 PL_preambleav = newAV();
2363 SV *sv = newSVpvn("use assertions::activate split(/,/,q{",37);
2367 av_push(PL_preambleav, sv);
2370 av_push(PL_preambleav, newSVpvn("use assertions::activate",24));
2373 forbid_setid("-M"); /* XXX ? */
2376 forbid_setid("-m"); /* XXX ? */
2381 /* -M-foo == 'no foo' */
2382 if (*s == '-') { use = "no "; ++s; }
2383 sv = newSVpv(use,0);
2385 /* We allow -M'Module qw(Foo Bar)' */
2386 while(isALNUM(*s) || *s==':') ++s;
2388 sv_catpv(sv, start);
2389 if (*(start-1) == 'm') {
2391 Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
2392 sv_catpv( sv, " ()");
2396 Perl_croak(aTHX_ "Module name required with -%c option",
2398 sv_catpvn(sv, start, s-start);
2399 sv_catpv(sv, " split(/,/,q{");
2405 PL_preambleav = newAV();
2406 av_push(PL_preambleav, sv);
2409 Perl_croak(aTHX_ "No space allowed after -%c", *(s-1));
2421 PL_doswitches = TRUE;
2426 Perl_croak(aTHX_ "Too late for \"-t\" option");
2431 Perl_croak(aTHX_ "Too late for \"-T\" option");
2435 #ifdef MACOS_TRADITIONAL
2436 Perl_croak(aTHX_ "Believe me, you don't want to use \"-u\" on a Macintosh");
2438 PL_do_undump = TRUE;
2447 PerlIO_printf(PerlIO_stdout(),
2448 Perl_form(aTHX_ "\nThis is perl, v%"VDf" built for %s",
2449 PL_patchlevel, ARCHNAME));
2451 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
2452 PerlIO_printf(PerlIO_stdout(),
2453 Perl_form(aTHX_ "\nThis is perl, version %vd\n", PL_patchlevel));
2454 PerlIO_printf(PerlIO_stdout(),
2455 Perl_form(aTHX_ " built under %s at %s %s\n",
2456 OSNAME, __DATE__, __TIME__));
2457 PerlIO_printf(PerlIO_stdout(),
2458 Perl_form(aTHX_ " OS Specific Release: %s\n",
2462 #if defined(LOCAL_PATCH_COUNT)
2463 if (LOCAL_PATCH_COUNT > 0)
2464 PerlIO_printf(PerlIO_stdout(),
2465 "\n(with %d registered patch%s, "
2466 "see perl -V for more detail)",
2467 (int)LOCAL_PATCH_COUNT,
2468 (LOCAL_PATCH_COUNT!=1) ? "es" : "");
2471 PerlIO_printf(PerlIO_stdout(),
2472 "\n\nCopyright 1987-2003, Larry Wall\n");
2473 #ifdef MACOS_TRADITIONAL
2474 PerlIO_printf(PerlIO_stdout(),
2475 "\nMac OS port Copyright 1991-2002, Matthias Neeracher;\n"
2476 "maintained by Chris Nandor\n");
2479 PerlIO_printf(PerlIO_stdout(),
2480 "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
2483 PerlIO_printf(PerlIO_stdout(),
2484 "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
2485 "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
2488 PerlIO_printf(PerlIO_stdout(),
2489 "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
2490 "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
2493 PerlIO_printf(PerlIO_stdout(),
2494 "atariST series port, ++jrb bammi@cadence.com\n");
2497 PerlIO_printf(PerlIO_stdout(),
2498 "BeOS port Copyright Tom Spindler, 1997-1999\n");
2501 PerlIO_printf(PerlIO_stdout(),
2502 "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2002\n");
2505 PerlIO_printf(PerlIO_stdout(),
2506 "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
2509 PerlIO_printf(PerlIO_stdout(),
2510 "Stratus VOS port by Paul.Green@stratus.com, 1997-2002\n");
2513 PerlIO_printf(PerlIO_stdout(),
2514 "VM/ESA port by Neale Ferguson, 1998-1999\n");
2517 PerlIO_printf(PerlIO_stdout(),
2518 "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
2521 PerlIO_printf(PerlIO_stdout(),
2522 "MiNT port by Guido Flohr, 1997-1999\n");
2525 PerlIO_printf(PerlIO_stdout(),
2526 "EPOC port by Olaf Flebbe, 1999-2002\n");
2529 PerlIO_printf(PerlIO_stdout(),"WINCE port by Rainer Keuchel, 2001-2002\n");
2530 PerlIO_printf(PerlIO_stdout(),"Built on " __DATE__ " " __TIME__ "\n\n");
2533 #ifdef BINARY_BUILD_NOTICE
2534 BINARY_BUILD_NOTICE;
2536 PerlIO_printf(PerlIO_stdout(),
2538 Perl may be copied only under the terms of either the Artistic License or the\n\
2539 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
2540 Complete documentation for Perl, including FAQ lists, should be found on\n\
2541 this system using `man perl' or `perldoc perl'. If you have access to the\n\
2542 Internet, point your browser at http://www.perl.com/, the Perl Home Page.\n\n");
2545 if (! (PL_dowarn & G_WARN_ALL_MASK))
2546 PL_dowarn |= G_WARN_ON;
2550 PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
2551 if (!specialWARN(PL_compiling.cop_warnings))
2552 SvREFCNT_dec(PL_compiling.cop_warnings);
2553 PL_compiling.cop_warnings = pWARN_ALL ;
2557 PL_dowarn = G_WARN_ALL_OFF;
2558 if (!specialWARN(PL_compiling.cop_warnings))
2559 SvREFCNT_dec(PL_compiling.cop_warnings);
2560 PL_compiling.cop_warnings = pWARN_NONE ;
2565 if (s[1] == '-') /* Additional switches on #! line. */
2570 #if defined(WIN32) || !defined(PERL_STRICT_CR)
2576 #ifdef ALTERNATE_SHEBANG
2577 case 'S': /* OS/2 needs -S on "extproc" line. */
2585 Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
2590 /* compliments of Tom Christiansen */
2592 /* unexec() can be found in the Gnu emacs distribution */
2593 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
2596 Perl_my_unexec(pTHX)
2604 prog = newSVpv(BIN_EXP, 0);
2605 sv_catpv(prog, "/perl");
2606 file = newSVpv(PL_origfilename, 0);
2607 sv_catpv(file, ".perldump");
2609 unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
2610 /* unexec prints msg to stderr in case of failure */
2611 PerlProc_exit(status);
2614 # include <lib$routines.h>
2615 lib$signal(SS$_DEBUG); /* ssdef.h #included from vmsish.h */
2617 ABORT(); /* for use with undump */
2622 /* initialize curinterp */
2628 # define PERLVAR(var,type)
2629 # define PERLVARA(var,n,type)
2630 # if defined(PERL_IMPLICIT_CONTEXT)
2631 # if defined(USE_5005THREADS)
2632 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2633 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2634 # else /* !USE_5005THREADS */
2635 # define PERLVARI(var,type,init) aTHX->var = init;
2636 # define PERLVARIC(var,type,init) aTHX->var = init;
2637 # endif /* USE_5005THREADS */
2639 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2640 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2642 # include "intrpvar.h"
2643 # ifndef USE_5005THREADS
2644 # include "thrdvar.h"
2651 # define PERLVAR(var,type)
2652 # define PERLVARA(var,n,type)
2653 # define PERLVARI(var,type,init) PL_##var = init;
2654 # define PERLVARIC(var,type,init) PL_##var = init;
2655 # include "intrpvar.h"
2656 # ifndef USE_5005THREADS
2657 # include "thrdvar.h"
2668 S_init_main_stash(pTHX)
2672 PL_curstash = PL_defstash = newHV();
2673 PL_curstname = newSVpvn("main",4);
2674 gv = gv_fetchpv("main::",TRUE, SVt_PVHV);
2675 SvREFCNT_dec(GvHV(gv));
2676 GvHV(gv) = (HV*)SvREFCNT_inc(PL_defstash);
2678 HvNAME(PL_defstash) = savepv("main");
2679 PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpv("INC",TRUE, SVt_PVAV)));
2680 GvMULTI_on(PL_incgv);
2681 PL_hintgv = gv_fetchpv("\010",TRUE, SVt_PV); /* ^H */
2682 GvMULTI_on(PL_hintgv);
2683 PL_defgv = gv_fetchpv("_",TRUE, SVt_PVAV);
2684 PL_errgv = gv_HVadd(gv_fetchpv("@", TRUE, SVt_PV));
2685 GvMULTI_on(PL_errgv);
2686 PL_replgv = gv_fetchpv("\022", TRUE, SVt_PV); /* ^R */
2687 GvMULTI_on(PL_replgv);
2688 (void)Perl_form(aTHX_ "%240s",""); /* Preallocate temp - for immediate signals. */
2689 sv_grow(ERRSV, 240); /* Preallocate - for immediate signals. */
2690 sv_setpvn(ERRSV, "", 0);
2691 PL_curstash = PL_defstash;
2692 CopSTASH_set(&PL_compiling, PL_defstash);
2693 PL_debstash = GvHV(gv_fetchpv("DB::", GV_ADDMULTI, SVt_PVHV));
2694 PL_globalstash = GvHV(gv_fetchpv("CORE::GLOBAL::", GV_ADDMULTI, SVt_PVHV));
2695 /* We must init $/ before switches are processed. */
2696 sv_setpvn(get_sv("/", TRUE), "\n", 1);
2700 S_open_script(pTHX_ char *scriptname, bool dosearch, SV *sv, int *fdscript)
2704 char *cpp_discard_flag;
2710 PL_origfilename = savepv("-e");
2713 /* if find_script() returns, it returns a malloc()-ed value */
2714 PL_origfilename = scriptname = find_script(scriptname, dosearch, NULL, 1);
2716 if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
2717 char *s = scriptname + 8;
2718 *fdscript = atoi(s);
2722 scriptname = savepv(s + 1);
2723 Safefree(PL_origfilename);
2724 PL_origfilename = scriptname;
2729 CopFILE_free(PL_curcop);
2730 CopFILE_set(PL_curcop, PL_origfilename);
2731 if (strEQ(PL_origfilename,"-"))
2733 if (*fdscript >= 0) {
2734 PL_rsfp = PerlIO_fdopen(*fdscript,PERL_SCRIPT_MODE);
2735 # if defined(HAS_FCNTL) && defined(F_SETFD)
2737 /* ensure close-on-exec */
2738 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2741 else if (PL_preprocess) {
2742 char *cpp_cfg = CPPSTDIN;
2743 SV *cpp = newSVpvn("",0);
2744 SV *cmd = NEWSV(0,0);
2746 if (strEQ(cpp_cfg, "cppstdin"))
2747 Perl_sv_catpvf(aTHX_ cpp, "%s/", BIN_EXP);
2748 sv_catpv(cpp, cpp_cfg);
2751 sv_catpvn(sv, "-I", 2);
2752 sv_catpv(sv,PRIVLIB_EXP);
2755 DEBUG_P(PerlIO_printf(Perl_debug_log,
2756 "PL_preprocess: scriptname=\"%s\", cpp=\"%s\", sv=\"%s\", CPPMINUS=\"%s\"\n",
2757 scriptname, SvPVX (cpp), SvPVX (sv), CPPMINUS));
2759 # if defined(MSDOS) || defined(WIN32) || defined(VMS)
2766 cpp_discard_flag = "";
2768 cpp_discard_flag = "-C";
2772 perl = os2_execname(aTHX);
2774 perl = PL_origargv[0];
2778 /* This strips off Perl comments which might interfere with
2779 the C pre-processor, including #!. #line directives are
2780 deliberately stripped to avoid confusion with Perl's version
2781 of #line. FWP played some golf with it so it will fit
2782 into VMS's 255 character buffer.
2785 code = "(1../^#!.*perl/i)|/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2787 code = "/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2789 Perl_sv_setpvf(aTHX_ cmd, "\
2790 %s -ne%s%s%s %s | %"SVf" %s %"SVf" %s",
2791 perl, quote, code, quote, scriptname, cpp,
2792 cpp_discard_flag, sv, CPPMINUS);
2794 PL_doextract = FALSE;
2795 # ifdef IAMSUID /* actually, this is caught earlier */
2796 if (PL_euid != PL_uid && !PL_euid) { /* if running suidperl */
2798 (void)seteuid(PL_uid); /* musn't stay setuid root */
2800 # ifdef HAS_SETREUID
2801 (void)setreuid((Uid_t)-1, PL_uid);
2803 # ifdef HAS_SETRESUID
2804 (void)setresuid((Uid_t)-1, PL_uid, (Uid_t)-1);
2806 PerlProc_setuid(PL_uid);
2810 if (PerlProc_geteuid() != PL_uid)
2811 Perl_croak(aTHX_ "Can't do seteuid!\n");
2813 # endif /* IAMSUID */
2815 DEBUG_P(PerlIO_printf(Perl_debug_log,
2816 "PL_preprocess: cmd=\"%s\"\n",
2819 PL_rsfp = PerlProc_popen(SvPVX(cmd), "r");
2823 else if (!*scriptname) {
2824 forbid_setid("program input from stdin");
2825 PL_rsfp = PerlIO_stdin();
2828 PL_rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
2829 # if defined(HAS_FCNTL) && defined(F_SETFD)
2831 /* ensure close-on-exec */
2832 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2837 # ifndef IAMSUID /* in case script is not readable before setuid */
2839 PerlLIO_stat(CopFILE(PL_curcop),&PL_statbuf) >= 0 &&
2840 PL_statbuf.st_mode & (S_ISUID|S_ISGID))
2843 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT,
2844 BIN_EXP, (int)PERL_REVISION,
2846 (int)PERL_SUBVERSION), PL_origargv);
2847 Perl_croak(aTHX_ "Can't do setuid\n");
2853 Perl_croak(aTHX_ "Can't open perl script: %s\n",
2856 Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
2857 CopFILE(PL_curcop), Strerror(errno));
2863 * I_SYSSTATVFS HAS_FSTATVFS
2865 * I_STATFS HAS_FSTATFS HAS_GETFSSTAT
2866 * I_MNTENT HAS_GETMNTENT HAS_HASMNTOPT
2867 * here so that metaconfig picks them up. */
2871 S_fd_on_nosuid_fs(pTHX_ int fd)
2873 int check_okay = 0; /* able to do all the required sys/libcalls */
2874 int on_nosuid = 0; /* the fd is on a nosuid fs */
2876 * Preferred order: fstatvfs(), fstatfs(), ustat()+getmnt(), getmntent().
2877 * fstatvfs() is UNIX98.
2878 * fstatfs() is 4.3 BSD.
2879 * ustat()+getmnt() is pre-4.3 BSD.
2880 * getmntent() is O(number-of-mounted-filesystems) and can hang on
2881 * an irrelevant filesystem while trying to reach the right one.
2884 #undef FD_ON_NOSUID_CHECK_OKAY /* found the syscalls to do the check? */
2886 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2887 defined(HAS_FSTATVFS)
2888 # define FD_ON_NOSUID_CHECK_OKAY
2889 struct statvfs stfs;
2891 check_okay = fstatvfs(fd, &stfs) == 0;
2892 on_nosuid = check_okay && (stfs.f_flag & ST_NOSUID);
2893 # endif /* fstatvfs */
2895 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2896 defined(PERL_MOUNT_NOSUID) && \
2897 defined(HAS_FSTATFS) && \
2898 defined(HAS_STRUCT_STATFS) && \
2899 defined(HAS_STRUCT_STATFS_F_FLAGS)
2900 # define FD_ON_NOSUID_CHECK_OKAY
2903 check_okay = fstatfs(fd, &stfs) == 0;
2904 on_nosuid = check_okay && (stfs.f_flags & PERL_MOUNT_NOSUID);
2905 # endif /* fstatfs */
2907 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2908 defined(PERL_MOUNT_NOSUID) && \
2909 defined(HAS_FSTAT) && \
2910 defined(HAS_USTAT) && \
2911 defined(HAS_GETMNT) && \
2912 defined(HAS_STRUCT_FS_DATA) && \
2914 # define FD_ON_NOSUID_CHECK_OKAY
2917 if (fstat(fd, &fdst) == 0) {
2919 if (ustat(fdst.st_dev, &us) == 0) {
2921 /* NOSTAT_ONE here because we're not examining fields which
2922 * vary between that case and STAT_ONE. */
2923 if (getmnt((int*)0, &fsd, (int)0, NOSTAT_ONE, us.f_fname) == 0) {
2924 size_t cmplen = sizeof(us.f_fname);
2925 if (sizeof(fsd.fd_req.path) < cmplen)
2926 cmplen = sizeof(fsd.fd_req.path);
2927 if (strnEQ(fsd.fd_req.path, us.f_fname, cmplen) &&
2928 fdst.st_dev == fsd.fd_req.dev) {
2930 on_nosuid = fsd.fd_req.flags & PERL_MOUNT_NOSUID;
2936 # endif /* fstat+ustat+getmnt */
2938 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2939 defined(HAS_GETMNTENT) && \
2940 defined(HAS_HASMNTOPT) && \
2941 defined(MNTOPT_NOSUID)
2942 # define FD_ON_NOSUID_CHECK_OKAY
2943 FILE *mtab = fopen("/etc/mtab", "r");
2944 struct mntent *entry;
2947 if (mtab && (fstat(fd, &stb) == 0)) {
2948 while (entry = getmntent(mtab)) {
2949 if (stat(entry->mnt_dir, &fsb) == 0
2950 && fsb.st_dev == stb.st_dev)
2952 /* found the filesystem */
2954 if (hasmntopt(entry, MNTOPT_NOSUID))
2957 } /* A single fs may well fail its stat(). */
2962 # endif /* getmntent+hasmntopt */
2965 Perl_croak(aTHX_ "Can't check filesystem of script \"%s\" for nosuid", PL_origfilename);
2968 #endif /* IAMSUID */
2971 S_validate_suid(pTHX_ char *validarg, char *scriptname, int fdscript)
2977 /* do we need to emulate setuid on scripts? */
2979 /* This code is for those BSD systems that have setuid #! scripts disabled
2980 * in the kernel because of a security problem. Merely defining DOSUID
2981 * in perl will not fix that problem, but if you have disabled setuid
2982 * scripts in the kernel, this will attempt to emulate setuid and setgid
2983 * on scripts that have those now-otherwise-useless bits set. The setuid
2984 * root version must be called suidperl or sperlN.NNN. If regular perl
2985 * discovers that it has opened a setuid script, it calls suidperl with
2986 * the same argv that it had. If suidperl finds that the script it has
2987 * just opened is NOT setuid root, it sets the effective uid back to the
2988 * uid. We don't just make perl setuid root because that loses the
2989 * effective uid we had before invoking perl, if it was different from the
2992 * DOSUID must be defined in both perl and suidperl, and IAMSUID must
2993 * be defined in suidperl only. suidperl must be setuid root. The
2994 * Configure script will set this up for you if you want it.
3000 if (PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf) < 0) /* normal stat is insecure */
3001 Perl_croak(aTHX_ "Can't stat script \"%s\"",PL_origfilename);
3002 if (fdscript < 0 && PL_statbuf.st_mode & (S_ISUID|S_ISGID)) {
3007 #ifndef HAS_SETREUID
3008 /* On this access check to make sure the directories are readable,
3009 * there is actually a small window that the user could use to make
3010 * filename point to an accessible directory. So there is a faint
3011 * chance that someone could execute a setuid script down in a
3012 * non-accessible directory. I don't know what to do about that.
3013 * But I don't think it's too important. The manual lies when
3014 * it says access() is useful in setuid programs.
3016 if (PerlLIO_access(CopFILE(PL_curcop),1)) /*double check*/
3017 Perl_croak(aTHX_ "Permission denied");
3019 /* If we can swap euid and uid, then we can determine access rights
3020 * with a simple stat of the file, and then compare device and
3021 * inode to make sure we did stat() on the same file we opened.
3022 * Then we just have to make sure he or she can execute it.
3029 setreuid(PL_euid,PL_uid) < 0
3032 setresuid(PL_euid,PL_uid,(Uid_t)-1) < 0
3035 || PerlProc_getuid() != PL_euid || PerlProc_geteuid() != PL_uid)
3036 Perl_croak(aTHX_ "Can't swap uid and euid"); /* really paranoid */
3037 if (PerlLIO_stat(CopFILE(PL_curcop),&tmpstatbuf) < 0)
3038 Perl_croak(aTHX_ "Permission denied"); /* testing full pathname here */
3039 #if defined(IAMSUID) && !defined(NO_NOSUID_CHECK)
3040 if (fd_on_nosuid_fs(PerlIO_fileno(PL_rsfp)))
3041 Perl_croak(aTHX_ "Permission denied");
3043 if (tmpstatbuf.st_dev != PL_statbuf.st_dev ||
3044 tmpstatbuf.st_ino != PL_statbuf.st_ino) {
3045 (void)PerlIO_close(PL_rsfp);
3046 Perl_croak(aTHX_ "Permission denied\n");
3050 setreuid(PL_uid,PL_euid) < 0
3052 # if defined(HAS_SETRESUID)
3053 setresuid(PL_uid,PL_euid,(Uid_t)-1) < 0
3056 || PerlProc_getuid() != PL_uid || PerlProc_geteuid() != PL_euid)
3057 Perl_croak(aTHX_ "Can't reswap uid and euid");
3058 if (!cando(S_IXUSR,FALSE,&PL_statbuf)) /* can real uid exec? */
3059 Perl_croak(aTHX_ "Permission denied\n");
3061 #endif /* HAS_SETREUID */
3062 #endif /* IAMSUID */
3064 if (!S_ISREG(PL_statbuf.st_mode))
3065 Perl_croak(aTHX_ "Permission denied");
3066 if (PL_statbuf.st_mode & S_IWOTH)
3067 Perl_croak(aTHX_ "Setuid/gid script is writable by world");
3068 PL_doswitches = FALSE; /* -s is insecure in suid */
3069 CopLINE_inc(PL_curcop);
3070 if (sv_gets(PL_linestr, PL_rsfp, 0) == Nullch ||
3071 strnNE(SvPV(PL_linestr,n_a),"#!",2) ) /* required even on Sys V */
3072 Perl_croak(aTHX_ "No #! line");
3073 s = SvPV(PL_linestr,n_a)+2;
3075 while (!isSPACE(*s)) s++;
3076 for (s2 = s; (s2 > SvPV(PL_linestr,n_a)+2 &&
3077 (isDIGIT(s2[-1]) || strchr("._-", s2[-1]))); s2--) ;
3078 if (strnNE(s2-4,"perl",4) && strnNE(s-9,"perl",4)) /* sanity check */
3079 Perl_croak(aTHX_ "Not a perl script");
3080 while (*s == ' ' || *s == '\t') s++;
3082 * #! arg must be what we saw above. They can invoke it by
3083 * mentioning suidperl explicitly, but they may not add any strange
3084 * arguments beyond what #! says if they do invoke suidperl that way.
3086 len = strlen(validarg);
3087 if (strEQ(validarg," PHOOEY ") ||
3088 strnNE(s,validarg,len) || !isSPACE(s[len]))
3089 Perl_croak(aTHX_ "Args must match #! line");
3092 if (PL_euid != PL_uid && (PL_statbuf.st_mode & S_ISUID) &&
3093 PL_euid == PL_statbuf.st_uid)
3095 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3096 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3097 #endif /* IAMSUID */
3099 if (PL_euid) { /* oops, we're not the setuid root perl */
3100 (void)PerlIO_close(PL_rsfp);
3103 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
3104 (int)PERL_REVISION, (int)PERL_VERSION,
3105 (int)PERL_SUBVERSION), PL_origargv);
3107 Perl_croak(aTHX_ "Can't do setuid\n");
3110 if (PL_statbuf.st_mode & S_ISGID && PL_statbuf.st_gid != PL_egid) {
3112 (void)setegid(PL_statbuf.st_gid);
3115 (void)setregid((Gid_t)-1,PL_statbuf.st_gid);
3117 #ifdef HAS_SETRESGID
3118 (void)setresgid((Gid_t)-1,PL_statbuf.st_gid,(Gid_t)-1);
3120 PerlProc_setgid(PL_statbuf.st_gid);
3124 if (PerlProc_getegid() != PL_statbuf.st_gid)
3125 Perl_croak(aTHX_ "Can't do setegid!\n");
3127 if (PL_statbuf.st_mode & S_ISUID) {
3128 if (PL_statbuf.st_uid != PL_euid)
3130 (void)seteuid(PL_statbuf.st_uid); /* all that for this */
3133 (void)setreuid((Uid_t)-1,PL_statbuf.st_uid);
3135 #ifdef HAS_SETRESUID
3136 (void)setresuid((Uid_t)-1,PL_statbuf.st_uid,(Uid_t)-1);
3138 PerlProc_setuid(PL_statbuf.st_uid);
3142 if (PerlProc_geteuid() != PL_statbuf.st_uid)
3143 Perl_croak(aTHX_ "Can't do seteuid!\n");
3145 else if (PL_uid) { /* oops, mustn't run as root */
3147 (void)seteuid((Uid_t)PL_uid);
3150 (void)setreuid((Uid_t)-1,(Uid_t)PL_uid);
3152 #ifdef HAS_SETRESUID
3153 (void)setresuid((Uid_t)-1,(Uid_t)PL_uid,(Uid_t)-1);
3155 PerlProc_setuid((Uid_t)PL_uid);
3159 if (PerlProc_geteuid() != PL_uid)
3160 Perl_croak(aTHX_ "Can't do seteuid!\n");
3163 if (!cando(S_IXUSR,TRUE,&PL_statbuf))
3164 Perl_croak(aTHX_ "Permission denied\n"); /* they can't do this */
3167 else if (PL_preprocess)
3168 Perl_croak(aTHX_ "-P not allowed for setuid/setgid script\n");
3169 else if (fdscript >= 0)
3170 Perl_croak(aTHX_ "fd script not allowed in suidperl\n");
3172 Perl_croak(aTHX_ "Script is not setuid/setgid in suidperl\n");
3174 /* We absolutely must clear out any saved ids here, so we */
3175 /* exec the real perl, substituting fd script for scriptname. */
3176 /* (We pass script name as "subdir" of fd, which perl will grok.) */
3177 PerlIO_rewind(PL_rsfp);
3178 PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0); /* just in case rewind didn't */
3179 for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;
3180 if (!PL_origargv[which])
3181 Perl_croak(aTHX_ "Permission denied");
3182 PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",
3183 PerlIO_fileno(PL_rsfp), PL_origargv[which]));
3184 #if defined(HAS_FCNTL) && defined(F_SETFD)
3185 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0); /* ensure no close-on-exec */
3187 PerlProc_execv(Perl_form(aTHX_ "%s/perl"PERL_FS_VER_FMT, BIN_EXP,
3188 (int)PERL_REVISION, (int)PERL_VERSION,
3189 (int)PERL_SUBVERSION), PL_origargv);/* try again */
3190 Perl_croak(aTHX_ "Can't do setuid\n");
3191 #endif /* IAMSUID */
3193 if (PL_euid != PL_uid || PL_egid != PL_gid) { /* (suidperl doesn't exist, in fact) */
3194 #ifndef SETUID_SCRIPTS_ARE_SECURE_NOW
3195 PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf); /* may be either wrapped or real suid */
3196 if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3198 (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3201 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3202 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3203 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3204 /* not set-id, must be wrapped */
3210 S_find_beginning(pTHX)
3212 register char *s, *s2;
3213 #ifdef MACOS_TRADITIONAL
3217 /* skip forward in input to the real script? */
3220 #ifdef MACOS_TRADITIONAL
3221 /* Since the Mac OS does not honor #! arguments for us, we do it ourselves */
3223 while (PL_doextract || gMacPerl_AlwaysExtract) {
3224 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
3225 if (!gMacPerl_AlwaysExtract)
3226 Perl_croak(aTHX_ "No Perl script found in input\n");
3228 if (PL_doextract) /* require explicit override ? */
3229 if (!OverrideExtract(PL_origfilename))
3230 Perl_croak(aTHX_ "User aborted script\n");
3232 PL_doextract = FALSE;
3234 /* Pater peccavi, file does not have #! */
3235 PerlIO_rewind(PL_rsfp);
3240 while (PL_doextract) {
3241 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch)
3242 Perl_croak(aTHX_ "No Perl script found in input\n");
3245 if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
3246 PerlIO_ungetc(PL_rsfp, '\n'); /* to keep line count right */
3247 PL_doextract = FALSE;
3248 while (*s && !(isSPACE (*s) || *s == '#')) s++;
3250 while (*s == ' ' || *s == '\t') s++;
3252 while (isDIGIT(s2[-1]) || strchr("-._", s2[-1])) s2--;
3253 if (strnEQ(s2-4,"perl",4))
3255 while ((s = moreswitches(s)))
3258 #ifdef MACOS_TRADITIONAL
3259 /* We are always searching for the #!perl line in MacPerl,
3260 * so if we find it, still keep the line count correct
3261 * by counting lines we already skipped over
3263 for (; maclines > 0 ; maclines--)
3264 PerlIO_ungetc(PL_rsfp, '\n');
3268 /* gMacPerl_AlwaysExtract is false in MPW tool */
3269 } else if (gMacPerl_AlwaysExtract) {
3280 PL_uid = PerlProc_getuid();
3281 PL_euid = PerlProc_geteuid();
3282 PL_gid = PerlProc_getgid();
3283 PL_egid = PerlProc_getegid();
3285 PL_uid |= PL_gid << 16;
3286 PL_euid |= PL_egid << 16;
3288 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3292 S_forbid_setid(pTHX_ char *s)
3294 if (PL_euid != PL_uid)
3295 Perl_croak(aTHX_ "No %s allowed while running setuid", s);
3296 if (PL_egid != PL_gid)
3297 Perl_croak(aTHX_ "No %s allowed while running setgid", s);
3301 Perl_init_debugger(pTHX)
3303 HV *ostash = PL_curstash;
3305 PL_curstash = PL_debstash;
3306 PL_dbargs = GvAV(gv_AVadd((gv_fetchpv("args", GV_ADDMULTI, SVt_PVAV))));
3307 AvREAL_off(PL_dbargs);
3308 PL_DBgv = gv_fetchpv("DB", GV_ADDMULTI, SVt_PVGV);
3309 PL_DBline = gv_fetchpv("dbline", GV_ADDMULTI, SVt_PVAV);
3310 PL_DBsub = gv_HVadd(gv_fetchpv("sub", GV_ADDMULTI, SVt_PVHV));
3311 sv_upgrade(GvSV(PL_DBsub), SVt_IV); /* IVX accessed if PERLDB_SUB_NN */
3312 PL_DBsingle = GvSV((gv_fetchpv("single", GV_ADDMULTI, SVt_PV)));
3313 sv_setiv(PL_DBsingle, 0);
3314 PL_DBtrace = GvSV((gv_fetchpv("trace", GV_ADDMULTI, SVt_PV)));
3315 sv_setiv(PL_DBtrace, 0);
3316 PL_DBsignal = GvSV((gv_fetchpv("signal", GV_ADDMULTI, SVt_PV)));
3317 sv_setiv(PL_DBsignal, 0);
3318 PL_DBassertion = GvSV((gv_fetchpv("assertion", GV_ADDMULTI, SVt_PV)));
3319 sv_setiv(PL_DBassertion, 0);
3320 PL_curstash = ostash;
3323 #ifndef STRESS_REALLOC
3324 #define REASONABLE(size) (size)
3326 #define REASONABLE(size) (1) /* unreasonable */
3330 Perl_init_stacks(pTHX)
3332 /* start with 128-item stack and 8K cxstack */
3333 PL_curstackinfo = new_stackinfo(REASONABLE(128),
3334 REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
3335 PL_curstackinfo->si_type = PERLSI_MAIN;
3336 PL_curstack = PL_curstackinfo->si_stack;
3337 PL_mainstack = PL_curstack; /* remember in case we switch stacks */
3339 PL_stack_base = AvARRAY(PL_curstack);
3340 PL_stack_sp = PL_stack_base;
3341 PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
3343 New(50,PL_tmps_stack,REASONABLE(128),SV*);
3346 PL_tmps_max = REASONABLE(128);
3348 New(54,PL_markstack,REASONABLE(32),I32);
3349 PL_markstack_ptr = PL_markstack;
3350 PL_markstack_max = PL_markstack + REASONABLE(32);
3354 New(54,PL_scopestack,REASONABLE(32),I32);
3355 PL_scopestack_ix = 0;
3356 PL_scopestack_max = REASONABLE(32);
3358 New(54,PL_savestack,REASONABLE(128),ANY);
3359 PL_savestack_ix = 0;
3360 PL_savestack_max = REASONABLE(128);
3362 New(54,PL_retstack,REASONABLE(16),OP*);
3364 PL_retstack_max = REASONABLE(16);
3372 while (PL_curstackinfo->si_next)
3373 PL_curstackinfo = PL_curstackinfo->si_next;
3374 while (PL_curstackinfo) {
3375 PERL_SI *p = PL_curstackinfo->si_prev;
3376 /* curstackinfo->si_stack got nuked by sv_free_arenas() */
3377 Safefree(PL_curstackinfo->si_cxstack);
3378 Safefree(PL_curstackinfo);
3379 PL_curstackinfo = p;
3381 Safefree(PL_tmps_stack);
3382 Safefree(PL_markstack);
3383 Safefree(PL_scopestack);
3384 Safefree(PL_savestack);
3385 Safefree(PL_retstack);
3394 lex_start(PL_linestr);
3396 PL_subname = newSVpvn("main",4);
3400 S_init_predump_symbols(pTHX)
3405 sv_setpvn(get_sv("\"", TRUE), " ", 1);
3406 PL_stdingv = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
3407 GvMULTI_on(PL_stdingv);
3408 io = GvIOp(PL_stdingv);
3409 IoTYPE(io) = IoTYPE_RDONLY;
3410 IoIFP(io) = PerlIO_stdin();
3411 tmpgv = gv_fetchpv("stdin",TRUE, SVt_PV);
3413 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3415 tmpgv = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
3418 IoTYPE(io) = IoTYPE_WRONLY;
3419 IoOFP(io) = IoIFP(io) = PerlIO_stdout();
3421 tmpgv = gv_fetchpv("stdout",TRUE, SVt_PV);
3423 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3425 PL_stderrgv = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
3426 GvMULTI_on(PL_stderrgv);
3427 io = GvIOp(PL_stderrgv);
3428 IoTYPE(io) = IoTYPE_WRONLY;
3429 IoOFP(io) = IoIFP(io) = PerlIO_stderr();
3430 tmpgv = gv_fetchpv("stderr",TRUE, SVt_PV);
3432 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3434 PL_statname = NEWSV(66,0); /* last filename we did stat on */
3437 Safefree(PL_osname);
3438 PL_osname = savepv(OSNAME);
3442 Perl_init_argv_symbols(pTHX_ register int argc, register char **argv)
3445 argc--,argv++; /* skip name of script */
3446 if (PL_doswitches) {
3447 for (; argc > 0 && **argv == '-'; argc--,argv++) {
3450 if (argv[0][1] == '-' && !argv[0][2]) {
3454 if ((s = strchr(argv[0], '='))) {
3456 sv_setpv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),s);
3459 sv_setiv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),1);
3462 if ((PL_argvgv = gv_fetchpv("ARGV",TRUE, SVt_PVAV))) {
3463 GvMULTI_on(PL_argvgv);
3464 (void)gv_AVadd(PL_argvgv);
3465 av_clear(GvAVn(PL_argvgv));
3466 for (; argc > 0; argc--,argv++) {
3467 SV *sv = newSVpv(argv[0],0);
3468 av_push(GvAVn(PL_argvgv),sv);
3469 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
3470 if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
3473 if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
3474 (void)sv_utf8_decode(sv);
3479 #ifdef HAS_PROCSELFEXE
3480 /* This is a function so that we don't hold on to MAXPATHLEN
3481 bytes of stack longer than necessary
3484 S_procself_val(pTHX_ SV *sv, char *arg0)
3486 char buf[MAXPATHLEN];
3487 int len = readlink(PROCSELFEXE_PATH, buf, sizeof(buf) - 1);
3489 /* On Playstation2 Linux V1.0 (kernel 2.2.1) readlink(/proc/self/exe)
3490 includes a spurious NUL which will cause $^X to fail in system
3491 or backticks (this will prevent extensions from being built and
3492 many tests from working). readlink is not meant to add a NUL.
3493 Normal readlink works fine.
3495 if (len > 0 && buf[len-1] == '\0') {
3499 /* FreeBSD's implementation is acknowledged to be imperfect, sometimes
3500 returning the text "unknown" from the readlink rather than the path
3501 to the executable (or returning an error from the readlink). Any valid
3502 path has a '/' in it somewhere, so use that to validate the result.
3503 See http://www.freebsd.org/cgi/query-pr.cgi?pr=35703
3505 if (len > 0 && memchr(buf, '/', len)) {
3506 sv_setpvn(sv,buf,len);
3512 #endif /* HAS_PROCSELFEXE */
3515 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
3521 PL_toptarget = NEWSV(0,0);
3522 sv_upgrade(PL_toptarget, SVt_PVFM);
3523 sv_setpvn(PL_toptarget, "", 0);
3524 PL_bodytarget = NEWSV(0,0);
3525 sv_upgrade(PL_bodytarget, SVt_PVFM);
3526 sv_setpvn(PL_bodytarget, "", 0);
3527 PL_formtarget = PL_bodytarget;
3531 init_argv_symbols(argc,argv);
3533 if ((tmpgv = gv_fetchpv("0",TRUE, SVt_PV))) {
3534 #ifdef MACOS_TRADITIONAL
3535 /* $0 is not majick on a Mac */
3536 sv_setpv(GvSV(tmpgv),MacPerl_MPWFileName(PL_origfilename));
3538 sv_setpv(GvSV(tmpgv),PL_origfilename);
3539 magicname("0", "0", 1);
3542 if ((tmpgv = gv_fetchpv("\030",TRUE, SVt_PV))) {/* $^X */
3543 #ifdef HAS_PROCSELFEXE
3544 S_procself_val(aTHX_ GvSV(tmpgv), PL_origargv[0]);
3547 sv_setpv(GvSV(tmpgv), os2_execname(aTHX));
3549 sv_setpv(GvSV(tmpgv),PL_origargv[0]);
3553 if ((PL_envgv = gv_fetchpv("ENV",TRUE, SVt_PVHV))) {
3555 GvMULTI_on(PL_envgv);
3556 hv = GvHVn(PL_envgv);
3557 hv_magic(hv, Nullgv, PERL_MAGIC_env);
3558 #ifdef USE_ENVIRON_ARRAY
3559 /* Note that if the supplied env parameter is actually a copy
3560 of the global environ then it may now point to free'd memory
3561 if the environment has been modified since. To avoid this
3562 problem we treat env==NULL as meaning 'use the default'
3567 # ifdef USE_ITHREADS
3568 && PL_curinterp == aTHX
3572 environ[0] = Nullch;
3575 for (; *env; env++) {
3576 if (!(s = strchr(*env,'=')))
3583 sv = newSVpv(s+1, 0);
3584 (void)hv_store(hv, *env, s - *env, sv, 0);
3588 #endif /* USE_ENVIRON_ARRAY */
3591 if ((tmpgv = gv_fetchpv("$",TRUE, SVt_PV))) {
3592 SvREADONLY_off(GvSV(tmpgv));
3593 sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
3594 SvREADONLY_on(GvSV(tmpgv));
3596 #ifdef THREADS_HAVE_PIDS
3597 PL_ppid = (IV)getppid();
3600 /* touch @F array to prevent spurious warnings 20020415 MJD */
3602 (void) get_av("main::F", TRUE | GV_ADDMULTI);
3604 /* touch @- and @+ arrays to prevent spurious warnings 20020415 MJD */
3605 (void) get_av("main::-", TRUE | GV_ADDMULTI);
3606 (void) get_av("main::+", TRUE | GV_ADDMULTI);
3610 S_init_perllib(pTHX)
3615 s = PerlEnv_getenv("PERL5LIB");
3617 incpush(s, TRUE, TRUE, TRUE);
3619 incpush(PerlEnv_getenv("PERLLIB"), FALSE, FALSE, TRUE);
3621 /* Treat PERL5?LIB as a possible search list logical name -- the
3622 * "natural" VMS idiom for a Unix path string. We allow each
3623 * element to be a set of |-separated directories for compatibility.
3627 if (my_trnlnm("PERL5LIB",buf,0))
3628 do { incpush(buf,TRUE,TRUE,TRUE); } while (my_trnlnm("PERL5LIB",buf,++idx));
3630 while (my_trnlnm("PERLLIB",buf,idx++)) incpush(buf,FALSE,FALSE,TRUE);
3634 /* Use the ~-expanded versions of APPLLIB (undocumented),
3635 ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
3638 incpush(APPLLIB_EXP, TRUE, TRUE, TRUE);
3642 incpush(ARCHLIB_EXP, FALSE, FALSE, TRUE);
3644 #ifdef MACOS_TRADITIONAL
3647 SV * privdir = NEWSV(55, 0);
3648 char * macperl = PerlEnv_getenv("MACPERL");
3653 Perl_sv_setpvf(aTHX_ privdir, "%slib:", macperl);
3654 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3655 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3656 Perl_sv_setpvf(aTHX_ privdir, "%ssite_perl:", macperl);
3657 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3658 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3660 SvREFCNT_dec(privdir);
3663 incpush(":", FALSE, FALSE, TRUE);
3666 # define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
3669 incpush(PRIVLIB_EXP, TRUE, FALSE, TRUE);
3671 incpush(PRIVLIB_EXP, FALSE, FALSE, TRUE);
3675 /* sitearch is always relative to sitelib on Windows for
3676 * DLL-based path intuition to work correctly */
3677 # if !defined(WIN32)
3678 incpush(SITEARCH_EXP, FALSE, FALSE, TRUE);
3684 /* this picks up sitearch as well */
3685 incpush(SITELIB_EXP, TRUE, FALSE, TRUE);
3687 incpush(SITELIB_EXP, FALSE, FALSE, TRUE);
3691 #ifdef SITELIB_STEM /* Search for version-specific dirs below here */
3692 incpush(SITELIB_STEM, FALSE, TRUE, TRUE);
3695 #ifdef PERL_VENDORARCH_EXP
3696 /* vendorarch is always relative to vendorlib on Windows for
3697 * DLL-based path intuition to work correctly */
3698 # if !defined(WIN32)
3699 incpush(PERL_VENDORARCH_EXP, FALSE, FALSE, TRUE);
3703 #ifdef PERL_VENDORLIB_EXP
3705 incpush(PERL_VENDORLIB_EXP, TRUE, FALSE, TRUE); /* this picks up vendorarch as well */
3707 incpush(PERL_VENDORLIB_EXP, FALSE, FALSE, TRUE);
3711 #ifdef PERL_VENDORLIB_STEM /* Search for version-specific dirs below here */
3712 incpush(PERL_VENDORLIB_STEM, FALSE, TRUE, TRUE);
3715 #ifdef PERL_OTHERLIBDIRS
3716 incpush(PERL_OTHERLIBDIRS, TRUE, TRUE, TRUE);
3720 incpush(".", FALSE, FALSE, TRUE);
3721 #endif /* MACOS_TRADITIONAL */
3724 #if defined(DOSISH) || defined(EPOC)
3725 # define PERLLIB_SEP ';'
3728 # define PERLLIB_SEP '|'
3730 # if defined(MACOS_TRADITIONAL)
3731 # define PERLLIB_SEP ','
3733 # define PERLLIB_SEP ':'
3737 #ifndef PERLLIB_MANGLE
3738 # define PERLLIB_MANGLE(s,n) (s)
3742 S_incpush(pTHX_ char *p, int addsubdirs, int addoldvers, int usesep)
3744 SV *subdir = Nullsv;
3749 if (addsubdirs || addoldvers) {
3750 subdir = sv_newmortal();
3753 /* Break at all separators */
3755 SV *libdir = NEWSV(55,0);
3758 /* skip any consecutive separators */
3760 while ( *p == PERLLIB_SEP ) {
3761 /* Uncomment the next line for PATH semantics */
3762 /* av_push(GvAVn(PL_incgv), newSVpvn(".", 1)); */
3767 if ( usesep && (s = strchr(p, PERLLIB_SEP)) != Nullch ) {
3768 sv_setpvn(libdir, PERLLIB_MANGLE(p, (STRLEN)(s - p)),
3773 sv_setpv(libdir, PERLLIB_MANGLE(p, 0));
3774 p = Nullch; /* break out */
3776 #ifdef MACOS_TRADITIONAL
3777 if (!strchr(SvPVX(libdir), ':')) {
3780 sv_setpv(libdir, MacPerl_CanonDir(SvPVX(libdir), buf, 0));
3782 if (SvPVX(libdir)[SvCUR(libdir)-1] != ':')
3783 sv_catpv(libdir, ":");
3787 * BEFORE pushing libdir onto @INC we may first push version- and
3788 * archname-specific sub-directories.
3790 if (addsubdirs || addoldvers) {
3791 #ifdef PERL_INC_VERSION_LIST
3792 /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
3793 const char *incverlist[] = { PERL_INC_VERSION_LIST };
3794 const char **incver;
3801 if ((unix = tounixspec_ts(SvPV(libdir,len),Nullch)) != Nullch) {
3803 while (unix[len-1] == '/') len--; /* Cosmetic */
3804 sv_usepvn(libdir,unix,len);
3807 PerlIO_printf(Perl_error_log,
3808 "Failed to unixify @INC element \"%s\"\n",
3812 #ifdef MACOS_TRADITIONAL
3813 #define PERL_AV_SUFFIX_FMT ""
3814 #define PERL_ARCH_FMT "%s:"
3815 #define PERL_ARCH_FMT_PATH PERL_FS_VER_FMT PERL_AV_SUFFIX_FMT
3817 #define PERL_AV_SUFFIX_FMT "/"
3818 #define PERL_ARCH_FMT "/%s"
3819 #define PERL_ARCH_FMT_PATH PERL_AV_SUFFIX_FMT PERL_FS_VER_FMT
3821 /* .../version/archname if -d .../version/archname */
3822 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH PERL_ARCH_FMT,
3824 (int)PERL_REVISION, (int)PERL_VERSION,
3825 (int)PERL_SUBVERSION, ARCHNAME);
3826 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3827 S_ISDIR(tmpstatbuf.st_mode))
3828 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3830 /* .../version if -d .../version */
3831 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH, libdir,
3832 (int)PERL_REVISION, (int)PERL_VERSION,
3833 (int)PERL_SUBVERSION);
3834 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3835 S_ISDIR(tmpstatbuf.st_mode))
3836 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3838 /* .../archname if -d .../archname */
3839 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, ARCHNAME);
3840 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3841 S_ISDIR(tmpstatbuf.st_mode))
3842 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3845 #ifdef PERL_INC_VERSION_LIST
3847 for (incver = incverlist; *incver; incver++) {
3848 /* .../xxx if -d .../xxx */
3849 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, *incver);
3850 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3851 S_ISDIR(tmpstatbuf.st_mode))
3852 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3858 /* finally push this lib directory on the end of @INC */
3859 av_push(GvAVn(PL_incgv), libdir);
3863 #ifdef USE_5005THREADS
3864 STATIC struct perl_thread *
3865 S_init_main_thread(pTHX)
3867 #if !defined(PERL_IMPLICIT_CONTEXT)
3868 struct perl_thread *thr;
3872 Newz(53, thr, 1, struct perl_thread);
3873 PL_curcop = &PL_compiling;
3874 thr->interp = PERL_GET_INTERP;
3875 thr->cvcache = newHV();
3876 thr->threadsv = newAV();
3877 /* thr->threadsvp is set when find_threadsv is called */
3878 thr->specific = newAV();
3879 thr->flags = THRf_R_JOINABLE;
3880 MUTEX_INIT(&thr->mutex);
3881 /* Handcraft thrsv similarly to mess_sv */
3882 New(53, PL_thrsv, 1, SV);
3883 Newz(53, xpv, 1, XPV);
3884 SvFLAGS(PL_thrsv) = SVt_PV;
3885 SvANY(PL_thrsv) = (void*)xpv;
3886 SvREFCNT(PL_thrsv) = 1 << 30; /* practically infinite */
3887 SvPVX(PL_thrsv) = (char*)thr;
3888 SvCUR_set(PL_thrsv, sizeof(thr));
3889 SvLEN_set(PL_thrsv, sizeof(thr));
3890 *SvEND(PL_thrsv) = '\0'; /* in the trailing_nul field */
3891 thr->oursv = PL_thrsv;
3892 PL_chopset = " \n-";
3895 MUTEX_LOCK(&PL_threads_mutex);
3901 MUTEX_UNLOCK(&PL_threads_mutex);
3903 #ifdef HAVE_THREAD_INTERN
3904 Perl_init_thread_intern(thr);
3907 #ifdef SET_THREAD_SELF
3908 SET_THREAD_SELF(thr);
3910 thr->self = pthread_self();
3911 #endif /* SET_THREAD_SELF */
3915 * These must come after the thread self setting
3916 * because sv_setpvn does SvTAINT and the taint
3917 * fields thread selfness being set.
3919 PL_toptarget = NEWSV(0,0);
3920 sv_upgrade(PL_toptarget, SVt_PVFM);
3921 sv_setpvn(PL_toptarget, "", 0);
3922 PL_bodytarget = NEWSV(0,0);
3923 sv_upgrade(PL_bodytarget, SVt_PVFM);
3924 sv_setpvn(PL_bodytarget, "", 0);
3925 PL_formtarget = PL_bodytarget;
3926 thr->errsv = newSVpvn("", 0);
3927 (void) find_threadsv("@"); /* Ensure $@ is initialised early */
3930 PL_peepp = MEMBER_TO_FPTR(Perl_peep);
3931 PL_regcompp = MEMBER_TO_FPTR(Perl_pregcomp);
3932 PL_regexecp = MEMBER_TO_FPTR(Perl_regexec_flags);
3933 PL_regint_start = MEMBER_TO_FPTR(Perl_re_intuit_start);
3934 PL_regint_string = MEMBER_TO_FPTR(Perl_re_intuit_string);
3935 PL_regfree = MEMBER_TO_FPTR(Perl_pregfree);
3937 PL_reginterp_cnt = 0;
3941 #endif /* USE_5005THREADS */
3944 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
3947 line_t oldline = CopLINE(PL_curcop);
3953 while (AvFILL(paramList) >= 0) {
3954 cv = (CV*)av_shift(paramList);
3956 if (paramList == PL_beginav) {
3957 /* save PL_beginav for compiler */
3958 if (! PL_beginav_save)
3959 PL_beginav_save = newAV();
3960 av_push(PL_beginav_save, (SV*)cv);
3962 else if (paramList == PL_checkav) {
3963 /* save PL_checkav for compiler */
3964 if (! PL_checkav_save)
3965 PL_checkav_save = newAV();
3966 av_push(PL_checkav_save, (SV*)cv);
3971 #ifdef PERL_FLEXIBLE_EXCEPTIONS
3972 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_list_body), cv);
3978 #ifndef PERL_FLEXIBLE_EXCEPTIONS
3982 (void)SvPV(atsv, len);
3984 PL_curcop = &PL_compiling;
3985 CopLINE_set(PL_curcop, oldline);
3986 if (paramList == PL_beginav)
3987 sv_catpv(atsv, "BEGIN failed--compilation aborted");
3989 Perl_sv_catpvf(aTHX_ atsv,
3990 "%s failed--call queue aborted",
3991 paramList == PL_checkav ? "CHECK"
3992 : paramList == PL_initav ? "INIT"
3994 while (PL_scopestack_ix > oldscope)
3997 Perl_croak(aTHX_ "%"SVf"", atsv);
4004 /* my_exit() was called */
4005 while (PL_scopestack_ix > oldscope)
4008 PL_curstash = PL_defstash;
4009 PL_curcop = &PL_compiling;
4010 CopLINE_set(PL_curcop, oldline);
4012 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
4013 if (paramList == PL_beginav)
4014 Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
4016 Perl_croak(aTHX_ "%s failed--call queue aborted",
4017 paramList == PL_checkav ? "CHECK"
4018 : paramList == PL_initav ? "INIT"
4025 PL_curcop = &PL_compiling;
4026 CopLINE_set(PL_curcop, oldline);
4029 PerlIO_printf(Perl_error_log, "panic: restartop\n");
4037 #ifdef PERL_FLEXIBLE_EXCEPTIONS
4039 S_vcall_list_body(pTHX_ va_list args)
4041 CV *cv = va_arg(args, CV*);
4042 return call_list_body(cv);
4047 S_call_list_body(pTHX_ CV *cv)
4049 PUSHMARK(PL_stack_sp);
4050 call_sv((SV*)cv, G_EVAL|G_DISCARD);
4055 Perl_my_exit(pTHX_ U32 status)
4057 DEBUG_S(PerlIO_printf(Perl_debug_log, "my_exit: thread %p, status %lu\n",
4058 thr, (unsigned long) status));
4067 STATUS_NATIVE_SET(status);
4074 Perl_my_failure_exit(pTHX)
4077 if (vaxc$errno & 1) {
4078 if (STATUS_NATIVE & 1) /* fortuitiously includes "-1" */
4079 STATUS_NATIVE_SET(44);
4082 if (!vaxc$errno && errno) /* unlikely */
4083 STATUS_NATIVE_SET(44);
4085 STATUS_NATIVE_SET(vaxc$errno);
4090 STATUS_POSIX_SET(errno);
4092 exitstatus = STATUS_POSIX >> 8;
4093 if (exitstatus & 255)
4094 STATUS_POSIX_SET(exitstatus);
4096 STATUS_POSIX_SET(255);
4103 S_my_exit_jump(pTHX)
4105 register PERL_CONTEXT *cx;
4110 SvREFCNT_dec(PL_e_script);
4111 PL_e_script = Nullsv;
4114 POPSTACK_TO(PL_mainstack);
4115 if (cxstack_ix >= 0) {
4118 POPBLOCK(cx,PL_curpm);
4126 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen)
4129 p = SvPVX(PL_e_script);
4130 nl = strchr(p, '\n');
4131 nl = (nl) ? nl+1 : SvEND(PL_e_script);
4133 filter_del(read_e_script);
4136 sv_catpvn(buf_sv, p, nl-p);
4137 sv_chop(PL_e_script, nl);