Andrew has developed the following patch which allows Perl 5.05 to
compile plperl.  I have applied the patch because it is causing compile
failures for testers.

---------------------------------------------------------------------------

Andrew Dunstan wrote:
> 
> Ok. It's impossible for me to fix this by remote control - I need access 
> to some box with one of these old versions of perl so I can come up with 
> a clean solution.
> 
> Or did you revert the change that put "#include ppport.h" in SPI.xs?
> 
> cheers
> 
> andrew
> 
> 
> Bruce Momjian wrote:
> 
> >Andrew Dunstan wrote:
> >  
> >
> >>That is *intensely* annoying. What on earth are these function bodies 
> >>doing in a .h file anyway? (Remember, I just used the standard utility 
> >>to generate the file).
> >>
> >>Anyway, here is a version with all that stuff cut out - I don't believe 
> >>we need any of it. Does this improve things?
> >>    
> >>
> >
> >Nope.  I get this failure:
> >     
> >     gmake[4]: Leaving directory 
> > `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src/pl/tcl/modules'
> >     gmake[3]: Leaving directory 
> > `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src/pl/tcl'
> >     gmake[3]: Entering directory 
> > `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src/pl/plperl'
> >     gcc -O2 -fno-strict-aliasing -O1 -Wpointer-arith -Wcast-align -fpic -I. 
> > -I/usr/libdata/perl5/5.00503/i386-bsdos/CORE -I../../../src/include 
> > -I/usr/local/include/readline -I/usr/contrib/include  -c -o plperl.o plperl.c
> >     gcc -O2 -fno-strict-aliasing -O1 -Wpointer-arith -Wcast-align -fpic -I. 
> > -I/usr/libdata/perl5/5.00503/i386-bsdos/CORE -I../../../src/include 
> > -I/usr/local/include/readline -I/usr/contrib/include  -c -o spi_internal.o 
> > spi_internal.c
> >     /usr/bin/perl /usr/libdata/perl5/5.00503/ExtUtils/xsubpp -typemap 
> > /usr/libdata/perl5/5.00503/ExtUtils/typemap SPI.xs >SPI.c
> >     gcc -O2 -fno-strict-aliasing -O1 -Wpointer-arith -Wcast-align -fpic -I. 
> > -I/usr/libdata/perl5/5.00503/i386-bsdos/CORE -I../../../src/include 
> > -I/usr/local/include/readline -I/usr/contrib/include  -c -o SPI.o SPI.c
> >     SPI.xs: In function `XS__spi_exec_query':
> >     SPI.xs:51: `aTHX_' undeclared (first use in this function)
> >     SPI.xs:51: (Each undeclared identifier is reported only once
> >     SPI.xs:51: for each function it appears in.)
> >     SPI.xs:51: syntax error before string constant
> >     gmake[3]: *** [SPI.o] Error 1
> >     gmake[3]: Leaving directory 
> > `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src/pl/plperl'
> >     gmake[2]: *** [all] Error 2
> >     gmake[2]: Leaving directory `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src/pl'
> >     gmake[1]: *** [all] Error 2
> >     gmake[1]: Leaving directory `/usr/var/local/src/gen/pgsql/CURRENT/pgsql/src'
> >     gmake: *** [all] Error 2
> >
> >  
> >
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster
> 
> 
> !DSPAM:40e8839e277026631821392!
> 
> 

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  [EMAIL PROTECTED]               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
Index: src/pl/plperl/SPI.xs
===================================================================
RCS file: /cvsroot/pgsql-server/src/pl/plperl/SPI.xs,v
retrieving revision 1.6
diff -c -c -r1.6 SPI.xs
*** src/pl/plperl/SPI.xs        1 Jul 2004 20:50:22 -0000       1.6
--- src/pl/plperl/SPI.xs        5 Jul 2004 01:15:07 -0000
***************
*** 5,10 ****
--- 5,11 ----
  #include "EXTERN.h"
  #include "perl.h"
  #include "XSUB.h"
+ #include "ppport.h"
  
  #include "spi_internal.h"
  
Index: src/pl/plperl/ppport.h
===================================================================
RCS file: /cvsroot/pgsql-server/src/pl/plperl/ppport.h,v
retrieving revision 1.5
diff -c -c -r1.5 ppport.h
*** src/pl/plperl/ppport.h      18 Oct 2002 20:33:57 -0000      1.5
--- src/pl/plperl/ppport.h      5 Jul 2004 01:15:07 -0000
***************
*** 1,57 ****
  
