This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
applied suggested patch with PERL_OBJECT tweaks
[perl5.git] / thrdvar.h
index ba867c1..7c72259 100644 (file)
--- a/thrdvar.h
+++ b/thrdvar.h
-/* Per-thread variables */
+/***********************************************/
+/* Global only to current thread               */
+/***********************************************/
+
+/* Don't forget to re-run embed.pl to propagate changes! */
+
+/* The 'T' prefix is only needed for vars that need appropriate #defines
+ * generated when built with or without USE_THREADS.  It is also used
+ * to generate the appropriate export list for win32.
+ *
+ * When building without USE_THREADS, these variables will be truly global.
+ * When building without USE_THREADS but with MULTIPLICITY, these variables
+ * will be global per-interpreter.
+ *
+ * Avoid build-specific #ifdefs here, like DEBUGGING.  That way,
+ * we can keep binary compatibility of the curinterp structure */
+
 /* Important ones in the first cache line (if alignment is done right) */
 
-PERLVAR(Tstack_sp,     SV **)          
+PERLVAR(Tstack_sp,     SV **)          /* top of the stack */
 #ifdef OP_IN_REGISTER
-PERLVAR(Topsave,       OP *)           
+PERLVAR(Topsave,       OP *)
 #else
-PERLVAR(Top,           OP *)           
+PERLVAR(Top,           OP *)           /* currently executing op */
 #endif
-PERLVAR(Tcurpad,       SV **)          
+PERLVAR(Tcurpad,       SV **)          /* active pad (lexicals+tmps) */
+
+PERLVAR(Tstack_base,   SV **)
+PERLVAR(Tstack_max,    SV **)
+
+PERLVAR(Tscopestack,   I32 *)          /* scopes we've ENTERed */
+PERLVAR(Tscopestack_ix,        I32)
+PERLVAR(Tscopestack_max,I32)
+
+PERLVAR(Tsavestack,    ANY *)          /* items that need to be restored
+                                          when LEAVEing scopes we've ENTERed */
+PERLVAR(Tsavestack_ix, I32)
+PERLVAR(Tsavestack_max,        I32)
 
-PERLVAR(Tstack_base,   SV **)          
-PERLVAR(Tstack_max,    SV **)          
+PERLVAR(Ttmps_stack,   SV **)          /* mortals we've made */
+PERLVARI(Ttmps_ix,     I32,    -1)
+PERLVARI(Ttmps_floor,  I32,    -1)
+PERLVAR(Ttmps_max,     I32)
 
-PERLVAR(Tscopestack,   I32 *)          
-PERLVAR(Tscopestack_ix,        I32)            
-PERLVAR(Tscopestack_max,I32)           
+PERLVAR(Tmarkstack,    I32 *)          /* stack_sp locations we're remembering */
+PERLVAR(Tmarkstack_ptr,        I32 *)
+PERLVAR(Tmarkstack_max,        I32 *)
 
-PERLVAR(Tsavestack,    ANY *)          
-PERLVAR(Tsavestack_ix, I32)            
-PERLVAR(Tsavestack_max,        I32)            
+PERLVAR(Tretstack,     OP **)          /* OPs we have postponed executing */
+PERLVAR(Tretstack_ix,  I32)
+PERLVAR(Tretstack_max, I32)
 
-PERLVAR(Tretstack,     OP **)          
-PERLVAR(Tretstack_ix,  I32)            
-PERLVAR(Tretstack_max, I32)            
+PERLVAR(TSv,           SV *)           /* used to hold temporary values */
+PERLVAR(TXpv,          XPV *)          /* used to hold temporary values */
 
-PERLVAR(Tmarkstack,    I32 *)          
-PERLVAR(Tmarkstack_ptr,        I32 *)          
-PERLVAR(Tmarkstack_max,        I32 *)          
+/* stat stuff */
+PERLVAR(Tstatbuf,      Stat_t)
+PERLVAR(Tstatcache,    Stat_t)         /* _ */
+PERLVAR(Tstatgv,       GV *)
+PERLVARI(Tstatname,    SV *,   Nullsv)
 
