libgcc2.h (__NW, __NDW): Define using a __gnu_ prefix if LIBGCC2_GNU_PREFIX is defined.
[platform/upstream/gcc.git] / gcc / target.def
1 /* Target hook definitions.
2    Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
3    2011
4    Free Software Foundation, Inc.
5
6    This program is free software; you can redistribute it and/or modify it
7    under the terms of the GNU General Public License as published by the
8    Free Software Foundation; either version 3, or (at your option) any
9    later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program; see the file COPYING3.  If not see
18    <http://www.gnu.org/licenses/>.
19
20    In other words, you are welcome to use, share and improve this program.
21    You are forbidden to forbid anyone else to use, share and improve
22    what you give them.   Help stamp out software-hoarding!  */
23
24 /* See target-hooks-macros.h for details of macros that should be
25    provided by the including file, and how to use them here.  */
26 #include "target-hooks-macros.h"
27
28 #undef HOOK_TYPE
29 #define HOOK_TYPE "Target Hook"
30
31 HOOK_VECTOR (TARGET_INITIALIZER, gcc_target)
32
33 /* Functions that output assembler for the target.  */
34 #define HOOK_PREFIX "TARGET_ASM_"
35 HOOK_VECTOR (TARGET_ASM_OUT, asm_out)
36
37 /* Opening and closing parentheses for asm expression grouping.  */
38 DEFHOOKPOD
39 (open_paren,
40  "",
41  const char *, "(")
42 DEFHOOKPODX (close_paren, const char *, ")")
43
44 /* Assembler instructions for creating various kinds of integer object.  */
45 DEFHOOKPOD
46 (byte_op,
47  "",
48  const char *, "\t.byte\t")
49 DEFHOOKPOD (aligned_op, "*", struct asm_int_op, TARGET_ASM_ALIGNED_INT_OP)
50 DEFHOOKPOD (unaligned_op, "*", struct asm_int_op, TARGET_ASM_UNALIGNED_INT_OP)
51
52 /* The maximum number of bytes to skip when applying
53    LABEL_ALIGN_AFTER_BARRIER.  */
54 DEFHOOK
55 (label_align_after_barrier_max_skip,
56  "",
57  int, (rtx label),
58  default_label_align_after_barrier_max_skip)
59
60 /* The maximum number of bytes to skip when applying
61    LOOP_ALIGN.  */
62 DEFHOOK
63 (loop_align_max_skip,
64  "",
65  int, (rtx label),
66  default_loop_align_max_skip)
67
68 /* The maximum number of bytes to skip when applying
69    LABEL_ALIGN.  */
70 DEFHOOK
71 (label_align_max_skip,
72  "",
73  int, (rtx label),
74  default_label_align_max_skip)
75
76 /* The maximum number of bytes to skip when applying
77    JUMP_ALIGN.  */
78 DEFHOOK
79 (jump_align_max_skip,
80  "",
81  int, (rtx label),
82  default_jump_align_max_skip)
83
84 /* Try to output the assembler code for an integer object whose
85    value is given by X.  SIZE is the size of the object in bytes and
86    ALIGNED_P indicates whether it is aligned.  Return true if
87    successful.  Only handles cases for which BYTE_OP, ALIGNED_OP
88    and UNALIGNED_OP are NULL.  */
89 DEFHOOK
90 (integer,
91  "",
92  /* Only handles cases for which BYTE_OP, ALIGNED_OP and UNALIGNED_OP are
93     NULL.  */
94  bool, (rtx x, unsigned int size, int aligned_p),
95  default_assemble_integer)
96
97 /* Output code that will globalize a label.  */
98 DEFHOOK
99 (globalize_label,
100  "",
101  void, (FILE *stream, const char *name),
102  default_globalize_label)
103
104 /* Output code that will globalize a declaration.  */
105 DEFHOOK
106 (globalize_decl_name,
107  "",
108  void, (FILE *stream, tree decl), default_globalize_decl_name)
109
110 /* Output code that will emit a label for unwind info, if this
111    target requires such labels.  Second argument is the decl the
112    unwind info is associated with, third is a boolean: true if
113    this is for exception handling, fourth is a boolean: true if
114    this is only a placeholder for an omitted FDE.  */
115 DEFHOOK
116 (emit_unwind_label,
117  "",
118  void, (FILE *stream, tree decl, int for_eh, int empty),
119  default_emit_unwind_label)
120
121 /* Output code that will emit a label to divide up the exception table.  */
122 DEFHOOK
123 (emit_except_table_label,
124  "",
125  void, (FILE *stream),
126  default_emit_except_table_label)
127
128 /* Emit a directive for setting the personality for the function.  */
129 DEFHOOK
130 (emit_except_personality,
131  "If the target implements @code{TARGET_ASM_UNWIND_EMIT}, this hook may be\
132  used to emit a directive to install a personality hook into the unwind\
133  info.  This hook should not be used if dwarf2 unwind info is used.",
134  void, (rtx personality),
135  NULL)
136
137 /* Emit any directives required to unwind this instruction.  */
138 DEFHOOK
139 (unwind_emit,
140  "",
141  void, (FILE *stream, rtx insn),
142  NULL)
143
144 DEFHOOKPOD
145 (unwind_emit_before_insn,
146  "True if the @code{TARGET_ASM_UNWIND_EMIT} hook should be called before\
147  the assembly for @var{insn} has been emitted, false if the hook should\
148  be called afterward.",
149  bool, true)
150
151 /* Generate an internal label.
152    For now this is just a wrapper for ASM_GENERATE_INTERNAL_LABEL.  */
153 DEFHOOK_UNDOC
154 (generate_internal_label,
155  "",
156  void, (char *buf, const char *prefix, unsigned long labelno),
157  default_generate_internal_label)
158
159 /* Output an internal label.  */
160 DEFHOOK
161 (internal_label,
162  "",
163  void, (FILE *stream, const char *prefix, unsigned long labelno),
164  default_internal_label)
165
166 /* Output label for the constant.  */
167 DEFHOOK
168 (declare_constant_name,
169  "",
170  void, (FILE *file, const char *name, const_tree expr, HOST_WIDE_INT size),
171  default_asm_declare_constant_name)
172
173 /* Emit a ttype table reference to a typeinfo object.  */
174 DEFHOOK
175 (ttype,
176  "",
177  bool, (rtx sym),
178  hook_bool_rtx_false)
179
180 /* Emit an assembler directive to set visibility for the symbol
181    associated with the tree decl.  */
182 DEFHOOK
183 (assemble_visibility,
184  "",
185  void, (tree decl, int visibility),
186  default_assemble_visibility)
187
188 /* Output the assembler code for entry to a function.  */
189 DEFHOOK
190 (function_prologue,
191  "",
192  void, (FILE *file, HOST_WIDE_INT size),
193  default_function_pro_epilogue)
194
195 /* Output the assembler code for end of prologue.  */
196 DEFHOOK
197 (function_end_prologue,
198  "",
199  void, (FILE *file),
200  no_asm_to_stream)
201
202 /* Output the assembler code for start of epilogue.  */
203 DEFHOOK
204 (function_begin_epilogue,
205  "",
206  void, (FILE *file),
207  no_asm_to_stream)
208
209 /* Output the assembler code for function exit.  */
210 DEFHOOK
211 (function_epilogue,
212  "",
213  void, (FILE *file, HOST_WIDE_INT size),
214  default_function_pro_epilogue)
215
216 /* Initialize target-specific sections.  */
217 DEFHOOK
218 (init_sections,
219  "",
220  void, (void),
221  hook_void_void)
222
223 /* Tell assembler to change to section NAME with attributes FLAGS.
224    If DECL is non-NULL, it is the VAR_DECL or FUNCTION_DECL with
225    which this section is associated.  */
226 DEFHOOK
227 (named_section,
228  "",
229  void, (const char *name, unsigned int flags, tree decl),
230  default_no_named_section)
231
232 /* Return preferred text (sub)section for function DECL.
233    Main purpose of this function is to separate cold, normal and hot
234    functions. STARTUP is true when function is known to be used only 
235    at startup (from static constructors or it is main()).
236    EXIT is true when function is known to be used only at exit
237    (from static destructors).
238    Return NULL if function should go to default text section.  */
239 DEFHOOK
240 (function_section,
241  "",
242  section *, (tree decl, enum node_frequency freq, bool startup, bool exit),
243  default_function_section)
244
245 /* Output the assembler code for function exit.  */
246 DEFHOOK
247 (function_switched_text_sections,
248  "Used by the target to emit any assembler directives or additional\
249   labels needed when a function is partitioned between different\
250   sections.  Output should be written to @var{file}.  The function\
251   decl is available as @var{decl} and the new section is `cold' if\
252   @var{new_is_cold} is @code{true}.",
253  void, (FILE *file, tree decl, bool new_is_cold),
254  default_function_switched_text_sections)
255
256 /* Return a mask describing how relocations should be treated when
257    selecting sections.  Bit 1 should be set if global relocations
258    should be placed in a read-write section; bit 0 should be set if
259    local relocations should be placed in a read-write section.  */
260 DEFHOOK
261 (reloc_rw_mask,
262  "",
263  int, (void),
264  default_reloc_rw_mask)
265
266  /* Return a section for EXP.  It may be a DECL or a constant.  RELOC
267     is nonzero if runtime relocations must be applied; bit 1 will be
268     set if the runtime relocations require non-local name resolution.
269     ALIGN is the required alignment of the data.  */
270 DEFHOOK
271 (select_section,
272  "",
273  section *, (tree exp, int reloc, unsigned HOST_WIDE_INT align),
274  default_select_section)
275
276 /* Return a section for X.  MODE is X's mode and ALIGN is its
277    alignment in bits.  */
278 DEFHOOK
279 (select_rtx_section,
280  "",
281  section *, (enum machine_mode mode, rtx x, unsigned HOST_WIDE_INT align),
282  default_select_rtx_section)
283
284 /* Select a unique section name for DECL.  RELOC is the same as
285    for SELECT_SECTION.  */
286 DEFHOOK
287 (unique_section,
288  "",
289  void, (tree decl, int reloc),
290  default_unique_section)
291
292 /* Return the readonly data section associated with function DECL.  */
293 DEFHOOK
294 (function_rodata_section,
295  "",
296  section *, (tree decl),
297  default_function_rodata_section)
298
299 /* Output a constructor for a symbol with a given priority.  */
300 DEFHOOK
301 (constructor,
302  "",
303  void, (rtx symbol, int priority), NULL)
304
305 /* Output a destructor for a symbol with a given priority.  */
306 DEFHOOK
307 (destructor,
308  "",
309  void, (rtx symbol, int priority), NULL)
310
311 /* Output the assembler code for a thunk function.  THUNK_DECL is the
312    declaration for the thunk function itself, FUNCTION is the decl for
313    the target function.  DELTA is an immediate constant offset to be
314    added to THIS.  If VCALL_OFFSET is nonzero, the word at
315    *(*this + vcall_offset) should be added to THIS.  */
316 DEFHOOK
317 (output_mi_thunk,
318  "",
319  void, (FILE *file, tree thunk_fndecl, HOST_WIDE_INT delta,
320         HOST_WIDE_INT vcall_offset, tree function),
321  NULL)
322
323 /* Determine whether output_mi_thunk would succeed.  */
324 /* ??? Ideally, this hook would not exist, and success or failure
325    would be returned from output_mi_thunk directly.  But there's
326    too much undo-able setup involved in invoking output_mi_thunk.
327    Could be fixed by making output_mi_thunk emit rtl instead of
328    text to the output file.  */
329 DEFHOOK
330 (can_output_mi_thunk,
331  "",
332  bool, (const_tree thunk_fndecl, HOST_WIDE_INT delta,
333         HOST_WIDE_INT vcall_offset, const_tree function),
334  hook_bool_const_tree_hwi_hwi_const_tree_false)
335
336 /* Output any boilerplate text needed at the beginning of a
337    translation unit.  */
338 DEFHOOK
339 (file_start,
340  "",
341  void, (void),
342  default_file_start)
343
344 /* Output any boilerplate text needed at the end of a translation unit.  */
345 DEFHOOK
346 (file_end,
347  "",
348  void, (void),
349  hook_void_void)
350
351 /* Output any boilerplate text needed at the beginning of an
352    LTO output stream.  */
353 DEFHOOK
354 (lto_start,
355  "",
356  void, (void),
357  hook_void_void)
358
359 /* Output any boilerplate text needed at the end of an
360    LTO output stream.  */
361 DEFHOOK
362 (lto_end,
363  "",
364  void, (void),
365  hook_void_void)
366
367 /* Output any boilerplace text needed at the end of a
368    translation unit before debug and unwind info is emitted.  */
369 DEFHOOK
370 (code_end,
371  "",
372  void, (void),
373  hook_void_void)
374
375 /* Output an assembler pseudo-op to declare a library function name
376    external.  */
377 DEFHOOK
378 (external_libcall,
379  "",
380  void, (rtx symref),
381  default_external_libcall)
382
383 /* Output an assembler directive to mark decl live. This instructs
384    linker to not dead code strip this symbol.  */
385 DEFHOOK
386 (mark_decl_preserved,
387  "",
388  void, (const char *symbol),
389  hook_void_constcharptr)
390
391 /* Output a record of the command line switches that have been passed.  */
392 DEFHOOK
393 (record_gcc_switches,
394  "",
395  int, (print_switch_type type, const char *text),
396  NULL)
397
398 /* The name of the section that the example ELF implementation of
399    record_gcc_switches will use to store the information.  Target
400    specific versions of record_gcc_switches may or may not use
401    this information.  */
402 DEFHOOKPOD
403 (record_gcc_switches_section,
404  "",
405  const char *, ".GCC.command.line")
406
407 /* Output the definition of a section anchor.  */
408 DEFHOOK
409 (output_anchor,
410  "",
411  void, (rtx x),
412  default_asm_output_anchor)
413
414 /* Output a DTP-relative reference to a TLS symbol.  */
415 DEFHOOK
416 (output_dwarf_dtprel,
417  "",
418  void, (FILE *file, int size, rtx x),
419  NULL)
420
421 /* Some target machines need to postscan each insn after it is output.  */
422 DEFHOOK
423 (final_postscan_insn,
424  "",
425  void, (FILE *file, rtx insn, rtx *opvec, int noperands),
426  NULL)
427
428 /* Emit the trampoline template.  This hook may be NULL.  */
429 DEFHOOK
430 (trampoline_template,
431  "",
432  void, (FILE *f),
433  NULL)
434
435 DEFHOOK
436 (output_source_filename,
437  "Output COFF information or DWARF debugging information which indicates\
438  that filename @var{name} is the current source file to the stdio\
439  stream @var{file}.\n\
440  \n\
441  This target hook need not be defined if the standard form of output\
442  for the file format in use is appropriate.",
443  void ,(FILE *file, const char *name),
444  default_asm_output_source_filename)
445
446 DEFHOOK
447 (output_addr_const_extra,
448  "",
449  bool, (FILE *file, rtx x),
450  default_asm_output_addr_const_extra)
451
452 /* ??? The TARGET_PRINT_OPERAND* hooks are part of the asm_out struct,
453    even though that is not reflected in the macro name to override their
454    initializers.  */
455 #undef HOOK_PREFIX
456 #define HOOK_PREFIX "TARGET_"
457
458 /* Emit a machine-specific insn operand.  */
459 /* ??? tm.texi only documents the old macro PRINT_OPERAND,
460    not this  hook, and uses a different name for the argument FILE.  */
461 DEFHOOK_UNDOC
462 (print_operand,
463  "",
464  void, (FILE *file, rtx x, int code),
465  default_print_operand)
466
467 /* Emit a machine-specific memory address.  */
468 /* ??? tm.texi only documents the old macro PRINT_OPERAND_ADDRESS,
469    not this  hook, and uses different argument names.  */
470 DEFHOOK_UNDOC
471 (print_operand_address,
472  "",
473  void, (FILE *file, rtx addr),
474  default_print_operand_address)
475
476 /* Determine whether CODE is a valid punctuation character for the
477    `print_operand' hook.  */
478 /* ??? tm.texi only documents the old macro PRINT_OPERAND_PUNCT_VALID_P,
479    not this  hook.  */
480 DEFHOOK_UNDOC
481 (print_operand_punct_valid_p,
482  "",
483  bool ,(unsigned char code),
484  default_print_operand_punct_valid_p)
485
486 /* Given a symbol name, perform same mangling as assemble_name and
487    ASM_OUTPUT_LABELREF, returning result as an IDENTIFIER_NODE.  */
488 DEFHOOK
489 (mangle_assembler_name,
490  "Given a symbol @var{name}, perform same mangling as @code{varasm.c}'s\
491  @code{assemble_name}, but in memory rather than to a file stream, returning\
492  result as an @code{IDENTIFIER_NODE}.  Required for correct LTO symtabs.  The\
493  default implementation calls the @code{TARGET_STRIP_NAME_ENCODING} hook and\
494  then prepends the @code{USER_LABEL_PREFIX}, if any.",
495  tree, (const char *name),
496  default_mangle_assembler_name)
497
498 HOOK_VECTOR_END (asm_out)
499
500 /* Functions relating to instruction scheduling.  All of these
501    default to null pointers, which haifa-sched.c looks for and handles.  */
502 #undef HOOK_PREFIX
503 #define HOOK_PREFIX "TARGET_SCHED_"
504 HOOK_VECTOR (TARGET_SCHED, sched)
505
506 /* Given the current cost, COST, of an insn, INSN, calculate and
507    return a new cost based on its relationship to DEP_INSN through
508    the dependence LINK.  The default is to make no adjustment.  */
509 DEFHOOK
510 (adjust_cost,
511  "",
512  int, (rtx insn, rtx link, rtx dep_insn, int cost), NULL)
513
514 /* Adjust the priority of an insn as you see fit.  Returns the new priority.  */
515 DEFHOOK
516 (adjust_priority,
517  "",
518  int, (rtx insn, int priority), NULL)
519
520 /* Function which returns the maximum number of insns that can be
521    scheduled in the same machine cycle.  This must be constant
522    over an entire compilation.  The default is 1.  */
523 DEFHOOK
524 (issue_rate,
525  "",
526  int, (void), NULL)
527
528 /* Calculate how much this insn affects how many more insns we
529    can emit this cycle.  Default is they all cost the same.  */
530 DEFHOOK
531 (variable_issue,
532  "",
533  int, (FILE *file, int verbose, rtx insn, int more), NULL)
534
535 /* Initialize machine-dependent scheduling code.  */
536 DEFHOOK
537 (init,
538  "",
539  void, (FILE *file, int verbose, int max_ready), NULL)
540
541 /* Finalize machine-dependent scheduling code.  */
542 DEFHOOK
543 (finish,
544  "",
545  void, (FILE *file, int verbose), NULL)
546
547  /* Initialize machine-dependent function wide scheduling code.  */
548 DEFHOOK
549 (init_global,
550  "",
551  void, (FILE *file, int verbose, int old_max_uid), NULL)
552
553 /* Finalize machine-dependent function wide scheduling code.  */
554 DEFHOOK
555 (finish_global,
556  "",
557  void, (FILE *file, int verbose), NULL)
558
559 /* Reorder insns in a machine-dependent fashion, in two different
560        places.  Default does nothing.  */
561 DEFHOOK
562 (reorder,
563  "",
564  int, (FILE *file, int verbose, rtx *ready, int *n_readyp, int clock), NULL)
565
566 DEFHOOK
567 (reorder2,
568  "",
569  int, (FILE *file, int verbose, rtx *ready, int *n_readyp, int clock), NULL)
570
571 /* The following member value is a pointer to a function called
572    after evaluation forward dependencies of insns in chain given
573    by two parameter values (head and tail correspondingly).  */
574 DEFHOOK
575 (dependencies_evaluation_hook,
576  "",
577  void, (rtx head, rtx tail), NULL)
578
579 /* The values of the following four members are pointers to functions
580    used to simplify the automaton descriptions.  dfa_pre_cycle_insn and
581    dfa_post_cycle_insn give functions returning insns which are used to
582    change the pipeline hazard recognizer state when the new simulated
583    processor cycle correspondingly starts and finishes.  The function
584    defined by init_dfa_pre_cycle_insn and init_dfa_post_cycle_insn are
585    used to initialize the corresponding insns.  The default values of
586    the members result in not changing the automaton state when the
587    new simulated processor cycle correspondingly starts and finishes.  */
588
589 DEFHOOK
590 (init_dfa_pre_cycle_insn,
591  "",
592  void, (void), NULL)
593
594 DEFHOOK
595 (dfa_pre_cycle_insn,
596  "",
597  rtx, (void), NULL)
598
599 DEFHOOK
600 (init_dfa_post_cycle_insn,
601  "",
602  void, (void), NULL)
603
604 DEFHOOK
605 (dfa_post_cycle_insn,
606  "",
607  rtx, (void), NULL)
608
609 /* The values of the following two members are pointers to
610    functions used to simplify the automaton descriptions.
611    dfa_pre_advance_cycle and dfa_post_advance_cycle are getting called
612    immediately before and after cycle is advanced.  */
613
614 DEFHOOK
615 (dfa_pre_advance_cycle,
616  "",
617  void, (void), NULL)
618
619 DEFHOOK
620 (dfa_post_advance_cycle,
621  "",
622  void, (void), NULL)
623
624 /* The following member value is a pointer to a function returning value
625    which defines how many insns in queue `ready' will we try for
626    multi-pass scheduling.  If the member value is nonzero and the
627    function returns positive value, the DFA based scheduler will make
628    multi-pass scheduling for the first cycle.  In other words, we will
629    try to choose ready insn which permits to start maximum number of
630    insns on the same cycle.  */
631 DEFHOOK
632 (first_cycle_multipass_dfa_lookahead,
633  "",
634  int, (void), NULL)
635
636 /* The following member value is pointer to a function controlling
637    what insns from the ready insn queue will be considered for the
638    multipass insn scheduling.  If the hook returns zero for insn
639    passed as the parameter, the insn will be not chosen to be issued.  */
640 DEFHOOK
641 (first_cycle_multipass_dfa_lookahead_guard,
642  "",
643  int, (rtx insn), NULL)
644
645 /* This hook prepares the target for a new round of multipass
646    scheduling.
647    DATA is a pointer to target-specific data used for multipass scheduling.
648    READY_TRY and N_READY represent the current state of search in the
649    optimization space.  The target can filter out instructions that
650    should not be tried during current round by setting corresponding
651    elements in READY_TRY to non-zero.
652    FIRST_CYCLE_INSN_P is true if this is the first round of multipass
653    scheduling on current cycle.  */
654 DEFHOOK
655 (first_cycle_multipass_begin,
656  "",
657  void, (void *data, char *ready_try, int n_ready, bool first_cycle_insn_p),
658  NULL)
659
660 /* This hook is called when multipass scheduling evaluates instruction INSN.
661    DATA is a pointer to target-specific data that can be used to record effects
662    of INSN on CPU that are not described in DFA.
663    READY_TRY and N_READY represent the current state of search in the
664    optimization space.  The target can filter out instructions that
665    should not be tried after issueing INSN by setting corresponding
666    elements in READY_TRY to non-zero.
667    INSN is the instruction being evaluated.
668    PREV_DATA is a pointer to target-specific data corresponding
669    to a state before issueing INSN.  */
670 DEFHOOK
671 (first_cycle_multipass_issue,
672  "",
673  void, (void *data, char *ready_try, int n_ready, rtx insn,
674         const void *prev_data), NULL)
675
676 /* This hook is called when multipass scheduling backtracks from evaluation of
677    instruction corresponding to DATA.
678    DATA is a pointer to target-specific data that stores the effects
679    of instruction from which the algorithm backtracks on CPU that are not
680    described in DFA.
681    READY_TRY and N_READY represent the current state of search in the
682    optimization space.  The target can filter out instructions that
683    should not be tried after issueing INSN by setting corresponding
684    elements in READY_TRY to non-zero.  */
685 DEFHOOK
686 (first_cycle_multipass_backtrack,
687  "",
688  void, (const void *data, char *ready_try, int n_ready), NULL)
689
690 /* This hook notifies the target about the result of the concluded current
691    round of multipass scheduling.
692    DATA is a pointer.
693    If DATA is non-NULL it points to target-specific data used for multipass
694    scheduling which corresponds to instruction at the start of the chain of
695    the winning solution.  DATA is NULL when multipass scheduling cannot find
696    a good enough solution on current cycle and decides to retry later,
697    usually after advancing the cycle count.  */
698 DEFHOOK
699 (first_cycle_multipass_end,
700  "",
701  void, (const void *data), NULL)
702
703 /* This hook is called to initialize target-specific data for multipass
704    scheduling after it has been allocated.
705    DATA is a pointer to target-specific data that stores the effects
706    of instruction from which the algorithm backtracks on CPU that are not
707    described in DFA.  */
708 DEFHOOK
709 (first_cycle_multipass_init,
710  "",
711  void, (void *data), NULL)
712
713 /* This hook is called to finalize target-specific data for multipass
714    scheduling before it is deallocated.
715    DATA is a pointer to target-specific data that stores the effects
716    of instruction from which the algorithm backtracks on CPU that are not
717    described in DFA.  */
718 DEFHOOK
719 (first_cycle_multipass_fini,
720  "",
721  void, (void *data), NULL)
722
723 /* The following member value is pointer to a function called by
724    the insn scheduler before issuing insn passed as the third
725    parameter on given cycle.  If the hook returns nonzero, the
726    insn is not issued on given processors cycle.  Instead of that,
727    the processor cycle is advanced.  If the value passed through
728    the last parameter is zero, the insn ready queue is not sorted
729    on the new cycle start as usually.  The first parameter passes
730    file for debugging output.  The second one passes the scheduler
731    verbose level of the debugging output.  The forth and the fifth
732    parameter values are correspondingly processor cycle on which
733    the previous insn has been issued and the current processor cycle.  */
734 DEFHOOK
735 (dfa_new_cycle,
736  "",
737  int, (FILE *dump, int verbose, rtx insn, int last_clock,
738        int clock, int *sort_p),
739  NULL)
740
741 /* The following member value is a pointer to a function called by the
742    insn scheduler.  It should return true if there exists a dependence
743    which is considered costly by the target, between the insn
744    DEP_PRO (&_DEP), and the insn DEP_CON (&_DEP).  The first parameter is
745    the dep that represents the dependence between the two insns.  The
746    second argument is the cost of the dependence as estimated by
747    the scheduler.  The last argument is the distance in cycles
748    between the already scheduled insn (first parameter) and the
749    second insn (second parameter).  */
750 DEFHOOK
751 (is_costly_dependence,
752  "",
753  bool, (struct _dep *_dep, int cost, int distance), NULL)
754
755 DEFHOOK_UNDOC
756 (adjust_cost_2,
757  "Given the current cost, @var{cost}, of an insn, @var{insn}, calculate and\
758  return a new cost based on its relationship to @var{dep_insn} through the\
759  dependence of weakness @var{dw}.  The default is to make no adjustment.",
760  int, (rtx insn, int dep_type1, rtx dep_insn, int cost, int dw), NULL)
761
762 /* The following member value is a pointer to a function called
763    by the insn scheduler. This hook is called to notify the backend
764    that new instructions were emitted.  */
765 DEFHOOK
766 (h_i_d_extended,
767  "",
768  void, (void), NULL)
769
770 /* Next 5 functions are for multi-point scheduling.  */
771
772 /* Allocate memory for scheduler context.  */
773 DEFHOOK
774 (alloc_sched_context,
775  "",
776  void *, (void), NULL)
777
778 /* Fills the context from the local machine scheduler context.  */
779 DEFHOOK
780 (init_sched_context,
781  "",
782  void, (void *tc, bool clean_p), NULL)
783
784 /* Sets local machine scheduler context to a saved value.  */
785 DEFHOOK
786 (set_sched_context,
787  "",
788  void, (void *tc), NULL)
789
790 /* Clears a scheduler context so it becomes like after init.  */
791 DEFHOOK
792 (clear_sched_context,
793  "",
794  void, (void *tc), NULL)
795
796 /* Frees the scheduler context.  */
797 DEFHOOK
798 (free_sched_context,
799  "",
800  void, (void *tc), NULL)
801
802 /* The following member value is a pointer to a function called
803    by the insn scheduler.
804    The first parameter is an instruction, the second parameter is the type
805    of the requested speculation, and the third parameter is a pointer to the
806    speculative pattern of the corresponding type (set if return value == 1).
807    It should return
808    -1, if there is no pattern, that will satisfy the requested speculation type,
809    0, if current pattern satisfies the requested speculation type,
810    1, if pattern of the instruction should be changed to the newly
811    generated one.  */
812 DEFHOOK
813 (speculate_insn,
814  "",
815  int, (rtx insn, int request, rtx *new_pat), NULL)
816
817 /* The following member value is a pointer to a function called
818    by the insn scheduler.  It should return true if the check instruction
819    passed as the parameter needs a recovery block.  */
820 DEFHOOK
821 (needs_block_p,
822  "",
823  bool, (int dep_status), NULL)
824
825 /* The following member value is a pointer to a function called
826    by the insn scheduler.  It should return a pattern for the check
827    instruction.
828    The first parameter is a speculative instruction, the second parameter
829    is the label of the corresponding recovery block (or null, if it is a
830    simple check).  If the mutation of the check is requested (e.g. from
831    ld.c to chk.a), the third parameter is true - in this case the first
832    parameter is the previous check.  */
833 DEFHOOK
834 (gen_spec_check,
835  "",
836  rtx, (rtx insn, rtx label, int mutate_p), NULL)
837
838 /* The following member value is a pointer to a function controlling
839    what insns from the ready insn queue will be considered for the
840    multipass insn scheduling.  If the hook returns zero for the insn
841    passed as the parameter, the insn will not be chosen to be
842    issued.  This hook is used to discard speculative instructions,
843    that stand at the first position of the ready list.  */
844 DEFHOOK
845 (first_cycle_multipass_dfa_lookahead_guard_spec,
846  "",
847  bool, (const_rtx insn), NULL)
848
849 /* The following member value is a pointer to a function that provides
850    information about the speculation capabilities of the target.
851    The parameter is a pointer to spec_info variable.  */
852 DEFHOOK
853 (set_sched_flags,
854  "",
855  void, (struct spec_info_def *spec_info), NULL)
856
857 DEFHOOK_UNDOC
858 (get_insn_spec_ds,
859  "Return speculation types of instruction @var{insn}.",
860  int, (rtx insn), NULL)
861
862 DEFHOOK_UNDOC
863 (get_insn_checked_ds,
864  "Return speculation types that are checked for instruction @var{insn}",
865  int, (rtx insn), NULL)
866
867 DEFHOOK_UNDOC
868 (skip_rtx_p,
869  "Return bool if rtx scanning should just skip current layer and\
870  advance to the inner rtxes.",
871  bool, (const_rtx x), NULL)
872
873 /* The following member value is a pointer to a function that provides
874    information about the target resource-based lower bound which is
875    used by the swing modulo scheduler.  The parameter is a pointer
876    to ddg variable.  */
877 DEFHOOK
878 (sms_res_mii,
879  "",
880  int, (struct ddg *g), NULL)
881
882 /* The following member value is a function that initializes dispatch
883    schedling and adds instructions to dispatch window according to its
884    parameters.  */
885 DEFHOOK
886 (dispatch_do,
887 "",
888 void, (rtx insn, int x),
889 hook_void_rtx_int)
890
891 /* The following member value is a a function that returns true is
892    dispatch schedling is supported in hardware and condition passed
893    as the second parameter is true.  */
894 DEFHOOK
895 (dispatch,
896 "",
897 bool, (rtx insn, int x),
898 hook_bool_rtx_int_false)
899
900 HOOK_VECTOR_END (sched)
901
902 /* Functions relating to vectorization.  */
903 #undef HOOK_PREFIX
904 #define HOOK_PREFIX "TARGET_VECTORIZE_"
905 HOOK_VECTOR (TARGET_VECTORIZE, vectorize)
906
907 /* The following member value is a pointer to a function called
908    by the vectorizer, and return the decl of the target builtin
909    function.  */
910 DEFHOOK
911 (builtin_mask_for_load,
912  "",
913  tree, (void), NULL)
914
915 /* Returns a code for builtin that realizes vectorized version of
916    function, or NULL_TREE if not available.  */
917 DEFHOOK
918 (builtin_vectorized_function,
919  "",
920  tree, (tree fndecl, tree vec_type_out, tree vec_type_in),
921  default_builtin_vectorized_function)
922
923 /* Returns a function declaration for a builtin that realizes the
924    vector conversion, or NULL_TREE if not available.  */
925 DEFHOOK
926 (builtin_conversion,
927  "",
928  tree, (unsigned code, tree dest_type, tree src_type),
929  default_builtin_vectorized_conversion)
930
931 /* Target builtin that implements vector widening multiplication.
932    builtin_mul_widen_eve computes the element-by-element products
933    for the even elements, and builtin_mul_widen_odd computes the
934    element-by-element products for the odd elements.  */
935 DEFHOOK
936 (builtin_mul_widen_even,
937  "",
938  tree, (tree x), NULL)
939
940 DEFHOOK
941 (builtin_mul_widen_odd,
942  "",
943  tree, (tree x), NULL)
944
945 /* Cost of different vector/scalar statements in vectorization cost
946    model. In case of misaligned vector loads and stores the cost depends
947    on the data type and misalignment value.  */
948 DEFHOOK
949 (builtin_vectorization_cost,
950  "",
951  int, (enum vect_cost_for_stmt type_of_cost, tree vectype, int misalign),
952  default_builtin_vectorization_cost)
953
954 /* Return true if vector alignment is reachable (by peeling N
955    iterations) for the given type.  */
956 DEFHOOK
957 (vector_alignment_reachable,
958  "",
959  bool, (const_tree type, bool is_packed),
960  default_builtin_vector_alignment_reachable)
961
962 /* Target builtin that implements vector permute.  */
963 DEFHOOK
964 (builtin_vec_perm,
965  "",
966  tree, (tree type, tree *mask_element_type), NULL)
967
968 /* Return true if a vector created for builtin_vec_perm is valid.  */
969 DEFHOOK
970 (builtin_vec_perm_ok,
971  "",
972  bool, (tree vec_type, tree mask),
973  hook_bool_tree_tree_true)
974
975 /* Return true if the target supports misaligned store/load of a
976    specific factor denoted in the third parameter.  The last parameter
977    is true if the access is defined in a packed struct.  */
978 DEFHOOK
979 (support_vector_misalignment,
980  "",
981  bool,
982  (enum machine_mode mode, const_tree type, int misalignment, bool is_packed),
983  default_builtin_support_vector_misalignment)
984
985 /* Returns the preferred mode for SIMD operations for the specified
986    scalar mode.  */
987 DEFHOOK
988 (preferred_simd_mode,
989  "",
990  enum machine_mode,
991  (enum machine_mode mode),
992  default_preferred_simd_mode)
993
994 /* Returns a mask of vector sizes to iterate over when auto-vectorizing
995    after processing the preferred one derived from preferred_simd_mode.  */
996 DEFHOOK
997 (autovectorize_vector_sizes,
998  "",
999  unsigned int,
1000  (void),
1001  default_autovectorize_vector_sizes)
1002
1003 HOOK_VECTOR_END (vectorize)
1004
1005 #undef HOOK_PREFIX
1006 #define HOOK_PREFIX "TARGET_"
1007
1008 /* The initial value of target_flags.  */
1009 DEFHOOKPOD
1010 (default_target_flags,
1011  "",
1012  int, 0)
1013
1014 /* Allow target specific overriding of option settings after options have
1015   been changed by an attribute or pragma or when it is reset at the
1016   end of the code affected by an attribute or pragma.  */
1017 DEFHOOK
1018 (override_options_after_change,
1019  "",
1020  void, (void),
1021  hook_void_void)
1022
1023 /* Handle target switch DECODED for options structures OPTS and
1024    OPTS_SET, at location LOC.  Return true if the switch was valid.  */
1025 DEFHOOK
1026 (handle_option,
1027  "",
1028  bool, (struct gcc_options *opts, struct gcc_options *opts_set,
1029         const struct cl_decoded_option *decoded,
1030         unsigned int /*location_t*/ loc),
1031  default_target_handle_option)
1032
1033 /* Display extra, target specific information in response to a
1034    --target-help switch.  */
1035 DEFHOOK
1036 (help,
1037  "",
1038  void, (void), NULL)
1039
1040 DEFHOOK_UNDOC
1041 (eh_return_filter_mode,
1042  "Return machine mode for filter value.",
1043  enum machine_mode, (void),
1044  default_eh_return_filter_mode)
1045
1046 /* Return machine mode for libgcc expanded cmp instructions.  */
1047 DEFHOOK
1048 (libgcc_cmp_return_mode,
1049  "",
1050  enum machine_mode, (void),
1051  default_libgcc_cmp_return_mode)
1052
1053 /* Return machine mode for libgcc expanded shift instructions.  */
1054 DEFHOOK
1055 (libgcc_shift_count_mode,
1056  "",
1057  enum machine_mode, (void),
1058  default_libgcc_shift_count_mode)
1059
1060 /* Return machine mode to be used for _Unwind_Word type.  */
1061 DEFHOOK
1062 (unwind_word_mode,
1063  "",
1064  enum machine_mode, (void),
1065  default_unwind_word_mode)
1066
1067 /* Given two decls, merge their attributes and return the result.  */
1068 DEFHOOK
1069 (merge_decl_attributes,
1070  "",
1071  tree, (tree olddecl, tree newdecl),
1072  merge_decl_attributes)
1073
1074 /* Given two types, merge their attributes and return the result.  */
1075 DEFHOOK
1076 (merge_type_attributes,
1077  "",
1078  tree, (tree type1, tree type2),
1079  merge_type_attributes)
1080
1081 /* Table of machine attributes and functions to handle them.
1082    Ignored if NULL.  */
1083 DEFHOOKPOD
1084 (attribute_table,
1085  "",
1086  const struct attribute_spec *, NULL)
1087
1088 /* Return true iff attribute NAME expects a plain identifier as its first
1089    argument.  */
1090 DEFHOOK
1091 (attribute_takes_identifier_p,
1092  "",
1093  bool, (const_tree name),
1094  hook_bool_const_tree_false)
1095
1096 /* Return zero if the attributes on TYPE1 and TYPE2 are incompatible,
1097    one if they are compatible and two if they are nearly compatible
1098    (which causes a warning to be generated).  */
1099 DEFHOOK
1100 (comp_type_attributes,
1101  "",
1102  int, (const_tree type1, const_tree type2),
1103  hook_int_const_tree_const_tree_1)
1104
1105 /* Assign default attributes to the newly defined TYPE.  */
1106 DEFHOOK
1107 (set_default_type_attributes,
1108  "",
1109  void, (tree type),
1110  hook_void_tree)
1111
1112 /* Insert attributes on the newly created DECL.  */
1113 DEFHOOK
1114 (insert_attributes,
1115  "",
1116  void, (tree node, tree *attr_ptr),
1117  hook_void_tree_treeptr)
1118
1119 /* Return true if FNDECL (which has at least one machine attribute)
1120    can be inlined despite its machine attributes, false otherwise.  */
1121 DEFHOOK
1122 (function_attribute_inlinable_p,
1123  "",
1124  bool, (const_tree fndecl),
1125  hook_bool_const_tree_false)
1126
1127 /* Return true if bitfields in RECORD_TYPE should follow the
1128    Microsoft Visual C++ bitfield layout rules.  */
1129 DEFHOOK
1130 (ms_bitfield_layout_p,
1131  "",
1132  bool, (const_tree record_type),
1133  hook_bool_const_tree_false)
1134
1135 /* For now this is only an interface to WORDS_BIG_ENDIAN for
1136    target-independent code like the front ends, need performance testing
1137    before switching completely to the target hook.  */
1138 DEFHOOK_UNDOC
1139 (words_big_endian,
1140  "",
1141  bool, (void),
1142  targhook_words_big_endian)
1143
1144 /* Likewise for FLOAT_WORDS_BIG_ENDIAN.  */
1145 DEFHOOK_UNDOC
1146 (float_words_big_endian,
1147  "",
1148  bool, (void),
1149  targhook_float_words_big_endian)
1150
1151 /* True if the target supports decimal floating point.  */
1152 DEFHOOK
1153 (decimal_float_supported_p,
1154  "",
1155  bool, (void),
1156  default_decimal_float_supported_p)
1157
1158 /* True if the target supports fixed-point.  */
1159 DEFHOOK
1160 (fixed_point_supported_p,
1161  "",
1162  bool, (void),
1163  default_fixed_point_supported_p)
1164
1165 /* Return true if anonymous bitfields affect structure alignment.  */
1166 DEFHOOK
1167 (align_anon_bitfield,
1168  "",
1169  bool, (void),
1170  hook_bool_void_false)
1171
1172 /* Return true if volatile bitfields should use the narrowest type possible.
1173    Return false if they should use the container type.  */
1174 DEFHOOK
1175 (narrow_volatile_bitfield,
1176  "",
1177  bool, (void),
1178  hook_bool_void_false)
1179
1180 /* Set up target-specific built-in functions.  */
1181 DEFHOOK
1182 (init_builtins,
1183  "",
1184  void, (void),
1185  hook_void_void)
1186
1187 /* Initialize (if INITIALIZE_P is true) and return the target-specific
1188    built-in function decl for CODE.
1189    Return NULL if that is not possible.  Return error_mark_node if CODE
1190    is outside of the range of valid target builtin function codes.  */
1191 DEFHOOK
1192 (builtin_decl,
1193  "",
1194  tree, (unsigned code, bool initialize_p), NULL)
1195
1196 /* Expand a target-specific builtin.  */
1197 DEFHOOK
1198 (expand_builtin,
1199  "",
1200  rtx,
1201  (tree exp, rtx target, rtx subtarget, enum machine_mode mode, int ignore),
1202  default_expand_builtin)
1203
1204 /* Select a replacement for a target-specific builtin.  This is done
1205    *before* regular type checking, and so allows the target to
1206    implement a crude form of function overloading.  The result is a
1207    complete expression that implements the operation.  PARAMS really
1208    has type VEC(tree,gc)*, but we don't want to include tree.h here.  */
1209 DEFHOOK
1210 (resolve_overloaded_builtin,
1211  "",
1212  tree, (unsigned int /*location_t*/ loc, tree fndecl, void *arglist), NULL)
1213
1214 /* Fold a target-specific builtin.  */
1215 DEFHOOK
1216 (fold_builtin,
1217  "",
1218  tree, (tree fndecl, int n_args, tree *argp, bool ignore),
1219  hook_tree_tree_int_treep_bool_null)
1220
1221 /* Returns a code for a target-specific builtin that implements
1222    reciprocal of the function, or NULL_TREE if not available.  */
1223 DEFHOOK
1224 (builtin_reciprocal,
1225  "",
1226  tree, (unsigned fn, bool md_fn, bool sqrt),
1227  default_builtin_reciprocal)
1228
1229 /* For a vendor-specific TYPE, return a pointer to a statically-allocated
1230    string containing the C++ mangling for TYPE.  In all other cases, return
1231    NULL.  */
1232 DEFHOOK
1233 (mangle_type,
1234  "",
1235  const char *, (const_tree type),
1236  hook_constcharptr_const_tree_null)
1237
1238 /* Make any adjustments to libfunc names needed for this target.  */
1239 DEFHOOK
1240 (init_libfuncs,
1241  "",
1242  void, (void),
1243  hook_void_void)
1244
1245  /* Add a __gnu_ prefix to library functions rather than just __.  */
1246 DEFHOOKPOD
1247 (libfunc_gnu_prefix,
1248  "If false (the default), internal library routines start with two\n\
1249 underscores.  If set to true, these routines start with @code{__gnu_}\n\
1250 instead.  E.g., @code{__muldi3} changes to @code{__gnu_muldi3}.  This\n\
1251 currently only affects functions defined in @file{libgcc2.c}.  If this\n\
1252 is set to true, the @file{tm.h} file must also\n\
1253 @code{#define LIBGCC2_GNU_PREFIX}.",
1254   bool, false)
1255
1256 /* Given a decl, a section name, and whether the decl initializer
1257    has relocs, choose attributes for the section.  */
1258 /* ??? Should be merged with SELECT_SECTION and UNIQUE_SECTION.  */
1259 DEFHOOK
1260 (section_type_flags,
1261  "",
1262  unsigned int, (tree decl, const char *name, int reloc),
1263  default_section_type_flags)
1264
1265 /* True if new jumps cannot be created, to replace existing ones or
1266    not, at the current point in the compilation.  */
1267 DEFHOOK
1268 (cannot_modify_jumps_p,
1269  "",
1270  bool, (void),
1271  hook_bool_void_false)
1272
1273 /* Return a register class for which branch target register
1274    optimizations should be applied.  */
1275 DEFHOOK
1276 (branch_target_register_class,
1277  "",
1278  reg_class_t, (void),
1279  default_branch_target_register_class)
1280
1281 /* Return true if branch target register optimizations should include
1282    callee-saved registers that are not already live during the current
1283    function.  AFTER_PE_GEN is true if prologues and epilogues have
1284    already been generated.  */
1285 DEFHOOK
1286 (branch_target_register_callee_saved,
1287  "",
1288  bool, (bool after_prologue_epilogue_gen),
1289  hook_bool_bool_false)
1290
1291 /* Return true if the target supports conditional execution.  */
1292 DEFHOOK
1293 (have_conditional_execution,
1294  "",
1295  bool, (void),
1296  default_have_conditional_execution)
1297
1298 /* Return a new value for loop unroll size.  */
1299 DEFHOOK
1300 (loop_unroll_adjust,
1301  "",
1302  unsigned, (unsigned nunroll, struct loop *loop),
1303  NULL)
1304
1305 /* True if X is a legitimate MODE-mode immediate operand.  */
1306 DEFHOOK
1307 (legitimate_constant_p,
1308  "",
1309  bool, (enum machine_mode mode, rtx x),
1310  hook_bool_mode_rtx_true)
1311
1312 /* True if the constant X cannot be placed in the constant pool.  */
1313 DEFHOOK
1314 (cannot_force_const_mem,
1315  "",
1316  bool, (enum machine_mode mode, rtx x),
1317  hook_bool_mode_rtx_false)
1318
1319 DEFHOOK_UNDOC
1320 (cannot_copy_insn_p,
1321  "True if the insn @var{x} cannot be duplicated.",
1322  bool, (rtx), NULL)
1323
1324 /* True if X is considered to be commutative.  */
1325 DEFHOOK
1326 (commutative_p,
1327  "",
1328  bool, (const_rtx x, int outer_code),
1329  hook_bool_const_rtx_commutative_p)
1330
1331 /* True if ADDR is an address-expression whose effect depends
1332    on the mode of the memory reference it is used in.  */
1333 DEFHOOK
1334 (mode_dependent_address_p,
1335  "",
1336  bool, (const_rtx addr),
1337  default_mode_dependent_address_p)
1338
1339 /* Given an invalid address X for a given machine mode, try machine-specific
1340    ways to make it legitimate.  Return X or an invalid address on failure.  */
1341 DEFHOOK
1342 (legitimize_address,
1343  "",
1344  rtx, (rtx x, rtx oldx, enum machine_mode mode),
1345  default_legitimize_address)
1346
1347 /* Given an address RTX, undo the effects of LEGITIMIZE_ADDRESS.  */
1348 DEFHOOK
1349 (delegitimize_address,
1350  "",
1351  rtx, (rtx x),
1352  delegitimize_mem_from_attrs)
1353
1354 /* Given an address RTX, say whether it is valid.  */
1355 DEFHOOK
1356 (legitimate_address_p,
1357  "",
1358  bool, (enum machine_mode mode, rtx x, bool strict),
1359  default_legitimate_address_p)
1360
1361 /* True if the given constant can be put into an object_block.  */
1362 DEFHOOK
1363 (use_blocks_for_constant_p,
1364  "",
1365  bool, (enum machine_mode mode, const_rtx x),
1366  hook_bool_mode_const_rtx_false)
1367
1368 /* The minimum and maximum byte offsets for anchored addresses.  */
1369 DEFHOOKPOD
1370 (min_anchor_offset,
1371  "",
1372  HOST_WIDE_INT, 0)
1373
1374 DEFHOOKPOD
1375 (max_anchor_offset,
1376  "",
1377  HOST_WIDE_INT, 0)
1378
1379 /* True if section anchors can be used to access the given symbol.  */
1380 DEFHOOK
1381 (use_anchors_for_symbol_p,
1382  "",
1383  bool, (const_rtx x),
1384  default_use_anchors_for_symbol_p)
1385
1386 /* True if it is OK to do sibling call optimization for the specified
1387    call expression EXP.  DECL will be the called function, or NULL if
1388    this is an indirect call.  */
1389 DEFHOOK
1390 (function_ok_for_sibcall,
1391  "",
1392  bool, (tree decl, tree exp),
1393  hook_bool_tree_tree_false)
1394
1395 /* Establish appropriate back-end context for processing the function
1396    FNDECL.  The argument might be NULL to indicate processing at top
1397    level, outside of any function scope.  */
1398 DEFHOOK
1399 (set_current_function,
1400  "",
1401  void, (tree decl), hook_void_tree)
1402
1403 /* True if EXP should be placed in a "small data" section.  */
1404 DEFHOOK
1405 (in_small_data_p,
1406  "",
1407  bool, (const_tree exp),
1408  hook_bool_const_tree_false)
1409
1410 /* True if EXP names an object for which name resolution must resolve
1411    to the current executable or shared library.  */
1412 DEFHOOK
1413 (binds_local_p,
1414  "",
1415  bool, (const_tree exp),
1416  default_binds_local_p)
1417
1418 /* Check if profiling code is before or after prologue.  */
1419 DEFHOOK
1420 (profile_before_prologue,
1421  "It returns true if target wants profile code emitted before prologue.\n\n\
1422 The default version of this hook use the target macro\n\
1423 @code{PROFILE_BEFORE_PROLOGUE}.",
1424  bool, (void),
1425  default_profile_before_prologue)
1426
1427 /* Modify and return the identifier of a DECL's external name,
1428    originally identified by ID, as required by the target,
1429    (eg, append @nn to windows32 stdcall function names).
1430    The default is to return ID without modification. */
1431 DEFHOOK
1432 (mangle_decl_assembler_name,
1433  "",
1434  tree, (tree decl, tree  id),
1435  default_mangle_decl_assembler_name)
1436
1437 /* Do something target-specific to record properties of the DECL into
1438    the associated SYMBOL_REF.  */
1439 DEFHOOK
1440 (encode_section_info,
1441  "",
1442  void, (tree decl, rtx rtl, int new_decl_p),
1443  default_encode_section_info)
1444
1445 /* Undo the effects of encode_section_info on the symbol string.  */
1446 DEFHOOK
1447 (strip_name_encoding,
1448  "",
1449  const char *, (const char *name),
1450  default_strip_name_encoding)
1451
1452 /* If shift optabs for MODE are known to always truncate the shift count,
1453    return the mask that they apply.  Return 0 otherwise.  */
1454 DEFHOOK
1455 (shift_truncation_mask,
1456  "",
1457  unsigned HOST_WIDE_INT, (enum machine_mode mode),
1458  default_shift_truncation_mask)
1459
1460 /* Return the number of divisions in the given MODE that should be present,
1461    so that it is profitable to turn the division into a multiplication by
1462    the reciprocal.  */
1463 DEFHOOK
1464 (min_divisions_for_recip_mul,
1465  "",
1466  unsigned int, (enum machine_mode mode),
1467  default_min_divisions_for_recip_mul)
1468
1469 /* If the representation of integral MODE is such that values are
1470    always sign-extended to a wider mode MODE_REP then return
1471    SIGN_EXTEND.  Return UNKNOWN otherwise.  */
1472 /* Note that the return type ought to be RTX_CODE, but that's not
1473    necessarily defined at this point.  */
1474 DEFHOOK
1475 (mode_rep_extended,
1476  "",
1477  int, (enum machine_mode mode, enum machine_mode rep_mode),
1478  default_mode_rep_extended)
1479
1480 /* True if MODE is valid for a pointer in __attribute__((mode("MODE"))).  */
1481 DEFHOOK
1482 (valid_pointer_mode,
1483  "",
1484  bool, (enum machine_mode mode),
1485  default_valid_pointer_mode)
1486
1487 /* Disambiguate with errno.  */
1488 DEFHOOK
1489 (ref_may_alias_errno,
1490  "Define this to return nonzero if the memory reference @var{ref}\
1491   may alias with the system C library errno location.  The default\
1492   version of this hook assumes the system C library errno location\
1493   is either a declaration of type int or accessed by dereferencing\
1494   a pointer to int.",
1495  bool, (struct ao_ref_s *ref),
1496  default_ref_may_alias_errno)
1497
1498 /* Support for named address spaces.  */
1499 #undef HOOK_PREFIX
1500 #define HOOK_PREFIX "TARGET_ADDR_SPACE_"
1501 HOOK_VECTOR (TARGET_ADDR_SPACE_HOOKS, addr_space)
1502
1503 /* MODE to use for a pointer into another address space.  */
1504 DEFHOOK
1505 (pointer_mode,
1506  "",
1507  enum machine_mode, (addr_space_t address_space),
1508  default_addr_space_pointer_mode)
1509
1510 /* MODE to use for an address in another address space.  */
1511 DEFHOOK
1512 (address_mode,
1513  "",
1514  enum machine_mode, (addr_space_t address_space),
1515  default_addr_space_address_mode)
1516
1517 /* True if MODE is valid for a pointer in __attribute__((mode("MODE")))
1518    in another address space.  */
1519 DEFHOOK
1520 (valid_pointer_mode,
1521  "",
1522  bool, (enum machine_mode mode, addr_space_t as),
1523  default_addr_space_valid_pointer_mode)
1524
1525 /* True if an address is a valid memory address to a given named address
1526    space for a given mode.  */
1527 DEFHOOK
1528 (legitimate_address_p,
1529  "",
1530  bool, (enum machine_mode mode, rtx exp, bool strict, addr_space_t as),
1531  default_addr_space_legitimate_address_p)
1532
1533 /* Return an updated address to convert an invalid pointer to a named
1534    address space to a valid one.  If NULL_RTX is returned use machine
1535    independent methods to make the address valid.  */
1536 DEFHOOK
1537 (legitimize_address,
1538  "",
1539  rtx, (rtx x, rtx oldx, enum machine_mode mode, addr_space_t as),
1540  default_addr_space_legitimize_address)
1541
1542 /* True if one named address space is a subset of another named address. */
1543 DEFHOOK
1544 (subset_p,
1545  "",
1546  bool, (addr_space_t superset, addr_space_t subset),
1547  default_addr_space_subset_p)
1548
1549 /* Function to convert an rtl expression from one address space to another.  */
1550 DEFHOOK
1551 (convert,
1552  "",
1553  rtx, (rtx op, tree from_type, tree to_type),
1554  default_addr_space_convert)
1555
1556 HOOK_VECTOR_END (addr_space)
1557
1558 #undef HOOK_PREFIX
1559 #define HOOK_PREFIX "TARGET_"
1560
1561 /* True if MODE is valid for the target.  By "valid", we mean able to
1562    be manipulated in non-trivial ways.  In particular, this means all
1563    the arithmetic is supported.  */
1564 DEFHOOK
1565 (scalar_mode_supported_p,
1566  "",
1567  bool, (enum machine_mode mode),
1568  default_scalar_mode_supported_p)
1569
1570 /* Similarly for vector modes.  "Supported" here is less strict.  At
1571    least some operations are supported; need to check optabs or builtins
1572    for further details.  */
1573 DEFHOOK
1574 (vector_mode_supported_p,
1575  "",
1576  bool, (enum machine_mode mode),
1577  hook_bool_mode_false)
1578
1579 /* True if we should try to use a scalar mode to represent an array,
1580    overriding the usual MAX_FIXED_MODE limit.  */
1581 DEFHOOK
1582 (array_mode_supported_p,
1583  "Return true if GCC should try to use a scalar mode to store an array\n\
1584 of @var{nelems} elements, given that each element has mode @var{mode}.\n\
1585 Returning true here overrides the usual @code{MAX_FIXED_MODE} limit\n\
1586 and allows GCC to use any defined integer mode.\n\
1587 \n\
1588 One use of this hook is to support vector load and store operations\n\
1589 that operate on several homogeneous vectors.  For example, ARM NEON\n\
1590 has operations like:\n\
1591 \n\
1592 @smallexample\n\
1593 int8x8x3_t vld3_s8 (const int8_t *)\n\
1594 @end smallexample\n\
1595 \n\
1596 where the return type is defined as:\n\
1597 \n\
1598 @smallexample\n\
1599 typedef struct int8x8x3_t\n\
1600 @{\n\
1601   int8x8_t val[3];\n\
1602 @} int8x8x3_t;\n\
1603 @end smallexample\n\
1604 \n\
1605 If this hook allows @code{val} to have a scalar mode, then\n\
1606 @code{int8x8x3_t} can have the same mode.  GCC can then store\n\
1607 @code{int8x8x3_t}s in registers rather than forcing them onto the stack.",
1608  bool, (enum machine_mode mode, unsigned HOST_WIDE_INT nelems),
1609  hook_bool_mode_uhwi_false)
1610
1611 /* Compute cost of moving data from a register of class FROM to one of
1612    TO, using MODE.  */
1613 DEFHOOK
1614 (register_move_cost,
1615  "",
1616  int, (enum machine_mode mode, reg_class_t from, reg_class_t to),
1617  default_register_move_cost)
1618
1619 /* Compute cost of moving registers to/from memory.  */
1620 /* ??? Documenting the argument types for this hook requires a GFDL
1621    license grant.  Also, the documentation uses a different name for RCLASS.  */
1622 DEFHOOK
1623 (memory_move_cost,
1624  "",
1625  int, (enum machine_mode mode, reg_class_t rclass, bool in),
1626  default_memory_move_cost)
1627
1628 /* True for MODE if the target expects that registers in this mode will
1629    be allocated to registers in a small register class.  The compiler is
1630    allowed to use registers explicitly used in the rtl as spill registers
1631    but it should prevent extending the lifetime of these registers.  */
1632 DEFHOOK
1633 (small_register_classes_for_mode_p,
1634  "",
1635  bool, (enum machine_mode mode),
1636  hook_bool_mode_false)
1637
1638 /* Register number for a flags register.  Only needs to be defined if the
1639    target is constrainted to use post-reload comparison elimination.  */
1640 DEFHOOKPOD
1641 (flags_regnum,
1642  "If the target has a dedicated flags register, and it needs to use the\
1643  post-reload comparison elimination pass, then this value should be set\
1644  appropriately.",
1645  unsigned int, INVALID_REGNUM)
1646
1647 /* Compute a (partial) cost for rtx X.  Return true if the complete
1648    cost has been computed, and false if subexpressions should be
1649    scanned.  In either case, *TOTAL contains the cost result.  */
1650 /* Note that CODE and OUTER_CODE ought to be RTX_CODE, but that's
1651    not necessarily defined at this point.  */
1652 DEFHOOK
1653 (rtx_costs,
1654  "",
1655  bool, (rtx x, int code, int outer_code, int *total, bool speed),
1656  hook_bool_rtx_int_int_intp_bool_false)
1657
1658 /* Compute the cost of X, used as an address.  Never called with
1659    invalid addresses.  */
1660 DEFHOOK
1661 (address_cost,
1662  "",
1663  int, (rtx address, bool speed),
1664  default_address_cost)
1665
1666 /* Return where to allocate pseudo for a given hard register initial value.  */
1667 DEFHOOK
1668 (allocate_initial_value,
1669  "",
1670  rtx, (rtx hard_reg), NULL)
1671
1672 /* Return nonzero if evaluating UNSPEC[_VOLATILE] X might cause a trap.
1673    FLAGS has the same meaning as in rtlanal.c: may_trap_p_1.  */
1674 DEFHOOK
1675 (unspec_may_trap_p,
1676  "",
1677  int, (const_rtx x, unsigned flags),
1678  default_unspec_may_trap_p)
1679
1680 /* Given a register, this hook should return a parallel of registers
1681    to represent where to find the register pieces.  Define this hook
1682    if the register and its mode are represented in Dwarf in
1683    non-contiguous locations, or if the register should be
1684    represented in more than one register in Dwarf.  Otherwise, this
1685    hook should return NULL_RTX.  */
1686 DEFHOOK
1687 (dwarf_register_span,
1688  "",
1689  rtx, (rtx reg),
1690  hook_rtx_rtx_null)
1691
1692 /* If expand_builtin_init_dwarf_reg_sizes needs to fill in table
1693    entries not corresponding directly to registers below
1694    FIRST_PSEUDO_REGISTER, this hook should generate the necessary
1695    code, given the address of the table.  */
1696 DEFHOOK
1697 (init_dwarf_reg_sizes_extra,
1698  "",
1699  void, (tree address),
1700  hook_void_tree)
1701
1702 /* Fetch the fixed register(s) which hold condition codes, for
1703    targets where it makes sense to look for duplicate assignments to
1704    the condition codes.  This should return true if there is such a
1705    register, false otherwise.  The arguments should be set to the
1706    fixed register numbers.  Up to two condition code registers are
1707    supported.  If there is only one for this target, the int pointed
1708    at by the second argument should be set to -1.  */
1709 DEFHOOK
1710 (fixed_condition_code_regs,
1711  "",
1712  bool, (unsigned int *p1, unsigned int *p2),
1713  hook_bool_uintp_uintp_false)
1714
1715 /* If two condition code modes are compatible, return a condition
1716      code mode which is compatible with both, such that a comparison
1717      done in the returned mode will work for both of the original
1718      modes.  If the condition code modes are not compatible, return
1719      VOIDmode.  */
1720 DEFHOOK
1721 (cc_modes_compatible,
1722  "",
1723  enum machine_mode, (enum machine_mode m1, enum machine_mode m2),
1724  default_cc_modes_compatible)
1725
1726 /* Do machine-dependent code transformations.  Called just before
1727      delayed-branch scheduling.  */
1728 DEFHOOK
1729 (machine_dependent_reorg,
1730  "",
1731  void, (void), NULL)
1732
1733 /* Create the __builtin_va_list type.  */
1734 DEFHOOK
1735 (build_builtin_va_list,
1736  "",
1737  tree, (void),
1738  std_build_builtin_va_list)
1739
1740 /* Enumerate the va list variants.  */
1741 DEFHOOK
1742 (enum_va_list_p,
1743  "",
1744  int, (int idx, const char **pname, tree *ptree),
1745  NULL)
1746
1747 /* Get the cfun/fndecl calling abi __builtin_va_list type.  */
1748 DEFHOOK
1749 (fn_abi_va_list,
1750  "",
1751  tree, (tree fndecl),
1752  std_fn_abi_va_list)
1753
1754 /* Get the __builtin_va_list type dependent on input type.  */
1755 DEFHOOK
1756 (canonical_va_list_type,
1757  "",
1758  tree, (tree type),
1759  std_canonical_va_list_type)
1760
1761 /* ??? Documenting this hook requires a GFDL license grant.  */
1762 DEFHOOK_UNDOC
1763 (expand_builtin_va_start,
1764 "Expand the @code{__builtin_va_start} builtin.",
1765  void, (tree valist, rtx nextarg), NULL)
1766
1767 /* Gimplifies a VA_ARG_EXPR.  */
1768 DEFHOOK
1769 (gimplify_va_arg_expr,
1770  "",
1771  tree, (tree valist, tree type, gimple_seq *pre_p, gimple_seq *post_p),
1772  std_gimplify_va_arg_expr)
1773
1774 /* Validity-checking routines for PCH files, target-specific.
1775    get_pch_validity returns a pointer to the data to be stored,
1776    and stores the size in its argument.  pch_valid_p gets the same
1777    information back and returns NULL if the PCH is valid,
1778    or an error message if not.  */
1779 DEFHOOK
1780 (get_pch_validity,
1781  "",
1782  void *, (size_t *sz),
1783  default_get_pch_validity)
1784
1785 DEFHOOK
1786 (pch_valid_p,
1787  "",
1788  const char *, (const void *data, size_t sz),
1789  default_pch_valid_p)
1790
1791 /* If nonnull, this function checks whether a PCH file with the
1792    given set of target flags can be used.  It returns NULL if so,
1793    otherwise it returns an error message.  */
1794 DEFHOOK
1795 (check_pch_target_flags,
1796  "",
1797  const char *, (int pch_flags), NULL)
1798
1799 /* True if the compiler should give an enum type only as many
1800    bytes as it takes to represent the range of possible values of
1801    that type.  */
1802 DEFHOOK
1803 (default_short_enums,
1804  "",
1805  bool, (void),
1806  hook_bool_void_false)
1807
1808 /* This target hook returns an rtx that is used to store the address
1809    of the current frame into the built-in setjmp buffer.  */
1810 DEFHOOK
1811 (builtin_setjmp_frame_value,
1812  "",
1813  rtx, (void),
1814  default_builtin_setjmp_frame_value)
1815
1816 /* This target hook should add STRING_CST trees for any hard regs
1817    the port wishes to automatically clobber for an asm.  */
1818 DEFHOOK
1819 (md_asm_clobbers,
1820  "",
1821  tree, (tree outputs, tree inputs, tree clobbers),
1822  hook_tree_tree_tree_tree_3rd_identity)
1823
1824 /* This target hook allows the backend to specify a calling convention
1825    in the debug information.  This function actually returns an
1826    enum dwarf_calling_convention, but because of forward declarations
1827    and not wanting to include dwarf2.h everywhere target.h is included
1828    the function is being declared as an int.  */
1829 DEFHOOK
1830 (dwarf_calling_convention,
1831  "",
1832  int, (const_tree function),
1833  hook_int_const_tree_0)
1834
1835 /* This target hook allows the backend to emit frame-related insns that
1836    contain UNSPECs or UNSPEC_VOLATILEs.  The call frame debugging info
1837    engine will invoke it on insns of the form
1838      (set (reg) (unspec [...] UNSPEC_INDEX))
1839    and
1840      (set (reg) (unspec_volatile [...] UNSPECV_INDEX))
1841    to let the backend emit the call frame instructions.  */
1842 DEFHOOK
1843 (dwarf_handle_frame_unspec,
1844  "",
1845  void, (const char *label, rtx pattern, int index), NULL)
1846
1847 /* ??? Documenting this hook requires a GFDL license grant.  */
1848 DEFHOOK_UNDOC
1849 (stdarg_optimize_hook,
1850 "Perform architecture specific checking of statements gimplified\
1851  from @code{VA_ARG_EXPR}.  @var{stmt} is the statement.  Returns true if\
1852  the statement doesn't need to be checked for @code{va_list} references.",
1853  bool, (struct stdarg_info *ai, const_gimple stmt), NULL)
1854
1855 /* This target hook allows the operating system to override the DECL
1856    that represents the external variable that contains the stack
1857    protection guard variable.  The type of this DECL is ptr_type_node.  */
1858 DEFHOOK
1859 (stack_protect_guard,
1860  "",
1861  tree, (void),
1862  default_stack_protect_guard)
1863
1864 /* This target hook allows the operating system to override the CALL_EXPR
1865    that is invoked when a check vs the guard variable fails.  */
1866 DEFHOOK
1867 (stack_protect_fail,
1868  "",
1869  tree, (void),
1870  default_external_stack_protect_fail)
1871
1872 DEFHOOK
1873 (supports_split_stack,
1874  "Whether this target supports splitting the stack when the options\
1875  described in @var{opts} have been passed.  This is called\
1876  after options have been parsed, so the target may reject splitting\
1877  the stack in some configurations.  The default version of this hook\
1878  returns false.  If @var{report} is true, this function may issue a warning\
1879  or error; if @var{report} is false, it must simply return a value",
1880  bool, (bool report, struct gcc_options *opts),
1881  hook_bool_bool_gcc_optionsp_false)
1882
1883 /* Returns NULL if target supports the insn within a doloop block,
1884    otherwise it returns an error message.  */
1885 DEFHOOK
1886 (invalid_within_doloop,
1887  "",
1888  const char *, (const_rtx insn),
1889  default_invalid_within_doloop)
1890
1891 DEFHOOK
1892 (valid_dllimport_attribute_p,
1893 "@var{decl} is a variable or function with @code{__attribute__((dllimport))}\
1894  specified.  Use this hook if the target needs to add extra validation\
1895  checks to @code{handle_dll_attribute}.",
1896  bool, (const_tree decl),
1897  hook_bool_const_tree_true)
1898
1899 /* If non-zero, align constant anchors in CSE to a multiple of this
1900    value.  */
1901 DEFHOOKPOD
1902 (const_anchor,
1903  "",
1904  unsigned HOST_WIDE_INT, 0)
1905
1906 /* Functions relating to calls - argument passing, returns, etc.  */
1907 /* Members of struct call have no special macro prefix.  */
1908 HOOK_VECTOR (TARGET_CALLS, calls)
1909
1910 DEFHOOK
1911 (promote_function_mode,
1912  "",
1913  enum machine_mode, (const_tree type, enum machine_mode mode, int *punsignedp,
1914                      const_tree funtype, int for_return),
1915  default_promote_function_mode)
1916
1917 DEFHOOK
1918 (promote_prototypes,
1919  "",
1920  bool, (const_tree fntype),
1921  hook_bool_const_tree_false)
1922
1923 DEFHOOK
1924 (struct_value_rtx,
1925  "",
1926  rtx, (tree fndecl, int incoming),
1927  hook_rtx_tree_int_null)
1928 DEFHOOK
1929 (return_in_memory,
1930  "",
1931  bool, (const_tree type, const_tree fntype),
1932  default_return_in_memory)
1933
1934 DEFHOOK
1935 (return_in_msb,
1936  "",
1937  bool, (const_tree type),
1938  hook_bool_const_tree_false)
1939
1940 /* Return true if a parameter must be passed by reference.  TYPE may
1941    be null if this is a libcall.  CA may be null if this query is
1942    from __builtin_va_arg.  */
1943 DEFHOOK
1944 (pass_by_reference,
1945  "",
1946  bool,
1947  (CUMULATIVE_ARGS *cum, enum machine_mode mode, const_tree type, bool named),
1948  hook_bool_CUMULATIVE_ARGS_mode_tree_bool_false)
1949
1950 DEFHOOK
1951 (expand_builtin_saveregs,
1952  "",
1953  rtx, (void),
1954  default_expand_builtin_saveregs)
1955
1956 /* Returns pretend_argument_size.  */
1957 DEFHOOK
1958 (setup_incoming_varargs,
1959  "",
1960  void, (CUMULATIVE_ARGS *args_so_far, enum machine_mode mode, tree type,
1961         int *pretend_args_size, int second_time),
1962  default_setup_incoming_varargs)
1963
1964 DEFHOOK
1965 (strict_argument_naming,
1966  "",
1967  bool, (CUMULATIVE_ARGS *ca),
1968  hook_bool_CUMULATIVE_ARGS_false)
1969
1970 /* Returns true if we should use
1971    targetm.calls.setup_incoming_varargs() and/or
1972    targetm.calls.strict_argument_naming().  */
1973 DEFHOOK
1974 (pretend_outgoing_varargs_named,
1975  "",
1976  bool, (CUMULATIVE_ARGS *ca),
1977  default_pretend_outgoing_varargs_named)
1978
1979 /* Given a complex type T, return true if a parameter of type T
1980    should be passed as two scalars.  */
1981 DEFHOOK
1982 (split_complex_arg,
1983  "",
1984  bool, (const_tree type), NULL)
1985
1986 /* Return true if type T, mode MODE, may not be passed in registers,
1987    but must be passed on the stack.  */
1988 /* ??? This predicate should be applied strictly after pass-by-reference.
1989    Need audit to verify that this is the case.  */
1990 DEFHOOK
1991 (must_pass_in_stack,
1992  "",
1993  bool, (enum machine_mode mode, const_tree type),
1994  must_pass_in_stack_var_size_or_pad)
1995
1996 /* Return true if type TYPE, mode MODE, which is passed by reference,
1997    should have the object copy generated by the callee rather than
1998    the caller.  It is never called for TYPE requiring constructors.  */
1999 DEFHOOK
2000 (callee_copies,
2001  "",
2002  bool,
2003  (CUMULATIVE_ARGS *cum, enum machine_mode mode, const_tree type, bool named),
2004  hook_bool_CUMULATIVE_ARGS_mode_tree_bool_false)
2005
2006 /* Return zero for arguments passed entirely on the stack or entirely
2007    in registers.  If passed in both, return the number of bytes passed
2008    in registers; the balance is therefore passed on the stack.  */
2009 DEFHOOK
2010 (arg_partial_bytes,
2011  "",
2012  int, (CUMULATIVE_ARGS *cum, enum machine_mode mode, tree type, bool named),
2013  hook_int_CUMULATIVE_ARGS_mode_tree_bool_0)
2014
2015 /* Update the state in CA to advance past an argument in the
2016    argument list.  The values MODE, TYPE, and NAMED describe that
2017    argument.  */
2018 DEFHOOK
2019 (function_arg_advance,
2020  "",
2021  void,
2022  (CUMULATIVE_ARGS *ca, enum machine_mode mode, const_tree type, bool named),
2023  default_function_arg_advance)
2024
2025 /* Return zero if the argument described by the state of CA should
2026    be placed on a stack, or a hard register in which to store the
2027    argument.  The values MODE, TYPE, and NAMED describe that
2028    argument.  */
2029 DEFHOOK
2030 (function_arg,
2031  "",
2032  rtx, (CUMULATIVE_ARGS *ca, enum machine_mode mode, const_tree type,
2033        bool named),
2034  default_function_arg)
2035
2036 /* Likewise, but for machines with register windows.  Return the
2037    location where the argument will appear to the callee.  */
2038 DEFHOOK
2039 (function_incoming_arg,
2040  "",
2041  rtx, (CUMULATIVE_ARGS *ca, enum machine_mode mode, const_tree type,
2042        bool named),
2043  default_function_incoming_arg)
2044
2045 DEFHOOK
2046 (function_arg_boundary,
2047  "",
2048  unsigned int, (enum machine_mode mode, const_tree type),
2049  default_function_arg_boundary)
2050
2051 /* Return the diagnostic message string if function without a prototype
2052    is not allowed for this 'val' argument; NULL otherwise. */
2053 DEFHOOK
2054 (invalid_arg_for_unprototyped_fn,
2055  "",
2056  const char *, (const_tree typelist, const_tree funcdecl, const_tree val),
2057  hook_invalid_arg_for_unprototyped_fn)
2058
2059 /* Return an rtx for the return value location of the function
2060    specified by FN_DECL_OR_TYPE with a return type of RET_TYPE.  */
2061 DEFHOOK
2062 (function_value,
2063  "",
2064  rtx, (const_tree ret_type, const_tree fn_decl_or_type, bool outgoing),
2065  default_function_value)
2066
2067 /* Return the rtx for the result of a libcall of mode MODE,
2068    calling the function FN_NAME.  */
2069 DEFHOOK
2070 (libcall_value,
2071  "",
2072  rtx, (enum machine_mode mode, const_rtx fun),
2073  default_libcall_value)
2074
2075 /* Return true if REGNO is a possible register number for
2076    a function value as seen by the caller.  */
2077 DEFHOOK
2078 (function_value_regno_p,
2079  "",
2080  bool, (const unsigned int regno),
2081  default_function_value_regno_p)
2082
2083 /* ??? Documenting this hook requires a GFDL license grant.  */
2084 DEFHOOK_UNDOC
2085 (internal_arg_pointer,
2086 "Return an rtx for the argument pointer incoming to the\
2087  current function.",
2088  rtx, (void),
2089  default_internal_arg_pointer)
2090
2091 /* Update the current function stack boundary if needed.  */
2092 DEFHOOK
2093 (update_stack_boundary,
2094  "",
2095  void, (void), NULL)
2096
2097 /* Handle stack alignment and return an rtx for Dynamic Realign
2098    Argument Pointer if necessary.  */
2099 DEFHOOK
2100 (get_drap_rtx,
2101  "",
2102  rtx, (void), NULL)
2103
2104 /* Return true if all function parameters should be spilled to the
2105    stack.  */
2106 DEFHOOK
2107 (allocate_stack_slots_for_args,
2108  "",
2109  bool, (void),
2110  hook_bool_void_true)
2111
2112 /* Return an rtx for the static chain for FNDECL.  If INCOMING_P is true,
2113        then it should be for the callee; otherwise for the caller.  */
2114 DEFHOOK
2115 (static_chain,
2116  "",
2117  rtx, (const_tree fndecl, bool incoming_p),
2118  default_static_chain)
2119
2120 /* Fill in the trampoline at MEM with a call to FNDECL and a
2121    static chain value of CHAIN.  */
2122 DEFHOOK
2123 (trampoline_init,
2124  "",
2125  void, (rtx m_tramp, tree fndecl, rtx static_chain),
2126  default_trampoline_init)
2127
2128 /* Adjust the address of the trampoline in a target-specific way.  */
2129 DEFHOOK
2130 (trampoline_adjust_address,
2131  "",
2132  rtx, (rtx addr), NULL)
2133
2134 /* Return the number of bytes of its own arguments that a function
2135    pops on returning, or 0 if the function pops no arguments and the
2136    caller must therefore pop them all after the function returns.  */
2137 /* ??? tm.texi has no types for the parameters.  */
2138 DEFHOOK
2139 (return_pops_args,
2140  "",
2141  int, (tree fundecl, tree funtype, int size),
2142  default_return_pops_args)
2143
2144 /* Return a mode wide enough to copy any function value that might be
2145    returned.  */
2146 DEFHOOK
2147 (get_raw_result_mode,
2148  "This target hook returns the mode to be used when accessing raw return\
2149  registers in @code{__builtin_return}.  Define this macro if the value\
2150  in @var{reg_raw_mode} is not correct.",
2151  enum machine_mode, (int regno),
2152  default_get_reg_raw_mode)
2153
2154 /* Return a mode wide enough to copy any argument value that might be
2155    passed.  */
2156 DEFHOOK
2157 (get_raw_arg_mode,
2158  "This target hook returns the mode to be used when accessing raw argument\
2159  registers in @code{__builtin_apply_args}.  Define this macro if the value\
2160  in @var{reg_raw_mode} is not correct.",
2161  enum machine_mode, (int regno),
2162  default_get_reg_raw_mode)
2163
2164 HOOK_VECTOR_END (calls)
2165
2166 /* Return the diagnostic message string if conversion from FROMTYPE
2167    to TOTYPE is not allowed, NULL otherwise.  */
2168 DEFHOOK
2169 (invalid_conversion,
2170  "",
2171  const char *, (const_tree fromtype, const_tree totype),
2172  hook_constcharptr_const_tree_const_tree_null)
2173
2174 /* Return the diagnostic message string if the unary operation OP is
2175    not permitted on TYPE, NULL otherwise.  */
2176 DEFHOOK
2177 (invalid_unary_op,
2178  "",
2179  const char *, (int op, const_tree type),
2180  hook_constcharptr_int_const_tree_null)
2181
2182 /* Return the diagnostic message string if the binary operation OP
2183    is not permitted on TYPE1 and TYPE2, NULL otherwise.  */
2184 DEFHOOK
2185 (invalid_binary_op,
2186  "",
2187  const char *, (int op, const_tree type1, const_tree type2),
2188  hook_constcharptr_int_const_tree_const_tree_null)
2189
2190 /* Return the diagnostic message string if TYPE is not valid as a
2191    function parameter type, NULL otherwise.  */
2192 DEFHOOK
2193 (invalid_parameter_type,
2194  "",
2195  const char *, (const_tree type),
2196  hook_constcharptr_const_tree_null)
2197
2198 /* Return the diagnostic message string if TYPE is not valid as a
2199    function return type, NULL otherwise.  */
2200 DEFHOOK
2201 (invalid_return_type,
2202  "",
2203  const char *, (const_tree type),
2204  hook_constcharptr_const_tree_null)
2205
2206 /* If values of TYPE are promoted to some other type when used in
2207    expressions (analogous to the integer promotions), return that type,
2208    or NULL_TREE otherwise.  */
2209 DEFHOOK
2210 (promoted_type,
2211  "",
2212  tree, (const_tree type),
2213  hook_tree_const_tree_null)
2214
2215 /* Convert EXPR to TYPE, if target-specific types with special conversion
2216    rules are involved.  Return the converted expression, or NULL to apply
2217    the standard conversion rules.  */
2218 DEFHOOK
2219 (convert_to_type,
2220  "",
2221  tree, (tree type, tree expr),
2222  hook_tree_tree_tree_null)
2223
2224 /* Return the class for a secondary reload, and fill in extra information.  */
2225 DEFHOOK
2226 (secondary_reload,
2227  "",
2228  reg_class_t,
2229  (bool in_p, rtx x, reg_class_t reload_class, enum machine_mode reload_mode,
2230   secondary_reload_info *sri),
2231  default_secondary_reload)
2232
2233 /* Given an rtx X being reloaded into a reg required to be in class CLASS,
2234    return the class of reg to actually use.  */
2235 DEFHOOK
2236 (preferred_reload_class,
2237  "",
2238  reg_class_t,
2239  (rtx x, reg_class_t rclass),
2240  default_preferred_reload_class)
2241
2242 /* Like TARGET_PREFERRED_RELOAD_CLASS, but for output reloads instead of
2243    input reloads.  */
2244 DEFHOOK
2245 (preferred_output_reload_class,
2246  "",
2247  reg_class_t,
2248  (rtx x, reg_class_t rclass),
2249  default_preferred_output_reload_class)
2250
2251 DEFHOOK
2252 (class_likely_spilled_p,
2253  "",
2254  bool, (reg_class_t rclass),
2255  default_class_likely_spilled_p)
2256
2257 DEFHOOK
2258 (preferred_rename_class,
2259  "A target hook that places additional preference on the register\
2260  class to use when it is necessary to rename a register in class\
2261  @var{rclass} to another class, or perhaps @var{NO_REGS}, if no\
2262  preferred register class is found or hook @code{preferred_rename_class}\
2263  is not implemented.\
2264  Sometimes returning a more restrictive class makes better code.  For\
2265  example, on ARM, thumb-2 instructions using @code{LO_REGS} may be\
2266  smaller than instructions using @code{GENERIC_REGS}.  By returning\
2267  @code{LO_REGS} from @code{preferred_rename_class}, code size can\
2268  be reduced.",
2269  reg_class_t, (reg_class_t rclass),
2270  default_preferred_rename_class)
2271
2272 /* This target hook allows the backend to perform additional
2273    processing while initializing for variable expansion.  */
2274 DEFHOOK
2275 (expand_to_rtl_hook,
2276  "",
2277  void, (void),
2278  hook_void_void)
2279
2280 /* This target hook allows the backend to perform additional
2281    instantiations on rtx that are not actually in insns yet,
2282    but will be later.  */
2283 DEFHOOK
2284 (instantiate_decls,
2285  "",
2286  void, (void),
2287  hook_void_void)
2288
2289 /* Return true if is OK to use a hard register REGNO as scratch register
2290    in peephole2.  */
2291 DEFHOOK
2292 (hard_regno_scratch_ok,
2293  "",
2294  bool, (unsigned int regno),
2295  default_hard_regno_scratch_ok)
2296
2297 /* Return the smallest number of different values for which it is best to
2298    use a jump-table instead of a tree of conditional branches.  */
2299 DEFHOOK
2300 (case_values_threshold,
2301  "",
2302  unsigned int, (void),
2303  default_case_values_threshold)
2304
2305 /* Retutn true if a function must have and use a frame pointer.  */
2306 DEFHOOK
2307 (frame_pointer_required,
2308  "",
2309  bool, (void),
2310  hook_bool_void_false)
2311
2312 /* Returns true if the compiler is allowed to try to replace register number
2313    from-reg with register number to-reg.  */
2314 DEFHOOK
2315 (can_eliminate,
2316  "",
2317  bool, (const int from_reg, const int to_reg),
2318  hook_bool_const_int_const_int_true)
2319
2320 /* Modify any or all of fixed_regs, call_used_regs, global_regs,
2321    reg_names, and reg_class_contents to account of the vagaries of the
2322    target.  */
2323 DEFHOOK
2324 (conditional_register_usage,
2325  "",
2326  void, (void),
2327  hook_void_void)
2328
2329 /* Functions specific to the C family of frontends.  */
2330 #undef HOOK_PREFIX
2331 #define HOOK_PREFIX "TARGET_C_"
2332 HOOK_VECTOR (TARGET_C, c)
2333
2334 /* ??? Documenting this hook requires a GFDL license grant.  */
2335 DEFHOOK_UNDOC
2336 (mode_for_suffix,
2337 "Return machine mode for non-standard constant literal suffix @var{c},\
2338  or VOIDmode if non-standard suffixes are unsupported.",
2339  enum machine_mode, (char c),
2340  default_mode_for_suffix)
2341
2342 HOOK_VECTOR_END (c)
2343
2344 /* Functions specific to the C++ frontend.  */
2345 #undef HOOK_PREFIX
2346 #define HOOK_PREFIX "TARGET_CXX_"
2347 HOOK_VECTOR (TARGET_CXX, cxx)
2348
2349 /* Return the integer type used for guard variables.  */
2350 DEFHOOK
2351 (guard_type,
2352  "",
2353  tree, (void),
2354  default_cxx_guard_type)
2355
2356 /* Return true if only the low bit of the guard should be tested.  */
2357 DEFHOOK
2358 (guard_mask_bit,
2359  "",
2360  bool, (void),
2361  hook_bool_void_false)
2362
2363 /* Returns the size of the array cookie for an array of type.  */
2364 DEFHOOK
2365 (get_cookie_size,
2366  "",
2367  tree, (tree type),
2368  default_cxx_get_cookie_size)
2369
2370 /* Returns true if the element size should be stored in the array cookie.  */
2371 DEFHOOK
2372 (cookie_has_size,
2373  "",
2374  bool, (void),
2375  hook_bool_void_false)
2376
2377 /* Allows backends to perform additional processing when
2378    deciding if a class should be exported or imported.  */
2379 DEFHOOK
2380 (import_export_class,
2381  "",
2382  int, (tree type, int import_export), NULL)
2383
2384 /* Returns true if constructors and destructors return "this".  */
2385 DEFHOOK
2386 (cdtor_returns_this,
2387  "",
2388  bool, (void),
2389  hook_bool_void_false)
2390
2391 /* Returns true if the key method for a class can be an inline
2392    function, so long as it is not declared inline in the class
2393    itself.  Returning true is the behavior required by the Itanium C++ ABI.  */
2394 DEFHOOK
2395 (key_method_may_be_inline,
2396  "",
2397  bool, (void),
2398  hook_bool_void_true)
2399
2400 DEFHOOK
2401 (determine_class_data_visibility,
2402 "@var{decl} is a virtual table, virtual table table, typeinfo object,\
2403  or other similar implicit class data object that will be emitted with\
2404  external linkage in this translation unit.  No ELF visibility has been\
2405  explicitly specified.  If the target needs to specify a visibility\
2406  other than that of the containing class, use this hook to set\
2407  @code{DECL_VISIBILITY} and @code{DECL_VISIBILITY_SPECIFIED}.",
2408  void, (tree decl),
2409  hook_void_tree)
2410
2411 /* Returns true (the default) if virtual tables and other
2412    similar implicit class data objects are always COMDAT if they
2413    have external linkage.  If this hook returns false, then
2414    class data for classes whose virtual table will be emitted in
2415    only one translation unit will not be COMDAT.  */
2416 DEFHOOK
2417 (class_data_always_comdat,
2418  "",
2419  bool, (void),
2420  hook_bool_void_true)
2421
2422 /* Returns true (the default) if the RTTI for the basic types,
2423    which is always defined in the C++ runtime, should be COMDAT;
2424    false if it should not be COMDAT.  */
2425 DEFHOOK
2426 (library_rtti_comdat,
2427  "",
2428  bool, (void),
2429  hook_bool_void_true)
2430
2431 /* Returns true if __aeabi_atexit should be used to register static
2432    destructors.  */
2433 DEFHOOK
2434 (use_aeabi_atexit,
2435  "",
2436  bool, (void),
2437  hook_bool_void_false)
2438
2439 /* Returns true if target may use atexit in the same manner as
2440    __cxa_atexit  to register static destructors.  */
2441 DEFHOOK
2442 (use_atexit_for_cxa_atexit,
2443  "",
2444  bool, (void),
2445  hook_bool_void_false)
2446
2447 DEFHOOK
2448 (adjust_class_at_definition,
2449 "@var{type} is a C++ class (i.e., RECORD_TYPE or UNION_TYPE) that has just\
2450  been defined.  Use this hook to make adjustments to the class (eg, tweak\
2451  visibility or perform any other required target modifications).",
2452  void, (tree type),
2453  hook_void_tree)
2454
2455 HOOK_VECTOR_END (cxx)
2456
2457 /* Functions and data for emulated TLS support.  */
2458 #undef HOOK_PREFIX
2459 #define HOOK_PREFIX "TARGET_EMUTLS_"
2460 HOOK_VECTOR (TARGET_EMUTLS, emutls)
2461
2462 /* Name of the address and common functions.  */
2463 DEFHOOKPOD
2464 (get_address,
2465  "",
2466  const char *, "__builtin___emutls_get_address")
2467
2468 DEFHOOKPOD
2469 (register_common,
2470  "",
2471  const char *, "__builtin___emutls_register_common")
2472
2473 /* Prefixes for proxy variable and template.  */
2474 DEFHOOKPOD
2475 (var_section,
2476  "",
2477  const char *, NULL)
2478
2479 DEFHOOKPOD
2480 (tmpl_section,
2481  "",
2482  const char *, NULL)
2483
2484 /* Prefixes for proxy variable and template.  */
2485 DEFHOOKPOD
2486 (var_prefix,
2487  "",
2488  const char *, NULL)
2489
2490 DEFHOOKPOD
2491 (tmpl_prefix,
2492  "",
2493  const char *, NULL)
2494
2495 /* Function to generate field definitions of the proxy variable.  */
2496 DEFHOOK
2497 (var_fields,
2498  "",
2499  tree, (tree type, tree *name),
2500  default_emutls_var_fields)
2501
2502 /* Function to initialize a proxy variable.  */
2503 DEFHOOK
2504 (var_init,
2505  "",
2506  tree, (tree var, tree decl, tree tmpl_addr),
2507  default_emutls_var_init)
2508
2509 /* Whether we are allowed to alter the usual alignment of the
2510    proxy variable.  */
2511 DEFHOOKPOD
2512 (var_align_fixed,
2513  "",
2514  bool, false)
2515
2516 /* Whether we can emit debug information for TLS vars.  */
2517 DEFHOOKPOD
2518 (debug_form_tls_address,
2519  "",
2520  bool, false)
2521
2522 HOOK_VECTOR_END (emutls)
2523
2524 #undef HOOK_PREFIX
2525 #define HOOK_PREFIX "TARGET_OPTION_"
2526 HOOK_VECTOR (TARGET_OPTION_HOOKS, target_option_hooks)
2527
2528 /* Function to validate the attribute((option(...))) strings or NULL.  If
2529    the option is validated, it is assumed that DECL_FUNCTION_SPECIFIC will
2530    be filled in in the function decl node.  */
2531 DEFHOOK
2532 (valid_attribute_p,
2533  "",
2534  bool, (tree fndecl, tree name, tree args, int flags),
2535  default_target_option_valid_attribute_p)
2536
2537 /* Function to save any extra target state in the target options structure.  */
2538 DEFHOOK
2539 (save,
2540  "",
2541  void, (struct cl_target_option *ptr), NULL)
2542
2543 /* Function to restore any extra target state from the target options
2544    structure.  */
2545 DEFHOOK
2546 (restore,
2547  "",
2548  void, (struct cl_target_option *ptr), NULL)
2549
2550 /* Function to print any extra target state from the target options
2551    structure.  */
2552 DEFHOOK
2553 (print,
2554  "",
2555  void, (FILE *file, int indent, struct cl_target_option *ptr), NULL)
2556
2557 /* Function to parse arguments to be validated for #pragma option, and to
2558    change the state if the options are valid.  If the first argument is
2559    NULL, the second argument specifies the default options to use.  Return
2560    true if the options are valid, and set the current state.  */
2561 /* ??? The documentation in tm.texi is incomplete.  */
2562 DEFHOOK
2563 (pragma_parse,
2564  "",
2565  bool, (tree args, tree pop_target),
2566  default_target_option_pragma_parse)
2567
2568 /* Do option overrides for the target.  */
2569 DEFHOOK
2570 (override,
2571  "",
2572  void, (void),
2573  hook_void_void)
2574
2575 /* Set default optimizations for the target.  */
2576 DEFHOOKPOD
2577 (optimization_table,
2578  "",
2579  const struct default_options *, empty_optimization_table)
2580
2581 DEFHOOK
2582 (default_params,
2583 "Set target-dependent default values for @option{--param} settings, using\
2584  calls to @code{set_default_param_value}.",
2585  void, (void),
2586  hook_void_void)
2587
2588 DEFHOOK
2589 (init_struct,
2590 "Set target-dependent initial values of fields in @var{opts}.",
2591  void, (struct gcc_options *opts),
2592  hook_void_gcc_optionsp)
2593
2594 /* Function to determine if one function can inline another function.  */
2595 #undef HOOK_PREFIX
2596 #define HOOK_PREFIX "TARGET_"
2597 DEFHOOK
2598 (can_inline_p,
2599  "",
2600  bool, (tree caller, tree callee),
2601  default_target_can_inline_p)
2602
2603 HOOK_VECTOR_END (target_option)
2604
2605 /* For targets that need to mark extra registers as live on entry to
2606    the function, they should define this target hook and set their
2607    bits in the bitmap passed in. */
2608 DEFHOOK
2609 (extra_live_on_entry,
2610  "",
2611  void, (bitmap regs),
2612  hook_void_bitmap)
2613
2614 /* Determine the type of unwind info to emit for debugging.  */
2615 DEFHOOK
2616 (debug_unwind_info,
2617  "",
2618  enum unwind_info_type, (void),
2619  default_debug_unwind_info)
2620
2621 /* Determine the type of unwind info to emit for exceptions.  */
2622 DEFHOOK
2623 (except_unwind_info,
2624  "",
2625  enum unwind_info_type, (struct gcc_options *opts),
2626  default_except_unwind_info)
2627
2628 /* Leave the boolean fields at the end.  */
2629
2630 /* True if unwinding tables should be generated by default.  */
2631 DEFHOOKPOD
2632 (unwind_tables_default,
2633  "",
2634  bool, false)
2635
2636 /* True if arbitrary sections are supported.  */
2637 DEFHOOKPOD
2638 (have_named_sections,
2639  "",
2640  bool, false)
2641
2642 /* True if we can create zeroed data by switching to a BSS section
2643    and then using ASM_OUTPUT_SKIP to allocate the space.  */
2644 DEFHOOKPOD
2645 (have_switchable_bss_sections,
2646  "",
2647  bool, false)
2648
2649 /* True if "native" constructors and destructors are supported,
2650    false if we're using collect2 for the job.  */
2651 DEFHOOKPOD
2652 (have_ctors_dtors,
2653  "",
2654  bool, false)
2655
2656 /* True if thread-local storage is supported.  */
2657 DEFHOOKPOD
2658 (have_tls,
2659  "",
2660  bool, false)
2661
2662 /* True if a small readonly data section is supported.  */
2663 DEFHOOKPOD
2664 (have_srodata_section,
2665  "",
2666  bool, false)
2667
2668 /* True if EH frame info sections should be zero-terminated.  */
2669 DEFHOOKPOD
2670 (terminate_dw2_eh_frame_info,
2671  "",
2672  bool, true)
2673
2674 /* True if #NO_APP should be emitted at the beginning of assembly output.  */
2675 DEFHOOKPOD
2676 (asm_file_start_app_off,
2677  "",
2678  bool, false)
2679
2680 /* True if output_file_directive should be called for main_input_filename
2681    at the beginning of assembly output.  */
2682 DEFHOOKPOD
2683 (asm_file_start_file_directive,
2684  "",
2685  bool, false)
2686
2687 DEFHOOKPOD
2688 (handle_pragma_extern_prefix,
2689 "True if @code{#pragma extern_prefix} is to be supported.",
2690  bool, 0)
2691
2692 /* True if the target is allowed to reorder memory accesses unless
2693    synchronization is explicitly requested.  */
2694 DEFHOOKPOD
2695 (relaxed_ordering,
2696  "",
2697  bool, false)
2698
2699 /* Returns true if we should generate exception tables for use with the
2700    ARM EABI.  The effects the encoding of function exception specifications.  */
2701 DEFHOOKPOD
2702 (arm_eabi_unwinder,
2703  "",
2704  bool, false)
2705
2706 DEFHOOKPOD
2707 (want_debug_pub_sections,
2708  "True if the @code{.debug_pubtypes} and @code{.debug_pubnames} sections\
2709  should be emitted.  These sections are not used on most platforms, and\
2710  in particular GDB does not use them.",
2711  bool, false)
2712
2713 /* Leave the boolean fields at the end.  */
2714
2715 /* Close the 'struct gcc_target' definition.  */
2716 HOOK_VECTOR_END (C90_EMPTY_HACK)