gcc/value-prof.h

   1 /* Definitions for transformations based on profile information for values.
   2    Copyright (C) 2003, 2004, 2005, 2007, 2008, 2010
   3    Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 3, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING3.  If not see
  19 <http://www.gnu.org/licenses/>.  */
  20
  21 #ifndef GCC_VALUE_PROF_H
  22 #define GCC_VALUE_PROF_H
  23
  24 /* Supported histogram types.  */
  25 enum hist_type
  26 {
  27   HIST_TYPE_INTERVAL,   /* Measures histogram of values inside a specified
  28                            interval.  */
  29   HIST_TYPE_POW2,       /* Histogram of power of 2 values.  */
  30   HIST_TYPE_SINGLE_VALUE, /* Tries to identify the value that is (almost)
  31                            always constant.  */
  32   HIST_TYPE_CONST_DELTA, /* Tries to identify the (almost) always constant
  33                            difference between two evaluations of a value.  */
  34   HIST_TYPE_INDIR_CALL,   /* Tries to identify the function that is (almost)
  35                             called in indirect call */
  36   HIST_TYPE_AVERAGE,    /* Compute average value (sum of all values).  */
  37   HIST_TYPE_IOR         /* Used to compute expected alignment.  */
  38 };
  39
  40 #define COUNTER_FOR_HIST_TYPE(TYPE) ((int) (TYPE) + GCOV_FIRST_VALUE_COUNTER)
  41 #define HIST_TYPE_FOR_COUNTER(COUNTER) \
  42   ((enum hist_type) ((COUNTER) - GCOV_FIRST_VALUE_COUNTER))
  43
  44 \f
  45 /* The value to measure.  */
  46 struct histogram_value_t
  47 {
  48   struct
  49     {
  50       tree value;               /* The value to profile.  */
  51       gimple stmt;              /* Insn containing the value.  */
  52       gcov_type *counters;                      /* Pointer to first counter.  */
  53       struct histogram_value_t *next;           /* Linked list pointer.  */
  54     } hvalue;
  55   enum hist_type type;                  /* Type of information to measure.  */
  56   unsigned n_counters;                  /* Number of required counters.  */
  57   union
  58     {
  59       struct
  60         {
  61           int int_start;        /* First value in interval.  */
  62           unsigned int steps;   /* Number of values in it.  */
  63         } intvl;        /* Interval histogram data.  */
  64     } hdata;            /* Profiled information specific data.  */
  65 };
  66
  67 typedef struct histogram_value_t *histogram_value;
  68 typedef const struct histogram_value_t *const_histogram_value;
  69
  70
  71 typedef vec<histogram_value> histogram_values;
  72
  73 extern void gimple_find_values_to_profile (histogram_values *);
  74 extern bool gimple_value_profile_transformations (void);
  75
  76 histogram_value gimple_histogram_value (struct function *, gimple);
  77 histogram_value gimple_histogram_value_of_type (struct function *, gimple,
  78                                                 enum hist_type);
  79 void gimple_add_histogram_value (struct function *, gimple, histogram_value);
  80 void dump_histograms_for_stmt (struct function *, FILE *, gimple);
  81 void gimple_remove_histogram_value (struct function *, gimple, histogram_value);
  82 void gimple_remove_stmt_histograms (struct function *, gimple);
  83 void gimple_duplicate_stmt_histograms (struct function *, gimple,
  84                                        struct function *, gimple);
  85 void gimple_move_stmt_histograms (struct function *, gimple, gimple);
  86 void verify_histograms (void);
  87 void free_histograms (void);
  88 void stringop_block_profile (gimple, unsigned int *, HOST_WIDE_INT *);
  89
  90 /* In tree-profile.c.  */
  91 extern void gimple_init_edge_profiler (void);
  92 extern void gimple_gen_edge_profiler (int, edge);
  93 extern void gimple_gen_interval_profiler (histogram_value, unsigned, unsigned);
  94 extern void gimple_gen_pow2_profiler (histogram_value, unsigned, unsigned);
  95 extern void gimple_gen_one_value_profiler (histogram_value, unsigned, unsigned);
  96 extern void gimple_gen_ic_profiler (histogram_value, unsigned, unsigned);
  97 extern void gimple_gen_ic_func_profiler (void);
  98 extern void gimple_gen_const_delta_profiler (histogram_value,
  99                                              unsigned, unsigned);
 100 extern void gimple_gen_average_profiler (histogram_value, unsigned, unsigned);
 101 extern void gimple_gen_ior_profiler (histogram_value, unsigned, unsigned);
 102
 103 /* In profile.c.  */
 104 extern void init_branch_prob (void);
 105 extern void branch_prob (void);
 106 extern void end_branch_prob (void);
 107
 108 #endif  /* GCC_VALUE_PROF_H */
 109