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