! #ifndef _P_P_PORTABILITY_H_
! #define _P_P_PORTABILITY_H_
! 
! /* Perl/Pollution/Portability Version 1.0007 */
! 
! /* Copyright (C) 1999, Kenneth Albanowski. This code may be used and
!    distributed under the same license as any version of Perl. */
! 
! /* For the latest version of this code, please retreive the Devel::PPPort
!    module from CPAN, contact the author at <[EMAIL PROTECTED]>, or check
!    with the Perl maintainers. */
! 
! /* If you needed to customize this file for your project, please mention
!    your changes, and visible alter the version number. */
! 
  
  /*
!    In order for a Perl extension module to be as portable as possible
!    across differing versions of Perl itself, certain steps need to be taken.
!    Including this header is the first major one, then using dTHR is all the
!    appropriate places and using a PL_ prefix to refer to global Perl
!    variables is the second.
! */
  
  
  /* If you use one of a few functions that were not present in earlier
!    versions of Perl, please add a define before the inclusion of ppport.h
!    for a static include, or use the GLOBAL request in a single module to
!    produce a global definition that can be referenced from the other
!    modules.
! 
!    Function:                  Static define:                   Extern define:
!    newCONSTSUB()              NEED_newCONSTSUB                 
NEED_newCONSTSUB_GLOBAL
! 
! */
! 
  
  /* To verify whether ppport.h is needed for your module, and whether any
!    special defines should be used, ppport.h can be run through Perl to check
!    your source code. Simply say:
! 
!       perl -x ppport.h *.c *.h *.xs foo/*.c [etc]
! 
!    The result will be a list of patches suggesting changes that should at
!    least be acceptable, if not necessarily the most efficient solution, or a
!    fix for all possible problems. It won't catch where dTHR is needed, and
!    doesn't attempt to account for global macro or function definitions,
!    nested includes, typemaps, etc.
! 
!    In order to test for the need of dTHR, please try your module under a
!    recent version of Perl that has threading compiled-in.
! 
! */
  
  
  /*
--- 1,81 ----
  
! /* ppport.h -- Perl/Pollution/Portability Version 2.011 
!  *
!  * Automatically Created by Devel::PPPort on Sun Jul  4 09:11:52 2004 
!  *
!  * Do NOT edit this file directly! -- Edit PPPort.pm instead.
!  *
!  * Version 2.x, Copyright (C) 2001, Paul Marquess.
!  * Version 1.x, Copyright (C) 1999, Kenneth Albanowski.
!  * This code may be used and distributed under the same license as any
!  * version of Perl.
!  * 
!  * This version of ppport.h is designed to support operation with Perl
!  * installations back to 5.004, and has been tested up to 5.8.1.
!  *
!  * If this version of ppport.h is failing during the compilation of this
!  * module, please check if a newer version of Devel::PPPort is available
!  * on CPAN before sending a bug report.
!  *
!  * If you are using the latest version of Devel::PPPort and it is failing
!  * during compilation of this module, please send a report to [EMAIL PROTECTED]
!  *
!  * Include all following information:
!  *
!  *  1. The complete output from running "perl -V"
!  *
!  *  2. This file.
!  *
!  *  3. The name & version of the module you were trying to build.
!  *
!  *  4. A full log of the build that failed.
!  *
!  *  5. Any other information that you think could be relevant.
!  *
!  *
!  * For the latest version of this code, please retreive the Devel::PPPort
!  * module from CPAN.
!  * 
!  */
  
  /*
!  * In order for a Perl extension module to be as portable as possible
!  * across differing versions of Perl itself, certain steps need to be taken.
!  * Including this header is the first major one, then using dTHR is all the
!  * appropriate places and using a PL_ prefix to refer to global Perl
!  * variables is the second.
!  *
!  */
  
  
  /* If you use one of a few functions that were not present in earlier
!  * versions of Perl, please add a define before the inclusion of ppport.h
!  * for a static include, or use the GLOBAL request in a single module to
!  * produce a global definition that can be referenced from the other
!  * modules.
!  * 
!  * Function:            Static define:           Extern define:
!  * newCONSTSUB()        NEED_newCONSTSUB         NEED_newCONSTSUB_GLOBAL
!  *
!  */
!  
  
  /* To verify whether ppport.h is needed for your module, and whether any
!  * special defines should be used, ppport.h can be run through Perl to check
!  * your source code. Simply say:
!  * 
!  *    perl -x ppport.h *.c *.h *.xs foo/bar*.c [etc]
!  * 
!  * The result will be a list of patches suggesting changes that should at
!  * least be acceptable, if not necessarily the most efficient solution, or a
!  * fix for all possible problems. It won't catch where dTHR is needed, and
!  * doesn't attempt to account for global macro or function definitions,
!  * nested includes, typemaps, etc.
!  * 
!  * In order to test for the need of dTHR, please try your module under a
!  * recent version of Perl that has threading compiled-in.
!  *
!  */ 
  
  
  /*
***************
*** 109,119 ****
                        $need_include = 1;
                }
        }
! 
        if (scalar(keys %add_func) or $need_include != $has_include) {
                if (!$has_include) {
                        $inc = join('',map("#define NEED_$_\n", sort keys %add_func)).
!                                  "#include \"ppport.h\"\n";
                        $c = "$inc$c" unless $c =~ s/#.*include.*XSUB.*\n/$&$inc/m;
                } elsif (keys %add_func) {
                        $inc = join('',map("#define NEED_$_\n", sort keys %add_func));
--- 133,143 ----
                        $need_include = 1;
                }
        }
!       
        if (scalar(keys %add_func) or $need_include != $has_include) {
                if (!$has_include) {
                        $inc = join('',map("#define NEED_$_\n", sort keys %add_func)).
!                              "#include \"ppport.h\"\n";
                        $c = "$inc$c" unless $c =~ s/#.*include.*XSUB.*\n/$&$inc/m;
                } elsif (keys %add_func) {
                        $inc = join('',map("#define NEED_$_\n", sort keys %add_func));
***************
*** 125,131 ****
                }
                $changes++;
        }
! 
        if ($changes) {
                open(OUT,">/tmp/ppport.h.$$");
                print OUT $c;
--- 149,155 ----
                }
                $changes++;
        }
!       
        if ($changes) {
                open(OUT,">/tmp/ppport.h.$$");
                print OUT $c;
***************
*** 141,227 ****
  __DATA__
  */
  
  #ifndef PERL_REVISION
