annotate gcc/calls.h @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 /* Declarations and data types for RTL call insn generation.
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
2 Copyright (C) 2013-2020 Free Software Foundation, Inc.
111
kono
parents:
diff changeset
3
kono
parents:
diff changeset
4 This file is part of GCC.
kono
parents:
diff changeset
5
kono
parents:
diff changeset
6 GCC is free software; you can redistribute it and/or modify it under
kono
parents:
diff changeset
7 the terms of the GNU General Public License as published by the Free
kono
parents:
diff changeset
8 Software Foundation; either version 3, or (at your option) any later
kono
parents:
diff changeset
9 version.
kono
parents:
diff changeset
10
kono
parents:
diff changeset
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
kono
parents:
diff changeset
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
kono
parents:
diff changeset
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
kono
parents:
diff changeset
14 for more details.
kono
parents:
diff changeset
15
kono
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
kono
parents:
diff changeset
17 along with GCC; see the file COPYING3. If not see
kono
parents:
diff changeset
18 <http://www.gnu.org/licenses/>. */
kono
parents:
diff changeset
19
kono
parents:
diff changeset
20 #ifndef GCC_CALLS_H
kono
parents:
diff changeset
21 #define GCC_CALLS_H
kono
parents:
diff changeset
22
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
23 /* Describes a function argument.
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
24
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
25 Each argument conceptually has a gimple-level type. Usually this type
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
26 is available directly as a tree via the TYPE field, but when calling
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
27 libgcc support functions it might instead be inferred from a mode,
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
28 in which case the type isn't available directly.
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
29
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
30 This gimple-level type might go through promotion before being passed to
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
31 the target function. Depending on the context, the MODE field is either
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
32 the mode of the gimple-level type (whether explicitly given or not)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
33 or the mode after promotion has been performed. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
34 class function_arg_info
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
35 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
36 public:
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
37 function_arg_info ()
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
38 : type (NULL_TREE), mode (VOIDmode), named (false),
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
39 pass_by_reference (false)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
40 {}
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
41
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
42 /* Initialize an argument of mode MODE, either before or after promotion. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
43 function_arg_info (machine_mode mode, bool named)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
44 : type (NULL_TREE), mode (mode), named (named), pass_by_reference (false)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
45 {}
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
46
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
47 /* Initialize an unpromoted argument of type TYPE. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
48 function_arg_info (tree type, bool named)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
49 : type (type), mode (TYPE_MODE (type)), named (named),
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
50 pass_by_reference (false)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
51 {}
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
52
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
53 /* Initialize an argument with explicit properties. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
54 function_arg_info (tree type, machine_mode mode, bool named)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
55 : type (type), mode (mode), named (named), pass_by_reference (false)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
56 {}
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
57
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
58 /* Return true if the gimple-level type is an aggregate. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
59 bool aggregate_type_p () const { return type && AGGREGATE_TYPE_P (type); }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
60
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
61 /* Return the size of the gimple-level type, or -1 if the size is
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
62 variable or otherwise not representable as a poly_int64.
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
63
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
64 Use this function when MODE is the mode of the type before promotion,
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
65 or in any context if the target never promotes function arguments. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
66 poly_int64 type_size_in_bytes () const
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
67 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
68 if (type)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
69 return int_size_in_bytes (type);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
70 return GET_MODE_SIZE (mode);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
71 }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
72
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
73 /* Return the size of the argument after promotion, or -1 if the size
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
74 is variable or otherwise not representable as a poly_int64.
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
75
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
76 Use this function when MODE is the mode of the type after promotion. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
77 poly_int64 promoted_size_in_bytes () const
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
78 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
79 if (mode == BLKmode)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
80 return int_size_in_bytes (type);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
81 return GET_MODE_SIZE (mode);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
82 }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
83
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
84 /* True if the argument represents the end of the argument list,
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
85 as returned by end_marker (). */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
86 bool end_marker_p () const { return mode == VOIDmode; }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
87
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
88 /* Return a function_arg_info that represents the end of the
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
89 argument list. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
90 static function_arg_info end_marker ()
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
91 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
92 return function_arg_info (void_type_node, /*named=*/true);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
93 }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
94
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
95 /* The type of the argument, or null if not known (which is true for
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
96 libgcc support functions). */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
97 tree type;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
98
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
99 /* The mode of the argument. Depending on context, this might be
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
100 the mode of the argument type or the mode after promotion. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
101 machine_mode mode;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
102
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
103 /* True if the argument is treated as a named argument, false if it is
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
104 treated as an unnamed variadic argument (i.e. one passed through
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
105 "..."). See also TARGET_STRICT_ARGUMENT_NAMING. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
106 unsigned int named : 1;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
107
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
108 /* True if we have decided to pass the argument by reference, in which case
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
109 the function_arg_info describes a pointer to the original argument. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
110 unsigned int pass_by_reference : 1;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
111 };
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
112
111
kono
parents:
diff changeset
113 extern int flags_from_decl_or_type (const_tree);
kono
parents:
diff changeset
114 extern int call_expr_flags (const_tree);
kono
parents:
diff changeset
115 extern int setjmp_call_p (const_tree);
kono
parents:
diff changeset
116 extern bool gimple_maybe_alloca_call_p (const gimple *);
kono
parents:
diff changeset
117 extern bool gimple_alloca_call_p (const gimple *);
kono
parents:
diff changeset
118 extern bool alloca_call_p (const_tree);
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
119 extern bool must_pass_in_stack_var_size (const function_arg_info &);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
120 extern bool must_pass_in_stack_var_size_or_pad (const function_arg_info &);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
121 extern bool must_pass_va_arg_in_stack (tree);
111
kono
parents:
diff changeset
122 extern rtx prepare_call_address (tree, rtx, rtx, rtx *, int, int);
kono
parents:
diff changeset
123 extern bool shift_return_value (machine_mode, bool, rtx);
kono
parents:
diff changeset
124 extern rtx expand_call (tree, rtx, int);
kono
parents:
diff changeset
125 extern void fixup_tail_calls (void);
kono
parents:
diff changeset
126
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
127 extern bool pass_by_reference (CUMULATIVE_ARGS *, function_arg_info);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
128 extern bool pass_va_arg_by_reference (tree);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
129 extern bool apply_pass_by_reference_rules (CUMULATIVE_ARGS *,
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
130 function_arg_info &);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
131 extern bool reference_callee_copied (CUMULATIVE_ARGS *,
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
132 const function_arg_info &);
111
kono
parents:
diff changeset
133 extern void maybe_warn_alloc_args_overflow (tree, tree, tree[2], int[2]);
131
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
134 extern tree get_attr_nonstring_decl (tree, tree * = NULL);
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
135 extern void maybe_warn_nonstring_arg (tree, tree);
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
136 extern bool get_size_range (tree, tree[2], bool = false);
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
137 extern rtx rtx_for_static_chain (const_tree, bool);
111
kono
parents:
diff changeset
138
kono
parents:
diff changeset
139 #endif // GCC_CALLS_H