Raven Core  3.0.0
P2P Digital Currency
threadsafety.h
Go to the documentation of this file.
1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2014 The Bitcoin Core developers
3 // Copyright (c) 2017-2019 The Raven Core developers
4 // Distributed under the MIT software license, see the accompanying
5 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
6 
7 #ifndef RAVEN_THREADSAFETY_H
8 #define RAVEN_THREADSAFETY_H
9 
10 #ifdef __clang__
11 // TL;DR Add GUARDED_BY(mutex) to member variables. The others are
12 // rarely necessary. Ex: int nFoo GUARDED_BY(cs_foo);
13 //
14 // See http://clang.llvm.org/docs/LanguageExtensions.html#threadsafety
15 // for documentation. The clang compiler can do advanced static analysis
16 // of locking when given the -Wthread-safety option.
17 #define LOCKABLE __attribute__((lockable))
18 #define SCOPED_LOCKABLE __attribute__((scoped_lockable))
19 #define GUARDED_BY(x) __attribute__((guarded_by(x)))
20 #define GUARDED_VAR __attribute__((guarded_var))
21 #define PT_GUARDED_BY(x) __attribute__((pt_guarded_by(x)))
22 #define PT_GUARDED_VAR __attribute__((pt_guarded_var))
23 #define ACQUIRED_AFTER(...) __attribute__((acquired_after(__VA_ARGS__)))
24 #define ACQUIRED_BEFORE(...) __attribute__((acquired_before(__VA_ARGS__)))
25 #define EXCLUSIVE_LOCK_FUNCTION(...) __attribute__((exclusive_lock_function(__VA_ARGS__)))
26 #define SHARED_LOCK_FUNCTION(...) __attribute__((shared_lock_function(__VA_ARGS__)))
27 #define EXCLUSIVE_TRYLOCK_FUNCTION(...) __attribute__((exclusive_trylock_function(__VA_ARGS__)))
28 #define SHARED_TRYLOCK_FUNCTION(...) __attribute__((shared_trylock_function(__VA_ARGS__)))
29 #define UNLOCK_FUNCTION(...) __attribute__((unlock_function(__VA_ARGS__)))
30 #define LOCK_RETURNED(x) __attribute__((lock_returned(x)))
31 #define LOCKS_EXCLUDED(...) __attribute__((locks_excluded(__VA_ARGS__)))
32 #define EXCLUSIVE_LOCKS_REQUIRED(...) __attribute__((exclusive_locks_required(__VA_ARGS__)))
33 #define SHARED_LOCKS_REQUIRED(...) __attribute__((shared_locks_required(__VA_ARGS__)))
34 #define NO_THREAD_SAFETY_ANALYSIS __attribute__((no_thread_safety_analysis))
35 #else
36 #define LOCKABLE
37 #define SCOPED_LOCKABLE
38 #define GUARDED_BY(x)
39 #define GUARDED_VAR
40 #define PT_GUARDED_BY(x)
41 #define PT_GUARDED_VAR
42 #define ACQUIRED_AFTER(...)
43 #define ACQUIRED_BEFORE(...)
44 #define EXCLUSIVE_LOCK_FUNCTION(...)
45 #define SHARED_LOCK_FUNCTION(...)
46 #define EXCLUSIVE_TRYLOCK_FUNCTION(...)
47 #define SHARED_TRYLOCK_FUNCTION(...)
48 #define UNLOCK_FUNCTION(...)
49 #define LOCK_RETURNED(x)
50 #define LOCKS_EXCLUDED(...)
51 #define EXCLUSIVE_LOCKS_REQUIRED(...)
52 #define SHARED_LOCKS_REQUIRED(...)
53 #define NO_THREAD_SAFETY_ANALYSIS
54 #endif // __GNUC__
55 
56 #endif // RAVEN_THREADSAFETY_H