| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (C) 2011 Google Inc. All rights reserved. | 2 * Copyright (C) 2011 Google Inc. All rights reserved. |
| 3 * | 3 * |
| 4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
| 5 * modification, are permitted provided that the following conditions are | 5 * modification, are permitted provided that the following conditions are |
| 6 * met: | 6 * met: |
| 7 * | 7 * |
| 8 * * Redistributions of source code must retain the above copyright | 8 * * Redistributions of source code must retain the above copyright |
| 9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
| 10 * * Neither the name of Google Inc. nor the names of its | 10 * * Neither the name of Google Inc. nor the names of its |
| (...skipping 27 matching lines...) Expand all Loading... |
| 38 * By using dynamic annotations a developer can give more details to the dynamic | 38 * By using dynamic annotations a developer can give more details to the dynamic |
| 39 * analysis tool to improve its precision. | 39 * analysis tool to improve its precision. |
| 40 * | 40 * |
| 41 * In C/C++ program the annotations are represented as C macros. | 41 * In C/C++ program the annotations are represented as C macros. |
| 42 * With the default build flags, these macros are empty, hence don't affect | 42 * With the default build flags, these macros are empty, hence don't affect |
| 43 * performance of a compiled binary. | 43 * performance of a compiled binary. |
| 44 * If dynamic annotations are enabled, they just call no-op functions. | 44 * If dynamic annotations are enabled, they just call no-op functions. |
| 45 * The dynamic analysis tools can intercept these functions and replace them | 45 * The dynamic analysis tools can intercept these functions and replace them |
| 46 * with their own implementations. | 46 * with their own implementations. |
| 47 * | 47 * |
| 48 * See http://code.google.com/p/data-race-test/wiki/DynamicAnnotations for more
information. | 48 * See http://code.google.com/p/data-race-test/wiki/DynamicAnnotations for more |
| 49 * information. |
| 49 */ | 50 */ |
| 50 | 51 |
| 51 #include "wtf/WTFExport.h" | 52 #include "wtf/WTFExport.h" |
| 52 #include "wtf/build_config.h" | 53 #include "wtf/build_config.h" |
| 53 | 54 |
| 54 #if USE(DYNAMIC_ANNOTATIONS) | 55 #if USE(DYNAMIC_ANNOTATIONS) |
| 55 /* Tell data race detector that we're not interested in reports on the given add
ress range. */ | 56 /* Tell data race detector that we're not interested in reports on the given |
| 57 * address range. */ |
| 56 #define WTF_ANNOTATE_BENIGN_RACE_SIZED(address, size, description) \ | 58 #define WTF_ANNOTATE_BENIGN_RACE_SIZED(address, size, description) \ |
| 57 WTFAnnotateBenignRaceSized(__FILE__, __LINE__, address, size, description) | 59 WTFAnnotateBenignRaceSized(__FILE__, __LINE__, address, size, description) |
| 58 #define WTF_ANNOTATE_BENIGN_RACE(pointer, description) \ | 60 #define WTF_ANNOTATE_BENIGN_RACE(pointer, description) \ |
| 59 WTFAnnotateBenignRaceSized(__FILE__, __LINE__, pointer, sizeof(*(pointer)), \ | 61 WTFAnnotateBenignRaceSized(__FILE__, __LINE__, pointer, sizeof(*(pointer)), \ |
| 60 description) | 62 description) |
| 61 | 63 |
| 62 /* Annotations for user-defined synchronization mechanisms. | 64 /* Annotations for user-defined synchronization mechanisms. |
| 63 * These annotations can be used to define happens-before arcs in user-defined | 65 * These annotations can be used to define happens-before arcs in user-defined |
| 64 * synchronization mechanisms: the race detector will infer an arc from | 66 * synchronization mechanisms: the race detector will infer an arc from |
| 65 * the former to the latter when they share the same argument pointer. | 67 * the former to the latter when they share the same argument pointer. |
| (...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 103 #else // USE(DYNAMIC_ANNOTATIONS) | 105 #else // USE(DYNAMIC_ANNOTATIONS) |
| 104 /* These macros are empty when dynamic annotations are not enabled so you can | 106 /* These macros are empty when dynamic annotations are not enabled so you can |
| 105 * use them without affecting the performance of release binaries. */ | 107 * use them without affecting the performance of release binaries. */ |
| 106 #define WTF_ANNOTATE_BENIGN_RACE_SIZED(address, size, description) | 108 #define WTF_ANNOTATE_BENIGN_RACE_SIZED(address, size, description) |
| 107 #define WTF_ANNOTATE_BENIGN_RACE(pointer, description) | 109 #define WTF_ANNOTATE_BENIGN_RACE(pointer, description) |
| 108 #define WTF_ANNOTATE_HAPPENS_BEFORE(address) | 110 #define WTF_ANNOTATE_HAPPENS_BEFORE(address) |
| 109 #define WTF_ANNOTATE_HAPPENS_AFTER(address) | 111 #define WTF_ANNOTATE_HAPPENS_AFTER(address) |
| 110 #endif // USE(DYNAMIC_ANNOTATIONS) | 112 #endif // USE(DYNAMIC_ANNOTATIONS) |
| 111 | 113 |
| 112 #endif // WTF_DynamicAnnotations_h | 114 #endif // WTF_DynamicAnnotations_h |
| OLD | NEW |