2 * Copyright (C) 1995-2008 University of Karlsruhe. All right reserved.
4 * This file is part of libFirm.
6 * This file may be distributed and/or modified under the terms of the
7 * GNU General Public License version 2 as published by the Free Software
8 * Foundation and appearing in the file LICENSE.GPL included in the
9 * packaging of this file.
11 * Licensees holding valid libFirm Professional Edition licenses may use
12 * this file in accordance with the libFirm Commercial License.
13 * Agreement provided with the Software.
15 * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
16 * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * @brief Entry point to the representation of procedure code -- internal header.
23 * @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
26 #ifndef FIRM_IR_IRGRAPH_T_H
27 #define FIRM_IR_IRGRAPH_T_H
29 #include "firm_types.h"
36 #include "iredgekinds.h"
44 /** Suffix that is added to every frame type. */
45 #define FRAME_TP_SUFFIX "frame_tp"
48 * Initializes the graph construction module.
50 void firm_init_irgraph(void);
53 * Set the number of locals for a given graph.
55 * @param irg the graph
56 * @param n_loc number of locals
58 void irg_set_nloc(ir_graph *res, int n_loc);
61 * Internal constructor that does not add to irp_irgs or the like.
63 ir_graph *new_r_ir_graph(ir_entity *ent, int n_loc);
66 * Make a rudimentary ir graph for the constant code.
67 * Must look like a correct irg, spare everything else.
69 ir_graph *new_const_code_irg(void);
72 * Create a new graph that is a copy of a given one.
73 * Uses the link fields of the original graphs.
75 * @param irg The graph that must be copied.
77 ir_graph *create_irg_copy(ir_graph *irg);
80 * Set the op_pin_state_pinned state of a graph.
82 * @param irg the IR graph
83 * @param p new pin state
85 void set_irg_pinned(ir_graph *irg, op_pin_state p);
87 /** Returns the obstack associated with the graph. */
88 struct obstack *get_irg_obstack(const ir_graph *irg);
91 * Returns true if the node n is allocated on the storage of graph irg.
93 * @param irg the IR graph
94 * @param n the IR node
96 int node_is_in_irgs_storage(ir_graph *irg, ir_node *n);
98 /*-------------------------------------------------------------------*/
99 /* inline functions for graphs */
100 /*-------------------------------------------------------------------*/
102 static inline int _is_ir_graph(const void *thing)
104 return (get_kind(thing) == k_ir_graph);
107 /** Returns the start block of a graph. */
108 static inline ir_node *_get_irg_start_block(const ir_graph *irg)
110 return get_irn_n(irg->anchor, anchor_start_block);
113 static inline void _set_irg_start_block(ir_graph *irg, ir_node *node)
115 set_irn_n(irg->anchor, anchor_start_block, node);
118 static inline ir_node *_get_irg_start(const ir_graph *irg)
120 return get_irn_n(irg->anchor, anchor_start);
123 static inline void _set_irg_start(ir_graph *irg, ir_node *node)
125 set_irn_n(irg->anchor, anchor_start, node);
128 static inline ir_node *_get_irg_end_block(const ir_graph *irg)
130 return get_irn_n(irg->anchor, anchor_end_block);
133 static inline void _set_irg_end_block(ir_graph *irg, ir_node *node)
135 set_irn_n(irg->anchor, -1, node);
136 set_irn_n(irg->anchor, anchor_end_block, node);
139 static inline ir_node *_get_irg_end(const ir_graph *irg)
141 return get_irn_n(irg->anchor, anchor_end);
144 static inline void _set_irg_end(ir_graph *irg, ir_node *node)
146 set_irn_n(irg->anchor, anchor_end, node);
149 static inline ir_node *_get_irg_initial_exec(const ir_graph *irg)
151 return get_irn_n(irg->anchor, anchor_initial_exec);
154 static inline void _set_irg_initial_exec(ir_graph *irg, ir_node *node)
156 set_irn_n(irg->anchor, anchor_initial_exec, node);
159 static inline ir_node *_get_irg_frame(const ir_graph *irg)
161 return get_irn_n(irg->anchor, anchor_frame);
164 static inline void _set_irg_frame(ir_graph *irg, ir_node *node)
166 set_irn_n(irg->anchor, anchor_frame, node);
169 static inline ir_node *_get_irg_tls(const ir_graph *irg)
171 return get_irn_n(irg->anchor, anchor_tls);
174 static inline void _set_irg_tls(ir_graph *irg, ir_node *node)
176 set_irn_n(irg->anchor, anchor_tls, node);
179 static inline ir_node *_get_irg_initial_mem(const ir_graph *irg)
181 return get_irn_n(irg->anchor, anchor_initial_mem);
184 static inline void _set_irg_initial_mem(ir_graph *irg, ir_node *node)
186 set_irn_n(irg->anchor, anchor_initial_mem, node);
189 static inline ir_node *_get_irg_args(const ir_graph *irg)
191 return get_irn_n(irg->anchor, anchor_args);
194 static inline void _set_irg_args(ir_graph *irg, ir_node *node)
196 set_irn_n(irg->anchor, anchor_args, node);
199 static inline ir_node *_get_irg_bad(const ir_graph *irg)
201 return get_irn_n(irg->anchor, anchor_bad);
204 static inline void _set_irg_bad(ir_graph *irg, ir_node *node)
206 set_irn_n(irg->anchor, anchor_bad, node);
209 static inline ir_node * _get_irg_no_mem(const ir_graph *irg)
211 return get_irn_n(irg->anchor, anchor_no_mem);
214 static inline void _set_irg_no_mem(ir_graph *irg, ir_node *node)
216 set_irn_n(irg->anchor, anchor_no_mem, node);
219 static inline ir_node *_get_irg_current_block(const ir_graph *irg)
221 return irg->current_block;
224 static inline void _set_irg_current_block(ir_graph *irg, ir_node *node)
226 irg->current_block = node;
229 static inline ir_entity *_get_irg_entity(const ir_graph *irg)
235 static inline void _set_irg_entity(ir_graph *irg, ir_entity *ent)
240 static inline ir_type *_get_irg_frame_type(ir_graph *irg)
242 assert(irg->frame_type);
243 return irg->frame_type;
246 static inline void _set_irg_frame_type(ir_graph *irg, ir_type *ftp)
248 assert(is_frame_type(ftp));
249 irg->frame_type = ftp;
252 static inline struct obstack *_get_irg_obstack(const ir_graph *irg)
258 static inline irg_phase_state _get_irg_phase_state(const ir_graph *irg)
260 return irg->phase_state;
263 static inline void _set_irg_phase_state(ir_graph *irg, irg_phase_state state)
265 irg->phase_state = state;
268 static inline op_pin_state _get_irg_pinned(const ir_graph *irg)
270 return irg->irg_pinned_state;
273 static inline irg_outs_state _get_irg_outs_state(const ir_graph *irg)
275 return irg->outs_state;
278 static inline void _set_irg_outs_inconsistent(ir_graph *irg)
280 if (irg->outs_state == outs_consistent)
281 irg->outs_state = outs_inconsistent;
284 static inline irg_extblk_state _get_irg_extblk_state(const ir_graph *irg)
286 return irg->extblk_state;
289 static inline void _set_irg_extblk_inconsistent(ir_graph *irg)
291 if (irg->extblk_state == extblk_valid)
292 irg->extblk_state = extblk_invalid;
295 static inline irg_dom_state _get_irg_dom_state(const ir_graph *irg)
297 return irg->dom_state;
300 static inline irg_dom_state _get_irg_postdom_state(const ir_graph *irg)
302 return irg->pdom_state;
305 static inline void _set_irg_doms_inconsistent(ir_graph *irg)
307 if (irg->dom_state != dom_none)
308 irg->dom_state = dom_inconsistent;
309 if (irg->pdom_state != dom_none)
310 irg->pdom_state = dom_inconsistent;
313 static inline irg_loopinfo_state _get_irg_loopinfo_state(const ir_graph *irg)
315 return irg->loopinfo_state;
318 static inline void _set_irg_loopinfo_state(ir_graph *irg, irg_loopinfo_state s)
320 irg->loopinfo_state = s;
323 static inline void _set_irg_loopinfo_inconsistent(ir_graph *irg)
325 irg->loopinfo_state &= ~loopinfo_valid;
328 static inline void _set_irg_pinned(ir_graph *irg, op_pin_state p)
330 irg->irg_pinned_state = p;
333 static inline irg_callee_info_state _get_irg_callee_info_state(const ir_graph *irg)
335 return irg->callee_info_state;
338 static inline void _set_irg_callee_info_state(ir_graph *irg, irg_callee_info_state s)
340 irg_callee_info_state irp_state = get_irp_callee_info_state();
342 irg->callee_info_state = s;
344 /* I could compare ... but who knows? */
345 if ((irp_state == irg_callee_info_consistent) ||
346 ((irp_state == irg_callee_info_inconsistent) && (s == irg_callee_info_none)))
347 set_irp_callee_info_state(s);
350 static inline irg_inline_property _get_irg_inline_property(const ir_graph *irg)
352 return irg->inline_property;
355 static inline void _set_irg_inline_property(ir_graph *irg, irg_inline_property s)
357 irg->inline_property = s;
360 static inline unsigned _get_irg_additional_properties(const ir_graph *irg)
362 if (irg->additional_properties & mtp_property_inherited)
363 return get_method_additional_properties(get_entity_type(irg->ent));
364 return irg->additional_properties;
367 static inline void _set_irg_additional_properties(ir_graph *irg, unsigned mask)
369 irg->additional_properties = mask & ~mtp_property_inherited;
372 static inline void _set_irg_additional_property(ir_graph *irg, mtp_additional_property flag)
374 unsigned prop = irg->additional_properties;
376 if (prop & mtp_property_inherited)
377 prop = get_method_additional_properties(get_entity_type(irg->ent));
378 irg->additional_properties = prop | flag;
381 static inline void _set_irg_link(ir_graph *irg, void *thing)
386 static inline void *_get_irg_link(const ir_graph *irg)
391 static inline ir_visited_t _get_irg_visited(const ir_graph *irg)
396 static inline ir_visited_t _get_irg_block_visited(const ir_graph *irg)
398 return irg->block_visited;
401 static inline void _set_irg_block_visited(ir_graph *irg, ir_visited_t visited)
403 irg->block_visited = visited;
406 static inline void _inc_irg_block_visited(ir_graph *irg)
408 ++irg->block_visited;
411 static inline void _dec_irg_block_visited(ir_graph *irg)
413 --irg->block_visited;
416 static inline unsigned _get_irg_estimated_node_cnt(const ir_graph *irg)
418 return irg->estimated_node_count;
421 /* Return the floating point model of this graph. */
422 static inline unsigned _get_irg_fp_model(const ir_graph *irg)
424 return irg->fp_model;
427 static inline void _set_irg_state(ir_graph *irg, ir_graph_state_t state)
432 static inline void _clear_irg_state(ir_graph *irg, ir_graph_state_t state)
434 irg->state &= ~state;
437 static inline int _is_irg_state(const ir_graph *irg, ir_graph_state_t state)
439 return (irg->state & state) == state;
443 * Allocates a new idx in the irg for the node and adds the irn to the idx -> irn map.
444 * @param irg The graph.
445 * @param irn The node.
446 * @return The index allocated for the node.
448 static inline unsigned irg_register_node_idx(ir_graph *irg, ir_node *irn) {
449 unsigned idx = irg->last_node_idx++;
450 if (idx >= (unsigned)ARR_LEN(irg->idx_irn_map))
451 ARR_RESIZE(ir_node *, irg->idx_irn_map, idx + 1);
453 irg->idx_irn_map[idx] = irn;
458 * Kill a node from the irg. BEWARE: this kills
459 * all later created nodes.
461 static inline void irg_kill_node(ir_graph *irg, ir_node *n)
463 unsigned idx = get_irn_idx(n);
464 assert(idx + 1 == irg->last_node_idx);
466 if (idx + 1 == irg->last_node_idx)
467 --irg->last_node_idx;
468 irg->idx_irn_map[idx] = NULL;
469 obstack_free(irg->obst, n);
473 * Get the node for an index.
474 * @param irg The graph.
475 * @param idx The index you want the node for.
476 * @return The node with that index or NULL, if there is no node with that index.
477 * @note The node you got might be dead.
479 static inline ir_node *_get_idx_irn(ir_graph *irg, unsigned idx)
481 assert(idx < (unsigned) ARR_LEN(irg->idx_irn_map));
482 return irg->idx_irn_map[idx];
486 * Return the number of anchors in this graph.
488 static inline int get_irg_n_anchors(const ir_graph *irg)
490 return get_irn_arity(irg->anchor);
494 * Return anchor for given index
496 static inline ir_node *get_irg_anchor(const ir_graph *irg, int idx)
498 return get_irn_n(irg->anchor, idx);
502 * Set anchor for given index
504 static inline void set_irg_anchor(ir_graph *irg, int idx, ir_node *irn)
506 set_irn_n(irg->anchor, idx, irn);
512 * Register a phase on an irg.
513 * The phase will then be managed by the irg. This means you can easily
514 * access the phase when you only have a graph handle, the memory will be
515 * freed when the graph is freed and some care is taken that the phase data
516 * will be invalidated/preserved on events like dead code elemination and
519 void irg_register_phase(ir_graph *irg, ir_phase_id id, ir_phase *phase);
522 * Frees all phase infos attached to an irg
524 void irg_invalidate_phases(ir_graph *irg);
527 * return phase with given id
529 static inline ir_phase *irg_get_phase(const ir_graph *irg, ir_phase_id id)
531 assert(id <= PHASE_LAST);
532 return irg->phases[id];
536 #define is_ir_graph(thing) _is_ir_graph(thing)
537 #define get_irg_start_block(irg) _get_irg_start_block(irg)
538 #define set_irg_start_block(irg, node) _set_irg_start_block(irg, node)
539 #define get_irg_start(irg) _get_irg_start(irg)
540 #define set_irg_start(irg, node) _set_irg_start(irg, node)
541 #define get_irg_end_block(irg) _get_irg_end_block(irg)
542 #define set_irg_end_block(irg, node) _set_irg_end_block(irg, node)
543 #define get_irg_end(irg) _get_irg_end(irg)
544 #define set_irg_end(irg, node) _set_irg_end(irg, node)
545 #define get_irg_initial_exec(irg) _get_irg_initial_exec(irg)
546 #define set_irg_initial_exec(irg, node) _set_irg_initial_exec(irg, node)
547 #define get_irg_frame(irg) _get_irg_frame(irg)
548 #define set_irg_frame(irg, node) _set_irg_frame(irg, node)
549 #define get_irg_tls(irg) _get_irg_tls(irg)
550 #define set_irg_tls(irg, node) _set_irg_tls(irg, node)
551 #define get_irg_initial_mem(irg) _get_irg_initial_mem(irg)
552 #define set_irg_initial_mem(irg, node) _set_irg_initial_mem(irg, node)
553 #define get_irg_args(irg) _get_irg_args(irg)
554 #define set_irg_args(irg, node) _set_irg_args(irg, node)
555 #define get_irg_bad(irg) _get_irg_bad(irg)
556 #define set_irg_bad(irg, node) _set_irg_bad(irg, node)
557 #define get_irg_no_mem(irg) _get_irg_no_mem(irg)
558 #define set_irn_no_mem(irg, node) _set_irn_no_mem(irg, node)
559 #define get_irg_current_block(irg) _get_irg_current_block(irg)
560 #define set_irg_current_block(irg, node) _set_irg_current_block(irg, node)
561 #define get_irg_entity(irg) _get_irg_entity(irg)
562 #define set_irg_entity(irg, ent) _set_irg_entity(irg, ent)
563 #define get_irg_frame_type(irg) _get_irg_frame_type(irg)
564 #define set_irg_frame_type(irg, ftp) _set_irg_frame_type(irg, ftp)
565 #define get_irg_obstack(irg) _get_irg_obstack(irg)
566 #define get_irg_phase_state(irg) _get_irg_phase_state(irg)
567 #define set_irg_phase_state(irg, state) _set_irg_phase_state(irg, state)
568 #define get_irg_pinned(irg) _get_irg_pinned(irg)
569 #define get_irg_outs_state(irg) _get_irg_outs_state(irg)
570 #define set_irg_outs_inconsistent(irg) _set_irg_outs_inconsistent(irg)
571 #define get_irg_extblk_state(irg) _get_irg_extblk_state(irg)
572 #define set_irg_extblk_inconsistent(irg) _set_irg_extblk_inconsistent(irg)
573 #define get_irg_dom_state(irg) _get_irg_dom_state(irg)
574 #define get_irg_postdom_state(irg) _get_irg_postdom_state(irg)
575 #define set_irg_doms_inconsistent(irg) _set_irg_doms_inconsistent(irg)
576 #define get_irg_loopinfo_state(irg) _get_irg_loopinfo_state(irg)
577 #define set_irg_loopinfo_state(irg, s) _set_irg_loopinfo_state(irg, s)
578 #define set_irg_loopinfo_inconsistent(irg) _set_irg_loopinfo_inconsistent(irg)
579 #define set_irg_pinned(irg, p) _set_irg_pinned(irg, p)
580 #define get_irg_callee_info_state(irg) _get_irg_callee_info_state(irg)
581 #define set_irg_callee_info_state(irg, s) _set_irg_callee_info_state(irg, s)
582 #define get_irg_inline_property(irg) _get_irg_inline_property(irg)
583 #define set_irg_inline_property(irg, s) _set_irg_inline_property(irg, s)
584 #define get_irg_additional_properties(irg) _get_irg_additional_properties(irg)
585 #define set_irg_additional_properties(irg, m) _set_irg_additional_properties(irg, m)
586 #define set_irg_additional_property(irg, f) _set_irg_additional_property(irg, f)
587 #define set_irg_link(irg, thing) _set_irg_link(irg, thing)
588 #define get_irg_link(irg) _get_irg_link(irg)
589 #define get_irg_visited(irg) _get_irg_visited(irg)
590 #define get_irg_block_visited(irg) _get_irg_block_visited(irg)
591 #define set_irg_block_visited(irg, v) _set_irg_block_visited(irg, v)
592 #define inc_irg_block_visited(irg) _inc_irg_block_visited(irg)
593 #define dec_irg_block_visited(irg) _dec_irg_block_visited(irg)
594 #define get_irg_estimated_node_cnt(irg) _get_irg_estimated_node_cnt(irg)
595 #define get_irg_fp_model(irg) _get_irg_fp_model(irg)
596 #define get_idx_irn(irg, idx) _get_idx_irn(irg, idx)
597 #define set_irg_state(irg, state) _set_irg_state(irg, state)
598 #define clear_irg_state(irg, state) _clear_irg_state(irg, state)
599 #define is_irg_state(irg, state) _is_irg_state(irg, state)