summaryrefslogtreecommitdiffstats
path: root/clang/docs/ThreadSanitizer.rst
diff options
context:
space:
mode:
authorKostya Serebryany <kcc@google.com>2013-02-26 06:58:27 +0000
committerKostya Serebryany <kcc@google.com>2013-02-26 06:58:27 +0000
commit4c0fc9931e5af027bee100a26062fe40283727ee (patch)
treeecf1ed318b3f90b425b5dd7c66ce8a68d61ad862 /clang/docs/ThreadSanitizer.rst
parentcf880b94434ddfcba2d5c7b0deb588591b0d8a08 (diff)
downloadbcm5719-llvm-4c0fc9931e5af027bee100a26062fe40283727ee.tar.gz
bcm5719-llvm-4c0fc9931e5af027bee100a26062fe40283727ee.zip
Unify clang/llvm attributes for asan/tsan/msan (Clang part)
These are two related changes (one in llvm, one in clang). LLVM: - rename address_safety => sanitize_address (the enum value is the same, so we preserve binary compatibility with old bitcode) - rename thread_safety => sanitize_thread - rename no_uninitialized_checks -> sanitize_memory CLANG: - add __attribute__((no_sanitize_address)) as a synonym for __attribute__((no_address_safety_analysis)) - add __attribute__((no_sanitize_thread)) - add __attribute__((no_sanitize_memory)) for S in address thread memory If -fsanitize=S is present and __attribute__((no_sanitize_S)) is not set llvm attribute sanitize_S llvm-svn: 176076
Diffstat (limited to 'clang/docs/ThreadSanitizer.rst')
-rw-r--r--clang/docs/ThreadSanitizer.rst17
1 files changed, 16 insertions, 1 deletions
diff --git a/clang/docs/ThreadSanitizer.rst b/clang/docs/ThreadSanitizer.rst
index a7f6eb782b5..c0c576b44a5 100644
--- a/clang/docs/ThreadSanitizer.rst
+++ b/clang/docs/ThreadSanitizer.rst
@@ -78,10 +78,25 @@ this purpose.
.. code-block:: c
- #if defined(__has_feature) && __has_feature(thread_sanitizer)
+ #if defined(__has_feature)
+ # if __has_feature(thread_sanitizer)
// code that builds only under ThreadSanitizer
+ # endif
#endif
+``__attribute__((no_sanitize_thread))``
+-----------------------------------------------
+
+Some code should not be instrumented by ThreadSanitizer.
+One may use the function attribute
+:ref:`no_sanitize_thread <langext-thread_sanitizer>`
+to disable instrumentation of plain (non-atomic) loads/stores in a particular function.
+ThreadSanitizer may still instrument such functions to avoid false positives.
+This attribute may not be
+supported by other compilers, so we suggest to use it together with
+``__has_feature(thread_sanitizer)``. Note: currently, this attribute will be
+lost if the function is inlined.
+
Limitations
-----------
OpenPOWER on IntegriCloud