-PERLVAR(TSv,           SV *)           
-PERLVAR(TXpv,          XPV *)          
-PERLVAR(Tstatbuf,      Stat_t)         
 #ifdef HAS_TIMES
-PERLVAR(Ttimesbuf,     struct tms)             
+PERLVAR(Ttimesbuf,     struct tms)
 #endif
-    
-/* Now the fields that used to be "per interpreter" (even when global) */
 
 /* Fields used by magic variables such as $@, $/ and so on */
 PERLVAR(Ttainted,      bool)           /* using variables controlled by $< */
-PERLVAR(Tcurpm,                PMOP *)         /* what to do \ interps from */
-PERLVAR(Tnrs,          SV *)           
-PERLVAR(Trs,           SV *)           /* $/ */
-PERLVAR(Tlast_in_gv,   GV *)           
-PERLVAR(Tofs,          char *)         /* $, */
-PERLVAR(Tofslen,       STRLEN)         
-PERLVAR(Tdefoutgv,     GV *)           
+PERLVAR(Tcurpm,                PMOP *)         /* what to do \ interps in REs from */
+PERLVAR(Tnrs,          SV *)
+PERLVAR(Trs,           SV *)           /* input record separator $/ */
+PERLVAR(Tlast_in_gv,   GV *)           /* GV used in last <FH> */
+PERLVAR(Tofs,          char *)         /* output field separator $, */
+PERLVAR(Tofslen,       STRLEN)
+PERLVAR(Tdefoutgv,     GV *)           /* default FH for output */
 PERLVARI(Tchopset,     char *, " \n-") /* $: */
-PERLVAR(Tformtarget,   SV *)           
-PERLVAR(Tbodytarget,   SV *)           
-PERLVAR(Ttoptarget,    SV *)           
+PERLVAR(Tformtarget,   SV *)
+PERLVAR(Tbodytarget,   SV *)
+PERLVAR(Ttoptarget,    SV *)
 
 /* Stashes */
 PERLVAR(Tdefstash,     HV *)           /* main symbol table */
 PERLVAR(Tcurstash,     HV *)           /* symbol table for current package */
 
-/* Stacks */
-PERLVAR(Ttmps_stack,   SV **)          
-PERLVARI(Ttmps_ix,     I32,    -1)     
-PERLVARI(Ttmps_floor,  I32,    -1)     
-PERLVAR(Ttmps_max,     I32)            
-
-PERLVAR(Trestartop,    OP *)           /* Are we propagating an error from croak? */
-PERLVARI(Tcurcop,      COP * VOL,      &compiling)     
+PERLVAR(Trestartop,    OP *)           /* propagating an error from croak? */
+PERLVARI(Tcurcop,      COP * VOL,      &PL_compiling)
 PERLVAR(Tin_eval,      VOL int)        /* trap "fatal" errors? */
 PERLVAR(Tdelaymagic,   int)            /* ($<,$>) = ... */
-PERLVAR(Tdirty,                bool)           /* In the middle of tearing things down? */
+PERLVARI(Tdirty,       bool, FALSE)    /* in the middle of tearing things down? */
 PERLVAR(Tlocalizing,   int)            /* are we processing a local() list? */
 
-PERLVAR(Tcxstack,      PERL_CONTEXT *)         
-PERLVARI(Tcxstack_ix,  I32,    -1)     
-PERLVARI(Tcxstack_max, I32,    128)    
-
-PERLVAR(Tcurstack,     AV *)                   /* THE STACK */
-PERLVAR(Tmainstack,    AV *)                   /* the stack when nothing funny is happening */
-PERLVAR(Ttop_env,      JMPENV *)               /* ptr. to current sigjmp() environment */
-PERLVAR(Tstart_env,    JMPENV)                 /* empty startup sigjmp() environment */
+PERLVAR(Tcurstack,     AV *)           /* THE STACK */
+PERLVAR(Tcurstackinfo, PERL_SI *)      /* current stack + context */
+PERLVAR(Tmainstack,    AV *)           /* the stack when nothing funny is happening */
+PERLVAR(Ttop_env,      JMPENV *)       /* ptr. to current sigjmp() environment */
+PERLVAR(Tstart_env,    JMPENV)         /* empty startup sigjmp() environment */
 
 /* statics "owned" by various functions */
