xref: /freebsd/tools/build/cross-build/include/common/sys/cdefs.h (revision dd41de95a84d979615a2ef11df6850622bf6184e)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright 2018-2020 Alex Richardson <arichardson@FreeBSD.org>
5  *
6  * This software was developed by SRI International and the University of
7  * Cambridge Computer Laboratory (Department of Computer Science and
8  * Technology) under DARPA contract HR0011-18-C-0016 ("ECATS"), as part of the
9  * DARPA SSITH research programme.
10  *
11  * This software was developed by SRI International and the University of
12  * Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237)
13  * ("CTSRD"), as part of the DARPA CRASH research programme.
14  *
15  * Redistribution and use in source and binary forms, with or without
16  * modification, are permitted provided that the following conditions
17  * are met:
18  * 1. Redistributions of source code must retain the above copyright
19  *    notice, this list of conditions and the following disclaimer.
20  * 2. Redistributions in binary form must reproduce the above copyright
21  *    notice, this list of conditions and the following disclaimer in the
22  *    documentation and/or other materials provided with the distribution.
23  *
24  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34  * SUCH DAMAGE.
35  *
36  * $FreeBSD$
37  */
38 #pragma once
39 /* musl libc does not provide a sys/cdefs.h header */
40 #if __has_include_next(<sys/cdefs.h>)
41 #include_next <sys/cdefs.h>
42 #else
43 /* No sys/cdefs.h header exists so we have to provide some basic macros */
44 #ifdef __cplusplus
45 #define __BEGIN_DECLS extern "C" {
46 #define __END_DECLS }
47 #else
48 #define __BEGIN_DECLS
49 #define __END_DECLS
50 #endif
51 
52 #endif
53 
54 #ifndef __FBSDID
55 #define __FBSDID(id)
56 #endif
57 
58 #ifndef __IDSTRING
59 #define __IDSTRING(name, string)
60 #endif
61 
62 #ifndef __pure
63 #define __pure __attribute__((__pure__))
64 #endif
65 #ifndef __packed
66 #define __packed __attribute__((__packed__))
67 #endif
68 #ifndef __dead2
69 #define __dead2 __attribute__((__noreturn__))
70 #endif
71 #ifndef __pure2
72 #define __pure2 __attribute__((__const__))
73 #endif
74 #ifndef __used
75 #define __used __attribute__((__used__))
76 #endif
77 #ifndef __aligned
78 #define __aligned(x) __attribute__((__aligned__(x)))
79 #endif
80 #ifndef __section
81 #define __section(x) __attribute__((__section__(x)))
82 #endif
83 
84 #ifndef __alloc_size
85 #define __alloc_size(...) __attribute__((__alloc_size__(__VA_ARGS__)))
86 #endif
87 #ifndef __alloc_size2
88 #define __alloc_size2(n, x) __attribute__((__alloc_size__(n, x)))
89 #endif
90 #ifndef __alloc_align
91 #define __alloc_align(x) __attribute__((__alloc_align__(x)))
92 #endif
93 #ifndef __result_use_check
94 #define __result_use_check __attribute__((__warn_unused_result__))
95 #endif
96 #ifndef __printflike
97 #define __printflike(fmtarg, firstvararg) \
98 	__attribute__((__format__(__printf__, fmtarg, firstvararg)))
99 #endif
100 #ifndef __printf0like
101 #define __printf0like(fmtarg, firstvararg) \
102 	__attribute__((__format__(__printf0__, fmtarg, firstvararg)))
103 #endif
104 
105 #ifndef __predict_true
106 #define __predict_true(exp) __builtin_expect((exp), 1)
107 #endif
108 #ifndef __predict_false
109 #define __predict_false(exp) __builtin_expect((exp), 0)
110 #endif
111 
112 #ifndef __weak_reference
113 #ifdef __ELF__
114 #define __weak_reference(sym, alias) \
115 	__asm__(".weak " #alias);    \
116 	__asm__(".equ " #alias ", " #sym)
117 #else
118 #define __weak_reference(sym, alias) \
119 	static int alias() __attribute__((weakref(#sym)));
120 #endif
121 #endif
122 
123 /* Some files built as part of the bootstrap libegacy use these macros, but
124  * since we aren't actually building libc.so, we can defined them to be empty */
125 #ifndef __sym_compat
126 #define __sym_compat(sym, impl, verid) /* not needed for bootstrapping */
127 #endif
128 #ifndef __sym_default
129 #define __sym_default(sym, impl, verid) /* not needed for bootstrapping */
130 #endif
131 #ifndef __sym_default
132 #define __warn_references(sym, msg) /* not needed for bootstrapping */
133 #endif
134 
135 #ifndef __malloc_like
136 #define __malloc_like __attribute__((__malloc__))
137 #endif
138 
139 #ifndef __min_size
140 #if !defined(__cplusplus)
141 #define __min_size(x) static(x)
142 #else
143 #define __min_size(x) (x)
144 #endif
145 #endif
146 
147 #ifndef __unused
148 #define __unused __attribute__((unused))
149 #endif
150 #define __format_arg(fmtarg) __attribute__((__format_arg__(fmtarg)))
151 
152 #ifndef __exported
153 #define __exported __attribute__((__visibility__("default")))
154 #endif
155 #ifndef __hidden
156 #define __hidden __attribute__((__visibility__("hidden")))
157 #endif
158 
159 #ifndef __unreachable
160 #define __unreachable() __builtin_unreachable()
161 #endif
162 
163 #ifndef __clang__
164 /* GCC doesn't like the printf0 format specifier. Clang treats it the same as
165  * printf so add the compatibility macro here. */
166 #define __printf0__ __printf__
167 #endif
168 
169 /* On MacOS __CONCAT is defined as x ## y, which won't expand macros */
170 #undef __CONCAT
171 #define __CONCAT1(x, y) x##y
172 #define __CONCAT(x, y) __CONCAT1(x, y)
173 
174 #ifndef __STRING
175 #define __STRING(x) #x /* stringify without expanding x */
176 #endif
177 #ifndef __XSTRING
178 #define __XSTRING(x) __STRING(x) /* expand x, then stringify */
179 #endif
180 
181 #ifndef __has_feature
182 #define __has_feature(...) 0
183 #endif
184 
185 #ifndef __has_builtin
186 #define __has_builtin(...) 0
187 #endif
188 
189 /*
190  * Nullability qualifiers: currently only supported by Clang.
191  */
192 #if !(defined(__clang__) && __has_feature(nullability))
193 #define _Nonnull
194 #define _Nullable
195 #define _Null_unspecified
196 #define __NULLABILITY_PRAGMA_PUSH
197 #define __NULLABILITY_PRAGMA_POP
198 #else
199 #define __NULLABILITY_PRAGMA_PUSH        \
200 	_Pragma("clang diagnostic push") \
201 	    _Pragma("clang diagnostic ignored \"-Wnullability-completeness\"")
202 #define __NULLABILITY_PRAGMA_POP _Pragma("clang diagnostic pop")
203 #endif
204 
205 #ifndef __offsetof
206 #define __offsetof(type, field) __builtin_offsetof(type, field)
207 #endif
208 
209 #define __rangeof(type, start, end) \
210 	(__offsetof(type, end) - __offsetof(type, start))
211 
212 #ifndef __containerof
213 #define __containerof(x, s, m)                                           \
214 	({                                                               \
215 		const volatile __typeof(((s *)0)->m) *__x = (x);         \
216 		__DEQUALIFY(                                             \
217 		    s *, (const volatile char *)__x - __offsetof(s, m)); \
218 	})
219 #endif
220 
221 #ifndef __RCSID
222 #define __RCSID(x)
223 #endif
224 #ifndef __FBSDID
225 #define __FBSDID(x)
226 #endif
227 #ifndef __RCSID
228 #define __RCSID(x)
229 #endif
230 #ifndef __RCSID_SOURCE
231 #define __RCSID_SOURCE(x)
232 #endif
233 #ifndef __SCCSID
234 #define __SCCSID(x)
235 #endif
236 #ifndef __COPYRIGHT
237 #define __COPYRIGHT(x)
238 #endif
239 #ifndef __DECONST
240 #define __DECONST(type, var) ((type)(__uintptr_t)(const void *)(var))
241 #endif
242 
243 #ifndef __DEVOLATILE
244 #define __DEVOLATILE(type, var) ((type)(__uintptr_t)(volatile void *)(var))
245 #endif
246 
247 #ifndef __DEQUALIFY
248 #define __DEQUALIFY(type, var) ((type)(__uintptr_t)(const volatile void *)(var))
249 #endif
250 
251 
252 /* Expose all declarations when using FreeBSD headers */
253 #define	__POSIX_VISIBLE		200809
254 #define	__XSI_VISIBLE		700
255 #define	__BSD_VISIBLE		1
256 #define	__ISO_C_VISIBLE		2011
257 #define	__EXT1_VISIBLE		1
258