]>
Commit | Line | Data |
---|---|---|
1322177d | 1 | /* Compilation switch flag definitions for GCC. |
e295f317 | 2 | Copyright (C) 1987, 1988, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2002, |
6a4d4e8a | 3 | 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 |
06ceef4e | 4 | Free Software Foundation, Inc. |
f7a29665 | 5 | |
1322177d | 6 | This file is part of GCC. |
f7a29665 | 7 | |
1322177d LB |
8 | GCC is free software; you can redistribute it and/or modify it under |
9 | the terms of the GNU General Public License as published by the Free | |
9dcd6f09 | 10 | Software Foundation; either version 3, or (at your option) any later |
1322177d | 11 | version. |
f7a29665 | 12 | |
1322177d LB |
13 | GCC is distributed in the hope that it will be useful, but WITHOUT ANY |
14 | WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
15 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
16 | for more details. | |
f7a29665 RS |
17 | |
18 | You should have received a copy of the GNU General Public License | |
9dcd6f09 NC |
19 | along with GCC; see the file COPYING3. If not see |
20 | <http://www.gnu.org/licenses/>. */ | |
f7a29665 | 21 | |
0e5921e8 ZW |
22 | #ifndef GCC_FLAGS_H |
23 | #define GCC_FLAGS_H | |
24 | ||
39ef6592 | 25 | #include "coretypes.h" |
50431bc4 ZD |
26 | #include "options.h" |
27 | ||
f7a29665 RS |
28 | enum debug_info_type |
29 | { | |
30 | NO_DEBUG, /* Write no debug info. */ | |
31 | DBX_DEBUG, /* Write BSD .stabs for DBX (using dbxout.c). */ | |
32 | SDB_DEBUG, /* Write COFF for (old) SDB (using sdbout.c). */ | |
9a666dda | 33 | DWARF2_DEBUG, /* Write Dwarf v2 debug info (using dwarf2out.c). */ |
7a0c8d71 | 34 | XCOFF_DEBUG, /* Write IBM/Xcoff debug info (using dbxout.c). */ |
23d1aac4 | 35 | VMS_DEBUG, /* Write VMS debug info (using vmsdbgout.c). */ |
7a0c8d71 | 36 | VMS_AND_DWARF2_DEBUG /* Write VMS debug info (using vmsdbgout.c). |
23d1aac4 | 37 | and DWARF v2 debug info (using dwarf2out.c). */ |
f7a29665 RS |
38 | }; |
39 | ||
40 | /* Specify which kind of debugging info to generate. */ | |
41 | extern enum debug_info_type write_symbols; | |
42 | ||
df026186 GK |
43 | /* Names of debug_info_type, for error messages. */ |
44 | extern const char *const debug_type_names[]; | |
45 | ||
f7a29665 RS |
46 | enum debug_info_level |
47 | { | |
48 | DINFO_LEVEL_NONE, /* Write no debugging info. */ | |
49 | DINFO_LEVEL_TERSE, /* Write minimal info to support tracebacks only. */ | |
eebedaa5 | 50 | DINFO_LEVEL_NORMAL, /* Write info for all declarations (and line table). */ |
f7a29665 RS |
51 | DINFO_LEVEL_VERBOSE /* Write normal info plus #define/#undef info. */ |
52 | }; | |
53 | ||
54 | /* Specify how much debugging info to generate. */ | |
55 | extern enum debug_info_level debug_info_level; | |
56 | ||
39ef6592 LC |
57 | /* A major contribution to object and executable size is debug |
58 | information size. A major contribution to debug information | |
59 | size is struct descriptions replicated in several object files. | |
60 | The following function determines whether or not debug information | |
61 | should be generated for a given struct. The indirect parameter | |
62 | indicates that the struct is being handled indirectly, via | |
63 | a pointer. See opts.c for the implementation. */ | |
64 | ||
65 | enum debug_info_usage | |
66 | { | |
67 | DINFO_USAGE_DFN, /* A struct definition. */ | |
68 | DINFO_USAGE_DIR_USE, /* A direct use, such as the type of a variable. */ | |
69 | DINFO_USAGE_IND_USE, /* An indirect use, such as through a pointer. */ | |
70 | DINFO_USAGE_NUM_ENUMS /* The number of enumerators. */ | |
71 | }; | |
72 | ||
73 | extern bool should_emit_struct_debug (tree type_decl, enum debug_info_usage); | |
74 | extern void set_struct_debug_option (const char *value); | |
75 | ||
79604d8f CH |
76 | /* Nonzero means use GNU-only extensions in the generated symbolic |
77 | debugging information. */ | |
df38ffef | 78 | extern bool use_gnu_debug_info_extensions; |
f7a29665 | 79 | |
e3339d0f JM |
80 | /* Run the second compilation of -fcompare-debug. Not defined using |
81 | Var in common.opt because this is used in Ada code and so must be | |
82 | an actual variable not a macro. */ | |
83 | extern int flag_compare_debug; | |
84 | ||
b9e75696 JM |
85 | /* Enumerate visibility settings. This is deliberately ordered from most |
86 | to least visibility. */ | |
d7afec4b ND |
87 | #ifndef SYMBOL_VISIBILITY_DEFINED |
88 | #define SYMBOL_VISIBILITY_DEFINED | |
89 | enum symbol_visibility | |
90 | { | |
91 | VISIBILITY_DEFAULT, | |
b9e75696 | 92 | VISIBILITY_PROTECTED, |
d7afec4b | 93 | VISIBILITY_HIDDEN, |
b9e75696 | 94 | VISIBILITY_INTERNAL |
d7afec4b ND |
95 | }; |
96 | #endif | |
97 | ||
98 | /* The default visibility for all symbols (unless overridden). */ | |
99 | extern enum symbol_visibility default_visibility; | |
100 | ||
101 | struct visibility_flags | |
102 | { | |
103 | unsigned inpragma : 1; /* True when in #pragma GCC visibility. */ | |
104 | unsigned inlines_hidden : 1; /* True when -finlineshidden in effect. */ | |
105 | }; | |
106 | ||
107 | /* Global visibility options. */ | |
108 | extern struct visibility_flags visibility_options; | |
109 | ||
d7f09764 DN |
110 | /* True if this is the LTO front end (lto1). This is used to disable |
111 | gimple generation and lowering passes that are normally run on the | |
112 | output of a front end. These passes must be bypassed for lto since | |
b8698a0f | 113 | they have already been done before the gimple was written. */ |
d7f09764 DN |
114 | |
115 | extern bool in_lto_p; | |
116 | ||
117 | /* Nonzero if we should write GIMPLE bytecode for link-time optimization. */ | |
118 | ||
119 | extern int flag_generate_lto; | |
120 | ||
b8698a0f | 121 | /* Used to set the level of -Wstrict-aliasing, when no level is specified. |
79bedddc | 122 | The external way to set the default level is to use |
b8698a0f | 123 | -Wstrict-aliasing=level. |
79bedddc SR |
124 | ONOFF is assumed to take value 1 when -Wstrict-aliasing is specified, |
125 | and 0 otherwise. After calling this function, wstrict_aliasing will be | |
126 | set to the default value of -Wstrict_aliasing=level. */ | |
127 | ||
128 | extern void set_Wstrict_aliasing (int onoff); | |
129 | ||
76817b9d RK |
130 | /* Nonzero means warn about any objects definitions whose size is larger |
131 | than N bytes. Also want about function definitions whose returned | |
132 | values are larger than N bytes. The value N is in `larger_than_size'. */ | |
133 | ||
e01cc6dc | 134 | extern bool warn_larger_than; |
06ceef4e | 135 | extern HOST_WIDE_INT larger_than_size; |
f7a29665 | 136 | |
a214518f SP |
137 | /* Nonzero means warn about any function whose frame size is larger |
138 | than N bytes. */ | |
139 | ||
140 | extern bool warn_frame_larger_than; | |
141 | extern HOST_WIDE_INT frame_larger_than_size; | |
142 | ||
f7a29665 RS |
143 | /* Nonzero for -dp: annotate the assembly with a comment describing the |
144 | pattern and alternative used. */ | |
145 | ||
146 | extern int flag_print_asm_name; | |
147 | \f | |
148 | /* Now the symbols that are set with `-f' switches. */ | |
149 | ||
c64f913e CB |
150 | /* 0 means straightforward implementation of complex divide acceptable. |
151 | 1 means wide ranges of inputs must work for complex divide. | |
7e7e470f | 152 | 2 means C99-like requirements for complex multiply and divide. */ |
c64f913e | 153 | |
7e7e470f | 154 | extern int flag_complex_method; |
c64f913e | 155 | |
f7a29665 RS |
156 | /* Nonzero if we are only using compiler to check syntax errors. */ |
157 | ||
f6db1481 | 158 | extern int rtl_dump_and_exit; |
f7a29665 | 159 | |
d45cf215 | 160 | /* Nonzero means we should save auxiliary info into a .X file. */ |
f7a29665 RS |
161 | |
162 | extern int flag_gen_aux_info; | |
163 | ||
6ca5d1f6 JJ |
164 | /* True if printing into -fdump-final-insns= dump. */ |
165 | ||
166 | extern bool final_insns_dump_p; | |
167 | ||
f7a29665 RS |
168 | /* Nonzero means change certain warnings into errors. |
169 | Usually these are warnings about failure to conform to some standard. */ | |
170 | ||
171 | extern int flag_pedantic_errors; | |
172 | ||
393eda6a MLI |
173 | /* Nonzero means make permerror produce warnings instead of errors. */ |
174 | ||
175 | extern int flag_permissive; | |
176 | ||
24a4dd31 JJ |
177 | /* Nonzero if we are compiling code for a shared library, zero for |
178 | executable. */ | |
179 | ||
180 | extern int flag_shlib; | |
181 | ||
32b592fb DE |
182 | /* -dA causes debug information to be produced in |
183 | the generated assembly code (to make it more readable). This option | |
184 | is generally only of use to those who actually need to read the | |
185 | generated assembly code (perhaps while debugging the compiler itself). | |
186 | Currently, this switch is only used by dwarfout.c; however, it is intended | |
187 | to be a catchall for printing debug information in the assembler file. */ | |
188 | ||
189 | extern int flag_debug_asm; | |
190 | ||
43b3a5b1 ZL |
191 | /* Generate code for GNU or NeXT Objective-C runtime environment. */ |
192 | ||
193 | extern int flag_next_runtime; | |
194 | ||
c349e40b | 195 | extern int flag_dump_rtl_in_asm; |
058e97ec VM |
196 | |
197 | /* The algorithm used for the integrated register allocator (IRA). */ | |
198 | enum ira_algorithm | |
199 | { | |
058e97ec | 200 | IRA_ALGORITHM_CB, |
7db7ed3c | 201 | IRA_ALGORITHM_PRIORITY |
058e97ec VM |
202 | }; |
203 | ||
204 | extern enum ira_algorithm flag_ira_algorithm; | |
205 | ||
7db7ed3c VM |
206 | /* The regions used for the integrated register allocator (IRA). */ |
207 | enum ira_region | |
208 | { | |
209 | IRA_REGION_ONE, | |
210 | IRA_REGION_ALL, | |
211 | IRA_REGION_MIXED | |
212 | }; | |
213 | ||
214 | extern enum ira_region flag_ira_region; | |
215 | ||
8ce94e44 JM |
216 | /* The options for excess precision. */ |
217 | enum excess_precision | |
218 | { | |
219 | EXCESS_PRECISION_DEFAULT, | |
220 | EXCESS_PRECISION_FAST, | |
221 | EXCESS_PRECISION_STANDARD | |
222 | }; | |
223 | ||
224 | /* The excess precision specified on the command line, or defaulted by | |
225 | the front end. */ | |
226 | extern enum excess_precision flag_excess_precision_cmdline; | |
f7a29665 RS |
227 | \f |
228 | /* Other basic status info about current function. */ | |
229 | ||
3bd36029 RS |
230 | /* Target-dependent global state. */ |
231 | struct target_flag_state { | |
232 | /* Values of the -falign-* flags: how much to align labels in code. | |
233 | 0 means `use default', 1 means `don't align'. | |
234 | For each variable, there is an _log variant which is the power | |
235 | of two not less than the variable, for .align output. */ | |
236 | int x_align_loops_log; | |
237 | int x_align_loops_max_skip; | |
238 | int x_align_jumps_log; | |
239 | int x_align_jumps_max_skip; | |
240 | int x_align_labels_log; | |
241 | int x_align_labels_max_skip; | |
242 | int x_align_functions_log; | |
b6609375 RS |
243 | |
244 | /* The excess precision currently in effect. */ | |
245 | enum excess_precision x_flag_excess_precision; | |
3bd36029 RS |
246 | }; |
247 | ||
248 | extern struct target_flag_state default_target_flag_state; | |
249 | #if SWITCHABLE_TARGET | |
250 | extern struct target_flag_state *this_target_flag_state; | |
251 | #else | |
252 | #define this_target_flag_state (&default_target_flag_state) | |
253 | #endif | |
254 | ||
255 | #define align_loops_log \ | |
256 | (this_target_flag_state->x_align_loops_log) | |
257 | #define align_loops_max_skip \ | |
258 | (this_target_flag_state->x_align_loops_max_skip) | |
259 | #define align_jumps_log \ | |
260 | (this_target_flag_state->x_align_jumps_log) | |
261 | #define align_jumps_max_skip \ | |
262 | (this_target_flag_state->x_align_jumps_max_skip) | |
263 | #define align_labels_log \ | |
264 | (this_target_flag_state->x_align_labels_log) | |
265 | #define align_labels_max_skip \ | |
266 | (this_target_flag_state->x_align_labels_max_skip) | |
267 | #define align_functions_log \ | |
268 | (this_target_flag_state->x_align_functions_log) | |
b6609375 RS |
269 | #define flag_excess_precision \ |
270 | (this_target_flag_state->x_flag_excess_precision) | |
3bd36029 | 271 | |
c67e6e14 RS |
272 | /* Nonzero if subexpressions must be evaluated from left-to-right. */ |
273 | extern int flag_evaluation_order; | |
274 | ||
bb8ebb7f | 275 | /* Value of the -G xx switch, and whether it was passed or not. */ |
307b599c | 276 | extern unsigned HOST_WIDE_INT g_switch_value; |
d185d268 | 277 | extern bool g_switch_set; |
735a0e33 | 278 | |
a406865a RG |
279 | /* Whether to run the warn_unused_result attribute pass. */ |
280 | extern bool flag_warn_unused_result; | |
281 | ||
735a0e33 UD |
282 | /* Nonzero if we dump in VCG format, not plain text. */ |
283 | extern int dump_for_graph; | |
284 | ||
285 | /* Selection of the graph form. */ | |
286 | enum graph_dump_types | |
287 | { | |
288 | no_graph = 0, | |
289 | vcg | |
290 | }; | |
291 | extern enum graph_dump_types graph_dump_format; | |
be163a70 | 292 | |
b38f3813 EB |
293 | /* Type of stack check. */ |
294 | enum stack_check_type | |
295 | { | |
296 | /* Do not check the stack. */ | |
297 | NO_STACK_CHECK = 0, | |
298 | ||
299 | /* Check the stack generically, i.e. assume no specific support | |
300 | from the target configuration files. */ | |
301 | GENERIC_STACK_CHECK, | |
302 | ||
303 | /* Check the stack and rely on the target configuration files to | |
304 | check the static frame of functions, i.e. use the generic | |
305 | mechanism only for dynamic stack allocations. */ | |
306 | STATIC_BUILTIN_STACK_CHECK, | |
307 | ||
308 | /* Check the stack and entirely rely on the target configuration | |
309 | files, i.e. do not use the generic mechanism at all. */ | |
310 | FULL_BUILTIN_STACK_CHECK | |
311 | }; | |
312 | extern enum stack_check_type flag_stack_check; | |
313 | ||
57782ad8 MM |
314 | /* Returns TRUE if generated code should match ABI version N or |
315 | greater is in use. */ | |
316 | ||
317 | #define abi_version_at_least(N) \ | |
318 | (flag_abi_version == 0 || flag_abi_version >= (N)) | |
319 | ||
8d5a7d1f ILT |
320 | /* Return whether the function should be excluded from |
321 | instrumentation. */ | |
322 | extern bool flag_instrument_functions_exclude_p (tree fndecl); | |
323 | ||
eeef0e45 ILT |
324 | /* True if overflow wraps around for the given integral type. That |
325 | is, TYPE_MAX + 1 == TYPE_MIN. */ | |
326 | #define TYPE_OVERFLOW_WRAPS(TYPE) \ | |
327 | (TYPE_UNSIGNED (TYPE) || flag_wrapv) | |
328 | ||
329 | /* True if overflow is undefined for the given integral type. We may | |
6ac01510 ILT |
330 | optimize on the assumption that values in the type never overflow. |
331 | ||
332 | IMPORTANT NOTE: Any optimization based on TYPE_OVERFLOW_UNDEFINED | |
333 | must issue a warning based on warn_strict_overflow. In some cases | |
334 | it will be appropriate to issue the warning immediately, and in | |
335 | other cases it will be appropriate to simply set a flag and let the | |
336 | caller decide whether a warning is appropriate or not. */ | |
eeef0e45 ILT |
337 | #define TYPE_OVERFLOW_UNDEFINED(TYPE) \ |
338 | (!TYPE_UNSIGNED (TYPE) && !flag_wrapv && !flag_trapv && flag_strict_overflow) | |
339 | ||
340 | /* True if overflow for the given integral type should issue a | |
341 | trap. */ | |
342 | #define TYPE_OVERFLOW_TRAPS(TYPE) \ | |
343 | (!TYPE_UNSIGNED (TYPE) && flag_trapv) | |
344 | ||
4c9db6e0 ILT |
345 | /* True if pointer types have undefined overflow. */ |
346 | #define POINTER_TYPE_OVERFLOW_UNDEFINED (flag_strict_overflow) | |
347 | ||
6ac01510 ILT |
348 | /* Names for the different levels of -Wstrict-overflow=N. The numeric |
349 | values here correspond to N. */ | |
350 | ||
351 | enum warn_strict_overflow_code | |
352 | { | |
353 | /* Overflow warning that should be issued with -Wall: a questionable | |
354 | construct that is easy to avoid even when using macros. Example: | |
355 | folding (x + CONSTANT > x) to 1. */ | |
356 | WARN_STRICT_OVERFLOW_ALL = 1, | |
357 | /* Overflow warning about folding a comparison to a constant because | |
358 | of undefined signed overflow, other than cases covered by | |
359 | WARN_STRICT_OVERFLOW_ALL. Example: folding (abs (x) >= 0) to 1 | |
360 | (this is false when x == INT_MIN). */ | |
361 | WARN_STRICT_OVERFLOW_CONDITIONAL = 2, | |
362 | /* Overflow warning about changes to comparisons other than folding | |
363 | them to a constant. Example: folding (x + 1 > 1) to (x > 0). */ | |
364 | WARN_STRICT_OVERFLOW_COMPARISON = 3, | |
365 | /* Overflow warnings not covered by the above cases. Example: | |
366 | folding ((x * 10) / 5) to (x * 2). */ | |
367 | WARN_STRICT_OVERFLOW_MISC = 4, | |
368 | /* Overflow warnings about reducing magnitude of constants in | |
369 | comparison. Example: folding (x + 2 > y) to (x + 1 >= y). */ | |
370 | WARN_STRICT_OVERFLOW_MAGNITUDE = 5 | |
371 | }; | |
372 | ||
373 | /* Whether to emit an overflow warning whose code is C. */ | |
c4e74b1a | 374 | #define issue_strict_overflow_warning(c) (warn_strict_overflow >= (int) (c)) |
6ac01510 | 375 | |
88657302 | 376 | #endif /* ! GCC_FLAGS_H */ |