-PERLVAR(Tav_fetch_sv,  SV *)
-PERLVAR(Thv_fetch_sv,  SV *)
-PERLVAR(Thv_fetch_ent_mh, HE)
+PERLVAR(Tav_fetch_sv,  SV *)           /* owned by av_fetch() */
+PERLVAR(Thv_fetch_sv,  SV *)           /* owned by hv_fetch() */
+PERLVAR(Thv_fetch_ent_mh, HE)          /* owned by hv_fetch_ent() */
+
+PERLVAR(Tmodcount,     I32)            /* how much mod()ification in assignment? */
+
+PERLVAR(Tlastgotoprobe,        OP*)            /* from pp_ctl.c */
+PERLVARI(Tdumpindent,  I32, 4)         /* # of blanks per dump indentation level */
+
+/* sort stuff */
+PERLVAR(Tsortcop,      OP *)           /* user defined sort routine */
+PERLVAR(Tsortstash,    HV *)           /* which is in some package or other */
+PERLVAR(Tfirstgv,      GV *)           /* $a */
+PERLVAR(Tsecondgv,     GV *)           /* $b */
+PERLVAR(Tsortcxix,     I32)            /* from pp_ctl.c */
+
+/* regex stuff */
+
+PERLVAR(Tscreamfirst,  I32 *)
+PERLVAR(Tscreamnext,   I32 *)
+PERLVARI(Tmaxscream,   I32,    -1)
+PERLVAR(Tlastscream,   SV *)
+
+PERLVAR(Tregdummy,     regnode)        /* from regcomp.c */
+PERLVAR(Tregcomp_parse,        char*)          /* Input-scan pointer. */
+PERLVAR(Tregxend,      char*)          /* End of input for compile */
+PERLVAR(Tregcode,      regnode*)       /* Code-emit pointer; &regdummy = don't */
+PERLVAR(Tregnaughty,   I32)            /* How bad is this pattern? */
+PERLVAR(Tregsawback,   I32)            /* Did we see \1, ...? */
+PERLVAR(Tregprecomp,   char *)         /* uncompiled string. */
+PERLVAR(Tregnpar,      I32)            /* () count. */
+PERLVAR(Tregsize,      I32)            /* Code size. */
+PERLVAR(Tregflags,     U16)            /* are we folding, multilining? */
+PERLVAR(Tregseen,      U32)            /* from regcomp.c */
+PERLVAR(Tseen_zerolen, I32)            /* from regcomp.c */
+PERLVAR(Tseen_evals,   I32)            /* from regcomp.c */
+PERLVAR(Tregcomp_rx,   regexp *)       /* from regcomp.c */
+PERLVAR(Textralen,     I32)            /* from regcomp.c */
+PERLVAR(Tcolorset,     int)            /* from regcomp.c */
+PERLVAR(Tcolors[6],    char *)         /* from regcomp.c */
+PERLVAR(Treginput,     char *)         /* String-input pointer. */
+PERLVAR(Tregbol,       char *)         /* Beginning of input, for ^ check. */
+PERLVAR(Tregeol,       char *)         /* End of input, for $ check. */
+PERLVAR(Tregstartp,    char **)        /* Pointer to startp array. */
+PERLVAR(Tregendp,      char **)        /* Ditto for endp. */
+PERLVAR(Treglastparen, U32 *)          /* Similarly for lastparen. */
+PERLVAR(Tregtill,      char *)         /* How far we are required to go. */
+PERLVAR(Tregprev,      char)           /* char before regbol, \n if none */
+PERLVAR(Treg_start_tmp,        char **)        /* from regexec.c */
+PERLVAR(Treg_start_tmpl,U32)           /* from regexec.c */
+PERLVAR(Tregdata,      struct reg_data *)
+                                       /* from regexec.c renamed was data */
+PERLVAR(Tbostr,                char *)         /* from regexec.c */
+PERLVAR(Treg_flags,    U32)            /* from regexec.c */
+PERLVAR(Treg_eval_set, I32)            /* from regexec.c */
+PERLVAR(Tregnarrate,   I32)            /* from regexec.c */
+PERLVAR(Tregprogram,   regnode *)      /* from regexec.c */
+PERLVARI(Tregindent,   int,        0)  /* from regexec.c */
+PERLVAR(Tregcc,                CURCUR *)       /* from regexec.c */
+PERLVAR(Treg_call_cc,  struct re_cc_state *)   /* from regexec.c */
+PERLVAR(Treg_re,       regexp *)       /* from regexec.c */
+PERLVAR(Treg_ganch,    char *)         /* position of \G */
+PERLVAR(Treg_sv,       SV *)           /* what we match against */
+PERLVAR(Treg_magic,    MAGIC *)        /* pos-magic of what we match */
+PERLVAR(Treg_oldpos,   I32)            /* old pos of what we match */
+
+PERLVARI(Tregcompp,    regcomp_t, FUNC_NAME_TO_PTR(pregcomp))
+                                       /* Pointer to RE compiler */
+PERLVARI(Tregexecp,    regexec_t, FUNC_NAME_TO_PTR(regexec_flags))
+                                       /* Pointer to RE executer */
+PERLVARI(Treginterp_cnt,int,       0)  /* Whether `re'
+                                                  was interpolated. */
+#ifdef DEBUGGING
+PERLVARI(Twatchaddr,   char **,    0)
+PERLVAR(Twatchok,      char *)
+#endif
 