! #ifndef __PATCHLEVEL_H_INCLUDED__
! #include "patchlevel.h"
! #endif
! #ifndef PERL_REVISION
! #define PERL_REVISION  (5)
!  /* Replace: 1 */
! #define PERL_VERSION PATCHLEVEL
! #define PERL_SUBVERSION  SUBVERSION
!  /* Replace PERL_PATCHLEVEL with PERL_VERSION */
!  /* Replace: 0 */
! #endif
  #endif
  
  #define PERL_BCDVERSION ((PERL_REVISION * 0x1000000L) + (PERL_VERSION * 0x1000L) + 
PERL_SUBVERSION)
  
  #ifndef ERRSV
! #define ERRSV perl_get_sv("@",FALSE)
  #endif
  
  #if (PERL_VERSION < 4) || ((PERL_VERSION == 4) && (PERL_SUBVERSION <= 5))
  /* Replace: 1 */
! #define PL_sv_undef  sv_undef
! #define PL_sv_yes      sv_yes
! #define PL_sv_no       sv_no
! #define PL_na          na
! #define PL_stdingv     stdingv
! #define PL_hints       hints
! #define PL_curcop      curcop
! #define PL_curstash  curstash
! #define PL_copline     copline
! #define PL_Sv          Sv
  /* Replace: 0 */
  #endif
  
  #ifndef dTHR
! #define dTHR extern int no_such_variable
  #endif
  
  #ifndef boolSV
! #define boolSV(b) ((b) ? &PL_sv_yes : &PL_sv_no)
  #endif
  
  #ifndef gv_stashpvn
! #define gv_stashpvn(str,len,flags) gv_stashpv(str,flags)
  #endif
  
  #ifndef newSVpvn
! #define newSVpvn(data,len) ((len) ? newSVpv ((data), (len)) : newSVpv ("", 0))
  #endif
  
  #ifndef newRV_inc
  /* Replace: 1 */
! #define newRV_inc(sv) newRV(sv)
  /* Replace: 0 */
  #endif
  
  #ifndef newRV_noinc
! #ifdef __GNUC__
! #define newRV_noinc(sv)                                 \
!         ({                                                              \
!                 SV *nsv = (SV*)newRV(sv);               \
!                 SvREFCNT_dec(sv);                               \
!                 nsv;                                                    \
!         })
! #else
! #if defined(CRIPPLED_CC) || defined(USE_THREADS)
! static SV  *
! newRV_noinc(SV * sv)
  {
!       SV                 *nsv = (SV *) newRV(sv);
! 
!       SvREFCNT_dec(sv);
!       return nsv;
  }
! 
! #else
! #define newRV_noinc(sv)    \
!               ((PL_Sv=(SV*)newRV(sv), SvREFCNT_dec(sv), (SV*)PL_Sv)
! #endif
! #endif
  #endif
  
  /* Provide: newCONSTSUB */
--- 165,360 ----
  __DATA__
  */
  
+ #ifndef _P_P_PORTABILITY_H_
+ #define _P_P_PORTABILITY_H_
+ 
  #ifndef PERL_REVISION
! #   ifndef __PATCHLEVEL_H_INCLUDED__
! #       define PERL_PATCHLEVEL_H_IMPLICIT
! #       include <patchlevel.h>
! #   endif
! #   if !(defined(PERL_VERSION) || (defined(SUBVERSION) && defined(PATCHLEVEL)))
! #       include <could_not_find_Perl_patchlevel.h>
! #   endif
! #   ifndef PERL_REVISION
! #     define PERL_REVISION    (5)
!         /* Replace: 1 */
! #       define PERL_VERSION   PATCHLEVEL
! #       define PERL_SUBVERSION        SUBVERSION
!         /* Replace PERL_PATCHLEVEL with PERL_VERSION */
!         /* Replace: 0 */
! #   endif
  #endif
  
  #define PERL_BCDVERSION ((PERL_REVISION * 0x1000000L) + (PERL_VERSION * 0x1000L) + 
PERL_SUBVERSION)
  
