comparison gcc/doc/optinfo.texi @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
comparison
equal deleted inserted replaced
111:04ced10e8804 131:84e7813d76e9
1 @c Copyright (C) 2013-2017 Free Software Foundation, Inc. 1 @c Copyright (C) 2013-2018 Free Software Foundation, Inc.
2 @c This is part of the GCC manual. 2 @c This is part of the GCC manual.
3 @c For copying conditions, see the file gcc.texi. 3 @c For copying conditions, see the file gcc.texi.
4 4
5 @cindex optimization dumps 5 @cindex optimization dumps
6 6
166 166
167 @end itemize 167 @end itemize
168 168
169 @example 169 @example
170 int report_flags = MSG_OPTIMIZED_LOCATIONS | TDF_RTL | TDF_DETAILS; 170 int report_flags = MSG_OPTIMIZED_LOCATIONS | TDF_RTL | TDF_DETAILS;
171 dump_printf_loc (report_flags, locus, 171 dump_printf_loc (report_flags, insn,
172 "loop turned into non-loop; it never loops.\n"); 172 "loop turned into non-loop; it never loops.\n");
173 @end example 173 @end example
174 174
175 @item dump_basic_block 175 @item dump_basic_block
176 Output basic block. 176 Output basic block.
179 @item dump_gimple_stmt 179 @item dump_gimple_stmt
180 Output gimple statement. 180 Output gimple statement.
181 181
182 Note that the above methods also have variants prefixed with 182 Note that the above methods also have variants prefixed with
183 @code{_loc}, such as @code{dump_printf_loc}, which are similar except 183 @code{_loc}, such as @code{dump_printf_loc}, which are similar except
184 they also output the source location information. 184 they also output the source location information. The @code{_loc} variants
185 take a @code{const dump_location_t &}. This class can be constructed from
186 a @code{gimple *} or from a @code{rtx_insn *}, and so callers can pass
187 a @code{gimple *} or a @code{rtx_insn *} as the @code{_loc} argument.
188 The @code{dump_location_t} constructor will extract the source location
189 from the statement or instruction, along with the profile count, and
190 the location in GCC's own source code (or the plugin) from which the dump
191 call was emitted. Only the source location is currently used.
192 There is also a @code{dump_user_location_t} class, capturing the
193 source location and profile count, but not the dump emission location,
194 so that locations in the user's code can be passed around. This
195 can also be constructed from a @code{gimple *} and from a @code{rtx_insn *},
196 and it too can be passed as the @code{_loc} argument.
185 197
186 @end ftable 198 @end ftable
187 199
188 @node Dump examples 200 @node Dump examples
189 @subsection Dump examples 201 @subsection Dump examples