add better pod and headers, and clean up some whitespace issues in the previous patches
[perl.git] / intrpvar.h
1 /*   intrpvar.h 
2  *
3  *    Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
4  *    2006, 2007, 2008 by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12 =head1 Per-Interpreter Variables
13 */
14
15 /* These variables are per-interpreter in threaded/multiplicity builds,
16  * global otherwise.
17
18  * Don't forget to re-run embed.pl to propagate changes! */
19
20 /* New variables must be added to the very end for binary compatibility.
21  * XSUB.h provides wrapper functions via perlapi.h that make this
22  * irrelevant, but not all code may be expected to #include XSUB.h. */
23
24 /* Don't forget to add your variable also to perl_clone()! */
25
26 /* The 'I' prefix is only needed for vars that need appropriate #defines
27  * generated when built with or without MULTIPLICITY.  It is also used
28  * to generate the appropriate export list for win32.
29  *
30  * When building without MULTIPLICITY, these variables will be truly global.
31  *
32  * Important ones in the first cache line (if alignment is done right) */
33
34 PERLVAR(Istack_sp,      SV **)          /* top of the stack */
35 #ifdef OP_IN_REGISTER
36 PERLVAR(Iopsave,        OP *)
37 #else
38 PERLVAR(Iop,            OP *)           /* currently executing op */
39 #endif
40 PERLVAR(Icurpad,        SV **)          /* active pad (lexicals+tmps) */
41
42 PERLVAR(Istack_base,    SV **)
43 PERLVAR(Istack_max,     SV **)
44
45 PERLVAR(Iscopestack,    I32 *)          /* scopes we've ENTERed */
46 PERLVAR(Iscopestack_ix, I32)
47 PERLVAR(Iscopestack_max,I32)
48
49 PERLVAR(Isavestack,     ANY *)          /* items that need to be restored when
50                                            LEAVEing scopes we've ENTERed */
51 PERLVAR(Isavestack_ix,  I32)
52 PERLVAR(Isavestack_max, I32)
53
54 PERLVAR(Itmps_stack,    SV **)          /* mortals we've made */
55 PERLVARI(Itmps_ix,      I32,    -1)
56 PERLVARI(Itmps_floor,   I32,    -1)
57 PERLVAR(Itmps_max,      I32)
58 PERLVAR(Imodcount,      I32)            /* how much mod()ification in
59                                            assignment? */
60
61 PERLVAR(Imarkstack,     I32 *)          /* stack_sp locations we're
62                                            remembering */
63 PERLVAR(Imarkstack_ptr, I32 *)
64 PERLVAR(Imarkstack_max, I32 *)
65
66 PERLVAR(ISv,            SV *)           /* used to hold temporary values */
67 PERLVAR(IXpv,           XPV *)          /* used to hold temporary values */
68
69 /*
70 =for apidoc Amn|STRLEN|PL_na
71
72 A convenience variable which is typically used with C<SvPV> when one
73 doesn't care about the length of the string.  It is usually more efficient
74 to either declare a local variable and use that instead or to use the
75 C<SvPV_nolen> macro.
76
77 =cut
78 */
79
80 PERLVAR(Ina,            STRLEN)         /* for use in SvPV when length is
81                                            Not Applicable */
82
83 /* stat stuff */
84 PERLVAR(Istatbuf,       Stat_t)
85 PERLVAR(Istatcache,     Stat_t)         /* _ */
86 PERLVAR(Istatgv,        GV *)
87 PERLVARI(Istatname,     SV *,   NULL)
88
89 #ifdef HAS_TIMES
90 PERLVAR(Itimesbuf,      struct tms)
91 #endif
92
93 /* Fields used by magic variables such as $@, $/ and so on */
94 PERLVAR(Icurpm,         PMOP *)         /* what to do \ interps in REs from */
95
96 /*
97 =for apidoc mn|SV*|PL_rs
98
99 The input record separator - C<$/> in Perl space.
100
101 =for apidoc mn|GV*|PL_last_in_gv
102
103 The GV which was last used for a filehandle input operation. (C<< <FH> >>)
104
105 =for apidoc mn|GV*|PL_ofsgv
106
107 The glob containing the output field separator - C<*,> in Perl space.
108
109 =cut
110 */
111
112 PERLVAR(Irs,            SV *)           /* input record separator $/ */
113 PERLVAR(Ilast_in_gv,    GV *)           /* GV used in last <FH> */
114 PERLVAR(Iofsgv,         GV *)           /* GV of output field separator *, */
115 PERLVAR(Idefoutgv,      GV *)           /* default FH for output */
116 PERLVARI(Ichopset,      const char *, " \n-")   /* $: */
117 PERLVAR(Iformtarget,    SV *)
118 PERLVAR(Ibodytarget,    SV *)
119 PERLVAR(Itoptarget,     SV *)
120
121 /* Stashes */
122 PERLVAR(Idefstash,      HV *)           /* main symbol table */
123 PERLVAR(Icurstash,      HV *)           /* symbol table for current package */
124
125 PERLVAR(Irestartop,     OP *)           /* propagating an error from croak? */
126 PERLVAR(Icurcop,        COP *)
127 PERLVAR(Icurstack,      AV *)           /* THE STACK */
128 PERLVAR(Icurstackinfo,  PERL_SI *)      /* current stack + context */
129 PERLVAR(Imainstack,     AV *)           /* the stack when nothing funny is
130                                            happening */
131
132 PERLVAR(Itop_env,       JMPENV *)       /* ptr to current sigjmp environment */
133 PERLVAR(Istart_env,     JMPENV)         /* empty startup sigjmp environment */
134 PERLVARI(Ierrors,       SV *,   NULL)   /* outstanding queued errors */
135
136 /* statics "owned" by various functions */
137 PERLVAR(Ihv_fetch_ent_mh, HE*)          /* owned by hv_fetch_ent() */
138
139 PERLVAR(Ilastgotoprobe, OP*)            /* from pp_ctl.c */
140
141 /* sort stuff */
142 PERLVAR(Isortcop,       OP *)           /* user defined sort routine */
143 PERLVAR(Isortstash,     HV *)           /* which is in some package or other */
144 PERLVAR(Ifirstgv,       GV *)           /* $a */
145 PERLVAR(Isecondgv,      GV *)           /* $b */
146
147 /* float buffer */
148 PERLVAR(Iefloatbuf,     char *)
149 PERLVAR(Iefloatsize,    STRLEN)
150
151 /* regex stuff */
152
153 PERLVAR(Iscreamfirst,   I32 *)
154 PERLVAR(Iscreamnext,    I32 *)
155 PERLVAR(Ilastscream,    SV *)
156
157 PERLVAR(Ireg_state,     struct re_save_state)
158
159 PERLVAR(Iregdummy,      regnode)        /* from regcomp.c */
160
161 PERLVARI(Idumpindent,   U16,    4)      /* number of blanks per dump
162                                            indentation level */
163
164
165 PERLVAR(Iutf8locale,    bool)           /* utf8 locale detected */
166 PERLVARI(Irehash_seed_set, bool, FALSE) /* 582 hash initialized? */
167
168 PERLVARA(Icolors,6,     char *)         /* from regcomp.c */
169
170 PERLVARI(Ipeepp,        peep_t, MEMBER_TO_FPTR(Perl_peep))
171                                         /* Pointer to peephole optimizer */
172
173 PERLVARI(Imaxscream,    I32,    -1)
174 PERLVARI(Ireginterp_cnt,I32,     0)     /* Whether "Regexp" was interpolated. */
175 PERLVARI(Iwatchaddr,    char **, 0)
176 PERLVAR(Iwatchok,       char *)
177
178 /* the currently active slab in a chain of slabs of regmatch states,
179  * and the currently active state within that slab */
180
181 PERLVARI(Iregmatch_slab, regmatch_slab *,       NULL)
182 PERLVAR(Iregmatch_state, regmatch_state *)
183
184 /* Put anything new that is pointer aligned here. */
185
186 PERLVAR(Idelaymagic,    U16)            /* ($<,$>) = ... */
187 PERLVAR(Ilocalizing,    U8)             /* are we processing a local() list? */
188 PERLVAR(Icolorset,      bool)           /* from regcomp.c */
189 PERLVARI(Idirty,        bool, FALSE)    /* in the middle of tearing things
190                                            down? */
191 PERLVAR(Iin_eval,       U8)             /* trap "fatal" errors? */
192 PERLVAR(Itainted,       bool)           /* using variables controlled by $< */
193
194 /* This value may be set when embedding for full cleanup  */
195 /* 0=none, 1=full, 2=full with checks */
196 /* mod_perl is special, and also assigns a meaning -1 */
197 PERLVARI(Iperl_destruct_level,  signed char,    0)
198
199 PERLVAR(Iperldb,        U32)
200
201 /* pseudo environmental stuff */
202 PERLVAR(Iorigargc,      int)
203 PERLVAR(Iorigargv,      char **)
204 PERLVAR(Ienvgv,         GV *)
205 PERLVAR(Iincgv,         GV *)
206 PERLVAR(Ihintgv,        GV *)
207 PERLVAR(Iorigfilename,  char *)
208 PERLVAR(Idiehook,       SV *)
209 PERLVAR(Iwarnhook,      SV *)
210
211 /* switches */
212 PERLVAR(Ipatchlevel,    SV *)
213 PERLVAR(Ilocalpatches,  const char * const *)
214 PERLVARI(Isplitstr,     const char *, " ")
215
216 PERLVAR(Iminus_c,       bool)
217 PERLVAR(Iminus_n,       bool)
218 PERLVAR(Iminus_p,       bool)
219 PERLVAR(Iminus_l,       bool)
220 PERLVAR(Iminus_a,       bool)
221 PERLVAR(Iminus_F,       bool)
222 PERLVAR(Idoswitches,    bool)
223 PERLVAR(Iminus_E,       bool)
224
225 /*
226
227 =for apidoc mn|bool|PL_dowarn
228
229 The C variable which corresponds to Perl's $^W warning variable.
230
231 =cut
232 */
233
234 PERLVAR(Idowarn,        U8)
235 PERLVAR(Idoextract,     bool)
236 PERLVAR(Isawampersand,  bool)           /* must save all match strings */
237 PERLVAR(Iunsafe,        bool)
238 PERLVAR(Iexit_flags,    U8)             /* was exit() unexpected, etc. */
239 PERLVAR(Isrand_called,  bool)
240 /* Part of internal state, but makes the 16th 1 byte variable in a row.  */
241 PERLVAR(Itainting,      bool)           /* doing taint checks */
242 /* Space for a U8 */
243 PERLVAR(Iinplace,       char *)
244 PERLVAR(Ie_script,      SV *)
245
246 /* magical thingies */
247 PERLVAR(Ibasetime,      Time_t)         /* $^T */
248 PERLVAR(Iformfeed,      SV *)           /* $^L */
249
250
251 PERLVARI(Imaxsysfd,     I32,    MAXSYSFD)
252                                         /* top fd to pass to subprocesses */
253 PERLVAR(Istatusvalue,   I32)            /* $? */
254 #ifdef VMS
255 PERLVAR(Istatusvalue_vms,U32)
256 #else
257 PERLVAR(Istatusvalue_posix,I32)
258 #endif
259
260 PERLVARI(Isig_pending, int,0)           /* Number if highest signal pending */
261 PERLVAR(Ipsig_pend, int *)              /* per-signal "count" of pending */
262
263 /* shortcuts to various I/O objects */
264 PERLVAR(Istdingv,       GV *)
265 PERLVAR(Istderrgv,      GV *)
266 PERLVAR(Idefgv,         GV *)
267 PERLVAR(Iargvgv,        GV *)
268 PERLVAR(Iargvoutgv,     GV *)
269 PERLVAR(Iargvout_stack, AV *)
270
271 /* shortcuts to regexp stuff */
272 PERLVAR(Ireplgv,        GV *)
273
274 /* shortcuts to misc objects */
275 PERLVAR(Ierrgv,         GV *)
276
277 /* shortcuts to debugging objects */
278 PERLVAR(IDBgv,          GV *)
279 PERLVAR(IDBline,        GV *)
280
281 /*
282 =for apidoc mn|GV *|PL_DBsub
283 When Perl is run in debugging mode, with the B<-d> switch, this GV contains
284 the SV which holds the name of the sub being debugged.  This is the C
285 variable which corresponds to Perl's $DB::sub variable.  See
286 C<PL_DBsingle>.
287
288 =for apidoc mn|SV *|PL_DBsingle
289 When Perl is run in debugging mode, with the B<-d> switch, this SV is a
290 boolean which indicates whether subs are being single-stepped.
291 Single-stepping is automatically turned on after every step.  This is the C
292 variable which corresponds to Perl's $DB::single variable.  See
293 C<PL_DBsub>.
294
295 =for apidoc mn|SV *|PL_DBtrace
296 Trace variable used when Perl is run in debugging mode, with the B<-d>
297 switch.  This is the C variable which corresponds to Perl's $DB::trace
298 variable.  See C<PL_DBsingle>.
299
300 =cut
301 */
302
303 PERLVAR(IDBsub,         GV *)
304 PERLVAR(IDBsingle,      SV *)
305 PERLVAR(IDBtrace,       SV *)
306 PERLVAR(IDBsignal,      SV *)
307 PERLVAR(Idbargs,        AV *)           /* args to call listed by caller function */
308
309 /* symbol tables */
310 PERLVAR(Idebstash,      HV *)           /* symbol table for perldb package */
311 PERLVAR(Iglobalstash,   HV *)           /* global keyword overrides imported here */
312 PERLVAR(Icurstname,     SV *)           /* name of current package */
313 PERLVAR(Ibeginav,       AV *)           /* names of BEGIN subroutines */
314 PERLVAR(Iendav,         AV *)           /* names of END subroutines */
315 PERLVAR(Iunitcheckav,   AV *)           /* names of UNITCHECK subroutines */
316 PERLVAR(Icheckav,       AV *)           /* names of CHECK subroutines */
317 PERLVAR(Iinitav,        AV *)           /* names of INIT subroutines */
318 PERLVAR(Istrtab,        HV *)           /* shared string table */
319 PERLVARI(Isub_generation,U32,1)         /* incr to invalidate method cache */
320
321 /* funky return mechanisms */
322 PERLVAR(Iforkprocess,   int)            /* so do_open |- can return proc# */
323
324 /* memory management */
325 PERLVAR(Isv_count,      I32)            /* how many SV* are currently allocated */
326 PERLVAR(Isv_objcount,   I32)            /* how many objects are currently allocated */
327 PERLVAR(Isv_root,       SV*)            /* storage for SVs belonging to interp */
328 PERLVAR(Isv_arenaroot,  SV*)            /* list of areas for garbage collection */
329
330 /* subprocess state */
331 PERLVAR(Ifdpid,         AV *)           /* keep fd-to-pid mappings for my_popen */
332
333 /* internal state */
334 PERLVARI(Iop_mask,      char *, NULL)   /* masked operations for safe evals */
335
336 /* current interpreter roots */
337 PERLVAR(Imain_cv,       CV *)
338 PERLVAR(Imain_root,     OP *)
339 PERLVAR(Imain_start,    OP *)
340 PERLVAR(Ieval_root,     OP *)
341 PERLVAR(Ieval_start,    OP *)
342
343 /* runtime control stuff */
344 PERLVARI(Icurcopdb,     COP *,  NULL)
345
346 PERLVAR(Ifilemode,      int)            /* so nextargv() can preserve mode */
347 PERLVAR(Ilastfd,        int)            /* what to preserve mode on */
348 PERLVAR(Ioldname,       char *)         /* what to preserve mode on */
349 PERLVAR(IArgv,          const char **)  /* stuff to free from do_aexec, vfork safe */
350 PERLVAR(ICmd,           char *)         /* stuff to free from do_aexec, vfork safe */
351 /* Elements in this array have ';' appended and are injected as a single line
352    into the tokeniser. You can't put any (literal) newlines into any program
353    you stuff in into this array, as the point where it's injected is expecting
354    a single physical line. */
355 PERLVAR(Ipreambleav,    AV *)
356 PERLVAR(Imess_sv,       SV *)
357 PERLVAR(Iors_sv,        SV *)           /* output record separator $\ */
358 /* statics moved here for shared library purposes */
359 PERLVARI(Igensym,       I32,    0)      /* next symbol for getsym() to define */
360 PERLVARI(Icv_has_eval, bool, FALSE) /* PL_compcv includes an entereval or similar */
361 PERLVAR(Itaint_warn,    bool)      /* taint warns instead of dying */
362 PERLVARI(Ilaststype,    U16,    OP_STAT)
363 PERLVARI(Ilaststatval,  int,    -1)
364
365 /* interpreter atexit processing */
366 PERLVARI(Iexitlistlen,  I32, 0)         /* length of same */
367 PERLVARI(Iexitlist,     PerlExitListEntry *, NULL)
368                                         /* list of exit functions */
369
370 /*
371 =for apidoc Amn|HV*|PL_modglobal
372
373 C<PL_modglobal> is a general purpose, interpreter global HV for use by
374 extensions that need to keep information on a per-interpreter basis.
375 In a pinch, it can also be used as a symbol table for extensions
376 to share data among each other.  It is a good idea to use keys
377 prefixed by the package name of the extension that owns the data.
378
379 =cut
380 */
381
382 PERLVAR(Imodglobal,     HV *)           /* per-interp module data */
383
384 /* these used to be in global before 5.004_68 */
385 PERLVARI(Iprofiledata,  U32 *,  NULL)   /* table of ops, counts */
386
387 PERLVAR(Icompiling,     COP)            /* compiling/done executing marker */
388
389 PERLVAR(Icompcv,        CV *)           /* currently compiling subroutine */
390 PERLVAR(Icomppad,       AV *)           /* storage for lexically scoped temporaries */
391 PERLVAR(Icomppad_name,  AV *)           /* variable names for "my" variables */
392 PERLVAR(Icomppad_name_fill,     I32)    /* last "introduced" variable offset */
393 PERLVAR(Icomppad_name_floor,    I32)    /* start of vars in innermost block */
394
395 #ifdef HAVE_INTERP_INTERN
396 PERLVAR(Isys_intern,    struct interp_intern)
397                                         /* platform internals */
398 #endif
399
400 /* more statics moved here */
401 PERLVAR(IDBcv,          CV *)           /* from perl.c */
402 PERLVARI(Igeneration,   int,    100)    /* from op.c */
403
404 PERLVARI(Iin_clean_objs,bool,    FALSE) /* from sv.c */
405 PERLVARI(Iin_clean_all, bool,    FALSE) /* from sv.c */
406 PERLVAR(Inomemok,       bool)           /* let malloc context handle nomem */
407 PERLVARI(Isavebegin,     bool,  FALSE)  /* save BEGINs for compiler     */
408
409 PERLVAR(Iuid,           Uid_t)          /* current real user id */
410 PERLVAR(Ieuid,          Uid_t)          /* current effective user id */
411 PERLVAR(Igid,           Gid_t)          /* current real group id */
412 PERLVAR(Iegid,          Gid_t)          /* current effective group id */
413 PERLVARI(Ian,           U32,    0)      /* malloc sequence number */
414 PERLVARI(Icop_seqmax,   U32,    0)      /* statement sequence number */
415 PERLVARI(Ievalseq,      U32,    0)      /* eval sequence number */
416 PERLVAR(Iorigalen,      U32)
417 PERLVAR(Iorigenviron,   char **)
418 #ifdef PERL_USES_PL_PIDSTATUS
419 PERLVAR(Ipidstatus,     HV *)           /* pid-to-status mappings for waitpid */
420 #endif
421 PERLVAR(Iosname,        char *)         /* operating system */
422
423 PERLVAR(Isighandlerp,   Sighandler_t)
424
425 PERLVARA(Ibody_roots,   PERL_ARENA_ROOTS_SIZE, void*) /* array of body roots */
426
427 PERLVAR(Inice_chunk,    char *)         /* a nice chunk of memory to reuse */
428 PERLVAR(Inice_chunk_size,       U32)    /* how nice the chunk of memory is */
429
430 PERLVARI(Imaxo, int,    MAXO)           /* maximum number of ops */
431
432 PERLVARI(Irunops,       runops_proc_t,  MEMBER_TO_FPTR(RUNOPS_DEFAULT))
433
434 /*
435 =for apidoc Amn|SV|PL_sv_undef
436 This is the C<undef> SV.  Always refer to this as C<&PL_sv_undef>.
437
438 =for apidoc Amn|SV|PL_sv_no
439 This is the C<false> SV.  See C<PL_sv_yes>.  Always refer to this as
440 C<&PL_sv_no>.
441
442 =for apidoc Amn|SV|PL_sv_yes
443 This is the C<true> SV.  See C<PL_sv_no>.  Always refer to this as
444 C<&PL_sv_yes>.
445
446 =cut
447 */
448
449 PERLVAR(Isv_undef,      SV)
450 PERLVAR(Isv_no,         SV)
451 PERLVAR(Isv_yes,        SV)
452
453 PERLVAR(Isubname,       SV *)           /* name of current subroutine */
454
455 PERLVAR(Isubline,       I32)            /* line this subroutine began on */
456 PERLVAR(Imin_intro_pending,     I32)    /* start of vars to introduce */
457
458 PERLVAR(Imax_intro_pending,     I32)    /* end of vars to introduce */
459 PERLVAR(Ipadix,         I32)            /* max used index in current "register" pad */
460
461 PERLVAR(Ipadix_floor,   I32)            /* how low may inner block reset padix */
462
463 PERLVAR(Ihints,         U32)            /* pragma-tic compile-time flags */
464
465 PERLVAR(Idebug,         VOL U32)        /* flags given to -D switch */
466
467 /* Perl_Ibreakable_sub_generation_ptr was too long for VMS, hence "gen"  */
468 PERLVARI(Ibreakable_sub_gen, U32, 0)
469
470 PERLVARI(Iamagic_generation,    long,   0)
471
472 #ifdef USE_LOCALE_COLLATE
473 PERLVAR(Icollation_name,char *)         /* Name of current collation */
474 PERLVAR(Icollxfrm_base, Size_t)         /* Basic overhead in *xfrm() */
475 PERLVARI(Icollxfrm_mult,Size_t, 2)      /* Expansion factor in *xfrm() */
476 PERLVARI(Icollation_ix, U32,    0)      /* Collation generation index */
477 PERLVARI(Icollation_standard, bool,     TRUE)
478                                         /* Assume simple collation */
479 #endif /* USE_LOCALE_COLLATE */
480
481
482 #if defined (PERL_UTF8_CACHE_ASSERT) || defined (DEBUGGING)
483 #  define PERL___I -1
484 #else
485 #  define PERL___I 1
486 #endif
487 PERLVARI(Iutf8cache, I8, PERL___I)      /* Is the utf8 caching code enabled? */
488 #undef PERL___I
489
490
491 #ifdef USE_LOCALE_NUMERIC
492
493 PERLVARI(Inumeric_standard,     bool,   TRUE)
494                                         /* Assume simple numerics */
495 PERLVARI(Inumeric_local,        bool,   TRUE)
496                                         /* Assume local numerics */
497 PERLVAR(Inumeric_name,  char *)         /* Name of current numeric locale */
498 #endif /* !USE_LOCALE_NUMERIC */
499
500 /* utf8 character classes */
501 PERLVAR(Iutf8_alnum,    SV *)
502 PERLVAR(Iutf8_alnumc,   SV *)
503 PERLVAR(Iutf8_ascii,    SV *)
504 PERLVAR(Iutf8_alpha,    SV *)
505 PERLVAR(Iutf8_space,    SV *)
506 PERLVAR(Iutf8_cntrl,    SV *)
507 PERLVAR(Iutf8_graph,    SV *)
508 PERLVAR(Iutf8_digit,    SV *)
509 PERLVAR(Iutf8_upper,    SV *)
510 PERLVAR(Iutf8_lower,    SV *)
511 PERLVAR(Iutf8_print,    SV *)
512 PERLVAR(Iutf8_punct,    SV *)
513 PERLVAR(Iutf8_xdigit,   SV *)
514 PERLVAR(Iutf8_mark,     SV *)
515 PERLVAR(Iutf8_toupper,  SV *)
516 PERLVAR(Iutf8_totitle,  SV *)
517 PERLVAR(Iutf8_tolower,  SV *)
518 PERLVAR(Iutf8_tofold,   SV *)
519 PERLVAR(Ilast_swash_hv, HV *)
520 PERLVAR(Ilast_swash_tmps,       U8 *)
521 PERLVAR(Ilast_swash_slen,       STRLEN)
522 PERLVARA(Ilast_swash_key,10,    U8)
523 PERLVAR(Ilast_swash_klen,       U8)     /* Only needs to store 0-10  */
524
525 #ifdef FCRYPT
526 PERLVARI(Icryptseen,    bool,   FALSE)  /* has fast crypt() been initialized? */
527 #endif
528
529 PERLVAR(Ipad_reset_pending,     bool)   /* reset pad on next attempted alloc */
530
531 PERLVARI(Iglob_index,   int,    0)
532
533
534 PERLVAR(Iparser,        yy_parser *)    /* current parser state */
535
536 PERLVAR(Ibitcount,      char *)
537
538 PERLVAR(Ipsig_ptr, SV**)
539 PERLVAR(Ipsig_name, SV**)
540
541 #if defined(PERL_IMPLICIT_SYS)
542 PERLVAR(IMem,           struct IPerlMem*)
543 PERLVAR(IMemShared,     struct IPerlMem*)
544 PERLVAR(IMemParse,      struct IPerlMem*)
545 PERLVAR(IEnv,           struct IPerlEnv*)
546 PERLVAR(IStdIO,         struct IPerlStdIO*)
547 PERLVAR(ILIO,           struct IPerlLIO*)
548 PERLVAR(IDir,           struct IPerlDir*)
549 PERLVAR(ISock,          struct IPerlSock*)
550 PERLVAR(IProc,          struct IPerlProc*)
551 #endif
552
553 PERLVAR(Iptr_table,     PTR_TBL_t*)
554 PERLVARI(Ibeginav_save, AV*, NULL)      /* save BEGIN{}s when compiling */
555
556 PERLVAR(Ibody_arenas, void*) /* pointer to list of body-arenas */
557
558
559 #ifdef USE_LOCALE_NUMERIC
560
561 PERLVAR(Inumeric_radix_sv,      SV *)   /* The radix separator if not '.' */
562
563 #endif
564
565 #if defined(USE_ITHREADS)
566 PERLVAR(Iregex_pad,     SV**)           /* Shortcut into the array of
567                                            regex_padav */
568 PERLVAR(Iregex_padav,   AV*)            /* All regex objects, indexed via the
569                                            values in op_pmoffset of pmop.
570                                            Entry 0 is an SV whose PV is a
571                                            "packed" list of IVs listing
572                                            the now-free slots in the array */
573 #endif
574
575 #ifdef USE_REENTRANT_API
576 PERLVAR(Ireentrant_buffer, REENTR*)     /* here we store the _r buffers */
577 #endif
578
579 PERLVAR(Icustom_op_names, HV*)  /* Names of user defined ops */
580 PERLVAR(Icustom_op_descs, HV*)  /* Descriptions of user defined ops */
581
582 #ifdef PERLIO_LAYERS
583 PERLVARI(Iperlio, PerlIO *,NULL)
584 PERLVARI(Iknown_layers, PerlIO_list_t *,NULL)
585 PERLVARI(Idef_layerlist, PerlIO_list_t *,NULL)
586 #endif
587
588 PERLVARI(Iencoding,     SV*, NULL)              /* character encoding */
589
590 PERLVAR(Idebug_pad,     struct perl_debug_pad)  /* always needed because of the re extension */
591
592 PERLVAR(Iutf8_idstart,  SV *)
593 PERLVAR(Iutf8_idcont,   SV *)
594
595 PERLVAR(Isort_RealCmp,  SVCOMPARE_t)
596
597 PERLVARI(Icheckav_save, AV*, NULL)      /* save CHECK{}s when compiling */
598 PERLVARI(Iunitcheckav_save, AV*, NULL)  /* save UNITCHECK{}s when compiling */
599
600 PERLVARI(Iclocktick, long, 0)   /* this many times() ticks in a second */
601
602 PERLVARI(Iin_load_module, int, 0)       /* to prevent recursions in PerlIO_find_layer */
603
604 PERLVAR(Iunicode, U32)  /* Unicode features: $ENV{PERL_UNICODE} or -C */
605
606 PERLVAR(Isignals, U32)  /* Using which pre-5.8 signals */
607
608 PERLVAR(Ireentrant_retint, int) /* Integer return value from reentrant functions */
609
610 PERLVAR(Istashcache,    HV *)           /* Cache to speed up S_method_common */
611
612 /* Hooks to shared SVs and locks. */
613 PERLVARI(Isharehook,    share_proc_t,   MEMBER_TO_FPTR(Perl_sv_nosharing))
614 PERLVARI(Ilockhook,     share_proc_t,   MEMBER_TO_FPTR(Perl_sv_nosharing))
615 #ifdef NO_MATHOMS
616 #  define PERL_UNLOCK_HOOK Perl_sv_nosharing
617 #else
618 /* This reference ensures that the mathoms are linked with perl */
619 #  define PERL_UNLOCK_HOOK Perl_sv_nounlocking
620 #endif
621 PERLVARI(Iunlockhook,   share_proc_t,   MEMBER_TO_FPTR(PERL_UNLOCK_HOOK))
622
623 PERLVARI(Ithreadhook,   thrhook_proc_t, MEMBER_TO_FPTR(Perl_nothreadhook))
624
625 PERLVARI(Ihash_seed, UV, 0)             /* Hash initializer */
626
627 PERLVARI(Irehash_seed, UV, 0)           /* 582 hash initializer */
628
629 PERLVARI(Iisarev, HV*, NULL) /* Reverse map of @ISA dependencies */
630
631 /* The last unconditional member of the interpreter structure when 5.10.0 was
632    released. The offset of the end of this is baked into a global variable in 
633    any shared perl library which will allow a sanity test in future perl
634    releases.  */
635 #define PERL_LAST_5_10_0_INTERP_MEMBER  Iisarev
636
637 #ifdef PERL_IMPLICIT_CONTEXT
638 PERLVARI(Imy_cxt_size, int, 0)          /* size of PL_my_cxt_list */
639 PERLVARI(Imy_cxt_list, void **, NULL) /* per-module array of MY_CXT pointers */
640 #  ifdef PERL_GLOBAL_STRUCT_PRIVATE
641 PERLVARI(Imy_cxt_keys, const char **, NULL) /* per-module array of pointers to MY_CXT_KEY constants */
642 #  endif
643 #endif
644
645 #ifdef PERL_TRACK_MEMPOOL
646 /* For use with the memory debugging code in util.c  */
647 PERLVAR(Imemory_debug_header, struct perl_memory_debug_header)
648 #endif
649
650 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
651 /* File descriptor to talk to the child which dumps scalars.  */
652 PERLVARI(Idumper_fd, int, -1)
653 #endif
654
655 /* Stores the PPID */
656 #ifdef THREADS_HAVE_PIDS
657 PERLVARI(Ippid,         IV,             0)
658 #endif
659
660 #ifdef PERL_MAD
661 PERLVARI(Imadskills,    bool, FALSE)    /* preserve all syntactic info */
662                                         /* (MAD = Misc Attribute Decoration) */
663 PERLVARI(Ixmlfp, PerlIO *,NULL)
664 #endif
665
666 #ifdef PL_OP_SLAB_ALLOC
667 PERLVAR(IOpPtr,I32 **)
668 PERLVARI(IOpSpace,I32,0)
669 PERLVAR(IOpSlab,I32 *)
670 #endif
671
672 #ifdef PERL_DEBUG_READONLY_OPS
673 PERLVARI(Islabs, I32**, NULL)   /* Array of slabs that have been allocated */
674 PERLVARI(Islab_count, U32, 0)   /* Size of the array */
675 #endif
676
677 /* Can shared object be destroyed */
678 PERLVARI(Idestroyhook, destroyable_proc_t, MEMBER_TO_FPTR(Perl_sv_destroyable))
679
680 #ifdef DEBUG_LEAKING_SCALARS
681 PERLVARI(Isv_serial, U32, 0) /* SV serial number, used in sv.c */
682 #endif
683
684 /* Register of known Method Resolution Orders.
685    What this actually points to is an implementation detail (it may change to
686    a structure incorporating a reference count - use mro_get_from_name to
687    retrieve a C<struct mro_alg *>  */
688 PERLVAR(Iregistered_mros, HV *)
689
690 /* If you are adding a U8 or U16, check to see if there are 'Space' comments
691  * above on where there are gaps which currently will be structure padding.  */
692
693 /* Within a stable branch, new variables must be added to the very end, before
694  * this comment, for binary compatibility (the offsets of the old members must
695  *  not change).
696  * (Don't forget to add your variable also to perl_clone()!)
697  * XSUB.h provides wrapper functions via perlapi.h that make this
698  * irrelevant, but not all code may be expected to #include XSUB.h.
699  */