Commit | Line | Data |
---|---|---|
d6376244 JH |
1 | /* thdrvar.h |
2 | * | |
3 | * Copyright (c) 1997-2002, Larry Wall | |
4 | * | |
5 | * You may distribute under the terms of either the GNU General Public | |
6 | * License or the Artistic License, as specified in the README file. | |
7 | * | |
8 | */ | |
9 | ||
ccfc67b7 JH |
10 | /* |
11 | =head1 Global Variables | |
12 | */ | |
13 | ||
cb68f92d GS |
14 | /***********************************************/ |
15 | /* Global only to current thread */ | |
16 | /***********************************************/ | |
17 | ||
8b3be1d1 JP |
18 | /* Don't forget to re-run embed.pl to propagate changes! */ |
19 | ||
cb68f92d | 20 | /* The 'T' prefix is only needed for vars that need appropriate #defines |
4d1ff10f | 21 | * generated when built with or without USE_5005THREADS. It is also used |
cb68f92d GS |
22 | * to generate the appropriate export list for win32. |
23 | * | |
4d1ff10f AB |
24 | * When building without USE_5005THREADS, these variables will be truly global. |
25 | * When building without USE_5005THREADS but with MULTIPLICITY, these variables | |
14dd3ad8 | 26 | * will be global per-interpreter. */ |
8b3be1d1 | 27 | |
49f531da | 28 | /* Important ones in the first cache line (if alignment is done right) */ |
d4cce5f1 | 29 | |
4d1ff10f | 30 | #ifdef USE_5005THREADS |
c5be433b GS |
31 | PERLVAR(interp, PerlInterpreter*) /* thread owner */ |
32 | #endif | |
33 | ||
cb68f92d | 34 | PERLVAR(Tstack_sp, SV **) /* top of the stack */ |
49f531da | 35 | #ifdef OP_IN_REGISTER |
cb68f92d | 36 | PERLVAR(Topsave, OP *) |
49f531da | 37 | #else |
cb68f92d | 38 | PERLVAR(Top, OP *) /* currently executing op */ |
49f531da | 39 | #endif |
cb68f92d GS |
40 | PERLVAR(Tcurpad, SV **) /* active pad (lexicals+tmps) */ |
41 | ||
42 | PERLVAR(Tstack_base, SV **) | |
43 | PERLVAR(Tstack_max, SV **) | |
44 | ||
45 | PERLVAR(Tscopestack, I32 *) /* scopes we've ENTERed */ | |
46 | PERLVAR(Tscopestack_ix, I32) | |
47 | PERLVAR(Tscopestack_max,I32) | |
49f531da | 48 | |
cb68f92d GS |
49 | PERLVAR(Tsavestack, ANY *) /* items that need to be restored |
50 | when LEAVEing scopes we've ENTERed */ | |
51 | PERLVAR(Tsavestack_ix, I32) | |
52 | PERLVAR(Tsavestack_max, I32) | |
49f531da | 53 | |
cb68f92d GS |
54 | PERLVAR(Ttmps_stack, SV **) /* mortals we've made */ |
55 | PERLVARI(Ttmps_ix, I32, -1) | |
56 | PERLVARI(Ttmps_floor, I32, -1) | |
57 | PERLVAR(Ttmps_max, I32) | |
49f531da | 58 | |
cb68f92d GS |
59 | PERLVAR(Tmarkstack, I32 *) /* stack_sp locations we're remembering */ |
60 | PERLVAR(Tmarkstack_ptr, I32 *) | |
61 | PERLVAR(Tmarkstack_max, I32 *) | |
49f531da | 62 | |
cb68f92d GS |
63 | PERLVAR(Tretstack, OP **) /* OPs we have postponed executing */ |
64 | PERLVAR(Tretstack_ix, I32) | |
65 | PERLVAR(Tretstack_max, I32) | |
49f531da | 66 | |
cb68f92d GS |
67 | PERLVAR(TSv, SV *) /* used to hold temporary values */ |
68 | PERLVAR(TXpv, XPV *) /* used to hold temporary values */ | |
954c1994 GS |
69 | |
70 | /* | |
71 | =for apidoc Amn|STRLEN|PL_na | |
72 | ||
73 | A convenience variable which is typically used with C<SvPV> when one | |
74 | doesn't care about the length of the string. It is usually more efficient | |
75 | to either declare a local variable and use that instead or to use the | |
76 | C<SvPV_nolen> macro. | |
77 | ||
78 | =cut | |
79 | */ | |
80 | ||
b099ddc0 GS |
81 | PERLVAR(Tna, STRLEN) /* for use in SvPV when length is |
82 | Not Applicable */ | |
49f531da | 83 | |
5c0ca799 | 84 | /* stat stuff */ |
cb68f92d | 85 | PERLVAR(Tstatbuf, Stat_t) |
5c0ca799 GS |
86 | PERLVAR(Tstatcache, Stat_t) /* _ */ |
87 | PERLVAR(Tstatgv, GV *) | |
88 | PERLVARI(Tstatname, SV *, Nullsv) | |
89 | ||
49f531da | 90 | #ifdef HAS_TIMES |
cb68f92d | 91 | PERLVAR(Ttimesbuf, struct tms) |
49f531da | 92 | #endif |
49f531da NIS |
93 | |
94 | /* Fields used by magic variables such as $@, $/ and so on */ | |
d4cce5f1 | 95 | PERLVAR(Ttainted, bool) /* using variables controlled by $< */ |
cb68f92d | 96 | PERLVAR(Tcurpm, PMOP *) /* what to do \ interps in REs from */ |
b7ac61fa | 97 | PERLVAR(Tnrs, SV *) /* placeholder: unused since 5.8.0 (5.7.2 patch #12027 for bug ID 20010815.012) */ |
c155e47c SC |
98 | |
99 | /* | |
2eb25c99 | 100 | =for apidoc mn|SV*|PL_rs |
c155e47c SC |
101 | |
102 | The input record separator - C<$/> in Perl space. | |
103 | ||
2eb25c99 | 104 | =for apidoc mn|GV*|PL_last_in_gv |
c155e47c SC |
105 | |
106 | The GV which was last used for a filehandle input operation. (C<< <FH> >>) | |
107 | ||
2eb25c99 | 108 | =for apidoc mn|SV*|PL_ofs_sv |
c155e47c SC |
109 | |
110 | The output field separator - C<$,> in Perl space. | |
111 | ||
112 | =cut | |
113 | */ | |
114 | ||
cb68f92d GS |
115 | PERLVAR(Trs, SV *) /* input record separator $/ */ |
116 | PERLVAR(Tlast_in_gv, GV *) /* GV used in last <FH> */ | |
7889fe52 | 117 | PERLVAR(Tofs_sv, SV *) /* output field separator $, */ |
cb68f92d | 118 | PERLVAR(Tdefoutgv, GV *) /* default FH for output */ |
d4cce5f1 | 119 | PERLVARI(Tchopset, char *, " \n-") /* $: */ |
cb68f92d GS |
120 | PERLVAR(Tformtarget, SV *) |
121 | PERLVAR(Tbodytarget, SV *) | |
122 | PERLVAR(Ttoptarget, SV *) | |
49f531da | 123 | |
d4cce5f1 NIS |
124 | /* Stashes */ |
125 | PERLVAR(Tdefstash, HV *) /* main symbol table */ | |
126 | PERLVAR(Tcurstash, HV *) /* symbol table for current package */ | |
49f531da | 127 | |
cb68f92d | 128 | PERLVAR(Trestartop, OP *) /* propagating an error from croak? */ |
3280af22 | 129 | PERLVARI(Tcurcop, COP * VOL, &PL_compiling) |
d4cce5f1 NIS |
130 | PERLVAR(Tin_eval, VOL int) /* trap "fatal" errors? */ |
131 | PERLVAR(Tdelaymagic, int) /* ($<,$>) = ... */ | |
24d3c518 | 132 | PERLVARI(Tdirty, bool, FALSE) /* in the middle of tearing things down? */ |
61bb5906 | 133 | PERLVAR(Tlocalizing, int) /* are we processing a local() list? */ |
49f531da | 134 | |
cb68f92d GS |
135 | PERLVAR(Tcurstack, AV *) /* THE STACK */ |
136 | PERLVAR(Tcurstackinfo, PERL_SI *) /* current stack + context */ | |
137 | PERLVAR(Tmainstack, AV *) /* the stack when nothing funny is happening */ | |
312caa8e | 138 | |
cb68f92d GS |
139 | PERLVAR(Ttop_env, JMPENV *) /* ptr. to current sigjmp() environment */ |
140 | PERLVAR(Tstart_env, JMPENV) /* empty startup sigjmp() environment */ | |
14dd3ad8 | 141 | #ifdef PERL_FLEXIBLE_EXCEPTIONS |
0b94c7bb | 142 | PERLVARI(Tprotect, protect_proc_t, MEMBER_TO_FPTR(Perl_default_protect)) |
14dd3ad8 | 143 | #endif |
5a844595 | 144 | PERLVARI(Terrors, SV *, Nullsv) /* outstanding queued errors */ |
49f531da | 145 | |
4e4c362e | 146 | /* statics "owned" by various functions */ |
cb68f92d GS |
147 | PERLVAR(Tav_fetch_sv, SV *) /* owned by av_fetch() */ |
148 | PERLVAR(Thv_fetch_sv, SV *) /* owned by hv_fetch() */ | |
149 | PERLVAR(Thv_fetch_ent_mh, HE) /* owned by hv_fetch_ent() */ | |
150 | ||
151 | PERLVAR(Tmodcount, I32) /* how much mod()ification in assignment? */ | |
4e4c362e | 152 | |
5c0ca799 | 153 | PERLVAR(Tlastgotoprobe, OP*) /* from pp_ctl.c */ |
3967c732 | 154 | PERLVARI(Tdumpindent, I32, 4) /* # of blanks per dump indentation level */ |
5c0ca799 GS |
155 | |
156 | /* sort stuff */ | |
157 | PERLVAR(Tsortcop, OP *) /* user defined sort routine */ | |
158 | PERLVAR(Tsortstash, HV *) /* which is in some package or other */ | |
159 | PERLVAR(Tfirstgv, GV *) /* $a */ | |
160 | PERLVAR(Tsecondgv, GV *) /* $b */ | |
161 | PERLVAR(Tsortcxix, I32) /* from pp_ctl.c */ | |
162 | ||
7d5ea4e7 GS |
163 | /* float buffer */ |
164 | PERLVAR(Tefloatbuf, char*) | |
165 | PERLVAR(Tefloatsize, STRLEN) | |
166 | ||
5c0ca799 GS |
167 | /* regex stuff */ |
168 | ||
169 | PERLVAR(Tscreamfirst, I32 *) | |
170 | PERLVAR(Tscreamnext, I32 *) | |
171 | PERLVARI(Tmaxscream, I32, -1) | |
172 | PERLVAR(Tlastscream, SV *) | |
173 | ||
174 | PERLVAR(Tregdummy, regnode) /* from regcomp.c */ | |
175 | PERLVAR(Tregcomp_parse, char*) /* Input-scan pointer. */ | |
176 | PERLVAR(Tregxend, char*) /* End of input for compile */ | |
177 | PERLVAR(Tregcode, regnode*) /* Code-emit pointer; ®dummy = don't */ | |
178 | PERLVAR(Tregnaughty, I32) /* How bad is this pattern? */ | |
179 | PERLVAR(Tregsawback, I32) /* Did we see \1, ...? */ | |
180 | PERLVAR(Tregprecomp, char *) /* uncompiled string. */ | |
181 | PERLVAR(Tregnpar, I32) /* () count. */ | |
182 | PERLVAR(Tregsize, I32) /* Code size. */ | |
183 | PERLVAR(Tregflags, U16) /* are we folding, multilining? */ | |
184 | PERLVAR(Tregseen, U32) /* from regcomp.c */ | |
185 | PERLVAR(Tseen_zerolen, I32) /* from regcomp.c */ | |
186 | PERLVAR(Tseen_evals, I32) /* from regcomp.c */ | |
187 | PERLVAR(Tregcomp_rx, regexp *) /* from regcomp.c */ | |
188 | PERLVAR(Textralen, I32) /* from regcomp.c */ | |
189 | PERLVAR(Tcolorset, int) /* from regcomp.c */ | |
51371543 | 190 | PERLVARA(Tcolors,6, char *) /* from regcomp.c */ |
82ba1be6 | 191 | PERLVAR(Treg_whilem_seen, I32) /* number of WHILEM in this expr */ |
5c0ca799 GS |
192 | PERLVAR(Treginput, char *) /* String-input pointer. */ |
193 | PERLVAR(Tregbol, char *) /* Beginning of input, for ^ check. */ | |
194 | PERLVAR(Tregeol, char *) /* End of input, for $ check. */ | |
cf93c79d IZ |
195 | PERLVAR(Tregstartp, I32 *) /* Pointer to startp array. */ |
196 | PERLVAR(Tregendp, I32 *) /* Ditto for endp. */ | |
5c0ca799 | 197 | PERLVAR(Treglastparen, U32 *) /* Similarly for lastparen. */ |
a01268b5 | 198 | PERLVAR(Treglastcloseparen, U32 *) /* Similarly for lastcloseparen. */ |
5c0ca799 | 199 | PERLVAR(Tregtill, char *) /* How far we are required to go. */ |
31376155 | 200 | PERLVAR(Tregcompat1, char) /* used to be regprev1 */ |
5c0ca799 GS |
201 | PERLVAR(Treg_start_tmp, char **) /* from regexec.c */ |
202 | PERLVAR(Treg_start_tmpl,U32) /* from regexec.c */ | |
203 | PERLVAR(Tregdata, struct reg_data *) | |
204 | /* from regexec.c renamed was data */ | |
205 | PERLVAR(Tbostr, char *) /* from regexec.c */ | |
206 | PERLVAR(Treg_flags, U32) /* from regexec.c */ | |
207 | PERLVAR(Treg_eval_set, I32) /* from regexec.c */ | |
208 | PERLVAR(Tregnarrate, I32) /* from regexec.c */ | |
209 | PERLVAR(Tregprogram, regnode *) /* from regexec.c */ | |
210 | PERLVARI(Tregindent, int, 0) /* from regexec.c */ | |
211 | PERLVAR(Tregcc, CURCUR *) /* from regexec.c */ | |
0f5d15d6 IZ |
212 | PERLVAR(Treg_call_cc, struct re_cc_state *) /* from regexec.c */ |
213 | PERLVAR(Treg_re, regexp *) /* from regexec.c */ | |
22e551b9 IZ |
214 | PERLVAR(Treg_ganch, char *) /* position of \G */ |
215 | PERLVAR(Treg_sv, SV *) /* what we match against */ | |
9661b544 IZ |
216 | PERLVAR(Treg_magic, MAGIC *) /* pos-magic of what we match */ |
217 | PERLVAR(Treg_oldpos, I32) /* old pos of what we match */ | |
5c5e4c24 IZ |
218 | PERLVARI(Treg_oldcurpm, PMOP*, NULL) /* curpm before match */ |
219 | PERLVARI(Treg_curpm, PMOP*, NULL) /* curpm during match */ | |
cf93c79d IZ |
220 | PERLVAR(Treg_oldsaved, char*) /* old saved substr during match */ |
221 | PERLVAR(Treg_oldsavedlen, STRLEN) /* old length of saved substr during match */ | |
82ba1be6 IZ |
222 | PERLVAR(Treg_maxiter, I32) /* max wait until caching pos */ |
223 | PERLVAR(Treg_leftiter, I32) /* wait until caching pos */ | |
224 | PERLVARI(Treg_poscache, char *, Nullch) /* cache of pos of WHILEM */ | |
225 | PERLVAR(Treg_poscache_size, STRLEN) /* size of pos cache of WHILEM */ | |
5c0ca799 | 226 | |
a2efc822 SC |
227 | PERLVARI(Tpeepp, peep_t, MEMBER_TO_FPTR(Perl_peep)) |
228 | /* Pointer to peephole optimizer */ | |
0b94c7bb | 229 | PERLVARI(Tregcompp, regcomp_t, MEMBER_TO_FPTR(Perl_pregcomp)) |
f722798b | 230 | /* Pointer to REx compiler */ |
0b94c7bb | 231 | PERLVARI(Tregexecp, regexec_t, MEMBER_TO_FPTR(Perl_regexec_flags)) |
f722798b | 232 | /* Pointer to REx executer */ |
0b94c7bb | 233 | PERLVARI(Tregint_start, re_intuit_start_t, MEMBER_TO_FPTR(Perl_re_intuit_start)) |
f722798b | 234 | /* Pointer to optimized REx executer */ |
0b94c7bb | 235 | PERLVARI(Tregint_string,re_intuit_string_t, MEMBER_TO_FPTR(Perl_re_intuit_string)) |
f722798b | 236 | /* Pointer to optimized REx string */ |
0b94c7bb | 237 | PERLVARI(Tregfree, regfree_t, MEMBER_TO_FPTR(Perl_pregfree)) |
f722798b IZ |
238 | /* Pointer to REx free()er */ |
239 | ||
57668c4d | 240 | PERLVARI(Treginterp_cnt,int, 0) /* Whether `Regexp' |
5c0ca799 | 241 | was interpolated. */ |
364723c2 | 242 | PERLVARI(Treg_starttry, char *, 0) /* -Dr: where regtry was called. */ |
22c35a8c GS |
243 | PERLVARI(Twatchaddr, char **, 0) |
244 | PERLVAR(Twatchok, char *) | |
d4cce5f1 | 245 | |
8b3be1d1 | 246 | /* Note that the variables below are all explicitly referenced in the code |
cb68f92d | 247 | * as thr->whatever and therefore don't need the 'T' prefix. */ |
8b3be1d1 | 248 | |
4d1ff10f | 249 | #ifdef USE_5005THREADS |
49f531da | 250 | |
cb68f92d GS |
251 | PERLVAR(oursv, SV *) |
252 | PERLVAR(cvcache, HV *) | |
253 | PERLVAR(self, perl_os_thread) /* Underlying thread object */ | |
254 | PERLVAR(flags, U32) | |
255 | PERLVAR(threadsv, AV *) /* Per-thread SVs ($_, $@ etc.) */ | |
256 | PERLVAR(threadsvp, SV **) /* AvARRAY(threadsv) */ | |
257 | PERLVAR(specific, AV *) /* Thread-specific user data */ | |
258 | PERLVAR(errsv, SV *) /* Backing SV for $@ */ | |
cb68f92d GS |
259 | PERLVAR(mutex, perl_mutex) /* For the fields others can change */ |
260 | PERLVAR(tid, U32) | |
49f531da | 261 | PERLVAR(prev, struct perl_thread *) |
cb68f92d GS |
262 | PERLVAR(next, struct perl_thread *) |
263 | /* Circular linked list of threads */ | |
49f531da NIS |
264 | |
265 | #ifdef HAVE_THREAD_INTERN | |
cb68f92d GS |
266 | PERLVAR(i, struct thread_intern) |
267 | /* Platform-dependent internals */ | |
49f531da NIS |
268 | #endif |
269 | ||
cb68f92d | 270 | PERLVAR(trailing_nul, char) /* For the sake of thrsv and oursv */ |
8dcd6f7b | 271 | PERLVAR(thr_done, bool) /* True when the thread has finished */ |
d9f424b2 | 272 | |
4d1ff10f | 273 | #endif /* USE_5005THREADS */ |
d9f424b2 | 274 | |
53c4c00c | 275 | PERLVAR(Treg_match_utf8, bool) /* was what we matched against utf8 */ |
d9f424b2 | 276 |