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