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