This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Pod::Text.pm reformating indented paragraphs
[perl5.git] / perlvars.h
CommitLineData
49f531da
NIS
1/****************/
2/* Truly global */
3/****************/
4
cb68f92d
GS
5/* Don't forget to re-run embed.pl to propagate changes! */
6
7/* This file describes the "global" variables used by perl
8 * This used to be in perl.h directly but we want to abstract out into
9 * distinct files which are per-thread, per-interpreter or really global,
10 * and how they're initialized.
11 *
12 * The 'G' prefix is only needed for vars that need appropriate #defines
22c35a8c 13 * generated in embed*.h. Such symbols are also used to generate
cb68f92d
GS
14 * the appropriate export list for win32.
15 *
16 * Avoid build-specific #ifdefs here, like DEBUGGING. That way,
17 * we can keep binary compatibility of the curinterp structure */
18
19
49f531da 20/* global state */
cb68f92d
GS
21PERLVAR(Gcurinterp, PerlInterpreter *)
22 /* currently running interpreter */
49f531da 23#ifdef USE_THREADS
cb68f92d
GS
24PERLVAR(Gthr_key, perl_key) /* For per-thread struct perl_thread* */
25PERLVAR(Gsv_mutex, perl_mutex) /* Mutex for allocating SVs in sv.c */
26PERLVAR(Gmalloc_mutex, perl_mutex) /* Mutex for malloc */
27PERLVAR(Geval_mutex, perl_mutex) /* Mutex for doeval */
28PERLVAR(Geval_cond, perl_cond) /* Condition variable for doeval */
29PERLVAR(Geval_owner, struct perl_thread *)
30 /* Owner thread for doeval */
22239a37 31PERLVAR(Gnthreads, int) /* Number of threads currently */
cb68f92d
GS
32PERLVAR(Gthreads_mutex, perl_mutex) /* Mutex for nthreads and thread list */
33PERLVAR(Gnthreads_cond, perl_cond) /* Condition variable for nthreads */
34PERLVAR(Gsvref_mutex, perl_mutex) /* Mutex for SvREFCNT_{inc,dec} */
35PERLVARI(Gthreadsv_names,char *, THREADSV_NAMES)
49f531da 36#ifdef FAKE_THREADS
cb68f92d
GS
37PERLVAR(Gcurthr, struct perl_thread *)
38 /* Currently executing (fake) thread */
49f531da 39#endif
5ff3f7a4
GS
40
41PERLVAR(Gcred_mutex, perl_mutex) /* altered credentials in effect */
42
49f531da
NIS
43#endif /* USE_THREADS */
44
cb68f92d
GS
45PERLVAR(Gninterps, int) /* number of active interpreters */
46
47PERLVAR(Guid, int) /* current real user id */
48PERLVAR(Geuid, int) /* current effective user id */
49PERLVAR(Ggid, int) /* current real group id */
50PERLVAR(Gegid, int) /* current effective group id */
22239a37 51PERLVAR(Gnomemok, bool) /* let malloc context handle nomem */
cb68f92d 52PERLVAR(Gan, U32) /* malloc sequence number */
22239a37
NIS
53PERLVAR(Gcop_seqmax, U32) /* statement sequence number */
54PERLVAR(Gop_seqmax, U16) /* op sequence number */
55PERLVAR(Gevalseq, U32) /* eval sequence number */
cb68f92d
GS
56PERLVAR(Gorigenviron, char **)
57PERLVAR(Gorigalen, U32)
22239a37 58PERLVAR(Gpidstatus, HV *) /* pid-to-status mappings for waitpid */
cb68f92d 59PERLVARI(Gmaxo, int, MAXO) /* maximum number of ops */
22239a37 60PERLVAR(Gosname, char *) /* operating system */
cb68f92d
GS
61PERLVARI(Gsh_path, char *, SH_PATH)/* full path of shell */
62PERLVAR(Gsighandlerp, Sighandler_t)
22239a37
NIS
63
64PERLVAR(Gxiv_arenaroot, XPV*) /* list of allocated xiv areas */
ea7c11a3 65PERLVAR(Gxiv_root, IV *) /* free xiv list--shared by interpreters */
cb68f92d 66PERLVAR(Gxnv_root, double *) /* free xnv list--shared by interpreters */
22239a37
NIS
67PERLVAR(Gxrv_root, XRV *) /* free xrv list--shared by interpreters */
68PERLVAR(Gxpv_root, XPV *) /* free xpv list--shared by interpreters */
69PERLVAR(Ghe_root, HE *) /* free he list--shared by interpreters */
70PERLVAR(Gnice_chunk, char *) /* a nice chunk of memory to reuse */
cb68f92d 71PERLVAR(Gnice_chunk_size, U32) /* how nice the chunk of memory is */
22239a37 72
cb68f92d 73PERLVARI(Grunops, runops_proc_t, FUNC_NAME_TO_PTR(RUNOPS_DEFAULT))
22239a37 74
cb68f92d 75PERLVAR(Gtokenbuf[256], char)
22239a37 76
cb68f92d
GS
77PERLVAR(Gsv_undef, SV)
78PERLVAR(Gsv_no, SV)
79PERLVAR(Gsv_yes, SV)
49f531da 80#ifdef CSH
cb68f92d
GS
81PERLVARI(Gcshname, char *, CSH)
82PERLVAR(Gcshlen, I32)
49f531da
NIS
83#endif
84
22239a37
NIS
85PERLVAR(Glex_state, U32) /* next token is determined */
86PERLVAR(Glex_defer, U32) /* state after determined token */
cb68f92d 87PERLVAR(Glex_expect, expectation) /* expect after determined token */
22239a37
NIS
88PERLVAR(Glex_brackets, I32) /* bracket count */
89PERLVAR(Glex_formbrack, I32) /* bracket count at outer format level */
90PERLVAR(Glex_fakebrack, I32) /* outer bracket is mere delimiter */
91PERLVAR(Glex_casemods, I32) /* casemod count */
92PERLVAR(Glex_dojoin, I32) /* doing an array interpolation */
93PERLVAR(Glex_starts, I32) /* how many interps done on level */
94PERLVAR(Glex_stuff, SV *) /* runtime pattern from m// or s/// */
95PERLVAR(Glex_repl, SV *) /* runtime replacement from s/// */
96PERLVAR(Glex_op, OP *) /* extra info to pass back on op */
97PERLVAR(Glex_inpat, OP *) /* in pattern $) and $| are special */
98PERLVAR(Glex_inwhat, I32) /* what kind of quoting are we in */
cb68f92d 99PERLVAR(Glex_brackstack,char *) /* what kind of brackets to pop */
22239a37 100PERLVAR(Glex_casestack, char *) /* what kind of case mods in effect */
49f531da
NIS
101
102/* What we know when we're in LEX_KNOWNEXT state. */
cb68f92d 103PERLVAR(Gnextval[5], YYSTYPE) /* value of next token, if any */
22239a37 104PERLVAR(Gnexttype[5], I32) /* type of next token */
cb68f92d 105PERLVAR(Gnexttoke, I32)
22239a37 106
cb68f92d
GS
107PERLVAR(Glinestr, SV *)
108PERLVAR(Gbufptr, char *)
109PERLVAR(Goldbufptr, char *)
110PERLVAR(Goldoldbufptr, char *)
111PERLVAR(Gbufend, char *)
112PERLVARI(Gexpect,expectation, XSTATE) /* how to interpret ambiguous tokens */
22239a37
NIS
113
114PERLVAR(Gmulti_start, I32) /* 1st line of multi-line string */
115PERLVAR(Gmulti_end, I32) /* last line of multi-line string */
116PERLVAR(Gmulti_open, I32) /* delimiter of said string */
117PERLVAR(Gmulti_close, I32) /* delimiter of said string */
118
22239a37
NIS
119PERLVAR(Gerror_count, I32) /* how many errors so far, max 10 */
120PERLVAR(Gsubline, I32) /* line this subroutine began on */
121PERLVAR(Gsubname, SV *) /* name of current subroutine */
122
cb68f92d
GS
123PERLVAR(Gmin_intro_pending, I32) /* start of vars to introduce */
124PERLVAR(Gmax_intro_pending, I32) /* end of vars to introduce */
125PERLVAR(Gpadix, I32) /* max used index in current "register" pad */
22239a37 126PERLVAR(Gpadix_floor, I32) /* how low may inner block reset padix */
cb68f92d 127PERLVAR(Gpad_reset_pending, I32) /* reset pad on next attempted alloc */
22239a37
NIS
128
129PERLVAR(Gthisexpr, I32) /* name id for nothing_in_common() */
cb68f92d 130PERLVAR(Glast_uni, char *) /* position of last named-unary op */
22239a37
NIS
131PERLVAR(Glast_lop, char *) /* position of last list operator */
132PERLVAR(Glast_lop_op, OPCODE) /* last list operator */
cb68f92d 133PERLVAR(Gin_my, bool) /* we're compiling a "my" declaration */
22239a37 134PERLVAR(Gin_my_stash, HV *) /* declared class of this "my" declaration */
49f531da 135#ifdef FCRYPT
22239a37 136PERLVAR(Gcryptseen, I32) /* has fast crypt() been initialized? */
49f531da
NIS
137#endif
138
cb68f92d 139PERLVAR(Ghints, U32) /* pragma-tic compile-time flags */
49f531da 140
22239a37 141PERLVAR(Gdo_undump, bool) /* -u or dump seen? */
cb68f92d 142PERLVAR(Gdebug, VOL U32) /* flags given to -D switch */
49f531da
NIS
143
144
145#ifdef OVERLOAD
146
cb68f92d 147PERLVAR(Gamagic_generation, long)
49f531da
NIS
148
149#endif
150
151#ifdef USE_LOCALE_COLLATE
22239a37 152PERLVAR(Gcollation_ix, U32) /* Collation generation index */
cb68f92d
GS
153PERLVAR(Gcollation_name,char *) /* Name of current collation */
154PERLVARI(Gcollation_standard, bool, TRUE)
155 /* Assume simple collation */
22239a37 156PERLVAR(Gcollxfrm_base, Size_t) /* Basic overhead in *xfrm() */
cb68f92d 157PERLVARI(Gcollxfrm_mult,Size_t, 2) /* Expansion factor in *xfrm() */
49f531da
NIS
158#endif /* USE_LOCALE_COLLATE */
159
160#ifdef USE_LOCALE_NUMERIC
161
22239a37 162PERLVAR(Gnumeric_name, char *) /* Name of current numeric locale */
cb68f92d
GS
163PERLVARI(Gnumeric_standard, bool, TRUE)
164 /* Assume simple numerics */
165PERLVARI(Gnumeric_local, bool, TRUE)
166 /* Assume local numerics */
49f531da
NIS
167
168#endif /* !USE_LOCALE_NUMERIC */
169
a0ed51b3 170/* utf8 character classes */
d3b6f988
GS
171PERLVAR(Gutf8_alnum, SV *)
172PERLVAR(Gutf8_alpha, SV *)
173PERLVAR(Gutf8_space, SV *)
174PERLVAR(Gutf8_digit, SV *)
175PERLVAR(Gutf8_upper, SV *)
176PERLVAR(Gutf8_lower, SV *)
177PERLVAR(Gutf8_print, SV *)
178PERLVAR(Gutf8_mark, SV *)
179PERLVAR(Gutf8_toupper, SV *)
180PERLVAR(Gutf8_totitle, SV *)
181PERLVAR(Gutf8_tolower, SV *)
182PERLVAR(Glast_swash_hv, HV *)
183PERLVAR(Glast_swash_klen, U32)
184PERLVAR(Glast_swash_key[10], U8)
185PERLVAR(Glast_swash_tmps, U8 *)
186PERLVAR(Glast_swash_slen, STRLEN)
a0ed51b3 187
3fe35a81 188/* constants (these are not literals to facilitate pointer comparisons) */
3fe6f2dc
MB
189PERLVARIC(GYes, char *, "1")
190PERLVARIC(GNo, char *, "")
e3fdf988 191PERLVARIC(Ghexdigit, char *, "0123456789abcdef0123456789ABCDEF")
3fe6f2dc 192PERLVARIC(Gpatleave, char *, "\\.^$@dDwWsSbB+*?|()-nrtfeaxc0123456789[{]}")
3fe35a81 193
cb68f92d 194PERLVAR(Gspecialsv_list[4],SV *) /* from byterun.h */
e2d46a1d 195
d3b6f988
GS
196/* perly.c globals */
197PERLVAR(Gyydebug, int)
198PERLVAR(Gyynerrs, int)
199PERLVAR(Gyyerrflag, int)
200PERLVAR(Gyychar, int)
d3b6f988
GS
201PERLVAR(Gyyval, YYSTYPE)
202PERLVAR(Gyylval, YYSTYPE)