2018-12-05 12:29:49 +03:00
|
|
|
/*
|
2019-05-29 14:32:35 +03:00
|
|
|
* Copyright 2013-present Facebook, Inc.
|
2018-12-05 12:29:49 +03:00
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
/* These definitions are in a separate file so that they
|
|
|
|
* may be included from C- as well as C++-based projects. */
|
|
|
|
|
2019-05-29 14:32:35 +03:00
|
|
|
#include <folly/portability/Config.h>
|
|
|
|
|
2018-12-05 12:29:49 +03:00
|
|
|
/**
|
|
|
|
* Portable version check.
|
|
|
|
*/
|
|
|
|
#ifndef __GNUC_PREREQ
|
2019-05-29 14:32:35 +03:00
|
|
|
#if defined __GNUC__ && defined __GNUC_MINOR__
|
2018-12-05 12:29:49 +03:00
|
|
|
/* nolint */
|
2019-05-29 14:32:35 +03:00
|
|
|
#define __GNUC_PREREQ(maj, min) \
|
|
|
|
((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
|
|
|
|
#else
|
2018-12-05 12:29:49 +03:00
|
|
|
/* nolint */
|
2019-05-29 14:32:35 +03:00
|
|
|
#define __GNUC_PREREQ(maj, min) 0
|
|
|
|
#endif
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
|
|
|
|
2019-05-29 14:32:35 +03:00
|
|
|
// portable version check for clang
|
|
|
|
#ifndef __CLANG_PREREQ
|
|
|
|
#if defined __clang__ && defined __clang_major__ && defined __clang_minor__
|
|
|
|
/* nolint */
|
|
|
|
#define __CLANG_PREREQ(maj, min) \
|
|
|
|
((__clang_major__ << 16) + __clang_minor__ >= ((maj) << 16) + (min))
|
|
|
|
#else
|
|
|
|
/* nolint */
|
|
|
|
#define __CLANG_PREREQ(maj, min) 0
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(__has_builtin)
|
|
|
|
#define FOLLY_HAS_BUILTIN(...) __has_builtin(__VA_ARGS__)
|
|
|
|
#else
|
|
|
|
#define FOLLY_HAS_BUILTIN(...) 0
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(__has_feature)
|
|
|
|
#define FOLLY_HAS_FEATURE(...) __has_feature(__VA_ARGS__)
|
|
|
|
#else
|
|
|
|
#define FOLLY_HAS_FEATURE(...) 0
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* FOLLY_SANITIZE_ADDRESS is defined to 1 if the current compilation unit
|
|
|
|
* is being compiled with ASAN enabled.
|
|
|
|
*
|
|
|
|
* Beware when using this macro in a header file: this macro may change values
|
|
|
|
* across compilation units if some libraries are built with ASAN enabled
|
|
|
|
* and some built with ASAN disabled. For instance, this may occur, if folly
|
|
|
|
* itself was compiled without ASAN but a downstream project that uses folly is
|
|
|
|
* compiling with ASAN enabled.
|
|
|
|
*
|
|
|
|
* Use FOLLY_ASAN_ENABLED (defined in folly-config.h) to check if folly itself
|
|
|
|
* was compiled with ASAN enabled.
|
|
|
|
*/
|
|
|
|
#if FOLLY_HAS_FEATURE(address_sanitizer) || __SANITIZE_ADDRESS__
|
|
|
|
#define FOLLY_SANITIZE_ADDRESS 1
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Define attribute wrapper for function attribute used to disable
|
|
|
|
* address sanitizer instrumentation. Unfortunately, this attribute
|
|
|
|
* has issues when inlining is used, so disable that as well. */
|
|
|
|
#ifdef FOLLY_SANITIZE_ADDRESS
|
2019-05-29 14:32:35 +03:00
|
|
|
#if defined(__clang__)
|
|
|
|
#if __has_attribute(__no_sanitize__)
|
|
|
|
#define FOLLY_DISABLE_ADDRESS_SANITIZER \
|
|
|
|
__attribute__((__no_sanitize__("address"), __noinline__))
|
|
|
|
#elif __has_attribute(__no_address_safety_analysis__)
|
|
|
|
#define FOLLY_DISABLE_ADDRESS_SANITIZER \
|
|
|
|
__attribute__((__no_address_safety_analysis__, __noinline__))
|
|
|
|
#elif __has_attribute(__no_sanitize_address__)
|
|
|
|
#define FOLLY_DISABLE_ADDRESS_SANITIZER \
|
|
|
|
__attribute__((__no_sanitize_address__, __noinline__))
|
|
|
|
#endif
|
|
|
|
#elif defined(__GNUC__)
|
|
|
|
#define FOLLY_DISABLE_ADDRESS_SANITIZER \
|
|
|
|
__attribute__((__no_address_safety_analysis__, __noinline__))
|
|
|
|
#endif
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
|
|
|
#ifndef FOLLY_DISABLE_ADDRESS_SANITIZER
|
2019-05-29 14:32:35 +03:00
|
|
|
#define FOLLY_DISABLE_ADDRESS_SANITIZER
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Define a convenience macro to test when thread sanitizer is being used
|
|
|
|
* across the different compilers (e.g. clang, gcc) */
|
2019-05-29 14:32:35 +03:00
|
|
|
#if FOLLY_HAS_FEATURE(thread_sanitizer) || __SANITIZE_THREAD__
|
|
|
|
#define FOLLY_SANITIZE_THREAD 1
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/**
|
2019-05-29 14:32:35 +03:00
|
|
|
* Define a convenience macro to test when ASAN, UBSAN or TSAN sanitizer are
|
|
|
|
* being used
|
2018-12-05 12:29:49 +03:00
|
|
|
*/
|
2019-05-29 14:32:35 +03:00
|
|
|
#if defined(FOLLY_SANITIZE_ADDRESS) || defined(FOLLY_SANITIZE_THREAD)
|
|
|
|
#define FOLLY_SANITIZE 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if FOLLY_SANITIZE
|
|
|
|
#define FOLLY_DISABLE_UNDEFINED_BEHAVIOR_SANITIZER(...) \
|
|
|
|
__attribute__((no_sanitize(__VA_ARGS__)))
|
2018-12-05 12:29:49 +03:00
|
|
|
#else
|
2019-05-29 14:32:35 +03:00
|
|
|
#define FOLLY_DISABLE_UNDEFINED_BEHAVIOR_SANITIZER(...)
|
|
|
|
#endif // FOLLY_SANITIZE
|
2018-12-05 12:29:49 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Macro for marking functions as having public visibility.
|
|
|
|
*/
|
|
|
|
#if defined(__GNUC__)
|
2019-05-29 14:32:35 +03:00
|
|
|
#if __GNUC_PREREQ(4, 9)
|
|
|
|
#define FOLLY_EXPORT [[gnu::visibility("default")]]
|
|
|
|
#else
|
|
|
|
#define FOLLY_EXPORT __attribute__((__visibility__("default")))
|
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#define FOLLY_EXPORT
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// noinline
|
|
|
|
#ifdef _MSC_VER
|
|
|
|
#define FOLLY_NOINLINE __declspec(noinline)
|
|
|
|
#elif defined(__clang__) || defined(__GNUC__)
|
|
|
|
#define FOLLY_NOINLINE __attribute__((__noinline__))
|
2018-12-05 12:29:49 +03:00
|
|
|
#else
|
2019-05-29 14:32:35 +03:00
|
|
|
#define FOLLY_NOINLINE
|
2018-12-05 12:29:49 +03:00
|
|
|
#endif
|
2019-05-29 14:32:35 +03:00
|
|
|
|
|
|
|
// always inline
|
|
|
|
#ifdef _MSC_VER
|
|
|
|
#define FOLLY_ALWAYS_INLINE __forceinline
|
|
|
|
#elif defined(__clang__) || defined(__GNUC__)
|
|
|
|
#define FOLLY_ALWAYS_INLINE inline __attribute__((__always_inline__))
|
|
|
|
#else
|
|
|
|
#define FOLLY_ALWAYS_INLINE inline
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// attribute hidden
|
|
|
|
#if _MSC_VER
|
|
|
|
#define FOLLY_ATTR_VISIBILITY_HIDDEN
|
|
|
|
#elif defined(__clang__) || defined(__GNUC__)
|
|
|
|
#define FOLLY_ATTR_VISIBILITY_HIDDEN __attribute__((__visibility__("hidden")))
|
|
|
|
#else
|
|
|
|
#define FOLLY_ATTR_VISIBILITY_HIDDEN
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// An attribute for marking symbols as weak, if supported
|
|
|
|
#if FOLLY_HAVE_WEAK_SYMBOLS
|
|
|
|
#define FOLLY_ATTR_WEAK __attribute__((__weak__))
|
|
|
|
#else
|
|
|
|
#define FOLLY_ATTR_WEAK
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// Microsoft ABI version (can be overridden manually if necessary)
|
|
|
|
#ifndef FOLLY_MICROSOFT_ABI_VER
|
|
|
|
#ifdef _MSC_VER
|
|
|
|
#define FOLLY_MICROSOFT_ABI_VER _MSC_VER
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// These functions are defined by the TSAN runtime library and enable
|
|
|
|
// annotating mutexes for TSAN.
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void
|
|
|
|
AnnotateRWLockCreate(const char* f, int l, const volatile void* addr);
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void
|
|
|
|
AnnotateRWLockCreateStatic(const char* f, int l, const volatile void* addr);
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void
|
|
|
|
AnnotateRWLockDestroy(const char* f, int l, const volatile void* addr);
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void
|
|
|
|
AnnotateRWLockAcquired(const char* f, int l, const volatile void* addr, long w);
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void
|
|
|
|
AnnotateRWLockReleased(const char* f, int l, const volatile void* addr, long w);
|
|
|
|
extern "C" FOLLY_ATTR_WEAK void AnnotateBenignRaceSized(
|
|
|
|
const char* f,
|
|
|
|
int l,
|
|
|
|
const volatile void* addr,
|
|
|
|
long size,
|
|
|
|
const char* desc);
|