-/* XXX Sort stuff, firstgv secongv and so on? */
-/* XXX What about regexp stuff? */
+/* Note that the variables below are all explicitly referenced in the code
+ * as thr->whatever and therefore don't need the 'T' prefix. */
 
 #ifdef USE_THREADS
 
-PERLVAR(oursv,         SV *)           
-PERLVAR(cvcache,       HV *)           
-PERLVAR(self,          perl_os_thread)         /* Underlying thread object */
-PERLVAR(flags,         U32)            
-PERLVAR(threadsv,      AV *)                   /* Per-thread SVs ($_, $@ etc.) */
-PERLVAR(threadsvp,     SV **)                  /* AvARRAY(threadsv) */
-PERLVAR(specific,      AV *)                   /* Thread-specific user data */
-PERLVAR(errsv,         SV *)                   /* Backing SV for $@ */
-PERLVAR(errhv,         HV *)                   /* HV for what was %@ in pp_ctl.c */
-PERLVAR(mutex,         perl_mutex)             /* For the fields others can change */
-PERLVAR(tid,           U32)            
+PERLVAR(oursv,         SV *)
+PERLVAR(cvcache,       HV *)
+PERLVAR(self,          perl_os_thread) /* Underlying thread object */
+PERLVAR(flags,         U32)
+PERLVAR(threadsv,      AV *)           /* Per-thread SVs ($_, $@ etc.) */
+PERLVAR(threadsvp,     SV **)          /* AvARRAY(threadsv) */
+PERLVAR(specific,      AV *)           /* Thread-specific user data */
+PERLVAR(errsv,         SV *)           /* Backing SV for $@ */
+PERLVAR(errhv,         HV *)           /* HV for what was %@ in pp_ctl.c */
+PERLVAR(mutex,         perl_mutex)     /* For the fields others can change */
+PERLVAR(tid,           U32)
 PERLVAR(prev,          struct perl_thread *)
-PERLVAR(next,          struct perl_thread *)   /* Circular linked list of threads */
+PERLVAR(next,          struct perl_thread *)
+                                       /* Circular linked list of threads */
 
 #ifdef HAVE_THREAD_INTERN
-PERLVAR(i,             struct thread_intern)   /* Platform-dependent internals */
+PERLVAR(i,             struct thread_intern)
+                                       /* Platform-dependent internals */
 #endif
 
-PERLVAR(trailing_nul,  char)                   /* For the sake of thrsv and oursv */
+PERLVAR(trailing_nul,  char)           /* For the sake of thrsv and oursv */
 
 #endif /* USE_THREADS */