]>
Commit | Line | Data |
---|---|---|
a767736d | 1 | /* Data structure definitions for a generic GCC target. |
b7119a5a | 2 | Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
a767736d | 3 | |
4 | This program is free software; you can redistribute it and/or modify it | |
5 | under the terms of the GNU General Public License as published by the | |
6 | Free Software Foundation; either version 2, or (at your option) any | |
7 | later version. | |
8 | ||
9 | This program is distributed in the hope that it will be useful, | |
10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
12 | GNU General Public License for more details. | |
13 | ||
14 | You should have received a copy of the GNU General Public License | |
15 | along with this program; if not, write to the Free Software | |
67ce556b | 16 | Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
a767736d | 17 | |
18 | In other words, you are welcome to use, share and improve this program. | |
19 | You are forbidden to forbid anyone else to use, share and improve | |
20 | what you give them. Help stamp out software-hoarding! */ | |
21 | ||
22 | /* This file contains a data structure that describes a GCC target. | |
11ff5d0d | 23 | At present it is incomplete, but in future it should grow to |
a767736d | 24 | contain most or all target machine and target O/S specific |
25 | information. | |
26 | ||
27 | This structure has its initializer declared in target-def.h in the | |
28 | form of large macro TARGET_INITIALIZER that expands to many smaller | |
29 | macros. | |
30 | ||
31 | The smaller macros each initialize one component of the structure, | |
32 | and each has a default. Each target should have a file that | |
33 | includes target.h and target-def.h, and overrides any inappropriate | |
34 | defaults by undefining the relevant macro and defining a suitable | |
35 | replacement. That file should then contain the definition of | |
57e4bbfb | 36 | "targetm" like so: |
a767736d | 37 | |
57e4bbfb | 38 | struct gcc_target targetm = TARGET_INITIALIZER; |
a767736d | 39 | |
40 | Doing things this way allows us to bring together everything that | |
11ff5d0d | 41 | defines a GCC target. By supplying a default that is appropriate |
42 | to most targets, we can easily add new items without needing to | |
43 | edit dozens of target configuration files. It should also allow us | |
44 | to gradually reduce the amount of conditional compilation that is | |
45 | scattered throughout GCC. */ | |
a767736d | 46 | |
bcf3c70d | 47 | #ifndef GCC_TARGET_H |
48 | #define GCC_TARGET_H | |
49 | ||
7988d6e2 | 50 | #include "tm.h" |
bcf3c70d | 51 | #include "insn-modes.h" |
7988d6e2 | 52 | |
a6c787e5 | 53 | struct stdarg_info; |
54 | ||
4d58fa46 | 55 | /* The struct used by the secondary_reload target hook. */ |
56 | typedef struct secondary_reload_info | |
57 | { | |
58 | /* icode is actually an enum insn_code, but we don't want to force every | |
59 | file that includes target.h to include optabs.h . */ | |
60 | int icode; | |
61 | int extra_cost; /* Cost for using (a) scratch register(s) to be taken | |
62 | into account by copy_cost. */ | |
63 | /* The next two members are for the use of the backward | |
64 | compatibility hook. */ | |
65 | struct secondary_reload_info *prev_sri; | |
66 | int t_icode; /* Actually an enum insn_code - see above. */ | |
67 | } secondary_reload_info; | |
68 | ||
69 | ||
a767736d | 70 | struct gcc_target |
71 | { | |
17d9b0c3 | 72 | /* Functions that output assembler for the target. */ |
73 | struct asm_out | |
74 | { | |
11ff5d0d | 75 | /* Opening and closing parentheses for asm expression grouping. */ |
76 | const char *open_paren, *close_paren; | |
77 | ||
58356836 | 78 | /* Assembler instructions for creating various kinds of integer object. */ |
79 | const char *byte_op; | |
80 | struct asm_int_op | |
81 | { | |
82 | const char *hi; | |
83 | const char *si; | |
84 | const char *di; | |
85 | const char *ti; | |
86 | } aligned_op, unaligned_op; | |
87 | ||
88 | /* Try to output the assembler code for an integer object whose | |
89 | value is given by X. SIZE is the size of the object in bytes and | |
90 | ALIGNED_P indicates whether it is aligned. Return true if | |
91 | successful. Only handles cases for which BYTE_OP, ALIGNED_OP | |
92 | and UNALIGNED_OP are NULL. */ | |
60b8c5b3 | 93 | bool (* integer) (rtx x, unsigned int size, int aligned_p); |
58356836 | 94 | |
67c1e638 | 95 | /* Output code that will globalize a label. */ |
60b8c5b3 | 96 | void (* globalize_label) (FILE *, const char *); |
67c1e638 | 97 | |
2f9fc8ef | 98 | /* Output code that will emit a label for unwind info, if this |
99 | target requires such labels. Second argument is the decl the | |
ef1074f7 | 100 | unwind info is associated with, third is a boolean: true if |
101 | this is for exception handling, fourth is a boolean: true if | |
0bed3869 | 102 | this is only a placeholder for an omitted FDE. */ |
ef1074f7 | 103 | void (* unwind_label) (FILE *, tree, int, int); |
2f9fc8ef | 104 | |
8ec87476 | 105 | /* Emit any directives required to unwind this instruction. */ |
106 | void (* unwind_emit) (FILE *, rtx); | |
107 | ||
805e22b2 | 108 | /* Output an internal label. */ |
60b8c5b3 | 109 | void (* internal_label) (FILE *, const char *, unsigned long); |
805e22b2 | 110 | |
1774763d | 111 | /* Emit a ttype table reference to a typeinfo object. */ |
112 | bool (* ttype) (rtx); | |
113 | ||
2532673e | 114 | /* Emit an assembler directive to set visibility for the symbol |
115 | associated with the tree decl. */ | |
60b8c5b3 | 116 | void (* visibility) (tree, int); |
2532673e | 117 | |
17d9b0c3 | 118 | /* Output the assembler code for entry to a function. */ |
60b8c5b3 | 119 | void (* function_prologue) (FILE *, HOST_WIDE_INT); |
17d9b0c3 | 120 | |
85ae73e8 | 121 | /* Output the assembler code for end of prologue. */ |
60b8c5b3 | 122 | void (* function_end_prologue) (FILE *); |
85ae73e8 | 123 | |
124 | /* Output the assembler code for start of epilogue. */ | |
60b8c5b3 | 125 | void (* function_begin_epilogue) (FILE *); |
85ae73e8 | 126 | |
17d9b0c3 | 127 | /* Output the assembler code for function exit. */ |
60b8c5b3 | 128 | void (* function_epilogue) (FILE *, HOST_WIDE_INT); |
2cb4ac60 | 129 | |
2f14b1f9 | 130 | /* Initialize target-specific sections. */ |
131 | void (* init_sections) (void); | |
132 | ||
537cd941 | 133 | /* Tell assembler to change to section NAME with attributes FLAGS. |
134 | If DECL is non-NULL, it is the VAR_DECL or FUNCTION_DECL with | |
135 | which this section is associated. */ | |
136 | void (* named_section) (const char *name, unsigned int flags, tree decl); | |
01d15dc5 | 137 | |
2f14b1f9 | 138 | /* Return a section for EXP. It may be a DECL or a constant. RELOC |
139 | is nonzero if runtime relocations must be applied; bit 1 will be | |
140 | set if the runtime relocations require non-local name resolution. | |
141 | ALIGN is the required alignment of the data. */ | |
142 | section *(* select_section) (tree, int, unsigned HOST_WIDE_INT); | |
52470889 | 143 | |
2f14b1f9 | 144 | /* Return a section for X. MODE is X's mode and ALIGN is its |
145 | alignment in bits. */ | |
146 | section *(* select_rtx_section) (enum machine_mode, rtx, | |
147 | unsigned HOST_WIDE_INT); | |
bbfbe351 | 148 | |
52470889 | 149 | /* Select a unique section name for DECL. RELOC is the same as |
150 | for SELECT_SECTION. */ | |
60b8c5b3 | 151 | void (* unique_section) (tree, int); |
52470889 | 152 | |
2f14b1f9 | 153 | /* Return the readonly data section associated with function DECL. */ |
154 | section *(* function_rodata_section) (tree); | |
76aec42f | 155 | |
01d15dc5 | 156 | /* Output a constructor for a symbol with a given priority. */ |
60b8c5b3 | 157 | void (* constructor) (rtx, int); |
01d15dc5 | 158 | |
159 | /* Output a destructor for a symbol with a given priority. */ | |
60b8c5b3 | 160 | void (* destructor) (rtx, int); |
c6933ba6 | 161 | |
eb344f43 | 162 | /* Output the assembler code for a thunk function. THUNK_DECL is the |
163 | declaration for the thunk function itself, FUNCTION is the decl for | |
164 | the target function. DELTA is an immediate constant offset to be | |
6e7fc474 | 165 | added to THIS. If VCALL_OFFSET is nonzero, the word at |
eb344f43 | 166 | *(*this + vcall_offset) should be added to THIS. */ |
60b8c5b3 | 167 | void (* output_mi_thunk) (FILE *file, tree thunk_decl, |
168 | HOST_WIDE_INT delta, HOST_WIDE_INT vcall_offset, | |
169 | tree function_decl); | |
eb344f43 | 170 | |
171 | /* Determine whether output_mi_thunk would succeed. */ | |
172 | /* ??? Ideally, this hook would not exist, and success or failure | |
173 | would be returned from output_mi_thunk directly. But there's | |
174 | too much undo-able setup involved in invoking output_mi_thunk. | |
175 | Could be fixed by making output_mi_thunk emit rtl instead of | |
176 | text to the output file. */ | |
60b8c5b3 | 177 | bool (* can_output_mi_thunk) (tree thunk_decl, HOST_WIDE_INT delta, |
178 | HOST_WIDE_INT vcall_offset, | |
179 | tree function_decl); | |
f6940372 | 180 | |
92c473b8 | 181 | /* Output any boilerplate text needed at the beginning of a |
182 | translation unit. */ | |
60b8c5b3 | 183 | void (*file_start) (void); |
92c473b8 | 184 | |
185 | /* Output any boilerplate text needed at the end of a | |
186 | translation unit. */ | |
60b8c5b3 | 187 | void (*file_end) (void); |
864af209 | 188 | |
189 | /* Output an assembler pseudo-op to declare a library function name | |
190 | external. */ | |
191 | void (*external_libcall) (rtx); | |
9423c9b7 | 192 | |
193 | /* Output an assembler directive to mark decl live. This instructs | |
194 | linker to not dead code strip this symbol. */ | |
195 | void (*mark_decl_preserved) (const char *); | |
196 | ||
40af64cc | 197 | /* Output a DTP-relative reference to a TLS symbol. */ |
198 | void (*output_dwarf_dtprel) (FILE *file, int size, rtx x); | |
199 | ||
17d9b0c3 | 200 | } asm_out; |
201 | ||
747af5e7 | 202 | /* Functions relating to instruction scheduling. */ |
203 | struct sched | |
204 | { | |
205 | /* Given the current cost, COST, of an insn, INSN, calculate and | |
206 | return a new cost based on its relationship to DEP_INSN through | |
207 | the dependence LINK. The default is to make no adjustment. */ | |
60b8c5b3 | 208 | int (* adjust_cost) (rtx insn, rtx link, rtx def_insn, int cost); |
747af5e7 | 209 | |
210 | /* Adjust the priority of an insn as you see fit. Returns the new | |
211 | priority. */ | |
60b8c5b3 | 212 | int (* adjust_priority) (rtx, int); |
747af5e7 | 213 | |
214 | /* Function which returns the maximum number of insns that can be | |
215 | scheduled in the same machine cycle. This must be constant | |
216 | over an entire compilation. The default is 1. */ | |
60b8c5b3 | 217 | int (* issue_rate) (void); |
747af5e7 | 218 | |
219 | /* Calculate how much this insn affects how many more insns we | |
220 | can emit this cycle. Default is they all cost the same. */ | |
60b8c5b3 | 221 | int (* variable_issue) (FILE *, int, rtx, int); |
6c34d0c2 | 222 | |
747af5e7 | 223 | /* Initialize machine-dependent scheduling code. */ |
60b8c5b3 | 224 | void (* md_init) (FILE *, int, int); |
747af5e7 | 225 | |
226 | /* Finalize machine-dependent scheduling code. */ | |
60b8c5b3 | 227 | void (* md_finish) (FILE *, int); |
747af5e7 | 228 | |
f77a5bb0 | 229 | /* Initialize machine-dependent function while scheduling code. */ |
230 | void (* md_init_global) (FILE *, int, int); | |
231 | ||
232 | /* Finalize machine-dependent function wide scheduling code. */ | |
233 | void (* md_finish_global) (FILE *, int); | |
234 | ||
747af5e7 | 235 | /* Reorder insns in a machine-dependent fashion, in two different |
236 | places. Default does nothing. */ | |
60b8c5b3 | 237 | int (* reorder) (FILE *, int, rtx *, int *, int); |
238 | int (* reorder2) (FILE *, int, rtx *, int *, int); | |
747af5e7 | 239 | |
58ada791 | 240 | /* The following member value is a pointer to a function called |
241 | after evaluation forward dependencies of insns in chain given | |
242 | by two parameter values (head and tail correspondingly). */ | |
60b8c5b3 | 243 | void (* dependencies_evaluation_hook) (rtx, rtx); |
58ada791 | 244 | |
bea4bad2 | 245 | /* The values of the following four members are pointers to |
246 | functions used to simplify the automaton descriptions. | |
247 | dfa_pre_cycle_insn and dfa_post_cycle_insn give functions | |
248 | returning insns which are used to change the pipeline hazard | |
249 | recognizer state when the new simulated processor cycle | |
250 | correspondingly starts and finishes. The function defined by | |
251 | init_dfa_pre_cycle_insn and init_dfa_post_cycle_insn are used | |
252 | to initialize the corresponding insns. The default values of | |
40e55fbb | 253 | the members result in not changing the automaton state when |
bea4bad2 | 254 | the new simulated processor cycle correspondingly starts and |
255 | finishes. */ | |
60b8c5b3 | 256 | void (* init_dfa_pre_cycle_insn) (void); |
257 | rtx (* dfa_pre_cycle_insn) (void); | |
258 | void (* init_dfa_post_cycle_insn) (void); | |
259 | rtx (* dfa_post_cycle_insn) (void); | |
67900a4f | 260 | |
bea4bad2 | 261 | /* The following member value is a pointer to a function returning value |
262 | which defines how many insns in queue `ready' will we try for | |
4fa61ced | 263 | multi-pass scheduling. If the member value is nonzero and the |
bea4bad2 | 264 | function returns positive value, the DFA based scheduler will make |
265 | multi-pass scheduling for the first cycle. In other words, we will | |
266 | try to choose ready insn which permits to start maximum number of | |
267 | insns on the same cycle. */ | |
60b8c5b3 | 268 | int (* first_cycle_multipass_dfa_lookahead) (void); |
67900a4f | 269 | |
58ada791 | 270 | /* The following member value is pointer to a function controlling |
271 | what insns from the ready insn queue will be considered for the | |
272 | multipass insn scheduling. If the hook returns zero for insn | |
273 | passed as the parameter, the insn will be not chosen to be | |
274 | issued. */ | |
60b8c5b3 | 275 | int (* first_cycle_multipass_dfa_lookahead_guard) (rtx); |
67900a4f | 276 | |
58ada791 | 277 | /* The following member value is pointer to a function called by |
278 | the insn scheduler before issuing insn passed as the third | |
279 | parameter on given cycle. If the hook returns nonzero, the | |
280 | insn is not issued on given processors cycle. Instead of that, | |
281 | the processor cycle is advanced. If the value passed through | |
282 | the last parameter is zero, the insn ready queue is not sorted | |
283 | on the new cycle start as usually. The first parameter passes | |
284 | file for debugging output. The second one passes the scheduler | |
285 | verbose level of the debugging output. The forth and the fifth | |
286 | parameter values are correspondingly processor cycle on which | |
287 | the previous insn has been issued and the current processor | |
288 | cycle. */ | |
60b8c5b3 | 289 | int (* dfa_new_cycle) (FILE *, int, rtx, int, int, int *); |
67900a4f | 290 | |
52c4b43f | 291 | /* The following member value is a pointer to a function called |
292 | by the insn scheduler. It should return true if there exists a | |
9e7454d0 | 293 | dependence which is considered costly by the target, between |
294 | the insn passed as the first parameter, and the insn passed as | |
295 | the second parameter. The third parameter is the INSN_DEPEND | |
52c4b43f | 296 | link that represents the dependence between the two insns. The |
297 | fourth argument is the cost of the dependence as estimated by | |
9e7454d0 | 298 | the scheduler. The last argument is the distance in cycles |
52c4b43f | 299 | between the already scheduled insn (first parameter) and the |
1b50d756 | 300 | the second insn (second parameter). */ |
301 | bool (* is_costly_dependence) (rtx, rtx, rtx, int, int); | |
747af5e7 | 302 | } sched; |
303 | ||
b056d812 | 304 | /* Functions relating to vectorization. */ |
305 | struct vectorize | |
306 | { | |
f61467c8 | 307 | /* The following member value is a pointer to a function called |
b056d812 | 308 | by the vectorizer, and return the decl of the target builtin |
309 | function. */ | |
310 | tree (* builtin_mask_for_load) (void); | |
b056d812 | 311 | } vectorize; |
312 | ||
ff05e09e | 313 | /* The initial value of target_flags. */ |
314 | int default_target_flags; | |
315 | ||
316 | /* Handle target switch CODE (an OPT_* value). ARG is the argument | |
317 | passed to the switch; it is NULL if no argument was. VALUE is the | |
318 | value of ARG if CODE specifies a UInteger option, otherwise it is | |
319 | 1 if the positive form of the switch was used and 0 if the negative | |
320 | form was. Return true if the switch was valid. */ | |
321 | bool (* handle_option) (size_t code, const char *arg, int value); | |
322 | ||
fbf0afd1 | 323 | /* Return machine mode for filter value. */ |
95215948 | 324 | enum machine_mode (* eh_return_filter_mode) (void); |
325 | ||
a767736d | 326 | /* Given two decls, merge their attributes and return the result. */ |
60b8c5b3 | 327 | tree (* merge_decl_attributes) (tree, tree); |
a767736d | 328 | |
329 | /* Given two types, merge their attributes and return the result. */ | |
60b8c5b3 | 330 | tree (* merge_type_attributes) (tree, tree); |
a767736d | 331 | |
f8e93a2e | 332 | /* Table of machine attributes and functions to handle them. |
333 | Ignored if NULL. */ | |
e3c541f0 | 334 | const struct attribute_spec *attribute_table; |
f32321da | 335 | |
336 | /* Return zero if the attributes on TYPE1 and TYPE2 are incompatible, | |
337 | one if they are compatible and two if they are nearly compatible | |
338 | (which causes a warning to be generated). */ | |
60b8c5b3 | 339 | int (* comp_type_attributes) (tree type1, tree type2); |
f32321da | 340 | |
341 | /* Assign default attributes to the newly defined TYPE. */ | |
60b8c5b3 | 342 | void (* set_default_type_attributes) (tree type); |
8ee295a7 | 343 | |
344 | /* Insert attributes on the newly created DECL. */ | |
60b8c5b3 | 345 | void (* insert_attributes) (tree decl, tree *attributes); |
fc2a2dcb | 346 | |
e3c541f0 | 347 | /* Return true if FNDECL (which has at least one machine attribute) |
348 | can be inlined despite its machine attributes, false otherwise. */ | |
60b8c5b3 | 349 | bool (* function_attribute_inlinable_p) (tree fndecl); |
e3c541f0 | 350 | |
f04f096b | 351 | /* Return true if bitfields in RECORD_TYPE should follow the |
352 | Microsoft Visual C++ bitfield layout rules. */ | |
60b8c5b3 | 353 | bool (* ms_bitfield_layout_p) (tree record_type); |
f04f096b | 354 | |
c4503c0a | 355 | /* True if the target supports decimal floating point. */ |
356 | bool (* decimal_float_supported_p) (void); | |
357 | ||
25ba5be6 | 358 | /* Return true if anonymous bitfields affect structure alignment. */ |
359 | bool (* align_anon_bitfield) (void); | |
360 | ||
fc2a2dcb | 361 | /* Set up target-specific built-in functions. */ |
60b8c5b3 | 362 | void (* init_builtins) (void); |
fc2a2dcb | 363 | |
364 | /* Expand a target-specific builtin. */ | |
60b8c5b3 | 365 | rtx (* expand_builtin) (tree exp, rtx target, rtx subtarget, |
366 | enum machine_mode mode, int ignore); | |
2cb4ac60 | 367 | |
65441f6f | 368 | /* Select a replacement for a target-specific builtin. This is done |
369 | *before* regular type checking, and so allows the target to implement | |
370 | a crude form of function overloading. The result is a complete | |
371 | expression that implements the operation. */ | |
372 | tree (*resolve_overloaded_builtin) (tree decl, tree params); | |
373 | ||
b0160cb4 | 374 | /* Fold a target-specific builtin. */ |
0ab8af67 | 375 | tree (* fold_builtin) (tree fndecl, tree arglist, bool ignore); |
65441f6f | 376 | |
333715c2 | 377 | /* For a vendor-specific fundamental TYPE, return a pointer to |
378 | a statically-allocated string containing the C++ mangling for | |
379 | TYPE. In all other cases, return NULL. */ | |
380 | const char * (* mangle_fundamental_type) (tree type); | |
381 | ||
f2f543a3 | 382 | /* Make any adjustments to libfunc names needed for this target. */ |
383 | void (* init_libfuncs) (void); | |
384 | ||
2cb4ac60 | 385 | /* Given a decl, a section name, and whether the decl initializer |
386 | has relocs, choose attributes for the section. */ | |
387 | /* ??? Should be merged with SELECT_SECTION and UNIQUE_SECTION. */ | |
60b8c5b3 | 388 | unsigned int (* section_type_flags) (tree, const char *, int); |
2cb4ac60 | 389 | |
e27e52e0 | 390 | /* True if new jumps cannot be created, to replace existing ones or |
391 | not, at the current point in the compilation. */ | |
60b8c5b3 | 392 | bool (* cannot_modify_jumps_p) (void); |
52470889 | 393 | |
e26dbf6d | 394 | /* Return a register class for which branch target register |
395 | optimizations should be applied. */ | |
60b8c5b3 | 396 | int (* branch_target_register_class) (void); |
e26dbf6d | 397 | |
398 | /* Return true if branch target register optimizations should include | |
399 | callee-saved registers that are not already live during the current | |
400 | function. AFTER_PE_GEN is true if prologues and epilogues have | |
401 | already been generated. */ | |
60b8c5b3 | 402 | bool (* branch_target_register_callee_saved) (bool after_pe_gen); |
8af3db02 | 403 | |
a6bbccc1 | 404 | /* True if the constant X cannot be placed in the constant pool. */ |
60b8c5b3 | 405 | bool (* cannot_force_const_mem) (rtx); |
a6bbccc1 | 406 | |
2f58af60 | 407 | /* True if the insn X cannot be duplicated. */ |
60b8c5b3 | 408 | bool (* cannot_copy_insn_p) (rtx); |
2f58af60 | 409 | |
280566a7 | 410 | /* True if X is considered to be commutative. */ |
411 | bool (* commutative_p) (rtx, int); | |
412 | ||
bfe57ab7 | 413 | /* Given an address RTX, undo the effects of LEGITIMIZE_ADDRESS. */ |
60b8c5b3 | 414 | rtx (* delegitimize_address) (rtx); |
bfe57ab7 | 415 | |
805e22b2 | 416 | /* True if it is OK to do sibling call optimization for the specified |
417 | call expression EXP. DECL will be the called function, or NULL if | |
418 | this is an indirect call. */ | |
60b8c5b3 | 419 | bool (*function_ok_for_sibcall) (tree decl, tree exp); |
420 | ||
52470889 | 421 | /* True if EXP should be placed in a "small data" section. */ |
60b8c5b3 | 422 | bool (* in_small_data_p) (tree); |
7811991d | 423 | |
33459320 | 424 | /* True if EXP names an object for which name resolution must resolve |
425 | to the current module. */ | |
60b8c5b3 | 426 | bool (* binds_local_p) (tree); |
33459320 | 427 | |
7811991d | 428 | /* Do something target-specific to record properties of the DECL into |
429 | the associated SYMBOL_REF. */ | |
60b8c5b3 | 430 | void (* encode_section_info) (tree, rtx, int); |
7b4a38a6 | 431 | |
432 | /* Undo the effects of encode_section_info on the symbol string. */ | |
60b8c5b3 | 433 | const char * (* strip_name_encoding) (const char *); |
33459320 | 434 | |
c49547c4 | 435 | /* If shift optabs for MODE are known to always truncate the shift count, |
436 | return the mask that they apply. Return 0 otherwise. */ | |
437 | unsigned HOST_WIDE_INT (* shift_truncation_mask) (enum machine_mode mode); | |
438 | ||
fab7adbf | 439 | /* True if MODE is valid for a pointer in __attribute__((mode("MODE"))). */ |
60b8c5b3 | 440 | bool (* valid_pointer_mode) (enum machine_mode mode); |
fab7adbf | 441 | |
b2aef146 | 442 | /* True if MODE is valid for the target. By "valid", we mean able to |
443 | be manipulated in non-trivial ways. In particular, this means all | |
444 | the arithmetic is supported. */ | |
445 | bool (* scalar_mode_supported_p) (enum machine_mode mode); | |
446 | ||
447 | /* Similarly for vector modes. "Supported" here is less strict. At | |
448 | least some operations are supported; need to check optabs or builtins | |
449 | for further details. */ | |
9e7454d0 | 450 | bool (* vector_mode_supported_p) (enum machine_mode mode); |
451 | ||
ad92037a | 452 | /* True if a vector is opaque. */ |
60b8c5b3 | 453 | bool (* vector_opaque_p) (tree); |
5050b2f7 | 454 | |
fab7adbf | 455 | /* Compute a (partial) cost for rtx X. Return true if the complete |
456 | cost has been computed, and false if subexpressions should be | |
457 | scanned. In either case, *TOTAL contains the cost result. */ | |
458 | /* Note that CODE and OUTER_CODE ought to be RTX_CODE, but that's | |
459 | not necessarily defined at this point. */ | |
60b8c5b3 | 460 | bool (* rtx_costs) (rtx x, int code, int outer_code, int *total); |
fab7adbf | 461 | |
ec0457a8 | 462 | /* Compute the cost of X, used as an address. Never called with |
463 | invalid addresses. */ | |
60b8c5b3 | 464 | int (* address_cost) (rtx x); |
ec0457a8 | 465 | |
edf54f2a | 466 | /* Return where to allocate pseudo for a given hard register initial |
467 | value. */ | |
468 | rtx (* allocate_initial_value) (rtx x); | |
469 | ||
9754a2f0 | 470 | /* Given a register, this hook should return a parallel of registers |
471 | to represent where to find the register pieces. Define this hook | |
472 | if the register and its mode are represented in Dwarf in | |
473 | non-contiguous locations, or if the register should be | |
474 | represented in more than one register in Dwarf. Otherwise, this | |
475 | hook should return NULL_RTX. */ | |
60b8c5b3 | 476 | rtx (* dwarf_register_span) (rtx); |
9754a2f0 | 477 | |
124ac4e4 | 478 | /* Fetch the fixed register(s) which hold condition codes, for |
479 | targets where it makes sense to look for duplicate assignments to | |
480 | the condition codes. This should return true if there is such a | |
481 | register, false otherwise. The arguments should be set to the | |
482 | fixed register numbers. Up to two condition code registers are | |
483 | supported. If there is only one for this target, the int pointed | |
484 | at by the second argument should be set to -1. */ | |
485 | bool (* fixed_condition_code_regs) (unsigned int *, unsigned int *); | |
486 | ||
487 | /* If two condition code modes are compatible, return a condition | |
488 | code mode which is compatible with both, such that a comparison | |
489 | done in the returned mode will work for both of the original | |
490 | modes. If the condition code modes are not compatible, return | |
491 | VOIDmode. */ | |
492 | enum machine_mode (* cc_modes_compatible) (enum machine_mode, | |
493 | enum machine_mode); | |
494 | ||
2efea8c0 | 495 | /* Do machine-dependent code transformations. Called just before |
496 | delayed-branch scheduling. */ | |
60b8c5b3 | 497 | void (* machine_dependent_reorg) (void); |
2efea8c0 | 498 | |
2e15d750 | 499 | /* Create the __builtin_va_list type. */ |
500 | tree (* build_builtin_va_list) (void); | |
501 | ||
17a6380d | 502 | /* Gimplifies a VA_ARG_EXPR. */ |
503 | tree (* gimplify_va_arg_expr) (tree valist, tree type, tree *pre_p, | |
504 | tree *post_p); | |
505 | ||
7988d6e2 | 506 | /* Validity-checking routines for PCH files, target-specific. |
507 | get_pch_validity returns a pointer to the data to be stored, | |
508 | and stores the size in its argument. pch_valid_p gets the same | |
509 | information back and returns NULL if the PCH is valid, | |
510 | or an error message if not. | |
511 | */ | |
512 | void * (* get_pch_validity) (size_t *); | |
513 | const char * (* pch_valid_p) (const void *, size_t); | |
514 | ||
761d9126 | 515 | /* If nonnull, this function checks whether a PCH file with the |
516 | given set of target flags can be used. It returns NULL if so, | |
517 | otherwise it returns an error message. */ | |
518 | const char *(*check_pch_target_flags) (int); | |
519 | ||
13401456 | 520 | /* True if the compiler should give an enum type only as many |
bfb835d3 | 521 | bytes as it takes to represent the range of possible values of |
522 | that type. */ | |
523 | bool (* default_short_enums) (void); | |
524 | ||
e3e026e8 | 525 | /* This target hook returns an rtx that is used to store the address |
13401456 | 526 | of the current frame into the built-in setjmp buffer. */ |
e3e026e8 | 527 | rtx (* builtin_setjmp_frame_value) (void); |
528 | ||
0fb2666c | 529 | /* This target hook should add STRING_CST trees for any hard regs |
64d5fb6a | 530 | the port wishes to automatically clobber for an asm. */ |
531 | tree (* md_asm_clobbers) (tree, tree, tree); | |
0fb2666c | 532 | |
8ff30ff6 | 533 | /* This target hook allows the backend to specify a calling convention |
534 | in the debug information. This function actually returns an | |
535 | enum dwarf_calling_convention, but because of forward declarations | |
536 | and not wanting to include dwarf2.h everywhere target.h is included | |
537 | the function is being declared as an int. */ | |
538 | int (* dwarf_calling_convention) (tree); | |
539 | ||
d15ee1a5 | 540 | /* This target hook allows the backend to emit frame-related insns that |
541 | contain UNSPECs or UNSPEC_VOLATILEs. The call frame debugging info | |
542 | engine will invoke it on insns of the form | |
543 | (set (reg) (unspec [...] UNSPEC_INDEX)) | |
544 | and | |
545 | (set (reg) (unspec_volatile [...] UNSPECV_INDEX)) | |
546 | to let the backend emit the call frame instructions. */ | |
547 | void (* dwarf_handle_frame_unspec) (const char *, rtx, int); | |
548 | ||
a6c787e5 | 549 | /* Perform architecture specific checking of statements gimplified |
550 | from VA_ARG_EXPR. LHS is left hand side of MODIFY_EXPR, RHS | |
551 | is right hand side. Returns true if the statements doesn't need | |
552 | to be checked for va_list references. */ | |
f1a0edff | 553 | bool (* stdarg_optimize_hook) (struct stdarg_info *ai, tree lhs, tree rhs); |
554 | ||
555 | /* This target hook allows the operating system to override the DECL | |
556 | that represents the external variable that contains the stack | |
557 | protection guard variable. The type of this DECL is ptr_type_node. */ | |
558 | tree (* stack_protect_guard) (void); | |
559 | ||
560 | /* This target hook allows the operating system to override the CALL_EXPR | |
561 | that is invoked when a check vs the guard variable fails. */ | |
562 | tree (* stack_protect_fail) (void); | |
a6c787e5 | 563 | |
1606e68a | 564 | /* Returns NULL if target supports the insn within a doloop block, |
565 | otherwise it returns an error message. */ | |
566 | const char * (*invalid_within_doloop) (rtx); | |
6c1e551f | 567 | |
568 | /* DECL is a variable or function with __attribute__((dllimport)) | |
569 | specified. Use this hook if the target needs to add extra validation | |
570 | checks to handle_dll_attribute (). */ | |
571 | bool (* valid_dllimport_attribute_p) (tree decl); | |
7dfa5ce3 | 572 | |
92d40bc4 | 573 | /* Functions relating to calls - argument passing, returns, etc. */ |
574 | struct calls { | |
575 | bool (*promote_function_args) (tree fntype); | |
576 | bool (*promote_function_return) (tree fntype); | |
577 | bool (*promote_prototypes) (tree fntype); | |
578 | rtx (*struct_value_rtx) (tree fndecl, int incoming); | |
579 | bool (*return_in_memory) (tree type, tree fndecl); | |
580 | bool (*return_in_msb) (tree type); | |
b981d932 | 581 | |
582 | /* Return true if a parameter must be passed by reference. TYPE may | |
583 | be null if this is a libcall. CA may be null if this query is | |
584 | from __builtin_va_arg. */ | |
585 | bool (*pass_by_reference) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
586 | tree type, bool named_arg); | |
587 | ||
92d40bc4 | 588 | rtx (*expand_builtin_saveregs) (void); |
589 | /* Returns pretend_argument_size. */ | |
590 | void (*setup_incoming_varargs) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
591 | tree type, int *pretend_arg_size, | |
592 | int second_time); | |
593 | bool (*strict_argument_naming) (CUMULATIVE_ARGS *ca); | |
594 | /* Returns true if we should use | |
595 | targetm.calls.setup_incoming_varargs() and/or | |
596 | targetm.calls.strict_argument_naming(). */ | |
597 | bool (*pretend_outgoing_varargs_named) (CUMULATIVE_ARGS *ca); | |
598 | ||
599 | /* Given a complex type T, return true if a parameter of type T | |
600 | should be passed as two scalars. */ | |
601 | bool (* split_complex_arg) (tree type); | |
0336f0f0 | 602 | |
603 | /* Return true if type T, mode MODE, may not be passed in registers, | |
604 | but must be passed on the stack. */ | |
605 | /* ??? This predicate should be applied strictly after pass-by-reference. | |
606 | Need audit to verify that this is the case. */ | |
607 | bool (* must_pass_in_stack) (enum machine_mode mode, tree t); | |
13f08ee7 | 608 | |
609 | /* Return true if type TYPE, mode MODE, which is passed by reference, | |
610 | should have the object copy generated by the callee rather than | |
611 | the caller. It is never called for TYPE requiring constructors. */ | |
612 | bool (* callee_copies) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
613 | tree type, bool named); | |
f054eb3c | 614 | |
615 | /* Return zero for arguments passed entirely on the stack or entirely | |
616 | in registers. If passed in both, return the number of bytes passed | |
617 | in registers; the balance is therefore passed on the stack. */ | |
618 | int (* arg_partial_bytes) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
619 | tree type, bool named); | |
10fda9eb | 620 | |
621 | /* Return the diagnostic message string if function without a prototype | |
622 | is not allowed for this 'val' argument; NULL otherwise. */ | |
623 | const char *(*invalid_arg_for_unprototyped_fn) (tree typelist, | |
624 | tree funcdecl, tree val); | |
46b3ff29 | 625 | |
626 | /* Return an rtx for the return value location of the function | |
627 | specified by FN_DECL_OR_TYPE with a return type of RET_TYPE. */ | |
628 | rtx (*function_value) (tree ret_type, tree fn_decl_or_type, | |
629 | bool outgoing); | |
567925e3 | 630 | |
631 | /* Return an rtx for the argument pointer incoming to the | |
632 | current function. */ | |
633 | rtx (*internal_arg_pointer) (void); | |
92d40bc4 | 634 | } calls; |
635 | ||
7a979707 | 636 | /* Return the diagnostic message string if conversion from FROMTYPE |
637 | to TOTYPE is not allowed, NULL otherwise. */ | |
638 | const char *(*invalid_conversion) (tree fromtype, tree totype); | |
639 | ||
640 | /* Return the diagnostic message string if the unary operation OP is | |
641 | not permitted on TYPE, NULL otherwise. */ | |
642 | const char *(*invalid_unary_op) (int op, tree type); | |
643 | ||
644 | /* Return the diagnostic message string if the binary operation OP | |
645 | is not permitted on TYPE1 and TYPE2, NULL otherwise. */ | |
646 | const char *(*invalid_binary_op) (int op, tree type1, tree type2); | |
647 | ||
4d58fa46 | 648 | /* Return the class for a secondary reload, and fill in extra information. */ |
649 | enum reg_class (*secondary_reload) (bool, rtx, enum reg_class, | |
650 | enum machine_mode, | |
651 | struct secondary_reload_info *); | |
652 | ||
c1dc02de | 653 | /* Functions specific to the C++ frontend. */ |
654 | struct cxx { | |
655 | /* Return the integer type used for guard variables. */ | |
656 | tree (*guard_type) (void); | |
657 | /* Return true if only the low bit of the guard should be tested. */ | |
658 | bool (*guard_mask_bit) (void); | |
600f4be7 | 659 | /* Returns the size of the array cookie for an array of type. */ |
660 | tree (*get_cookie_size) (tree); | |
661 | /* Returns true if the element size should be stored in the | |
662 | array cookie. */ | |
663 | bool (*cookie_has_size) (void); | |
52d6bee4 | 664 | /* Allows backends to perform additional processing when |
665 | deciding if a class should be exported or imported. */ | |
666 | int (*import_export_class) (tree, int); | |
853b7640 | 667 | /* Returns true if constructors and destructors return "this". */ |
668 | bool (*cdtor_returns_this) (void); | |
219626ad | 669 | /* Returns true if the key method for a class can be an inline |
670 | function, so long as it is not declared inline in the class | |
671 | itself. Returning true is the behavior required by the Itanium | |
672 | C++ ABI. */ | |
673 | bool (*key_method_may_be_inline) (void); | |
7908506d | 674 | /* DECL is a virtual table, virtual table table, typeinfo object, |
675 | or other similar implicit class data object that will be | |
676 | emitted with external linkage in this translation unit. No ELF | |
677 | visibility has been explicitly specified. If the target needs | |
678 | to specify a visibility other than that of the containing class, | |
679 | use this hook to set DECL_VISIBILITY and | |
680 | DECL_VISIBILITY_SPECIFIED. */ | |
681 | void (*determine_class_data_visibility) (tree decl); | |
682 | /* Returns true (the default) if virtual tables and other | |
683 | similar implicit class data objects are always COMDAT if they | |
684 | have external linkage. If this hook returns false, then | |
685 | class data for classes whose virtual table will be emitted in | |
686 | only one translation unit will not be COMDAT. */ | |
687 | bool (*class_data_always_comdat) (void); | |
46b9ff5e | 688 | /* Returns true if __aeabi_atexit should be used to register static |
689 | destructors. */ | |
690 | bool (*use_aeabi_atexit) (void); | |
6c1e551f | 691 | /* TYPE is a C++ class (i.e., RECORD_TYPE or UNION_TYPE) that |
692 | has just been defined. Use this hook to make adjustments to the | |
693 | class (eg, tweak visibility or perform any other required | |
694 | target modifications). */ | |
695 | void (*adjust_class_at_definition) (tree type); | |
c1dc02de | 696 | } cxx; |
697 | ||
1774763d | 698 | /* True if unwinding tables should be generated by default. */ |
699 | bool unwind_tables_default; | |
700 | ||
33459320 | 701 | /* Leave the boolean fields at the end. */ |
702 | ||
703 | /* True if arbitrary sections are supported. */ | |
704 | bool have_named_sections; | |
705 | ||
706 | /* True if "native" constructors and destructors are supported, | |
707 | false if we're using collect2 for the job. */ | |
708 | bool have_ctors_dtors; | |
2a6f0f81 | 709 | |
710 | /* True if thread-local storage is supported. */ | |
711 | bool have_tls; | |
9292e3be | 712 | |
713 | /* True if a small readonly data section is supported. */ | |
714 | bool have_srodata_section; | |
a08b74c8 | 715 | |
716 | /* True if EH frame info sections should be zero-terminated. */ | |
717 | bool terminate_dw2_eh_frame_info; | |
92c473b8 | 718 | |
719 | /* True if #NO_APP should be emitted at the beginning of | |
720 | assembly output. */ | |
721 | bool file_start_app_off; | |
722 | ||
723 | /* True if output_file_directive should be called for main_input_filename | |
724 | at the beginning of assembly output. */ | |
725 | bool file_start_file_directive; | |
45550790 | 726 | |
146c1b4f | 727 | /* True if #pragma redefine_extname is to be supported. */ |
728 | bool handle_pragma_redefine_extname; | |
729 | ||
730 | /* True if #pragma extern_prefix is to be supported. */ | |
731 | bool handle_pragma_extern_prefix; | |
732 | ||
2ca3d426 | 733 | /* True if the target is allowed to reorder memory accesses unless |
734 | synchronization is explicitly requested. */ | |
735 | bool relaxed_ordering; | |
736 | ||
1774763d | 737 | /* Returns true if we should generate exception tables for use with the |
738 | ARM EABI. The effects the encoding of function exception specifications. | |
739 | */ | |
740 | bool arm_eabi_unwinder; | |
741 | ||
92d40bc4 | 742 | /* Leave the boolean fields at the end. */ |
a767736d | 743 | }; |
744 | ||
57e4bbfb | 745 | extern struct gcc_target targetm; |
bcf3c70d | 746 | |
747 | #endif /* GCC_TARGET_H */ |