1 /* Structure for saving state for a nested function.
2 Copyright (C) 1989-2015 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 #ifndef GCC_FUNCTION_H
21 #define GCC_FUNCTION_H
24 /* Stack of pending (incomplete) sequences saved by `start_sequence'.
25 Each element describes one pending sequence.
26 The main insn-chain is saved in the last element of the chain,
27 unless the chain is empty. */
29 struct GTY(()) sequence_stack
{
30 /* First and last insns in the chain of the saved sequence. */
33 struct sequence_stack
*next
;
36 struct GTY(()) emit_status
{
37 /* This is reset to LAST_VIRTUAL_REGISTER + 1 at the start of each function.
38 After rtl generation, it is 1 plus the largest register number used. */
41 /* Lowest label number in current function. */
42 int x_first_label_num
;
44 /* seq.first and seq.last are the ends of the doubly-linked chain of
45 rtl for the current function. Both are reset to null at the
46 start of rtl generation for the function.
48 start_sequence saves both of these on seq.next and then starts
49 a new, nested sequence of insns.
51 seq.next is a stack of pending (incomplete) sequences saved by
52 start_sequence. Each element describes one pending sequence.
53 The main insn-chain is the last element of the chain. */
54 struct sequence_stack seq
;
56 /* INSN_UID for next insn emitted.
57 Reset to 1 for each function compiled. */
60 /* INSN_UID for next debug insn emitted. Only used if
61 --param min-nondebug-insn-uid=<value> is given with nonzero value. */
62 int x_cur_debug_insn_uid
;
64 /* The length of the regno_pointer_align, regno_decl, and x_regno_reg_rtx
65 vectors. Since these vectors are needed during the expansion phase when
66 the total number of registers in the function is not yet known, the
67 vectors are copied and made bigger when necessary. */
68 int regno_pointer_align_length
;
70 /* Indexed by pseudo register number, if nonzero gives the known alignment
71 for that pseudo (if REG_POINTER is set in x_regno_reg_rtx).
72 Allocated in parallel with x_regno_reg_rtx. */
73 unsigned char * GTY((skip
)) regno_pointer_align
;
77 /* Indexed by register number, gives an rtx for that register (and only
78 that register). For pseudo registers, it is the unique rtx for
79 that pseudo. For hard registers, it is an rtx of the mode specified
82 FIXME: We could put it into emit_status struct, but gengtype is not
83 able to deal with length attribute nested in top level structures. */
85 extern GTY ((length ("crtl->emit.x_reg_rtx_no"))) rtx
* regno_reg_rtx
;
87 /* For backward compatibility... eventually these should all go away. */
88 #define reg_rtx_no (crtl->emit.x_reg_rtx_no)
90 #define REGNO_POINTER_ALIGN(REGNO) (crtl->emit.regno_pointer_align[REGNO])
92 struct GTY(()) expr_status
{
93 /* Number of units that we should eventually pop off the stack.
94 These are the arguments to function calls that have already returned. */
95 int x_pending_stack_adjust
;
97 /* Under some ABIs, it is the caller's responsibility to pop arguments
98 pushed for function calls. A naive implementation would simply pop
99 the arguments immediately after each call. However, if several
100 function calls are made in a row, it is typically cheaper to pop
101 all the arguments after all of the calls are complete since a
102 single pop instruction can be used. Therefore, GCC attempts to
103 defer popping the arguments until absolutely necessary. (For
104 example, at the end of a conditional, the arguments must be popped,
105 since code outside the conditional won't know whether or not the
106 arguments need to be popped.)
108 When INHIBIT_DEFER_POP is nonzero, however, the compiler does not
109 attempt to defer pops. Instead, the stack is popped immediately
110 after each call. Rather then setting this variable directly, use
111 NO_DEFER_POP and OK_DEFER_POP. */
112 int x_inhibit_defer_pop
;
114 /* If PREFERRED_STACK_BOUNDARY and PUSH_ROUNDING are defined, the stack
115 boundary can be momentarily unaligned while pushing the arguments.
116 Record the delta since last aligned boundary here in order to get
117 stack alignment in the nested function calls working right. */
118 int x_stack_pointer_delta
;
120 /* Nonzero means __builtin_saveregs has already been done in this function.
121 The value is the pseudoreg containing the value __builtin_saveregs
123 rtx x_saveregs_value
;
125 /* Similarly for __builtin_apply_args. */
126 rtx x_apply_args_value
;
128 /* List of labels that must never be deleted. */
129 rtx_insn_list
*x_forced_labels
;
132 typedef struct call_site_record_d
*call_site_record
;
134 /* RTL representation of exception handling. */
135 struct GTY(()) rtl_eh
{
138 rtx_code_label
*ehr_label
;
141 rtx_insn
*sjlj_exit_after
;
143 vec
<uchar
, va_gc
> *action_record_data
;
145 vec
<call_site_record
, va_gc
> *call_site_record_v
[2];
148 #define pending_stack_adjust (crtl->expr.x_pending_stack_adjust)
149 #define inhibit_defer_pop (crtl->expr.x_inhibit_defer_pop)
150 #define saveregs_value (crtl->expr.x_saveregs_value)
151 #define apply_args_value (crtl->expr.x_apply_args_value)
152 #define forced_labels (crtl->expr.x_forced_labels)
153 #define stack_pointer_delta (crtl->expr.x_stack_pointer_delta)
156 struct call_site_record_d
;
159 struct GTY(()) varasm_status
{
160 /* If we're using a per-function constant pool, this is it. */
161 struct rtx_constant_pool
*pool
;
163 /* Number of tree-constants deferred during the expansion of this
165 unsigned int deferred_constants
;
169 /* Data for function partitioning. */
170 struct GTY(()) function_subsections
{
171 /* Assembly labels for the hot and cold text sections, to
172 be used by debugger functions for determining the size of text
175 const char *hot_section_label
;
176 const char *cold_section_label
;
177 const char *hot_section_end_label
;
178 const char *cold_section_end_label
;
181 /* Describe an empty area of space in the stack frame. These can be chained
182 into a list; this is used to keep track of space wasted for alignment
184 struct GTY(()) frame_space
186 struct frame_space
*next
;
189 HOST_WIDE_INT length
;
192 struct GTY(()) stack_usage
194 /* # of bytes of static stack space allocated by the function. */
195 HOST_WIDE_INT static_stack_size
;
197 /* # of bytes of dynamic stack space allocated by the function. This is
198 meaningful only if has_unbounded_dynamic_stack_size is zero. */
199 HOST_WIDE_INT dynamic_stack_size
;
201 /* # of bytes of space pushed onto the stack after the prologue. If
202 !ACCUMULATE_OUTGOING_ARGS, it contains the outgoing arguments. */
203 int pushed_stack_size
;
205 /* Nonzero if the amount of stack space allocated dynamically cannot
206 be bounded at compile-time. */
207 unsigned int has_unbounded_dynamic_stack_size
: 1;
210 #define current_function_static_stack_size (cfun->su->static_stack_size)
211 #define current_function_dynamic_stack_size (cfun->su->dynamic_stack_size)
212 #define current_function_pushed_stack_size (cfun->su->pushed_stack_size)
213 #define current_function_has_unbounded_dynamic_stack_size \
214 (cfun->su->has_unbounded_dynamic_stack_size)
215 #define current_function_allocates_dynamic_stack_space \
216 (current_function_dynamic_stack_size != 0 \
217 || current_function_has_unbounded_dynamic_stack_size)
219 /* This structure can save all the important global and static variables
220 describing the status of the current function. */
222 struct GTY(()) function
{
223 struct eh_status
*eh
;
225 /* The control flow graph for this function. */
226 struct control_flow_graph
*cfg
;
228 /* GIMPLE body for this function. */
229 gimple_seq gimple_body
;
231 /* SSA and dataflow information. */
232 struct gimple_df
*gimple_df
;
234 /* The loops in this function. */
235 struct loops
*x_current_loops
;
237 /* The stack usage of this function. */
238 struct stack_usage
*su
;
240 /* Value histograms attached to particular statements. */
241 htab_t
GTY((skip
)) value_histograms
;
243 /* For function.c. */
245 /* Points to the FUNCTION_DECL of this function. */
248 /* A PARM_DECL that should contain the static chain for this function.
249 It will be initialized at the beginning of the function. */
250 tree static_chain_decl
;
252 /* An expression that contains the non-local goto save area. The first
253 word is the saved frame pointer and the second is the saved stack
255 tree nonlocal_goto_save_area
;
257 /* Vector of function local variables, functions, types and constants. */
258 vec
<tree
, va_gc
> *local_decls
;
260 /* In a Cilk function, the VAR_DECL for the frame descriptor. */
261 tree cilk_frame_decl
;
265 /* tm.h can use this to store whatever it likes. */
266 struct machine_function
* GTY ((maybe_undef
)) machine
;
268 /* Language-specific code can use this to store whatever it likes. */
269 struct language_function
* language
;
271 /* Used types hash table. */
272 hash_set
<tree
> *GTY (()) used_types_hash
;
274 /* Dwarf2 Frame Description Entry, containing the Call Frame Instructions
275 used for unwinding. Only set when either dwarf2 unwinding or dwarf2
276 debugging is enabled. */
277 struct dw_fde_node
*fde
;
279 /* Last statement uid. */
282 /* Function sequence number for profiling, debugging, etc. */
285 /* Line number of the start of the function for debugging purposes. */
286 location_t function_start_locus
;
288 /* Line number of the end of the function. */
289 location_t function_end_locus
;
291 /* Properties used by the pass manager. */
292 unsigned int curr_properties
;
293 unsigned int last_verified
;
295 /* Non-null if the function does something that would prevent it from
296 being copied; this applies to both versioning and inlining. Set to
297 a string describing the reason for failure. */
298 const char * GTY((skip
)) cannot_be_copied_reason
;
300 /* Last assigned dependence info clique. */
301 unsigned short last_clique
;
303 /* Collected bit flags. */
305 /* Number of units of general registers that need saving in stdarg
306 function. What unit is depends on the backend, either it is number
307 of bytes, or it can be number of registers. */
308 unsigned int va_list_gpr_size
: 8;
310 /* Number of units of floating point registers that need saving in stdarg
312 unsigned int va_list_fpr_size
: 8;
314 /* Nonzero if function being compiled can call setjmp. */
315 unsigned int calls_setjmp
: 1;
317 /* Nonzero if function being compiled can call alloca,
318 either as a subroutine or builtin. */
319 unsigned int calls_alloca
: 1;
321 /* This will indicate whether a function is a cilk function */
322 unsigned int is_cilk_function
: 1;
324 /* Nonzero if this is a Cilk function that spawns. */
325 unsigned int calls_cilk_spawn
: 1;
327 /* Nonzero if function being compiled receives nonlocal gotos
328 from nested functions. */
329 unsigned int has_nonlocal_label
: 1;
331 /* Nonzero if we've set cannot_be_copied_reason. I.e. if
332 (cannot_be_copied_set && !cannot_be_copied_reason), the function
333 can in fact be copied. */
334 unsigned int cannot_be_copied_set
: 1;
336 /* Nonzero if current function uses stdarg.h or equivalent. */
337 unsigned int stdarg
: 1;
339 unsigned int after_inlining
: 1;
340 unsigned int always_inline_functions_inlined
: 1;
342 /* Nonzero if function being compiled can throw synchronous non-call
344 unsigned int can_throw_non_call_exceptions
: 1;
346 /* Nonzero if instructions that may throw exceptions but don't otherwise
347 contribute to the execution of the program can be deleted. */
348 unsigned int can_delete_dead_exceptions
: 1;
350 /* Fields below this point are not set for abstract functions; see
351 allocate_struct_function. */
353 /* Nonzero if function being compiled needs to be given an address
354 where the value should be stored. */
355 unsigned int returns_struct
: 1;
357 /* Nonzero if function being compiled needs to
358 return the address of where it has put a structure value. */
359 unsigned int returns_pcc_struct
: 1;
361 /* Nonzero if this function has local DECL_HARD_REGISTER variables.
362 In this case code motion has to be done more carefully. */
363 unsigned int has_local_explicit_reg_vars
: 1;
365 /* Nonzero if the current function is a thunk, i.e., a lightweight
366 function implemented by the output_mi_thunk hook) that just
367 adjusts one of its arguments and forwards to another
369 unsigned int is_thunk
: 1;
371 /* Nonzero if the current function contains any loops with
372 loop->force_vectorize set. */
373 unsigned int has_force_vectorize_loops
: 1;
375 /* Nonzero if the current function contains any loops with
376 nonzero value in loop->simduid. */
377 unsigned int has_simduid_loops
: 1;
379 /* Set when the tail call has been identified. */
380 unsigned int tail_call_marked
: 1;
383 /* Add the decl D to the local_decls list of FUN. */
385 void add_local_decl (struct function
*fun
, tree d
);
387 #define FOR_EACH_LOCAL_DECL(FUN, I, D) \
388 FOR_EACH_VEC_SAFE_ELT_REVERSE ((FUN)->local_decls, I, D)
390 /* If va_list_[gf]pr_size is set to this, it means we don't know how
391 many units need to be saved. */
392 #define VA_LIST_MAX_GPR_SIZE 255
393 #define VA_LIST_MAX_FPR_SIZE 255
395 /* The function currently being compiled. */
396 extern GTY(()) struct function
*cfun
;
398 /* In order to ensure that cfun is not set directly, we redefine it so
399 that it is not an lvalue. Rather than assign to cfun, use
400 push_cfun or set_cfun. */
401 #define cfun (cfun + 0)
403 /* Nonzero if we've already converted virtual regs to hard regs. */
404 extern int virtuals_instantiated
;
406 /* Nonzero if at least one trampoline has been created. */
407 extern int trampolines_created
;
409 struct GTY((for_user
)) types_used_by_vars_entry
{
414 struct used_type_hasher
: ggc_ptr_hash
<types_used_by_vars_entry
>
416 static hashval_t
hash (types_used_by_vars_entry
*);
417 static bool equal (types_used_by_vars_entry
*, types_used_by_vars_entry
*);
420 /* Hash table making the relationship between a global variable
421 and the types it references in its initializer. The key of the
422 entry is a referenced type, and the value is the DECL of the global
423 variable. types_use_by_vars_do_hash and types_used_by_vars_eq below are
424 the hash and equality functions to use for this hash table. */
425 extern GTY(()) hash_table
<used_type_hasher
> *types_used_by_vars_hash
;
427 void types_used_by_var_decl_insert (tree type
, tree var_decl
);
429 /* During parsing of a global variable, this vector contains the types
430 referenced by the global variable. */
431 extern GTY(()) vec
<tree
, va_gc
> *types_used_by_cur_var_decl
;
434 /* Return the loop tree of FN. */
436 inline struct loops
*
437 loops_for_fn (struct function
*fn
)
439 return fn
->x_current_loops
;
442 /* Set the loop tree of FN to LOOPS. */
445 set_loops_for_fn (struct function
*fn
, struct loops
*loops
)
447 gcc_checking_assert (fn
->x_current_loops
== NULL
|| loops
== NULL
);
448 fn
->x_current_loops
= loops
;
451 /* For backward compatibility... eventually these should all go away. */
452 #define current_function_funcdef_no (cfun->funcdef_no)
454 #define current_loops (cfun->x_current_loops)
455 #define dom_computed (cfun->cfg->x_dom_computed)
456 #define n_bbs_in_dom_tree (cfun->cfg->x_n_bbs_in_dom_tree)
457 #define VALUE_HISTOGRAMS(fun) (fun)->value_histograms
459 /* A pointer to a function to create target specific, per-function
461 extern struct machine_function
* (*init_machine_status
) (void);
463 enum direction
{none
, upward
, downward
};
465 /* Structure to record the size of a sequence of arguments
466 as the sum of a tree-expression and a constant. This structure is
467 also used to store offsets from the stack, which might be negative,
468 so the variable part must be ssizetype, not sizetype. */
472 HOST_WIDE_INT constant
;
476 /* Package up various arg related fields of struct args for
477 locate_and_pad_parm. */
478 struct locate_and_pad_arg_data
480 /* Size of this argument on the stack, rounded up for any padding it
481 gets. If REG_PARM_STACK_SPACE is defined, then register parms are
482 counted here, otherwise they aren't. */
483 struct args_size size
;
484 /* Offset of this argument from beginning of stack-args. */
485 struct args_size offset
;
486 /* Offset to the start of the stack slot. Different from OFFSET
487 if this arg pads downward. */
488 struct args_size slot_offset
;
489 /* The amount that the stack pointer needs to be adjusted to
490 force alignment for the next argument. */
491 struct args_size alignment_pad
;
492 /* Which way we should pad this arg. */
493 enum direction where_pad
;
494 /* slot_offset is at least this aligned. */
495 unsigned int boundary
;
498 /* Add the value of the tree INC to the `struct args_size' TO. */
500 #define ADD_PARM_SIZE(TO, INC) \
503 if (tree_fits_shwi_p (inc)) \
504 (TO).constant += tree_to_shwi (inc); \
505 else if ((TO).var == 0) \
506 (TO).var = fold_convert (ssizetype, inc); \
508 (TO).var = size_binop (PLUS_EXPR, (TO).var, \
509 fold_convert (ssizetype, inc)); \
512 #define SUB_PARM_SIZE(TO, DEC) \
515 if (tree_fits_shwi_p (dec)) \
516 (TO).constant -= tree_to_shwi (dec); \
517 else if ((TO).var == 0) \
518 (TO).var = size_binop (MINUS_EXPR, ssize_int (0), \
519 fold_convert (ssizetype, dec)); \
521 (TO).var = size_binop (MINUS_EXPR, (TO).var, \
522 fold_convert (ssizetype, dec)); \
525 /* Convert the implicit sum in a `struct args_size' into a tree
526 of type ssizetype. */
527 #define ARGS_SIZE_TREE(SIZE) \
528 ((SIZE).var == 0 ? ssize_int ((SIZE).constant) \
529 : size_binop (PLUS_EXPR, fold_convert (ssizetype, (SIZE).var), \
530 ssize_int ((SIZE).constant)))
532 /* Convert the implicit sum in a `struct args_size' into an rtx. */
533 #define ARGS_SIZE_RTX(SIZE) \
534 ((SIZE).var == 0 ? GEN_INT ((SIZE).constant) \
535 : expand_normal (ARGS_SIZE_TREE (SIZE)))
537 #define ASLK_REDUCE_ALIGN 1
538 #define ASLK_RECORD_PAD 2
542 extern void push_function_context (void);
543 extern void pop_function_context (void);
545 /* Save and restore status information for a nested function. */
546 extern void free_after_parsing (struct function
*);
547 extern void free_after_compilation (struct function
*);
549 /* Return size needed for stack frame based on slots so far allocated.
550 This size counts from zero. It is not rounded to STACK_BOUNDARY;
551 the caller may have to do that. */
552 extern HOST_WIDE_INT
get_frame_size (void);
554 /* Issue an error message and return TRUE if frame OFFSET overflows in
555 the signed target pointer arithmetics for function FUNC. Otherwise
557 extern bool frame_offset_overflow (HOST_WIDE_INT
, tree
);
559 extern rtx
assign_stack_local_1 (machine_mode
, HOST_WIDE_INT
, int, int);
560 extern rtx
assign_stack_local (machine_mode
, HOST_WIDE_INT
, int);
561 extern rtx
assign_stack_temp_for_type (machine_mode
, HOST_WIDE_INT
, tree
);
562 extern rtx
assign_stack_temp (machine_mode
, HOST_WIDE_INT
);
563 extern rtx
assign_temp (tree
, int, int);
564 extern void update_temp_slot_address (rtx
, rtx
);
565 extern void preserve_temp_slots (rtx
);
566 extern void free_temp_slots (void);
567 extern void push_temp_slots (void);
568 extern void pop_temp_slots (void);
569 extern void init_temp_slots (void);
570 extern rtx
get_hard_reg_initial_reg (rtx
);
571 extern rtx
get_hard_reg_initial_val (machine_mode
, unsigned int);
572 extern rtx
has_hard_reg_initial_val (machine_mode
, unsigned int);
574 /* Called from gimple_expand_cfg. */
575 extern unsigned int emit_initial_value_sets (void);
577 extern bool initial_value_entry (int i
, rtx
*, rtx
*);
578 extern void instantiate_decl_rtl (rtx x
);
579 extern int aggregate_value_p (const_tree
, const_tree
);
580 extern bool use_register_for_decl (const_tree
);
581 extern gimple_seq
gimplify_parameters (void);
582 extern void locate_and_pad_parm (machine_mode
, tree
, int, int, int,
583 tree
, struct args_size
*,
584 struct locate_and_pad_arg_data
*);
585 extern void generate_setjmp_warnings (void);
587 /* Identify BLOCKs referenced by more than one NOTE_INSN_BLOCK_{BEG,END},
588 and create duplicate blocks. */
589 extern void reorder_blocks (void);
590 extern void clear_block_marks (tree
);
591 extern tree
blocks_nreverse (tree
);
592 extern tree
block_chainon (tree
, tree
);
594 /* Set BLOCK_NUMBER for all the blocks in FN. */
595 extern void number_blocks (tree
);
597 /* cfun shouldn't be set directly; use one of these functions instead. */
598 extern void set_cfun (struct function
*new_cfun
);
599 extern void push_cfun (struct function
*new_cfun
);
600 extern void pop_cfun (void);
602 extern int get_next_funcdef_no (void);
603 extern int get_last_funcdef_no (void);
604 extern void allocate_struct_function (tree
, bool);
605 extern void push_struct_function (tree fndecl
);
606 extern void push_dummy_function (bool);
607 extern void pop_dummy_function (void);
608 extern void init_dummy_function_start (void);
609 extern void init_function_start (tree
);
610 extern void stack_protect_epilogue (void);
611 extern void expand_function_start (tree
);
612 extern void expand_dummy_function_end (void);
614 extern void thread_prologue_and_epilogue_insns (void);
615 extern void diddle_return_value (void (*)(rtx
, void*), void*);
616 extern void clobber_return_register (void);
617 extern void do_warn_unused_parameter (tree
);
618 extern void expand_function_end (void);
619 extern rtx
get_arg_pointer_save_area (void);
620 extern void maybe_copy_prologue_epilogue_insn (rtx
, rtx
);
621 extern int prologue_epilogue_contains (const_rtx
);
622 extern void emit_return_into_block (bool simple_p
, basic_block bb
);
623 extern void set_return_jump_label (rtx_insn
*);
624 extern bool active_insn_between (rtx_insn
*head
, rtx_insn
*tail
);
625 extern vec
<edge
> convert_jumps_to_returns (basic_block last_bb
, bool simple_p
,
626 vec
<edge
> unconverted
);
627 extern basic_block
emit_return_for_exit (edge exit_fallthru_edge
,
629 extern void reposition_prologue_and_epilogue_notes (void);
631 /* Returns the name of the current function. */
632 extern const char *fndecl_name (tree
);
633 extern const char *function_name (struct function
*);
634 extern const char *current_function_name (void);
636 extern void used_types_insert (tree
);
638 #endif /* GCC_FUNCTION_H */