gen_docu: fix missing attributes, show generation time at the end
[libfirm] / ir / ana / irlivechk.h
index fc22e66..750dd0c 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 1995-2007 University of Karlsruhe.  All right reserved.
+ * Copyright (C) 1995-2007 Inria Rhone-Alpes.  All right reserved.
  *
  * This file is part of libFirm.
  *
  * @file    irlivechk.h
  * @author  Sebastian Hack
  * @date    22.04.2007
- * @version $Id$
- * @summary
+ * @brief
  *
  * Live in/end checks whose only precomputation concerns the structure of the CFG.
  * Hence, nothing has to be updated if the program is modified unless the CFG is touched.
  * See .c file for more comments.
  */
+
 #ifndef FIRM_ANA_IRLIVECHK_H
 #define FIRM_ANA_IRLIVECHK_H
 
 #include "irgraph.h"
 #include "irnode.h"
+#include "dfs.h"
+
+typedef enum {
+       lv_chk_state_in  = 1,
+       lv_chk_state_end = 2,
+       lv_chk_state_out = 4,
+       lv_chk_state_through = lv_chk_state_in | lv_chk_state_out | lv_chk_state_end,
+} lv_chk_state_t;
 
-typedef struct _lv_chk_t lv_chk_t;
+typedef struct lv_chk_t lv_chk_t;
 
 /**
  * Make a new liveness check environment.
  * @param irg The graph.
+ * @param dfs A forward DFS on CFG of the given irg.
  * @return    The environment.
  */
-extern lv_chk_t *lv_chk_new(ir_graph *irg);
+extern lv_chk_t *lv_chk_new(ir_graph *irg, const dfs_t *dfs);
 
 /**
  * Free liveness check information.
@@ -49,31 +58,18 @@ extern lv_chk_t *lv_chk_new(ir_graph *irg);
  */
 extern void lv_chk_free(lv_chk_t *lv);
 
-/**
- * Check, if a node is live end of a given block.
- * @param lv   The liveness environment.
- * @param bl   The block to investigate.
- * @param irn  The node to check for.
- * @return     1, if @p what is live end at @p bl, 0 else.
- */
-extern int lv_chk_bl_end(const lv_chk_t *lv, const ir_node *bl, const ir_node *irn);
 
 /**
- * Check, if a node is live out of a given block.
+ * Return liveness information for a node concerning a block.
  * @param lv   The liveness environment.
  * @param bl   The block to investigate.
  * @param irn  The node to check for.
- * @return     1, if @p what is live out at @p bl, 0 else.
+ * @return     A bitmask of <code>lv_chk_state_t</code>.
  */
-extern int lv_chk_bl_out(const lv_chk_t *lv, const ir_node *bl, const ir_node *irn);
+extern unsigned lv_chk_bl_xxx(lv_chk_t *lv, const ir_node *bl, const ir_node *irn);
 
-/**
- * Check, if a node is live in of a given block.
- * @param lv   The liveness environment.
- * @param bl   The block to investigate.
- * @param irn  The node to check for.
- * @return     1, if @p what is live in at @p bl, 0 else.
- */
-extern int lv_chk_bl_in(const lv_chk_t *lv, const ir_node *bl, const ir_node *irn);
+#define lv_chk_bl_in(lv, bl, irn)  ((lv_chk_bl_xxx((lv), (bl), (irn)) & lv_chk_state_in)  != 0)
+#define lv_chk_bl_end(lv, bl, irn) ((lv_chk_bl_xxx((lv), (bl), (irn)) & lv_chk_state_end) != 0)
+#define lv_chk_bl_out(lv, bl, irn) ((lv_chk_bl_xxx((lv), (bl), (irn)) & lv_chk_state_out) != 0)
 
 #endif /* FIRM_ANA_IRLIVECHK_H */