This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[ID 20010801.039] perlre.pod message typo
[perl5.git] / perl.c
1 /*    perl.c
2  *
3  *    Copyright (c) 1987-2001 Larry Wall
4  *
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.
7  *
8  */
9
10 /*
11  * "A ship then new they built for him/of mithril and of elven glass" --Bilbo
12  */
13
14 #include "EXTERN.h"
15 #define PERL_IN_PERL_C
16 #include "perl.h"
17 #include "patchlevel.h"                 /* for local_patches */
18
19 /* XXX If this causes problems, set i_unistd=undef in the hint file.  */
20 #ifdef I_UNISTD
21 #include <unistd.h>
22 #endif
23
24 #if !defined(STANDARD_C) && !defined(HAS_GETENV_PROTOTYPE)
25 char *getenv (char *); /* Usually in <stdlib.h> */
26 #endif
27
28 static I32 read_e_script(pTHXo_ int idx, SV *buf_sv, int maxlen);
29
30 #ifdef IAMSUID
31 #ifndef DOSUID
32 #define DOSUID
33 #endif
34 #endif
35
36 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
37 #ifdef DOSUID
38 #undef DOSUID
39 #endif
40 #endif
41
42 #ifdef PERL_OBJECT
43 #define perl_construct  Perl_construct
44 #define perl_parse      Perl_parse
45 #define perl_run        Perl_run
46 #define perl_destruct   Perl_destruct
47 #define perl_free       Perl_free
48 #endif
49
50 #if defined(USE_THREADS)
51 #  define INIT_TLS_AND_INTERP \
52     STMT_START {                                \
53         if (!PL_curinterp) {                    \
54             PERL_SET_INTERP(my_perl);           \
55             INIT_THREADS;                       \
56             ALLOC_THREAD_KEY;                   \
57         }                                       \
58     } STMT_END
59 #else
60 #  if defined(USE_ITHREADS)
61 #  define INIT_TLS_AND_INTERP \
62     STMT_START {                                \
63         if (!PL_curinterp) {                    \
64             PERL_SET_INTERP(my_perl);           \
65             INIT_THREADS;                       \
66             ALLOC_THREAD_KEY;                   \
67             PERL_SET_THX(my_perl);              \
68             OP_REFCNT_INIT;                     \
69         }                                       \
70         else {                                  \
71             PERL_SET_THX(my_perl);              \
72         }                                       \
73     } STMT_END
74 #  else
75 #  define INIT_TLS_AND_INTERP \
76     STMT_START {                                \
77         if (!PL_curinterp) {                    \
78             PERL_SET_INTERP(my_perl);           \
79         }                                       \
80         PERL_SET_THX(my_perl);                  \
81     } STMT_END
82 #  endif
83 #endif
84
85 #ifdef PERL_IMPLICIT_SYS
86 PerlInterpreter *
87 perl_alloc_using(struct IPerlMem* ipM, struct IPerlMem* ipMS,
88                  struct IPerlMem* ipMP, struct IPerlEnv* ipE,
89                  struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
90                  struct IPerlDir* ipD, struct IPerlSock* ipS,
91                  struct IPerlProc* ipP)
92 {
93     PerlInterpreter *my_perl;
94 #ifdef PERL_OBJECT
95     my_perl = (PerlInterpreter*)new(ipM) CPerlObj(ipM, ipMS, ipMP, ipE, ipStd,
96                                                   ipLIO, ipD, ipS, ipP);
97     INIT_TLS_AND_INTERP;
98 #else
99     /* New() needs interpreter, so call malloc() instead */
100     my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
101     INIT_TLS_AND_INTERP;
102     Zero(my_perl, 1, PerlInterpreter);
103     PL_Mem = ipM;
104     PL_MemShared = ipMS;
105     PL_MemParse = ipMP;
106     PL_Env = ipE;
107     PL_StdIO = ipStd;
108     PL_LIO = ipLIO;
109     PL_Dir = ipD;
110     PL_Sock = ipS;
111     PL_Proc = ipP;
112 #endif
113
114     return my_perl;
115 }
116 #else
117
118 /*
119 =for apidoc perl_alloc
120
121 Allocates a new Perl interpreter.  See L<perlembed>.
122
123 =cut
124 */
125
126 PerlInterpreter *
127 perl_alloc(void)
128 {
129     PerlInterpreter *my_perl;
130
131     /* New() needs interpreter, so call malloc() instead */
132     my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
133
134     INIT_TLS_AND_INTERP;
135     Zero(my_perl, 1, PerlInterpreter);
136     return my_perl;
137 }
138 #endif /* PERL_IMPLICIT_SYS */
139
140 /*
141 =for apidoc perl_construct
142
143 Initializes a new Perl interpreter.  See L<perlembed>.
144
145 =cut
146 */
147
148 void
149 perl_construct(pTHXx)
150 {
151 #ifdef USE_THREADS
152 #ifndef FAKE_THREADS
153     struct perl_thread *thr = NULL;
154 #endif /* FAKE_THREADS */
155 #endif /* USE_THREADS */
156
157 #ifdef MULTIPLICITY
158     init_interp();
159     PL_perl_destruct_level = 1;
160 #else
161    if (PL_perl_destruct_level > 0)
162        init_interp();
163 #endif
164
165    /* Init the real globals (and main thread)? */
166     if (!PL_linestr) {
167 #ifdef USE_THREADS
168         MUTEX_INIT(&PL_sv_mutex);
169         /*
170          * Safe to use basic SV functions from now on (though
171          * not things like mortals or tainting yet).
172          */
173         MUTEX_INIT(&PL_eval_mutex);
174         COND_INIT(&PL_eval_cond);
175         MUTEX_INIT(&PL_threads_mutex);
176         COND_INIT(&PL_nthreads_cond);
177 #  ifdef EMULATE_ATOMIC_REFCOUNTS
178         MUTEX_INIT(&PL_svref_mutex);
179 #  endif /* EMULATE_ATOMIC_REFCOUNTS */
180         
181         MUTEX_INIT(&PL_cred_mutex);
182         MUTEX_INIT(&PL_sv_lock_mutex);
183         MUTEX_INIT(&PL_fdpid_mutex);
184
185         thr = init_main_thread();
186 #endif /* USE_THREADS */
187
188 #ifdef PERL_FLEXIBLE_EXCEPTIONS
189         PL_protect = MEMBER_TO_FPTR(Perl_default_protect); /* for exceptions */
190 #endif
191
192         PL_curcop = &PL_compiling;      /* needed by ckWARN, right away */
193
194         PL_linestr = NEWSV(65,79);
195         sv_upgrade(PL_linestr,SVt_PVIV);
196
197         if (!SvREADONLY(&PL_sv_undef)) {
198             /* set read-only and try to insure than we wont see REFCNT==0
199                very often */
200
201             SvREADONLY_on(&PL_sv_undef);
202             SvREFCNT(&PL_sv_undef) = (~(U32)0)/2;
203
204             sv_setpv(&PL_sv_no,PL_No);
205             SvNV(&PL_sv_no);
206             SvREADONLY_on(&PL_sv_no);
207             SvREFCNT(&PL_sv_no) = (~(U32)0)/2;
208
209             sv_setpv(&PL_sv_yes,PL_Yes);
210             SvNV(&PL_sv_yes);
211             SvREADONLY_on(&PL_sv_yes);
212             SvREFCNT(&PL_sv_yes) = (~(U32)0)/2;
213         }
214
215 #ifdef PERL_OBJECT
216         /* TODO: */
217         /* PL_sighandlerp = sighandler; */
218 #else
219         PL_sighandlerp = Perl_sighandler;
220 #endif
221         PL_pidstatus = newHV();
222
223 #ifdef MSDOS
224         /*
225          * There is no way we can refer to them from Perl so close them to save
226          * space.  The other alternative would be to provide STDAUX and STDPRN
227          * filehandles.
228          */
229         (void)PerlIO_close(PerlIO_importFILE(stdaux, 0));
230         (void)PerlIO_close(PerlIO_importFILE(stdprn, 0));
231 #endif
232     }
233
234     PL_nrs = newSVpvn("\n", 1);
235     PL_rs = SvREFCNT_inc(PL_nrs);
236
237     init_stacks();
238
239     init_ids();
240     PL_lex_state = LEX_NOTPARSING;
241
242     JMPENV_BOOTSTRAP;
243     STATUS_ALL_SUCCESS;
244
245     init_i18nl10n(1);
246     SET_NUMERIC_STANDARD();
247
248     {
249         U8 *s;
250         PL_patchlevel = NEWSV(0,4);
251         (void)SvUPGRADE(PL_patchlevel, SVt_PVNV);
252         if (PERL_REVISION > 127 || PERL_VERSION > 127 || PERL_SUBVERSION > 127)
253             SvGROW(PL_patchlevel, UTF8_MAXLEN*3+1);
254         s = (U8*)SvPVX(PL_patchlevel);
255         /* Build version strings using "native" characters */
256         s = uvchr_to_utf8(s, (UV)PERL_REVISION);
257         s = uvchr_to_utf8(s, (UV)PERL_VERSION);
258         s = uvchr_to_utf8(s, (UV)PERL_SUBVERSION);
259         *s = '\0';
260         SvCUR_set(PL_patchlevel, s - (U8*)SvPVX(PL_patchlevel));
261         SvPOK_on(PL_patchlevel);
262         SvNVX(PL_patchlevel) = (NV)PERL_REVISION
263                                 + ((NV)PERL_VERSION / (NV)1000)
264 #if defined(PERL_SUBVERSION) && PERL_SUBVERSION > 0
265                                 + ((NV)PERL_SUBVERSION / (NV)1000000)
266 #endif
267                                 ;
268         SvNOK_on(PL_patchlevel);        /* dual valued */
269         SvUTF8_on(PL_patchlevel);
270         SvREADONLY_on(PL_patchlevel);
271     }
272
273 #if defined(LOCAL_PATCH_COUNT)
274     PL_localpatches = local_patches;    /* For possible -v */
275 #endif
276
277 #ifdef HAVE_INTERP_INTERN
278     sys_intern_init();
279 #endif
280
281     PerlIO_init();                      /* Hook to IO system */
282
283     PL_fdpid = newAV();                 /* for remembering popen pids by fd */
284     PL_modglobal = newHV();             /* pointers to per-interpreter module globals */
285     PL_errors = newSVpvn("",0);
286 #ifdef USE_ITHREADS
287         PL_regex_padav = newAV();
288 #endif
289 #ifdef USE_REENTRANT_API
290     New(31337, PL_reentrant_buffer,1, REBUF);
291     New(31337, PL_reentrant_buffer->tmbuff,1, struct tm);
292 #endif
293     ENTER;
294 }
295
296 /*
297 =for apidoc perl_destruct
298
299 Shuts down a Perl interpreter.  See L<perlembed>.
300
301 =cut
302 */
303
304 void
305 perl_destruct(pTHXx)
306 {
307     int destruct_level;  /* 0=none, 1=full, 2=full with checks */
308     HV *hv;
309 #ifdef USE_THREADS
310     Thread t;
311     dTHX;
312 #endif /* USE_THREADS */
313
314     /* wait for all pseudo-forked children to finish */
315     PERL_WAIT_FOR_CHILDREN;
316
317 #ifdef USE_THREADS
318 #ifndef FAKE_THREADS
319     /* Pass 1 on any remaining threads: detach joinables, join zombies */
320   retry_cleanup:
321     MUTEX_LOCK(&PL_threads_mutex);
322     DEBUG_S(PerlIO_printf(Perl_debug_log,
323                           "perl_destruct: waiting for %d threads...\n",
324                           PL_nthreads - 1));
325     for (t = thr->next; t != thr; t = t->next) {
326         MUTEX_LOCK(&t->mutex);
327         switch (ThrSTATE(t)) {
328             AV *av;
329         case THRf_ZOMBIE:
330             DEBUG_S(PerlIO_printf(Perl_debug_log,
331                                   "perl_destruct: joining zombie %p\n", t));
332             ThrSETSTATE(t, THRf_DEAD);
333             MUTEX_UNLOCK(&t->mutex);
334             PL_nthreads--;
335             /*
336              * The SvREFCNT_dec below may take a long time (e.g. av
337              * may contain an object scalar whose destructor gets
338              * called) so we have to unlock threads_mutex and start
339              * all over again.
340              */
341             MUTEX_UNLOCK(&PL_threads_mutex);
342             JOIN(t, &av);
343             SvREFCNT_dec((SV*)av);
344             DEBUG_S(PerlIO_printf(Perl_debug_log,
345                                   "perl_destruct: joined zombie %p OK\n", t));
346             goto retry_cleanup;
347         case THRf_R_JOINABLE:
348             DEBUG_S(PerlIO_printf(Perl_debug_log,
349                                   "perl_destruct: detaching thread %p\n", t));
350             ThrSETSTATE(t, THRf_R_DETACHED);
351             /*
352              * We unlock threads_mutex and t->mutex in the opposite order
353              * from which we locked them just so that DETACH won't
354              * deadlock if it panics. It's only a breach of good style
355              * not a bug since they are unlocks not locks.
356              */
357             MUTEX_UNLOCK(&PL_threads_mutex);
358             DETACH(t);
359             MUTEX_UNLOCK(&t->mutex);
360             goto retry_cleanup;
361         default:
362             DEBUG_S(PerlIO_printf(Perl_debug_log,
363                                   "perl_destruct: ignoring %p (state %u)\n",
364                                   t, ThrSTATE(t)));
365             MUTEX_UNLOCK(&t->mutex);
366             /* fall through and out */
367         }
368     }
369     /* We leave the above "Pass 1" loop with threads_mutex still locked */
370
371     /* Pass 2 on remaining threads: wait for the thread count to drop to one */
372     while (PL_nthreads > 1)
373     {
374         DEBUG_S(PerlIO_printf(Perl_debug_log,
375                               "perl_destruct: final wait for %d threads\n",
376                               PL_nthreads - 1));
377         COND_WAIT(&PL_nthreads_cond, &PL_threads_mutex);
378     }
379     /* At this point, we're the last thread */
380     MUTEX_UNLOCK(&PL_threads_mutex);
381     DEBUG_S(PerlIO_printf(Perl_debug_log, "perl_destruct: armageddon has arrived\n"));
382     MUTEX_DESTROY(&PL_threads_mutex);
383     COND_DESTROY(&PL_nthreads_cond);
384     PL_nthreads--;
385 #endif /* !defined(FAKE_THREADS) */
386 #endif /* USE_THREADS */
387
388     destruct_level = PL_perl_destruct_level;
389 #ifdef DEBUGGING
390     {
391         char *s;
392         if ((s = PerlEnv_getenv("PERL_DESTRUCT_LEVEL"))) {
393             int i = atoi(s);
394             if (destruct_level < i)
395                 destruct_level = i;
396         }
397     }
398 #endif
399
400     LEAVE;
401     FREETMPS;
402
403
404     /* We must account for everything.  */
405
406     /* Destroy the main CV and syntax tree */
407     if (PL_main_root) {
408         PL_curpad = AvARRAY(PL_comppad);
409         op_free(PL_main_root);
410         PL_main_root = Nullop;
411     }
412     PL_curcop = &PL_compiling;
413     PL_main_start = Nullop;
414     SvREFCNT_dec(PL_main_cv);
415     PL_main_cv = Nullcv;
416     PL_dirty = TRUE;
417
418     /* Tell PerlIO we are about to tear things apart in case
419        we have layers which are using resources that should
420        be cleaned up now.
421      */
422
423     PerlIO_destruct(aTHX);
424
425     if (PL_sv_objcount) {
426         /*
427          * Try to destruct global references.  We do this first so that the
428          * destructors and destructees still exist.  Some sv's might remain.
429          * Non-referenced objects are on their own.
430          */
431         sv_clean_objs();
432     }
433
434     /* unhook hooks which will soon be, or use, destroyed data */
435     SvREFCNT_dec(PL_warnhook);
436     PL_warnhook = Nullsv;
437     SvREFCNT_dec(PL_diehook);
438     PL_diehook = Nullsv;
439
440     /* call exit list functions */
441     while (PL_exitlistlen-- > 0)
442         PL_exitlist[PL_exitlistlen].fn(aTHXo_ PL_exitlist[PL_exitlistlen].ptr);
443
444     Safefree(PL_exitlist);
445
446     if (destruct_level == 0){
447
448         DEBUG_P(debprofdump());
449
450         /* The exit() function will do everything that needs doing. */
451         return;
452     }
453
454     /* jettison our possibly duplicated environment */
455
456 #ifdef USE_ENVIRON_ARRAY
457     if (environ != PL_origenviron) {
458         I32 i;
459
460         for (i = 0; environ[i]; i++)
461             safesysfree(environ[i]);
462         /* Must use safesysfree() when working with environ. */
463         safesysfree(environ);           
464
465         environ = PL_origenviron;
466     }
467 #endif
468
469     /* loosen bonds of global variables */
470
471     if(PL_rsfp) {
472         (void)PerlIO_close(PL_rsfp);
473         PL_rsfp = Nullfp;
474     }
475
476     /* Filters for program text */
477     SvREFCNT_dec(PL_rsfp_filters);
478     PL_rsfp_filters = Nullav;
479
480     /* switches */
481     PL_preprocess   = FALSE;
482     PL_minus_n      = FALSE;
483     PL_minus_p      = FALSE;
484     PL_minus_l      = FALSE;
485     PL_minus_a      = FALSE;
486     PL_minus_F      = FALSE;
487     PL_doswitches   = FALSE;
488     PL_dowarn       = G_WARN_OFF;
489     PL_doextract    = FALSE;
490     PL_sawampersand = FALSE;    /* must save all match strings */
491     PL_unsafe       = FALSE;
492
493     Safefree(PL_inplace);
494     PL_inplace = Nullch;
495     SvREFCNT_dec(PL_patchlevel);
496
497     if (PL_e_script) {
498         SvREFCNT_dec(PL_e_script);
499         PL_e_script = Nullsv;
500     }
501
502     /* magical thingies */
503
504     SvREFCNT_dec(PL_ofs_sv);    /* $, */
505     PL_ofs_sv = Nullsv;
506
507     SvREFCNT_dec(PL_ors_sv);    /* $\ */
508     PL_ors_sv = Nullsv;
509
510     SvREFCNT_dec(PL_rs);        /* $/ */
511     PL_rs = Nullsv;
512
513     SvREFCNT_dec(PL_nrs);       /* $/ helper */
514     PL_nrs = Nullsv;
515
516     PL_multiline = 0;           /* $* */
517     Safefree(PL_osname);        /* $^O */
518     PL_osname = Nullch;
519
520     SvREFCNT_dec(PL_statname);
521     PL_statname = Nullsv;
522     PL_statgv = Nullgv;
523
524     /* defgv, aka *_ should be taken care of elsewhere */
525
526     /* clean up after study() */
527     SvREFCNT_dec(PL_lastscream);
528     PL_lastscream = Nullsv;
529     Safefree(PL_screamfirst);
530     PL_screamfirst = 0;
531     Safefree(PL_screamnext);
532     PL_screamnext  = 0;
533
534     /* float buffer */
535     Safefree(PL_efloatbuf);
536     PL_efloatbuf = Nullch;
537     PL_efloatsize = 0;
538
539     /* startup and shutdown function lists */
540     SvREFCNT_dec(PL_beginav);
541     SvREFCNT_dec(PL_endav);
542     SvREFCNT_dec(PL_checkav);
543     SvREFCNT_dec(PL_initav);
544     PL_beginav = Nullav;
545     PL_endav = Nullav;
546     PL_checkav = Nullav;
547     PL_initav = Nullav;
548
549     /* shortcuts just get cleared */
550     PL_envgv = Nullgv;
551     PL_incgv = Nullgv;
552     PL_hintgv = Nullgv;
553     PL_errgv = Nullgv;
554     PL_argvgv = Nullgv;
555     PL_argvoutgv = Nullgv;
556     PL_stdingv = Nullgv;
557     PL_stderrgv = Nullgv;
558     PL_last_in_gv = Nullgv;
559     PL_replgv = Nullgv;
560     PL_debstash = Nullhv;
561
562     /* reset so print() ends up where we expect */
563     setdefout(Nullgv);
564
565     SvREFCNT_dec(PL_argvout_stack);
566     PL_argvout_stack = Nullav;
567
568     SvREFCNT_dec(PL_modglobal);
569     PL_modglobal = Nullhv;
570     SvREFCNT_dec(PL_preambleav);
571     PL_preambleav = Nullav;
572     SvREFCNT_dec(PL_subname);
573     PL_subname = Nullsv;
574     SvREFCNT_dec(PL_linestr);
575     PL_linestr = Nullsv;
576     SvREFCNT_dec(PL_pidstatus);
577     PL_pidstatus = Nullhv;
578     SvREFCNT_dec(PL_toptarget);
579     PL_toptarget = Nullsv;
580     SvREFCNT_dec(PL_bodytarget);
581     PL_bodytarget = Nullsv;
582     PL_formtarget = Nullsv;
583
584     /* free locale stuff */
585 #ifdef USE_LOCALE_COLLATE
586     Safefree(PL_collation_name);
587     PL_collation_name = Nullch;
588 #endif
589
590 #ifdef USE_LOCALE_NUMERIC
591     Safefree(PL_numeric_name);
592     PL_numeric_name = Nullch;
593     SvREFCNT_dec(PL_numeric_radix_sv);
594 #endif
595
596     /* clear utf8 character classes */
597     SvREFCNT_dec(PL_utf8_alnum);
598     SvREFCNT_dec(PL_utf8_alnumc);
599     SvREFCNT_dec(PL_utf8_ascii);
600     SvREFCNT_dec(PL_utf8_alpha);
601     SvREFCNT_dec(PL_utf8_space);
602     SvREFCNT_dec(PL_utf8_cntrl);
603     SvREFCNT_dec(PL_utf8_graph);
604     SvREFCNT_dec(PL_utf8_digit);
605     SvREFCNT_dec(PL_utf8_upper);
606     SvREFCNT_dec(PL_utf8_lower);
607     SvREFCNT_dec(PL_utf8_print);
608     SvREFCNT_dec(PL_utf8_punct);
609     SvREFCNT_dec(PL_utf8_xdigit);
610     SvREFCNT_dec(PL_utf8_mark);
611     SvREFCNT_dec(PL_utf8_toupper);
612     SvREFCNT_dec(PL_utf8_tolower);
613     PL_utf8_alnum       = Nullsv;
614     PL_utf8_alnumc      = Nullsv;
615     PL_utf8_ascii       = Nullsv;
616     PL_utf8_alpha       = Nullsv;
617     PL_utf8_space       = Nullsv;
618     PL_utf8_cntrl       = Nullsv;
619     PL_utf8_graph       = Nullsv;
620     PL_utf8_digit       = Nullsv;
621     PL_utf8_upper       = Nullsv;
622     PL_utf8_lower       = Nullsv;
623     PL_utf8_print       = Nullsv;
624     PL_utf8_punct       = Nullsv;
625     PL_utf8_xdigit      = Nullsv;
626     PL_utf8_mark        = Nullsv;
627     PL_utf8_toupper     = Nullsv;
628     PL_utf8_totitle     = Nullsv;
629     PL_utf8_tolower     = Nullsv;
630
631     if (!specialWARN(PL_compiling.cop_warnings))
632         SvREFCNT_dec(PL_compiling.cop_warnings);
633     PL_compiling.cop_warnings = Nullsv;
634     if (!specialCopIO(PL_compiling.cop_io))
635         SvREFCNT_dec(PL_compiling.cop_io);
636     PL_compiling.cop_io = Nullsv;
637 #ifdef USE_ITHREADS
638     Safefree(CopFILE(&PL_compiling));
639     CopFILE(&PL_compiling) = Nullch;
640     Safefree(CopSTASHPV(&PL_compiling));
641 #else
642     SvREFCNT_dec(CopFILEGV(&PL_compiling));
643     CopFILEGV(&PL_compiling) = Nullgv;
644     /* cop_stash is not refcounted */
645 #endif
646
647     /* Prepare to destruct main symbol table.  */
648
649     hv = PL_defstash;
650     PL_defstash = 0;
651     SvREFCNT_dec(hv);
652     SvREFCNT_dec(PL_curstname);
653     PL_curstname = Nullsv;
654
655     /* clear queued errors */
656     SvREFCNT_dec(PL_errors);
657     PL_errors = Nullsv;
658
659     FREETMPS;
660     if (destruct_level >= 2 && ckWARN_d(WARN_INTERNAL)) {
661         if (PL_scopestack_ix != 0)
662             Perl_warner(aTHX_ WARN_INTERNAL,
663                  "Unbalanced scopes: %ld more ENTERs than LEAVEs\n",
664                  (long)PL_scopestack_ix);
665         if (PL_savestack_ix != 0)
666             Perl_warner(aTHX_ WARN_INTERNAL,
667                  "Unbalanced saves: %ld more saves than restores\n",
668                  (long)PL_savestack_ix);
669         if (PL_tmps_floor != -1)
670             Perl_warner(aTHX_ WARN_INTERNAL,"Unbalanced tmps: %ld more allocs than frees\n",
671                  (long)PL_tmps_floor + 1);
672         if (cxstack_ix != -1)
673             Perl_warner(aTHX_ WARN_INTERNAL,"Unbalanced context: %ld more PUSHes than POPs\n",
674                  (long)cxstack_ix + 1);
675     }
676
677     /* Now absolutely destruct everything, somehow or other, loops or no. */
678     SvFLAGS(PL_fdpid) |= SVTYPEMASK;            /* don't clean out pid table now */
679     SvFLAGS(PL_strtab) |= SVTYPEMASK;           /* don't clean out strtab now */
680
681     /* the 2 is for PL_fdpid and PL_strtab */
682     while (PL_sv_count > 2 && sv_clean_all())
683         ;
684
685     SvFLAGS(PL_fdpid) &= ~SVTYPEMASK;
686     SvFLAGS(PL_fdpid) |= SVt_PVAV;
687     SvFLAGS(PL_strtab) &= ~SVTYPEMASK;
688     SvFLAGS(PL_strtab) |= SVt_PVHV;
689
690     AvREAL_off(PL_fdpid);               /* no surviving entries */
691     SvREFCNT_dec(PL_fdpid);             /* needed in io_close() */
692     PL_fdpid = Nullav;
693
694 #ifdef HAVE_INTERP_INTERN
695     sys_intern_clear();
696 #endif
697
698     /* Destruct the global string table. */
699     {
700         /* Yell and reset the HeVAL() slots that are still holding refcounts,
701          * so that sv_free() won't fail on them.
702          */
703         I32 riter;
704         I32 max;
705         HE *hent;
706         HE **array;
707
708         riter = 0;
709         max = HvMAX(PL_strtab);
710         array = HvARRAY(PL_strtab);
711         hent = array[0];
712         for (;;) {
713             if (hent && ckWARN_d(WARN_INTERNAL)) {
714                 Perl_warner(aTHX_ WARN_INTERNAL,
715                      "Unbalanced string table refcount: (%d) for \"%s\"",
716                      HeVAL(hent) - Nullsv, HeKEY(hent));
717                 HeVAL(hent) = Nullsv;
718                 hent = HeNEXT(hent);
719             }
720             if (!hent) {
721                 if (++riter > max)
722                     break;
723                 hent = array[riter];
724             }
725         }
726     }
727     SvREFCNT_dec(PL_strtab);
728
729 #ifdef USE_ITHREADS
730     /* free the pointer table used for cloning */
731     ptr_table_free(PL_ptr_table);
732 #endif
733
734     /* free special SVs */
735
736     SvREFCNT(&PL_sv_yes) = 0;
737     sv_clear(&PL_sv_yes);
738     SvANY(&PL_sv_yes) = NULL;
739     SvFLAGS(&PL_sv_yes) = 0;
740
741     SvREFCNT(&PL_sv_no) = 0;
742     sv_clear(&PL_sv_no);
743     SvANY(&PL_sv_no) = NULL;
744     SvFLAGS(&PL_sv_no) = 0;
745
746     SvREFCNT(&PL_sv_undef) = 0;
747     SvREADONLY_off(&PL_sv_undef);
748
749     if (PL_sv_count != 0 && ckWARN_d(WARN_INTERNAL))
750         Perl_warner(aTHX_ WARN_INTERNAL,"Scalars leaked: %ld\n", (long)PL_sv_count);
751
752     Safefree(PL_origfilename);
753     Safefree(PL_reg_start_tmp);
754     if (PL_reg_curpm)
755         Safefree(PL_reg_curpm);
756     Safefree(PL_reg_poscache);
757     Safefree(HeKEY_hek(&PL_hv_fetch_ent_mh));
758     Safefree(PL_op_mask);
759     Safefree(PL_psig_ptr);
760     Safefree(PL_psig_name);
761     Safefree(PL_bitcount);
762     Safefree(PL_psig_pend);
763     nuke_stacks();
764     PL_hints = 0;               /* Reset hints. Should hints be per-interpreter ? */
765
766     DEBUG_P(debprofdump());
767 #ifdef USE_THREADS
768     MUTEX_DESTROY(&PL_strtab_mutex);
769     MUTEX_DESTROY(&PL_sv_mutex);
770     MUTEX_DESTROY(&PL_eval_mutex);
771     MUTEX_DESTROY(&PL_cred_mutex);
772     MUTEX_DESTROY(&PL_fdpid_mutex);
773     COND_DESTROY(&PL_eval_cond);
774 #ifdef EMULATE_ATOMIC_REFCOUNTS
775     MUTEX_DESTROY(&PL_svref_mutex);
776 #endif /* EMULATE_ATOMIC_REFCOUNTS */
777
778     /* As the penultimate thing, free the non-arena SV for thrsv */
779     Safefree(SvPVX(PL_thrsv));
780     Safefree(SvANY(PL_thrsv));
781     Safefree(PL_thrsv);
782     PL_thrsv = Nullsv;
783 #endif /* USE_THREADS */
784
785 #ifdef USE_REENTRANT_API
786     Safefree(PL_reentrant_buffer->tmbuff);
787     Safefree(PL_reentrant_buffer);
788 #endif
789
790     sv_free_arenas();
791
792     /* As the absolutely last thing, free the non-arena SV for mess() */
793
794     if (PL_mess_sv) {
795         /* it could have accumulated taint magic */
796         if (SvTYPE(PL_mess_sv) >= SVt_PVMG) {
797             MAGIC* mg;
798             MAGIC* moremagic;
799             for (mg = SvMAGIC(PL_mess_sv); mg; mg = moremagic) {
800                 moremagic = mg->mg_moremagic;
801                 if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global
802                                                 && mg->mg_len >= 0)
803                     Safefree(mg->mg_ptr);
804                 Safefree(mg);
805             }
806         }
807         /* we know that type >= SVt_PV */
808         (void)SvOOK_off(PL_mess_sv);
809         Safefree(SvPVX(PL_mess_sv));
810         Safefree(SvANY(PL_mess_sv));
811         Safefree(PL_mess_sv);
812         PL_mess_sv = Nullsv;
813     }
814 }
815
816 /*
817 =for apidoc perl_free
818
819 Releases a Perl interpreter.  See L<perlembed>.
820
821 =cut
822 */
823
824 void
825 perl_free(pTHXx)
826 {
827 #if defined(PERL_OBJECT)
828     PerlMem_free(this);
829 #else
830 #  if defined(WIN32) || defined(NETWARE)
831 #  if defined(PERL_IMPLICIT_SYS)
832     #ifdef NETWARE
833                 void *host = nw_internal_host;
834         #else
835                 void *host = w32_internal_host;
836         #endif
837         #ifndef NETWARE
838         if (PerlProc_lasthost()) {
839         PerlIO_cleanup();
840         }
841         #endif
842     PerlMem_free(aTHXx);
843         #ifdef NETWARE
844                 nw5_delete_internal_host(host);
845         #else
846                 win32_delete_internal_host(host);
847         #endif
848 #else
849     PerlIO_cleanup();
850     PerlMem_free(aTHXx);
851 #endif
852 #  else
853     PerlMem_free(aTHXx);
854 #  endif
855 #endif
856 }
857
858 void
859 Perl_call_atexit(pTHX_ ATEXIT_t fn, void *ptr)
860 {
861     Renew(PL_exitlist, PL_exitlistlen+1, PerlExitListEntry);
862     PL_exitlist[PL_exitlistlen].fn = fn;
863     PL_exitlist[PL_exitlistlen].ptr = ptr;
864     ++PL_exitlistlen;
865 }
866
867 /*
868 =for apidoc perl_parse
869
870 Tells a Perl interpreter to parse a Perl script.  See L<perlembed>.
871
872 =cut
873 */
874
875 int
876 perl_parse(pTHXx_ XSINIT_t xsinit, int argc, char **argv, char **env)
877 {
878     I32 oldscope;
879     int ret;
880     dJMPENV;
881 #ifdef USE_THREADS
882     dTHX;
883 #endif
884
885 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
886 #ifdef IAMSUID
887 #undef IAMSUID
888     Perl_croak(aTHX_ "suidperl is no longer needed since the kernel can now execute\n\
889 setuid perl scripts securely.\n");
890 #endif
891 #endif
892
893 #if defined(__DYNAMIC__) && (defined(NeXT) || defined(__NeXT__))
894     _dyld_lookup_and_bind
895         ("__environ", (unsigned long *) &environ_pointer, NULL);
896 #endif /* environ */
897
898     PL_origargv = argv;
899     PL_origargc = argc;
900 #ifdef  USE_ENVIRON_ARRAY
901     PL_origenviron = environ;
902 #endif
903
904     if (PL_do_undump) {
905
906         /* Come here if running an undumped a.out. */
907
908         PL_origfilename = savepv(argv[0]);
909         PL_do_undump = FALSE;
910         cxstack_ix = -1;                /* start label stack again */
911         init_ids();
912         init_postdump_symbols(argc,argv,env);
913         return 0;
914     }
915
916     if (PL_main_root) {
917         PL_curpad = AvARRAY(PL_comppad);
918         op_free(PL_main_root);
919         PL_main_root = Nullop;
920     }
921     PL_main_start = Nullop;
922     SvREFCNT_dec(PL_main_cv);
923     PL_main_cv = Nullcv;
924
925     time(&PL_basetime);
926     oldscope = PL_scopestack_ix;
927     PL_dowarn = G_WARN_OFF;
928
929 #ifdef PERL_FLEXIBLE_EXCEPTIONS
930     CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vparse_body), env, xsinit);
931 #else
932     JMPENV_PUSH(ret);
933 #endif
934     switch (ret) {
935     case 0:
936 #ifndef PERL_FLEXIBLE_EXCEPTIONS
937         parse_body(env,xsinit);
938 #endif
939         if (PL_checkav)
940             call_list(oldscope, PL_checkav);
941         ret = 0;
942         break;
943     case 1:
944         STATUS_ALL_FAILURE;
945         /* FALL THROUGH */
946     case 2:
947         /* my_exit() was called */
948         while (PL_scopestack_ix > oldscope)
949             LEAVE;
950         FREETMPS;
951         PL_curstash = PL_defstash;
952         if (PL_checkav)
953             call_list(oldscope, PL_checkav);
954         ret = STATUS_NATIVE_EXPORT;
955         break;
956     case 3:
957         PerlIO_printf(Perl_error_log, "panic: top_env\n");
958         ret = 1;
959         break;
960     }
961     JMPENV_POP;
962     return ret;
963 }
964
965 #ifdef PERL_FLEXIBLE_EXCEPTIONS
966 STATIC void *
967 S_vparse_body(pTHX_ va_list args)
968 {
969     char **env = va_arg(args, char**);
970     XSINIT_t xsinit = va_arg(args, XSINIT_t);
971
972     return parse_body(env, xsinit);
973 }
974 #endif
975
976 STATIC void *
977 S_parse_body(pTHX_ char **env, XSINIT_t xsinit)
978 {
979     int argc = PL_origargc;
980     char **argv = PL_origargv;
981     char *scriptname = NULL;
982     int fdscript = -1;
983     VOL bool dosearch = FALSE;
984     char *validarg = "";
985     AV* comppadlist;
986     register SV *sv;
987     register char *s;
988     char *popts, *cddir = Nullch;
989
990     sv_setpvn(PL_linestr,"",0);
991     sv = newSVpvn("",0);                /* first used for -I flags */
992     SAVEFREESV(sv);
993     init_main_stash();
994
995     for (argc--,argv++; argc > 0; argc--,argv++) {
996         if (argv[0][0] != '-' || !argv[0][1])
997             break;
998 #ifdef DOSUID
999     if (*validarg)
1000         validarg = " PHOOEY ";
1001     else
1002         validarg = argv[0];
1003 #endif
1004         s = argv[0]+1;
1005       reswitch:
1006         switch (*s) {
1007         case 'C':
1008 #ifdef  WIN32
1009             win32_argv2utf8(argc-1, argv+1);
1010             /* FALL THROUGH */
1011 #endif
1012 #ifndef PERL_STRICT_CR
1013         case '\r':
1014 #endif
1015         case ' ':
1016         case '0':
1017         case 'F':
1018         case 'a':
1019         case 'c':
1020         case 'd':
1021         case 'D':
1022         case 'h':
1023         case 'i':
1024         case 'l':
1025         case 'M':
1026         case 'm':
1027         case 'n':
1028         case 'p':
1029         case 's':
1030         case 'u':
1031         case 'U':
1032         case 'v':
1033         case 'W':
1034         case 'X':
1035         case 'w':
1036             if ((s = moreswitches(s)))
1037                 goto reswitch;
1038             break;
1039
1040         case 'T':
1041             PL_tainting = TRUE;
1042             s++;
1043             goto reswitch;
1044
1045         case 'e':
1046 #ifdef MACOS_TRADITIONAL
1047             /* ignore -e for Dev:Pseudo argument */
1048             if (argv[1] && !strcmp(argv[1], "Dev:Pseudo"))
1049                 break;
1050 #endif
1051             if (PL_euid != PL_uid || PL_egid != PL_gid)
1052                 Perl_croak(aTHX_ "No -e allowed in setuid scripts");
1053             if (!PL_e_script) {
1054                 PL_e_script = newSVpvn("",0);
1055                 filter_add(read_e_script, NULL);
1056             }
1057             if (*++s)
1058                 sv_catpv(PL_e_script, s);
1059             else if (argv[1]) {
1060                 sv_catpv(PL_e_script, argv[1]);
1061                 argc--,argv++;
1062             }
1063             else
1064                 Perl_croak(aTHX_ "No code specified for -e");
1065             sv_catpv(PL_e_script, "\n");
1066             break;
1067
1068         case 'I':       /* -I handled both here and in moreswitches() */
1069             forbid_setid("-I");
1070             if (!*++s && (s=argv[1]) != Nullch) {
1071                 argc--,argv++;
1072             }
1073             if (s && *s) {
1074                 char *p;
1075                 STRLEN len = strlen(s);
1076                 p = savepvn(s, len);
1077                 incpush(p, TRUE, TRUE);
1078                 sv_catpvn(sv, "-I", 2);
1079                 sv_catpvn(sv, p, len);
1080                 sv_catpvn(sv, " ", 1);
1081                 Safefree(p);
1082             }
1083             else
1084                 Perl_croak(aTHX_ "No directory specified for -I");
1085             break;
1086         case 'P':
1087             forbid_setid("-P");
1088             PL_preprocess = TRUE;
1089             s++;
1090             goto reswitch;
1091         case 'S':
1092             forbid_setid("-S");
1093             dosearch = TRUE;
1094             s++;
1095             goto reswitch;
1096         case 'V':
1097             if (!PL_preambleav)
1098                 PL_preambleav = newAV();
1099             av_push(PL_preambleav, newSVpv("use Config qw(myconfig config_vars)",0));
1100             if (*++s != ':')  {
1101                 PL_Sv = newSVpv("print myconfig();",0);
1102 #ifdef VMS
1103                 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this PERLSHR image: \\n\",");
1104 #else
1105                 sv_catpv(PL_Sv,"print \"\\nCharacteristics of this binary (from libperl): \\n\",");
1106 #endif
1107                 sv_catpv(PL_Sv,"\"  Compile-time options:");
1108 #  ifdef DEBUGGING
1109                 sv_catpv(PL_Sv," DEBUGGING");
1110 #  endif
1111 #  ifdef MULTIPLICITY
1112                 sv_catpv(PL_Sv," MULTIPLICITY");
1113 #  endif
1114 #  ifdef USE_THREADS
1115                 sv_catpv(PL_Sv," USE_THREADS");
1116 #  endif
1117 #  ifdef USE_ITHREADS
1118                 sv_catpv(PL_Sv," USE_ITHREADS");
1119 #  endif
1120 #  ifdef USE_64_BIT_INT
1121                 sv_catpv(PL_Sv," USE_64_BIT_INT");
1122 #  endif
1123 #  ifdef USE_64_BIT_ALL
1124                 sv_catpv(PL_Sv," USE_64_BIT_ALL");
1125 #  endif
1126 #  ifdef USE_LONG_DOUBLE
1127                 sv_catpv(PL_Sv," USE_LONG_DOUBLE");
1128 #  endif
1129 #  ifdef USE_LARGE_FILES
1130                 sv_catpv(PL_Sv," USE_LARGE_FILES");
1131 #  endif
1132 #  ifdef USE_SOCKS
1133                 sv_catpv(PL_Sv," USE_SOCKS");
1134 #  endif
1135 #  ifdef PERL_OBJECT
1136                 sv_catpv(PL_Sv," PERL_OBJECT");
1137 #  endif
1138 #  ifdef PERL_IMPLICIT_CONTEXT
1139                 sv_catpv(PL_Sv," PERL_IMPLICIT_CONTEXT");
1140 #  endif
1141 #  ifdef PERL_IMPLICIT_SYS
1142                 sv_catpv(PL_Sv," PERL_IMPLICIT_SYS");
1143 #  endif
1144                 sv_catpv(PL_Sv,"\\n\",");
1145
1146 #if defined(LOCAL_PATCH_COUNT)
1147                 if (LOCAL_PATCH_COUNT > 0) {
1148                     int i;
1149                     sv_catpv(PL_Sv,"\"  Locally applied patches:\\n\",");
1150                     for (i = 1; i <= LOCAL_PATCH_COUNT; i++) {
1151                         if (PL_localpatches[i])
1152                             Perl_sv_catpvf(aTHX_ PL_Sv,"q\"  \t%s\n\",",PL_localpatches[i]);
1153                     }
1154                 }
1155 #endif
1156                 Perl_sv_catpvf(aTHX_ PL_Sv,"\"  Built under %s\\n\"",OSNAME);
1157 #ifdef __DATE__
1158 #  ifdef __TIME__
1159                 Perl_sv_catpvf(aTHX_ PL_Sv,",\"  Compiled at %s %s\\n\"",__DATE__,__TIME__);
1160 #  else
1161                 Perl_sv_catpvf(aTHX_ PL_Sv,",\"  Compiled on %s\\n\"",__DATE__);
1162 #  endif
1163 #endif
1164                 sv_catpv(PL_Sv, "; \
1165 $\"=\"\\n    \"; \
1166 @env = map { \"$_=\\\"$ENV{$_}\\\"\" } sort grep {/^PERL/} keys %ENV; ");
1167 #ifdef __CYGWIN__
1168                 sv_catpv(PL_Sv,"\
1169 push @env, \"CYGWIN=\\\"$ENV{CYGWIN}\\\"\";");
1170 #endif
1171                 sv_catpv(PL_Sv, "\
1172 print \"  \\%ENV:\\n    @env\\n\" if @env; \
1173 print \"  \\@INC:\\n    @INC\\n\";");
1174             }
1175             else {
1176                 PL_Sv = newSVpv("config_vars(qw(",0);
1177                 sv_catpv(PL_Sv, ++s);
1178                 sv_catpv(PL_Sv, "))");
1179                 s += strlen(s);
1180             }
1181             av_push(PL_preambleav, PL_Sv);
1182             scriptname = BIT_BUCKET;    /* don't look for script or read stdin */
1183             goto reswitch;
1184         case 'x':
1185             PL_doextract = TRUE;
1186             s++;
1187             if (*s)
1188                 cddir = s;
1189             break;
1190         case 0:
1191             break;
1192         case '-':
1193             if (!*++s || isSPACE(*s)) {
1194                 argc--,argv++;
1195                 goto switch_end;
1196             }
1197             /* catch use of gnu style long options */
1198             if (strEQ(s, "version")) {
1199                 s = "v";
1200                 goto reswitch;
1201             }
1202             if (strEQ(s, "help")) {
1203                 s = "h";
1204                 goto reswitch;
1205             }
1206             s--;
1207             /* FALL THROUGH */
1208         default:
1209             Perl_croak(aTHX_ "Unrecognized switch: -%s  (-h will show valid options)",s);
1210         }
1211     }
1212   switch_end:
1213
1214     if (
1215 #ifndef SECURE_INTERNAL_GETENV
1216         !PL_tainting &&
1217 #endif
1218         (popts = PerlEnv_getenv("PERL5OPT")))
1219     {
1220         s = savepv(popts);
1221         while (isSPACE(*s))
1222             s++;
1223         if (*s == '-' && *(s+1) == 'T')
1224             PL_tainting = TRUE;
1225         else {
1226             while (s && *s) {
1227                 char *d;
1228                 while (isSPACE(*s))
1229                     s++;
1230                 if (*s == '-') {
1231                     s++;
1232                     if (isSPACE(*s))
1233                         continue;
1234                 }
1235                 d = s;
1236                 if (!*s)
1237                     break;
1238                 if (!strchr("DIMUdmw", *s))
1239                     Perl_croak(aTHX_ "Illegal switch in PERL5OPT: -%c", *s);
1240                 while (++s && *s) {
1241                     if (isSPACE(*s)) {
1242                         *s++ = '\0';
1243                         break;
1244                     }
1245                 }
1246                 moreswitches(d);
1247             }
1248         }
1249     }
1250
1251     if (!scriptname)
1252         scriptname = argv[0];
1253     if (PL_e_script) {
1254         argc++,argv--;
1255         scriptname = BIT_BUCKET;        /* don't look for script or read stdin */
1256     }
1257     else if (scriptname == Nullch) {
1258 #ifdef MSDOS
1259         if ( PerlLIO_isatty(PerlIO_fileno(PerlIO_stdin())) )
1260             moreswitches("h");
1261 #endif
1262         scriptname = "-";
1263     }
1264
1265     init_perllib();
1266
1267     open_script(scriptname,dosearch,sv,&fdscript);
1268
1269     validate_suid(validarg, scriptname,fdscript);
1270
1271 #ifndef PERL_MICRO
1272 #if defined(SIGCHLD) || defined(SIGCLD)
1273     {
1274 #ifndef SIGCHLD
1275 #  define SIGCHLD SIGCLD
1276 #endif
1277         Sighandler_t sigstate = rsignal_state(SIGCHLD);
1278         if (sigstate == SIG_IGN) {
1279             if (ckWARN(WARN_SIGNAL))
1280                 Perl_warner(aTHX_ WARN_SIGNAL,
1281                             "Can't ignore signal CHLD, forcing to default");
1282             (void)rsignal(SIGCHLD, (Sighandler_t)SIG_DFL);
1283         }
1284     }
1285 #endif
1286 #endif
1287
1288 #ifdef MACOS_TRADITIONAL
1289     if (PL_doextract || gMacPerl_AlwaysExtract) {
1290 #else
1291     if (PL_doextract) {
1292 #endif
1293         find_beginning();
1294         if (cddir && PerlDir_chdir(cddir) < 0)
1295             Perl_croak(aTHX_ "Can't chdir to %s",cddir);
1296
1297     }
1298
1299     PL_main_cv = PL_compcv = (CV*)NEWSV(1104,0);
1300     sv_upgrade((SV *)PL_compcv, SVt_PVCV);
1301     CvUNIQUE_on(PL_compcv);
1302
1303     PL_comppad = newAV();
1304     av_push(PL_comppad, Nullsv);
1305     PL_curpad = AvARRAY(PL_comppad);
1306     PL_comppad_name = newAV();
1307     PL_comppad_name_fill = 0;
1308     PL_min_intro_pending = 0;
1309     PL_padix = 0;
1310 #ifdef USE_THREADS
1311     av_store(PL_comppad_name, 0, newSVpvn("@_", 2));
1312     PL_curpad[0] = (SV*)newAV();
1313     SvPADMY_on(PL_curpad[0]);   /* XXX Needed? */
1314     CvOWNER(PL_compcv) = 0;
1315     New(666, CvMUTEXP(PL_compcv), 1, perl_mutex);
1316     MUTEX_INIT(CvMUTEXP(PL_compcv));
1317 #endif /* USE_THREADS */
1318
1319     comppadlist = newAV();
1320     AvREAL_off(comppadlist);
1321     av_store(comppadlist, 0, (SV*)PL_comppad_name);
1322     av_store(comppadlist, 1, (SV*)PL_comppad);
1323     CvPADLIST(PL_compcv) = comppadlist;
1324
1325     boot_core_PerlIO();
1326     boot_core_UNIVERSAL();
1327 #ifndef PERL_MICRO
1328     boot_core_xsutils();
1329 #endif
1330
1331     if (xsinit)
1332         (*xsinit)(aTHXo);       /* in case linked C routines want magical variables */
1333 #ifndef PERL_MICRO
1334 #if defined(VMS) || defined(WIN32) || defined(DJGPP) || defined(__CYGWIN__) || defined(EPOC)
1335     init_os_extras();
1336 #endif
1337 #endif
1338
1339 #ifdef USE_SOCKS
1340 #   ifdef HAS_SOCKS5_INIT
1341     socks5_init(argv[0]);
1342 #   else
1343     SOCKSinit(argv[0]);
1344 #   endif
1345 #endif
1346
1347     init_predump_symbols();
1348     /* init_postdump_symbols not currently designed to be called */
1349     /* more than once (ENV isn't cleared first, for example)     */
1350     /* But running with -u leaves %ENV & @ARGV undefined!    XXX */
1351     if (!PL_do_undump)
1352         init_postdump_symbols(argc,argv,env);
1353
1354     init_lexer();
1355
1356     /* now parse the script */
1357
1358     SETERRNO(0,SS$_NORMAL);
1359     PL_error_count = 0;
1360 #ifdef MACOS_TRADITIONAL
1361     if (gMacPerl_SyntaxError = (yyparse() || PL_error_count)) {
1362         if (PL_minus_c)
1363             Perl_croak(aTHX_ "%s had compilation errors.\n", MacPerl_MPWFileName(PL_origfilename));
1364         else {
1365             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1366                        MacPerl_MPWFileName(PL_origfilename));
1367         }
1368     }
1369 #else
1370     if (yyparse() || PL_error_count) {
1371         if (PL_minus_c)
1372             Perl_croak(aTHX_ "%s had compilation errors.\n", PL_origfilename);
1373         else {
1374             Perl_croak(aTHX_ "Execution of %s aborted due to compilation errors.\n",
1375                        PL_origfilename);
1376         }
1377     }
1378 #endif
1379     CopLINE_set(PL_curcop, 0);
1380     PL_curstash = PL_defstash;
1381     PL_preprocess = FALSE;
1382     if (PL_e_script) {
1383         SvREFCNT_dec(PL_e_script);
1384         PL_e_script = Nullsv;
1385     }
1386
1387     /* now that script is parsed, we can modify record separator */
1388     SvREFCNT_dec(PL_rs);
1389     PL_rs = SvREFCNT_inc(PL_nrs);
1390     sv_setsv(get_sv("/", TRUE), PL_rs);
1391     if (PL_do_undump)
1392         my_unexec();
1393
1394     if (isWARN_ONCE) {
1395         SAVECOPFILE(PL_curcop);
1396         SAVECOPLINE(PL_curcop);
1397         gv_check(PL_defstash);
1398     }
1399
1400     LEAVE;
1401     FREETMPS;
1402
1403 #ifdef MYMALLOC
1404     if ((s=PerlEnv_getenv("PERL_DEBUG_MSTATS")) && atoi(s) >= 2)
1405         dump_mstats("after compilation:");
1406 #endif
1407
1408     ENTER;
1409     PL_restartop = 0;
1410     return NULL;
1411 }
1412
1413 /*
1414 =for apidoc perl_run
1415
1416 Tells a Perl interpreter to run.  See L<perlembed>.
1417
1418 =cut
1419 */
1420
1421 int
1422 perl_run(pTHXx)
1423 {
1424     I32 oldscope;
1425     int ret = 0;
1426     dJMPENV;
1427 #ifdef USE_THREADS
1428     dTHX;
1429 #endif
1430
1431     oldscope = PL_scopestack_ix;
1432
1433 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1434  redo_body:
1435     CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vrun_body), oldscope);
1436 #else
1437     JMPENV_PUSH(ret);
1438 #endif
1439     switch (ret) {
1440     case 1:
1441         cxstack_ix = -1;                /* start context stack again */
1442         goto redo_body;
1443     case 0:                             /* normal completion */
1444 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1445  redo_body:
1446         run_body(oldscope);
1447 #endif
1448         /* FALL THROUGH */
1449     case 2:                             /* my_exit() */
1450         while (PL_scopestack_ix > oldscope)
1451             LEAVE;
1452         FREETMPS;
1453         PL_curstash = PL_defstash;
1454         if (PL_endav && !PL_minus_c)
1455             call_list(oldscope, PL_endav);
1456 #ifdef MYMALLOC
1457         if (PerlEnv_getenv("PERL_DEBUG_MSTATS"))
1458             dump_mstats("after execution:  ");
1459 #endif
1460         ret = STATUS_NATIVE_EXPORT;
1461         break;
1462     case 3:
1463         if (PL_restartop) {
1464             POPSTACK_TO(PL_mainstack);
1465             goto redo_body;
1466         }
1467         PerlIO_printf(Perl_error_log, "panic: restartop\n");
1468         FREETMPS;
1469         ret = 1;
1470         break;
1471     }
1472
1473     JMPENV_POP;
1474     return ret;
1475 }
1476
1477 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1478 STATIC void *
1479 S_vrun_body(pTHX_ va_list args)
1480 {
1481     I32 oldscope = va_arg(args, I32);
1482
1483     return run_body(oldscope);
1484 }
1485 #endif
1486
1487
1488 STATIC void *
1489 S_run_body(pTHX_ I32 oldscope)
1490 {
1491     DEBUG_r(PerlIO_printf(Perl_debug_log, "%s $` $& $' support.\n",
1492                     PL_sawampersand ? "Enabling" : "Omitting"));
1493
1494     if (!PL_restartop) {
1495         DEBUG_x(dump_all());
1496         DEBUG(PerlIO_printf(Perl_debug_log, "\nEXECUTING...\n\n"));
1497         DEBUG_S(PerlIO_printf(Perl_debug_log, "main thread is 0x%"UVxf"\n",
1498                               PTR2UV(thr)));
1499
1500         if (PL_minus_c) {
1501 #ifdef MACOS_TRADITIONAL
1502             PerlIO_printf(Perl_error_log, "%s syntax OK\n", MacPerl_MPWFileName(PL_origfilename));
1503 #else
1504             PerlIO_printf(Perl_error_log, "%s syntax OK\n", PL_origfilename);
1505 #endif
1506             my_exit(0);
1507         }
1508         if (PERLDB_SINGLE && PL_DBsingle)
1509             sv_setiv(PL_DBsingle, 1);
1510         if (PL_initav)
1511             call_list(oldscope, PL_initav);
1512     }
1513
1514     /* do it */
1515
1516     if (PL_restartop) {
1517         PL_op = PL_restartop;
1518         PL_restartop = 0;
1519         CALLRUNOPS(aTHX);
1520     }
1521     else if (PL_main_start) {
1522         CvDEPTH(PL_main_cv) = 1;
1523         PL_op = PL_main_start;
1524         CALLRUNOPS(aTHX);
1525     }
1526
1527     my_exit(0);
1528     /* NOTREACHED */
1529     return NULL;
1530 }
1531
1532 /*
1533 =for apidoc p||get_sv
1534
1535 Returns the SV of the specified Perl scalar.  If C<create> is set and the
1536 Perl variable does not exist then it will be created.  If C<create> is not
1537 set and the variable does not exist then NULL is returned.
1538
1539 =cut
1540 */
1541
1542 SV*
1543 Perl_get_sv(pTHX_ const char *name, I32 create)
1544 {
1545     GV *gv;
1546 #ifdef USE_THREADS
1547     if (name[1] == '\0' && !isALPHA(name[0])) {
1548         PADOFFSET tmp = find_threadsv(name);
1549         if (tmp != NOT_IN_PAD)
1550             return THREADSV(tmp);
1551     }
1552 #endif /* USE_THREADS */
1553     gv = gv_fetchpv(name, create, SVt_PV);
1554     if (gv)
1555         return GvSV(gv);
1556     return Nullsv;
1557 }
1558
1559 /*
1560 =for apidoc p||get_av
1561
1562 Returns the AV of the specified Perl array.  If C<create> is set and the
1563 Perl variable does not exist then it will be created.  If C<create> is not
1564 set and the variable does not exist then NULL is returned.
1565
1566 =cut
1567 */
1568
1569 AV*
1570 Perl_get_av(pTHX_ const char *name, I32 create)
1571 {
1572     GV* gv = gv_fetchpv(name, create, SVt_PVAV);
1573     if (create)
1574         return GvAVn(gv);
1575     if (gv)
1576         return GvAV(gv);
1577     return Nullav;
1578 }
1579
1580 /*
1581 =for apidoc p||get_hv
1582
1583 Returns the HV of the specified Perl hash.  If C<create> is set and the
1584 Perl variable does not exist then it will be created.  If C<create> is not
1585 set and the variable does not exist then NULL is returned.
1586
1587 =cut
1588 */
1589
1590 HV*
1591 Perl_get_hv(pTHX_ const char *name, I32 create)
1592 {
1593     GV* gv = gv_fetchpv(name, create, SVt_PVHV);
1594     if (create)
1595         return GvHVn(gv);
1596     if (gv)
1597         return GvHV(gv);
1598     return Nullhv;
1599 }
1600
1601 /*
1602 =for apidoc p||get_cv
1603
1604 Returns the CV of the specified Perl subroutine.  If C<create> is set and
1605 the Perl subroutine does not exist then it will be declared (which has the
1606 same effect as saying C<sub name;>).  If C<create> is not set and the
1607 subroutine does not exist then NULL is returned.
1608
1609 =cut
1610 */
1611
1612 CV*
1613 Perl_get_cv(pTHX_ const char *name, I32 create)
1614 {
1615     GV* gv = gv_fetchpv(name, create, SVt_PVCV);
1616     /* XXX unsafe for threads if eval_owner isn't held */
1617     /* XXX this is probably not what they think they're getting.
1618      * It has the same effect as "sub name;", i.e. just a forward
1619      * declaration! */
1620     if (create && !GvCVu(gv))
1621         return newSUB(start_subparse(FALSE, 0),
1622                       newSVOP(OP_CONST, 0, newSVpv(name,0)),
1623                       Nullop,
1624                       Nullop);
1625     if (gv)
1626         return GvCVu(gv);
1627     return Nullcv;
1628 }
1629
1630 /* Be sure to refetch the stack pointer after calling these routines. */
1631
1632 /*
1633 =for apidoc p||call_argv
1634
1635 Performs a callback to the specified Perl sub.  See L<perlcall>.
1636
1637 =cut
1638 */
1639
1640 I32
1641 Perl_call_argv(pTHX_ const char *sub_name, I32 flags, register char **argv)
1642
1643                         /* See G_* flags in cop.h */
1644                         /* null terminated arg list */
1645 {
1646     dSP;
1647
1648     PUSHMARK(SP);
1649     if (argv) {
1650         while (*argv) {
1651             XPUSHs(sv_2mortal(newSVpv(*argv,0)));
1652             argv++;
1653         }
1654         PUTBACK;
1655     }
1656     return call_pv(sub_name, flags);
1657 }
1658
1659 /*
1660 =for apidoc p||call_pv
1661
1662 Performs a callback to the specified Perl sub.  See L<perlcall>.
1663
1664 =cut
1665 */
1666
1667 I32
1668 Perl_call_pv(pTHX_ const char *sub_name, I32 flags)
1669                         /* name of the subroutine */
1670                         /* See G_* flags in cop.h */
1671 {
1672     return call_sv((SV*)get_cv(sub_name, TRUE), flags);
1673 }
1674
1675 /*
1676 =for apidoc p||call_method
1677
1678 Performs a callback to the specified Perl method.  The blessed object must
1679 be on the stack.  See L<perlcall>.
1680
1681 =cut
1682 */
1683
1684 I32
1685 Perl_call_method(pTHX_ const char *methname, I32 flags)
1686                         /* name of the subroutine */
1687                         /* See G_* flags in cop.h */
1688 {
1689     return call_sv(sv_2mortal(newSVpv(methname,0)), flags | G_METHOD);
1690 }
1691
1692 /* May be called with any of a CV, a GV, or an SV containing the name. */
1693 /*
1694 =for apidoc p||call_sv
1695
1696 Performs a callback to the Perl sub whose name is in the SV.  See
1697 L<perlcall>.
1698
1699 =cut
1700 */
1701
1702 I32
1703 Perl_call_sv(pTHX_ SV *sv, I32 flags)
1704                         /* See G_* flags in cop.h */
1705 {
1706     dSP;
1707     LOGOP myop;         /* fake syntax tree node */
1708     UNOP method_op;
1709     I32 oldmark;
1710     volatile I32 retval = 0;
1711     I32 oldscope;
1712     bool oldcatch = CATCH_GET;
1713     int ret;
1714     OP* oldop = PL_op;
1715     dJMPENV;
1716
1717     if (flags & G_DISCARD) {
1718         ENTER;
1719         SAVETMPS;
1720     }
1721
1722     Zero(&myop, 1, LOGOP);
1723     myop.op_next = Nullop;
1724     if (!(flags & G_NOARGS))
1725         myop.op_flags |= OPf_STACKED;
1726     myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1727                       (flags & G_ARRAY) ? OPf_WANT_LIST :
1728                       OPf_WANT_SCALAR);
1729     SAVEOP();
1730     PL_op = (OP*)&myop;
1731
1732     EXTEND(PL_stack_sp, 1);
1733     *++PL_stack_sp = sv;
1734     oldmark = TOPMARK;
1735     oldscope = PL_scopestack_ix;
1736
1737     if (PERLDB_SUB && PL_curstash != PL_debstash
1738            /* Handle first BEGIN of -d. */
1739           && (PL_DBcv || (PL_DBcv = GvCV(PL_DBsub)))
1740            /* Try harder, since this may have been a sighandler, thus
1741             * curstash may be meaningless. */
1742           && (SvTYPE(sv) != SVt_PVCV || CvSTASH((CV*)sv) != PL_debstash)
1743           && !(flags & G_NODEBUG))
1744         PL_op->op_private |= OPpENTERSUB_DB;
1745
1746     if (flags & G_METHOD) {
1747         Zero(&method_op, 1, UNOP);
1748         method_op.op_next = PL_op;
1749         method_op.op_ppaddr = PL_ppaddr[OP_METHOD];
1750         myop.op_ppaddr = PL_ppaddr[OP_ENTERSUB];
1751         PL_op = (OP*)&method_op;
1752     }
1753
1754     if (!(flags & G_EVAL)) {
1755         CATCH_SET(TRUE);
1756         call_body((OP*)&myop, FALSE);
1757         retval = PL_stack_sp - (PL_stack_base + oldmark);
1758         CATCH_SET(oldcatch);
1759     }
1760     else {
1761         myop.op_other = (OP*)&myop;
1762         PL_markstack_ptr--;
1763         /* we're trying to emulate pp_entertry() here */
1764         {
1765             register PERL_CONTEXT *cx;
1766             I32 gimme = GIMME_V;
1767         
1768             ENTER;
1769             SAVETMPS;
1770         
1771             push_return(Nullop);
1772             PUSHBLOCK(cx, (CXt_EVAL|CXp_TRYBLOCK), PL_stack_sp);
1773             PUSHEVAL(cx, 0, 0);
1774             PL_eval_root = PL_op;             /* Only needed so that goto works right. */
1775         
1776             PL_in_eval = EVAL_INEVAL;
1777             if (flags & G_KEEPERR)
1778                 PL_in_eval |= EVAL_KEEPERR;
1779             else
1780                 sv_setpv(ERRSV,"");
1781         }
1782         PL_markstack_ptr++;
1783
1784 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1785  redo_body:
1786         CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
1787                     (OP*)&myop, FALSE);
1788 #else
1789         JMPENV_PUSH(ret);
1790 #endif
1791         switch (ret) {
1792         case 0:
1793 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1794  redo_body:
1795             call_body((OP*)&myop, FALSE);
1796 #endif
1797             retval = PL_stack_sp - (PL_stack_base + oldmark);
1798             if (!(flags & G_KEEPERR))
1799                 sv_setpv(ERRSV,"");
1800             break;
1801         case 1:
1802             STATUS_ALL_FAILURE;
1803             /* FALL THROUGH */
1804         case 2:
1805             /* my_exit() was called */
1806             PL_curstash = PL_defstash;
1807             FREETMPS;
1808             JMPENV_POP;
1809             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
1810                 Perl_croak(aTHX_ "Callback called exit");
1811             my_exit_jump();
1812             /* NOTREACHED */
1813         case 3:
1814             if (PL_restartop) {
1815                 PL_op = PL_restartop;
1816                 PL_restartop = 0;
1817                 goto redo_body;
1818             }
1819             PL_stack_sp = PL_stack_base + oldmark;
1820             if (flags & G_ARRAY)
1821                 retval = 0;
1822             else {
1823                 retval = 1;
1824                 *++PL_stack_sp = &PL_sv_undef;
1825             }
1826             break;
1827         }
1828
1829         if (PL_scopestack_ix > oldscope) {
1830             SV **newsp;
1831             PMOP *newpm;
1832             I32 gimme;
1833             register PERL_CONTEXT *cx;
1834             I32 optype;
1835
1836             POPBLOCK(cx,newpm);
1837             POPEVAL(cx);
1838             pop_return();
1839             PL_curpm = newpm;
1840             LEAVE;
1841         }
1842         JMPENV_POP;
1843     }
1844
1845     if (flags & G_DISCARD) {
1846         PL_stack_sp = PL_stack_base + oldmark;
1847         retval = 0;
1848         FREETMPS;
1849         LEAVE;
1850     }
1851     PL_op = oldop;
1852     return retval;
1853 }
1854
1855 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1856 STATIC void *
1857 S_vcall_body(pTHX_ va_list args)
1858 {
1859     OP *myop = va_arg(args, OP*);
1860     int is_eval = va_arg(args, int);
1861
1862     call_body(myop, is_eval);
1863     return NULL;
1864 }
1865 #endif
1866
1867 STATIC void
1868 S_call_body(pTHX_ OP *myop, int is_eval)
1869 {
1870     if (PL_op == myop) {
1871         if (is_eval)
1872             PL_op = Perl_pp_entereval(aTHX);    /* this doesn't do a POPMARK */
1873         else
1874             PL_op = Perl_pp_entersub(aTHX);     /* this does */
1875     }
1876     if (PL_op)
1877         CALLRUNOPS(aTHX);
1878 }
1879
1880 /* Eval a string. The G_EVAL flag is always assumed. */
1881
1882 /*
1883 =for apidoc p||eval_sv
1884
1885 Tells Perl to C<eval> the string in the SV.
1886
1887 =cut
1888 */
1889
1890 I32
1891 Perl_eval_sv(pTHX_ SV *sv, I32 flags)
1892
1893                         /* See G_* flags in cop.h */
1894 {
1895     dSP;
1896     UNOP myop;          /* fake syntax tree node */
1897     volatile I32 oldmark = SP - PL_stack_base;
1898     volatile I32 retval = 0;
1899     I32 oldscope;
1900     int ret;
1901     OP* oldop = PL_op;
1902     dJMPENV;
1903
1904     if (flags & G_DISCARD) {
1905         ENTER;
1906         SAVETMPS;
1907     }
1908
1909     SAVEOP();
1910     PL_op = (OP*)&myop;
1911     Zero(PL_op, 1, UNOP);
1912     EXTEND(PL_stack_sp, 1);
1913     *++PL_stack_sp = sv;
1914     oldscope = PL_scopestack_ix;
1915
1916     if (!(flags & G_NOARGS))
1917         myop.op_flags = OPf_STACKED;
1918     myop.op_next = Nullop;
1919     myop.op_type = OP_ENTEREVAL;
1920     myop.op_flags |= ((flags & G_VOID) ? OPf_WANT_VOID :
1921                       (flags & G_ARRAY) ? OPf_WANT_LIST :
1922                       OPf_WANT_SCALAR);
1923     if (flags & G_KEEPERR)
1924         myop.op_flags |= OPf_SPECIAL;
1925
1926 #ifdef PERL_FLEXIBLE_EXCEPTIONS
1927  redo_body:
1928     CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_body),
1929                 (OP*)&myop, TRUE);
1930 #else
1931     JMPENV_PUSH(ret);
1932 #endif
1933     switch (ret) {
1934     case 0:
1935 #ifndef PERL_FLEXIBLE_EXCEPTIONS
1936  redo_body:
1937         call_body((OP*)&myop,TRUE);
1938 #endif
1939         retval = PL_stack_sp - (PL_stack_base + oldmark);
1940         if (!(flags & G_KEEPERR))
1941             sv_setpv(ERRSV,"");
1942         break;
1943     case 1:
1944         STATUS_ALL_FAILURE;
1945         /* FALL THROUGH */
1946     case 2:
1947         /* my_exit() was called */
1948         PL_curstash = PL_defstash;
1949         FREETMPS;
1950         JMPENV_POP;
1951         if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED))
1952             Perl_croak(aTHX_ "Callback called exit");
1953         my_exit_jump();
1954         /* NOTREACHED */
1955     case 3:
1956         if (PL_restartop) {
1957             PL_op = PL_restartop;
1958             PL_restartop = 0;
1959             goto redo_body;
1960         }
1961         PL_stack_sp = PL_stack_base + oldmark;
1962         if (flags & G_ARRAY)
1963             retval = 0;
1964         else {
1965             retval = 1;
1966             *++PL_stack_sp = &PL_sv_undef;
1967         }
1968         break;
1969     }
1970
1971     JMPENV_POP;
1972     if (flags & G_DISCARD) {
1973         PL_stack_sp = PL_stack_base + oldmark;
1974         retval = 0;
1975         FREETMPS;
1976         LEAVE;
1977     }
1978     PL_op = oldop;
1979     return retval;
1980 }
1981
1982 /*
1983 =for apidoc p||eval_pv
1984
1985 Tells Perl to C<eval> the given string and return an SV* result.
1986
1987 =cut
1988 */
1989
1990 SV*
1991 Perl_eval_pv(pTHX_ const char *p, I32 croak_on_error)
1992 {
1993     dSP;
1994     SV* sv = newSVpv(p, 0);
1995
1996     eval_sv(sv, G_SCALAR);
1997     SvREFCNT_dec(sv);
1998
1999     SPAGAIN;
2000     sv = POPs;
2001     PUTBACK;
2002
2003     if (croak_on_error && SvTRUE(ERRSV)) {
2004         STRLEN n_a;
2005         Perl_croak(aTHX_ SvPVx(ERRSV, n_a));
2006     }
2007
2008     return sv;
2009 }
2010
2011 /* Require a module. */
2012
2013 /*
2014 =for apidoc p||require_pv
2015
2016 Tells Perl to C<require> the file named by the string argument.  It is
2017 analogous to the Perl code C<eval "require '$file'">.  It's even
2018 implemented that way; consider using Perl_load_module instead.
2019
2020 =cut */
2021
2022 void
2023 Perl_require_pv(pTHX_ const char *pv)
2024 {
2025     SV* sv;
2026     dSP;
2027     PUSHSTACKi(PERLSI_REQUIRE);
2028     PUTBACK;
2029     sv = sv_newmortal();
2030     sv_setpv(sv, "require '");
2031     sv_catpv(sv, pv);
2032     sv_catpv(sv, "'");
2033     eval_sv(sv, G_DISCARD);
2034     SPAGAIN;
2035     POPSTACK;
2036 }
2037
2038 void
2039 Perl_magicname(pTHX_ char *sym, char *name, I32 namlen)
2040 {
2041     register GV *gv;
2042
2043     if ((gv = gv_fetchpv(sym,TRUE, SVt_PV)))
2044         sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, namlen);
2045 }
2046
2047 STATIC void
2048 S_usage(pTHX_ char *name)               /* XXX move this out into a module ? */
2049 {
2050     /* This message really ought to be max 23 lines.
2051      * Removed -h because the user already knows that option. Others? */
2052
2053     static char *usage_msg[] = {
2054 "-0[octal]       specify record separator (\\0, if no argument)",
2055 "-a              autosplit mode with -n or -p (splits $_ into @F)",
2056 "-C              enable native wide character system interfaces",
2057 "-c              check syntax only (runs BEGIN and CHECK blocks)",
2058 "-d[:debugger]   run program under debugger",
2059 "-D[number/list] set debugging flags (argument is a bit mask or alphabets)",
2060 "-e 'command'    one line of program (several -e's allowed, omit programfile)",
2061 "-F/pattern/     split() pattern for -a switch (//'s are optional)",
2062 "-i[extension]   edit <> files in place (makes backup if extension supplied)",
2063 "-Idirectory     specify @INC/#include directory (several -I's allowed)",
2064 "-l[octal]       enable line ending processing, specifies line terminator",
2065 "-[mM][-]module  execute `use/no module...' before executing program",
2066 "-n              assume 'while (<>) { ... }' loop around program",
2067 "-p              assume loop like -n but print line also, like sed",
2068 "-P              run program through C preprocessor before compilation",
2069 "-s              enable rudimentary parsing for switches after programfile",
2070 "-S              look for programfile using PATH environment variable",
2071 "-T              enable tainting checks",
2072 "-u              dump core after parsing program",
2073 "-U              allow unsafe operations",
2074 "-v              print version, subversion (includes VERY IMPORTANT perl info)",
2075 "-V[:variable]   print configuration summary (or a single Config.pm variable)",
2076 "-w              enable many useful warnings (RECOMMENDED)",
2077 "-W              enable all warnings",
2078 "-X              disable all warnings",
2079 "-x[directory]   strip off text before #!perl line and perhaps cd to directory",
2080 "\n",
2081 NULL
2082 };
2083     char **p = usage_msg;
2084
2085     PerlIO_printf(PerlIO_stdout(),
2086                   "\nUsage: %s [switches] [--] [programfile] [arguments]",
2087                   name);
2088     while (*p)
2089         PerlIO_printf(PerlIO_stdout(), "\n  %s", *p++);
2090 }
2091
2092 /* This routine handles any switches that can be given during run */
2093
2094 char *
2095 Perl_moreswitches(pTHX_ char *s)
2096 {
2097     STRLEN numlen;
2098     U32 rschar;
2099
2100     switch (*s) {
2101     case '0':
2102     {
2103         numlen = 0;                     /* disallow underscores */
2104         rschar = (U32)scan_oct(s, 4, &numlen);
2105         SvREFCNT_dec(PL_nrs);
2106         if (rschar & ~((U8)~0))
2107             PL_nrs = &PL_sv_undef;
2108         else if (!rschar && numlen >= 2)
2109             PL_nrs = newSVpvn("", 0);
2110         else {
2111             char ch = rschar;
2112             PL_nrs = newSVpvn(&ch, 1);
2113         }
2114         return s + numlen;
2115     }
2116     case 'C':
2117         PL_widesyscalls = TRUE;
2118         s++;
2119         return s;
2120     case 'F':
2121         PL_minus_F = TRUE;
2122         PL_splitstr = savepv(s + 1);
2123         s += strlen(s);
2124         return s;
2125     case 'a':
2126         PL_minus_a = TRUE;
2127         s++;
2128         return s;
2129     case 'c':
2130         PL_minus_c = TRUE;
2131         s++;
2132         return s;
2133     case 'd':
2134         forbid_setid("-d");
2135         s++;
2136         /* The following permits -d:Mod to accepts arguments following an =
2137            in the fashion that -MSome::Mod does. */
2138         if (*s == ':' || *s == '=') {
2139             char *start;
2140             SV *sv;
2141             sv = newSVpv("use Devel::", 0);
2142             start = ++s;
2143             /* We now allow -d:Module=Foo,Bar */
2144             while(isALNUM(*s) || *s==':') ++s;
2145             if (*s != '=')
2146                 sv_catpv(sv, start);
2147             else {
2148                 sv_catpvn(sv, start, s-start);
2149                 sv_catpv(sv, " split(/,/,q{");
2150                 sv_catpv(sv, ++s);
2151                 sv_catpv(sv,    "})");
2152             }
2153             s += strlen(s);
2154             my_setenv("PERL5DB", SvPV(sv, PL_na));
2155         }
2156         if (!PL_perldb) {
2157             PL_perldb = PERLDB_ALL;
2158             init_debugger();
2159         }
2160         return s;
2161     case 'D':
2162     {   
2163 #ifdef DEBUGGING
2164         forbid_setid("-D");
2165         if (isALPHA(s[1])) {
2166             /* if adding extra options, remember to update DEBUG_MASK */
2167             static char debopts[] = "psltocPmfrxuLHXDSTR";
2168             char *d;
2169
2170             for (s++; *s && (d = strchr(debopts,*s)); s++)
2171                 PL_debug |= 1 << (d - debopts);
2172         }
2173         else {
2174             PL_debug = atoi(s+1);
2175             for (s++; isDIGIT(*s); s++) ;
2176         }
2177         PL_debug |= DEBUG_TOP_FLAG;
2178 #else
2179         if (ckWARN_d(WARN_DEBUGGING))
2180             Perl_warner(aTHX_ WARN_DEBUGGING,
2181                    "Recompile perl with -DDEBUGGING to use -D switch\n");
2182         for (s++; isALNUM(*s); s++) ;
2183 #endif
2184         /*SUPPRESS 530*/
2185         return s;
2186     }   
2187     case 'h':
2188         usage(PL_origargv[0]);
2189         PerlProc_exit(0);
2190     case 'i':
2191         if (PL_inplace)
2192             Safefree(PL_inplace);
2193         PL_inplace = savepv(s+1);
2194         /*SUPPRESS 530*/
2195         for (s = PL_inplace; *s && !isSPACE(*s); s++) ;
2196         if (*s) {
2197             *s++ = '\0';
2198             if (*s == '-')      /* Additional switches on #! line. */
2199                 s++;
2200         }
2201         return s;
2202     case 'I':   /* -I handled both here and in parse_perl() */
2203         forbid_setid("-I");
2204         ++s;
2205         while (*s && isSPACE(*s))
2206             ++s;
2207         if (*s) {
2208             char *e, *p;
2209             p = s;
2210             /* ignore trailing spaces (possibly followed by other switches) */
2211             do {
2212                 for (e = p; *e && !isSPACE(*e); e++) ;
2213                 p = e;
2214                 while (isSPACE(*p))
2215                     p++;
2216             } while (*p && *p != '-');
2217             e = savepvn(s, e-s);
2218             incpush(e, TRUE, TRUE);
2219             Safefree(e);
2220             s = p;
2221             if (*s == '-')
2222                 s++;
2223         }
2224         else
2225             Perl_croak(aTHX_ "No directory specified for -I");
2226         return s;
2227     case 'l':
2228         PL_minus_l = TRUE;
2229         s++;
2230         if (PL_ors_sv) {
2231             SvREFCNT_dec(PL_ors_sv);
2232             PL_ors_sv = Nullsv;
2233         }
2234         if (isDIGIT(*s)) {
2235             PL_ors_sv = newSVpvn("\n",1);
2236             numlen = 0;                 /* disallow underscores */
2237             *SvPVX(PL_ors_sv) = (char)scan_oct(s, 3 + (*s == '0'), &numlen);
2238             s += numlen;
2239         }
2240         else {
2241             if (RsPARA(PL_nrs)) {
2242                 PL_ors_sv = newSVpvn("\n\n",2);
2243             }
2244             else {
2245                 PL_ors_sv = newSVsv(PL_nrs);
2246             }
2247         }
2248         return s;
2249     case 'M':
2250         forbid_setid("-M");     /* XXX ? */
2251         /* FALL THROUGH */
2252     case 'm':
2253         forbid_setid("-m");     /* XXX ? */
2254         if (*++s) {
2255             char *start;
2256             SV *sv;
2257             char *use = "use ";
2258             /* -M-foo == 'no foo'       */
2259             if (*s == '-') { use = "no "; ++s; }
2260             sv = newSVpv(use,0);
2261             start = s;
2262             /* We allow -M'Module qw(Foo Bar)'  */
2263             while(isALNUM(*s) || *s==':') ++s;
2264             if (*s != '=') {
2265                 sv_catpv(sv, start);
2266                 if (*(start-1) == 'm') {
2267                     if (*s != '\0')
2268                         Perl_croak(aTHX_ "Can't use '%c' after -mname", *s);
2269                     sv_catpv( sv, " ()");
2270                 }
2271             } else {
2272                 if (s == start)
2273                     Perl_croak(aTHX_ "Module name required with -%c option",
2274                                s[-1]);
2275                 sv_catpvn(sv, start, s-start);
2276                 sv_catpv(sv, " split(/,/,q{");
2277                 sv_catpv(sv, ++s);
2278                 sv_catpv(sv,    "})");
2279             }
2280             s += strlen(s);
2281             if (!PL_preambleav)
2282                 PL_preambleav = newAV();
2283             av_push(PL_preambleav, sv);
2284         }
2285         else
2286             Perl_croak(aTHX_ "No space allowed after -%c", *(s-1));
2287         return s;
2288     case 'n':
2289         PL_minus_n = TRUE;
2290         s++;
2291         return s;
2292     case 'p':
2293         PL_minus_p = TRUE;
2294         s++;
2295         return s;
2296     case 's':
2297         forbid_setid("-s");
2298         PL_doswitches = TRUE;
2299         s++;
2300         return s;
2301     case 'T':
2302         if (!PL_tainting)
2303             Perl_croak(aTHX_ "Too late for \"-T\" option");
2304         s++;
2305         return s;
2306     case 'u':
2307 #ifdef MACOS_TRADITIONAL
2308         Perl_croak(aTHX_ "Believe me, you don't want to use \"-u\" on a Macintosh");
2309 #endif
2310         PL_do_undump = TRUE;
2311         s++;
2312         return s;
2313     case 'U':
2314         PL_unsafe = TRUE;
2315         s++;
2316         return s;
2317     case 'v':
2318 #if !defined(DGUX)
2319         PerlIO_printf(PerlIO_stdout(),
2320                       Perl_form(aTHX_ "\nThis is perl, v%"VDf" built for %s",
2321                                 PL_patchlevel, ARCHNAME));
2322 #else /* DGUX */
2323 /* Adjust verbose output as in the perl that ships with the DG/UX OS from EMC */
2324         PerlIO_printf(PerlIO_stdout(),
2325                         Perl_form(aTHX_ "\nThis is perl, version %vd\n", PL_patchlevel));
2326         PerlIO_printf(PerlIO_stdout(),
2327                         Perl_form(aTHX_ "        built under %s at %s %s\n",
2328                                         OSNAME, __DATE__, __TIME__));
2329         PerlIO_printf(PerlIO_stdout(),
2330                         Perl_form(aTHX_ "        OS Specific Release: %s\n",
2331                                         OSVERS));
2332 #endif /* !DGUX */
2333
2334 #if defined(LOCAL_PATCH_COUNT)
2335         if (LOCAL_PATCH_COUNT > 0)
2336             PerlIO_printf(PerlIO_stdout(),
2337                           "\n(with %d registered patch%s, "
2338                           "see perl -V for more detail)",
2339                           (int)LOCAL_PATCH_COUNT,
2340                           (LOCAL_PATCH_COUNT!=1) ? "es" : "");
2341 #endif
2342
2343         PerlIO_printf(PerlIO_stdout(),
2344                       "\n\nCopyright 1987-2001, Larry Wall\n");
2345 #ifdef MACOS_TRADITIONAL
2346         PerlIO_printf(PerlIO_stdout(),
2347                       "\nMac OS port Copyright (c) 1991-2001, Matthias Neeracher\n");
2348 #endif
2349 #ifdef MSDOS
2350         PerlIO_printf(PerlIO_stdout(),
2351                       "\nMS-DOS port Copyright (c) 1989, 1990, Diomidis Spinellis\n");
2352 #endif
2353 #ifdef DJGPP
2354         PerlIO_printf(PerlIO_stdout(),
2355                       "djgpp v2 port (jpl5003c) by Hirofumi Watanabe, 1996\n"
2356                       "djgpp v2 port (perl5004+) by Laszlo Molnar, 1997-1999\n");
2357 #endif
2358 #ifdef OS2
2359         PerlIO_printf(PerlIO_stdout(),
2360                       "\n\nOS/2 port Copyright (c) 1990, 1991, Raymond Chen, Kai Uwe Rommel\n"
2361                       "Version 5 port Copyright (c) 1994-1999, Andreas Kaiser, Ilya Zakharevich\n");
2362 #endif
2363 #ifdef atarist
2364         PerlIO_printf(PerlIO_stdout(),
2365                       "atariST series port, ++jrb  bammi@cadence.com\n");
2366 #endif
2367 #ifdef __BEOS__
2368         PerlIO_printf(PerlIO_stdout(),
2369                       "BeOS port Copyright Tom Spindler, 1997-1999\n");
2370 #endif
2371 #ifdef MPE
2372         PerlIO_printf(PerlIO_stdout(),
2373                       "MPE/iX port Copyright by Mark Klein and Mark Bixby, 1996-2001\n");
2374 #endif
2375 #ifdef OEMVS
2376         PerlIO_printf(PerlIO_stdout(),
2377                       "MVS (OS390) port by Mortice Kern Systems, 1997-1999\n");
2378 #endif
2379 #ifdef __VOS__
2380         PerlIO_printf(PerlIO_stdout(),
2381                       "Stratus VOS port by Paul_Green@stratus.com, 1997-1999\n");
2382 #endif
2383 #ifdef __OPEN_VM
2384         PerlIO_printf(PerlIO_stdout(),
2385                       "VM/ESA port by Neale Ferguson, 1998-1999\n");
2386 #endif
2387 #ifdef POSIX_BC
2388         PerlIO_printf(PerlIO_stdout(),
2389                       "BS2000 (POSIX) port by Start Amadeus GmbH, 1998-1999\n");
2390 #endif
2391 #ifdef __MINT__
2392         PerlIO_printf(PerlIO_stdout(),
2393                       "MiNT port by Guido Flohr, 1997-1999\n");
2394 #endif
2395 #ifdef EPOC
2396         PerlIO_printf(PerlIO_stdout(),
2397                       "EPOC port by Olaf Flebbe, 1999-2000\n");
2398 #endif
2399 #ifdef BINARY_BUILD_NOTICE
2400         BINARY_BUILD_NOTICE;
2401 #endif
2402         PerlIO_printf(PerlIO_stdout(),
2403                       "\n\
2404 Perl may be copied only under the terms of either the Artistic License or the\n\
2405 GNU General Public License, which may be found in the Perl 5 source kit.\n\n\
2406 Complete documentation for Perl, including FAQ lists, should be found on\n\
2407 this system using `man perl' or `perldoc perl'.  If you have access to the\n\
2408 Internet, point your browser at http://www.perl.com/, the Perl Home Page.\n\n");
2409         PerlProc_exit(0);
2410     case 'w':
2411         if (! (PL_dowarn & G_WARN_ALL_MASK))
2412             PL_dowarn |= G_WARN_ON;
2413         s++;
2414         return s;
2415     case 'W':
2416         PL_dowarn = G_WARN_ALL_ON|G_WARN_ON;
2417         PL_compiling.cop_warnings = pWARN_ALL ;
2418         s++;
2419         return s;
2420     case 'X':
2421         PL_dowarn = G_WARN_ALL_OFF;
2422         PL_compiling.cop_warnings = pWARN_NONE ;
2423         s++;
2424         return s;
2425     case '*':
2426     case ' ':
2427         if (s[1] == '-')        /* Additional switches on #! line. */
2428             return s+2;
2429         break;
2430     case '-':
2431     case 0:
2432 #if defined(WIN32) || !defined(PERL_STRICT_CR)
2433     case '\r':
2434 #endif
2435     case '\n':
2436     case '\t':
2437         break;
2438 #ifdef ALTERNATE_SHEBANG
2439     case 'S':                   /* OS/2 needs -S on "extproc" line. */
2440         break;
2441 #endif
2442     case 'P':
2443         if (PL_preprocess)
2444             return s+1;
2445         /* FALL THROUGH */
2446     default:
2447         Perl_croak(aTHX_ "Can't emulate -%.1s on #! line",s);
2448     }
2449     return Nullch;
2450 }
2451
2452 /* compliments of Tom Christiansen */
2453
2454 /* unexec() can be found in the Gnu emacs distribution */
2455 /* Known to work with -DUNEXEC and using unexelf.c from GNU emacs-20.2 */
2456
2457 void
2458 Perl_my_unexec(pTHX)
2459 {
2460 #ifdef UNEXEC
2461     SV*    prog;
2462     SV*    file;
2463     int    status = 1;
2464     extern int etext;
2465
2466     prog = newSVpv(BIN_EXP, 0);
2467     sv_catpv(prog, "/perl");
2468     file = newSVpv(PL_origfilename, 0);
2469     sv_catpv(file, ".perldump");
2470
2471     unexec(SvPVX(file), SvPVX(prog), &etext, sbrk(0), 0);
2472     /* unexec prints msg to stderr in case of failure */
2473     PerlProc_exit(status);
2474 #else
2475 #  ifdef VMS
2476 #    include <lib$routines.h>
2477      lib$signal(SS$_DEBUG);  /* ssdef.h #included from vmsish.h */
2478 #  else
2479     ABORT();            /* for use with undump */
2480 #  endif
2481 #endif
2482 }
2483
2484 /* initialize curinterp */
2485 STATIC void
2486 S_init_interp(pTHX)
2487 {
2488
2489 #ifdef PERL_OBJECT              /* XXX kludge */
2490 #define I_REINIT \
2491   STMT_START {                          \
2492     PL_chopset          = " \n-";       \
2493     PL_copline          = NOLINE;       \
2494     PL_curcop           = &PL_compiling;\
2495     PL_curcopdb         = NULL;         \
2496     PL_dbargs           = 0;            \
2497     PL_dumpindent       = 4;            \
2498     PL_laststatval      = -1;           \
2499     PL_laststype        = OP_STAT;      \
2500     PL_maxscream        = -1;           \
2501     PL_maxsysfd         = MAXSYSFD;     \
2502     PL_statname         = Nullsv;       \
2503     PL_tmps_floor       = -1;           \
2504     PL_tmps_ix          = -1;           \
2505     PL_op_mask          = NULL;         \
2506     PL_laststatval      = -1;           \
2507     PL_laststype        = OP_STAT;      \
2508     PL_mess_sv          = Nullsv;       \
2509     PL_splitstr         = " ";          \
2510     PL_generation       = 100;          \
2511     PL_exitlist         = NULL;         \
2512     PL_exitlistlen      = 0;            \
2513     PL_regindent        = 0;            \
2514     PL_in_clean_objs    = FALSE;        \
2515     PL_in_clean_all     = FALSE;        \
2516     PL_profiledata      = NULL;         \
2517     PL_rsfp             = Nullfp;       \
2518     PL_rsfp_filters     = Nullav;       \
2519     PL_dirty            = FALSE;        \
2520   } STMT_END
2521     I_REINIT;
2522 #else
2523 #  ifdef MULTIPLICITY
2524 #    define PERLVAR(var,type)
2525 #    define PERLVARA(var,n,type)
2526 #    if defined(PERL_IMPLICIT_CONTEXT)
2527 #      if defined(USE_THREADS)
2528 #        define PERLVARI(var,type,init)         PERL_GET_INTERP->var = init;
2529 #        define PERLVARIC(var,type,init)        PERL_GET_INTERP->var = init;
2530 #      else /* !USE_THREADS */
2531 #        define PERLVARI(var,type,init)         aTHX->var = init;
2532 #        define PERLVARIC(var,type,init)        aTHX->var = init;
2533 #      endif /* USE_THREADS */
2534 #    else
2535 #      define PERLVARI(var,type,init)   PERL_GET_INTERP->var = init;
2536 #      define PERLVARIC(var,type,init)  PERL_GET_INTERP->var = init;
2537 #    endif
2538 #    include "intrpvar.h"
2539 #    ifndef USE_THREADS
2540 #      include "thrdvar.h"
2541 #    endif
2542 #    undef PERLVAR
2543 #    undef PERLVARA
2544 #    undef PERLVARI
2545 #    undef PERLVARIC
2546 #  else
2547 #    define PERLVAR(var,type)
2548 #    define PERLVARA(var,n,type)
2549 #    define PERLVARI(var,type,init)     PL_##var = init;
2550 #    define PERLVARIC(var,type,init)    PL_##var = init;
2551 #    include "intrpvar.h"
2552 #    ifndef USE_THREADS
2553 #      include "thrdvar.h"
2554 #    endif
2555 #    undef PERLVAR
2556 #    undef PERLVARA
2557 #    undef PERLVARI
2558 #    undef PERLVARIC
2559 #  endif
2560 #endif
2561
2562 }
2563
2564 STATIC void
2565 S_init_main_stash(pTHX)
2566 {
2567     GV *gv;
2568
2569     /* Note that strtab is a rather special HV.  Assumptions are made
2570        about not iterating on it, and not adding tie magic to it.
2571        It is properly deallocated in perl_destruct() */
2572     PL_strtab = newHV();
2573 #ifdef USE_THREADS
2574     MUTEX_INIT(&PL_strtab_mutex);
2575 #endif
2576     HvSHAREKEYS_off(PL_strtab);                 /* mandatory */
2577     hv_ksplit(PL_strtab, 512);
2578
2579     PL_curstash = PL_defstash = newHV();
2580     PL_curstname = newSVpvn("main",4);
2581     gv = gv_fetchpv("main::",TRUE, SVt_PVHV);
2582     SvREFCNT_dec(GvHV(gv));
2583     GvHV(gv) = (HV*)SvREFCNT_inc(PL_defstash);
2584     SvREADONLY_on(gv);
2585     HvNAME(PL_defstash) = savepv("main");
2586     PL_incgv = gv_HVadd(gv_AVadd(gv_fetchpv("INC",TRUE, SVt_PVAV)));
2587     GvMULTI_on(PL_incgv);
2588     PL_hintgv = gv_fetchpv("\010",TRUE, SVt_PV); /* ^H */
2589     GvMULTI_on(PL_hintgv);
2590     PL_defgv = gv_fetchpv("_",TRUE, SVt_PVAV);
2591     PL_errgv = gv_HVadd(gv_fetchpv("@", TRUE, SVt_PV));
2592     GvMULTI_on(PL_errgv);
2593     PL_replgv = gv_fetchpv("\022", TRUE, SVt_PV); /* ^R */
2594     GvMULTI_on(PL_replgv);
2595     (void)Perl_form(aTHX_ "%240s","");  /* Preallocate temp - for immediate signals. */
2596     sv_grow(ERRSV, 240);        /* Preallocate - for immediate signals. */
2597     sv_setpvn(ERRSV, "", 0);
2598     PL_curstash = PL_defstash;
2599     CopSTASH_set(&PL_compiling, PL_defstash);
2600     PL_debstash = GvHV(gv_fetchpv("DB::", GV_ADDMULTI, SVt_PVHV));
2601     PL_globalstash = GvHV(gv_fetchpv("CORE::GLOBAL::", GV_ADDMULTI, SVt_PVHV));
2602     PL_nullstash = GvHV(gv_fetchpv("<none>::", GV_ADDMULTI, SVt_PVHV));
2603     /* We must init $/ before switches are processed. */
2604     sv_setpvn(get_sv("/", TRUE), "\n", 1);
2605 }
2606
2607 STATIC void
2608 S_open_script(pTHX_ char *scriptname, bool dosearch, SV *sv, int *fdscript)
2609 {
2610     *fdscript = -1;
2611
2612     if (PL_e_script) {
2613         PL_origfilename = savepv("-e");
2614     }
2615     else {
2616         /* if find_script() returns, it returns a malloc()-ed value */
2617         PL_origfilename = scriptname = find_script(scriptname, dosearch, NULL, 1);
2618
2619         if (strnEQ(scriptname, "/dev/fd/", 8) && isDIGIT(scriptname[8]) ) {
2620             char *s = scriptname + 8;
2621             *fdscript = atoi(s);
2622             while (isDIGIT(*s))
2623                 s++;
2624             if (*s) {
2625                 scriptname = savepv(s + 1);
2626                 Safefree(PL_origfilename);
2627                 PL_origfilename = scriptname;
2628             }
2629         }
2630     }
2631
2632 #ifdef USE_ITHREADS
2633     Safefree(CopFILE(PL_curcop));
2634 #else
2635     SvREFCNT_dec(CopFILEGV(PL_curcop));
2636 #endif
2637     CopFILE_set(PL_curcop, PL_origfilename);
2638     if (strEQ(PL_origfilename,"-"))
2639         scriptname = "";
2640     if (*fdscript >= 0) {
2641         PL_rsfp = PerlIO_fdopen(*fdscript,PERL_SCRIPT_MODE);
2642 #if defined(HAS_FCNTL) && defined(F_SETFD)
2643         if (PL_rsfp)
2644             fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);  /* ensure close-on-exec */
2645 #endif
2646     }
2647     else if (PL_preprocess) {
2648         char *cpp_cfg = CPPSTDIN;
2649         SV *cpp = newSVpvn("",0);
2650         SV *cmd = NEWSV(0,0);
2651
2652         if (strEQ(cpp_cfg, "cppstdin"))
2653             Perl_sv_catpvf(aTHX_ cpp, "%s/", BIN_EXP);
2654         sv_catpv(cpp, cpp_cfg);
2655
2656         sv_catpvn(sv, "-I", 2);
2657         sv_catpv(sv,PRIVLIB_EXP);
2658
2659         DEBUG_P(PerlIO_printf(Perl_debug_log,
2660                               "PL_preprocess: scriptname=\"%s\", cpp=\"%s\", sv=\"%s\", CPPMINUS=\"%s\"\n",
2661                               scriptname, SvPVX (cpp), SvPVX (sv), CPPMINUS));
2662 #if defined(MSDOS) || defined(WIN32)
2663         Perl_sv_setpvf(aTHX_ cmd, "\
2664 sed %s -e \"/^[^#]/b\" \
2665  -e \"/^#[      ]*include[      ]/b\" \
2666  -e \"/^#[      ]*define[       ]/b\" \
2667  -e \"/^#[      ]*if[   ]/b\" \
2668  -e \"/^#[      ]*ifdef[        ]/b\" \
2669  -e \"/^#[      ]*ifndef[       ]/b\" \
2670  -e \"/^#[      ]*else/b\" \
2671  -e \"/^#[      ]*elif[         ]/b\" \
2672  -e \"/^#[      ]*undef[        ]/b\" \
2673  -e \"/^#[      ]*endif/b\" \
2674  -e \"s/^#.*//\" \
2675  %s | %"SVf" -C %"SVf" %s",
2676           (PL_doextract ? "-e \"1,/^#/d\n\"" : ""),
2677 #else
2678 #  ifdef __OPEN_VM
2679         Perl_sv_setpvf(aTHX_ cmd, "\
2680 %s %s -e '/^[^#]/b' \
2681  -e '/^#[       ]*include[      ]/b' \
2682  -e '/^#[       ]*define[       ]/b' \
2683  -e '/^#[       ]*if[   ]/b' \
2684  -e '/^#[       ]*ifdef[        ]/b' \
2685  -e '/^#[       ]*ifndef[       ]/b' \
2686  -e '/^#[       ]*else/b' \
2687  -e '/^#[       ]*elif[         ]/b' \
2688  -e '/^#[       ]*undef[        ]/b' \
2689  -e '/^#[       ]*endif/b' \
2690  -e 's/^[       ]*#.*//' \
2691  %s | %"SVf" %"SVf" %s",
2692 #  else
2693         Perl_sv_setpvf(aTHX_ cmd, "\
2694 %s %s -e '/^[^#]/b' \
2695  -e '/^#[       ]*include[      ]/b' \
2696  -e '/^#[       ]*define[       ]/b' \
2697  -e '/^#[       ]*if[   ]/b' \
2698  -e '/^#[       ]*ifdef[        ]/b' \
2699  -e '/^#[       ]*ifndef[       ]/b' \
2700  -e '/^#[       ]*else/b' \
2701  -e '/^#[       ]*elif[         ]/b' \
2702  -e '/^#[       ]*undef[        ]/b' \
2703  -e '/^#[       ]*endif/b' \
2704  -e 's/^[       ]*#.*//' \
2705  %s | %"SVf" -C %"SVf" %s",
2706 #  endif
2707 #ifdef LOC_SED
2708           LOC_SED,
2709 #else
2710           "sed",
2711 #endif
2712           (PL_doextract ? "-e '1,/^#/d\n'" : ""),
2713 #endif
2714           scriptname, cpp, sv, CPPMINUS);
2715         PL_doextract = FALSE;
2716 #ifdef IAMSUID                          /* actually, this is caught earlier */
2717         if (PL_euid != PL_uid && !PL_euid) {    /* if running suidperl */
2718 #ifdef HAS_SETEUID
2719             (void)seteuid(PL_uid);              /* musn't stay setuid root */
2720 #else
2721 #ifdef HAS_SETREUID
2722             (void)setreuid((Uid_t)-1, PL_uid);
2723 #else
2724 #ifdef HAS_SETRESUID
2725             (void)setresuid((Uid_t)-1, PL_uid, (Uid_t)-1);
2726 #else
2727             PerlProc_setuid(PL_uid);
2728 #endif
2729 #endif
2730 #endif
2731             if (PerlProc_geteuid() != PL_uid)
2732                 Perl_croak(aTHX_ "Can't do seteuid!\n");
2733         }
2734 #endif /* IAMSUID */
2735         PL_rsfp = PerlProc_popen(SvPVX(cmd), "r");
2736         SvREFCNT_dec(cmd);
2737         SvREFCNT_dec(cpp);
2738     }
2739     else if (!*scriptname) {
2740         forbid_setid("program input from stdin");
2741         PL_rsfp = PerlIO_stdin();
2742     }
2743     else {
2744         PL_rsfp = PerlIO_open(scriptname,PERL_SCRIPT_MODE);
2745 #if defined(HAS_FCNTL) && defined(F_SETFD)
2746         if (PL_rsfp)
2747             fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,1);  /* ensure close-on-exec */
2748 #endif
2749     }
2750     if (!PL_rsfp) {
2751 #ifdef DOSUID
2752 #ifndef IAMSUID         /* in case script is not readable before setuid */
2753         if (PL_euid &&
2754             PerlLIO_stat(CopFILE(PL_curcop),&PL_statbuf) >= 0 &&
2755             PL_statbuf.st_mode & (S_ISUID|S_ISGID))
2756         {
2757             /* try again */
2758             PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
2759                                      (int)PERL_REVISION, (int)PERL_VERSION,
2760                                      (int)PERL_SUBVERSION), PL_origargv);
2761             Perl_croak(aTHX_ "Can't do setuid\n");
2762         }
2763 #endif
2764 #endif
2765 #ifdef IAMSUID
2766         errno = EPERM;
2767         Perl_croak(aTHX_ "Can't open perl script: %s\n",
2768                    Strerror(errno));
2769 #else
2770         Perl_croak(aTHX_ "Can't open perl script \"%s\": %s\n",
2771                    CopFILE(PL_curcop), Strerror(errno));
2772 #endif
2773     }
2774 }
2775
2776 /* Mention
2777  * I_SYSSTATVFS HAS_FSTATVFS
2778  * I_SYSMOUNT
2779  * I_STATFS     HAS_FSTATFS     HAS_GETFSSTAT
2780  * I_MNTENT     HAS_GETMNTENT   HAS_HASMNTOPT
2781  * here so that metaconfig picks them up. */
2782
2783 #ifdef IAMSUID
2784 STATIC int
2785 S_fd_on_nosuid_fs(pTHX_ int fd)
2786 {
2787     int check_okay = 0; /* able to do all the required sys/libcalls */
2788     int on_nosuid  = 0; /* the fd is on a nosuid fs */
2789 /*
2790  * Preferred order: fstatvfs(), fstatfs(), ustat()+getmnt(), getmntent().
2791  * fstatvfs() is UNIX98.
2792  * fstatfs() is 4.3 BSD.
2793  * ustat()+getmnt() is pre-4.3 BSD.
2794  * getmntent() is O(number-of-mounted-filesystems) and can hang on
2795  * an irrelevant filesystem while trying to reach the right one.
2796  */
2797
2798 #undef FD_ON_NOSUID_CHECK_OKAY  /* found the syscalls to do the check? */
2799
2800 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2801         defined(HAS_FSTATVFS)
2802 #   define FD_ON_NOSUID_CHECK_OKAY
2803     struct statvfs stfs;
2804
2805     check_okay = fstatvfs(fd, &stfs) == 0;
2806     on_nosuid  = check_okay && (stfs.f_flag  & ST_NOSUID);
2807 #   endif /* fstatvfs */
2808
2809 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2810         defined(PERL_MOUNT_NOSUID)      && \
2811         defined(HAS_FSTATFS)            && \
2812         defined(HAS_STRUCT_STATFS)      && \
2813         defined(HAS_STRUCT_STATFS_F_FLAGS)
2814 #   define FD_ON_NOSUID_CHECK_OKAY
2815     struct statfs  stfs;
2816
2817     check_okay = fstatfs(fd, &stfs)  == 0;
2818     on_nosuid  = check_okay && (stfs.f_flags & PERL_MOUNT_NOSUID);
2819 #   endif /* fstatfs */
2820
2821 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2822         defined(PERL_MOUNT_NOSUID)      && \
2823         defined(HAS_FSTAT)              && \
2824         defined(HAS_USTAT)              && \
2825         defined(HAS_GETMNT)             && \
2826         defined(HAS_STRUCT_FS_DATA)     && \
2827         defined(NOSTAT_ONE)
2828 #   define FD_ON_NOSUID_CHECK_OKAY
2829     struct stat fdst;
2830
2831     if (fstat(fd, &fdst) == 0) {
2832         struct ustat us;
2833         if (ustat(fdst.st_dev, &us) == 0) {
2834             struct fs_data fsd;
2835             /* NOSTAT_ONE here because we're not examining fields which
2836              * vary between that case and STAT_ONE. */
2837             if (getmnt((int*)0, &fsd, (int)0, NOSTAT_ONE, us.f_fname) == 0) {
2838                 size_t cmplen = sizeof(us.f_fname);
2839                 if (sizeof(fsd.fd_req.path) < cmplen)
2840                     cmplen = sizeof(fsd.fd_req.path);
2841                 if (strnEQ(fsd.fd_req.path, us.f_fname, cmplen) &&
2842                     fdst.st_dev == fsd.fd_req.dev) {
2843                         check_okay = 1;
2844                         on_nosuid = fsd.fd_req.flags & PERL_MOUNT_NOSUID;
2845                     }
2846                 }
2847             }
2848         }
2849     }
2850 #   endif /* fstat+ustat+getmnt */
2851
2852 #   if !defined(FD_ON_NOSUID_CHECK_OKAY) && \
2853         defined(HAS_GETMNTENT)          && \
2854         defined(HAS_HASMNTOPT)          && \
2855         defined(MNTOPT_NOSUID)
2856 #   define FD_ON_NOSUID_CHECK_OKAY
2857     FILE                *mtab = fopen("/etc/mtab", "r");
2858     struct mntent       *entry;
2859     struct stat         stb, fsb;
2860
2861     if (mtab && (fstat(fd, &stb) == 0)) {
2862         while (entry = getmntent(mtab)) {
2863             if (stat(entry->mnt_dir, &fsb) == 0
2864                 && fsb.st_dev == stb.st_dev)
2865             {
2866                 /* found the filesystem */
2867                 check_okay = 1;
2868                 if (hasmntopt(entry, MNTOPT_NOSUID))
2869                     on_nosuid = 1;
2870                 break;
2871             } /* A single fs may well fail its stat(). */
2872         }
2873     }
2874     if (mtab)
2875         fclose(mtab);
2876 #   endif /* getmntent+hasmntopt */
2877
2878     if (!check_okay)
2879         Perl_croak(aTHX_ "Can't check filesystem of script \"%s\" for nosuid", PL_origfilename);
2880     return on_nosuid;
2881 }
2882 #endif /* IAMSUID */
2883
2884 STATIC void
2885 S_validate_suid(pTHX_ char *validarg, char *scriptname, int fdscript)
2886 {
2887 #ifdef IAMSUID
2888     int which;
2889 #endif
2890
2891     /* do we need to emulate setuid on scripts? */
2892
2893     /* This code is for those BSD systems that have setuid #! scripts disabled
2894      * in the kernel because of a security problem.  Merely defining DOSUID
2895      * in perl will not fix that problem, but if you have disabled setuid
2896      * scripts in the kernel, this will attempt to emulate setuid and setgid
2897      * on scripts that have those now-otherwise-useless bits set.  The setuid
2898      * root version must be called suidperl or sperlN.NNN.  If regular perl
2899      * discovers that it has opened a setuid script, it calls suidperl with
2900      * the same argv that it had.  If suidperl finds that the script it has
2901      * just opened is NOT setuid root, it sets the effective uid back to the
2902      * uid.  We don't just make perl setuid root because that loses the
2903      * effective uid we had before invoking perl, if it was different from the
2904      * uid.
2905      *
2906      * DOSUID must be defined in both perl and suidperl, and IAMSUID must
2907      * be defined in suidperl only.  suidperl must be setuid root.  The
2908      * Configure script will set this up for you if you want it.
2909      */
2910
2911 #ifdef DOSUID
2912     char *s, *s2;
2913
2914     if (PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf) < 0)  /* normal stat is insecure */
2915         Perl_croak(aTHX_ "Can't stat script \"%s\"",PL_origfilename);
2916     if (fdscript < 0 && PL_statbuf.st_mode & (S_ISUID|S_ISGID)) {
2917         I32 len;
2918         STRLEN n_a;
2919
2920 #ifdef IAMSUID
2921 #ifndef HAS_SETREUID
2922         /* On this access check to make sure the directories are readable,
2923          * there is actually a small window that the user could use to make
2924          * filename point to an accessible directory.  So there is a faint
2925          * chance that someone could execute a setuid script down in a
2926          * non-accessible directory.  I don't know what to do about that.
2927          * But I don't think it's too important.  The manual lies when
2928          * it says access() is useful in setuid programs.
2929          */
2930         if (PerlLIO_access(CopFILE(PL_curcop),1)) /*double check*/
2931             Perl_croak(aTHX_ "Permission denied");
2932 #else
2933         /* If we can swap euid and uid, then we can determine access rights
2934          * with a simple stat of the file, and then compare device and
2935          * inode to make sure we did stat() on the same file we opened.
2936          * Then we just have to make sure he or she can execute it.
2937          */
2938         {
2939             struct stat tmpstatbuf;
2940
2941             if (
2942 #ifdef HAS_SETREUID
2943                 setreuid(PL_euid,PL_uid) < 0
2944 #else
2945 # if HAS_SETRESUID
2946                 setresuid(PL_euid,PL_uid,(Uid_t)-1) < 0
2947 # endif
2948 #endif
2949                 || PerlProc_getuid() != PL_euid || PerlProc_geteuid() != PL_uid)
2950                 Perl_croak(aTHX_ "Can't swap uid and euid");    /* really paranoid */
2951             if (PerlLIO_stat(CopFILE(PL_curcop),&tmpstatbuf) < 0)
2952                 Perl_croak(aTHX_ "Permission denied");  /* testing full pathname here */
2953 #if defined(IAMSUID) && !defined(NO_NOSUID_CHECK)
2954             if (fd_on_nosuid_fs(PerlIO_fileno(PL_rsfp)))
2955                 Perl_croak(aTHX_ "Permission denied");
2956 #endif
2957             if (tmpstatbuf.st_dev != PL_statbuf.st_dev ||
2958                 tmpstatbuf.st_ino != PL_statbuf.st_ino) {
2959                 (void)PerlIO_close(PL_rsfp);
2960                 Perl_croak(aTHX_ "Permission denied\n");
2961             }
2962             if (
2963 #ifdef HAS_SETREUID
2964               setreuid(PL_uid,PL_euid) < 0
2965 #else
2966 # if defined(HAS_SETRESUID)
2967               setresuid(PL_uid,PL_euid,(Uid_t)-1) < 0
2968 # endif
2969 #endif
2970               || PerlProc_getuid() != PL_uid || PerlProc_geteuid() != PL_euid)
2971                 Perl_croak(aTHX_ "Can't reswap uid and euid");
2972             if (!cando(S_IXUSR,FALSE,&PL_statbuf))              /* can real uid exec? */
2973                 Perl_croak(aTHX_ "Permission denied\n");
2974         }
2975 #endif /* HAS_SETREUID */
2976 #endif /* IAMSUID */
2977
2978         if (!S_ISREG(PL_statbuf.st_mode))
2979             Perl_croak(aTHX_ "Permission denied");
2980         if (PL_statbuf.st_mode & S_IWOTH)
2981             Perl_croak(aTHX_ "Setuid/gid script is writable by world");
2982         PL_doswitches = FALSE;          /* -s is insecure in suid */
2983         CopLINE_inc(PL_curcop);
2984         if (sv_gets(PL_linestr, PL_rsfp, 0) == Nullch ||
2985           strnNE(SvPV(PL_linestr,n_a),"#!",2) ) /* required even on Sys V */
2986             Perl_croak(aTHX_ "No #! line");
2987         s = SvPV(PL_linestr,n_a)+2;
2988         if (*s == ' ') s++;
2989         while (!isSPACE(*s)) s++;
2990         for (s2 = s;  (s2 > SvPV(PL_linestr,n_a)+2 &&
2991                        (isDIGIT(s2[-1]) || strchr("._-", s2[-1])));  s2--) ;
2992         if (strnNE(s2-4,"perl",4) && strnNE(s-9,"perl",4))  /* sanity check */
2993             Perl_croak(aTHX_ "Not a perl script");
2994         while (*s == ' ' || *s == '\t') s++;
2995         /*
2996          * #! arg must be what we saw above.  They can invoke it by
2997          * mentioning suidperl explicitly, but they may not add any strange
2998          * arguments beyond what #! says if they do invoke suidperl that way.
2999          */
3000         len = strlen(validarg);
3001         if (strEQ(validarg," PHOOEY ") ||
3002             strnNE(s,validarg,len) || !isSPACE(s[len]))
3003             Perl_croak(aTHX_ "Args must match #! line");
3004
3005 #ifndef IAMSUID
3006         if (PL_euid != PL_uid && (PL_statbuf.st_mode & S_ISUID) &&
3007             PL_euid == PL_statbuf.st_uid)
3008             if (!PL_do_undump)
3009                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3010 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3011 #endif /* IAMSUID */
3012
3013         if (PL_euid) {  /* oops, we're not the setuid root perl */
3014             (void)PerlIO_close(PL_rsfp);
3015 #ifndef IAMSUID
3016             /* try again */
3017             PerlProc_execv(Perl_form(aTHX_ "%s/sperl"PERL_FS_VER_FMT, BIN_EXP,
3018                                      (int)PERL_REVISION, (int)PERL_VERSION,
3019                                      (int)PERL_SUBVERSION), PL_origargv);
3020 #endif
3021             Perl_croak(aTHX_ "Can't do setuid\n");
3022         }
3023
3024         if (PL_statbuf.st_mode & S_ISGID && PL_statbuf.st_gid != PL_egid) {
3025 #ifdef HAS_SETEGID
3026             (void)setegid(PL_statbuf.st_gid);
3027 #else
3028 #ifdef HAS_SETREGID
3029            (void)setregid((Gid_t)-1,PL_statbuf.st_gid);
3030 #else
3031 #ifdef HAS_SETRESGID
3032            (void)setresgid((Gid_t)-1,PL_statbuf.st_gid,(Gid_t)-1);
3033 #else
3034             PerlProc_setgid(PL_statbuf.st_gid);
3035 #endif
3036 #endif
3037 #endif
3038             if (PerlProc_getegid() != PL_statbuf.st_gid)
3039                 Perl_croak(aTHX_ "Can't do setegid!\n");
3040         }
3041         if (PL_statbuf.st_mode & S_ISUID) {
3042             if (PL_statbuf.st_uid != PL_euid)
3043 #ifdef HAS_SETEUID
3044                 (void)seteuid(PL_statbuf.st_uid);       /* all that for this */
3045 #else
3046 #ifdef HAS_SETREUID
3047                 (void)setreuid((Uid_t)-1,PL_statbuf.st_uid);
3048 #else
3049 #ifdef HAS_SETRESUID
3050                 (void)setresuid((Uid_t)-1,PL_statbuf.st_uid,(Uid_t)-1);
3051 #else
3052                 PerlProc_setuid(PL_statbuf.st_uid);
3053 #endif
3054 #endif
3055 #endif
3056             if (PerlProc_geteuid() != PL_statbuf.st_uid)
3057                 Perl_croak(aTHX_ "Can't do seteuid!\n");
3058         }
3059         else if (PL_uid) {                      /* oops, mustn't run as root */
3060 #ifdef HAS_SETEUID
3061           (void)seteuid((Uid_t)PL_uid);
3062 #else
3063 #ifdef HAS_SETREUID
3064           (void)setreuid((Uid_t)-1,(Uid_t)PL_uid);
3065 #else
3066 #ifdef HAS_SETRESUID
3067           (void)setresuid((Uid_t)-1,(Uid_t)PL_uid,(Uid_t)-1);
3068 #else
3069           PerlProc_setuid((Uid_t)PL_uid);
3070 #endif
3071 #endif
3072 #endif
3073             if (PerlProc_geteuid() != PL_uid)
3074                 Perl_croak(aTHX_ "Can't do seteuid!\n");
3075         }
3076         init_ids();
3077         if (!cando(S_IXUSR,TRUE,&PL_statbuf))
3078             Perl_croak(aTHX_ "Permission denied\n");    /* they can't do this */
3079     }
3080 #ifdef IAMSUID
3081     else if (PL_preprocess)
3082         Perl_croak(aTHX_ "-P not allowed for setuid/setgid script\n");
3083     else if (fdscript >= 0)
3084         Perl_croak(aTHX_ "fd script not allowed in suidperl\n");
3085     else
3086         Perl_croak(aTHX_ "Script is not setuid/setgid in suidperl\n");
3087
3088     /* We absolutely must clear out any saved ids here, so we */
3089     /* exec the real perl, substituting fd script for scriptname. */
3090     /* (We pass script name as "subdir" of fd, which perl will grok.) */
3091     PerlIO_rewind(PL_rsfp);
3092     PerlLIO_lseek(PerlIO_fileno(PL_rsfp),(Off_t)0,0);  /* just in case rewind didn't */
3093     for (which = 1; PL_origargv[which] && PL_origargv[which] != scriptname; which++) ;
3094     if (!PL_origargv[which])
3095         Perl_croak(aTHX_ "Permission denied");
3096     PL_origargv[which] = savepv(Perl_form(aTHX_ "/dev/fd/%d/%s",
3097                                   PerlIO_fileno(PL_rsfp), PL_origargv[which]));
3098 #if defined(HAS_FCNTL) && defined(F_SETFD)
3099     fcntl(PerlIO_fileno(PL_rsfp),F_SETFD,0);    /* ensure no close-on-exec */
3100 #endif
3101     PerlProc_execv(Perl_form(aTHX_ "%s/perl"PERL_FS_VER_FMT, BIN_EXP,
3102                              (int)PERL_REVISION, (int)PERL_VERSION,
3103                              (int)PERL_SUBVERSION), PL_origargv);/* try again */
3104     Perl_croak(aTHX_ "Can't do setuid\n");
3105 #endif /* IAMSUID */
3106 #else /* !DOSUID */
3107     if (PL_euid != PL_uid || PL_egid != PL_gid) {       /* (suidperl doesn't exist, in fact) */
3108 #ifndef SETUID_SCRIPTS_ARE_SECURE_NOW
3109         PerlLIO_fstat(PerlIO_fileno(PL_rsfp),&PL_statbuf);      /* may be either wrapped or real suid */
3110         if ((PL_euid != PL_uid && PL_euid == PL_statbuf.st_uid && PL_statbuf.st_mode & S_ISUID)
3111             ||
3112             (PL_egid != PL_gid && PL_egid == PL_statbuf.st_gid && PL_statbuf.st_mode & S_ISGID)
3113            )
3114             if (!PL_do_undump)
3115                 Perl_croak(aTHX_ "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!\n\
3116 FIX YOUR KERNEL, PUT A C WRAPPER AROUND THIS SCRIPT, OR USE -u AND UNDUMP!\n");
3117 #endif /* SETUID_SCRIPTS_ARE_SECURE_NOW */
3118         /* not set-id, must be wrapped */
3119     }
3120 #endif /* DOSUID */
3121 }
3122
3123 STATIC void
3124 S_find_beginning(pTHX)
3125 {
3126     register char *s, *s2;
3127
3128     /* skip forward in input to the real script? */
3129
3130     forbid_setid("-x");
3131 #ifdef MACOS_TRADITIONAL
3132     /* Since the Mac OS does not honor #! arguments for us, we do it ourselves */
3133
3134     while (PL_doextract || gMacPerl_AlwaysExtract) {
3135         if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
3136             if (!gMacPerl_AlwaysExtract)
3137                 Perl_croak(aTHX_ "No Perl script found in input\n");
3138                 
3139             if (PL_doextract)                   /* require explicit override ? */
3140                 if (!OverrideExtract(PL_origfilename))
3141                     Perl_croak(aTHX_ "User aborted script\n");
3142                 else
3143                     PL_doextract = FALSE;
3144                 
3145             /* Pater peccavi, file does not have #! */
3146             PerlIO_rewind(PL_rsfp);
3147         
3148             break;
3149         }
3150 #else
3151     while (PL_doextract) {
3152         if ((s = sv_gets(PL_linestr, PL_rsfp, 0)) == Nullch)
3153             Perl_croak(aTHX_ "No Perl script found in input\n");
3154 #endif
3155         s2 = s;
3156         if (*s == '#' && s[1] == '!' && ((s = instr(s,"perl")) || (s = instr(s2,"PERL")))) {
3157             PerlIO_ungetc(PL_rsfp, '\n');               /* to keep line count right */
3158             PL_doextract = FALSE;
3159             while (*s && !(isSPACE (*s) || *s == '#')) s++;
3160             s2 = s;
3161             while (*s == ' ' || *s == '\t') s++;
3162             if (*s++ == '-') {
3163                 while (isDIGIT(s2[-1]) || strchr("-._", s2[-1])) s2--;
3164                 if (strnEQ(s2-4,"perl",4))
3165                     /*SUPPRESS 530*/
3166                     while ((s = moreswitches(s)))
3167                         ;
3168             }
3169 #ifdef MACOS_TRADITIONAL
3170             break;
3171 #endif
3172         }
3173     }
3174 }
3175
3176
3177 STATIC void
3178 S_init_ids(pTHX)
3179 {
3180     PL_uid = PerlProc_getuid();
3181     PL_euid = PerlProc_geteuid();
3182     PL_gid = PerlProc_getgid();
3183     PL_egid = PerlProc_getegid();
3184 #ifdef VMS
3185     PL_uid |= PL_gid << 16;
3186     PL_euid |= PL_egid << 16;
3187 #endif
3188     PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
3189 }
3190
3191 STATIC void
3192 S_forbid_setid(pTHX_ char *s)
3193 {
3194     if (PL_euid != PL_uid)
3195         Perl_croak(aTHX_ "No %s allowed while running setuid", s);
3196     if (PL_egid != PL_gid)
3197         Perl_croak(aTHX_ "No %s allowed while running setgid", s);
3198 }
3199
3200 void
3201 Perl_init_debugger(pTHX)
3202 {
3203     HV *ostash = PL_curstash;
3204
3205     PL_curstash = PL_debstash;
3206     PL_dbargs = GvAV(gv_AVadd((gv_fetchpv("args", GV_ADDMULTI, SVt_PVAV))));
3207     AvREAL_off(PL_dbargs);
3208     PL_DBgv = gv_fetchpv("DB", GV_ADDMULTI, SVt_PVGV);
3209     PL_DBline = gv_fetchpv("dbline", GV_ADDMULTI, SVt_PVAV);
3210     PL_DBsub = gv_HVadd(gv_fetchpv("sub", GV_ADDMULTI, SVt_PVHV));
3211     sv_upgrade(GvSV(PL_DBsub), SVt_IV); /* IVX accessed if PERLDB_SUB_NN */
3212     PL_DBsingle = GvSV((gv_fetchpv("single", GV_ADDMULTI, SVt_PV)));
3213     sv_setiv(PL_DBsingle, 0);
3214     PL_DBtrace = GvSV((gv_fetchpv("trace", GV_ADDMULTI, SVt_PV)));
3215     sv_setiv(PL_DBtrace, 0);
3216     PL_DBsignal = GvSV((gv_fetchpv("signal", GV_ADDMULTI, SVt_PV)));
3217     sv_setiv(PL_DBsignal, 0);
3218     PL_curstash = ostash;
3219 }
3220
3221 #ifndef STRESS_REALLOC
3222 #define REASONABLE(size) (size)
3223 #else
3224 #define REASONABLE(size) (1) /* unreasonable */
3225 #endif
3226
3227 void
3228 Perl_init_stacks(pTHX)
3229 {
3230     /* start with 128-item stack and 8K cxstack */
3231     PL_curstackinfo = new_stackinfo(REASONABLE(128),
3232                                  REASONABLE(8192/sizeof(PERL_CONTEXT) - 1));
3233     PL_curstackinfo->si_type = PERLSI_MAIN;
3234     PL_curstack = PL_curstackinfo->si_stack;
3235     PL_mainstack = PL_curstack;         /* remember in case we switch stacks */
3236
3237     PL_stack_base = AvARRAY(PL_curstack);
3238     PL_stack_sp = PL_stack_base;
3239     PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
3240
3241     New(50,PL_tmps_stack,REASONABLE(128),SV*);
3242     PL_tmps_floor = -1;
3243     PL_tmps_ix = -1;
3244     PL_tmps_max = REASONABLE(128);
3245
3246     New(54,PL_markstack,REASONABLE(32),I32);
3247     PL_markstack_ptr = PL_markstack;
3248     PL_markstack_max = PL_markstack + REASONABLE(32);
3249
3250     SET_MARK_OFFSET;
3251
3252     New(54,PL_scopestack,REASONABLE(32),I32);
3253     PL_scopestack_ix = 0;
3254     PL_scopestack_max = REASONABLE(32);
3255
3256     New(54,PL_savestack,REASONABLE(128),ANY);
3257     PL_savestack_ix = 0;
3258     PL_savestack_max = REASONABLE(128);
3259
3260     New(54,PL_retstack,REASONABLE(16),OP*);
3261     PL_retstack_ix = 0;
3262     PL_retstack_max = REASONABLE(16);
3263 }
3264
3265 #undef REASONABLE
3266
3267 STATIC void
3268 S_nuke_stacks(pTHX)
3269 {
3270     while (PL_curstackinfo->si_next)
3271         PL_curstackinfo = PL_curstackinfo->si_next;
3272     while (PL_curstackinfo) {
3273         PERL_SI *p = PL_curstackinfo->si_prev;
3274         /* curstackinfo->si_stack got nuked by sv_free_arenas() */
3275         Safefree(PL_curstackinfo->si_cxstack);
3276         Safefree(PL_curstackinfo);
3277         PL_curstackinfo = p;
3278     }
3279     Safefree(PL_tmps_stack);
3280     Safefree(PL_markstack);
3281     Safefree(PL_scopestack);
3282     Safefree(PL_savestack);
3283     Safefree(PL_retstack);
3284 }
3285
3286 #ifndef PERL_OBJECT
3287 static PerlIO *tmpfp;  /* moved outside init_lexer() because of UNICOS bug */
3288 #endif
3289
3290 STATIC void
3291 S_init_lexer(pTHX)
3292 {
3293 #ifdef PERL_OBJECT
3294         PerlIO *tmpfp;
3295 #endif
3296     tmpfp = PL_rsfp;
3297     PL_rsfp = Nullfp;
3298     lex_start(PL_linestr);
3299     PL_rsfp = tmpfp;
3300     PL_subname = newSVpvn("main",4);
3301 }
3302
3303 STATIC void
3304 S_init_predump_symbols(pTHX)
3305 {
3306     GV *tmpgv;
3307     IO *io;
3308
3309     sv_setpvn(get_sv("\"", TRUE), " ", 1);
3310     PL_stdingv = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
3311     GvMULTI_on(PL_stdingv);
3312     io = GvIOp(PL_stdingv);
3313     IoTYPE(io) = IoTYPE_RDONLY;
3314     IoIFP(io) = PerlIO_stdin();
3315     tmpgv = gv_fetchpv("stdin",TRUE, SVt_PV);
3316     GvMULTI_on(tmpgv);
3317     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3318
3319     tmpgv = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
3320     GvMULTI_on(tmpgv);
3321     io = GvIOp(tmpgv);
3322     IoTYPE(io) = IoTYPE_WRONLY;
3323     IoOFP(io) = IoIFP(io) = PerlIO_stdout();
3324     setdefout(tmpgv);
3325     tmpgv = gv_fetchpv("stdout",TRUE, SVt_PV);
3326     GvMULTI_on(tmpgv);
3327     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3328
3329     PL_stderrgv = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
3330     GvMULTI_on(PL_stderrgv);
3331     io = GvIOp(PL_stderrgv);
3332     IoTYPE(io) = IoTYPE_WRONLY;
3333     IoOFP(io) = IoIFP(io) = PerlIO_stderr();
3334     tmpgv = gv_fetchpv("stderr",TRUE, SVt_PV);
3335     GvMULTI_on(tmpgv);
3336     GvIOp(tmpgv) = (IO*)SvREFCNT_inc(io);
3337
3338     PL_statname = NEWSV(66,0);          /* last filename we did stat on */
3339
3340     if (PL_osname)
3341         Safefree(PL_osname);
3342     PL_osname = savepv(OSNAME);
3343 }
3344
3345 STATIC void
3346 S_init_postdump_symbols(pTHX_ register int argc, register char **argv, register char **env)
3347 {
3348     char *s;
3349     SV *sv;
3350     GV* tmpgv;
3351 #ifdef NEED_ENVIRON_DUP_FOR_MODIFY
3352     char **dup_env_base = 0;
3353     int dup_env_count = 0;
3354 #endif
3355
3356     argc--,argv++;      /* skip name of script */
3357     if (PL_doswitches) {
3358         for (; argc > 0 && **argv == '-'; argc--,argv++) {
3359             if (!argv[0][1])
3360                 break;
3361             if (argv[0][1] == '-' && !argv[0][2]) {
3362                 argc--,argv++;
3363                 break;
3364             }
3365             if ((s = strchr(argv[0], '='))) {
3366                 *s++ = '\0';
3367                 sv_setpv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),s);
3368             }
3369             else
3370                 sv_setiv(GvSV(gv_fetchpv(argv[0]+1,TRUE, SVt_PV)),1);
3371         }
3372     }
3373     PL_toptarget = NEWSV(0,0);
3374     sv_upgrade(PL_toptarget, SVt_PVFM);
3375     sv_setpvn(PL_toptarget, "", 0);
3376     PL_bodytarget = NEWSV(0,0);
3377     sv_upgrade(PL_bodytarget, SVt_PVFM);
3378     sv_setpvn(PL_bodytarget, "", 0);
3379     PL_formtarget = PL_bodytarget;
3380
3381     TAINT;
3382     if ((tmpgv = gv_fetchpv("0",TRUE, SVt_PV))) {
3383 #ifdef MACOS_TRADITIONAL
3384         /* $0 is not majick on a Mac */
3385         sv_setpv(GvSV(tmpgv),MacPerl_MPWFileName(PL_origfilename));
3386 #else
3387         sv_setpv(GvSV(tmpgv),PL_origfilename);
3388         magicname("0", "0", 1);
3389 #endif
3390     }
3391     if ((tmpgv = gv_fetchpv("\030",TRUE, SVt_PV)))
3392 #ifdef OS2
3393         sv_setpv(GvSV(tmpgv), os2_execname(aTHX));
3394 #else
3395         sv_setpv(GvSV(tmpgv),PL_origargv[0]);
3396 #endif
3397     if ((PL_argvgv = gv_fetchpv("ARGV",TRUE, SVt_PVAV))) {
3398         GvMULTI_on(PL_argvgv);
3399         (void)gv_AVadd(PL_argvgv);
3400         av_clear(GvAVn(PL_argvgv));
3401         for (; argc > 0; argc--,argv++) {
3402             SV *sv = newSVpv(argv[0],0);
3403             av_push(GvAVn(PL_argvgv),sv);
3404             if (PL_widesyscalls)
3405                 (void)sv_utf8_decode(sv);
3406         }
3407     }
3408     if ((PL_envgv = gv_fetchpv("ENV",TRUE, SVt_PVHV))) {
3409         HV *hv;
3410         GvMULTI_on(PL_envgv);
3411         hv = GvHVn(PL_envgv);
3412         hv_magic(hv, Nullgv, PERL_MAGIC_env);
3413 #ifdef USE_ENVIRON_ARRAY
3414         /* Note that if the supplied env parameter is actually a copy
3415            of the global environ then it may now point to free'd memory
3416            if the environment has been modified since. To avoid this
3417            problem we treat env==NULL as meaning 'use the default'
3418         */
3419         if (!env)
3420             env = environ;
3421         if (env != environ)
3422             environ[0] = Nullch;
3423 #ifdef NEED_ENVIRON_DUP_FOR_MODIFY
3424         {
3425             char **env_base;
3426             for (env_base = env; *env; env++)
3427                 dup_env_count++;
3428             if ((dup_env_base = (char **)
3429                  safesysmalloc( sizeof(char *) * (dup_env_count+1) ))) {
3430                 char **dup_env;
3431                 for (env = env_base, dup_env = dup_env_base;
3432                      *env;
3433                      env++, dup_env++) {
3434                     /* With environ one needs to use safesysmalloc(). */
3435                     *dup_env = safesysmalloc(strlen(*env) + 1);
3436                     (void)strcpy(*dup_env, *env);
3437                 }
3438                 *dup_env = Nullch;
3439                 env = dup_env_base;
3440             } /* else what? */
3441         }
3442 #endif /* NEED_ENVIRON_DUP_FOR_MODIFY */
3443         if (env)
3444           for (; *env; env++) {
3445             if (!(s = strchr(*env,'=')))
3446                 continue;
3447             *s++ = '\0';
3448 #if defined(MSDOS)
3449             (void)strupr(*env);
3450 #endif
3451             sv = newSVpv(s--,0);
3452             (void)hv_store(hv, *env, s - *env, sv, 0);
3453             *s = '=';
3454           }
3455 #ifdef NEED_ENVIRON_DUP_FOR_MODIFY
3456         if (dup_env_base) {
3457             char **dup_env;
3458             for (dup_env = dup_env_base; *dup_env; dup_env++)
3459                 safesysfree(*dup_env);
3460             safesysfree(dup_env_base);
3461         }
3462 #endif /* NEED_ENVIRON_DUP_FOR_MODIFY */
3463 #endif /* USE_ENVIRON_ARRAY */
3464     }
3465     TAINT_NOT;
3466     if ((tmpgv = gv_fetchpv("$",TRUE, SVt_PV)))
3467         sv_setiv(GvSV(tmpgv), (IV)PerlProc_getpid());
3468 }
3469
3470 STATIC void
3471 S_init_perllib(pTHX)
3472 {
3473     char *s;
3474     if (!PL_tainting) {
3475 #ifndef VMS
3476         s = PerlEnv_getenv("PERL5LIB");
3477         if (s)
3478             incpush(s, TRUE, TRUE);
3479         else
3480             incpush(PerlEnv_getenv("PERLLIB"), FALSE, FALSE);
3481 #else /* VMS */
3482         /* Treat PERL5?LIB as a possible search list logical name -- the
3483          * "natural" VMS idiom for a Unix path string.  We allow each
3484          * element to be a set of |-separated directories for compatibility.
3485          */
3486         char buf[256];
3487         int idx = 0;
3488         if (my_trnlnm("PERL5LIB",buf,0))
3489             do { incpush(buf,TRUE,TRUE); } while (my_trnlnm("PERL5LIB",buf,++idx));
3490         else
3491             while (my_trnlnm("PERLLIB",buf,idx++)) incpush(buf,FALSE,FALSE);
3492 #endif /* VMS */
3493     }
3494
3495 /* Use the ~-expanded versions of APPLLIB (undocumented),
3496     ARCHLIB PRIVLIB SITEARCH SITELIB VENDORARCH and VENDORLIB
3497 */
3498 #ifdef APPLLIB_EXP
3499     incpush(APPLLIB_EXP, TRUE, TRUE);
3500 #endif
3501
3502 #ifdef ARCHLIB_EXP
3503     incpush(ARCHLIB_EXP, FALSE, FALSE);
3504 #endif
3505 #ifdef MACOS_TRADITIONAL
3506     {
3507         struct stat tmpstatbuf;
3508         SV * privdir = NEWSV(55, 0);
3509         char * macperl = PerlEnv_getenv("MACPERL");
3510         
3511         if (!macperl)
3512             macperl = "";
3513         
3514         Perl_sv_setpvf(aTHX_ privdir, "%slib:", macperl);
3515         if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3516             incpush(SvPVX(privdir), TRUE, FALSE);
3517         Perl_sv_setpvf(aTHX_ privdir, "%ssite_perl:", macperl);
3518         if (PerlLIO_stat(SvPVX(privdir), &tmpstatbuf) >= 0 && S_ISDIR(tmpstatbuf.st_mode))
3519             incpush(SvPVX(privdir), TRUE, FALSE);
3520         
3521         SvREFCNT_dec(privdir);
3522     }
3523     if (!PL_tainting)
3524         incpush(":", FALSE, FALSE);
3525 #else
3526 #ifndef PRIVLIB_EXP
3527 #  define PRIVLIB_EXP "/usr/local/lib/perl5:/usr/local/lib/perl"
3528 #endif
3529 #if defined(WIN32)
3530     incpush(PRIVLIB_EXP, TRUE, FALSE);
3531 #else
3532     incpush(PRIVLIB_EXP, FALSE, FALSE);
3533 #endif
3534
3535 #ifdef SITEARCH_EXP
3536     /* sitearch is always relative to sitelib on Windows for
3537      * DLL-based path intuition to work correctly */
3538 #  if !defined(WIN32)
3539     incpush(SITEARCH_EXP, FALSE, FALSE);
3540 #  endif
3541 #endif
3542
3543 #ifdef SITELIB_EXP
3544 #  if defined(WIN32)
3545     incpush(SITELIB_EXP, TRUE, FALSE);  /* this picks up sitearch as well */
3546 #  else
3547     incpush(SITELIB_EXP, FALSE, FALSE);
3548 #  endif
3549 #endif
3550
3551 #ifdef SITELIB_STEM /* Search for version-specific dirs below here */
3552     incpush(SITELIB_STEM, FALSE, TRUE);
3553 #endif
3554
3555 #ifdef PERL_VENDORARCH_EXP
3556     /* vendorarch is always relative to vendorlib on Windows for
3557      * DLL-based path intuition to work correctly */
3558 #  if !defined(WIN32)
3559     incpush(PERL_VENDORARCH_EXP, FALSE, FALSE);
3560 #  endif
3561 #endif
3562
3563 #ifdef PERL_VENDORLIB_EXP
3564 #  if defined(WIN32)
3565     incpush(PERL_VENDORLIB_EXP, TRUE, FALSE);   /* this picks up vendorarch as well */
3566 #  else
3567     incpush(PERL_VENDORLIB_EXP, FALSE, FALSE);
3568 #  endif
3569 #endif
3570
3571 #ifdef PERL_VENDORLIB_STEM /* Search for version-specific dirs below here */
3572     incpush(PERL_VENDORLIB_STEM, FALSE, TRUE);
3573 #endif
3574
3575 #ifdef PERL_OTHERLIBDIRS
3576     incpush(PERL_OTHERLIBDIRS, TRUE, TRUE);
3577 #endif
3578
3579     if (!PL_tainting)
3580         incpush(".", FALSE, FALSE);
3581 #endif /* MACOS_TRADITIONAL */
3582 }
3583
3584 #if defined(DOSISH) || defined(EPOC)
3585 #    define PERLLIB_SEP ';'
3586 #else
3587 #  if defined(VMS)
3588 #    define PERLLIB_SEP '|'
3589 #  else
3590 #    if defined(MACOS_TRADITIONAL)
3591 #      define PERLLIB_SEP ','
3592 #    else
3593 #      define PERLLIB_SEP ':'
3594 #    endif
3595 #  endif
3596 #endif
3597 #ifndef PERLLIB_MANGLE
3598 #  define PERLLIB_MANGLE(s,n) (s)
3599 #endif
3600
3601 STATIC void
3602 S_incpush(pTHX_ char *p, int addsubdirs, int addoldvers)
3603 {
3604     SV *subdir = Nullsv;
3605
3606     if (!p || !*p)
3607         return;
3608
3609     if (addsubdirs || addoldvers) {
3610         subdir = sv_newmortal();
3611     }
3612
3613     /* Break at all separators */
3614     while (p && *p) {
3615         SV *libdir = NEWSV(55,0);
3616         char *s;
3617
3618         /* skip any consecutive separators */
3619         while ( *p == PERLLIB_SEP ) {
3620             /* Uncomment the next line for PATH semantics */
3621             /* av_push(GvAVn(PL_incgv), newSVpvn(".", 1)); */
3622             p++;
3623         }
3624
3625         if ( (s = strchr(p, PERLLIB_SEP)) != Nullch ) {
3626             sv_setpvn(libdir, PERLLIB_MANGLE(p, (STRLEN)(s - p)),
3627                       (STRLEN)(s - p));
3628             p = s + 1;
3629         }
3630         else {
3631             sv_setpv(libdir, PERLLIB_MANGLE(p, 0));
3632             p = Nullch; /* break out */
3633         }
3634 #ifdef MACOS_TRADITIONAL
3635         if (!strchr(SvPVX(libdir), ':'))
3636             sv_insert(libdir, 0, 0, ":", 1);
3637         if (SvPVX(libdir)[SvCUR(libdir)-1] != ':')
3638             sv_catpv(libdir, ":");
3639 #endif
3640
3641         /*
3642          * BEFORE pushing libdir onto @INC we may first push version- and
3643          * archname-specific sub-directories.
3644          */
3645         if (addsubdirs || addoldvers) {
3646 #ifdef PERL_INC_VERSION_LIST
3647             /* Configure terminates PERL_INC_VERSION_LIST with a NULL */
3648             const char *incverlist[] = { PERL_INC_VERSION_LIST };
3649             const char **incver;
3650 #endif
3651             struct stat tmpstatbuf;
3652 #ifdef VMS
3653             char *unix;
3654             STRLEN len;
3655
3656             if ((unix = tounixspec_ts(SvPV(libdir,len),Nullch)) != Nullch) {
3657                 len = strlen(unix);
3658                 while (unix[len-1] == '/') len--;  /* Cosmetic */
3659                 sv_usepvn(libdir,unix,len);
3660             }
3661             else
3662                 PerlIO_printf(Perl_error_log,
3663                               "Failed to unixify @INC element \"%s\"\n",
3664                               SvPV(libdir,len));
3665 #endif
3666             if (addsubdirs) {
3667 #ifdef MACOS_TRADITIONAL
3668 #define PERL_AV_SUFFIX_FMT      ""
3669 #define PERL_ARCH_FMT           "%s:"
3670 #define PERL_ARCH_FMT_PATH      PERL_FS_VER_FMT PERL_AV_SUFFIX_FMT
3671 #else
3672 #define PERL_AV_SUFFIX_FMT      "/"
3673 #define PERL_ARCH_FMT           "/%s"
3674 #define PERL_ARCH_FMT_PATH      PERL_AV_SUFFIX_FMT PERL_FS_VER_FMT
3675 #endif
3676                 /* .../version/archname if -d .../version/archname */
3677                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH PERL_ARCH_FMT,
3678                                 libdir,
3679                                (int)PERL_REVISION, (int)PERL_VERSION,
3680                                (int)PERL_SUBVERSION, ARCHNAME);
3681                 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3682                       S_ISDIR(tmpstatbuf.st_mode))
3683                     av_push(GvAVn(PL_incgv), newSVsv(subdir));
3684
3685                 /* .../version if -d .../version */
3686                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT_PATH, libdir,
3687                                (int)PERL_REVISION, (int)PERL_VERSION,
3688                                (int)PERL_SUBVERSION);
3689                 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3690                       S_ISDIR(tmpstatbuf.st_mode))
3691                     av_push(GvAVn(PL_incgv), newSVsv(subdir));
3692
3693                 /* .../archname if -d .../archname */
3694                 Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, ARCHNAME);
3695                 if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3696                       S_ISDIR(tmpstatbuf.st_mode))
3697                     av_push(GvAVn(PL_incgv), newSVsv(subdir));
3698             }
3699
3700 #ifdef PERL_INC_VERSION_LIST
3701             if (addoldvers) {
3702                 for (incver = incverlist; *incver; incver++) {
3703                     /* .../xxx if -d .../xxx */
3704                     Perl_sv_setpvf(aTHX_ subdir, "%"SVf PERL_ARCH_FMT, libdir, *incver);
3705                     if (PerlLIO_stat(SvPVX(subdir), &tmpstatbuf) >= 0 &&
3706                           S_ISDIR(tmpstatbuf.st_mode))
3707                         av_push(GvAVn(PL_incgv), newSVsv(subdir));
3708                 }
3709             }
3710 #endif
3711         }
3712
3713         /* finally push this lib directory on the end of @INC */
3714         av_push(GvAVn(PL_incgv), libdir);
3715     }
3716 }
3717
3718 #ifdef USE_THREADS
3719 STATIC struct perl_thread *
3720 S_init_main_thread(pTHX)
3721 {
3722 #if !defined(PERL_IMPLICIT_CONTEXT)
3723     struct perl_thread *thr;
3724 #endif
3725     XPV *xpv;
3726
3727     Newz(53, thr, 1, struct perl_thread);
3728     PL_curcop = &PL_compiling;
3729     thr->interp = PERL_GET_INTERP;
3730     thr->cvcache = newHV();
3731     thr->threadsv = newAV();
3732     /* thr->threadsvp is set when find_threadsv is called */
3733     thr->specific = newAV();
3734     thr->flags = THRf_R_JOINABLE;
3735     MUTEX_INIT(&thr->mutex);
3736     /* Handcraft thrsv similarly to mess_sv */
3737     New(53, PL_thrsv, 1, SV);
3738     Newz(53, xpv, 1, XPV);
3739     SvFLAGS(PL_thrsv) = SVt_PV;
3740     SvANY(PL_thrsv) = (void*)xpv;
3741     SvREFCNT(PL_thrsv) = 1 << 30;       /* practically infinite */
3742     SvPVX(PL_thrsv) = (char*)thr;
3743     SvCUR_set(PL_thrsv, sizeof(thr));
3744     SvLEN_set(PL_thrsv, sizeof(thr));
3745     *SvEND(PL_thrsv) = '\0';    /* in the trailing_nul field */
3746     thr->oursv = PL_thrsv;
3747     PL_chopset = " \n-";
3748     PL_dumpindent = 4;
3749
3750     MUTEX_LOCK(&PL_threads_mutex);
3751     PL_nthreads++;
3752     thr->tid = 0;
3753     thr->next = thr;
3754     thr->prev = thr;
3755     thr->thr_done = 0;
3756     MUTEX_UNLOCK(&PL_threads_mutex);
3757
3758 #ifdef HAVE_THREAD_INTERN
3759     Perl_init_thread_intern(thr);
3760 #endif
3761
3762 #ifdef SET_THREAD_SELF
3763     SET_THREAD_SELF(thr);
3764 #else
3765     thr->self = pthread_self();
3766 #endif /* SET_THREAD_SELF */
3767     PERL_SET_THX(thr);
3768
3769     /*
3770      * These must come after the thread self setting
3771      * because sv_setpvn does SvTAINT and the taint
3772      * fields thread selfness being set.
3773      */
3774     PL_toptarget = NEWSV(0,0);
3775     sv_upgrade(PL_toptarget, SVt_PVFM);
3776     sv_setpvn(PL_toptarget, "", 0);
3777     PL_bodytarget = NEWSV(0,0);
3778     sv_upgrade(PL_bodytarget, SVt_PVFM);
3779     sv_setpvn(PL_bodytarget, "", 0);
3780     PL_formtarget = PL_bodytarget;
3781     thr->errsv = newSVpvn("", 0);
3782     (void) find_threadsv("@");  /* Ensure $@ is initialised early */
3783
3784     PL_maxscream = -1;
3785     PL_regcompp = MEMBER_TO_FPTR(Perl_pregcomp);
3786     PL_regexecp = MEMBER_TO_FPTR(Perl_regexec_flags);
3787     PL_regint_start = MEMBER_TO_FPTR(Perl_re_intuit_start);
3788     PL_regint_string = MEMBER_TO_FPTR(Perl_re_intuit_string);
3789     PL_regfree = MEMBER_TO_FPTR(Perl_pregfree);
3790     PL_regindent = 0;
3791     PL_reginterp_cnt = 0;
3792
3793     return thr;
3794 }
3795 #endif /* USE_THREADS */
3796
3797 void
3798 Perl_call_list(pTHX_ I32 oldscope, AV *paramList)
3799 {
3800     SV *atsv;
3801     line_t oldline = CopLINE(PL_curcop);
3802     CV *cv;
3803     STRLEN len;
3804     int ret;
3805     dJMPENV;
3806
3807     while (AvFILL(paramList) >= 0) {
3808         cv = (CV*)av_shift(paramList);
3809         if ((PL_minus_c & 0x10) && (paramList == PL_beginav)) {
3810                 /* save PL_beginav for compiler */
3811             if (! PL_beginav_save)
3812                 PL_beginav_save = newAV();
3813             av_push(PL_beginav_save, (SV*)cv);
3814         } else {
3815             SAVEFREESV(cv);
3816         }
3817 #ifdef PERL_FLEXIBLE_EXCEPTIONS
3818         CALLPROTECT(aTHX_ pcur_env, &ret, MEMBER_TO_FPTR(S_vcall_list_body), cv);
3819 #else
3820         JMPENV_PUSH(ret);
3821 #endif
3822         switch (ret) {
3823         case 0:
3824 #ifndef PERL_FLEXIBLE_EXCEPTIONS
3825             call_list_body(cv);
3826 #endif
3827             atsv = ERRSV;
3828             (void)SvPV(atsv, len);
3829             if (len) {
3830                 STRLEN n_a;
3831                 PL_curcop = &PL_compiling;
3832                 CopLINE_set(PL_curcop, oldline);
3833                 if (paramList == PL_beginav)
3834                     sv_catpv(atsv, "BEGIN failed--compilation aborted");
3835                 else
3836                     Perl_sv_catpvf(aTHX_ atsv,
3837                                    "%s failed--call queue aborted",
3838                                    paramList == PL_checkav ? "CHECK"
3839                                    : paramList == PL_initav ? "INIT"
3840                                    : "END");
3841                 while (PL_scopestack_ix > oldscope)
3842                     LEAVE;
3843                 JMPENV_POP;
3844                 Perl_croak(aTHX_ "%s", SvPVx(atsv, n_a));
3845             }
3846             break;
3847         case 1:
3848             STATUS_ALL_FAILURE;
3849             /* FALL THROUGH */
3850         case 2:
3851             /* my_exit() was called */
3852             while (PL_scopestack_ix > oldscope)
3853                 LEAVE;
3854             FREETMPS;
3855             PL_curstash = PL_defstash;
3856             PL_curcop = &PL_compiling;
3857             CopLINE_set(PL_curcop, oldline);
3858             JMPENV_POP;
3859             if (PL_statusvalue && !(PL_exit_flags & PERL_EXIT_EXPECTED)) {
3860                 if (paramList == PL_beginav)
3861                     Perl_croak(aTHX_ "BEGIN failed--compilation aborted");
3862                 else
3863                     Perl_croak(aTHX_ "%s failed--call queue aborted",
3864                                paramList == PL_checkav ? "CHECK"
3865                                : paramList == PL_initav ? "INIT"
3866                                : "END");
3867             }
3868             my_exit_jump();
3869             /* NOTREACHED */
3870         case 3:
3871             if (PL_restartop) {
3872                 PL_curcop = &PL_compiling;
3873                 CopLINE_set(PL_curcop, oldline);
3874                 JMPENV_JUMP(3);
3875             }
3876             PerlIO_printf(Perl_error_log, "panic: restartop\n");
3877             FREETMPS;
3878             break;
3879         }
3880         JMPENV_POP;
3881     }
3882 }
3883
3884 #ifdef PERL_FLEXIBLE_EXCEPTIONS
3885 STATIC void *
3886 S_vcall_list_body(pTHX_ va_list args)
3887 {
3888     CV *cv = va_arg(args, CV*);
3889     return call_list_body(cv);
3890 }
3891 #endif
3892
3893 STATIC void *
3894 S_call_list_body(pTHX_ CV *cv)
3895 {
3896     PUSHMARK(PL_stack_sp);
3897     call_sv((SV*)cv, G_EVAL|G_DISCARD);
3898     return NULL;
3899 }
3900
3901 void
3902 Perl_my_exit(pTHX_ U32 status)
3903 {
3904     DEBUG_S(PerlIO_printf(Perl_debug_log, "my_exit: thread %p, status %lu\n",
3905                           thr, (unsigned long) status));
3906     switch (status) {
3907     case 0:
3908         STATUS_ALL_SUCCESS;
3909         break;
3910     case 1:
3911         STATUS_ALL_FAILURE;
3912         break;
3913     default:
3914         STATUS_NATIVE_SET(status);
3915         break;
3916     }
3917     my_exit_jump();
3918 }
3919
3920 void
3921 Perl_my_failure_exit(pTHX)
3922 {
3923 #ifdef VMS
3924     if (vaxc$errno & 1) {
3925         if (STATUS_NATIVE & 1)          /* fortuitiously includes "-1" */
3926             STATUS_NATIVE_SET(44);
3927     }
3928     else {
3929         if (!vaxc$errno && errno)       /* unlikely */
3930             STATUS_NATIVE_SET(44);
3931         else
3932             STATUS_NATIVE_SET(vaxc$errno);
3933     }
3934 #else
3935     int exitstatus;
3936     if (errno & 255)
3937         STATUS_POSIX_SET(errno);
3938     else {
3939         exitstatus = STATUS_POSIX >> 8;
3940         if (exitstatus & 255)
3941             STATUS_POSIX_SET(exitstatus);
3942         else
3943             STATUS_POSIX_SET(255);
3944     }
3945 #endif
3946     my_exit_jump();
3947 }
3948
3949 STATIC void
3950 S_my_exit_jump(pTHX)
3951 {
3952     register PERL_CONTEXT *cx;
3953     I32 gimme;
3954     SV **newsp;
3955
3956     if (PL_e_script) {
3957         SvREFCNT_dec(PL_e_script);
3958         PL_e_script = Nullsv;
3959     }
3960
3961     POPSTACK_TO(PL_mainstack);
3962     if (cxstack_ix >= 0) {
3963         if (cxstack_ix > 0)
3964             dounwind(0);
3965         POPBLOCK(cx,PL_curpm);
3966         LEAVE;
3967     }
3968
3969     JMPENV_JUMP(2);
3970 }
3971
3972 #ifdef PERL_OBJECT
3973 #include "XSUB.h"
3974 #endif
3975
3976 static I32
3977 read_e_script(pTHXo_ int idx, SV *buf_sv, int maxlen)
3978 {
3979     char *p, *nl;
3980     p  = SvPVX(PL_e_script);
3981     nl = strchr(p, '\n');
3982     nl = (nl) ? nl+1 : SvEND(PL_e_script);
3983     if (nl-p == 0) {
3984         filter_del(read_e_script);
3985         return 0;
3986     }
3987     sv_catpvn(buf_sv, p, nl-p);
3988     sv_chop(PL_e_script, nl);
3989     return 1;
3990 }