LLVM OpenMP* Runtime Library
Loading...
Searching...
No Matches
kmp_os.h
1/*
2 * kmp_os.h -- KPTS runtime header file.
3 */
4
5//===----------------------------------------------------------------------===//
6//
7// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
8// See https://llvm.org/LICENSE.txt for license information.
9// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef KMP_OS_H
14#define KMP_OS_H
15
16#include "kmp_config.h"
17#include <atomic>
18#include <stdarg.h>
19#include <stdlib.h>
20#include <string.h>
21
22#define KMP_FTN_PLAIN 1
23#define KMP_FTN_APPEND 2
24#define KMP_FTN_UPPER 3
25/*
26#define KMP_FTN_PREPEND 4
27#define KMP_FTN_UAPPEND 5
28*/
29
30#define KMP_PTR_SKIP (sizeof(void *))
31
32/* -------------------------- Compiler variations ------------------------ */
33
34#define KMP_OFF 0
35#define KMP_ON 1
36
37#define KMP_MEM_CONS_VOLATILE 0
38#define KMP_MEM_CONS_FENCE 1
39
40#ifndef KMP_MEM_CONS_MODEL
41#define KMP_MEM_CONS_MODEL KMP_MEM_CONS_VOLATILE
42#endif
43
44#ifndef __has_cpp_attribute
45#define __has_cpp_attribute(x) 0
46#endif
47
48#ifndef __has_attribute
49#define __has_attribute(x) 0
50#endif
51
52/* ------------------------- Compiler recognition ---------------------- */
53#define KMP_COMPILER_ICC 0
54#define KMP_COMPILER_GCC 0
55#define KMP_COMPILER_CLANG 0
56#define KMP_COMPILER_MSVC 0
57#define KMP_COMPILER_ICX 0
58
59#if __INTEL_CLANG_COMPILER
60#undef KMP_COMPILER_ICX
61#define KMP_COMPILER_ICX 1
62#elif defined(__INTEL_COMPILER)
63#undef KMP_COMPILER_ICC
64#define KMP_COMPILER_ICC 1
65#elif defined(__clang__)
66#undef KMP_COMPILER_CLANG
67#define KMP_COMPILER_CLANG 1
68#elif defined(__GNUC__)
69#undef KMP_COMPILER_GCC
70#define KMP_COMPILER_GCC 1
71#elif defined(_MSC_VER)
72#undef KMP_COMPILER_MSVC
73#define KMP_COMPILER_MSVC 1
74#else
75#error Unknown compiler
76#endif
77
78#if (KMP_OS_LINUX || KMP_OS_WINDOWS || KMP_OS_FREEBSD || KMP_OS_NETBSD || \
79 KMP_OS_DRAGONFLY || KMP_OS_AIX) && \
80 !KMP_OS_WASI && !KMP_OS_EMSCRIPTEN
81#define KMP_AFFINITY_SUPPORTED 1
82#if KMP_OS_WINDOWS && KMP_ARCH_X86_64
83#define KMP_GROUP_AFFINITY 1
84#else
85#define KMP_GROUP_AFFINITY 0
86#endif
87#else
88#define KMP_AFFINITY_SUPPORTED 0
89#define KMP_GROUP_AFFINITY 0
90#endif
91
92#if (KMP_OS_LINUX || (KMP_OS_FREEBSD && __FreeBSD_version >= 1301000))
93#define KMP_HAVE_SCHED_GETCPU 1
94#else
95#define KMP_HAVE_SCHED_GETCPU 0
96#endif
97
98/* Check for quad-precision extension. */
99#define KMP_HAVE_QUAD 0
100#if KMP_ARCH_X86 || KMP_ARCH_X86_64
101#if KMP_COMPILER_ICC || KMP_COMPILER_ICX
102/* _Quad is already defined for icc */
103#undef KMP_HAVE_QUAD
104#define KMP_HAVE_QUAD 1
105#elif KMP_COMPILER_CLANG
106/* Clang doesn't support a software-implemented
107 128-bit extended precision type yet */
108typedef long double _Quad;
109#elif KMP_COMPILER_GCC
110/* GCC on NetBSD lacks __multc3/__divtc3 builtins needed for quad until
111 NetBSD 10.0 which ships with GCC 10.5 */
112#if (!KMP_OS_NETBSD || __GNUC__ >= 10)
113typedef __float128 _Quad;
114#undef KMP_HAVE_QUAD
115#define KMP_HAVE_QUAD 1
116#endif
117#elif KMP_COMPILER_MSVC
118typedef long double _Quad;
119#endif
120#else
121#if __LDBL_MAX_EXP__ >= 16384 && KMP_COMPILER_GCC
122typedef long double _Quad;
123#undef KMP_HAVE_QUAD
124#define KMP_HAVE_QUAD 1
125#endif
126#endif /* KMP_ARCH_X86 || KMP_ARCH_X86_64 */
127
128#define KMP_USE_X87CONTROL 0
129#if KMP_OS_WINDOWS
130#define KMP_END_OF_LINE "\r\n"
131typedef char kmp_int8;
132typedef unsigned char kmp_uint8;
133typedef short kmp_int16;
134typedef unsigned short kmp_uint16;
135typedef int kmp_int32;
136typedef unsigned int kmp_uint32;
137#define KMP_INT32_SPEC "d"
138#define KMP_UINT32_SPEC "u"
139#ifndef KMP_STRUCT64
140typedef __int64 kmp_int64;
141typedef unsigned __int64 kmp_uint64;
142#define KMP_INT64_SPEC "I64d"
143#define KMP_UINT64_SPEC "I64u"
144#else
145struct kmp_struct64 {
146 kmp_int32 a, b;
147};
148typedef struct kmp_struct64 kmp_int64;
149typedef struct kmp_struct64 kmp_uint64;
150/* Not sure what to use for KMP_[U]INT64_SPEC here */
151#endif
152#if KMP_ARCH_X86 && KMP_MSVC_COMPAT
153#undef KMP_USE_X87CONTROL
154#define KMP_USE_X87CONTROL 1
155#endif
156#if KMP_ARCH_X86_64 || KMP_ARCH_AARCH64 || KMP_ARCH_ARM64EC
157#define KMP_INTPTR 1
158typedef __int64 kmp_intptr_t;
159typedef unsigned __int64 kmp_uintptr_t;
160#define KMP_INTPTR_SPEC "I64d"
161#define KMP_UINTPTR_SPEC "I64u"
162#endif
163#endif /* KMP_OS_WINDOWS */
164
165#if KMP_OS_UNIX
166#define KMP_END_OF_LINE "\n"
167typedef char kmp_int8;
168typedef unsigned char kmp_uint8;
169typedef short kmp_int16;
170typedef unsigned short kmp_uint16;
171typedef int kmp_int32;
172typedef unsigned int kmp_uint32;
173typedef long long kmp_int64;
174typedef unsigned long long kmp_uint64;
175#define KMP_INT32_SPEC "d"
176#define KMP_UINT32_SPEC "u"
177#define KMP_INT64_SPEC "lld"
178#define KMP_UINT64_SPEC "llu"
179#endif /* KMP_OS_UNIX */
180
181#if KMP_ARCH_X86 || KMP_ARCH_ARM || KMP_ARCH_MIPS || KMP_ARCH_WASM || \
182 KMP_ARCH_PPC || KMP_ARCH_AARCH64_32 || KMP_ARCH_SPARC32
183#define KMP_SIZE_T_SPEC KMP_UINT32_SPEC
184#elif KMP_ARCH_X86_64 || KMP_ARCH_PPC64 || KMP_ARCH_AARCH64 || \
185 KMP_ARCH_MIPS64 || KMP_ARCH_RISCV64 || KMP_ARCH_LOONGARCH64 || \
186 KMP_ARCH_VE || KMP_ARCH_S390X || KMP_ARCH_SPARC64 || KMP_ARCH_ARM64EC
187#define KMP_SIZE_T_SPEC KMP_UINT64_SPEC
188#else
189#error "Can't determine size_t printf format specifier."
190#endif
191
192#if KMP_ARCH_X86 || KMP_ARCH_ARM || KMP_ARCH_WASM || KMP_ARCH_PPC
193#define KMP_SIZE_T_MAX (0xFFFFFFFF)
194#else
195#define KMP_SIZE_T_MAX (0xFFFFFFFFFFFFFFFF)
196#endif
197
198typedef size_t kmp_size_t;
199typedef float kmp_real32;
200typedef double kmp_real64;
201
202#ifndef KMP_INTPTR
203#define KMP_INTPTR 1
204typedef long kmp_intptr_t;
205typedef unsigned long kmp_uintptr_t;
206#define KMP_INTPTR_SPEC "ld"
207#define KMP_UINTPTR_SPEC "lu"
208#endif
209
210#ifdef BUILD_I8
211typedef kmp_int64 kmp_int;
212typedef kmp_uint64 kmp_uint;
213#else
214typedef kmp_int32 kmp_int;
215typedef kmp_uint32 kmp_uint;
216#endif /* BUILD_I8 */
217#define KMP_INT_MAX ((kmp_int32)0x7FFFFFFF)
218#define KMP_INT_MIN ((kmp_int32)0x80000000)
219
220// stdarg handling
221#if (KMP_ARCH_ARM || KMP_ARCH_X86_64 || KMP_ARCH_AARCH64 || KMP_ARCH_WASM) && \
222 (KMP_OS_FREEBSD || KMP_OS_NETBSD || KMP_OS_OPENBSD || KMP_OS_DRAGONFLY || \
223 KMP_OS_LINUX || KMP_OS_WASI)
224typedef va_list *kmp_va_list;
225#define kmp_va_deref(ap) (*(ap))
226#define kmp_va_addr_of(ap) (&(ap))
227#else
228typedef va_list kmp_va_list;
229#define kmp_va_deref(ap) (ap)
230#define kmp_va_addr_of(ap) (ap)
231#endif
232
233#ifdef __cplusplus
234// macros to cast out qualifiers and to re-interpret types
235#define CCAST(type, var) const_cast<type>(var)
236#define RCAST(type, var) reinterpret_cast<type>(var)
237//-------------------------------------------------------------------------
238// template for debug prints specification ( d, u, lld, llu ), and to obtain
239// signed/unsigned flavors of a type
240template <typename T> struct traits_t {};
241// int
242template <> struct traits_t<signed int> {
243 typedef signed int signed_t;
244 typedef unsigned int unsigned_t;
245 typedef double floating_t;
246 static char const *spec;
247 static const signed_t max_value = 0x7fffffff;
248 static const signed_t min_value = 0x80000000;
249 static const int type_size = sizeof(signed_t);
250};
251// unsigned int
252template <> struct traits_t<unsigned int> {
253 typedef signed int signed_t;
254 typedef unsigned int unsigned_t;
255 typedef double floating_t;
256 static char const *spec;
257 static const unsigned_t max_value = 0xffffffff;
258 static const unsigned_t min_value = 0x00000000;
259 static const int type_size = sizeof(unsigned_t);
260};
261// long
262template <> struct traits_t<signed long> {
263 typedef signed long signed_t;
264 typedef unsigned long unsigned_t;
265 typedef long double floating_t;
266 static char const *spec;
267 static const int type_size = sizeof(signed_t);
268};
269// long long
270template <> struct traits_t<signed long long> {
271 typedef signed long long signed_t;
272 typedef unsigned long long unsigned_t;
273 typedef long double floating_t;
274 static char const *spec;
275 static const signed_t max_value = 0x7fffffffffffffffLL;
276 static const signed_t min_value = 0x8000000000000000LL;
277 static const int type_size = sizeof(signed_t);
278};
279// unsigned long long
280template <> struct traits_t<unsigned long long> {
281 typedef signed long long signed_t;
282 typedef unsigned long long unsigned_t;
283 typedef long double floating_t;
284 static char const *spec;
285 static const unsigned_t max_value = 0xffffffffffffffffLL;
286 static const unsigned_t min_value = 0x0000000000000000LL;
287 static const int type_size = sizeof(unsigned_t);
288};
289//-------------------------------------------------------------------------
290#else
291#define CCAST(type, var) (type)(var)
292#define RCAST(type, var) (type)(var)
293#endif // __cplusplus
294
295#define KMP_EXPORT extern /* export declaration in guide libraries */
296
297#if __GNUC__ >= 4 && !defined(__MINGW32__)
298#define __forceinline __inline
299#endif
300
301/* Check if the OS/arch can support user-level mwait */
302// All mwait code tests for UMWAIT first, so it should only fall back to ring3
303// MWAIT for KNL.
304#define KMP_HAVE_MWAIT \
305 ((KMP_ARCH_X86 || KMP_ARCH_X86_64) && (KMP_OS_LINUX || KMP_OS_WINDOWS) && \
306 !KMP_MIC2)
307#define KMP_HAVE_UMWAIT \
308 ((KMP_ARCH_X86 || KMP_ARCH_X86_64) && (KMP_OS_LINUX || KMP_OS_WINDOWS) && \
309 !KMP_MIC)
310
311#if KMP_OS_WINDOWS
312// Don't include everything related to NT status code, we'll do that explicitly
313#define WIN32_NO_STATUS
314#include <windows.h>
315
316static inline int KMP_GET_PAGE_SIZE(void) {
317 SYSTEM_INFO si;
318 GetSystemInfo(&si);
319 return si.dwPageSize;
320}
321#else
322#define KMP_GET_PAGE_SIZE() getpagesize()
323#endif
324
325#define PAGE_ALIGNED(_addr) \
326 (!((size_t)_addr & (size_t)(KMP_GET_PAGE_SIZE() - 1)))
327#define ALIGN_TO_PAGE(x) \
328 (void *)(((size_t)(x)) & ~((size_t)(KMP_GET_PAGE_SIZE() - 1)))
329
330/* ---------- Support for cache alignment, padding, etc. ----------------*/
331
332#ifdef __cplusplus
333extern "C" {
334#endif // __cplusplus
335
336#define INTERNODE_CACHE_LINE 4096 /* for multi-node systems */
337
338/* Define the default size of the cache line */
339#ifndef CACHE_LINE
340#define CACHE_LINE 128 /* cache line size in bytes */
341#else
342#if (CACHE_LINE < 64) && !defined(KMP_OS_DARWIN)
343// 2006-02-13: This produces too many warnings on OS X*. Disable for now
344#warning CACHE_LINE is too small.
345#endif
346#endif /* CACHE_LINE */
347
348#define KMP_CACHE_PREFETCH(ADDR) /* nothing */
349
350// Define attribute that indicates that the fall through from the previous
351// case label is intentional and should not be diagnosed by a compiler
352// Code from libcxx/include/__config
353// Use a function like macro to imply that it must be followed by a semicolon
354#if __cplusplus > 201402L && __has_cpp_attribute(fallthrough)
355#define KMP_FALLTHROUGH() [[fallthrough]]
356// icc cannot properly tell this attribute is absent so force off
357#elif KMP_COMPILER_ICC
358#define KMP_FALLTHROUGH() ((void)0)
359#elif __has_cpp_attribute(clang::fallthrough)
360#define KMP_FALLTHROUGH() [[clang::fallthrough]]
361#elif __has_attribute(fallthrough) || __GNUC__ >= 7
362#define KMP_FALLTHROUGH() __attribute__((__fallthrough__))
363#else
364#define KMP_FALLTHROUGH() ((void)0)
365#endif
366
367#if KMP_HAVE_ATTRIBUTE_WAITPKG
368#define KMP_ATTRIBUTE_TARGET_WAITPKG __attribute__((target("waitpkg")))
369#else
370#define KMP_ATTRIBUTE_TARGET_WAITPKG /* Nothing */
371#endif
372
373#if KMP_HAVE_ATTRIBUTE_RTM
374#define KMP_ATTRIBUTE_TARGET_RTM __attribute__((target("rtm")))
375#else
376#define KMP_ATTRIBUTE_TARGET_RTM /* Nothing */
377#endif
378
379// Define attribute that indicates a function does not return
380#if __cplusplus >= 201103L
381#define KMP_NORETURN [[noreturn]]
382#elif KMP_OS_WINDOWS
383#define KMP_NORETURN __declspec(noreturn)
384#else
385#define KMP_NORETURN __attribute__((noreturn))
386#endif
387
388#if KMP_OS_WINDOWS && KMP_MSVC_COMPAT
389#define KMP_ALIGN(bytes) __declspec(align(bytes))
390#define KMP_THREAD_LOCAL __declspec(thread)
391#define KMP_ALIAS /* Nothing */
392#else
393#define KMP_ALIGN(bytes) __attribute__((aligned(bytes)))
394#define KMP_THREAD_LOCAL __thread
395#define KMP_ALIAS(alias_of) __attribute__((alias(alias_of)))
396#endif
397
398#if KMP_HAVE_WEAK_ATTRIBUTE && !KMP_DYNAMIC_LIB
399#define KMP_WEAK_ATTRIBUTE_EXTERNAL __attribute__((weak))
400#else
401#define KMP_WEAK_ATTRIBUTE_EXTERNAL /* Nothing */
402#endif
403
404#if KMP_HAVE_WEAK_ATTRIBUTE
405#define KMP_WEAK_ATTRIBUTE_INTERNAL __attribute__((weak))
406#else
407#define KMP_WEAK_ATTRIBUTE_INTERNAL /* Nothing */
408#endif
409
410// Define KMP_VERSION_SYMBOL and KMP_EXPAND_NAME
411#ifndef KMP_STR
412#define KMP_STR(x) _KMP_STR(x)
413#define _KMP_STR(x) #x
414#endif
415
416#ifdef KMP_USE_VERSION_SYMBOLS
417// If using versioned symbols, KMP_EXPAND_NAME prepends
418// __kmp_api_ to the real API name
419#define KMP_EXPAND_NAME(api_name) _KMP_EXPAND_NAME(api_name)
420#define _KMP_EXPAND_NAME(api_name) __kmp_api_##api_name
421#define KMP_VERSION_SYMBOL(api_name, ver_num, ver_str) \
422 _KMP_VERSION_SYMBOL(api_name, ver_num, ver_str, "VERSION")
423#define _KMP_VERSION_SYMBOL(api_name, ver_num, ver_str, default_ver) \
424 __typeof__(__kmp_api_##api_name) __kmp_api_##api_name##_##ver_num##_alias \
425 __attribute__((alias(KMP_STR(__kmp_api_##api_name)))); \
426 __asm__( \
427 ".symver " KMP_STR(__kmp_api_##api_name##_##ver_num##_alias) "," KMP_STR( \
428 api_name) "@" ver_str "\n\t"); \
429 __asm__(".symver " KMP_STR(__kmp_api_##api_name) "," KMP_STR( \
430 api_name) "@@" default_ver "\n\t")
431
432#define KMP_VERSION_OMPC_SYMBOL(apic_name, api_name, ver_num, ver_str) \
433 _KMP_VERSION_OMPC_SYMBOL(apic_name, api_name, ver_num, ver_str, "VERSION")
434#define _KMP_VERSION_OMPC_SYMBOL(apic_name, api_name, ver_num, ver_str, \
435 default_ver) \
436 __typeof__(__kmp_api_##apic_name) __kmp_api_##apic_name##_##ver_num##_alias \
437 __attribute__((alias(KMP_STR(__kmp_api_##apic_name)))); \
438 __asm__(".symver " KMP_STR(__kmp_api_##apic_name) "," KMP_STR( \
439 apic_name) "@@" default_ver "\n\t"); \
440 __asm__( \
441 ".symver " KMP_STR(__kmp_api_##apic_name##_##ver_num##_alias) "," KMP_STR( \
442 api_name) "@" ver_str "\n\t")
443
444#else // KMP_USE_VERSION_SYMBOLS
445#define KMP_EXPAND_NAME(api_name) api_name
446#define KMP_VERSION_SYMBOL(api_name, ver_num, ver_str) /* Nothing */
447#define KMP_VERSION_OMPC_SYMBOL(apic_name, api_name, ver_num, \
448 ver_str) /* Nothing */
449#endif // KMP_USE_VERSION_SYMBOLS
450
451/* Temporary note: if performance testing of this passes, we can remove
452 all references to KMP_DO_ALIGN and replace with KMP_ALIGN. */
453#define KMP_DO_ALIGN(bytes) KMP_ALIGN(bytes)
454#define KMP_ALIGN_CACHE KMP_ALIGN(CACHE_LINE)
455#define KMP_ALIGN_CACHE_INTERNODE KMP_ALIGN(INTERNODE_CACHE_LINE)
456
457/* General purpose fence types for memory operations */
458enum kmp_mem_fence_type {
459 kmp_no_fence, /* No memory fence */
460 kmp_acquire_fence, /* Acquire (read) memory fence */
461 kmp_release_fence, /* Release (write) memory fence */
462 kmp_full_fence /* Full (read+write) memory fence */
463};
464
465// Synchronization primitives
466
467#if KMP_ASM_INTRINS && KMP_OS_WINDOWS && \
468 !((KMP_ARCH_AARCH64 || KMP_ARCH_ARM || KMP_ARCH_ARM64EC) && \
469 (KMP_COMPILER_CLANG || KMP_COMPILER_GCC))
470
471#if KMP_MSVC_COMPAT && !KMP_COMPILER_CLANG
472#pragma intrinsic(InterlockedExchangeAdd)
473#pragma intrinsic(InterlockedCompareExchange)
474#pragma intrinsic(InterlockedExchange)
475#if !KMP_32_BIT_ARCH
476#pragma intrinsic(InterlockedExchange64)
477#endif
478#endif
479
480// Using InterlockedIncrement / InterlockedDecrement causes a library loading
481// ordering problem, so we use InterlockedExchangeAdd instead.
482#define KMP_TEST_THEN_INC32(p) InterlockedExchangeAdd((volatile long *)(p), 1)
483#define KMP_TEST_THEN_INC_ACQ32(p) \
484 InterlockedExchangeAdd((volatile long *)(p), 1)
485#define KMP_TEST_THEN_ADD4_32(p) InterlockedExchangeAdd((volatile long *)(p), 4)
486#define KMP_TEST_THEN_ADD4_ACQ32(p) \
487 InterlockedExchangeAdd((volatile long *)(p), 4)
488#define KMP_TEST_THEN_DEC32(p) InterlockedExchangeAdd((volatile long *)(p), -1)
489#define KMP_TEST_THEN_DEC_ACQ32(p) \
490 InterlockedExchangeAdd((volatile long *)(p), -1)
491#define KMP_TEST_THEN_ADD32(p, v) \
492 InterlockedExchangeAdd((volatile long *)(p), (v))
493
494#define KMP_COMPARE_AND_STORE_RET32(p, cv, sv) \
495 InterlockedCompareExchange((volatile long *)(p), (long)(sv), (long)(cv))
496
497#define KMP_XCHG_FIXED32(p, v) \
498 InterlockedExchange((volatile long *)(p), (long)(v))
499#define KMP_XCHG_FIXED64(p, v) \
500 InterlockedExchange64((volatile kmp_int64 *)(p), (kmp_int64)(v))
501
502inline kmp_real32 KMP_XCHG_REAL32(volatile kmp_real32 *p, kmp_real32 v) {
503 kmp_int32 tmp = InterlockedExchange((volatile long *)p, *(long *)&v);
504 return *(kmp_real32 *)&tmp;
505}
506
507#define KMP_TEST_THEN_OR8(p, v) __kmp_test_then_or8((p), (v))
508#define KMP_TEST_THEN_AND8(p, v) __kmp_test_then_and8((p), (v))
509#define KMP_TEST_THEN_OR32(p, v) __kmp_test_then_or32((p), (v))
510#define KMP_TEST_THEN_AND32(p, v) __kmp_test_then_and32((p), (v))
511#define KMP_TEST_THEN_OR64(p, v) __kmp_test_then_or64((p), (v))
512#define KMP_TEST_THEN_AND64(p, v) __kmp_test_then_and64((p), (v))
513
514extern kmp_int8 __kmp_test_then_or8(volatile kmp_int8 *p, kmp_int8 v);
515extern kmp_int8 __kmp_test_then_and8(volatile kmp_int8 *p, kmp_int8 v);
516extern kmp_int32 __kmp_test_then_add32(volatile kmp_int32 *p, kmp_int32 v);
517extern kmp_uint32 __kmp_test_then_or32(volatile kmp_uint32 *p, kmp_uint32 v);
518extern kmp_uint32 __kmp_test_then_and32(volatile kmp_uint32 *p, kmp_uint32 v);
519extern kmp_int64 __kmp_test_then_add64(volatile kmp_int64 *p, kmp_int64 v);
520extern kmp_uint64 __kmp_test_then_or64(volatile kmp_uint64 *p, kmp_uint64 v);
521extern kmp_uint64 __kmp_test_then_and64(volatile kmp_uint64 *p, kmp_uint64 v);
522
523#if KMP_ARCH_AARCH64 && KMP_COMPILER_MSVC && !KMP_COMPILER_CLANG
524#define KMP_TEST_THEN_INC64(p) _InterlockedExchangeAdd64((p), 1LL)
525#define KMP_TEST_THEN_INC_ACQ64(p) _InterlockedExchangeAdd64_acq((p), 1LL)
526#define KMP_TEST_THEN_ADD4_64(p) _InterlockedExchangeAdd64((p), 4LL)
527// #define KMP_TEST_THEN_ADD4_ACQ64(p) _InterlockedExchangeAdd64_acq((p), 4LL)
528// #define KMP_TEST_THEN_DEC64(p) _InterlockedExchangeAdd64((p), -1LL)
529// #define KMP_TEST_THEN_DEC_ACQ64(p) _InterlockedExchangeAdd64_acq((p), -1LL)
530// #define KMP_TEST_THEN_ADD8(p, v) _InterlockedExchangeAdd8((p), (v))
531#define KMP_TEST_THEN_ADD64(p, v) _InterlockedExchangeAdd64((p), (v))
532
533#define KMP_COMPARE_AND_STORE_ACQ8(p, cv, sv) \
534 __kmp_compare_and_store_acq8((p), (cv), (sv))
535#define KMP_COMPARE_AND_STORE_REL8(p, cv, sv) \
536 __kmp_compare_and_store_rel8((p), (cv), (sv))
537#define KMP_COMPARE_AND_STORE_ACQ16(p, cv, sv) \
538 __kmp_compare_and_store_acq16((p), (cv), (sv))
539/*
540#define KMP_COMPARE_AND_STORE_REL16(p, cv, sv) \
541 __kmp_compare_and_store_rel16((p), (cv), (sv))
542*/
543#define KMP_COMPARE_AND_STORE_ACQ32(p, cv, sv) \
544 __kmp_compare_and_store_acq32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
545 (kmp_int32)(sv))
546#define KMP_COMPARE_AND_STORE_REL32(p, cv, sv) \
547 __kmp_compare_and_store_rel32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
548 (kmp_int32)(sv))
549#define KMP_COMPARE_AND_STORE_ACQ64(p, cv, sv) \
550 __kmp_compare_and_store_acq64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
551 (kmp_int64)(sv))
552#define KMP_COMPARE_AND_STORE_REL64(p, cv, sv) \
553 __kmp_compare_and_store_rel64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
554 (kmp_int64)(sv))
555#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
556 __kmp_compare_and_store_ptr((void *volatile *)(p), (void *)(cv), (void *)(sv))
557
558// KMP_COMPARE_AND_STORE expects this order: pointer, compare, exchange
559// _InterlockedCompareExchange expects this order: pointer, exchange, compare
560// KMP_COMPARE_AND_STORE also returns a bool indicating a successful write. A
561// write is successful if the return value of _InterlockedCompareExchange is the
562// same as the compare value.
563inline kmp_int8 __kmp_compare_and_store_acq8(volatile kmp_int8 *p, kmp_int8 cv,
564 kmp_int8 sv) {
565 return _InterlockedCompareExchange8_acq(p, sv, cv) == cv;
566}
567
568inline kmp_int8 __kmp_compare_and_store_rel8(volatile kmp_int8 *p, kmp_int8 cv,
569 kmp_int8 sv) {
570 return _InterlockedCompareExchange8_rel(p, sv, cv) == cv;
571}
572
573inline kmp_int16 __kmp_compare_and_store_acq16(volatile kmp_int16 *p,
574 kmp_int16 cv, kmp_int16 sv) {
575 return _InterlockedCompareExchange16_acq(p, sv, cv) == cv;
576}
577
578inline kmp_int16 __kmp_compare_and_store_rel16(volatile kmp_int16 *p,
579 kmp_int16 cv, kmp_int16 sv) {
580 return _InterlockedCompareExchange16_rel(p, sv, cv) == cv;
581}
582
583inline kmp_int32 __kmp_compare_and_store_acq32(volatile kmp_int32 *p,
584 kmp_int32 cv, kmp_int32 sv) {
585 return _InterlockedCompareExchange_acq((volatile long *)p, sv, cv) == cv;
586}
587
588inline kmp_int32 __kmp_compare_and_store_rel32(volatile kmp_int32 *p,
589 kmp_int32 cv, kmp_int32 sv) {
590 return _InterlockedCompareExchange_rel((volatile long *)p, sv, cv) == cv;
591}
592
593inline kmp_int32 __kmp_compare_and_store_acq64(volatile kmp_int64 *p,
594 kmp_int64 cv, kmp_int64 sv) {
595 return _InterlockedCompareExchange64_acq(p, sv, cv) == cv;
596}
597
598inline kmp_int32 __kmp_compare_and_store_rel64(volatile kmp_int64 *p,
599 kmp_int64 cv, kmp_int64 sv) {
600 return _InterlockedCompareExchange64_rel(p, sv, cv) == cv;
601}
602
603inline kmp_int32 __kmp_compare_and_store_ptr(void *volatile *p, void *cv,
604 void *sv) {
605 return _InterlockedCompareExchangePointer(p, sv, cv) == cv;
606}
607
608// The _RET versions return the value instead of a bool
609
610#define KMP_COMPARE_AND_STORE_RET8(p, cv, sv) \
611 _InterlockedCompareExchange8((p), (sv), (cv))
612#define KMP_COMPARE_AND_STORE_RET16(p, cv, sv) \
613 _InterlockedCompareExchange16((p), (sv), (cv))
614
615#define KMP_COMPARE_AND_STORE_RET64(p, cv, sv) \
616 _InterlockedCompareExchange64((volatile kmp_int64 *)(p), (kmp_int64)(sv), \
617 (kmp_int64)(cv))
618
619
620#define KMP_XCHG_FIXED8(p, v) \
621 _InterlockedExchange8((volatile kmp_int8 *)(p), (kmp_int8)(v));
622#define KMP_XCHG_FIXED16(p, v) _InterlockedExchange16((p), (v));
623#define KMP_XCHG_REAL64(p, v) __kmp_xchg_real64((p), (v));
624
625inline kmp_real64 __kmp_xchg_real64(volatile kmp_real64 *p, kmp_real64 v) {
626 kmp_int64 tmp = _InterlockedExchange64((volatile kmp_int64 *)p, *(kmp_int64
627 *)&v); return *(kmp_real64 *)&tmp;
628}
629
630#else // !KMP_ARCH_AARCH64
631
632// Routines that we still need to implement in assembly.
633extern kmp_int8 __kmp_test_then_add8(volatile kmp_int8 *p, kmp_int8 v);
634
635extern kmp_int8 __kmp_compare_and_store8(volatile kmp_int8 *p, kmp_int8 cv,
636 kmp_int8 sv);
637extern kmp_int16 __kmp_compare_and_store16(volatile kmp_int16 *p, kmp_int16 cv,
638 kmp_int16 sv);
639extern kmp_int32 __kmp_compare_and_store32(volatile kmp_int32 *p, kmp_int32 cv,
640 kmp_int32 sv);
641extern kmp_int32 __kmp_compare_and_store64(volatile kmp_int64 *p, kmp_int64 cv,
642 kmp_int64 sv);
643extern kmp_int8 __kmp_compare_and_store_ret8(volatile kmp_int8 *p, kmp_int8 cv,
644 kmp_int8 sv);
645extern kmp_int16 __kmp_compare_and_store_ret16(volatile kmp_int16 *p,
646 kmp_int16 cv, kmp_int16 sv);
647extern kmp_int32 __kmp_compare_and_store_ret32(volatile kmp_int32 *p,
648 kmp_int32 cv, kmp_int32 sv);
649extern kmp_int64 __kmp_compare_and_store_ret64(volatile kmp_int64 *p,
650 kmp_int64 cv, kmp_int64 sv);
651
652extern kmp_int8 __kmp_xchg_fixed8(volatile kmp_int8 *p, kmp_int8 v);
653extern kmp_int16 __kmp_xchg_fixed16(volatile kmp_int16 *p, kmp_int16 v);
654extern kmp_int32 __kmp_xchg_fixed32(volatile kmp_int32 *p, kmp_int32 v);
655extern kmp_int64 __kmp_xchg_fixed64(volatile kmp_int64 *p, kmp_int64 v);
656extern kmp_real32 __kmp_xchg_real32(volatile kmp_real32 *p, kmp_real32 v);
657extern kmp_real64 __kmp_xchg_real64(volatile kmp_real64 *p, kmp_real64 v);
658
659//#define KMP_TEST_THEN_INC32(p) __kmp_test_then_add32((p), 1)
660//#define KMP_TEST_THEN_INC_ACQ32(p) __kmp_test_then_add32((p), 1)
661#define KMP_TEST_THEN_INC64(p) __kmp_test_then_add64((p), 1LL)
662#define KMP_TEST_THEN_INC_ACQ64(p) __kmp_test_then_add64((p), 1LL)
663//#define KMP_TEST_THEN_ADD4_32(p) __kmp_test_then_add32((p), 4)
664//#define KMP_TEST_THEN_ADD4_ACQ32(p) __kmp_test_then_add32((p), 4)
665#define KMP_TEST_THEN_ADD4_64(p) __kmp_test_then_add64((p), 4LL)
666#define KMP_TEST_THEN_ADD4_ACQ64(p) __kmp_test_then_add64((p), 4LL)
667//#define KMP_TEST_THEN_DEC32(p) __kmp_test_then_add32((p), -1)
668//#define KMP_TEST_THEN_DEC_ACQ32(p) __kmp_test_then_add32((p), -1)
669#define KMP_TEST_THEN_DEC64(p) __kmp_test_then_add64((p), -1LL)
670#define KMP_TEST_THEN_DEC_ACQ64(p) __kmp_test_then_add64((p), -1LL)
671//#define KMP_TEST_THEN_ADD32(p, v) __kmp_test_then_add32((p), (v))
672#define KMP_TEST_THEN_ADD8(p, v) __kmp_test_then_add8((p), (v))
673#define KMP_TEST_THEN_ADD64(p, v) __kmp_test_then_add64((p), (v))
674
675
676#define KMP_COMPARE_AND_STORE_ACQ8(p, cv, sv) \
677 __kmp_compare_and_store8((p), (cv), (sv))
678#define KMP_COMPARE_AND_STORE_REL8(p, cv, sv) \
679 __kmp_compare_and_store8((p), (cv), (sv))
680#define KMP_COMPARE_AND_STORE_ACQ16(p, cv, sv) \
681 __kmp_compare_and_store16((p), (cv), (sv))
682#define KMP_COMPARE_AND_STORE_REL16(p, cv, sv) \
683 __kmp_compare_and_store16((p), (cv), (sv))
684#define KMP_COMPARE_AND_STORE_ACQ32(p, cv, sv) \
685 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
686 (kmp_int32)(sv))
687#define KMP_COMPARE_AND_STORE_REL32(p, cv, sv) \
688 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
689 (kmp_int32)(sv))
690#define KMP_COMPARE_AND_STORE_ACQ64(p, cv, sv) \
691 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
692 (kmp_int64)(sv))
693#define KMP_COMPARE_AND_STORE_REL64(p, cv, sv) \
694 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
695 (kmp_int64)(sv))
696
697#if KMP_ARCH_X86
698#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
699 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
700 (kmp_int32)(sv))
701#else /* 64 bit pointers */
702#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
703 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
704 (kmp_int64)(sv))
705#endif /* KMP_ARCH_X86 */
706
707#define KMP_COMPARE_AND_STORE_RET8(p, cv, sv) \
708 __kmp_compare_and_store_ret8((p), (cv), (sv))
709#define KMP_COMPARE_AND_STORE_RET16(p, cv, sv) \
710 __kmp_compare_and_store_ret16((p), (cv), (sv))
711#define KMP_COMPARE_AND_STORE_RET64(p, cv, sv) \
712 __kmp_compare_and_store_ret64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
713 (kmp_int64)(sv))
714
715#define KMP_XCHG_FIXED8(p, v) \
716 __kmp_xchg_fixed8((volatile kmp_int8 *)(p), (kmp_int8)(v));
717#define KMP_XCHG_FIXED16(p, v) __kmp_xchg_fixed16((p), (v));
718//#define KMP_XCHG_FIXED32(p, v) __kmp_xchg_fixed32((p), (v));
719//#define KMP_XCHG_FIXED64(p, v) __kmp_xchg_fixed64((p), (v));
720//#define KMP_XCHG_REAL32(p, v) __kmp_xchg_real32((p), (v));
721#define KMP_XCHG_REAL64(p, v) __kmp_xchg_real64((p), (v));
722#endif
723
724#elif (KMP_ASM_INTRINS && KMP_OS_UNIX) || !(KMP_ARCH_X86 || KMP_ARCH_X86_64)
725
726/* cast p to correct type so that proper intrinsic will be used */
727#define KMP_TEST_THEN_INC32(p) \
728 __sync_fetch_and_add((volatile kmp_int32 *)(p), 1)
729#define KMP_TEST_THEN_INC_ACQ32(p) \
730 __sync_fetch_and_add((volatile kmp_int32 *)(p), 1)
731#if KMP_ARCH_MIPS
732#define KMP_TEST_THEN_INC64(p) \
733 __atomic_fetch_add((volatile kmp_int64 *)(p), 1LL, __ATOMIC_SEQ_CST)
734#define KMP_TEST_THEN_INC_ACQ64(p) \
735 __atomic_fetch_add((volatile kmp_int64 *)(p), 1LL, __ATOMIC_SEQ_CST)
736#else
737#define KMP_TEST_THEN_INC64(p) \
738 __sync_fetch_and_add((volatile kmp_int64 *)(p), 1LL)
739#define KMP_TEST_THEN_INC_ACQ64(p) \
740 __sync_fetch_and_add((volatile kmp_int64 *)(p), 1LL)
741#endif
742#define KMP_TEST_THEN_ADD4_32(p) \
743 __sync_fetch_and_add((volatile kmp_int32 *)(p), 4)
744#define KMP_TEST_THEN_ADD4_ACQ32(p) \
745 __sync_fetch_and_add((volatile kmp_int32 *)(p), 4)
746#if KMP_ARCH_MIPS
747#define KMP_TEST_THEN_ADD4_64(p) \
748 __atomic_fetch_add((volatile kmp_int64 *)(p), 4LL, __ATOMIC_SEQ_CST)
749#define KMP_TEST_THEN_ADD4_ACQ64(p) \
750 __atomic_fetch_add((volatile kmp_int64 *)(p), 4LL, __ATOMIC_SEQ_CST)
751#define KMP_TEST_THEN_DEC64(p) \
752 __atomic_fetch_sub((volatile kmp_int64 *)(p), 1LL, __ATOMIC_SEQ_CST)
753#define KMP_TEST_THEN_DEC_ACQ64(p) \
754 __atomic_fetch_sub((volatile kmp_int64 *)(p), 1LL, __ATOMIC_SEQ_CST)
755#else
756#define KMP_TEST_THEN_ADD4_64(p) \
757 __sync_fetch_and_add((volatile kmp_int64 *)(p), 4LL)
758#define KMP_TEST_THEN_ADD4_ACQ64(p) \
759 __sync_fetch_and_add((volatile kmp_int64 *)(p), 4LL)
760#define KMP_TEST_THEN_DEC64(p) \
761 __sync_fetch_and_sub((volatile kmp_int64 *)(p), 1LL)
762#define KMP_TEST_THEN_DEC_ACQ64(p) \
763 __sync_fetch_and_sub((volatile kmp_int64 *)(p), 1LL)
764#endif
765#define KMP_TEST_THEN_DEC32(p) \
766 __sync_fetch_and_sub((volatile kmp_int32 *)(p), 1)
767#define KMP_TEST_THEN_DEC_ACQ32(p) \
768 __sync_fetch_and_sub((volatile kmp_int32 *)(p), 1)
769#define KMP_TEST_THEN_ADD8(p, v) \
770 __sync_fetch_and_add((volatile kmp_int8 *)(p), (kmp_int8)(v))
771#define KMP_TEST_THEN_ADD32(p, v) \
772 __sync_fetch_and_add((volatile kmp_int32 *)(p), (kmp_int32)(v))
773#if KMP_ARCH_MIPS
774#define KMP_TEST_THEN_ADD64(p, v) \
775 __atomic_fetch_add((volatile kmp_uint64 *)(p), (kmp_uint64)(v), \
776 __ATOMIC_SEQ_CST)
777#else
778#define KMP_TEST_THEN_ADD64(p, v) \
779 __sync_fetch_and_add((volatile kmp_int64 *)(p), (kmp_int64)(v))
780#endif
781
782#define KMP_TEST_THEN_OR8(p, v) \
783 __sync_fetch_and_or((volatile kmp_int8 *)(p), (kmp_int8)(v))
784#define KMP_TEST_THEN_AND8(p, v) \
785 __sync_fetch_and_and((volatile kmp_int8 *)(p), (kmp_int8)(v))
786#define KMP_TEST_THEN_OR32(p, v) \
787 __sync_fetch_and_or((volatile kmp_uint32 *)(p), (kmp_uint32)(v))
788#define KMP_TEST_THEN_AND32(p, v) \
789 __sync_fetch_and_and((volatile kmp_uint32 *)(p), (kmp_uint32)(v))
790#if KMP_ARCH_MIPS
791#define KMP_TEST_THEN_OR64(p, v) \
792 __atomic_fetch_or((volatile kmp_uint64 *)(p), (kmp_uint64)(v), \
793 __ATOMIC_SEQ_CST)
794#define KMP_TEST_THEN_AND64(p, v) \
795 __atomic_fetch_and((volatile kmp_uint64 *)(p), (kmp_uint64)(v), \
796 __ATOMIC_SEQ_CST)
797#else
798#define KMP_TEST_THEN_OR64(p, v) \
799 __sync_fetch_and_or((volatile kmp_uint64 *)(p), (kmp_uint64)(v))
800#define KMP_TEST_THEN_AND64(p, v) \
801 __sync_fetch_and_and((volatile kmp_uint64 *)(p), (kmp_uint64)(v))
802#endif
803
804#define KMP_COMPARE_AND_STORE_ACQ8(p, cv, sv) \
805 __sync_bool_compare_and_swap((volatile kmp_uint8 *)(p), (kmp_uint8)(cv), \
806 (kmp_uint8)(sv))
807#define KMP_COMPARE_AND_STORE_REL8(p, cv, sv) \
808 __sync_bool_compare_and_swap((volatile kmp_uint8 *)(p), (kmp_uint8)(cv), \
809 (kmp_uint8)(sv))
810#define KMP_COMPARE_AND_STORE_ACQ16(p, cv, sv) \
811 __sync_bool_compare_and_swap((volatile kmp_uint16 *)(p), (kmp_uint16)(cv), \
812 (kmp_uint16)(sv))
813#define KMP_COMPARE_AND_STORE_REL16(p, cv, sv) \
814 __sync_bool_compare_and_swap((volatile kmp_uint16 *)(p), (kmp_uint16)(cv), \
815 (kmp_uint16)(sv))
816#define KMP_COMPARE_AND_STORE_ACQ32(p, cv, sv) \
817 __sync_bool_compare_and_swap((volatile kmp_uint32 *)(p), (kmp_uint32)(cv), \
818 (kmp_uint32)(sv))
819#define KMP_COMPARE_AND_STORE_REL32(p, cv, sv) \
820 __sync_bool_compare_and_swap((volatile kmp_uint32 *)(p), (kmp_uint32)(cv), \
821 (kmp_uint32)(sv))
822#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
823 __sync_bool_compare_and_swap((void *volatile *)(p), (void *)(cv), \
824 (void *)(sv))
825
826#define KMP_COMPARE_AND_STORE_RET8(p, cv, sv) \
827 __sync_val_compare_and_swap((volatile kmp_uint8 *)(p), (kmp_uint8)(cv), \
828 (kmp_uint8)(sv))
829#define KMP_COMPARE_AND_STORE_RET16(p, cv, sv) \
830 __sync_val_compare_and_swap((volatile kmp_uint16 *)(p), (kmp_uint16)(cv), \
831 (kmp_uint16)(sv))
832#define KMP_COMPARE_AND_STORE_RET32(p, cv, sv) \
833 __sync_val_compare_and_swap((volatile kmp_uint32 *)(p), (kmp_uint32)(cv), \
834 (kmp_uint32)(sv))
835#if KMP_ARCH_MIPS
836static inline bool mips_sync_bool_compare_and_swap(volatile kmp_uint64 *p,
837 kmp_uint64 cv,
838 kmp_uint64 sv) {
839 return __atomic_compare_exchange(p, &cv, &sv, false, __ATOMIC_SEQ_CST,
840 __ATOMIC_SEQ_CST);
841}
842static inline bool mips_sync_val_compare_and_swap(volatile kmp_uint64 *p,
843 kmp_uint64 cv,
844 kmp_uint64 sv) {
845 __atomic_compare_exchange(p, &cv, &sv, false, __ATOMIC_SEQ_CST,
846 __ATOMIC_SEQ_CST);
847 return cv;
848}
849#define KMP_COMPARE_AND_STORE_ACQ64(p, cv, sv) \
850 mips_sync_bool_compare_and_swap((volatile kmp_uint64 *)(p), \
851 (kmp_uint64)(cv), (kmp_uint64)(sv))
852#define KMP_COMPARE_AND_STORE_REL64(p, cv, sv) \
853 mips_sync_bool_compare_and_swap((volatile kmp_uint64 *)(p), \
854 (kmp_uint64)(cv), (kmp_uint64)(sv))
855#define KMP_COMPARE_AND_STORE_RET64(p, cv, sv) \
856 mips_sync_val_compare_and_swap((volatile kmp_uint64 *)(p), (kmp_uint64)(cv), \
857 (kmp_uint64)(sv))
858#else
859#define KMP_COMPARE_AND_STORE_ACQ64(p, cv, sv) \
860 __sync_bool_compare_and_swap((volatile kmp_uint64 *)(p), (kmp_uint64)(cv), \
861 (kmp_uint64)(sv))
862#define KMP_COMPARE_AND_STORE_REL64(p, cv, sv) \
863 __sync_bool_compare_and_swap((volatile kmp_uint64 *)(p), (kmp_uint64)(cv), \
864 (kmp_uint64)(sv))
865#define KMP_COMPARE_AND_STORE_RET64(p, cv, sv) \
866 __sync_val_compare_and_swap((volatile kmp_uint64 *)(p), (kmp_uint64)(cv), \
867 (kmp_uint64)(sv))
868#endif
869
870#if KMP_OS_DARWIN && defined(__INTEL_COMPILER) && __INTEL_COMPILER >= 1800
871#define KMP_XCHG_FIXED8(p, v) \
872 __atomic_exchange_1((volatile kmp_uint8 *)(p), (kmp_uint8)(v), \
873 __ATOMIC_SEQ_CST)
874#else
875#define KMP_XCHG_FIXED8(p, v) \
876 __sync_lock_test_and_set((volatile kmp_uint8 *)(p), (kmp_uint8)(v))
877#endif
878#define KMP_XCHG_FIXED16(p, v) \
879 __sync_lock_test_and_set((volatile kmp_uint16 *)(p), (kmp_uint16)(v))
880#define KMP_XCHG_FIXED32(p, v) \
881 __sync_lock_test_and_set((volatile kmp_uint32 *)(p), (kmp_uint32)(v))
882#define KMP_XCHG_FIXED64(p, v) \
883 __sync_lock_test_and_set((volatile kmp_uint64 *)(p), (kmp_uint64)(v))
884
885inline kmp_real32 KMP_XCHG_REAL32(volatile kmp_real32 *p, kmp_real32 v) {
886 volatile kmp_uint32 *up;
887 kmp_uint32 uv;
888 memcpy(&up, &p, sizeof(up));
889 memcpy(&uv, &v, sizeof(uv));
890 kmp_int32 tmp = __sync_lock_test_and_set(up, uv);
891 kmp_real32 ftmp;
892 memcpy(&ftmp, &tmp, sizeof(tmp));
893 return ftmp;
894}
895
896inline kmp_real64 KMP_XCHG_REAL64(volatile kmp_real64 *p, kmp_real64 v) {
897 volatile kmp_uint64 *up;
898 kmp_uint64 uv;
899 memcpy(&up, &p, sizeof(up));
900 memcpy(&uv, &v, sizeof(uv));
901 kmp_int64 tmp = __sync_lock_test_and_set(up, uv);
902 kmp_real64 dtmp;
903 memcpy(&dtmp, &tmp, sizeof(tmp));
904 return dtmp;
905}
906
907#else
908
909extern kmp_int8 __kmp_test_then_add8(volatile kmp_int8 *p, kmp_int8 v);
910extern kmp_int8 __kmp_test_then_or8(volatile kmp_int8 *p, kmp_int8 v);
911extern kmp_int8 __kmp_test_then_and8(volatile kmp_int8 *p, kmp_int8 v);
912extern kmp_int32 __kmp_test_then_add32(volatile kmp_int32 *p, kmp_int32 v);
913extern kmp_uint32 __kmp_test_then_or32(volatile kmp_uint32 *p, kmp_uint32 v);
914extern kmp_uint32 __kmp_test_then_and32(volatile kmp_uint32 *p, kmp_uint32 v);
915extern kmp_int64 __kmp_test_then_add64(volatile kmp_int64 *p, kmp_int64 v);
916extern kmp_uint64 __kmp_test_then_or64(volatile kmp_uint64 *p, kmp_uint64 v);
917extern kmp_uint64 __kmp_test_then_and64(volatile kmp_uint64 *p, kmp_uint64 v);
918
919extern kmp_int8 __kmp_compare_and_store8(volatile kmp_int8 *p, kmp_int8 cv,
920 kmp_int8 sv);
921extern kmp_int16 __kmp_compare_and_store16(volatile kmp_int16 *p, kmp_int16 cv,
922 kmp_int16 sv);
923extern kmp_int32 __kmp_compare_and_store32(volatile kmp_int32 *p, kmp_int32 cv,
924 kmp_int32 sv);
925extern kmp_int32 __kmp_compare_and_store64(volatile kmp_int64 *p, kmp_int64 cv,
926 kmp_int64 sv);
927extern kmp_int8 __kmp_compare_and_store_ret8(volatile kmp_int8 *p, kmp_int8 cv,
928 kmp_int8 sv);
929extern kmp_int16 __kmp_compare_and_store_ret16(volatile kmp_int16 *p,
930 kmp_int16 cv, kmp_int16 sv);
931extern kmp_int32 __kmp_compare_and_store_ret32(volatile kmp_int32 *p,
932 kmp_int32 cv, kmp_int32 sv);
933extern kmp_int64 __kmp_compare_and_store_ret64(volatile kmp_int64 *p,
934 kmp_int64 cv, kmp_int64 sv);
935
936extern kmp_int8 __kmp_xchg_fixed8(volatile kmp_int8 *p, kmp_int8 v);
937extern kmp_int16 __kmp_xchg_fixed16(volatile kmp_int16 *p, kmp_int16 v);
938extern kmp_int32 __kmp_xchg_fixed32(volatile kmp_int32 *p, kmp_int32 v);
939extern kmp_int64 __kmp_xchg_fixed64(volatile kmp_int64 *p, kmp_int64 v);
940extern kmp_real32 __kmp_xchg_real32(volatile kmp_real32 *p, kmp_real32 v);
941extern kmp_real64 __kmp_xchg_real64(volatile kmp_real64 *p, kmp_real64 v);
942
943#define KMP_TEST_THEN_INC32(p) \
944 __kmp_test_then_add32((volatile kmp_int32 *)(p), 1)
945#define KMP_TEST_THEN_INC_ACQ32(p) \
946 __kmp_test_then_add32((volatile kmp_int32 *)(p), 1)
947#define KMP_TEST_THEN_INC64(p) \
948 __kmp_test_then_add64((volatile kmp_int64 *)(p), 1LL)
949#define KMP_TEST_THEN_INC_ACQ64(p) \
950 __kmp_test_then_add64((volatile kmp_int64 *)(p), 1LL)
951#define KMP_TEST_THEN_ADD4_32(p) \
952 __kmp_test_then_add32((volatile kmp_int32 *)(p), 4)
953#define KMP_TEST_THEN_ADD4_ACQ32(p) \
954 __kmp_test_then_add32((volatile kmp_int32 *)(p), 4)
955#define KMP_TEST_THEN_ADD4_64(p) \
956 __kmp_test_then_add64((volatile kmp_int64 *)(p), 4LL)
957#define KMP_TEST_THEN_ADD4_ACQ64(p) \
958 __kmp_test_then_add64((volatile kmp_int64 *)(p), 4LL)
959#define KMP_TEST_THEN_DEC32(p) \
960 __kmp_test_then_add32((volatile kmp_int32 *)(p), -1)
961#define KMP_TEST_THEN_DEC_ACQ32(p) \
962 __kmp_test_then_add32((volatile kmp_int32 *)(p), -1)
963#define KMP_TEST_THEN_DEC64(p) \
964 __kmp_test_then_add64((volatile kmp_int64 *)(p), -1LL)
965#define KMP_TEST_THEN_DEC_ACQ64(p) \
966 __kmp_test_then_add64((volatile kmp_int64 *)(p), -1LL)
967#define KMP_TEST_THEN_ADD8(p, v) \
968 __kmp_test_then_add8((volatile kmp_int8 *)(p), (kmp_int8)(v))
969#define KMP_TEST_THEN_ADD32(p, v) \
970 __kmp_test_then_add32((volatile kmp_int32 *)(p), (kmp_int32)(v))
971#define KMP_TEST_THEN_ADD64(p, v) \
972 __kmp_test_then_add64((volatile kmp_int64 *)(p), (kmp_int64)(v))
973
974#define KMP_TEST_THEN_OR8(p, v) \
975 __kmp_test_then_or8((volatile kmp_int8 *)(p), (kmp_int8)(v))
976#define KMP_TEST_THEN_AND8(p, v) \
977 __kmp_test_then_and8((volatile kmp_int8 *)(p), (kmp_int8)(v))
978#define KMP_TEST_THEN_OR32(p, v) \
979 __kmp_test_then_or32((volatile kmp_uint32 *)(p), (kmp_uint32)(v))
980#define KMP_TEST_THEN_AND32(p, v) \
981 __kmp_test_then_and32((volatile kmp_uint32 *)(p), (kmp_uint32)(v))
982#define KMP_TEST_THEN_OR64(p, v) \
983 __kmp_test_then_or64((volatile kmp_uint64 *)(p), (kmp_uint64)(v))
984#define KMP_TEST_THEN_AND64(p, v) \
985 __kmp_test_then_and64((volatile kmp_uint64 *)(p), (kmp_uint64)(v))
986
987#define KMP_COMPARE_AND_STORE_ACQ8(p, cv, sv) \
988 __kmp_compare_and_store8((volatile kmp_int8 *)(p), (kmp_int8)(cv), \
989 (kmp_int8)(sv))
990#define KMP_COMPARE_AND_STORE_REL8(p, cv, sv) \
991 __kmp_compare_and_store8((volatile kmp_int8 *)(p), (kmp_int8)(cv), \
992 (kmp_int8)(sv))
993#define KMP_COMPARE_AND_STORE_ACQ16(p, cv, sv) \
994 __kmp_compare_and_store16((volatile kmp_int16 *)(p), (kmp_int16)(cv), \
995 (kmp_int16)(sv))
996#define KMP_COMPARE_AND_STORE_REL16(p, cv, sv) \
997 __kmp_compare_and_store16((volatile kmp_int16 *)(p), (kmp_int16)(cv), \
998 (kmp_int16)(sv))
999#define KMP_COMPARE_AND_STORE_ACQ32(p, cv, sv) \
1000 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
1001 (kmp_int32)(sv))
1002#define KMP_COMPARE_AND_STORE_REL32(p, cv, sv) \
1003 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
1004 (kmp_int32)(sv))
1005#define KMP_COMPARE_AND_STORE_ACQ64(p, cv, sv) \
1006 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
1007 (kmp_int64)(sv))
1008#define KMP_COMPARE_AND_STORE_REL64(p, cv, sv) \
1009 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
1010 (kmp_int64)(sv))
1011
1012#if KMP_ARCH_X86
1013#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
1014 __kmp_compare_and_store32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
1015 (kmp_int32)(sv))
1016#else /* 64 bit pointers */
1017#define KMP_COMPARE_AND_STORE_PTR(p, cv, sv) \
1018 __kmp_compare_and_store64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
1019 (kmp_int64)(sv))
1020#endif /* KMP_ARCH_X86 */
1021
1022#define KMP_COMPARE_AND_STORE_RET8(p, cv, sv) \
1023 __kmp_compare_and_store_ret8((p), (cv), (sv))
1024#define KMP_COMPARE_AND_STORE_RET16(p, cv, sv) \
1025 __kmp_compare_and_store_ret16((p), (cv), (sv))
1026#define KMP_COMPARE_AND_STORE_RET32(p, cv, sv) \
1027 __kmp_compare_and_store_ret32((volatile kmp_int32 *)(p), (kmp_int32)(cv), \
1028 (kmp_int32)(sv))
1029#define KMP_COMPARE_AND_STORE_RET64(p, cv, sv) \
1030 __kmp_compare_and_store_ret64((volatile kmp_int64 *)(p), (kmp_int64)(cv), \
1031 (kmp_int64)(sv))
1032
1033#define KMP_XCHG_FIXED8(p, v) \
1034 __kmp_xchg_fixed8((volatile kmp_int8 *)(p), (kmp_int8)(v));
1035#define KMP_XCHG_FIXED16(p, v) __kmp_xchg_fixed16((p), (v));
1036#define KMP_XCHG_FIXED32(p, v) __kmp_xchg_fixed32((p), (v));
1037#define KMP_XCHG_FIXED64(p, v) __kmp_xchg_fixed64((p), (v));
1038#define KMP_XCHG_REAL32(p, v) __kmp_xchg_real32((p), (v));
1039#define KMP_XCHG_REAL64(p, v) __kmp_xchg_real64((p), (v));
1040
1041#endif /* KMP_ASM_INTRINS */
1042
1043/* ------------- relaxed consistency memory model stuff ------------------ */
1044
1045#if KMP_OS_WINDOWS
1046#ifdef __ABSOFT_WIN
1047#define KMP_MB() asm("nop")
1048#define KMP_IMB() asm("nop")
1049#else
1050#define KMP_MB() /* _asm{ nop } */
1051#define KMP_IMB() /* _asm{ nop } */
1052#endif
1053#endif /* KMP_OS_WINDOWS */
1054
1055#if KMP_ARCH_PPC64 || KMP_ARCH_ARM || KMP_ARCH_AARCH64 || KMP_ARCH_MIPS || \
1056 KMP_ARCH_MIPS64 || KMP_ARCH_RISCV64 || KMP_ARCH_LOONGARCH64 || \
1057 KMP_ARCH_VE || KMP_ARCH_S390X || KMP_ARCH_PPC || KMP_ARCH_AARCH64_32 || \
1058 KMP_ARCH_SPARC || KMP_ARCH_ARM64EC
1059#if KMP_OS_WINDOWS
1060#undef KMP_MB
1061#define KMP_MB() std::atomic_thread_fence(std::memory_order_seq_cst)
1062#else /* !KMP_OS_WINDOWS */
1063#define KMP_MB() __sync_synchronize()
1064#endif
1065#endif
1066
1067#ifndef KMP_MB
1068#define KMP_MB() /* nothing to do */
1069#endif
1070
1071#if KMP_ARCH_X86 || KMP_ARCH_X86_64
1072#if KMP_MIC
1073// fence-style instructions do not exist, but lock; xaddl $0,(%rsp) can be used.
1074// We shouldn't need it, though, since the ABI rules require that
1075// * If the compiler generates NGO stores it also generates the fence
1076// * If users hand-code NGO stores they should insert the fence
1077// therefore no incomplete unordered stores should be visible.
1078#define KMP_MFENCE() /* Nothing */
1079#define KMP_SFENCE() /* Nothing */
1080#else
1081#if KMP_COMPILER_ICC || KMP_COMPILER_ICX
1082#define KMP_MFENCE_() _mm_mfence()
1083#define KMP_SFENCE_() _mm_sfence()
1084#elif KMP_COMPILER_MSVC
1085#define KMP_MFENCE_() MemoryBarrier()
1086#define KMP_SFENCE_() MemoryBarrier()
1087#else
1088#define KMP_MFENCE_() __sync_synchronize()
1089#define KMP_SFENCE_() __sync_synchronize()
1090#endif
1091#define KMP_MFENCE() \
1092 if (UNLIKELY(!__kmp_cpuinfo.initialized)) { \
1093 __kmp_query_cpuid(&__kmp_cpuinfo); \
1094 } \
1095 if (__kmp_cpuinfo.flags.sse2) { \
1096 KMP_MFENCE_(); \
1097 }
1098#define KMP_SFENCE() KMP_SFENCE_()
1099#endif
1100#else
1101#define KMP_MFENCE() KMP_MB()
1102#define KMP_SFENCE() KMP_MB()
1103#endif
1104
1105#ifndef KMP_IMB
1106#define KMP_IMB() /* nothing to do */
1107#endif
1108
1109#ifndef KMP_ST_REL32
1110#define KMP_ST_REL32(A, D) (*(A) = (D))
1111#endif
1112
1113#ifndef KMP_ST_REL64
1114#define KMP_ST_REL64(A, D) (*(A) = (D))
1115#endif
1116
1117#ifndef KMP_LD_ACQ32
1118#define KMP_LD_ACQ32(A) (*(A))
1119#endif
1120
1121#ifndef KMP_LD_ACQ64
1122#define KMP_LD_ACQ64(A) (*(A))
1123#endif
1124
1125/* ------------------------------------------------------------------------ */
1126// FIXME - maybe this should this be
1127//
1128// #define TCR_4(a) (*(volatile kmp_int32 *)(&a))
1129// #define TCW_4(a,b) (a) = (*(volatile kmp_int32 *)&(b))
1130//
1131// #define TCR_8(a) (*(volatile kmp_int64 *)(a))
1132// #define TCW_8(a,b) (a) = (*(volatile kmp_int64 *)(&b))
1133//
1134// I'm fairly certain this is the correct thing to do, but I'm afraid
1135// of performance regressions.
1136
1137#define TCR_1(a) (a)
1138#define TCW_1(a, b) (a) = (b)
1139#define TCR_4(a) (a)
1140#define TCW_4(a, b) (a) = (b)
1141#define TCI_4(a) (++(a))
1142#define TCD_4(a) (--(a))
1143#define TCR_8(a) (a)
1144#define TCW_8(a, b) (a) = (b)
1145#define TCI_8(a) (++(a))
1146#define TCD_8(a) (--(a))
1147#define TCR_SYNC_4(a) (a)
1148#define TCW_SYNC_4(a, b) (a) = (b)
1149#define TCX_SYNC_4(a, b, c) \
1150 KMP_COMPARE_AND_STORE_REL32((volatile kmp_int32 *)(volatile void *)&(a), \
1151 (kmp_int32)(b), (kmp_int32)(c))
1152#define TCR_SYNC_8(a) (a)
1153#define TCW_SYNC_8(a, b) (a) = (b)
1154#define TCX_SYNC_8(a, b, c) \
1155 KMP_COMPARE_AND_STORE_REL64((volatile kmp_int64 *)(volatile void *)&(a), \
1156 (kmp_int64)(b), (kmp_int64)(c))
1157
1158#if KMP_ARCH_X86 || KMP_ARCH_MIPS || KMP_ARCH_WASM || KMP_ARCH_PPC
1159// What about ARM?
1160#define TCR_PTR(a) ((void *)TCR_4(a))
1161#define TCW_PTR(a, b) TCW_4((a), (b))
1162#define TCR_SYNC_PTR(a) ((void *)TCR_SYNC_4(a))
1163#define TCW_SYNC_PTR(a, b) TCW_SYNC_4((a), (b))
1164#define TCX_SYNC_PTR(a, b, c) ((void *)TCX_SYNC_4((a), (b), (c)))
1165
1166#else /* 64 bit pointers */
1167
1168#define TCR_PTR(a) ((void *)TCR_8(a))
1169#define TCW_PTR(a, b) TCW_8((a), (b))
1170#define TCR_SYNC_PTR(a) ((void *)TCR_SYNC_8(a))
1171#define TCW_SYNC_PTR(a, b) TCW_SYNC_8((a), (b))
1172#define TCX_SYNC_PTR(a, b, c) ((void *)TCX_SYNC_8((a), (b), (c)))
1173
1174#endif /* KMP_ARCH_X86 */
1175
1176/* If these FTN_{TRUE,FALSE} values change, may need to change several places
1177 where they are used to check that language is Fortran, not C. */
1178
1179#ifndef FTN_TRUE
1180#define FTN_TRUE TRUE
1181#endif
1182
1183#ifndef FTN_FALSE
1184#define FTN_FALSE FALSE
1185#endif
1186
1187typedef void (*microtask_t)(int *gtid, int *npr, ...);
1188
1189#ifdef USE_VOLATILE_CAST
1190#define VOLATILE_CAST(x) (volatile x)
1191#else
1192#define VOLATILE_CAST(x) (x)
1193#endif
1194
1195#define KMP_WAIT __kmp_wait_4
1196#define KMP_WAIT_PTR __kmp_wait_4_ptr
1197#define KMP_EQ __kmp_eq_4
1198#define KMP_NEQ __kmp_neq_4
1199#define KMP_LT __kmp_lt_4
1200#define KMP_GE __kmp_ge_4
1201#define KMP_LE __kmp_le_4
1202
1203/* Workaround for Intel(R) 64 code gen bug when taking address of static array
1204 * (Intel(R) 64 Tracker #138) */
1205#if (KMP_ARCH_X86_64 || KMP_ARCH_PPC64) && KMP_OS_LINUX
1206#define STATIC_EFI2_WORKAROUND
1207#else
1208#define STATIC_EFI2_WORKAROUND static
1209#endif
1210
1211// Support of BGET usage
1212#ifndef KMP_USE_BGET
1213#define KMP_USE_BGET 1
1214#endif
1215
1216// Switches for OSS builds
1217#ifndef USE_CMPXCHG_FIX
1218#define USE_CMPXCHG_FIX 1
1219#endif
1220
1221// Enable dynamic user lock
1222#define KMP_USE_DYNAMIC_LOCK 1
1223
1224// Enable Intel(R) Transactional Synchronization Extensions (Intel(R) TSX) if
1225// dynamic user lock is turned on
1226#if KMP_USE_DYNAMIC_LOCK
1227// Visual studio can't handle the asm sections in this code
1228#define KMP_USE_TSX (KMP_ARCH_X86 || KMP_ARCH_X86_64) && !KMP_COMPILER_MSVC
1229#ifdef KMP_USE_ADAPTIVE_LOCKS
1230#undef KMP_USE_ADAPTIVE_LOCKS
1231#endif
1232#define KMP_USE_ADAPTIVE_LOCKS KMP_USE_TSX
1233#endif
1234
1235// Enable tick time conversion of ticks to seconds
1236#if KMP_STATS_ENABLED
1237#define KMP_HAVE_TICK_TIME \
1238 (KMP_OS_LINUX && (KMP_MIC || KMP_ARCH_X86 || KMP_ARCH_X86_64))
1239#endif
1240
1241// Warning levels
1242enum kmp_warnings_level {
1243 kmp_warnings_off = 0, /* No warnings */
1244 kmp_warnings_low, /* Minimal warnings (default) */
1245 kmp_warnings_explicit = 6, /* Explicitly set to ON - more warnings */
1246 kmp_warnings_verbose /* reserved */
1247};
1248
1249#ifdef __cplusplus
1250} // extern "C"
1251#endif // __cplusplus
1252
1253// Safe C API
1254#include "kmp_safe_c_api.h"
1255
1256// Macros for C++11 atomic functions
1257#define KMP_ATOMIC_LD(p, order) (p)->load(std::memory_order_##order)
1258#define KMP_ATOMIC_OP(op, p, v, order) (p)->op(v, std::memory_order_##order)
1259
1260// For non-default load/store
1261#define KMP_ATOMIC_LD_ACQ(p) KMP_ATOMIC_LD(p, acquire)
1262#define KMP_ATOMIC_LD_RLX(p) KMP_ATOMIC_LD(p, relaxed)
1263#define KMP_ATOMIC_ST_REL(p, v) KMP_ATOMIC_OP(store, p, v, release)
1264#define KMP_ATOMIC_ST_RLX(p, v) KMP_ATOMIC_OP(store, p, v, relaxed)
1265
1266// For non-default fetch_<op>
1267#define KMP_ATOMIC_ADD(p, v) KMP_ATOMIC_OP(fetch_add, p, v, acq_rel)
1268#define KMP_ATOMIC_SUB(p, v) KMP_ATOMIC_OP(fetch_sub, p, v, acq_rel)
1269#define KMP_ATOMIC_AND(p, v) KMP_ATOMIC_OP(fetch_and, p, v, acq_rel)
1270#define KMP_ATOMIC_OR(p, v) KMP_ATOMIC_OP(fetch_or, p, v, acq_rel)
1271#define KMP_ATOMIC_INC(p) KMP_ATOMIC_OP(fetch_add, p, 1, acq_rel)
1272#define KMP_ATOMIC_DEC(p) KMP_ATOMIC_OP(fetch_sub, p, 1, acq_rel)
1273#define KMP_ATOMIC_ADD_RLX(p, v) KMP_ATOMIC_OP(fetch_add, p, v, relaxed)
1274#define KMP_ATOMIC_INC_RLX(p) KMP_ATOMIC_OP(fetch_add, p, 1, relaxed)
1275
1276// Callers of the following functions cannot see the side effect on "expected".
1277template <typename T>
1278bool __kmp_atomic_compare_store(std::atomic<T> *p, T expected, T desired) {
1279 return p->compare_exchange_strong(
1280 expected, desired, std::memory_order_acq_rel, std::memory_order_relaxed);
1281}
1282
1283template <typename T>
1284bool __kmp_atomic_compare_store_acq(std::atomic<T> *p, T expected, T desired) {
1285 return p->compare_exchange_strong(
1286 expected, desired, std::memory_order_acquire, std::memory_order_relaxed);
1287}
1288
1289template <typename T>
1290bool __kmp_atomic_compare_store_rel(std::atomic<T> *p, T expected, T desired) {
1291 return p->compare_exchange_strong(
1292 expected, desired, std::memory_order_release, std::memory_order_relaxed);
1293}
1294
1295// Symbol lookup on Linux/Windows
1296#if KMP_OS_WINDOWS
1297extern void *__kmp_lookup_symbol(const char *name, bool next = false);
1298#define KMP_DLSYM(name) __kmp_lookup_symbol(name)
1299#define KMP_DLSYM_NEXT(name) __kmp_lookup_symbol(name, true)
1300#elif KMP_OS_WASI || KMP_OS_EMSCRIPTEN
1301#define KMP_DLSYM(name) nullptr
1302#define KMP_DLSYM_NEXT(name) nullptr
1303#else
1304#define KMP_DLSYM(name) dlsym(RTLD_DEFAULT, name)
1305#define KMP_DLSYM_NEXT(name) dlsym(RTLD_NEXT, name)
1306#endif
1307
1308// MSVC doesn't have this, but clang/clang-cl does.
1309#ifndef __has_builtin
1310#define __has_builtin(x) 0
1311#endif
1312
1313// Same as LLVM_BUILTIN_UNREACHABLE. States that it is UB to reach this point.
1314#if __has_builtin(__builtin_unreachable) || defined(__GNUC__)
1315#define KMP_BUILTIN_UNREACHABLE __builtin_unreachable()
1316#elif defined(_MSC_VER)
1317#define KMP_BUILTIN_UNREACHABLE __assume(false)
1318#else
1319#define KMP_BUILTIN_UNREACHABLE
1320#endif
1321
1322#endif /* KMP_OS_H */
Generated by doxygen 1.15.0