Zephyr API Documentation 4.2.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
llvm.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2021 Intel Corporation.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7#ifndef ZEPHYR_INCLUDE_TOOLCHAIN_LLVM_H_
8#define ZEPHYR_INCLUDE_TOOLCHAIN_LLVM_H_
9
10#ifndef ZEPHYR_INCLUDE_TOOLCHAIN_H_
11#error Please do not include toolchain-specific headers directly, use <zephyr/toolchain.h> instead
12#endif
13
14#define __no_optimization __attribute__((optnone))
15
16#ifndef __fallthrough
17#if __clang_major__ >= 10
18#define __fallthrough __attribute__((fallthrough))
19#endif
20#endif
21
22#define TOOLCHAIN_CLANG_VERSION \
23 ((__clang_major__ * 10000) + (__clang_minor__ * 100) + \
24 __clang_patchlevel__)
25
26#define TOOLCHAIN_HAS_PRAGMA_DIAG 1
27
28#if TOOLCHAIN_CLANG_VERSION >= 30800
29#define TOOLCHAIN_HAS_C_GENERIC 1
30#define TOOLCHAIN_HAS_C_AUTO_TYPE 1
31#endif
32
34
35/* clear out common version. The build assert assert from gcc.h is defined to be empty */
36#undef BUILD_ASSERT
37
38#if defined(__cplusplus) && (__cplusplus >= 201103L)
39
40/* C++11 has static_assert built in */
41#define BUILD_ASSERT(EXPR, MSG...) static_assert(EXPR, "" MSG)
42
43#elif !defined(__cplusplus) && ((__STDC_VERSION__) >= 201100)
44
45/* C11 has static_assert built in */
46#define BUILD_ASSERT(EXPR, MSG...) _Static_assert((EXPR), "" MSG)
47
48#else
49
50/* Rely on that the C-library provides a static assertion function */
51#define BUILD_ASSERT(EXPR, MSG...) _Static_assert((EXPR), "" MSG)
52
53#endif
54
55#define TOOLCHAIN_WARNING_SIZEOF_ARRAY_DECAY "-Wsizeof-array-decay"
56#define TOOLCHAIN_WARNING_UNNEEDED_INTERNAL_DECLARATION "-Wunneeded-internal-declaration"
57#define TOOLCHAIN_WARNING_USED_BUT_MARKED_UNUSED "-Wused-but-marked-unused"
58
59#define TOOLCHAIN_DISABLE_CLANG_WARNING(warning) _TOOLCHAIN_DISABLE_WARNING(clang, warning)
60#define TOOLCHAIN_ENABLE_CLANG_WARNING(warning) _TOOLCHAIN_ENABLE_WARNING(clang, warning)
61
62/*
63 * Provide these definitions only when minimal libc is used.
64 * Avoid collision with defines from include/zephyr/toolchain/zephyr_stdint.h
65 */
66#ifdef CONFIG_MINIMAL_LIBC
67
68/*
69 * Predefined __INTN_C/__UINTN_C macros are provided by clang starting in version 20.1.
70 * Avoid redefining these macros if a sufficiently modern clang is being used.
71 */
72#if TOOLCHAIN_CLANG_VERSION < 200100
73
74#define __int_c(v, suffix) v ## suffix
75#define int_c(v, suffix) __int_c(v, suffix)
76#define uint_c(v, suffix) __int_c(v ## U, suffix)
77
78#ifndef CONFIG_ENFORCE_ZEPHYR_STDINT
79
80#ifdef __INT64_TYPE__
81#undef __int_least64_c_suffix__
82#undef __int_least32_c_suffix__
83#undef __int_least16_c_suffix__
84#undef __int_least8_c_suffix__
85#ifdef __INT64_C_SUFFIX__
86#define __int_least64_c_suffix__ __INT64_C_SUFFIX__
87#define __int_least32_c_suffix__ __INT64_C_SUFFIX__
88#define __int_least16_c_suffix__ __INT64_C_SUFFIX__
89#define __int_least8_c_suffix__ __INT64_C_SUFFIX__
90#endif /* __INT64_C_SUFFIX__ */
91#endif /* __INT64_TYPE__ */
92
93#ifdef __INT_LEAST64_TYPE__
94#ifdef __int_least64_c_suffix__
95#define __INT64_C(x) int_c(x, __int_least64_c_suffix__)
96#define __UINT64_C(x) uint_c(x, __int_least64_c_suffix__)
97#else
98#define __INT64_C(x) x
99#define __UINT64_C(x) x ## U
100#endif /* __int_least64_c_suffix__ */
101#endif /* __INT_LEAST64_TYPE__ */
102
103#ifdef __INT32_TYPE__
104#undef __int_least32_c_suffix__
105#undef __int_least16_c_suffix__
106#undef __int_least8_c_suffix__
107#ifdef __INT32_C_SUFFIX__
108#define __int_least32_c_suffix__ __INT32_C_SUFFIX__
109#define __int_least16_c_suffix__ __INT32_C_SUFFIX__
110#define __int_least8_c_suffix__ __INT32_C_SUFFIX__
111#endif /* __INT32_C_SUFFIX__ */
112#endif /* __INT32_TYPE__ */
113
114#ifdef __INT_LEAST32_TYPE__
115#ifdef __int_least32_c_suffix__
116#define __INT32_C(x) int_c(x, __int_least32_c_suffix__)
117#define __UINT32_C(x) uint_c(x, __int_least32_c_suffix__)
118#else
119#define __INT32_C(x) x
120#define __UINT32_C(x) x ## U
121#endif /* __int_least32_c_suffix__ */
122#endif /* __INT_LEAST32_TYPE__ */
123
124#endif /* !CONFIG_ENFORCE_ZEPHYR_STDINT */
125
126#ifdef __INT16_TYPE__
127#undef __int_least16_c_suffix__
128#undef __int_least8_c_suffix__
129#ifdef __INT16_C_SUFFIX__
130#define __int_least16_c_suffix__ __INT16_C_SUFFIX__
131#define __int_least8_c_suffix__ __INT16_C_SUFFIX__
132#endif /* __INT16_C_SUFFIX__ */
133#endif /* __INT16_TYPE__ */
134
135#ifdef __INT_LEAST16_TYPE__
136#ifdef __int_least16_c_suffix__
137#define __INT16_C(x) int_c(x, __int_least16_c_suffix__)
138#define __UINT16_C(x) uint_c(x, __int_least16_c_suffix__)
139#else
140#define __INT16_C(x) x
141#define __UINT16_C(x) x ## U
142#endif /* __int_least16_c_suffix__ */
143#endif /* __INT_LEAST16_TYPE__ */
144
145#ifdef __INT8_TYPE__
146#undef __int_least8_c_suffix__
147#ifdef __INT8_C_SUFFIX__
148#define __int_least8_c_suffix__ __INT8_C_SUFFIX__
149#endif /* __INT8_C_SUFFIX__ */
150#endif /* __INT8_TYPE__ */
151
152#ifdef __INT_LEAST8_TYPE__
153#ifdef __int_least8_c_suffix__
154#define __INT8_C(x) int_c(x, __int_least8_c_suffix__)
155#define __UINT8_C(x) uint_c(x, __int_least8_c_suffix__)
156#else
157#define __INT8_C(x) x
158#define __UINT8_C(x) x ## U
159#endif /* __int_least8_c_suffix__ */
160#endif /* __INT_LEAST8_TYPE__ */
161
162#define __INTMAX_C(x) int_c(x, __INTMAX_C_SUFFIX__)
163#define __UINTMAX_C(x) int_c(x, __UINTMAX_C_SUFFIX__)
164
165#endif /* TOOLCHAIN_CLANG_VERSION < 200100 */
166
167#endif /* CONFIG_MINIMAL_LIBC */
168
169#endif /* ZEPHYR_INCLUDE_TOOLCHAIN_LLVM_H_ */
GCC toolchain abstraction.