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