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