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_Anchor(ir_graph *irg);
  37
  38 /**
  39  * Allocate a frag array for a node if the current graph state is phase_building.
  40  *
  41  * @param irn         the node for which the frag array should be allocated
  42  * @param op          the opcode of the (original) node, if does not match opcode of irn,
  43  *                    nothing is done
  44  * @param frag_store  the address of the frag store in irn attributes, if this
  45  *                    address contains a value != NULL, does nothing
  46  */
  47 void firm_alloc_frag_arr(ir_node *irn, ir_op *op, ir_node ***frag_store);
  48
  49 /**
  50  * Restarts SSA construction on the given graph with n_loc
  51  * new values.
  52  *
  53  * @param irg    the graph on which the SSA construction is restarted
  54  * @param n_loc  number of new variables
  55  *
  56  * After this function is complete, the graph is in phase_building
  57  * again and set_value()/get_value() and mature_block() can be used
  58  * to construct new values.
  59  *
  60  * @note do not use get_mem()/set_mem() they will build a new memory
  61  *       instead of modifying the old one which might be not what you expect...
  62  */
  63 void ssa_cons_start(ir_graph *irg, int n_loc);
  64
  65 /**
  66  * Finalize the (restarted) SSA construction. Matures all blocks that are
  67  * not matured yet and reset the graph state to phase_high.
  68  *
  69  * @param irg    the graph on which the SSA construction was restarted
  70  */
  71 void ssa_cons_finish(ir_graph *irg);
  72
  73 #endif