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