nsz Git - libfirm/blob - ir/ana/callgraph.h

   1 /*
   2  * Project:     libFIRM
   3  * File name:   ir/ana/callgraph.h
   4  * Purpose:     Representation and computation of the callgraph.
   5  * Author:      Goetz Lindenmaier
   6  * Modified by:
   7  * Created:     21.7.2004
   8  * CVS-ID:      $Id$
   9  * Copyright:   (c) 2004 Universität Karlsruhe
  10  * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
  11  */
  12
  13 #ifndef _CALLGRAPH_H_
  14 #define _CALLGRAPH_H_
  15
  16 /**
  17  * @file callgraph.h
  18  *
  19  *  This file contains the representation of the callgraph.
  20  *  The nodes of the call graph are ir_graphs.  The edges between
  21  *  ghe nodes are calling relations.  I.e., if method a calls method
  22  *  b at some point, there is an edge between a and b.
  23  *
  24  *  Further this file contains an algorithm to construct the call
  25  *  graph.  The construction of the callgraph uses the callee
  26  *  information in Call nodes to determine which methods are called.
  27  *
  28  *  Finally this file contains an algorithm that computes backedges
  29  *  in the callgraph, i.e., the algorithm finds possibly recursive calls.
  30  *  The algorithm computes an upper bound of all recursive calls.
  31  *
  32  */
  33
  34 #include "irgraph.h"
  35
  36 /** Flag to indicate state of callgraph. */
  37 typedef enum {
  38   irp_callgraph_none,
  39   irp_callgraph_consistent,   /* calltree is inconsistent */
  40   irp_callgraph_inconsistent,
  41   irp_callgraph_and_calltree_consistent
  42 } irp_callgraph_state;
  43 irp_callgraph_state get_irp_callgraph_state(void);
  44 void                set_irp_callgraph_state(irp_callgraph_state s);
  45
  46 /** The functions that call irg. */
  47 int       get_irg_n_callers(ir_graph *irg);
  48 ir_graph *get_irg_caller(ir_graph *irg, int pos);
  49
  50 int       is_irg_caller_backedge(ir_graph *irg, int pos);
  51 int       has_irg_caller_backedge(ir_graph *irg);
  52
  53 /** maximal loop depth of call nodes that call along this edge. */
  54 int       get_irg_caller_loop_depth(ir_graph *irg, int pos);
  55
  56 /** The functions called by irg. */
  57 int       get_irg_n_callees(ir_graph *irg);
  58 ir_graph *get_irg_callee(ir_graph *irg, int pos);
  59
  60 int       is_irg_callee_backedge(ir_graph *irg, int pos);
  61 int       has_irg_callee_backedge(ir_graph *irg);
  62
  63 /** maximal loop depth of call nodes that call along this edge. */
  64 int       get_irg_callee_loop_depth(ir_graph *irg, int pos);
  65
  66 /** Maximal loop depth of all paths from an external visible method to
  67     this irg. */
  68 int       get_irg_loop_depth(ir_graph *irg);
  69 /** Maximal recursion depth of all paths from an external visible method to
  70     this irg. */
  71 int       get_irg_recursion_depth(ir_graph *irg);
  72
  73
  74 /** Construct and destruct the callgraph. */
  75 void compute_callgraph(void);
  76 void free_callgraph(void);
  77
  78
  79 /** A function type for fuctions passed to the callgraph walker. */
  80 typedef void callgraph_walk_func(ir_graph *g, void *env);
  81
  82 void callgraph_walk(callgraph_walk_func *pre, callgraph_walk_func *post, void *env);
  83
  84 /** Compute the backedges that represent recursions. */
  85 void find_callgraph_recursions(void);
  86
  87
  88 /** Computes the loop nesting information.
  89  *
  90  * Computes callee info and the callgraph if
  91  * this information is not available.
  92  */
  93 void analyse_loop_nesting_depth(void);
  94
  95
  96 #endif /* _CALLGRAPH_H_ */