+ /* It is very unlikely that anyone will try to use this with Perl 6 
+    (or greater), but who knows.
+  */
+ #if PERL_REVISION != 5
+ #     error ppport.h only works with Perl version 5
+ #endif /* PERL_REVISION != 5 */
+ 
  #ifndef ERRSV
! #     define ERRSV perl_get_sv("@",FALSE)
  #endif
  
  #if (PERL_VERSION < 4) || ((PERL_VERSION == 4) && (PERL_SUBVERSION <= 5))
  /* Replace: 1 */
! #     define PL_Sv            Sv
! #     define PL_compiling     compiling
! #     define PL_copline       copline
! #     define PL_curcop        curcop
! #     define PL_curstash      curstash
! #     define PL_defgv         defgv
! #     define PL_dirty         dirty
! #     define PL_dowarn        dowarn
! #     define PL_hints         hints
! #     define PL_na            na
! #     define PL_perldb        perldb
! #     define PL_rsfp_filters  rsfp_filters
! #     define PL_rsfpv         rsfp
! #     define PL_stdingv       stdingv
! #     define PL_sv_no         sv_no
! #     define PL_sv_undef      sv_undef
! #     define PL_sv_yes        sv_yes
  /* Replace: 0 */
  #endif
  
+ #ifdef HASATTRIBUTE
+ #  if (defined(__GNUC__) && defined(__cplusplus)) || defined(__INTEL_COMPILER)
+ #    define PERL_UNUSED_DECL
+ #  else
+ #    define PERL_UNUSED_DECL __attribute__((unused))
+ #  endif
+ #else
+ #  define PERL_UNUSED_DECL
+ #endif
+ 
+ #ifndef dNOOP
+ #  define NOOP (void)0
+ #  define dNOOP extern int Perl___notused PERL_UNUSED_DECL
+ #endif
+ 
  #ifndef dTHR
! #  define dTHR          dNOOP
! #endif
! 
! #ifndef dTHX
! #  define dTHX          dNOOP
! #  define dTHXa(x)      dNOOP
! #  define dTHXoa(x)     dNOOP
! #endif
! 
! #ifndef pTHX
! #    define pTHX      void
! #    define pTHX_
! #    define aTHX
! #    define aTHX_
! #endif         
! 
! #ifndef dAX
! #   define dAX I32 ax = MARK - PL_stack_base + 1
! #endif
! #ifndef dITEMS
! #   define dITEMS I32 items = SP - MARK
! #endif
! 
! /* IV could also be a quad (say, a long long), but Perls
!  * capable of those should have IVSIZE already. */
! #if !defined(IVSIZE) && defined(LONGSIZE)
! #   define IVSIZE LONGSIZE
! #endif
! #ifndef IVSIZE
! #   define IVSIZE 4 /* A bold guess, but the best we can make. */
! #endif
! 
! #ifndef UVSIZE
! #   define UVSIZE IVSIZE
! #endif
! 
! #ifndef NVTYPE
! #   if defined(USE_LONG_DOUBLE) && defined(HAS_LONG_DOUBLE)
! #       define NVTYPE long double
! #   else
! #       define NVTYPE double
! #   endif
! typedef NVTYPE NV;
! #endif
! 
! #ifndef INT2PTR
! 
! #if (IVSIZE == PTRSIZE) && (UVSIZE == PTRSIZE)
! #  define PTRV                  UV
! #  define INT2PTR(any,d)        (any)(d)
! #else
! #  if PTRSIZE == LONGSIZE
! #    define PTRV                unsigned long
! #  else
! #    define PTRV                unsigned
! #  endif
! #  define INT2PTR(any,d)        (any)(PTRV)(d)
! #endif
! #define NUM2PTR(any,d)  (any)(PTRV)(d)
! #define PTR2IV(p)       INT2PTR(IV,p)
! #define PTR2UV(p)       INT2PTR(UV,p)
! #define PTR2NV(p)       NUM2PTR(NV,p)
! #if PTRSIZE == LONGSIZE
! #  define PTR2ul(p)     (unsigned long)(p)
! #else
! #  define PTR2ul(p)     INT2PTR(unsigned long,p)        
  #endif
  
+ #endif /* !INT2PTR */
+ 
  #ifndef boolSV
! #     define boolSV(b) ((b) ? &PL_sv_yes : &PL_sv_no)
  #endif
  
  #ifndef gv_stashpvn
! #     define gv_stashpvn(str,len,flags) gv_stashpv(str,flags)
  #endif
  
  #ifndef newSVpvn
