2 * Copyright (C) 1995-2011 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.
23 * @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
33 #include "irgraph_t.h"
35 #include "irgraph_t.h"
45 #include "irbackedge_t.h"
46 #include "iredges_t.h"
51 #define INITIAL_IDX_IRN_MAP_SIZE 1024
54 * Indicates, whether additional data can be registered to graphs.
55 * If set to 1, this is not possible anymore.
57 static int forbid_new_data = 0;
60 * The amount of additional space for custom data to be allocated upon
61 * creating a new graph.
63 static size_t additional_graph_data_size = 0;
65 ir_graph *current_ir_graph;
66 ir_graph *get_current_ir_graph(void)
68 return current_ir_graph;
71 void set_current_ir_graph(ir_graph *graph)
73 current_ir_graph = graph;
76 /** contains the suffix for frame type names */
77 static ident *frame_type_suffix = NULL;
79 /* initialize the IR graph module */
80 void firm_init_irgraph(void)
82 frame_type_suffix = new_id_from_str(FRAME_TP_SUFFIX);
87 * Allocate a new IR graph.
88 * This function respects the registered graph data. The only reason for
89 * this function is, that there are two locations, where graphs are
90 * allocated (new_r_ir_graph, new_const_code_irg).
91 * @return Memory for a new graph.
93 static ir_graph *alloc_graph(void)
96 size_t size = sizeof(ir_graph) + additional_graph_data_size;
97 char *ptr = XMALLOCNZ(char, size);
99 res = (ir_graph *)(ptr + additional_graph_data_size);
100 res->kind = k_ir_graph;
102 /* initialize the idx->node map. */
103 res->idx_irn_map = NEW_ARR_F(ir_node *, INITIAL_IDX_IRN_MAP_SIZE);
104 memset(res->idx_irn_map, 0, INITIAL_IDX_IRN_MAP_SIZE * sizeof(res->idx_irn_map[0]));
110 * Frees an allocated IR graph
112 static void free_graph(ir_graph *irg)
114 char *ptr = (char *)irg;
117 for (i = EDGE_KIND_FIRST; i < EDGE_KIND_LAST; ++i)
118 edges_deactivate_kind(irg, i);
119 DEL_ARR_F(irg->idx_irn_map);
120 free(ptr - additional_graph_data_size);
124 * Set the number of locals for a given graph.
126 * @param irg the graph
127 * @param n_loc number of locals
129 void irg_set_nloc(ir_graph *res, int n_loc)
131 assert(res->phase_state == phase_building);
133 res->n_loc = n_loc + 1; /* number of local variables that are never
134 dereferenced in this graph plus one for
135 the store. This is not the number of
136 parameters to the procedure! */
138 if (res->loc_descriptions) {
139 xfree(res->loc_descriptions);
140 res->loc_descriptions = NULL;
144 /* Allocates a list of nodes:
145 - The start block containing a start node and Proj nodes for its four
146 results (X, M, P, Tuple).
147 - The end block containing an end node. This block is not matured after
148 new_ir_graph as predecessors need to be added to it.
149 - The current block, which is empty and also not matured.
150 Further it allocates several datastructures needed for graph construction
153 ir_graph *new_r_ir_graph(ir_entity *ent, int n_loc)
156 ir_node *first_block;
157 ir_node *start, *start_block, *initial_mem, *projX;
161 /* inform statistics here, as blocks will be already build on this graph */
162 hook_new_graph(res, ent);
164 /*-- initialized for each graph. --*/
165 res->kind = k_ir_graph;
166 res->obst = XMALLOC(struct obstack);
167 obstack_init(res->obst);
169 res->phase_state = phase_building;
170 irg_set_nloc(res, n_loc);
172 /* descriptions will be allocated on demand */
173 res->loc_descriptions = NULL;
175 res->visited = 0; /* visited flag, for the ir walker */
176 res->block_visited = 0; /* visited flag, for the 'block'-walker */
178 res->extbb_obst = NULL;
180 res->last_node_idx = 0;
185 res->inline_property = irg_inline_any;
186 res->additional_properties = mtp_property_inherited; /* inherited from type */
188 res->irg_pinned_state = op_pin_state_pinned;
189 res->outs_state = outs_none;
190 res->dom_state = dom_none;
191 res->pdom_state = dom_none;
192 res->typeinfo_state = ir_typeinfo_none;
193 set_irp_typeinfo_inconsistent(); /* there is a new graph with typeinfo_none. */
194 res->callee_info_state = irg_callee_info_none;
195 res->loopinfo_state = loopinfo_none;
196 res->class_cast_state = ir_class_casts_transitive;
197 res->extblk_state = ir_extblk_info_none;
198 res->execfreq_state = exec_freq_none;
199 res->fp_model = fp_model_precise;
200 res->entity_usage_state = ir_entity_usage_not_computed;
201 res->mem_disambig_opt = aa_opt_inherited;
203 /*-- Type information for the procedure of the graph --*/
205 set_entity_irg(ent, res);
207 /*-- a class type so that it can contain "inner" methods as in Pascal. --*/
208 res->frame_type = new_type_frame();
210 /* the Anchor node must be created first */
211 res->anchor = new_r_Anchor(res);
213 /*-- Nodes needed in every graph --*/
214 set_irg_end_block (res, new_r_immBlock(res));
215 set_irg_end(res, new_r_End(res, 0, NULL));
217 start_block = new_r_Block_noopt(res, 0, NULL);
218 set_irg_start_block(res, start_block);
219 set_irg_no_mem (res, new_r_NoMem(res));
220 start = new_r_Start(res);
221 set_irg_start (res, start);
223 /* Proj results of start node */
224 projX = new_r_Proj(start, mode_X, pn_Start_X_initial_exec);
225 set_irg_initial_exec (res, projX);
226 set_irg_frame (res, new_r_Proj(start, mode_P_data, pn_Start_P_frame_base));
227 set_irg_args (res, new_r_Proj(start, mode_T, pn_Start_T_args));
228 initial_mem = new_r_Proj(start, mode_M, pn_Start_M);
229 set_irg_initial_mem(res, initial_mem);
231 res->index = get_irp_new_irg_idx();
233 res->graph_nr = get_irp_new_node_nr();
236 set_r_cur_block(res, start_block);
237 set_r_store(res, initial_mem);
239 /*-- Make a block to start with --*/
240 first_block = new_r_immBlock(res);
241 set_r_cur_block(res, first_block);
242 add_immBlock_pred(first_block, projX);
244 res->method_execution_frequency = -1.0;
245 res->estimated_node_count = 0;
250 ir_graph *new_ir_graph(ir_entity *ent, int n_loc)
252 ir_graph *res = new_r_ir_graph(ent, n_loc);
253 add_irp_irg(res); /* remember this graph global. */
257 /* Make a rudimentary IR graph for the constant code.
258 Must look like a correct irg, spare everything else. */
259 ir_graph *new_const_code_irg(void)
261 ir_graph *res = alloc_graph();
267 ir_node *start_block;
270 /* inform statistics here, as blocks will be already build on this graph */
271 hook_new_graph(res, NULL);
273 res->n_loc = 1; /* Only the memory. */
274 res->visited = 0; /* visited flag, for the ir walker */
275 res->block_visited = 0; /* visited flag, for the 'block'-walker */
276 res->obst = XMALLOC(struct obstack);
277 obstack_init(res->obst);
278 res->extbb_obst = NULL;
280 res->last_node_idx = 0;
282 res->phase_state = phase_building;
283 res->irg_pinned_state = op_pin_state_pinned;
284 res->extblk_state = ir_extblk_info_none;
285 res->fp_model = fp_model_precise;
287 /* value table for global value numbering for optimizing use in iropt.c */
290 res->frame_type = NULL;
292 /* the Anchor node must be created first */
293 res->anchor = new_r_Anchor(res);
295 /* -- The end block -- */
296 end_block = new_r_Block_noopt(res, 0, NULL);
297 set_irg_end_block(res, end_block);
298 end = new_r_End(res, 0, NULL);
299 set_irg_end(res, end);
301 /* -- The start block -- */
302 start_block = new_r_Block_noopt(res, 0, NULL);
303 set_irg_start_block(res, start_block);
304 no_mem = new_r_NoMem(res);
305 set_irg_no_mem(res, no_mem);
306 start = new_r_Start(res);
307 set_irg_start(res, start);
309 /* Proj results of start node */
310 set_irg_initial_mem(res, new_r_Proj(start, mode_M, pn_Start_M));
311 projX = new_r_Proj(start, mode_X, pn_Start_X_initial_exec);
313 body_block = new_r_Block(res, 1, &projX);
315 set_r_cur_block(res, body_block);
317 /* Set the visited flag high enough that the blocks will never be visited. */
318 set_irn_visited(body_block, -1);
319 set_Block_block_visited(body_block, -1);
320 set_Block_block_visited(start_block, -1);
321 set_irn_visited(start_block, -1);
322 set_irn_visited(no_mem, -1);
328 * Pre-Walker: Copies blocks and nodes from the original method graph
329 * to the copied graph.
331 * @param n A node from the original method graph.
332 * @param env The copied graph.
334 static void copy_all_nodes(ir_node *node, void *env)
336 ir_graph *irg = (ir_graph*)env;
337 ir_node *new_node = irn_copy_into_irg(node, irg);
339 set_irn_link(node, new_node);
341 /* fix access to entities on the stack frame */
342 if (is_Sel(new_node)) {
343 ir_entity *ent = get_Sel_entity(new_node);
344 ir_type *tp = get_entity_owner(ent);
346 if (is_frame_type(tp)) {
347 /* replace by the copied entity */
348 ent = (ir_entity*)get_entity_link(ent);
350 assert(is_entity(ent));
351 assert(get_entity_owner(ent) == get_irg_frame_type(irg));
352 set_Sel_entity(new_node, ent);
358 * Post-walker: Set the predecessors of the copied nodes.
359 * The copied nodes are set as link of their original nodes. The links of
360 * "irn" predecessors are the predecessors of copied node.
362 static void rewire(ir_node *irn, void *env)
365 irn_rewire_inputs(irn);
368 static ir_node *get_new_node(const ir_node *old_node)
370 return (ir_node*) get_irn_link(old_node);
374 * Create a new graph that is a copy of a given one.
376 ir_graph *create_irg_copy(ir_graph *irg)
383 res->visited = 0; /* visited flag, for the ir walker */
384 res->block_visited = 0; /* visited flag, for the 'block'-walker */
385 res->obst = XMALLOC(struct obstack);
386 obstack_init(res->obst);
387 res->extbb_obst = NULL;
389 res->last_node_idx = 0;
391 res->phase_state = irg->phase_state;
392 res->irg_pinned_state = irg->irg_pinned_state;
393 res->extblk_state = ir_extblk_info_none;
394 res->fp_model = irg->fp_model;
398 /* clone the frame type here for safety */
399 irp_reserve_resources(irp, IRP_RESOURCE_ENTITY_LINK);
400 res->frame_type = clone_frame_type(irg->frame_type);
402 res->phase_state = irg->phase_state;
404 ir_reserve_resources(irg, IR_RESOURCE_IRN_LINK);
406 /* copy all nodes from the graph irg to the new graph res */
407 irg_walk_anchors(irg, copy_all_nodes, rewire, res);
409 /* copy the Anchor node */
410 res->anchor = get_new_node(irg->anchor);
412 /* -- The end block -- */
413 set_irg_end_block (res, get_new_node(get_irg_end_block(irg)));
414 set_irg_end (res, get_new_node(get_irg_end(irg)));
416 /* -- The start block -- */
417 set_irg_start_block(res, get_new_node(get_irg_start_block(irg)));
418 set_irg_no_mem (res, get_new_node(get_irg_no_mem(irg)));
419 set_irg_start (res, get_new_node(get_irg_start(irg)));
421 /* Proj results of start node */
422 set_irg_initial_mem(res, get_new_node(get_irg_initial_mem(irg)));
424 /* Copy the node count estimation. Would be strange if this
425 is different from the original one. */
426 res->estimated_node_count = irg->estimated_node_count;
428 ir_free_resources(irg, IR_RESOURCE_IRN_LINK);
429 irp_free_resources(irp, IRP_RESOURCE_ENTITY_LINK);
434 /* Frees the passed irgraph.
435 Deallocates all nodes in this graph and the ir_graph structure.
436 Sets the field irgraph in the corresponding entity to NULL.
437 Does not remove the irgraph from the list in irprog (requires
438 inefficient search, call remove_irp_irg by hand).
439 Does not free types, entities or modes that are used only by this
440 graph, nor the entity standing for this graph. */
441 void free_ir_graph(ir_graph *irg)
443 assert(is_ir_graph(irg));
445 edges_deactivate(irg);
447 hook_free_graph(irg);
448 if (irg->outs_state != outs_none)
451 free_type(irg->frame_type);
454 set_entity_irg(irg->ent, NULL); /* not set in const code irg */
457 free_End(get_irg_end(irg));
458 obstack_free(irg->obst,NULL);
460 if (irg->loc_descriptions)
461 free(irg->loc_descriptions);
466 /* access routines for all ir_graph attributes:
468 {attr type} get_irg_{attribute name} (ir_graph *irg);
469 void set_irg_{attr name} (ir_graph *irg, {attr type} {attr}); */
471 int (is_ir_graph)(const void *thing)
473 return _is_ir_graph(thing);
477 /* Outputs a unique number for this node */
478 long get_irg_graph_nr(const ir_graph *irg)
480 return irg->graph_nr;
483 long get_irg_graph_nr(const ir_graph *irg)
485 return PTR_TO_INT(irg);
489 size_t get_irg_idx(const ir_graph *irg)
494 ir_node *(get_idx_irn)(const ir_graph *irg, unsigned idx)
496 return _get_idx_irn(irg, idx);
499 ir_node *(get_irg_start_block)(const ir_graph *irg)
501 return _get_irg_start_block(irg);
504 void (set_irg_start_block)(ir_graph *irg, ir_node *node)
506 _set_irg_start_block(irg, node);
509 ir_node *(get_irg_start)(const ir_graph *irg)
511 return _get_irg_start(irg);
514 void (set_irg_start)(ir_graph *irg, ir_node *node)
516 _set_irg_start(irg, node);
519 ir_node *(get_irg_end_block)(const ir_graph *irg)
521 return _get_irg_end_block(irg);
524 void (set_irg_end_block)(ir_graph *irg, ir_node *node)
526 _set_irg_end_block(irg, node);
529 ir_node *(get_irg_end)(const ir_graph *irg)
531 return _get_irg_end(irg);
534 void (set_irg_end)(ir_graph *irg, ir_node *node)
536 _set_irg_end(irg, node);
539 ir_node *(get_irg_initial_exec)(const ir_graph *irg)
541 return _get_irg_initial_exec(irg);
544 void (set_irg_initial_exec)(ir_graph *irg, ir_node *node)
546 _set_irg_initial_exec(irg, node);
549 ir_node *(get_irg_frame)(const ir_graph *irg)
551 return _get_irg_frame(irg);
554 void (set_irg_frame)(ir_graph *irg, ir_node *node)
556 _set_irg_frame(irg, node);
559 ir_node *(get_irg_initial_mem)(const ir_graph *irg)
561 return _get_irg_initial_mem(irg);
564 void (set_irg_initial_mem)(ir_graph *irg, ir_node *node)
566 _set_irg_initial_mem(irg, node);
569 ir_node *(get_irg_args)(const ir_graph *irg)
571 return _get_irg_args(irg);
574 void (set_irg_args)(ir_graph *irg, ir_node *node)
576 _set_irg_args(irg, node);
579 ir_node *(get_irg_no_mem)(const ir_graph *irg)
581 return _get_irg_no_mem(irg);
584 void (set_irg_no_mem)(ir_graph *irg, ir_node *node)
586 _set_irg_no_mem(irg, node);
589 ir_entity *(get_irg_entity)(const ir_graph *irg)
591 return _get_irg_entity(irg);
594 void (set_irg_entity)(ir_graph *irg, ir_entity *ent)
596 _set_irg_entity(irg, ent);
599 ir_type *(get_irg_frame_type)(ir_graph *irg)
601 return _get_irg_frame_type(irg);
604 void (set_irg_frame_type)(ir_graph *irg, ir_type *ftp)
606 _set_irg_frame_type(irg, ftp);
609 int get_irg_n_locs(ir_graph *irg)
611 return irg->n_loc - 1;
614 /* Returns the obstack associated with the graph. */
616 (get_irg_obstack)(const ir_graph *irg) {
617 return _get_irg_obstack(irg);
621 * Returns true if the node n is allocated on the storage of graph irg.
623 * Implementation is GLIBC specific as is uses the internal _obstack_chunk implementation.
625 int node_is_in_irgs_storage(const ir_graph *irg, const ir_node *n)
627 struct _obstack_chunk *p;
630 * checks weather the ir_node pointer is on the obstack.
631 * A more sophisticated check would test the "whole" ir_node
633 for (p = irg->obst->chunk; p; p = p->prev) {
634 if (((char *)p->contents <= (char *)n) && ((char *)n < (char *)p->limit))
641 irg_phase_state (get_irg_phase_state)(const ir_graph *irg)
643 return _get_irg_phase_state(irg);
646 void (set_irg_phase_state)(ir_graph *irg, irg_phase_state state)
648 _set_irg_phase_state(irg, state);
651 op_pin_state (get_irg_pinned)(const ir_graph *irg)
653 return _get_irg_pinned(irg);
656 irg_outs_state (get_irg_outs_state)(const ir_graph *irg)
658 return _get_irg_outs_state(irg);
661 void (set_irg_outs_inconsistent)(ir_graph *irg)
663 _set_irg_outs_inconsistent(irg);
666 irg_extblk_info_state (get_irg_extblk_state)(const ir_graph *irg)
668 return _get_irg_extblk_state(irg);
671 void (set_irg_extblk_inconsistent)(ir_graph *irg)
673 _set_irg_extblk_inconsistent(irg);
676 irg_dom_state (get_irg_dom_state)(const ir_graph *irg)
678 return _get_irg_dom_state(irg);
681 irg_dom_state (get_irg_postdom_state)(const ir_graph *irg)
683 return _get_irg_postdom_state(irg);
686 void (set_irg_doms_inconsistent)(ir_graph *irg)
688 _set_irg_doms_inconsistent(irg);
691 irg_loopinfo_state (get_irg_loopinfo_state)(const ir_graph *irg)
693 return _get_irg_loopinfo_state(irg);
696 void (set_irg_loopinfo_state)(ir_graph *irg, irg_loopinfo_state s)
698 _set_irg_loopinfo_state(irg, s);
701 void (set_irg_loopinfo_inconsistent)(ir_graph *irg)
703 _set_irg_loopinfo_inconsistent(irg);
706 void set_irp_loopinfo_inconsistent(void)
709 for (i = 0, n = get_irp_n_irgs(); i < n; ++i) {
710 set_irg_loopinfo_inconsistent(get_irp_irg(i));
716 void (set_irg_pinned)(ir_graph *irg, op_pin_state p)
718 _set_irg_pinned(irg, p);
721 irg_callee_info_state (get_irg_callee_info_state)(const ir_graph *irg)
723 return _get_irg_callee_info_state(irg);
726 void (set_irg_callee_info_state)(ir_graph *irg, irg_callee_info_state s)
728 _set_irg_callee_info_state(irg, s);
731 irg_inline_property (get_irg_inline_property)(const ir_graph *irg)
733 return _get_irg_inline_property(irg);
736 void (set_irg_inline_property)(ir_graph *irg, irg_inline_property s)
738 _set_irg_inline_property(irg, s);
741 mtp_additional_properties (get_irg_additional_properties)(const ir_graph *irg)
743 return _get_irg_additional_properties(irg);
746 void (set_irg_additional_properties)(ir_graph *irg, mtp_additional_properties property_mask)
748 _set_irg_additional_properties(irg, property_mask);
751 void (add_irg_additional_properties)(ir_graph *irg, mtp_additional_properties flag)
753 _add_irg_additional_properties(irg, flag);
756 void (set_irg_link)(ir_graph *irg, void *thing)
758 _set_irg_link(irg, thing);
761 void *(get_irg_link)(const ir_graph *irg)
763 return _get_irg_link(irg);
766 ir_visited_t (get_irg_visited)(const ir_graph *irg)
768 return _get_irg_visited(irg);
771 /** maximum visited flag content of all ir_graph visited fields. */
772 static ir_visited_t max_irg_visited = 0;
774 void set_irg_visited(ir_graph *irg, ir_visited_t visited)
776 irg->visited = visited;
777 if (irg->visited > max_irg_visited) {
778 max_irg_visited = irg->visited;
782 void inc_irg_visited(ir_graph *irg)
785 if (irg->visited > max_irg_visited) {
786 max_irg_visited = irg->visited;
790 ir_visited_t get_max_irg_visited(void)
792 return max_irg_visited;
795 void set_max_irg_visited(int val)
797 max_irg_visited = val;
800 ir_visited_t inc_max_irg_visited(void)
804 for (i = 0; i < get_irp_n_irgs(); i++)
805 assert(max_irg_visited >= get_irg_visited(get_irp_irg(i)));
807 return ++max_irg_visited;
810 ir_visited_t (get_irg_block_visited)(const ir_graph *irg)
812 return _get_irg_block_visited(irg);
815 void (set_irg_block_visited)(ir_graph *irg, ir_visited_t visited)
817 _set_irg_block_visited(irg, visited);
820 void (inc_irg_block_visited)(ir_graph *irg)
822 _inc_irg_block_visited(irg);
825 /* Return the floating point model of this graph. */
826 unsigned (get_irg_fp_model)(const ir_graph *irg)
828 return _get_irg_fp_model(irg);
831 /* Sets the floating point model for this graph. */
832 void set_irg_fp_model(ir_graph *irg, unsigned model)
834 irg->fp_model = model;
837 /* set a description for local value n */
838 void set_irg_loc_description(ir_graph *irg, int n, void *description)
840 assert(0 <= n && n < irg->n_loc);
842 if (! irg->loc_descriptions)
843 irg->loc_descriptions = XMALLOCNZ(void*, irg->n_loc);
845 irg->loc_descriptions[n] = description;
848 /* get the description for local value n */
849 void *get_irg_loc_description(ir_graph *irg, int n)
851 assert(0 <= n && n < irg->n_loc);
852 return irg->loc_descriptions ? irg->loc_descriptions[n] : NULL;
855 void irg_register_phase(ir_graph *irg, ir_phase_id id, ir_phase *phase)
857 assert(id <= PHASE_LAST);
858 assert(irg->phases[id] == NULL);
859 irg->phases[id] = phase;
862 void irg_invalidate_phases(ir_graph *irg)
865 for (p = 0; p <= PHASE_LAST; ++p) {
866 ir_phase *phase = irg->phases[p];
871 irg->phases[p] = NULL;
876 void ir_reserve_resources(ir_graph *irg, ir_resources_t resources)
878 assert((irg->reserved_resources & resources) == 0);
879 irg->reserved_resources |= resources;
882 void ir_free_resources(ir_graph *irg, ir_resources_t resources)
884 assert((irg->reserved_resources & resources) == resources);
885 irg->reserved_resources &= ~resources;
888 ir_resources_t ir_resources_reserved(const ir_graph *irg)
890 return irg->reserved_resources;
894 /* Returns a estimated node count of the irg. */
895 unsigned (get_irg_estimated_node_cnt)(const ir_graph *irg)
897 return _get_irg_estimated_node_cnt(irg);
900 /* Returns the last irn index for this graph. */
901 unsigned get_irg_last_idx(const ir_graph *irg)
903 return irg->last_node_idx;
906 /* register additional space in an IR graph */
907 size_t register_additional_graph_data(size_t size)
909 assert(!forbid_new_data && "Too late to register additional node data");
914 return additional_graph_data_size += size;
917 void (set_irg_state)(ir_graph *irg, ir_graph_state_t state)
919 _set_irg_state(irg, state);
922 void (clear_irg_state)(ir_graph *irg, ir_graph_state_t state)
924 _clear_irg_state(irg, state);
927 int (is_irg_state)(const ir_graph *irg, ir_graph_state_t state)
929 return _is_irg_state(irg, state);