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