! #     define newSVpvn(data,len) ((len) ? newSVpv ((data), (len)) : newSVpv ("", 0))
  #endif
  
  #ifndef newRV_inc
  /* Replace: 1 */
! #     define newRV_inc(sv) newRV(sv)
  /* Replace: 0 */
  #endif
  
+ /* DEFSV appears first in 5.004_56 */
+ #ifndef DEFSV
+ #  define DEFSV       GvSV(PL_defgv)
+ #endif
+ 
+ #ifndef SAVE_DEFSV
+ #    define SAVE_DEFSV SAVESPTR(GvSV(PL_defgv))
+ #endif
+ 
  #ifndef newRV_noinc
! #  ifdef __GNUC__
! #    define newRV_noinc(sv)               \
!       ({                                  \
!           SV *nsv = (SV*)newRV(sv);       \
!           SvREFCNT_dec(sv);               \
!           nsv;                            \
!       })
! #  else
! #    if defined(USE_THREADS)
! static SV * newRV_noinc (SV * sv)
  {
!           SV *nsv = (SV*)newRV(sv);       
!           SvREFCNT_dec(sv);               
!           return nsv;                     
  }
! #    else
! #      define newRV_noinc(sv)    \
!         (PL_Sv=(SV*)newRV(sv), SvREFCNT_dec(sv), (SV*)PL_Sv)
! #    endif
! #  endif
  #endif
  
  /* Provide: newCONSTSUB */
***************
*** 232,252 ****
  #if defined(NEED_newCONSTSUB)
  static
  #else
! extern void newCONSTSUB _((HV * stash, char *name, SV * sv));
  #endif
  
  #if defined(NEED_newCONSTSUB) || defined(NEED_newCONSTSUB_GLOBAL)
  void
! newCONSTSUB(stash, name, sv)
! HV               *stash;
! char     *name;
! SV               *sv;
  {
!       U32                     oldhints = PL_hints;
!       HV                 *old_cop_stash = PL_curcop->cop_stash;
!       HV                 *old_curstash = PL_curstash;
!       line_t          oldline = PL_curcop->cop_line;
! 
        PL_curcop->cop_line = PL_copline;
  
        PL_hints &= ~HINT_BLOCK_SCOPE;
--- 365,384 ----
  #if defined(NEED_newCONSTSUB)
  static
  #else
! extern void newCONSTSUB(HV * stash, char * name, SV *sv);
  #endif
  
  #if defined(NEED_newCONSTSUB) || defined(NEED_newCONSTSUB_GLOBAL)
  void
! newCONSTSUB(stash,name,sv)
! HV *stash;
! char *name;
! SV *sv;
  {
!       U32 oldhints = PL_hints;
!       HV *old_cop_stash = PL_curcop->cop_stash;
!       HV *old_curstash = PL_curstash;
!       line_t oldline = PL_curcop->cop_line;
        PL_curcop->cop_line = PL_copline;
  
        PL_hints &= ~HINT_BLOCK_SCOPE;
***************
*** 256,278 ****
        newSUB(
  
  #if (PERL_VERSION < 3) || ((PERL_VERSION == 3) && (PERL_SUBVERSION < 22))
!       /* before 5.003_22 */
!                  start_subparse(),
! #else
! #if (PERL_VERSION == 3) && (PERL_SUBVERSION == 22)
!       /* 5.003_22 */
!                  start_subparse(0),
  #else
!       /* 5.003_23  onwards */
!                  start_subparse(FALSE, 0),
! #endif
  #endif
  
!                  newSVOP(OP_CONST, 0, newSVpv(name, 0)),
!                  newSVOP(OP_CONST, 0, &PL_sv_no),             /* SvPV(&PL_sv_no) == 
""
!                                                                                      
          * -- GMB */
!                  newSTATEOP(0, Nullch, newSVOP(OP_CONST, 0, sv))
!               );
  
        PL_hints = oldhints;
        PL_curcop->cop_stash = old_cop_stash;
--- 388,409 ----
        newSUB(
  
  #if (PERL_VERSION < 3) || ((PERL_VERSION == 3) && (PERL_SUBVERSION < 22))
!      /* before 5.003_22 */
!               start_subparse(),
  #else
! #  if (PERL_VERSION == 3) && (PERL_SUBVERSION == 22)
!      /* 5.003_22 */
!               start_subparse(0),
! #  else
!      /* 5.003_23  onwards */
!               start_subparse(FALSE, 0),
! #  endif
  #endif
  
!               newSVOP(OP_CONST, 0, newSVpv(name,0)),
!               newSVOP(OP_CONST, 0, &PL_sv_no),   /* SvPV(&PL_sv_no) == "" -- GMB */
!               newSTATEOP(0, Nullch, newSVOP(OP_CONST, 0, sv))
!       );
  
        PL_hints = oldhints;
        PL_curcop->cop_stash = old_cop_stash;
***************
*** 280,285 ****
        PL_curcop->cop_line = oldline;
  }
  #endif
- #endif   /* newCONSTSUB */
  
! #endif   /* _P_P_PORTABILITY_H_ */
--- 411,813 ----
        PL_curcop->cop_line = oldline;
  }
  #endif
  
