gccint: Dump types

1 
1 9.6.5 Dump types
1 ----------------
1 
1 'dump_printf'
1 
1      This is a generic method for doing formatted output.  It takes an
1      additional argument 'dump_kind' which signifies the type of dump.
1      This method outputs information only when the dumps are enabled for
1      this particular 'dump_kind'.  Note that the caller doesn't need to
1      know if the particular dump is enabled or not, or even the file
1      name.  The caller only needs to decide which dump output
1      information is relevant, and under what conditions.  This
1      determines the associated flags.
1 
1      Consider the following example from 'loop-unroll.c' where an
1      informative message about a loop (along with its location) is
1      printed when any of the following flags is enabled
1 
1         - optimization messages
1         - RTL dumps
1         - detailed dumps
1 
1           int report_flags = MSG_OPTIMIZED_LOCATIONS | TDF_RTL | TDF_DETAILS;
1           dump_printf_loc (report_flags, locus,
1                            "loop turned into non-loop; it never loops.\n");
1 
1 'dump_basic_block'
1      Output basic block.
1 'dump_generic_expr'
1      Output generic expression.
1 'dump_gimple_stmt'
1      Output gimple statement.
1 
1      Note that the above methods also have variants prefixed with
1      '_loc', such as 'dump_printf_loc', which are similar except they
1      also output the source location information.
1