gcc/tree-pass.h

   1 /* Definitions for describing one tree-ssa optimization pass.
   2    Copyright (C) 2004, 2005 Free Software Foundation, Inc.
   3    Contributed by Richard Henderson <rth@redhat.com>
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2, or (at your option)
  10 any later version.
  11
  12 GCC is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to
  19 the Free Software Foundation, 51 Franklin Street, Fifth Floor,
  20 Boston, MA 02110-1301, USA.  */
  21
  22
  23 #ifndef GCC_TREE_PASS_H
  24 #define GCC_TREE_PASS_H 1
  25
  26 /* In tree-dump.c */
  27
  28 /* Different tree dump places.  When you add new tree dump places,
  29    extend the DUMP_FILES array in tree-dump.c.  */
  30 enum tree_dump_index
  31 {
  32   TDI_none,                     /* No dump */
  33   TDI_tu,                       /* dump the whole translation unit.  */
  34   TDI_class,                    /* dump class hierarchy.  */
  35   TDI_original,                 /* dump each function before optimizing it */
  36   TDI_generic,                  /* dump each function after genericizing it */
  37   TDI_nested,                   /* dump each function after unnesting it */
  38   TDI_inlined,                  /* dump each function after inlining
  39                                    within it.  */
  40   TDI_vcg,                      /* create a VCG graph file for each
  41                                    function's flowgraph.  */
  42   TDI_tree_all,                 /* enable all the GENERIC/GIMPLE dumps.  */
  43   TDI_rtl_all,                  /* enable all the RTL dumps.  */
  44   TDI_ipa_all,                  /* enable all the IPA dumps.  */
  45
  46   TDI_cgraph,                   /* dump function call graph.  */
  47   TDI_end
  48 };
  49
  50 /* Bit masks to control dumping. Not all values are applicable to
  51    all dumps. Add new ones at the end. When you define new
  52    values, extend the DUMP_OPTIONS array in tree-dump.c */
  53 #define TDF_ADDRESS     (1 << 0)        /* dump node addresses */
  54 #define TDF_SLIM        (1 << 1)        /* don't go wild following links */
  55 #define TDF_RAW         (1 << 2)        /* don't unparse the function */
  56 #define TDF_DETAILS     (1 << 3)        /* show more detailed info about
  57                                            each pass */
  58 #define TDF_STATS       (1 << 4)        /* dump various statistics about
  59                                            each pass */
  60 #define TDF_BLOCKS      (1 << 5)        /* display basic block boundaries */
  61 #define TDF_VOPS        (1 << 6)        /* display virtual operands */
  62 #define TDF_LINENO      (1 << 7)        /* display statement line numbers */
  63 #define TDF_UID         (1 << 8)        /* display decl UIDs */
  64
  65 #define TDF_TREE        (1 << 9)        /* is a tree dump */
  66 #define TDF_RTL         (1 << 10)       /* is a RTL dump */
  67 #define TDF_IPA         (1 << 11)       /* is an IPA dump */
  68 #define TDF_STMTADDR    (1 << 12)       /* Address of stmt.  */
  69
  70 #define TDF_GRAPH       (1 << 13)       /* a graph dump is being emitted */
  71
  72 extern char *get_dump_file_name (enum tree_dump_index);
  73 extern int dump_enabled_p (enum tree_dump_index);
  74 extern int dump_initialized_p (enum tree_dump_index);
  75 extern FILE *dump_begin (enum tree_dump_index, int *);
  76 extern void dump_end (enum tree_dump_index, FILE *);
  77 extern void dump_node (tree, int, FILE *);
  78 extern int dump_switch_p (const char *);
  79 extern const char *dump_flag_name (enum tree_dump_index);
  80
  81 /* Global variables used to communicate with passes.  */
  82 extern FILE *dump_file;
  83 extern int dump_flags;
  84 extern const char *dump_file_name;
  85
  86 /* Return the dump_file_info for the given phase.  */
  87 extern struct dump_file_info *get_dump_file_info (enum tree_dump_index);
  88
  89 /* Describe one pass.  */
  90 struct tree_opt_pass
  91 {
  92   /* Terse name of the pass used as a fragment of the dump file name.  */
  93   const char *name;
  94
  95   /* If non-null, this pass and all sub-passes are executed only if
  96      the function returns true.  */
  97   bool (*gate) (void);
  98
  99   /* This is the code to run.  If null, then there should be sub-passes
 100      otherwise this pass does nothing.  */
 101   void (*execute) (void);
 102
 103   /* A list of sub-passes to run, dependent on gate predicate.  */
 104   struct tree_opt_pass *sub;
 105
 106   /* Next in the list of passes to run, independent of gate predicate.  */
 107   struct tree_opt_pass *next;
 108
 109   /* Static pass number, used as a fragment of the dump file name.  */
 110   int static_pass_number;
 111
 112   /* The timevar id associated with this pass.  */
 113   /* ??? Ideally would be dynamically assigned.  */
 114   unsigned int tv_id;
 115
 116   /* Sets of properties input and output from this pass.  */
 117   unsigned int properties_required;
 118   unsigned int properties_provided;
 119   unsigned int properties_destroyed;
 120
 121   /* Flags indicating common sets things to do before and after.  */
 122   unsigned int todo_flags_start;
 123   unsigned int todo_flags_finish;
 124
 125   /* Letter for RTL dumps.  */
 126   char letter;
 127 };
 128
 129 /* Define a tree dump switch.  */
 130 struct dump_file_info
 131 {
 132   const char *suffix;           /* suffix to give output file.  */
 133   const char *swtch;            /* command line switch */
 134   const char *glob;             /* command line glob  */
 135   int flags;                    /* user flags */
 136   int state;                    /* state of play */
 137   int num;                      /* dump file number */
 138   int letter;                   /* enabling letter for RTL dumps */
 139 };
 140
 141 /* Pass properties.  */
 142 #define PROP_gimple_any         (1 << 0)        /* entire gimple grammar */
 143 #define PROP_gimple_lcf         (1 << 1)        /* lowered control flow */
 144 #define PROP_gimple_leh         (1 << 2)        /* lowered eh */
 145 #define PROP_cfg                (1 << 3)
 146 #define PROP_referenced_vars    (1 << 4)
 147 #define PROP_pta                (1 << 5)
 148 #define PROP_ssa                (1 << 6)
 149 #define PROP_no_crit_edges      (1 << 7)
 150 #define PROP_rtl                (1 << 8)
 151 #define PROP_alias              (1 << 9)
 152
 153 #define PROP_trees \
 154   (PROP_gimple_any | PROP_gimple_lcf | PROP_gimple_leh)
 155
 156 /* To-do flags.  */
 157 #define TODO_dump_func                  (1 << 0)
 158 #define TODO_ggc_collect                (1 << 1)
 159 #define TODO_verify_ssa                 (1 << 2)
 160 #define TODO_verify_flow                (1 << 3)
 161 #define TODO_verify_stmts               (1 << 4)
 162 #define TODO_cleanup_cfg                (1 << 5)
 163 #define TODO_verify_loops               (1 << 6)
 164 #define TODO_dump_cgraph                (1 << 7)
 165
 166 /* To-do flags for calls to update_ssa.  */
 167
 168 /* Update the SSA form inserting PHI nodes for newly exposed symbols
 169    and virtual names marked for updating.  When updating real names,
 170    only insert PHI nodes for a real name O_j in blocks reached by all
 171    the new and old definitions for O_j.  If the iterated dominance
 172    frontier for O_j is not pruned, we may end up inserting PHI nodes
 173    in blocks that have one or more edges with no incoming definition
 174    for O_j.  This would lead to uninitialized warnings for O_j's
 175    symbol.  */
 176 #define TODO_update_ssa                 (1 << 7)
 177
 178 /* Update the SSA form without inserting any new PHI nodes at all.
 179    This is used by passes that have either inserted all the PHI nodes
 180    themselves or passes that need only to patch use-def and def-def
 181    chains for virtuals (e.g., DCE).  */
 182 #define TODO_update_ssa_no_phi          (1 << 8)
 183
 184 /* Insert PHI nodes everywhere they are needed.  No pruning of the
 185    IDF is done.  This is used by passes that need the PHI nodes for
 186    O_j even if it means that some arguments will come from the default
 187    definition of O_j's symbol (e.g., pass_linear_transform).
 188
 189    WARNING: If you need to use this flag, chances are that your pass
 190    may be doing something wrong.  Inserting PHI nodes for an old name
 191    where not all edges carry a new replacement may lead to silent
 192    codegen errors or spurious uninitialized warnings.  */
 193 #define TODO_update_ssa_full_phi        (1 << 9)
 194
 195 /* Passes that update the SSA form on their own may want to delegate
 196    the updating of virtual names to the generic updater.  Since FUD
 197    chains are easier to maintain, this simplifies the work they need
 198    to do.  NOTE: If this flag is used, any OLD->NEW mappings for real
 199    names are explicitly destroyed and only the symbols marked for
 200    renaming are processed.  */
 201 #define TODO_update_ssa_only_virtuals   (1 << 10)
 202
 203 #define TODO_update_ssa_any             \
 204     (TODO_update_ssa                    \
 205      | TODO_update_ssa_no_phi           \
 206      | TODO_update_ssa_full_phi         \
 207      | TODO_update_ssa_only_virtuals)
 208
 209 #define TODO_verify_all \
 210   (TODO_verify_ssa | TODO_verify_flow | TODO_verify_stmts)
 211
 212 extern void tree_lowering_passes (tree decl);
 213
 214 extern struct tree_opt_pass pass_mudflap_1;
 215 extern struct tree_opt_pass pass_mudflap_2;
 216 extern struct tree_opt_pass pass_remove_useless_stmts;
 217 extern struct tree_opt_pass pass_lower_cf;
 218 extern struct tree_opt_pass pass_lower_eh;
 219 extern struct tree_opt_pass pass_build_cfg;
 220 extern struct tree_opt_pass pass_tree_profile;
 221 extern struct tree_opt_pass pass_early_tree_profile;
 222 extern struct tree_opt_pass pass_cleanup_cfg;
 223 extern struct tree_opt_pass pass_referenced_vars;
 224 extern struct tree_opt_pass pass_sra;
 225 extern struct tree_opt_pass pass_tail_recursion;
 226 extern struct tree_opt_pass pass_tail_calls;
 227 extern struct tree_opt_pass pass_tree_loop;
 228 extern struct tree_opt_pass pass_tree_loop_init;
 229 extern struct tree_opt_pass pass_lim;
 230 extern struct tree_opt_pass pass_tree_unswitch;
 231 extern struct tree_opt_pass pass_iv_canon;
 232 extern struct tree_opt_pass pass_scev_cprop;
 233 extern struct tree_opt_pass pass_empty_loop;
 234 extern struct tree_opt_pass pass_record_bounds;
 235 extern struct tree_opt_pass pass_if_conversion;
 236 extern struct tree_opt_pass pass_vectorize;
 237 extern struct tree_opt_pass pass_complete_unroll;
 238 extern struct tree_opt_pass pass_iv_optimize;
 239 extern struct tree_opt_pass pass_tree_loop_done;
 240 extern struct tree_opt_pass pass_ch;
 241 extern struct tree_opt_pass pass_ccp;
 242 extern struct tree_opt_pass pass_build_ssa;
 243 extern struct tree_opt_pass pass_del_ssa;
 244 extern struct tree_opt_pass pass_dominator;
 245 extern struct tree_opt_pass pass_dce;
 246 extern struct tree_opt_pass pass_dce_loop;
 247 extern struct tree_opt_pass pass_cd_dce;
 248 extern struct tree_opt_pass pass_merge_phi;
 249 extern struct tree_opt_pass pass_may_alias;
 250 extern struct tree_opt_pass pass_split_crit_edges;
 251 extern struct tree_opt_pass pass_pre;
 252 extern struct tree_opt_pass pass_profile;
 253 extern struct tree_opt_pass pass_lower_complex_O0;
 254 extern struct tree_opt_pass pass_lower_complex;
 255 extern struct tree_opt_pass pass_lower_vector;
 256 extern struct tree_opt_pass pass_lower_vector_ssa;
 257 extern struct tree_opt_pass pass_object_sizes;
 258 extern struct tree_opt_pass pass_fold_builtins;
 259 extern struct tree_opt_pass pass_stdarg;
 260 extern struct tree_opt_pass pass_early_warn_uninitialized;
 261 extern struct tree_opt_pass pass_late_warn_uninitialized;
 262 extern struct tree_opt_pass pass_cse_reciprocals;
 263 extern struct tree_opt_pass pass_warn_function_return;
 264 extern struct tree_opt_pass pass_warn_function_noreturn;
 265 extern struct tree_opt_pass pass_phiopt;
 266 extern struct tree_opt_pass pass_forwprop;
 267 extern struct tree_opt_pass pass_redundant_phi;
 268 extern struct tree_opt_pass pass_dse;
 269 extern struct tree_opt_pass pass_nrv;
 270 extern struct tree_opt_pass pass_remove_useless_vars;
 271 extern struct tree_opt_pass pass_mark_used_blocks;
 272 extern struct tree_opt_pass pass_rename_ssa_copies;
 273 extern struct tree_opt_pass pass_expand;
 274 extern struct tree_opt_pass pass_rest_of_compilation;
 275 extern struct tree_opt_pass pass_sink_code;
 276 extern struct tree_opt_pass pass_fre;
 277 extern struct tree_opt_pass pass_linear_transform;
 278 extern struct tree_opt_pass pass_copy_prop;
 279 extern struct tree_opt_pass pass_phi_only_copy_prop;
 280 extern struct tree_opt_pass pass_store_ccp;
 281 extern struct tree_opt_pass pass_store_copy_prop;
 282 extern struct tree_opt_pass pass_vrp;
 283 extern struct tree_opt_pass pass_create_structure_vars;
 284 extern struct tree_opt_pass pass_uncprop;
 285 extern struct tree_opt_pass pass_return_slot;
 286 extern struct tree_opt_pass pass_reassoc;
 287 extern struct tree_opt_pass pass_rebuild_cgraph_edges;
 288 extern struct tree_opt_pass pass_eliminate_useless_stores;
 289
 290 /* IPA Passes */
 291 extern struct tree_opt_pass pass_ipa_cp;
 292 extern struct tree_opt_pass pass_ipa_inline;
 293 extern struct tree_opt_pass pass_early_ipa_inline;
 294 extern struct tree_opt_pass pass_ipa_reference;
 295 extern struct tree_opt_pass pass_ipa_pure_const;
 296 extern struct tree_opt_pass pass_ipa_type_escape;
 297 extern struct tree_opt_pass pass_ipa_pta;
 298 extern struct tree_opt_pass pass_early_local_passes;
 299
 300 extern struct tree_opt_pass pass_all_optimizations;
 301 extern struct tree_opt_pass pass_cleanup_cfg_post_optimizing;
 302 extern struct tree_opt_pass pass_free_cfg_annotations;
 303 extern struct tree_opt_pass pass_free_datastructures;
 304 extern struct tree_opt_pass pass_init_datastructures;
 305 extern struct tree_opt_pass pass_fixup_cfg;
 306
 307 extern struct tree_opt_pass pass_remove_unnecessary_notes;
 308 extern struct tree_opt_pass pass_init_function;
 309 extern struct tree_opt_pass pass_jump;
 310 extern struct tree_opt_pass pass_insn_locators_initialize;
 311 extern struct tree_opt_pass pass_rtl_eh;
 312 extern struct tree_opt_pass pass_initial_value_sets;
 313 extern struct tree_opt_pass pass_unshare_all_rtl;
 314 extern struct tree_opt_pass pass_instantiate_virtual_regs;
 315 extern struct tree_opt_pass pass_jump2;
 316 extern struct tree_opt_pass pass_cse;
 317 extern struct tree_opt_pass pass_gcse;
 318 extern struct tree_opt_pass pass_loop_optimize;
 319 extern struct tree_opt_pass pass_jump_bypass;
 320 extern struct tree_opt_pass pass_cfg;
 321 extern struct tree_opt_pass pass_profiling;
 322 extern struct tree_opt_pass pass_rtl_ifcvt;
 323 extern struct tree_opt_pass pass_tracer;
 324
 325 extern struct tree_opt_pass pass_loop2;
 326 extern struct tree_opt_pass pass_rtl_loop_init;
 327 extern struct tree_opt_pass pass_rtl_move_loop_invariants;
 328 extern struct tree_opt_pass pass_rtl_unswitch;
 329 extern struct tree_opt_pass pass_rtl_unroll_and_peel_loops;
 330 extern struct tree_opt_pass pass_rtl_doloop;
 331 extern struct tree_opt_pass pass_rtl_loop_done;
 332
 333 extern struct tree_opt_pass pass_web;
 334 extern struct tree_opt_pass pass_cse2;
 335 extern struct tree_opt_pass pass_life;
 336 extern struct tree_opt_pass pass_combine;
 337 extern struct tree_opt_pass pass_if_after_combine;
 338 extern struct tree_opt_pass pass_partition_blocks;
 339 extern struct tree_opt_pass pass_partition_blocks;
 340 extern struct tree_opt_pass pass_regmove;
 341 extern struct tree_opt_pass pass_split_all_insns;
 342 extern struct tree_opt_pass pass_mode_switching;
 343 extern struct tree_opt_pass pass_recompute_reg_usage;
 344 extern struct tree_opt_pass pass_sms;
 345 extern struct tree_opt_pass pass_sched;
 346 extern struct tree_opt_pass pass_local_alloc;
 347 extern struct tree_opt_pass pass_global_alloc;
 348 extern struct tree_opt_pass pass_postreload;
 349 extern struct tree_opt_pass pass_clean_state;
 350 extern struct tree_opt_pass pass_branch_prob;
 351 extern struct tree_opt_pass pass_value_profile_transformations;
 352 extern struct tree_opt_pass pass_remove_death_notes;
 353 extern struct tree_opt_pass pass_postreload_cse;
 354 extern struct tree_opt_pass pass_gcse2;
 355 extern struct tree_opt_pass pass_flow2;
 356 extern struct tree_opt_pass pass_stack_adjustments;
 357 extern struct tree_opt_pass pass_peephole2;
 358 extern struct tree_opt_pass pass_if_after_reload;
 359 extern struct tree_opt_pass pass_regrename;
 360 extern struct tree_opt_pass pass_reorder_blocks;
 361 extern struct tree_opt_pass pass_branch_target_load_optimize;
 362 extern struct tree_opt_pass pass_leaf_regs;
 363 extern struct tree_opt_pass pass_sched2;
 364 extern struct tree_opt_pass pass_stack_regs;
 365 extern struct tree_opt_pass pass_compute_alignments;
 366 extern struct tree_opt_pass pass_duplicate_computed_gotos;
 367 extern struct tree_opt_pass pass_variable_tracking;
 368 extern struct tree_opt_pass pass_free_cfg;
 369 extern struct tree_opt_pass pass_machine_reorg;
 370 extern struct tree_opt_pass pass_purge_lineno_notes;
 371 extern struct tree_opt_pass pass_cleanup_barriers;
 372 extern struct tree_opt_pass pass_delay_slots;
 373 extern struct tree_opt_pass pass_split_for_shorten_branches;
 374 extern struct tree_opt_pass pass_split_before_regstack;
 375 extern struct tree_opt_pass pass_convert_to_eh_region_ranges;
 376 extern struct tree_opt_pass pass_shorten_branches;
 377 extern struct tree_opt_pass pass_set_nothrow_function_flags;
 378 extern struct tree_opt_pass pass_final;
 379
 380 /* The root of the compilation pass tree, once constructed.  */
 381 extern struct tree_opt_pass *all_passes, *all_ipa_passes, *all_lowering_passes;
 382
 383 extern void execute_pass_list (struct tree_opt_pass *);
 384 extern void execute_ipa_pass_list (struct tree_opt_pass *);
 385
 386 #endif /* GCC_TREE_PASS_H */