This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Avoid wrapping long lines when displaying as man page
[perl5.git] / perl.h
1 /*    perl.h
2  *
3  *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001
4  *    2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
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 #ifndef H_PERL
12 #define H_PERL 1
13
14 #ifdef PERL_FOR_X2P
15 /*
16  * This file is being used for x2p stuff.
17  * Above symbol is defined via -D in 'x2p/Makefile.SH'
18  * Decouple x2p stuff from some of perls more extreme eccentricities.
19  */
20 #undef MULTIPLICITY
21 #undef USE_STDIO
22 #define USE_STDIO
23 #endif /* PERL_FOR_X2P */
24
25 #if defined(DGUX)
26 #include <sys/fcntl.h>
27 #endif
28
29 #ifdef VOIDUSED
30 #   undef VOIDUSED
31 #endif 
32 #define VOIDUSED 1
33
34 #ifdef PERL_MICRO
35 #   include "uconfig.h"
36 #else
37 #   ifndef USE_CROSS_COMPILE
38 #       include "config.h"
39 #   else
40 #       include "xconfig.h"
41 #   endif
42 #endif
43
44 /* This logic needs to come after reading config.h, but before including
45    proto.h  */
46 #ifdef IAMSUID
47 #  ifndef DOSUID
48 #    define DOSUID
49 #  endif
50 #endif
51
52 #ifdef SETUID_SCRIPTS_ARE_SECURE_NOW
53 #  ifdef DOSUID
54 #    undef DOSUID
55 #  endif
56 #  ifdef IAMSUID
57 #    undef IAMSUID
58 #    define SETUID_SCRIPTS_ARE_SECURE_NOW_AND_IAMSUID
59 #  endif
60 #endif
61
62 /* See L<perlguts/"The Perl API"> for detailed notes on
63  * PERL_IMPLICIT_CONTEXT and PERL_IMPLICIT_SYS */
64
65 /* Note that from here --> to <-- the same logic is
66  * repeated in makedef.pl, so be certain to update
67  * both places when editing. */
68
69 #ifdef PERL_IMPLICIT_SYS
70 /* PERL_IMPLICIT_SYS implies PerlMemShared != PerlMem
71    so use slab allocator to avoid lots of MUTEX overhead
72  */
73 #  ifndef PL_OP_SLAB_ALLOC
74 #    define PL_OP_SLAB_ALLOC
75 #  endif
76 #endif
77
78 #ifdef USE_ITHREADS
79 #  if !defined(MULTIPLICITY)
80 #    define MULTIPLICITY
81 #  endif
82 #endif
83
84 #ifdef PERL_GLOBAL_STRUCT_PRIVATE
85 #  ifndef PERL_GLOBAL_STRUCT
86 #    define PERL_GLOBAL_STRUCT
87 #  endif
88 #endif
89
90 #ifdef PERL_GLOBAL_STRUCT
91 #  ifndef MULTIPLICITY
92 #    define MULTIPLICITY
93 #  endif
94 #endif
95
96 #ifdef MULTIPLICITY
97 #  ifndef PERL_IMPLICIT_CONTEXT
98 #    define PERL_IMPLICIT_CONTEXT
99 #  endif
100 #endif
101
102 /* undef WIN32 when building on Cygwin (for libwin32) - gph */
103 #ifdef __CYGWIN__
104 #   undef WIN32
105 #   undef _WIN32
106 #endif
107
108 #if defined(__SYMBIAN32__) || (defined(__VC32__) && defined(WINS))
109 #   ifndef SYMBIAN
110 #       define SYMBIAN
111 #   endif
112 #endif
113
114 #ifdef __SYMBIAN32__
115 #  include "symbian/symbian_proto.h"
116 #endif
117
118 /* Any stack-challenged places.  The limit varies (and often
119  * is configurable), but using more than a kilobyte of stack
120  * is usually dubious in these systems. */
121 #if defined(EPOC) || defined(__SYMBIAN32__)
122 /* EPOC/Symbian: need to work around the SDK features. *
123  * On WINS: MS VC5 generates calls to _chkstk,         *
124  * if a "large" stack frame is allocated.              *
125  * gcc on MARM does not generate calls like these.     */
126 #   define USE_HEAP_INSTEAD_OF_STACK
127 #endif
128
129 #/* Use the reentrant APIs like localtime_r and getpwent_r */
130 /* Win32 has naturally threadsafe libraries, no need to use any _r variants. */
131 #if defined(USE_ITHREADS) && !defined(USE_REENTRANT_API) && !defined(NETWARE) && !defined(WIN32) && !defined(PERL_DARWIN)
132 #   define USE_REENTRANT_API
133 #endif
134
135 /* <--- here ends the logic shared by perl.h and makedef.pl */
136
137 /*
138  * PERL_DARWIN for MacOSX (__APPLE__ exists but is not officially sanctioned)
139  * (The -DPERL_DARWIN comes from the hints/darwin.sh.)
140  * __bsdi__ for BSD/OS
141  */
142 #if defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) || defined(PERL_DARWIN) || defined(__bsdi__) || defined(BSD41) || defined(BSD42) || defined(BSD43) || defined(BSD44)
143 #   ifndef BSDish
144 #       define BSDish
145 #   endif
146 #endif
147
148 #ifdef PERL_GLOBAL_STRUCT
149 #  ifndef PERL_GET_VARS
150 #    ifdef PERL_GLOBAL_STRUCT_PRIVATE
151        extern struct perl_vars* Perl_GetVarsPrivate();
152 #      define PERL_GET_VARS() Perl_GetVarsPrivate() /* see miniperlmain.c */
153 #      ifndef PERLIO_FUNCS_CONST
154 #        define PERLIO_FUNCS_CONST /* Can't have these lying around. */
155 #      endif
156 #    else
157 #      define PERL_GET_VARS() PL_VarsPtr
158 #    endif
159 #  endif
160 #endif
161
162 #define pVAR    register struct perl_vars* my_vars PERL_UNUSED_DECL
163
164 #ifdef PERL_GLOBAL_STRUCT
165 #  define dVAR          pVAR    = (struct perl_vars*)PERL_GET_VARS()
166 #else
167 #  define dVAR          dNOOP
168 #endif
169
170 #ifdef PERL_IMPLICIT_CONTEXT
171 #  ifndef MULTIPLICITY
172 #    define MULTIPLICITY
173 #  endif
174 #  define tTHX  PerlInterpreter*
175 #  define pTHX  register tTHX my_perl PERL_UNUSED_DECL
176 #  define aTHX  my_perl
177 #  ifdef PERL_GLOBAL_STRUCT
178 #    define dTHXa(a)    dVAR; pTHX = (tTHX)a
179 #  else
180 #    define dTHXa(a)    pTHX = (tTHX)a
181 #  endif
182 #  ifdef PERL_GLOBAL_STRUCT
183 #    define dTHX                dVAR; pTHX = PERL_GET_THX
184 #  else
185 #    define dTHX                pTHX = PERL_GET_THX
186 #  endif
187 #  define pTHX_         pTHX,
188 #  define aTHX_         aTHX,
189 #  define pTHX_1        2
190 #  define pTHX_2        3
191 #  define pTHX_3        4
192 #  define pTHX_4        5
193 #  define pTHX_5        6
194 #  define pTHX_6        7
195 #  define pTHX_7        8
196 #  define pTHX_8        9
197 #  define pTHX_9        10
198 #  if defined(DEBUGGING) && !defined(PERL_TRACK_MEMPOOL)
199 #    define PERL_TRACK_MEMPOOL
200 #  endif
201 #else
202 #  undef PERL_TRACK_MEMPOOL
203 #endif
204
205 #define STATIC static
206 #define CPERLscope(x) x
207 #define CPERLarg void
208 #define CPERLarg_
209 #define _CPERLarg
210 #define PERL_OBJECT_THIS
211 #define _PERL_OBJECT_THIS
212 #define PERL_OBJECT_THIS_
213 #define CALL_FPTR(fptr) (*fptr)
214
215 #define CALLRUNOPS  CALL_FPTR(PL_runops)
216
217 #define CALLREGCOMP(sv, flags) Perl_pregcomp(aTHX_ (sv),(flags))
218
219 #define CALLREGCOMP_ENG(prog, sv, flags) \
220     CALL_FPTR(((prog)->comp))(aTHX_ sv, flags)
221 #define CALLREGEXEC(prog,stringarg,strend,strbeg,minend,screamer,data,flags) \
222     CALL_FPTR(RX_ENGINE(prog)->exec)(aTHX_ (prog),(stringarg),(strend), \
223         (strbeg),(minend),(screamer),(data),(flags))
224 #define CALLREG_INTUIT_START(prog,sv,strpos,strend,flags,data) \
225     CALL_FPTR(RX_ENGINE(prog)->intuit)(aTHX_ (prog), (sv), (strpos), \
226         (strend),(flags),(data))
227 #define CALLREG_INTUIT_STRING(prog) \
228     CALL_FPTR(RX_ENGINE(prog)->checkstr)(aTHX_ (prog))
229
230 #define CALLREGFREE(prog) \
231     Perl_pregfree(aTHX_ (prog))
232
233 #define CALLREGFREE_PVT(prog) \
234     if(prog) CALL_FPTR(RX_ENGINE(prog)->free)(aTHX_ (prog))
235
236 #define CALLREG_NUMBUF_FETCH(rx,paren,usesv)                                \
237     CALL_FPTR(RX_ENGINE(rx)->numbered_buff_FETCH)(aTHX_ (rx),(paren),(usesv))
238
239 #define CALLREG_NUMBUF_STORE(rx,paren,value) \
240     CALL_FPTR(RX_ENGINE(rx)->numbered_buff_STORE)(aTHX_ (rx),(paren),(value))
241
242 #define CALLREG_NUMBUF_LENGTH(rx,sv,paren)                              \
243     CALL_FPTR(RX_ENGINE(rx)->numbered_buff_LENGTH)(aTHX_ (rx),(sv),(paren))
244
245 #define CALLREG_NAMED_BUFF_FETCH(rx, key, flags) \
246     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), (key), NULL, ((flags) | RXapif_FETCH))
247
248 #define CALLREG_NAMED_BUFF_STORE(rx, key, value, flags) \
249     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), (key), (value), ((flags) | RXapif_STORE))
250
251 #define CALLREG_NAMED_BUFF_DELETE(rx, key, flags) \
252     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx),(key), NULL, ((flags) | RXapif_DELETE))
253
254 #define CALLREG_NAMED_BUFF_CLEAR(rx, flags) \
255     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), NULL, NULL, ((flags) | RXapif_CLEAR))
256
257 #define CALLREG_NAMED_BUFF_EXISTS(rx, key, flags) \
258     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), (key), NULL, ((flags) | RXapif_EXISTS))
259
260 #define CALLREG_NAMED_BUFF_FIRSTKEY(rx, flags) \
261     CALL_FPTR(RX_ENGINE(rx)->named_buff_iter)(aTHX_ (rx), NULL, ((flags) | RXapif_FIRSTKEY))
262
263 #define CALLREG_NAMED_BUFF_NEXTKEY(rx, lastkey, flags) \
264     CALL_FPTR(RX_ENGINE(rx)->named_buff_iter)(aTHX_ (rx), (lastkey), ((flags) | RXapif_NEXTKEY))
265
266 #define CALLREG_NAMED_BUFF_SCALAR(rx, flags) \
267     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), NULL, NULL, ((flags) | RXapif_SCALAR))
268
269 #define CALLREG_NAMED_BUFF_COUNT(rx) \
270     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), NULL, NULL, RXapif_REGNAMES_COUNT)
271
272 #define CALLREG_NAMED_BUFF_ALL(rx, flags) \
273     CALL_FPTR(RX_ENGINE(rx)->named_buff)(aTHX_ (rx), NULL, NULL, flags)
274
275 #define CALLREG_PACKAGE(rx) \
276     CALL_FPTR(RX_ENGINE(rx)->qr_package)(aTHX_ (rx))
277
278 #if defined(USE_ITHREADS)         
279 #define CALLREGDUPE(prog,param) \
280     Perl_re_dup(aTHX_ (prog),(param))
281
282 #define CALLREGDUPE_PVT(prog,param) \
283     (prog ? CALL_FPTR(RX_ENGINE(prog)->dupe)(aTHX_ (prog),(param)) \
284           : (REGEXP *)NULL) 
285 #endif
286
287
288
289
290
291 /*
292  * Because of backward compatibility reasons the PERL_UNUSED_DECL
293  * cannot be changed from postfix to PERL_UNUSED_DECL(x).  Sigh.
294  *
295  * Note that there are C compilers such as MetroWerks CodeWarrior
296  * which do not have an "inlined" way (like the gcc __attribute__) of
297  * marking unused variables (they need e.g. a #pragma) and therefore
298  * cpp macros like PERL_UNUSED_DECL cannot work for this purpose, even
299  * if it were PERL_UNUSED_DECL(x), which it cannot be (see above).
300  *
301  */
302
303 #if defined(__SYMBIAN32__) && defined(__GNUC__)
304 #  ifdef __cplusplus
305 #    define PERL_UNUSED_DECL
306 #  else
307 #    define PERL_UNUSED_DECL __attribute__((unused))
308 #  endif
309 #endif
310
311 #ifndef PERL_UNUSED_DECL
312 #  if defined(HASATTRIBUTE_UNUSED) && !defined(__cplusplus)
313 #    define PERL_UNUSED_DECL __attribute__unused__
314 #  else
315 #    define PERL_UNUSED_DECL
316 #  endif
317 #endif
318  
319 /* gcc -Wall:
320  * for silencing unused variables that are actually used most of the time,
321  * but we cannot quite get rid of, such as "ax" in PPCODE+noargs xsubs
322  */
323 #ifndef PERL_UNUSED_ARG
324 #  if defined(lint) && defined(S_SPLINT_S) /* www.splint.org */
325 #    include <note.h>
326 #    define PERL_UNUSED_ARG(x) NOTE(ARGUNUSED(x))
327 #  else
328 #    define PERL_UNUSED_ARG(x) ((void)x)
329 #  endif
330 #endif
331 #ifndef PERL_UNUSED_VAR
332 #  define PERL_UNUSED_VAR(x) ((void)x)
333 #endif
334
335 #ifdef USE_ITHREADS
336 #  define PERL_UNUSED_CONTEXT PERL_UNUSED_ARG(my_perl)
337 #else
338 #  define PERL_UNUSED_CONTEXT
339 #endif
340
341 #define NOOP /*EMPTY*/(void)0
342 #if !defined(HASATTRIBUTE_UNUSED) && defined(__cplusplus)
343 #define dNOOP /*EMPTY*/(void)0 /* Older g++ has no __attribute((unused))__ */
344 #else
345 #define dNOOP extern int /*@unused@*/ Perl___notused PERL_UNUSED_DECL
346 #endif
347
348 #ifndef pTHX
349 /* Don't bother defining tTHX and sTHX; using them outside
350  * code guarded by PERL_IMPLICIT_CONTEXT is an error.
351  */
352 #  define pTHX          void
353 #  define pTHX_
354 #  define aTHX
355 #  define aTHX_
356 #  define dTHXa(a)      dNOOP
357 #  define dTHX          dNOOP
358 #  define pTHX_1        1       
359 #  define pTHX_2        2
360 #  define pTHX_3        3
361 #  define pTHX_4        4
362 #  define pTHX_5        5
363 #  define pTHX_6        6
364 #  define pTHX_7        7
365 #  define pTHX_8        8
366 #  define pTHX_9        9
367 #endif
368
369 #ifndef dVAR
370 #  define dVAR          dNOOP
371 #endif
372
373 /* these are only defined for compatibility; should not be used internally */
374 #if !defined(pTHXo) && !defined(PERL_CORE)
375 #  define pTHXo         pTHX
376 #  define pTHXo_        pTHX_
377 #  define aTHXo         aTHX
378 #  define aTHXo_        aTHX_
379 #  define dTHXo         dTHX
380 #  define dTHXoa(x)     dTHXa(x)
381 #endif
382
383 #ifndef pTHXx
384 #  define pTHXx         register PerlInterpreter *my_perl
385 #  define pTHXx_        pTHXx,
386 #  define aTHXx         my_perl
387 #  define aTHXx_        aTHXx,
388 #  define dTHXx         dTHX
389 #endif
390
391 /* Under PERL_IMPLICIT_SYS (used in Windows for fork emulation)
392  * PerlIO_foo() expands to PL_StdIO->pFOO(PL_StdIO, ...).
393  * dTHXs is therefore needed for all functions using PerlIO_foo(). */
394 #ifdef PERL_IMPLICIT_SYS
395 #  ifdef PERL_GLOBAL_STRUCT_PRIVATE
396 #    define dTHXs               dVAR; dTHX
397 #  else
398 #    define dTHXs               dTHX
399 #  endif
400 #else
401 #  ifdef PERL_GLOBAL_STRUCT_PRIVATE
402 #    define dTHXs               dVAR
403 #  else
404 #    define dTHXs               dNOOP
405 #  endif
406 #endif
407
408 #undef START_EXTERN_C
409 #undef END_EXTERN_C
410 #undef EXTERN_C
411 #ifdef __cplusplus
412 #  define START_EXTERN_C extern "C" {
413 #  define END_EXTERN_C }
414 #  define EXTERN_C extern "C"
415 #else
416 #  define START_EXTERN_C
417 #  define END_EXTERN_C
418 #  define EXTERN_C extern
419 #endif
420
421 /* Some platforms require marking function declarations
422  * for them to be exportable.  Used in perlio.h, proto.h
423  * is handled either by the makedef.pl or by defining the
424  * PERL_CALLCONV to be something special.  See also the
425  * definition of XS() in XSUB.h. */
426 #ifndef PERL_EXPORT_C
427 #  ifdef __cplusplus
428 #    define PERL_EXPORT_C extern "C"
429 #  else
430 #    define PERL_EXPORT_C extern
431 #  endif
432 #endif
433 #ifndef PERL_XS_EXPORT_C
434 #  ifdef __cplusplus
435 #    define PERL_XS_EXPORT_C extern "C"
436 #  else
437 #    define PERL_XS_EXPORT_C
438 #  endif
439 #endif
440
441 #ifdef OP_IN_REGISTER
442 #  ifdef __GNUC__
443 #    define stringify_immed(s) #s
444 #    define stringify(s) stringify_immed(s)
445 register struct op *Perl_op asm(stringify(OP_IN_REGISTER));
446 #  endif
447 #endif
448
449 /* gcc (-ansi) -pedantic doesn't allow gcc statement expressions,
450  * g++ allows them but seems to have problems with them
451  * (insane errors ensue).
452  * g++ does not give insane errors now (RMB 2008-01-30, gcc 4.2.2).
453  */
454 #if defined(PERL_GCC_PEDANTIC) || \
455     (defined(__GNUC__) && defined(__cplusplus) && \
456         ((__GNUC__ < 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ < 2))))
457 #  ifndef PERL_GCC_BRACE_GROUPS_FORBIDDEN
458 #    define PERL_GCC_BRACE_GROUPS_FORBIDDEN
459 #  endif
460 #endif
461
462 #if defined(__GNUC__) && !defined(PERL_GCC_BRACE_GROUPS_FORBIDDEN) && !defined(__cplusplus)
463 #  ifndef PERL_USE_GCC_BRACE_GROUPS
464 #    define PERL_USE_GCC_BRACE_GROUPS
465 #  endif
466 #endif
467
468 /*
469  * STMT_START { statements; } STMT_END;
470  * can be used as a single statement, as in
471  * if (x) STMT_START { ... } STMT_END; else ...
472  *
473  * Trying to select a version that gives no warnings...
474  */
475 #if !(defined(STMT_START) && defined(STMT_END))
476 # ifdef PERL_USE_GCC_BRACE_GROUPS
477 #   define STMT_START   (void)( /* gcc supports "({ STATEMENTS; })" */
478 #   define STMT_END     )
479 # else
480    /* Now which other defined()s do we need here ??? */
481 #  if (VOIDFLAGS) && (defined(sun) || defined(__sun__)) && !defined(__GNUC__)
482 #   define STMT_START   if (1)
483 #   define STMT_END     else (void)0
484 #  else
485 #   define STMT_START   do
486 #   define STMT_END     while (0)
487 #  endif
488 # endif
489 #endif
490
491 #define WITH_THX(s) STMT_START { dTHX; s; } STMT_END
492 #define WITH_THR(s) WITH_THX(s)
493
494 #ifndef BYTEORDER  /* Should never happen -- byteorder is in config.h */
495 #   define BYTEORDER 0x1234
496 #endif
497
498 /* Overall memory policy? */
499 #ifndef CONSERVATIVE
500 #   define LIBERAL 1
501 #endif
502
503 #if 'A' == 65 && 'I' == 73 && 'J' == 74 && 'Z' == 90
504 #define ASCIIish
505 #else
506 #undef  ASCIIish
507 #endif
508
509 /*
510  * The following contortions are brought to you on behalf of all the
511  * standards, semi-standards, de facto standards, not-so-de-facto standards
512  * of the world, as well as all the other botches anyone ever thought of.
513  * The basic theory is that if we work hard enough here, the rest of the
514  * code can be a lot prettier.  Well, so much for theory.  Sorry, Henry...
515  */
516
517 /* define this once if either system, instead of cluttering up the src */
518 #if defined(MSDOS) || defined(atarist) || defined(WIN32) || defined(NETWARE)
519 #define DOSISH 1
520 #endif
521
522 #if defined(__STDC__) || defined(_AIX) || defined(__stdc__) || defined(__cplusplus) || defined(EPOC) || defined(NETWARE) || defined(__SYMBIAN32__)
523 # define STANDARD_C 1
524 #endif
525
526 #if defined(__cplusplus) || defined(WIN32) || defined(__sgi) || defined(__EMX__) || defined(__DGUX) || defined(EPOC) || defined(__QNX__) || defined(NETWARE) || defined(PERL_MICRO)
527 # define DONT_DECLARE_STD 1
528 #endif
529
530 #if defined(HASVOLATILE) || defined(STANDARD_C)
531 #       define VOL volatile
532 #else
533 #   define VOL
534 #endif
535
536 #define TAINT           (PL_tainted = TRUE)
537 #define TAINT_NOT       (PL_tainted = FALSE)
538 #define TAINT_IF(c)     if (c) { PL_tainted = TRUE; }
539 #define TAINT_ENV()     if (PL_tainting) { taint_env(); }
540 #define TAINT_PROPER(s) if (PL_tainting) { taint_proper(NULL, s); }
541
542 /* XXX All process group stuff is handled in pp_sys.c.  Should these
543    defines move there?  If so, I could simplify this a lot. --AD  9/96.
544 */
545 /* Process group stuff changed from traditional BSD to POSIX.
546    perlfunc.pod documents the traditional BSD-style syntax, so we'll
547    try to preserve that, if possible.
548 */
549 #ifdef HAS_SETPGID
550 #  define BSD_SETPGRP(pid, pgrp)        setpgid((pid), (pgrp))
551 #else
552 #  if defined(HAS_SETPGRP) && defined(USE_BSD_SETPGRP)
553 #    define BSD_SETPGRP(pid, pgrp)      setpgrp((pid), (pgrp))
554 #  else
555 #    ifdef HAS_SETPGRP2  /* DG/UX */
556 #      define BSD_SETPGRP(pid, pgrp)    setpgrp2((pid), (pgrp))
557 #    endif
558 #  endif
559 #endif
560 #if defined(BSD_SETPGRP) && !defined(HAS_SETPGRP)
561 #  define HAS_SETPGRP  /* Well, effectively it does . . . */
562 #endif
563
564 /* getpgid isn't POSIX, but at least Solaris and Linux have it, and it makes
565     our life easier :-) so we'll try it.
566 */
567 #ifdef HAS_GETPGID
568 #  define BSD_GETPGRP(pid)              getpgid((pid))
569 #else
570 #  if defined(HAS_GETPGRP) && defined(USE_BSD_GETPGRP)
571 #    define BSD_GETPGRP(pid)            getpgrp((pid))
572 #  else
573 #    ifdef HAS_GETPGRP2  /* DG/UX */
574 #      define BSD_GETPGRP(pid)          getpgrp2((pid))
575 #    endif
576 #  endif
577 #endif
578 #if defined(BSD_GETPGRP) && !defined(HAS_GETPGRP)
579 #  define HAS_GETPGRP  /* Well, effectively it does . . . */
580 #endif
581
582 /* These are not exact synonyms, since setpgrp() and getpgrp() may
583    have different behaviors, but perl.h used to define USE_BSDPGRP
584    (prior to 5.003_05) so some extension might depend on it.
585 */
586 #if defined(USE_BSD_SETPGRP) || defined(USE_BSD_GETPGRP)
587 #  ifndef USE_BSDPGRP
588 #    define USE_BSDPGRP
589 #  endif
590 #endif
591
592 /* HP-UX 10.X CMA (Common Multithreaded Architecure) insists that
593    pthread.h must be included before all other header files.
594 */
595 #if defined(USE_ITHREADS) && defined(PTHREAD_H_FIRST) && defined(I_PTHREAD)
596 #  include <pthread.h>
597 #endif
598
599 #ifndef _TYPES_         /* If types.h defines this it's easy. */
600 #   ifndef major                /* Does everyone's types.h define this? */
601 #       include <sys/types.h>
602 #   endif
603 #endif
604
605 #ifdef __cplusplus
606 #  ifndef I_STDARG
607 #    define I_STDARG 1
608 #  endif
609 #endif
610
611 #ifdef I_STDARG
612 #  include <stdarg.h>
613 #else
614 #  ifdef I_VARARGS
615 #    include <varargs.h>
616 #  endif
617 #endif
618
619 #ifdef USE_NEXT_CTYPE
620
621 #if NX_CURRENT_COMPILER_RELEASE >= 500
622 #  include <bsd/ctypes.h>
623 #else
624 #  if NX_CURRENT_COMPILER_RELEASE >= 400
625 #    include <objc/NXCType.h>
626 #  else /*  NX_CURRENT_COMPILER_RELEASE < 400 */
627 #    include <appkit/NXCType.h>
628 #  endif /*  NX_CURRENT_COMPILER_RELEASE >= 400 */
629 #endif /*  NX_CURRENT_COMPILER_RELEASE >= 500 */
630
631 #else /* !USE_NEXT_CTYPE */
632 #include <ctype.h>
633 #endif /* USE_NEXT_CTYPE */
634
635 #ifdef METHOD   /* Defined by OSF/1 v3.0 by ctype.h */
636 #undef METHOD
637 #endif
638
639 #ifdef PERL_MICRO
640 #   define NO_LOCALE
641 #endif
642
643 #ifdef I_LOCALE
644 #   include <locale.h>
645 #endif
646
647 #if !defined(NO_LOCALE) && defined(HAS_SETLOCALE)
648 #   define USE_LOCALE
649 #   if !defined(NO_LOCALE_COLLATE) && defined(LC_COLLATE) \
650        && defined(HAS_STRXFRM)
651 #       define USE_LOCALE_COLLATE
652 #   endif
653 #   if !defined(NO_LOCALE_CTYPE) && defined(LC_CTYPE)
654 #       define USE_LOCALE_CTYPE
655 #   endif
656 #   if !defined(NO_LOCALE_NUMERIC) && defined(LC_NUMERIC)
657 #       define USE_LOCALE_NUMERIC
658 #   endif
659 #endif /* !NO_LOCALE && HAS_SETLOCALE */
660
661 #include <setjmp.h>
662
663 #ifdef I_SYS_PARAM
664 #   ifdef PARAM_NEEDS_TYPES
665 #       include <sys/types.h>
666 #   endif
667 #   include <sys/param.h>
668 #endif
669
670 /* Use all the "standard" definitions? */
671 #if defined(STANDARD_C) && defined(I_STDLIB)
672 #   include <stdlib.h>
673 #endif
674
675 /* If this causes problems, set i_unistd=undef in the hint file.  */
676 #ifdef I_UNISTD
677 #   include <unistd.h>
678 #endif
679
680 /* for WCOREDUMP */
681 #ifdef I_SYS_WAIT
682 #   include <sys/wait.h>
683 #endif
684
685 #ifdef __SYMBIAN32__
686 #   undef _SC_ARG_MAX /* Symbian has _SC_ARG_MAX but no sysconf() */
687 #endif
688
689 #if defined(HAS_SYSCALL) && !defined(HAS_SYSCALL_PROTO) && !defined(PERL_MICRO)
690 EXTERN_C int syscall(int, ...);
691 #endif
692
693 #if defined(HAS_USLEEP) && !defined(HAS_USLEEP_PROTO) && !defined(PERL_MICRO)
694 EXTERN_C int usleep(unsigned int);
695 #endif
696
697 /* Funky places that do not have socket stuff. */
698 #if defined(__LIBCATAMOUNT__)
699 #  define MYSWAP
700 #endif
701
702 #ifdef PERL_MICRO /* Last chance to export Perl_my_swap */
703 #  define MYSWAP
704 #endif
705
706 #ifdef PERL_CORE
707
708 /* macros for correct constant construction */
709 # if INTSIZE >= 2
710 #  define U16_CONST(x) ((U16)x##U)
711 # else
712 #  define U16_CONST(x) ((U16)x##UL)
713 # endif
714
715 # if INTSIZE >= 4
716 #  define U32_CONST(x) ((U32)x##U)
717 # else
718 #  define U32_CONST(x) ((U32)x##UL)
719 # endif
720
721 # ifdef HAS_QUAD
722 #  if INTSIZE >= 8
723 #   define U64_CONST(x) ((U64)x##U)
724 #  elif LONGSIZE >= 8
725 #   define U64_CONST(x) ((U64)x##UL)
726 #  elif QUADKIND == QUAD_IS_LONG_LONG
727 #   define U64_CONST(x) ((U64)x##ULL)
728 #  else /* best guess we can make */
729 #   define U64_CONST(x) ((U64)x##UL)
730 #  endif
731 # endif
732
733 /* byte-swapping functions for big-/little-endian conversion */
734 # define _swab_16_(x) ((U16)( \
735          (((U16)(x) & U16_CONST(0x00ff)) << 8) | \
736          (((U16)(x) & U16_CONST(0xff00)) >> 8) ))
737
738 # define _swab_32_(x) ((U32)( \
739          (((U32)(x) & U32_CONST(0x000000ff)) << 24) | \
740          (((U32)(x) & U32_CONST(0x0000ff00)) <<  8) | \
741          (((U32)(x) & U32_CONST(0x00ff0000)) >>  8) | \
742          (((U32)(x) & U32_CONST(0xff000000)) >> 24) ))
743
744 # ifdef HAS_QUAD
745 #  define _swab_64_(x) ((U64)( \
746           (((U64)(x) & U64_CONST(0x00000000000000ff)) << 56) | \
747           (((U64)(x) & U64_CONST(0x000000000000ff00)) << 40) | \
748           (((U64)(x) & U64_CONST(0x0000000000ff0000)) << 24) | \
749           (((U64)(x) & U64_CONST(0x00000000ff000000)) <<  8) | \
750           (((U64)(x) & U64_CONST(0x000000ff00000000)) >>  8) | \
751           (((U64)(x) & U64_CONST(0x0000ff0000000000)) >> 24) | \
752           (((U64)(x) & U64_CONST(0x00ff000000000000)) >> 40) | \
753           (((U64)(x) & U64_CONST(0xff00000000000000)) >> 56) ))
754 # endif
755
756 /*----------------------------------------------------------------------------*/
757 # if BYTEORDER == 0x1234 || BYTEORDER == 0x12345678  /*     little-endian     */
758 /*----------------------------------------------------------------------------*/
759 #  define my_htole16(x)         (x)
760 #  define my_letoh16(x)         (x)
761 #  define my_htole32(x)         (x)
762 #  define my_letoh32(x)         (x)
763 #  define my_htobe16(x)         _swab_16_(x)
764 #  define my_betoh16(x)         _swab_16_(x)
765 #  define my_htobe32(x)         _swab_32_(x)
766 #  define my_betoh32(x)         _swab_32_(x)
767 #  ifdef HAS_QUAD
768 #   define my_htole64(x)        (x)
769 #   define my_letoh64(x)        (x)
770 #   define my_htobe64(x)        _swab_64_(x)
771 #   define my_betoh64(x)        _swab_64_(x)
772 #  endif
773 #  define my_htoles(x)          (x)
774 #  define my_letohs(x)          (x)
775 #  define my_htolei(x)          (x)
776 #  define my_letohi(x)          (x)
777 #  define my_htolel(x)          (x)
778 #  define my_letohl(x)          (x)
779 #  if SHORTSIZE == 1
780 #   define my_htobes(x)         (x)
781 #   define my_betohs(x)         (x)
782 #  elif SHORTSIZE == 2
783 #   define my_htobes(x)         _swab_16_(x)
784 #   define my_betohs(x)         _swab_16_(x)
785 #  elif SHORTSIZE == 4
786 #   define my_htobes(x)         _swab_32_(x)
787 #   define my_betohs(x)         _swab_32_(x)
788 #  elif SHORTSIZE == 8
789 #   define my_htobes(x)         _swab_64_(x)
790 #   define my_betohs(x)         _swab_64_(x)
791 #  else
792 #   define PERL_NEED_MY_HTOBES
793 #   define PERL_NEED_MY_BETOHS
794 #  endif
795 #  if INTSIZE == 1
796 #   define my_htobei(x)         (x)
797 #   define my_betohi(x)         (x)
798 #  elif INTSIZE == 2
799 #   define my_htobei(x)         _swab_16_(x)
800 #   define my_betohi(x)         _swab_16_(x)
801 #  elif INTSIZE == 4
802 #   define my_htobei(x)         _swab_32_(x)
803 #   define my_betohi(x)         _swab_32_(x)
804 #  elif INTSIZE == 8
805 #   define my_htobei(x)         _swab_64_(x)
806 #   define my_betohi(x)         _swab_64_(x)
807 #  else
808 #   define PERL_NEED_MY_HTOBEI
809 #   define PERL_NEED_MY_BETOHI
810 #  endif
811 #  if LONGSIZE == 1
812 #   define my_htobel(x)         (x)
813 #   define my_betohl(x)         (x)
814 #  elif LONGSIZE == 2
815 #   define my_htobel(x)         _swab_16_(x)
816 #   define my_betohl(x)         _swab_16_(x)
817 #  elif LONGSIZE == 4
818 #   define my_htobel(x)         _swab_32_(x)
819 #   define my_betohl(x)         _swab_32_(x)
820 #  elif LONGSIZE == 8
821 #   define my_htobel(x)         _swab_64_(x)
822 #   define my_betohl(x)         _swab_64_(x)
823 #  else
824 #   define PERL_NEED_MY_HTOBEL
825 #   define PERL_NEED_MY_BETOHL
826 #  endif
827 #  define my_htolen(p,n)        NOOP
828 #  define my_letohn(p,n)        NOOP
829 #  define my_htoben(p,n)        my_swabn(p,n)
830 #  define my_betohn(p,n)        my_swabn(p,n)
831 /*----------------------------------------------------------------------------*/
832 # elif BYTEORDER == 0x4321 || BYTEORDER == 0x87654321  /*     big-endian      */
833 /*----------------------------------------------------------------------------*/
834 #  define my_htobe16(x)         (x)
835 #  define my_betoh16(x)         (x)
836 #  define my_htobe32(x)         (x)
837 #  define my_betoh32(x)         (x)
838 #  define my_htole16(x)         _swab_16_(x)
839 #  define my_letoh16(x)         _swab_16_(x)
840 #  define my_htole32(x)         _swab_32_(x)
841 #  define my_letoh32(x)         _swab_32_(x)
842 #  ifdef HAS_QUAD
843 #   define my_htobe64(x)        (x)
844 #   define my_betoh64(x)        (x)
845 #   define my_htole64(x)        _swab_64_(x)
846 #   define my_letoh64(x)        _swab_64_(x)
847 #  endif
848 #  define my_htobes(x)          (x)
849 #  define my_betohs(x)          (x)
850 #  define my_htobei(x)          (x)
851 #  define my_betohi(x)          (x)
852 #  define my_htobel(x)          (x)
853 #  define my_betohl(x)          (x)
854 #  if SHORTSIZE == 1
855 #   define my_htoles(x)         (x)
856 #   define my_letohs(x)         (x)
857 #  elif SHORTSIZE == 2
858 #   define my_htoles(x)         _swab_16_(x)
859 #   define my_letohs(x)         _swab_16_(x)
860 #  elif SHORTSIZE == 4
861 #   define my_htoles(x)         _swab_32_(x)
862 #   define my_letohs(x)         _swab_32_(x)
863 #  elif SHORTSIZE == 8
864 #   define my_htoles(x)         _swab_64_(x)
865 #   define my_letohs(x)         _swab_64_(x)
866 #  else
867 #   define PERL_NEED_MY_HTOLES
868 #   define PERL_NEED_MY_LETOHS
869 #  endif
870 #  if INTSIZE == 1
871 #   define my_htolei(x)         (x)
872 #   define my_letohi(x)         (x)
873 #  elif INTSIZE == 2
874 #   define my_htolei(x)         _swab_16_(x)
875 #   define my_letohi(x)         _swab_16_(x)
876 #  elif INTSIZE == 4
877 #   define my_htolei(x)         _swab_32_(x)
878 #   define my_letohi(x)         _swab_32_(x)
879 #  elif INTSIZE == 8
880 #   define my_htolei(x)         _swab_64_(x)
881 #   define my_letohi(x)         _swab_64_(x)
882 #  else
883 #   define PERL_NEED_MY_HTOLEI
884 #   define PERL_NEED_MY_LETOHI
885 #  endif
886 #  if LONGSIZE == 1
887 #   define my_htolel(x)         (x)
888 #   define my_letohl(x)         (x)
889 #  elif LONGSIZE == 2
890 #   define my_htolel(x)         _swab_16_(x)
891 #   define my_letohl(x)         _swab_16_(x)
892 #  elif LONGSIZE == 4
893 #   define my_htolel(x)         _swab_32_(x)
894 #   define my_letohl(x)         _swab_32_(x)
895 #  elif LONGSIZE == 8
896 #   define my_htolel(x)         _swab_64_(x)
897 #   define my_letohl(x)         _swab_64_(x)
898 #  else
899 #   define PERL_NEED_MY_HTOLEL
900 #   define PERL_NEED_MY_LETOHL
901 #  endif
902 #  define my_htolen(p,n)        my_swabn(p,n)
903 #  define my_letohn(p,n)        my_swabn(p,n)
904 #  define my_htoben(p,n)        NOOP
905 #  define my_betohn(p,n)        NOOP
906 /*----------------------------------------------------------------------------*/
907 # else /*                       all other byte-orders                         */
908 /*----------------------------------------------------------------------------*/
909 #  define PERL_NEED_MY_HTOLE16
910 #  define PERL_NEED_MY_LETOH16
911 #  define PERL_NEED_MY_HTOBE16
912 #  define PERL_NEED_MY_BETOH16
913 #  define PERL_NEED_MY_HTOLE32
914 #  define PERL_NEED_MY_LETOH32
915 #  define PERL_NEED_MY_HTOBE32
916 #  define PERL_NEED_MY_BETOH32
917 #  ifdef HAS_QUAD
918 #   define PERL_NEED_MY_HTOLE64
919 #   define PERL_NEED_MY_LETOH64
920 #   define PERL_NEED_MY_HTOBE64
921 #   define PERL_NEED_MY_BETOH64
922 #  endif
923 #  define PERL_NEED_MY_HTOLES
924 #  define PERL_NEED_MY_LETOHS
925 #  define PERL_NEED_MY_HTOBES
926 #  define PERL_NEED_MY_BETOHS
927 #  define PERL_NEED_MY_HTOLEI
928 #  define PERL_NEED_MY_LETOHI
929 #  define PERL_NEED_MY_HTOBEI
930 #  define PERL_NEED_MY_BETOHI
931 #  define PERL_NEED_MY_HTOLEL
932 #  define PERL_NEED_MY_LETOHL
933 #  define PERL_NEED_MY_HTOBEL
934 #  define PERL_NEED_MY_BETOHL
935 /*----------------------------------------------------------------------------*/
936 # endif /*                     end of byte-order macros                       */
937 /*----------------------------------------------------------------------------*/
938
939 /* The old value was hard coded at 1008. (4096-16) seems to be a bit faster,
940    at least on FreeBSD.  YMMV, so experiment.  */
941 #ifndef PERL_ARENA_SIZE
942 #define PERL_ARENA_SIZE 4080
943 #endif
944
945 /* Maximum level of recursion */
946 #ifndef PERL_SUB_DEPTH_WARN
947 #define PERL_SUB_DEPTH_WARN 100
948 #endif
949
950 #endif /* PERL_CORE */
951
952 /* We no longer default to creating a new SV for GvSV.
953    Do this before embed.  */
954 #ifndef PERL_CREATE_GVSV
955 #  ifndef PERL_DONT_CREATE_GVSV
956 #    define PERL_DONT_CREATE_GVSV
957 #  endif
958 #endif
959
960 #if !defined(HAS_WAITPID) && !defined(HAS_WAIT4) || defined(HAS_WAITPID_RUNTIME)
961 #define PERL_USES_PL_PIDSTATUS
962 #endif
963
964 #if !defined(OS2) && !defined(WIN32) && !defined(DJGPP) && !defined(EPOC) && !defined(__SYMBIAN32__) && !defined(MACOS_TRADITIONAL)
965 #define PERL_DEFAULT_DO_EXEC3_IMPLEMENTATION
966 #endif
967
968 /* Cannot include embed.h here on Win32 as win32.h has not 
969    yet been included and defines some config variables e.g. HAVE_INTERP_INTERN
970  */
971 #if !defined(PERL_FOR_X2P) && !(defined(WIN32)||defined(VMS))
972 #  include "embed.h"
973 #  ifndef PERL_MAD
974 #    undef op_getmad
975 #    define op_getmad(arg,pegop,slot) NOOP
976 #  endif
977 #endif
978
979 #define MEM_SIZE Size_t
980
981 /* Round all values passed to malloc up, by default to a multiple of
982    sizeof(size_t)
983 */
984 #ifndef PERL_STRLEN_ROUNDUP_QUANTUM
985 #define PERL_STRLEN_ROUNDUP_QUANTUM Size_t_size
986 #endif
987
988 #if defined(STANDARD_C) && defined(I_STDDEF)
989 #   include <stddef.h>
990 #   define STRUCT_OFFSET(s,m)  offsetof(s,m)
991 #else
992 #   define STRUCT_OFFSET(s,m)  (Size_t)(&(((s *)0)->m))
993 #endif
994
995 #ifndef __SYMBIAN32__
996 #  if defined(I_STRING) || defined(__cplusplus)
997 #     include <string.h>
998 #  else
999 #     include <strings.h>
1000 #  endif
1001 #endif
1002
1003 /* This comes after <stdlib.h> so we don't try to change the standard
1004  * library prototypes; we'll use our own in proto.h instead. */
1005
1006 #ifdef MYMALLOC
1007 #  ifdef PERL_POLLUTE_MALLOC
1008 #   ifndef PERL_EXTMALLOC_DEF
1009 #    define Perl_malloc         malloc
1010 #    define Perl_calloc         calloc
1011 #    define Perl_realloc        realloc
1012 #    define Perl_mfree          free
1013 #   endif
1014 #  else
1015 #    define EMBEDMYMALLOC       /* for compatibility */
1016 #  endif
1017
1018 #  define safemalloc  Perl_malloc
1019 #  define safecalloc  Perl_calloc
1020 #  define saferealloc Perl_realloc
1021 #  define safefree    Perl_mfree
1022 #  define CHECK_MALLOC_TOO_LATE_FOR_(code)      STMT_START {            \
1023         if (!PL_tainting && MallocCfg_ptr[MallocCfg_cfg_env_read])      \
1024                 code;                                                   \
1025     } STMT_END
1026 #  define CHECK_MALLOC_TOO_LATE_FOR(ch)                         \
1027         CHECK_MALLOC_TOO_LATE_FOR_(MALLOC_TOO_LATE_FOR(ch))
1028 #  define panic_write2(s)               write(2, s, strlen(s))
1029 #  define CHECK_MALLOC_TAINT(newval)                            \
1030         CHECK_MALLOC_TOO_LATE_FOR_(                             \
1031                 if (newval) {                                   \
1032                   panic_write2("panic: tainting with $ENV{PERL_MALLOC_OPT}\n");\
1033                   exit(1); })
1034 #  define MALLOC_CHECK_TAINT(argc,argv,env)     STMT_START {    \
1035         if (doing_taint(argc,argv,env)) {                       \
1036                 MallocCfg_ptr[MallocCfg_skip_cfg_env] = 1;      \
1037     }} STMT_END;
1038 #else  /* MYMALLOC */
1039 #  define safemalloc  safesysmalloc
1040 #  define safecalloc  safesyscalloc
1041 #  define saferealloc safesysrealloc
1042 #  define safefree    safesysfree
1043 #  define CHECK_MALLOC_TOO_LATE_FOR(ch)         ((void)0)
1044 #  define CHECK_MALLOC_TAINT(newval)            ((void)0)
1045 #  define MALLOC_CHECK_TAINT(argc,argv,env)
1046 #endif /* MYMALLOC */
1047
1048 #define TOO_LATE_FOR_(ch,what)  Perl_croak(aTHX_ "\"-%c\" is on the #! line, it must also be used on the command line%s", (char)(ch), what)
1049 #define TOO_LATE_FOR(ch)        TOO_LATE_FOR_(ch, "")
1050 #define MALLOC_TOO_LATE_FOR(ch) TOO_LATE_FOR_(ch, " with $ENV{PERL_MALLOC_OPT}")
1051 #define MALLOC_CHECK_TAINT2(argc,argv)  MALLOC_CHECK_TAINT(argc,argv,NULL)
1052
1053 #if !defined(HAS_STRCHR) && defined(HAS_INDEX) && !defined(strchr)
1054 #define strchr index
1055 #define strrchr rindex
1056 #endif
1057
1058 #ifdef I_MEMORY
1059 #  include <memory.h>
1060 #endif
1061
1062 #ifdef HAS_MEMCPY
1063 #  if !defined(STANDARD_C) && !defined(I_STRING) && !defined(I_MEMORY)
1064 #    ifndef memcpy
1065         extern char * memcpy (char*, char*, int);
1066 #    endif
1067 #  endif
1068 #else
1069 #   ifndef memcpy
1070 #       ifdef HAS_BCOPY
1071 #           define memcpy(d,s,l) bcopy(s,d,l)
1072 #       else
1073 #           define memcpy(d,s,l) my_bcopy(s,d,l)
1074 #       endif
1075 #   endif
1076 #endif /* HAS_MEMCPY */
1077
1078 #ifdef HAS_MEMSET
1079 #  if !defined(STANDARD_C) && !defined(I_STRING) && !defined(I_MEMORY)
1080 #    ifndef memset
1081         extern char *memset (char*, int, int);
1082 #    endif
1083 #  endif
1084 #else
1085 #  undef  memset
1086 #  define memset(d,c,l) my_memset(d,c,l)
1087 #endif /* HAS_MEMSET */
1088
1089 #if !defined(HAS_MEMMOVE) && !defined(memmove)
1090 #   if defined(HAS_BCOPY) && defined(HAS_SAFE_BCOPY)
1091 #       define memmove(d,s,l) bcopy(s,d,l)
1092 #   else
1093 #       if defined(HAS_MEMCPY) && defined(HAS_SAFE_MEMCPY)
1094 #           define memmove(d,s,l) memcpy(d,s,l)
1095 #       else
1096 #           define memmove(d,s,l) my_bcopy(s,d,l)
1097 #       endif
1098 #   endif
1099 #endif
1100
1101 #if defined(mips) && defined(ultrix) && !defined(__STDC__)
1102 #   undef HAS_MEMCMP
1103 #endif
1104
1105 #if defined(HAS_MEMCMP) && defined(HAS_SANE_MEMCMP)
1106 #  if !defined(STANDARD_C) && !defined(I_STRING) && !defined(I_MEMORY)
1107 #    ifndef memcmp
1108         extern int memcmp (char*, char*, int);
1109 #    endif
1110 #  endif
1111 #  ifdef BUGGY_MSC
1112 #    pragma function(memcmp)
1113 #  endif
1114 #else
1115 #   ifndef memcmp
1116 #       define memcmp   my_memcmp
1117 #   endif
1118 #endif /* HAS_MEMCMP && HAS_SANE_MEMCMP */
1119
1120 #ifndef memzero
1121 #   ifdef HAS_MEMSET
1122 #       define memzero(d,l) memset(d,0,l)
1123 #   else
1124 #       ifdef HAS_BZERO
1125 #           define memzero(d,l) bzero(d,l)
1126 #       else
1127 #           define memzero(d,l) my_bzero(d,l)
1128 #       endif
1129 #   endif
1130 #endif
1131
1132 #ifndef PERL_MICRO
1133 #ifndef memchr
1134 #   ifndef HAS_MEMCHR
1135 #       define memchr(s,c,n) ninstr((char*)(s), ((char*)(s)) + n, &(c), &(c) + 1)
1136 #   endif
1137 #endif
1138 #endif
1139
1140 #ifndef HAS_BCMP
1141 #   ifndef bcmp
1142 #       define bcmp(s1,s2,l) memcmp(s1,s2,l)
1143 #   endif
1144 #endif /* !HAS_BCMP */
1145
1146 #ifdef I_NETINET_IN
1147 #   include <netinet/in.h>
1148 #endif
1149
1150 #ifdef I_ARPA_INET
1151 #   include <arpa/inet.h>
1152 #endif
1153
1154 #if defined(SF_APPEND) && defined(USE_SFIO) && defined(I_SFIO)
1155 /* <sfio.h> defines SF_APPEND and <sys/stat.h> might define SF_APPEND
1156  * (the neo-BSD seem to do this).  */
1157 #   undef SF_APPEND
1158 #endif
1159
1160 #ifdef I_SYS_STAT
1161 #   include <sys/stat.h>
1162 #endif
1163
1164 /* The stat macros for Amdahl UTS, Unisoft System V/88 (and derivatives
1165    like UTekV) are broken, sometimes giving false positives.  Undefine
1166    them here and let the code below set them to proper values.
1167
1168    The ghs macro stands for GreenHills Software C-1.8.5 which
1169    is the C compiler for sysV88 and the various derivatives.
1170    This header file bug is corrected in gcc-2.5.8 and later versions.
1171    --Kaveh Ghazi (ghazi@noc.rutgers.edu) 10/3/94.  */
1172
1173 #if defined(uts) || (defined(m88k) && defined(ghs))
1174 #   undef S_ISDIR
1175 #   undef S_ISCHR
1176 #   undef S_ISBLK
1177 #   undef S_ISREG
1178 #   undef S_ISFIFO
1179 #   undef S_ISLNK
1180 #endif
1181
1182 #ifdef I_TIME
1183 #   include <time.h>
1184 #endif
1185
1186 #ifdef I_SYS_TIME
1187 #   ifdef I_SYS_TIME_KERNEL
1188 #       define KERNEL
1189 #   endif
1190 #   include <sys/time.h>
1191 #   ifdef I_SYS_TIME_KERNEL
1192 #       undef KERNEL
1193 #   endif
1194 #endif
1195
1196 #if defined(HAS_TIMES) && defined(I_SYS_TIMES)
1197 #    include <sys/times.h>
1198 #endif
1199
1200 #if defined(HAS_STRERROR) && (!defined(HAS_MKDIR) || !defined(HAS_RMDIR))
1201 #   undef HAS_STRERROR
1202 #endif
1203
1204 #include <errno.h>
1205
1206 #if defined(WIN32) && defined(PERL_IMPLICIT_SYS)
1207 #  define WIN32SCK_IS_STDSCK            /* don't pull in custom wsock layer */
1208 #endif
1209
1210 /* In Tru64 use the 4.4BSD struct msghdr, not the 4.3 one.
1211  * This is important for using IPv6. 
1212  * For OSF/1 3.2, however, defining _SOCKADDR_LEN would be
1213  * a bad idea since it breaks send() and recv(). */
1214 #if defined(__osf__) && defined(__alpha) && !defined(_SOCKADDR_LEN) && !defined(DEC_OSF1_3_X)
1215 #   define _SOCKADDR_LEN
1216 #endif
1217
1218 #if defined(HAS_SOCKET) && !defined(VMS) && !defined(WIN32) /* VMS/WIN32 handle sockets via vmsish.h/win32.h */
1219 # include <sys/socket.h>
1220 # if defined(USE_SOCKS) && defined(I_SOCKS)
1221 #   if !defined(INCLUDE_PROTOTYPES)
1222 #       define INCLUDE_PROTOTYPES /* for <socks.h> */
1223 #       define PERL_SOCKS_NEED_PROTOTYPES
1224 #   endif
1225 #   include <socks.h>
1226 #   ifdef PERL_SOCKS_NEED_PROTOTYPES /* keep cpp space clean */
1227 #       undef INCLUDE_PROTOTYPES
1228 #       undef PERL_SOCKS_NEED_PROTOTYPES
1229 #   endif
1230 # endif
1231 # ifdef I_NETDB
1232 #  ifdef NETWARE
1233 #   include<stdio.h>
1234 #  endif
1235 #  include <netdb.h>
1236 # endif
1237 # ifndef ENOTSOCK
1238 #  ifdef I_NET_ERRNO
1239 #   include <net/errno.h>
1240 #  endif
1241 # endif
1242 #endif
1243
1244 /* sockatmark() is so new (2001) that many places might have it hidden
1245  * behind some -D_BLAH_BLAH_SOURCE guard.  The __THROW magic is required
1246  * e.g. in Gentoo, see http://bugs.gentoo.org/show_bug.cgi?id=12605 */
1247 #if defined(HAS_SOCKATMARK) && !defined(HAS_SOCKATMARK_PROTO)
1248 # if defined(__THROW) && defined(__GLIBC__)
1249 int sockatmark(int) __THROW;
1250 # else
1251 int sockatmark(int);
1252 # endif
1253 #endif
1254
1255 #if defined(__osf__) && defined(__cplusplus) && !defined(_XOPEN_SOURCE_EXTENDED) /* Tru64 "cxx" (C++), see hints/dec_osf.sh for why the _XOPEN_SOURCE_EXTENDED cannot be defined. */
1256 EXTERN_C int fchdir(int);
1257 EXTERN_C int flock(int, int);
1258 EXTERN_C int fseeko(FILE *, off_t, int);
1259 EXTERN_C off_t ftello(FILE *);
1260 #endif
1261
1262 #if defined(__SUNPRO_CC) /* SUNWspro CC (C++) */
1263 EXTERN_C char *crypt(const char *, const char *);
1264 EXTERN_C char **environ;
1265 #endif
1266
1267 #if defined(__cplusplus)
1268 #  if defined(__OpenBSD__) || defined(__FreeBSD__) || defined(__NetBSD__)
1269 EXTERN_C char **environ;
1270 #  elif defined(__CYGWIN__)
1271 EXTERN_C char *crypt(const char *, const char *);
1272 #endif
1273 #endif
1274
1275 #ifdef SETERRNO
1276 # undef SETERRNO  /* SOCKS might have defined this */
1277 #endif
1278
1279 #ifdef VMS
1280 #   define SETERRNO(errcode,vmserrcode) \
1281         STMT_START {                    \
1282             set_errno(errcode);         \
1283             set_vaxc_errno(vmserrcode); \
1284         } STMT_END
1285 #   define dSAVEDERRNO    int saved_errno; unsigned saved_vms_errno
1286 #   define dSAVE_ERRNO    int saved_errno = errno; unsigned saved_vms_errno = vaxc$errno
1287 #   define SAVE_ERRNO     ( saved_errno = errno, saved_vms_errno = vaxc$errno )
1288 #   define RESTORE_ERRNO  SETERRNO(saved_errno, saved_vms_errno)
1289
1290 #   define LIB_INVARG           LIB$_INVARG
1291 #   define RMS_DIR              RMS$_DIR
1292 #   define RMS_FAC              RMS$_FAC
1293 #   define RMS_FEX              RMS$_FEX
1294 #   define RMS_FNF              RMS$_FNF
1295 #   define RMS_IFI              RMS$_IFI
1296 #   define RMS_ISI              RMS$_ISI
1297 #   define RMS_PRV              RMS$_PRV
1298 #   define SS_ACCVIO            SS$_ACCVIO
1299 #   define SS_DEVOFFLINE        SS$_DEVOFFLINE
1300 #   define SS_IVCHAN            SS$_IVCHAN
1301 #   define SS_NORMAL            SS$_NORMAL
1302 #else
1303 #   define SETERRNO(errcode,vmserrcode) (errno = (errcode))
1304 #   define dSAVEDERRNO    int saved_errno
1305 #   define dSAVE_ERRNO    int saved_errno = errno
1306 #   define SAVE_ERRNO     (saved_errno = errno)
1307 #   define RESTORE_ERRNO  (errno = saved_errno)
1308
1309 #   define LIB_INVARG           0
1310 #   define RMS_DIR              0
1311 #   define RMS_FAC              0
1312 #   define RMS_FEX              0
1313 #   define RMS_FNF              0
1314 #   define RMS_IFI              0
1315 #   define RMS_ISI              0
1316 #   define RMS_PRV              0
1317 #   define SS_ACCVIO            0
1318 #   define SS_DEVOFFLINE        0
1319 #   define SS_IVCHAN            0
1320 #   define SS_NORMAL            0
1321 #endif
1322
1323 #define ERRSV GvSV(PL_errgv)
1324 #ifdef PERL_CORE
1325 # define DEFSV (0 + GvSVn(PL_defgv))
1326 #else
1327 # define DEFSV GvSVn(PL_defgv)
1328 #endif
1329 #define DEFSV_set(sv) (GvSV(PL_defgv) = (sv))
1330 #define SAVE_DEFSV SAVESPTR(GvSV(PL_defgv))
1331
1332 #define ERRHV GvHV(PL_errgv)    /* XXX unused, here for compatibility */
1333
1334 #ifndef errno
1335         extern int errno;     /* ANSI allows errno to be an lvalue expr.
1336                                * For example in multithreaded environments
1337                                * something like this might happen:
1338                                * extern int *_errno(void);
1339                                * #define errno (*_errno()) */
1340 #endif
1341
1342 #ifdef HAS_STRERROR
1343 #       ifdef VMS
1344         char *strerror (int,...);
1345 #       else
1346 #ifndef DONT_DECLARE_STD
1347         char *strerror (int);
1348 #endif
1349 #       endif
1350 #       ifndef Strerror
1351 #           define Strerror strerror
1352 #       endif
1353 #else
1354 #    ifdef HAS_SYS_ERRLIST
1355         extern int sys_nerr;
1356         extern char *sys_errlist[];
1357 #       ifndef Strerror
1358 #           define Strerror(e) \
1359                 ((e) < 0 || (e) >= sys_nerr ? "(unknown)" : sys_errlist[e])
1360 #       endif
1361 #   endif
1362 #endif
1363
1364 #ifdef I_SYS_IOCTL
1365 #   ifndef _IOCTL_
1366 #       include <sys/ioctl.h>
1367 #   endif
1368 #endif
1369
1370 #if defined(mc300) || defined(mc500) || defined(mc700) || defined(mc6000)
1371 #   ifdef HAS_SOCKETPAIR
1372 #       undef HAS_SOCKETPAIR
1373 #   endif
1374 #   ifdef I_NDBM
1375 #       undef I_NDBM
1376 #   endif
1377 #endif
1378
1379 #ifndef HAS_SOCKETPAIR
1380 #   ifdef HAS_SOCKET
1381 #       define socketpair Perl_my_socketpair
1382 #   endif
1383 #endif
1384
1385 #if INTSIZE == 2
1386 #   define htoni htons
1387 #   define ntohi ntohs
1388 #else
1389 #   define htoni htonl
1390 #   define ntohi ntohl
1391 #endif
1392
1393 /* Configure already sets Direntry_t */
1394 #if defined(I_DIRENT)
1395 #   include <dirent.h>
1396     /* NeXT needs dirent + sys/dir.h */
1397 #   if  defined(I_SYS_DIR) && (defined(NeXT) || defined(__NeXT__))
1398 #       include <sys/dir.h>
1399 #   endif
1400 #else
1401 #   ifdef I_SYS_NDIR
1402 #       include <sys/ndir.h>
1403 #   else
1404 #       ifdef I_SYS_DIR
1405 #           ifdef hp9000s500
1406 #               include <ndir.h>        /* may be wrong in the future */
1407 #           else
1408 #               include <sys/dir.h>
1409 #           endif
1410 #       endif
1411 #   endif
1412 #endif
1413
1414 #ifdef PERL_MICRO
1415 #   ifndef DIR
1416 #      define DIR void
1417 #   endif
1418 #endif
1419
1420 #ifdef FPUTS_BOTCH
1421 /* work around botch in SunOS 4.0.1 and 4.0.2 */
1422 #   ifndef fputs
1423 #       define fputs(sv,fp) fprintf(fp,"%s",sv)
1424 #   endif
1425 #endif
1426
1427 /*
1428  * The following gobbledygook brought to you on behalf of __STDC__.
1429  * (I could just use #ifndef __STDC__, but this is more bulletproof
1430  * in the face of half-implementations.)
1431  */
1432
1433 #if defined(I_SYSMODE) && !defined(PERL_MICRO)
1434 #include <sys/mode.h>
1435 #endif
1436
1437 #ifndef S_IFMT
1438 #   ifdef _S_IFMT
1439 #       define S_IFMT _S_IFMT
1440 #   else
1441 #       define S_IFMT 0170000
1442 #   endif
1443 #endif
1444
1445 #ifndef S_ISDIR
1446 #   define S_ISDIR(m) ((m & S_IFMT) == S_IFDIR)
1447 #endif
1448
1449 #ifndef S_ISCHR
1450 #   define S_ISCHR(m) ((m & S_IFMT) == S_IFCHR)
1451 #endif
1452
1453 #ifndef S_ISBLK
1454 #   ifdef S_IFBLK
1455 #       define S_ISBLK(m) ((m & S_IFMT) == S_IFBLK)
1456 #   else
1457 #       define S_ISBLK(m) (0)
1458 #   endif
1459 #endif
1460
1461 #ifndef S_ISREG
1462 #   define S_ISREG(m) ((m & S_IFMT) == S_IFREG)
1463 #endif
1464
1465 #ifndef S_ISFIFO
1466 #   ifdef S_IFIFO
1467 #       define S_ISFIFO(m) ((m & S_IFMT) == S_IFIFO)
1468 #   else
1469 #       define S_ISFIFO(m) (0)
1470 #   endif
1471 #endif
1472
1473 #ifndef S_ISLNK
1474 #   ifdef _S_ISLNK
1475 #       define S_ISLNK(m) _S_ISLNK(m)
1476 #   else
1477 #       ifdef _S_IFLNK
1478 #           define S_ISLNK(m) ((m & S_IFMT) == _S_IFLNK)
1479 #       else
1480 #           ifdef S_IFLNK
1481 #               define S_ISLNK(m) ((m & S_IFMT) == S_IFLNK)
1482 #           else
1483 #               define S_ISLNK(m) (0)
1484 #           endif
1485 #       endif
1486 #   endif
1487 #endif
1488
1489 #ifndef S_ISSOCK
1490 #   ifdef _S_ISSOCK
1491 #       define S_ISSOCK(m) _S_ISSOCK(m)
1492 #   else
1493 #       ifdef _S_IFSOCK
1494 #           define S_ISSOCK(m) ((m & S_IFMT) == _S_IFSOCK)
1495 #       else
1496 #           ifdef S_IFSOCK
1497 #               define S_ISSOCK(m) ((m & S_IFMT) == S_IFSOCK)
1498 #           else
1499 #               define S_ISSOCK(m) (0)
1500 #           endif
1501 #       endif
1502 #   endif
1503 #endif
1504
1505 #ifndef S_IRUSR
1506 #   ifdef S_IREAD
1507 #       define S_IRUSR S_IREAD
1508 #       define S_IWUSR S_IWRITE
1509 #       define S_IXUSR S_IEXEC
1510 #   else
1511 #       define S_IRUSR 0400
1512 #       define S_IWUSR 0200
1513 #       define S_IXUSR 0100
1514 #   endif
1515 #endif
1516
1517 #ifndef S_IRGRP
1518 #   ifdef S_IRUSR
1519 #       define S_IRGRP (S_IRUSR>>3)
1520 #       define S_IWGRP (S_IWUSR>>3)
1521 #       define S_IXGRP (S_IXUSR>>3)
1522 #   else
1523 #       define S_IRGRP 0040
1524 #       define S_IWGRP 0020
1525 #       define S_IXGRP 0010
1526 #   endif
1527 #endif
1528
1529 #ifndef S_IROTH
1530 #   ifdef S_IRUSR
1531 #       define S_IROTH (S_IRUSR>>6)
1532 #       define S_IWOTH (S_IWUSR>>6)
1533 #       define S_IXOTH (S_IXUSR>>6)
1534 #   else
1535 #       define S_IROTH 0040
1536 #       define S_IWOTH 0020
1537 #       define S_IXOTH 0010
1538 #   endif
1539 #endif
1540
1541 #ifndef S_ISUID
1542 #   define S_ISUID 04000
1543 #endif
1544
1545 #ifndef S_ISGID
1546 #   define S_ISGID 02000
1547 #endif
1548
1549 #ifndef S_IRWXU
1550 #   define S_IRWXU (S_IRUSR|S_IWUSR|S_IXUSR)
1551 #endif
1552
1553 #ifndef S_IRWXG
1554 #   define S_IRWXG (S_IRGRP|S_IWGRP|S_IXGRP)
1555 #endif
1556
1557 #ifndef S_IRWXO
1558 #   define S_IRWXO (S_IROTH|S_IWOTH|S_IXOTH)
1559 #endif
1560
1561 /* BeOS 5.0 and Haiku R1 seem to define S_IREAD and S_IWRITE in <posix/fcntl.h>
1562  * which would get included through <sys/file.h >, but that is 3000
1563  * lines in the future.  --jhi */
1564
1565 #if !defined(S_IREAD) && !(defined(__BEOS__) || defined(__HAIKU__))
1566 #   define S_IREAD S_IRUSR
1567 #endif
1568
1569 #if !defined(S_IWRITE) && !(defined(__BEOS__) || defined(__HAIKU__))
1570 #   define S_IWRITE S_IWUSR
1571 #endif
1572
1573 #ifndef S_IEXEC
1574 #   define S_IEXEC S_IXUSR
1575 #endif
1576
1577 #ifdef ff_next
1578 #   undef ff_next
1579 #endif
1580
1581 #if defined(cray) || defined(gould) || defined(i860) || defined(pyr)
1582 #   define SLOPPYDIVIDE
1583 #endif
1584
1585 #ifdef UV
1586 #undef UV
1587 #endif
1588
1589 #ifdef  SPRINTF_E_BUG
1590 #  define sprintf UTS_sprintf_wrap
1591 #endif
1592
1593 /* For the times when you want the return value of sprintf, and you want it
1594    to be the length. Can't have a thread variable passed in, because C89 has
1595    no varargs macros.
1596 */
1597 #ifdef SPRINTF_RETURNS_STRLEN
1598 #  define my_sprintf sprintf
1599 #else
1600 #  define my_sprintf Perl_my_sprintf
1601 #endif
1602
1603 /*
1604  * If we have v?snprintf() and the C99 variadic macros, we can just
1605  * use just the v?snprintf().  It is nice to try to trap the buffer
1606  * overflow, however, so if we are DEBUGGING, and we cannot use the
1607  * gcc statement expressions, then use the function wrappers which try
1608  * to trap the overflow.  If we can use the gcc statement expressions,
1609  * we can try that even with the version that uses the C99 variadic
1610  * macros.
1611  */
1612
1613 /* Note that we do not check against snprintf()/vsnprintf() returning
1614  * negative values because that is non-standard behaviour and we use
1615  * snprintf/vsnprintf only iff HAS_VSNPRINTF has been defined, and
1616  * that should be true only if the snprintf()/vsnprintf() are true
1617  * to the standard. */
1618
1619 #if defined(HAS_SNPRINTF) && defined(HAS_C99_VARIADIC_MACROS) && !(defined(DEBUGGING) && !defined(PERL_USE_GCC_BRACE_GROUPS)) && !defined(PERL_GCC_PEDANTIC)
1620 #  ifdef PERL_USE_GCC_BRACE_GROUPS
1621 #      define my_snprintf(buffer, len, ...) ({ int __len__ = snprintf(buffer, len, __VA_ARGS__); if ((len) > 0 && (Size_t)__len__ >= (len)) Perl_croak_nocontext("panic: snprintf buffer overflow"); __len__; })
1622 #      define PERL_MY_SNPRINTF_GUARDED
1623 #  else
1624 #    define my_snprintf(buffer, len, ...) snprintf(buffer, len, __VA_ARGS__)
1625 #  endif
1626 #else
1627 #  define my_snprintf  Perl_my_snprintf
1628 #  define PERL_MY_SNPRINTF_GUARDED
1629 #endif
1630
1631 #if defined(HAS_VSNPRINTF) && defined(HAS_C99_VARIADIC_MACROS) && !(defined(DEBUGGING) && !defined(PERL_USE_GCC_BRACE_GROUPS)) && !defined(PERL_GCC_PEDANTIC)
1632 #  ifdef PERL_USE_GCC_BRACE_GROUPS
1633 #      define my_vsnprintf(buffer, len, ...) ({ int __len__ = vsnprintf(buffer, len, __VA_ARGS__); if ((len) > 0 && (Size_t)__len__ >= (len)) Perl_croak_nocontext("panic: vsnprintf buffer overflow"); __len__; })
1634 #      define PERL_MY_VSNPRINTF_GUARDED
1635 #  else
1636 #    define my_vsnprintf(buffer, len, ...) vsnprintf(buffer, len, __VA_ARGS__)
1637 #  endif
1638 #else
1639 #  define my_vsnprintf Perl_my_vsnprintf
1640 #  define PERL_MY_VSNPRINTF_GUARDED
1641 #endif
1642
1643 #ifdef HAS_STRLCAT
1644 #  define my_strlcat    strlcat
1645 #else
1646 #  define my_strlcat    Perl_my_strlcat
1647 #endif
1648
1649 #ifdef HAS_STRLCPY
1650 #  define my_strlcpy    strlcpy
1651 #else
1652 #  define my_strlcpy    Perl_my_strlcpy
1653 #endif
1654
1655 /* Configure gets this right but the UTS compiler gets it wrong.
1656    -- Hal Morris <hom00@utsglobal.com> */
1657 #ifdef UTS
1658 #  undef  UVTYPE
1659 #  define UVTYPE unsigned
1660 #endif
1661
1662 /*
1663     The IV type is supposed to be long enough to hold any integral
1664     value or a pointer.
1665     --Andy Dougherty    August 1996
1666 */
1667
1668 typedef IVTYPE IV;
1669 typedef UVTYPE UV;
1670
1671 #if defined(USE_64_BIT_INT) && defined(HAS_QUAD)
1672 #  if QUADKIND == QUAD_IS_INT64_T && defined(INT64_MAX)
1673 #    define IV_MAX INT64_MAX
1674 #    define IV_MIN INT64_MIN
1675 #    define UV_MAX UINT64_MAX
1676 #    ifndef UINT64_MIN
1677 #      define UINT64_MIN 0
1678 #    endif
1679 #    define UV_MIN UINT64_MIN
1680 #  else
1681 #    define IV_MAX PERL_QUAD_MAX
1682 #    define IV_MIN PERL_QUAD_MIN
1683 #    define UV_MAX PERL_UQUAD_MAX
1684 #    define UV_MIN PERL_UQUAD_MIN
1685 #  endif
1686 #  define IV_IS_QUAD
1687 #  define UV_IS_QUAD
1688 #else
1689 #  if defined(INT32_MAX) && IVSIZE == 4
1690 #    define IV_MAX INT32_MAX
1691 #    define IV_MIN INT32_MIN
1692 #    ifndef UINT32_MAX_BROKEN /* e.g. HP-UX with gcc messes this up */
1693 #        define UV_MAX UINT32_MAX
1694 #    else
1695 #        define UV_MAX 4294967295U
1696 #    endif
1697 #    ifndef UINT32_MIN
1698 #      define UINT32_MIN 0
1699 #    endif
1700 #    define UV_MIN UINT32_MIN
1701 #  else
1702 #    define IV_MAX PERL_LONG_MAX
1703 #    define IV_MIN PERL_LONG_MIN
1704 #    define UV_MAX PERL_ULONG_MAX
1705 #    define UV_MIN PERL_ULONG_MIN
1706 #  endif
1707 #  if IVSIZE == 8
1708 #    define IV_IS_QUAD
1709 #    define UV_IS_QUAD
1710 #    ifndef HAS_QUAD
1711 #      define HAS_QUAD
1712 #    endif
1713 #  else
1714 #    undef IV_IS_QUAD
1715 #    undef UV_IS_QUAD
1716 #    undef HAS_QUAD
1717 #  endif
1718 #endif
1719
1720 #ifndef HAS_QUAD
1721 # undef PERL_NEED_MY_HTOLE64
1722 # undef PERL_NEED_MY_LETOH64
1723 # undef PERL_NEED_MY_HTOBE64
1724 # undef PERL_NEED_MY_BETOH64
1725 #endif
1726
1727 #if defined(uts) || defined(UTS)
1728 #       undef UV_MAX
1729 #       define UV_MAX (4294967295u)
1730 #endif
1731
1732 #define IV_DIG (BIT_DIGITS(IVSIZE * 8))
1733 #define UV_DIG (BIT_DIGITS(UVSIZE * 8))
1734
1735 #ifndef NO_PERL_PRESERVE_IVUV
1736 #define PERL_PRESERVE_IVUV      /* We like our integers to stay integers. */
1737 #endif
1738
1739 /*
1740  *  The macros INT2PTR and NUM2PTR are (despite their names)
1741  *  bi-directional: they will convert int/float to or from pointers.
1742  *  However the conversion to int/float are named explicitly:
1743  *  PTR2IV, PTR2UV, PTR2NV.
1744  *
1745  *  For int conversions we do not need two casts if pointers are
1746  *  the same size as IV and UV.   Otherwise we need an explicit
1747  *  cast (PTRV) to avoid compiler warnings.
1748  */
1749 #if (IVSIZE == PTRSIZE) && (UVSIZE == PTRSIZE)
1750 #  define PTRV                  UV
1751 #  define INT2PTR(any,d)        (any)(d)
1752 #else
1753 #  if PTRSIZE == LONGSIZE
1754 #    define PTRV                unsigned long
1755 #    define PTR2ul(p)           (unsigned long)(p)
1756 #  else
1757 #    define PTRV                unsigned
1758 #  endif
1759 #endif
1760
1761 #ifndef INT2PTR
1762 #  define INT2PTR(any,d)        (any)(PTRV)(d)
1763 #endif
1764
1765 #ifndef PTR2ul
1766 #  define PTR2ul(p)     INT2PTR(unsigned long,p)        
1767 #endif
1768
1769 #define NUM2PTR(any,d)  (any)(PTRV)(d)
1770 #define PTR2IV(p)       INT2PTR(IV,p)
1771 #define PTR2UV(p)       INT2PTR(UV,p)
1772 #define PTR2NV(p)       NUM2PTR(NV,p)
1773 #define PTR2nat(p)      (PTRV)(p)       /* pointer to integer of PTRSIZE */
1774
1775 /* According to strict ANSI C89 one cannot freely cast between
1776  * data pointers and function (code) pointers.  There are at least
1777  * two ways around this.  One (used below) is to do two casts,
1778  * first the other pointer to an (unsigned) integer, and then
1779  * the integer to the other pointer.  The other way would be
1780  * to use unions to "overlay" the pointers.  For an example of
1781  * the latter technique, see union dirpu in struct xpvio in sv.h.
1782  * The only feasible use is probably temporarily storing
1783  * function pointers in a data pointer (such as a void pointer). */
1784
1785 #define DPTR2FPTR(t,p) ((t)PTR2nat(p))  /* data pointer to function pointer */
1786 #define FPTR2DPTR(t,p) ((t)PTR2nat(p))  /* function pointer to data pointer */
1787
1788 #ifdef USE_LONG_DOUBLE
1789 #  if defined(HAS_LONG_DOUBLE) && LONG_DOUBLESIZE == DOUBLESIZE
1790 #      define LONG_DOUBLE_EQUALS_DOUBLE
1791 #  endif
1792 #  if !(defined(HAS_LONG_DOUBLE) && (LONG_DOUBLESIZE > DOUBLESIZE))
1793 #     undef USE_LONG_DOUBLE /* Ouch! */
1794 #  endif
1795 #endif
1796
1797 #ifdef OVR_DBL_DIG
1798 /* Use an overridden DBL_DIG */
1799 # ifdef DBL_DIG
1800 #  undef DBL_DIG
1801 # endif
1802 # define DBL_DIG OVR_DBL_DIG
1803 #else
1804 /* The following is all to get DBL_DIG, in order to pick a nice
1805    default value for printing floating point numbers in Gconvert
1806    (see config.h). (It also has other uses, such as figuring out if
1807    a given precision of printing can be done with a double instead of
1808    a long double - Allen).
1809 */
1810 #ifdef I_LIMITS
1811 #include <limits.h>
1812 #endif
1813 #ifdef I_FLOAT
1814 #include <float.h>
1815 #endif
1816 #ifndef HAS_DBL_DIG
1817 #define DBL_DIG 15   /* A guess that works lots of places */
1818 #endif
1819 #endif
1820
1821 #ifdef OVR_LDBL_DIG
1822 /* Use an overridden LDBL_DIG */
1823 # ifdef LDBL_DIG
1824 #  undef LDBL_DIG
1825 # endif
1826 # define LDBL_DIG OVR_LDBL_DIG
1827 #else
1828 /* The following is all to get LDBL_DIG, in order to pick a nice
1829    default value for printing floating point numbers in Gconvert.
1830    (see config.h)
1831 */
1832 # ifdef I_LIMITS
1833 #   include <limits.h>
1834 # endif
1835 # ifdef I_FLOAT
1836 #  include <float.h>
1837 # endif
1838 # ifndef HAS_LDBL_DIG
1839 #  if LONG_DOUBLESIZE == 10
1840 #   define LDBL_DIG 18 /* assume IEEE */
1841 #  else
1842 #   if LONG_DOUBLESIZE == 12
1843 #    define LDBL_DIG 18 /* gcc? */
1844 #   else
1845 #    if LONG_DOUBLESIZE == 16
1846 #     define LDBL_DIG 33 /* assume IEEE */
1847 #    else
1848 #     if LONG_DOUBLESIZE == DOUBLESIZE
1849 #      define LDBL_DIG DBL_DIG /* bummer */
1850 #     endif
1851 #    endif
1852 #   endif
1853 #  endif
1854 # endif
1855 #endif
1856
1857 /*
1858  * This is for making sure we have a good DBL_MAX value, if possible,
1859  * either for usage as NV_MAX or for usage in figuring out if we can
1860  * fit a given long double into a double, if bug-fixing makes it
1861  * necessary to do so. - Allen <allens@cpan.org>
1862  */
1863
1864 #ifdef I_LIMITS
1865 #  include <limits.h>
1866 #endif
1867
1868 #ifdef I_VALUES
1869 #  if !(defined(DBL_MIN) && defined(DBL_MAX) && defined(I_LIMITS))
1870 #    include <values.h>
1871 #    if defined(MAXDOUBLE) && !defined(DBL_MAX)
1872 #      define DBL_MAX MAXDOUBLE
1873 #    endif
1874 #    if defined(MINDOUBLE) && !defined(DBL_MIN)
1875 #      define DBL_MIN MINDOUBLE
1876 #    endif
1877 #  endif
1878 #endif /* defined(I_VALUES) */
1879
1880 typedef NVTYPE NV;
1881
1882 #ifdef I_IEEEFP
1883 #   include <ieeefp.h>
1884 #endif
1885
1886 #ifdef USE_LONG_DOUBLE
1887 #   ifdef I_SUNMATH
1888 #       include <sunmath.h>
1889 #   endif
1890 #   define NV_DIG LDBL_DIG
1891 #   ifdef LDBL_MANT_DIG
1892 #       define NV_MANT_DIG LDBL_MANT_DIG
1893 #   endif
1894 #   ifdef LDBL_MIN
1895 #       define NV_MIN LDBL_MIN
1896 #   endif
1897 #   ifdef LDBL_MAX
1898 #       define NV_MAX LDBL_MAX
1899 #   endif
1900 #   ifdef LDBL_MIN_10_EXP
1901 #       define NV_MIN_10_EXP LDBL_MIN_10_EXP
1902 #   endif
1903 #   ifdef LDBL_MAX_10_EXP
1904 #       define NV_MAX_10_EXP LDBL_MAX_10_EXP
1905 #   endif
1906 #   ifdef LDBL_EPSILON
1907 #       define NV_EPSILON LDBL_EPSILON
1908 #   endif
1909 #   ifdef LDBL_MAX
1910 #       define NV_MAX LDBL_MAX
1911 /* Having LDBL_MAX doesn't necessarily mean that we have LDBL_MIN... -Allen */
1912 #   else
1913 #       ifdef HUGE_VALL
1914 #           define NV_MAX HUGE_VALL
1915 #       else
1916 #           ifdef HUGE_VAL
1917 #               define NV_MAX ((NV)HUGE_VAL)
1918 #           endif
1919 #       endif
1920 #   endif
1921 #   ifdef HAS_SQRTL
1922 #       define Perl_cos cosl
1923 #       define Perl_sin sinl
1924 #       define Perl_sqrt sqrtl
1925 #       define Perl_exp expl
1926 #       define Perl_log logl
1927 #       define Perl_atan2 atan2l
1928 #       define Perl_pow powl
1929 #       define Perl_floor floorl
1930 #       define Perl_ceil ceill
1931 #       define Perl_fmod fmodl
1932 #   endif
1933 /* e.g. libsunmath doesn't have modfl and frexpl as of mid-March 2000 */
1934 #   ifdef HAS_MODFL
1935 #       define Perl_modf(x,y) modfl(x,y)
1936 /* eg glibc 2.2 series seems to provide modfl on ppc and arm, but has no
1937    prototype in <math.h> */
1938 #       ifndef HAS_MODFL_PROTO
1939 EXTERN_C long double modfl(long double, long double *);
1940 #       endif
1941 #   else
1942 #       if defined(HAS_AINTL) && defined(HAS_COPYSIGNL)
1943         extern long double Perl_my_modfl(long double x, long double *ip);
1944 #           define Perl_modf(x,y) Perl_my_modfl(x,y)
1945 #       endif
1946 #   endif
1947 #   ifdef HAS_FREXPL
1948 #       define Perl_frexp(x,y) frexpl(x,y)
1949 #   else
1950 #       if defined(HAS_ILOGBL) && defined(HAS_SCALBNL)
1951         extern long double Perl_my_frexpl(long double x, int *e);
1952 #           define Perl_frexp(x,y) Perl_my_frexpl(x,y)
1953 #       endif
1954 #   endif
1955 #   ifndef Perl_isnan
1956 #       ifdef HAS_ISNANL
1957 #           define Perl_isnan(x) isnanl(x)
1958 #       endif
1959 #   endif
1960 #   ifndef Perl_isinf
1961 #       ifdef HAS_FINITEL
1962 #           define Perl_isinf(x) !(finitel(x)||Perl_isnan(x))
1963 #       endif
1964 #   endif
1965 #else
1966 #   define NV_DIG DBL_DIG
1967 #   ifdef DBL_MANT_DIG
1968 #       define NV_MANT_DIG DBL_MANT_DIG
1969 #   endif
1970 #   ifdef DBL_MIN
1971 #       define NV_MIN DBL_MIN
1972 #   endif
1973 #   ifdef DBL_MAX
1974 #       define NV_MAX DBL_MAX
1975 #   endif
1976 #   ifdef DBL_MIN_10_EXP
1977 #       define NV_MIN_10_EXP DBL_MIN_10_EXP
1978 #   endif
1979 #   ifdef DBL_MAX_10_EXP
1980 #       define NV_MAX_10_EXP DBL_MAX_10_EXP
1981 #   endif
1982 #   ifdef DBL_EPSILON
1983 #       define NV_EPSILON DBL_EPSILON
1984 #   endif
1985 #   ifdef DBL_MAX               /* XXX Does DBL_MAX imply having DBL_MIN? */
1986 #       define NV_MAX DBL_MAX
1987 #       define NV_MIN DBL_MIN
1988 #   else
1989 #       ifdef HUGE_VAL
1990 #           define NV_MAX HUGE_VAL
1991 #       endif
1992 #   endif
1993 #   define Perl_cos cos
1994 #   define Perl_sin sin
1995 #   define Perl_sqrt sqrt
1996 #   define Perl_exp exp
1997 #   define Perl_log log
1998 #   define Perl_atan2 atan2
1999 #   define Perl_pow pow
2000 #   define Perl_floor floor
2001 #   define Perl_ceil ceil
2002 #   define Perl_fmod fmod
2003 #   define Perl_modf(x,y) modf(x,y)
2004 #   define Perl_frexp(x,y) frexp(x,y)
2005 #endif
2006
2007 /* rumor has it that Win32 has _fpclass() */
2008
2009 /* SGI has fpclassl... but not with the same result values,
2010  * and it's via a typedef (not via #define), so will need to redo Configure
2011  * to use. Not worth the trouble, IMO, at least until the below is used
2012  * more places. Also has fp_class_l, BTW, via fp_class.h. Feel free to check
2013  * with me for the SGI manpages, SGI testing, etcetera, if you want to
2014  * try getting this to work with IRIX. - Allen <allens@cpan.org> */
2015
2016 #if !defined(Perl_fp_class) && (defined(HAS_FPCLASS)||defined(HAS_FPCLASSL))
2017 #    ifdef I_IEEFP
2018 #        include <ieeefp.h>
2019 #    endif
2020 #    ifdef I_FP
2021 #        include <fp.h>
2022 #    endif
2023 #    if defined(USE_LONG_DOUBLE) && defined(HAS_FPCLASSL)
2024 #        define Perl_fp_class()         fpclassl(x)
2025 #    else
2026 #        define Perl_fp_class()         fpclass(x)
2027 #    endif
2028 #    define Perl_fp_class_snan(x)       (Perl_fp_class(x)==FP_CLASS_SNAN)
2029 #    define Perl_fp_class_qnan(x)       (Perl_fp_class(x)==FP_CLASS_QNAN)
2030 #    define Perl_fp_class_nan(x)        (Perl_fp_class(x)==FP_CLASS_SNAN||Perl_fp_class(x)==FP_CLASS_QNAN)
2031 #    define Perl_fp_class_ninf(x)       (Perl_fp_class(x)==FP_CLASS_NINF)
2032 #    define Perl_fp_class_pinf(x)       (Perl_fp_class(x)==FP_CLASS_PINF)
2033 #    define Perl_fp_class_inf(x)        (Perl_fp_class(x)==FP_CLASS_NINF||Perl_fp_class(x)==FP_CLASS_PINF)
2034 #    define Perl_fp_class_nnorm(x)      (Perl_fp_class(x)==FP_CLASS_NNORM)
2035 #    define Perl_fp_class_pnorm(x)      (Perl_fp_class(x)==FP_CLASS_PNORM)
2036 #    define Perl_fp_class_norm(x)       (Perl_fp_class(x)==FP_CLASS_NNORM||Perl_fp_class(x)==FP_CLASS_PNORM)
2037 #    define Perl_fp_class_ndenorm(x)    (Perl_fp_class(x)==FP_CLASS_NDENORM)
2038 #    define Perl_fp_class_pdenorm(x)    (Perl_fp_class(x)==FP_CLASS_PDENORM)
2039 #    define Perl_fp_class_denorm(x)     (Perl_fp_class(x)==FP_CLASS_NDENORM||Perl_fp_class(x)==FP_CLASS_PDENORM)
2040 #    define Perl_fp_class_nzero(x)      (Perl_fp_class(x)==FP_CLASS_NZERO)
2041 #    define Perl_fp_class_pzero(x)      (Perl_fp_class(x)==FP_CLASS_PZERO)
2042 #    define Perl_fp_class_zero(x)       (Perl_fp_class(x)==FP_CLASS_NZERO||Perl_fp_class(x)==FP_CLASS_PZERO)
2043 #endif
2044
2045 #if !defined(Perl_fp_class) && defined(HAS_FP_CLASS) && !defined(PERL_MICRO)
2046 #    include <math.h>
2047 #    if !defined(FP_SNAN) && defined(I_FP_CLASS)
2048 #        include <fp_class.h>
2049 #    endif
2050 #    define Perl_fp_class(x)            fp_class(x)
2051 #    define Perl_fp_class_snan(x)       (fp_class(x)==FP_SNAN)
2052 #    define Perl_fp_class_qnan(x)       (fp_class(x)==FP_QNAN)
2053 #    define Perl_fp_class_nan(x)        (fp_class(x)==FP_SNAN||fp_class(x)==FP_QNAN)
2054 #    define Perl_fp_class_ninf(x)       (fp_class(x)==FP_NEG_INF)
2055 #    define Perl_fp_class_pinf(x)       (fp_class(x)==FP_POS_INF)
2056 #    define Perl_fp_class_inf(x)        (fp_class(x)==FP_NEG_INF||fp_class(x)==FP_POS_INF)
2057 #    define Perl_fp_class_nnorm(x)      (fp_class(x)==FP_NEG_NORM)
2058 #    define Perl_fp_class_pnorm(x)      (fp_class(x)==FP_POS_NORM)
2059 #    define Perl_fp_class_norm(x)       (fp_class(x)==FP_NEG_NORM||fp_class(x)==FP_POS_NORM)
2060 #    define Perl_fp_class_ndenorm(x)    (fp_class(x)==FP_NEG_DENORM)
2061 #    define Perl_fp_class_pdenorm(x)    (fp_class(x)==FP_POS_DENORM)
2062 #    define Perl_fp_class_denorm(x)     (fp_class(x)==FP_NEG_DENORM||fp_class(x)==FP_POS_DENORM)
2063 #    define Perl_fp_class_nzero(x)      (fp_class(x)==FP_NEG_ZERO)
2064 #    define Perl_fp_class_pzero(x)      (fp_class(x)==FP_POS_ZERO)
2065 #    define Perl_fp_class_zero(x)       (fp_class(x)==FP_NEG_ZERO||fp_class(x)==FP_POS_ZERO)
2066 #endif
2067
2068 #if !defined(Perl_fp_class) && defined(HAS_FPCLASSIFY)
2069 #    include <math.h>
2070 #    define Perl_fp_class(x)            fpclassify(x)
2071 #    define Perl_fp_class_nan(x)        (fp_classify(x)==FP_SNAN||fp_classify(x)==FP_QNAN)
2072 #    define Perl_fp_class_inf(x)        (fp_classify(x)==FP_INFINITE)
2073 #    define Perl_fp_class_norm(x)       (fp_classify(x)==FP_NORMAL)
2074 #    define Perl_fp_class_denorm(x)     (fp_classify(x)==FP_SUBNORMAL)
2075 #    define Perl_fp_class_zero(x)       (fp_classify(x)==FP_ZERO)
2076 #endif
2077
2078 #if !defined(Perl_fp_class) && defined(HAS_CLASS)
2079 #    include <math.h>
2080 #    ifndef _cplusplus
2081 #        define Perl_fp_class(x)        class(x)
2082 #    else
2083 #        define Perl_fp_class(x)        _class(x)
2084 #    endif
2085 #    define Perl_fp_class_snan(x)       (Perl_fp_class(x)==FP_NANS)
2086 #    define Perl_fp_class_qnan(x)       (Perl_fp_class(x)==FP_NANQ)
2087 #    define Perl_fp_class_nan(x)        (Perl_fp_class(x)==FP_SNAN||Perl_fp_class(x)==FP_QNAN)
2088 #    define Perl_fp_class_ninf(x)       (Perl_fp_class(x)==FP_MINUS_INF)
2089 #    define Perl_fp_class_pinf(x)       (Perl_fp_class(x)==FP_PLUS_INF)
2090 #    define Perl_fp_class_inf(x)        (Perl_fp_class(x)==FP_MINUS_INF||Perl_fp_class(x)==FP_PLUS_INF)
2091 #    define Perl_fp_class_nnorm(x)      (Perl_fp_class(x)==FP_MINUS_NORM)
2092 #    define Perl_fp_class_pnorm(x)      (Perl_fp_class(x)==FP_PLUS_NORM)
2093 #    define Perl_fp_class_norm(x)       (Perl_fp_class(x)==FP_MINUS_NORM||Perl_fp_class(x)==FP_PLUS_NORM)
2094 #    define Perl_fp_class_ndenorm(x)    (Perl_fp_class(x)==FP_MINUS_DENORM)
2095 #    define Perl_fp_class_pdenorm(x)    (Perl_fp_class(x)==FP_PLUS_DENORM)
2096 #    define Perl_fp_class_denorm(x)     (Perl_fp_class(x)==FP_MINUS_DENORM||Perl_fp_class(x)==FP_PLUS_DENORM)
2097 #    define Perl_fp_class_nzero(x)      (Perl_fp_class(x)==FP_MINUS_ZERO)
2098 #    define Perl_fp_class_pzero(x)      (Perl_fp_class(x)==FP_PLUS_ZERO)
2099 #    define Perl_fp_class_zero(x)       (Perl_fp_class(x)==FP_MINUS_ZERO||Perl_fp_class(x)==FP_PLUS_ZERO)
2100 #endif
2101
2102 /* rumor has it that Win32 has _isnan() */
2103
2104 #ifndef Perl_isnan
2105 #   ifdef HAS_ISNAN
2106 #       define Perl_isnan(x) isnan((NV)x)
2107 #   else
2108 #       ifdef Perl_fp_class_nan
2109 #           define Perl_isnan(x) Perl_fp_class_nan(x)
2110 #       else
2111 #           ifdef HAS_UNORDERED
2112 #               define Perl_isnan(x) unordered((x), 0.0)
2113 #           else
2114 #               define Perl_isnan(x) ((x)!=(x))
2115 #           endif
2116 #       endif
2117 #   endif
2118 #endif
2119
2120 #ifdef UNDER_CE
2121 int isnan(double d);
2122 #endif
2123
2124 #ifndef Perl_isinf
2125 #   ifdef HAS_ISINF
2126 #       define Perl_isinf(x) isinf((NV)x)
2127 #   else
2128 #       ifdef Perl_fp_class_inf
2129 #           define Perl_isinf(x) Perl_fp_class_inf(x)
2130 #       else
2131 #           define Perl_isinf(x) ((x)==NV_INF)
2132 #       endif
2133 #   endif
2134 #endif
2135
2136 #ifndef Perl_isfinite
2137 #   ifdef HAS_FINITE
2138 #       define Perl_isfinite(x) finite((NV)x)
2139 #   else
2140 #       ifdef HAS_ISFINITE
2141 #           define Perl_isfinite(x) isfinite(x)
2142 #       else
2143 #           ifdef Perl_fp_class_finite
2144 #               define Perl_isfinite(x) Perl_fp_class_finite(x)
2145 #           else
2146 #               define Perl_isfinite(x) !(Perl_is_inf(x)||Perl_is_nan(x))
2147 #           endif
2148 #       endif
2149 #   endif
2150 #endif
2151
2152 /* The default is to use Perl's own atof() implementation (in numeric.c).
2153  * Usually that is the one to use but for some platforms (e.g. UNICOS)
2154  * it is however best to use the native implementation of atof.
2155  * You can experiment with using your native one by -DUSE_PERL_ATOF=0.
2156  * Some good tests to try out with either setting are t/base/num.t,
2157  * t/op/numconvert.t, and t/op/pack.t. Note that if using long doubles
2158  * you may need to be using a different function than atof! */
2159
2160 #ifndef USE_PERL_ATOF
2161 #   ifndef _UNICOS
2162 #       define USE_PERL_ATOF
2163 #   endif
2164 #else
2165 #   if USE_PERL_ATOF == 0
2166 #       undef USE_PERL_ATOF
2167 #   endif
2168 #endif
2169
2170 #ifdef USE_PERL_ATOF
2171 #   define Perl_atof(s) Perl_my_atof(s)
2172 #   define Perl_atof2(s, n) Perl_my_atof2(aTHX_ (s), &(n))
2173 #else
2174 #   define Perl_atof(s) (NV)atof(s)
2175 #   define Perl_atof2(s, n) ((n) = atof(s))
2176 #endif
2177
2178 /* Previously these definitions used hardcoded figures.
2179  * It is hoped these formula are more portable, although
2180  * no data one way or another is presently known to me.
2181  * The "PERL_" names are used because these calculated constants
2182  * do not meet the ANSI requirements for LONG_MAX, etc., which
2183  * need to be constants acceptable to #if - kja
2184  *    define PERL_LONG_MAX        2147483647L
2185  *    define PERL_LONG_MIN        (-LONG_MAX - 1)
2186  *    define PERL ULONG_MAX       4294967295L
2187  */
2188
2189 #ifdef I_LIMITS  /* Needed for cast_xxx() functions below. */
2190 #  include <limits.h>
2191 #endif
2192 /* Included values.h above if necessary; still including limits.h down here,
2193  * despite doing above, because math.h might have overriden... XXX - Allen */
2194
2195 /*
2196  * Try to figure out max and min values for the integral types.  THE CORRECT
2197  * SOLUTION TO THIS MESS: ADAPT enquire.c FROM GCC INTO CONFIGURE.  The
2198  * following hacks are used if neither limits.h or values.h provide them:
2199  * U<TYPE>_MAX: for types >= int: ~(unsigned TYPE)0
2200  *              for types <  int:  (unsigned TYPE)~(unsigned)0
2201  *      The argument to ~ must be unsigned so that later signed->unsigned
2202  *      conversion can't modify the value's bit pattern (e.g. -0 -> +0),
2203  *      and it must not be smaller than int because ~ does integral promotion.
2204  * <type>_MAX: (<type>) (U<type>_MAX >> 1)
2205  * <type>_MIN: -<type>_MAX - <is_twos_complement_architecture: (3 & -1) == 3>.
2206  *      The latter is a hack which happens to work on some machines but
2207  *      does *not* catch any random system, or things like integer types
2208  *      with NaN if that is possible.
2209  *
2210  * All of the types are explicitly cast to prevent accidental loss of
2211  * numeric range, and in the hope that they will be less likely to confuse
2212  * over-eager optimizers.
2213  *
2214  */
2215
2216 #define PERL_UCHAR_MIN ((unsigned char)0)
2217
2218 #ifdef UCHAR_MAX
2219 #  define PERL_UCHAR_MAX ((unsigned char)UCHAR_MAX)
2220 #else
2221 #  ifdef MAXUCHAR
2222 #    define PERL_UCHAR_MAX ((unsigned char)MAXUCHAR)
2223 #  else
2224 #    define PERL_UCHAR_MAX       ((unsigned char)~(unsigned)0)
2225 #  endif
2226 #endif
2227
2228 /*
2229  * CHAR_MIN and CHAR_MAX are not included here, as the (char) type may be
2230  * ambiguous. It may be equivalent to (signed char) or (unsigned char)
2231  * depending on local options. Until Configure detects this (or at least
2232  * detects whether the "signed" keyword is available) the CHAR ranges
2233  * will not be included. UCHAR functions normally.
2234  *                                                           - kja
2235  */
2236
2237 #define PERL_USHORT_MIN ((unsigned short)0)
2238
2239 #ifdef USHORT_MAX
2240 #  define PERL_USHORT_MAX ((unsigned short)USHORT_MAX)
2241 #else
2242 #  ifdef MAXUSHORT
2243 #    define PERL_USHORT_MAX ((unsigned short)MAXUSHORT)
2244 #  else
2245 #    ifdef USHRT_MAX
2246 #      define PERL_USHORT_MAX ((unsigned short)USHRT_MAX)
2247 #    else
2248 #      define PERL_USHORT_MAX       ((unsigned short)~(unsigned)0)
2249 #    endif
2250 #  endif
2251 #endif
2252
2253 #ifdef SHORT_MAX
2254 #  define PERL_SHORT_MAX ((short)SHORT_MAX)
2255 #else
2256 #  ifdef MAXSHORT    /* Often used in <values.h> */
2257 #    define PERL_SHORT_MAX ((short)MAXSHORT)
2258 #  else
2259 #    ifdef SHRT_MAX
2260 #      define PERL_SHORT_MAX ((short)SHRT_MAX)
2261 #    else
2262 #      define PERL_SHORT_MAX      ((short) (PERL_USHORT_MAX >> 1))
2263 #    endif
2264 #  endif
2265 #endif
2266
2267 #ifdef SHORT_MIN
2268 #  define PERL_SHORT_MIN ((short)SHORT_MIN)
2269 #else
2270 #  ifdef MINSHORT
2271 #    define PERL_SHORT_MIN ((short)MINSHORT)
2272 #  else
2273 #    ifdef SHRT_MIN
2274 #      define PERL_SHORT_MIN ((short)SHRT_MIN)
2275 #    else
2276 #      define PERL_SHORT_MIN        (-PERL_SHORT_MAX - ((3 & -1) == 3))
2277 #    endif
2278 #  endif
2279 #endif
2280
2281 #ifdef UINT_MAX
2282 #  define PERL_UINT_MAX ((unsigned int)UINT_MAX)
2283 #else
2284 #  ifdef MAXUINT
2285 #    define PERL_UINT_MAX ((unsigned int)MAXUINT)
2286 #  else
2287 #    define PERL_UINT_MAX       (~(unsigned int)0)
2288 #  endif
2289 #endif
2290
2291 #define PERL_UINT_MIN ((unsigned int)0)
2292
2293 #ifdef INT_MAX
2294 #  define PERL_INT_MAX ((int)INT_MAX)
2295 #else
2296 #  ifdef MAXINT    /* Often used in <values.h> */
2297 #    define PERL_INT_MAX ((int)MAXINT)
2298 #  else
2299 #    define PERL_INT_MAX        ((int)(PERL_UINT_MAX >> 1))
2300 #  endif
2301 #endif
2302
2303 #ifdef INT_MIN
2304 #  define PERL_INT_MIN ((int)INT_MIN)
2305 #else
2306 #  ifdef MININT
2307 #    define PERL_INT_MIN ((int)MININT)
2308 #  else
2309 #    define PERL_INT_MIN        (-PERL_INT_MAX - ((3 & -1) == 3))
2310 #  endif
2311 #endif
2312
2313 #ifdef ULONG_MAX
2314 #  define PERL_ULONG_MAX ((unsigned long)ULONG_MAX)
2315 #else
2316 #  ifdef MAXULONG
2317 #    define PERL_ULONG_MAX ((unsigned long)MAXULONG)
2318 #  else
2319 #    define PERL_ULONG_MAX       (~(unsigned long)0)
2320 #  endif
2321 #endif
2322
2323 #define PERL_ULONG_MIN ((unsigned long)0L)
2324
2325 #ifdef LONG_MAX
2326 #  define PERL_LONG_MAX ((long)LONG_MAX)
2327 #else
2328 #  ifdef MAXLONG    /* Often used in <values.h> */
2329 #    define PERL_LONG_MAX ((long)MAXLONG)
2330 #  else
2331 #    define PERL_LONG_MAX        ((long) (PERL_ULONG_MAX >> 1))
2332 #  endif
2333 #endif
2334
2335 #ifdef LONG_MIN
2336 #  define PERL_LONG_MIN ((long)LONG_MIN)
2337 #else
2338 #  ifdef MINLONG
2339 #    define PERL_LONG_MIN ((long)MINLONG)
2340 #  else
2341 #    define PERL_LONG_MIN        (-PERL_LONG_MAX - ((3 & -1) == 3))
2342 #  endif
2343 #endif
2344
2345 #ifdef UV_IS_QUAD
2346
2347 #    define PERL_UQUAD_MAX      (~(UV)0)
2348 #    define PERL_UQUAD_MIN      ((UV)0)
2349 #    define PERL_QUAD_MAX       ((IV) (PERL_UQUAD_MAX >> 1))
2350 #    define PERL_QUAD_MIN       (-PERL_QUAD_MAX - ((3 & -1) == 3))
2351
2352 #endif
2353
2354 #ifdef MYMALLOC
2355 #  include "malloc_ctl.h"
2356 #endif
2357
2358 struct RExC_state_t;
2359 struct _reg_trie_data;
2360
2361 typedef MEM_SIZE STRLEN;
2362
2363 #ifdef PERL_MAD
2364 typedef struct token TOKEN;
2365 typedef struct madprop MADPROP;
2366 typedef struct nexttoken NEXTTOKE;
2367 #endif
2368 typedef struct op OP;
2369 typedef struct cop COP;
2370 typedef struct unop UNOP;
2371 typedef struct binop BINOP;
2372 typedef struct listop LISTOP;
2373 typedef struct logop LOGOP;
2374 typedef struct pmop PMOP;
2375 typedef struct svop SVOP;
2376 typedef struct padop PADOP;
2377 typedef struct pvop PVOP;
2378 typedef struct loop LOOP;
2379
2380 typedef struct interpreter PerlInterpreter;
2381
2382 /* Amdahl's <ksync.h> has struct sv */
2383 /* SGI's <sys/sema.h> has struct sv */
2384 #if defined(UTS) || defined(__sgi)
2385 #   define STRUCT_SV perl_sv
2386 #else
2387 #   define STRUCT_SV sv
2388 #endif
2389 typedef struct STRUCT_SV SV;
2390 typedef struct av AV;
2391 typedef struct hv HV;
2392 typedef struct cv CV;
2393 typedef struct regexp ORANGE;   /* This is the body structure.  */
2394 typedef struct p5rx REGEXP;
2395 typedef struct gp GP;
2396 typedef struct gv GV;
2397 typedef struct io IO;
2398 typedef struct context PERL_CONTEXT;
2399 typedef struct block BLOCK;
2400
2401 typedef struct magic MAGIC;
2402 typedef struct xpv XPV;
2403 typedef struct xpviv XPVIV;
2404 typedef struct xpvuv XPVUV;
2405 typedef struct xpvnv XPVNV;
2406 typedef struct xpvmg XPVMG;
2407 typedef struct xpvlv XPVLV;
2408 typedef struct xpvav XPVAV;
2409 typedef struct xpvhv XPVHV;
2410 typedef struct xpvgv XPVGV;
2411 typedef struct xpvcv XPVCV;
2412 typedef struct xpvbm XPVBM;
2413 typedef struct xpvfm XPVFM;
2414 typedef struct xpvio XPVIO;
2415 typedef struct mgvtbl MGVTBL;
2416 typedef union any ANY;
2417 typedef struct ptr_tbl_ent PTR_TBL_ENT_t;
2418 typedef struct ptr_tbl PTR_TBL_t;
2419 typedef struct clone_params CLONE_PARAMS;
2420
2421 #include "handy.h"
2422
2423 #if defined(USE_LARGE_FILES) && !defined(NO_64_BIT_RAWIO)
2424 #   if LSEEKSIZE == 8 && !defined(USE_64_BIT_RAWIO)
2425 #       define USE_64_BIT_RAWIO /* implicit */
2426 #   endif
2427 #endif
2428
2429 /* Notice the use of HAS_FSEEKO: now we are obligated to always use
2430  * fseeko/ftello if possible.  Don't go #defining ftell to ftello yourself,
2431  * however, because operating systems like to do that themself. */
2432 #ifndef FSEEKSIZE
2433 #   ifdef HAS_FSEEKO
2434 #       define FSEEKSIZE LSEEKSIZE
2435 #   else
2436 #       define FSEEKSIZE LONGSIZE
2437 #   endif
2438 #endif
2439
2440 #if defined(USE_LARGE_FILES) && !defined(NO_64_BIT_STDIO)
2441 #   if FSEEKSIZE == 8 && !defined(USE_64_BIT_STDIO)
2442 #       define USE_64_BIT_STDIO /* implicit */
2443 #   endif
2444 #endif
2445
2446 #ifdef USE_64_BIT_RAWIO
2447 #   ifdef HAS_OFF64_T
2448 #       undef Off_t
2449 #       define Off_t off64_t
2450 #       undef LSEEKSIZE
2451 #       define LSEEKSIZE 8
2452 #   endif
2453 /* Most 64-bit environments have defines like _LARGEFILE_SOURCE that
2454  * will trigger defines like the ones below.  Some 64-bit environments,
2455  * however, do not.  Therefore we have to explicitly mix and match. */
2456 #   if defined(USE_OPEN64)
2457 #       define open open64
2458 #   endif
2459 #   if defined(USE_LSEEK64)
2460 #       define lseek lseek64
2461 #   else
2462 #       if defined(USE_LLSEEK)
2463 #           define lseek llseek
2464 #       endif
2465 #   endif
2466 #   if defined(USE_STAT64)
2467 #       define stat stat64
2468 #   endif
2469 #   if defined(USE_FSTAT64)
2470 #       define fstat fstat64
2471 #   endif
2472 #   if defined(USE_LSTAT64)
2473 #       define lstat lstat64
2474 #   endif
2475 #   if defined(USE_FLOCK64)
2476 #       define flock flock64
2477 #   endif
2478 #   if defined(USE_LOCKF64)
2479 #       define lockf lockf64
2480 #   endif
2481 #   if defined(USE_FCNTL64)
2482 #       define fcntl fcntl64
2483 #   endif
2484 #   if defined(USE_TRUNCATE64)
2485 #       define truncate truncate64
2486 #   endif
2487 #   if defined(USE_FTRUNCATE64)
2488 #       define ftruncate ftruncate64
2489 #   endif
2490 #endif
2491
2492 #ifdef USE_64_BIT_STDIO
2493 #   ifdef HAS_FPOS64_T
2494 #       undef Fpos_t
2495 #       define Fpos_t fpos64_t
2496 #   endif
2497 /* Most 64-bit environments have defines like _LARGEFILE_SOURCE that
2498  * will trigger defines like the ones below.  Some 64-bit environments,
2499  * however, do not. */
2500 #   if defined(USE_FOPEN64)
2501 #       define fopen fopen64
2502 #   endif
2503 #   if defined(USE_FSEEK64)
2504 #       define fseek fseek64 /* don't do fseeko here, see perlio.c */
2505 #   endif
2506 #   if defined(USE_FTELL64)
2507 #       define ftell ftell64 /* don't do ftello here, see perlio.c */
2508 #   endif
2509 #   if defined(USE_FSETPOS64)
2510 #       define fsetpos fsetpos64
2511 #   endif
2512 #   if defined(USE_FGETPOS64)
2513 #       define fgetpos fgetpos64
2514 #   endif
2515 #   if defined(USE_TMPFILE64)
2516 #       define tmpfile tmpfile64
2517 #   endif
2518 #   if defined(USE_FREOPEN64)
2519 #       define freopen freopen64
2520 #   endif
2521 #endif
2522
2523 #if defined(OS2) || defined(MACOS_TRADITIONAL)
2524 #  include "iperlsys.h"
2525 #endif
2526
2527 #if defined(__OPEN_VM)
2528 #   include "vmesa/vmesaish.h"
2529 #   define ISHISH "vmesa"
2530 #endif
2531
2532 #ifdef DOSISH
2533 #   if defined(OS2)
2534 #       include "os2ish.h"
2535 #   else
2536 #       include "dosish.h"
2537 #   endif
2538 #   define ISHISH "dos"
2539 #endif
2540
2541 #if defined(VMS)
2542 #   include "vmsish.h"
2543 #   include "embed.h"
2544 #  ifndef PERL_MAD
2545 #    undef op_getmad
2546 #    define op_getmad(arg,pegop,slot) NOOP
2547 #  endif
2548 #   define ISHISH "vms"
2549 #endif
2550
2551 #if defined(PLAN9)
2552 #   include "./plan9/plan9ish.h"
2553 #   define ISHISH "plan9"
2554 #endif
2555
2556 #if defined(MPE)
2557 #  include "mpeix/mpeixish.h"
2558 #  define ISHISH "mpeix"
2559 #endif
2560
2561 #if defined(__VOS__)
2562 #   ifdef __GNUC__
2563 #     include "./vos/vosish.h"
2564 #   else
2565 #     include "vos/vosish.h"
2566 #   endif
2567 #   define ISHISH "vos"
2568 #endif
2569
2570 #if defined(EPOC)
2571 #   include "epocish.h"
2572 #   define ISHISH "epoc"
2573 #endif
2574
2575 #ifdef __SYMBIAN32__
2576 #   include "symbian/symbianish.h"
2577 #   include "embed.h"
2578 #  ifndef PERL_MAD
2579 #    undef op_getmad
2580 #    define op_getmad(arg,pegop,slot) NOOP
2581 #  endif
2582 #   define ISHISH "symbian"
2583 #endif
2584
2585 #if defined(MACOS_TRADITIONAL)
2586 #   include "macos/macish.h"
2587 #   ifndef NO_ENVIRON_ARRAY
2588 #       define NO_ENVIRON_ARRAY
2589 #   endif
2590 #   define ISHISH "macos classic"
2591 #endif
2592
2593 #if defined(__HAIKU__)
2594 #   include "haiku/haikuish.h"
2595 #   define ISHISH "haiku"
2596 #elif defined(__BEOS__)
2597 #   include "beos/beosish.h"
2598 #   define ISHISH "beos"
2599 #endif
2600
2601 #ifndef ISHISH
2602 #   include "unixish.h"
2603 #   define ISHISH "unix"
2604 #endif
2605
2606 /* NSIG logic from Configure --> */
2607 /* Strange style to avoid deeply-nested #if/#else/#endif */
2608 #ifndef NSIG
2609 #  ifdef _NSIG
2610 #    define NSIG (_NSIG)
2611 #  endif
2612 #endif
2613
2614 #ifndef NSIG
2615 #  ifdef SIGMAX
2616 #    define NSIG (SIGMAX+1)
2617 #  endif
2618 #endif
2619
2620 #ifndef NSIG
2621 #  ifdef SIG_MAX
2622 #    define NSIG (SIG_MAX+1)
2623 #  endif
2624 #endif
2625
2626 #ifndef NSIG
2627 #  ifdef _SIG_MAX
2628 #    define NSIG (_SIG_MAX+1)
2629 #  endif
2630 #endif
2631
2632 #ifndef NSIG
2633 #  ifdef MAXSIG
2634 #    define NSIG (MAXSIG+1)
2635 #  endif
2636 #endif
2637
2638 #ifndef NSIG
2639 #  ifdef MAX_SIG
2640 #    define NSIG (MAX_SIG+1)
2641 #  endif
2642 #endif
2643
2644 #ifndef NSIG
2645 #  ifdef SIGARRAYSIZE
2646 #    define NSIG SIGARRAYSIZE /* Assume ary[SIGARRAYSIZE] */
2647 #  endif
2648 #endif
2649
2650 #ifndef NSIG
2651 #  ifdef _sys_nsig
2652 #    define NSIG (_sys_nsig) /* Solaris 2.5 */
2653 #  endif
2654 #endif
2655
2656 /* Default to some arbitrary number that's big enough to get most
2657    of the common signals.
2658 */
2659 #ifndef NSIG
2660 #    define NSIG 50
2661 #endif
2662 /* <-- NSIG logic from Configure */
2663
2664 #ifndef NO_ENVIRON_ARRAY
2665 #  define USE_ENVIRON_ARRAY
2666 #endif
2667
2668 /*
2669  * initialise to avoid floating-point exceptions from overflow, etc
2670  */
2671 #ifndef PERL_FPU_INIT
2672 #  ifdef HAS_FPSETMASK
2673 #    if HAS_FLOATINGPOINT_H
2674 #      include <floatingpoint.h>
2675 #    endif
2676 /* Some operating systems have this as a macro, which in turn expands to a comma
2677    expression, and the last sub-expression is something that gets calculated,
2678    and then they have the gall to warn that a value computed is not used. Hence
2679    cast to void.  */
2680 #    define PERL_FPU_INIT (void)fpsetmask(0)
2681 #  else
2682 #    if defined(SIGFPE) && defined(SIG_IGN) && !defined(PERL_MICRO)
2683 #      define PERL_FPU_INIT       PL_sigfpe_saved = (Sighandler_t) signal(SIGFPE, SIG_IGN)
2684 #      define PERL_FPU_PRE_EXEC   { Sigsave_t xfpe; rsignal_save(SIGFPE, PL_sigfpe_saved, &xfpe);
2685 #      define PERL_FPU_POST_EXEC    rsignal_restore(SIGFPE, &xfpe); }
2686 #    else
2687 #      define PERL_FPU_INIT
2688
2689 #    endif
2690 #  endif
2691 #endif
2692 #ifndef PERL_FPU_PRE_EXEC
2693 #  define PERL_FPU_PRE_EXEC   {
2694 #  define PERL_FPU_POST_EXEC  }
2695 #endif
2696
2697 #ifndef PERL_SYS_INIT3_BODY
2698 #  define PERL_SYS_INIT3_BODY(argvp,argcp,envp) PERL_SYS_INIT_BODY(argvp,argcp)
2699 #endif
2700
2701 #define PERL_SYS_INIT(argc, argv)       Perl_sys_init(argc, argv)
2702 #define PERL_SYS_INIT3(argc, argv, env) Perl_sys_init3(argc, argv, env)
2703 #define PERL_SYS_TERM()                 Perl_sys_term()
2704
2705 #ifndef PERL_WRITE_MSG_TO_CONSOLE
2706 #  define PERL_WRITE_MSG_TO_CONSOLE(io, msg, len) PerlIO_write(io, msg, len)
2707 #endif
2708
2709 #ifndef MAXPATHLEN
2710 #  ifdef PATH_MAX
2711 #    ifdef _POSIX_PATH_MAX
2712 #       if PATH_MAX > _POSIX_PATH_MAX
2713 /* POSIX 1990 (and pre) was ambiguous about whether PATH_MAX
2714  * included the null byte or not.  Later amendments of POSIX,
2715  * XPG4, the Austin Group, and the Single UNIX Specification
2716  * all explicitly include the null byte in the PATH_MAX.
2717  * Ditto for _POSIX_PATH_MAX. */
2718 #         define MAXPATHLEN PATH_MAX
2719 #       else
2720 #         define MAXPATHLEN _POSIX_PATH_MAX
2721 #       endif
2722 #    else
2723 #      define MAXPATHLEN (PATH_MAX+1)
2724 #    endif
2725 #  else
2726 #    ifdef _POSIX_PATH_MAX
2727 #       define MAXPATHLEN _POSIX_PATH_MAX
2728 #    else
2729 #       define MAXPATHLEN 1024  /* Err on the large side. */
2730 #    endif
2731 #  endif
2732 #endif
2733
2734 /* In case Configure was not used (we are using a "canned config"
2735  * such as Win32, or a cross-compilation setup, for example) try going
2736  * by the gcc major and minor versions.  One useful URL is
2737  * http://www.ohse.de/uwe/articles/gcc-attributes.html,
2738  * but contrary to this information warn_unused_result seems
2739  * not to be in gcc 3.3.5, at least. --jhi
2740  * Also, when building extensions with an installed perl, this allows
2741  * the user to upgrade gcc and get the right attributes, rather than
2742  * relying on the list generated at Configure time.  --AD
2743  * Set these up now otherwise we get confused when some of the <*thread.h>
2744  * includes below indirectly pull in <perlio.h> (which needs to know if we
2745  * have HASATTRIBUTE_FORMAT).
2746  */
2747
2748 #ifndef PERL_MICRO
2749 #if defined __GNUC__ && !defined(__INTEL_COMPILER)
2750 #  if __GNUC__ == 3 && __GNUC_MINOR__ >= 1 || __GNUC__ > 3 /* 3.1 -> */
2751 #    define HASATTRIBUTE_DEPRECATED
2752 #  endif
2753 #  if __GNUC__ >= 3 /* 3.0 -> */ /* XXX Verify this version */
2754 #    define HASATTRIBUTE_FORMAT
2755 #    if defined __MINGW32__
2756 #      define PRINTF_FORMAT_NULL_OK
2757 #    endif
2758 #  endif
2759 #  if __GNUC__ >= 3 /* 3.0 -> */
2760 #    define HASATTRIBUTE_MALLOC
2761 #  endif
2762 #  if __GNUC__ == 3 && __GNUC_MINOR__ >= 3 || __GNUC__ > 3 /* 3.3 -> */
2763 #    define HASATTRIBUTE_NONNULL
2764 #  endif
2765 #  if __GNUC__ == 2 && __GNUC_MINOR__ >= 5 || __GNUC__ > 2 /* 2.5 -> */
2766 #    define HASATTRIBUTE_NORETURN
2767 #  endif
2768 #  if __GNUC__ >= 3 /* gcc 3.0 -> */
2769 #    define HASATTRIBUTE_PURE
2770 #  endif
2771 #  if __GNUC__ == 3 && __GNUC_MINOR__ >= 4 || __GNUC__ > 3 /* 3.4 -> */
2772 #    define HASATTRIBUTE_UNUSED
2773 #  endif
2774 #  if __GNUC__ == 3 && __GNUC_MINOR__ == 3 && !defined(__cplusplus)
2775 #    define HASATTRIBUTE_UNUSED /* gcc-3.3, but not g++-3.3. */
2776 #  endif
2777 #  if __GNUC__ == 3 && __GNUC_MINOR__ >= 4 || __GNUC__ > 3 /* 3.4 -> */
2778 #    define HASATTRIBUTE_WARN_UNUSED_RESULT
2779 #  endif
2780 #endif
2781 #endif /* #ifndef PERL_MICRO */ 
2782
2783 /* USE_5005THREADS needs to be after unixish.h as <pthread.h> includes
2784  * <sys/signal.h> which defines NSIG - which will stop inclusion of <signal.h>
2785  * this results in many functions being undeclared which bothers C++
2786  * May make sense to have threads after "*ish.h" anyway
2787  */
2788
2789 #if defined(USE_ITHREADS)
2790 #  ifdef NETWARE
2791 #   include <nw5thread.h>
2792 #  else
2793 #  ifdef FAKE_THREADS
2794 #    include "fakethr.h"
2795 #  else
2796 #    ifdef WIN32
2797 #      include <win32thread.h>
2798 #    else
2799 #      ifdef OS2
2800 #        include "os2thread.h"
2801 #      else
2802 #        ifdef I_MACH_CTHREADS
2803 #          include <mach/cthreads.h>
2804 #          if (defined(NeXT) || defined(__NeXT__)) && defined(PERL_POLLUTE_MALLOC)
2805 #            define MUTEX_INIT_CALLS_MALLOC
2806 #          endif
2807 typedef cthread_t       perl_os_thread;
2808 typedef mutex_t         perl_mutex;
2809 typedef condition_t     perl_cond;
2810 typedef void *          perl_key;
2811 #        else /* Posix threads */
2812 #          ifdef I_PTHREAD
2813 #            include <pthread.h>
2814 #          endif
2815 typedef pthread_t       perl_os_thread;
2816 typedef pthread_mutex_t perl_mutex;
2817 typedef pthread_cond_t  perl_cond;
2818 typedef pthread_key_t   perl_key;
2819 #        endif /* I_MACH_CTHREADS */
2820 #      endif /* OS2 */
2821 #    endif /* WIN32 */
2822 #  endif /* FAKE_THREADS */
2823 #endif  /* NETWARE */
2824 #endif /* USE_ITHREADS */
2825
2826 #if defined(WIN32)
2827 #  include "win32.h"
2828 #endif
2829
2830 #ifdef NETWARE
2831 #  include "netware.h"
2832 #endif
2833
2834 #define STATUS_UNIX     PL_statusvalue
2835 #ifdef VMS
2836 #   define STATUS_NATIVE        PL_statusvalue_vms
2837 /*
2838  * vaxc$errno is only guaranteed to be valid if errno == EVMSERR, otherwise
2839  * its contents can not be trusted.  Unfortunately, Perl seems to check
2840  * it on exit, so it when PL_statusvalue_vms is updated, vaxc$errno should
2841  * be updated also.
2842  */
2843 #  include <stsdef.h>
2844 #  include <ssdef.h>
2845 /* Presume this because if VMS changes it, it will require a new
2846  * set of APIs for waiting on children for binary compatibility.
2847  */
2848 #  define child_offset_bits (8)
2849 #  ifndef C_FAC_POSIX
2850 #  define C_FAC_POSIX 0x35A000
2851 #  endif
2852
2853 /*  STATUS_EXIT - validates and returns a NATIVE exit status code for the
2854  * platform from the existing UNIX or Native status values.
2855  */
2856
2857 #   define STATUS_EXIT \
2858         (((I32)PL_statusvalue_vms == -1 ? SS$_ABORT : PL_statusvalue_vms) | \
2859            (VMSISH_HUSHED ? STS$M_INHIB_MSG : 0))
2860
2861
2862 /* STATUS_NATIVE_CHILD_SET - Calculate UNIX status that matches the child
2863  * exit code and shifts the UNIX value over the correct number of bits to
2864  * be a child status.  Usually the number of bits is 8, but that could be
2865  * platform dependent.  The NATIVE status code is presumed to have either
2866  * from a child process.
2867  */
2868
2869 /* This is complicated.  The child processes return a true native VMS
2870    status which must be saved.  But there is an assumption in Perl that
2871    the UNIX child status has some relationship to errno values, so
2872    Perl tries to translate it to text in some of the tests.  
2873    In order to get the string translation correct, for the error, errno
2874    must be EVMSERR, but that generates a different text message
2875    than what the test programs are expecting.  So an errno value must
2876    be derived from the native status value when an error occurs.
2877    That will hide the true native status message.  With this version of
2878    perl, the true native child status can always be retrieved so that
2879    is not a problem.  But in this case, Pl_statusvalue and errno may
2880    have different values in them.
2881  */
2882
2883 #   define STATUS_NATIVE_CHILD_SET(n) \
2884         STMT_START {                                                    \
2885             I32 evalue = (I32)n;                                        \
2886             if (evalue == EVMSERR) {                                    \
2887               PL_statusvalue_vms = vaxc$errno;                          \
2888               PL_statusvalue = evalue;                                  \
2889             } else {                                                    \
2890               PL_statusvalue_vms = evalue;                              \
2891               if (evalue == -1) {                                       \
2892                 PL_statusvalue = -1;                                    \
2893                 PL_statusvalue_vms = SS$_ABORT; /* Should not happen */ \
2894               } else                                                    \
2895                 PL_statusvalue = Perl_vms_status_to_unix(evalue, 1);    \
2896               set_vaxc_errno(evalue);                                   \
2897               if ((PL_statusvalue_vms & C_FAC_POSIX) == C_FAC_POSIX)    \
2898                   set_errno(EVMSERR);                                   \
2899               else set_errno(Perl_vms_status_to_unix(evalue, 0));       \
2900               PL_statusvalue = PL_statusvalue << child_offset_bits;     \
2901             }                                                           \
2902         } STMT_END
2903
2904 #   ifdef VMSISH_STATUS
2905 #       define STATUS_CURRENT   (VMSISH_STATUS ? STATUS_NATIVE : STATUS_UNIX)
2906 #   else
2907 #       define STATUS_CURRENT   STATUS_UNIX
2908 #   endif
2909
2910   /* STATUS_UNIX_SET - takes a UNIX/POSIX errno value and attempts to update
2911    * the NATIVE status to an equivalent value.  Can not be used to translate
2912    * exit code values as exit code values are not guaranteed to have any
2913    * relationship at all to errno values.
2914    * This is used when Perl is forcing errno to have a specific value.
2915    */
2916 #   define STATUS_UNIX_SET(n)                           \
2917         STMT_START {                                    \
2918             I32 evalue = (I32)n;                        \
2919             PL_statusvalue = evalue;                    \
2920             if (PL_statusvalue != -1) {                 \
2921                 if (PL_statusvalue != EVMSERR) {        \
2922                   PL_statusvalue &= 0xFFFF;             \
2923                   if (MY_POSIX_EXIT)                    \
2924                     PL_statusvalue_vms=PL_statusvalue ? SS$_ABORT : SS$_NORMAL;\
2925                   else PL_statusvalue_vms = Perl_unix_status_to_vms(evalue); \
2926                 }                                       \
2927                 else {                                  \
2928                   PL_statusvalue_vms = vaxc$errno;      \
2929                 }                                       \
2930             }                                           \
2931             else PL_statusvalue_vms = SS$_ABORT;        \
2932             set_vaxc_errno(PL_statusvalue_vms);         \
2933         } STMT_END
2934
2935   /* STATUS_UNIX_EXIT_SET - Takes a UNIX/POSIX exit code and sets
2936    * the NATIVE error status based on it.
2937    *
2938    * When in the default mode to comply with the Perl VMS documentation,
2939    * 0 is a success and any other code sets the NATIVE status to a failure
2940    * code of SS$_ABORT.
2941    *
2942    * In the new POSIX EXIT mode, native status will be set so that the
2943    * actual exit code will can be retrieved by the calling program or
2944    * shell.
2945    *
2946    * If the exit code is not clearly a UNIX parent or child exit status,
2947    * it will be passed through as a VMS status.
2948    */
2949
2950 #   define STATUS_UNIX_EXIT_SET(n)                      \
2951         STMT_START {                                    \
2952             I32 evalue = (I32)n;                        \
2953             PL_statusvalue = evalue;                    \
2954             if (MY_POSIX_EXIT) { \
2955               if (evalue <= 0xFF00) {           \
2956                   if (evalue > 0xFF)                    \
2957                     evalue = (evalue >> child_offset_bits) & 0xFF; \
2958                   PL_statusvalue_vms =          \
2959                     (C_FAC_POSIX | (evalue << 3 ) |     \
2960                     ((evalue == 1) ? (STS$K_ERROR | STS$M_INHIB_MSG) : 1)); \
2961               } else /* forgive them Perl, for they have sinned */ \
2962                 PL_statusvalue_vms = evalue; \
2963             } else { \
2964               if (evalue == 0)                  \
2965                 PL_statusvalue_vms = SS$_NORMAL;        \
2966               else if (evalue <= 0xFF00) \
2967                 PL_statusvalue_vms = SS$_ABORT; \
2968               else { /* forgive them Perl, for they have sinned */ \
2969                   if (evalue != EVMSERR) PL_statusvalue_vms = evalue; \
2970                   else PL_statusvalue_vms = vaxc$errno; \
2971                   /* And obviously used a VMS status value instead of UNIX */ \
2972                   PL_statusvalue = EVMSERR;             \
2973               } \
2974               set_vaxc_errno(PL_statusvalue_vms);       \
2975             }                                           \
2976         } STMT_END
2977
2978
2979   /* STATUS_EXIT_SET - Takes a NATIVE/UNIX/POSIX exit code
2980    * and sets the NATIVE error status based on it.  This special case
2981    * is needed to maintain compatibility with past VMS behavior.
2982    *
2983    * In the default mode on VMS, this number is passed through as
2984    * both the NATIVE and UNIX status.  Which makes it different
2985    * that the STATUS_UNIX_EXIT_SET.
2986    *
2987    * In the new POSIX EXIT mode, native status will be set so that the
2988    * actual exit code will can be retrieved by the calling program or
2989    * shell.
2990    *
2991    * A POSIX exit code is from 0 to 255.  If the exit code is higher
2992    * than this, it needs to be assumed that it is a VMS exit code and
2993    * passed through.
2994    */
2995
2996 #   define STATUS_EXIT_SET(n)                           \
2997         STMT_START {                                    \
2998             I32 evalue = (I32)n;                        \
2999             PL_statusvalue = evalue;                    \
3000             if (MY_POSIX_EXIT)                          \
3001                 if (evalue > 255) PL_statusvalue_vms = evalue; else {   \
3002                   PL_statusvalue_vms = \
3003                     (C_FAC_POSIX | (evalue << 3 ) |     \
3004                      ((evalue == 1) ? (STS$K_ERROR | STS$M_INHIB_MSG) : 1));} \
3005             else                                        \
3006                 PL_statusvalue_vms = evalue ? evalue : SS$_NORMAL; \
3007             set_vaxc_errno(PL_statusvalue_vms);         \
3008         } STMT_END
3009
3010
3011  /* This macro forces a success status */
3012 #   define STATUS_ALL_SUCCESS   \
3013         (PL_statusvalue = 0, PL_statusvalue_vms = SS$_NORMAL)
3014
3015  /* This macro forces a failure status */
3016 #   define STATUS_ALL_FAILURE   (PL_statusvalue = 1, \
3017      vaxc$errno = PL_statusvalue_vms = MY_POSIX_EXIT ? \
3018         (C_FAC_POSIX | (1 << 3) | STS$K_ERROR | STS$M_INHIB_MSG) : SS$_ABORT)
3019
3020 #else
3021 #   define STATUS_NATIVE        PL_statusvalue_posix
3022 #   if defined(WCOREDUMP)
3023 #       define STATUS_NATIVE_CHILD_SET(n)                  \
3024             STMT_START {                                   \
3025                 PL_statusvalue_posix = (n);                \
3026                 if (PL_statusvalue_posix == -1)            \
3027                     PL_statusvalue = -1;                   \
3028                 else {                                     \
3029                     PL_statusvalue =                       \
3030                         (WIFEXITED(PL_statusvalue_posix) ? (WEXITSTATUS(PL_statusvalue_posix) << 8) : 0) |  \
3031                         (WIFSIGNALED(PL_statusvalue_posix) ? (WTERMSIG(PL_statusvalue_posix) & 0x7F) : 0) | \
3032                         (WIFSIGNALED(PL_statusvalue_posix) && WCOREDUMP(PL_statusvalue_posix) ? 0x80 : 0);  \
3033                 }                                          \
3034             } STMT_END
3035 #   elif defined(WIFEXITED)
3036 #       define STATUS_NATIVE_CHILD_SET(n)                  \
3037             STMT_START {                                   \
3038                 PL_statusvalue_posix = (n);                \
3039                 if (PL_statusvalue_posix == -1)            \
3040                     PL_statusvalue = -1;                   \
3041                 else {                                     \
3042                     PL_statusvalue =                       \
3043                         (WIFEXITED(PL_statusvalue_posix) ? (WEXITSTATUS(PL_statusvalue_posix) << 8) : 0) |  \
3044                         (WIFSIGNALED(PL_statusvalue_posix) ? (WTERMSIG(PL_statusvalue_posix) & 0x7F) : 0);  \
3045                 }                                          \
3046             } STMT_END
3047 #   else
3048 #       define STATUS_NATIVE_CHILD_SET(n)                  \
3049             STMT_START {                                   \
3050                 PL_statusvalue_posix = (n);                \
3051                 if (PL_statusvalue_posix == -1)            \
3052                     PL_statusvalue = -1;                   \
3053                 else {                                     \
3054                     PL_statusvalue =                       \
3055                         PL_statusvalue_posix & 0xFFFF;     \
3056                 }                                          \
3057             } STMT_END
3058 #   endif
3059 #   define STATUS_UNIX_SET(n)           \
3060         STMT_START {                    \
3061             PL_statusvalue = (n);               \
3062             if (PL_statusvalue != -1)   \
3063                 PL_statusvalue &= 0xFFFF;       \
3064         } STMT_END
3065 #   define STATUS_UNIX_EXIT_SET(n) STATUS_UNIX_SET(n)
3066 #   define STATUS_EXIT_SET(n) STATUS_UNIX_SET(n)
3067 #   define STATUS_CURRENT STATUS_UNIX
3068 #   define STATUS_EXIT STATUS_UNIX
3069 #   define STATUS_ALL_SUCCESS   (PL_statusvalue = 0, PL_statusvalue_posix = 0)
3070 #   define STATUS_ALL_FAILURE   (PL_statusvalue = 1, PL_statusvalue_posix = 1)
3071 #endif
3072
3073 /* flags in PL_exit_flags for nature of exit() */
3074 #define PERL_EXIT_EXPECTED      0x01
3075 #define PERL_EXIT_DESTRUCT_END  0x02  /* Run END in perl_destruct */
3076
3077 #ifndef MEMBER_TO_FPTR
3078 #  define MEMBER_TO_FPTR(name)          name
3079 #endif
3080
3081 /* format to use for version numbers in file/directory names */
3082 /* XXX move to Configure? */
3083 #ifndef PERL_FS_VER_FMT
3084 #  define PERL_FS_VER_FMT       "%d.%d.%d"
3085 #endif
3086
3087 /* This defines a way to flush all output buffers.  This may be a
3088  * performance issue, so we allow people to disable it.  Also, if
3089  * we are using stdio, there are broken implementations of fflush(NULL)
3090  * out there, Solaris being the most prominent.
3091  */
3092 #ifndef PERL_FLUSHALL_FOR_CHILD
3093 # if defined(USE_PERLIO) || defined(FFLUSH_NULL) || defined(USE_SFIO)
3094 #  define PERL_FLUSHALL_FOR_CHILD       PerlIO_flush((PerlIO*)NULL)
3095 # else
3096 #  ifdef FFLUSH_ALL
3097 #   define PERL_FLUSHALL_FOR_CHILD      my_fflush_all()
3098 #  else
3099 #   define PERL_FLUSHALL_FOR_CHILD      NOOP
3100 #  endif
3101 # endif
3102 #endif
3103
3104 #ifndef PERL_WAIT_FOR_CHILDREN
3105 #  define PERL_WAIT_FOR_CHILDREN        NOOP
3106 #endif
3107
3108 /* the traditional thread-unsafe notion of "current interpreter". */
3109 #ifndef PERL_SET_INTERP
3110 #  define PERL_SET_INTERP(i)            (PL_curinterp = (PerlInterpreter*)(i))
3111 #endif
3112
3113 #ifndef PERL_GET_INTERP
3114 #  define PERL_GET_INTERP               (PL_curinterp)
3115 #endif
3116
3117 #if defined(PERL_IMPLICIT_CONTEXT) && !defined(PERL_GET_THX)
3118 #  ifdef MULTIPLICITY
3119 #    define PERL_GET_THX                ((PerlInterpreter *)PERL_GET_CONTEXT)
3120 #  endif
3121 #  define PERL_SET_THX(t)               PERL_SET_CONTEXT(t)
3122 #endif
3123
3124 /* 
3125     This replaces the previous %_ "hack" by the "%p" hacks.
3126     All that is required is that the perl source does not
3127     use "%-p" or "%-<number>p" or "%<number>p" formats.  
3128     These formats will still work in perl code.   
3129     See comments in sv.c for futher details.
3130
3131     Robin Barker 2005-07-14
3132
3133     No longer use %1p for VDf = %vd.  RMB 2007-10-19 
3134 */
3135
3136 #ifndef SVf_
3137 #  define SVf_(n) "-" STRINGIFY(n) "p"
3138 #endif
3139
3140 #ifndef SVf
3141 #  define SVf "-p"
3142 #endif
3143
3144 #ifndef SVf32
3145 #  define SVf32 SVf_(32)
3146 #endif
3147
3148 #ifndef SVf256
3149 #  define SVf256 SVf_(256)
3150 #endif
3151
3152 #define SVfARG(p) ((void*)(p))
3153
3154 #ifdef PERL_CORE
3155 /* not used; but needed for backward compatibilty with XS code? - RMB */ 
3156 #  undef VDf
3157 #else
3158 #  ifndef VDf
3159 #    define VDf "vd"
3160 #  endif
3161 #endif
3162
3163 #ifdef PERL_CORE
3164 /* not used; but needed for backward compatibilty with XS code? - RMB */ 
3165 #  undef UVf
3166 #else
3167 #  ifndef UVf
3168 #    define UVf UVuf
3169 #  endif
3170 #endif
3171
3172 #ifdef HASATTRIBUTE_DEPRECATED
3173 #  define __attribute__deprecated__         __attribute__((deprecated))
3174 #endif
3175 #ifdef HASATTRIBUTE_FORMAT
3176 #  define __attribute__format__(x,y,z)      __attribute__((format(x,y,z)))
3177 #endif
3178 #ifdef HASATTRIBUTE_MALLOC
3179 #  define __attribute__malloc__             __attribute__((__malloc__))
3180 #endif
3181 #ifdef HASATTRIBUTE_NONNULL
3182 #  define __attribute__nonnull__(a)         __attribute__((nonnull(a)))
3183 #endif
3184 #ifdef HASATTRIBUTE_NORETURN
3185 #  define __attribute__noreturn__           __attribute__((noreturn))
3186 #endif
3187 #ifdef HASATTRIBUTE_PURE
3188 #  define __attribute__pure__               __attribute__((pure))
3189 #endif
3190 #ifdef HASATTRIBUTE_UNUSED
3191 #  define __attribute__unused__             __attribute__((unused))
3192 #endif
3193 #ifdef HASATTRIBUTE_WARN_UNUSED_RESULT
3194 #  define __attribute__warn_unused_result__ __attribute__((warn_unused_result))
3195 #endif
3196
3197 /* If we haven't defined the attributes yet, define them to blank. */
3198 #ifndef __attribute__deprecated__
3199 #  define __attribute__deprecated__
3200 #endif
3201 #ifndef __attribute__format__
3202 #  define __attribute__format__(x,y,z)
3203 #endif
3204 #ifndef __attribute__malloc__
3205 #  define __attribute__malloc__
3206 #endif
3207 #ifndef __attribute__nonnull__
3208 #  define __attribute__nonnull__(a)
3209 #endif
3210 #ifndef __attribute__noreturn__
3211 #  define __attribute__noreturn__
3212 #endif
3213 #ifndef __attribute__pure__
3214 #  define __attribute__pure__
3215 #endif
3216 #ifndef __attribute__unused__
3217 #  define __attribute__unused__
3218 #endif
3219 #ifndef __attribute__warn_unused_result__
3220 #  define __attribute__warn_unused_result__
3221 #endif
3222
3223 /* For functions that are marked as __attribute__noreturn__, it's not
3224    appropriate to call return.  In either case, include the lint directive.
3225  */
3226 #ifdef HASATTRIBUTE_NORETURN
3227 #  define NORETURN_FUNCTION_END /* NOTREACHED */
3228 #else
3229 #  define NORETURN_FUNCTION_END /* NOTREACHED */ return 0
3230 #endif
3231
3232 /* Some OS warn on NULL format to printf */
3233 #ifdef PRINTF_FORMAT_NULL_OK
3234 #  define __attribute__format__null_ok__(x,y,z)  __attribute__format__(x,y,z)
3235 #else
3236 #  define __attribute__format__null_ok__(x,y,z)  
3237 #endif
3238
3239 #ifdef HAS_BUILTIN_EXPECT
3240 #  define EXPECT(expr,val)                  __builtin_expect(expr,val)
3241 #else
3242 #  define EXPECT(expr,val)                  (expr)
3243 #endif
3244 #define LIKELY(cond)                        EXPECT(cond,1)
3245 #define UNLIKELY(cond)                      EXPECT(cond,0)
3246 #ifdef HAS_BUILTIN_CHOOSE_EXPR
3247 /* placeholder */
3248 #endif
3249
3250 /* Some unistd.h's give a prototype for pause() even though
3251    HAS_PAUSE ends up undefined.  This causes the #define
3252    below to be rejected by the compiler.  Sigh.
3253 */
3254 #ifdef HAS_PAUSE
3255 #define Pause   pause
3256 #else
3257 #define Pause() sleep((32767<<16)+32767)
3258 #endif
3259
3260 #ifndef IOCPARM_LEN
3261 #   ifdef IOCPARM_MASK
3262         /* on BSDish systems we're safe */
3263 #       define IOCPARM_LEN(x)  (((x) >> 16) & IOCPARM_MASK)
3264 #   else
3265 #       if defined(_IOC_SIZE) && defined(__GLIBC__)
3266         /* on Linux systems we're safe; except when we're not [perl #38223] */
3267 #           define IOCPARM_LEN(x) (_IOC_SIZE(x) < 256 ? 256 : _IOC_SIZE(x))
3268 #       else
3269         /* otherwise guess at what's safe */
3270 #           define IOCPARM_LEN(x)       256
3271 #       endif
3272 #   endif
3273 #endif
3274
3275 #if defined(__CYGWIN__)
3276 /* USEMYBINMODE
3277  *   This symbol, if defined, indicates that the program should
3278  *   use the routine my_binmode(FILE *fp, char iotype, int mode) to insure
3279  *   that a file is in "binary" mode -- that is, that no translation
3280  *   of bytes occurs on read or write operations.
3281  */
3282 #  define USEMYBINMODE /**/
3283 #  include <io.h> /* for setmode() prototype */
3284 #  define my_binmode(fp, iotype, mode) \
3285             (PerlLIO_setmode(fileno(fp), mode) != -1 ? TRUE : FALSE)
3286 #endif
3287
3288 #ifdef __CYGWIN__
3289 void init_os_extras(void);
3290 #endif
3291
3292 #ifdef UNION_ANY_DEFINITION
3293 UNION_ANY_DEFINITION;
3294 #else
3295 union any {
3296     void*       any_ptr;
3297     I32         any_i32;
3298     IV          any_iv;
3299     long        any_long;
3300     bool        any_bool;
3301     void        (*any_dptr) (void*);
3302     void        (*any_dxptr) (pTHX_ void*);
3303 };
3304 #endif
3305
3306 typedef I32 (*filter_t) (pTHX_ int, SV *, int);
3307
3308 #define FILTER_READ(idx, sv, len)  filter_read(idx, sv, len)
3309 #define FILTER_DATA(idx) \
3310             (PL_parser ? AvARRAY(PL_parser->rsfp_filters)[idx] : NULL)
3311 #define FILTER_ISREADER(idx) \
3312             (PL_parser && PL_parser->rsfp_filters \
3313                 && idx >= AvFILLp(PL_parser->rsfp_filters))
3314 #define PERL_FILTER_EXISTS(i) \
3315             (PL_parser && PL_parser->rsfp_filters \
3316                 && (i) <= av_len(PL_parser->rsfp_filters))
3317
3318 #if defined(_AIX) && !defined(_AIX43)
3319 #if defined(USE_REENTRANT) || defined(_REENTRANT) || defined(_THREAD_SAFE)
3320 /* We cannot include <crypt.h> to get the struct crypt_data
3321  * because of setkey prototype problems when threading */
3322 typedef        struct crypt_data {     /* straight from /usr/include/crypt.h */
3323     /* From OSF, Not needed in AIX
3324        char C[28], D[28];
3325     */
3326     char E[48];
3327     char KS[16][48];
3328     char block[66];
3329     char iobuf[16];
3330 } CRYPTD;
3331 #endif /* threading */
3332 #endif /* AIX */
3333
3334 #if !defined(OS2) && !defined(MACOS_TRADITIONAL)
3335 #  include "iperlsys.h"
3336 #endif
3337
3338 #ifdef __LIBCATAMOUNT__
3339 #undef HAS_PASSWD  /* unixish.h but not unixish enough. */ 
3340 #undef HAS_GROUP
3341 #define FAKE_BIT_BUCKET
3342 #endif
3343
3344 /* [perl #22371] Algorimic Complexity Attack on Perl 5.6.1, 5.8.0.
3345  * Note that the USE_HASH_SEED and USE_HASH_SEED_EXPLICIT are *NOT*
3346  * defined by Configure, despite their names being similar to the
3347  * other defines like USE_ITHREADS.  Configure in fact knows nothing
3348  * about the randomised hashes.  Therefore to enable/disable the hash
3349  * randomisation defines use the Configure -Accflags=... instead. */
3350 #if !defined(NO_HASH_SEED) && !defined(USE_HASH_SEED) && !defined(USE_HASH_SEED_EXPLICIT)
3351 #  define USE_HASH_SEED
3352 #endif
3353
3354 /* Win32 defines a type 'WORD' in windef.h. This conflicts with the enumerator
3355  * 'WORD' defined in perly.h. The yytokentype enum is only a debugging aid, so
3356  * it's not really needed.
3357  */
3358 #if defined(WIN32)
3359 #  define YYTOKENTYPE
3360 #endif
3361 #include "perly.h"
3362
3363 #ifdef PERL_MAD
3364 struct nexttoken {
3365     YYSTYPE next_val;   /* value of next token, if any */
3366     I32 next_type;      /* type of next token */
3367     MADPROP *next_mad;  /* everything else about that token */
3368 };
3369 #endif
3370
3371 /* macros to define bit-fields in structs. */
3372 #ifndef PERL_BITFIELD8
3373 #  define PERL_BITFIELD8 unsigned
3374 #endif
3375 #ifndef PERL_BITFIELD16
3376 #  define PERL_BITFIELD16 unsigned
3377 #endif
3378 #ifndef PERL_BITFIELD32
3379 #  define PERL_BITFIELD32 unsigned
3380 #endif
3381
3382 #include "sv.h"
3383 #include "regexp.h"
3384 #include "util.h"
3385 #include "form.h"
3386 #include "gv.h"
3387 #include "pad.h"
3388 #include "cv.h"
3389 #include "opnames.h"
3390 #include "op.h"
3391 #include "hv.h"
3392 #include "cop.h"
3393 #include "av.h"
3394 #include "mg.h"
3395 #include "scope.h"
3396 #include "warnings.h"
3397 #include "utf8.h"
3398
3399 /* defined in sv.c, but also used in [ach]v.c */
3400 #undef _XPV_ALLOCATED_HEAD
3401 #undef _XPV_HEAD
3402 #undef _XPVMG_HEAD
3403 #undef _XPVCV_COMMON
3404
3405 typedef struct _sublex_info SUBLEXINFO;
3406 struct _sublex_info {
3407     U8 super_state;     /* lexer state to save */
3408     U16 sub_inwhat;     /* "lex_inwhat" to use */
3409     OP *sub_op;         /* "lex_op" to use */
3410     char *super_bufptr; /* PL_parser->bufptr that was */
3411     char *super_bufend; /* PL_parser->bufend that was */
3412 };
3413
3414 #include "parser.h"
3415
3416 typedef struct magic_state MGS; /* struct magic_state defined in mg.c */
3417
3418 struct scan_data_t;             /* Used in S_* functions in regcomp.c */
3419 struct regnode_charclass_class; /* Used in S_* functions in regcomp.c */
3420
3421 /* Keep next first in this structure, because sv_free_arenas take
3422    advantage of this to share code between the pte arenas and the SV
3423    body arenas  */
3424 struct ptr_tbl_ent {
3425     struct ptr_tbl_ent*         next;
3426     const void*                 oldval;
3427     void*                       newval;
3428 };
3429
3430 struct ptr_tbl {
3431     struct ptr_tbl_ent**        tbl_ary;
3432     UV                          tbl_max;
3433     UV                          tbl_items;
3434 };
3435
3436 #if defined(iAPX286) || defined(M_I286) || defined(I80286)
3437 #   define I286
3438 #endif
3439
3440 #if defined(htonl) && !defined(HAS_HTONL)
3441 #define HAS_HTONL
3442 #endif
3443 #if defined(htons) && !defined(HAS_HTONS)
3444 #define HAS_HTONS
3445 #endif
3446 #if defined(ntohl) && !defined(HAS_NTOHL)
3447 #define HAS_NTOHL
3448 #endif
3449 #if defined(ntohs) && !defined(HAS_NTOHS)
3450 #define HAS_NTOHS
3451 #endif
3452 #ifndef HAS_HTONL
3453 #if (BYTEORDER & 0xffff) != 0x4321
3454 #define HAS_HTONS
3455 #define HAS_HTONL
3456 #define HAS_NTOHS
3457 #define HAS_NTOHL
3458 #define MYSWAP
3459 #define htons my_swap
3460 #define htonl my_htonl
3461 #define ntohs my_swap
3462 #define ntohl my_ntohl
3463 #endif
3464 #else
3465 #if (BYTEORDER & 0xffff) == 0x4321
3466 #undef HAS_HTONS
3467 #undef HAS_HTONL
3468 #undef HAS_NTOHS
3469 #undef HAS_NTOHL
3470 #endif
3471 #endif
3472
3473 /*
3474  * Little-endian byte order functions - 'v' for 'VAX', or 'reVerse'.
3475  * -DWS
3476  */
3477 #if BYTEORDER != 0x1234
3478 # define HAS_VTOHL
3479 # define HAS_VTOHS
3480 # define HAS_HTOVL
3481 # define HAS_HTOVS
3482 # if BYTEORDER == 0x4321 || BYTEORDER == 0x87654321
3483 #  define vtohl(x)      ((((x)&0xFF)<<24)       \
3484                         +(((x)>>24)&0xFF)       \
3485                         +(((x)&0x0000FF00)<<8)  \
3486                         +(((x)&0x00FF0000)>>8)  )
3487 #  define vtohs(x)      ((((x)&0xFF)<<8) + (((x)>>8)&0xFF))
3488 #  define htovl(x)      vtohl(x)
3489 #  define htovs(x)      vtohs(x)
3490 # endif
3491         /* otherwise default to functions in util.c */
3492 #ifndef htovs
3493 short htovs(short n);
3494 short vtohs(short n);
3495 long htovl(long n);
3496 long vtohl(long n);
3497 #endif
3498 #endif
3499
3500 /* *MAX Plus 1. A floating point value.
3501    Hopefully expressed in a way that dodgy floating point can't mess up.
3502    >> 2 rather than 1, so that value is safely less than I32_MAX after 1
3503    is added to it
3504    May find that some broken compiler will want the value cast to I32.
3505    [after the shift, as signed >> may not be as secure as unsigned >>]
3506 */
3507 #define I32_MAX_P1 (2.0 * (1 + (((U32)I32_MAX) >> 1)))
3508 #define U32_MAX_P1 (4.0 * (1 + ((U32_MAX) >> 2)))
3509 /* For compilers that can't correctly cast NVs over 0x7FFFFFFF (or
3510    0x7FFFFFFFFFFFFFFF) to an unsigned integer. In the future, sizeof(UV)
3511    may be greater than sizeof(IV), so don't assume that half max UV is max IV.
3512 */
3513 #define U32_MAX_P1_HALF (2.0 * (1 + ((U32_MAX) >> 2)))
3514
3515 #define UV_MAX_P1 (4.0 * (1 + ((UV_MAX) >> 2)))
3516 #define IV_MAX_P1 (2.0 * (1 + (((UV)IV_MAX) >> 1)))
3517 #define UV_MAX_P1_HALF (2.0 * (1 + ((UV_MAX) >> 2)))
3518
3519 /* This may look like unnecessary jumping through hoops, but converting
3520    out of range floating point values to integers *is* undefined behaviour,
3521    and it is starting to bite.
3522 */
3523 #ifndef CAST_INLINE
3524 #define I_32(what) (cast_i32((NV)(what)))
3525 #define U_32(what) (cast_ulong((NV)(what)))
3526 #define I_V(what) (cast_iv((NV)(what)))
3527 #define U_V(what) (cast_uv((NV)(what)))
3528 #else
3529 #define I_32(n) ((n) < I32_MAX_P1 ? ((n) < I32_MIN ? I32_MIN : (I32) (n)) \
3530                   : ((n) < U32_MAX_P1 ? (I32)(U32) (n) \
3531                      : ((n) > 0 ? (I32) U32_MAX : 0 /* NaN */)))
3532 #define U_32(n) ((n) < 0.0 ? ((n) < I32_MIN ? (UV) I32_MIN : (U32)(I32) (n)) \
3533                   : ((n) < U32_MAX_P1 ? (U32) (n) \
3534                      : ((n) > 0 ? U32_MAX : 0 /* NaN */)))
3535 #define I_V(n) ((n) < IV_MAX_P1 ? ((n) < IV_MIN ? IV_MIN : (IV) (n)) \
3536                   : ((n) < UV_MAX_P1 ? (IV)(UV) (n) \
3537                      : ((n) > 0 ? (IV)UV_MAX : 0 /* NaN */)))
3538 #define U_V(n) ((n) < 0.0 ? ((n) < IV_MIN ? (UV) IV_MIN : (UV)(IV) (n)) \
3539                   : ((n) < UV_MAX_P1 ? (UV) (n) \
3540                      : ((n) > 0 ? UV_MAX : 0 /* NaN */)))
3541 #endif
3542
3543 #define U_S(what) ((U16)U_32(what))
3544 #define U_I(what) ((unsigned int)U_32(what))
3545 #define U_L(what) U_32(what)
3546
3547 #ifdef HAS_SIGNBIT
3548 #  define Perl_signbit signbit
3549 #endif
3550
3551 /* These do not care about the fractional part, only about the range. */
3552 #define NV_WITHIN_IV(nv) (I_V(nv) >= IV_MIN && I_V(nv) <= IV_MAX)
3553 #define NV_WITHIN_UV(nv) ((nv)>=0.0 && U_V(nv) >= UV_MIN && U_V(nv) <= UV_MAX)
3554
3555 /* Used with UV/IV arguments: */
3556                                         /* XXXX: need to speed it up */
3557 #define CLUMP_2UV(iv)   ((iv) < 0 ? 0 : (UV)(iv))
3558 #define CLUMP_2IV(uv)   ((uv) > (UV)IV_MAX ? IV_MAX : (IV)(uv))
3559
3560 #ifndef MAXSYSFD
3561 #   define MAXSYSFD 2
3562 #endif
3563
3564 #ifndef __cplusplus
3565 #if !(defined(UNDER_CE) || defined(SYMBIAN))
3566 Uid_t getuid (void);
3567 Uid_t geteuid (void);
3568 Gid_t getgid (void);
3569 Gid_t getegid (void);
3570 #endif
3571 #endif
3572
3573 #ifndef Perl_debug_log
3574 #  define Perl_debug_log        PerlIO_stderr()
3575 #endif
3576
3577 #ifndef Perl_error_log
3578 #  define Perl_error_log        (PL_stderrgv                    \
3579                                  && isGV(PL_stderrgv)           \
3580                                  && GvIOp(PL_stderrgv)          \
3581                                  && IoOFP(GvIOp(PL_stderrgv))   \
3582                                  ? IoOFP(GvIOp(PL_stderrgv))    \
3583                                  : PerlIO_stderr())
3584 #endif
3585
3586
3587 #define DEBUG_p_FLAG            0x00000001 /*      1 */
3588 #define DEBUG_s_FLAG            0x00000002 /*      2 */
3589 #define DEBUG_l_FLAG            0x00000004 /*      4 */
3590 #define DEBUG_t_FLAG            0x00000008 /*      8 */
3591 #define DEBUG_o_FLAG            0x00000010 /*     16 */
3592 #define DEBUG_c_FLAG            0x00000020 /*     32 */
3593 #define DEBUG_P_FLAG            0x00000040 /*     64 */
3594 #define DEBUG_m_FLAG            0x00000080 /*    128 */
3595 #define DEBUG_f_FLAG            0x00000100 /*    256 */
3596 #define DEBUG_r_FLAG            0x00000200 /*    512 */
3597 #define DEBUG_x_FLAG            0x00000400 /*   1024 */
3598 #define DEBUG_u_FLAG            0x00000800 /*   2048 */
3599 /* U is reserved for Unofficial, exploratory hacking */
3600 #define DEBUG_U_FLAG            0x00001000 /*   4096 */
3601 #define DEBUG_H_FLAG            0x00002000 /*   8192 */
3602 #define DEBUG_X_FLAG            0x00004000 /*  16384 */
3603 #define DEBUG_D_FLAG            0x00008000 /*  32768 */
3604 /* 0x00010000 is unused, used to be S */
3605 #define DEBUG_T_FLAG            0x00020000 /* 131072 */
3606 #define DEBUG_R_FLAG            0x00040000 /* 262144 */
3607 #define DEBUG_J_FLAG            0x00080000 /* 524288 */
3608 #define DEBUG_v_FLAG            0x00100000 /*1048576 */
3609 #define DEBUG_C_FLAG            0x00200000 /*2097152 */
3610 #define DEBUG_A_FLAG            0x00400000 /*4194304 */
3611 #define DEBUG_q_FLAG            0x00800000 /*8388608 */
3612 #define DEBUG_MASK              0x00FEEFFF /* mask of all the standard flags */
3613
3614 #define DEBUG_DB_RECURSE_FLAG   0x40000000
3615 #define DEBUG_TOP_FLAG          0x80000000 /* XXX what's this for ??? Signal
3616                                               that something was done? */
3617
3618 #  define DEBUG_p_TEST_ (PL_debug & DEBUG_p_FLAG)
3619 #  define DEBUG_s_TEST_ (PL_debug & DEBUG_s_FLAG)
3620 #  define DEBUG_l_TEST_ (PL_debug & DEBUG_l_FLAG)
3621 #  define DEBUG_t_TEST_ (PL_debug & DEBUG_t_FLAG)
3622 #  define DEBUG_o_TEST_ (PL_debug & DEBUG_o_FLAG)
3623 #  define DEBUG_c_TEST_ (PL_debug & DEBUG_c_FLAG)
3624 #  define DEBUG_P_TEST_ (PL_debug & DEBUG_P_FLAG)
3625 #  define DEBUG_m_TEST_ (PL_debug & DEBUG_m_FLAG)
3626 #  define DEBUG_f_TEST_ (PL_debug & DEBUG_f_FLAG)
3627 #  define DEBUG_r_TEST_ (PL_debug & DEBUG_r_FLAG)
3628 #  define DEBUG_x_TEST_ (PL_debug & DEBUG_x_FLAG)
3629 #  define DEBUG_u_TEST_ (PL_debug & DEBUG_u_FLAG)
3630 #  define DEBUG_U_TEST_ (PL_debug & DEBUG_U_FLAG)
3631 #  define DEBUG_H_TEST_ (PL_debug & DEBUG_H_FLAG)
3632 #  define DEBUG_X_TEST_ (PL_debug & DEBUG_X_FLAG)
3633 #  define DEBUG_D_TEST_ (PL_debug & DEBUG_D_FLAG)
3634 #  define DEBUG_T_TEST_ (PL_debug & DEBUG_T_FLAG)
3635 #  define DEBUG_R_TEST_ (PL_debug & DEBUG_R_FLAG)
3636 #  define DEBUG_J_TEST_ (PL_debug & DEBUG_J_FLAG)
3637 #  define DEBUG_v_TEST_ (PL_debug & DEBUG_v_FLAG)
3638 #  define DEBUG_C_TEST_ (PL_debug & DEBUG_C_FLAG)
3639 #  define DEBUG_A_TEST_ (PL_debug & DEBUG_A_FLAG)
3640 #  define DEBUG_q_TEST_ (PL_debug & DEBUG_q_FLAG)
3641 #  define DEBUG_Xv_TEST_ (DEBUG_X_TEST_ && DEBUG_v_TEST_)
3642 #  define DEBUG_Uv_TEST_ (DEBUG_U_TEST_ && DEBUG_v_TEST_)
3643
3644 #ifdef DEBUGGING
3645
3646 #  define DEBUG_p_TEST DEBUG_p_TEST_
3647 #  define DEBUG_s_TEST DEBUG_s_TEST_
3648 #  define DEBUG_l_TEST DEBUG_l_TEST_
3649 #  define DEBUG_t_TEST DEBUG_t_TEST_
3650 #  define DEBUG_o_TEST DEBUG_o_TEST_
3651 #  define DEBUG_c_TEST DEBUG_c_TEST_
3652 #  define DEBUG_P_TEST DEBUG_P_TEST_
3653 #  define DEBUG_m_TEST DEBUG_m_TEST_
3654 #  define DEBUG_f_TEST DEBUG_f_TEST_
3655 #  define DEBUG_r_TEST DEBUG_r_TEST_
3656 #  define DEBUG_x_TEST DEBUG_x_TEST_
3657 #  define DEBUG_u_TEST DEBUG_u_TEST_
3658 #  define DEBUG_U_TEST DEBUG_U_TEST_
3659 #  define DEBUG_H_TEST DEBUG_H_TEST_
3660 #  define DEBUG_X_TEST DEBUG_X_TEST_
3661 #  define DEBUG_D_TEST DEBUG_D_TEST_
3662 #  define DEBUG_T_TEST DEBUG_T_TEST_
3663 #  define DEBUG_R_TEST DEBUG_R_TEST_
3664 #  define DEBUG_J_TEST DEBUG_J_TEST_
3665 #  define DEBUG_v_TEST DEBUG_v_TEST_
3666 #  define DEBUG_C_TEST DEBUG_C_TEST_
3667 #  define DEBUG_A_TEST DEBUG_A_TEST_
3668 #  define DEBUG_q_TEST DEBUG_q_TEST_
3669 #  define DEBUG_Xv_TEST DEBUG_Xv_TEST_
3670 #  define DEBUG_Uv_TEST DEBUG_Uv_TEST_
3671
3672 #  define PERL_DEB(a)                  a
3673 #  define PERL_DEBUG(a) if (PL_debug)  a
3674 #  define DEBUG_p(a) if (DEBUG_p_TEST) a
3675 #  define DEBUG_s(a) if (DEBUG_s_TEST) a
3676 #  define DEBUG_l(a) if (DEBUG_l_TEST) a
3677 #  define DEBUG_t(a) if (DEBUG_t_TEST) a
3678 #  define DEBUG_o(a) if (DEBUG_o_TEST) a
3679 #  define DEBUG_c(a) if (DEBUG_c_TEST) a
3680 #  define DEBUG_P(a) if (DEBUG_P_TEST) a
3681
3682      /* Temporarily turn off memory debugging in case the a
3683       * does memory allocation, either directly or indirectly. */
3684 #  define DEBUG_m(a)  \
3685     STMT_START {                                                        \
3686         if (PERL_GET_INTERP) { dTHX; if (DEBUG_m_TEST) {PL_debug&=~DEBUG_m_FLAG; a; PL_debug|=DEBUG_m_FLAG;} } \
3687     } STMT_END
3688
3689 #  define DEBUG__(t, a) \
3690         STMT_START { \
3691                 if (t) STMT_START {a;} STMT_END; \
3692         } STMT_END
3693
3694 #  define DEBUG_f(a) DEBUG__(DEBUG_f_TEST, a)
3695 #ifndef PERL_EXT_RE_BUILD
3696 #  define DEBUG_r(a) DEBUG__(DEBUG_r_TEST, a)
3697 #else
3698 #  define DEBUG_r(a) STMT_START {a;} STMT_END
3699 #endif /* PERL_EXT_RE_BUILD */
3700 #  define DEBUG_x(a) DEBUG__(DEBUG_x_TEST, a)
3701 #  define DEBUG_u(a) DEBUG__(DEBUG_u_TEST, a)
3702 #  define DEBUG_U(a) DEBUG__(DEBUG_U_TEST, a)
3703 #  define DEBUG_H(a) DEBUG__(DEBUG_H_TEST, a)
3704 #  define DEBUG_X(a) DEBUG__(DEBUG_X_TEST, a)
3705 #  define DEBUG_D(a) DEBUG__(DEBUG_D_TEST, a)
3706 #  define DEBUG_Xv(a) DEBUG__(DEBUG_Xv_TEST, a)
3707 #  define DEBUG_Uv(a) DEBUG__(DEBUG_Uv_TEST, a)
3708
3709 #  define DEBUG_T(a) DEBUG__(DEBUG_T_TEST, a)
3710 #  define DEBUG_R(a) DEBUG__(DEBUG_R_TEST, a)
3711 #  define DEBUG_v(a) DEBUG__(DEBUG_v_TEST, a)
3712 #  define DEBUG_C(a) DEBUG__(DEBUG_C_TEST, a)
3713 #  define DEBUG_A(a) DEBUG__(DEBUG_A_TEST, a)
3714 #  define DEBUG_q(a) DEBUG__(DEBUG_q_TEST, a)
3715
3716 #else /* DEBUGGING */
3717
3718 #  define DEBUG_p_TEST (0)
3719 #  define DEBUG_s_TEST (0)
3720 #  define DEBUG_l_TEST (0)
3721 #  define DEBUG_t_TEST (0)
3722 #  define DEBUG_o_TEST (0)
3723 #  define DEBUG_c_TEST (0)
3724 #  define DEBUG_P_TEST (0)
3725 #  define DEBUG_m_TEST (0)
3726 #  define DEBUG_f_TEST (0)
3727 #  define DEBUG_r_TEST (0)
3728 #  define DEBUG_x_TEST (0)
3729 #  define DEBUG_u_TEST (0)
3730 #  define DEBUG_U_TEST (0)
3731 #  define DEBUG_H_TEST (0)
3732 #  define DEBUG_X_TEST (0)
3733 #  define DEBUG_D_TEST (0)
3734 #  define DEBUG_T_TEST (0)
3735 #  define DEBUG_R_TEST (0)
3736 #  define DEBUG_J_TEST (0)
3737 #  define DEBUG_v_TEST (0)
3738 #  define DEBUG_C_TEST (0)
3739 #  define DEBUG_A_TEST (0)
3740 #  define DEBUG_q_TEST (0)
3741 #  define DEBUG_Xv_TEST (0)
3742 #  define DEBUG_Uv_TEST (0)
3743
3744 #  define PERL_DEB(a)
3745 #  define PERL_DEBUG(a)
3746 #  define DEBUG_p(a)
3747 #  define DEBUG_s(a)
3748 #  define DEBUG_l(a)
3749 #  define DEBUG_t(a)
3750 #  define DEBUG_o(a)
3751 #  define DEBUG_c(a)
3752 #  define DEBUG_P(a)
3753 #  define DEBUG_m(a)
3754 #  define DEBUG_f(a)
3755 #  define DEBUG_r(a)
3756 #  define DEBUG_x(a)
3757 #  define DEBUG_u(a)
3758 #  define DEBUG_U(a)
3759 #  define DEBUG_H(a)
3760 #  define DEBUG_X(a)
3761 #  define DEBUG_D(a)
3762 #  define DEBUG_T(a)
3763 #  define DEBUG_R(a)
3764 #  define DEBUG_v(a)
3765 #  define DEBUG_C(a)
3766 #  define DEBUG_A(a)
3767 #  define DEBUG_q(a)
3768 #  define DEBUG_Xv(a)
3769 #  define DEBUG_Uv(a)
3770 #endif /* DEBUGGING */
3771
3772
3773 #define DEBUG_SCOPE(where) \
3774     DEBUG_l(WITH_THR(Perl_deb(aTHX_ "%s scope %ld at %s:%d\n",  \
3775                     where, (long)PL_scopestack_ix, __FILE__, __LINE__)));
3776
3777
3778
3779
3780 /* These constants should be used in preference to raw characters
3781  * when using magic. Note that some perl guts still assume
3782  * certain character properties of these constants, namely that
3783  * isUPPER() and toLOWER() may do useful mappings.
3784  *
3785  * Update the magic_names table in dump.c when adding/amending these
3786  */
3787
3788 #define PERL_MAGIC_sv             '\0' /* Special scalar variable */
3789 #define PERL_MAGIC_overload       'A' /* %OVERLOAD hash */
3790 #define PERL_MAGIC_overload_elem  'a' /* %OVERLOAD hash element */
3791 #define PERL_MAGIC_overload_table 'c' /* Holds overload table (AMT) on stash */
3792 #define PERL_MAGIC_bm             'B' /* Boyer-Moore (fast string search) */
3793 #define PERL_MAGIC_regdata        'D' /* Regex match position data
3794                                         (@+ and @- vars) */
3795 #define PERL_MAGIC_regdatum       'd' /* Regex match position data element */
3796 #define PERL_MAGIC_env            'E' /* %ENV hash */
3797 #define PERL_MAGIC_envelem        'e' /* %ENV hash element */
3798 #define PERL_MAGIC_fm             'f' /* Formline ('compiled' format) */
3799 #define PERL_MAGIC_regex_global   'g' /* m//g target / study()ed string */
3800 #define PERL_MAGIC_hints          'H' /* %^H hash */
3801 #define PERL_MAGIC_hintselem      'h' /* %^H hash element */
3802 #define PERL_MAGIC_isa            'I' /* @ISA array */
3803 #define PERL_MAGIC_isaelem        'i' /* @ISA array element */
3804 #define PERL_MAGIC_nkeys          'k' /* scalar(keys()) lvalue */
3805 #define PERL_MAGIC_dbfile         'L' /* Debugger %_<filename */
3806 #define PERL_MAGIC_dbline         'l' /* Debugger %_<filename element */
3807 #define PERL_MAGIC_shared         'N' /* Shared between threads */
3808 #define PERL_MAGIC_shared_scalar  'n' /* Shared between threads */
3809 #define PERL_MAGIC_collxfrm       'o' /* Locale transformation */
3810 #define PERL_MAGIC_tied           'P' /* Tied array or hash */
3811 #define PERL_MAGIC_tiedelem       'p' /* Tied array or hash element */
3812 #define PERL_MAGIC_tiedscalar     'q' /* Tied scalar or handle */
3813 #define PERL_MAGIC_qr             'r' /* precompiled qr// regex */
3814 #define PERL_MAGIC_sig            'S' /* %SIG hash */
3815 #define PERL_MAGIC_sigelem        's' /* %SIG hash element */
3816 #define PERL_MAGIC_taint          't' /* Taintedness */
3817 #define PERL_MAGIC_uvar           'U' /* Available for use by extensions */
3818 #define PERL_MAGIC_uvar_elem      'u' /* Reserved for use by extensions */
3819 #define PERL_MAGIC_vec            'v' /* vec() lvalue */
3820 #define PERL_MAGIC_vstring        'V' /* SV was vstring literal */
3821 #define PERL_MAGIC_utf8           'w' /* Cached UTF-8 information */
3822 #define PERL_MAGIC_substr         'x' /* substr() lvalue */
3823 #define PERL_MAGIC_defelem        'y' /* Shadow "foreach" iterator variable /
3824                                         smart parameter vivification */
3825 #define PERL_MAGIC_arylen         '#' /* Array length ($#ary) */
3826 #define PERL_MAGIC_pos            '.' /* pos() lvalue */
3827 #define PERL_MAGIC_backref        '<' /* for weak ref data */
3828 #define PERL_MAGIC_symtab         ':' /* extra data for symbol tables */
3829 #define PERL_MAGIC_rhash          '%' /* extra data for restricted hashes */
3830 #define PERL_MAGIC_arylen_p       '@' /* to move arylen out of XPVAV */
3831 #define PERL_MAGIC_ext            '~' /* Available for use by extensions */
3832
3833 #if defined(DEBUGGING) && defined(I_ASSERT)
3834 #  include <assert.h>
3835 #endif
3836
3837 /* Keep the old croak based assert for those who want it, and as a fallback if
3838    the platform is so heretically non-ANSI that it can't assert.  */
3839
3840 #define Perl_assert(what)       PERL_DEB(                               \
3841         ((what) ? ((void) 0) :                                          \
3842             (Perl_croak_nocontext("Assertion %s failed: file \"" __FILE__ \
3843                         "\", line %d", STRINGIFY(what), __LINE__),      \
3844             (void) 0)))
3845
3846 #ifndef assert
3847 #  define assert(what)  Perl_assert(what)
3848 #endif
3849
3850 struct ufuncs {
3851     I32 (*uf_val)(pTHX_ IV, SV*);
3852     I32 (*uf_set)(pTHX_ IV, SV*);
3853     IV uf_index;
3854 };
3855
3856 /* In pre-5.7-Perls the PERL_MAGIC_uvar magic didn't get the thread context.
3857  * XS code wanting to be backward compatible can do something
3858  * like the following:
3859
3860 #ifndef PERL_MG_UFUNC
3861 #define PERL_MG_UFUNC(name,ix,sv) I32 name(IV ix, SV *sv)
3862 #endif
3863
3864 static PERL_MG_UFUNC(foo_get, index, val)
3865 {
3866     sv_setsv(val, ...);
3867     return TRUE;
3868 }
3869
3870 -- Doug MacEachern
3871
3872 */
3873
3874 #ifndef PERL_MG_UFUNC
3875 #define PERL_MG_UFUNC(name,ix,sv) I32 name(pTHX_ IV ix, SV *sv)
3876 #endif
3877
3878 /* Fix these up for __STDC__ */
3879 #ifndef DONT_DECLARE_STD
3880 char *mktemp (char*);
3881 #ifndef atof
3882 double atof (const char*);
3883 #endif
3884 #endif
3885
3886 #ifndef STANDARD_C
3887 /* All of these are in stdlib.h or time.h for ANSI C */
3888 Time_t time();
3889 struct tm *gmtime(), *localtime();
3890 #if defined(OEMVS) || defined(__OPEN_VM)
3891 char *(strchr)(), *(strrchr)();
3892 char *(strcpy)(), *(strcat)();
3893 #else
3894 char *strchr(), *strrchr();
3895 char *strcpy(), *strcat();
3896 #endif
3897 #endif /* ! STANDARD_C */
3898
3899
3900 #ifdef I_MATH
3901 #    include <math.h>
3902 #else
3903 START_EXTERN_C
3904             double exp (double);
3905             double log (double);
3906             double log10 (double);
3907             double sqrt (double);
3908             double frexp (double,int*);
3909             double ldexp (double,int);
3910             double modf (double,double*);
3911             double sin (double);
3912             double cos (double);
3913             double atan2 (double,double);
3914             double pow (double,double);
3915 END_EXTERN_C
3916 #endif
3917
3918 #if !defined(NV_INF) && defined(USE_LONG_DOUBLE) && defined(LDBL_INFINITY)
3919 #  define NV_INF LDBL_INFINITY
3920 #endif
3921 #if !defined(NV_INF) && defined(DBL_INFINITY)
3922 #  define NV_INF (NV)DBL_INFINITY
3923 #endif
3924 #if !defined(NV_INF) && defined(INFINITY)
3925 #  define NV_INF (NV)INFINITY
3926 #endif
3927 #if !defined(NV_INF) && defined(INF)
3928 #  define NV_INF (NV)INF
3929 #endif
3930 #if !defined(NV_INF) && defined(USE_LONG_DOUBLE) && defined(HUGE_VALL)
3931 #  define NV_INF (NV)HUGE_VALL
3932 #endif
3933 #if !defined(NV_INF) && defined(HUGE_VAL)
3934 #  define NV_INF (NV)HUGE_VAL
3935 #endif
3936
3937 #if !defined(NV_NAN) && defined(USE_LONG_DOUBLE)
3938 #   if !defined(NV_NAN) && defined(LDBL_NAN)
3939 #       define NV_NAN LDBL_NAN
3940 #   endif
3941 #   if !defined(NV_NAN) && defined(LDBL_QNAN)
3942 #       define NV_NAN LDBL_QNAN
3943 #   endif
3944 #   if !defined(NV_NAN) && defined(LDBL_SNAN)
3945 #       define NV_NAN LDBL_SNAN
3946 #   endif
3947 #endif
3948 #if !defined(NV_NAN) && defined(DBL_NAN)
3949 #  define NV_NAN (NV)DBL_NAN
3950 #endif
3951 #if !defined(NV_NAN) && defined(DBL_QNAN)
3952 #  define NV_NAN (NV)DBL_QNAN
3953 #endif
3954 #if !defined(NV_NAN) && defined(DBL_SNAN)
3955 #  define NV_NAN (NV)DBL_SNAN
3956 #endif
3957 #if !defined(NV_NAN) && defined(QNAN)
3958 #  define NV_NAN (NV)QNAN
3959 #endif
3960 #if !defined(NV_NAN) && defined(SNAN)
3961 #  define NV_NAN (NV)SNAN
3962 #endif
3963 #if !defined(NV_NAN) && defined(NAN)
3964 #  define NV_NAN (NV)NAN
3965 #endif
3966
3967 #ifndef __cplusplus
3968 #  if defined(NeXT) || defined(__NeXT__) /* or whatever catches all NeXTs */
3969 char *crypt ();       /* Maybe more hosts will need the unprototyped version */
3970 #  else
3971 #    if !defined(WIN32) && !defined(VMS)
3972 #ifndef crypt
3973 char *crypt (const char*, const char*);
3974 #endif
3975 #    endif /* !WIN32 */
3976 #  endif /* !NeXT && !__NeXT__ */
3977 #  ifndef DONT_DECLARE_STD
3978 #    ifndef getenv
3979 char *getenv (const char*);
3980 #    endif /* !getenv */
3981 #    if !defined(HAS_LSEEK_PROTO) && !defined(EPOC) && !defined(__hpux)
3982 #      ifdef _FILE_OFFSET_BITS
3983 #        if _FILE_OFFSET_BITS == 64
3984 Off_t lseek (int,Off_t,int);
3985 #        endif
3986 #      endif
3987 #    endif
3988 #  endif /* !DONT_DECLARE_STD */
3989 #ifndef getlogin
3990 char *getlogin (void);
3991 #endif
3992 #endif /* !__cplusplus */
3993
3994 /* Fixme on VMS.  This needs to be a run-time, not build time options */
3995 /* Also rename() is affected by this */
3996 #ifdef UNLINK_ALL_VERSIONS /* Currently only makes sense for VMS */
3997 #define UNLINK unlnk
3998 I32 unlnk (pTHX_ const char*);
3999 #else
4000 #define UNLINK PerlLIO_unlink
4001 #endif
4002
4003 /* some versions of glibc are missing the setresuid() proto */
4004 #if defined(HAS_SETRESUID) && !defined(HAS_SETRESUID_PROTO)
4005 int setresuid(uid_t ruid, uid_t euid, uid_t suid);
4006 #endif
4007 /* some versions of glibc are missing the setresgid() proto */
4008 #if defined(HAS_SETRESGID) && !defined(HAS_SETRESGID_PROTO)
4009 int setresgid(gid_t rgid, gid_t egid, gid_t sgid);
4010 #endif
4011
4012 #ifndef HAS_SETREUID
4013 #  ifdef HAS_SETRESUID
4014 #    define setreuid(r,e) setresuid(r,e,(Uid_t)-1)
4015 #    define HAS_SETREUID
4016 #  endif
4017 #endif
4018 #ifndef HAS_SETREGID
4019 #  ifdef HAS_SETRESGID
4020 #    define setregid(r,e) setresgid(r,e,(Gid_t)-1)
4021 #    define HAS_SETREGID
4022 #  endif
4023 #endif
4024
4025 /* Sighandler_t defined in iperlsys.h */
4026
4027 #ifdef HAS_SIGACTION
4028 typedef struct sigaction Sigsave_t;
4029 #else
4030 typedef Sighandler_t Sigsave_t;
4031 #endif
4032
4033 #define SCAN_DEF 0
4034 #define SCAN_TR 1
4035 #define SCAN_REPL 2
4036
4037 #ifdef DEBUGGING
4038 # ifndef register
4039 #  define register
4040 # endif
4041 # define RUNOPS_DEFAULT Perl_runops_debug
4042 #else
4043 # define RUNOPS_DEFAULT Perl_runops_standard
4044 #endif
4045
4046 #ifdef USE_PERLIO
4047 EXTERN_C void PerlIO_teardown(void);
4048 # ifdef USE_ITHREADS
4049 #  define PERLIO_INIT MUTEX_INIT(&PL_perlio_mutex)
4050 #  define PERLIO_TERM                           \
4051         STMT_START {                            \
4052                 PerlIO_teardown();              \
4053                 MUTEX_DESTROY(&PL_perlio_mutex);\
4054         } STMT_END
4055 # else
4056 #  define PERLIO_INIT
4057 #  define PERLIO_TERM   PerlIO_teardown()
4058 # endif
4059 #else
4060 #  define PERLIO_INIT
4061 #  define PERLIO_TERM
4062 #endif
4063
4064 #ifdef MYMALLOC
4065 #  ifdef MUTEX_INIT_CALLS_MALLOC
4066 #    define MALLOC_INIT                                 \
4067         STMT_START {                                    \
4068                 PL_malloc_mutex = NULL;                 \
4069                 MUTEX_INIT(&PL_malloc_mutex);           \
4070         } STMT_END
4071 #    define MALLOC_TERM                                 \
4072         STMT_START {                                    \
4073                 perl_mutex tmp = PL_malloc_mutex;       \
4074                 PL_malloc_mutex = NULL;                 \
4075                 MUTEX_DESTROY(&tmp);                    \
4076         } STMT_END
4077 #  else
4078 #    define MALLOC_INIT MUTEX_INIT(&PL_malloc_mutex)
4079 #    define MALLOC_TERM MUTEX_DESTROY(&PL_malloc_mutex)
4080 #  endif
4081 #else
4082 #  define MALLOC_INIT
4083 #  define MALLOC_TERM
4084 #endif
4085
4086 #if defined(PERL_IMPLICIT_CONTEXT)
4087
4088 struct perl_memory_debug_header;
4089 struct perl_memory_debug_header {
4090   tTHX  interpreter;
4091 #  ifdef PERL_POISON
4092   MEM_SIZE size;
4093 #  endif
4094   struct perl_memory_debug_header *prev;
4095   struct perl_memory_debug_header *next;
4096 };
4097
4098 #  define sTHX  (sizeof(struct perl_memory_debug_header) + \
4099         (MEM_ALIGNBYTES - sizeof(struct perl_memory_debug_header) \
4100          %MEM_ALIGNBYTES) % MEM_ALIGNBYTES)
4101
4102 #else
4103 #  define sTHX  0
4104 #endif
4105
4106 #ifdef PERL_TRACK_MEMPOOL
4107 #  define INIT_TRACK_MEMPOOL(header, interp)                    \
4108         STMT_START {                                            \
4109                 (header).interpreter = (interp);                \
4110                 (header).prev = (header).next = &(header);      \
4111         } STMT_END
4112 #  else
4113 #  define INIT_TRACK_MEMPOOL(header, interp)
4114 #endif
4115
4116 #ifdef I_MALLOCMALLOC
4117 /* Needed for malloc_size(), malloc_good_size() on some systems */
4118 #  include <malloc/malloc.h>
4119 #endif
4120
4121 #ifdef MYMALLOC
4122 #  define Perl_safesysmalloc_size(where)        Perl_malloced_size(where)
4123 #else
4124 #  ifdef HAS_MALLOC_SIZE
4125 #    ifdef PERL_TRACK_MEMPOOL
4126 #       define Perl_safesysmalloc_size(where)                   \
4127             (malloc_size(((char *)(where)) - sTHX) - sTHX)
4128 #    else
4129 #       define Perl_safesysmalloc_size(where) malloc_size(where)
4130 #    endif
4131 #  endif
4132 #  ifdef HAS_MALLOC_GOOD_SIZE
4133 #    ifdef PERL_TRACK_MEMPOOL
4134 #       define Perl_malloc_good_size(how_much)                  \
4135             (malloc_good_size((how_much) + sTHX) - sTHX)
4136 #    else
4137 #       define Perl_malloc_good_size(how_much) malloc_good_size(how_much)
4138 #    endif
4139 #  else
4140 /* Having this as the identity operation makes some code simpler.  */
4141 #       define Perl_malloc_good_size(how_much)  (how_much)
4142 #  endif
4143 #endif
4144
4145 typedef int (CPERLscope(*runops_proc_t)) (pTHX);
4146 typedef void (CPERLscope(*share_proc_t)) (pTHX_ SV *sv);
4147 typedef int  (CPERLscope(*thrhook_proc_t)) (pTHX);
4148 typedef OP* (CPERLscope(*PPADDR_t)[]) (pTHX);
4149 typedef bool (CPERLscope(*destroyable_proc_t)) (pTHX_ SV *sv);
4150
4151 /* _ (for $_) must be first in the following list (DEFSV requires it) */
4152 #define THREADSV_NAMES "_123456789&`'+/.,\\\";^-%=|~:\001\005!@"
4153
4154 /* NeXT has problems with crt0.o globals */
4155 #if defined(__DYNAMIC__) && \
4156     (defined(NeXT) || defined(__NeXT__) || defined(PERL_DARWIN))
4157 #  if defined(NeXT) || defined(__NeXT)
4158 #    include <mach-o/dyld.h>
4159 #    define environ (*environ_pointer)
4160 EXT char *** environ_pointer;
4161 #  else
4162 #    if defined(PERL_DARWIN) && defined(PERL_CORE)
4163 #      include <crt_externs.h>  /* for the env array */
4164 #      define environ (*_NSGetEnviron())
4165 #    endif
4166 #  endif
4167 #else
4168    /* VMS and some other platforms don't use the environ array */
4169 #  ifdef USE_ENVIRON_ARRAY
4170 #    if !defined(DONT_DECLARE_STD) || \
4171         (defined(__svr4__) && defined(__GNUC__) && defined(sun)) || \
4172         defined(__sgi) || \
4173         defined(__DGUX)
4174 extern char **  environ;        /* environment variables supplied via exec */
4175 #    endif
4176 #  endif
4177 #endif
4178
4179 START_EXTERN_C
4180
4181 /* handy constants */
4182 EXTCONST char PL_warn_uninit[]
4183   INIT("Use of uninitialized value%s%s%s");
4184 EXTCONST char PL_warn_nosemi[]
4185   INIT("Semicolon seems to be missing");
4186 EXTCONST char PL_warn_reserved[]
4187   INIT("Unquoted string \"%s\" may clash with future reserved word");
4188 EXTCONST char PL_warn_nl[]
4189   INIT("Unsuccessful %s on filename containing newline");
4190 EXTCONST char PL_no_wrongref[]
4191   INIT("Can't use %s ref as %s ref");
4192 EXTCONST char PL_no_symref[]
4193   INIT("Can't use string (\"%.32s\") as %s ref while \"strict refs\" in use");
4194 EXTCONST char PL_no_symref_sv[]
4195   INIT("Can't use string (\"%" SVf32 "\") as %s ref while \"strict refs\" in use");
4196 EXTCONST char PL_no_usym[]
4197   INIT("Can't use an undefined value as %s reference");
4198 EXTCONST char PL_no_aelem[]
4199   INIT("Modification of non-creatable array value attempted, subscript %d");
4200 EXTCONST char PL_no_helem_sv[]
4201   INIT("Modification of non-creatable hash value attempted, subscript \"%"SVf"\"");
4202 EXTCONST char PL_no_modify[]
4203   INIT("Modification of a read-only value attempted");
4204 EXTCONST char PL_no_mem[]
4205   INIT("Out of memory!\n");
4206 EXTCONST char PL_no_security[]
4207   INIT("Insecure dependency in %s%s");
4208 EXTCONST char PL_no_sock_func[]
4209   INIT("Unsupported socket function \"%s\" called");
4210 EXTCONST char PL_no_dir_func[]
4211   INIT("Unsupported directory function \"%s\" called");
4212 EXTCONST char PL_no_func[]
4213   INIT("The %s function is unimplemented");
4214 EXTCONST char PL_no_myglob[]
4215   INIT("\"%s\" variable %s can't be in a package");
4216 EXTCONST char PL_no_localize_ref[]
4217   INIT("Can't localize through a reference");
4218 EXTCONST char PL_memory_wrap[]
4219   INIT("panic: memory wrap");
4220
4221 #ifdef CSH
4222 EXTCONST char PL_cshname[]
4223   INIT(CSH);
4224 #  define PL_cshlen     (sizeof(CSH "") - 1)
4225 #endif
4226
4227 EXTCONST char PL_uuemap[65]
4228   INIT("`!\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_");
4229
4230 #ifdef DOINIT
4231 EXTCONST char PL_uudmap[256] =
4232 #include "uudmap.h"
4233 ;
4234 EXTCONST char* const PL_sig_name[] = { SIG_NAME };
4235 EXTCONST int         PL_sig_num[]  = { SIG_NUM };
4236 #else
4237 EXTCONST char PL_uudmap[256];
4238 EXTCONST char* const PL_sig_name[];
4239 EXTCONST int         PL_sig_num[];
4240 #endif
4241
4242 /* fast conversion and case folding tables */
4243
4244 #ifdef DOINIT
4245 #ifdef EBCDIC
4246 EXTCONST unsigned char PL_fold[] = { /* fast EBCDIC case folding table */
4247     0,      1,      2,      3,      4,      5,      6,      7,
4248     8,      9,      10,     11,     12,     13,     14,     15,
4249     16,     17,     18,     19,     20,     21,     22,     23,
4250     24,     25,     26,     27,     28,     29,     30,     31,
4251     32,     33,     34,     35,     36,     37,     38,     39,
4252     40,     41,     42,     43,     44,     45,     46,     47,
4253     48,     49,     50,     51,     52,     53,     54,     55,
4254     56,     57,     58,     59,     60,     61,     62,     63,
4255     64,     65,     66,     67,     68,     69,     70,     71,
4256     72,     73,     74,     75,     76,     77,     78,     79,
4257     80,     81,     82,     83,     84,     85,     86,     87,
4258     88,     89,     90,     91,     92,     93,     94,     95,
4259     96,     97,     98,     99,     100,    101,    102,    103,
4260     104,    105,    106,    107,    108,    109,    110,    111,
4261     112,    113,    114,    115,    116,    117,    118,    119,
4262     120,    121,    122,    123,    124,    125,    126,    127,
4263     128,    'A',    'B',    'C',    'D',    'E',    'F',    'G',
4264     'H',    'I',    138,    139,    140,    141,    142,    143,
4265     144,    'J',    'K',    'L',    'M',    'N',    'O',    'P',
4266     'Q',    'R',    154,    155,    156,    157,    158,    159,
4267     160,    161,    'S',    'T',    'U',    'V',    'W',    'X',
4268     'Y',    'Z',    170,    171,    172,    173,    174,    175,
4269     176,    177,    178,    179,    180,    181,    182,    183,
4270     184,    185,    186,    187,    188,    189,    190,    191,
4271     192,    'a',    'b',    'c',    'd',    'e',    'f',    'g',
4272     'h',    'i',    202,    203,    204,    205,    206,    207,
4273     208,    'j',    'k',    'l',    'm',    'n',    'o',    'p',
4274     'q',    'r',    218,    219,    220,    221,    222,    223,
4275     224,    225,    's',    't',    'u',    'v',    'w',    'x',
4276     'y',    'z',    234,    235,    236,    237,    238,    239,
4277     240,    241,    242,    243,    244,    245,    246,    247,
4278     248,    249,    250,    251,    252,    253,    254,    255
4279 };
4280 #else   /* ascii rather than ebcdic */
4281 EXTCONST  unsigned char PL_fold[] = {
4282         0,      1,      2,      3,      4,      5,      6,      7,
4283         8,      9,      10,     11,     12,     13,     14,     15,
4284         16,     17,     18,     19,     20,     21,     22,     23,
4285         24,     25,     26,     27,     28,     29,     30,     31,
4286         32,     33,     34,     35,     36,     37,     38,     39,
4287         40,     41,     42,     43,     44,     45,     46,     47,
4288         48,     49,     50,     51,     52,     53,     54,     55,
4289         56,     57,     58,     59,     60,     61,     62,     63,
4290         64,     'a',    'b',    'c',    'd',    'e',    'f',    'g',
4291         'h',    'i',    'j',    'k',    'l',    'm',    'n',    'o',
4292         'p',    'q',    'r',    's',    't',    'u',    'v',    'w',
4293         'x',    'y',    'z',    91,     92,     93,     94,     95,
4294         96,     'A',    'B',    'C',    'D',    'E',    'F',    'G',
4295         'H',    'I',    'J',    'K',    'L',    'M',    'N',    'O',
4296         'P',    'Q',    'R',    'S',    'T',    'U',    'V',    'W',
4297         'X',    'Y',    'Z',    123,    124,    125,    126,    127,
4298         128,    129,    130,    131,    132,    133,    134,    135,
4299         136,    137,    138,    139,    140,    141,    142,    143,
4300         144,    145,    146,    147,    148,    149,    150,    151,
4301         152,    153,    154,    155,    156,    157,    158,    159,
4302         160,    161,    162,    163,    164,    165,    166,    167,
4303         168,    169,    170,    171,    172,    173,    174,    175,
4304         176,    177,    178,    179,    180,    181,    182,    183,
4305         184,    185,    186,    187,    188,    189,    190,    191,
4306         192,    193,    194,    195,    196,    197,    198,    199,
4307         200,    201,    202,    203,    204,    205,    206,    207,
4308         208,    209,    210,    211,    212,    213,    214,    215,
4309         216,    217,    218,    219,    220,    221,    222,    223,    
4310         224,    225,    226,    227,    228,    229,    230,    231,
4311         232,    233,    234,    235,    236,    237,    238,    239,
4312         240,    241,    242,    243,    244,    245,    246,    247,
4313         248,    249,    250,    251,    252,    253,    254,    255
4314 };
4315 #endif  /* !EBCDIC */
4316 #else
4317 EXTCONST unsigned char PL_fold[];
4318 #endif
4319
4320 #ifndef PERL_GLOBAL_STRUCT /* or perlvars.h */
4321 #ifdef DOINIT
4322 EXT unsigned char PL_fold_locale[] = { /* Unfortunately not EXTCONST. */
4323         0,      1,      2,      3,      4,      5,      6,      7,
4324         8,      9,      10,     11,     12,     13,     14,     15,
4325         16,     17,     18,     19,     20,     21,     22,     23,
4326         24,     25,     26,     27,     28,     29,     30,     31,
4327         32,     33,     34,     35,     36,     37,     38,     39,
4328         40,     41,     42,     43,     44,     45,     46,     47,
4329         48,     49,     50,     51,     52,     53,     54,     55,
4330         56,     57,     58,     59,     60,     61,     62,     63,
4331         64,     'a',    'b',    'c',    'd',    'e',    'f',    'g',
4332         'h',    'i',    'j',    'k',    'l',    'm',    'n',    'o',
4333         'p',    'q',    'r',    's',    't',    'u',    'v',    'w',
4334         'x',    'y',    'z',    91,     92,     93,     94,     95,
4335         96,     'A',    'B',    'C',    'D',    'E',    'F',    'G',
4336         'H',    'I',    'J',    'K',    'L',    'M',    'N',    'O',
4337         'P',    'Q',    'R',    'S',    'T',    'U',    'V',    'W',
4338         'X',    'Y',    'Z',    123,    124,    125,    126,    127,
4339         128,    129,    130,    131,    132,    133,    134,    135,
4340         136,    137,    138,    139,    140,    141,    142,    143,
4341         144,    145,    146,    147,    148,    149,    150,    151,
4342         152,    153,    154,    155,    156,    157,    158,    159,
4343         160,    161,    162,    163,    164,    165,    166,    167,
4344         168,    169,    170,    171,    172,    173,    174,    175,
4345         176,    177,    178,    179,    180,    181,    182,    183,
4346         184,    185,    186,    187,    188,    189,    190,    191,
4347         192,    193,    194,    195,    196,    197,    198,    199,
4348         200,    201,    202,    203,    204,    205,    206,    207,
4349         208,    209,    210,    211,    212,    213,    214,    215,
4350         216,    217,    218,    219,    220,    221,    222,    223,    
4351         224,    225,    226,    227,    228,    229,    230,    231,
4352         232,    233,    234,    235,    236,    237,    238,    239,
4353         240,    241,    242,    243,    244,    245,    246,    247,
4354         248,    249,    250,    251,    252,    253,    254,    255
4355 };
4356 #else
4357 EXT unsigned char PL_fold_locale[]; /* Unfortunately not EXTCONST. */
4358 #endif
4359 #endif /* !PERL_GLOBAL_STRUCT */
4360
4361 #ifdef DOINIT
4362 #ifdef EBCDIC
4363 EXTCONST unsigned char PL_freq[] = {/* EBCDIC frequencies for mixed English/C */
4364     1,      2,      84,     151,    154,    155,    156,    157,
4365     165,    246,    250,    3,      158,    7,      18,     29,
4366     40,     51,     62,     73,     85,     96,     107,    118,
4367     129,    140,    147,    148,    149,    150,    152,    153,
4368     255,      6,      8,      9,     10,     11,     12,     13,
4369      14,     15,     24,     25,     26,     27,     28,    226,
4370      29,     30,     31,     32,     33,     43,     44,     45,
4371      46,     47,     48,     49,     50,     76,     77,     78,
4372      79,     80,     81,     82,     83,     84,     85,     86,
4373      87,     94,     95,    234,    181,    233,    187,    190,
4374     180,     96,     97,     98,     99,    100,    101,    102,
4375     104,    112,    182,    174,    236,    232,    229,    103,
4376     228,    226,    114,    115,    116,    117,    118,    119,
4377     120,    121,    122,    235,    176,    230,    194,    162,
4378     130,    131,    132,    133,    134,    135,    136,    137,
4379     138,    139,    201,    205,    163,    217,    220,    224,
4380     5,      248,    227,    244,    242,    255,    241,    231,
4381     240,    253,    16,     197,    19,     20,     21,     187,
4382     23,     169,    210,    245,    237,    249,    247,    239,
4383     168,    252,    34,     196,    36,     37,     38,     39,
4384     41,     42,     251,    254,    238,    223,    221,    213,
4385     225,    177,    52,     53,     54,     55,     56,     57,
4386     58,     59,     60,     61,     63,     64,     65,     66,
4387     67,     68,     69,     70,     71,     72,     74,     75,
4388     205,    208,    186,    202,    200,    218,    198,    179,
4389     178,    214,    88,     89,     90,     91,     92,     93,
4390     217,    166,    170,    207,    199,    209,    206,    204,
4391     160,    212,    105,    106,    108,    109,    110,    111,
4392     203,    113,    216,    215,    192,    175,    193,    243,
4393     172,    161,    123,    124,    125,    126,    127,    128,
4394     222,    219,    211,    195,    188,    193,    185,    184,
4395     191,    183,    141,    142,    143,    144,    145,    146
4396 };
4397 #else  /* ascii rather than ebcdic */
4398 EXTCONST unsigned char PL_freq[] = {    /* letter frequencies for mixed English/C */
4399         1,      2,      84,     151,    154,    155,    156,    157,
4400         165,    246,    250,    3,      158,    7,      18,     29,
4401         40,     51,     62,     73,     85,     96,     107,    118,
4402         129,    140,    147,    148,    149,    150,    152,    153,
4403         255,    182,    224,    205,    174,    176,    180,    217,
4404         233,    232,    236,    187,    235,    228,    234,    226,
4405         222,    219,    211,    195,    188,    193,    185,    184,
4406         191,    183,    201,    229,    181,    220,    194,    162,
4407         163,    208,    186,    202,    200,    218,    198,    179,
4408         178,    214,    166,    170,    207,    199,    209,    206,
4409         204,    160,    212,    216,    215,    192,    175,    173,
4410         243,    172,    161,    190,    203,    189,    164,    230,
4411         167,    248,    227,    244,    242,    255,    241,    231,
4412         240,    253,    169,    210,    245,    237,    249,    247,
4413         239,    168,    252,    251,    254,    238,    223,    221,
4414         213,    225,    177,    197,    171,    196,    159,    4,
4415         5,      6,      8,      9,      10,     11,     12,     13,
4416         14,     15,     16,     17,     19,     20,     21,     22,
4417         23,     24,     25,     26,     27,     28,     30,     31,
4418         32,     33,     34,     35,     36,     37,     38,     39,
4419         41,     42,     43,     44,     45,     46,     47,     48,
4420         49,     50,     52,     53,     54,     55,     56,     57,
4421         58,     59,     60,     61,     63,     64,     65,     66,
4422         67,     68,     69,     70,     71,     72,     74,     75,
4423         76,     77,     78,     79,     80,     81,     82,     83,
4424         86,     87,     88,     89,     90,     91,     92,     93,
4425         94,     95,     97,     98,     99,     100,    101,    102,
4426         103,    104,    105,    106,    108,    109,    110,    111,
4427         112,    113,    114,    115,    116,    117,    119,    120,
4428         121,    122,    123,    124,    125,    126,    127,    128,
4429         130,    131,    132,    133,    134,    135,    136,    137,
4430         138,    139,    141,    142,    143,    144,    145,    146
4431 };
4432 #endif
4433 #else
4434 EXTCONST unsigned char PL_freq[];
4435 #endif
4436
4437 #ifdef DEBUGGING
4438 #ifdef DOINIT
4439 EXTCONST char* const PL_block_type[] = {
4440         "NULL",
4441         "WHEN",
4442         "BLOCK",
4443         "GIVEN",
4444         "LOOP_FOR",
4445         "LOOP_PLAIN",
4446         "LOOP_LAZYSV",
4447         "LOOP_LAZYIV",
4448         "SUB",
4449         "FORMAT",
4450         "EVAL",
4451         "SUBST"
4452 };
4453 #else
4454 EXTCONST char* PL_block_type[];
4455 #endif
4456 #endif
4457
4458 /* These are all the compile time options that affect binary compatibility.
4459    Other compile time options that are binary compatible are in perl.c
4460    Both are combined for the output of perl -V
4461    However, this string will be embedded in any shared perl library, which will
4462    allow us add a comparison check in perlmain.c in the near future.  */
4463 #ifdef DOINIT
4464 EXTCONST char PL_bincompat_options[] =
4465 #  ifdef DEBUG_LEAKING_SCALARS
4466                              " DEBUG_LEAKING_SCALARS"
4467 #  endif
4468 #  ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
4469                              " DEBUG_LEAKING_SCALARS_FORK_DUMP"
4470 #  endif
4471 #  ifdef FAKE_THREADS
4472                              " FAKE_THREADS"
4473 #  endif
4474 #  ifdef MULTIPLICITY
4475                              " MULTIPLICITY"
4476 #  endif
4477 #  ifdef MYMALLOC
4478                              " MYMALLOC"
4479 #  endif
4480 #  ifdef PERL_DEBUG_READONLY_OPS
4481                              " PERL_DEBUG_READONLY_OPS"
4482 #  endif
4483 #  ifdef PERL_GLOBAL_STRUCT
4484                              " PERL_GLOBAL_STRUCT"
4485 #  endif
4486 #  ifdef PERL_IMPLICIT_CONTEXT
4487                              " PERL_IMPLICIT_CONTEXT"
4488 #  endif
4489 #  ifdef PERL_IMPLICIT_SYS
4490                              " PERL_IMPLICIT_SYS"
4491 #  endif
4492 #  ifdef PERL_MAD
4493                              " PERL_MAD"
4494 #  endif
4495 #  ifdef PERL_NEED_APPCTX
4496                              " PERL_NEED_APPCTX"
4497 #  endif
4498 #  ifdef PERL_NEED_TIMESBASE
4499                              " PERL_NEED_TIMESBASE"
4500 #  endif
4501 #  ifdef PERL_OLD_COPY_ON_WRITE
4502                              " PERL_OLD_COPY_ON_WRITE"
4503 #  endif
4504 #  ifdef PERL_POISON
4505                              " PERL_POISON"
4506 #  endif
4507 #  ifdef PERL_TRACK_MEMPOOL
4508                              " PERL_TRACK_MEMPOOL"
4509 #  endif
4510 #  ifdef PERL_USES_PL_PIDSTATUS
4511                              " PERL_USES_PL_PIDSTATUS"
4512 #  endif
4513 #  ifdef PL_OP_SLAB_ALLOC
4514                              " PL_OP_SLAB_ALLOC"
4515 #  endif
4516 #  ifdef THREADS_HAVE_PIDS
4517                              " THREADS_HAVE_PIDS"
4518 #  endif
4519 #  ifdef USE_64_BIT_ALL
4520                              " USE_64_BIT_ALL"
4521 #  endif
4522 #  ifdef USE_64_BIT_INT
4523                              " USE_64_BIT_INT"
4524 #  endif
4525 #  ifdef USE_IEEE
4526                              " USE_IEEE"
4527 #  endif
4528 #  ifdef USE_ITHREADS
4529                              " USE_ITHREADS"
4530 #  endif
4531 #  ifdef USE_LARGE_FILES
4532                              " USE_LARGE_FILES"
4533 #  endif
4534 #  ifdef USE_LONG_DOUBLE
4535                              " USE_LONG_DOUBLE"
4536 #  endif
4537 #  ifdef USE_PERLIO
4538                              " USE_PERLIO"
4539 #  endif
4540 #  ifdef USE_REENTRANT_API
4541                              " USE_REENTRANT_API"
4542 #  endif
4543 #  ifdef USE_SFIO
4544                              " USE_SFIO"
4545 #  endif
4546 #  ifdef USE_SOCKS
4547                              " USE_SOCKS"
4548 #  endif
4549 #  ifdef VMS_DO_SOCKETS
4550                              " VMS_DO_SOCKETS"
4551 #    ifdef DECCRTL_SOCKETS
4552                              " DECCRTL_SOCKETS"
4553 #    endif
4554 #  endif
4555 #  ifdef VMS_WE_ARE_CASE_SENSITIVE
4556                              " VMS_SYMBOL_CASE_AS_IS"
4557 #  endif
4558   "";
4559 #else
4560 EXTCONST char PL_bincompat_options[];
4561 #endif
4562
4563 END_EXTERN_C
4564
4565 /*****************************************************************************/
4566 /* This lexer/parser stuff is currently global since yacc is hard to reenter */
4567 /*****************************************************************************/
4568 /* XXX This needs to be revisited, since BEGIN makes yacc re-enter... */
4569
4570 #ifdef __Lynx__
4571 /* LynxOS defines these in scsi.h which is included via ioctl.h */
4572 #ifdef FORMAT
4573 #undef FORMAT
4574 #endif
4575 #ifdef SPACE
4576 #undef SPACE
4577 #endif
4578 #endif
4579
4580 #define LEX_NOTPARSING          11      /* borrowed from toke.c */
4581
4582 typedef enum {
4583     XOPERATOR,
4584     XTERM,
4585     XREF,
4586     XSTATE,
4587     XBLOCK,
4588     XATTRBLOCK,
4589     XATTRTERM,
4590     XTERMBLOCK,
4591     XTERMORDORDOR /* evil hack */
4592     /* update exp_name[] in toke.c if adding to this enum */
4593 } expectation;
4594
4595 enum {          /* pass one of these to get_vtbl */
4596     want_vtbl_sv,
4597     want_vtbl_env,
4598     want_vtbl_envelem,
4599     want_vtbl_sig,
4600     want_vtbl_sigelem,
4601     want_vtbl_pack,
4602     want_vtbl_packelem,
4603     want_vtbl_dbline,
4604     want_vtbl_isa,
4605     want_vtbl_isaelem,
4606     want_vtbl_arylen,
4607     want_vtbl_glob,
4608     want_vtbl_mglob,
4609     want_vtbl_nkeys,
4610     want_vtbl_taint,
4611     want_vtbl_substr,
4612     want_vtbl_vec,
4613     want_vtbl_pos,
4614     want_vtbl_bm,
4615     want_vtbl_fm,
4616     want_vtbl_uvar,
4617     want_vtbl_defelem,
4618     want_vtbl_regexp,
4619     want_vtbl_collxfrm,
4620     want_vtbl_amagic,
4621     want_vtbl_amagicelem,
4622     want_vtbl_regdata,
4623     want_vtbl_regdatum,
4624     want_vtbl_backref,
4625     want_vtbl_utf8,
4626     want_vtbl_symtab,
4627     want_vtbl_arylen_p,
4628     want_vtbl_hintselem
4629 };
4630
4631
4632 /* Hints are now stored in a dedicated U32, so the bottom 8 bits are no longer
4633    special and there is no need for HINT_PRIVATE_MASK for COPs
4634    However, bitops store HINT_INTEGER in their op_private.  */
4635 #define HINT_INTEGER            0x00000001 /* integer pragma */
4636 #define HINT_STRICT_REFS        0x00000002 /* strict pragma */
4637 #define HINT_LOCALE             0x00000004 /* locale pragma */
4638 #define HINT_BYTES              0x00000008 /* bytes pragma */
4639 #define HINT_ARYBASE            0x00000010 /* $[ is non-zero */
4640                                 /* Note: 20,40,80 used for NATIVE_HINTS */
4641                                 /* currently defined by vms/vmsish.h */
4642
4643 #define HINT_BLOCK_SCOPE        0x00000100
4644 #define HINT_STRICT_SUBS        0x00000200 /* strict pragma */
4645 #define HINT_STRICT_VARS        0x00000400 /* strict pragma */
4646
4647 /* The HINT_NEW_* constants are used by the overload pragma */
4648 #define HINT_NEW_INTEGER        0x00001000
4649 #define HINT_NEW_FLOAT          0x00002000
4650 #define HINT_NEW_BINARY         0x00004000
4651 #define HINT_NEW_STRING         0x00008000
4652 #define HINT_NEW_RE             0x00010000
4653 #define HINT_LOCALIZE_HH        0x00020000 /* %^H needs to be copied */
4654 #define HINT_LEXICAL_IO_IN      0x00040000 /* ${^OPEN} is set for input */
4655 #define HINT_LEXICAL_IO_OUT     0x00080000 /* ${^OPEN} is set for output */
4656
4657 #define HINT_RE_TAINT           0x00100000 /* re pragma */
4658 #define HINT_RE_EVAL            0x00200000 /* re pragma */
4659
4660 #define HINT_FILETEST_ACCESS    0x00400000 /* filetest pragma */
4661 #define HINT_UTF8               0x00800000 /* utf8 pragma */
4662
4663 #define HINT_NO_AMAGIC          0x01000000 /* overloading pragma */
4664
4665 /* The following are stored in $^H{sort}, not in PL_hints */
4666 #define HINT_SORT_SORT_BITS     0x000000FF /* allow 256 different ones */
4667 #define HINT_SORT_QUICKSORT     0x00000001
4668 #define HINT_SORT_MERGESORT     0x00000002
4669 #define HINT_SORT_STABLE        0x00000100 /* sort styles (currently one) */
4670
4671 /* Various states of the input record separator SV (rs) */
4672 #define RsSNARF(sv)   (! SvOK(sv))
4673 #define RsSIMPLE(sv)  (SvOK(sv) && (! SvPOK(sv) || SvCUR(sv)))
4674 #define RsPARA(sv)    (SvPOK(sv) && ! SvCUR(sv))
4675 #define RsRECORD(sv)  (SvROK(sv) && (SvIV(SvRV(sv)) > 0))
4676
4677 /* A struct for keeping various DEBUGGING related stuff,
4678  * neatly packed.  Currently only scratch variables for
4679  * constructing debug output are included.  Needed always,
4680  * not just when DEBUGGING, though, because of the re extension. c*/
4681 struct perl_debug_pad {
4682   SV pad[3];
4683 };
4684
4685 #define PERL_DEBUG_PAD(i)       &(PL_debug_pad.pad[i])
4686 #define PERL_DEBUG_PAD_ZERO(i)  (SvPVX(PERL_DEBUG_PAD(i))[0] = 0, \
4687         (((XPV*) SvANY(PERL_DEBUG_PAD(i)))->xpv_cur = 0), \
4688         PERL_DEBUG_PAD(i))
4689
4690 /* Enable variables which are pointers to functions */
4691 typedef void (CPERLscope(*peep_t))(pTHX_ OP* o);
4692 typedef regexp*(CPERLscope(*regcomp_t)) (pTHX_ char* exp, char* xend, PMOP* pm);
4693 typedef I32 (CPERLscope(*regexec_t)) (pTHX_ regexp* prog, char* stringarg,
4694                                       char* strend, char* strbeg, I32 minend,
4695                                       SV* screamer, void* data, U32 flags);
4696 typedef char* (CPERLscope(*re_intuit_start_t)) (pTHX_ regexp *prog, SV *sv,
4697                                                 char *strpos, char *strend,
4698                                                 U32 flags,
4699                                                 re_scream_pos_data *d);
4700 typedef SV*     (CPERLscope(*re_intuit_string_t)) (pTHX_ regexp *prog);
4701 typedef void    (CPERLscope(*regfree_t)) (pTHX_ struct regexp* r);
4702 typedef regexp*(CPERLscope(*regdupe_t)) (pTHX_ const regexp* r, CLONE_PARAMS *param);
4703
4704 typedef void (*DESTRUCTORFUNC_NOCONTEXT_t) (void*);
4705 typedef void (*DESTRUCTORFUNC_t) (pTHX_ void*);
4706 typedef void (*SVFUNC_t) (pTHX_ SV* const);
4707 typedef I32  (*SVCOMPARE_t) (pTHX_ SV* const, SV* const);
4708 typedef void (*XSINIT_t) (pTHX);
4709 typedef void (*ATEXIT_t) (pTHX_ void*);
4710 typedef void (*XSUBADDR_t) (pTHX_ CV *);
4711
4712 /* Set up PERLVAR macros for populating structs */
4713 #define PERLVAR(var,type) type var;
4714 #define PERLVARA(var,n,type) type var[n];
4715 #define PERLVARI(var,type,init) type var;
4716 #define PERLVARIC(var,type,init) type var;
4717 #define PERLVARISC(var,init) const char var[sizeof(init)];
4718
4719 typedef OP* (CPERLscope(*Perl_ppaddr_t))(pTHX);
4720 typedef OP* (CPERLscope(*Perl_check_t)) (pTHX_ OP*);
4721
4722 /* Interpreter exitlist entry */
4723 typedef struct exitlistentry {
4724     void (*fn) (pTHX_ void*);
4725     void *ptr;
4726 } PerlExitListEntry;
4727
4728 /* if you only have signal() and it resets on each signal, FAKE_PERSISTENT_SIGNAL_HANDLERS fixes */
4729 /* These have to be before perlvars.h */
4730 #if !defined(HAS_SIGACTION) && defined(VMS)
4731 #  define  FAKE_PERSISTENT_SIGNAL_HANDLERS
4732 #endif
4733 /* if we're doing kill() with sys$sigprc on VMS, FAKE_DEFAULT_SIGNAL_HANDLERS */
4734 #if defined(KILL_BY_SIGPRC)
4735 #  define  FAKE_DEFAULT_SIGNAL_HANDLERS
4736 #endif
4737
4738 #define PERL_PATCHLEVEL_H_IMPLICIT
4739 #include "patchlevel.h"
4740 #undef PERL_PATCHLEVEL_H_IMPLICIT
4741
4742 #ifdef PERL_GLOBAL_STRUCT
4743 struct perl_vars {
4744 #  include "perlvars.h"
4745 };
4746
4747 #  ifdef PERL_CORE
4748 #    ifndef PERL_GLOBAL_STRUCT_PRIVATE
4749 EXT struct perl_vars PL_Vars;
4750 EXT struct perl_vars *PL_VarsPtr INIT(&PL_Vars);
4751 #      undef PERL_GET_VARS
4752 #      define PERL_GET_VARS() PL_VarsPtr
4753 #    endif /* !PERL_GLOBAL_STRUCT_PRIVATE */
4754 #  else /* PERL_CORE */
4755 #    if !defined(__GNUC__) || !defined(WIN32)
4756 EXT
4757 #    endif /* WIN32 */
4758 struct perl_vars *PL_VarsPtr;
4759 #    define PL_Vars (*((PL_VarsPtr) \
4760                        ? PL_VarsPtr : (PL_VarsPtr = Perl_GetVars(aTHX))))
4761 #  endif /* PERL_CORE */
4762 #endif /* PERL_GLOBAL_STRUCT */
4763
4764 #if defined(MULTIPLICITY)
4765 /* If we have multiple interpreters define a struct
4766    holding variables which must be per-interpreter
4767    If we don't have threads anything that would have
4768    be per-thread is per-interpreter.
4769 */
4770
4771 struct interpreter {
4772 #  include "intrpvar.h"
4773 };
4774
4775 #else
4776 struct interpreter {
4777     char broiled;
4778 };
4779 #endif /* MULTIPLICITY */
4780
4781 /* Done with PERLVAR macros for now ... */
4782 #undef PERLVAR
4783 #undef PERLVARA
4784 #undef PERLVARI
4785 #undef PERLVARIC
4786 #undef PERLVARISC
4787
4788 struct tempsym; /* defined in pp_pack.c */
4789
4790 #include "thread.h"
4791 #include "pp.h"
4792
4793 #ifndef PERL_CALLCONV
4794 #  ifdef __cplusplus
4795 #    define PERL_CALLCONV extern "C"
4796 #  else
4797 #    define PERL_CALLCONV
4798 #  endif
4799 #endif
4800 #undef PERL_CKDEF
4801 #undef PERL_PPDEF
4802 #define PERL_CKDEF(s)   PERL_CALLCONV OP *s (pTHX_ OP *o);
4803 #define PERL_PPDEF(s)   PERL_CALLCONV OP *s (pTHX);
4804
4805 #include "proto.h"
4806
4807 /* this has structure inits, so it cannot be included before here */
4808 #include "opcode.h"
4809
4810 /* The following must follow proto.h as #defines mess up syntax */
4811
4812 #if !defined(PERL_FOR_X2P)
4813 #  include "embedvar.h"
4814 #endif
4815 #ifndef PERL_MAD
4816 #  undef PL_madskills
4817 #  undef PL_xmlfp
4818 #  define PL_madskills 0
4819 #  define PL_xmlfp 0
4820 #endif
4821
4822 /* Now include all the 'global' variables
4823  * If we don't have threads or multiple interpreters
4824  * these include variables that would have been their struct-s
4825  */
4826
4827 #define PERLVAR(var,type) EXT type PL_##var;
4828 #define PERLVARA(var,n,type) EXT type PL_##var[n];
4829 #define PERLVARI(var,type,init) EXT type  PL_##var INIT(init);
4830 #define PERLVARIC(var,type,init) EXTCONST type PL_##var INIT(init);
4831 #define PERLVARISC(var,init) EXTCONST char PL_##var[sizeof(init)] INIT(init);
4832
4833 #if !defined(MULTIPLICITY)
4834 START_EXTERN_C
4835 #  include "intrpvar.h"
4836 END_EXTERN_C
4837 #endif
4838
4839 #ifdef PERL_CORE
4840 /* All core uses now exterminated. Ensure no zombies can return:  */
4841 #  undef PL_na
4842 #endif
4843
4844 #if defined(WIN32)
4845 /* Now all the config stuff is setup we can include embed.h */
4846 #  include "embed.h"
4847 #  ifndef PERL_MAD
4848 #    undef op_getmad
4849 #    define op_getmad(arg,pegop,slot) NOOP
4850 #  endif
4851 #endif
4852
4853 #ifndef PERL_GLOBAL_STRUCT
4854 START_EXTERN_C
4855
4856 #  include "perlvars.h"
4857
4858 END_EXTERN_C
4859 #endif
4860
4861 #undef PERLVAR
4862 #undef PERLVARA
4863 #undef PERLVARI
4864 #undef PERLVARIC
4865
4866 START_EXTERN_C
4867
4868 /* PERL_GLOBAL_STRUCT_PRIVATE wants to keep global data like the
4869  * magic vtables const, but this is incompatible with SWIG which
4870  * does want to modify the vtables. */
4871 #ifdef PERL_GLOBAL_STRUCT_PRIVATE
4872 #  define EXT_MGVTBL EXTCONST MGVTBL
4873 #else
4874 #  define EXT_MGVTBL EXT MGVTBL
4875 #endif
4876
4877 #ifdef DOINIT
4878 #  define MGVTBL_SET(var,a,b,c,d,e,f,g,h) EXT_MGVTBL var = {a,b,c,d,e,f,g,h}
4879 /* Like MGVTBL_SET but with the get magic having a const MG* */
4880 #  define MGVTBL_SET_CONST_MAGIC_GET(var,a,b,c,d,e,f,g,h) EXT_MGVTBL var \
4881     = {(int (*)(pTHX_ SV *, MAGIC *))a,b,c,d,e,f,g,h}
4882 #else
4883 #  define MGVTBL_SET(var,a,b,c,d,e,f,g,h) EXT_MGVTBL var
4884 #  define MGVTBL_SET_CONST_MAGIC_GET(var,a,b,c,d,e,f,g,h) EXT_MGVTBL var
4885 #endif
4886
4887 /* These all need to be 0, not NULL, as NULL can be (void*)0, which is a
4888  * pointer to data, whereas we're assigning pointers to functions, which are
4889  * not the same beast. ANSI doesn't allow the assignment from one to the other.
4890  * (although most, but not all, compilers are prepared to do it)
4891  */
4892 MGVTBL_SET(
4893     PL_vtbl_sv,
4894     MEMBER_TO_FPTR(Perl_magic_get),
4895     MEMBER_TO_FPTR(Perl_magic_set),
4896     MEMBER_TO_FPTR(Perl_magic_len),
4897     0,
4898     0,
4899     0,
4900     0,
4901     0
4902 );
4903
4904 MGVTBL_SET(
4905     PL_vtbl_env,
4906     0,
4907     MEMBER_TO_FPTR(Perl_magic_set_all_env),
4908     0,
4909     MEMBER_TO_FPTR(Perl_magic_clear_all_env),
4910     0,
4911     0,
4912     0,
4913     0
4914 );
4915
4916 MGVTBL_SET(
4917     PL_vtbl_envelem,
4918     0,
4919     MEMBER_TO_FPTR(Perl_magic_setenv),
4920     0,
4921     MEMBER_TO_FPTR(Perl_magic_clearenv),
4922     0,
4923     0,
4924     0,
4925     0
4926 );
4927
4928 /* For now, hints magic will also use vtbl_sig, because it is all 0  */
4929 MGVTBL_SET(
4930     PL_vtbl_sig,
4931     0,
4932     0,
4933     0,
4934     0,
4935     0,
4936     0,
4937     0,
4938     0
4939 );
4940
4941 #ifdef PERL_MICRO
4942 MGVTBL_SET(
4943     PL_vtbl_sigelem,
4944     0,
4945     0,
4946     0,
4947     0,
4948     0,
4949     0,
4950     0,
4951     0
4952 );
4953
4954 #else
4955 MGVTBL_SET(
4956     PL_vtbl_sigelem,
4957     MEMBER_TO_FPTR(Perl_magic_getsig),
4958     MEMBER_TO_FPTR(Perl_magic_setsig),
4959     0,
4960     MEMBER_TO_FPTR(Perl_magic_clearsig),
4961     0,
4962     0,
4963     0,
4964     0
4965 );
4966 #endif
4967
4968 MGVTBL_SET(
4969     PL_vtbl_pack,
4970     0,
4971     0,
4972     MEMBER_TO_FPTR(Perl_magic_sizepack),
4973     MEMBER_TO_FPTR(Perl_magic_wipepack),
4974     0,
4975     0,
4976     0,
4977     0
4978 );
4979
4980 MGVTBL_SET(
4981     PL_vtbl_packelem,
4982     MEMBER_TO_FPTR(Perl_magic_getpack),
4983     MEMBER_TO_FPTR(Perl_magic_setpack),
4984     0,
4985     MEMBER_TO_FPTR(Perl_magic_clearpack),
4986     0,
4987     0,
4988     0,
4989     0
4990 );
4991
4992 MGVTBL_SET(
4993     PL_vtbl_dbline,
4994     0,
4995     MEMBER_TO_FPTR(Perl_magic_setdbline),
4996     0,
4997     0,
4998     0,
4999     0,
5000     0,
5001     0
5002 );
5003
5004 MGVTBL_SET(
5005     PL_vtbl_isa,
5006     0,
5007     MEMBER_TO_FPTR(Perl_magic_setisa),
5008     0,
5009     MEMBER_TO_FPTR(Perl_magic_clearisa),
5010     0,
5011     0,
5012     0,
5013     0
5014 );
5015
5016 MGVTBL_SET(
5017     PL_vtbl_isaelem,
5018     0,
5019     MEMBER_TO_FPTR(Perl_magic_setisa),
5020     0,
5021     0,
5022     0,
5023     0,
5024     0,
5025     0
5026 );
5027
5028 MGVTBL_SET_CONST_MAGIC_GET(
5029     PL_vtbl_arylen,
5030     MEMBER_TO_FPTR(Perl_magic_getarylen),
5031     MEMBER_TO_FPTR(Perl_magic_setarylen),
5032     0,
5033     0,
5034     0,
5035     0,
5036     0,
5037     0
5038 );
5039
5040 MGVTBL_SET(
5041     PL_vtbl_arylen_p,
5042     0,
5043     0,
5044     0,
5045     0,
5046     MEMBER_TO_FPTR(Perl_magic_freearylen_p),
5047     0,
5048     0,
5049     0
5050 );
5051
5052 MGVTBL_SET(
5053     PL_vtbl_mglob,
5054     0,
5055     MEMBER_TO_FPTR(Perl_magic_setmglob),
5056     0,
5057     0,
5058     0,
5059     0,
5060     0,
5061     0
5062 );
5063
5064 MGVTBL_SET(
5065     PL_vtbl_nkeys,
5066     MEMBER_TO_FPTR(Perl_magic_getnkeys),
5067     MEMBER_TO_FPTR(Perl_magic_setnkeys),
5068     0,
5069     0,
5070     0,
5071     0,
5072     0,
5073     0
5074 );
5075
5076 MGVTBL_SET(
5077     PL_vtbl_taint,
5078     MEMBER_TO_FPTR(Perl_magic_gettaint),
5079     MEMBER_TO_FPTR(Perl_magic_settaint),
5080     0,
5081     0,
5082     0,
5083     0,
5084     0,
5085     0
5086 );
5087
5088 MGVTBL_SET(
5089     PL_vtbl_substr,
5090     MEMBER_TO_FPTR(Perl_magic_getsubstr),
5091     MEMBER_TO_FPTR(Perl_magic_setsubstr),
5092     0,
5093     0,
5094     0,
5095     0,
5096     0,
5097     0
5098 );
5099
5100 MGVTBL_SET(
5101     PL_vtbl_vec,
5102     MEMBER_TO_FPTR(Perl_magic_getvec),
5103     MEMBER_TO_FPTR(Perl_magic_setvec),
5104     0,
5105     0,
5106     0,
5107     0,
5108     0,
5109     0
5110 );
5111
5112 MGVTBL_SET(
5113     PL_vtbl_pos,
5114     MEMBER_TO_FPTR(Perl_magic_getpos),
5115     MEMBER_TO_FPTR(Perl_magic_setpos),
5116     0,
5117     0,
5118     0,
5119     0,
5120     0,
5121     0
5122 );
5123
5124 MGVTBL_SET(
5125     PL_vtbl_bm,
5126     0,
5127     MEMBER_TO_FPTR(Perl_magic_setregexp),
5128     0,
5129     0,
5130     0,
5131     0,
5132     0,
5133     0
5134 );
5135
5136 MGVTBL_SET(
5137     PL_vtbl_fm,
5138     0,
5139     MEMBER_TO_FPTR(Perl_magic_setregexp),
5140     0,
5141     0,
5142     0,
5143     0,
5144     0,
5145     0
5146 );
5147
5148 MGVTBL_SET(
5149     PL_vtbl_uvar,
5150     MEMBER_TO_FPTR(Perl_magic_getuvar),
5151     MEMBER_TO_FPTR(Perl_magic_setuvar),
5152     0,
5153     0,
5154     0,
5155     0,
5156     0,
5157     0
5158 );
5159
5160 MGVTBL_SET(
5161     PL_vtbl_defelem,
5162     MEMBER_TO_FPTR(Perl_magic_getdefelem),
5163     MEMBER_TO_FPTR(Perl_magic_setdefelem),
5164     0,
5165     0,
5166     0,
5167     0,
5168     0,
5169     0
5170 );
5171
5172 MGVTBL_SET(
5173     PL_vtbl_regexp,
5174     0,
5175     MEMBER_TO_FPTR(Perl_magic_setregexp),
5176     0,
5177     0,
5178     0,
5179     0,
5180     0,
5181     0
5182 );
5183
5184 MGVTBL_SET(
5185     PL_vtbl_regdata,
5186     0,
5187     0,
5188     MEMBER_TO_FPTR(Perl_magic_regdata_cnt),
5189     0,
5190     0,
5191     0,
5192     0,
5193     0
5194 );
5195
5196 MGVTBL_SET(
5197     PL_vtbl_regdatum,
5198     MEMBER_TO_FPTR(Perl_magic_regdatum_get),
5199     MEMBER_TO_FPTR(Perl_magic_regdatum_set),
5200     0,
5201     0,
5202     0,
5203     0,
5204     0,
5205     0
5206 );
5207
5208 MGVTBL_SET(
5209     PL_vtbl_amagic,
5210     0,
5211     MEMBER_TO_FPTR(Perl_magic_setamagic),
5212     0,
5213     0,
5214     MEMBER_TO_FPTR(Perl_magic_setamagic),
5215     0,
5216     0,
5217     0
5218 );
5219
5220 MGVTBL_SET(
5221     PL_vtbl_amagicelem,
5222     0,
5223     MEMBER_TO_FPTR(Perl_magic_setamagic),
5224     0,
5225     0,
5226     MEMBER_TO_FPTR(Perl_magic_setamagic),
5227     0,
5228     0,
5229     0
5230 );
5231
5232 MGVTBL_SET(
5233     PL_vtbl_backref,
5234     0,
5235     0,
5236     0,
5237     0,
5238     MEMBER_TO_FPTR(Perl_magic_killbackrefs),
5239     0,
5240     0,
5241     0
5242 );
5243
5244 MGVTBL_SET(
5245     PL_vtbl_ovrld,
5246     0,
5247     0,
5248     0,
5249     0,
5250     MEMBER_TO_FPTR(Perl_magic_freeovrld),
5251     0,
5252     0,
5253     0
5254 );
5255
5256 MGVTBL_SET(
5257     PL_vtbl_utf8,
5258     0,
5259     MEMBER_TO_FPTR(Perl_magic_setutf8),
5260     0,
5261     0,
5262     0,
5263     0,
5264     0,
5265     0
5266 );
5267 #ifdef USE_LOCALE_COLLATE
5268 MGVTBL_SET(
5269     PL_vtbl_collxfrm,
5270     0,
5271     MEMBER_TO_FPTR(Perl_magic_setcollxfrm),
5272     0,
5273     0,
5274     0,
5275     0,
5276     0,
5277     0
5278 );
5279 #endif
5280
5281 MGVTBL_SET(
5282     PL_vtbl_hintselem,
5283     0,
5284     MEMBER_TO_FPTR(Perl_magic_sethint),
5285     0,
5286     MEMBER_TO_FPTR(Perl_magic_clearhint),
5287     0,
5288     0,
5289     0,
5290     0
5291 );
5292
5293 #include "overload.h"
5294
5295 END_EXTERN_C
5296
5297 struct am_table {
5298   U32 flags;
5299   U32 was_ok_sub;
5300   long was_ok_am;
5301   long fallback;
5302   CV* table[NofAMmeth];
5303 };
5304 struct am_table_short {
5305   U32 flags;
5306   U32 was_ok_sub;
5307   long was_ok_am;
5308 };
5309 typedef struct am_table AMT;
5310 typedef struct am_table_short AMTS;
5311
5312 #define AMGfallNEVER    1
5313 #define AMGfallNO       2
5314 #define AMGfallYES      3
5315
5316 #define AMTf_AMAGIC             1
5317 #define AMTf_OVERLOADED         2
5318 #define AMT_AMAGIC(amt)         ((amt)->flags & AMTf_AMAGIC)
5319 #define AMT_AMAGIC_on(amt)      ((amt)->flags |= AMTf_AMAGIC)
5320 #define AMT_AMAGIC_off(amt)     ((amt)->flags &= ~AMTf_AMAGIC)
5321 #define AMT_OVERLOADED(amt)     ((amt)->flags & AMTf_OVERLOADED)
5322 #define AMT_OVERLOADED_on(amt)  ((amt)->flags |= AMTf_OVERLOADED)
5323 #define AMT_OVERLOADED_off(amt) ((amt)->flags &= ~AMTf_OVERLOADED)
5324
5325 #define StashHANDLER(stash,meth)        gv_handler((stash),CAT2(meth,_amg))
5326
5327 /*
5328  * some compilers like to redefine cos et alia as faster
5329  * (and less accurate?) versions called F_cos et cetera (Quidquid
5330  * latine dictum sit, altum viditur.)  This trick collides with
5331  * the Perl overloading (amg).  The following #defines fool both.
5332  */
5333
5334 #ifdef _FASTMATH
5335 #   ifdef atan2
5336 #       define F_atan2_amg  atan2_amg
5337 #   endif
5338 #   ifdef cos
5339 #       define F_cos_amg    cos_amg
5340 #   endif
5341 #   ifdef exp
5342 #       define F_exp_amg    exp_amg
5343 #   endif
5344 #   ifdef log
5345 #       define F_log_amg    log_amg
5346 #   endif
5347 #   ifdef pow
5348 #       define F_pow_amg    pow_amg
5349 #   endif
5350 #   ifdef sin
5351 #       define F_sin_amg    sin_amg
5352 #   endif
5353 #   ifdef sqrt
5354 #       define F_sqrt_amg   sqrt_amg
5355 #   endif
5356 #endif /* _FASTMATH */
5357
5358 #define PERLDB_ALL              (PERLDBf_SUB    | PERLDBf_LINE  |       \
5359                                  PERLDBf_NOOPT  | PERLDBf_INTER |       \
5360                                  PERLDBf_SUBLINE| PERLDBf_SINGLE|       \
5361                                  PERLDBf_NAMEEVAL| PERLDBf_NAMEANON |   \
5362                                  PERLDBf_SAVESRC)
5363                                         /* No _NONAME, _GOTO */
5364 #define PERLDBf_SUB             0x01    /* Debug sub enter/exit */
5365 #define PERLDBf_LINE            0x02    /* Keep line # */
5366 #define PERLDBf_NOOPT           0x04    /* Switch off optimizations */
5367 #define PERLDBf_INTER           0x08    /* Preserve more data for
5368                                            later inspections  */
5369 #define PERLDBf_SUBLINE         0x10    /* Keep subr source lines */
5370 #define PERLDBf_SINGLE          0x20    /* Start with single-step on */
5371 #define PERLDBf_NONAME          0x40    /* For _SUB: no name of the subr */
5372 #define PERLDBf_GOTO            0x80    /* Report goto: call DB::goto */
5373 #define PERLDBf_NAMEEVAL        0x100   /* Informative names for evals */
5374 #define PERLDBf_NAMEANON        0x200   /* Informative names for anon subs */
5375 #define PERLDBf_SAVESRC         0x400   /* Save source lines into @{"_<$filename"} */
5376 #define PERLDBf_SAVESRC_NOSUBS  0x800   /* Including evals that generate no subrouties */
5377 #define PERLDBf_SAVESRC_INVALID 0x1000  /* Save source that did not compile */
5378
5379 #define PERLDB_SUB      (PL_perldb && (PL_perldb & PERLDBf_SUB))
5380 #define PERLDB_LINE     (PL_perldb && (PL_perldb & PERLDBf_LINE))
5381 #define PERLDB_NOOPT    (PL_perldb && (PL_perldb & PERLDBf_NOOPT))
5382 #define PERLDB_INTER    (PL_perldb && (PL_perldb & PERLDBf_INTER))
5383 #define PERLDB_SUBLINE  (PL_perldb && (PL_perldb & PERLDBf_SUBLINE))
5384 #define PERLDB_SINGLE   (PL_perldb && (PL_perldb & PERLDBf_SINGLE))
5385 #define PERLDB_SUB_NN   (PL_perldb && (PL_perldb & (PERLDBf_NONAME)))
5386 #define PERLDB_GOTO     (PL_perldb && (PL_perldb & PERLDBf_GOTO))
5387 #define PERLDB_NAMEEVAL (PL_perldb && (PL_perldb & PERLDBf_NAMEEVAL))
5388 #define PERLDB_NAMEANON (PL_perldb && (PL_perldb & PERLDBf_NAMEANON))
5389 #define PERLDB_SAVESRC  (PL_perldb && (PL_perldb & PERLDBf_SAVESRC))
5390 #define PERLDB_SAVESRC_NOSUBS   (PL_perldb && (PL_perldb & PERLDBf_SAVESRC_NOSUBS))
5391 #define PERLDB_SAVESRC_INVALID  (PL_perldb && (PL_perldb & PERLDBf_SAVESRC_INVALID))
5392
5393 #ifdef USE_LOCALE_NUMERIC
5394
5395 #define SET_NUMERIC_STANDARD() \
5396         set_numeric_standard();
5397
5398 #define SET_NUMERIC_LOCAL() \
5399         set_numeric_local();
5400
5401 #define IN_LOCALE_RUNTIME       (CopHINTS_get(PL_curcop) & HINT_LOCALE)
5402 #define IN_LOCALE_COMPILETIME   (PL_hints & HINT_LOCALE)
5403
5404 #define IN_LOCALE \
5405         (IN_PERL_COMPILETIME ? IN_LOCALE_COMPILETIME : IN_LOCALE_RUNTIME)
5406
5407 #define STORE_NUMERIC_LOCAL_SET_STANDARD() \
5408         bool was_local = PL_numeric_local && IN_LOCALE; \
5409         if (was_local) SET_NUMERIC_STANDARD();
5410
5411 #define STORE_NUMERIC_STANDARD_SET_LOCAL() \
5412         bool was_standard = PL_numeric_standard && IN_LOCALE; \
5413         if (was_standard) SET_NUMERIC_LOCAL();
5414
5415 #define RESTORE_NUMERIC_LOCAL() \
5416         if (was_local) SET_NUMERIC_LOCAL();
5417
5418 #define RESTORE_NUMERIC_STANDARD() \
5419         if (was_standard) SET_NUMERIC_STANDARD();
5420
5421 #define Atof                            my_atof
5422
5423 #else /* !USE_LOCALE_NUMERIC */
5424
5425 #define SET_NUMERIC_STANDARD()          /**/
5426 #define SET_NUMERIC_LOCAL()             /**/
5427 #define IS_NUMERIC_RADIX(a, b)          (0)
5428 #define STORE_NUMERIC_LOCAL_SET_STANDARD()      /**/
5429 #define STORE_NUMERIC_STANDARD_SET_LOCAL()      /**/
5430 #define RESTORE_NUMERIC_LOCAL()         /**/
5431 #define RESTORE_NUMERIC_STANDARD()      /**/
5432 #define Atof                            my_atof
5433 #define IN_LOCALE_RUNTIME               0
5434
5435 #endif /* !USE_LOCALE_NUMERIC */
5436
5437 #if !defined(Strtol) && defined(USE_64_BIT_INT) && defined(IV_IS_QUAD) && QUADKIND == QUAD_IS_LONG_LONG
5438 #    ifdef __hpux
5439 #        define strtoll __strtoll       /* secret handshake */
5440 #    endif
5441 #    ifdef WIN64
5442 #        define strtoll _strtoi64       /* secret handshake */
5443 #    endif
5444 #   if !defined(Strtol) && defined(HAS_STRTOLL)
5445 #       define Strtol   strtoll
5446 #   endif
5447 #    if !defined(Strtol) && defined(HAS_STRTOQ)
5448 #       define Strtol   strtoq
5449 #    endif
5450 /* is there atoq() anywhere? */
5451 #endif
5452 #if !defined(Strtol) && defined(HAS_STRTOL)
5453 #   define Strtol       strtol
5454 #endif
5455 #ifndef Atol
5456 /* It would be more fashionable to use Strtol() to define atol()
5457  * (as is done for Atoul(), see below) but for backward compatibility
5458  * we just assume atol(). */
5459 #   if defined(USE_64_BIT_INT) && defined(IV_IS_QUAD) && QUADKIND == QUAD_IS_LONG_LONG && defined(HAS_ATOLL)
5460 #    ifdef WIN64
5461 #       define atoll    _atoi64         /* secret handshake */
5462 #    endif
5463 #       define Atol     atoll
5464 #   else
5465 #       define Atol     atol
5466 #   endif
5467 #endif
5468
5469 #if !defined(Strtoul) && defined(USE_64_BIT_INT) && defined(UV_IS_QUAD) && QUADKIND == QUAD_IS_LONG_LONG
5470 #    ifdef __hpux
5471 #        define strtoull __strtoull     /* secret handshake */
5472 #    endif
5473 #    ifdef WIN64
5474 #        define strtoull _strtoui64     /* secret handshake */
5475 #    endif
5476 #    if !defined(Strtoul) && defined(HAS_STRTOULL)
5477 #       define Strtoul  strtoull
5478 #    endif
5479 #    if !defined(Strtoul) && defined(HAS_STRTOUQ)
5480 #       define Strtoul  strtouq
5481 #    endif
5482 /* is there atouq() anywhere? */
5483 #endif
5484 #if !defined(Strtoul) && defined(HAS_STRTOUL)
5485 #   define Strtoul      strtoul
5486 #endif
5487 #if !defined(Strtoul) && defined(HAS_STRTOL) /* Last resort. */
5488 #   define Strtoul(s, e, b)     strchr((s), '-') ? ULONG_MAX : (unsigned long)strtol((s), (e), (b))
5489 #endif
5490 #ifndef Atoul
5491 #   define Atoul(s)     Strtoul(s, NULL, 10)
5492 #endif
5493
5494
5495 /* if these never got defined, they need defaults */
5496 #ifndef PERL_SET_CONTEXT
5497 #  define PERL_SET_CONTEXT(i)           PERL_SET_INTERP(i)
5498 #endif
5499
5500 #ifndef PERL_GET_CONTEXT
5501 #  define PERL_GET_CONTEXT              PERL_GET_INTERP
5502 #endif
5503
5504 #ifndef PERL_GET_THX
5505 #  define PERL_GET_THX                  ((void*)NULL)
5506 #endif
5507
5508 #ifndef PERL_SET_THX
5509 #  define PERL_SET_THX(t)               NOOP
5510 #endif
5511
5512 #ifndef PERL_SCRIPT_MODE
5513 #define PERL_SCRIPT_MODE "r"
5514 #endif
5515
5516 /*
5517  * Some operating systems are stingy with stack allocation,
5518  * so perl may have to guard against stack overflow.
5519  */
5520 #ifndef PERL_STACK_OVERFLOW_CHECK
5521 #define PERL_STACK_OVERFLOW_CHECK()  NOOP
5522 #endif
5523
5524 /*
5525  * Some nonpreemptive operating systems find it convenient to
5526  * check for asynchronous conditions after each op execution.
5527  * Keep this check simple, or it may slow down execution
5528  * massively.
5529  */
5530
5531 #ifndef PERL_MICRO
5532 #       ifndef PERL_ASYNC_CHECK
5533 #               define PERL_ASYNC_CHECK() if (PL_sig_pending) despatch_signals()
5534 #       endif
5535 #endif
5536
5537 #ifndef PERL_ASYNC_CHECK
5538 #   define PERL_ASYNC_CHECK()  NOOP
5539 #endif
5540
5541 /*
5542  * On some operating systems, a memory allocation may succeed,
5543  * but put the process too close to the system's comfort limit.
5544  * In this case, PERL_ALLOC_CHECK frees the pointer and sets
5545  * it to NULL.
5546  */
5547 #ifndef PERL_ALLOC_CHECK
5548 #define PERL_ALLOC_CHECK(p)  NOOP
5549 #endif
5550
5551 #ifdef HAS_SEM
5552 #   include <sys/ipc.h>
5553 #   include <sys/sem.h>
5554 #   ifndef HAS_UNION_SEMUN      /* Provide the union semun. */
5555     union semun {
5556         int             val;
5557         struct semid_ds *buf;
5558         unsigned short  *array;
5559     };
5560 #   endif
5561 #   ifdef USE_SEMCTL_SEMUN
5562 #       ifdef IRIX32_SEMUN_BROKEN_BY_GCC
5563             union gccbug_semun {
5564                 int             val;
5565                 struct semid_ds *buf;
5566                 unsigned short  *array;
5567                 char            __dummy[5];
5568             };
5569 #           define semun gccbug_semun
5570 #       endif
5571 #       define Semctl(id, num, cmd, semun) semctl(id, num, cmd, semun)
5572 #   else
5573 #       ifdef USE_SEMCTL_SEMID_DS
5574 #           ifdef EXTRA_F_IN_SEMUN_BUF
5575 #               define Semctl(id, num, cmd, semun) semctl(id, num, cmd, semun.buff)
5576 #           else
5577 #               define Semctl(id, num, cmd, semun) semctl(id, num, cmd, semun.buf)
5578 #           endif
5579 #       endif
5580 #   endif
5581 #endif
5582
5583 /*
5584  * Boilerplate macros for initializing and accessing interpreter-local
5585  * data from C.  All statics in extensions should be reworked to use
5586  * this, if you want to make the extension thread-safe.  See
5587  * ext/XS/APItest/APItest.xs for an example of the use of these macros,
5588  * and perlxs.pod for more.
5589  *
5590  * Code that uses these macros is responsible for the following:
5591  * 1. #define MY_CXT_KEY to a unique string, e.g.
5592  *    "DynaLoader::_guts" XS_VERSION
5593  *    XXX in the current implementation, this string is ignored.
5594  * 2. Declare a typedef named my_cxt_t that is a structure that contains
5595  *    all the data that needs to be interpreter-local.
5596  * 3. Use the START_MY_CXT macro after the declaration of my_cxt_t.
5597  * 4. Use the MY_CXT_INIT macro such that it is called exactly once
5598  *    (typically put in the BOOT: section).
5599  * 5. Use the members of the my_cxt_t structure everywhere as
5600  *    MY_CXT.member.
5601  * 6. Use the dMY_CXT macro (a declaration) in all the functions that
5602  *    access MY_CXT.
5603  */
5604
5605 #if defined(PERL_IMPLICIT_CONTEXT)
5606
5607 #ifdef PERL_GLOBAL_STRUCT_PRIVATE
5608
5609 /* This must appear in all extensions that define a my_cxt_t structure,
5610  * right after the definition (i.e. at file scope).  The non-threads
5611  * case below uses it to declare the data as static. */
5612 #define START_MY_CXT
5613 #define MY_CXT_INDEX Perl_my_cxt_index(aTHX_ MY_CXT_KEY)
5614
5615 /* Creates and zeroes the per-interpreter data.
5616  * (We allocate my_cxtp in a Perl SV so that it will be released when
5617  * the interpreter goes away.) */
5618 #define MY_CXT_INIT \
5619         my_cxt_t *my_cxtp = \
5620             (my_cxt_t*)Perl_my_cxt_init(aTHX_ MY_CXT_KEY, sizeof(my_cxt_t))
5621 #define MY_CXT_INIT_INTERP(my_perl) \
5622         my_cxt_t *my_cxtp = \
5623             (my_cxt_t*)Perl_my_cxt_init(my_perl, MY_CXT_KEY, sizeof(my_cxt_t))
5624
5625 /* This declaration should be used within all functions that use the
5626  * interpreter-local data. */
5627 #define dMY_CXT \
5628         my_cxt_t *my_cxtp = (my_cxt_t *)PL_my_cxt_list[MY_CXT_INDEX]
5629 #define dMY_CXT_INTERP(my_perl) \
5630         my_cxt_t *my_cxtp = (my_cxt_t *)(my_perl)->Imy_cxt_list[MY_CXT_INDEX]
5631
5632 /* Clones the per-interpreter data. */
5633 #define MY_CXT_CLONE \
5634         my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1));\
5635         Copy(PL_my_cxt_list[MY_CXT_INDEX], my_cxtp, 1, my_cxt_t);\
5636         PL_my_cxt_list[MY_CXT_INDEX] = my_cxtp                          \
5637
5638 #else /* #ifdef PERL_GLOBAL_STRUCT_PRIVATE */
5639
5640 /* This must appear in all extensions that define a my_cxt_t structure,
5641  * right after the definition (i.e. at file scope).  The non-threads
5642  * case below uses it to declare the data as static. */
5643 #define START_MY_CXT static int my_cxt_index = -1;
5644
5645 /* This declaration should be used within all functions that use the
5646  * interpreter-local data. */
5647 #define dMY_CXT \
5648         my_cxt_t *my_cxtp = (my_cxt_t *)PL_my_cxt_list[my_cxt_index]
5649 #define dMY_CXT_INTERP(my_perl) \
5650         my_cxt_t *my_cxtp = (my_cxt_t *)(my_perl)->Imy_cxt_list[my_cxt_index]
5651
5652 /* Creates and zeroes the per-interpreter data.
5653  * (We allocate my_cxtp in a Perl SV so that it will be released when
5654  * the interpreter goes away.) */
5655 #define MY_CXT_INIT \
5656         my_cxt_t *my_cxtp = \
5657             (my_cxt_t*)Perl_my_cxt_init(aTHX_ &my_cxt_index, sizeof(my_cxt_t))
5658 #define MY_CXT_INIT_INTERP(my_perl) \
5659         my_cxt_t *my_cxtp = \
5660             (my_cxt_t*)Perl_my_cxt_init(my_perl, &my_cxt_index, sizeof(my_cxt_t))
5661
5662 /* Clones the per-interpreter data. */
5663 #define MY_CXT_CLONE \
5664         my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1));\
5665         Copy(PL_my_cxt_list[my_cxt_index], my_cxtp, 1, my_cxt_t);\
5666         PL_my_cxt_list[my_cxt_index] = my_cxtp                          \
5667
5668 #endif /* #ifdef PERL_GLOBAL_STRUCT_PRIVATE */
5669
5670 /* This macro must be used to access members of the my_cxt_t structure.
5671  * e.g. MYCXT.some_data */
5672 #define MY_CXT          (*my_cxtp)
5673
5674 /* Judicious use of these macros can reduce the number of times dMY_CXT
5675  * is used.  Use is similar to pTHX, aTHX etc. */
5676 #define pMY_CXT         my_cxt_t *my_cxtp
5677 #define pMY_CXT_        pMY_CXT,
5678 #define _pMY_CXT        ,pMY_CXT
5679 #define aMY_CXT         my_cxtp
5680 #define aMY_CXT_        aMY_CXT,
5681 #define _aMY_CXT        ,aMY_CXT
5682
5683 #else /* PERL_IMPLICIT_CONTEXT */
5684
5685 #define START_MY_CXT    static my_cxt_t my_cxt;
5686 #define dMY_CXT_SV      dNOOP
5687 #define dMY_CXT         dNOOP
5688 #define dMY_CXT_INTERP(my_perl) dNOOP
5689 #define MY_CXT_INIT     NOOP
5690 #define MY_CXT_CLONE    NOOP
5691 #define MY_CXT          my_cxt
5692
5693 #define pMY_CXT         void
5694 #define pMY_CXT_
5695 #define _pMY_CXT
5696 #define aMY_CXT
5697 #define aMY_CXT_
5698 #define _aMY_CXT
5699
5700 #endif /* !defined(PERL_IMPLICIT_CONTEXT) */
5701
5702 #ifdef I_FCNTL
5703 #  include <fcntl.h>
5704 #endif
5705
5706 #ifdef __Lynx__
5707 #  include <fcntl.h>
5708 #endif
5709
5710 #ifdef I_SYS_FILE
5711 #  include <sys/file.h>
5712 #endif
5713
5714 #if defined(HAS_FLOCK) && !defined(HAS_FLOCK_PROTO)
5715 int flock(int fd, int op);
5716 #endif
5717
5718 #ifndef O_RDONLY
5719 /* Assume UNIX defaults */
5720 #    define O_RDONLY    0000
5721 #    define O_WRONLY    0001
5722 #    define O_RDWR      0002
5723 #    define O_CREAT     0100
5724 #endif
5725
5726 #ifndef O_BINARY
5727 #  define O_BINARY 0
5728 #endif
5729
5730 #ifndef O_TEXT
5731 #  define O_TEXT 0
5732 #endif
5733
5734 #if O_TEXT != O_BINARY
5735     /* If you have different O_TEXT and O_BINARY and you are a CLRF shop,
5736      * that is, you are somehow DOSish. */
5737 #   if defined(__BEOS__) || defined(__HAIKU__) || defined(__VOS__) || \
5738         defined(__CYGWIN__)
5739     /* BeOS/Haiku has O_TEXT != O_BINARY but O_TEXT and O_BINARY have no effect;
5740      * BeOS/Haiku is always UNIXoid (LF), not DOSish (CRLF). */
5741     /* VOS has O_TEXT != O_BINARY, and they have effect,
5742      * but VOS always uses LF, never CRLF. */
5743     /* If you have O_TEXT different from your O_BINARY but you still are
5744      * not a CRLF shop. */
5745 #       undef PERLIO_USING_CRLF
5746 #   else
5747     /* If you really are DOSish. */
5748 #      define PERLIO_USING_CRLF 1
5749 #   endif
5750 #endif
5751
5752 #ifdef IAMSUID
5753
5754 #ifdef I_SYS_STATVFS
5755 #   if defined(PERL_SCO) && !defined(_SVID3)
5756 #       define _SVID3
5757 #   endif
5758 #   include <sys/statvfs.h>     /* for f?statvfs() */
5759 #endif
5760 #ifdef I_SYS_MOUNT
5761 #   include <sys/mount.h>       /* for *BSD f?statfs() */
5762 #endif
5763 #ifdef I_MNTENT
5764 #   include <mntent.h>          /* for getmntent() */
5765 #endif
5766 #ifdef I_SYS_STATFS
5767 #   include <sys/statfs.h>      /* for some statfs() */
5768 #endif
5769 #ifdef I_SYS_VFS
5770 #  ifdef __sgi
5771 #    define sv IRIX_sv          /* kludge: IRIX has an sv of its own */
5772 #  endif
5773 #    include <sys/vfs.h>        /* for some statfs() */
5774 #  ifdef __sgi
5775 #    undef IRIX_sv
5776 #  endif
5777 #endif
5778 #ifdef I_USTAT
5779 #   include <ustat.h>           /* for ustat() */
5780 #endif
5781
5782 #if !defined(PERL_MOUNT_NOSUID) && defined(MOUNT_NOSUID)
5783 #    define PERL_MOUNT_NOSUID MOUNT_NOSUID
5784 #endif
5785 #if !defined(PERL_MOUNT_NOSUID) && defined(MNT_NOSUID)
5786 #    define PERL_MOUNT_NOSUID MNT_NOSUID
5787 #endif
5788 #if !defined(PERL_MOUNT_NOSUID) && defined(MS_NOSUID)
5789 #   define PERL_MOUNT_NOSUID MS_NOSUID
5790 #endif
5791 #if !defined(PERL_MOUNT_NOSUID) && defined(M_NOSUID)
5792 #   define PERL_MOUNT_NOSUID M_NOSUID
5793 #endif
5794
5795 #if !defined(PERL_MOUNT_NOEXEC) && defined(MOUNT_NOEXEC)
5796 #    define PERL_MOUNT_NOEXEC MOUNT_NOEXEC
5797 #endif
5798 #if !defined(PERL_MOUNT_NOEXEC) && defined(MNT_NOEXEC)
5799 #    define PERL_MOUNT_NOEXEC MNT_NOEXEC
5800 #endif
5801 #if !defined(PERL_MOUNT_NOEXEC) && defined(MS_NOEXEC)
5802 #   define PERL_MOUNT_NOEXEC MS_NOEXEC
5803 #endif
5804 #if !defined(PERL_MOUNT_NOEXEC) && defined(M_NOEXEC)
5805 #   define PERL_MOUNT_NOEXEC M_NOEXEC
5806 #endif
5807
5808 #endif /* IAMSUID */
5809
5810 #ifdef I_LIBUTIL
5811 #   include <libutil.h>         /* setproctitle() in some FreeBSDs */
5812 #endif
5813
5814 #ifndef EXEC_ARGV_CAST
5815 #define EXEC_ARGV_CAST(x) (char **)x
5816 #endif
5817
5818 #define IS_NUMBER_IN_UV               0x01 /* number within UV range (maybe not
5819                                               int).  value returned in pointed-
5820                                               to UV */
5821 #define IS_NUMBER_GREATER_THAN_UV_MAX 0x02 /* pointed to UV undefined */
5822 #define IS_NUMBER_NOT_INT             0x04 /* saw . or E notation */
5823 #define IS_NUMBER_NEG                 0x08 /* leading minus sign */
5824 #define IS_NUMBER_INFINITY            0x10 /* this is big */
5825 #define IS_NUMBER_NAN                 0x20 /* this is not */
5826
5827 #define GROK_NUMERIC_RADIX(sp, send) grok_numeric_radix(sp, send)
5828
5829 /* Input flags: */
5830 #define PERL_SCAN_ALLOW_UNDERSCORES   0x01 /* grok_??? accept _ in numbers */
5831 #define PERL_SCAN_DISALLOW_PREFIX     0x02 /* grok_??? reject 0x in hex etc */
5832 #define PERL_SCAN_SILENT_ILLDIGIT     0x04 /* grok_??? not warn about illegal digits */
5833 /* Output flags: */
5834 #define PERL_SCAN_GREATER_THAN_UV_MAX 0x02 /* should this merge with above? */
5835
5836 /* to let user control profiling */
5837 #ifdef PERL_GPROF_CONTROL
5838 extern void moncontrol(int);
5839 #define PERL_GPROF_MONCONTROL(x) moncontrol(x)
5840 #else
5841 #define PERL_GPROF_MONCONTROL(x)
5842 #endif
5843
5844 #ifdef UNDER_CE
5845 #include "wince.h"
5846 #endif
5847
5848 /* ISO 6429 NEL - C1 control NExt Line */
5849 /* See http://www.unicode.org/unicode/reports/tr13/ */
5850 #ifdef EBCDIC   /* In EBCDIC NEL is just an alias for LF */
5851 #   if '^' == 95        /* CP 1047: MVS OpenEdition - OS/390 - z/OS */
5852 #       define NEXT_LINE_CHAR   0x15
5853 #   else                /* CDRA */
5854 #       define NEXT_LINE_CHAR   0x25
5855 #   endif
5856 #else
5857 #   define NEXT_LINE_CHAR       0x85
5858 #endif
5859
5860 /* The UTF-8 bytes of the Unicode LS and PS, U+2028 and U+2029 */
5861 #define UNICODE_LINE_SEPA_0     0xE2
5862 #define UNICODE_LINE_SEPA_1     0x80
5863 #define UNICODE_LINE_SEPA_2     0xA8
5864 #define UNICODE_PARA_SEPA_0     0xE2
5865 #define UNICODE_PARA_SEPA_1     0x80
5866 #define UNICODE_PARA_SEPA_2     0xA9
5867
5868 #ifndef PIPESOCK_MODE
5869 #  define PIPESOCK_MODE
5870 #endif
5871
5872 #ifndef SOCKET_OPEN_MODE
5873 #  define SOCKET_OPEN_MODE      PIPESOCK_MODE
5874 #endif
5875
5876 #ifndef PIPE_OPEN_MODE
5877 #  define PIPE_OPEN_MODE        PIPESOCK_MODE
5878 #endif
5879
5880 #define PERL_MAGIC_UTF8_CACHESIZE       2
5881
5882 #define PERL_UNICODE_STDIN_FLAG                 0x0001
5883 #define PERL_UNICODE_STDOUT_FLAG                0x0002
5884 #define PERL_UNICODE_STDERR_FLAG                0x0004
5885 #define PERL_UNICODE_IN_FLAG                    0x0008
5886 #define PERL_UNICODE_OUT_FLAG                   0x0010
5887 #define PERL_UNICODE_ARGV_FLAG                  0x0020
5888 #define PERL_UNICODE_LOCALE_FLAG                0x0040
5889 #define PERL_UNICODE_WIDESYSCALLS_FLAG          0x0080 /* for Sarathy */
5890 #define PERL_UNICODE_UTF8CACHEASSERT_FLAG       0x0100
5891
5892 #define PERL_UNICODE_STD_FLAG           \
5893         (PERL_UNICODE_STDIN_FLAG        | \
5894          PERL_UNICODE_STDOUT_FLAG       | \
5895          PERL_UNICODE_STDERR_FLAG)
5896
5897 #define PERL_UNICODE_INOUT_FLAG         \
5898         (PERL_UNICODE_IN_FLAG   | \
5899          PERL_UNICODE_OUT_FLAG)
5900
5901 #define PERL_UNICODE_DEFAULT_FLAGS      \
5902         (PERL_UNICODE_STD_FLAG          | \
5903          PERL_UNICODE_INOUT_FLAG        | \
5904          PERL_UNICODE_LOCALE_FLAG)
5905
5906 #define PERL_UNICODE_ALL_FLAGS                  0x01ff
5907
5908 #define PERL_UNICODE_STDIN                      'I'
5909 #define PERL_UNICODE_STDOUT                     'O'
5910 #define PERL_UNICODE_STDERR                     'E'
5911 #define PERL_UNICODE_STD                        'S'
5912 #define PERL_UNICODE_IN                         'i'
5913 #define PERL_UNICODE_OUT                        'o'
5914 #define PERL_UNICODE_INOUT                      'D'
5915 #define PERL_UNICODE_ARGV                       'A'
5916 #define PERL_UNICODE_LOCALE                     'L'
5917 #define PERL_UNICODE_WIDESYSCALLS               'W'
5918 #define PERL_UNICODE_UTF8CACHEASSERT            'a'
5919
5920 #define PERL_SIGNALS_UNSAFE_FLAG        0x0001
5921
5922 /* From sigaction(2) (FreeBSD man page):
5923  * | Signal routines normally execute with the signal that
5924  * | caused their invocation blocked, but other signals may
5925  * | yet occur.
5926  * Emulation of this behavior (from within Perl) is enabled
5927  * by defining PERL_BLOCK_SIGNALS.
5928  */
5929 #define PERL_BLOCK_SIGNALS
5930
5931 #if defined(HAS_SIGPROCMASK) && defined(PERL_BLOCK_SIGNALS)
5932 #   define PERL_BLOCKSIG_ADD(set,sig) \
5933         sigset_t set; sigemptyset(&(set)); sigaddset(&(set), sig)
5934 #   define PERL_BLOCKSIG_BLOCK(set) \
5935         sigprocmask(SIG_BLOCK, &(set), NULL)
5936 #   define PERL_BLOCKSIG_UNBLOCK(set) \
5937         sigprocmask(SIG_UNBLOCK, &(set), NULL)
5938 #endif /* HAS_SIGPROCMASK && PERL_BLOCK_SIGNALS */
5939
5940 /* How about the old style of sigblock()? */
5941
5942 #ifndef PERL_BLOCKSIG_ADD
5943 #   define PERL_BLOCKSIG_ADD(set, sig)  NOOP
5944 #endif
5945 #ifndef PERL_BLOCKSIG_BLOCK
5946 #   define PERL_BLOCKSIG_BLOCK(set)     NOOP
5947 #endif
5948 #ifndef PERL_BLOCKSIG_UNBLOCK
5949 #   define PERL_BLOCKSIG_UNBLOCK(set)   NOOP
5950 #endif
5951
5952 /* Use instead of abs() since abs() forces its argument to be an int,
5953  * but also beware since this evaluates its argument twice, so no x++. */
5954 #define PERL_ABS(x) ((x) < 0 ? -(x) : (x))
5955
5956 #if defined(__DECC) && defined(__osf__)
5957 #pragma message disable (mainparm) /* Perl uses the envp in main(). */
5958 #endif
5959
5960 #define do_open(g, n, l, a, rm, rp, sf) \
5961         do_openn(g, n, l, a, rm, rp, sf, (SV **) NULL, 0)
5962 #ifdef PERL_DEFAULT_DO_EXEC3_IMPLEMENTATION
5963 #  define do_exec(cmd)                  do_exec3(cmd,0,0)
5964 #endif
5965 #ifdef OS2
5966 #  define do_aexec                      Perl_do_aexec
5967 #else
5968 #  define do_aexec(really, mark,sp)     do_aexec5(really, mark, sp, 0, 0)
5969 #endif
5970
5971 #if defined(OEMVS)
5972 #define NO_ENV_ARRAY_IN_MAIN
5973 #endif
5974
5975 /* These are used by Perl_pv_escape() and Perl_pv_pretty() 
5976  * are here so that they are available throughout the core 
5977  * NOTE that even though some are for _escape and some for _pretty
5978  * there must not be any clashes as the flags from _pretty are
5979  * passed straight through to _escape.
5980  */
5981
5982 #define PERL_PV_ESCAPE_QUOTE        0x0001
5983 #define PERL_PV_PRETTY_QUOTE        PERL_PV_ESCAPE_QUOTE
5984
5985 #define PERL_PV_PRETTY_ELLIPSES     0x0002
5986 #define PERL_PV_PRETTY_LTGT         0x0004
5987
5988 #define PERL_PV_ESCAPE_FIRSTCHAR    0x0008
5989
5990 #define PERL_PV_ESCAPE_UNI          0x0100     
5991 #define PERL_PV_ESCAPE_UNI_DETECT   0x0200
5992
5993 #define PERL_PV_ESCAPE_ALL          0x1000
5994 #define PERL_PV_ESCAPE_NOBACKSLASH  0x2000
5995 #define PERL_PV_ESCAPE_NOCLEAR      0x4000
5996 #define PERL_PV_ESCAPE_RE           0x8000
5997
5998 #define PERL_PV_PRETTY_NOCLEAR      PERL_PV_ESCAPE_NOCLEAR
5999
6000 /* used by pv_display in dump.c*/
6001 #define PERL_PV_PRETTY_DUMP  PERL_PV_PRETTY_ELLIPSES|PERL_PV_PRETTY_QUOTE
6002 #define PERL_PV_PRETTY_REGPROP PERL_PV_PRETTY_ELLIPSES|PERL_PV_PRETTY_LTGT|PERL_PV_ESCAPE_RE
6003
6004 /*
6005
6006    (KEEP THIS LAST IN perl.h!)
6007
6008    Mention
6009
6010    NV_PRESERVES_UV
6011
6012    HAS_MKSTEMP
6013    HAS_MKSTEMPS
6014    HAS_MKDTEMP
6015
6016    HAS_GETCWD
6017
6018    HAS_MMAP
6019    HAS_MPROTECT
6020    HAS_MSYNC
6021    HAS_MADVISE
6022    HAS_MUNMAP
6023    I_SYSMMAN
6024    Mmap_t
6025
6026    NVef
6027    NVff
6028    NVgf
6029
6030    HAS_UALARM
6031    HAS_USLEEP
6032
6033    HAS_SETITIMER
6034    HAS_GETITIMER
6035
6036    HAS_SENDMSG
6037    HAS_RECVMSG
6038    HAS_READV
6039    HAS_WRITEV
6040    I_SYSUIO
6041    HAS_STRUCT_MSGHDR
6042    HAS_STRUCT_CMSGHDR
6043
6044    HAS_NL_LANGINFO
6045
6046    HAS_DIRFD
6047
6048    so that Configure picks them up.
6049
6050    (KEEP THIS LAST IN perl.h!)
6051
6052 */
6053
6054 #endif /* Include guard */
6055
6056 #define CLEAR_ERRSV() STMT_START { sv_setpvn(ERRSV,"",0); if (SvMAGICAL(ERRSV)) { mg_free(ERRSV); } SvPOK_only(ERRSV); } STMT_END
6057
6058 /*
6059  * Local variables:
6060  * c-indentation-style: bsd
6061  * c-basic-offset: 4
6062  * indent-tabs-mode: t
6063  * End:
6064  *
6065  * ex: set ts=8 sts=4 sw=4 noet:
6066  */