nsz Git - libfirm/blob - ir/ir/ircons_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     Various irnode constructors.  Automatic construction
  23  *            of SSA representation. Private Header
  24  * @author    Martin Trapp, Christian Schaefer, Michael Beck
  25  */
  26 #ifndef FIRM_IR_IRCONS_T_H
  27 #define FIRM_IR_IRCONS_T_H
  28
  29 #include "ircons.h"
  30 #include "irgraph_t.h"
  31
  32 /**
  33  * Creates a new Anchor node.
  34  */
  35 ir_node *new_r_Anchor(ir_graph *irg);
  36
  37 /** create new block node without immediately optimizing it.
  38  * This is an internal helper function for new_ir_graph() */
  39 ir_node *new_r_Block_noopt(ir_graph *irg, int arity, ir_node *in[]);
  40
  41 /**
  42  * Allocate a frag array for a node if the current graph state is phase_building.
  43  *
  44  * @param irn         the node for which the frag array should be allocated
  45  * @param op          the opcode of the (original) node, if does not match opcode of irn,
  46  *                    nothing is done
  47  * @param frag_store  the address of the frag store in irn attributes, if this
  48  *                    address contains a value != NULL, does nothing
  49  */
  50 void firm_alloc_frag_arr(ir_node *irn, ir_op *op, ir_node ***frag_store);
  51
  52 /**
  53  * Restarts SSA construction on the given graph with n_loc
  54  * new values.
  55  *
  56  * @param irg    the graph on which the SSA construction is restarted
  57  * @param n_loc  number of new variables
  58  *
  59  * After this function is complete, the graph is in phase_building
  60  * again and set_value()/get_value() and mature_block() can be used
  61  * to construct new values.
  62  *
  63  * @note do not use get_mem()/set_mem() they will build a new memory
  64  *       instead of modifying the old one which might be not what you expect...
  65  */
  66 void ssa_cons_start(ir_graph *irg, int n_loc);
  67
  68 /**
  69  * Finalize the (restarted) SSA construction. Matures all blocks that are
  70  * not matured yet and reset the graph state to phase_high.
  71  *
  72  * @param irg    the graph on which the SSA construction was restarted
  73  */
  74 void ssa_cons_finish(ir_graph *irg);
  75
  76 #endif