! #endif /* newCONSTSUB */
! 
! #ifndef START_MY_CXT
! 
! /*
!  * Boilerplate macros for initializing and accessing interpreter-local
!  * data from C.  All statics in extensions should be reworked to use
!  * this, if you want to make the extension thread-safe.  See ext/re/re.xs
!  * for an example of the use of these macros.
!  *
!  * Code that uses these macros is responsible for the following:
!  * 1. #define MY_CXT_KEY to a unique string, e.g. "DynaLoader_guts"
!  * 2. Declare a typedef named my_cxt_t that is a structure that contains
!  *    all the data that needs to be interpreter-local.
!  * 3. Use the START_MY_CXT macro after the declaration of my_cxt_t.
!  * 4. Use the MY_CXT_INIT macro such that it is called exactly once
!  *    (typically put in the BOOT: section).
!  * 5. Use the members of the my_cxt_t structure everywhere as
!  *    MY_CXT.member.
!  * 6. Use the dMY_CXT macro (a declaration) in all the functions that
!  *    access MY_CXT.
!  */
! 
! #if defined(MULTIPLICITY) || defined(PERL_OBJECT) || \
!     defined(PERL_CAPI)    || defined(PERL_IMPLICIT_CONTEXT)
! 
! /* This must appear in all extensions that define a my_cxt_t structure,
!  * right after the definition (i.e. at file scope).  The non-threads
!  * case below uses it to declare the data as static. */
! #define START_MY_CXT
! 
! #if (PERL_VERSION < 4 || (PERL_VERSION == 4 && PERL_SUBVERSION < 68 ))
! /* Fetches the SV that keeps the per-interpreter data. */
! #define dMY_CXT_SV \
!       SV *my_cxt_sv = perl_get_sv(MY_CXT_KEY, FALSE)
! #else /* >= perl5.004_68 */
! #define dMY_CXT_SV \
!       SV *my_cxt_sv = *hv_fetch(PL_modglobal, MY_CXT_KEY,             \
!                                 sizeof(MY_CXT_KEY)-1, TRUE)
! #endif /* < perl5.004_68 */
! 
! /* This declaration should be used within all functions that use the
!  * interpreter-local data. */
! #define dMY_CXT       \
!       dMY_CXT_SV;                                                     \
!       my_cxt_t *my_cxtp = INT2PTR(my_cxt_t*,SvUV(my_cxt_sv))
! 
! /* Creates and zeroes the per-interpreter data.
!  * (We allocate my_cxtp in a Perl SV so that it will be released when
!  * the interpreter goes away.) */
! #define MY_CXT_INIT \
!       dMY_CXT_SV;                                                     \
!       /* newSV() allocates one more than needed */                    \
!       my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1));\
!       Zero(my_cxtp, 1, my_cxt_t);                                     \
!       sv_setuv(my_cxt_sv, PTR2UV(my_cxtp))
! 
! /* This macro must be used to access members of the my_cxt_t structure.
!  * e.g. MYCXT.some_data */
! #define MY_CXT                (*my_cxtp)
! 
! /* Judicious use of these macros can reduce the number of times dMY_CXT
!  * is used.  Use is similar to pTHX, aTHX etc. */
! #define pMY_CXT               my_cxt_t *my_cxtp
! #define pMY_CXT_      pMY_CXT,
! #define _pMY_CXT      ,pMY_CXT
! #define aMY_CXT               my_cxtp
! #define aMY_CXT_      aMY_CXT,
! #define _aMY_CXT      ,aMY_CXT
! 
! #else /* single interpreter */
! 
! #define START_MY_CXT  static my_cxt_t my_cxt;
! #define dMY_CXT_SV    dNOOP
! #define dMY_CXT               dNOOP
! #define MY_CXT_INIT   NOOP
! #define MY_CXT                my_cxt
! 
! #define pMY_CXT               void
! #define pMY_CXT_
! #define _pMY_CXT
! #define aMY_CXT
! #define aMY_CXT_
! #define _aMY_CXT
! 
! #endif 
! 
! #endif /* START_MY_CXT */
! 
! #ifndef IVdf
! #  if IVSIZE == LONGSIZE
! #       define        IVdf            "ld"
! #       define        UVuf            "lu"
! #       define        UVof            "lo"
! #       define        UVxf            "lx"
! #       define        UVXf            "lX"
! #   else
! #       if IVSIZE == INTSIZE
! #           define    IVdf    "d"
! #           define    UVuf    "u"
! #           define    UVof    "o"
! #           define    UVxf    "x"
! #           define    UVXf    "X"
! #       endif
! #   endif
! #endif
! 
! #ifndef NVef
! #   if defined(USE_LONG_DOUBLE) && defined(HAS_LONG_DOUBLE) && \
!       defined(PERL_PRIfldbl) /* Not very likely, but let's try anyway. */ 
! #       define NVef           PERL_PRIeldbl
! #       define NVff           PERL_PRIfldbl
! #       define NVgf           PERL_PRIgldbl
! #   else
! #       define NVef           "e"
! #       define NVff           "f"
! #       define NVgf           "g"
! #   endif
! #endif
! 
! #ifndef AvFILLp                       /* Older perls (<=5.003) lack AvFILLp */
! #   define AvFILLp AvFILL
! #endif
! 
! #ifdef SvPVbyte
! #   if PERL_REVISION == 5 && PERL_VERSION < 7
!        /* SvPVbyte does not work in perl-5.6.1, borrowed version for 5.7.3 */
! #       undef SvPVbyte
! #       define SvPVbyte(sv, lp) \
!           ((SvFLAGS(sv) & (SVf_POK|SVf_UTF8)) == (SVf_POK) \
!            ? ((lp = SvCUR(sv)), SvPVX(sv)) : my_sv_2pvbyte(aTHX_ sv, &lp))
!        static char *
!        my_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
!        {   
!            sv_utf8_downgrade(sv,0);
!            return SvPV(sv,*lp);
!        }
! #   endif
! #else
! #   define SvPVbyte SvPV
! #endif
! 
! #ifndef SvPV_nolen
! #   define SvPV_nolen(sv) \
!         ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \
!          ? SvPVX(sv) : sv_2pv_nolen(sv))
!     static char *
!     sv_2pv_nolen(pTHX_ register SV *sv)
!     {   
!         STRLEN n_a;
!         return sv_2pv(sv, &n_a);
!     }
! #endif
! 
! #ifndef get_cv
! #   define get_cv(name,create) perl_get_cv(name,create)
! #endif
! 
! #ifndef get_sv
! #   define get_sv(name,create) perl_get_sv(name,create)
! #endif
! 
! #ifndef get_av
! #   define get_av(name,create) perl_get_av(name,create)
! #endif
! 
! #ifndef get_hv
! #   define get_hv(name,create) perl_get_hv(name,create)
! #endif
! 
! #ifndef call_argv
! #   define call_argv perl_call_argv
! #endif
! 
! #ifndef call_method
! #   define call_method perl_call_method
! #endif
! 
! #ifndef call_pv
! #   define call_pv perl_call_pv
! #endif
! 
! #ifndef call_sv
! #   define call_sv perl_call_sv
! #endif
! 
! #ifndef eval_pv
! #   define eval_pv perl_eval_pv
! #endif
! 
! #ifndef eval_sv
! #   define eval_sv perl_eval_sv
! #endif
! 
! #ifndef PERL_SCAN_GREATER_THAN_UV_MAX
! #   define PERL_SCAN_GREATER_THAN_UV_MAX 0x02
! #endif
! 
! #ifndef PERL_SCAN_SILENT_ILLDIGIT
! #   define PERL_SCAN_SILENT_ILLDIGIT 0x04
! #endif
! 
! #ifndef PERL_SCAN_ALLOW_UNDERSCORES
! #   define PERL_SCAN_ALLOW_UNDERSCORES 0x01
! #endif
! 
! #ifndef PERL_SCAN_DISALLOW_PREFIX
! #   define PERL_SCAN_DISALLOW_PREFIX 0x02
! #endif
! 
! #if (PERL_VERSION > 6) || ((PERL_VERSION == 6) && (PERL_SUBVERSION >= 1))
! #define I32_CAST
! #else
! #define I32_CAST (I32*)
! #endif
! 
! 
! #ifndef IN_LOCALE
! #   define IN_LOCALE \
!       (PL_curcop == &PL_compiling ? IN_LOCALE_COMPILETIME : IN_LOCALE_RUNTIME)
! #endif
! 
! #ifndef IN_LOCALE_RUNTIME
! #   define IN_LOCALE_RUNTIME   (PL_curcop->op_private & HINT_LOCALE)
! #endif
! 
! #ifndef IN_LOCALE_COMPILETIME
! #   define IN_LOCALE_COMPILETIME   (PL_hints & HINT_LOCALE)
! #endif
! 
! 
! #ifndef IS_NUMBER_IN_UV
! #   define IS_NUMBER_IN_UV                        0x01   
! #   define IS_NUMBER_GREATER_THAN_UV_MAX    0x02
! #   define IS_NUMBER_NOT_INT              0x04
! #   define IS_NUMBER_NEG                          0x08
! #   define IS_NUMBER_INFINITY             0x10 
! #   define IS_NUMBER_NAN                    0x20  
! #endif
! 
! #ifndef PERL_MAGIC_sv
! #   define PERL_MAGIC_sv             '\0'
! #endif
! 
! #ifndef PERL_MAGIC_overload
! #   define PERL_MAGIC_overload       'A'
! #endif
! 
! #ifndef PERL_MAGIC_overload_elem
! #   define PERL_MAGIC_overload_elem  'a'
! #endif
! 
! #ifndef PERL_MAGIC_overload_table
! #   define PERL_MAGIC_overload_table 'c'
! #endif
! 
! #ifndef PERL_MAGIC_bm
! #   define PERL_MAGIC_bm             'B'
! #endif
! 
! #ifndef PERL_MAGIC_regdata
! #   define PERL_MAGIC_regdata        'D'
! #endif
! 
! #ifndef PERL_MAGIC_regdatum
! #   define PERL_MAGIC_regdatum       'd'
! #endif
! 
! #ifndef PERL_MAGIC_env
! #   define PERL_MAGIC_env            'E'
! #endif
! 
! #ifndef PERL_MAGIC_envelem
! #   define PERL_MAGIC_envelem        'e'
! #endif
! 
! #ifndef PERL_MAGIC_fm
! #   define PERL_MAGIC_fm             'f'
! #endif
! 
! #ifndef PERL_MAGIC_regex_global
! #   define PERL_MAGIC_regex_global   'g'
! #endif
! 
! #ifndef PERL_MAGIC_isa
! #   define PERL_MAGIC_isa            'I'
! #endif
! 
! #ifndef PERL_MAGIC_isaelem
! #   define PERL_MAGIC_isaelem        'i'
! #endif
! 
! #ifndef PERL_MAGIC_nkeys
! #   define PERL_MAGIC_nkeys          'k'
! #endif
! 
! #ifndef PERL_MAGIC_dbfile
! #   define PERL_MAGIC_dbfile         'L'
! #endif
! 
! #ifndef PERL_MAGIC_dbline
! #   define PERL_MAGIC_dbline         'l'
! #endif
! 
! #ifndef PERL_MAGIC_mutex
! #   define PERL_MAGIC_mutex          'm'
! #endif
! 
! #ifndef PERL_MAGIC_shared
! #   define PERL_MAGIC_shared         'N'
! #endif
! 
! #ifndef PERL_MAGIC_shared_scalar
! #   define PERL_MAGIC_shared_scalar  'n'
! #endif
! 
! #ifndef PERL_MAGIC_collxfrm
! #   define PERL_MAGIC_collxfrm       'o'
! #endif
! 
! #ifndef PERL_MAGIC_tied
! #   define PERL_MAGIC_tied           'P'
! #endif
! 
! #ifndef PERL_MAGIC_tiedelem
! #   define PERL_MAGIC_tiedelem       'p'
! #endif
! 
! #ifndef PERL_MAGIC_tiedscalar
! #   define PERL_MAGIC_tiedscalar     'q'
! #endif
! 
! #ifndef PERL_MAGIC_qr
! #   define PERL_MAGIC_qr             'r'
! #endif
! 
! #ifndef PERL_MAGIC_sig
! #   define PERL_MAGIC_sig            'S'
! #endif
! 
! #ifndef PERL_MAGIC_sigelem
! #   define PERL_MAGIC_sigelem        's'
! #endif
! 
! #ifndef PERL_MAGIC_taint
! #   define PERL_MAGIC_taint          't'
! #endif
! 
! #ifndef PERL_MAGIC_uvar
! #   define PERL_MAGIC_uvar           'U'
! #endif
! 
! #ifndef PERL_MAGIC_uvar_elem
! #   define PERL_MAGIC_uvar_elem      'u'
! #endif
! 
! #ifndef PERL_MAGIC_vstring
! #   define PERL_MAGIC_vstring        'V'
! #endif
! 
! #ifndef PERL_MAGIC_vec
! #   define PERL_MAGIC_vec            'v'
! #endif
! 
! #ifndef PERL_MAGIC_utf8
! #   define PERL_MAGIC_utf8           'w'
! #endif
! 
! #ifndef PERL_MAGIC_substr
! #   define PERL_MAGIC_substr         'x'
! #endif
! 
! #ifndef PERL_MAGIC_defelem
! #   define PERL_MAGIC_defelem        'y'
! #endif
! 
! #ifndef PERL_MAGIC_glob
! #   define PERL_MAGIC_glob           '*'
! #endif
! 
! #ifndef PERL_MAGIC_arylen
! #   define PERL_MAGIC_arylen         '#'
! #endif
! 
! #ifndef PERL_MAGIC_pos
! #   define PERL_MAGIC_pos            '.'
! #endif
! 
! #ifndef PERL_MAGIC_backref
! #   define PERL_MAGIC_backref        '<'
! #endif
! 
! #ifndef PERL_MAGIC_ext
! #   define PERL_MAGIC_ext            '~'
! #endif
! 
! #endif /* _P_P_PORTABILITY_H_ */
! 
! /* End of File ppport.h */
---------------------------(end of broadcast)---------------------------
TIP 8: explain analyze is your friend

Reply via email to