libguile/root.h

   1 /* classes: h_files */
   2
   3 #ifndef ROOTH
   4 #define ROOTH
   5
   6 /*      Copyright (C) 1996,1998, 2000 Free Software Foundation, Inc.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2, or (at your option)
  11  * any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this software; see the file COPYING.  If not, write to
  20  * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  21  * Boston, MA 02111-1307 USA
  22  *
  23  * As a special exception, the Free Software Foundation gives permission
  24  * for additional uses of the text contained in its release of GUILE.
  25  *
  26  * The exception is that, if you link the GUILE library with other files
  27  * to produce an executable, this does not by itself cause the
  28  * resulting executable to be covered by the GNU General Public License.
  29  * Your use of that executable is in no way restricted on account of
  30  * linking the GUILE library code into it.
  31  *
  32  * This exception does not however invalidate any other reasons why
  33  * the executable file might be covered by the GNU General Public License.
  34  *
  35  * This exception applies only to the code released by the
  36  * Free Software Foundation under the name GUILE.  If you copy
  37  * code from other Free Software Foundation releases into a copy of
  38  * GUILE, as the General Public License permits, the exception does
  39  * not apply to the code that you add in this way.  To avoid misleading
  40  * anyone as to the status of such modified files, you must delete
  41  * this exception notice from them.
  42  *
  43  * If you write modifications of your own for GUILE, it is your choice
  44  * whether to permit this exception to apply to your modifications.
  45  * If you do not wish that, delete this exception notice.  */
  46
  47 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
  48    gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
  49 \f
  50
  51 \f
  52
  53 #include "libguile/__scm.h"
  54 #include "libguile/debug.h"
  55 #include "libguile/throw.h"
  56
  57 \f
  58
  59 #define scm_flo0 scm_sys_protects[0]
  60 #define scm_listofnull scm_sys_protects[1]
  61 #define scm_undefineds scm_sys_protects[2]
  62 #define scm_nullvect scm_sys_protects[3]
  63 #define scm_nullstr scm_sys_protects[4]
  64 #define scm_keyword_obarray scm_sys_protects[5]
  65 #define scm_stand_in_procs scm_sys_protects[6]
  66 #define scm_object_whash scm_sys_protects[7]
  67 #define scm_permobjs scm_sys_protects[8]
  68 #define scm_asyncs scm_sys_protects[9]
  69 #define scm_protects scm_sys_protects[10]
  70 #define scm_properties_whash scm_sys_protects[11]
  71 #define scm_gc_registered_roots scm_sys_protects[12]
  72 #ifdef DEBUG_EXTENSIONS
  73 #define scm_source_whash scm_sys_protects[13]
  74 #define SCM_NUM_PROTECTS 14
  75 #else
  76 #define SCM_NUM_PROTECTS 13
  77 #endif
  78
  79 extern SCM scm_sys_protects[];
  80
  81 \f
  82
  83 extern scm_bits_t scm_tc16_root;
  84
  85 #define SCM_ROOTP(obj)       SCM_TYP16_PREDICATE (scm_tc16_root, obj)
  86 #define SCM_ROOT_STATE(root) ((scm_root_state *) SCM_CELL_WORD_1 (root))
  87
  88 typedef struct scm_root_state
  89 {
  90   SCM_STACKITEM * stack_base;
  91   jmp_buf save_regs_gc_mark;
  92   int errjmp_bad;
  93
  94   SCM rootcont;
  95   SCM dynwinds;
  96   SCM continuation_stack;
  97   SCM continuation_stack_ptr;
  98 #ifdef DEBUG_EXTENSIONS
  99   /* It is very inefficient to have this variable in the root state. */
 100   scm_debug_frame_t *last_debug_frame;
 101 #endif
 102
 103   SCM progargs;                 /* vestigial */
 104   SCM exitval;                  /* vestigial */
 105
 106   SCM cur_inp;
 107   SCM cur_outp;
 108   SCM cur_errp;
 109   SCM def_inp;
 110   SCM def_outp;
 111   SCM def_errp;
 112   SCM cur_loadp;
 113
 114   SCM fluids;
 115
 116   SCM handle;                   /* The root object for this root state */
 117   SCM parent;                   /* The parent root object */
 118 } scm_root_state;
 119
 120 #define scm_stack_base                  (scm_root->stack_base)
 121 #define scm_save_regs_gc_mark           (scm_root->save_regs_gc_mark)
 122 #define scm_errjmp_bad                  (scm_root->errjmp_bad)
 123
 124 #define scm_rootcont                    (scm_root->rootcont)
 125 #define scm_dynwinds                    (scm_root->dynwinds)
 126 #define scm_continuation_stack          (scm_root->continuation_stack)
 127 #define scm_continuation_stack_ptr      (scm_root->continuation_stack_ptr)
 128 #define scm_progargs                    (scm_root->progargs)
 129 #ifdef USE_THREADS
 130 #define scm_last_debug_frame            (scm_root->last_debug_frame)
 131 #endif
 132 #define scm_exitval                     (scm_root->exitval)
 133 #define scm_cur_inp                     (scm_root->cur_inp)
 134 #define scm_cur_outp                    (scm_root->cur_outp)
 135 #define scm_cur_errp                    (scm_root->cur_errp)
 136 #define scm_def_inp                     (scm_root->def_inp)
 137 #define scm_def_outp                    (scm_root->def_outp)
 138 #define scm_def_errp                    (scm_root->def_errp)
 139 #define scm_cur_loadp                   (scm_root->cur_loadp)
 140
 141 #ifdef USE_THREADS
 142 #define scm_root ((scm_root_state *) SCM_THREAD_LOCAL_DATA)
 143 #define scm_set_root(new_root) SCM_SET_THREAD_LOCAL_DATA (new_root)
 144 #else /* USE_THREADS */
 145 extern struct scm_root_state *scm_root;
 146 #define scm_set_root(new_root) (scm_root = (new_root))
 147 #endif /* USE_THREADS */
 148
 149 \f
 150
 151 extern SCM scm_make_root (SCM parent);
 152 extern SCM scm_internal_cwdr (scm_catch_body_t body,
 153                               void *body_data,
 154                               scm_catch_handler_t handler,
 155                               void *handler_data,
 156                               SCM_STACKITEM *stack_start);
 157 extern SCM scm_call_with_dynamic_root (SCM thunk, SCM handler);
 158 extern SCM scm_dynamic_root (void);
 159 extern SCM scm_apply_with_dynamic_root (SCM proc, SCM a1, SCM args, SCM handler);
 160 extern void scm_init_root (void);
 161
 162 \f
 163
 164 #if (SCM_DEBUG_DEPRECATED == 0)
 165
 166 /* Use the catch functions from throw.[ch] instead of: */
 167 extern SCM scm_call_catching_errors (SCM (*thunk)(), SCM (*err_filter)(), void * closure);
 168
 169 #endif  /* SCM_DEBUG_DEPRECATED == 0 */
 170
 171 #endif  /* ROOTH */
 172
 173 /*
 174   Local Variables:
 175   c-file-style: "gnu"
 176   End:
 177 */