Commit | Line | Data |
---|---|---|
c7ecd529 MD |
1 | /* classes: h_files */ |
2 | ||
13dcb666 DH |
3 | #ifndef SCM_DEBUG_H |
4 | #define SCM_DEBUG_H | |
b29058ff | 5 | |
434f2f7a DH |
6 | /* Copyright (C) 1995,1996,1998,1999,2000,2001,2002,2004 |
7 | * Free Software Foundation, Inc. | |
b29058ff | 8 | * |
73be1d9e MV |
9 | * This library is free software; you can redistribute it and/or |
10 | * modify it under the terms of the GNU Lesser General Public | |
11 | * License as published by the Free Software Foundation; either | |
12 | * version 2.1 of the License, or (at your option) any later version. | |
b29058ff | 13 | * |
73be1d9e | 14 | * This library is distributed in the hope that it will be useful, |
c7ecd529 | 15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
73be1d9e MV |
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
17 | * Lesser General Public License for more details. | |
b29058ff | 18 | * |
73be1d9e MV |
19 | * You should have received a copy of the GNU Lesser General Public |
20 | * License along with this library; if not, write to the Free Software | |
92205699 | 21 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
73be1d9e | 22 | */ |
d3a6bc94 | 23 | |
c7ecd529 MD |
24 | \f |
25 | ||
b4309c3c | 26 | #include "libguile/__scm.h" |
c7ecd529 | 27 | |
e771f866 | 28 | #include "libguile/options.h" |
c7ecd529 MD |
29 | \f |
30 | ||
31 | /* | |
32 | * Here comes some definitions for the debugging machinery. | |
33 | * It might seem strange to represent debug flags as ints, | |
34 | * but consider that any particular piece of code is normally | |
35 | * only interested in one flag at a time. This is then | |
36 | * the most efficient representation. | |
37 | */ | |
38 | ||
39 | /* {Options} | |
40 | */ | |
41 | ||
33b97402 | 42 | /* scm_debug_opts is defined in eval.c. |
5e8d7fd4 MD |
43 | */ |
44 | ||
33b001fd | 45 | SCM_API scm_t_option scm_debug_opts[]; |
c7ecd529 | 46 | |
5e8d7fd4 MD |
47 | #define SCM_BREAKPOINTS_P scm_debug_opts[1].val |
48 | #define SCM_TRACE_P scm_debug_opts[2].val | |
49 | #define SCM_REC_PROCNAMES_P scm_debug_opts[3].val | |
50 | #define SCM_BACKWARDS_P scm_debug_opts[4].val | |
274dc5fd MD |
51 | #define SCM_BACKTRACE_WIDTH scm_debug_opts[5].val |
52 | #define SCM_BACKTRACE_INDENT scm_debug_opts[6].val | |
53 | #define SCM_N_FRAMES scm_debug_opts[7].val | |
54 | #define SCM_BACKTRACE_MAXDEPTH scm_debug_opts[8].val | |
55 | #define SCM_BACKTRACE_DEPTH scm_debug_opts[9].val | |
56 | #define SCM_BACKTRACE_P scm_debug_opts[10].val | |
57 | #define SCM_DEVAL_P scm_debug_opts[11].val | |
58 | #define SCM_STACK_LIMIT scm_debug_opts[12].val | |
29067b9d | 59 | #define SCM_SHOW_FILE_NAME scm_debug_opts[13].val |
65bc1f7a MV |
60 | #define SCM_WARN_DEPRECATED scm_debug_opts[14].val |
61 | #define SCM_N_DEBUG_OPTIONS 15 | |
c7ecd529 | 62 | |
434f2f7a | 63 | SCM_API int scm_debug_mode_p; |
33b001fd MV |
64 | SCM_API int scm_check_entry_p; |
65 | SCM_API int scm_check_apply_p; | |
66 | SCM_API int scm_check_exit_p; | |
72f19c26 | 67 | SCM_API int scm_check_memoize_p; |
c7ecd529 | 68 | |
5e8d7fd4 | 69 | #define SCM_RESET_DEBUG_MODE \ |
d3a6bc94 | 70 | do {\ |
5132eef0 | 71 | scm_check_entry_p = (SCM_ENTER_FRAME_P || SCM_BREAKPOINTS_P)\ |
7888309b | 72 | && scm_is_true (SCM_ENTER_FRAME_HDLR);\ |
5132eef0 | 73 | scm_check_apply_p = (SCM_APPLY_FRAME_P || SCM_TRACE_P)\ |
7888309b | 74 | && scm_is_true (SCM_APPLY_FRAME_HDLR);\ |
5132eef0 | 75 | scm_check_exit_p = (SCM_EXIT_FRAME_P || SCM_TRACE_P)\ |
7888309b | 76 | && scm_is_true (SCM_EXIT_FRAME_HDLR);\ |
72f19c26 HWN |
77 | scm_check_memoize_p = (SCM_MEMOIZE_P)\ |
78 | && scm_is_true (SCM_MEMOIZE_HDLR);\ | |
434f2f7a | 79 | scm_debug_mode_p = SCM_DEVAL_P\ |
72f19c26 | 80 | || scm_check_memoize_p || scm_check_entry_p || scm_check_apply_p || scm_check_exit_p;\ |
d3a6bc94 | 81 | } while (0) |
c7ecd529 | 82 | |
c7ecd529 MD |
83 | /* {Evaluator} |
84 | */ | |
85 | ||
92c2555f | 86 | typedef union scm_t_debug_info |
c7ecd529 MD |
87 | { |
88 | struct { SCM exp, env; } e; | |
89 | struct { SCM proc, args; } a; | |
473c250d | 90 | SCM id; |
92c2555f | 91 | } scm_t_debug_info; |
c7ecd529 | 92 | |
33b001fd | 93 | SCM_API long scm_debug_eframe_size; |
c7ecd529 | 94 | |
92c2555f | 95 | typedef struct scm_t_debug_frame |
c7ecd529 | 96 | { |
92c2555f | 97 | struct scm_t_debug_frame *prev; |
c7ecd529 | 98 | long status; |
92c2555f MV |
99 | scm_t_debug_info *vect; |
100 | scm_t_debug_info *info; | |
101 | } scm_t_debug_frame; | |
1be6b49c | 102 | |
77debe3c MD |
103 | #define SCM_EVALFRAME (0L << 11) |
104 | #define SCM_APPLYFRAME (1L << 11) | |
105 | #define SCM_VOIDFRAME (3L << 11) | |
106 | #define SCM_MACROEXPF (1L << 10) | |
fcbb26b2 MD |
107 | #define SCM_TAILREC (1L << 9) |
108 | #define SCM_TRACED_FRAME (1L << 8) | |
5e8d7fd4 | 109 | #define SCM_ARGS_READY (1L << 7) |
fcbb26b2 | 110 | #define SCM_DOVERFLOW (1L << 6) |
020c890c | 111 | #define SCM_MAX_FRAME_SIZE 63 |
5e8d7fd4 | 112 | |
77debe3c | 113 | #define SCM_FRAMETYPE (3L << 11) |
fcbb26b2 | 114 | |
77debe3c | 115 | #define SCM_EVALFRAMEP(x) (((x).status & SCM_FRAMETYPE) == SCM_EVALFRAME) |
fcbb26b2 | 116 | #define SCM_APPLYFRAMEP(x) (((x).status & SCM_FRAMETYPE) == SCM_APPLYFRAME) |
473c250d | 117 | #define SCM_VOIDFRAMEP(x) (((x).status & SCM_FRAMETYPE) == SCM_VOIDFRAME) |
5e8d7fd4 MD |
118 | #define SCM_OVERFLOWP(x) (((x).status & SCM_DOVERFLOW) != 0) |
119 | #define SCM_ARGS_READY_P(x) (((x).status & SCM_ARGS_READY) != 0) | |
120 | #define SCM_TRACED_FRAME_P(x) (((x).status & SCM_TRACED_FRAME) != 0) | |
121 | #define SCM_TAILRECP(x) (((x).status & SCM_TAILREC) != 0) | |
77debe3c | 122 | #define SCM_MACROEXPP(x) (((x).status & SCM_MACROEXPF) != 0) |
5e8d7fd4 MD |
123 | #define SCM_SET_OVERFLOW(x) ((x).status |= SCM_DOVERFLOW) |
124 | #define SCM_SET_ARGSREADY(x) ((x).status |= SCM_ARGS_READY) | |
125 | #define SCM_CLEAR_ARGSREADY(x) ((x).status &= ~SCM_ARGS_READY) | |
126 | #define SCM_SET_TRACED_FRAME(x) ((x).status |= SCM_TRACED_FRAME) | |
127 | #define SCM_CLEAR_TRACED_FRAME(x) ((x).status &= ~SCM_TRACED_FRAME) | |
128 | #define SCM_SET_TAILREC(x) ((x).status |= SCM_TAILREC) | |
77debe3c MD |
129 | #define SCM_SET_MACROEXP(x) ((x).status |= SCM_MACROEXPF) |
130 | #define SCM_CLEAR_MACROEXP(x) ((x).status &= ~SCM_MACROEXPF) | |
5e8d7fd4 | 131 | |
fcbb26b2 MD |
132 | /* {Debug Objects} |
133 | */ | |
134 | ||
33b001fd | 135 | SCM_API scm_t_bits scm_tc16_debugobj; |
fcbb26b2 | 136 | |
13dcb666 DH |
137 | #define SCM_DEBUGOBJP(x) \ |
138 | SCM_TYP16_PREDICATE (scm_tc16_debugobj, x) | |
139 | #define SCM_DEBUGOBJ_FRAME(x) \ | |
140 | ((scm_t_debug_frame *) SCM_CELL_WORD_1 (x)) | |
e841c3e0 | 141 | #define SCM_SET_DEBUGOBJ_FRAME(x, f) SCM_SET_CELL_WORD_1 (x, f) |
fcbb26b2 | 142 | |
c7ecd529 MD |
143 | /* {Memoized Source} |
144 | */ | |
145 | ||
33b001fd | 146 | SCM_API scm_t_bits scm_tc16_memoized; |
c7ecd529 | 147 | |
e841c3e0 KN |
148 | #define SCM_MEMOIZEDP(x) SCM_TYP16_PREDICATE (scm_tc16_memoized, x) |
149 | #define SCM_MEMOIZED_EXP(x) SCM_CAR (SCM_CELL_OBJECT_1 (x)) | |
150 | #define SCM_MEMOIZED_ENV(x) SCM_CDR (SCM_CELL_OBJECT_1 (x)) | |
c7ecd529 MD |
151 | |
152 | \f | |
153 | ||
33b001fd MV |
154 | SCM_API SCM scm_debug_object_p (SCM obj); |
155 | SCM_API SCM scm_local_eval (SCM exp, SCM env); | |
156 | SCM_API SCM scm_reverse_lookup (SCM env, SCM data); | |
00f9eace | 157 | SCM_API SCM scm_start_stack (SCM info_id, SCM exp, SCM env); |
33b001fd MV |
158 | SCM_API SCM scm_procedure_environment (SCM proc); |
159 | SCM_API SCM scm_procedure_source (SCM proc); | |
160 | SCM_API SCM scm_procedure_name (SCM proc); | |
161 | SCM_API SCM scm_memoized_environment (SCM m); | |
162 | SCM_API SCM scm_make_memoized (SCM exp, SCM env); | |
163 | SCM_API SCM scm_memoized_p (SCM obj); | |
164 | SCM_API SCM scm_with_traps (SCM thunk); | |
165 | SCM_API SCM scm_evaluator_traps (SCM setting); | |
166 | SCM_API SCM scm_debug_options (SCM setting); | |
33b001fd | 167 | SCM_API SCM scm_make_debugobj (scm_t_debug_frame *debug); |
9fcf3cbb DH |
168 | |
169 | SCM_API SCM scm_i_unmemoize_expr (SCM memoized); | |
33b001fd | 170 | SCM_API void scm_init_debug (void); |
c7ecd529 | 171 | |
f3667f52 | 172 | #ifdef GUILE_DEBUG |
33b001fd MV |
173 | SCM_API SCM scm_memcons (SCM car, SCM cdr, SCM env); |
174 | SCM_API SCM scm_mem_to_proc (SCM obj); | |
175 | SCM_API SCM scm_proc_to_mem (SCM obj); | |
176 | SCM_API SCM scm_debug_hang (SCM obj); | |
f3667f52 JB |
177 | #endif /*GUILE_DEBUG*/ |
178 | ||
5132eef0 | 179 | #if SCM_ENABLE_DEPRECATED == 1 |
434f2f7a | 180 | |
5132eef0 DH |
181 | #define CHECK_ENTRY scm_check_entry_p |
182 | #define CHECK_APPLY scm_check_apply_p | |
183 | #define CHECK_EXIT scm_check_exit_p | |
434f2f7a DH |
184 | |
185 | /* Deprecated in guile 1.7.0 on 2004-03-29. */ | |
186 | #define SCM_DEBUGGINGP scm_debug_mode_p | |
187 | #define scm_debug_mode scm_debug_mode_p | |
188 | ||
5132eef0 DH |
189 | #endif |
190 | ||
b29058ff | 191 | #endif /* SCM_DEBUG_H */ |
89e00824 ML |
192 | |
193 | /* | |
194 | Local Variables: | |
195 | c-file-style: "gnu" | |
196 | End: | |
197 | */ |