OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-dev/] [or1k-gcc/] [gcc/] [target.def] - Blame information for rev 711

Go to most recent revision | Details | Compare with Previous | View Log

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

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.