This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add --crash option for Porting/bisect
[perl5.git] / intrpvar.h
... / ...
CommitLineData
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#include "handy.h"
12
13/*
14=head1 Per-Interpreter Variables
15*/
16
17/* These variables are per-interpreter in threaded/multiplicity builds,
18 * global otherwise.
19
20 * Don't forget to re-run regen/embed.pl to propagate changes! */
21
22/* New variables must be added to the very end for binary compatibility. */
23
24/* Don't forget to add your variable also to perl_clone()! (in sv.c) */
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. If the variable
29 * needs to be initialized, use PERLVARI.
30 *
31 * When building without MULTIPLICITY, these variables will be truly global.
32 *
33 * Important ones in the first cache line (if alignment is done right) */
34
35PERLVAR(I, stack_sp, SV **) /* top of the stack */
36PERLVAR(I, op, OP *) /* currently executing op */
37PERLVAR(I, curpad, SV **) /* active pad (lexicals+tmps) */
38
39PERLVAR(I, stack_base, SV **)
40PERLVAR(I, stack_max, SV **)
41
42PERLVAR(I, savestack, ANY *) /* items that need to be restored when
43 LEAVEing scopes we've ENTERed */
44PERLVAR(I, savestack_ix, I32)
45PERLVAR(I, savestack_max, I32)
46
47PERLVAR(I, scopestack, I32 *) /* scopes we've ENTERed */
48PERLVAR(I, scopestack_ix, I32)
49PERLVAR(I, scopestack_max, I32)
50
51PERLVAR(I, tmps_stack, SV **) /* mortals we've made */
52PERLVARI(I, tmps_ix, SSize_t, -1)
53PERLVARI(I, tmps_floor, SSize_t, -1)
54PERLVAR(I, tmps_max, SSize_t)
55
56PERLVARI(I, sub_generation, U32, 1) /* incr to invalidate method cache */
57
58PERLVAR(I, markstack, I32 *) /* stack_sp locations we're
59 remembering */
60PERLVAR(I, markstack_ptr, I32 *)
61PERLVAR(I, markstack_max, I32 *)
62
63PERLVARI(I, sawalias, bool, FALSE) /* must enable common-vars
64 pessimisation */
65
66#ifdef PERL_HASH_RANDOMIZE_KEYS
67#ifdef USE_PERL_PERTURB_KEYS
68PERLVARI(I, hash_rand_bits_enabled, U8, 1) /* used to randomize hash stuff 0 == no-random, 1 == random, 2 == determinsitic */
69#endif
70PERLVARI(I, hash_rand_bits, UV, 0) /* used to randomize hash stuff */
71#endif
72PERLVAR(I, strtab, HV *) /* shared string table */
73/* prog counter for the currently executing OP_MULTIDEREF Used to signal
74 * to S_find_uninit_var() where we are */
75PERLVAR(I, multideref_pc, UNOP_AUX_item *)
76
77/* Fields used by magic variables such as $@, $/ and so on */
78PERLVAR(I, curpm, PMOP *) /* what to do \ interps in REs from */
79
80PERLVAR(I, tainting, bool) /* doing taint checks */
81PERLVAR(I, tainted, bool) /* using variables controlled by $< */
82PERLVAR(I, delaymagic, U16) /* ($<,$>) = ... */
83PERLVAR(I, localizing, U8) /* are we processing a local() list? */
84PERLVAR(I, in_eval, U8) /* trap "fatal" errors? */
85PERLVAR(I, defgv, GV *) /* the *_ glob */
86/*
87
88=for apidoc mn|bool|PL_dowarn
89
90The C variable which corresponds to Perl's $^W warning variable.
91
92=cut
93*/
94
95PERLVAR(I, dowarn, U8)
96
97#if defined (PERL_UTF8_CACHE_ASSERT) || defined (DEBUGGING)
98# define PERL___I -1
99#else
100# define PERL___I 1
101#endif
102PERLVARI(I, utf8cache, I8, PERL___I) /* Is the utf8 caching code enabled? */
103#undef PERL___I
104
105
106/* Stashes */
107PERLVAR(I, defstash, HV *) /* main symbol table */
108PERLVAR(I, curstash, HV *) /* symbol table for current package */
109
110PERLVAR(I, curcop, COP *)
111PERLVAR(I, curstack, AV *) /* THE STACK */
112PERLVAR(I, curstackinfo, PERL_SI *) /* current stack + context */
113PERLVAR(I, mainstack, AV *) /* the stack when nothing funny is
114 happening */
115
116/* memory management */
117PERLVAR(I, sv_count, IV) /* how many SV* are currently allocated */
118
119PERLVAR(I, sv_root, SV *) /* storage for SVs belonging to interp */
120PERLVAR(I, sv_arenaroot, SV *) /* list of areas for garbage collection */
121
122/* fake PMOP that PL_curpm points to while in (?{}) so $1 et al are visible */
123PERLVARI(I, reg_curpm, PMOP*, NULL)
124
125/* the currently active slab in a chain of slabs of regmatch states,
126 * and the currently active state within that slab. This stack of states
127 * is shared amongst re-entrant calls to the regex engine */
128
129PERLVARI(I, regmatch_slab, regmatch_slab *, NULL)
130PERLVAR(I, regmatch_state, regmatch_state *)
131
132PERLVAR(I, comppad, PAD *) /* storage for lexically scoped temporaries */
133
134/*
135=for apidoc Amn|SV|PL_sv_undef
136This is the C<undef> SV. Always refer to this as C<&PL_sv_undef>.
137
138=for apidoc Amn|SV|PL_sv_no
139This is the C<false> SV. See C<PL_sv_yes>. Always refer to this as
140C<&PL_sv_no>.
141
142=for apidoc Amn|SV|PL_sv_yes
143This is the C<true> SV. See C<PL_sv_no>. Always refer to this as
144C<&PL_sv_yes>.
145
146=cut
147*/
148
149PERLVAR(I, sv_undef, SV)
150PERLVAR(I, sv_no, SV)
151PERLVAR(I, sv_yes, SV)
152PERLVAR(I, padname_undef, PADNAME)
153PERLVAR(I, padname_const, PADNAME)
154PERLVAR(I, Sv, SV *) /* used to hold temporary values */
155
156PERLVAR(I, parser, yy_parser *) /* current parser state */
157
158PERLVAR(I, stashcache, HV *) /* Cache to speed up S_method_common */
159
160
161/*
162=for apidoc Amn|STRLEN|PL_na
163
164A convenience variable which is typically used with C<SvPV> when one
165doesn't care about the length of the string. It is usually more efficient
166to either declare a local variable and use that instead or to use the
167C<SvPV_nolen> macro.
168
169=cut
170*/
171
172PERLVAR(I, na, STRLEN) /* for use in SvPV when length is
173 Not Applicable */
174
175/* stat stuff */
176PERLVAR(I, statbuf, Stat_t)
177PERLVAR(I, statcache, Stat_t) /* _ */
178PERLVAR(I, statgv, GV *)
179PERLVARI(I, statname, SV *, NULL)
180
181#ifdef HAS_TIMES
182/* Will be removed soon after v5.21.9. See RT #121351 */
183PERLVAR(I, timesbuf, struct tms)
184#endif
185
186/*
187=for apidoc mn|SV*|PL_rs
188
189The input record separator - C<$/> in Perl space.
190
191=for apidoc mn|GV*|PL_last_in_gv
192
193The GV which was last used for a filehandle input operation. (C<< <FH> >>)
194
195=for apidoc mn|GV*|PL_ofsgv
196
197The glob containing the output field separator - C<*,> in Perl space.
198
199=cut
200*/
201
202PERLVAR(I, rs, SV *) /* input record separator $/ */
203PERLVAR(I, last_in_gv, GV *) /* GV used in last <FH> */
204PERLVAR(I, ofsgv, GV *) /* GV of output field separator *, */
205PERLVAR(I, defoutgv, GV *) /* default FH for output */
206PERLVARI(I, chopset, const char *, " \n-") /* $: */
207PERLVAR(I, formtarget, SV *)
208PERLVAR(I, bodytarget, SV *)
209PERLVAR(I, toptarget, SV *)
210
211
212PERLVAR(I, restartop, OP *) /* propagating an error from croak? */
213PERLVAR(I, restartjmpenv, JMPENV *) /* target frame for longjmp in die */
214
215PERLVAR(I, top_env, JMPENV *) /* ptr to current sigjmp environment */
216PERLVAR(I, start_env, JMPENV) /* empty startup sigjmp environment */
217PERLVARI(I, errors, SV *, NULL) /* outstanding queued errors */
218
219/* statics "owned" by various functions */
220PERLVAR(I, hv_fetch_ent_mh, HE*) /* owned by hv_fetch_ent() */
221
222PERLVAR(I, lastgotoprobe, OP*) /* from pp_ctl.c */
223
224/* sort stuff */
225PERLVAR(I, sortcop, OP *) /* user defined sort routine */
226PERLVAR(I, sortstash, HV *) /* which is in some package or other */
227PERLVAR(I, firstgv, GV *) /* $a */
228PERLVAR(I, secondgv, GV *) /* $b */
229
230/* float buffer */
231PERLVAR(I, efloatbuf, char *)
232PERLVAR(I, efloatsize, STRLEN)
233
234PERLVARI(I, dumpindent, U16, 4) /* number of blanks per dump
235 indentation level */
236
237PERLVAR(I, exit_flags, U8) /* was exit() unexpected, etc. */
238
239PERLVAR(I, utf8locale, bool) /* utf8 locale detected */
240PERLVAR(I, in_utf8_CTYPE_locale, bool)
241PERLVAR(I, warn_locale, SV *)
242
243PERLVARA(I, colors,6, char *) /* values from PERL_RE_COLORS env var */
244
245/*
246=for apidoc Amn|peep_t|PL_peepp
247
248Pointer to the per-subroutine peephole optimiser. This is a function
249that gets called at the end of compilation of a Perl subroutine (or
250equivalently independent piece of Perl code) to perform fixups of
251some ops and to perform small-scale optimisations. The function is
252called once for each subroutine that is compiled, and is passed, as sole
253parameter, a pointer to the op that is the entry point to the subroutine.
254It modifies the op tree in place.
255
256The peephole optimiser should never be completely replaced. Rather,
257add code to it by wrapping the existing optimiser. The basic way to do
258this can be seen in L<perlguts/Compile pass 3: peephole optimization>.
259If the new code wishes to operate on ops throughout the subroutine's
260structure, rather than just at the top level, it is likely to be more
261convenient to wrap the L</PL_rpeepp> hook.
262
263=cut
264*/
265
266PERLVARI(I, peepp, peep_t, Perl_peep)
267
268/*
269=for apidoc Amn|peep_t|PL_rpeepp
270
271Pointer to the recursive peephole optimiser. This is a function
272that gets called at the end of compilation of a Perl subroutine (or
273equivalently independent piece of Perl code) to perform fixups of some
274ops and to perform small-scale optimisations. The function is called
275once for each chain of ops linked through their C<op_next> fields;
276it is recursively called to handle each side chain. It is passed, as
277sole parameter, a pointer to the op that is at the head of the chain.
278It modifies the op tree in place.
279
280The peephole optimiser should never be completely replaced. Rather,
281add code to it by wrapping the existing optimiser. The basic way to do
282this can be seen in L<perlguts/Compile pass 3: peephole optimization>.
283If the new code wishes to operate only on ops at a subroutine's top level,
284rather than throughout the structure, it is likely to be more convenient
285to wrap the L</PL_peepp> hook.
286
287=cut
288*/
289
290PERLVARI(I, rpeepp, peep_t, Perl_rpeep)
291
292/*
293=for apidoc Amn|Perl_ophook_t|PL_opfreehook
294
295When non-C<NULL>, the function pointed by this variable will be called each time an OP is freed with the corresponding OP as the argument.
296This allows extensions to free any extra attribute they have locally attached to an OP.
297It is also assured to first fire for the parent OP and then for its kids.
298
299When you replace this variable, it is considered a good practice to store the possibly previously installed hook and that you recall it inside your own.
300
301=cut
302*/
303
304PERLVARI(I, opfreehook, Perl_ophook_t, 0) /* op_free() hook */
305
306PERLVARI(I, watchaddr, char **, 0)
307PERLVAR(I, watchok, char *)
308
309PERLVAR(I, perldb, U32)
310
311PERLVAR(I, signals, U32) /* Using which pre-5.8 signals */
312
313PERLVAR(I, reentrant_retint, int) /* Integer return value from reentrant functions */
314
315/* pseudo environmental stuff */
316PERLVAR(I, origargc, int)
317PERLVAR(I, origargv, char **)
318PERLVAR(I, envgv, GV *)
319PERLVAR(I, incgv, GV *)
320PERLVAR(I, hintgv, GV *)
321PERLVAR(I, origfilename, char *)
322PERLVARI(I, xsubfilename, const char *, NULL)
323PERLVAR(I, diehook, SV *)
324PERLVAR(I, warnhook, SV *)
325
326/* switches */
327PERLVAR(I, patchlevel, SV *)
328PERLVAR(I, localpatches, const char * const *)
329PERLVARI(I, splitstr, const char *, " ")
330
331PERLVAR(I, minus_c, bool)
332PERLVAR(I, minus_n, bool)
333PERLVAR(I, minus_p, bool)
334PERLVAR(I, minus_l, bool)
335PERLVAR(I, minus_a, bool)
336PERLVAR(I, minus_F, bool)
337PERLVAR(I, doswitches, bool)
338PERLVAR(I, minus_E, bool)
339
340PERLVAR(I, inplace, char *)
341PERLVAR(I, e_script, SV *)
342
343PERLVAR(I, basetime, Time_t) /* $^T */
344
345PERLVARI(I, maxsysfd, I32, MAXSYSFD)
346 /* top fd to pass to subprocesses */
347PERLVAR(I, statusvalue, I32) /* $? */
348#ifdef VMS
349PERLVAR(I, statusvalue_vms, U32)
350#else
351PERLVAR(I, statusvalue_posix, I32)
352#endif
353
354PERLVARI(I, sig_pending, int, 0) /* Number if highest signal pending */
355PERLVAR(I, psig_pend, int *) /* per-signal "count" of pending */
356
357/* shortcuts to various I/O objects */
358PERLVAR(I, stdingv, GV *) /* *STDIN */
359PERLVAR(I, stderrgv, GV *) /* *STDERR */
360PERLVAR(I, argvgv, GV *) /* *ARGV */
361PERLVAR(I, argvoutgv, GV *) /* *ARGVOUT */
362PERLVAR(I, argvout_stack, AV *)
363
364/* shortcuts to regexp stuff */
365PERLVAR(I, replgv, GV *) /* *^R */
366
367/* shortcuts to misc objects */
368PERLVAR(I, errgv, GV *) /* *@ */
369
370/* shortcuts to debugging objects */
371PERLVAR(I, DBgv, GV *) /* *DB::DB */
372PERLVAR(I, DBline, GV *) /* *DB::line */
373
374/*
375=for apidoc mn|GV *|PL_DBsub
376When Perl is run in debugging mode, with the B<-d> switch, this GV contains
377the SV which holds the name of the sub being debugged. This is the C
378variable which corresponds to Perl's $DB::sub variable. See
379C<PL_DBsingle>.
380
381=for apidoc mn|SV *|PL_DBsingle
382When Perl is run in debugging mode, with the B<-d> switch, this SV is a
383boolean which indicates whether subs are being single-stepped.
384Single-stepping is automatically turned on after every step. This is the C
385variable which corresponds to Perl's $DB::single variable. See
386C<PL_DBsub>.
387
388=for apidoc mn|SV *|PL_DBtrace
389Trace variable used when Perl is run in debugging mode, with the B<-d>
390switch. This is the C variable which corresponds to Perl's $DB::trace
391variable. See C<PL_DBsingle>.
392
393=cut
394*/
395
396PERLVAR(I, DBsub, GV *) /* *DB::sub */
397PERLVAR(I, DBsingle, SV *) /* $DB::single */
398PERLVAR(I, DBtrace, SV *) /* $DB::trace */
399PERLVAR(I, DBsignal, SV *) /* $DB::signal */
400PERLVAR(I, dbargs, AV *) /* args to call listed by caller function */
401
402PERLVARA(I, DBcontrol, DBVARMG_COUNT, IV) /* IV versions of $DB::single, trace, signal */
403
404/* symbol tables */
405PERLVAR(I, debstash, HV *) /* symbol table for perldb package */
406PERLVAR(I, globalstash, HV *) /* global keyword overrides imported here */
407PERLVAR(I, curstname, SV *) /* name of current package */
408PERLVAR(I, beginav, AV *) /* names of BEGIN subroutines */
409PERLVAR(I, endav, AV *) /* names of END subroutines */
410PERLVAR(I, unitcheckav, AV *) /* names of UNITCHECK subroutines */
411PERLVAR(I, checkav, AV *) /* names of CHECK subroutines */
412PERLVAR(I, initav, AV *) /* names of INIT subroutines */
413
414/* subprocess state */
415PERLVAR(I, fdpid, AV *) /* keep fd-to-pid mappings for my_popen */
416
417/* internal state */
418PERLVARI(I, op_mask, char *, NULL) /* masked operations for safe evals */
419
420/* current interpreter roots */
421PERLVAR(I, main_cv, CV *)
422PERLVAR(I, main_root, OP *)
423PERLVAR(I, main_start, OP *)
424PERLVAR(I, eval_root, OP *)
425PERLVAR(I, eval_start, OP *)
426
427/* runtime control stuff */
428PERLVARI(I, curcopdb, COP *, NULL)
429
430PERLVAR(I, filemode, int) /* so nextargv() can preserve mode */
431PERLVAR(I, lastfd, int) /* what to preserve mode on */
432PERLVAR(I, oldname, char *) /* what to preserve mode on */
433PERLVAR(I, Argv, const char **) /* stuff to free from do_aexec, vfork safe */
434PERLVAR(I, Cmd, char *) /* stuff to free from do_aexec, vfork safe */
435/* Elements in this array have ';' appended and are injected as a single line
436 into the tokeniser. You can't put any (literal) newlines into any program
437 you stuff in into this array, as the point where it's injected is expecting
438 a single physical line. */
439PERLVAR(I, preambleav, AV *)
440PERLVAR(I, mess_sv, SV *)
441PERLVAR(I, ors_sv, SV *) /* output record separator $\ */
442
443/* funky return mechanisms */
444PERLVAR(I, forkprocess, int) /* so do_open |- can return proc# */
445
446/* statics moved here for shared library purposes */
447PERLVARI(I, gensym, I32, 0) /* next symbol for getsym() to define */
448PERLVARI(I, cv_has_eval, bool, FALSE) /* PL_compcv includes an entereval or similar */
449PERLVAR(I, taint_warn, bool) /* taint warns instead of dying */
450PERLVARI(I, laststype, U16, OP_STAT)
451
452PERLVARI(I, laststatval, int, -1)
453
454PERLVAR(I, modcount, I32) /* how much op_lvalue()ification in
455 assignment? */
456
457/* interpreter atexit processing */
458PERLVARI(I, exitlistlen, I32, 0) /* length of same */
459PERLVARI(I, exitlist, PerlExitListEntry *, NULL)
460 /* list of exit functions */
461
462/*
463=for apidoc Amn|HV*|PL_modglobal
464
465C<PL_modglobal> is a general purpose, interpreter global HV for use by
466extensions that need to keep information on a per-interpreter basis.
467In a pinch, it can also be used as a symbol table for extensions
468to share data among each other. It is a good idea to use keys
469prefixed by the package name of the extension that owns the data.
470
471=cut
472*/
473
474PERLVAR(I, modglobal, HV *) /* per-interp module data */
475
476/* these used to be in global before 5.004_68 */
477PERLVARI(I, profiledata, U32 *, NULL) /* table of ops, counts */
478
479PERLVAR(I, compiling, COP) /* compiling/done executing marker */
480
481PERLVAR(I, compcv, CV *) /* currently compiling subroutine */
482PERLVAR(I, comppad_name, PADNAMELIST *) /* variable names for "my" variables */
483PERLVAR(I, comppad_name_fill, I32) /* last "introduced" variable offset */
484PERLVAR(I, comppad_name_floor, I32) /* start of vars in innermost block */
485
486#ifdef HAVE_INTERP_INTERN
487PERLVAR(I, sys_intern, struct interp_intern)
488 /* platform internals */
489#endif
490
491/* more statics moved here */
492PERLVAR(I, DBcv, CV *) /* from perl.c */
493PERLVARI(I, generation, int, 100) /* from op.c */
494
495PERLVAR(I, unicode, U32) /* Unicode features: $ENV{PERL_UNICODE} or -C */
496
497PERLVARI(I, in_clean_objs,bool, FALSE) /* from sv.c */
498PERLVARI(I, in_clean_all, bool, FALSE) /* ptrs to freed SVs now legal */
499PERLVAR(I, nomemok, bool) /* let malloc context handle nomem */
500PERLVARI(I, savebegin, bool, FALSE) /* save BEGINs for compiler */
501
502
503PERLVAR(I, delaymagic_uid, Uid_t) /* current real user id, only for delaymagic */
504PERLVAR(I, delaymagic_euid, Uid_t) /* current effective user id, only for delaymagic */
505PERLVAR(I, delaymagic_gid, Gid_t) /* current real group id, only for delaymagic */
506PERLVAR(I, delaymagic_egid, Gid_t) /* current effective group id, only for delaymagic */
507PERLVARI(I, an, U32, 0) /* malloc sequence number */
508
509/* Perl_Ibreakable_sub_generation_ptr was too long for VMS, hence "gen" */
510PERLVARI(I, breakable_sub_gen, U32, 0)
511
512#ifdef DEBUGGING
513 /* exercise wrap-around */
514 #define PERL_COP_SEQMAX (U32_MAX-50)
515#else
516 #define PERL_COP_SEQMAX 0
517#endif
518PERLVARI(I, cop_seqmax, U32, PERL_COP_SEQMAX) /* statement sequence number */
519#undef PERL_COP_SEQMAX
520
521PERLVARI(I, evalseq, U32, 0) /* eval sequence number */
522PERLVAR(I, origalen, U32)
523PERLVAR(I, origenviron, char **)
524#ifdef PERL_USES_PL_PIDSTATUS
525PERLVAR(I, pidstatus, HV *) /* pid-to-status mappings for waitpid */
526#endif
527PERLVAR(I, osname, char *) /* operating system */
528
529PERLVAR(I, sighandlerp, Sighandler_t)
530
531PERLVARA(I, body_roots, PERL_ARENA_ROOTS_SIZE, void*) /* array of body roots */
532
533PERLVAR(I, debug, VOL U32) /* flags given to -D switch */
534
535PERLVARI(I, maxo, int, MAXO) /* maximum number of ops */
536
537PERLVARI(I, runops, runops_proc_t, RUNOPS_DEFAULT)
538
539PERLVAR(I, subname, SV *) /* name of current subroutine */
540
541PERLVAR(I, subline, I32) /* line this subroutine began on */
542PERLVAR(I, min_intro_pending, I32) /* start of vars to introduce */
543
544PERLVAR(I, max_intro_pending, I32) /* end of vars to introduce */
545PERLVAR(I, padix, I32) /* lowest unused index - 1
546 in current "register" pad */
547PERLVAR(I, constpadix, I32) /* lowest unused for constants */
548
549PERLVAR(I, padix_floor, I32) /* how low may inner block reset padix */
550
551#ifdef USE_LOCALE_COLLATE
552PERLVAR(I, collation_name, char *) /* Name of current collation */
553PERLVAR(I, collxfrm_base, Size_t) /* Basic overhead in *xfrm() */
554PERLVARI(I, collxfrm_mult,Size_t, 2) /* Expansion factor in *xfrm() */
555PERLVARI(I, collation_ix, U32, 0) /* Collation generation index */
556PERLVARI(I, collation_standard, bool, TRUE)
557 /* Assume simple collation */
558#endif /* USE_LOCALE_COLLATE */
559
560#ifdef PERL_SAWAMPERSAND
561PERLVAR(I, sawampersand, U8) /* must save all match strings */
562#endif
563
564PERLVAR(I, unsafe, bool)
565PERLVAR(I, colorset, bool) /* PERL_RE_COLORS env var is in use */
566
567/* current phase the interpreter is in
568 for ordering this structure to remove holes, we're assuming that this is 4
569 bytes. */
570PERLVARI(I, phase, enum perl_phase, PERL_PHASE_CONSTRUCT)
571
572PERLVARI(I, in_load_module, bool, FALSE) /* to prevent recursions in PerlIO_find_layer */
573
574/* This value may be set when embedding for full cleanup */
575/* 0=none, 1=full, 2=full with checks */
576/* mod_perl is special, and also assigns a meaning -1 */
577PERLVARI(I, perl_destruct_level, signed char, 0)
578
579#ifdef USE_LOCALE_NUMERIC
580
581PERLVARI(I, numeric_standard, int, TRUE)
582 /* Assume simple numerics */
583PERLVARI(I, numeric_local, bool, TRUE)
584 /* Assume local numerics */
585PERLVAR(I, numeric_name, char *) /* Name of current numeric locale */
586PERLVAR(I, numeric_radix_sv, SV *) /* The radix separator if not '.' */
587
588#endif /* !USE_LOCALE_NUMERIC */
589
590/* Unicode inversion lists */
591PERLVAR(I, Latin1, SV *)
592PERLVAR(I, UpperLatin1, SV *) /* Code points 128 - 255 */
593PERLVAR(I, AboveLatin1, SV *)
594PERLVAR(I, InBitmap, SV *)
595
596PERLVAR(I, NonL1NonFinalFold, SV *)
597PERLVAR(I, HasMultiCharFold, SV *)
598
599/* utf8 character class swashes */
600PERLVAR(I, utf8_mark, SV *)
601PERLVAR(I, utf8_X_regular_begin, SV *)
602PERLVAR(I, utf8_X_extend, SV *)
603PERLVAR(I, utf8_toupper, SV *)
604PERLVAR(I, utf8_totitle, SV *)
605PERLVAR(I, utf8_tolower, SV *)
606PERLVAR(I, utf8_tofold, SV *)
607PERLVAR(I, utf8_charname_begin, SV *)
608PERLVAR(I, utf8_charname_continue, SV *)
609
610PERLVARA(I, utf8_swash_ptrs, POSIX_SWASH_COUNT, SV *)
611PERLVARA(I, Posix_ptrs, POSIX_CC_COUNT, SV *)
612PERLVARA(I, XPosix_ptrs, POSIX_CC_COUNT, SV *)
613
614PERLVAR(I, last_swash_hv, HV *)
615PERLVAR(I, last_swash_tmps, U8 *)
616PERLVAR(I, last_swash_slen, STRLEN)
617PERLVARA(I, last_swash_key,UTF8_MAXBYTES-1, U8)
618PERLVAR(I, last_swash_klen, U8) /* Only needs to store 0-12 */
619
620#ifdef FCRYPT
621PERLVARI(I, cryptseen, bool, FALSE) /* has fast crypt() been initialized? */
622#else
623/* One byte hole in the interpreter structure. */
624#endif
625
626PERLVAR(I, pad_reset_pending, bool) /* reset pad on next attempted alloc */
627PERLVAR(I, srand_called, bool)
628
629/* Array of signal handlers, indexed by signal number, through which the C
630 signal handler dispatches. */
631PERLVAR(I, psig_ptr, SV **)
632/* Array of names of signals, indexed by signal number, for (re)use as the first
633 argument to a signal handler. Only one block of memory is allocated for
634 both psig_name and psig_ptr. */
635PERLVAR(I, psig_name, SV **)
636
637#if defined(PERL_IMPLICIT_SYS)
638PERLVAR(I, Mem, struct IPerlMem *)
639PERLVAR(I, MemShared, struct IPerlMem *)
640PERLVAR(I, MemParse, struct IPerlMem *)
641PERLVAR(I, Env, struct IPerlEnv *)
642PERLVAR(I, StdIO, struct IPerlStdIO *)
643PERLVAR(I, LIO, struct IPerlLIO *)
644PERLVAR(I, Dir, struct IPerlDir *)
645PERLVAR(I, Sock, struct IPerlSock *)
646PERLVAR(I, Proc, struct IPerlProc *)
647#endif
648
649PERLVAR(I, ptr_table, PTR_TBL_t *)
650PERLVARI(I, beginav_save, AV *, NULL) /* save BEGIN{}s when compiling */
651
652PERLVAR(I, body_arenas, void *) /* pointer to list of body-arenas */
653
654
655#if defined(USE_ITHREADS)
656PERLVAR(I, regex_pad, SV **) /* Shortcut into the array of
657 regex_padav */
658PERLVAR(I, regex_padav, AV *) /* All regex objects, indexed via the
659 values in op_pmoffset of pmop.
660 Entry 0 is an SV whose PV is a
661 "packed" list of IVs listing
662 the now-free slots in the array */
663PERLVAR(I, stashpad, HV **) /* for CopSTASH */
664PERLVARI(I, stashpadmax, PADOFFSET, 64)
665PERLVARI(I, stashpadix, PADOFFSET, 0)
666#endif
667
668#ifdef USE_REENTRANT_API
669PERLVAR(I, reentrant_buffer, REENTR *) /* here we store the _r buffers */
670#endif
671
672PERLVAR(I, custom_op_names, HV *) /* Names of user defined ops */
673PERLVAR(I, custom_op_descs, HV *) /* Descriptions of user defined ops */
674
675#ifdef PERLIO_LAYERS
676PERLVARI(I, perlio, PerlIOl *, NULL)
677PERLVARI(I, known_layers, PerlIO_list_t *, NULL)
678PERLVARI(I, def_layerlist, PerlIO_list_t *, NULL)
679#endif
680
681PERLVARI(I, encoding, SV *, NULL) /* $^ENCODING */
682PERLVARI(I, lex_encoding, SV *, NULL) /* encoding pragma */
683
684PERLVAR(I, utf8_idstart, SV *)
685PERLVAR(I, utf8_idcont, SV *)
686PERLVAR(I, utf8_xidstart, SV *)
687PERLVAR(I, utf8_perl_idstart, SV *)
688PERLVAR(I, utf8_perl_idcont, SV *)
689PERLVAR(I, utf8_xidcont, SV *)
690
691PERLVAR(I, sort_RealCmp, SVCOMPARE_t)
692
693PERLVARI(I, checkav_save, AV *, NULL) /* save CHECK{}s when compiling */
694PERLVARI(I, unitcheckav_save, AV *, NULL)
695 /* save UNITCHECK{}s when compiling */
696
697PERLVARI(I, clocktick, long, 0) /* this many times() ticks in a second */
698
699/* Hooks to shared SVs and locks. */
700PERLVARI(I, sharehook, share_proc_t, Perl_sv_nosharing)
701PERLVARI(I, lockhook, share_proc_t, Perl_sv_nosharing)
702#ifdef NO_MATHOMS
703# define PERL_UNLOCK_HOOK Perl_sv_nosharing
704#else
705/* This reference ensures that the mathoms are linked with perl */
706# define PERL_UNLOCK_HOOK Perl_sv_nounlocking
707#endif
708PERLVARI(I, unlockhook, share_proc_t, PERL_UNLOCK_HOOK)
709
710PERLVARI(I, threadhook, thrhook_proc_t, Perl_nothreadhook)
711
712/* Can shared object be destroyed */
713PERLVARI(I, destroyhook, destroyable_proc_t, Perl_sv_destroyable)
714
715#ifndef PERL_MICRO
716PERLVARI(I, signalhook, despatch_signals_proc_t, Perl_despatch_signals)
717#endif
718
719PERLVARI(I, isarev, HV *, NULL) /* Reverse map of @ISA dependencies */
720
721/* Register of known Method Resolution Orders.
722 What this actually points to is an implementation detail (it may change to
723 a structure incorporating a reference count - use mro_get_from_name to
724 retrieve a C<struct mro_alg *> */
725PERLVAR(I, registered_mros, HV *)
726
727/* Compile-time block start/end hooks */
728PERLVAR(I, blockhooks, AV *)
729
730/* Everything that folds to a given character, for case insensitivity regex
731 * matching */
732PERLVARI(I, utf8_foldclosures, HV *, NULL)
733
734/* List of characters that participate in folds (except marks, etc in
735 * multi-char folds) */
736PERLVARI(I, utf8_foldable, SV *, NULL)
737
738PERLVAR(I, custom_ops, HV *) /* custom op registrations */
739
740PERLVAR(I, Xpv, XPV *) /* (unused) held temporary value */
741
742/* name of the scopes we've ENTERed. Only used with -DDEBUGGING, but needs to be
743 present always, as -DDEBUGGING must be binary compatible with non. */
744PERLVARI(I, scopestack_name, const char * *, NULL)
745
746PERLVAR(I, debug_pad, struct perl_debug_pad) /* always needed because of the re extension */
747
748/* Hook for File::Glob */
749PERLVARI(I, globhook, globhook_t, NULL)
750
751PERLVARI(I, padlist_generation, U32, 1) /* id to identify padlist clones */
752
753/* The last unconditional member of the interpreter structure when 5.21.9 was
754 released. The offset of the end of this is baked into a global variable in
755 any shared perl library which will allow a sanity test in future perl
756 releases. */
757#define PERL_LAST_5_18_0_INTERP_MEMBER Iglobhook
758
759#ifdef PERL_IMPLICIT_CONTEXT
760PERLVARI(I, my_cxt_list, void **, NULL) /* per-module array of MY_CXT pointers */
761PERLVARI(I, my_cxt_size, int, 0) /* size of PL_my_cxt_list */
762# ifdef PERL_GLOBAL_STRUCT_PRIVATE
763PERLVARI(I, my_cxt_keys, const char **, NULL) /* per-module array of pointers to MY_CXT_KEY constants */
764# endif
765#endif
766
767#ifdef PERL_TRACK_MEMPOOL
768/* For use with the memory debugging code in util.c */
769PERLVAR(I, memory_debug_header, struct perl_memory_debug_header)
770#endif
771
772#ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
773/* File descriptor to talk to the child which dumps scalars. */
774PERLVARI(I, dumper_fd, int, -1)
775#endif
776
777
778#ifdef DEBUG_LEAKING_SCALARS
779PERLVARI(I, sv_serial, U32, 0) /* SV serial number, used in sv.c */
780#endif
781
782PERLVARA(I, sv_consts, SV_CONSTS_COUNT, SV*) /* constant SVs with precomputed hash value */
783
784#ifdef PERL_TRACE_OPS
785PERLVARA(I, op_exec_cnt, OP_max+2, UV) /* Counts of executed OPs of the given type.
786 If PERL_TRACE_OPS is enabled, we'll dump
787 a summary count of all ops executed in the
788 program at perl_destruct time. For
789 profiling/debugging only. Works only if
790 DEBUGGING is enabled, too. */
791#endif
792
793PERLVAR(I, random_state, PL_RANDOM_STATE_TYPE)
794
795/* If you are adding a U8 or U16, check to see if there are 'Space' comments
796 * above on where there are gaps which currently will be structure padding. */
797
798/* Within a stable branch, new variables must be added to the very end, before
799 * this comment, for binary compatibility (the offsets of the old members must
800 * not change).
801 * (Don't forget to add your variable also to perl_clone()!)
802 * XSUB.h provides wrapper functions via perlapi.h that make this
803 * irrelevant, but not all code may be expected to #include XSUB.h.
804 */