Branch data Line data Source code
1 : : /* Copyright (C) 2001-2025 Free Software Foundation, Inc.
2 : : Contributed by Joseph Myers <jsm28@cam.ac.uk>.
3 : :
4 : : This file is part of GCC.
5 : :
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
9 : : version.
10 : :
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
14 : : for more details.
15 : :
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/>. */
19 : :
20 : : /* This header provides a declarative way of describing the attributes
21 : : that are applied to some built-in functions by default. Attributes
22 : : that are meant to be used by user-defined functions but aren't used
23 : : by any built-ins, or attributes that apply to types or variables
24 : : but not to functions need not and should not be defined here.
25 : :
26 : : Before including this header, you must define the following macros.
27 : : In each case where there is an ENUM, it is an identifier used to
28 : : reference the tree in subsequent definitions.
29 : :
30 : : DEF_ATTR_NULL_TREE (ENUM)
31 : :
32 : : Constructs a NULL_TREE.
33 : :
34 : : DEF_ATTR_INT (ENUM, VALUE)
35 : :
36 : : Constructs an INTEGER_CST with value VALUE (an integer representable
37 : : in HOST_WIDE_INT).
38 : :
39 : : DEF_ATTR_IDENT (ENUM, STRING)
40 : :
41 : : Constructs an IDENTIFIER_NODE for STRING.
42 : :
43 : : DEF_ATTR_TREE_LIST (ENUM, PURPOSE, VALUE, CHAIN)
44 : :
45 : : Constructs a TREE_LIST with given PURPOSE, VALUE and CHAIN (given
46 : : as previous ENUM names). */
47 : :
48 : 228619 : DEF_ATTR_NULL_TREE (ATTR_NULL)
49 : :
50 : : /* Construct a tree for a given integer and a list containing it. */
51 : : #define DEF_ATTR_FOR_INT(VALUE) \
52 : : DEF_ATTR_INT (ATTR_##VALUE, VALUE) \
53 : : DEF_ATTR_TREE_LIST (ATTR_LIST_##VALUE, ATTR_NULL, \
54 : : ATTR_##VALUE, ATTR_NULL)
55 : 228619 : DEF_ATTR_FOR_INT (0)
56 : 228644 : DEF_ATTR_FOR_INT (1)
57 : 228644 : DEF_ATTR_FOR_INT (2)
58 : 228669 : DEF_ATTR_FOR_INT (3)
59 : 228619 : DEF_ATTR_FOR_INT (4)
60 : 228619 : DEF_ATTR_FOR_INT (5)
61 : 228619 : DEF_ATTR_FOR_INT (6)
62 : : #undef DEF_ATTR_FOR_INT
63 : :
64 : : /* Construct a tree for a given string and a list containing it. */
65 : : #define DEF_ATTR_FOR_STRING(ENUM, VALUE) \
66 : : DEF_ATTR_STRING (ATTR_##ENUM, VALUE) \
67 : : DEF_ATTR_TREE_LIST (ATTR_LIST_##ENUM, ATTR_NULL, \
68 : : ATTR_##ENUM, ATTR_NULL)
69 : 228619 : DEF_ATTR_FOR_STRING (STR1, "1 ")
70 : 228619 : DEF_ATTR_FOR_STRING (STRERRNOC, ".C")
71 : 228619 : DEF_ATTR_FOR_STRING (STRERRNOP, ".P")
72 : : #undef DEF_ATTR_FOR_STRING
73 : :
74 : : /* Construct a tree for a list of two integers. */
75 : : #define DEF_LIST_INT_INT(VALUE1, VALUE2) \
76 : : DEF_ATTR_TREE_LIST (ATTR_LIST_##VALUE1##_##VALUE2, ATTR_NULL, \
77 : : ATTR_##VALUE1, ATTR_LIST_##VALUE2)
78 : 228619 : DEF_LIST_INT_INT (1,0)
79 : 228619 : DEF_LIST_INT_INT (1,2)
80 : 228644 : DEF_LIST_INT_INT (1,3)
81 : 228619 : DEF_LIST_INT_INT (1,4)
82 : 228619 : DEF_LIST_INT_INT (1,5)
83 : 228619 : DEF_LIST_INT_INT (2,0)
84 : 228644 : DEF_LIST_INT_INT (2,3)
85 : 228619 : DEF_LIST_INT_INT (3,0)
86 : 228619 : DEF_LIST_INT_INT (3,4)
87 : 228619 : DEF_LIST_INT_INT (4,0)
88 : 228619 : DEF_LIST_INT_INT (4,5)
89 : 228619 : DEF_LIST_INT_INT (5,0)
90 : 228619 : DEF_LIST_INT_INT (5,6)
91 : : #undef DEF_LIST_INT_INT
92 : :
93 : : /* Construct a tree for a list of three integers. */
94 : : #define DEF_LIST_INT_INT_INT(VALUE1, VALUE2, VALUE3) \
95 : : DEF_ATTR_TREE_LIST (ATTR_LIST_##VALUE1##_##VALUE2##_##VALUE3, \
96 : : ATTR_NULL, ATTR_##VALUE1, \
97 : : ATTR_LIST_##VALUE2##_##VALUE3)
98 : 228619 : DEF_LIST_INT_INT_INT (1,2,3)
99 : : #undef DEF_LIST_INT_INT_INT
100 : :
101 : : /* Construct trees for identifiers used in built-in function attributes.
102 : : The construction contributes to startup costs so only attributes that
103 : : are used to define built-ins should be defined here. */
104 : 228619 : DEF_ATTR_IDENT (ATTR_ALLOC_SIZE, "alloc_size")
105 : 229843 : DEF_ATTR_IDENT (ATTR_COLD, "cold")
106 : 229843 : DEF_ATTR_IDENT (ATTR_CONST, "const")
107 : 228619 : DEF_ATTR_IDENT (ATTR_FORMAT, "format")
108 : 228619 : DEF_ATTR_IDENT (ATTR_FORMAT_ARG, "format_arg")
109 : 228619 : DEF_ATTR_IDENT (ATTR_MALLOC, "malloc")
110 : 228654 : DEF_ATTR_IDENT (ATTR_NONNULL, "nonnull")
111 : 228644 : DEF_ATTR_IDENT (ATTR_NONNULL_IF_NONZERO, "nonnull_if_nonzero")
112 : 229843 : DEF_ATTR_IDENT (ATTR_NORETURN, "noreturn")
113 : 229843 : DEF_ATTR_IDENT (ATTR_NOTHROW, "nothrow")
114 : 229843 : DEF_ATTR_IDENT (ATTR_LEAF, "leaf")
115 : 228619 : DEF_ATTR_IDENT (ATTR_FNSPEC, "fn spec")
116 : 228619 : DEF_ATTR_IDENT (ATTR_PRINTF, "printf")
117 : 228619 : DEF_ATTR_IDENT (ATTR_ASM_FPRINTF, "asm_fprintf")
118 : 228619 : DEF_ATTR_IDENT (ATTR_GCC_DIAG, "gcc_diag")
119 : 228619 : DEF_ATTR_IDENT (ATTR_GCC_CDIAG, "gcc_cdiag")
120 : 228619 : DEF_ATTR_IDENT (ATTR_GCC_CXXDIAG, "gcc_cxxdiag")
121 : 228634 : DEF_ATTR_IDENT (ATTR_PURE, "pure")
122 : 228619 : DEF_ATTR_IDENT (ATTR_NOVOPS, "no vops")
123 : 228619 : DEF_ATTR_IDENT (ATTR_SCANF, "scanf")
124 : 228619 : DEF_ATTR_IDENT (ATTR_SENTINEL, "sentinel")
125 : 228619 : DEF_ATTR_IDENT (ATTR_STRFMON, "strfmon")
126 : 228619 : DEF_ATTR_IDENT (ATTR_STRFTIME, "strftime")
127 : 228634 : DEF_ATTR_IDENT (ATTR_TYPEGENERIC, "type generic")
128 : 228619 : DEF_ATTR_IDENT (ATTR_TM_REGPARM, "*tm regparm")
129 : 228619 : DEF_ATTR_IDENT (ATTR_TM_TMPURE, "transaction_pure")
130 : 228619 : DEF_ATTR_IDENT (ATTR_RETURNS_TWICE, "returns_twice")
131 : 228619 : DEF_ATTR_IDENT (ATTR_RETURNS_NONNULL, "returns_nonnull")
132 : 228619 : DEF_ATTR_IDENT (ATTR_WARN_UNUSED_RESULT, "warn_unused_result")
133 : :
134 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOVOPS_LIST, ATTR_NOVOPS, ATTR_NULL, ATTR_NULL)
135 : :
136 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOVOPS_LEAF_LIST, ATTR_LEAF, ATTR_NULL, ATTR_NOVOPS_LIST)
137 : :
138 : 228619 : DEF_ATTR_TREE_LIST (ATTR_LEAF_LIST, ATTR_LEAF, ATTR_NULL, ATTR_NULL)
139 : :
140 : 229843 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_LIST, ATTR_NOTHROW, ATTR_NULL, ATTR_NULL)
141 : :
142 : 229843 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_LEAF_LIST, ATTR_LEAF, ATTR_NULL, ATTR_NOTHROW_LIST)
143 : :
144 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOVOPS_NOTHROW_LEAF_LIST, ATTR_NOVOPS, \
145 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
146 : 228619 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_LIST, ATTR_CONST, \
147 : : ATTR_NULL, ATTR_NOTHROW_LIST)
148 : 229843 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_LEAF_LIST, ATTR_CONST, \
149 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
150 : 228619 : DEF_ATTR_TREE_LIST (ATTR_ERRNOCONST_NOTHROW_LEAF_LIST, ATTR_FNSPEC,\
151 : : ATTR_LIST_STRERRNOC, ATTR_NOTHROW_LEAF_LIST)
152 : 228619 : DEF_ATTR_TREE_LIST (ATTR_ERRNOPURE_NOTHROW_LEAF_LIST, ATTR_FNSPEC,\
153 : : ATTR_LIST_STRERRNOP, ATTR_NOTHROW_LEAF_LIST)
154 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_LIST, ATTR_PURE, \
155 : : ATTR_NULL, ATTR_NOTHROW_LIST)
156 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_LEAF_LIST, ATTR_PURE, \
157 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
158 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NORETURN_NOTHROW_LIST, ATTR_NORETURN, \
159 : : ATTR_NULL, ATTR_NOTHROW_LIST)
160 : 229843 : DEF_ATTR_TREE_LIST (ATTR_NORETURN_NOTHROW_LEAF_LIST, ATTR_NORETURN,\
161 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
162 : 229843 : DEF_ATTR_TREE_LIST (ATTR_NORETURN_NOTHROW_LEAF_COLD_LIST, ATTR_COLD,\
163 : : ATTR_NULL, ATTR_NORETURN_NOTHROW_LEAF_LIST)
164 : 228619 : DEF_ATTR_TREE_LIST (ATTR_RT_NOTHROW_LEAF_LIST, ATTR_RETURNS_TWICE,\
165 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
166 : 228619 : DEF_ATTR_TREE_LIST (ATTR_COLD_NOTHROW_LEAF_LIST, ATTR_COLD,\
167 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
168 : 228619 : DEF_ATTR_TREE_LIST (ATTR_COLD_NORETURN_NOTHROW_LEAF_LIST, ATTR_COLD,\
169 : : ATTR_NULL, ATTR_NORETURN_NOTHROW_LEAF_LIST)
170 : 228624 : DEF_ATTR_TREE_LIST (ATTR_CONST_NORETURN_NOTHROW_LEAF_LIST, ATTR_CONST,\
171 : : ATTR_NULL, ATTR_NORETURN_NOTHROW_LEAF_LIST)
172 : 228624 : DEF_ATTR_TREE_LIST (ATTR_CONST_NORETURN_NOTHROW_LEAF_COLD_LIST, ATTR_COLD,\
173 : : ATTR_NULL, ATTR_CONST_NORETURN_NOTHROW_LEAF_LIST)
174 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_NOTHROW_LIST, ATTR_MALLOC, \
175 : : ATTR_NULL, ATTR_NOTHROW_LIST)
176 : 228619 : DEF_ATTR_TREE_LIST (ATTR_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST, ATTR_WARN_UNUSED_RESULT, \
177 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
178 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST, ATTR_MALLOC, \
179 : : ATTR_NULL, ATTR_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST)
180 : 228619 : DEF_ATTR_TREE_LIST (ATTR_SENTINEL_NOTHROW_LIST, ATTR_SENTINEL, \
181 : : ATTR_NULL, ATTR_NOTHROW_LIST)
182 : 228619 : DEF_ATTR_TREE_LIST (ATTR_SENTINEL_NOTHROW_LEAF_LIST, ATTR_SENTINEL, \
183 : : ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
184 : 228619 : DEF_ATTR_TREE_LIST (ATTR_COLD_CONST_NORETURN_NOTHROW_LEAF_LIST, ATTR_CONST,\
185 : : ATTR_NULL, ATTR_COLD_NORETURN_NOTHROW_LEAF_LIST)
186 : :
187 : : /* Allocation functions like malloc and realloc whose first argument
188 : : with _SIZE_1, or second argument with _SIZE_2, specifies the size
189 : : of the allocated object. */
190 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_SIZE_1_NOTHROW_LIST, ATTR_ALLOC_SIZE, \
191 : : ATTR_LIST_1, ATTR_MALLOC_NOTHROW_LIST)
192 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_LIST, ATTR_WARN_UNUSED_RESULT, \
193 : : ATTR_NULL, ATTR_MALLOC_NOTHROW_LIST)
194 : 228619 : DEF_ATTR_TREE_LIST (ATTR_ALLOC_WARN_UNUSED_RESULT_SIZE_2_NOTHROW_LIST, ATTR_ALLOC_SIZE, \
195 : : ATTR_LIST_2, ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_LIST)
196 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_SIZE_1_NOTHROW_LEAF_LIST, ATTR_ALLOC_SIZE, \
197 : : ATTR_LIST_1, ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST)
198 : : /* Alloca is just like malloc except that it never returns null. */
199 : 228619 : DEF_ATTR_TREE_LIST (ATTR_ALLOCA_WARN_UNUSED_RESULT_SIZE_1_NOTHROW_LEAF_LIST, ATTR_RETURNS_NONNULL,
200 : : ATTR_NULL, ATTR_MALLOC_WARN_UNUSED_RESULT_SIZE_1_NOTHROW_LEAF_LIST)
201 : :
202 : : /* Allocation functions like calloc the product of whose first two arguments
203 : : specifies the size of the allocated object. */
204 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_SIZE_1_2_NOTHROW_LEAF_LIST, ATTR_ALLOC_SIZE, \
205 : : ATTR_LIST_1_2, ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST)
206 : :
207 : : /* Allocation functions like realloc whose second argument specifies
208 : : the size of the allocated object. */
209 : 228619 : DEF_ATTR_TREE_LIST (ATTR_ALLOC_WARN_UNUSED_RESULT_SIZE_2_NOTHROW_LEAF_LIST, ATTR_ALLOC_SIZE, \
210 : : ATTR_LIST_2, ATTR_WARN_UNUSED_RESULT_NOTHROW_LEAF_LIST)
211 : :
212 : : /* Functions whose pointer parameter(s) are all nonnull. */
213 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_LIST, ATTR_NONNULL, ATTR_NULL, ATTR_NULL)
214 : : /* Functions whose first parameter is a nonnull pointer. */
215 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1, ATTR_NONNULL, ATTR_LIST_1, ATTR_NULL)
216 : : /* Functions whose second parameter is a nonnull pointer. */
217 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_2, ATTR_NONNULL, ATTR_LIST_2, ATTR_NULL)
218 : : /* Functions whose third parameter is a nonnull pointer. */
219 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_3, ATTR_NONNULL, ATTR_LIST_3, ATTR_NULL)
220 : : /* Functions whose selected pointer parameter(s) are conditionally
221 : : nonnull. */
222 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_IF123_LIST, ATTR_NONNULL_IF_NONZERO, \
223 : : ATTR_LIST_1_2_3, ATTR_NULL)
224 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_4_IF123_LIST, ATTR_NONNULL, \
225 : : ATTR_LIST_4, ATTR_NONNULL_IF123_LIST)
226 : : /* Nothrow functions with the sentinel(1) attribute. */
227 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_SENTINEL_1, ATTR_SENTINEL, ATTR_LIST_1, \
228 : : ATTR_NOTHROW_LIST)
229 : : /* Nothrow functions whose pointer parameter(s) are all nonnull. */
230 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL, ATTR_NONNULL, ATTR_NULL, \
231 : : ATTR_NOTHROW_LIST)
232 : : /* Nothrow leaf functions whose pointer parameter(s) are all nonnull. */
233 : 228654 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_LEAF, ATTR_NONNULL, ATTR_NULL, \
234 : : ATTR_NOTHROW_LEAF_LIST)
235 : 228634 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_LEAF_LIST, ATTR_LEAF, ATTR_NULL, ATTR_NOTHROW_NONNULL_LEAF)
236 : : /* Nothrow functions whose first parameter is a nonnull pointer. */
237 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1, ATTR_NONNULL, ATTR_LIST_1, \
238 : : ATTR_NOTHROW_LIST)
239 : : /* Nothrow functions whose second parameter is a nonnull pointer. */
240 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_2, ATTR_NONNULL, ATTR_LIST_2, \
241 : : ATTR_NOTHROW_LIST)
242 : : /* Nothrow functions whose third parameter is a nonnull pointer. */
243 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_3, ATTR_NONNULL, ATTR_LIST_3, \
244 : : ATTR_NOTHROW_LIST)
245 : : /* Nothrow functions whose fourth parameter is a nonnull pointer. */
246 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_4, ATTR_NONNULL, ATTR_LIST_4, \
247 : : ATTR_NOTHROW_LIST)
248 : : /* Nothrow functions whose fifth parameter is a nonnull pointer. */
249 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_5, ATTR_NONNULL, ATTR_LIST_5, \
250 : : ATTR_NOTHROW_LIST)
251 : : /* Nothrow leaf functions whose selected pointer parameter(s) are conditionally
252 : : nonnull. */
253 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_IF12_LEAF, ATTR_NONNULL_IF_NONZERO, \
254 : : ATTR_LIST_1_2, ATTR_NOTHROW_LEAF_LIST)
255 : 228644 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_IF13_LEAF, ATTR_NONNULL_IF_NONZERO, \
256 : : ATTR_LIST_1_3, ATTR_NOTHROW_LEAF_LIST)
257 : 228644 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_IF123_LEAF, ATTR_NONNULL_IF_NONZERO, \
258 : : ATTR_LIST_2_3, ATTR_NOTHROW_NONNULL_IF13_LEAF)
259 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_IF23_LEAF, ATTR_NONNULL_IF_NONZERO, \
260 : : ATTR_LIST_2_3, ATTR_NOTHROW_LEAF_LIST)
261 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_IF23_LEAF, ATTR_NONNULL, \
262 : : ATTR_LIST_1, ATTR_NOTHROW_NONNULL_IF23_LEAF)
263 : :
264 : : /* Same as ATTR_NONNULL_1. */
265 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_1, ATTR_NONNULL, ATTR_LIST_1, ATTR_NULL)
266 : : /* Functions like {v,}fprintf whose first and second parameters are
267 : : nonnull pointers. As cancellation points the functions are not
268 : : nothrow. */
269 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_2, ATTR_NONNULL, ATTR_LIST_1_2, ATTR_NULL)
270 : : /* The following don't have {v,}fprintf forms. They exist only to
271 : : make it possible to declare {v,}{f,s}printf attributes using
272 : : the same macro. */
273 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_3, ATTR_NONNULL, ATTR_LIST_1_3, ATTR_NULL)
274 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_4, ATTR_NONNULL, ATTR_LIST_1_4, ATTR_NULL)
275 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_5, ATTR_NONNULL, ATTR_LIST_1_5, ATTR_NULL)
276 : :
277 : : /* Same as ATTR_NOTHROW_NONNULL_1. */
278 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_1, ATTR_NONNULL, ATTR_LIST_1,
279 : : ATTR_NOTHROW_LIST)
280 : : /* Nothrow functions like {v,}sprintf whose first and second parameters
281 : : are nonnull pointers. */
282 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_2, ATTR_NONNULL, ATTR_LIST_1_2, \
283 : : ATTR_NOTHROW_LIST)
284 : : /* Nothrow functions like {v,}snprintf whose first and third parameters
285 : : are nonnull pointers. */
286 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_3, ATTR_NONNULL, ATTR_LIST_1_3, \
287 : : ATTR_NOTHROW_LIST)
288 : : /* Nothrow functions like {v,}sprintf_chk whose first and fourth parameters
289 : : are nonnull pointers. */
290 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_4, ATTR_NONNULL, ATTR_LIST_1_4, \
291 : : ATTR_NOTHROW_LIST)
292 : : /* Nothrow functions like {v,}snprintf_chk whose first and fifth parameters
293 : : are nonnull pointers. */
294 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_5, ATTR_NONNULL, ATTR_LIST_1_5, \
295 : : ATTR_NOTHROW_LIST)
296 : :
297 : : /* Nothrow leaf functions which are type-generic. */
298 : 228619 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_TYPEGENERIC_LEAF, ATTR_TYPEGENERIC, ATTR_NULL, \
299 : : ATTR_NOTHROW_LEAF_LIST)
300 : : /* Nothrow nonnull leaf functions that are type-generic. */
301 : 228634 : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_TYPEGENERIC_LEAF,
302 : : ATTR_TYPEGENERIC, ATTR_NULL,
303 : : ATTR_NOTHROW_NONNULL_LEAF)
304 : : /* Nothrow const functions whose pointer parameter(s) are all nonnull. */
305 : 228619 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_NONNULL, ATTR_CONST, ATTR_NULL, \
306 : : ATTR_NOTHROW_NONNULL)
307 : : /* Nothrow leaf functions whose pointer parameter(s) are all nonnull,
308 : : and which return their first argument. */
309 : 228619 : DEF_ATTR_TREE_LIST (ATTR_RET1_NOTHROW_NONNULL_LEAF, ATTR_FNSPEC, ATTR_LIST_STR1, \
310 : : ATTR_NOTHROW_NONNULL_LEAF)
311 : : /* Nothrow leaf functions whose pointer parameter(s) are all nonnull,
312 : : and return value is also nonnull. */
313 : 228619 : DEF_ATTR_TREE_LIST (ATTR_RETNONNULL_NOTHROW_LEAF, ATTR_RETURNS_NONNULL, ATTR_NULL, \
314 : : ATTR_NOTHROW_NONNULL_LEAF)
315 : : /* Nothrow const leaf functions whose pointer parameter(s) are all nonnull. */
316 : 228619 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_NONNULL_LEAF, ATTR_CONST, ATTR_NULL, \
317 : : ATTR_NOTHROW_NONNULL_LEAF)
318 : : /* Nothrow const functions which are type-generic. */
319 : 228619 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_TYPEGENERIC, ATTR_TYPEGENERIC, ATTR_NULL, \
320 : : ATTR_CONST_NOTHROW_LIST)
321 : : /* Nothrow const leaf functions which are type-generic. */
322 : 228619 : DEF_ATTR_TREE_LIST (ATTR_CONST_NOTHROW_TYPEGENERIC_LEAF, ATTR_TYPEGENERIC, ATTR_NULL, \
323 : : ATTR_CONST_NOTHROW_LEAF_LIST)
324 : : /* Nothrow pure functions whose pointer parameter(s) are all nonnull. */
325 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_NONNULL, ATTR_PURE, ATTR_NULL, \
326 : : ATTR_NOTHROW_NONNULL)
327 : : /* Nothrow pure leaf functions whose pointer parameter(s) are all nonnull. */
328 : 228634 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_NONNULL_LEAF, ATTR_PURE, ATTR_NULL, \
329 : : ATTR_NOTHROW_NONNULL_LEAF)
330 : : /* Nothrow pure leaf functions whose selected pointer parameter(s) are
331 : : conditionally nonnull. */
332 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_NONNULL_IF12_LEAF, ATTR_PURE, ATTR_NULL, \
333 : : ATTR_NOTHROW_NONNULL_IF12_LEAF)
334 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_NONNULL_IF13_LEAF, ATTR_PURE, ATTR_NULL, \
335 : : ATTR_NOTHROW_NONNULL_IF13_LEAF)
336 : 228619 : DEF_ATTR_TREE_LIST (ATTR_PURE_NOTHROW_NONNULL_IF123_LEAF, ATTR_PURE, ATTR_NULL, \
337 : : ATTR_NOTHROW_NONNULL_IF123_LEAF)
338 : : /* Nothrow malloc functions whose pointer parameter(s) are all nonnull. */
339 : 228619 : DEF_ATTR_TREE_LIST (ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL, ATTR_WARN_UNUSED_RESULT, ATTR_NULL, \
340 : : ATTR_NOTHROW_NONNULL)
341 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_NONNULL, ATTR_MALLOC, ATTR_NULL, \
342 : : ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL)
343 : : /* Nothrow malloc leaf functions whose pointer parameter(s) are all nonnull. */
344 : 228619 : DEF_ATTR_TREE_LIST (ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL_LEAF, ATTR_WARN_UNUSED_RESULT, ATTR_NULL, \
345 : : ATTR_NOTHROW_NONNULL_LEAF)
346 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_NONNULL_LEAF, ATTR_MALLOC, ATTR_NULL, \
347 : : ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL_LEAF)
348 : : /* Nothrow malloc leaf functions whose selected pointer parameter(s) are
349 : : conditionally nonnull. */
350 : 228619 : DEF_ATTR_TREE_LIST (ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL_IF12_LEAF, \
351 : : ATTR_WARN_UNUSED_RESULT, ATTR_NULL, \
352 : : ATTR_NOTHROW_NONNULL_IF12_LEAF)
353 : 228619 : DEF_ATTR_TREE_LIST (ATTR_MALLOC_WARN_UNUSED_RESULT_NOTHROW_NONNULL_IF12_LEAF, \
354 : : ATTR_MALLOC, ATTR_NULL, \
355 : : ATTR_WARN_UNUSED_RESULT_NOTHROW_NONNULL_IF12_LEAF)
356 : :
357 : : /* Construct a tree for the format attribute (and implicitly nonnull). */
358 : : #define DEF_FORMAT_ATTRIBUTE(TYPE, FA, VALUES) \
359 : : DEF_ATTR_TREE_LIST (ATTR_##TYPE##_##VALUES, ATTR_NULL, \
360 : : ATTR_##TYPE, ATTR_LIST_##VALUES) \
361 : : DEF_ATTR_TREE_LIST (ATTR_FORMAT_##TYPE##_##VALUES, ATTR_FORMAT, \
362 : : ATTR_##TYPE##_##VALUES, ATTR_NONNULL_##FA)
363 : :
364 : : /* Construct a tree for the format and nothrow attributes (format
365 : : implies nonnull). */
366 : : #define DEF_FORMAT_ATTRIBUTE_NOTHROW(TYPE, FA, VALUES) \
367 : : DEF_ATTR_TREE_LIST (ATTR_##TYPE##_##VALUES, ATTR_NULL, \
368 : : ATTR_##TYPE, ATTR_LIST_##VALUES) \
369 : : DEF_ATTR_TREE_LIST (ATTR_FORMAT_##TYPE##_NOTHROW_##VALUES, ATTR_FORMAT,\
370 : : ATTR_##TYPE##_##VALUES, ATTR_NOTHROW_NONNULL_##FA)
371 : :
372 : : /* Construct one tree for the format attribute and another for the format
373 : : and nothrow attributes (in both cases format implies nonnull). */
374 : : #define DEF_FORMAT_ATTRIBUTE_BOTH(TYPE, FA, VALUES) \
375 : : DEF_ATTR_TREE_LIST (ATTR_##TYPE##_##VALUES, ATTR_NULL, \
376 : : ATTR_##TYPE, ATTR_LIST_##VALUES) \
377 : : DEF_ATTR_TREE_LIST (ATTR_FORMAT_##TYPE##_##VALUES, ATTR_FORMAT, \
378 : : ATTR_##TYPE##_##VALUES, ATTR_NONNULL_##FA) \
379 : : DEF_ATTR_TREE_LIST (ATTR_FORMAT_##TYPE##_NOTHROW_##VALUES, ATTR_FORMAT,\
380 : : ATTR_##TYPE##_##VALUES, ATTR_NOTHROW_NONNULL_##FA)
381 : :
382 : : /* Construct a pair of trees for the nonnull attribute for the first
383 : : argument, plus format printf attribute (format implies nonnull):
384 : : the first ordinary and the second nothrow. */
385 : : #define DEF_FORMAT_ATTRIBUTE_NONNULL(TYPE, FA, VALUES) \
386 : : DEF_ATTR_TREE_LIST (ATTR_NONNULL_1_FORMAT_##TYPE##_##VALUES, \
387 : : ATTR_FORMAT, ATTR_##TYPE##_##VALUES, \
388 : : ATTR_NONNULL_1_##FA) \
389 : : DEF_ATTR_TREE_LIST (ATTR_NOTHROW_NONNULL_1_FORMAT_##TYPE##_##VALUES, \
390 : : ATTR_FORMAT, ATTR_##TYPE##_##VALUES, \
391 : : ATTR_NOTHROW_NONNULL_1_##FA)
392 : :
393 : 228619 : DEF_FORMAT_ATTRIBUTE(PRINTF,1,1_0)
394 : 228619 : DEF_FORMAT_ATTRIBUTE(PRINTF,1,1_2)
395 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(PRINTF,2,2_0)
396 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(PRINTF,2,2_3)
397 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(PRINTF,3,3_0)
398 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(PRINTF,3,3_4)
399 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(PRINTF,4,4_0)
400 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(PRINTF,4,4_5)
401 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(PRINTF,5,5_0)
402 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(PRINTF,5,5_6)
403 : :
404 : : /* Attributes for fprintf(f, f, va). */
405 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,1,1_2)
406 : : /* Attributes for v{f,s}printf(d, f, va). vsprintf is nothrow, vfprintf
407 : : is not. */
408 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,2,2_0)
409 : : /* Attributes for {f,s}printf(d, f, ...). sprintf is nothrow, fprintf
410 : : is not. */
411 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,2,2_3)
412 : : /* Attributes for vprintf_chk. */
413 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,3,3_0)
414 : : /* Attributes for printf_chk. */
415 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,3,3_4)
416 : : /* Attributes for v{f,s}printf_chk(d, t, bos, f, va). vsprintf_chk is
417 : : nothrow, vfprintf_chk is not. */
418 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,4,4_0)
419 : : /* Attributes for {f,s}printf_chk(d, t, bos, f, ...). sprintf_chk is
420 : : nothrow, fprintf_chk is not. */
421 : 228619 : DEF_FORMAT_ATTRIBUTE_NONNULL(PRINTF,4,4_5)
422 : :
423 : 228619 : DEF_FORMAT_ATTRIBUTE(SCANF,1,1_0)
424 : 228619 : DEF_FORMAT_ATTRIBUTE(SCANF,1,1_2)
425 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(SCANF,2,2_0)
426 : 228619 : DEF_FORMAT_ATTRIBUTE_BOTH(SCANF,2,2_3)
427 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(STRFTIME,3,3_0)
428 : 228619 : DEF_FORMAT_ATTRIBUTE_NOTHROW(STRFMON,3,3_4)
429 : : #undef DEF_FORMAT_ATTRIBUTE
430 : : #undef DEF_FORMAT_ATTRIBUTE_NOTHROW
431 : : #undef DEF_FORMAT_ATTRIBUTE_BOTH
432 : :
433 : : /* Transactional memory variants of the above. */
434 : :
435 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_NOTHROW_LIST,
436 : : ATTR_TM_REGPARM, ATTR_NULL, ATTR_NOTHROW_LIST)
437 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_TMPURE_NOTHROW_LIST,
438 : : ATTR_TM_TMPURE, ATTR_NULL, ATTR_TM_NOTHROW_LIST)
439 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_PURE_TMPURE_NOTHROW_LIST,
440 : : ATTR_PURE, ATTR_NULL, ATTR_TM_TMPURE_NOTHROW_LIST)
441 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_NORETURN_NOTHROW_LIST,
442 : : ATTR_TM_REGPARM, ATTR_NULL, ATTR_NORETURN_NOTHROW_LIST)
443 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_CONST_NOTHROW_LIST,
444 : : ATTR_TM_REGPARM, ATTR_NULL, ATTR_CONST_NOTHROW_LIST)
445 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TM_NOTHROW_RT_LIST,
446 : : ATTR_RETURNS_TWICE, ATTR_NULL, ATTR_TM_NOTHROW_LIST)
447 : :
448 : : /* Same attributes used for BUILT_IN_MALLOC except with TM_PURE thrown in. */
449 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TMPURE_MALLOC_NOTHROW_LIST,
450 : : ATTR_TM_TMPURE, ATTR_NULL, ATTR_MALLOC_NOTHROW_LIST)
451 : : /* Same attributes used for BUILT_IN_FREE except with TM_PURE thrown in. */
452 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TMPURE_NOTHROW_LIST,
453 : : ATTR_TM_TMPURE, ATTR_NULL, ATTR_NOTHROW_LIST)
454 : :
455 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TMPURE_NOTHROW_LEAF_LIST,
456 : : ATTR_TM_TMPURE, ATTR_NULL, ATTR_NOTHROW_LEAF_LIST)
457 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TMPURE_NORETURN_NOTHROW_LEAF_LIST,
458 : : ATTR_TM_TMPURE, ATTR_NULL, ATTR_NORETURN_NOTHROW_LEAF_LIST)
459 : 228619 : DEF_ATTR_TREE_LIST (ATTR_TMPURE_NORETURN_NOTHROW_LEAF_COLD_LIST,
460 : : ATTR_COLD, ATTR_NULL,
461 : : ATTR_TMPURE_NORETURN_NOTHROW_LEAF_LIST)
462 : :
463 : : /* Construct a tree for a format_arg attribute. */
464 : : #define DEF_FORMAT_ARG_ATTRIBUTE(FA) \
465 : : DEF_ATTR_TREE_LIST (ATTR_FORMAT_ARG_##FA, ATTR_FORMAT_ARG, \
466 : : ATTR_LIST_##FA, ATTR_NOTHROW_NONNULL_##FA)
467 : 228619 : DEF_FORMAT_ARG_ATTRIBUTE(1)
468 : 228619 : DEF_FORMAT_ARG_ATTRIBUTE(2)
469 : : #undef DEF_FORMAT_ARG_ATTRIBUTE
470 : :
|