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)
279 =for apidoc nothreadhook
281 Stub that provides thread hook for perl_destruct when there are
288 Perl_nothreadhook(pTHX)
294 =for apidoc perl_destruct
296 Shuts down a Perl interpreter. See L<perlembed>.
304 volatile int destruct_level; /* 0=none, 1=full, 2=full with checks */
306 #ifdef USE_5005THREADS
308 #endif /* USE_5005THREADS */
310 /* wait for all pseudo-forked children to finish */
311 PERL_WAIT_FOR_CHILDREN;
313 destruct_level = PL_perl_destruct_level;
317 if ((s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL"))) {
319 if (destruct_level < i)
326 if(PL_exit_flags & PERL_EXIT_DESTRUCT_END) {
331 if (PL_endav && !PL_minus_c)
332 call_list(PL_scopestack_ix, PL_endav);
338 /* Need to flush since END blocks can produce output */
341 if (CALL_FPTR(PL_threadhook)(aTHX)) {
342 /* Threads hook has vetoed further cleanup */
343 return STATUS_NATIVE_EXPORT;
346 /* We must account for everything. */
348 /* Destroy the main CV and syntax tree */
350 op_free(PL_main_root);
351 PL_main_root = Nullop;
353 PL_curcop = &PL_compiling;
354 PL_main_start = Nullop;
355 SvREFCNT_dec(PL_main_cv);
359 /* Tell PerlIO we are about to tear things apart in case
360 we have layers which are using resources that should
364 PerlIO_destruct(aTHX);
366 if (PL_sv_objcount) {
368 * Try to destruct global references. We do this first so that the
369 * destructors and destructees still exist. Some sv's might remain.
370 * Non-referenced objects are on their own.
375 /* unhook hooks which will soon be, or use, destroyed data */
376 SvREFCNT_dec(PL_warnhook);
377 PL_warnhook = Nullsv;
378 SvREFCNT_dec(PL_diehook);
381 /* call exit list functions */
382 while (PL_exitlistlen-- > 0)
383 PL_exitlist[PL_exitlistlen].fn(aTHX_ PL_exitlist[PL_exitlistlen].ptr);
385 Safefree(PL_exitlist);
390 if (destruct_level == 0){
392 DEBUG_P(debprofdump());
394 #if defined(PERLIO_LAYERS)
395 /* No more IO - including error messages ! */
396 PerlIO_cleanup(aTHX);
399 /* The exit() function will do everything that needs doing. */
400 return STATUS_NATIVE_EXPORT;
403 /* jettison our possibly duplicated environment */
404 /* if PERL_USE_SAFE_PUTENV is defined environ will not have been copied
405 * so we certainly shouldn't free it here
407 #if defined(USE_ENVIRON_ARRAY) && !defined(PERL_USE_SAFE_PUTENV)
408 if (environ != PL_origenviron
410 /* only main thread can free environ[0] contents */
411 && PL_curinterp == aTHX
417 for (i = 0; environ[i]; i++)
418 safesysfree(environ[i]);
420 /* Must use safesysfree() when working with environ. */
421 safesysfree(environ);
423 environ = PL_origenviron;
428 /* the syntax tree is shared between clones
429 * so op_free(PL_main_root) only ReREFCNT_dec's
430 * REGEXPs in the parent interpreter
431 * we need to manually ReREFCNT_dec for the clones
434 I32 i = AvFILLp(PL_regex_padav) + 1;
435 SV **ary = AvARRAY(PL_regex_padav);
439 REGEXP *re = INT2PTR(REGEXP *,SvIVX(resv));
441 if (SvFLAGS(resv) & SVf_BREAK) {
442 /* this is PL_reg_curpm, already freed
443 * flag is set in regexec.c:S_regtry
445 SvFLAGS(resv) &= ~SVf_BREAK;
447 else if(SvREPADTMP(resv)) {
448 SvREPADTMP_off(resv);
455 SvREFCNT_dec(PL_regex_padav);
456 PL_regex_padav = Nullav;
460 /* loosen bonds of global variables */
463 (void)PerlIO_close(PL_rsfp);
467 /* Filters for program text */
468 SvREFCNT_dec(PL_rsfp_filters);
469 PL_rsfp_filters = Nullav;
472 PL_preprocess = FALSE;
478 PL_doswitches = FALSE;
479 PL_dowarn = G_WARN_OFF;
480 PL_doextract = FALSE;
481 PL_sawampersand = FALSE; /* must save all match strings */
484 Safefree(PL_inplace);
486 SvREFCNT_dec(PL_patchlevel);
489 SvREFCNT_dec(PL_e_script);
490 PL_e_script = Nullsv;
493 /* magical thingies */
495 SvREFCNT_dec(PL_ofs_sv); /* $, */
498 SvREFCNT_dec(PL_ors_sv); /* $\ */
501 SvREFCNT_dec(PL_rs); /* $/ */
504 PL_multiline = 0; /* $* */
505 Safefree(PL_osname); /* $^O */
508 SvREFCNT_dec(PL_statname);
509 PL_statname = Nullsv;
512 /* defgv, aka *_ should be taken care of elsewhere */
514 /* clean up after study() */
515 SvREFCNT_dec(PL_lastscream);
516 PL_lastscream = Nullsv;
517 Safefree(PL_screamfirst);
519 Safefree(PL_screamnext);
523 Safefree(PL_efloatbuf);
524 PL_efloatbuf = Nullch;
527 /* startup and shutdown function lists */
528 SvREFCNT_dec(PL_beginav);
529 SvREFCNT_dec(PL_beginav_save);
530 SvREFCNT_dec(PL_endav);
531 SvREFCNT_dec(PL_checkav);
532 SvREFCNT_dec(PL_checkav_save);
533 SvREFCNT_dec(PL_initav);
535 PL_beginav_save = Nullav;
538 PL_checkav_save = Nullav;
541 /* shortcuts just get cleared */
547 PL_argvoutgv = Nullgv;
549 PL_stderrgv = Nullgv;
550 PL_last_in_gv = Nullgv;
552 PL_debstash = Nullhv;
554 /* reset so print() ends up where we expect */
557 SvREFCNT_dec(PL_argvout_stack);
558 PL_argvout_stack = Nullav;
560 SvREFCNT_dec(PL_modglobal);
561 PL_modglobal = Nullhv;
562 SvREFCNT_dec(PL_preambleav);
563 PL_preambleav = Nullav;
564 SvREFCNT_dec(PL_subname);
566 SvREFCNT_dec(PL_linestr);
568 SvREFCNT_dec(PL_pidstatus);
569 PL_pidstatus = Nullhv;
570 SvREFCNT_dec(PL_toptarget);
571 PL_toptarget = Nullsv;
572 SvREFCNT_dec(PL_bodytarget);
573 PL_bodytarget = Nullsv;
574 PL_formtarget = Nullsv;
576 /* free locale stuff */
577 #ifdef USE_LOCALE_COLLATE
578 Safefree(PL_collation_name);
579 PL_collation_name = Nullch;
582 #ifdef USE_LOCALE_NUMERIC
583 Safefree(PL_numeric_name);
584 PL_numeric_name = Nullch;
585 SvREFCNT_dec(PL_numeric_radix_sv);
588 /* clear utf8 character classes */
589 SvREFCNT_dec(PL_utf8_alnum);
590 SvREFCNT_dec(PL_utf8_alnumc);
591 SvREFCNT_dec(PL_utf8_ascii);
592 SvREFCNT_dec(PL_utf8_alpha);
593 SvREFCNT_dec(PL_utf8_space);
594 SvREFCNT_dec(PL_utf8_cntrl);
595 SvREFCNT_dec(PL_utf8_graph);
596 SvREFCNT_dec(PL_utf8_digit);
597 SvREFCNT_dec(PL_utf8_upper);
598 SvREFCNT_dec(PL_utf8_lower);
599 SvREFCNT_dec(PL_utf8_print);
600 SvREFCNT_dec(PL_utf8_punct);
601 SvREFCNT_dec(PL_utf8_xdigit);
602 SvREFCNT_dec(PL_utf8_mark);
603 SvREFCNT_dec(PL_utf8_toupper);
604 SvREFCNT_dec(PL_utf8_totitle);
605 SvREFCNT_dec(PL_utf8_tolower);
606 SvREFCNT_dec(PL_utf8_tofold);
607 SvREFCNT_dec(PL_utf8_idstart);
608 SvREFCNT_dec(PL_utf8_idcont);
609 PL_utf8_alnum = Nullsv;
610 PL_utf8_alnumc = Nullsv;
611 PL_utf8_ascii = Nullsv;
612 PL_utf8_alpha = Nullsv;
613 PL_utf8_space = Nullsv;
614 PL_utf8_cntrl = Nullsv;
615 PL_utf8_graph = Nullsv;
616 PL_utf8_digit = Nullsv;
617 PL_utf8_upper = Nullsv;
618 PL_utf8_lower = Nullsv;
619 PL_utf8_print = Nullsv;
620 PL_utf8_punct = Nullsv;
621 PL_utf8_xdigit = Nullsv;
622 PL_utf8_mark = Nullsv;
623 PL_utf8_toupper = Nullsv;
624 PL_utf8_totitle = Nullsv;
625 PL_utf8_tolower = Nullsv;
626 PL_utf8_tofold = Nullsv;
627 PL_utf8_idstart = Nullsv;
628 PL_utf8_idcont = Nullsv;
630 if (!specialWARN(PL_compiling.cop_warnings))
631 SvREFCNT_dec(PL_compiling.cop_warnings);
632 PL_compiling.cop_warnings = Nullsv;
633 if (!specialCopIO(PL_compiling.cop_io))
634 SvREFCNT_dec(PL_compiling.cop_io);
635 PL_compiling.cop_io = Nullsv;
636 CopFILE_free(&PL_compiling);
637 CopSTASH_free(&PL_compiling);
639 /* Prepare to destruct main symbol table. */
644 SvREFCNT_dec(PL_curstname);
645 PL_curstname = Nullsv;
647 /* clear queued errors */
648 SvREFCNT_dec(PL_errors);
652 if (destruct_level >= 2 && ckWARN_d(WARN_INTERNAL)) {
653 if (PL_scopestack_ix != 0)
654 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
655 "Unbalanced scopes: %ld more ENTERs than LEAVEs\n",
656 (long)PL_scopestack_ix);
657 if (PL_savestack_ix != 0)
658 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
659 "Unbalanced saves: %ld more saves than restores\n",
660 (long)PL_savestack_ix);
661 if (PL_tmps_floor != -1)
662 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced tmps: %ld more allocs than frees\n",
663 (long)PL_tmps_floor + 1);
664 if (cxstack_ix != -1)
665 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Unbalanced context: %ld more PUSHes than POPs\n",
666 (long)cxstack_ix + 1);
669 /* Now absolutely destruct everything, somehow or other, loops or no. */
670 SvFLAGS(PL_fdpid) |= SVTYPEMASK; /* don't clean out pid table now */
671 SvFLAGS(PL_strtab) |= SVTYPEMASK; /* don't clean out strtab now */
673 /* the 2 is for PL_fdpid and PL_strtab */
674 while (PL_sv_count > 2 && sv_clean_all())
677 SvFLAGS(PL_fdpid) &= ~SVTYPEMASK;
678 SvFLAGS(PL_fdpid) |= SVt_PVAV;
679 SvFLAGS(PL_strtab) &= ~SVTYPEMASK;
680 SvFLAGS(PL_strtab) |= SVt_PVHV;
682 AvREAL_off(PL_fdpid); /* no surviving entries */
683 SvREFCNT_dec(PL_fdpid); /* needed in io_close() */
686 #ifdef HAVE_INTERP_INTERN
690 /* Destruct the global string table. */
692 /* Yell and reset the HeVAL() slots that are still holding refcounts,
693 * so that sv_free() won't fail on them.
701 max = HvMAX(PL_strtab);
702 array = HvARRAY(PL_strtab);
705 if (hent && ckWARN_d(WARN_INTERNAL)) {
706 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
707 "Unbalanced string table refcount: (%d) for \"%s\"",
708 HeVAL(hent) - Nullsv, HeKEY(hent));
709 HeVAL(hent) = Nullsv;
719 SvREFCNT_dec(PL_strtab);
722 /* free the pointer table used for cloning */
723 ptr_table_free(PL_ptr_table);
726 /* free special SVs */
728 SvREFCNT(&PL_sv_yes) = 0;
729 sv_clear(&PL_sv_yes);
730 SvANY(&PL_sv_yes) = NULL;
731 SvFLAGS(&PL_sv_yes) = 0;
733 SvREFCNT(&PL_sv_no) = 0;
735 SvANY(&PL_sv_no) = NULL;
736 SvFLAGS(&PL_sv_no) = 0;
740 for (i=0; i<=2; i++) {
741 SvREFCNT(PERL_DEBUG_PAD(i)) = 0;
742 sv_clear(PERL_DEBUG_PAD(i));
743 SvANY(PERL_DEBUG_PAD(i)) = NULL;
744 SvFLAGS(PERL_DEBUG_PAD(i)) = 0;
748 if (PL_sv_count != 0 && ckWARN_d(WARN_INTERNAL))
749 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),"Scalars leaked: %ld\n", (long)PL_sv_count);
751 #ifdef DEBUG_LEAKING_SCALARS
752 if (PL_sv_count != 0) {
757 for (sva = PL_sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
758 svend = &sva[SvREFCNT(sva)];
759 for (sv = sva + 1; sv < svend; ++sv) {
760 if (SvTYPE(sv) != SVTYPEMASK) {
761 PerlIO_printf(Perl_debug_log, "leaked: 0x%p\n", sv);
769 #if defined(PERLIO_LAYERS)
770 /* No more IO - including error messages ! */
771 PerlIO_cleanup(aTHX);
774 /* sv_undef needs to stay immortal until after PerlIO_cleanup
775 as currently layers use it rather than Nullsv as a marker
776 for no arg - and will try and SvREFCNT_dec it.
778 SvREFCNT(&PL_sv_undef) = 0;
779 SvREADONLY_off(&PL_sv_undef);
781 Safefree(PL_origfilename);
782 Safefree(PL_reg_start_tmp);
784 Safefree(PL_reg_curpm);
785 Safefree(PL_reg_poscache);
786 Safefree(HeKEY_hek(&PL_hv_fetch_ent_mh));
787 Safefree(PL_op_mask);
788 Safefree(PL_psig_ptr);
789 Safefree(PL_psig_name);
790 Safefree(PL_bitcount);
791 Safefree(PL_psig_pend);
793 PL_hints = 0; /* Reset hints. Should hints be per-interpreter ? */
795 DEBUG_P(debprofdump());
797 #ifdef USE_REENTRANT_API
798 Perl_reentrant_free(aTHX);
803 /* As the absolutely last thing, free the non-arena SV for mess() */
806 /* it could have accumulated taint magic */
807 if (SvTYPE(PL_mess_sv) >= SVt_PVMG) {
810 for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
811 moremagic = mg->mg_moremagic;
812 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
814 Safefree(mg->mg_ptr);
818 /* we know that type >= SVt_PV */
819 (void)SvOOK_off(PL_mess_sv);
820 Safefree(SvPVX(PL_mess_sv));
821 Safefree(SvANY(PL_mess_sv));
822 Safefree(PL_mess_sv);
825 return STATUS_NATIVE_EXPORT;
829 =for apidoc perl_free
831 Releases a Perl interpreter. See L<perlembed>.
839 #if defined(WIN32) || defined(NETWARE)
840 # if defined(PERL_IMPLICIT_SYS)
842 void *host = nw_internal_host;
844 void *host = w32_internal_host;
848 nw_delete_internal_host(host);
850 win32_delete_internal_host(host);
861 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
863 Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
864 PL_exitlist[PL_exitlistlen].fn = fn;
865 PL_exitlist[PL_exitlistlen].ptr = ptr;
870 =for apidoc perl_parse
872 Tells a Perl interpreter to parse a Perl script. See L<perlembed>.
878 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
883 #ifdef USE_5005THREADS
887 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
890 Perl_croak(aTHX_ "suidperl is no longer needed since the kernel can now execute\n\
891 setuid perl scripts securely.\n");
900 /* Come here if running an undumped a.out. */
902 PL_origfilename = savepv(argv[0]);
903 PL_do_undump = FALSE;
904 cxstack_ix = -1; /* start label stack again */
906 init_postdump_symbols(argc,argv,env);
911 op_free(PL_main_root);
912 PL_main_root = Nullop;
914 PL_main_start = Nullop;
915 SvREFCNT_dec(PL_main_cv);
919 oldscope = PL_scopestack_ix;
920 PL_dowarn = G_WARN_OFF;
922 #ifdef PERL_FLEXIBLE_EXCEPTIONS
923 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vparse_body), env, xsinit);
929 #ifndef PERL_FLEXIBLE_EXCEPTIONS
930 parse_body(env,xsinit);
933 call_list(oldscope, PL_checkav);
940 /* my_exit() was called */
941 while (PL_scopestack_ix > oldscope)
944 PL_curstash = PL_defstash;
946 call_list(oldscope, PL_checkav);
947 ret = STATUS_NATIVE_EXPORT;
950 PerlIO_printf(Perl_error_log, "panic: top_env\n");
958 #ifdef PERL_FLEXIBLE_EXCEPTIONS
960 S_vparse_body(pTHX_ va_list args)
962 char **env = va_arg(args, char**);
963 XSINIT_t xsinit = va_arg(args, XSINIT_t);
965 return parse_body(env, xsinit);
970 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
972 int argc = PL_origargc;
973 char **argv = PL_origargv;
974 char *scriptname = NULL;
976 VOL bool dosearch = FALSE;
980 char *cddir = Nullch;
982 sv_setpvn(PL_linestr,"",0);
983 sv = newSVpvn("",0); /* first used for -I flags */
987 for (argc--,argv++; argc > 0; argc--,argv++) {
988 if (argv[0][0] != '-' || !argv[0][1])
992 validarg = " PHOOEY ";
1000 #ifndef PERL_STRICT_CR
1025 if ((s = moreswitches(s)))
1030 if( !PL_tainting ) {
1031 PL_taint_warn = TRUE;
1038 PL_taint_warn = FALSE;
1043 #ifdef MACOS_TRADITIONAL
1044 /* ignore -e for Dev:Pseudo argument */
1045 if (argv[1] && !strcmp(argv[1], "Dev:Pseudo"))
1048 if (PL_euid != PL_uid || PL_egid != PL_gid)
1049 Perl_croak(aTHX_ "No -e allowed in setuid scripts");
1051 PL_e_script = newSVpvn("",0);
1052 filter_add(read_e_script, NULL);
1055 sv_catpv(PL_e_script, s);
1057 sv_catpv(PL_e_script, argv[1]);
1061 Perl_croak(aTHX_ "No code specified for -e");
1062 sv_catpv(PL_e_script, "\n");
1065 case 'I': /* -I handled both here and in moreswitches() */
1067 if (!*++s && (s=argv[1]) != Nullch) {
1072 STRLEN len = strlen(s);
1073 p = savepvn(s, len);
1074 incpush(p, TRUE, TRUE, FALSE);
1075 sv_catpvn(sv, "-I", 2);
1076 sv_catpvn(sv, p, len);
1077 sv_catpvn(sv, " ", 1);
1081 Perl_croak(aTHX_ "No directory specified for -I");
1085 PL_preprocess = TRUE;
1095 PL_preambleav = newAV();
1096 av_push(PL_preambleav, newSVpv("use Config qw(myconfig config_vars)",0));
1098 PL_Sv = newSVpv("print myconfig();",0);
1100 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this PERLSHR image: \\n\",");
1102 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this binary (from libperl): \\n\",");
1104 sv_catpv(PL_Sv,"\" Compile-time options:");
1106 sv_catpv(PL_Sv," DEBUGGING");
1108 # ifdef MULTIPLICITY
1109 sv_catpv(PL_Sv," MULTIPLICITY");
1111 # ifdef USE_5005THREADS
1112 sv_catpv(PL_Sv," USE_5005THREADS");
1114 # ifdef USE_ITHREADS
1115 sv_catpv(PL_Sv," USE_ITHREADS");
1117 # ifdef USE_64_BIT_INT
1118 sv_catpv(PL_Sv," USE_64_BIT_INT");
1120 # ifdef USE_64_BIT_ALL
1121 sv_catpv(PL_Sv," USE_64_BIT_ALL");
1123 # ifdef USE_LONG_DOUBLE
1124 sv_catpv(PL_Sv," USE_LONG_DOUBLE");
1126 # ifdef USE_LARGE_FILES
1127 sv_catpv(PL_Sv," USE_LARGE_FILES");
1130 sv_catpv(PL_Sv," USE_SOCKS");
1132 # ifdef PERL_IMPLICIT_CONTEXT
1133 sv_catpv(PL_Sv," PERL_IMPLICIT_CONTEXT");
1135 # ifdef PERL_IMPLICIT_SYS
1136 sv_catpv(PL_Sv," PERL_IMPLICIT_SYS");
1138 sv_catpv(PL_Sv,"\\n\",");
1140 #if defined(LOCAL_PATCH_COUNT)
1141 if (LOCAL_PATCH_COUNT > 0) {
1143 sv_catpv(PL_Sv,"\" Locally applied patches:\\n\",");
1144 for (i = 1; i <= LOCAL_PATCH_COUNT; i++) {
1145 if (PL_localpatches[i])
1146 Perl_sv_catpvf(aTHX_ PL_Sv,"q\" \t%s\n\",",PL_localpatches[i]);
1150 Perl_sv_catpvf(aTHX_ PL_Sv,"\" Built under %s\\n\"",OSNAME);
1153 Perl_sv_catpvf(aTHX_ PL_Sv,",\" Compiled at %s %s\\n\"",__DATE__,__TIME__);
1155 Perl_sv_catpvf(aTHX_ PL_Sv,",\" Compiled on %s\\n\"",__DATE__);
1158 sv_catpv(PL_Sv, "; \
1160 @env = map { \"$_=\\\"$ENV{$_}\\\"\" } sort grep {/^PERL/} keys %ENV; ");
1163 push @env, \"CYGWIN=\\\"$ENV{CYGWIN}\\\"\";");
1166 print \" \\%ENV:\\n @env\\n\" if @env; \
1167 print \" \\@INC:\\n @INC\\n\";");
1170 PL_Sv = newSVpv("config_vars(qw(",0);
1171 sv_catpv(PL_Sv, ++s);
1172 sv_catpv(PL_Sv, "))");
1175 av_push(PL_preambleav, PL_Sv);
1176 scriptname = BIT_BUCKET; /* don't look for script or read stdin */
1179 PL_doextract = TRUE;
1187 if (!*++s || isSPACE(*s)) {
1191 /* catch use of gnu style long options */
1192 if (strEQ(s, "version")) {
1196 if (strEQ(s, "help")) {
1203 Perl_croak(aTHX_ "Unrecognized switch: -%s (-h will show valid options)",s);
1207 sv_setsv(get_sv("/", TRUE), PL_rs);
1210 #ifndef SECURE_INTERNAL_GETENV
1213 (s = PerlEnv_getenv("PERL5OPT")))
1218 if (*s == '-' && *(s+1) == 'T') {
1220 PL_taint_warn = FALSE;
1223 char *popt_copy = Nullch;
1236 if (!strchr("DIMUdmtwA", *s))
1237 Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
1241 popt_copy = SvPVX(sv_2mortal(newSVpv(popt,0)));
1242 s = popt_copy + (s - popt);
1243 d = popt_copy + (d - popt);
1250 if( !PL_tainting ) {
1251 PL_taint_warn = TRUE;
1261 if (PL_taint_warn && PL_dowarn != G_WARN_ALL_OFF) {
1262 PL_compiling.cop_warnings = newSVpvn(WARN_TAINTstring, WARNsize);
1266 scriptname = argv[0];
1269 scriptname = BIT_BUCKET; /* don't look for script or read stdin */
1271 else if (scriptname == Nullch) {
1273 if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
1281 open_script(scriptname,dosearch,sv,&fdscript);
1283 validate_suid(validarg, scriptname,fdscript);
1286 #if defined(SIGCHLD) || defined(SIGCLD)
1289 # define SIGCHLD SIGCLD
1291 Sighandler_t sigstate = rsignal_state(SIGCHLD);
1292 if (sigstate == SIG_IGN) {
1293 if (ckWARN(WARN_SIGNAL))
1294 Perl_warner(aTHX_ packWARN(WARN_SIGNAL),
1295 "Can't ignore signal CHLD, forcing to default");
1296 (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
1302 #ifdef MACOS_TRADITIONAL
1303 if (PL_doextract || gMacPerl_AlwaysExtract) {
1308 if (cddir && PerlDir_chdir(cddir) < 0)
1309 Perl_croak(aTHX_ "Can't chdir to %s",cddir);
1313 PL_main_cv = PL_compcv = (CV*)NEWSV(1104,0);
1314 sv_upgrade((SV *)PL_compcv, SVt_PVCV);
1315 CvUNIQUE_on(PL_compcv);
1317 CvPADLIST(PL_compcv) = pad_new(0);
1318 #ifdef USE_5005THREADS
1319 CvOWNER(PL_compcv) = 0;
1320 New(666, CvMUTEXP(PL_compcv), 1, perl_mutex);
1321 MUTEX_INIT(CvMUTEXP(PL_compcv));
1322 #endif /* USE_5005THREADS */
1325 boot_core_UNIVERSAL();
1327 boot_core_xsutils();
1331 (*xsinit)(aTHX); /* in case linked C routines want magical variables */
1333 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(EPOC)
1339 # ifdef HAS_SOCKS5_INIT
1340 socks5_init(argv[0]);
1346 init_predump_symbols();
1347 /* init_postdump_symbols not currently designed to be called */
1348 /* more than once (ENV isn't cleared first, for example) */
1349 /* But running with -u leaves %ENV & @ARGV undefined! XXX */
1351 init_postdump_symbols(argc,argv,env);
1353 /* PL_unicode is turned on by -C or by $ENV{PERL_UNICODE}.
1354 * PL_utf8locale is conditionally turned on by
1355 * locale.c:Perl_init_i18nl10n() if the environment
1356 * look like the user wants to use UTF-8. */
1358 /* Requires init_predump_symbols(). */
1359 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
1364 /* Turn on UTF-8-ness on STDIN, STDOUT, STDERR
1365 * and the default open disciplines. */
1366 if ((PL_unicode & PERL_UNICODE_STDIN_FLAG) &&
1367 PL_stdingv && (io = GvIO(PL_stdingv)) &&
1369 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1370 if ((PL_unicode & PERL_UNICODE_STDOUT_FLAG) &&
1371 PL_defoutgv && (io = GvIO(PL_defoutgv)) &&
1373 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1374 if ((PL_unicode & PERL_UNICODE_STDERR_FLAG) &&
1375 PL_stderrgv && (io = GvIO(PL_stderrgv)) &&
1377 PerlIO_binmode(aTHX_ fp, IoTYPE(io), 0, ":utf8");
1378 if ((PL_unicode & PERL_UNICODE_INOUT_FLAG) &&
1379 (sv = GvSV(gv_fetchpv("\017PEN", TRUE, SVt_PV)))) {
1380 U32 in = PL_unicode & PERL_UNICODE_IN_FLAG;
1381 U32 out = PL_unicode & PERL_UNICODE_OUT_FLAG;
1384 sv_setpvn(sv, ":utf8\0:utf8", 11);
1386 sv_setpvn(sv, ":utf8\0", 6);
1389 sv_setpvn(sv, "\0:utf8", 6);
1395 if ((s = PerlEnv_getenv("PERL_SIGNALS"))) {
1396 if (strEQ(s, "unsafe"))
1397 PL_signals |= PERL_SIGNALS_UNSAFE_FLAG;
1398 else if (strEQ(s, "safe"))
1399 PL_signals &= ~PERL_SIGNALS_UNSAFE_FLAG;
1401 Perl_croak(aTHX_ "PERL_SIGNALS illegal: \"%s\"", s);
1406 /* now parse the script */
1408 SETERRNO(0,SS_NORMAL);
1410 #ifdef MACOS_TRADITIONAL
1411 if (gMacPerl_SyntaxError = (yyparse() || PL_error_count)) {
1413 Perl_croak(aTHX_ "%s had compilation errors.\n", MacPerl_MPWFileName(PL_origfilename));
1415 Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1416 MacPerl_MPWFileName(PL_origfilename));
1420 if (yyparse() || PL_error_count) {
1422 Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
1424 Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1429 CopLINE_set(PL_curcop, 0);
1430 PL_curstash = PL_defstash;
1431 PL_preprocess = FALSE;
1433 SvREFCNT_dec(PL_e_script);
1434 PL_e_script = Nullsv;
1441 SAVECOPFILE(PL_curcop);
1442 SAVECOPLINE(PL_curcop);
1443 gv_check(PL_defstash);
1450 if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && atoi(s) >= 2)
1451 dump_mstats("after compilation:");
1460 =for apidoc perl_run
1462 Tells a Perl interpreter to run. See L<perlembed>.
1473 #ifdef USE_5005THREADS
1477 oldscope = PL_scopestack_ix;
1482 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1484 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vrun_body), oldscope);
1490 cxstack_ix = -1; /* start context stack again */
1492 case 0: /* normal completion */
1493 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1498 case 2: /* my_exit() */
1499 while (PL_scopestack_ix > oldscope)
1502 PL_curstash = PL_defstash;
1503 if (!(PL_exit_flags & PERL_EXIT_DESTRUCT_END) &&
1504 PL_endav && !PL_minus_c)
1505 call_list(oldscope, PL_endav);
1507 if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
1508 dump_mstats("after execution: ");
1510 ret = STATUS_NATIVE_EXPORT;
1514 POPSTACK_TO(PL_mainstack);
1517 PerlIO_printf(Perl_error_log, "panic: restartop\n");
1527 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1529 S_vrun_body(pTHX_ va_list args)
1531 I32 oldscope = va_arg(args, I32);
1533 return run_body(oldscope);
1539 S_run_body(pTHX_ I32 oldscope)
1541 DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support.\n",
1542 PL_sawampersand ? "Enabling" : "Omitting"));
1544 if (!PL_restartop) {
1545 DEBUG_x(dump_all());
1546 DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
1547 DEBUG_S(PerlIO_printf(Perl_debug_log, "main thread is 0x%"UVxf"\n",
1551 #ifdef MACOS_TRADITIONAL
1552 PerlIO_printf(Perl_error_log, "%s%s syntax OK\n",
1553 (gMacPerl_ErrorFormat ? "# " : ""),
1554 MacPerl_MPWFileName(PL_origfilename));
1556 PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
1560 if (PERLDB_SINGLE && PL_DBsingle)
1561 sv_setiv(PL_DBsingle, 1);
1563 call_list(oldscope, PL_initav);
1569 PL_op = PL_restartop;
1573 else if (PL_main_start) {
1574 CvDEPTH(PL_main_cv) = 1;
1575 PL_op = PL_main_start;
1585 =head1 SV Manipulation Functions
1587 =for apidoc p||get_sv
1589 Returns the SV of the specified Perl scalar. If C<create> is set and the
1590 Perl variable does not exist then it will be created. If C<create> is not
1591 set and the variable does not exist then NULL is returned.
1597 Perl_get_sv(pTHX_ const char *name, I32 create)
1600 #ifdef USE_5005THREADS
1601 if (name[1] == '\0' && !isALPHA(name[0])) {
1602 PADOFFSET tmp = find_threadsv(name);
1603 if (tmp != NOT_IN_PAD)
1604 return THREADSV(tmp);
1606 #endif /* USE_5005THREADS */
1607 gv = gv_fetchpv(name, create, SVt_PV);
1614 =head1 Array Manipulation Functions
1616 =for apidoc p||get_av
1618 Returns the AV of the specified Perl array. If C<create> is set and the
1619 Perl variable does not exist then it will be created. If C<create> is not
1620 set and the variable does not exist then NULL is returned.
1626 Perl_get_av(pTHX_ const char *name, I32 create)
1628 GV* gv = gv_fetchpv(name, create, SVt_PVAV);
1637 =head1 Hash Manipulation Functions
1639 =for apidoc p||get_hv
1641 Returns the HV of the specified Perl hash. If C<create> is set and the
1642 Perl variable does not exist then it will be created. If C<create> is not
1643 set and the variable does not exist then NULL is returned.
1649 Perl_get_hv(pTHX_ const char *name, I32 create)
1651 GV* gv = gv_fetchpv(name, create, SVt_PVHV);
1660 =head1 CV Manipulation Functions
1662 =for apidoc p||get_cv
1664 Returns the CV of the specified Perl subroutine. If C<create> is set and
1665 the Perl subroutine does not exist then it will be declared (which has the
1666 same effect as saying C<sub name;>). If C<create> is not set and the
1667 subroutine does not exist then NULL is returned.
1673 Perl_get_cv(pTHX_ const char *name, I32 create)
1675 GV* gv = gv_fetchpv(name, create, SVt_PVCV);
1676 /* XXX unsafe for threads if eval_owner isn't held */
1677 /* XXX this is probably not what they think they're getting.
1678 * It has the same effect as "sub name;", i.e. just a forward
1680 if (create && !GvCVu(gv))
1681 return newSUB(start_subparse(FALSE, 0),
1682 newSVOP(OP_CONST, 0, newSVpv(name,0)),
1690 /* Be sure to refetch the stack pointer after calling these routines. */
1694 =head1 Callback Functions
1696 =for apidoc p||call_argv
1698 Performs a callback to the specified Perl sub. See L<perlcall>.
1704 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, register char **argv)
1706 /* See G_* flags in cop.h */
1707 /* null terminated arg list */
1714 XPUSHs(sv_2mortal(newSVpv(*argv,0)));
1719 return call_pv(sub_name, flags);
1723 =for apidoc p||call_pv
1725 Performs a callback to the specified Perl sub. See L<perlcall>.
1731 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
1732 /* name of the subroutine */
1733 /* See G_* flags in cop.h */
1735 return call_sv((SV*)get_cv(sub_name, TRUE), flags);
1739 =for apidoc p||call_method
1741 Performs a callback to the specified Perl method. The blessed object must
1742 be on the stack. See L<perlcall>.
1748 Perl_call_method(pTHX_ const char *methname, I32 flags)
1749 /* name of the subroutine */
1750 /* See G_* flags in cop.h */
1752 return call_sv(sv_2mortal(newSVpv(methname,0)), flags | G_METHOD);
1755 /* May be called with any of a CV, a GV, or an SV containing the name. */
1757 =for apidoc p||call_sv
1759 Performs a callback to the Perl sub whose name is in the SV. See
1766 Perl_call_sv(pTHX_ SV *sv, I32 flags)
1767 /* See G_* flags in cop.h */
1770 LOGOP myop; /* fake syntax tree node */
1773 volatile I32 retval = 0;
1775 bool oldcatch = CATCH_GET;
1780 if (flags & G_DISCARD) {
1785 Zero(&myop, 1, LOGOP);
1786 myop.op_next = Nullop;
1787 if (!(flags & G_NOARGS))
1788 myop.op_flags |= OPf_STACKED;
1789 myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1790 (flags & G_ARRAY) ? OPf_WANT_LIST :
1795 EXTEND(PL_stack_sp, 1);
1796 *++PL_stack_sp = sv;
1798 oldscope = PL_scopestack_ix;
1800 if (PERLDB_SUB && PL_curstash != PL_debstash
1801 /* Handle first BEGIN of -d. */
1802 && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
1803 /* Try harder, since this may have been a sighandler, thus
1804 * curstash may be meaningless. */
1805 && (SvTYPE(sv) != SVt_PVCV || CvSTASH((CV*)sv) != PL_debstash)
1806 && !(flags & G_NODEBUG))
1807 PL_op->op_private |= OPpENTERSUB_DB;
1809 if (flags & G_METHOD) {
1810 Zero(&method_op, 1, UNOP);
1811 method_op.op_next = PL_op;
1812 method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
1813 myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
1814 PL_op = (OP*)&method_op;
1817 if (!(flags & G_EVAL)) {
1819 call_body((OP*)&myop, FALSE);
1820 retval = PL_stack_sp - (PL_stack_base + oldmark);
1821 CATCH_SET(oldcatch);
1824 myop.op_other = (OP*)&myop;
1826 /* we're trying to emulate pp_entertry() here */
1828 register PERL_CONTEXT *cx;
1829 I32 gimme = GIMME_V;
1834 push_return(Nullop);
1835 PUSHBLOCK(cx, (CXt_EVAL|CXp_TRYBLOCK), PL_stack_sp);
1837 PL_eval_root = PL_op; /* Only needed so that goto works right. */
1839 PL_in_eval = EVAL_INEVAL;
1840 if (flags & G_KEEPERR)
1841 PL_in_eval |= EVAL_KEEPERR;
1847 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1849 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
1856 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1858 call_body((OP*)&myop, FALSE);
1860 retval = PL_stack_sp - (PL_stack_base + oldmark);
1861 if (!(flags & G_KEEPERR))
1868 /* my_exit() was called */
1869 PL_curstash = PL_defstash;
1872 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
1873 Perl_croak(aTHX_ "Callback called exit");
1878 PL_op = PL_restartop;
1882 PL_stack_sp = PL_stack_base + oldmark;
1883 if (flags & G_ARRAY)
1887 *++PL_stack_sp = &PL_sv_undef;
1892 if (PL_scopestack_ix > oldscope) {
1896 register PERL_CONTEXT *cx;
1908 if (flags & G_DISCARD) {
1909 PL_stack_sp = PL_stack_base + oldmark;
1918 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1920 S_vcall_body(pTHX_ va_list args)
1922 OP *myop = va_arg(args, OP*);
1923 int is_eval = va_arg(args, int);
1925 call_body(myop, is_eval);
1931 S_call_body(pTHX_ OP *myop, int is_eval)
1933 if (PL_op == myop) {
1935 PL_op = Perl_pp_entereval(aTHX); /* this doesn't do a POPMARK */
1937 PL_op = Perl_pp_entersub(aTHX); /* this does */
1943 /* Eval a string. The G_EVAL flag is always assumed. */
1946 =for apidoc p||eval_sv
1948 Tells Perl to C<eval> the string in the SV.
1954 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
1956 /* See G_* flags in cop.h */
1959 UNOP myop; /* fake syntax tree node */
1960 volatile I32 oldmark = SP - PL_stack_base;
1961 volatile I32 retval = 0;
1967 if (flags & G_DISCARD) {
1974 Zero(PL_op, 1, UNOP);
1975 EXTEND(PL_stack_sp, 1);
1976 *++PL_stack_sp = sv;
1977 oldscope = PL_scopestack_ix;
1979 if (!(flags & G_NOARGS))
1980 myop.op_flags = OPf_STACKED;
1981 myop.op_next = Nullop;
1982 myop.op_type = OP_ENTEREVAL;
1983 myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1984 (flags & G_ARRAY) ? OPf_WANT_LIST :
1986 if (flags & G_KEEPERR)
1987 myop.op_flags |= OPf_SPECIAL;
1989 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1991 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
1998 #ifndef PERL_FLEXIBLE_EXCEPTIONS
2000 call_body((OP*)&myop,TRUE);
2002 retval = PL_stack_sp - (PL_stack_base + oldmark);
2003 if (!(flags & G_KEEPERR))
2010 /* my_exit() was called */
2011 PL_curstash = PL_defstash;
2014 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
2015 Perl_croak(aTHX_ "Callback called exit");
2020 PL_op = PL_restartop;
2024 PL_stack_sp = PL_stack_base + oldmark;
2025 if (flags & G_ARRAY)
2029 *++PL_stack_sp = &PL_sv_undef;
2035 if (flags & G_DISCARD) {
2036 PL_stack_sp = PL_stack_base + oldmark;
2046 =for apidoc p||eval_pv
2048 Tells Perl to C<eval> the given string and return an SV* result.
2054 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
2057 SV* sv = newSVpv(p, 0);
2059 eval_sv(sv, G_SCALAR);
2066 if (croak_on_error && SvTRUE(ERRSV)) {
2068 Perl_croak(aTHX_ SvPVx(ERRSV, n_a));
2074 /* Require a module. */
2077 =head1 Embedding Functions
2079 =for apidoc p||require_pv
2081 Tells Perl to C<require> the file named by the string argument. It is
2082 analogous to the Perl code C<eval "require '$file'">. It's even
2083 implemented that way; consider using load_module instead.
2088 Perl_require_pv(pTHX_ const char *pv)
2092 PUSHSTACKi(PERLSI_REQUIRE);
2094 sv = sv_newmortal();
2095 sv_setpv(sv, "require '");
2098 eval_sv(sv, G_DISCARD);
2104 Perl_magicname(pTHX_ char *sym, char *name, I32 namlen)
2108 if ((gv = gv_fetchpv(sym,TRUE, SVt_PV)))
2109 sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, namlen);
2113 S_usage(pTHX_ char *name) /* XXX move this out into a module ? */
2115 /* This message really ought to be max 23 lines.
2116 * Removed -h because the user already knows that option. Others? */
2118 static char *usage_msg[] = {
2119 "-0[octal] specify record separator (\\0, if no argument)",
2120 "-a autosplit mode with -n or -p (splits $_ into @F)",
2121 "-C enable native wide character system interfaces",
2122 "-c check syntax only (runs BEGIN and CHECK blocks)",
2123 "-d[:debugger] run program under debugger",
2124 "-D[number/list] set debugging flags (argument is a bit mask or alphabets)",
2125 "-e 'command' one line of program (several -e's allowed, omit programfile)",
2126 "-F/pattern/ split() pattern for -a switch (//'s are optional)",
2127 "-i[extension] edit <> files in place (makes backup if extension supplied)",
2128 "-Idirectory specify @INC/#include directory (several -I's allowed)",
2129 "-l[octal] enable line ending processing, specifies line terminator",
2130 "-[mM][-]module execute `use/no module...' before executing program",
2131 "-n assume 'while (<>) { ... }' loop around program",
2132 "-p assume loop like -n but print line also, like sed",
2133 "-P run program through C preprocessor before compilation",
2134 "-s enable rudimentary parsing for switches after programfile",
2135 "-S look for programfile using PATH environment variable",
2136 "-T enable tainting checks",
2137 "-t enable tainting warnings",
2138 "-u dump core after parsing program",
2139 "-U allow unsafe operations",
2140 "-v print version, subversion (includes VERY IMPORTANT perl info)",
2141 "-V[:variable] print configuration summary (or a single Config.pm variable)",
2142 "-w enable many useful warnings (RECOMMENDED)",
2143 "-W enable all warnings",
2144 "-X disable all warnings",
2145 "-x[directory] strip off text before #!perl line and perhaps cd to directory",
2149 char **p = usage_msg;
2151 PerlIO_printf(PerlIO_stdout(),
2152 "\nUsage: %s [switches] [--] [programfile] [arguments]",
2155 PerlIO_printf(PerlIO_stdout(), "\n %s", *p++);
2158 /* This routine handles any switches that can be given during run */
2161 Perl_moreswitches(pTHX_ char *s)
2171 rschar = (U32)grok_oct(s, &numlen, &flags, NULL);
2172 SvREFCNT_dec(PL_rs);
2173 if (rschar & ~((U8)~0))
2174 PL_rs = &PL_sv_undef;
2175 else if (!rschar && numlen >= 2)
2176 PL_rs = newSVpvn("", 0);
2178 char ch = (char)rschar;
2179 PL_rs = newSVpvn(&ch, 1);
2185 PL_unicode = parse_unicode_opts(&s);
2190 while (*s && !isSPACE(*s)) ++s;
2192 PL_splitstr = savepv(PL_splitstr);
2205 /* The following permits -d:Mod to accepts arguments following an =
2206 in the fashion that -MSome::Mod does. */
2207 if (*s == ':' || *s == '=') {
2210 sv = newSVpv("use Devel::", 0);
2212 /* We now allow -d:Module=Foo,Bar */
2213 while(isALNUM(*s) || *s==':') ++s;
2215 sv_catpv(sv, start);
2217 sv_catpvn(sv, start, s-start);
2218 sv_catpv(sv, " split(/,/,q{");
2223 my_setenv("PERL5DB", SvPV(sv, PL_na));
2226 PL_perldb = PERLDB_ALL;
2234 if (isALPHA(s[1])) {
2235 /* if adding extra options, remember to update DEBUG_MASK */
2236 static char debopts[] = "psltocPmfrxu HXDSTRJvC";
2239 for (s++; *s && (d = strchr(debopts,*s)); s++)
2240 PL_debug |= 1 << (d - debopts);
2243 PL_debug = atoi(s+1);
2244 for (s++; isDIGIT(*s); s++) ;
2247 if (DEBUG_p_TEST_ && ckWARN_d(WARN_DEBUGGING))
2248 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2249 "-Dp not implemented on this platform\n");
2251 PL_debug |= DEBUG_TOP_FLAG;
2252 #else /* !DEBUGGING */
2253 if (ckWARN_d(WARN_DEBUGGING))
2254 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
2255 "Recompile perl with -DDEBUGGING to use -D switch\n");
2256 for (s++; isALNUM(*s); s++) ;
2262 usage(PL_origargv[0]);
2266 Safefree(PL_inplace);
2267 #if defined(__CYGWIN__) /* do backup extension automagically */
2268 if (*(s+1) == '\0') {
2269 PL_inplace = savepv(".bak");
2272 #endif /* __CYGWIN__ */
2273 PL_inplace = savepv(s+1);
2275 for (s = PL_inplace; *s && !isSPACE(*s); s++) ;
2278 if (*s == '-') /* Additional switches on #! line. */
2282 case 'I': /* -I handled both here and in parse_body() */
2285 while (*s && isSPACE(*s))
2290 /* ignore trailing spaces (possibly followed by other switches) */
2292 for (e = p; *e && !isSPACE(*e); e++) ;
2296 } while (*p && *p != '-');
2297 e = savepvn(s, e-s);
2298 incpush(e, TRUE, TRUE, FALSE);
2305 Perl_croak(aTHX_ "No directory specified for -I");
2311 SvREFCNT_dec(PL_ors_sv);
2316 PL_ors_sv = newSVpvn("\n",1);
2317 numlen = 3 + (*s == '0');
2318 *SvPVX(PL_ors_sv) = (char)grok_oct(s, &numlen, &flags, NULL);
2322 if (RsPARA(PL_rs)) {
2323 PL_ors_sv = newSVpvn("\n\n",2);
2326 PL_ors_sv = newSVsv(PL_rs);
2333 PL_preambleav = newAV();
2335 SV *sv = newSVpvn("use assertions::activate split(/,/,q{",37);
2339 av_push(PL_preambleav, sv);
2342 av_push(PL_preambleav, newSVpvn("use assertions::activate",24));
2345 forbid_setid("-M"); /* XXX ? */
2348 forbid_setid("-m"); /* XXX ? */
2353 /* -M-foo == 'no foo' */
2354 if (*s == '-') { use = "no "; ++s; }
2355 sv = newSVpv(use,0);
2357 /* We allow -M'Module qw(Foo Bar)' */
2358 while(isALNUM(*s) || *s==':') ++s;
2360 sv_catpv(sv, start);
2361 if (*(start-1) == 'm') {
2363 Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
2364 sv_catpv( sv, " ()");
2368 Perl_croak(aTHX_ "Module name required with -%c option",
2370 sv_catpvn(sv, start, s-start);
2371 sv_catpv(sv, " split(/,/,q{");
2377 PL_preambleav = newAV();
2378 av_push(PL_preambleav, sv);
2381 Perl_croak(aTHX_ "No space allowed after -%c", *(s-1));
2393 PL_doswitches = TRUE;
2398 Perl_croak(aTHX_ "Too late for \"-t\" option");
2403 Perl_croak(aTHX_ "Too late for \"-T\" option");
2407 #ifdef MACOS_TRADITIONAL
2408 Perl_croak(aTHX_ "Believe me, you don't want to use \"-u\" on a Macintosh");
2410 PL_do_undump = TRUE;
2419 PerlIO_printf(PerlIO_stdout(),
2420 Perl_form(aTHX_ "\nThis is perl, v%"VDf" built for %s",
2421 PL_patchlevel, ARCHNAME));
2423 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
2424 PerlIO_printf(PerlIO_stdout(),
2425 Perl_form(aTHX_ "\nThis is perl, version %vd\n", PL_patchlevel));
2426 PerlIO_printf(PerlIO_stdout(),
2427 Perl_form(aTHX_ " built under %s at %s %s\n",
2428 OSNAME, __DATE__, __TIME__));
2429 PerlIO_printf(PerlIO_stdout(),
2430 Perl_form(aTHX_ " OS Specific Release: %s\n",
2434 #if defined(LOCAL_PATCH_COUNT)
2435 if (LOCAL_PATCH_COUNT > 0)
2436 PerlIO_printf(PerlIO_stdout(),
2437 "\n(with %d registered patch%s, "
2438 "see perl -V for more detail)",
2439 (int)LOCAL_PATCH_COUNT,
2440 (LOCAL_PATCH_COUNT!=1) ? "es" : "");
2443 PerlIO_printf(PerlIO_stdout(),
2444 "\n\nCopyright 1987-2003, Larry Wall\n");
2445 #ifdef MACOS_TRADITIONAL
2446 PerlIO_printf(PerlIO_stdout(),
2447 "\nMac OS port Copyright 1991-2002, Matthias Neeracher;\n"
2448 "maintained by Chris Nandor\n");
2451 PerlIO_printf(PerlIO_stdout(),
2452 "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
2455 PerlIO_printf(PerlIO_stdout(),
2456 "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
2457 "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
2460 PerlIO_printf(PerlIO_stdout(),
2461 "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
2462 "Version 5 port Copyright (c) 1994-2002, Andreas Kaiser, Ilya Zakharevich\n");
2465 PerlIO_printf(PerlIO_stdout(),
2466 "atariST series port, ++jrb bammi@cadence.com\n");
2469 PerlIO_printf(PerlIO_stdout(),
2470 "BeOS port Copyright Tom Spindler, 1997-1999\n");
2473 PerlIO_printf(PerlIO_stdout(),
2474 "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2002\n");
2477 PerlIO_printf(PerlIO_stdout(),
2478 "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
2481 PerlIO_printf(PerlIO_stdout(),
2482 "Stratus VOS port by Paul.Green@stratus.com, 1997-2002\n");
2485 PerlIO_printf(PerlIO_stdout(),
2486 "VM/ESA port by Neale Ferguson, 1998-1999\n");
2489 PerlIO_printf(PerlIO_stdout(),
2490 "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
2493 PerlIO_printf(PerlIO_stdout(),
2494 "MiNT port by Guido Flohr, 1997-1999\n");
2497 PerlIO_printf(PerlIO_stdout(),
2498 "EPOC port by Olaf Flebbe, 1999-2002\n");
2501 PerlIO_printf(PerlIO_stdout(),"WINCE port by Rainer Keuchel, 2001-2002\n");
2502 PerlIO_printf(PerlIO_stdout(),"Built on " __DATE__ " " __TIME__ "\n\n");
2505 #ifdef BINARY_BUILD_NOTICE
2506 BINARY_BUILD_NOTICE;
2508 PerlIO_printf(PerlIO_stdout(),
2510 Perl may be copied only under the terms of either the Artistic License or the\n\
2511 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
2512 Complete documentation for Perl, including FAQ lists, should be found on\n\
2513 this system using `man perl' or `perldoc perl'. If you have access to the\n\
2514 Internet, point your browser at http://www.perl.com/, the Perl Home Page.\n\n");
2517 if (! (PL_dowarn & G_WARN_ALL_MASK))
2518 PL_dowarn |= G_WARN_ON;
2522 PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
2523 if (!specialWARN(PL_compiling.cop_warnings))
2524 SvREFCNT_dec(PL_compiling.cop_warnings);
2525 PL_compiling.cop_warnings = pWARN_ALL ;
2529 PL_dowarn = G_WARN_ALL_OFF;
2530 if (!specialWARN(PL_compiling.cop_warnings))
2531 SvREFCNT_dec(PL_compiling.cop_warnings);
2532 PL_compiling.cop_warnings = pWARN_NONE ;
2537 if (s[1] == '-') /* Additional switches on #! line. */
2542 #if defined(WIN32) || !defined(PERL_STRICT_CR)
2548 #ifdef ALTERNATE_SHEBANG
2549 case 'S': /* OS/2 needs -S on "extproc" line. */
2557 Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
2562 /* compliments of Tom Christiansen */
2564 /* unexec() can be found in the Gnu emacs distribution */
2565 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
2568 Perl_my_unexec(pTHX)
2576 prog = newSVpv(BIN_EXP, 0);
2577 sv_catpv(prog, "/perl");
2578 file = newSVpv(PL_origfilename, 0);
2579 sv_catpv(file, ".perldump");
2581 unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
2582 /* unexec prints msg to stderr in case of failure */
2583 PerlProc_exit(status);
2586 # include <lib$routines.h>
2587 lib$signal(SS$_DEBUG); /* ssdef.h #included from vmsish.h */
2589 ABORT(); /* for use with undump */
2594 /* initialize curinterp */
2600 # define PERLVAR(var,type)
2601 # define PERLVARA(var,n,type)
2602 # if defined(PERL_IMPLICIT_CONTEXT)
2603 # if defined(USE_5005THREADS)
2604 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2605 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2606 # else /* !USE_5005THREADS */
2607 # define PERLVARI(var,type,init) aTHX->var = init;
2608 # define PERLVARIC(var,type,init) aTHX->var = init;
2609 # endif /* USE_5005THREADS */
2611 # define PERLVARI(var,type,init) PERL_GET_INTERP->var = init;
2612 # define PERLVARIC(var,type,init) PERL_GET_INTERP->var = init;
2614 # include "intrpvar.h"
2615 # ifndef USE_5005THREADS
2616 # include "thrdvar.h"
2623 # define PERLVAR(var,type)
2624 # define PERLVARA(var,n,type)
2625 # define PERLVARI(var,type,init) PL_##var = init;
2626 # define PERLVARIC(var,type,init) PL_##var = init;
2627 # include "intrpvar.h"
2628 # ifndef USE_5005THREADS
2629 # include "thrdvar.h"
2640 S_init_main_stash(pTHX)
2644 PL_curstash = PL_defstash = newHV();
2645 PL_curstname = newSVpvn("main",4);
2646 gv = gv_fetchpv("main::",TRUE, SVt_PVHV);
2647 SvREFCNT_dec(GvHV(gv));
2648 GvHV(gv) = (HV*)SvREFCNT_inc(PL_defstash);
2650 HvNAME(PL_defstash) = savepv("main");
2651 PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpv("INC",TRUE, SVt_PVAV)));
2652 GvMULTI_on(PL_incgv);
2653 PL_hintgv = gv_fetchpv("\010",TRUE, SVt_PV); /* ^H */
2654 GvMULTI_on(PL_hintgv);
2655 PL_defgv = gv_fetchpv("_",TRUE, SVt_PVAV);
2656 PL_errgv = gv_HVadd(gv_fetchpv("@", TRUE, SVt_PV));
2657 GvMULTI_on(PL_errgv);
2658 PL_replgv = gv_fetchpv("\022", TRUE, SVt_PV); /* ^R */
2659 GvMULTI_on(PL_replgv);
2660 (void)Perl_form(aTHX_ "%240s",""); /* Preallocate temp - for immediate signals. */
2661 sv_grow(ERRSV, 240); /* Preallocate - for immediate signals. */
2662 sv_setpvn(ERRSV, "", 0);
2663 PL_curstash = PL_defstash;
2664 CopSTASH_set(&PL_compiling, PL_defstash);
2665 PL_debstash = GvHV(gv_fetchpv("DB::", GV_ADDMULTI, SVt_PVHV));
2666 PL_globalstash = GvHV(gv_fetchpv("CORE::GLOBAL::", GV_ADDMULTI, SVt_PVHV));
2667 /* We must init $/ before switches are processed. */
2668 sv_setpvn(get_sv("/", TRUE), "\n", 1);
2672 S_open_script(pTHX_ char *scriptname, bool dosearch, SV *sv, int *fdscript)
2676 char *cpp_discard_flag;
2682 PL_origfilename = savepv("-e");
2685 /* if find_script() returns, it returns a malloc()-ed value */
2686 PL_origfilename = scriptname = find_script(scriptname, dosearch, NULL, 1);
2688 if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
2689 char *s = scriptname + 8;
2690 *fdscript = atoi(s);
2694 scriptname = savepv(s + 1);
2695 Safefree(PL_origfilename);
2696 PL_origfilename = scriptname;
2701 CopFILE_free(PL_curcop);
2702 CopFILE_set(PL_curcop, PL_origfilename);
2703 if (strEQ(PL_origfilename,"-"))
2705 if (*fdscript >= 0) {
2706 PL_rsfp = PerlIO_fdopen(*fdscript,PERL_SCRIPT_MODE);
2707 # if defined(HAS_FCNTL) && defined(F_SETFD)
2709 /* ensure close-on-exec */
2710 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2713 else if (PL_preprocess) {
2714 char *cpp_cfg = CPPSTDIN;
2715 SV *cpp = newSVpvn("",0);
2716 SV *cmd = NEWSV(0,0);
2718 if (strEQ(cpp_cfg, "cppstdin"))
2719 Perl_sv_catpvf(aTHX_ cpp, "%s/", BIN_EXP);
2720 sv_catpv(cpp, cpp_cfg);
2723 sv_catpvn(sv, "-I", 2);
2724 sv_catpv(sv,PRIVLIB_EXP);
2727 DEBUG_P(PerlIO_printf(Perl_debug_log,
2728 "PL_preprocess: scriptname=\"%s\", cpp=\"%s\", sv=\"%s\", CPPMINUS=\"%s\"\n",
2729 scriptname, SvPVX (cpp), SvPVX (sv), CPPMINUS));
2731 # if defined(MSDOS) || defined(WIN32) || defined(VMS)
2738 cpp_discard_flag = "";
2740 cpp_discard_flag = "-C";
2744 perl = os2_execname(aTHX);
2746 perl = PL_origargv[0];
2750 /* This strips off Perl comments which might interfere with
2751 the C pre-processor, including #!. #line directives are
2752 deliberately stripped to avoid confusion with Perl's version
2753 of #line. FWP played some golf with it so it will fit
2754 into VMS's 255 character buffer.
2757 code = "(1../^#!.*perl/i)|/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2759 code = "/^\\s*#(?!\\s*((ifn?|un)def|(el|end)?if|define|include|else|error|pragma)\\b)/||!($|=1)||print";
2761 Perl_sv_setpvf(aTHX_ cmd, "\
2762 %s -ne%s%s%s %s | %"SVf" %s %"SVf" %s",
2763 perl, quote, code, quote, scriptname, cpp,
2764 cpp_discard_flag, sv, CPPMINUS);
2766 PL_doextract = FALSE;
2767 # ifdef IAMSUID /* actually, this is caught earlier */
2768 if (PL_euid != PL_uid && !PL_euid) { /* if running suidperl */
2770 (void)seteuid(PL_uid); /* musn't stay setuid root */
2772 # ifdef HAS_SETREUID
2773 (void)setreuid((Uid_t)-1, PL_uid);
2775 # ifdef HAS_SETRESUID
2776 (void)setresuid((Uid_t)-1, PL_uid, (Uid_t)-1);
2778 PerlProc_setuid(PL_uid);
2782 if (PerlProc_geteuid() != PL_uid)
2783 Perl_croak(aTHX_ "Can't do seteuid!\n");
2785 # endif /* IAMSUID */
2787 DEBUG_P(PerlIO_printf(Perl_debug_log,
2788 "PL_preprocess: cmd=\"%s\"\n",
2791 PL_rsfp = PerlProc_popen(SvPVX(cmd), "r");
2795 else if (!*scriptname) {
2796 forbid_setid("program input from stdin");
2797 PL_rsfp = PerlIO_stdin();
2800 PL_rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
2801 # if defined(HAS_FCNTL) && defined(F_SETFD)
2803 /* ensure close-on-exec */
2804 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);
2809 # ifndef IAMSUID /* in case script is not readable before setuid */
2811 PerlLIO_stat(CopFILE(PL_curcop),&PL_statbuf) >= 0 &&
2812 PL_statbuf.st_mode & (S_ISUID|S_ISGID))
2815 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT,
2816 BIN_EXP, (int)PERL_REVISION,
2818 (int)PERL_SUBVERSION), PL_origargv);
2819 Perl_croak(aTHX_ "Can't do setuid\n");
2825 Perl_croak(aTHX_ "Can't open perl script: %s\n",
2828 Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
2829 CopFILE(PL_curcop), Strerror(errno));
2835 * I_SYSSTATVFS HAS_FSTATVFS
2837 * I_STATFS HAS_FSTATFS HAS_GETFSSTAT
2838 * I_MNTENT HAS_GETMNTENT HAS_HASMNTOPT
2839 * here so that metaconfig picks them up. */
2843 S_fd_on_nosuid_fs(pTHX_ int fd)
2845 int check_okay = 0; /* able to do all the required sys/libcalls */
2846 int on_nosuid = 0; /* the fd is on a nosuid fs */
2848 * Preferred order: fstatvfs(), fstatfs(), ustat()+getmnt(), getmntent().
2849 * fstatvfs() is UNIX98.
2850 * fstatfs() is 4.3 BSD.
2851 * ustat()+getmnt() is pre-4.3 BSD.
2852 * getmntent() is O(number-of-mounted-filesystems) and can hang on
2853 * an irrelevant filesystem while trying to reach the right one.
2856 #undef FD_ON_NOSUID_CHECK_OKAY /* found the syscalls to do the check? */
2858 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2859 defined(HAS_FSTATVFS)
2860 # define FD_ON_NOSUID_CHECK_OKAY
2861 struct statvfs stfs;
2863 check_okay = fstatvfs(fd, &stfs) == 0;
2864 on_nosuid = check_okay && (stfs.f_flag & ST_NOSUID);
2865 # endif /* fstatvfs */
2867 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2868 defined(PERL_MOUNT_NOSUID) && \
2869 defined(HAS_FSTATFS) && \
2870 defined(HAS_STRUCT_STATFS) && \
2871 defined(HAS_STRUCT_STATFS_F_FLAGS)
2872 # define FD_ON_NOSUID_CHECK_OKAY
2875 check_okay = fstatfs(fd, &stfs) == 0;
2876 on_nosuid = check_okay && (stfs.f_flags & PERL_MOUNT_NOSUID);
2877 # endif /* fstatfs */
2879 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2880 defined(PERL_MOUNT_NOSUID) && \
2881 defined(HAS_FSTAT) && \
2882 defined(HAS_USTAT) && \
2883 defined(HAS_GETMNT) && \
2884 defined(HAS_STRUCT_FS_DATA) && \
2886 # define FD_ON_NOSUID_CHECK_OKAY
2889 if (fstat(fd, &fdst) == 0) {
2891 if (ustat(fdst.st_dev, &us) == 0) {
2893 /* NOSTAT_ONE here because we're not examining fields which
2894 * vary between that case and STAT_ONE. */
2895 if (getmnt((int*)0, &fsd, (int)0, NOSTAT_ONE, us.f_fname) == 0) {
2896 size_t cmplen = sizeof(us.f_fname);
2897 if (sizeof(fsd.fd_req.path) < cmplen)
2898 cmplen = sizeof(fsd.fd_req.path);
2899 if (strnEQ(fsd.fd_req.path, us.f_fname, cmplen) &&
2900 fdst.st_dev == fsd.fd_req.dev) {
2902 on_nosuid = fsd.fd_req.flags & PERL_MOUNT_NOSUID;
2908 # endif /* fstat+ustat+getmnt */
2910 # if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2911 defined(HAS_GETMNTENT) && \
2912 defined(HAS_HASMNTOPT) && \
2913 defined(MNTOPT_NOSUID)
2914 # define FD_ON_NOSUID_CHECK_OKAY
2915 FILE *mtab = fopen("/etc/mtab", "r");
2916 struct mntent *entry;
2919 if (mtab && (fstat(fd, &stb) == 0)) {
2920 while (entry = getmntent(mtab)) {
2921 if (stat(entry->mnt_dir, &fsb) == 0
2922 && fsb.st_dev == stb.st_dev)
2924 /* found the filesystem */
2926 if (hasmntopt(entry, MNTOPT_NOSUID))
2929 } /* A single fs may well fail its stat(). */
2934 # endif /* getmntent+hasmntopt */
2937 Perl_croak(aTHX_ "Can't check filesystem of script \"%s\" for nosuid", PL_origfilename);
2940 #endif /* IAMSUID */
2943 S_validate_suid(pTHX_ char *validarg, char *scriptname, int fdscript)
2949 /* do we need to emulate setuid on scripts? */
2951 /* This code is for those BSD systems that have setuid #! scripts disabled
2952 * in the kernel because of a security problem. Merely defining DOSUID
2953 * in perl will not fix that problem, but if you have disabled setuid
2954 * scripts in the kernel, this will attempt to emulate setuid and setgid
2955 * on scripts that have those now-otherwise-useless bits set. The setuid
2956 * root version must be called suidperl or sperlN.NNN. If regular perl
2957 * discovers that it has opened a setuid script, it calls suidperl with
2958 * the same argv that it had. If suidperl finds that the script it has
2959 * just opened is NOT setuid root, it sets the effective uid back to the
2960 * uid. We don't just make perl setuid root because that loses the
2961 * effective uid we had before invoking perl, if it was different from the
2964 * DOSUID must be defined in both perl and suidperl, and IAMSUID must
2965 * be defined in suidperl only. suidperl must be setuid root. The
2966 * Configure script will set this up for you if you want it.
2972 if (PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf) < 0) /* normal stat is insecure */
2973 Perl_croak(aTHX_ "Can't stat script \"%s\"",PL_origfilename);
2974 if (fdscript < 0 && PL_statbuf.st_mode & (S_ISUID|S_ISGID)) {
2979 #ifndef HAS_SETREUID
2980 /* On this access check to make sure the directories are readable,
2981 * there is actually a small window that the user could use to make
2982 * filename point to an accessible directory. So there is a faint
2983 * chance that someone could execute a setuid script down in a
2984 * non-accessible directory. I don't know what to do about that.
2985 * But I don't think it's too important. The manual lies when
2986 * it says access() is useful in setuid programs.
2988 if (PerlLIO_access(CopFILE(PL_curcop),1)) /*double check*/
2989 Perl_croak(aTHX_ "Permission denied");
2991 /* If we can swap euid and uid, then we can determine access rights
2992 * with a simple stat of the file, and then compare device and
2993 * inode to make sure we did stat() on the same file we opened.
2994 * Then we just have to make sure he or she can execute it.
3001 setreuid(PL_euid,PL_uid) < 0
3004 setresuid(PL_euid,PL_uid,(Uid_t)-1) < 0
3007 || PerlProc_getuid() != PL_euid || PerlProc_geteuid() != PL_uid)
3008 Perl_croak(aTHX_ "Can't swap uid and euid"); /* really paranoid */
3009 if (PerlLIO_stat(CopFILE(PL_curcop),&tmpstatbuf) < 0)
3010 Perl_croak(aTHX_ "Permission denied"); /* testing full pathname here */
3011 #if defined(IAMSUID) && !defined(NO_NOSUID_CHECK)
3012 if (fd_on_nosuid_fs(PerlIO_fileno(PL_rsfp)))
3013 Perl_croak(aTHX_ "Permission denied");
3015 if (tmpstatbuf.st_dev != PL_statbuf.st_dev ||
3016 tmpstatbuf.st_ino != PL_statbuf.st_ino) {
3017 (void)PerlIO_close(PL_rsfp);
3018 Perl_croak(aTHX_ "Permission denied\n");
3022 setreuid(PL_uid,PL_euid) < 0
3024 # if defined(HAS_SETRESUID)
3025 setresuid(PL_uid,PL_euid,(Uid_t)-1) < 0
3028 || PerlProc_getuid() != PL_uid || PerlProc_geteuid() != PL_euid)
3029 Perl_croak(aTHX_ "Can't reswap uid and euid");
3030 if (!cando(S_IXUSR,FALSE,&PL_statbuf)) /* can real uid exec? */
3031 Perl_croak(aTHX_ "Permission denied\n");
3033 #endif /* HAS_SETREUID */
3034 #endif /* IAMSUID */
3036 if (!S_ISREG(PL_statbuf.st_mode))
3037 Perl_croak(aTHX_ "Permission denied");
3038 if (PL_statbuf.st_mode & S_IWOTH)
3039 Perl_croak(aTHX_ "Setuid/gid script is writable by world");
3040 PL_doswitches = FALSE; /* -s is insecure in suid */
3041 CopLINE_inc(PL_curcop);
3042 if (sv_gets(PL_linestr, PL_rsfp, 0) == Nullch ||
3043 strnNE(SvPV(PL_linestr,n_a),"#!",2) ) /* required even on Sys V */
3044 Perl_croak(aTHX_ "No #! line");
3045 s = SvPV(PL_linestr,n_a)+2;
3047 while (!isSPACE(*s)) s++;
3048 for (s2 = s; (s2 > SvPV(PL_linestr,n_a)+2 &&
3049 (isDIGIT(s2[-1]) || strchr("._-", s2[-1]))); s2--) ;
3050 if (strnNE(s2-4,"perl",4) && strnNE(s-9,"perl",4)) /* sanity check */
3051 Perl_croak(aTHX_ "Not a perl script");
3052 while (*s == ' ' || *s == '\t') s++;
3054 * #! arg must be what we saw above. They can invoke it by
3055 * mentioning suidperl explicitly, but they may not add any strange
3056 * arguments beyond what #! says if they do invoke suidperl that way.
3058 len = strlen(validarg);
3059 if (strEQ(validarg," PHOOEY ") ||
3060 strnNE(s,validarg,len) || !isSPACE(s[len]))
3061 Perl_croak(aTHX_ "Args must match #! line");
3064 if (PL_euid != PL_uid && (PL_statbuf.st_mode & S_ISUID) &&
3065 PL_euid == PL_statbuf.st_uid)
3067 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3068 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3069 #endif /* IAMSUID */
3071 if (PL_euid) { /* oops, we're not the setuid root perl */
3072 (void)PerlIO_close(PL_rsfp);
3075 PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
3076 (int)PERL_REVISION, (int)PERL_VERSION,
3077 (int)PERL_SUBVERSION), PL_origargv);
3079 Perl_croak(aTHX_ "Can't do setuid\n");
3082 if (PL_statbuf.st_mode & S_ISGID && PL_statbuf.st_gid != PL_egid) {
3084 (void)setegid(PL_statbuf.st_gid);
3087 (void)setregid((Gid_t)-1,PL_statbuf.st_gid);
3089 #ifdef HAS_SETRESGID
3090 (void)setresgid((Gid_t)-1,PL_statbuf.st_gid,(Gid_t)-1);
3092 PerlProc_setgid(PL_statbuf.st_gid);
3096 if (PerlProc_getegid() != PL_statbuf.st_gid)
3097 Perl_croak(aTHX_ "Can't do setegid!\n");
3099 if (PL_statbuf.st_mode & S_ISUID) {
3100 if (PL_statbuf.st_uid != PL_euid)
3102 (void)seteuid(PL_statbuf.st_uid); /* all that for this */
3105 (void)setreuid((Uid_t)-1,PL_statbuf.st_uid);
3107 #ifdef HAS_SETRESUID
3108 (void)setresuid((Uid_t)-1,PL_statbuf.st_uid,(Uid_t)-1);
3110 PerlProc_setuid(PL_statbuf.st_uid);
3114 if (PerlProc_geteuid() != PL_statbuf.st_uid)
3115 Perl_croak(aTHX_ "Can't do seteuid!\n");
3117 else if (PL_uid) { /* oops, mustn't run as root */
3119 (void)seteuid((Uid_t)PL_uid);
3122 (void)setreuid((Uid_t)-1,(Uid_t)PL_uid);
3124 #ifdef HAS_SETRESUID
3125 (void)setresuid((Uid_t)-1,(Uid_t)PL_uid,(Uid_t)-1);
3127 PerlProc_setuid((Uid_t)PL_uid);
3131 if (PerlProc_geteuid() != PL_uid)
3132 Perl_croak(aTHX_ "Can't do seteuid!\n");
3135 if (!cando(S_IXUSR,TRUE,&PL_statbuf))
3136 Perl_croak(aTHX_ "Permission denied\n"); /* they can't do this */
3139 else if (PL_preprocess)
3140 Perl_croak(aTHX_ "-P not allowed for setuid/setgid script\n");
3141 else if (fdscript >= 0)
3142 Perl_croak(aTHX_ "fd script not allowed in suidperl\n");
3144 Perl_croak(aTHX_ "Script is not setuid/setgid in suidperl\n");
3146 /* We absolutely must clear out any saved ids here, so we */
3147 /* exec the real perl, substituting fd script for scriptname. */
3148 /* (We pass script name as "subdir" of fd, which perl will grok.) */
3149 PerlIO_rewind(PL_rsfp);
3150 PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0); /* just in case rewind didn't */
3151 for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;
3152 if (!PL_origargv[which])
3153 Perl_croak(aTHX_ "Permission denied");
3154 PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",
3155 PerlIO_fileno(PL_rsfp), PL_origargv[which]));
3156 #if defined(HAS_FCNTL) && defined(F_SETFD)
3157 fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0); /* ensure no close-on-exec */
3159 PerlProc_execv(Perl_form(aTHX_ "%s/perl"PERL_FS_VER_FMT, BIN_EXP,
3160 (int)PERL_REVISION, (int)PERL_VERSION,
3161 (int)PERL_SUBVERSION), PL_origargv);/* try again */
3162 Perl_croak(aTHX_ "Can't do setuid\n");
3163 #endif /* IAMSUID */
3165 if (PL_euid != PL_uid || PL_egid != PL_gid) { /* (suidperl doesn't exist, in fact) */
3166 #ifndef SETUID_SCRIPTS_ARE_SECURE_NOW
3167 PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf); /* may be either wrapped or real suid */
3168 if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3170 (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3173 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3174 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3175 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3176 /* not set-id, must be wrapped */
3182 S_find_beginning(pTHX)
3184 register char *s, *s2;
3185 #ifdef MACOS_TRADITIONAL
3189 /* skip forward in input to the real script? */
3192 #ifdef MACOS_TRADITIONAL
3193 /* Since the Mac OS does not honor #! arguments for us, we do it ourselves */
3195 while (PL_doextract || gMacPerl_AlwaysExtract) {
3196 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
3197 if (!gMacPerl_AlwaysExtract)
3198 Perl_croak(aTHX_ "No Perl script found in input\n");
3200 if (PL_doextract) /* require explicit override ? */
3201 if (!OverrideExtract(PL_origfilename))
3202 Perl_croak(aTHX_ "User aborted script\n");
3204 PL_doextract = FALSE;
3206 /* Pater peccavi, file does not have #! */
3207 PerlIO_rewind(PL_rsfp);
3212 while (PL_doextract) {
3213 if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch)
3214 Perl_croak(aTHX_ "No Perl script found in input\n");
3217 if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
3218 PerlIO_ungetc(PL_rsfp, '\n'); /* to keep line count right */
3219 PL_doextract = FALSE;
3220 while (*s && !(isSPACE (*s) || *s == '#')) s++;
3222 while (*s == ' ' || *s == '\t') s++;
3224 while (isDIGIT(s2[-1]) || strchr("-._", s2[-1])) s2--;
3225 if (strnEQ(s2-4,"perl",4))
3227 while ((s = moreswitches(s)))
3230 #ifdef MACOS_TRADITIONAL
3231 /* We are always searching for the #!perl line in MacPerl,
3232 * so if we find it, still keep the line count correct
3233 * by counting lines we already skipped over
3235 for (; maclines > 0 ; maclines--)
3236 PerlIO_ungetc(PL_rsfp, '\n');
3240 /* gMacPerl_AlwaysExtract is false in MPW tool */
3241 } else if (gMacPerl_AlwaysExtract) {
3252 PL_uid = PerlProc_getuid();
3253 PL_euid = PerlProc_geteuid();
3254 PL_gid = PerlProc_getgid();
3255 PL_egid = PerlProc_getegid();
3257 PL_uid |= PL_gid << 16;
3258 PL_euid |= PL_egid << 16;
3260 PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3264 S_forbid_setid(pTHX_ char *s)
3266 if (PL_euid != PL_uid)
3267 Perl_croak(aTHX_ "No %s allowed while running setuid", s);
3268 if (PL_egid != PL_gid)
3269 Perl_croak(aTHX_ "No %s allowed while running setgid", s);
3273 Perl_init_debugger(pTHX)
3275 HV *ostash = PL_curstash;
3277 PL_curstash = PL_debstash;
3278 PL_dbargs = GvAV(gv_AVadd((gv_fetchpv("args", GV_ADDMULTI, SVt_PVAV))));
3279 AvREAL_off(PL_dbargs);
3280 PL_DBgv = gv_fetchpv("DB", GV_ADDMULTI, SVt_PVGV);
3281 PL_DBline = gv_fetchpv("dbline", GV_ADDMULTI, SVt_PVAV);
3282 PL_DBsub = gv_HVadd(gv_fetchpv("sub", GV_ADDMULTI, SVt_PVHV));
3283 sv_upgrade(GvSV(PL_DBsub), SVt_IV); /* IVX accessed if PERLDB_SUB_NN */
3284 PL_DBsingle = GvSV((gv_fetchpv("single", GV_ADDMULTI, SVt_PV)));
3285 sv_setiv(PL_DBsingle, 0);
3286 PL_DBtrace = GvSV((gv_fetchpv("trace", GV_ADDMULTI, SVt_PV)));
3287 sv_setiv(PL_DBtrace, 0);
3288 PL_DBsignal = GvSV((gv_fetchpv("signal", GV_ADDMULTI, SVt_PV)));
3289 sv_setiv(PL_DBsignal, 0);
3290 PL_DBassertion = GvSV((gv_fetchpv("assertion", GV_ADDMULTI, SVt_PV)));
3291 sv_setiv(PL_DBassertion, 0);
3292 PL_curstash = ostash;
3295 #ifndef STRESS_REALLOC
3296 #define REASONABLE(size) (size)
3298 #define REASONABLE(size) (1) /* unreasonable */
3302 Perl_init_stacks(pTHX)
3304 /* start with 128-item stack and 8K cxstack */
3305 PL_curstackinfo = new_stackinfo(REASONABLE(128),
3306 REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
3307 PL_curstackinfo->si_type = PERLSI_MAIN;
3308 PL_curstack = PL_curstackinfo->si_stack;
3309 PL_mainstack = PL_curstack; /* remember in case we switch stacks */
3311 PL_stack_base = AvARRAY(PL_curstack);
3312 PL_stack_sp = PL_stack_base;
3313 PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
3315 New(50,PL_tmps_stack,REASONABLE(128),SV*);
3318 PL_tmps_max = REASONABLE(128);
3320 New(54,PL_markstack,REASONABLE(32),I32);
3321 PL_markstack_ptr = PL_markstack;
3322 PL_markstack_max = PL_markstack + REASONABLE(32);
3326 New(54,PL_scopestack,REASONABLE(32),I32);
3327 PL_scopestack_ix = 0;
3328 PL_scopestack_max = REASONABLE(32);
3330 New(54,PL_savestack,REASONABLE(128),ANY);
3331 PL_savestack_ix = 0;
3332 PL_savestack_max = REASONABLE(128);
3334 New(54,PL_retstack,REASONABLE(16),OP*);
3336 PL_retstack_max = REASONABLE(16);
3344 while (PL_curstackinfo->si_next)
3345 PL_curstackinfo = PL_curstackinfo->si_next;
3346 while (PL_curstackinfo) {
3347 PERL_SI *p = PL_curstackinfo->si_prev;
3348 /* curstackinfo->si_stack got nuked by sv_free_arenas() */
3349 Safefree(PL_curstackinfo->si_cxstack);
3350 Safefree(PL_curstackinfo);
3351 PL_curstackinfo = p;
3353 Safefree(PL_tmps_stack);
3354 Safefree(PL_markstack);
3355 Safefree(PL_scopestack);
3356 Safefree(PL_savestack);
3357 Safefree(PL_retstack);
3366 lex_start(PL_linestr);
3368 PL_subname = newSVpvn("main",4);
3372 S_init_predump_symbols(pTHX)
3377 sv_setpvn(get_sv("\"", TRUE), " ", 1);
3378 PL_stdingv = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
3379 GvMULTI_on(PL_stdingv);
3380 io = GvIOp(PL_stdingv);
3381 IoTYPE(io) = IoTYPE_RDONLY;
3382 IoIFP(io) = PerlIO_stdin();
3383 tmpgv = gv_fetchpv("stdin",TRUE, SVt_PV);
3385 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3387 tmpgv = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
3390 IoTYPE(io) = IoTYPE_WRONLY;
3391 IoOFP(io) = IoIFP(io) = PerlIO_stdout();
3393 tmpgv = gv_fetchpv("stdout",TRUE, SVt_PV);
3395 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3397 PL_stderrgv = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
3398 GvMULTI_on(PL_stderrgv);
3399 io = GvIOp(PL_stderrgv);
3400 IoTYPE(io) = IoTYPE_WRONLY;
3401 IoOFP(io) = IoIFP(io) = PerlIO_stderr();
3402 tmpgv = gv_fetchpv("stderr",TRUE, SVt_PV);
3404 GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3406 PL_statname = NEWSV(66,0); /* last filename we did stat on */
3409 Safefree(PL_osname);
3410 PL_osname = savepv(OSNAME);
3414 Perl_init_argv_symbols(pTHX_ register int argc, register char **argv)
3417 argc--,argv++; /* skip name of script */
3418 if (PL_doswitches) {
3419 for (; argc > 0 && **argv == '-'; argc--,argv++) {
3422 if (argv[0][1] == '-' && !argv[0][2]) {
3426 if ((s = strchr(argv[0], '='))) {
3428 sv_setpv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),s);
3431 sv_setiv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),1);
3434 if ((PL_argvgv = gv_fetchpv("ARGV",TRUE, SVt_PVAV))) {
3435 GvMULTI_on(PL_argvgv);
3436 (void)gv_AVadd(PL_argvgv);
3437 av_clear(GvAVn(PL_argvgv));
3438 for (; argc > 0; argc--,argv++) {
3439 SV *sv = newSVpv(argv[0],0);
3440 av_push(GvAVn(PL_argvgv),sv);
3441 if (!(PL_unicode & PERL_UNICODE_LOCALE_FLAG) || PL_utf8locale) {
3442 if (PL_unicode & PERL_UNICODE_ARGV_FLAG)
3445 if (PL_unicode & PERL_UNICODE_WIDESYSCALLS_FLAG) /* Sarathy? */
3446 (void)sv_utf8_decode(sv);
3451 #ifdef HAS_PROCSELFEXE
3452 /* This is a function so that we don't hold on to MAXPATHLEN
3453 bytes of stack longer than necessary
3456 S_procself_val(pTHX_ SV *sv, char *arg0)
3458 char buf[MAXPATHLEN];
3459 int len = readlink(PROCSELFEXE_PATH, buf, sizeof(buf) - 1);
3461 /* On Playstation2 Linux V1.0 (kernel 2.2.1) readlink(/proc/self/exe)
3462 includes a spurious NUL which will cause $^X to fail in system
3463 or backticks (this will prevent extensions from being built and
3464 many tests from working). readlink is not meant to add a NUL.
3465 Normal readlink works fine.
3467 if (len > 0 && buf[len-1] == '\0') {
3471 /* FreeBSD's implementation is acknowledged to be imperfect, sometimes
3472 returning the text "unknown" from the readlink rather than the path
3473 to the executable (or returning an error from the readlink). Any valid
3474 path has a '/' in it somewhere, so use that to validate the result.
3475 See http://www.freebsd.org/cgi/query-pr.cgi?pr=35703
3477 if (len > 0 && memchr(buf, '/', len)) {
3478 sv_setpvn(sv,buf,len);
3484 #endif /* HAS_PROCSELFEXE */
3487 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
3493 PL_toptarget = NEWSV(0,0);
3494 sv_upgrade(PL_toptarget, SVt_PVFM);
3495 sv_setpvn(PL_toptarget, "", 0);
3496 PL_bodytarget = NEWSV(0,0);
3497 sv_upgrade(PL_bodytarget, SVt_PVFM);
3498 sv_setpvn(PL_bodytarget, "", 0);
3499 PL_formtarget = PL_bodytarget;
3503 init_argv_symbols(argc,argv);
3505 if ((tmpgv = gv_fetchpv("0",TRUE, SVt_PV))) {
3506 #ifdef MACOS_TRADITIONAL
3507 /* $0 is not majick on a Mac */
3508 sv_setpv(GvSV(tmpgv),MacPerl_MPWFileName(PL_origfilename));
3510 sv_setpv(GvSV(tmpgv),PL_origfilename);
3511 magicname("0", "0", 1);
3514 if ((tmpgv = gv_fetchpv("\030",TRUE, SVt_PV))) {/* $^X */
3515 #ifdef HAS_PROCSELFEXE
3516 S_procself_val(aTHX_ GvSV(tmpgv), PL_origargv[0]);
3519 sv_setpv(GvSV(tmpgv), os2_execname(aTHX));
3521 sv_setpv(GvSV(tmpgv),PL_origargv[0]);
3525 if ((PL_envgv = gv_fetchpv("ENV",TRUE, SVt_PVHV))) {
3527 GvMULTI_on(PL_envgv);
3528 hv = GvHVn(PL_envgv);
3529 hv_magic(hv, Nullgv, PERL_MAGIC_env);
3530 #ifdef USE_ENVIRON_ARRAY
3531 /* Note that if the supplied env parameter is actually a copy
3532 of the global environ then it may now point to free'd memory
3533 if the environment has been modified since. To avoid this
3534 problem we treat env==NULL as meaning 'use the default'
3539 # ifdef USE_ITHREADS
3540 && PL_curinterp == aTHX
3544 environ[0] = Nullch;
3547 for (; *env; env++) {
3548 if (!(s = strchr(*env,'=')))
3555 sv = newSVpv(s+1, 0);
3556 (void)hv_store(hv, *env, s - *env, sv, 0);
3560 #endif /* USE_ENVIRON_ARRAY */
3563 if ((tmpgv = gv_fetchpv("$",TRUE, SVt_PV))) {
3564 SvREADONLY_off(GvSV(tmpgv));
3565 sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
3566 SvREADONLY_on(GvSV(tmpgv));
3568 #ifdef THREADS_HAVE_PIDS
3569 PL_ppid = (IV)getppid();
3572 /* touch @F array to prevent spurious warnings 20020415 MJD */
3574 (void) get_av("main::F", TRUE | GV_ADDMULTI);
3576 /* touch @- and @+ arrays to prevent spurious warnings 20020415 MJD */
3577 (void) get_av("main::-", TRUE | GV_ADDMULTI);
3578 (void) get_av("main::+", TRUE | GV_ADDMULTI);
3582 S_init_perllib(pTHX)
3587 s = PerlEnv_getenv("PERL5LIB");
3589 incpush(s, TRUE, TRUE, TRUE);
3591 incpush(PerlEnv_getenv("PERLLIB"), FALSE, FALSE, TRUE);
3593 /* Treat PERL5?LIB as a possible search list logical name -- the
3594 * "natural" VMS idiom for a Unix path string. We allow each
3595 * element to be a set of |-separated directories for compatibility.
3599 if (my_trnlnm("PERL5LIB",buf,0))
3600 do { incpush(buf,TRUE,TRUE,TRUE); } while (my_trnlnm("PERL5LIB",buf,++idx));
3602 while (my_trnlnm("PERLLIB",buf,idx++)) incpush(buf,FALSE,FALSE,TRUE);
3606 /* Use the ~-expanded versions of APPLLIB (undocumented),
3607 ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
3610 incpush(APPLLIB_EXP, TRUE, TRUE, TRUE);
3614 incpush(ARCHLIB_EXP, FALSE, FALSE, TRUE);
3616 #ifdef MACOS_TRADITIONAL
3619 SV * privdir = NEWSV(55, 0);
3620 char * macperl = PerlEnv_getenv("MACPERL");
3625 Perl_sv_setpvf(aTHX_ privdir, "%slib:", macperl);
3626 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3627 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3628 Perl_sv_setpvf(aTHX_ privdir, "%ssite_perl:", macperl);
3629 if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3630 incpush(SvPVX(privdir), TRUE, FALSE, TRUE);
3632 SvREFCNT_dec(privdir);
3635 incpush(":", FALSE, FALSE, TRUE);
3638 # define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
3641 incpush(PRIVLIB_EXP, TRUE, FALSE, TRUE);
3643 incpush(PRIVLIB_EXP, FALSE, FALSE, TRUE);
3647 /* sitearch is always relative to sitelib on Windows for
3648 * DLL-based path intuition to work correctly */
3649 # if !defined(WIN32)
3650 incpush(SITEARCH_EXP, FALSE, FALSE, TRUE);
3656 /* this picks up sitearch as well */
3657 incpush(SITELIB_EXP, TRUE, FALSE, TRUE);
3659 incpush(SITELIB_EXP, FALSE, FALSE, TRUE);
3663 #ifdef SITELIB_STEM /* Search for version-specific dirs below here */
3664 incpush(SITELIB_STEM, FALSE, TRUE, TRUE);
3667 #ifdef PERL_VENDORARCH_EXP
3668 /* vendorarch is always relative to vendorlib on Windows for
3669 * DLL-based path intuition to work correctly */
3670 # if !defined(WIN32)
3671 incpush(PERL_VENDORARCH_EXP, FALSE, FALSE, TRUE);
3675 #ifdef PERL_VENDORLIB_EXP
3677 incpush(PERL_VENDORLIB_EXP, TRUE, FALSE, TRUE); /* this picks up vendorarch as well */
3679 incpush(PERL_VENDORLIB_EXP, FALSE, FALSE, TRUE);
3683 #ifdef PERL_VENDORLIB_STEM /* Search for version-specific dirs below here */
3684 incpush(PERL_VENDORLIB_STEM, FALSE, TRUE, TRUE);
3687 #ifdef PERL_OTHERLIBDIRS
3688 incpush(PERL_OTHERLIBDIRS, TRUE, TRUE, TRUE);
3692 incpush(".", FALSE, FALSE, TRUE);
3693 #endif /* MACOS_TRADITIONAL */
3696 #if defined(DOSISH) || defined(EPOC)
3697 # define PERLLIB_SEP ';'
3700 # define PERLLIB_SEP '|'
3702 # if defined(MACOS_TRADITIONAL)
3703 # define PERLLIB_SEP ','
3705 # define PERLLIB_SEP ':'
3709 #ifndef PERLLIB_MANGLE
3710 # define PERLLIB_MANGLE(s,n) (s)
3714 S_incpush(pTHX_ char *p, int addsubdirs, int addoldvers, int usesep)
3716 SV *subdir = Nullsv;
3721 if (addsubdirs || addoldvers) {
3722 subdir = sv_newmortal();
3725 /* Break at all separators */
3727 SV *libdir = NEWSV(55,0);
3730 /* skip any consecutive separators */
3732 while ( *p == PERLLIB_SEP ) {
3733 /* Uncomment the next line for PATH semantics */
3734 /* av_push(GvAVn(PL_incgv), newSVpvn(".", 1)); */
3739 if ( usesep && (s = strchr(p, PERLLIB_SEP)) != Nullch ) {
3740 sv_setpvn(libdir, PERLLIB_MANGLE(p, (STRLEN)(s - p)),
3745 sv_setpv(libdir, PERLLIB_MANGLE(p, 0));
3746 p = Nullch; /* break out */
3748 #ifdef MACOS_TRADITIONAL
3749 if (!strchr(SvPVX(libdir), ':')) {
3752 sv_setpv(libdir, MacPerl_CanonDir(SvPVX(libdir), buf, 0));
3754 if (SvPVX(libdir)[SvCUR(libdir)-1] != ':')
3755 sv_catpv(libdir, ":");
3759 * BEFORE pushing libdir onto @INC we may first push version- and
3760 * archname-specific sub-directories.
3762 if (addsubdirs || addoldvers) {
3763 #ifdef PERL_INC_VERSION_LIST
3764 /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
3765 const char *incverlist[] = { PERL_INC_VERSION_LIST };
3766 const char **incver;
3773 if ((unix = tounixspec_ts(SvPV(libdir,len),Nullch)) != Nullch) {
3775 while (unix[len-1] == '/') len--; /* Cosmetic */
3776 sv_usepvn(libdir,unix,len);
3779 PerlIO_printf(Perl_error_log,
3780 "Failed to unixify @INC element \"%s\"\n",
3784 #ifdef MACOS_TRADITIONAL
3785 #define PERL_AV_SUFFIX_FMT ""
3786 #define PERL_ARCH_FMT "%s:"
3787 #define PERL_ARCH_FMT_PATH PERL_FS_VER_FMT PERL_AV_SUFFIX_FMT
3789 #define PERL_AV_SUFFIX_FMT "/"
3790 #define PERL_ARCH_FMT "/%s"
3791 #define PERL_ARCH_FMT_PATH PERL_AV_SUFFIX_FMT PERL_FS_VER_FMT
3793 /* .../version/archname if -d .../version/archname */
3794 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH PERL_ARCH_FMT,
3796 (int)PERL_REVISION, (int)PERL_VERSION,
3797 (int)PERL_SUBVERSION, ARCHNAME);
3798 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3799 S_ISDIR(tmpstatbuf.st_mode))
3800 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3802 /* .../version if -d .../version */
3803 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH, libdir,
3804 (int)PERL_REVISION, (int)PERL_VERSION,
3805 (int)PERL_SUBVERSION);
3806 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3807 S_ISDIR(tmpstatbuf.st_mode))
3808 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3810 /* .../archname if -d .../archname */
3811 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, ARCHNAME);
3812 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3813 S_ISDIR(tmpstatbuf.st_mode))
3814 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3817 #ifdef PERL_INC_VERSION_LIST
3819 for (incver = incverlist; *incver; incver++) {
3820 /* .../xxx if -d .../xxx */
3821 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, *incver);
3822 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3823 S_ISDIR(tmpstatbuf.st_mode))
3824 av_push(GvAVn(PL_incgv), newSVsv(subdir));
3830 /* finally push this lib directory on the end of @INC */
3831 av_push(GvAVn(PL_incgv), libdir);
3835 #ifdef USE_5005THREADS
3836 STATIC struct perl_thread *
3837 S_init_main_thread(pTHX)
3839 #if !defined(PERL_IMPLICIT_CONTEXT)
3840 struct perl_thread *thr;
3844 Newz(53, thr, 1, struct perl_thread);
3845 PL_curcop = &PL_compiling;
3846 thr->interp = PERL_GET_INTERP;
3847 thr->cvcache = newHV();
3848 thr->threadsv = newAV();
3849 /* thr->threadsvp is set when find_threadsv is called */
3850 thr->specific = newAV();
3851 thr->flags = THRf_R_JOINABLE;
3852 MUTEX_INIT(&thr->mutex);
3853 /* Handcraft thrsv similarly to mess_sv */
3854 New(53, PL_thrsv, 1, SV);
3855 Newz(53, xpv, 1, XPV);
3856 SvFLAGS(PL_thrsv) = SVt_PV;
3857 SvANY(PL_thrsv) = (void*)xpv;
3858 SvREFCNT(PL_thrsv) = 1 << 30; /* practically infinite */
3859 SvPVX(PL_thrsv) = (char*)thr;
3860 SvCUR_set(PL_thrsv, sizeof(thr));
3861 SvLEN_set(PL_thrsv, sizeof(thr));
3862 *SvEND(PL_thrsv) = '\0'; /* in the trailing_nul field */
3863 thr->oursv = PL_thrsv;
3864 PL_chopset = " \n-";
3867 MUTEX_LOCK(&PL_threads_mutex);
3873 MUTEX_UNLOCK(&PL_threads_mutex);
3875 #ifdef HAVE_THREAD_INTERN
3876 Perl_init_thread_intern(thr);
3879 #ifdef SET_THREAD_SELF
3880 SET_THREAD_SELF(thr);
3882 thr->self = pthread_self();
3883 #endif /* SET_THREAD_SELF */
3887 * These must come after the thread self setting
3888 * because sv_setpvn does SvTAINT and the taint
3889 * fields thread selfness being set.
3891 PL_toptarget = NEWSV(0,0);
3892 sv_upgrade(PL_toptarget, SVt_PVFM);
3893 sv_setpvn(PL_toptarget, "", 0);
3894 PL_bodytarget = NEWSV(0,0);
3895 sv_upgrade(PL_bodytarget, SVt_PVFM);
3896 sv_setpvn(PL_bodytarget, "", 0);
3897 PL_formtarget = PL_bodytarget;
3898 thr->errsv = newSVpvn("", 0);
3899 (void) find_threadsv("@"); /* Ensure $@ is initialised early */
3902 PL_peepp = MEMBER_TO_FPTR(Perl_peep);
3903 PL_regcompp = MEMBER_TO_FPTR(Perl_pregcomp);
3904 PL_regexecp = MEMBER_TO_FPTR(Perl_regexec_flags);
3905 PL_regint_start = MEMBER_TO_FPTR(Perl_re_intuit_start);
3906 PL_regint_string = MEMBER_TO_FPTR(Perl_re_intuit_string);
3907 PL_regfree = MEMBER_TO_FPTR(Perl_pregfree);
3909 PL_reginterp_cnt = 0;
3913 #endif /* USE_5005THREADS */
3916 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
3919 line_t oldline = CopLINE(PL_curcop);
3925 while (AvFILL(paramList) >= 0) {
3926 cv = (CV*)av_shift(paramList);
3928 if (paramList == PL_beginav) {
3929 /* save PL_beginav for compiler */
3930 if (! PL_beginav_save)
3931 PL_beginav_save = newAV();
3932 av_push(PL_beginav_save, (SV*)cv);
3934 else if (paramList == PL_checkav) {
3935 /* save PL_checkav for compiler */
3936 if (! PL_checkav_save)
3937 PL_checkav_save = newAV();
3938 av_push(PL_checkav_save, (SV*)cv);
3943 #ifdef PERL_FLEXIBLE_EXCEPTIONS
3944 CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_list_body), cv);
3950 #ifndef PERL_FLEXIBLE_EXCEPTIONS
3954 (void)SvPV(atsv, len);
3956 PL_curcop = &PL_compiling;
3957 CopLINE_set(PL_curcop, oldline);
3958 if (paramList == PL_beginav)
3959 sv_catpv(atsv, "BEGIN failed--compilation aborted");
3961 Perl_sv_catpvf(aTHX_ atsv,
3962 "%s failed--call queue aborted",
3963 paramList == PL_checkav ? "CHECK"
3964 : paramList == PL_initav ? "INIT"
3966 while (PL_scopestack_ix > oldscope)
3969 Perl_croak(aTHX_ "%"SVf"", atsv);
3976 /* my_exit() was called */
3977 while (PL_scopestack_ix > oldscope)
3980 PL_curstash = PL_defstash;
3981 PL_curcop = &PL_compiling;
3982 CopLINE_set(PL_curcop, oldline);
3984 if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
3985 if (paramList == PL_beginav)
3986 Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
3988 Perl_croak(aTHX_ "%s failed--call queue aborted",
3989 paramList == PL_checkav ? "CHECK"
3990 : paramList == PL_initav ? "INIT"
3997 PL_curcop = &PL_compiling;
3998 CopLINE_set(PL_curcop, oldline);
4001 PerlIO_printf(Perl_error_log, "panic: restartop\n");
4009 #ifdef PERL_FLEXIBLE_EXCEPTIONS
4011 S_vcall_list_body(pTHX_ va_list args)
4013 CV *cv = va_arg(args, CV*);
4014 return call_list_body(cv);
4019 S_call_list_body(pTHX_ CV *cv)
4021 PUSHMARK(PL_stack_sp);
4022 call_sv((SV*)cv, G_EVAL|G_DISCARD);
4027 Perl_my_exit(pTHX_ U32 status)
4029 DEBUG_S(PerlIO_printf(Perl_debug_log, "my_exit: thread %p, status %lu\n",
4030 thr, (unsigned long) status));
4039 STATUS_NATIVE_SET(status);
4046 Perl_my_failure_exit(pTHX)
4049 if (vaxc$errno & 1) {
4050 if (STATUS_NATIVE & 1) /* fortuitiously includes "-1" */
4051 STATUS_NATIVE_SET(44);
4054 if (!vaxc$errno && errno) /* unlikely */
4055 STATUS_NATIVE_SET(44);
4057 STATUS_NATIVE_SET(vaxc$errno);
4062 STATUS_POSIX_SET(errno);
4064 exitstatus = STATUS_POSIX >> 8;
4065 if (exitstatus & 255)
4066 STATUS_POSIX_SET(exitstatus);
4068 STATUS_POSIX_SET(255);
4075 S_my_exit_jump(pTHX)
4077 register PERL_CONTEXT *cx;
4082 SvREFCNT_dec(PL_e_script);
4083 PL_e_script = Nullsv;
4086 POPSTACK_TO(PL_mainstack);
4087 if (cxstack_ix >= 0) {
4090 POPBLOCK(cx,PL_curpm);
4098 read_e_script(pTHX_ int idx, SV *buf_sv, int maxlen)
4101 p = SvPVX(PL_e_script);
4102 nl = strchr(p, '\n');
4103 nl = (nl) ? nl+1 : SvEND(PL_e_script);
4105 filter_del(read_e_script);
4108 sv_catpvn(buf_sv, p, nl-p);
4109 sv_chop(PL_e_script, nl);