X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fir%2Firvrfy.h;h=4bacb198d4281fe7f16b9eeae00f606f15bd4326;hb=e5bab593a4048c0a320d7794fb2cb17697da8389;hp=f2a281b56717bf202d87cf7df8440f6986aff85d;hpb=e3e22fa6f927847099c0bff62457003aa81f2518;p=libfirm diff --git a/ir/ir/irvrfy.h b/ir/ir/irvrfy.h index f2a281b56..4bacb198d 100644 --- a/ir/ir/irvrfy.h +++ b/ir/ir/irvrfy.h @@ -1,12 +1,22 @@ -/* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe -** All rights reserved. -** -** Author: Christian Schaefer -** -** irgraph.h: ir graph verification -*/ +/* + * Project: libFIRM + * File name: ir/ir/irvrfy.h + * Purpose: Check irnodes for correctness. + * Author: Christian Schaefer + * Modified by: Goetz Lindenmaier. Till Riedel + * Created: + * CVS-ID: $Id$ + * Copyright: (c) 1998-2003 Universität Karlsruhe + * Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE. + */ -/* $Id$ */ +/** +* @file irvrfy.h +* +* ir graph verification. +* +* @author Christian Schaefer +*/ # ifndef _IRVRFY_H_ # define _IRVRFY_H_ @@ -14,11 +24,80 @@ # include "irnode.h" # include "irgraph.h" -/* Tests the types of predecessors of checknode. */ -void irn_vrfy (struct ir_node *checknode); +typedef enum _node_verification_t { + NODE_VERIFICATION_OFF = 0, /**< do not verify nodes at all */ + NODE_VERIFICATION_ON = 1, /**< do node verification and assert on error in debug version */ + NODE_VERIFICATION_REPORT = 2, /**< do node verification, but report to stderr only */ + NODE_VERIFICATION_ERROR_ONLY = 3 /**< do node verification, but NEVER do assert nor report */ +} node_verification_t; + +/** Select verification of nodes. + * + * Per default the verification is in mode NODE_VERIFICATION_ASSERT. + * Turn the verification off during development to check partial implementations. + */ +void do_node_verification(node_verification_t mode); + +/** + * Tests the modes of checknode and its predecessors. + * Checknode must be in current_ir_graph. + * + * \return + * NON-zero on success + */ +int irn_vrfy(struct ir_node *checknode); + +/** + * Tests the modes of checknode and its predecessors. + * Checknode must be in given ir_graph. + * + * \return + * NON-zero on success + */ +int irn_vrfy_irg(struct ir_node *checknode, ir_graph *irg); + +/** + * 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(struct ir_node *checknode, ir_graph *irg, const char **bad_string); + +/** + * Calls irn_vrfy for each node in irg. + * Graph must be in state "op_pin_state_pinned". + * + * \return + * NON-zero on success. + */ +int irg_vrfy(ir_graph *irg); + +/** + * 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. */ +}; -/* Calls irn_vrfy for each node in irg. */ -void irg_vrfy (ir_graph *irg); +/** + * Verify occurance 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_ */