forbid calls of new_XXX and new_d_XXX when not in phase_building (only new_r_XXX...
[libfirm] / ir / ir / irgraph_t.h
1 /*
2  * Copyright (C) 1995-2008 University of Karlsruhe.  All right reserved.
3  *
4  * This file is part of libFirm.
5  *
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.
10  *
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.
14  *
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
17  * PURPOSE.
18  */
19
20 /**
21  * @file
22  * @brief    Entry point to the representation of procedure code -- internal header.
23  * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
24  * @version  $Id$
25  */
26 #ifndef FIRM_IR_IRGRAPH_T_H
27 #define FIRM_IR_IRGRAPH_T_H
28
29 #include "firm_types.h"
30 #include "irgraph.h"
31
32 #include "irtypes.h"
33 #include "irprog.h"
34 #include "type_t.h"
35 #include "entity_t.h"
36 #include "iredgekinds.h"
37
38 #include "irloop.h"
39
40 #include "obst.h"
41 #include "pset.h"
42 #include "set.h"
43
44 /** Suffix that is added to every frame type. */
45 #define FRAME_TP_SUFFIX "frame_tp"
46
47 /**
48  * Initializes the graph construction module.
49  */
50 void firm_init_irgraph(void);
51
52 /**
53  * Set the number of locals for a given graph.
54  *
55  * @param irg    the graph
56  * @param n_loc  number of locals
57  */
58 void irg_set_nloc(ir_graph *res, int n_loc);
59
60 /**
61  * Internal constructor that does not add to irp_irgs or the like.
62  */
63 ir_graph *new_r_ir_graph(ir_entity *ent, int n_loc);
64
65 /**
66  * Make a rudimentary ir graph for the constant code.
67  * Must look like a correct irg, spare everything else.
68  */
69 ir_graph *new_const_code_irg(void);
70
71 /**
72  * Create a new graph that is a copy of a given one.
73  * Uses the link fields of the original graphs.
74  *
75  * @param irg  The graph that must be copied.
76  */
77 ir_graph *create_irg_copy(ir_graph *irg);
78
79 /**
80  * Set the op_pin_state_pinned state of a graph.
81  *
82  * @param irg     the IR graph
83  * @param p       new pin state
84  */
85 void set_irg_pinned(ir_graph *irg, op_pin_state p);
86
87 /** Returns the obstack associated with the graph. */
88 struct obstack *get_irg_obstack(const ir_graph *irg);
89
90 /**
91  * Returns true if the node n is allocated on the storage of graph irg.
92  *
93  * @param irg   the IR graph
94  * @param n the IR node
95  */
96 int node_is_in_irgs_storage(ir_graph *irg, ir_node *n);
97
98 /*-------------------------------------------------------------------*/
99 /* inline functions for graphs                                       */
100 /*-------------------------------------------------------------------*/
101
102 static inline int _is_ir_graph(const void *thing)
103 {
104         return (get_kind(thing) == k_ir_graph);
105 }
106
107 /** Returns the start block of a graph. */
108 static inline ir_node *_get_irg_start_block(const ir_graph *irg)
109 {
110         return get_irn_n(irg->anchor, anchor_start_block);
111 }
112
113 static inline void _set_irg_start_block(ir_graph *irg, ir_node *node)
114 {
115         set_irn_n(irg->anchor, anchor_start_block, node);
116 }
117
118 static inline ir_node *_get_irg_start(const ir_graph *irg)
119 {
120         return get_irn_n(irg->anchor, anchor_start);
121 }
122
123 static inline void _set_irg_start(ir_graph *irg, ir_node *node)
124 {
125         set_irn_n(irg->anchor, anchor_start, node);
126 }
127
128 static inline ir_node *_get_irg_end_block(const ir_graph *irg)
129 {
130         return get_irn_n(irg->anchor, anchor_end_block);
131 }
132
133 static inline void _set_irg_end_block(ir_graph *irg, ir_node *node)
134 {
135         set_irn_n(irg->anchor, -1, node);
136         set_irn_n(irg->anchor, anchor_end_block, node);
137 }
138
139 static inline ir_node *_get_irg_end(const ir_graph *irg)
140 {
141         return get_irn_n(irg->anchor, anchor_end);
142 }
143
144 static inline void _set_irg_end(ir_graph *irg, ir_node *node)
145 {
146         set_irn_n(irg->anchor, anchor_end, node);
147 }
148
149 static inline ir_node *_get_irg_initial_exec(const ir_graph *irg)
150 {
151         return get_irn_n(irg->anchor, anchor_initial_exec);
152 }
153
154 static inline void _set_irg_initial_exec(ir_graph *irg, ir_node *node)
155 {
156         set_irn_n(irg->anchor, anchor_initial_exec, node);
157 }
158
159 static inline ir_node *_get_irg_frame(const ir_graph *irg)
160 {
161         return get_irn_n(irg->anchor, anchor_frame);
162 }
163
164 static inline void _set_irg_frame(ir_graph *irg, ir_node *node)
165 {
166         set_irn_n(irg->anchor, anchor_frame, node);
167 }
168
169 static inline ir_node *_get_irg_tls(const ir_graph *irg)
170 {
171         return get_irn_n(irg->anchor, anchor_tls);
172 }
173
174 static inline void _set_irg_tls(ir_graph *irg, ir_node *node)
175 {
176         set_irn_n(irg->anchor, anchor_tls, node);
177 }
178
179 static inline ir_node *_get_irg_initial_mem(const ir_graph *irg)
180 {
181         return get_irn_n(irg->anchor, anchor_initial_mem);
182 }
183
184 static inline void _set_irg_initial_mem(ir_graph *irg, ir_node *node)
185 {
186         set_irn_n(irg->anchor, anchor_initial_mem, node);
187 }
188
189 static inline ir_node *_get_irg_args(const ir_graph *irg)
190 {
191         return get_irn_n(irg->anchor, anchor_args);
192 }
193
194 static inline void _set_irg_args(ir_graph *irg, ir_node *node)
195 {
196         set_irn_n(irg->anchor, anchor_args, node);
197 }
198
199 static inline ir_node *_get_irg_bad(const ir_graph *irg)
200 {
201         return get_irn_n(irg->anchor, anchor_bad);
202 }
203
204 static inline void _set_irg_bad(ir_graph *irg, ir_node *node)
205 {
206         set_irn_n(irg->anchor, anchor_bad, node);
207 }
208
209 static inline ir_node * _get_irg_no_mem(const ir_graph *irg)
210 {
211         return get_irn_n(irg->anchor, anchor_no_mem);
212 }
213
214 static inline void _set_irg_no_mem(ir_graph *irg, ir_node *node)
215 {
216         set_irn_n(irg->anchor, anchor_no_mem, node);
217 }
218
219 static inline ir_node *_get_irg_current_block(const ir_graph *irg)
220 {
221         return irg->current_block;
222 }
223
224 static inline void _set_irg_current_block(ir_graph *irg, ir_node *node)
225 {
226         irg->current_block = node;
227 }
228
229 static inline ir_entity *_get_irg_entity(const ir_graph *irg)
230 {
231         assert(irg);
232         return irg->ent;
233 }
234
235 static inline void _set_irg_entity(ir_graph *irg, ir_entity *ent)
236 {
237         irg->ent = ent;
238 }
239
240 static inline ir_type *_get_irg_frame_type(ir_graph *irg)
241 {
242         assert(irg->frame_type);
243         return irg->frame_type;
244 }
245
246 static inline void _set_irg_frame_type(ir_graph *irg, ir_type *ftp)
247 {
248         assert(is_frame_type(ftp));
249         irg->frame_type = ftp;
250 }
251
252 static inline struct obstack *_get_irg_obstack(const ir_graph *irg)
253 {
254         return irg->obst;
255 }
256
257
258 static inline irg_phase_state _get_irg_phase_state(const ir_graph *irg)
259 {
260         return irg->phase_state;
261 }
262
263 static inline void _set_irg_phase_state(ir_graph *irg, irg_phase_state state)
264 {
265         irg->phase_state = state;
266 }
267
268 static inline op_pin_state _get_irg_pinned(const ir_graph *irg)
269 {
270         return irg->irg_pinned_state;
271 }
272
273 static inline irg_outs_state _get_irg_outs_state(const ir_graph *irg)
274 {
275         return irg->outs_state;
276 }
277
278 static inline void _set_irg_outs_inconsistent(ir_graph *irg)
279 {
280         if (irg->outs_state == outs_consistent)
281                 irg->outs_state = outs_inconsistent;
282 }
283
284 static inline irg_extblk_state _get_irg_extblk_state(const ir_graph *irg)
285 {
286   return irg->extblk_state;
287 }
288
289 static inline void _set_irg_extblk_inconsistent(ir_graph *irg)
290 {
291         if (irg->extblk_state == extblk_valid)
292                 irg->extblk_state = extblk_invalid;
293 }
294
295 static inline irg_dom_state _get_irg_dom_state(const ir_graph *irg)
296 {
297         return irg->dom_state;
298 }
299
300 static inline irg_dom_state _get_irg_postdom_state(const ir_graph *irg)
301 {
302         return irg->pdom_state;
303 }
304
305 static inline void _set_irg_doms_inconsistent(ir_graph *irg)
306 {
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;
311 }
312
313 static inline irg_loopinfo_state _get_irg_loopinfo_state(const ir_graph *irg)
314 {
315         return irg->loopinfo_state;
316 }
317
318 static inline void _set_irg_loopinfo_state(ir_graph *irg, irg_loopinfo_state s)
319 {
320   irg->loopinfo_state = s;
321 }
322
323 static inline void _set_irg_loopinfo_inconsistent(ir_graph *irg)
324 {
325         irg->loopinfo_state &= ~loopinfo_valid;
326 }
327
328 static inline void _set_irg_pinned(ir_graph *irg, op_pin_state p)
329 {
330         irg->irg_pinned_state = p;
331 }
332
333 static inline irg_callee_info_state _get_irg_callee_info_state(const ir_graph *irg)
334 {
335         return irg->callee_info_state;
336 }
337
338 static inline void _set_irg_callee_info_state(ir_graph *irg, irg_callee_info_state s)
339 {
340         irg_callee_info_state irp_state = get_irp_callee_info_state();
341
342         irg->callee_info_state = s;
343
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);
348 }
349
350 static inline irg_inline_property _get_irg_inline_property(const ir_graph *irg)
351 {
352         return irg->inline_property;
353 }
354
355 static inline void _set_irg_inline_property(ir_graph *irg, irg_inline_property s)
356 {
357         irg->inline_property = s;
358 }
359
360 static inline unsigned _get_irg_additional_properties(const ir_graph *irg)
361 {
362         if (irg->additional_properties & mtp_property_inherited)
363                 return get_method_additional_properties(get_entity_type(irg->ent));
364         return irg->additional_properties;
365 }
366
367 static inline void _set_irg_additional_properties(ir_graph *irg, unsigned mask)
368 {
369         irg->additional_properties = mask & ~mtp_property_inherited;
370 }
371
372 static inline void _set_irg_additional_property(ir_graph *irg, mtp_additional_property flag)
373 {
374         unsigned prop = irg->additional_properties;
375
376         if (prop & mtp_property_inherited)
377                 prop = get_method_additional_properties(get_entity_type(irg->ent));
378         irg->additional_properties = prop | flag;
379 }
380
381 static inline void _set_irg_link(ir_graph *irg, void *thing)
382 {
383         irg->link = thing;
384 }
385
386 static inline void *_get_irg_link(const ir_graph *irg)
387 {
388         return irg->link;
389 }
390
391 static inline ir_visited_t _get_irg_visited(const ir_graph *irg)
392 {
393         return irg->visited;
394 }
395
396 static inline ir_visited_t _get_irg_block_visited(const ir_graph *irg)
397 {
398         return irg->block_visited;
399 }
400
401 static inline void _set_irg_block_visited(ir_graph *irg, ir_visited_t visited)
402 {
403         irg->block_visited = visited;
404 }
405
406 static inline void _inc_irg_block_visited(ir_graph *irg)
407 {
408         ++irg->block_visited;
409 }
410
411 static inline void _dec_irg_block_visited(ir_graph *irg)
412 {
413         --irg->block_visited;
414 }
415
416 static inline unsigned _get_irg_estimated_node_cnt(const ir_graph *irg)
417 {
418         return irg->estimated_node_count;
419 }
420
421 /* Return the floating point model of this graph. */
422 static inline unsigned _get_irg_fp_model(const ir_graph *irg)
423 {
424         return irg->fp_model;
425 }
426
427 static inline void _set_irg_state(ir_graph *irg, ir_graph_state_t state)
428 {
429         irg->state |= state;
430 }
431
432 static inline void _clear_irg_state(ir_graph *irg, ir_graph_state_t state)
433 {
434         irg->state &= ~state;
435 }
436
437 static inline int _is_irg_state(const ir_graph *irg, ir_graph_state_t state)
438 {
439         return (irg->state & state) == state;
440 }
441
442 /**
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.
447  */
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);
452
453         irg->idx_irn_map[idx] = irn;
454         return idx;
455 }
456
457 /**
458  * Kill a node from the irg. BEWARE: this kills
459  * all later created nodes.
460  */
461 static inline void irg_kill_node(ir_graph *irg, ir_node *n)
462 {
463         unsigned idx = get_irn_idx(n);
464         assert(idx + 1 == irg->last_node_idx);
465
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);
470 }
471
472 /**
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.
478  */
479 static inline ir_node *_get_idx_irn(ir_graph *irg, unsigned idx)
480 {
481         assert(idx < (unsigned) ARR_LEN(irg->idx_irn_map));
482         return irg->idx_irn_map[idx];
483 }
484
485 /**
486  * Return the number of anchors in this graph.
487  */
488 static inline int get_irg_n_anchors(const ir_graph *irg)
489 {
490         return get_irn_arity(irg->anchor);
491 }
492
493 /**
494  * Return anchor for given index
495  */
496 static inline ir_node *get_irg_anchor(const ir_graph *irg, int idx)
497 {
498         return get_irn_n(irg->anchor, idx);
499 }
500
501 /**
502  * Set anchor for given index
503  */
504 static inline void set_irg_anchor(ir_graph *irg, int idx, ir_node *irn)
505 {
506         set_irn_n(irg->anchor, idx, irn);
507 }
508
509
510
511 /**
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
517  * code selection.
518  */
519 void irg_register_phase(ir_graph *irg, ir_phase_id id, ir_phase *phase);
520
521 /**
522  * Frees all phase infos attached to an irg
523  */
524 void irg_invalidate_phases(ir_graph *irg);
525
526 /**
527  * return phase with given id
528  */
529 static inline ir_phase *irg_get_phase(const ir_graph *irg, ir_phase_id id)
530 {
531         assert(id <= PHASE_LAST);
532         return irg->phases[id];
533 }
534
535
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)
600
601 #endif