Daily bump.
[official-gcc.git] / gcc / except.h
blobd79182f6463b535f14833da3d4d200dddb3d9a76
1 /* Exception Handling interface routines.
2 Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
3 Free Software Foundation, Inc.
4 Contributed by Mike Stump <mrs@cygnus.com>.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
11 version.
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 for more details.
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING. If not, write to the Free
20 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
21 02111-1307, USA. */
24 struct function;
26 /* Per-function EH data. Used only in except.c, but GC and others
27 manipulate pointers to the opaque type. */
28 struct eh_status;
30 /* Internal structure describing a region. */
31 struct eh_region;
33 /* Test: is exception handling turned on? */
34 extern int doing_eh (int);
36 /* Note that the current EH region (if any) may contain a throw, or a
37 call to a function which itself may contain a throw. */
38 extern void note_eh_region_may_contain_throw (struct eh_region *);
39 extern void note_current_region_may_contain_throw (void);
41 /* Invokes CALLBACK for every exception handler label. Only used by old
42 loop hackery; should not be used by new code. */
43 extern void for_each_eh_label (void (*) (rtx));
45 /* Invokes CALLBACK for every exception region in the current function. */
46 extern void for_each_eh_region (void (*) (struct eh_region *));
48 /* Determine if the given INSN can throw an exception. */
49 extern bool can_throw_internal_1 (int);
50 extern bool can_throw_internal (rtx);
51 extern bool can_throw_external_1 (int);
52 extern bool can_throw_external (rtx);
54 /* Set TREE_NOTHROW and cfun->all_throwers_are_sibcalls. */
55 extern void set_nothrow_function_flags (void);
57 /* After initial rtl generation, call back to finish generating
58 exception support code. */
59 extern void finish_eh_generation (void);
61 extern void init_eh (void);
62 extern void init_eh_for_function (void);
64 extern rtx reachable_handlers (rtx);
65 extern void maybe_remove_eh_handler (rtx);
67 extern void convert_from_eh_region_ranges (void);
68 extern void convert_to_eh_region_ranges (void);
69 extern void find_exception_handler_labels (void);
70 extern bool current_function_has_exception_handlers (void);
71 extern void output_function_exception_table (void);
73 extern void expand_builtin_unwind_init (void);
74 extern rtx expand_builtin_eh_return_data_regno (tree);
75 extern rtx expand_builtin_extract_return_addr (tree);
76 extern void expand_builtin_init_dwarf_reg_sizes (tree);
77 extern rtx expand_builtin_frob_return_addr (tree);
78 extern rtx expand_builtin_dwarf_sp_column (void);
79 extern void expand_builtin_eh_return (tree, tree);
80 extern void expand_eh_return (void);
81 extern rtx expand_builtin_extend_pointer (tree);
82 extern rtx get_exception_pointer (struct function *);
83 extern rtx get_exception_filter (struct function *);
84 extern int check_handled (tree, tree);
86 extern void sjlj_emit_function_exit_after (rtx);
88 extern struct eh_region *gen_eh_region_cleanup (struct eh_region *,
89 struct eh_region *);
90 extern struct eh_region *gen_eh_region_try (struct eh_region *);
91 extern struct eh_region *gen_eh_region_catch (struct eh_region *, tree);
92 extern struct eh_region *gen_eh_region_allowed (struct eh_region *, tree);
93 extern struct eh_region *gen_eh_region_must_not_throw (struct eh_region *);
94 extern int get_eh_region_number (struct eh_region *);
95 extern bool get_eh_region_may_contain_throw (struct eh_region *);
96 extern tree get_eh_region_tree_label (struct eh_region *);
97 extern void set_eh_region_tree_label (struct eh_region *, tree);
99 extern void foreach_reachable_handler (int, bool,
100 void (*) (struct eh_region *, void *),
101 void *);
103 extern void collect_eh_region_array (void);
104 extern void expand_resx_expr (tree);
106 /* tree-eh.c */
107 extern int lookup_stmt_eh_region (tree);
109 /* If non-NULL, this is a function that returns an expression to be
110 executed if an unhandled exception is propagated out of a cleanup
111 region. For example, in C++, an exception thrown by a destructor
112 during stack unwinding is required to result in a call to
113 `std::terminate', so the C++ version of this function returns a
114 CALL_EXPR for `std::terminate'. */
115 extern tree (*lang_protect_cleanup_actions) (void);
117 /* Return true if type A catches type B. */
118 extern int (*lang_eh_type_covers) (tree a, tree b);
120 /* Map a type to a runtime object to match type. */
121 extern tree (*lang_eh_runtime_type) (tree);
124 /* Just because the user configured --with-sjlj-exceptions=no doesn't
125 mean that we can use call frame exceptions. Detect that the target
126 has appropriate support. */
128 #ifndef MUST_USE_SJLJ_EXCEPTIONS
129 # if !(defined (EH_RETURN_DATA_REGNO) \
130 && (defined (TARGET_UNWIND_INFO) \
131 || (DWARF2_UNWIND_INFO \
132 && (defined (EH_RETURN_HANDLER_RTX) \
133 || defined (HAVE_eh_return)))))
134 # define MUST_USE_SJLJ_EXCEPTIONS 1
135 # else
136 # define MUST_USE_SJLJ_EXCEPTIONS 0
137 # endif
138 #endif
140 #ifdef CONFIG_SJLJ_EXCEPTIONS
141 # if CONFIG_SJLJ_EXCEPTIONS == 1
142 # define USING_SJLJ_EXCEPTIONS 1
143 # endif
144 # if CONFIG_SJLJ_EXCEPTIONS == 0
145 # define USING_SJLJ_EXCEPTIONS 0
146 # ifndef EH_RETURN_DATA_REGNO
147 #error "EH_RETURN_DATA_REGNO required"
148 # endif
149 # if !defined(EH_RETURN_HANDLER_RTX) && !defined(HAVE_eh_return)
150 #error "EH_RETURN_HANDLER_RTX or eh_return required"
151 # endif
152 # if !defined(DWARF2_UNWIND_INFO) && !defined(TARGET_UNWIND_INFO)
153 #error "{DWARF2,TARGET}_UNWIND_INFO required"
154 # endif
155 # endif
156 #else
157 # define USING_SJLJ_EXCEPTIONS MUST_USE_SJLJ_EXCEPTIONS
158 #endif