]>
Commit | Line | Data |
---|---|---|
a767736d | 1 | /* Data structure definitions for a generic GCC target. |
cfaf579d | 2 | Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 |
4dc5882f | 3 | Free Software Foundation, Inc. |
a767736d | 4 | |
8c4c00c1 | 5 | This program is free software; you can redistribute it and/or modify it |
6 | under the terms of the GNU General Public License as published by the | |
7 | Free Software Foundation; either version 3, or (at your option) any | |
8 | later version. | |
9 | ||
10 | This program is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | GNU General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU General Public License | |
16 | along with this program; see the file COPYING3. If not see | |
17 | <http://www.gnu.org/licenses/>. | |
18 | ||
19 | In other words, you are welcome to use, share and improve this program. | |
20 | You are forbidden to forbid anyone else to use, share and improve | |
21 | what you give them. Help stamp out software-hoarding! */ | |
22 | ||
a767736d | 23 | |
24 | /* This file contains a data structure that describes a GCC target. | |
11ff5d0d | 25 | At present it is incomplete, but in future it should grow to |
a767736d | 26 | contain most or all target machine and target O/S specific |
27 | information. | |
28 | ||
29 | This structure has its initializer declared in target-def.h in the | |
30 | form of large macro TARGET_INITIALIZER that expands to many smaller | |
31 | macros. | |
32 | ||
33 | The smaller macros each initialize one component of the structure, | |
34 | and each has a default. Each target should have a file that | |
35 | includes target.h and target-def.h, and overrides any inappropriate | |
36 | defaults by undefining the relevant macro and defining a suitable | |
37 | replacement. That file should then contain the definition of | |
57e4bbfb | 38 | "targetm" like so: |
a767736d | 39 | |
57e4bbfb | 40 | struct gcc_target targetm = TARGET_INITIALIZER; |
a767736d | 41 | |
42 | Doing things this way allows us to bring together everything that | |
11ff5d0d | 43 | defines a GCC target. By supplying a default that is appropriate |
44 | to most targets, we can easily add new items without needing to | |
45 | edit dozens of target configuration files. It should also allow us | |
46 | to gradually reduce the amount of conditional compilation that is | |
47 | scattered throughout GCC. */ | |
a767736d | 48 | |
bcf3c70d | 49 | #ifndef GCC_TARGET_H |
50 | #define GCC_TARGET_H | |
51 | ||
7988d6e2 | 52 | #include "tm.h" |
bcf3c70d | 53 | #include "insn-modes.h" |
7988d6e2 | 54 | |
7c6733e8 | 55 | /* Types used by the record_gcc_switches() target function. */ |
56 | typedef enum | |
57 | { | |
58 | SWITCH_TYPE_PASSED, /* A switch passed on the command line. */ | |
59 | SWITCH_TYPE_ENABLED, /* An option that is currently enabled. */ | |
60 | SWITCH_TYPE_DESCRIPTIVE, /* Descriptive text, not a switch or option. */ | |
61 | SWITCH_TYPE_LINE_START, /* Please emit any necessary text at the start of a line. */ | |
62 | SWITCH_TYPE_LINE_END /* Please emit a line terminator. */ | |
63 | } | |
64 | print_switch_type; | |
65 | ||
66 | typedef int (* print_switch_fn_type) (print_switch_type, const char *); | |
67 | ||
68 | /* An example implementation for ELF targets. Defined in varasm.c */ | |
69 | extern int elf_record_gcc_switches (print_switch_type type, const char *); | |
70 | ||
98155838 | 71 | /* Some places still assume that all pointer or address modes are the |
72 | standard Pmode and ptr_mode. These optimizations become invalid if | |
73 | the target actually supports multiple different modes. For now, | |
74 | we disable such optimizations on such targets, using this function. */ | |
75 | extern bool target_default_pointer_address_modes_p (void); | |
76 | ||
a6c787e5 | 77 | struct stdarg_info; |
6a1cdb4d | 78 | struct spec_info_def; |
a6c787e5 | 79 | |
4d58fa46 | 80 | /* The struct used by the secondary_reload target hook. */ |
81 | typedef struct secondary_reload_info | |
82 | { | |
83 | /* icode is actually an enum insn_code, but we don't want to force every | |
84 | file that includes target.h to include optabs.h . */ | |
85 | int icode; | |
86 | int extra_cost; /* Cost for using (a) scratch register(s) to be taken | |
87 | into account by copy_cost. */ | |
88 | /* The next two members are for the use of the backward | |
89 | compatibility hook. */ | |
90 | struct secondary_reload_info *prev_sri; | |
91 | int t_icode; /* Actually an enum insn_code - see above. */ | |
92 | } secondary_reload_info; | |
93 | ||
9997bd27 | 94 | /* This is defined in sched-int.h . */ |
95 | struct _dep; | |
4d58fa46 | 96 | |
d52fd16a | 97 | /* This is defined in ddg.h . */ |
98 | struct ddg; | |
99 | ||
0b09525f | 100 | /* Assembler instructions for creating various kinds of integer object. */ |
101 | ||
102 | struct asm_int_op | |
103 | { | |
104 | const char *hi; | |
105 | const char *si; | |
106 | const char *di; | |
107 | const char *ti; | |
108 | }; | |
109 | ||
110 | /* The target structure. This holds all the backend hooks. */ | |
111 | ||
a767736d | 112 | struct gcc_target |
113 | { | |
17d9b0c3 | 114 | /* Functions that output assembler for the target. */ |
115 | struct asm_out | |
116 | { | |
11ff5d0d | 117 | /* Opening and closing parentheses for asm expression grouping. */ |
118 | const char *open_paren, *close_paren; | |
119 | ||
58356836 | 120 | /* Assembler instructions for creating various kinds of integer object. */ |
121 | const char *byte_op; | |
0b09525f | 122 | struct asm_int_op aligned_op, unaligned_op; |
58356836 | 123 | |
124 | /* Try to output the assembler code for an integer object whose | |
125 | value is given by X. SIZE is the size of the object in bytes and | |
126 | ALIGNED_P indicates whether it is aligned. Return true if | |
127 | successful. Only handles cases for which BYTE_OP, ALIGNED_OP | |
128 | and UNALIGNED_OP are NULL. */ | |
60b8c5b3 | 129 | bool (* integer) (rtx x, unsigned int size, int aligned_p); |
58356836 | 130 | |
67c1e638 | 131 | /* Output code that will globalize a label. */ |
60b8c5b3 | 132 | void (* globalize_label) (FILE *, const char *); |
67c1e638 | 133 | |
312b8e4a | 134 | /* Output code that will globalize a declaration. */ |
9afff52d | 135 | void (* globalize_decl_name) (FILE *, tree); |
136 | ||
2f9fc8ef | 137 | /* Output code that will emit a label for unwind info, if this |
138 | target requires such labels. Second argument is the decl the | |
ef1074f7 | 139 | unwind info is associated with, third is a boolean: true if |
140 | this is for exception handling, fourth is a boolean: true if | |
0bed3869 | 141 | this is only a placeholder for an omitted FDE. */ |
ef1074f7 | 142 | void (* unwind_label) (FILE *, tree, int, int); |
2f9fc8ef | 143 | |
b215c058 | 144 | /* Output code that will emit a label to divide up the exception |
145 | table. */ | |
146 | void (* except_table_label) (FILE *); | |
147 | ||
8ec87476 | 148 | /* Emit any directives required to unwind this instruction. */ |
149 | void (* unwind_emit) (FILE *, rtx); | |
150 | ||
805e22b2 | 151 | /* Output an internal label. */ |
60b8c5b3 | 152 | void (* internal_label) (FILE *, const char *, unsigned long); |
805e22b2 | 153 | |
1774763d | 154 | /* Emit a ttype table reference to a typeinfo object. */ |
155 | bool (* ttype) (rtx); | |
156 | ||
2532673e | 157 | /* Emit an assembler directive to set visibility for the symbol |
158 | associated with the tree decl. */ | |
60b8c5b3 | 159 | void (* visibility) (tree, int); |
2532673e | 160 | |
17d9b0c3 | 161 | /* Output the assembler code for entry to a function. */ |
60b8c5b3 | 162 | void (* function_prologue) (FILE *, HOST_WIDE_INT); |
17d9b0c3 | 163 | |
85ae73e8 | 164 | /* Output the assembler code for end of prologue. */ |
60b8c5b3 | 165 | void (* function_end_prologue) (FILE *); |
85ae73e8 | 166 | |
167 | /* Output the assembler code for start of epilogue. */ | |
60b8c5b3 | 168 | void (* function_begin_epilogue) (FILE *); |
85ae73e8 | 169 | |
17d9b0c3 | 170 | /* Output the assembler code for function exit. */ |
60b8c5b3 | 171 | void (* function_epilogue) (FILE *, HOST_WIDE_INT); |
2cb4ac60 | 172 | |
2f14b1f9 | 173 | /* Initialize target-specific sections. */ |
174 | void (* init_sections) (void); | |
175 | ||
537cd941 | 176 | /* Tell assembler to change to section NAME with attributes FLAGS. |
177 | If DECL is non-NULL, it is the VAR_DECL or FUNCTION_DECL with | |
178 | which this section is associated. */ | |
179 | void (* named_section) (const char *name, unsigned int flags, tree decl); | |
01d15dc5 | 180 | |
4e151b05 | 181 | /* Return a mask describing how relocations should be treated when |
182 | selecting sections. Bit 1 should be set if global relocations | |
183 | should be placed in a read-write section; bit 0 should be set if | |
184 | local relocations should be placed in a read-write section. */ | |
185 | int (*reloc_rw_mask) (void); | |
186 | ||
2f14b1f9 | 187 | /* Return a section for EXP. It may be a DECL or a constant. RELOC |
188 | is nonzero if runtime relocations must be applied; bit 1 will be | |
189 | set if the runtime relocations require non-local name resolution. | |
190 | ALIGN is the required alignment of the data. */ | |
191 | section *(* select_section) (tree, int, unsigned HOST_WIDE_INT); | |
52470889 | 192 | |
2f14b1f9 | 193 | /* Return a section for X. MODE is X's mode and ALIGN is its |
194 | alignment in bits. */ | |
195 | section *(* select_rtx_section) (enum machine_mode, rtx, | |
196 | unsigned HOST_WIDE_INT); | |
bbfbe351 | 197 | |
52470889 | 198 | /* Select a unique section name for DECL. RELOC is the same as |
199 | for SELECT_SECTION. */ | |
60b8c5b3 | 200 | void (* unique_section) (tree, int); |
52470889 | 201 | |
2f14b1f9 | 202 | /* Return the readonly data section associated with function DECL. */ |
203 | section *(* function_rodata_section) (tree); | |
76aec42f | 204 | |
01d15dc5 | 205 | /* Output a constructor for a symbol with a given priority. */ |
60b8c5b3 | 206 | void (* constructor) (rtx, int); |
01d15dc5 | 207 | |
208 | /* Output a destructor for a symbol with a given priority. */ | |
60b8c5b3 | 209 | void (* destructor) (rtx, int); |
c6933ba6 | 210 | |
eb344f43 | 211 | /* Output the assembler code for a thunk function. THUNK_DECL is the |
212 | declaration for the thunk function itself, FUNCTION is the decl for | |
213 | the target function. DELTA is an immediate constant offset to be | |
6e7fc474 | 214 | added to THIS. If VCALL_OFFSET is nonzero, the word at |
eb344f43 | 215 | *(*this + vcall_offset) should be added to THIS. */ |
60b8c5b3 | 216 | void (* output_mi_thunk) (FILE *file, tree thunk_decl, |
217 | HOST_WIDE_INT delta, HOST_WIDE_INT vcall_offset, | |
218 | tree function_decl); | |
eb344f43 | 219 | |
220 | /* Determine whether output_mi_thunk would succeed. */ | |
221 | /* ??? Ideally, this hook would not exist, and success or failure | |
222 | would be returned from output_mi_thunk directly. But there's | |
223 | too much undo-able setup involved in invoking output_mi_thunk. | |
224 | Could be fixed by making output_mi_thunk emit rtl instead of | |
225 | text to the output file. */ | |
a9f1838b | 226 | bool (* can_output_mi_thunk) (const_tree thunk_decl, HOST_WIDE_INT delta, |
60b8c5b3 | 227 | HOST_WIDE_INT vcall_offset, |
a9f1838b | 228 | const_tree function_decl); |
f6940372 | 229 | |
92c473b8 | 230 | /* Output any boilerplate text needed at the beginning of a |
231 | translation unit. */ | |
60b8c5b3 | 232 | void (*file_start) (void); |
92c473b8 | 233 | |
234 | /* Output any boilerplate text needed at the end of a | |
235 | translation unit. */ | |
60b8c5b3 | 236 | void (*file_end) (void); |
864af209 | 237 | |
238 | /* Output an assembler pseudo-op to declare a library function name | |
239 | external. */ | |
240 | void (*external_libcall) (rtx); | |
9423c9b7 | 241 | |
7c6733e8 | 242 | /* Output an assembler directive to mark decl live. This instructs |
9423c9b7 | 243 | linker to not dead code strip this symbol. */ |
244 | void (*mark_decl_preserved) (const char *); | |
245 | ||
7c6733e8 | 246 | /* Output a record of the command line switches that have been passed. */ |
247 | print_switch_fn_type record_gcc_switches; | |
248 | /* The name of the section that the example ELF implementation of | |
249 | record_gcc_switches will use to store the information. Target | |
250 | specific versions of record_gcc_switches may or may not use | |
251 | this information. */ | |
252 | const char * record_gcc_switches_section; | |
253 | ||
f2d0e9f1 | 254 | /* Output the definition of a section anchor. */ |
255 | void (*output_anchor) (rtx); | |
256 | ||
40af64cc | 257 | /* Output a DTP-relative reference to a TLS symbol. */ |
258 | void (*output_dwarf_dtprel) (FILE *file, int size, rtx x); | |
259 | ||
e6554c42 | 260 | /* Some target machines need to postscan each insn after it is output. */ |
261 | void (*final_postscan_insn) (FILE *, rtx, rtx *, int); | |
82c7907c | 262 | |
263 | /* Emit the trampoline template. This hook may be NULL. */ | |
264 | void (*trampoline_template) (FILE *); | |
17d9b0c3 | 265 | } asm_out; |
266 | ||
747af5e7 | 267 | /* Functions relating to instruction scheduling. */ |
268 | struct sched | |
269 | { | |
270 | /* Given the current cost, COST, of an insn, INSN, calculate and | |
271 | return a new cost based on its relationship to DEP_INSN through | |
272 | the dependence LINK. The default is to make no adjustment. */ | |
9997bd27 | 273 | int (* adjust_cost) (rtx insn, rtx link, rtx dep_insn, int cost); |
747af5e7 | 274 | |
275 | /* Adjust the priority of an insn as you see fit. Returns the new | |
276 | priority. */ | |
60b8c5b3 | 277 | int (* adjust_priority) (rtx, int); |
747af5e7 | 278 | |
279 | /* Function which returns the maximum number of insns that can be | |
280 | scheduled in the same machine cycle. This must be constant | |
281 | over an entire compilation. The default is 1. */ | |
60b8c5b3 | 282 | int (* issue_rate) (void); |
747af5e7 | 283 | |
284 | /* Calculate how much this insn affects how many more insns we | |
285 | can emit this cycle. Default is they all cost the same. */ | |
60b8c5b3 | 286 | int (* variable_issue) (FILE *, int, rtx, int); |
6c34d0c2 | 287 | |
747af5e7 | 288 | /* Initialize machine-dependent scheduling code. */ |
60b8c5b3 | 289 | void (* md_init) (FILE *, int, int); |
747af5e7 | 290 | |
291 | /* Finalize machine-dependent scheduling code. */ | |
60b8c5b3 | 292 | void (* md_finish) (FILE *, int); |
747af5e7 | 293 | |
e1ab7874 | 294 | /* Initialize machine-dependent function wide scheduling code. */ |
f77a5bb0 | 295 | void (* md_init_global) (FILE *, int, int); |
296 | ||
297 | /* Finalize machine-dependent function wide scheduling code. */ | |
298 | void (* md_finish_global) (FILE *, int); | |
299 | ||
747af5e7 | 300 | /* Reorder insns in a machine-dependent fashion, in two different |
301 | places. Default does nothing. */ | |
60b8c5b3 | 302 | int (* reorder) (FILE *, int, rtx *, int *, int); |
303 | int (* reorder2) (FILE *, int, rtx *, int *, int); | |
747af5e7 | 304 | |
58ada791 | 305 | /* The following member value is a pointer to a function called |
306 | after evaluation forward dependencies of insns in chain given | |
307 | by two parameter values (head and tail correspondingly). */ | |
60b8c5b3 | 308 | void (* dependencies_evaluation_hook) (rtx, rtx); |
58ada791 | 309 | |
bea4bad2 | 310 | /* The values of the following four members are pointers to |
311 | functions used to simplify the automaton descriptions. | |
312 | dfa_pre_cycle_insn and dfa_post_cycle_insn give functions | |
313 | returning insns which are used to change the pipeline hazard | |
314 | recognizer state when the new simulated processor cycle | |
315 | correspondingly starts and finishes. The function defined by | |
316 | init_dfa_pre_cycle_insn and init_dfa_post_cycle_insn are used | |
317 | to initialize the corresponding insns. The default values of | |
40e55fbb | 318 | the members result in not changing the automaton state when |
bea4bad2 | 319 | the new simulated processor cycle correspondingly starts and |
320 | finishes. */ | |
60b8c5b3 | 321 | void (* init_dfa_pre_cycle_insn) (void); |
322 | rtx (* dfa_pre_cycle_insn) (void); | |
323 | void (* init_dfa_post_cycle_insn) (void); | |
324 | rtx (* dfa_post_cycle_insn) (void); | |
67900a4f | 325 | |
07317795 | 326 | /* The values of the following two members are pointers to |
327 | functions used to simplify the automaton descriptions. | |
328 | dfa_pre_advance_cycle and dfa_post_advance_cycle are getting called | |
becfaa62 | 329 | immediately before and after cycle is advanced. */ |
07317795 | 330 | void (* dfa_pre_advance_cycle) (void); |
331 | void (* dfa_post_advance_cycle) (void); | |
332 | ||
bea4bad2 | 333 | /* The following member value is a pointer to a function returning value |
334 | which defines how many insns in queue `ready' will we try for | |
4fa61ced | 335 | multi-pass scheduling. If the member value is nonzero and the |
bea4bad2 | 336 | function returns positive value, the DFA based scheduler will make |
337 | multi-pass scheduling for the first cycle. In other words, we will | |
338 | try to choose ready insn which permits to start maximum number of | |
339 | insns on the same cycle. */ | |
60b8c5b3 | 340 | int (* first_cycle_multipass_dfa_lookahead) (void); |
67900a4f | 341 | |
58ada791 | 342 | /* The following member value is pointer to a function controlling |
343 | what insns from the ready insn queue will be considered for the | |
344 | multipass insn scheduling. If the hook returns zero for insn | |
345 | passed as the parameter, the insn will be not chosen to be | |
346 | issued. */ | |
60b8c5b3 | 347 | int (* first_cycle_multipass_dfa_lookahead_guard) (rtx); |
67900a4f | 348 | |
58ada791 | 349 | /* The following member value is pointer to a function called by |
350 | the insn scheduler before issuing insn passed as the third | |
351 | parameter on given cycle. If the hook returns nonzero, the | |
352 | insn is not issued on given processors cycle. Instead of that, | |
353 | the processor cycle is advanced. If the value passed through | |
354 | the last parameter is zero, the insn ready queue is not sorted | |
355 | on the new cycle start as usually. The first parameter passes | |
356 | file for debugging output. The second one passes the scheduler | |
357 | verbose level of the debugging output. The forth and the fifth | |
358 | parameter values are correspondingly processor cycle on which | |
359 | the previous insn has been issued and the current processor | |
360 | cycle. */ | |
60b8c5b3 | 361 | int (* dfa_new_cycle) (FILE *, int, rtx, int, int, int *); |
67900a4f | 362 | |
9997bd27 | 363 | /* The following member value is a pointer to a function called by the |
364 | insn scheduler. It should return true if there exists a dependence | |
365 | which is considered costly by the target, between the insn | |
366 | DEP_PRO (&_DEP), and the insn DEP_CON (&_DEP). The first parameter is | |
367 | the dep that represents the dependence between the two insns. The | |
368 | second argument is the cost of the dependence as estimated by | |
9e7454d0 | 369 | the scheduler. The last argument is the distance in cycles |
52c4b43f | 370 | between the already scheduled insn (first parameter) and the |
f0b5f617 | 371 | second insn (second parameter). */ |
9997bd27 | 372 | bool (* is_costly_dependence) (struct _dep *_dep, int, int); |
6a1cdb4d | 373 | |
e1ab7874 | 374 | /* Given the current cost, COST, of an insn, INSN, calculate and |
375 | return a new cost based on its relationship to DEP_INSN through the | |
376 | dependence of type DEP_TYPE. The default is to make no adjustment. */ | |
377 | int (* adjust_cost_2) (rtx insn, int, rtx dep_insn, int cost, int dw); | |
378 | ||
6a1cdb4d | 379 | /* The following member value is a pointer to a function called |
380 | by the insn scheduler. This hook is called to notify the backend | |
381 | that new instructions were emitted. */ | |
382 | void (* h_i_d_extended) (void); | |
e1ab7874 | 383 | |
384 | /* Next 5 functions are for multi-point scheduling. */ | |
385 | ||
386 | /* Allocate memory for scheduler context. */ | |
387 | void *(* alloc_sched_context) (void); | |
388 | ||
389 | /* Fills the context from the local machine scheduler context. */ | |
390 | void (* init_sched_context) (void *, bool); | |
391 | ||
392 | /* Sets local machine scheduler context to a saved value. */ | |
393 | void (* set_sched_context) (void *); | |
394 | ||
395 | /* Clears a scheduler context so it becomes like after init. */ | |
396 | void (* clear_sched_context) (void *); | |
397 | ||
398 | /* Frees the scheduler context. */ | |
399 | void (* free_sched_context) (void *); | |
400 | ||
6a1cdb4d | 401 | /* The following member value is a pointer to a function called |
402 | by the insn scheduler. | |
403 | The first parameter is an instruction, the second parameter is the type | |
404 | of the requested speculation, and the third parameter is a pointer to the | |
405 | speculative pattern of the corresponding type (set if return value == 1). | |
406 | It should return | |
407 | -1, if there is no pattern, that will satisfy the requested speculation | |
408 | type, | |
409 | 0, if current pattern satisfies the requested speculation type, | |
410 | 1, if pattern of the instruction should be changed to the newly | |
411 | generated one. */ | |
4dc5882f | 412 | int (* speculate_insn) (rtx, int, rtx *); |
6a1cdb4d | 413 | |
414 | /* The following member value is a pointer to a function called | |
415 | by the insn scheduler. It should return true if the check instruction | |
e1ab7874 | 416 | passed as the parameter needs a recovery block. */ |
cf7898a6 | 417 | bool (* needs_block_p) (int); |
6a1cdb4d | 418 | |
419 | /* The following member value is a pointer to a function called | |
420 | by the insn scheduler. It should return a pattern for the check | |
421 | instruction. | |
422 | The first parameter is a speculative instruction, the second parameter | |
423 | is the label of the corresponding recovery block (or null, if it is a | |
424 | simple check). If the mutation of the check is requested (e.g. from | |
425 | ld.c to chk.a), the third parameter is true - in this case the first | |
426 | parameter is the previous check. */ | |
cf7898a6 | 427 | rtx (* gen_spec_check) (rtx, rtx, int); |
6a1cdb4d | 428 | |
429 | /* The following member value is a pointer to a function controlling | |
430 | what insns from the ready insn queue will be considered for the | |
431 | multipass insn scheduling. If the hook returns zero for the insn | |
432 | passed as the parameter, the insn will not be chosen to be | |
433 | issued. This hook is used to discard speculative instructions, | |
434 | that stand at the first position of the ready list. */ | |
a9f1838b | 435 | bool (* first_cycle_multipass_dfa_lookahead_guard_spec) (const_rtx); |
6a1cdb4d | 436 | |
437 | /* The following member value is a pointer to a function that provides | |
438 | information about the speculation capabilities of the target. | |
439 | The parameter is a pointer to spec_info variable. */ | |
440 | void (* set_sched_flags) (struct spec_info_def *); | |
d52fd16a | 441 | |
e1ab7874 | 442 | /* Return speculation types of the instruction passed as the parameter. */ |
443 | int (* get_insn_spec_ds) (rtx); | |
444 | ||
445 | /* Return speculation types that are checked for the instruction passed as | |
446 | the parameter. */ | |
447 | int (* get_insn_checked_ds) (rtx); | |
448 | ||
449 | /* Return bool if rtx scanning should just skip current layer and | |
450 | advance to the inner rtxes. */ | |
451 | bool (* skip_rtx_p) (const_rtx); | |
452 | ||
d52fd16a | 453 | /* The following member value is a pointer to a function that provides |
454 | information about the target resource-based lower bound which is | |
455 | used by the swing modulo scheduler. The parameter is a pointer | |
456 | to ddg variable. */ | |
457 | int (* sms_res_mii) (struct ddg *); | |
747af5e7 | 458 | } sched; |
459 | ||
b056d812 | 460 | /* Functions relating to vectorization. */ |
461 | struct vectorize | |
462 | { | |
f61467c8 | 463 | /* The following member value is a pointer to a function called |
b056d812 | 464 | by the vectorizer, and return the decl of the target builtin |
465 | function. */ | |
466 | tree (* builtin_mask_for_load) (void); | |
c6c91d61 | 467 | |
22c2f6bd | 468 | /* Returns a code for builtin that realizes vectorized version of |
469 | function, or NULL_TREE if not available. */ | |
6d85df69 | 470 | tree (* builtin_vectorized_function) (unsigned, tree, tree); |
22c2f6bd | 471 | |
9d8bf4aa | 472 | /* Returns a code for builtin that realizes vectorized version of |
473 | conversion, or NULL_TREE if not available. */ | |
474 | tree (* builtin_conversion) (unsigned, tree); | |
475 | ||
c6c91d61 | 476 | /* Target builtin that implements vector widening multiplication. |
48e1416a | 477 | builtin_mul_widen_eve computes the element-by-element products |
c6c91d61 | 478 | for the even elements, and builtin_mul_widen_odd computes the |
479 | element-by-element products for the odd elements. */ | |
480 | tree (* builtin_mul_widen_even) (tree); | |
481 | tree (* builtin_mul_widen_odd) (tree); | |
a28df51d | 482 | |
483 | /* Returns the cost to be added to the overheads involved with | |
484 | executing the vectorized version of a loop. */ | |
485 | int (*builtin_vectorization_cost) (bool); | |
5a2538e1 | 486 | |
487 | /* Return true if vector alignment is reachable (by peeling N | |
4a7e4fcc | 488 | iterations) for the given type. */ |
a9f1838b | 489 | bool (* vector_alignment_reachable) (const_tree, bool); |
a0515226 | 490 | |
491 | /* Target builtin that implements vector permute. */ | |
492 | tree (* builtin_vec_perm) (tree, tree*); | |
c6b19c5f | 493 | /* Return true if the target supports misaligned store/load of a |
494 | specific factor denoted in the third parameter. The last parameter | |
495 | is true if the access is defined in a packed struct. */ | |
48e1416a | 496 | bool (* builtin_support_vector_misalignment) (enum machine_mode, |
c6b19c5f | 497 | const_tree, int, bool); |
01c8e4c9 | 498 | } vectorize; |
b056d812 | 499 | |
ff05e09e | 500 | /* The initial value of target_flags. */ |
501 | int default_target_flags; | |
502 | ||
4bec06b3 | 503 | /* Allow target specific overriding of option settings after options have |
504 | been changed by an attribute or pragma or when it is reset at the | |
505 | end of the code affected by an attribute or pragma. */ | |
506 | void (* override_options_after_change) (void); | |
507 | ||
ff05e09e | 508 | /* Handle target switch CODE (an OPT_* value). ARG is the argument |
509 | passed to the switch; it is NULL if no argument was. VALUE is the | |
510 | value of ARG if CODE specifies a UInteger option, otherwise it is | |
511 | 1 if the positive form of the switch was used and 0 if the negative | |
512 | form was. Return true if the switch was valid. */ | |
513 | bool (* handle_option) (size_t code, const char *arg, int value); | |
514 | ||
154ee3b8 | 515 | /* Display extra, target specific information in response to a |
516 | --target-help switch. */ | |
517 | void (* target_help) (void); | |
518 | ||
fbf0afd1 | 519 | /* Return machine mode for filter value. */ |
95215948 | 520 | enum machine_mode (* eh_return_filter_mode) (void); |
521 | ||
0ef89dfd | 522 | /* Return machine mode for libgcc expanded cmp instructions. */ |
523 | enum machine_mode (* libgcc_cmp_return_mode) (void); | |
524 | ||
525 | /* Return machine mode for libgcc expanded shift instructions. */ | |
526 | enum machine_mode (* libgcc_shift_count_mode) (void); | |
527 | ||
1bd43494 | 528 | /* Return machine mode to be used for _Unwind_Word type. */ |
529 | enum machine_mode (* unwind_word_mode) (void); | |
530 | ||
a767736d | 531 | /* Given two decls, merge their attributes and return the result. */ |
60b8c5b3 | 532 | tree (* merge_decl_attributes) (tree, tree); |
a767736d | 533 | |
534 | /* Given two types, merge their attributes and return the result. */ | |
60b8c5b3 | 535 | tree (* merge_type_attributes) (tree, tree); |
a767736d | 536 | |
f8e93a2e | 537 | /* Table of machine attributes and functions to handle them. |
538 | Ignored if NULL. */ | |
e3c541f0 | 539 | const struct attribute_spec *attribute_table; |
f32321da | 540 | |
541 | /* Return zero if the attributes on TYPE1 and TYPE2 are incompatible, | |
542 | one if they are compatible and two if they are nearly compatible | |
543 | (which causes a warning to be generated). */ | |
a9f1838b | 544 | int (* comp_type_attributes) (const_tree type1, const_tree type2); |
f32321da | 545 | |
546 | /* Assign default attributes to the newly defined TYPE. */ | |
60b8c5b3 | 547 | void (* set_default_type_attributes) (tree type); |
8ee295a7 | 548 | |
549 | /* Insert attributes on the newly created DECL. */ | |
60b8c5b3 | 550 | void (* insert_attributes) (tree decl, tree *attributes); |
fc2a2dcb | 551 | |
e3c541f0 | 552 | /* Return true if FNDECL (which has at least one machine attribute) |
553 | can be inlined despite its machine attributes, false otherwise. */ | |
a9f1838b | 554 | bool (* function_attribute_inlinable_p) (const_tree fndecl); |
e3c541f0 | 555 | |
f04f096b | 556 | /* Return true if bitfields in RECORD_TYPE should follow the |
557 | Microsoft Visual C++ bitfield layout rules. */ | |
a9f1838b | 558 | bool (* ms_bitfield_layout_p) (const_tree record_type); |
f04f096b | 559 | |
c4503c0a | 560 | /* True if the target supports decimal floating point. */ |
561 | bool (* decimal_float_supported_p) (void); | |
562 | ||
9421ebb9 | 563 | /* True if the target supports fixed-point. */ |
564 | bool (* fixed_point_supported_p) (void); | |
565 | ||
25ba5be6 | 566 | /* Return true if anonymous bitfields affect structure alignment. */ |
567 | bool (* align_anon_bitfield) (void); | |
568 | ||
5f458503 | 569 | /* Return true if volatile bitfields should use the narrowest type possible. |
570 | Return false if they should use the container type. */ | |
571 | bool (* narrow_volatile_bitfield) (void); | |
572 | ||
fc2a2dcb | 573 | /* Set up target-specific built-in functions. */ |
60b8c5b3 | 574 | void (* init_builtins) (void); |
fc2a2dcb | 575 | |
8d134460 | 576 | /* Initialize (if INITIALIZE_P is true) and return the target-specific |
577 | built-in function decl for CODE. | |
578 | Return NULL if that is not possible. Return error_mark_node if CODE | |
579 | is outside of the range of valid target builtin function codes. */ | |
580 | tree (* builtin_decl) (unsigned code, bool initialize_p); | |
581 | ||
fc2a2dcb | 582 | /* Expand a target-specific builtin. */ |
60b8c5b3 | 583 | rtx (* expand_builtin) (tree exp, rtx target, rtx subtarget, |
584 | enum machine_mode mode, int ignore); | |
2cb4ac60 | 585 | |
65441f6f | 586 | /* Select a replacement for a target-specific builtin. This is done |
b9c74b4d | 587 | *before* regular type checking, and so allows the target to |
588 | implement a crude form of function overloading. The result is a | |
589 | complete expression that implements the operation. PARAMS really | |
590 | has type VEC(tree,gc)*, but we don't want to include tree.h | |
591 | here. */ | |
e60a6f7b | 592 | tree (*resolve_overloaded_builtin) (unsigned int /*location_t*/, |
593 | tree decl, void *params); | |
65441f6f | 594 | |
b0160cb4 | 595 | /* Fold a target-specific builtin. */ |
0ab8af67 | 596 | tree (* fold_builtin) (tree fndecl, tree arglist, bool ignore); |
b215c058 | 597 | |
e174638f | 598 | /* Returns a code for a target-specific builtin that implements |
599 | reciprocal of the function, or NULL_TREE if not available. */ | |
2cd360b6 | 600 | tree (* builtin_reciprocal) (unsigned, bool, bool); |
e174638f | 601 | |
eddcdde1 | 602 | /* For a vendor-specific TYPE, return a pointer to a statically-allocated |
603 | string containing the C++ mangling for TYPE. In all other cases, return | |
604 | NULL. */ | |
a9f1838b | 605 | const char * (* mangle_type) (const_tree type); |
333715c2 | 606 | |
f2f543a3 | 607 | /* Make any adjustments to libfunc names needed for this target. */ |
608 | void (* init_libfuncs) (void); | |
609 | ||
2cb4ac60 | 610 | /* Given a decl, a section name, and whether the decl initializer |
611 | has relocs, choose attributes for the section. */ | |
612 | /* ??? Should be merged with SELECT_SECTION and UNIQUE_SECTION. */ | |
60b8c5b3 | 613 | unsigned int (* section_type_flags) (tree, const char *, int); |
2cb4ac60 | 614 | |
e27e52e0 | 615 | /* True if new jumps cannot be created, to replace existing ones or |
616 | not, at the current point in the compilation. */ | |
60b8c5b3 | 617 | bool (* cannot_modify_jumps_p) (void); |
52470889 | 618 | |
e26dbf6d | 619 | /* Return a register class for which branch target register |
620 | optimizations should be applied. */ | |
bc620c5c | 621 | enum reg_class (* branch_target_register_class) (void); |
e26dbf6d | 622 | |
623 | /* Return true if branch target register optimizations should include | |
624 | callee-saved registers that are not already live during the current | |
625 | function. AFTER_PE_GEN is true if prologues and epilogues have | |
626 | already been generated. */ | |
60b8c5b3 | 627 | bool (* branch_target_register_callee_saved) (bool after_pe_gen); |
8af3db02 | 628 | |
751d3ba7 | 629 | /* Return true if the target supports conditional execution. */ |
630 | bool (* have_conditional_execution) (void); | |
631 | ||
a6bbccc1 | 632 | /* True if the constant X cannot be placed in the constant pool. */ |
60b8c5b3 | 633 | bool (* cannot_force_const_mem) (rtx); |
a6bbccc1 | 634 | |
2f58af60 | 635 | /* True if the insn X cannot be duplicated. */ |
60b8c5b3 | 636 | bool (* cannot_copy_insn_p) (rtx); |
2f58af60 | 637 | |
280566a7 | 638 | /* True if X is considered to be commutative. */ |
a9f1838b | 639 | bool (* commutative_p) (const_rtx, int); |
280566a7 | 640 | |
41e3a0c7 | 641 | /* Given an invalid address X for a given machine mode, try machine-specific |
642 | ways to make it legitimate. Return X or an invalid address on failure. */ | |
643 | rtx (* legitimize_address) (rtx, rtx, enum machine_mode); | |
644 | ||
bfe57ab7 | 645 | /* Given an address RTX, undo the effects of LEGITIMIZE_ADDRESS. */ |
60b8c5b3 | 646 | rtx (* delegitimize_address) (rtx); |
bfe57ab7 | 647 | |
fd50b071 | 648 | /* Given an address RTX, say whether it is valid. */ |
649 | bool (* legitimate_address_p) (enum machine_mode, rtx, bool); | |
650 | ||
f2d0e9f1 | 651 | /* True if the given constant can be put into an object_block. */ |
a9f1838b | 652 | bool (* use_blocks_for_constant_p) (enum machine_mode, const_rtx); |
f2d0e9f1 | 653 | |
654 | /* The minimum and maximum byte offsets for anchored addresses. */ | |
655 | HOST_WIDE_INT min_anchor_offset; | |
656 | HOST_WIDE_INT max_anchor_offset; | |
657 | ||
658 | /* True if section anchors can be used to access the given symbol. */ | |
a9f1838b | 659 | bool (* use_anchors_for_symbol_p) (const_rtx); |
f2d0e9f1 | 660 | |
805e22b2 | 661 | /* True if it is OK to do sibling call optimization for the specified |
662 | call expression EXP. DECL will be the called function, or NULL if | |
663 | this is an indirect call. */ | |
60b8c5b3 | 664 | bool (*function_ok_for_sibcall) (tree decl, tree exp); |
665 | ||
87d4aa85 | 666 | /* Establish appropriate back-end context for processing the function |
667 | FNDECL. The argument might be NULL to indicate processing at top | |
668 | level, outside of any function scope. */ | |
669 | void (*set_current_function) (tree fndecl); | |
670 | ||
52470889 | 671 | /* True if EXP should be placed in a "small data" section. */ |
a9f1838b | 672 | bool (* in_small_data_p) (const_tree); |
7811991d | 673 | |
33459320 | 674 | /* True if EXP names an object for which name resolution must resolve |
807bf718 | 675 | to the current executable or shared library. */ |
a9f1838b | 676 | bool (* binds_local_p) (const_tree); |
33459320 | 677 | |
97a424bc | 678 | /* Modify and return the identifier of a DECL's external name, |
679 | originally identified by ID, as required by the target, | |
680 | (eg, append @nn to windows32 stdcall function names). | |
681 | The default is to return ID without modification. */ | |
682 | tree (* mangle_decl_assembler_name) (tree decl, tree id); | |
683 | ||
7811991d | 684 | /* Do something target-specific to record properties of the DECL into |
685 | the associated SYMBOL_REF. */ | |
60b8c5b3 | 686 | void (* encode_section_info) (tree, rtx, int); |
7b4a38a6 | 687 | |
688 | /* Undo the effects of encode_section_info on the symbol string. */ | |
60b8c5b3 | 689 | const char * (* strip_name_encoding) (const char *); |
33459320 | 690 | |
c49547c4 | 691 | /* If shift optabs for MODE are known to always truncate the shift count, |
692 | return the mask that they apply. Return 0 otherwise. */ | |
693 | unsigned HOST_WIDE_INT (* shift_truncation_mask) (enum machine_mode mode); | |
694 | ||
ac70caad | 695 | /* Return the number of divisions in the given MODE that should be present, |
696 | so that it is profitable to turn the division into a multiplication by | |
697 | the reciprocal. */ | |
698 | unsigned int (* min_divisions_for_recip_mul) (enum machine_mode mode); | |
699 | ||
4956440a | 700 | /* If the representation of integral MODE is such that values are |
701 | always sign-extended to a wider mode MODE_REP then return | |
702 | SIGN_EXTEND. Return UNKNOWN otherwise. */ | |
703 | /* Note that the return type ought to be RTX_CODE, but that's not | |
704 | necessarily defined at this point. */ | |
705 | int (* mode_rep_extended) (enum machine_mode mode, | |
706 | enum machine_mode mode_rep); | |
707 | ||
fab7adbf | 708 | /* True if MODE is valid for a pointer in __attribute__((mode("MODE"))). */ |
60b8c5b3 | 709 | bool (* valid_pointer_mode) (enum machine_mode mode); |
fab7adbf | 710 | |
bd1a81f7 | 711 | /* Support for named address spaces. */ |
712 | struct addr_space { | |
98155838 | 713 | /* MODE to use for a pointer into another address space. */ |
714 | enum machine_mode (* pointer_mode) (addr_space_t); | |
715 | ||
716 | /* MODE to use for an address in another address space. */ | |
717 | enum machine_mode (* address_mode) (addr_space_t); | |
718 | ||
719 | /* True if MODE is valid for a pointer in __attribute__((mode("MODE"))) | |
720 | in another address space. */ | |
721 | bool (* valid_pointer_mode) (enum machine_mode, addr_space_t); | |
722 | ||
bd1a81f7 | 723 | /* True if an address is a valid memory address to a given named address |
724 | space for a given mode. */ | |
725 | bool (* legitimate_address_p) (enum machine_mode, rtx, bool, addr_space_t); | |
726 | ||
727 | /* Return an updated address to convert an invalid pointer to a named | |
728 | address space to a valid one. If NULL_RTX is returned use machine | |
729 | independent methods to make the address valid. */ | |
730 | rtx (* legitimize_address) (rtx, rtx, enum machine_mode, addr_space_t); | |
731 | ||
732 | /* True if one named address space is a subset of another named address. */ | |
733 | bool (* subset_p) (addr_space_t, addr_space_t); | |
734 | ||
735 | /* Function to convert an rtl expression from one address space to | |
736 | another. */ | |
737 | rtx (* convert) (rtx, tree, tree); | |
738 | ||
739 | } addr_space; | |
740 | ||
b2aef146 | 741 | /* True if MODE is valid for the target. By "valid", we mean able to |
742 | be manipulated in non-trivial ways. In particular, this means all | |
743 | the arithmetic is supported. */ | |
744 | bool (* scalar_mode_supported_p) (enum machine_mode mode); | |
745 | ||
746 | /* Similarly for vector modes. "Supported" here is less strict. At | |
747 | least some operations are supported; need to check optabs or builtins | |
748 | for further details. */ | |
9e7454d0 | 749 | bool (* vector_mode_supported_p) (enum machine_mode mode); |
750 | ||
fab7adbf | 751 | /* Compute a (partial) cost for rtx X. Return true if the complete |
752 | cost has been computed, and false if subexpressions should be | |
753 | scanned. In either case, *TOTAL contains the cost result. */ | |
754 | /* Note that CODE and OUTER_CODE ought to be RTX_CODE, but that's | |
755 | not necessarily defined at this point. */ | |
f529eb25 | 756 | bool (* rtx_costs) (rtx x, int code, int outer_code, int *total, bool speed); |
fab7adbf | 757 | |
ec0457a8 | 758 | /* Compute the cost of X, used as an address. Never called with |
759 | invalid addresses. */ | |
f529eb25 | 760 | int (* address_cost) (rtx x, bool speed); |
ec0457a8 | 761 | |
edf54f2a | 762 | /* Return where to allocate pseudo for a given hard register initial |
763 | value. */ | |
764 | rtx (* allocate_initial_value) (rtx x); | |
765 | ||
77ad8e5a | 766 | /* Return nonzero if evaluating UNSPEC[_VOLATILE] X might cause a trap. |
767 | FLAGS has the same meaning as in rtlanal.c: may_trap_p_1. */ | |
768 | int (* unspec_may_trap_p) (const_rtx x, unsigned flags); | |
769 | ||
9754a2f0 | 770 | /* Given a register, this hook should return a parallel of registers |
771 | to represent where to find the register pieces. Define this hook | |
772 | if the register and its mode are represented in Dwarf in | |
773 | non-contiguous locations, or if the register should be | |
774 | represented in more than one register in Dwarf. Otherwise, this | |
775 | hook should return NULL_RTX. */ | |
60b8c5b3 | 776 | rtx (* dwarf_register_span) (rtx); |
9754a2f0 | 777 | |
114a8a4b | 778 | /* If expand_builtin_init_dwarf_reg_sizes needs to fill in table |
779 | entries not corresponding directly to registers below | |
780 | FIRST_PSEUDO_REGISTER, this hook should generate the necessary | |
781 | code, given the address of the table. */ | |
782 | void (* init_dwarf_reg_sizes_extra) (tree); | |
783 | ||
124ac4e4 | 784 | /* Fetch the fixed register(s) which hold condition codes, for |
785 | targets where it makes sense to look for duplicate assignments to | |
786 | the condition codes. This should return true if there is such a | |
787 | register, false otherwise. The arguments should be set to the | |
788 | fixed register numbers. Up to two condition code registers are | |
789 | supported. If there is only one for this target, the int pointed | |
790 | at by the second argument should be set to -1. */ | |
791 | bool (* fixed_condition_code_regs) (unsigned int *, unsigned int *); | |
792 | ||
793 | /* If two condition code modes are compatible, return a condition | |
794 | code mode which is compatible with both, such that a comparison | |
795 | done in the returned mode will work for both of the original | |
796 | modes. If the condition code modes are not compatible, return | |
797 | VOIDmode. */ | |
798 | enum machine_mode (* cc_modes_compatible) (enum machine_mode, | |
799 | enum machine_mode); | |
800 | ||
2efea8c0 | 801 | /* Do machine-dependent code transformations. Called just before |
802 | delayed-branch scheduling. */ | |
60b8c5b3 | 803 | void (* machine_dependent_reorg) (void); |
2efea8c0 | 804 | |
2e15d750 | 805 | /* Create the __builtin_va_list type. */ |
806 | tree (* build_builtin_va_list) (void); | |
807 | ||
5f57a8b1 | 808 | /* Get the cfun/fndecl calling abi __builtin_va_list type. */ |
809 | tree (* fn_abi_va_list) (tree); | |
810 | ||
811 | /* Get the __builtin_va_list type dependent on input type. */ | |
812 | tree (* canonical_va_list_type) (tree); | |
813 | ||
8a58ed0a | 814 | /* Expand the __builtin_va_start builtin. */ |
815 | void (* expand_builtin_va_start) (tree valist, rtx nextarg); | |
816 | ||
17a6380d | 817 | /* Gimplifies a VA_ARG_EXPR. */ |
75a70cf9 | 818 | tree (* gimplify_va_arg_expr) (tree valist, tree type, gimple_seq *pre_p, |
819 | gimple_seq *post_p); | |
17a6380d | 820 | |
7988d6e2 | 821 | /* Validity-checking routines for PCH files, target-specific. |
822 | get_pch_validity returns a pointer to the data to be stored, | |
823 | and stores the size in its argument. pch_valid_p gets the same | |
824 | information back and returns NULL if the PCH is valid, | |
825 | or an error message if not. | |
826 | */ | |
827 | void * (* get_pch_validity) (size_t *); | |
828 | const char * (* pch_valid_p) (const void *, size_t); | |
829 | ||
761d9126 | 830 | /* If nonnull, this function checks whether a PCH file with the |
831 | given set of target flags can be used. It returns NULL if so, | |
832 | otherwise it returns an error message. */ | |
833 | const char *(*check_pch_target_flags) (int); | |
834 | ||
13401456 | 835 | /* True if the compiler should give an enum type only as many |
bfb835d3 | 836 | bytes as it takes to represent the range of possible values of |
837 | that type. */ | |
838 | bool (* default_short_enums) (void); | |
839 | ||
e3e026e8 | 840 | /* This target hook returns an rtx that is used to store the address |
13401456 | 841 | of the current frame into the built-in setjmp buffer. */ |
e3e026e8 | 842 | rtx (* builtin_setjmp_frame_value) (void); |
843 | ||
0fb2666c | 844 | /* This target hook should add STRING_CST trees for any hard regs |
64d5fb6a | 845 | the port wishes to automatically clobber for an asm. */ |
846 | tree (* md_asm_clobbers) (tree, tree, tree); | |
0fb2666c | 847 | |
8ff30ff6 | 848 | /* This target hook allows the backend to specify a calling convention |
849 | in the debug information. This function actually returns an | |
850 | enum dwarf_calling_convention, but because of forward declarations | |
851 | and not wanting to include dwarf2.h everywhere target.h is included | |
852 | the function is being declared as an int. */ | |
a9f1838b | 853 | int (* dwarf_calling_convention) (const_tree); |
8ff30ff6 | 854 | |
d15ee1a5 | 855 | /* This target hook allows the backend to emit frame-related insns that |
856 | contain UNSPECs or UNSPEC_VOLATILEs. The call frame debugging info | |
857 | engine will invoke it on insns of the form | |
858 | (set (reg) (unspec [...] UNSPEC_INDEX)) | |
859 | and | |
860 | (set (reg) (unspec_volatile [...] UNSPECV_INDEX)) | |
861 | to let the backend emit the call frame instructions. */ | |
862 | void (* dwarf_handle_frame_unspec) (const char *, rtx, int); | |
863 | ||
a6c787e5 | 864 | /* Perform architecture specific checking of statements gimplified |
75a70cf9 | 865 | from VA_ARG_EXPR. STMT is the statement. Returns true if the statement |
866 | doesn't need to be checked for va_list references. */ | |
867 | bool (* stdarg_optimize_hook) (struct stdarg_info *ai, const_gimple stmt); | |
f1a0edff | 868 | |
869 | /* This target hook allows the operating system to override the DECL | |
870 | that represents the external variable that contains the stack | |
871 | protection guard variable. The type of this DECL is ptr_type_node. */ | |
872 | tree (* stack_protect_guard) (void); | |
873 | ||
874 | /* This target hook allows the operating system to override the CALL_EXPR | |
875 | that is invoked when a check vs the guard variable fails. */ | |
876 | tree (* stack_protect_fail) (void); | |
a6c787e5 | 877 | |
1606e68a | 878 | /* Returns NULL if target supports the insn within a doloop block, |
879 | otherwise it returns an error message. */ | |
a9f1838b | 880 | const char * (*invalid_within_doloop) (const_rtx); |
6c1e551f | 881 | |
882 | /* DECL is a variable or function with __attribute__((dllimport)) | |
883 | specified. Use this hook if the target needs to add extra validation | |
884 | checks to handle_dll_attribute (). */ | |
a9f1838b | 885 | bool (* valid_dllimport_attribute_p) (const_tree decl); |
b215c058 | 886 | |
01c8e4c9 | 887 | /* If non-zero, align constant anchors in CSE to a multiple of this |
888 | value. */ | |
889 | unsigned HOST_WIDE_INT const_anchor; | |
890 | ||
92d40bc4 | 891 | /* Functions relating to calls - argument passing, returns, etc. */ |
892 | struct calls { | |
3b2411a8 | 893 | enum machine_mode (*promote_function_mode) (const_tree type, |
894 | enum machine_mode mode, | |
895 | int *punsignedp, | |
896 | const_tree fntype, | |
897 | int for_return); | |
fb80456a | 898 | bool (*promote_prototypes) (const_tree fntype); |
92d40bc4 | 899 | rtx (*struct_value_rtx) (tree fndecl, int incoming); |
fb80456a | 900 | bool (*return_in_memory) (const_tree type, const_tree fndecl); |
901 | bool (*return_in_msb) (const_tree type); | |
b981d932 | 902 | |
903 | /* Return true if a parameter must be passed by reference. TYPE may | |
904 | be null if this is a libcall. CA may be null if this query is | |
905 | from __builtin_va_arg. */ | |
906 | bool (*pass_by_reference) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
fb80456a | 907 | const_tree type, bool named_arg); |
b981d932 | 908 | |
92d40bc4 | 909 | rtx (*expand_builtin_saveregs) (void); |
910 | /* Returns pretend_argument_size. */ | |
911 | void (*setup_incoming_varargs) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
912 | tree type, int *pretend_arg_size, | |
913 | int second_time); | |
914 | bool (*strict_argument_naming) (CUMULATIVE_ARGS *ca); | |
915 | /* Returns true if we should use | |
916 | targetm.calls.setup_incoming_varargs() and/or | |
917 | targetm.calls.strict_argument_naming(). */ | |
918 | bool (*pretend_outgoing_varargs_named) (CUMULATIVE_ARGS *ca); | |
919 | ||
920 | /* Given a complex type T, return true if a parameter of type T | |
921 | should be passed as two scalars. */ | |
a9f1838b | 922 | bool (* split_complex_arg) (const_tree type); |
0336f0f0 | 923 | |
924 | /* Return true if type T, mode MODE, may not be passed in registers, | |
925 | but must be passed on the stack. */ | |
926 | /* ??? This predicate should be applied strictly after pass-by-reference. | |
927 | Need audit to verify that this is the case. */ | |
fb80456a | 928 | bool (* must_pass_in_stack) (enum machine_mode mode, const_tree t); |
13f08ee7 | 929 | |
930 | /* Return true if type TYPE, mode MODE, which is passed by reference, | |
931 | should have the object copy generated by the callee rather than | |
932 | the caller. It is never called for TYPE requiring constructors. */ | |
933 | bool (* callee_copies) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
fb80456a | 934 | const_tree type, bool named); |
f054eb3c | 935 | |
936 | /* Return zero for arguments passed entirely on the stack or entirely | |
937 | in registers. If passed in both, return the number of bytes passed | |
938 | in registers; the balance is therefore passed on the stack. */ | |
939 | int (* arg_partial_bytes) (CUMULATIVE_ARGS *ca, enum machine_mode mode, | |
940 | tree type, bool named); | |
10fda9eb | 941 | |
942 | /* Return the diagnostic message string if function without a prototype | |
943 | is not allowed for this 'val' argument; NULL otherwise. */ | |
a9f1838b | 944 | const char *(*invalid_arg_for_unprototyped_fn) (const_tree typelist, |
945 | const_tree funcdecl, | |
946 | const_tree val); | |
46b3ff29 | 947 | |
948 | /* Return an rtx for the return value location of the function | |
949 | specified by FN_DECL_OR_TYPE with a return type of RET_TYPE. */ | |
fb80456a | 950 | rtx (*function_value) (const_tree ret_type, const_tree fn_decl_or_type, |
46b3ff29 | 951 | bool outgoing); |
567925e3 | 952 | |
578d1295 | 953 | /* Return the rtx for the result of a libcall of mode MODE, |
954 | calling the function FN_NAME. */ | |
e5ce1073 | 955 | rtx (*libcall_value) (enum machine_mode, const_rtx); |
578d1295 | 956 | |
567925e3 | 957 | /* Return an rtx for the argument pointer incoming to the |
958 | current function. */ | |
959 | rtx (*internal_arg_pointer) (void); | |
658e203c | 960 | |
27a7a23a | 961 | /* Update the current function stack boundary if needed. */ |
962 | void (*update_stack_boundary) (void); | |
963 | ||
964 | /* Handle stack alignment and return an rtx for Dynamic Realign | |
965 | Argument Pointer if necessary. */ | |
966 | rtx (*get_drap_rtx) (void); | |
967 | ||
658e203c | 968 | /* Return true if all function parameters should be spilled to the |
969 | stack. */ | |
970 | bool (*allocate_stack_slots_for_args) (void); | |
82c7907c | 971 | |
972 | /* Return an rtx for the static chain for FNDECL. If INCOMING_P is true, | |
973 | then it should be for the callee; otherwise for the caller. */ | |
974 | rtx (*static_chain) (const_tree fndecl, bool incoming_p); | |
975 | ||
48e1416a | 976 | /* Fill in the trampoline at MEM with a call to FNDECL and a |
82c7907c | 977 | static chain value of CHAIN. */ |
978 | void (*trampoline_init) (rtx mem, tree fndecl, rtx chain); | |
979 | ||
980 | /* Adjust the address of the trampoline in a target-specific way. */ | |
981 | rtx (*trampoline_adjust_address) (rtx addr); | |
92d40bc4 | 982 | } calls; |
983 | ||
7a979707 | 984 | /* Return the diagnostic message string if conversion from FROMTYPE |
985 | to TOTYPE is not allowed, NULL otherwise. */ | |
a9f1838b | 986 | const char *(*invalid_conversion) (const_tree fromtype, const_tree totype); |
7a979707 | 987 | |
988 | /* Return the diagnostic message string if the unary operation OP is | |
989 | not permitted on TYPE, NULL otherwise. */ | |
a9f1838b | 990 | const char *(*invalid_unary_op) (int op, const_tree type); |
7a979707 | 991 | |
992 | /* Return the diagnostic message string if the binary operation OP | |
993 | is not permitted on TYPE1 and TYPE2, NULL otherwise. */ | |
a9f1838b | 994 | const char *(*invalid_binary_op) (int op, const_tree type1, const_tree type2); |
7a979707 | 995 | |
2b3c93a3 | 996 | /* Return the diagnostic message string if TYPE is not valid as a |
997 | function parameter type, NULL otherwise. */ | |
998 | const char *(*invalid_parameter_type) (const_tree type); | |
999 | ||
1000 | /* Return the diagnostic message string if TYPE is not valid as a | |
1001 | function return type, NULL otherwise. */ | |
1002 | const char *(*invalid_return_type) (const_tree type); | |
1003 | ||
1004 | /* If values of TYPE are promoted to some other type when used in | |
1005 | expressions (analogous to the integer promotions), return that type, | |
1006 | or NULL_TREE otherwise. */ | |
1007 | tree (*promoted_type) (const_tree type); | |
1008 | ||
1009 | /* Convert EXPR to TYPE, if target-specific types with special conversion | |
1010 | rules are involved. Return the converted expression, or NULL to apply | |
1011 | the standard conversion rules. */ | |
1012 | tree (*convert_to_type) (tree type, tree expr); | |
1013 | ||
d9595a8c | 1014 | /* Return the array of IRA cover classes for the current target. */ |
1015 | const enum reg_class *(*ira_cover_classes) (void); | |
1016 | ||
4d58fa46 | 1017 | /* Return the class for a secondary reload, and fill in extra information. */ |
1018 | enum reg_class (*secondary_reload) (bool, rtx, enum reg_class, | |
1019 | enum machine_mode, | |
1020 | struct secondary_reload_info *); | |
1021 | ||
bc5e6ea1 | 1022 | /* This target hook allows the backend to perform additional |
1023 | processing while initializing for variable expansion. */ | |
1024 | void (* expand_to_rtl_hook) (void); | |
1025 | ||
1026 | /* This target hook allows the backend to perform additional | |
1027 | instantiations on rtx that are not actually in insns yet, | |
1028 | but will be later. */ | |
1029 | void (* instantiate_decls) (void); | |
1030 | ||
747bf50d | 1031 | /* Return true if is OK to use a hard register REGNO as scratch register |
1032 | in peephole2. */ | |
1033 | bool (* hard_regno_scratch_ok) (unsigned int regno); | |
1034 | ||
906bb5c3 | 1035 | /* Return the smallest number of different values for which it is best to |
1036 | use a jump-table instead of a tree of conditional branches. */ | |
1037 | unsigned int (* case_values_threshold) (void); | |
48e1416a | 1038 | |
5a1c68c3 | 1039 | /* Retutn true if a function must have and use a frame pointer. */ |
1040 | bool (* frame_pointer_required) (void); | |
906bb5c3 | 1041 | |
cd90919d | 1042 | /* Returns true if the compiler is allowed to try to replace register number |
1043 | from-reg with register number to-reg. */ | |
1044 | bool (* can_eliminate) (const int, const int); | |
1045 | ||
430be8e2 | 1046 | /* Functions specific to the C family of frontends. */ |
1047 | struct c { | |
1048 | /* Return machine mode for non-standard suffix | |
1049 | or VOIDmode if non-standard suffixes are unsupported. */ | |
1050 | enum machine_mode (*mode_for_suffix) (char); | |
1051 | } c; | |
1052 | ||
c1dc02de | 1053 | /* Functions specific to the C++ frontend. */ |
1054 | struct cxx { | |
1055 | /* Return the integer type used for guard variables. */ | |
1056 | tree (*guard_type) (void); | |
1057 | /* Return true if only the low bit of the guard should be tested. */ | |
1058 | bool (*guard_mask_bit) (void); | |
600f4be7 | 1059 | /* Returns the size of the array cookie for an array of type. */ |
1060 | tree (*get_cookie_size) (tree); | |
1061 | /* Returns true if the element size should be stored in the | |
1062 | array cookie. */ | |
1063 | bool (*cookie_has_size) (void); | |
52d6bee4 | 1064 | /* Allows backends to perform additional processing when |
1065 | deciding if a class should be exported or imported. */ | |
1066 | int (*import_export_class) (tree, int); | |
853b7640 | 1067 | /* Returns true if constructors and destructors return "this". */ |
1068 | bool (*cdtor_returns_this) (void); | |
219626ad | 1069 | /* Returns true if the key method for a class can be an inline |
1070 | function, so long as it is not declared inline in the class | |
1071 | itself. Returning true is the behavior required by the Itanium | |
1072 | C++ ABI. */ | |
1073 | bool (*key_method_may_be_inline) (void); | |
7908506d | 1074 | /* DECL is a virtual table, virtual table table, typeinfo object, |
1075 | or other similar implicit class data object that will be | |
1076 | emitted with external linkage in this translation unit. No ELF | |
1077 | visibility has been explicitly specified. If the target needs | |
1078 | to specify a visibility other than that of the containing class, | |
1079 | use this hook to set DECL_VISIBILITY and | |
b215c058 | 1080 | DECL_VISIBILITY_SPECIFIED. */ |
7908506d | 1081 | void (*determine_class_data_visibility) (tree decl); |
1082 | /* Returns true (the default) if virtual tables and other | |
1083 | similar implicit class data objects are always COMDAT if they | |
1084 | have external linkage. If this hook returns false, then | |
1085 | class data for classes whose virtual table will be emitted in | |
1086 | only one translation unit will not be COMDAT. */ | |
1087 | bool (*class_data_always_comdat) (void); | |
60d9461b | 1088 | /* Returns true (the default) if the RTTI for the basic types, |
1089 | which is always defined in the C++ runtime, should be COMDAT; | |
1090 | false if it should not be COMDAT. */ | |
1091 | bool (*library_rtti_comdat) (void); | |
46b9ff5e | 1092 | /* Returns true if __aeabi_atexit should be used to register static |
1093 | destructors. */ | |
1094 | bool (*use_aeabi_atexit) (void); | |
d91ef9b0 | 1095 | /* Returns true if target may use atexit in the same manner as |
1096 | __cxa_atexit to register static destructors. */ | |
1097 | bool (*use_atexit_for_cxa_atexit) (void); | |
6c1e551f | 1098 | /* TYPE is a C++ class (i.e., RECORD_TYPE or UNION_TYPE) that |
1099 | has just been defined. Use this hook to make adjustments to the | |
1100 | class (eg, tweak visibility or perform any other required | |
b215c058 | 1101 | target modifications). */ |
6c1e551f | 1102 | void (*adjust_class_at_definition) (tree type); |
c1dc02de | 1103 | } cxx; |
7c6733e8 | 1104 | |
38475469 | 1105 | /* Functions and data for emulated TLS support. */ |
1106 | struct emutls { | |
1107 | /* Name of the address and common functions. */ | |
1108 | const char *get_address; | |
1109 | const char *register_common; | |
1110 | ||
1111 | /* Prefixes for proxy variable and template. */ | |
1112 | const char *var_section; | |
1113 | const char *tmpl_section; | |
1114 | ||
1115 | /* Prefixes for proxy variable and template. */ | |
1116 | const char *var_prefix; | |
1117 | const char *tmpl_prefix; | |
48e1416a | 1118 | |
38475469 | 1119 | /* Function to generate field definitions of the proxy variable. */ |
1120 | tree (*var_fields) (tree, tree *); | |
1121 | ||
1122 | /* Function to initialize a proxy variable. */ | |
1123 | tree (*var_init) (tree, tree, tree); | |
1124 | ||
1125 | /* Whether we are allowed to alter the usual alignment of the | |
1126 | proxy variable. */ | |
1127 | bool var_align_fixed; | |
1128 | ||
1129 | /* Whether we can emit debug information for TLS vars. */ | |
1130 | bool debug_form_tls_address; | |
48e1416a | 1131 | } emutls; |
38475469 | 1132 | |
46f8e3b0 | 1133 | struct target_option_hooks { |
1134 | /* Function to validate the attribute((option(...))) strings or NULL. If | |
1135 | the option is validated, it is assumed that DECL_FUNCTION_SPECIFIC will | |
1136 | be filled in in the function decl node. */ | |
1137 | bool (*valid_attribute_p) (tree, tree, tree, int); | |
1138 | ||
1139 | /* Function to save any extra target state in the target options | |
1140 | structure. */ | |
1141 | void (*save) (struct cl_target_option *); | |
1142 | ||
1143 | /* Function to restore any extra target state from the target options | |
1144 | structure. */ | |
1145 | void (*restore) (struct cl_target_option *); | |
1146 | ||
1147 | /* Function to print any extra target state from the target options | |
1148 | structure. */ | |
1149 | void (*print) (FILE *, int, struct cl_target_option *); | |
1150 | ||
1151 | /* Function to parse arguments to be validated for #pragma option, and to | |
24470055 | 1152 | change the state if the options are valid. If the first argument is |
1153 | NULL, the second argument specifies the default options to use. Return | |
1154 | true if the options are valid, and set the current state. */ | |
1155 | bool (*pragma_parse) (tree, tree); | |
46f8e3b0 | 1156 | |
1157 | /* Function to determine if one function can inline another function. */ | |
1158 | bool (*can_inline_p) (tree, tree); | |
1159 | } target_option; | |
1160 | ||
fcf2ad9f | 1161 | /* For targets that need to mark extra registers as live on entry to |
1162 | the function, they should define this target hook and set their | |
48e1416a | 1163 | bits in the bitmap passed in. */ |
1164 | void (*live_on_entry) (bitmap); | |
c1dc02de | 1165 | |
1774763d | 1166 | /* True if unwinding tables should be generated by default. */ |
1167 | bool unwind_tables_default; | |
1168 | ||
33459320 | 1169 | /* Leave the boolean fields at the end. */ |
1170 | ||
1171 | /* True if arbitrary sections are supported. */ | |
1172 | bool have_named_sections; | |
1173 | ||
102e3995 | 1174 | /* True if we can create zeroed data by switching to a BSS section |
1175 | and then using ASM_OUTPUT_SKIP to allocate the space. */ | |
1176 | bool have_switchable_bss_sections; | |
1177 | ||
33459320 | 1178 | /* True if "native" constructors and destructors are supported, |
1179 | false if we're using collect2 for the job. */ | |
1180 | bool have_ctors_dtors; | |
2a6f0f81 | 1181 | |
1182 | /* True if thread-local storage is supported. */ | |
1183 | bool have_tls; | |
9292e3be | 1184 | |
1185 | /* True if a small readonly data section is supported. */ | |
1186 | bool have_srodata_section; | |
a08b74c8 | 1187 | |
1188 | /* True if EH frame info sections should be zero-terminated. */ | |
1189 | bool terminate_dw2_eh_frame_info; | |
92c473b8 | 1190 | |
1191 | /* True if #NO_APP should be emitted at the beginning of | |
1192 | assembly output. */ | |
1193 | bool file_start_app_off; | |
1194 | ||
1195 | /* True if output_file_directive should be called for main_input_filename | |
1196 | at the beginning of assembly output. */ | |
1197 | bool file_start_file_directive; | |
45550790 | 1198 | |
146c1b4f | 1199 | /* True if #pragma extern_prefix is to be supported. */ |
1200 | bool handle_pragma_extern_prefix; | |
1201 | ||
2ca3d426 | 1202 | /* True if the target is allowed to reorder memory accesses unless |
1203 | synchronization is explicitly requested. */ | |
1204 | bool relaxed_ordering; | |
1205 | ||
1774763d | 1206 | /* Returns true if we should generate exception tables for use with the |
1207 | ARM EABI. The effects the encoding of function exception specifications. | |
1208 | */ | |
1209 | bool arm_eabi_unwinder; | |
1210 | ||
92d40bc4 | 1211 | /* Leave the boolean fields at the end. */ |
a767736d | 1212 | }; |
1213 | ||
57e4bbfb | 1214 | extern struct gcc_target targetm; |
bcf3c70d | 1215 | |
b9fc964a | 1216 | struct gcc_targetcm { |
1217 | /* Handle target switch CODE (an OPT_* value). ARG is the argument | |
1218 | passed to the switch; it is NULL if no argument was. VALUE is the | |
1219 | value of ARG if CODE specifies a UInteger option, otherwise it is | |
1220 | 1 if the positive form of the switch was used and 0 if the negative | |
1221 | form was. Return true if the switch was valid. */ | |
1222 | bool (*handle_c_option) (size_t code, const char *arg, int value); | |
1223 | }; | |
1224 | ||
1225 | /* Each target can provide their own. */ | |
1226 | extern struct gcc_targetcm targetcm; | |
1227 | ||
bcf3c70d | 1228 | #endif /* GCC_TARGET_H */ |