1 /***********************************************/
2 /* Global only to current interpreter instance */
3 /***********************************************/
5 /* Don't forget to re-run embed.pl to propagate changes! */
7 /* The 'I' prefix is only needed for vars that need appropriate #defines
8 * generated when built with or without MULTIPLICITY. It is also used
9 * to generate the appropriate export list for win32.
11 * When building without MULTIPLICITY, these variables will be truly global. */
13 /* pseudo environmental stuff */
14 PERLVAR(Iorigargc
, int)
15 PERLVAR(Iorigargv
, char **)
18 PERLVAR(Ihintgv
, GV
*)
19 PERLVAR(Iorigfilename
, char *)
20 PERLVAR(Idiehook
, SV
*)
21 PERLVAR(Iwarnhook
, SV
*)
24 PERLVAR(Iminus_c
, bool)
25 PERLVAR(Ipatchlevel
, SV
*)
26 PERLVAR(Ilocalpatches
, char **)
27 PERLVARI(Isplitstr
, char *, " ")
28 PERLVAR(Ipreprocess
, bool)
29 PERLVAR(Iminus_n
, bool)
30 PERLVAR(Iminus_p
, bool)
31 PERLVAR(Iminus_l
, bool)
32 PERLVAR(Iminus_a
, bool)
33 PERLVAR(Iminus_F
, bool)
34 PERLVAR(Idoswitches
, bool)
37 =for apidoc mn|bool|PL_dowarn
39 The C variable which corresponds to Perl's $^W warning variable.
45 PERLVAR(Iwidesyscalls
, bool) /* wide system calls */
46 PERLVAR(Idoextract
, bool)
47 PERLVAR(Isawampersand
, bool) /* must save all match strings */
48 PERLVAR(Iunsafe
, bool)
49 PERLVAR(Iinplace
, char *)
50 PERLVAR(Ie_script
, SV
*)
53 /* This value may be set when embedding for full cleanup */
54 /* 0=none, 1=full, 2=full with checks */
55 PERLVARI(Iperl_destruct_level
, int, 0)
57 /* magical thingies */
58 PERLVAR(Ibasetime
, Time_t
) /* $^T */
59 PERLVAR(Iformfeed
, SV
*) /* $^L */
62 PERLVARI(Imaxsysfd
, I32
, MAXSYSFD
)
63 /* top fd to pass to subprocesses */
64 PERLVAR(Imultiline
, int) /* $*--do strings hold >1 line? */
65 PERLVAR(Istatusvalue
, I32
) /* $? */
66 PERLVAR(Iexit_flags
, U8
) /* was exit() unexpected, etc. */
68 PERLVAR(Istatusvalue_vms
,U32
)
71 /* shortcuts to various I/O objects */
72 PERLVAR(Istdingv
, GV
*)
73 PERLVAR(Istderrgv
, GV
*)
75 PERLVAR(Iargvgv
, GV
*)
76 PERLVAR(Iargvoutgv
, GV
*)
77 PERLVAR(Iargvout_stack
, AV
*)
79 /* shortcuts to regexp stuff */
80 /* this one needs to be moved to thrdvar.h and accessed via
81 * find_threadsv() when USE_THREADS */
82 PERLVAR(Ireplgv
, GV
*)
84 /* shortcuts to misc objects */
87 /* shortcuts to debugging objects */
89 PERLVAR(IDBline
, GV
*)
92 =for apidoc mn|GV *|PL_DBsub
93 When Perl is run in debugging mode, with the B<-d> switch, this GV contains
94 the SV which holds the name of the sub being debugged. This is the C
95 variable which corresponds to Perl's $DB::sub variable. See
98 =for apidoc mn|SV *|PL_DBsingle
99 When Perl is run in debugging mode, with the B<-d> switch, this SV is a
100 boolean which indicates whether subs are being single-stepped.
101 Single-stepping is automatically turned on after every step. This is the C
102 variable which corresponds to Perl's $DB::single variable. See
105 =for apidoc mn|SV *|PL_DBtrace
106 Trace variable used when Perl is run in debugging mode, with the B<-d>
107 switch. This is the C variable which corresponds to Perl's $DB::trace
108 variable. See C<PL_DBsingle>.
113 PERLVAR(IDBsub
, GV
*)
114 PERLVAR(IDBsingle
, SV
*)
115 PERLVAR(IDBtrace
, SV
*)
116 PERLVAR(IDBsignal
, SV
*)
117 PERLVAR(Ilineary
, AV
*) /* lines of script for debugger */
118 PERLVAR(Idbargs
, AV
*) /* args to call listed by caller function */
121 PERLVAR(Idebstash
, HV
*) /* symbol table for perldb package */
122 PERLVAR(Iglobalstash
, HV
*) /* global keyword overrides imported here */
123 PERLVAR(Icurstname
, SV
*) /* name of current package */
124 PERLVAR(Ibeginav
, AV
*) /* names of BEGIN subroutines */
125 PERLVAR(Iendav
, AV
*) /* names of END subroutines */
126 PERLVAR(Icheckav
, AV
*) /* names of CHECK subroutines */
127 PERLVAR(Iinitav
, AV
*) /* names of INIT subroutines */
128 PERLVAR(Istrtab
, HV
*) /* shared string table */
129 PERLVARI(Isub_generation
,U32
,1) /* incr to invalidate method cache */
131 /* memory management */
132 PERLVAR(Isv_count
, I32
) /* how many SV* are currently allocated */
133 PERLVAR(Isv_objcount
, I32
) /* how many objects are currently allocated */
134 PERLVAR(Isv_root
, SV
*) /* storage for SVs belonging to interp */
135 PERLVAR(Isv_arenaroot
, SV
*) /* list of areas for garbage collection */
137 /* funky return mechanisms */
138 PERLVAR(Iforkprocess
, int) /* so do_open |- can return proc# */
140 /* subprocess state */
141 PERLVAR(Ifdpid
, AV
*) /* keep fd-to-pid mappings for my_popen */
144 PERLVAR(Itainting
, bool) /* doing taint checks */
145 PERLVARI(Iop_mask
, char *, NULL
) /* masked operations for safe evals */
147 /* current interpreter roots */
148 PERLVAR(Imain_cv
, CV
*)
149 PERLVAR(Imain_root
, OP
*)
150 PERLVAR(Imain_start
, OP
*)
151 PERLVAR(Ieval_root
, OP
*)
152 PERLVAR(Ieval_start
, OP
*)
154 /* runtime control stuff */
155 PERLVARI(Icurcopdb
, COP
*, NULL
)
156 PERLVARI(Icopline
, line_t
, NOLINE
)
158 /* statics moved here for shared library purposes */
159 PERLVAR(Ifilemode
, int) /* so nextargv() can preserve mode */
160 PERLVAR(Ilastfd
, int) /* what to preserve mode on */
161 PERLVAR(Ioldname
, char *) /* what to preserve mode on */
162 PERLVAR(IArgv
, char **) /* stuff to free from do_aexec, vfork safe */
163 PERLVAR(ICmd
, char *) /* stuff to free from do_aexec, vfork safe */
164 PERLVAR(Igensym
, I32
) /* next symbol for getsym() to define */
165 PERLVAR(Ipreambled
, bool)
166 PERLVAR(Ipreambleav
, AV
*)
167 PERLVARI(Ilaststatval
, int, -1)
168 PERLVARI(Ilaststype
, I32
, OP_STAT
)
169 PERLVAR(Imess_sv
, SV
*)
171 /* XXX shouldn't these be per-thread? --GSAR */
172 PERLVAR(Iors
, char *) /* output record separator $\ */
173 PERLVAR(Iorslen
, STRLEN
)
174 PERLVAR(Iofmt
, char *) /* output format for numbers $# */
176 /* interpreter atexit processing */
177 PERLVARI(Iexitlist
, PerlExitListEntry
*, NULL
)
178 /* list of exit functions */
179 PERLVARI(Iexitlistlen
, I32
, 0) /* length of same */
182 =for apidoc Amn|HV*|PL_modglobal
184 C<PL_modglobal> is a general purpose, interpreter global HV for use by
185 extensions that need to keep information on a per-interpreter basis.
186 In a pinch, it can also be used as a symbol table for extensions
187 to share data among each other. It is a good idea to use keys
188 prefixed by the package name of the extension that owns the data.
193 PERLVAR(Imodglobal
, HV
*) /* per-interp module data */
195 /* these used to be in global before 5.004_68 */
196 PERLVARI(Iprofiledata
, U32
*, NULL
) /* table of ops, counts */
197 PERLVARI(Irsfp
, PerlIO
* VOL
, Nullfp
) /* current source file pointer */
198 PERLVARI(Irsfp_filters
, AV
*, Nullav
) /* keeps active source filters */
200 PERLVAR(Icompiling
, COP
) /* compiling/done executing marker */
202 PERLVAR(Icompcv
, CV
*) /* currently compiling subroutine */
203 PERLVAR(Icomppad
, AV
*) /* storage for lexically scoped temporaries */
204 PERLVAR(Icomppad_name
, AV
*) /* variable names for "my" variables */
205 PERLVAR(Icomppad_name_fill
, I32
) /* last "introduced" variable offset */
206 PERLVAR(Icomppad_name_floor
, I32
) /* start of vars in innermost block */
208 #ifdef HAVE_INTERP_INTERN
209 PERLVAR(Isys_intern
, struct interp_intern
)
210 /* platform internals */
213 /* more statics moved here */
214 PERLVARI(Igeneration
, int, 100) /* from op.c */
215 PERLVAR(IDBcv
, CV
*) /* from perl.c */
217 PERLVARI(Iin_clean_objs
,bool, FALSE
) /* from sv.c */
218 PERLVARI(Iin_clean_all
, bool, FALSE
) /* from sv.c */
220 PERLVAR(Ilinestart
, char *) /* beg. of most recently read line */
221 PERLVAR(Ipending_ident
, char) /* pending identifier lookup */
222 PERLVAR(Isublex_info
, SUBLEXINFO
) /* from toke.c */
225 PERLVAR(Ithrsv
, SV
*) /* struct perl_thread for main thread */
226 PERLVARI(Ithreadnum
, U32
, 0) /* incremented each thread creation */
227 PERLVAR(Istrtab_mutex
, perl_mutex
) /* Mutex for string table access */
228 #endif /* USE_THREADS */
230 PERLVAR(Iuid
, Uid_t
) /* current real user id */
231 PERLVAR(Ieuid
, Uid_t
) /* current effective user id */
232 PERLVAR(Igid
, Gid_t
) /* current real group id */
233 PERLVAR(Iegid
, Gid_t
) /* current effective group id */
234 PERLVAR(Inomemok
, bool) /* let malloc context handle nomem */
235 PERLVAR(Ian
, U32
) /* malloc sequence number */
236 PERLVAR(Icop_seqmax
, U32
) /* statement sequence number */
237 PERLVAR(Iop_seqmax
, U16
) /* op sequence number */
238 PERLVAR(Ievalseq
, U32
) /* eval sequence number */
239 PERLVAR(Iorigenviron
, char **)
240 PERLVAR(Iorigalen
, U32
)
241 PERLVAR(Ipidstatus
, HV
*) /* pid-to-status mappings for waitpid */
242 PERLVARI(Imaxo
, int, MAXO
) /* maximum number of ops */
243 PERLVAR(Iosname
, char *) /* operating system */
244 PERLVARI(Ish_path
, char *, SH_PATH
)/* full path of shell */
245 PERLVAR(Isighandlerp
, Sighandler_t
)
247 PERLVAR(Ixiv_arenaroot
, XPV
*) /* list of allocated xiv areas */
248 PERLVAR(Ixiv_root
, IV
*) /* free xiv list */
249 PERLVAR(Ixnv_root
, NV
*) /* free xnv list */
250 PERLVAR(Ixrv_root
, XRV
*) /* free xrv list */
251 PERLVAR(Ixpv_root
, XPV
*) /* free xpv list */
252 PERLVAR(Ixpviv_root
, XPVIV
*) /* free xpviv list */
253 PERLVAR(Ixpvnv_root
, XPVNV
*) /* free xpvnv list */
254 PERLVAR(Ixpvcv_root
, XPVCV
*) /* free xpvcv list */
255 PERLVAR(Ixpvav_root
, XPVAV
*) /* free xpvav list */
256 PERLVAR(Ixpvhv_root
, XPVHV
*) /* free xpvhv list */
257 PERLVAR(Ixpvmg_root
, XPVMG
*) /* free xpvmg list */
258 PERLVAR(Ixpvlv_root
, XPVLV
*) /* free xpvlv list */
259 PERLVAR(Ixpvbm_root
, XPVBM
*) /* free xpvbm list */
260 PERLVAR(Ihe_root
, HE
*) /* free he list */
261 PERLVAR(Inice_chunk
, char *) /* a nice chunk of memory to reuse */
262 PERLVAR(Inice_chunk_size
, U32
) /* how nice the chunk of memory is */
264 PERLVARI(Irunops
, runops_proc_t
, MEMBER_TO_FPTR(RUNOPS_DEFAULT
))
266 PERLVARA(Itokenbuf
,256, char)
269 =for apidoc Amn|SV|PL_sv_undef
270 This is the C<undef> SV. Always refer to this as C<&PL_sv_undef>.
272 =for apidoc Amn|SV|PL_sv_no
273 This is the C<false> SV. See C<PL_sv_yes>. Always refer to this as
276 =for apidoc Amn|SV|PL_sv_yes
277 This is the C<true> SV. See C<PL_sv_no>. Always refer to this as
283 PERLVAR(Isv_undef
, SV
)
288 PERLVARI(Icshname
, char *, CSH
)
289 PERLVAR(Icshlen
, I32
)
292 PERLVAR(Ilex_state
, U32
) /* next token is determined */
293 PERLVAR(Ilex_defer
, U32
) /* state after determined token */
294 PERLVAR(Ilex_expect
, int) /* expect after determined token */
295 PERLVAR(Ilex_brackets
, I32
) /* bracket count */
296 PERLVAR(Ilex_formbrack
, I32
) /* bracket count at outer format level */
297 PERLVAR(Ilex_casemods
, I32
) /* casemod count */
298 PERLVAR(Ilex_dojoin
, I32
) /* doing an array interpolation */
299 PERLVAR(Ilex_starts
, I32
) /* how many interps done on level */
300 PERLVAR(Ilex_stuff
, SV
*) /* runtime pattern from m// or s/// */
301 PERLVAR(Ilex_repl
, SV
*) /* runtime replacement from s/// */
302 PERLVAR(Ilex_op
, OP
*) /* extra info to pass back on op */
303 PERLVAR(Ilex_inpat
, OP
*) /* in pattern $) and $| are special */
304 PERLVAR(Ilex_inwhat
, I32
) /* what kind of quoting are we in */
305 PERLVAR(Ilex_brackstack
,char *) /* what kind of brackets to pop */
306 PERLVAR(Ilex_casestack
, char *) /* what kind of case mods in effect */
308 /* What we know when we're in LEX_KNOWNEXT state. */
309 PERLVARA(Inextval
,5, YYSTYPE
) /* value of next token, if any */
310 PERLVARA(Inexttype
,5, I32
) /* type of next token */
311 PERLVAR(Inexttoke
, I32
)
313 PERLVAR(Ilinestr
, SV
*)
314 PERLVAR(Ibufptr
, char *)
315 PERLVAR(Ioldbufptr
, char *)
316 PERLVAR(Ioldoldbufptr
, char *)
317 PERLVAR(Ibufend
, char *)
318 PERLVARI(Iexpect
,int, XSTATE
) /* how to interpret ambiguous tokens */
320 PERLVAR(Imulti_start
, I32
) /* 1st line of multi-line string */
321 PERLVAR(Imulti_end
, I32
) /* last line of multi-line string */
322 PERLVAR(Imulti_open
, I32
) /* delimiter of said string */
323 PERLVAR(Imulti_close
, I32
) /* delimiter of said string */
325 PERLVAR(Ierror_count
, I32
) /* how many errors so far, max 10 */
326 PERLVAR(Isubline
, I32
) /* line this subroutine began on */
327 PERLVAR(Isubname
, SV
*) /* name of current subroutine */
329 PERLVAR(Imin_intro_pending
, I32
) /* start of vars to introduce */
330 PERLVAR(Imax_intro_pending
, I32
) /* end of vars to introduce */
331 PERLVAR(Ipadix
, I32
) /* max used index in current "register" pad */
332 PERLVAR(Ipadix_floor
, I32
) /* how low may inner block reset padix */
333 PERLVAR(Ipad_reset_pending
, I32
) /* reset pad on next attempted alloc */
335 PERLVAR(Ilast_uni
, char *) /* position of last named-unary op */
336 PERLVAR(Ilast_lop
, char *) /* position of last list operator */
337 PERLVAR(Ilast_lop_op
, OPCODE
) /* last list operator */
338 PERLVAR(Iin_my
, I32
) /* we're compiling a "my" (or "our") declaration */
339 PERLVAR(Iin_my_stash
, HV
*) /* declared class of this "my" declaration */
341 PERLVAR(Icryptseen
, bool) /* has fast crypt() been initialized? */
344 PERLVAR(Ihints
, U32
) /* pragma-tic compile-time flags */
346 PERLVAR(Idebug
, VOL U32
) /* flags given to -D switch */
348 PERLVAR(Iamagic_generation
, long)
350 #ifdef USE_LOCALE_COLLATE
351 PERLVAR(Icollation_ix
, U32
) /* Collation generation index */
352 PERLVAR(Icollation_name
,char *) /* Name of current collation */
353 PERLVARI(Icollation_standard
, bool, TRUE
)
354 /* Assume simple collation */
355 PERLVAR(Icollxfrm_base
, Size_t
) /* Basic overhead in *xfrm() */
356 PERLVARI(Icollxfrm_mult
,Size_t
, 2) /* Expansion factor in *xfrm() */
357 #endif /* USE_LOCALE_COLLATE */
359 #ifdef USE_LOCALE_NUMERIC
361 PERLVAR(Inumeric_name
, char *) /* Name of current numeric locale */
362 PERLVARI(Inumeric_standard
, bool, TRUE
)
363 /* Assume simple numerics */
364 PERLVARI(Inumeric_local
, bool, TRUE
)
365 /* Assume local numerics */
366 PERLVAR(Idummy1_bincompat
, char)
367 /* Used to be numeric_radix */
369 #endif /* !USE_LOCALE_NUMERIC */
371 /* utf8 character classes */
372 PERLVAR(Iutf8_alnum
, SV
*)
373 PERLVAR(Iutf8_alnumc
, SV
*)
374 PERLVAR(Iutf8_ascii
, SV
*)
375 PERLVAR(Iutf8_alpha
, SV
*)
376 PERLVAR(Iutf8_space
, SV
*)
377 PERLVAR(Iutf8_cntrl
, SV
*)
378 PERLVAR(Iutf8_graph
, SV
*)
379 PERLVAR(Iutf8_digit
, SV
*)
380 PERLVAR(Iutf8_upper
, SV
*)
381 PERLVAR(Iutf8_lower
, SV
*)
382 PERLVAR(Iutf8_print
, SV
*)
383 PERLVAR(Iutf8_punct
, SV
*)
384 PERLVAR(Iutf8_xdigit
, SV
*)
385 PERLVAR(Iutf8_mark
, SV
*)
386 PERLVAR(Iutf8_toupper
, SV
*)
387 PERLVAR(Iutf8_totitle
, SV
*)
388 PERLVAR(Iutf8_tolower
, SV
*)
389 PERLVAR(Ilast_swash_hv
, HV
*)
390 PERLVAR(Ilast_swash_klen
, U32
)
391 PERLVARA(Ilast_swash_key
,10, U8
)
392 PERLVAR(Ilast_swash_tmps
, U8
*)
393 PERLVAR(Ilast_swash_slen
, STRLEN
)
395 /* perly.c globals */
396 PERLVAR(Iyydebug
, int)
397 PERLVAR(Iyynerrs
, int)
398 PERLVAR(Iyyerrflag
, int)
399 PERLVAR(Iyychar
, int)
400 PERLVAR(Iyyval
, YYSTYPE
)
401 PERLVAR(Iyylval
, YYSTYPE
)
403 PERLVAR(Iglob_index
, int)
404 PERLVAR(Isrand_called
, bool)
405 PERLVARA(Iuudmap
,256, char)
406 PERLVAR(Ibitcount
, char *)
409 PERLVAR(Isv_mutex
, perl_mutex
) /* Mutex for allocating SVs in sv.c */
410 PERLVAR(Ieval_mutex
, perl_mutex
) /* Mutex for doeval */
411 PERLVAR(Ieval_cond
, perl_cond
) /* Condition variable for doeval */
412 PERLVAR(Ieval_owner
, struct perl_thread
*)
413 /* Owner thread for doeval */
414 PERLVAR(Inthreads
, int) /* Number of threads currently */
415 PERLVAR(Ithreads_mutex
, perl_mutex
) /* Mutex for nthreads and thread list */
416 PERLVAR(Inthreads_cond
, perl_cond
) /* Condition variable for nthreads */
417 PERLVAR(Isvref_mutex
, perl_mutex
) /* Mutex for SvREFCNT_{inc,dec} */
418 PERLVARI(Ithreadsv_names
,char *, THREADSV_NAMES
)
420 PERLVAR(Icurthr
, struct perl_thread
*)
421 /* Currently executing (fake) thread */
424 PERLVAR(Icred_mutex
, perl_mutex
) /* altered credentials in effect */
426 #endif /* USE_THREADS */
428 PERLVAR(Ipsig_ptr
, SV
**)
429 PERLVAR(Ipsig_name
, SV
**)
431 #if defined(PERL_IMPLICIT_SYS)
432 PERLVAR(IMem
, struct IPerlMem
*)
433 PERLVAR(IMemShared
, struct IPerlMem
*)
434 PERLVAR(IMemParse
, struct IPerlMem
*)
435 PERLVAR(IEnv
, struct IPerlEnv
*)
436 PERLVAR(IStdIO
, struct IPerlStdIO
*)
437 PERLVAR(ILIO
, struct IPerlLIO
*)
438 PERLVAR(IDir
, struct IPerlDir
*)
439 PERLVAR(ISock
, struct IPerlSock
*)
440 PERLVAR(IProc
, struct IPerlProc
*)
443 #if defined(USE_ITHREADS)
444 PERLVAR(Iptr_table
, PTR_TBL_t
*)
446 PERLVARI(Ibeginav_save
, AV
*, Nullav
) /* save BEGIN{}s when compiling */
449 PERLVAR(Ifdpid_mutex
, perl_mutex
) /* mutex for fdpid array */
450 PERLVAR(Isv_lock_mutex
, perl_mutex
) /* mutex for SvLOCK macro */
453 PERLVAR(Inullstash
, HV
*) /* illegal symbols end up here */
455 PERLVAR(Ixnv_arenaroot
, XPV
*) /* list of allocated xnv areas */
456 PERLVAR(Ixrv_arenaroot
, XPV
*) /* list of allocated xrv areas */
457 PERLVAR(Ixpv_arenaroot
, XPV
*) /* list of allocated xpv areas */
458 PERLVAR(Ixpviv_arenaroot
,XPVIV
*) /* list of allocated xpviv areas */
459 PERLVAR(Ixpvnv_arenaroot
,XPVNV
*) /* list of allocated xpvnv areas */
460 PERLVAR(Ixpvcv_arenaroot
,XPVCV
*) /* list of allocated xpvcv areas */
461 PERLVAR(Ixpvav_arenaroot
,XPVAV
*) /* list of allocated xpvav areas */
462 PERLVAR(Ixpvhv_arenaroot
,XPVHV
*) /* list of allocated xpvhv areas */
463 PERLVAR(Ixpvmg_arenaroot
,XPVMG
*) /* list of allocated xpvmg areas */
464 PERLVAR(Ixpvlv_arenaroot
,XPVLV
*) /* list of allocated xpvlv areas */
465 PERLVAR(Ixpvbm_arenaroot
,XPVBM
*) /* list of allocated xpvbm areas */
466 PERLVAR(Ihe_arenaroot
, XPV
*) /* list of allocated he areas */
468 #ifdef USE_LOCALE_NUMERIC
470 PERLVAR(Inumeric_radix_sv
, SV
*) /* The radix separator if not '.' */
473 /* New variables must be added to the very end for binary compatibility.
474 * XSUB.h provides wrapper functions via perlapi.h that make this
475 * irrelevant, but not all code may be expected to #include XSUB.h. */