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 |