X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fir%2Firgraph_t.h;h=200831e3be1308dd02dcad30d9843bffe5cb5acc;hb=06c450a6bf29496386fa6f70b1a223cb4c39155f;hp=8f7848b4f1ab7ea0333ba5cd8027bee6b055641d;hpb=fb648cf14f79e1baffd2b4c4b705f69383e9b613;p=libfirm diff --git a/ir/ir/irgraph_t.h b/ir/ir/irgraph_t.h index 8f7848b4f..200831e3b 100644 --- a/ir/ir/irgraph_t.h +++ b/ir/ir/irgraph_t.h @@ -1,9 +1,13 @@ /* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe -** All rights reserved. -** -** Authors: Martin Trapp, Christian Schaefer -** -** irgraph.h: ir graph construction +* All rights reserved. +*/ + +/** +* @file irgraph_t.h +* +* ir graph construction. +* +* @author Martin Trapp, Christian Schaefer */ /* $Id$ */ @@ -13,62 +17,68 @@ # include "obst.h" # include "pset.h" # include "irgraph.h" +# include "firm_common_t.h" #define FRAME_TP_SUFFIX "frame_tp" -/* ir_graph holds all information for a procedure */ +/** ir_graph holds all information for a procedure */ struct ir_graph { - /** Basics of the representation **/ - struct entity *ent; /* The entity of this procedure, i.e., + /* -- Basics of the representation -- */ + struct entity *ent; /**< The entity of this procedure, i.e., the type of the procedure and the class it belongs to. */ - struct type *frame_type; /* A class type representing the stack frame. + struct type *frame_type; /**< A class type representing the stack frame. Can include "inner" methods. */ - struct ir_node *start_block; /* block the start node will belong to */ - struct ir_node *start; /* start node of this ir_graph */ - struct ir_node *end_block; /* block the end node will belong to */ - struct ir_node *end; /* end node of this ir_graph */ - struct ir_node *cstore; /* constant store -- no more needed!! */ - struct ir_node *frame; /* method's frame */ - struct ir_node *globals; /* pointer to the data segment containing all + struct ir_node *start_block; /**< block the start node will belong to */ + struct ir_node *start; /**< start node of this ir_graph */ + struct ir_node *end_block; /**< block the end node will belong to */ + struct ir_node *end; /**< end node of this ir_graph */ + struct ir_node *cstore; /**< constant store -- no more needed!! */ + struct ir_node *frame; /**< method's frame */ + struct ir_node *globals; /**< pointer to the data segment containing all globals as well as global procedures. */ - struct ir_node *args; /* methods arguments */ - struct ir_node *bad; /* bad node of this ir_graph, the one and + struct ir_node *args; /**< methods arguments */ + struct ir_node *bad; /**< bad node of this ir_graph, the one and only in this graph */ - struct obstack *obst; /* obstack where all of the ir_nodes live */ - struct ir_node *current_block; /* block for newly gen_*()-erated + struct ir_node *unknown; /**< unknown node of this ir_graph */ + struct obstack *obst; /**< obstack where all of the ir_nodes live */ + struct ir_node *current_block; /**< block for newly gen_*()-erated ir_nodes */ - /** Fields indicating different states of irgraph **/ - irg_phase_state phase_state; /* compiler phase */ - op_pinned pinned; /* Flag for status of nodes */ - irg_outs_state outs_state; /* Out edges. */ + /* -- Fields indicating different states of irgraph -- */ + irg_phase_state phase_state; /**< compiler phase */ + op_pinned pinned; /**< Flag for status of nodes */ + irg_outs_state outs_state; /**< Out edges. */ + irg_dom_state dom_state; /**< Dominator information */ - /** Fields for construction **/ -#if USE_EXPICIT_PHI_IN_STACK - struct Phi_in_stack *Phi_in_stack; /* needed for automatic Phi construction */ + /* -- Fields for construction -- */ +#if USE_EXPLICIT_PHI_IN_STACK + struct Phi_in_stack *Phi_in_stack; /**< needed for automatic Phi construction */ #endif - int n_loc; /* number of local variable in this + int n_loc; /**< number of local variable in this procedure including procedure parameters. */ - /** Fields for optimizations / analysis information **/ - pset *value_table; /* hash table for global value numbering (cse) + /* -- Fields for optimizations / analysis information -- */ + pset *value_table; /**< hash table for global value numbering (cse) for optimizing use in iropt.c */ - struct ir_node **outs; /* Space for the out arrays. */ + struct ir_node **outs; /**< Space for the out arrays. */ + struct ir_loop *loop; /**< The outermost loop */ + void *link; /**< A void* field to link any information to + the node. */ - /** Fields for Walking the graph **/ - unsigned long visited; /* this flag is an identifier for + /* -- Fields for Walking the graph -- */ + unsigned long visited; /**< this flag is an identifier for ir walk. it will be incremented every time someone walks through the graph */ - unsigned long block_visited; /* same as visited, for a complete block */ + unsigned long block_visited; /**< same as visited, for a complete block */ }; -/* Make a rudimentary ir graph for the constant code. +/** Make a rudimentary ir graph for the constant code. Must look like a correct irg, spare everything else. */ ir_graph *new_const_code_irg(); -inline void +INLINE void set_irg_pinned (ir_graph *irg, op_pinned p); # endif /* _IRGRAPH_T_H_ */