Commit | Line | Data |
---|---|---|
907b3e23 DM |
1 | /* intrpvar.h |
2 | * | |
3 | * Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, | |
1129b882 | 4 | * 2006, 2007, 2008 by Larry Wall and others |
907b3e23 DM |
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 | */ | |
49f531da | 14 | |
907b3e23 DM |
15 | /* These variables are per-interpreter in threaded/multiplicity builds, |
16 | * global otherwise. | |
17 | ||
d7cb65f2 | 18 | * Don't forget to re-run regen/embed.pl to propagate changes! */ |
cb68f92d | 19 | |
6537fe72 MS |
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 | ||
02506efe JH |
24 | /* Don't forget to add your variable also to perl_clone()! */ |
25 | ||
cb68f92d GS |
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 | |
97df044c KW |
28 | * to generate the appropriate export list for win32. If the variable |
29 | * needs to be initialized, use PERLVARI. | |
cb68f92d | 30 | * |
907b3e23 DM |
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 | ||
35 | PERLVAR(Istack_sp, SV **) /* top of the stack */ | |
36 | #ifdef OP_IN_REGISTER | |
37 | PERLVAR(Iopsave, OP *) | |
38 | #else | |
39 | PERLVAR(Iop, OP *) /* currently executing op */ | |
40 | #endif | |
41 | PERLVAR(Icurpad, SV **) /* active pad (lexicals+tmps) */ | |
42 | ||
43 | PERLVAR(Istack_base, SV **) | |
44 | PERLVAR(Istack_max, SV **) | |
45 | ||
46 | PERLVAR(Iscopestack, I32 *) /* scopes we've ENTERed */ | |
f2b88940 NC |
47 | /* name of the scopes we've ENTERed. Only used with -DDEBUGGING, but needs to be |
48 | present always, as -DDEUBGGING must be binary compatible with non. */ | |
49 | PERLVARI(Iscopestack_name, const char * *, NULL) | |
907b3e23 DM |
50 | PERLVAR(Iscopestack_ix, I32) |
51 | PERLVAR(Iscopestack_max,I32) | |
52 | ||
53 | PERLVAR(Isavestack, ANY *) /* items that need to be restored when | |
54 | LEAVEing scopes we've ENTERed */ | |
55 | PERLVAR(Isavestack_ix, I32) | |
56 | PERLVAR(Isavestack_max, I32) | |
57 | ||
58 | PERLVAR(Itmps_stack, SV **) /* mortals we've made */ | |
59 | PERLVARI(Itmps_ix, I32, -1) | |
60 | PERLVARI(Itmps_floor, I32, -1) | |
61 | PERLVAR(Itmps_max, I32) | |
3ad73efd | 62 | PERLVAR(Imodcount, I32) /* how much op_lvalue()ification in |
907b3e23 DM |
63 | assignment? */ |
64 | ||
65 | PERLVAR(Imarkstack, I32 *) /* stack_sp locations we're | |
66 | remembering */ | |
67 | PERLVAR(Imarkstack_ptr, I32 *) | |
68 | PERLVAR(Imarkstack_max, I32 *) | |
69 | ||
70 | PERLVAR(ISv, SV *) /* used to hold temporary values */ | |
71 | PERLVAR(IXpv, XPV *) /* used to hold temporary values */ | |
72 | ||
73 | /* | |
74 | =for apidoc Amn|STRLEN|PL_na | |
75 | ||
76 | A convenience variable which is typically used with C<SvPV> when one | |
77 | doesn't care about the length of the string. It is usually more efficient | |
78 | to either declare a local variable and use that instead or to use the | |
79 | C<SvPV_nolen> macro. | |
80 | ||
81 | =cut | |
82 | */ | |
83 | ||
84 | PERLVAR(Ina, STRLEN) /* for use in SvPV when length is | |
85 | Not Applicable */ | |
86 | ||
87 | /* stat stuff */ | |
88 | PERLVAR(Istatbuf, Stat_t) | |
89 | PERLVAR(Istatcache, Stat_t) /* _ */ | |
90 | PERLVAR(Istatgv, GV *) | |
91 | PERLVARI(Istatname, SV *, NULL) | |
92 | ||
93 | #ifdef HAS_TIMES | |
94 | PERLVAR(Itimesbuf, struct tms) | |
95 | #endif | |
96 | ||
97 | /* Fields used by magic variables such as $@, $/ and so on */ | |
98 | PERLVAR(Icurpm, PMOP *) /* what to do \ interps in REs from */ | |
99 | ||
100 | /* | |
101 | =for apidoc mn|SV*|PL_rs | |
102 | ||
103 | The input record separator - C<$/> in Perl space. | |
104 | ||
105 | =for apidoc mn|GV*|PL_last_in_gv | |
106 | ||
107 | The GV which was last used for a filehandle input operation. (C<< <FH> >>) | |
108 | ||
e23d9e2f | 109 | =for apidoc mn|GV*|PL_ofsgv |
907b3e23 | 110 | |
e23d9e2f | 111 | The glob containing the output field separator - C<*,> in Perl space. |
907b3e23 DM |
112 | |
113 | =cut | |
114 | */ | |
115 | ||
116 | PERLVAR(Irs, SV *) /* input record separator $/ */ | |
117 | PERLVAR(Ilast_in_gv, GV *) /* GV used in last <FH> */ | |
e23d9e2f | 118 | PERLVAR(Iofsgv, GV *) /* GV of output field separator *, */ |
907b3e23 DM |
119 | PERLVAR(Idefoutgv, GV *) /* default FH for output */ |
120 | PERLVARI(Ichopset, const char *, " \n-") /* $: */ | |
121 | PERLVAR(Iformtarget, SV *) | |
122 | PERLVAR(Ibodytarget, SV *) | |
123 | PERLVAR(Itoptarget, SV *) | |
124 | ||
125 | /* Stashes */ | |
126 | PERLVAR(Idefstash, HV *) /* main symbol table */ | |
127 | PERLVAR(Icurstash, HV *) /* symbol table for current package */ | |
128 | ||
129 | PERLVAR(Irestartop, OP *) /* propagating an error from croak? */ | |
febb3a6d | 130 | PERLVAR(Irestartjmpenv, JMPENV *) /* target frame for longjmp in die */ |
910e0671 | 131 | PERLVAR(Icurcop, COP *) |
907b3e23 DM |
132 | PERLVAR(Icurstack, AV *) /* THE STACK */ |
133 | PERLVAR(Icurstackinfo, PERL_SI *) /* current stack + context */ | |
134 | PERLVAR(Imainstack, AV *) /* the stack when nothing funny is | |
135 | happening */ | |
136 | ||
137 | PERLVAR(Itop_env, JMPENV *) /* ptr to current sigjmp environment */ | |
138 | PERLVAR(Istart_env, JMPENV) /* empty startup sigjmp environment */ | |
139 | PERLVARI(Ierrors, SV *, NULL) /* outstanding queued errors */ | |
140 | ||
141 | /* statics "owned" by various functions */ | |
907b3e23 DM |
142 | PERLVAR(Ihv_fetch_ent_mh, HE*) /* owned by hv_fetch_ent() */ |
143 | ||
907b3e23 DM |
144 | PERLVAR(Ilastgotoprobe, OP*) /* from pp_ctl.c */ |
145 | ||
146 | /* sort stuff */ | |
147 | PERLVAR(Isortcop, OP *) /* user defined sort routine */ | |
148 | PERLVAR(Isortstash, HV *) /* which is in some package or other */ | |
149 | PERLVAR(Ifirstgv, GV *) /* $a */ | |
150 | PERLVAR(Isecondgv, GV *) /* $b */ | |
151 | ||
152 | /* float buffer */ | |
153 | PERLVAR(Iefloatbuf, char *) | |
154 | PERLVAR(Iefloatsize, STRLEN) | |
155 | ||
156 | /* regex stuff */ | |
157 | ||
158 | PERLVAR(Iscreamfirst, I32 *) | |
159 | PERLVAR(Iscreamnext, I32 *) | |
160 | PERLVAR(Ilastscream, SV *) | |
161 | ||
162 | PERLVAR(Ireg_state, struct re_save_state) | |
163 | ||
164 | PERLVAR(Iregdummy, regnode) /* from regcomp.c */ | |
165 | ||
166 | PERLVARI(Idumpindent, U16, 4) /* number of blanks per dump | |
167 | indentation level */ | |
168 | ||
157b3822 NC |
169 | |
170 | PERLVAR(Iutf8locale, bool) /* utf8 locale detected */ | |
171 | PERLVARI(Irehash_seed_set, bool, FALSE) /* 582 hash initialized? */ | |
907b3e23 DM |
172 | |
173 | PERLVARA(Icolors,6, char *) /* from regcomp.c */ | |
174 | ||
9ea12537 Z |
175 | /* |
176 | =for apidoc Amn|peep_t|PL_peepp | |
177 | ||
178 | Pointer to the per-subroutine peephole optimiser. This is a function | |
179 | that gets called at the end of compilation of a Perl subroutine (or | |
180 | equivalently independent piece of Perl code) to perform fixups of | |
181 | some ops and to perform small-scale optimisations. The function is | |
182 | called once for each subroutine that is compiled, and is passed, as sole | |
183 | parameter, a pointer to the op that is the entry point to the subroutine. | |
184 | It modifies the op tree in place. | |
185 | ||
186 | The peephole optimiser should never be completely replaced. Rather, | |
187 | add code to it by wrapping the existing optimiser. The basic way to do | |
188 | this can be seen in L<perlguts/Compile pass 3: peephole optimization>. | |
189 | If the new code wishes to operate on ops throughout the subroutine's | |
190 | structure, rather than just at the top level, it is likely to be more | |
191 | convenient to wrap the L</PL_rpeepp> hook. | |
192 | ||
193 | =cut | |
194 | */ | |
195 | ||
ef69c8fc | 196 | PERLVARI(Ipeepp, peep_t, Perl_peep) |
9ea12537 Z |
197 | |
198 | /* | |
199 | =for apidoc Amn|peep_t|PL_rpeepp | |
200 | ||
201 | Pointer to the recursive peephole optimiser. This is a function | |
202 | that gets called at the end of compilation of a Perl subroutine (or | |
203 | equivalently independent piece of Perl code) to perform fixups of some | |
204 | ops and to perform small-scale optimisations. The function is called | |
205 | once for each chain of ops linked through their C<op_next> fields; | |
206 | it is recursively called to handle each side chain. It is passed, as | |
207 | sole parameter, a pointer to the op that is at the head of the chain. | |
208 | It modifies the op tree in place. | |
209 | ||
210 | The peephole optimiser should never be completely replaced. Rather, | |
211 | add code to it by wrapping the existing optimiser. The basic way to do | |
212 | this can be seen in L<perlguts/Compile pass 3: peephole optimization>. | |
213 | If the new code wishes to operate only on ops at a subroutine's top level, | |
214 | rather than throughout the structure, it is likely to be more convenient | |
215 | to wrap the L</PL_peepp> hook. | |
216 | ||
217 | =cut | |
218 | */ | |
219 | ||
ef69c8fc | 220 | PERLVARI(Irpeepp, peep_t, Perl_rpeep) |
907b3e23 | 221 | |
2f175318 VP |
222 | /* |
223 | =for apidoc Amn|Perl_ophook_t|PL_opfreehook | |
224 | ||
225 | When 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. | |
226 | This allows extensions to free any extra attribute they have locally attached to an OP. | |
227 | It is also assured to first fire for the parent OP and then for its kids. | |
228 | ||
229 | When 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. | |
230 | ||
231 | =cut | |
232 | */ | |
233 | ||
799dfa8f | 234 | PERLVARI(Iopfreehook, Perl_ophook_t, 0) /* op_free() hook */ |
f37b8c3f | 235 | |
907b3e23 DM |
236 | PERLVARI(Imaxscream, I32, -1) |
237 | PERLVARI(Ireginterp_cnt,I32, 0) /* Whether "Regexp" was interpolated. */ | |
238 | PERLVARI(Iwatchaddr, char **, 0) | |
239 | PERLVAR(Iwatchok, char *) | |
240 | ||
241 | /* the currently active slab in a chain of slabs of regmatch states, | |
242 | * and the currently active state within that slab */ | |
243 | ||
244 | PERLVARI(Iregmatch_slab, regmatch_slab *, NULL) | |
245 | PERLVAR(Iregmatch_state, regmatch_state *) | |
246 | ||
907b3e23 | 247 | /* Put anything new that is pointer aligned here. */ |
d95e864f | 248 | |
907b3e23 DM |
249 | PERLVAR(Idelaymagic, U16) /* ($<,$>) = ... */ |
250 | PERLVAR(Ilocalizing, U8) /* are we processing a local() list? */ | |
251 | PERLVAR(Icolorset, bool) /* from regcomp.c */ | |
910e0671 | 252 | PERLVAR(Iin_eval, U8) /* trap "fatal" errors? */ |
907b3e23 | 253 | PERLVAR(Itainted, bool) /* using variables controlled by $< */ |
d95e864f | 254 | |
9ebf26ad FR |
255 | /* current phase the interpreter is in */ |
256 | PERLVARI(Iphase, enum perl_phase, PERL_PHASE_CONSTRUCT) | |
257 | ||
d95e864f NC |
258 | /* This value may be set when embedding for full cleanup */ |
259 | /* 0=none, 1=full, 2=full with checks */ | |
801627e8 NC |
260 | /* mod_perl is special, and also assigns a meaning -1 */ |
261 | PERLVARI(Iperl_destruct_level, signed char, 0) | |
d95e864f NC |
262 | |
263 | PERLVAR(Iperldb, U32) | |
264 | ||
49f531da | 265 | /* pseudo environmental stuff */ |
d95e864f | 266 | PERLVAR(Iorigargc, int) |
cb68f92d GS |
267 | PERLVAR(Iorigargv, char **) |
268 | PERLVAR(Ienvgv, GV *) | |
cb68f92d | 269 | PERLVAR(Iincgv, GV *) |
b3ac6de7 | 270 | PERLVAR(Ihintgv, GV *) |
cb68f92d GS |
271 | PERLVAR(Iorigfilename, char *) |
272 | PERLVAR(Idiehook, SV *) | |
273 | PERLVAR(Iwarnhook, SV *) | |
1d7c1841 GS |
274 | |
275 | /* switches */ | |
a7cb1f99 | 276 | PERLVAR(Ipatchlevel, SV *) |
1e8125c6 | 277 | PERLVAR(Iapiversion, SV *) |
27da23d5 | 278 | PERLVAR(Ilocalpatches, const char * const *) |
dd374669 | 279 | PERLVARI(Isplitstr, const char *, " ") |
9f7da6d5 NC |
280 | |
281 | PERLVAR(Iminus_c, bool) | |
cb68f92d GS |
282 | PERLVAR(Iminus_n, bool) |
283 | PERLVAR(Iminus_p, bool) | |
284 | PERLVAR(Iminus_l, bool) | |
285 | PERLVAR(Iminus_a, bool) | |
286 | PERLVAR(Iminus_F, bool) | |
287 | PERLVAR(Idoswitches, bool) | |
bc9b29db | 288 | PERLVAR(Iminus_E, bool) |
954c1994 GS |
289 | |
290 | /* | |
ccfc67b7 | 291 | |
2eb25c99 | 292 | =for apidoc mn|bool|PL_dowarn |
954c1994 GS |
293 | |
294 | The C variable which corresponds to Perl's $^W warning variable. | |
295 | ||
296 | =cut | |
297 | */ | |
298 | ||
d41ff1b8 | 299 | PERLVAR(Idowarn, U8) |
07455d8f | 300 | /* Space for a U8 */ |
49f531da | 301 | PERLVAR(Isawampersand, bool) /* must save all match strings */ |
cb68f92d | 302 | PERLVAR(Iunsafe, bool) |
9f7da6d5 NC |
303 | PERLVAR(Iexit_flags, U8) /* was exit() unexpected, etc. */ |
304 | PERLVAR(Isrand_called, bool) | |
305 | /* Part of internal state, but makes the 16th 1 byte variable in a row. */ | |
306 | PERLVAR(Itainting, bool) /* doing taint checks */ | |
4fa7c2bf | 307 | PERLVARI(Iin_load_module, bool, FALSE) /* to prevent recursions in PerlIO_find_layer */ |
cb68f92d GS |
308 | PERLVAR(Iinplace, char *) |
309 | PERLVAR(Ie_script, SV *) | |
49f531da NIS |
310 | |
311 | /* magical thingies */ | |
312 | PERLVAR(Ibasetime, Time_t) /* $^T */ | |
313 | PERLVAR(Iformfeed, SV *) /* $^L */ | |
d4cce5f1 NIS |
314 | |
315 | ||
cb68f92d GS |
316 | PERLVARI(Imaxsysfd, I32, MAXSYSFD) |
317 | /* top fd to pass to subprocesses */ | |
49f531da NIS |
318 | PERLVAR(Istatusvalue, I32) /* $? */ |
319 | #ifdef VMS | |
cb68f92d | 320 | PERLVAR(Istatusvalue_vms,U32) |
e5218da5 GA |
321 | #else |
322 | PERLVAR(Istatusvalue_posix,I32) | |
49f531da NIS |
323 | #endif |
324 | ||
157b3822 NC |
325 | PERLVARI(Isig_pending, int,0) /* Number if highest signal pending */ |
326 | PERLVAR(Ipsig_pend, int *) /* per-signal "count" of pending */ | |
327 | ||
49f531da | 328 | /* shortcuts to various I/O objects */ |
16d811d4 DM |
329 | PERLVAR(Istdingv, GV *) /* *STDIN */ |
330 | PERLVAR(Istderrgv, GV *) /* *STDERR */ | |
cb68f92d | 331 | PERLVAR(Idefgv, GV *) |
16d811d4 DM |
332 | PERLVAR(Iargvgv, GV *) /* *ARGV */ |
333 | PERLVAR(Iargvoutgv, GV *) /* *ARGVOUT */ | |
1d7c1841 | 334 | PERLVAR(Iargvout_stack, AV *) |
49f531da NIS |
335 | |
336 | /* shortcuts to regexp stuff */ | |
16d811d4 | 337 | PERLVAR(Ireplgv, GV *) /* *^R */ |
49f531da NIS |
338 | |
339 | /* shortcuts to misc objects */ | |
16d811d4 | 340 | PERLVAR(Ierrgv, GV *) /* *@ */ |
49f531da NIS |
341 | |
342 | /* shortcuts to debugging objects */ | |
16d811d4 DM |
343 | PERLVAR(IDBgv, GV *) /* *DB::DB */ |
344 | PERLVAR(IDBline, GV *) /* *DB::line */ | |
954c1994 GS |
345 | |
346 | /* | |
2eb25c99 | 347 | =for apidoc mn|GV *|PL_DBsub |
954c1994 GS |
348 | When Perl is run in debugging mode, with the B<-d> switch, this GV contains |
349 | the SV which holds the name of the sub being debugged. This is the C | |
350 | variable which corresponds to Perl's $DB::sub variable. See | |
351 | C<PL_DBsingle>. | |
352 | ||
2eb25c99 | 353 | =for apidoc mn|SV *|PL_DBsingle |
954c1994 | 354 | When Perl is run in debugging mode, with the B<-d> switch, this SV is a |
7889fe52 | 355 | boolean which indicates whether subs are being single-stepped. |
954c1994 GS |
356 | Single-stepping is automatically turned on after every step. This is the C |
357 | variable which corresponds to Perl's $DB::single variable. See | |
358 | C<PL_DBsub>. | |
359 | ||
2eb25c99 | 360 | =for apidoc mn|SV *|PL_DBtrace |
954c1994 GS |
361 | Trace variable used when Perl is run in debugging mode, with the B<-d> |
362 | switch. This is the C variable which corresponds to Perl's $DB::trace | |
363 | variable. See C<PL_DBsingle>. | |
364 | ||
365 | =cut | |
366 | */ | |
367 | ||
16d811d4 DM |
368 | PERLVAR(IDBsub, GV *) /* *DB::sub */ |
369 | PERLVAR(IDBsingle, SV *) /* $DB::single */ | |
370 | PERLVAR(IDBtrace, SV *) /* $DB::trace */ | |
371 | PERLVAR(IDBsignal, SV *) /* $DB::signal */ | |
49f531da NIS |
372 | PERLVAR(Idbargs, AV *) /* args to call listed by caller function */ |
373 | ||
374 | /* symbol tables */ | |
49f531da NIS |
375 | PERLVAR(Idebstash, HV *) /* symbol table for perldb package */ |
376 | PERLVAR(Iglobalstash, HV *) /* global keyword overrides imported here */ | |
377 | PERLVAR(Icurstname, SV *) /* name of current package */ | |
378 | PERLVAR(Ibeginav, AV *) /* names of BEGIN subroutines */ | |
d4cce5f1 | 379 | PERLVAR(Iendav, AV *) /* names of END subroutines */ |
3c10abe3 | 380 | PERLVAR(Iunitcheckav, AV *) /* names of UNITCHECK subroutines */ |
7d30b5c4 | 381 | PERLVAR(Icheckav, AV *) /* names of CHECK subroutines */ |
49f531da NIS |
382 | PERLVAR(Iinitav, AV *) /* names of INIT subroutines */ |
383 | PERLVAR(Istrtab, HV *) /* shared string table */ | |
005a453c | 384 | PERLVARI(Isub_generation,U32,1) /* incr to invalidate method cache */ |
49f531da | 385 | |
9f7da6d5 NC |
386 | /* funky return mechanisms */ |
387 | PERLVAR(Iforkprocess, int) /* so do_open |- can return proc# */ | |
388 | ||
49f531da | 389 | /* memory management */ |
49f531da NIS |
390 | PERLVAR(Isv_count, I32) /* how many SV* are currently allocated */ |
391 | PERLVAR(Isv_objcount, I32) /* how many objects are currently allocated */ | |
392 | PERLVAR(Isv_root, SV*) /* storage for SVs belonging to interp */ | |
393 | PERLVAR(Isv_arenaroot, SV*) /* list of areas for garbage collection */ | |
394 | ||
49f531da | 395 | /* subprocess state */ |
d4cce5f1 | 396 | PERLVAR(Ifdpid, AV *) /* keep fd-to-pid mappings for my_popen */ |
49f531da NIS |
397 | |
398 | /* internal state */ | |
49f531da NIS |
399 | PERLVARI(Iop_mask, char *, NULL) /* masked operations for safe evals */ |
400 | ||
49f531da | 401 | /* current interpreter roots */ |
cb68f92d GS |
402 | PERLVAR(Imain_cv, CV *) |
403 | PERLVAR(Imain_root, OP *) | |
404 | PERLVAR(Imain_start, OP *) | |
405 | PERLVAR(Ieval_root, OP *) | |
406 | PERLVAR(Ieval_start, OP *) | |
49f531da NIS |
407 | |
408 | /* runtime control stuff */ | |
cb68f92d | 409 | PERLVARI(Icurcopdb, COP *, NULL) |
49f531da | 410 | |
49f531da NIS |
411 | PERLVAR(Ifilemode, int) /* so nextargv() can preserve mode */ |
412 | PERLVAR(Ilastfd, int) /* what to preserve mode on */ | |
413 | PERLVAR(Ioldname, char *) /* what to preserve mode on */ | |
360ea906 | 414 | PERLVAR(IArgv, const char **) /* stuff to free from do_aexec, vfork safe */ |
d4cce5f1 | 415 | PERLVAR(ICmd, char *) /* stuff to free from do_aexec, vfork safe */ |
00accf8d NC |
416 | /* Elements in this array have ';' appended and are injected as a single line |
417 | into the tokeniser. You can't put any (literal) newlines into any program | |
418 | you stuff in into this array, as the point where it's injected is expecting | |
419 | a single physical line. */ | |
cb68f92d | 420 | PERLVAR(Ipreambleav, AV *) |
cb68f92d | 421 | PERLVAR(Imess_sv, SV *) |
7889fe52 | 422 | PERLVAR(Iors_sv, SV *) /* output record separator $\ */ |
71eebe1e NC |
423 | /* statics moved here for shared library purposes */ |
424 | PERLVARI(Igensym, I32, 0) /* next symbol for getsym() to define */ | |
a4021b77 | 425 | PERLVARI(Icv_has_eval, bool, FALSE) /* PL_compcv includes an entereval or similar */ |
157b3822 | 426 | PERLVAR(Itaint_warn, bool) /* taint warns instead of dying */ |
d95e864f NC |
427 | PERLVARI(Ilaststype, U16, OP_STAT) |
428 | PERLVARI(Ilaststatval, int, -1) | |
d4cce5f1 | 429 | |
4b556e6c | 430 | /* interpreter atexit processing */ |
d95e864f | 431 | PERLVARI(Iexitlistlen, I32, 0) /* length of same */ |
cb68f92d GS |
432 | PERLVARI(Iexitlist, PerlExitListEntry *, NULL) |
433 | /* list of exit functions */ | |
954c1994 GS |
434 | |
435 | /* | |
436 | =for apidoc Amn|HV*|PL_modglobal | |
437 | ||
7889fe52 | 438 | C<PL_modglobal> is a general purpose, interpreter global HV for use by |
954c1994 | 439 | extensions that need to keep information on a per-interpreter basis. |
7889fe52 NIS |
440 | In a pinch, it can also be used as a symbol table for extensions |
441 | to share data among each other. It is a good idea to use keys | |
954c1994 GS |
442 | prefixed by the package name of the extension that owns the data. |
443 | ||
444 | =cut | |
445 | */ | |
446 | ||
cb68f92d GS |
447 | PERLVAR(Imodglobal, HV *) /* per-interp module data */ |
448 | ||
449 | /* these used to be in global before 5.004_68 */ | |
450 | PERLVARI(Iprofiledata, U32 *, NULL) /* table of ops, counts */ | |
cb68f92d GS |
451 | |
452 | PERLVAR(Icompiling, COP) /* compiling/done executing marker */ | |
453 | ||
454 | PERLVAR(Icompcv, CV *) /* currently compiling subroutine */ | |
455 | PERLVAR(Icomppad, AV *) /* storage for lexically scoped temporaries */ | |
456 | PERLVAR(Icomppad_name, AV *) /* variable names for "my" variables */ | |
457 | PERLVAR(Icomppad_name_fill, I32) /* last "introduced" variable offset */ | |
458 | PERLVAR(Icomppad_name_floor, I32) /* start of vars in innermost block */ | |
4b556e6c JD |
459 | |
460 | #ifdef HAVE_INTERP_INTERN | |
cb68f92d GS |
461 | PERLVAR(Isys_intern, struct interp_intern) |
462 | /* platform internals */ | |
4b556e6c JD |
463 | #endif |
464 | ||
7fae4e64 | 465 | /* more statics moved here */ |
7fae4e64 | 466 | PERLVAR(IDBcv, CV *) /* from perl.c */ |
9f7da6d5 | 467 | PERLVARI(Igeneration, int, 100) /* from op.c */ |
56953603 | 468 | |
cb68f92d | 469 | PERLVARI(Iin_clean_objs,bool, FALSE) /* from sv.c */ |
57ef47cc | 470 | PERLVARI(Iin_clean_all, bool, FALSE) /* ptrs to freed SVs now legal */ |
9f7da6d5 NC |
471 | PERLVAR(Inomemok, bool) /* let malloc context handle nomem */ |
472 | PERLVARI(Isavebegin, bool, FALSE) /* save BEGINs for compiler */ | |
7fae4e64 | 473 | |
d8eceb89 JH |
474 | PERLVAR(Iuid, Uid_t) /* current real user id */ |
475 | PERLVAR(Ieuid, Uid_t) /* current effective user id */ | |
476 | PERLVAR(Igid, Gid_t) /* current real group id */ | |
477 | PERLVAR(Iegid, Gid_t) /* current effective group id */ | |
bf9cdc68 | 478 | PERLVARI(Ian, U32, 0) /* malloc sequence number */ |
be2b6a89 DM |
479 | |
480 | #ifdef DEBUGGING | |
481 | /* exercise wrap-around */ | |
482 | #define PERL_COP_SEQMAX (U32_MAX-50) | |
483 | #else | |
484 | #define PERL_COP_SEQMAX 0 | |
485 | #endif | |
486 | PERLVARI(Icop_seqmax, U32, PERL_COP_SEQMAX) /* statement sequence number */ | |
487 | #undef PERL_COP_SEQMAX | |
488 | ||
bf9cdc68 | 489 | PERLVARI(Ievalseq, U32, 0) /* eval sequence number */ |
0672f40e | 490 | PERLVAR(Iorigalen, U32) |
9f7da6d5 | 491 | PERLVAR(Iorigenviron, char **) |
ca0c25f6 | 492 | #ifdef PERL_USES_PL_PIDSTATUS |
0672f40e | 493 | PERLVAR(Ipidstatus, HV *) /* pid-to-status mappings for waitpid */ |
ca0c25f6 | 494 | #endif |
0672f40e | 495 | PERLVAR(Iosname, char *) /* operating system */ |
5c728af0 | 496 | |
0672f40e GS |
497 | PERLVAR(Isighandlerp, Sighandler_t) |
498 | ||
232d1c15 | 499 | PERLVARA(Ibody_roots, PERL_ARENA_ROOTS_SIZE, void*) /* array of body roots */ |
93e68bfb | 500 | |
ed29bbba | 501 | PERLVAR(Iunicode, U32) /* Unicode features: $ENV{PERL_UNICODE} or -C */ |
0672f40e | 502 | |
9f7da6d5 NC |
503 | PERLVARI(Imaxo, int, MAXO) /* maximum number of ops */ |
504 | ||
ef69c8fc | 505 | PERLVARI(Irunops, runops_proc_t, RUNOPS_DEFAULT) |
0672f40e | 506 | |
954c1994 GS |
507 | /* |
508 | =for apidoc Amn|SV|PL_sv_undef | |
509 | This is the C<undef> SV. Always refer to this as C<&PL_sv_undef>. | |
510 | ||
511 | =for apidoc Amn|SV|PL_sv_no | |
512 | This is the C<false> SV. See C<PL_sv_yes>. Always refer to this as | |
513 | C<&PL_sv_no>. | |
514 | ||
515 | =for apidoc Amn|SV|PL_sv_yes | |
516 | This is the C<true> SV. See C<PL_sv_no>. Always refer to this as | |
517 | C<&PL_sv_yes>. | |
518 | ||
519 | =cut | |
520 | */ | |
521 | ||
0672f40e GS |
522 | PERLVAR(Isv_undef, SV) |
523 | PERLVAR(Isv_no, SV) | |
524 | PERLVAR(Isv_yes, SV) | |
525 | ||
0672f40e GS |
526 | PERLVAR(Isubname, SV *) /* name of current subroutine */ |
527 | ||
d95e864f | 528 | PERLVAR(Isubline, I32) /* line this subroutine began on */ |
0672f40e | 529 | PERLVAR(Imin_intro_pending, I32) /* start of vars to introduce */ |
d95e864f | 530 | |
0672f40e GS |
531 | PERLVAR(Imax_intro_pending, I32) /* end of vars to introduce */ |
532 | PERLVAR(Ipadix, I32) /* max used index in current "register" pad */ | |
d95e864f | 533 | |
0672f40e | 534 | PERLVAR(Ipadix_floor, I32) /* how low may inner block reset padix */ |
0672f40e | 535 | |
1d7c1841 | 536 | PERLVAR(Ihints, U32) /* pragma-tic compile-time flags */ |
0672f40e GS |
537 | |
538 | PERLVAR(Idebug, VOL U32) /* flags given to -D switch */ | |
539 | ||
f0cb02e3 NC |
540 | /* Perl_Ibreakable_sub_generation_ptr was too long for VMS, hence "gen" */ |
541 | PERLVARI(Ibreakable_sub_gen, U32, 0) | |
542 | ||
bf9cdc68 | 543 | PERLVARI(Iamagic_generation, long, 0) |
0672f40e GS |
544 | |
545 | #ifdef USE_LOCALE_COLLATE | |
0672f40e | 546 | PERLVAR(Icollation_name,char *) /* Name of current collation */ |
0672f40e GS |
547 | PERLVAR(Icollxfrm_base, Size_t) /* Basic overhead in *xfrm() */ |
548 | PERLVARI(Icollxfrm_mult,Size_t, 2) /* Expansion factor in *xfrm() */ | |
9f7da6d5 NC |
549 | PERLVARI(Icollation_ix, U32, 0) /* Collation generation index */ |
550 | PERLVARI(Icollation_standard, bool, TRUE) | |
551 | /* Assume simple collation */ | |
0672f40e GS |
552 | #endif /* USE_LOCALE_COLLATE */ |
553 | ||
9f7da6d5 | 554 | |
edd11d75 | 555 | #if defined (PERL_UTF8_CACHE_ASSERT) || defined (DEBUGGING) |
95ca8690 | 556 | # define PERL___I -1 |
9f7da6d5 | 557 | #else |
7cd91da4 | 558 | # define PERL___I 1 |
9f7da6d5 | 559 | #endif |
95ca8690 DM |
560 | PERLVARI(Iutf8cache, I8, PERL___I) /* Is the utf8 caching code enabled? */ |
561 | #undef PERL___I | |
562 | ||
9f7da6d5 | 563 | |
0672f40e GS |
564 | #ifdef USE_LOCALE_NUMERIC |
565 | ||
0672f40e GS |
566 | PERLVARI(Inumeric_standard, bool, TRUE) |
567 | /* Assume simple numerics */ | |
568 | PERLVARI(Inumeric_local, bool, TRUE) | |
569 | /* Assume local numerics */ | |
9f7da6d5 | 570 | PERLVAR(Inumeric_name, char *) /* Name of current numeric locale */ |
0672f40e GS |
571 | #endif /* !USE_LOCALE_NUMERIC */ |
572 | ||
573 | /* utf8 character classes */ | |
574 | PERLVAR(Iutf8_alnum, SV *) | |
b8c5462f | 575 | PERLVAR(Iutf8_ascii, SV *) |
0672f40e GS |
576 | PERLVAR(Iutf8_alpha, SV *) |
577 | PERLVAR(Iutf8_space, SV *) | |
d1eb3177 YO |
578 | PERLVAR(Iutf8_perl_space, SV *) |
579 | PERLVAR(Iutf8_perl_word, SV *) | |
580 | PERLVAR(Iutf8_posix_digit, SV *) | |
b8c5462f JH |
581 | PERLVAR(Iutf8_cntrl, SV *) |
582 | PERLVAR(Iutf8_graph, SV *) | |
0672f40e GS |
583 | PERLVAR(Iutf8_digit, SV *) |
584 | PERLVAR(Iutf8_upper, SV *) | |
585 | PERLVAR(Iutf8_lower, SV *) | |
586 | PERLVAR(Iutf8_print, SV *) | |
b8c5462f JH |
587 | PERLVAR(Iutf8_punct, SV *) |
588 | PERLVAR(Iutf8_xdigit, SV *) | |
0672f40e | 589 | PERLVAR(Iutf8_mark, SV *) |
37e2e78e KW |
590 | PERLVAR(Iutf8_X_begin, SV *) |
591 | PERLVAR(Iutf8_X_extend, SV *) | |
592 | PERLVAR(Iutf8_X_prepend, SV *) | |
593 | PERLVAR(Iutf8_X_non_hangul, SV *) | |
594 | PERLVAR(Iutf8_X_L, SV *) | |
595 | PERLVAR(Iutf8_X_LV, SV *) | |
596 | PERLVAR(Iutf8_X_LVT, SV *) | |
597 | PERLVAR(Iutf8_X_T, SV *) | |
598 | PERLVAR(Iutf8_X_V, SV *) | |
599 | PERLVAR(Iutf8_X_LV_LVT_V, SV *) | |
0672f40e GS |
600 | PERLVAR(Iutf8_toupper, SV *) |
601 | PERLVAR(Iutf8_totitle, SV *) | |
602 | PERLVAR(Iutf8_tolower, SV *) | |
b4e400f9 | 603 | PERLVAR(Iutf8_tofold, SV *) |
0672f40e | 604 | PERLVAR(Ilast_swash_hv, HV *) |
0672f40e GS |
605 | PERLVAR(Ilast_swash_tmps, U8 *) |
606 | PERLVAR(Ilast_swash_slen, STRLEN) | |
9f7da6d5 | 607 | PERLVARA(Ilast_swash_key,10, U8) |
d95e864f NC |
608 | PERLVAR(Ilast_swash_klen, U8) /* Only needs to store 0-10 */ |
609 | ||
610 | #ifdef FCRYPT | |
611 | PERLVARI(Icryptseen, bool, FALSE) /* has fast crypt() been initialized? */ | |
612 | #endif | |
613 | ||
f0cb02e3 | 614 | PERLVAR(Ipad_reset_pending, bool) /* reset pad on next attempted alloc */ |
49947b44 | 615 | |
d95e864f NC |
616 | PERLVARI(Iglob_index, int, 0) |
617 | ||
0672f40e | 618 | |
5912531f | 619 | PERLVAR(Iparser, yy_parser *) /* current parser state */ |
12fbd33b | 620 | |
c4a30c8c NC |
621 | /* Array of signal handlers, indexed by signal number, through which the C |
622 | signal handler dispatches. */ | |
1d7c1841 | 623 | PERLVAR(Ipsig_ptr, SV**) |
c4a30c8c | 624 | /* Array of names of signals, indexed by signal number, for (re)use as the first |
d525a7b2 NC |
625 | argument to a signal handler. Only one block of memory is allocated for |
626 | both psig_name and psig_ptr. */ | |
c4a30c8c | 627 | PERLVAR(Ipsig_name, SV**) |
1d7c1841 | 628 | |
c5be433b | 629 | #if defined(PERL_IMPLICIT_SYS) |
32e30700 | 630 | PERLVAR(IMem, struct IPerlMem*) |
1d7c1841 GS |
631 | PERLVAR(IMemShared, struct IPerlMem*) |
632 | PERLVAR(IMemParse, struct IPerlMem*) | |
32e30700 GS |
633 | PERLVAR(IEnv, struct IPerlEnv*) |
634 | PERLVAR(IStdIO, struct IPerlStdIO*) | |
635 | PERLVAR(ILIO, struct IPerlLIO*) | |
636 | PERLVAR(IDir, struct IPerlDir*) | |
637 | PERLVAR(ISock, struct IPerlSock*) | |
638 | PERLVAR(IProc, struct IPerlProc*) | |
76e3520e | 639 | #endif |
1d7c1841 | 640 | |
1d7c1841 | 641 | PERLVAR(Iptr_table, PTR_TBL_t*) |
7d49f689 | 642 | PERLVARI(Ibeginav_save, AV*, NULL) /* save BEGIN{}s when compiling */ |
f180df80 | 643 | |
fdda85ca | 644 | PERLVAR(Ibody_arenas, void*) /* pointer to list of body-arenas */ |
93e68bfb | 645 | |
d95e864f | 646 | |
a453c169 JH |
647 | #ifdef USE_LOCALE_NUMERIC |
648 | ||
649 | PERLVAR(Inumeric_radix_sv, SV *) /* The radix separator if not '.' */ | |
650 | ||
651 | #endif | |
ce08f86c | 652 | |
1fcf4c12 | 653 | #if defined(USE_ITHREADS) |
e6853197 NC |
654 | PERLVAR(Iregex_pad, SV**) /* Shortcut into the array of |
655 | regex_padav */ | |
656 | PERLVAR(Iregex_padav, AV*) /* All regex objects, indexed via the | |
657 | values in op_pmoffset of pmop. | |
402d2eb1 NC |
658 | Entry 0 is an SV whose PV is a |
659 | "packed" list of IVs listing | |
e6853197 | 660 | the now-free slots in the array */ |
1fcf4c12 AB |
661 | #endif |
662 | ||
ea68fd67 NC |
663 | #ifdef USE_REENTRANT_API |
664 | PERLVAR(Ireentrant_buffer, REENTR*) /* here we store the _r buffers */ | |
f5a82810 JH |
665 | #endif |
666 | ||
53e06cf0 SC |
667 | PERLVAR(Icustom_op_names, HV*) /* Names of user defined ops */ |
668 | PERLVAR(Icustom_op_descs, HV*) /* Descriptions of user defined ops */ | |
19e8ce8e | 669 | |
a1ea730d | 670 | #ifdef PERLIO_LAYERS |
303f2dc3 | 671 | PERLVARI(Iperlio, PerlIOl *,NULL) |
3a1ee7e8 NIS |
672 | PERLVARI(Iknown_layers, PerlIO_list_t *,NULL) |
673 | PERLVARI(Idef_layerlist, PerlIO_list_t *,NULL) | |
a1ea730d NIS |
674 | #endif |
675 | ||
a0714e2c | 676 | PERLVARI(Iencoding, SV*, NULL) /* character encoding */ |
0a378802 | 677 | |
128e8167 | 678 | PERLVAR(Idebug_pad, struct perl_debug_pad) /* always needed because of the re extension */ |
ce333219 | 679 | |
82686b01 JH |
680 | PERLVAR(Iutf8_idstart, SV *) |
681 | PERLVAR(Iutf8_idcont, SV *) | |
c11ff943 KW |
682 | PERLVAR(Iutf8_xidstart, SV *) |
683 | PERLVAR(Iutf8_xidcont, SV *) | |
82686b01 | 684 | |
147f47de AB |
685 | PERLVAR(Isort_RealCmp, SVCOMPARE_t) |
686 | ||
7d49f689 | 687 | PERLVARI(Icheckav_save, AV*, NULL) /* save CHECK{}s when compiling */ |
3c10abe3 | 688 | PERLVARI(Iunitcheckav_save, AV*, NULL) /* save UNITCHECK{}s when compiling */ |
ece599bd | 689 | |
5311654c JH |
690 | PERLVARI(Iclocktick, long, 0) /* this many times() ticks in a second */ |
691 | ||
4ffa73a3 JH |
692 | PERLVAR(Isignals, U32) /* Using which pre-5.8 signals */ |
693 | ||
57c6e6d2 JH |
694 | PERLVAR(Ireentrant_retint, int) /* Integer return value from reentrant functions */ |
695 | ||
9f7da6d5 NC |
696 | PERLVAR(Istashcache, HV *) /* Cache to speed up S_method_common */ |
697 | ||
15a5279a | 698 | /* Hooks to shared SVs and locks. */ |
ef69c8fc BM |
699 | PERLVARI(Isharehook, share_proc_t, Perl_sv_nosharing) |
700 | PERLVARI(Ilockhook, share_proc_t, Perl_sv_nosharing) | |
d0647d4e NC |
701 | #ifdef NO_MATHOMS |
702 | # define PERL_UNLOCK_HOOK Perl_sv_nosharing | |
703 | #else | |
704 | /* This reference ensures that the mathoms are linked with perl */ | |
705 | # define PERL_UNLOCK_HOOK Perl_sv_nounlocking | |
706 | #endif | |
ef69c8fc | 707 | PERLVARI(Iunlockhook, share_proc_t, PERL_UNLOCK_HOOK) |
d0647d4e | 708 | |
ef69c8fc | 709 | PERLVARI(Ithreadhook, thrhook_proc_t, Perl_nothreadhook) |
15a5279a | 710 | |
ef69c8fc | 711 | PERLVARI(Isignalhook, despatch_signals_proc_t, Perl_despatch_signals) |
92f022bb | 712 | |
504f80c1 JH |
713 | PERLVARI(Ihash_seed, UV, 0) /* Hash initializer */ |
714 | ||
008fb0c0 | 715 | PERLVARI(Irehash_seed, UV, 0) /* 582 hash initializer */ |
4b5190b5 | 716 | |
ba6d381e | 717 | PERLVARI(Iisarev, HV*, NULL) /* Reverse map of @ISA dependencies */ |
f16dd614 | 718 | |
ffee3ff6 NC |
719 | /* The last unconditional member of the interpreter structure when 5.10.0 was |
720 | released. The offset of the end of this is baked into a global variable in | |
721 | any shared perl library which will allow a sanity test in future perl | |
722 | releases. */ | |
723 | #define PERL_LAST_5_10_0_INTERP_MEMBER Iisarev | |
724 | ||
f16dd614 | 725 | #ifdef PERL_IMPLICIT_CONTEXT |
4c901e72 | 726 | PERLVARI(Imy_cxt_size, int, 0) /* size of PL_my_cxt_list */ |
f16dd614 | 727 | PERLVARI(Imy_cxt_list, void **, NULL) /* per-module array of MY_CXT pointers */ |
ba6d381e | 728 | # ifdef PERL_GLOBAL_STRUCT_PRIVATE |
53d44271 | 729 | PERLVARI(Imy_cxt_keys, const char **, NULL) /* per-module array of pointers to MY_CXT_KEY constants */ |
ba6d381e | 730 | # endif |
f16dd614 DM |
731 | #endif |
732 | ||
7cb608b5 NC |
733 | #ifdef PERL_TRACK_MEMPOOL |
734 | /* For use with the memory debugging code in util.c */ | |
735 | PERLVAR(Imemory_debug_header, struct perl_memory_debug_header) | |
736 | #endif | |
737 | ||
ba6d381e NC |
738 | #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP |
739 | /* File descriptor to talk to the child which dumps scalars. */ | |
740 | PERLVARI(Idumper_fd, int, -1) | |
741 | #endif | |
742 | ||
743 | /* Stores the PPID */ | |
744 | #ifdef THREADS_HAVE_PIDS | |
745 | PERLVARI(Ippid, IV, 0) | |
746 | #endif | |
747 | ||
748 | #ifdef PERL_MAD | |
749 | PERLVARI(Imadskills, bool, FALSE) /* preserve all syntactic info */ | |
750 | /* (MAD = Misc Attribute Decoration) */ | |
751 | PERLVARI(Ixmlfp, PerlIO *,NULL) | |
752 | #endif | |
753 | ||
754 | #ifdef PL_OP_SLAB_ALLOC | |
755 | PERLVAR(IOpPtr,I32 **) | |
756 | PERLVARI(IOpSpace,I32,0) | |
757 | PERLVAR(IOpSlab,I32 *) | |
758 | #endif | |
759 | ||
f1fac472 NC |
760 | #ifdef PERL_DEBUG_READONLY_OPS |
761 | PERLVARI(Islabs, I32**, NULL) /* Array of slabs that have been allocated */ | |
762 | PERLVARI(Islab_count, U32, 0) /* Size of the array */ | |
763 | #endif | |
764 | ||
eba16661 | 765 | /* Can shared object be destroyed */ |
ef69c8fc | 766 | PERLVARI(Idestroyhook, destroyable_proc_t, Perl_sv_destroyable) |
eba16661 | 767 | |
d7a2c63c MHM |
768 | #ifdef DEBUG_LEAKING_SCALARS |
769 | PERLVARI(Isv_serial, U32, 0) /* SV serial number, used in sv.c */ | |
770 | #endif | |
771 | ||
a3e6e81e NC |
772 | /* Register of known Method Resolution Orders. |
773 | What this actually points to is an implementation detail (it may change to | |
774 | a structure incorporating a reference count - use mro_get_from_name to | |
775 | retrieve a C<struct mro_alg *> */ | |
776 | PERLVAR(Iregistered_mros, HV *) | |
777 | ||
1930840b BM |
778 | /* Compile-time block start/end hooks */ |
779 | PERLVAR(Iblockhooks, AV *) | |
780 | ||
2726813d | 781 | |
41fc8fee KW |
782 | /* Everything that folds to a given character, for case insensitivity regex |
783 | * matching */ | |
2726813d KW |
784 | PERLVARI(Iutf8_foldclosures, HV *, NULL) |
785 | ||
1bd9dc91 KW |
786 | /* List of characters that participate in folds (except marks, etc in |
787 | * multi-char folds) */ | |
796c250a | 788 | PERLVARI(Iutf8_foldable, HV *, NULL) |
1bd9dc91 | 789 | |
1830b3d9 BM |
790 | PERLVAR(Icustom_ops, HV *) /* custom op registrations */ |
791 | ||
157b3822 NC |
792 | /* If you are adding a U8 or U16, check to see if there are 'Space' comments |
793 | * above on where there are gaps which currently will be structure padding. */ | |
d95e864f NC |
794 | |
795 | /* Within a stable branch, new variables must be added to the very end, before | |
796 | * this comment, for binary compatibility (the offsets of the old members must | |
797 | * not change). | |
b83cd129 | 798 | * (Don't forget to add your variable also to perl_clone()!) |
e3acbfda | 799 | * XSUB.h provides wrapper functions via perlapi.h that make this |
b83cd129 JH |
800 | * irrelevant, but not all code may be expected to #include XSUB.h. |
801 | */ |