tail recursion flag added

[libfirm] / ir / ir / irvrfy.h

diff --git a/ir/ir/irvrfy.h b/ir/ir/irvrfy.h
index 7693813..68d4a13 100644 (file)
--- a/ir/ir/irvrfy.h
+++ b/ir/ir/irvrfy.h
@@ -1,6 +1,14 @@
-/* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe
-* All rights reserved.
-*/
+/*
+ * 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.
+ */
 
 /**
 * @file irvrfy.h
@@ -10,21 +18,59 @@
 * @author Christian Schaefer
 */
 
-/* $Id$ */
-
 # ifndef _IRVRFY_H_
 # define _IRVRFY_H_
 
 # include "irnode.h"
 # include "irgraph.h"
 
-/** Tests the modes of chechnode and its predecessors.
-   Checknode must be in current_ir_graph. */
-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;
 
-/** Calls irn_vrfy for each node in irg.
-   Graph must be in state "pinned".*/
-void irg_vrfy (ir_graph *irg);
+/** 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 "pinned".
+ *
+ * \return
+ *     NON-zero on success.
+ */
+int irg_vrfy(ir_graph *irg);
 
 # endif /* _IRVRFY_H_ */