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