3 * File name: ir/ir/irhooks.h
4 * Purpose: Generic hooks for various libFirm functions.
8 * Copyright: (C) 1998-2005 Universität Karlsruhe
9 * Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
15 * Generic hooks for various libFirm functions.
17 * @author Michael Beck
22 #include "firm_config.h"
28 * options for the hook_merge_nodes hook
31 HOOK_OPT_STG, /**< straightening optimization */
32 HOOK_OPT_IFSIM, /**< if simplification */
33 HOOK_OPT_CONST_EVAL, /**< constant evaluation */
34 HOOK_OPT_ALGSIM, /**< algebraic simplification */
35 HOOK_OPT_PHI, /**< Phi optmization */
36 HOOK_OPT_WAW, /**< Write-After-Write optimization */
37 HOOK_OPT_WAR, /**< Write-After-Read optimization */
38 HOOK_OPT_RAW, /**< Read-After-Write optimization */
39 HOOK_OPT_RAR, /**< Read-After-Read optimization */
40 HOOK_OPT_RC, /**< Read-a-Const optimization */
41 HOOK_OPT_TUPLE, /**< Tuple optimization */
42 HOOK_OPT_ID, /**< ID optimization */
43 HOOK_OPT_CSE, /**< common subexpression elimination */
44 HOOK_OPT_STRENGTH_RED,/**< strength reduction */
45 HOOK_OPT_ARCH_DEP, /**< architecture dependent optimization */
46 HOOK_OPT_REASSOC, /**< reassociation */
47 HOOK_OPT_POLY_CALL, /**< polymorphic call optimization */
48 HOOK_LOWERED, /**< lowered */
56 typedef struct hook_entry {
57 /** a union of all possible hook types */
59 void (*_hook_new_ir_op)(void *context, ir_op *op);
60 void (*_hook_free_ir_op)(void *context, ir_op *op);
61 void (*_hook_new_node)(void *context, ir_node *node);
62 void (*_hook_turn_into_id)(void *context, ir_node *node);
63 void (*_hook_new_graph)(void *context, ir_graph *irg, entity *ent);
64 void (*_hook_free_graph)(void *context, ir_graph *irg);
65 void (*_hook_irg_walk)(void *context, ir_graph *irg, void *pre, void *post);
66 void (*_hook_irg_walk_blkwise)(void *context, ir_graph *irg, void *pre, void *post);
67 void (*_hook_irg_block_walk)(void *context, ir_graph *irg, ir_node *node, void *pre, void *post);
68 void (*_hook_merge_nodes)(void *context, ir_node **new_node_array, int new_num_entries, ir_node **old_node_array, int old_num_entries, hook_opt_kind opt);
69 void (*_hook_reassociate)(void *context, int start);
70 void (*_hook_lower)(void *context, ir_node *node);
71 void (*_hook_inline)(void *context, ir_node *call, ir_graph *irg);
72 void (*_hook_tail_rec)(void *context, ir_graph *irg);
73 void (*_hook_strength_red)(void *context, ir_graph *irg, ir_node *strong, ir_node *cmp);
74 void (*_hook_dead_node_elim_start)(void *context, ir_graph *irg);
75 void (*_hook_dead_node_elim_stop)(void *context, ir_graph *irg);
76 void (*_hook_arch_dep_replace_mul_with_shifts)(void *context, ir_node *irn);
77 void (*_hook_arch_dep_replace_div_by_const)(void *context, ir_node *irn);
78 void (*_hook_arch_dep_replace_mod_by_const)(void *context, ir_node *irn);
79 void (*_hook_arch_dep_replace_DivMod_by_const)(void *context, ir_node *irn);
82 /** the context for every hook */
85 /** needed for chaining */
86 struct hook_entry *next;
100 hook_irg_walk_blkwise,
108 hook_dead_node_elim_start,
109 hook_dead_node_elim_stop,
110 hook_arch_dep_replace_mul_with_shifts,
111 hook_arch_dep_replace_div_by_const,
112 hook_arch_dep_replace_mod_by_const,
113 hook_arch_dep_replace_DivMod_by_const,
118 * register the hook entry.
120 * @param hook the hook type
121 * @rapam entry the hook entry
123 void register_hook(hook_type_t hook, hook_entry_t *entry);
125 #ifdef FIRM_ENABLE_HOOKS
127 extern hook_entry_t *hooks[hook_last];
130 * execute the hook what with the args args
131 * Do not use this macro directly.
133 #define hook_exec(what, args) do { \
135 for (p = hooks[what]; p; p = p->next){ \
136 void *ctx = p->context; \
137 p->hook._##what args; \
143 #define hook_exec(what, args)
145 #endif /* FIRM_ENABLE_HOOKS */
147 #define hook_new_ir_op(op) hook_exec(hook_new_ir_op, (ctx, op))
148 #define hook_free_ir_op(op) hook_exec(hook_free_ir_op, (ctx, op))
149 #define hook_new_node(node) hook_exec(hook_new_node, (ctx, node))
150 #define hook_turn_into_id(node) hook_exec(hook_turn_into_id, (ctx, node))
151 #define hook_new_graph(irg, ent) hook_exec(hook_new_graph, (ctx, irg, ent))
152 #define hook_free_graph(irg) hook_exec(hook_free_graph, (ctx, irg))
153 #define hook_irg_walk(irg, pre, post) hook_exec(hook_irg_walk, (ctx, irg, pre, post))
154 #define hook_irg_walk_blkwise(irg, pre, post) \
155 hook_exec(hook_irg_walk_blkwise, (ctx, irg, pre, post))
156 #define hook_irg_block_walk(irg, node, pre, post) \
157 hook_exec(hook_irg_block_walk, (ctx, irg, node, pre, post))
158 #define hook_merge_nodes(new_node_array, new_num_entries, old_node_array, old_num_entries, opt) \
159 hook_exec(hook_merge_nodes, (ctx, new_node_array, new_num_entries, old_node_array, old_num_entries, opt))
160 #define hook_reassociate(start) hook_exec(hook_reassociate, (ctx, start))
161 #define hook_lower(node) hook_exec(hook_lower, (ctx, node))
162 #define hook_inline(call, irg) hook_exec(hook_inline, (ctx, call, irg))
163 #define hook_tail_rec(irg) hook_exec(hook_tail_rec, (ctx, irg))
164 #define hook_strength_red(irg, strong, cmp) \
165 hook_exec(hook_strength_red, (ctx, irg, strong, cmp))
166 #define hook_dead_node_elim_start(irg) hook_exec(hook_dead_node_elim_start, (ctx, irg))
167 #define hook_dead_node_elim_stop(irg) hook_exec(hook_dead_node_elim_stop, (ctx, irg))
168 #define hook_arch_dep_replace_mul_with_shifts(irn) \
169 hook_exec(hook_arch_dep_replace_mul_with_shifts, (ctx, irn))
170 #define hook_arch_dep_replace_div_by_const(irn) \
171 hook_exec(hook_arch_dep_replace_div_by_const, (ctx, irn))
172 #define hook_arch_dep_replace_mod_by_const(irn) \
173 hook_exec(hook_arch_dep_replace_mod_by_const, (ctx, irn))
174 #define hook_arch_dep_replace_DivMod_by_const(irn) \
175 hook_exec(hook_arch_dep_replace_DivMod_by_const, (ctx, irn))
177 /* the initializer, move to hooks_t.h some day */
178 int init_hooks(void);
180 #endif /* __IRHOOKS_H__ */