]>
Commit | Line | Data |
---|---|---|
672a6f42 | 1 | /* Data structure definitions for a generic GCC target. |
d9221e01 | 2 | Copyright (C) 2001, 2002, 2003, 2004 Free Software Foundation, Inc. |
672a6f42 NB |
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 | |
16 | Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. | |
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. | |
17b53c33 | 23 | At present it is incomplete, but in future it should grow to |
672a6f42 NB |
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 | |
f6897b10 | 36 | "targetm" like so: |
672a6f42 | 37 | |
f6897b10 | 38 | struct gcc_target targetm = TARGET_INITIALIZER; |
672a6f42 NB |
39 | |
40 | Doing things this way allows us to bring together everything that | |
17b53c33 NB |
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. */ | |
672a6f42 | 46 | |
59587b18 JQ |
47 | #ifndef GCC_TARGET_H |
48 | #define GCC_TARGET_H | |
49 | ||
7bb1ad93 | 50 | #include "tm.h" |
59587b18 | 51 | #include "insn-modes.h" |
7bb1ad93 | 52 | |
672a6f42 NB |
53 | struct gcc_target |
54 | { | |
08c148a8 NB |
55 | /* Functions that output assembler for the target. */ |
56 | struct asm_out | |
57 | { | |
17b53c33 NB |
58 | /* Opening and closing parentheses for asm expression grouping. */ |
59 | const char *open_paren, *close_paren; | |
60 | ||
301d03af RS |
61 | /* Assembler instructions for creating various kinds of integer object. */ |
62 | const char *byte_op; | |
63 | struct asm_int_op | |
64 | { | |
65 | const char *hi; | |
66 | const char *si; | |
67 | const char *di; | |
68 | const char *ti; | |
69 | } aligned_op, unaligned_op; | |
70 | ||
71 | /* Try to output the assembler code for an integer object whose | |
72 | value is given by X. SIZE is the size of the object in bytes and | |
73 | ALIGNED_P indicates whether it is aligned. Return true if | |
74 | successful. Only handles cases for which BYTE_OP, ALIGNED_OP | |
75 | and UNALIGNED_OP are NULL. */ | |
46c5ad27 | 76 | bool (* integer) (rtx x, unsigned int size, int aligned_p); |
301d03af | 77 | |
5eb99654 | 78 | /* Output code that will globalize a label. */ |
46c5ad27 | 79 | void (* globalize_label) (FILE *, const char *); |
5eb99654 | 80 | |
4746cf84 MA |
81 | /* Output code that will emit a label for unwind info, if this |
82 | target requires such labels. Second argument is the decl the | |
eeab4d81 MS |
83 | unwind info is associated with, third is a boolean: true if |
84 | this is for exception handling, fourth is a boolean: true if | |
9cf737f8 | 85 | this is only a placeholder for an omitted FDE. */ |
eeab4d81 | 86 | void (* unwind_label) (FILE *, tree, int, int); |
4746cf84 | 87 | |
951120ea PB |
88 | /* Emit any directives required to unwind this instruction. */ |
89 | void (* unwind_emit) (FILE *, rtx); | |
90 | ||
4977bab6 | 91 | /* Output an internal label. */ |
46c5ad27 | 92 | void (* internal_label) (FILE *, const char *, unsigned long); |
4977bab6 | 93 | |
93638d7a AM |
94 | /* Emit an assembler directive to set visibility for the symbol |
95 | associated with the tree decl. */ | |
46c5ad27 | 96 | void (* visibility) (tree, int); |
93638d7a | 97 | |
08c148a8 | 98 | /* Output the assembler code for entry to a function. */ |
46c5ad27 | 99 | void (* function_prologue) (FILE *, HOST_WIDE_INT); |
08c148a8 | 100 | |
b4c25db2 | 101 | /* Output the assembler code for end of prologue. */ |
46c5ad27 | 102 | void (* function_end_prologue) (FILE *); |
b4c25db2 NB |
103 | |
104 | /* Output the assembler code for start of epilogue. */ | |
46c5ad27 | 105 | void (* function_begin_epilogue) (FILE *); |
b4c25db2 | 106 | |
08c148a8 | 107 | /* Output the assembler code for function exit. */ |
46c5ad27 | 108 | void (* function_epilogue) (FILE *, HOST_WIDE_INT); |
7c262518 | 109 | |
c18a5b6c MM |
110 | /* Tell assembler to change to section NAME with attributes FLAGS. |
111 | If DECL is non-NULL, it is the VAR_DECL or FUNCTION_DECL with | |
112 | which this section is associated. */ | |
113 | void (* named_section) (const char *name, unsigned int flags, tree decl); | |
2cc07db4 | 114 | |
07c9d2eb | 115 | /* Switch to the section that holds the exception table. */ |
46c5ad27 | 116 | void (* exception_section) (void); |
07c9d2eb SS |
117 | |
118 | /* Switch to the section that holds the exception frames. */ | |
46c5ad27 | 119 | void (* eh_frame_section) (void); |
07c9d2eb | 120 | |
ae46c4e0 | 121 | /* Select and switch to a section for EXP. It may be a DECL or a |
0864034e ZW |
122 | constant. RELOC is nonzero if runtime relocations must be applied; |
123 | bit 1 will be set if the runtime relocations require non-local | |
124 | name resolution. ALIGN is the required alignment of the data. */ | |
46c5ad27 | 125 | void (* select_section) (tree, int, unsigned HOST_WIDE_INT); |
ae46c4e0 | 126 | |
b64a1b53 RH |
127 | /* Select and switch to a section for X with MODE. ALIGN is |
128 | the desired alignment of the data. */ | |
46c5ad27 AJ |
129 | void (* select_rtx_section) (enum machine_mode, rtx, |
130 | unsigned HOST_WIDE_INT); | |
b64a1b53 | 131 | |
ae46c4e0 RH |
132 | /* Select a unique section name for DECL. RELOC is the same as |
133 | for SELECT_SECTION. */ | |
46c5ad27 | 134 | void (* unique_section) (tree, int); |
ae46c4e0 | 135 | |
ab5c8549 JJ |
136 | /* Tell assembler to switch to the readonly data section associated |
137 | with function DECL. */ | |
f676971a | 138 | void (* function_rodata_section) (tree); |
ab5c8549 | 139 | |
2cc07db4 | 140 | /* Output a constructor for a symbol with a given priority. */ |
46c5ad27 | 141 | void (* constructor) (rtx, int); |
2cc07db4 RH |
142 | |
143 | /* Output a destructor for a symbol with a given priority. */ | |
46c5ad27 | 144 | void (* destructor) (rtx, int); |
483ab821 | 145 | |
3961e8fe RH |
146 | /* Output the assembler code for a thunk function. THUNK_DECL is the |
147 | declaration for the thunk function itself, FUNCTION is the decl for | |
148 | the target function. DELTA is an immediate constant offset to be | |
476c5eb6 | 149 | added to THIS. If VCALL_OFFSET is nonzero, the word at |
3961e8fe | 150 | *(*this + vcall_offset) should be added to THIS. */ |
46c5ad27 AJ |
151 | void (* output_mi_thunk) (FILE *file, tree thunk_decl, |
152 | HOST_WIDE_INT delta, HOST_WIDE_INT vcall_offset, | |
153 | tree function_decl); | |
3961e8fe RH |
154 | |
155 | /* Determine whether output_mi_thunk would succeed. */ | |
156 | /* ??? Ideally, this hook would not exist, and success or failure | |
157 | would be returned from output_mi_thunk directly. But there's | |
158 | too much undo-able setup involved in invoking output_mi_thunk. | |
159 | Could be fixed by making output_mi_thunk emit rtl instead of | |
160 | text to the output file. */ | |
46c5ad27 AJ |
161 | bool (* can_output_mi_thunk) (tree thunk_decl, HOST_WIDE_INT delta, |
162 | HOST_WIDE_INT vcall_offset, | |
163 | tree function_decl); | |
a5fe455b | 164 | |
1bc7c5b6 ZW |
165 | /* Output any boilerplate text needed at the beginning of a |
166 | translation unit. */ | |
46c5ad27 | 167 | void (*file_start) (void); |
1bc7c5b6 ZW |
168 | |
169 | /* Output any boilerplate text needed at the end of a | |
170 | translation unit. */ | |
46c5ad27 | 171 | void (*file_end) (void); |
6773a41c RO |
172 | |
173 | /* Output an assembler pseudo-op to declare a library function name | |
174 | external. */ | |
175 | void (*external_libcall) (rtx); | |
8e3e233b DP |
176 | |
177 | /* Output an assembler directive to mark decl live. This instructs | |
178 | linker to not dead code strip this symbol. */ | |
179 | void (*mark_decl_preserved) (const char *); | |
180 | ||
08c148a8 NB |
181 | } asm_out; |
182 | ||
c237e94a ZW |
183 | /* Functions relating to instruction scheduling. */ |
184 | struct sched | |
185 | { | |
186 | /* Given the current cost, COST, of an insn, INSN, calculate and | |
187 | return a new cost based on its relationship to DEP_INSN through | |
188 | the dependence LINK. The default is to make no adjustment. */ | |
46c5ad27 | 189 | int (* adjust_cost) (rtx insn, rtx link, rtx def_insn, int cost); |
c237e94a ZW |
190 | |
191 | /* Adjust the priority of an insn as you see fit. Returns the new | |
192 | priority. */ | |
46c5ad27 | 193 | int (* adjust_priority) (rtx, int); |
c237e94a ZW |
194 | |
195 | /* Function which returns the maximum number of insns that can be | |
196 | scheduled in the same machine cycle. This must be constant | |
197 | over an entire compilation. The default is 1. */ | |
46c5ad27 | 198 | int (* issue_rate) (void); |
c237e94a ZW |
199 | |
200 | /* Calculate how much this insn affects how many more insns we | |
201 | can emit this cycle. Default is they all cost the same. */ | |
46c5ad27 | 202 | int (* variable_issue) (FILE *, int, rtx, int); |
41077ce4 | 203 | |
c237e94a | 204 | /* Initialize machine-dependent scheduling code. */ |
46c5ad27 | 205 | void (* md_init) (FILE *, int, int); |
c237e94a ZW |
206 | |
207 | /* Finalize machine-dependent scheduling code. */ | |
46c5ad27 | 208 | void (* md_finish) (FILE *, int); |
c237e94a | 209 | |
58565a33 SKG |
210 | /* Initialize machine-dependent function while scheduling code. */ |
211 | void (* md_init_global) (FILE *, int, int); | |
212 | ||
213 | /* Finalize machine-dependent function wide scheduling code. */ | |
214 | void (* md_finish_global) (FILE *, int); | |
215 | ||
c237e94a ZW |
216 | /* Reorder insns in a machine-dependent fashion, in two different |
217 | places. Default does nothing. */ | |
46c5ad27 AJ |
218 | int (* reorder) (FILE *, int, rtx *, int *, int); |
219 | int (* reorder2) (FILE *, int, rtx *, int *, int); | |
c237e94a | 220 | |
30028c85 VM |
221 | /* The following member value is a pointer to a function called |
222 | after evaluation forward dependencies of insns in chain given | |
223 | by two parameter values (head and tail correspondingly). */ | |
46c5ad27 | 224 | void (* dependencies_evaluation_hook) (rtx, rtx); |
30028c85 | 225 | |
fae15c93 VM |
226 | /* The values of the following four members are pointers to |
227 | functions used to simplify the automaton descriptions. | |
228 | dfa_pre_cycle_insn and dfa_post_cycle_insn give functions | |
229 | returning insns which are used to change the pipeline hazard | |
230 | recognizer state when the new simulated processor cycle | |
231 | correspondingly starts and finishes. The function defined by | |
232 | init_dfa_pre_cycle_insn and init_dfa_post_cycle_insn are used | |
233 | to initialize the corresponding insns. The default values of | |
d91edf86 | 234 | the members result in not changing the automaton state when |
fae15c93 VM |
235 | the new simulated processor cycle correspondingly starts and |
236 | finishes. */ | |
46c5ad27 AJ |
237 | void (* init_dfa_pre_cycle_insn) (void); |
238 | rtx (* dfa_pre_cycle_insn) (void); | |
239 | void (* init_dfa_post_cycle_insn) (void); | |
240 | rtx (* dfa_post_cycle_insn) (void); | |
fa0aee89 | 241 | |
fae15c93 VM |
242 | /* The following member value is a pointer to a function returning value |
243 | which defines how many insns in queue `ready' will we try for | |
5ad6fca5 | 244 | multi-pass scheduling. If the member value is nonzero and the |
fae15c93 VM |
245 | function returns positive value, the DFA based scheduler will make |
246 | multi-pass scheduling for the first cycle. In other words, we will | |
247 | try to choose ready insn which permits to start maximum number of | |
248 | insns on the same cycle. */ | |
46c5ad27 | 249 | int (* first_cycle_multipass_dfa_lookahead) (void); |
fa0aee89 | 250 | |
30028c85 VM |
251 | /* The following member value is pointer to a function controlling |
252 | what insns from the ready insn queue will be considered for the | |
253 | multipass insn scheduling. If the hook returns zero for insn | |
254 | passed as the parameter, the insn will be not chosen to be | |
255 | issued. */ | |
46c5ad27 | 256 | int (* first_cycle_multipass_dfa_lookahead_guard) (rtx); |
fa0aee89 | 257 | |
30028c85 VM |
258 | /* The following member value is pointer to a function called by |
259 | the insn scheduler before issuing insn passed as the third | |
260 | parameter on given cycle. If the hook returns nonzero, the | |
261 | insn is not issued on given processors cycle. Instead of that, | |
262 | the processor cycle is advanced. If the value passed through | |
263 | the last parameter is zero, the insn ready queue is not sorted | |
264 | on the new cycle start as usually. The first parameter passes | |
265 | file for debugging output. The second one passes the scheduler | |
266 | verbose level of the debugging output. The forth and the fifth | |
267 | parameter values are correspondingly processor cycle on which | |
268 | the previous insn has been issued and the current processor | |
269 | cycle. */ | |
46c5ad27 | 270 | int (* dfa_new_cycle) (FILE *, int, rtx, int, int, int *); |
fa0aee89 | 271 | |
569fa502 DN |
272 | /* The following member value is a pointer to a function called |
273 | by the insn scheduler. It should return true if there exists a | |
f676971a EC |
274 | dependence which is considered costly by the target, between |
275 | the insn passed as the first parameter, and the insn passed as | |
276 | the second parameter. The third parameter is the INSN_DEPEND | |
569fa502 DN |
277 | link that represents the dependence between the two insns. The |
278 | fourth argument is the cost of the dependence as estimated by | |
f676971a | 279 | the scheduler. The last argument is the distance in cycles |
569fa502 | 280 | between the already scheduled insn (first parameter) and the |
80fcc7bc SB |
281 | the second insn (second parameter). */ |
282 | bool (* is_costly_dependence) (rtx, rtx, rtx, int, int); | |
c237e94a ZW |
283 | } sched; |
284 | ||
8c27b7d4 | 285 | /* Return machine mode for filter value. */ |
93f90be6 FJ |
286 | enum machine_mode (* eh_return_filter_mode) (void); |
287 | ||
672a6f42 | 288 | /* Given two decls, merge their attributes and return the result. */ |
46c5ad27 | 289 | tree (* merge_decl_attributes) (tree, tree); |
672a6f42 NB |
290 | |
291 | /* Given two types, merge their attributes and return the result. */ | |
46c5ad27 | 292 | tree (* merge_type_attributes) (tree, tree); |
672a6f42 | 293 | |
349ae713 NB |
294 | /* Table of machine attributes and functions to handle them. |
295 | Ignored if NULL. */ | |
91d231cb | 296 | const struct attribute_spec *attribute_table; |
8d8e52be JM |
297 | |
298 | /* Return zero if the attributes on TYPE1 and TYPE2 are incompatible, | |
299 | one if they are compatible and two if they are nearly compatible | |
300 | (which causes a warning to be generated). */ | |
46c5ad27 | 301 | int (* comp_type_attributes) (tree type1, tree type2); |
8d8e52be JM |
302 | |
303 | /* Assign default attributes to the newly defined TYPE. */ | |
46c5ad27 | 304 | void (* set_default_type_attributes) (tree type); |
12a68f1f JM |
305 | |
306 | /* Insert attributes on the newly created DECL. */ | |
46c5ad27 | 307 | void (* insert_attributes) (tree decl, tree *attributes); |
f6155fda | 308 | |
91d231cb JM |
309 | /* Return true if FNDECL (which has at least one machine attribute) |
310 | can be inlined despite its machine attributes, false otherwise. */ | |
46c5ad27 | 311 | bool (* function_attribute_inlinable_p) (tree fndecl); |
91d231cb | 312 | |
f913c102 AO |
313 | /* Return true if bitfields in RECORD_TYPE should follow the |
314 | Microsoft Visual C++ bitfield layout rules. */ | |
46c5ad27 | 315 | bool (* ms_bitfield_layout_p) (tree record_type); |
f913c102 | 316 | |
13c1cd82 PB |
317 | /* Return true if anonymous bitfields affect structure alignment. */ |
318 | bool (* align_anon_bitfield) (void); | |
319 | ||
f6155fda | 320 | /* Set up target-specific built-in functions. */ |
46c5ad27 | 321 | void (* init_builtins) (void); |
f6155fda SS |
322 | |
323 | /* Expand a target-specific builtin. */ | |
46c5ad27 AJ |
324 | rtx (* expand_builtin) (tree exp, rtx target, rtx subtarget, |
325 | enum machine_mode mode, int ignore); | |
7c262518 | 326 | |
f18eca82 ZL |
327 | /* For a vendor-specific fundamental TYPE, return a pointer to |
328 | a statically-allocated string containing the C++ mangling for | |
329 | TYPE. In all other cases, return NULL. */ | |
330 | const char * (* mangle_fundamental_type) (tree type); | |
331 | ||
c15c90bb ZW |
332 | /* Make any adjustments to libfunc names needed for this target. */ |
333 | void (* init_libfuncs) (void); | |
334 | ||
7c262518 RH |
335 | /* Given a decl, a section name, and whether the decl initializer |
336 | has relocs, choose attributes for the section. */ | |
337 | /* ??? Should be merged with SELECT_SECTION and UNIQUE_SECTION. */ | |
46c5ad27 | 338 | unsigned int (* section_type_flags) (tree, const char *, int); |
7c262518 | 339 | |
e4ec2cac AO |
340 | /* True if new jumps cannot be created, to replace existing ones or |
341 | not, at the current point in the compilation. */ | |
46c5ad27 | 342 | bool (* cannot_modify_jumps_p) (void); |
ae46c4e0 | 343 | |
a3424f5c RH |
344 | /* Return a register class for which branch target register |
345 | optimizations should be applied. */ | |
46c5ad27 | 346 | int (* branch_target_register_class) (void); |
a3424f5c RH |
347 | |
348 | /* Return true if branch target register optimizations should include | |
349 | callee-saved registers that are not already live during the current | |
350 | function. AFTER_PE_GEN is true if prologues and epilogues have | |
351 | already been generated. */ | |
46c5ad27 | 352 | bool (* branch_target_register_callee_saved) (bool after_pe_gen); |
fe3ad572 | 353 | |
3a04ff64 | 354 | /* True if the constant X cannot be placed in the constant pool. */ |
46c5ad27 | 355 | bool (* cannot_force_const_mem) (rtx); |
3a04ff64 | 356 | |
0b077eac | 357 | /* True if the insn X cannot be duplicated. */ |
46c5ad27 | 358 | bool (* cannot_copy_insn_p) (rtx); |
0b077eac | 359 | |
7daebb7a | 360 | /* Given an address RTX, undo the effects of LEGITIMIZE_ADDRESS. */ |
46c5ad27 | 361 | rtx (* delegitimize_address) (rtx); |
7daebb7a | 362 | |
4977bab6 ZW |
363 | /* True if it is OK to do sibling call optimization for the specified |
364 | call expression EXP. DECL will be the called function, or NULL if | |
365 | this is an indirect call. */ | |
46c5ad27 AJ |
366 | bool (*function_ok_for_sibcall) (tree decl, tree exp); |
367 | ||
ae46c4e0 | 368 | /* True if EXP should be placed in a "small data" section. */ |
46c5ad27 | 369 | bool (* in_small_data_p) (tree); |
fb49053f | 370 | |
47754fd5 RH |
371 | /* True if EXP names an object for which name resolution must resolve |
372 | to the current module. */ | |
46c5ad27 | 373 | bool (* binds_local_p) (tree); |
47754fd5 | 374 | |
fb49053f RH |
375 | /* Do something target-specific to record properties of the DECL into |
376 | the associated SYMBOL_REF. */ | |
46c5ad27 | 377 | void (* encode_section_info) (tree, rtx, int); |
772c5265 RH |
378 | |
379 | /* Undo the effects of encode_section_info on the symbol string. */ | |
46c5ad27 | 380 | const char * (* strip_name_encoding) (const char *); |
47754fd5 | 381 | |
273a2526 RS |
382 | /* If shift optabs for MODE are known to always truncate the shift count, |
383 | return the mask that they apply. Return 0 otherwise. */ | |
384 | unsigned HOST_WIDE_INT (* shift_truncation_mask) (enum machine_mode mode); | |
385 | ||
3c50106f | 386 | /* True if MODE is valid for a pointer in __attribute__((mode("MODE"))). */ |
46c5ad27 | 387 | bool (* valid_pointer_mode) (enum machine_mode mode); |
3c50106f | 388 | |
6dd53648 RH |
389 | /* True if MODE is valid for the target. By "valid", we mean able to |
390 | be manipulated in non-trivial ways. In particular, this means all | |
391 | the arithmetic is supported. */ | |
392 | bool (* scalar_mode_supported_p) (enum machine_mode mode); | |
393 | ||
394 | /* Similarly for vector modes. "Supported" here is less strict. At | |
395 | least some operations are supported; need to check optabs or builtins | |
396 | for further details. */ | |
f676971a EC |
397 | bool (* vector_mode_supported_p) (enum machine_mode mode); |
398 | ||
c8e4f0e9 | 399 | /* True if a vector is opaque. */ |
46c5ad27 | 400 | bool (* vector_opaque_p) (tree); |
62e1dfcf | 401 | |
3c50106f RH |
402 | /* Compute a (partial) cost for rtx X. Return true if the complete |
403 | cost has been computed, and false if subexpressions should be | |
404 | scanned. In either case, *TOTAL contains the cost result. */ | |
405 | /* Note that CODE and OUTER_CODE ought to be RTX_CODE, but that's | |
406 | not necessarily defined at this point. */ | |
46c5ad27 | 407 | bool (* rtx_costs) (rtx x, int code, int outer_code, int *total); |
3c50106f | 408 | |
dcefdf67 RH |
409 | /* Compute the cost of X, used as an address. Never called with |
410 | invalid addresses. */ | |
46c5ad27 | 411 | int (* address_cost) (rtx x); |
dcefdf67 | 412 | |
96714395 AH |
413 | /* Given a register, this hook should return a parallel of registers |
414 | to represent where to find the register pieces. Define this hook | |
415 | if the register and its mode are represented in Dwarf in | |
416 | non-contiguous locations, or if the register should be | |
417 | represented in more than one register in Dwarf. Otherwise, this | |
418 | hook should return NULL_RTX. */ | |
46c5ad27 | 419 | rtx (* dwarf_register_span) (rtx); |
96714395 | 420 | |
e129d93a ILT |
421 | /* Fetch the fixed register(s) which hold condition codes, for |
422 | targets where it makes sense to look for duplicate assignments to | |
423 | the condition codes. This should return true if there is such a | |
424 | register, false otherwise. The arguments should be set to the | |
425 | fixed register numbers. Up to two condition code registers are | |
426 | supported. If there is only one for this target, the int pointed | |
427 | at by the second argument should be set to -1. */ | |
428 | bool (* fixed_condition_code_regs) (unsigned int *, unsigned int *); | |
429 | ||
430 | /* If two condition code modes are compatible, return a condition | |
431 | code mode which is compatible with both, such that a comparison | |
432 | done in the returned mode will work for both of the original | |
433 | modes. If the condition code modes are not compatible, return | |
434 | VOIDmode. */ | |
435 | enum machine_mode (* cc_modes_compatible) (enum machine_mode, | |
436 | enum machine_mode); | |
437 | ||
18dbd950 RS |
438 | /* Do machine-dependent code transformations. Called just before |
439 | delayed-branch scheduling. */ | |
46c5ad27 | 440 | void (* machine_dependent_reorg) (void); |
18dbd950 | 441 | |
c35d187f RH |
442 | /* Create the __builtin_va_list type. */ |
443 | tree (* build_builtin_va_list) (void); | |
444 | ||
cdc3ddb8 RH |
445 | /* Gimplifies a VA_ARG_EXPR. */ |
446 | tree (* gimplify_va_arg_expr) (tree valist, tree type, tree *pre_p, | |
447 | tree *post_p); | |
448 | ||
7bb1ad93 GK |
449 | /* Validity-checking routines for PCH files, target-specific. |
450 | get_pch_validity returns a pointer to the data to be stored, | |
451 | and stores the size in its argument. pch_valid_p gets the same | |
452 | information back and returns NULL if the PCH is valid, | |
453 | or an error message if not. | |
454 | */ | |
455 | void * (* get_pch_validity) (size_t *); | |
456 | const char * (* pch_valid_p) (const void *, size_t); | |
457 | ||
a841ab8b | 458 | /* True if the compiler should give an enum type only as many |
221ee7c9 KH |
459 | bytes as it takes to represent the range of possible values of |
460 | that type. */ | |
461 | bool (* default_short_enums) (void); | |
462 | ||
d6da68b9 | 463 | /* This target hook returns an rtx that is used to store the address |
a841ab8b | 464 | of the current frame into the built-in setjmp buffer. */ |
d6da68b9 KH |
465 | rtx (* builtin_setjmp_frame_value) (void); |
466 | ||
67dfe110 KH |
467 | /* This target hook should add STRING_CST trees for any hard regs |
468 | the port wishes to automatically clobber for all asms. */ | |
469 | tree (* md_asm_clobbers) (tree); | |
470 | ||
42ba5130 RH |
471 | /* Functions relating to calls - argument passing, returns, etc. */ |
472 | struct calls { | |
473 | bool (*promote_function_args) (tree fntype); | |
474 | bool (*promote_function_return) (tree fntype); | |
475 | bool (*promote_prototypes) (tree fntype); | |
476 | rtx (*struct_value_rtx) (tree fndecl, int incoming); | |
477 | bool (*return_in_memory) (tree type, tree fndecl); | |
478 | bool (*return_in_msb) (tree type); | |
8cd5a4e0 RH |
479 | |
480 | /* Return true if a parameter must be passed by reference. TYPE may | |
481 | be null if this is a libcall. CA may be null if this query is | |
482 | from __builtin_va_arg. */ | |
483 | bool (*pass_by_reference) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
484 | tree type, bool named_arg); | |
485 | ||
42ba5130 RH |
486 | rtx (*expand_builtin_saveregs) (void); |
487 | /* Returns pretend_argument_size. */ | |
488 | void (*setup_incoming_varargs) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
489 | tree type, int *pretend_arg_size, | |
490 | int second_time); | |
491 | bool (*strict_argument_naming) (CUMULATIVE_ARGS *ca); | |
492 | /* Returns true if we should use | |
493 | targetm.calls.setup_incoming_varargs() and/or | |
494 | targetm.calls.strict_argument_naming(). */ | |
495 | bool (*pretend_outgoing_varargs_named) (CUMULATIVE_ARGS *ca); | |
496 | ||
497 | /* Given a complex type T, return true if a parameter of type T | |
498 | should be passed as two scalars. */ | |
499 | bool (* split_complex_arg) (tree type); | |
fe984136 RH |
500 | |
501 | /* Return true if type T, mode MODE, may not be passed in registers, | |
502 | but must be passed on the stack. */ | |
503 | /* ??? This predicate should be applied strictly after pass-by-reference. | |
504 | Need audit to verify that this is the case. */ | |
505 | bool (* must_pass_in_stack) (enum machine_mode mode, tree t); | |
6cdd5672 RH |
506 | |
507 | /* Return true if type TYPE, mode MODE, which is passed by reference, | |
508 | should have the object copy generated by the callee rather than | |
509 | the caller. It is never called for TYPE requiring constructors. */ | |
510 | bool (* callee_copies) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
511 | tree type, bool named); | |
42ba5130 RH |
512 | } calls; |
513 | ||
4185ae53 PB |
514 | /* Functions specific to the C++ frontend. */ |
515 | struct cxx { | |
516 | /* Return the integer type used for guard variables. */ | |
517 | tree (*guard_type) (void); | |
518 | /* Return true if only the low bit of the guard should be tested. */ | |
519 | bool (*guard_mask_bit) (void); | |
46e995e0 PB |
520 | /* Returns the size of the array cookie for an array of type. */ |
521 | tree (*get_cookie_size) (tree); | |
522 | /* Returns true if the element size should be stored in the | |
523 | array cookie. */ | |
524 | bool (*cookie_has_size) (void); | |
d59c7b4b NC |
525 | /* Allows backends to perform additional processing when |
526 | deciding if a class should be exported or imported. */ | |
527 | int (*import_export_class) (tree, int); | |
44d10c10 PB |
528 | /* Returns true if constructors and destructors return "this". */ |
529 | bool (*cdtor_returns_this) (void); | |
af287697 MM |
530 | /* Returns true if the key method for a class can be an inline |
531 | function, so long as it is not declared inline in the class | |
532 | itself. Returning true is the behavior required by the Itanium | |
533 | C++ ABI. */ | |
534 | bool (*key_method_may_be_inline) (void); | |
505970fc MM |
535 | /* Returns true if all class data (virtual tables, type info, |
536 | etc.) should be exported from the current DLL, even when the | |
537 | associated class is not exported. */ | |
538 | bool (*export_class_data) (void); | |
4185ae53 PB |
539 | } cxx; |
540 | ||
47754fd5 RH |
541 | /* Leave the boolean fields at the end. */ |
542 | ||
543 | /* True if arbitrary sections are supported. */ | |
544 | bool have_named_sections; | |
545 | ||
546 | /* True if "native" constructors and destructors are supported, | |
547 | false if we're using collect2 for the job. */ | |
548 | bool have_ctors_dtors; | |
3d78f2e9 RH |
549 | |
550 | /* True if thread-local storage is supported. */ | |
551 | bool have_tls; | |
275b6d80 DE |
552 | |
553 | /* True if a small readonly data section is supported. */ | |
554 | bool have_srodata_section; | |
7606e68f SS |
555 | |
556 | /* True if EH frame info sections should be zero-terminated. */ | |
557 | bool terminate_dw2_eh_frame_info; | |
1bc7c5b6 ZW |
558 | |
559 | /* True if #NO_APP should be emitted at the beginning of | |
560 | assembly output. */ | |
561 | bool file_start_app_off; | |
562 | ||
563 | /* True if output_file_directive should be called for main_input_filename | |
564 | at the beginning of assembly output. */ | |
565 | bool file_start_file_directive; | |
61f71b34 | 566 | |
84b8b0e0 ZW |
567 | /* True if #pragma redefine_extname is to be supported. */ |
568 | bool handle_pragma_redefine_extname; | |
569 | ||
570 | /* True if #pragma extern_prefix is to be supported. */ | |
571 | bool handle_pragma_extern_prefix; | |
572 | ||
9ac617d4 EB |
573 | /* True if the RTL prologue and epilogue should be expanded after all |
574 | passes that modify the instructions (and not merely reorder them) | |
575 | have been run. */ | |
576 | bool late_rtl_prologue_epilogue; | |
577 | ||
42ba5130 | 578 | /* Leave the boolean fields at the end. */ |
672a6f42 NB |
579 | }; |
580 | ||
f6897b10 | 581 | extern struct gcc_target targetm; |
59587b18 JQ |
582 | |
583 | #endif /* GCC_TARGET_H */ |