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 rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
2177 SvREFCNT_dec(PL_rs);
2178 if (rschar & ~((U8)~0))
2179 PL_rs = &PL_sv_undef;
2180 else if (!rschar && numlen >= 2)
2181 PL_rs = newSVpvn("", 0);
2183 char ch = (char)rschar;
2184 PL_rs = newSVpvn(&ch, 1);
2190 PL_unicode = parse_unicode_opts(&s);
2195 while (*s && !isSPACE(*s)) ++s;
2197 PL_splitstr = savepv(PL_splitstr);
2210 /* The following permits -d:Mod to accepts arguments following an =
2211 in the fashion that -MSome::Mod does. */
2212 if (*s == ':' || *s == '=') {
2215 sv = newSVpv("use Devel::", 0);
2217 /* We now allow -d:Module=Foo,Bar */
2218 while(isALNUM(*s) || *s==':') ++s;
2220 sv_catpv(sv, start);
2222 sv_catpvn(sv, start, s-start);
2223 sv_catpv(sv, " split(/,/,q{");
2228 my_setenv("PERL5DB", SvPV(sv, PL_na));
2231 PL_perldb = PERLDB_ALL;
2239 if (isALPHA(s[1])) {
2240 /* if adding extra options, remember to update DEBUG_MASK */
2241 static char debopts[] = "psltocPmfrxu HXDSTRJvC";
2244 for (s++; *s && (d = strchr(debopts,*s)); s++)
2245 PL_debug |= 1 << (d - debopts);
2248 PL_debug = atoi(s+1);
2249 for (s++; isDIGIT(*s); s++) ;
2252 if (DEBUG_p_TEST_ && ckWARN_d(WARN_DEBUGGING))
2253 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2254 "-Dp not implemented on this platform\n");
2256 PL_debug |= DEBUG_TOP_FLAG;
2257 #else /* !DEBUGGING */
2258 if (ckWARN_d(WARN_DEBUGGING))
2259 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2260 "Recompile perl with -DDEBUGGING to use -D switch\n");
2261 for (s++; isALNUM(*s); s++) ;
2267 usage(PL_origargv[0]);
2271 Safefree(PL_inplace);
2272 #if defined(__CYGWIN__) /* do backup extension automagically */
2273 if (*(s+1) == '\0') {
2274 PL_inplace = savepv(".bak");
2277 #endif /* __CYGWIN__ */
2278 PL_inplace = savepv(s+1);
2280 for (s = PL_inplace; *s && !isSPACE(*s); s++) ;
2283 if (*s == '-') /* Additional switches on #! line. */
2287 case 'I': /* -I handled both here and in parse_body() */
2290 while (*s && isSPACE(*s))
2295 /* ignore trailing spaces (possibly followed by other switches) */
2297 for (e = p; *e && !isSPACE(*e); e++) ;
2301 } while (*p && *p != '-');
2302 e = savepvn(s, e-s);
2303 incpush(e, TRUE, TRUE, FALSE);
2310 Perl_croak(aTHX_ "No directory specified for -I");
2316 SvREFCNT_dec(PL_ors_sv);
2321 PL_ors_sv = newSVpvn("\n",1);
2322 numlen = 3 + (*s == '0');
2323 *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
2327 if (RsPARA(PL_rs)) {
2328 PL_ors_sv = newSVpvn("\n\n",2);
2331 PL_ors_sv = newSVsv(PL_rs);
2338 PL_preambleav = newAV();
2340 SV *sv = newSVpvn("use assertions::activate split(/,/,q{",37);
2344 av_push(PL_preambleav, sv);
2347 av_push(PL_preambleav, newSVpvn("use assertions::activate",24));
2350 forbid_setid("-M"); /* XXX ? */
2353 forbid_setid("-m"); /* XXX ? */
2358 /* -M-foo == 'no foo' */
2359 if (*s == '-') { use = "no "; ++s; }
2360 sv = newSVpv(use,0);
2362 /* We allow -M'Module qw(Foo Bar)' */
2363 while(isALNUM(*s) || *s==':') ++s;
2365 sv_catpv(sv, start);
2366 if (*(start-1) == 'm') {
2368 Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
2369 sv_catpv( sv, " ()");
2373 Perl_croak(aTHX_ "Module name required with -%c option",
2375 sv_catpvn(sv, start, s-start);
2376 sv_catpv(sv, " split(/,/,q{");
2382 PL_preambleav = newAV();
2383 av_push(PL_preambleav, sv);
2386 Perl_croak(aTHX_ "No space allowed after -%c", *(s-1));
2398 PL_doswitches = TRUE;
2403 Perl_croak(aTHX_ "Too late for \"-t\" option");
2408 Perl_croak(aTHX_ "Too late for \"-T\" option");
2412 #ifdef MACOS_TRADITIONAL
2413 Perl_croak(aTHX_ "Believe me, you don't want to use \"-u\" on a Macintosh");
2415 PL_do_undump = TRUE;
2424 PerlIO_printf(PerlIO_stdout(),
2425 Perl_form(aTHX_ "\nThis is perl, v%"VDf" built for %s",
2426 PL_patchlevel, ARCHNAME));
2428 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
2429 PerlIO_printf(PerlIO_stdout(),
2430 Perl_form(aTHX_ "\nThis is perl, version %vd\n", PL_patchlevel));
2431 PerlIO_printf(PerlIO_stdout(),
2432 Perl_form(aTHX_ " built under %s at %s %s\n",
2433 OSNAME, __DATE__, __TIME__));
2434 PerlIO_printf(PerlIO_stdout(),
2435 Perl_form(aTHX_ " OS Specific Release: %s\n",
2439 #if defined(LOCAL_PATCH_COUNT)
2440 if (LOCAL_PATCH_COUNT > 0)
2441 PerlIO_printf(PerlIO_stdout(),
2442 "\n(with %d registered patch%s, "
2443 "see perl -V for more detail)",
2444 (int)LOCAL_PATCH_COUNT,
2445 (LOCAL_PATCH_COUNT!=1) ? "es" : "");
2448 PerlIO_printf(PerlIO_stdout(),
2449 "\n\nCopyright 1987-2003, Larry Wall\n");
2450 #ifdef MACOS_TRADITIONAL
2451 PerlIO_printf(PerlIO_stdout(),
2452 "\nMac OS port Copyright 1991-2002, Matthias Neeracher;\n"
2453 "maintained by Chris Nandor\n");
2456 PerlIO_printf(PerlIO_stdout(),
2457 "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
2460 PerlIO_printf(PerlIO_stdout(),
2461 "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
2462 "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
2465 PerlIO_printf(PerlIO_stdout(),
2466 "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
2467 "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
2470 PerlIO_printf(PerlIO_stdout(),
2471 "atariST series port, ++jrb bammi@cadence.com\n");
2474 PerlIO_printf(PerlIO_stdout(),
2475 "BeOS port Copyright Tom Spindler, 1997-1999\n");
2478 PerlIO_printf(PerlIO_stdout(),
2479 "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2002\n");
2482 PerlIO_printf(PerlIO_stdout(),
2483 "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
2486 PerlIO_printf(PerlIO_stdout(),
2487 "Stratus VOS port by Paul.Green@stratus.com, 1997-2002\n");
2490 PerlIO_printf(PerlIO_stdout(),
2491 "VM/ESA port by Neale Ferguson, 1998-1999\n");
2494 PerlIO_printf(PerlIO_stdout(),
2495 "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
2498 PerlIO_printf(PerlIO_stdout(),
2499 "MiNT port by Guido Flohr, 1997-1999\n");
2502 PerlIO_printf(PerlIO_stdout(),
2503 "EPOC port by Olaf Flebbe, 1999-2002\n");
2506 PerlIO_printf(PerlIO_stdout(),"WINCE port by Rainer Keuchel, 2001-2002\n");
2507 PerlIO_printf(PerlIO_stdout(),"Built on " __DATE__ " " __TIME__ "\n\n");
2510 #ifdef BINARY_BUILD_NOTICE
2511 BINARY_BUILD_NOTICE;
2513 PerlIO_printf(PerlIO_stdout(),
2515 Perl may be copied only under the terms of either the Artistic License or the\n\
2516 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
2517 Complete documentation for Perl, including FAQ lists, should be found on\n\
2518 this system using `man perl' or `perldoc perl'. If you have access to the\n\
2519 Internet, point your browser at http://www.perl.com/, the Perl Home Page.\n\n");
2522 if (! (PL_dowarn & G_WARN_ALL_MASK))
2523 PL_dowarn |= G_WARN_ON;
2527 PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
2528 if (!specialWARN(PL_compiling.cop_warnings))
2529 SvREFCNT_dec(PL_compiling.cop_warnings);
2530 PL_compiling.cop_warnings = pWARN_ALL ;
2534 PL_dowarn = G_WARN_ALL_OFF;
2535 if (!specialWARN(PL_compiling.cop_warnings))
2536 SvREFCNT_dec(PL_compiling.cop_warnings);
2537 PL_compiling.cop_warnings = pWARN_NONE ;
2542 if (s[1] == '-') /* Additional switches on #! line. */
2547 #if defined(WIN32) || !defined(PERL_STRICT_CR)
2553 #ifdef ALTERNATE_SHEBANG
2554 case 'S': /* OS/2 needs -S on "extproc" line. */
2562 Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
2567 /* compliments of Tom Christiansen */
2569 /* unexec() can be found in the Gnu emacs distribution */
2570 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
2573 Perl_my_unexec(pTHX)
2581 prog = newSVpv(BIN_EXP, 0);
2582 sv_catpv(prog, "/perl");
2583 file = newSVpv(PL_origfilename, 0);
2584 sv_catpv(file, ".perldump");
2586 unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
2587 /* unexec prints msg to stderr in case of failure */
2588 PerlProc_exit(status);
2591 # include <lib$routines.h>
2592 lib$signal(SS$_DEBUG); /* ssdef.h #included from vmsish.h */
2594 ABORT(); /* for use with undump */
2599 /* initialize curinterp */
2605 # define PERLVAR(var,type)
2606 # define PERLVARA(var,n,type)
2607 # if defined(PERL_IMPLICIT_CONTEXT)
2608 # if defined(USE_5005THREADS)
2609 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2610 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2611 # else /* !USE_5005THREADS */
2612 # define PERLVARI(var,type,init) aTHX->var = init;
2613 # define PERLVARIC(var,type,init) aTHX->var = init;
2614 # endif /* USE_5005THREADS */
2616 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2617 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2619 # include "intrpvar.h"
2620 # ifndef USE_5005THREADS
2621 # include "thrdvar.h"
2628 # define PERLVAR(var,type)
2629 # define PERLVARA(var,n,type)
2630 # define PERLVARI(var,type,init) PL_##var = init;
2631 # define PERLVARIC(var,type,init) PL_##var = init;
2632 # include "intrpvar.h"
2633 # ifndef USE_5005THREADS
2634 # include "thrdvar.h"
2645 S_init_main_stash(pTHX)
2649 PL_curstash = PL_defstash = newHV();
2650 PL_curstname = newSVpvn("main",4);
2651 gv = gv_fetchpv("main::",TRUE, SVt_PVHV);
2652 SvREFCNT_dec(GvHV(gv));
2653 GvHV(gv) = (HV*)SvREFCNT_inc(PL_defstash);
2655 HvNAME(PL_defstash) = savepv("main");
2656 PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpv("INC",TRUE, SVt_PVAV)));
2657 GvMULTI_on(PL_incgv);
2658 PL_hintgv = gv_fetchpv("\010",TRUE, SVt_PV); /* ^H */
2659 GvMULTI_on(PL_hintgv);
2660 PL_defgv = gv_fetchpv("_",TRUE, SVt_PVAV);
2661 PL_errgv = gv_HVadd(gv_fetchpv("@", TRUE, SVt_PV));
2662 GvMULTI_on(PL_errgv);
2663 PL_replgv = gv_fetchpv("\022", TRUE, SVt_PV); /* ^R */
2664 GvMULTI_on(PL_replgv);
2665 (void)Perl_form(aTHX_ "%240s",""); /* Preallocate temp - for immediate signals. */
2666 sv_grow(ERRSV, 240); /* Preallocate - for immediate signals. */
2667 sv_setpvn(ERRSV, "", 0);
2668 PL_curstash = PL_defstash;
2669 CopSTASH_set(&PL_compiling, PL_defstash);
2670 PL_debstash = GvHV(gv_fetchpv("DB::", GV_ADDMULTI, SVt_PVHV));
2671 PL_globalstash = GvHV(gv_fetchpv("CORE::GLOBAL::", GV_ADDMULTI, SVt_PVHV));
2672 /* We must init $/ before switches are processed. */
2673 sv_setpvn(get_sv("/", TRUE), "\n", 1);
2677 S_open_script(pTHX_ char *scriptname, bool dosearch, SV *sv, int *fdscript)
2681 char *cpp_discard_flag;
2687 PL_origfilename = savepv("-e");
2690 /* if find_script() returns, it returns a malloc()-ed value */
2691 PL_origfilename = scriptname = find_script(scriptname, dosearch, NULL, 1);
2693 if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
2694 char *s = scriptname + 8;
2695 *fdscript = atoi(s);
2699 scriptname = savepv(s + 1);
2700 Safefree(PL_origfilename);
2701 PL_origfilename = scriptname;
2706 CopFILE_free(PL_curcop);
2707 CopFILE_set(PL_curcop, PL_origfilename);
2708 if (strEQ(PL_origfilename,"-"))
2710 if (*fdscript >= 0) {
2711 PL_rsfp = PerlIO_fdopen(*fdscript,PERL_SCRIPT_MODE);
2712 # if defined(HAS_FCNTL) && defined(F_SETFD)
2714 /* ensure close-on-exec */
2715 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2718 else if (PL_preprocess) {
2719 char *cpp_cfg = CPPSTDIN;
2720 SV *cpp = newSVpvn("",0);
2721 SV *cmd = NEWSV(0,0);
2723 if (strEQ(cpp_cfg, "cppstdin"))
2724 Perl_sv_catpvf(aTHX_ cpp, "%s/", BIN_EXP);
2725 sv_catpv(cpp, cpp_cfg);
2728 sv_catpvn(sv, "-I", 2);
2729 sv_catpv(sv,PRIVLIB_EXP);
2732 DEBUG_P(PerlIO_printf(Perl_debug_log,
2733 "PL_preprocess: scriptname=\"%s\", cpp=\"%s\", sv=\"%s\", CPPMINUS=\"%s\"\n",
2734 scriptname, SvPVX (cpp), SvPVX (sv), CPPMINUS));
2736 # if defined(MSDOS) || defined(WIN32) || defined(VMS)
2743 cpp_discard_flag = "";
2745 cpp_discard_flag = "-C";
2749 perl = os2_execname(aTHX);
2751 perl = PL_origargv[0];
2755 /* This strips off Perl comments which might interfere with
2756 the C pre-processor, including #!. #line directives are
2757 deliberately stripped to avoid confusion with Perl's version
2758 of #line. FWP played some golf with it so it will fit
2759 into VMS's 255 character buffer.
2762 code = "(1../^#!.*perl/i)|/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2764 code = "/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2766 Perl_sv_setpvf(aTHX_ cmd, "\
2767 %s -ne%s%s%s %s | %"SVf" %s %"SVf" %s",
2768 perl, quote, code, quote, scriptname, cpp,
2769 cpp_discard_flag, sv, CPPMINUS);
2771 PL_doextract = FALSE;
2772 # ifdef IAMSUID /* actually, this is caught earlier */
2773 if (PL_euid != PL_uid && !PL_euid) { /* if running suidperl */
2775 (void)seteuid(PL_uid); /* musn't stay setuid root */
2777 # ifdef HAS_SETREUID
2778 (void)setreuid((Uid_t)-1, PL_uid);
2780 # ifdef HAS_SETRESUID
2781 (void)setresuid((Uid_t)-1, PL_uid, (Uid_t)-1);
2783 PerlProc_setuid(PL_uid);
2787 if (PerlProc_geteuid() != PL_uid)
2788 Perl_croak(aTHX_ "Can't do seteuid!\n");
2790 # endif /* IAMSUID */
2792 DEBUG_P(PerlIO_printf(Perl_debug_log,
2793 "PL_preprocess: cmd=\"%s\"\n",
2796 PL_rsfp = PerlProc_popen(SvPVX(cmd), "r");
2800 else if (!*scriptname) {
2801 forbid_setid("program input from stdin");
2802 PL_rsfp = PerlIO_stdin();
2805 PL_rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
2806 # if defined(HAS_FCNTL) && defined(F_SETFD)
2808 /* ensure close-on-exec */
2809 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2814 # ifndef IAMSUID /* in case script is not readable before setuid */
2816 PerlLIO_stat(CopFILE(PL_curcop),&PL_statbuf) >= 0 &&
2817 PL_statbuf.st_mode & (S_ISUID|S_ISGID))
2820 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT,
2821 BIN_EXP, (int)PERL_REVISION,
2823 (int)PERL_SUBVERSION), PL_origargv);
2824 Perl_croak(aTHX_ "Can't do setuid\n");
2830 Perl_croak(aTHX_ "Can't open perl script: %s\n",
2833 Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
2834 CopFILE(PL_curcop), Strerror(errno));
2840 * I_SYSSTATVFS HAS_FSTATVFS
2842 * I_STATFS HAS_FSTATFS HAS_GETFSSTAT
2843 * I_MNTENT HAS_GETMNTENT HAS_HASMNTOPT
2844 * here so that metaconfig picks them up. */
2848 S_fd_on_nosuid_fs(pTHX_ int fd)
2850 int check_okay = 0; /* able to do all the required sys/libcalls */
2851 int on_nosuid = 0; /* the fd is on a nosuid fs */
2853 * Preferred order: fstatvfs(), fstatfs(), ustat()+getmnt(), getmntent().
2854 * fstatvfs() is UNIX98.
2855 * fstatfs() is 4.3 BSD.
2856 * ustat()+getmnt() is pre-4.3 BSD.
2857 * getmntent() is O(number-of-mounted-filesystems) and can hang on
2858 * an irrelevant filesystem while trying to reach the right one.
2861 #undef FD_ON_NOSUID_CHECK_OKAY /* found the syscalls to do the check? */
2863 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2864 defined(HAS_FSTATVFS)
2865 # define FD_ON_NOSUID_CHECK_OKAY
2866 struct statvfs stfs;
2868 check_okay = fstatvfs(fd, &stfs) == 0;
2869 on_nosuid = check_okay && (stfs.f_flag & ST_NOSUID);
2870 # endif /* fstatvfs */
2872 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2873 defined(PERL_MOUNT_NOSUID) && \
2874 defined(HAS_FSTATFS) && \
2875 defined(HAS_STRUCT_STATFS) && \
2876 defined(HAS_STRUCT_STATFS_F_FLAGS)
2877 # define FD_ON_NOSUID_CHECK_OKAY
2880 check_okay = fstatfs(fd, &stfs) == 0;
2881 on_nosuid = check_okay && (stfs.f_flags & PERL_MOUNT_NOSUID);
2882 # endif /* fstatfs */
2884 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2885 defined(PERL_MOUNT_NOSUID) && \
2886 defined(HAS_FSTAT) && \
2887 defined(HAS_USTAT) && \
2888 defined(HAS_GETMNT) && \
2889 defined(HAS_STRUCT_FS_DATA) && \
2891 # define FD_ON_NOSUID_CHECK_OKAY
2894 if (fstat(fd, &fdst) == 0) {
2896 if (ustat(fdst.st_dev, &us) == 0) {
2898 /* NOSTAT_ONE here because we're not examining fields which
2899 * vary between that case and STAT_ONE. */
2900 if (getmnt((int*)0, &fsd, (int)0, NOSTAT_ONE, us.f_fname) == 0) {
2901 size_t cmplen = sizeof(us.f_fname);
2902 if (sizeof(fsd.fd_req.path) < cmplen)
2903 cmplen = sizeof(fsd.fd_req.path);
2904 if (strnEQ(fsd.fd_req.path, us.f_fname, cmplen) &&
2905 fdst.st_dev == fsd.fd_req.dev) {
2907 on_nosuid = fsd.fd_req.flags & PERL_MOUNT_NOSUID;
2913 # endif /* fstat+ustat+getmnt */
2915 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2916 defined(HAS_GETMNTENT) && \
2917 defined(HAS_HASMNTOPT) && \
2918 defined(MNTOPT_NOSUID)
2919 # define FD_ON_NOSUID_CHECK_OKAY
2920 FILE *mtab = fopen("/etc/mtab", "r");
2921 struct mntent *entry;
2924 if (mtab && (fstat(fd, &stb) == 0)) {
2925 while (entry = getmntent(mtab)) {
2926 if (stat(entry->mnt_dir, &fsb) == 0
2927 && fsb.st_dev == stb.st_dev)
2929 /* found the filesystem */
2931 if (hasmntopt(entry, MNTOPT_NOSUID))
2934 } /* A single fs may well fail its stat(). */
2939 # endif /* getmntent+hasmntopt */
2942 Perl_croak(aTHX_ "Can't check filesystem of script \"%s\" for nosuid", PL_origfilename);
2945 #endif /* IAMSUID */
2948 S_validate_suid(pTHX_ char *validarg, char *scriptname, int fdscript)
2954 /* do we need to emulate setuid on scripts? */
2956 /* This code is for those BSD systems that have setuid #! scripts disabled
2957 * in the kernel because of a security problem. Merely defining DOSUID
2958 * in perl will not fix that problem, but if you have disabled setuid
2959 * scripts in the kernel, this will attempt to emulate setuid and setgid
2960 * on scripts that have those now-otherwise-useless bits set. The setuid
2961 * root version must be called suidperl or sperlN.NNN. If regular perl
2962 * discovers that it has opened a setuid script, it calls suidperl with
2963 * the same argv that it had. If suidperl finds that the script it has
2964 * just opened is NOT setuid root, it sets the effective uid back to the
2965 * uid. We don't just make perl setuid root because that loses the
2966 * effective uid we had before invoking perl, if it was different from the
2969 * DOSUID must be defined in both perl and suidperl, and IAMSUID must
2970 * be defined in suidperl only. suidperl must be setuid root. The
2971 * Configure script will set this up for you if you want it.
2977 if (PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf) < 0) /* normal stat is insecure */
2978 Perl_croak(aTHX_ "Can't stat script \"%s\"",PL_origfilename);
2979 if (fdscript < 0 && PL_statbuf.st_mode & (S_ISUID|S_ISGID)) {
2984 #ifndef HAS_SETREUID
2985 /* On this access check to make sure the directories are readable,
2986 * there is actually a small window that the user could use to make
2987 * filename point to an accessible directory. So there is a faint
2988 * chance that someone could execute a setuid script down in a
2989 * non-accessible directory. I don't know what to do about that.
2990 * But I don't think it's too important. The manual lies when
2991 * it says access() is useful in setuid programs.
2993 if (PerlLIO_access(CopFILE(PL_curcop),1)) /*double check*/
2994 Perl_croak(aTHX_ "Permission denied");
2996 /* If we can swap euid and uid, then we can determine access rights
2997 * with a simple stat of the file, and then compare device and
2998 * inode to make sure we did stat() on the same file we opened.
2999 * Then we just have to make sure he or she can execute it.
3006 setreuid(PL_euid,PL_uid) < 0
3009 setresuid(PL_euid,PL_uid,(Uid_t)-1) < 0
3012 || PerlProc_getuid() != PL_euid || PerlProc_geteuid() != PL_uid)
3013 Perl_croak(aTHX_ "Can't swap uid and euid"); /* really paranoid */
3014 if (PerlLIO_stat(CopFILE(PL_curcop),&tmpstatbuf) < 0)
3015 Perl_croak(aTHX_ "Permission denied"); /* testing full pathname here */
3016 #if defined(IAMSUID) && !defined(NO_NOSUID_CHECK)
3017 if (fd_on_nosuid_fs(PerlIO_fileno(PL_rsfp)))
3018 Perl_croak(aTHX_ "Permission denied");
3020 if (tmpstatbuf.st_dev != PL_statbuf.st_dev ||
3021 tmpstatbuf.st_ino != PL_statbuf.st_ino) {
3022 (void)PerlIO_close(PL_rsfp);
3023 Perl_croak(aTHX_ "Permission denied\n");
3027 setreuid(PL_uid,PL_euid) < 0
3029 # if defined(HAS_SETRESUID)
3030 setresuid(PL_uid,PL_euid,(Uid_t)-1) < 0
3033 || PerlProc_getuid() != PL_uid || PerlProc_geteuid() != PL_euid)
3034 Perl_croak(aTHX_ "Can't reswap uid and euid");
3035 if (!cando(S_IXUSR,FALSE,&PL_statbuf)) /* can real uid exec? */
3036 Perl_croak(aTHX_ "Permission denied\n");
3038 #endif /* HAS_SETREUID */
3039 #endif /* IAMSUID */
3041 if (!S_ISREG(PL_statbuf.st_mode))
3042 Perl_croak(aTHX_ "Permission denied");
3043 if (PL_statbuf.st_mode & S_IWOTH)
3044 Perl_croak(aTHX_ "Setuid/gid script is writable by world");
3045 PL_doswitches = FALSE; /* -s is insecure in suid */
3046 CopLINE_inc(PL_curcop);
3047 if (sv_gets(PL_linestr, PL_rsfp, 0) == Nullch ||
3048 strnNE(SvPV(PL_linestr,n_a),"#!",2) ) /* required even on Sys V */
3049 Perl_croak(aTHX_ "No #! line");
3050 s = SvPV(PL_linestr,n_a)+2;
3052 while (!isSPACE(*s)) s++;
3053 for (s2 = s; (s2 > SvPV(PL_linestr,n_a)+2 &&
3054 (isDIGIT(s2[-1]) || strchr("._-", s2[-1]))); s2--) ;
3055 if (strnNE(s2-4,"perl",4) && strnNE(s-9,"perl",4)) /* sanity check */
3056 Perl_croak(aTHX_ "Not a perl script");
3057 while (*s == ' ' || *s == '\t') s++;
3059 * #! arg must be what we saw above. They can invoke it by
3060 * mentioning suidperl explicitly, but they may not add any strange
3061 * arguments beyond what #! says if they do invoke suidperl that way.
3063 len = strlen(validarg);
3064 if (strEQ(validarg," PHOOEY ") ||
3065 strnNE(s,validarg,len) || !isSPACE(s[len]))
3066 Perl_croak(aTHX_ "Args must match #! line");
3069 if (PL_euid != PL_uid && (PL_statbuf.st_mode & S_ISUID) &&
3070 PL_euid == PL_statbuf.st_uid)
3072 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3073 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3074 #endif /* IAMSUID */
3076 if (PL_euid) { /* oops, we're not the setuid root perl */
3077 (void)PerlIO_close(PL_rsfp);
3080 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
3081 (int)PERL_REVISION, (int)PERL_VERSION,
3082 (int)PERL_SUBVERSION), PL_origargv);
3084 Perl_croak(aTHX_ "Can't do setuid\n");
3087 if (PL_statbuf.st_mode & S_ISGID && PL_statbuf.st_gid != PL_egid) {
3089 (void)setegid(PL_statbuf.st_gid);
3092 (void)setregid((Gid_t)-1,PL_statbuf.st_gid);
3094 #ifdef HAS_SETRESGID
3095 (void)setresgid((Gid_t)-1,PL_statbuf.st_gid,(Gid_t)-1);
3097 PerlProc_setgid(PL_statbuf.st_gid);
3101 if (PerlProc_getegid() != PL_statbuf.st_gid)
3102 Perl_croak(aTHX_ "Can't do setegid!\n");
3104 if (PL_statbuf.st_mode & S_ISUID) {
3105 if (PL_statbuf.st_uid != PL_euid)
3107 (void)seteuid(PL_statbuf.st_uid); /* all that for this */
3110 (void)setreuid((Uid_t)-1,PL_statbuf.st_uid);
3112 #ifdef HAS_SETRESUID
3113 (void)setresuid((Uid_t)-1,PL_statbuf.st_uid,(Uid_t)-1);
3115 PerlProc_setuid(PL_statbuf.st_uid);
3119 if (PerlProc_geteuid() != PL_statbuf.st_uid)
3120 Perl_croak(aTHX_ "Can't do seteuid!\n");
3122 else if (PL_uid) { /* oops, mustn't run as root */
3124 (void)seteuid((Uid_t)PL_uid);
3127 (void)setreuid((Uid_t)-1,(Uid_t)PL_uid);
3129 #ifdef HAS_SETRESUID
3130 (void)setresuid((Uid_t)-1,(Uid_t)PL_uid,(Uid_t)-1);
3132 PerlProc_setuid((Uid_t)PL_uid);
3136 if (PerlProc_geteuid() != PL_uid)
3137 Perl_croak(aTHX_ "Can't do seteuid!\n");
3140 if (!cando(S_IXUSR,TRUE,&PL_statbuf))
3141 Perl_croak(aTHX_ "Permission denied\n"); /* they can't do this */
3144 else if (PL_preprocess)
3145 Perl_croak(aTHX_ "-P not allowed for setuid/setgid script\n");
3146 else if (fdscript >= 0)
3147 Perl_croak(aTHX_ "fd script not allowed in suidperl\n");
3149 Perl_croak(aTHX_ "Script is not setuid/setgid in suidperl\n");
3151 /* We absolutely must clear out any saved ids here, so we */
3152 /* exec the real perl, substituting fd script for scriptname. */
3153 /* (We pass script name as "subdir" of fd, which perl will grok.) */
3154 PerlIO_rewind(PL_rsfp);
3155 PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0); /* just in case rewind didn't */
3156 for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;
3157 if (!PL_origargv[which])
3158 Perl_croak(aTHX_ "Permission denied");
3159 PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",
3160 PerlIO_fileno(PL_rsfp), PL_origargv[which]));
3161 #if defined(HAS_FCNTL) && defined(F_SETFD)
3162 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0); /* ensure no close-on-exec */
3164 PerlProc_execv(Perl_form(aTHX_ "%s/perl"PERL_FS_VER_FMT, BIN_EXP,
3165 (int)PERL_REVISION, (int)PERL_VERSION,
3166 (int)PERL_SUBVERSION), PL_origargv);/* try again */
3167 Perl_croak(aTHX_ "Can't do setuid\n");
3168 #endif /* IAMSUID */
3170 if (PL_euid != PL_uid || PL_egid != PL_gid) { /* (suidperl doesn't exist, in fact) */
3171 #ifndef SETUID_SCRIPTS_ARE_SECURE_NOW
3172 PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf); /* may be either wrapped or real suid */
3173 if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3175 (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3178 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3179 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3180 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3181 /* not set-id, must be wrapped */
3187 S_find_beginning(pTHX)
3189 register char *s, *s2;
3190 #ifdef MACOS_TRADITIONAL
3194 /* skip forward in input to the real script? */
3197 #ifdef MACOS_TRADITIONAL
3198 /* Since the Mac OS does not honor #! arguments for us, we do it ourselves */
3200 while (PL_doextract || gMacPerl_AlwaysExtract) {
3201 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
3202 if (!gMacPerl_AlwaysExtract)
3203 Perl_croak(aTHX_ "No Perl script found in input\n");
3205 if (PL_doextract) /* require explicit override ? */
3206 if (!OverrideExtract(PL_origfilename))
3207 Perl_croak(aTHX_ "User aborted script\n");
3209 PL_doextract = FALSE;
3211 /* Pater peccavi, file does not have #! */
3212 PerlIO_rewind(PL_rsfp);
3217 while (PL_doextract) {
3218 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch)
3219 Perl_croak(aTHX_ "No Perl script found in input\n");
3222 if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
3223 PerlIO_ungetc(PL_rsfp, '\n'); /* to keep line count right */
3224 PL_doextract = FALSE;
3225 while (*s && !(isSPACE (*s) || *s == '#')) s++;
3227 while (*s == ' ' || *s == '\t') s++;
3229 while (isDIGIT(s2[-1]) || strchr("-._", s2[-1])) s2--;
3230 if (strnEQ(s2-4,"perl",4))
3232 while ((s = moreswitches(s)))
3235 #ifdef MACOS_TRADITIONAL
3236 /* We are always searching for the #!perl line in MacPerl,
3237 * so if we find it, still keep the line count correct
3238 * by counting lines we already skipped over
3240 for (; maclines > 0 ; maclines--)
3241 PerlIO_ungetc(PL_rsfp, '\n');
3245 /* gMacPerl_AlwaysExtract is false in MPW tool */
3246 } else if (gMacPerl_AlwaysExtract) {
3257 PL_uid = PerlProc_getuid();
3258 PL_euid = PerlProc_geteuid();
3259 PL_gid = PerlProc_getgid();
3260 PL_egid = PerlProc_getegid();
3262 PL_uid |= PL_gid << 16;
3263 PL_euid |= PL_egid << 16;
3265 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3269 S_forbid_setid(pTHX_ char *s)
3271 if (PL_euid != PL_uid)
3272 Perl_croak(aTHX_ "No %s allowed while running setuid", s);
3273 if (PL_egid != PL_gid)
3274 Perl_croak(aTHX_ "No %s allowed while running setgid", s);
3278 Perl_init_debugger(pTHX)
3280 HV *ostash = PL_curstash;
3282 PL_curstash = PL_debstash;
3283 PL_dbargs = GvAV(gv_AVadd((gv_fetchpv("args", GV_ADDMULTI, SVt_PVAV))));
3284 AvREAL_off(PL_dbargs);
3285 PL_DBgv = gv_fetchpv("DB", GV_ADDMULTI, SVt_PVGV);
3286 PL_DBline = gv_fetchpv("dbline", GV_ADDMULTI, SVt_PVAV);
3287 PL_DBsub = gv_HVadd(gv_fetchpv("sub", GV_ADDMULTI, SVt_PVHV));
3288 sv_upgrade(GvSV(PL_DBsub), SVt_IV); /* IVX accessed if PERLDB_SUB_NN */
3289 PL_DBsingle = GvSV((gv_fetchpv("single", GV_ADDMULTI, SVt_PV)));
3290 sv_setiv(PL_DBsingle, 0);
3291 PL_DBtrace = GvSV((gv_fetchpv("trace", GV_ADDMULTI, SVt_PV)));
3292 sv_setiv(PL_DBtrace, 0);
3293 PL_DBsignal = GvSV((gv_fetchpv("signal", GV_ADDMULTI, SVt_PV)));
3294 sv_setiv(PL_DBsignal, 0);
3295 PL_DBassertion = GvSV((gv_fetchpv("assertion", GV_ADDMULTI, SVt_PV)));
3296 sv_setiv(PL_DBassertion, 0);
3297 PL_curstash = ostash;
3300 #ifndef STRESS_REALLOC
3301 #define REASONABLE(size) (size)
3303 #define REASONABLE(size) (1) /* unreasonable */
3307 Perl_init_stacks(pTHX)
3309 /* start with 128-item stack and 8K cxstack */
3310 PL_curstackinfo = new_stackinfo(REASONABLE(128),
3311 REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
3312 PL_curstackinfo->si_type = PERLSI_MAIN;
3313 PL_curstack = PL_curstackinfo->si_stack;
3314 PL_mainstack = PL_curstack; /* remember in case we switch stacks */
3316 PL_stack_base = AvARRAY(PL_curstack);
3317 PL_stack_sp = PL_stack_base;
3318 PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
3320 New(50,PL_tmps_stack,REASONABLE(128),SV*);
3323 PL_tmps_max = REASONABLE(128);
3325 New(54,PL_markstack,REASONABLE(32),I32);
3326 PL_markstack_ptr = PL_markstack;
3327 PL_markstack_max = PL_markstack + REASONABLE(32);
3331 New(54,PL_scopestack,REASONABLE(32),I32);
3332 PL_scopestack_ix = 0;
3333 PL_scopestack_max = REASONABLE(32);
3335 New(54,PL_savestack,REASONABLE(128),ANY);
3336 PL_savestack_ix = 0;
3337 PL_savestack_max = REASONABLE(128);
3339 New(54,PL_retstack,REASONABLE(16),OP*);
3341 PL_retstack_max = REASONABLE(16);
3349 while (PL_curstackinfo->si_next)
3350 PL_curstackinfo = PL_curstackinfo->si_next;
3351 while (PL_curstackinfo) {
3352 PERL_SI *p = PL_curstackinfo->si_prev;
3353 /* curstackinfo->si_stack got nuked by sv_free_arenas() */
3354 Safefree(PL_curstackinfo->si_cxstack);
3355 Safefree(PL_curstackinfo);
3356 PL_curstackinfo = p;
3358 Safefree(PL_tmps_stack);
3359 Safefree(PL_markstack);
3360 Safefree(PL_scopestack);
3361 Safefree(PL_savestack);
3362 Safefree(PL_retstack);
3371 lex_start(PL_linestr);
3373 PL_subname = newSVpvn("main",4);
3377 S_init_predump_symbols(pTHX)
3382 sv_setpvn(get_sv("\"", TRUE), " ", 1);
3383 PL_stdingv = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
3384 GvMULTI_on(PL_stdingv);
3385 io = GvIOp(PL_stdingv);
3386 IoTYPE(io) = IoTYPE_RDONLY;
3387 IoIFP(io) = PerlIO_stdin();
3388 tmpgv = gv_fetchpv("stdin",TRUE, SVt_PV);
3390 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3392 tmpgv = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
3395 IoTYPE(io) = IoTYPE_WRONLY;
3396 IoOFP(io) = IoIFP(io) = PerlIO_stdout();
3398 tmpgv = gv_fetchpv("stdout",TRUE, SVt_PV);
3400 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3402 PL_stderrgv = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
3403 GvMULTI_on(PL_stderrgv);
3404 io = GvIOp(PL_stderrgv);
3405 IoTYPE(io) = IoTYPE_WRONLY;
3406 IoOFP(io) = IoIFP(io) = PerlIO_stderr();
3407 tmpgv = gv_fetchpv("stderr",TRUE, SVt_PV);
3409 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3411 PL_statname = NEWSV(66,0); /* last filename we did stat on */
3414 Safefree(PL_osname);
3415 PL_osname = savepv(OSNAME);
3419 Perl_init_argv_symbols(pTHX_ register int argc, register char **argv)
3422 argc--,argv++; /* skip name of script */
3423 if (PL_doswitches) {
3424 for (; argc > 0 && **argv == '-'; argc--,argv++) {
3427 if (argv[0][1] == '-' && !argv[0][2]) {
3431 if ((s = strchr(argv[0], '='))) {
3433 sv_setpv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),s);
3436 sv_setiv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),1);
3439 if ((PL_argvgv = gv_fetchpv("ARGV",TRUE, SVt_PVAV))) {
3440 GvMULTI_on(PL_argvgv);
3441 (void)gv_AVadd(PL_argvgv);
3442 av_clear(GvAVn(PL_argvgv));
3443 for (; argc > 0; argc--,argv++) {
3444 SV *sv = newSVpv(argv[0],0);
3445 av_push(GvAVn(PL_argvgv),sv);
3446 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
3447 if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
3450 if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
3451 (void)sv_utf8_decode(sv);
3456 #ifdef HAS_PROCSELFEXE
3457 /* This is a function so that we don't hold on to MAXPATHLEN
3458 bytes of stack longer than necessary
3461 S_procself_val(pTHX_ SV *sv, char *arg0)
3463 char buf[MAXPATHLEN];
3464 int len = readlink(PROCSELFEXE_PATH, buf, sizeof(buf) - 1);
3466 /* On Playstation2 Linux V1.0 (kernel 2.2.1) readlink(/proc/self/exe)
3467 includes a spurious NUL which will cause $^X to fail in system
3468 or backticks (this will prevent extensions from being built and
3469 many tests from working). readlink is not meant to add a NUL.
3470 Normal readlink works fine.
3472 if (len > 0 && buf[len-1] == '\0') {
3476 /* FreeBSD's implementation is acknowledged to be imperfect, sometimes
3477 returning the text "unknown" from the readlink rather than the path
3478 to the executable (or returning an error from the readlink). Any valid
3479 path has a '/' in it somewhere, so use that to validate the result.
3480 See http://www.freebsd.org/cgi/query-pr.cgi?pr=35703
3482 if (len > 0 && memchr(buf, '/', len)) {
3483 sv_setpvn(sv,buf,len);
3489 #endif /* HAS_PROCSELFEXE */
3492 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
3498 PL_toptarget = NEWSV(0,0);
3499 sv_upgrade(PL_toptarget, SVt_PVFM);
3500 sv_setpvn(PL_toptarget, "", 0);
3501 PL_bodytarget = NEWSV(0,0);
3502 sv_upgrade(PL_bodytarget, SVt_PVFM);
3503 sv_setpvn(PL_bodytarget, "", 0);
3504 PL_formtarget = PL_bodytarget;
3508 init_argv_symbols(argc,argv);
3510 if ((tmpgv = gv_fetchpv("0",TRUE, SVt_PV))) {
3511 #ifdef MACOS_TRADITIONAL
3512 /* $0 is not majick on a Mac */
3513 sv_setpv(GvSV(tmpgv),MacPerl_MPWFileName(PL_origfilename));
3515 sv_setpv(GvSV(tmpgv),PL_origfilename);
3516 magicname("0", "0", 1);
3519 if ((tmpgv = gv_fetchpv("\030",TRUE, SVt_PV))) {/* $^X */
3520 #ifdef HAS_PROCSELFEXE
3521 S_procself_val(aTHX_ GvSV(tmpgv), PL_origargv[0]);
3524 sv_setpv(GvSV(tmpgv), os2_execname(aTHX));
3526 sv_setpv(GvSV(tmpgv),PL_origargv[0]);
3530 if ((PL_envgv = gv_fetchpv("ENV",TRUE, SVt_PVHV))) {
3532 GvMULTI_on(PL_envgv);
3533 hv = GvHVn(PL_envgv);
3534 hv_magic(hv, Nullgv, PERL_MAGIC_env);
3535 #ifdef USE_ENVIRON_ARRAY
3536 /* Note that if the supplied env parameter is actually a copy
3537 of the global environ then it may now point to free'd memory
3538 if the environment has been modified since. To avoid this
3539 problem we treat env==NULL as meaning 'use the default'
3544 # ifdef USE_ITHREADS
3545 && PL_curinterp == aTHX
3549 environ[0] = Nullch;
3552 for (; *env; env++) {
3553 if (!(s = strchr(*env,'=')))
3560 sv = newSVpv(s+1, 0);
3561 (void)hv_store(hv, *env, s - *env, sv, 0);
3565 #endif /* USE_ENVIRON_ARRAY */
3568 if ((tmpgv = gv_fetchpv("$",TRUE, SVt_PV))) {
3569 SvREADONLY_off(GvSV(tmpgv));
3570 sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
3571 SvREADONLY_on(GvSV(tmpgv));
3573 #ifdef THREADS_HAVE_PIDS
3574 PL_ppid = (IV)getppid();
3577 /* touch @F array to prevent spurious warnings 20020415 MJD */
3579 (void) get_av("main::F", TRUE | GV_ADDMULTI);
3581 /* touch @- and @+ arrays to prevent spurious warnings 20020415 MJD */
3582 (void) get_av("main::-", TRUE | GV_ADDMULTI);
3583 (void) get_av("main::+", TRUE | GV_ADDMULTI);
3587 S_init_perllib(pTHX)
3592 s = PerlEnv_getenv("PERL5LIB");
3594 incpush(s, TRUE, TRUE, TRUE);
3596 incpush(PerlEnv_getenv("PERLLIB"), FALSE, FALSE, TRUE);
3598 /* Treat PERL5?LIB as a possible search list logical name -- the
3599 * "natural" VMS idiom for a Unix path string. We allow each
3600 * element to be a set of |-separated directories for compatibility.
3604 if (my_trnlnm("PERL5LIB",buf,0))
3605 do { incpush(buf,TRUE,TRUE,TRUE); } while (my_trnlnm("PERL5LIB",buf,++idx));
3607 while (my_trnlnm("PERLLIB",buf,idx++)) incpush(buf,FALSE,FALSE,TRUE);
3611 /* Use the ~-expanded versions of APPLLIB (undocumented),
3612 ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
3615 incpush(APPLLIB_EXP, TRUE, TRUE, TRUE);
3619 incpush(ARCHLIB_EXP, FALSE, FALSE, TRUE);
3621 #ifdef MACOS_TRADITIONAL
3624 SV * privdir = NEWSV(55, 0);
3625 char * macperl = PerlEnv_getenv("MACPERL");
3630 Perl_sv_setpvf(aTHX_ privdir, "%slib:", macperl);
3631 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3632 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3633 Perl_sv_setpvf(aTHX_ privdir, "%ssite_perl:", macperl);
3634 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3635 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3637 SvREFCNT_dec(privdir);
3640 incpush(":", FALSE, FALSE, TRUE);
3643 # define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
3646 incpush(PRIVLIB_EXP, TRUE, FALSE, TRUE);
3648 incpush(PRIVLIB_EXP, FALSE, FALSE, TRUE);
3652 /* sitearch is always relative to sitelib on Windows for
3653 * DLL-based path intuition to work correctly */
3654 # if !defined(WIN32)
3655 incpush(SITEARCH_EXP, FALSE, FALSE, TRUE);
3661 /* this picks up sitearch as well */
3662 incpush(SITELIB_EXP, TRUE, FALSE, TRUE);
3664 incpush(SITELIB_EXP, FALSE, FALSE, TRUE);
3668 #ifdef SITELIB_STEM /* Search for version-specific dirs below here */
3669 incpush(SITELIB_STEM, FALSE, TRUE, TRUE);
3672 #ifdef PERL_VENDORARCH_EXP
3673 /* vendorarch is always relative to vendorlib on Windows for
3674 * DLL-based path intuition to work correctly */
3675 # if !defined(WIN32)
3676 incpush(PERL_VENDORARCH_EXP, FALSE, FALSE, TRUE);
3680 #ifdef PERL_VENDORLIB_EXP
3682 incpush(PERL_VENDORLIB_EXP, TRUE, FALSE, TRUE); /* this picks up vendorarch as well */
3684 incpush(PERL_VENDORLIB_EXP, FALSE, FALSE, TRUE);
3688 #ifdef PERL_VENDORLIB_STEM /* Search for version-specific dirs below here */
3689 incpush(PERL_VENDORLIB_STEM, FALSE, TRUE, TRUE);
3692 #ifdef PERL_OTHERLIBDIRS
3693 incpush(PERL_OTHERLIBDIRS, TRUE, TRUE, TRUE);
3697 incpush(".", FALSE, FALSE, TRUE);
3698 #endif /* MACOS_TRADITIONAL */
3701 #if defined(DOSISH) || defined(EPOC)
3702 # define PERLLIB_SEP ';'
3705 # define PERLLIB_SEP '|'
3707 # if defined(MACOS_TRADITIONAL)
3708 # define PERLLIB_SEP ','
3710 # define PERLLIB_SEP ':'
3714 #ifndef PERLLIB_MANGLE
3715 # define PERLLIB_MANGLE(s,n) (s)
3719 S_incpush(pTHX_ char *p, int addsubdirs, int addoldvers, int usesep)
3721 SV *subdir = Nullsv;
3726 if (addsubdirs || addoldvers) {
3727 subdir = sv_newmortal();
3730 /* Break at all separators */
3732 SV *libdir = NEWSV(55,0);
3735 /* skip any consecutive separators */
3737 while ( *p == PERLLIB_SEP ) {
3738 /* Uncomment the next line for PATH semantics */
3739 /* av_push(GvAVn(PL_incgv), newSVpvn(".", 1)); */
3744 if ( usesep && (s = strchr(p, PERLLIB_SEP)) != Nullch ) {
3745 sv_setpvn(libdir, PERLLIB_MANGLE(p, (STRLEN)(s - p)),
3750 sv_setpv(libdir, PERLLIB_MANGLE(p, 0));
3751 p = Nullch; /* break out */
3753 #ifdef MACOS_TRADITIONAL
3754 if (!strchr(SvPVX(libdir), ':')) {
3757 sv_setpv(libdir, MacPerl_CanonDir(SvPVX(libdir), buf, 0));
3759 if (SvPVX(libdir)[SvCUR(libdir)-1] != ':')
3760 sv_catpv(libdir, ":");
3764 * BEFORE pushing libdir onto @INC we may first push version- and
3765 * archname-specific sub-directories.
3767 if (addsubdirs || addoldvers) {
3768 #ifdef PERL_INC_VERSION_LIST
3769 /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
3770 const char *incverlist[] = { PERL_INC_VERSION_LIST };
3771 const char **incver;
3778 if ((unix = tounixspec_ts(SvPV(libdir,len),Nullch)) != Nullch) {
3780 while (unix[len-1] == '/') len--; /* Cosmetic */
3781 sv_usepvn(libdir,unix,len);
3784 PerlIO_printf(Perl_error_log,
3785 "Failed to unixify @INC element \"%s\"\n",
3789 #ifdef MACOS_TRADITIONAL
3790 #define PERL_AV_SUFFIX_FMT ""
3791 #define PERL_ARCH_FMT "%s:"
3792 #define PERL_ARCH_FMT_PATH PERL_FS_VER_FMT PERL_AV_SUFFIX_FMT
3794 #define PERL_AV_SUFFIX_FMT "/"
3795 #define PERL_ARCH_FMT "/%s"
3796 #define PERL_ARCH_FMT_PATH PERL_AV_SUFFIX_FMT PERL_FS_VER_FMT
3798 /* .../version/archname if -d .../version/archname */
3799 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH PERL_ARCH_FMT,
3801 (int)PERL_REVISION, (int)PERL_VERSION,
3802 (int)PERL_SUBVERSION, ARCHNAME);
3803 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3804 S_ISDIR(tmpstatbuf.st_mode))
3805 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3807 /* .../version if -d .../version */
3808 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH, libdir,
3809 (int)PERL_REVISION, (int)PERL_VERSION,
3810 (int)PERL_SUBVERSION);
3811 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3812 S_ISDIR(tmpstatbuf.st_mode))
3813 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3815 /* .../archname if -d .../archname */
3816 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, ARCHNAME);
3817 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3818 S_ISDIR(tmpstatbuf.st_mode))
3819 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3822 #ifdef PERL_INC_VERSION_LIST
3824 for (incver = incverlist; *incver; incver++) {
3825 /* .../xxx if -d .../xxx */
3826 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, *incver);
3827 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3828 S_ISDIR(tmpstatbuf.st_mode))
3829 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3835 /* finally push this lib directory on the end of @INC */
3836 av_push(GvAVn(PL_incgv), libdir);
3840 #ifdef USE_5005THREADS
3841 STATIC struct perl_thread *
3842 S_init_main_thread(pTHX)
3844 #if !defined(PERL_IMPLICIT_CONTEXT)
3845 struct perl_thread *thr;
3849 Newz(53, thr, 1, struct perl_thread);
3850 PL_curcop = &PL_compiling;
3851 thr->interp = PERL_GET_INTERP;
3852 thr->cvcache = newHV();
3853 thr->threadsv = newAV();
3854 /* thr->threadsvp is set when find_threadsv is called */
3855 thr->specific = newAV();
3856 thr->flags = THRf_R_JOINABLE;
3857 MUTEX_INIT(&thr->mutex);
3858 /* Handcraft thrsv similarly to mess_sv */
3859 New(53, PL_thrsv, 1, SV);
3860 Newz(53, xpv, 1, XPV);
3861 SvFLAGS(PL_thrsv) = SVt_PV;
3862 SvANY(PL_thrsv) = (void*)xpv;
3863 SvREFCNT(PL_thrsv) = 1 << 30; /* practically infinite */
3864 SvPVX(PL_thrsv) = (char*)thr;
3865 SvCUR_set(PL_thrsv, sizeof(thr));
3866 SvLEN_set(PL_thrsv, sizeof(thr));
3867 *SvEND(PL_thrsv) = '\0'; /* in the trailing_nul field */
3868 thr->oursv = PL_thrsv;
3869 PL_chopset = " \n-";
3872 MUTEX_LOCK(&PL_threads_mutex);
3878 MUTEX_UNLOCK(&PL_threads_mutex);
3880 #ifdef HAVE_THREAD_INTERN
3881 Perl_init_thread_intern(thr);
3884 #ifdef SET_THREAD_SELF
3885 SET_THREAD_SELF(thr);
3887 thr->self = pthread_self();
3888 #endif /* SET_THREAD_SELF */
3892 * These must come after the thread self setting
3893 * because sv_setpvn does SvTAINT and the taint
3894 * fields thread selfness being set.
3896 PL_toptarget = NEWSV(0,0);
3897 sv_upgrade(PL_toptarget, SVt_PVFM);
3898 sv_setpvn(PL_toptarget, "", 0);
3899 PL_bodytarget = NEWSV(0,0);
3900 sv_upgrade(PL_bodytarget, SVt_PVFM);
3901 sv_setpvn(PL_bodytarget, "", 0);
3902 PL_formtarget = PL_bodytarget;
3903 thr->errsv = newSVpvn("", 0);
3904 (void) find_threadsv("@"); /* Ensure $@ is initialised early */
3907 PL_peepp = MEMBER_TO_FPTR(Perl_peep);
3908 PL_regcompp = MEMBER_TO_FPTR(Perl_pregcomp);
3909 PL_regexecp = MEMBER_TO_FPTR(Perl_regexec_flags);
3910 PL_regint_start = MEMBER_TO_FPTR(Perl_re_intuit_start);
3911 PL_regint_string = MEMBER_TO_FPTR(Perl_re_intuit_string);
3912 PL_regfree = MEMBER_TO_FPTR(Perl_pregfree);
3914 PL_reginterp_cnt = 0;
3918 #endif /* USE_5005THREADS */
3921 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
3924 line_t oldline = CopLINE(PL_curcop);
3930 while (AvFILL(paramList) >= 0) {
3931 cv = (CV*)av_shift(paramList);
3933 if (paramList == PL_beginav) {
3934 /* save PL_beginav for compiler */
3935 if (! PL_beginav_save)
3936 PL_beginav_save = newAV();
3937 av_push(PL_beginav_save, (SV*)cv);
3939 else if (paramList == PL_checkav) {
3940 /* save PL_checkav for compiler */
3941 if (! PL_checkav_save)
3942 PL_checkav_save = newAV();
3943 av_push(PL_checkav_save, (SV*)cv);
3948 #ifdef PERL_FLEXIBLE_EXCEPTIONS
3949 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_list_body), cv);
3955 #ifndef PERL_FLEXIBLE_EXCEPTIONS
3959 (void)SvPV(atsv, len);
3961 PL_curcop = &PL_compiling;
3962 CopLINE_set(PL_curcop, oldline);
3963 if (paramList == PL_beginav)
3964 sv_catpv(atsv, "BEGIN failed--compilation aborted");
3966 Perl_sv_catpvf(aTHX_ atsv,
3967 "%s failed--call queue aborted",
3968 paramList == PL_checkav ? "CHECK"
3969 : paramList == PL_initav ? "INIT"
3971 while (PL_scopestack_ix > oldscope)
3974 Perl_croak(aTHX_ "%"SVf"", atsv);
3981 /* my_exit() was called */
3982 while (PL_scopestack_ix > oldscope)
3985 PL_curstash = PL_defstash;
3986 PL_curcop = &PL_compiling;
3987 CopLINE_set(PL_curcop, oldline);
3989 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
3990 if (paramList == PL_beginav)
3991 Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
3993 Perl_croak(aTHX_ "%s failed--call queue aborted",
3994 paramList == PL_checkav ? "CHECK"
3995 : paramList == PL_initav ? "INIT"
4002 PL_curcop = &PL_compiling;
4003 CopLINE_set(PL_curcop, oldline);
4006 PerlIO_printf(Perl_error_log, "panic: restartop\n");
4014 #ifdef PERL_FLEXIBLE_EXCEPTIONS
4016 S_vcall_list_body(pTHX_ va_list args)
4018 CV *cv = va_arg(args, CV*);
4019 return call_list_body(cv);
4024 S_call_list_body(pTHX_ CV *cv)
4026 PUSHMARK(PL_stack_sp);
4027 call_sv((SV*)cv, G_EVAL|G_DISCARD);
4032 Perl_my_exit(pTHX_ U32 status)
4034 DEBUG_S(PerlIO_printf(Perl_debug_log, "my_exit: thread %p, status %lu\n",
4035 thr, (unsigned long) status));
4044 STATUS_NATIVE_SET(status);
4051 Perl_my_failure_exit(pTHX)
4054 if (vaxc$errno & 1) {
4055 if (STATUS_NATIVE & 1) /* fortuitiously includes "-1" */
4056 STATUS_NATIVE_SET(44);
4059 if (!vaxc$errno && errno) /* unlikely */
4060 STATUS_NATIVE_SET(44);
4062 STATUS_NATIVE_SET(vaxc$errno);
4067 STATUS_POSIX_SET(errno);
4069 exitstatus = STATUS_POSIX >> 8;
4070 if (exitstatus & 255)
4071 STATUS_POSIX_SET(exitstatus);
4073 STATUS_POSIX_SET(255);
4080 S_my_exit_jump(pTHX)
4082 register PERL_CONTEXT *cx;
4087 SvREFCNT_dec(PL_e_script);
4088 PL_e_script = Nullsv;
4091 POPSTACK_TO(PL_mainstack);
4092 if (cxstack_ix >= 0) {
4095 POPBLOCK(cx,PL_curpm);
4103 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen)
4106 p = SvPVX(PL_e_script);
4107 nl = strchr(p, '\n');
4108 nl = (nl) ? nl+1 : SvEND(PL_e_script);
4110 filter_del(read_e_script);
4113 sv_catpvn(buf_sv, p, nl-p);
4114 sv_chop(PL_e_script, nl);