X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fir%2Firvrfy.h;h=d073c88773aa9908e48f3e144cea799746df6e36;hb=eda9d668d0e8c8246015b4c5e743316a6a835a23;hp=a48abaea006ed6438ad7257fde0edebbb6ca502e;hpb=0471d79023aa0d40aee18ed0938331e1ca82d233;p=libfirm diff --git a/ir/ir/irvrfy.h b/ir/ir/irvrfy.h index a48abaea0..d073c8877 100644 --- a/ir/ir/irvrfy.h +++ b/ir/ir/irvrfy.h @@ -1,35 +1,106 @@ -/* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe -* All rights reserved. -*/ +/* + * Copyright (C) 1995-2007 University of Karlsruhe. All right reserved. + * + * This file is part of libFirm. + * + * This file may be distributed and/or modified under the terms of the + * GNU General Public License version 2 as published by the Free Software + * Foundation and appearing in the file LICENSE.GPL included in the + * packaging of this file. + * + * Licensees holding valid libFirm Professional Edition licenses may use + * this file in accordance with the libFirm Commercial License. + * Agreement provided with the Software. + * + * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE + * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE. + */ /** -* @file irvrfy.h -* -* ir graph verification. -* -* @author Christian Schaefer -*/ + * @file + * @brief Check irnodes for correctness. + * @author Christian Schaefer, Goetz Lindenmaier, Till Riedel + * @version $Id$ + */ +#ifndef FIRM_IR_IRVRFY_H +#define FIRM_IR_IRVRFY_H -/* $Id$ */ +#include "firm_types.h" -# ifndef _IRVRFY_H_ -# define _IRVRFY_H_ +/** + * Tests the modes of checknode and its predecessors. + * checknode must be in current_ir_graph. + * + * @return + * NON-zero on success + */ +int irn_vrfy(ir_node *checknode); -# include "irnode.h" -# include "irgraph.h" +/** + * Tests the modes of checknode and its predecessors. + * checknode must be in given ir_graph. + * + * @return + * NON-zero on success + */ +int irn_vrfy_irg(ir_node *checknode, ir_graph *irg); -/** Tests the modes of chechnode and its predecessors. - Checknode must be in current_ir_graph. */ -void irn_vrfy (struct ir_node *checknode); +/** + * Same as irn_vrfy_irg, but temporary sets verification mode to + * NODE_VERIFICATION_ERROR_ONLY. + * @return + * NON-zero on success + */ +int irn_vrfy_irg_dump(ir_node *checknode, ir_graph *irg, const char **bad_string); -/** Tests the modes of chechnode and its predecessors. - Checknode must be in given ir_graph. */ -void irn_vrfy_irg (struct ir_node *checknode, ir_graph *irg); +/** + * Flags for irg_verify(). + */ +typedef enum _irg_verify_flags_t { + VRFY_NORMAL = 0, /**< check SSA property only if dominance information is available */ + VRFY_ENFORCE_SSA = 1 /**< check SSA property by enforcing the dominance information recalculation */ +} irg_verify_flags_t; +/** + * Calls irn_vrfy() for each node in irg. + * Graph must be in state "op_pin_state_pinned". + * + * @return + * NON-zero on success. + */ +int irg_verify(ir_graph *irg, unsigned flags); -/** Calls irn_vrfy for each node in irg. - Graph must be in state "pinned".*/ -void irg_vrfy (ir_graph *irg); +/** + * Compatibility macro. Deprecated soon. + */ +#define irg_vrfy(irg) irg_verify(irg, 0) +/** + * Possible flags for irg_vrfy_bads(). + */ +enum verify_bad_flags_t { + BAD_CF = 1, /**< Bad nodes are allowed as predecessors of Blocks and Phis. */ + BAD_DF = 2, /**< Bad nodes are allowed as dataflow predecessors. */ + BAD_BLOCK = 4, /**< Bad nodes are allowed as Block input. */ + TUPLE = 8 /**< Tuple nodes are allowed. */ +}; + +/** + * Verify occurrence of bad nodes in a graph. + * + * @param irg The graph to verify + * @param flags combination of verify_bad_flags_t flags describing + * which Bads are allowed + * @returns a value combined of verify_bad_flags_t indicating the problems found. + */ +int irg_vrfy_bads(ir_graph *irg, int flags); + +/** + * Enable/disable verification of Load/Store nodes with + * its entities. If disabled, Store(SymConst(array)) will be allowed + * (C-frontend builds this :-) + */ +void vrfy_enable_entity_tests(int enable); -# endif /* _IRVRFY_H_ */ +#endif