FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
cpython/Include/dynamic_annotations.h at 3.5 · python/cpython · GitHub
python
cpython
Repository navigation
Code
Issues
5k+
(5k+)
Pull requests
2.4k
(2.4k)
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
cpython
/
Include
/
dynamic_annotations.h
Copy path
More file actions
More file actions
Latest commit
History
History
History
499 lines (423 loc) · 21.9 KB
Breadcrumbs
cpython
/
Include
/
dynamic_annotations.h
Copy path
File metadata and controls
499 lines (423 loc) · 21.9 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
/*
Copyright (c) 2008-2009, Google Inc.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Neither the name of Google Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* ---
* Author: Kostya Serebryany
* Copied to CPython by Jeffrey Yasskin, with all macros renamed to
* start with _Py_ to avoid colliding with users embedding Python, and
* with deprecated macros removed.
*/
/*
This file defines dynamic annotations for use with dynamic analysis
tool such as valgrind, PIN, etc.
Dynamic annotation is a source code annotation that affects
the generated code (that is, the annotation is not a comment).
Each such annotation is attached to a particular
instruction and/or to a particular object (address) in the program.
The annotations that should be used by users are macros in all upper-case
(e.g., _Py_ANNOTATE_NEW_MEMORY).
Actual implementation of these macros may differ depending on the
dynamic analysis tool being used.
See http://code.google.com/p/data-race-test/ for more information.
This file supports the following dynamic analysis tools:
- None (DYNAMIC_ANNOTATIONS_ENABLED is not defined or zero).
Macros are defined empty.
- ThreadSanitizer, Helgrind, DRD (DYNAMIC_ANNOTATIONS_ENABLED is 1).
Macros are defined as calls to non-inlinable empty functions
that are intercepted by Valgrind.
*/
#
ifndef
__DYNAMIC_ANNOTATIONS_H__
#
define
__DYNAMIC_ANNOTATIONS_H__
#
ifndef
DYNAMIC_ANNOTATIONS_ENABLED
#
define
DYNAMIC_ANNOTATIONS_ENABLED
0
#
endif
#
if
DYNAMIC_ANNOTATIONS_ENABLED != 0
/*
-------------------------------------------------------------
Annotations useful when implementing condition variables such as CondVar,
using conditional critical sections (Await/LockWhen) and when constructing
user-defined synchronization mechanisms.
The annotations _Py_ANNOTATE_HAPPENS_BEFORE() and
_Py_ANNOTATE_HAPPENS_AFTER() can be used to define happens-before arcs in
user-defined synchronization mechanisms: the race detector will infer an
arc from the former to the latter when they share the same argument
pointer.
Example 1 (reference counting):
void Unref() {
_Py_ANNOTATE_HAPPENS_BEFORE(&refcount_);
if (AtomicDecrementByOne(&refcount_) == 0) {
_Py_ANNOTATE_HAPPENS_AFTER(&refcount_);
delete this;
}
}
Example 2 (message queue):
void MyQueue::Put(Type *e) {
MutexLock lock(&mu_);
_Py_ANNOTATE_HAPPENS_BEFORE(e);
PutElementIntoMyQueue(e);
}
Type *MyQueue::Get() {
MutexLock lock(&mu_);
Type *e = GetElementFromMyQueue();
_Py_ANNOTATE_HAPPENS_AFTER(e);
return e;
}
Note: when possible, please use the existing reference counting and message
queue implementations instead of inventing new ones.
*/
/*
Report that wait on the condition variable at address "cv" has succeeded
and the lock at address "lock" is held.
*/
#
define
_Py_ANNOTATE_CONDVAR_LOCK_WAIT
(
cv, lock
) \
AnnotateCondVarWait
(__FILE__, __LINE__, cv, lock)
/*
Report that wait on the condition variable at "cv" has succeeded. Variant
w/o lock.
*/
#
define
_Py_ANNOTATE_CONDVAR_WAIT
(
cv
) \
AnnotateCondVarWait
(__FILE__, __LINE__, cv,
NULL
)
/*
Report that we are about to signal on the condition variable at address
"cv".
*/
#
define
_Py_ANNOTATE_CONDVAR_SIGNAL
(
cv
) \
AnnotateCondVarSignal
(__FILE__, __LINE__, cv)
/*
Report that we are about to signal_all on the condition variable at "cv".
*/
#
define
_Py_ANNOTATE_CONDVAR_SIGNAL_ALL
(
cv
) \
AnnotateCondVarSignalAll
(__FILE__, __LINE__, cv)
/*
Annotations for user-defined synchronization mechanisms.
*/
#
define
_Py_ANNOTATE_HAPPENS_BEFORE
(
obj
) _Py_ANNOTATE_CONDVAR_SIGNAL(obj)
#
define
_Py_ANNOTATE_HAPPENS_AFTER
(
obj
) _Py_ANNOTATE_CONDVAR_WAIT(obj)
/*
Report that the bytes in the range [pointer, pointer+size) are about
to be published safely. The race checker will create a happens-before
arc from the call _Py_ANNOTATE_PUBLISH_MEMORY_RANGE(pointer, size) to
subsequent accesses to this memory.
Note: this annotation may not work properly if the race detector uses
sampling, i.e. does not observe all memory accesses.
*/
#
define
_Py_ANNOTATE_PUBLISH_MEMORY_RANGE
(
pointer, size
) \
AnnotatePublishMemoryRange
(__FILE__, __LINE__, pointer, size)
/*
Instruct the tool to create a happens-before arc between mu->Unlock() and
mu->Lock(). This annotation may slow down the race detector and hide real
races. Normally it is used only when it would be difficult to annotate each
of the mutex's critical sections individually using the annotations above.
This annotation makes sense only for hybrid race detectors. For pure
happens-before detectors this is a no-op. For more details see
http://code.google.com/p/data-race-test/wiki/PureHappensBeforeVsHybrid .
*/
#
define
_Py_ANNOTATE_PURE_HAPPENS_BEFORE_MUTEX
(
mu
) \
AnnotateMutexIsUsedAsCondVar
(__FILE__, __LINE__, mu)
/*
-------------------------------------------------------------
Annotations useful when defining memory allocators, or when memory that
was protected in one way starts to be protected in another.
*/
/*
Report that a new memory at "address" of size "size" has been allocated.
This might be used when the memory has been retrieved from a free list and
is about to be reused, or when the locking discipline for a variable
changes.
*/
#
define
_Py_ANNOTATE_NEW_MEMORY
(
address, size
) \
AnnotateNewMemory
(__FILE__, __LINE__, address, size)
/*
-------------------------------------------------------------
Annotations useful when defining FIFO queues that transfer data between
threads.
*/
/*
Report that the producer-consumer queue (such as ProducerConsumerQueue) at
address "pcq" has been created. The _Py_ANNOTATE_PCQ_* annotations should
be used only for FIFO queues. For non-FIFO queues use
_Py_ANNOTATE_HAPPENS_BEFORE (for put) and _Py_ANNOTATE_HAPPENS_AFTER (for
get).
*/
#
define
_Py_ANNOTATE_PCQ_CREATE
(
pcq
) \
AnnotatePCQCreate
(__FILE__, __LINE__, pcq)
/*
Report that the queue at address "pcq" is about to be destroyed.
*/
#
define
_Py_ANNOTATE_PCQ_DESTROY
(
pcq
) \
AnnotatePCQDestroy
(__FILE__, __LINE__, pcq)
/*
Report that we are about to put an element into a FIFO queue at address
"pcq".
*/
#
define
_Py_ANNOTATE_PCQ_PUT
(
pcq
) \
AnnotatePCQPut
(__FILE__, __LINE__, pcq)
/*
Report that we've just got an element from a FIFO queue at address "pcq".
*/
#
define
_Py_ANNOTATE_PCQ_GET
(
pcq
) \
AnnotatePCQGet
(__FILE__, __LINE__, pcq)
/*
-------------------------------------------------------------
Annotations that suppress errors. It is usually better to express the
program's synchronization using the other annotations, but these can
be used when all else fails.
*/
/*
Report that we may have a benign race at "pointer", with size
"sizeof(*(pointer))". "pointer" must be a non-void* pointer. Insert at the
point where "pointer" has been allocated, preferably close to the point
where the race happens. See also _Py_ANNOTATE_BENIGN_RACE_STATIC.
*/
#
define
_Py_ANNOTATE_BENIGN_RACE
(
pointer, description
) \
AnnotateBenignRaceSized
(__FILE__, __LINE__, pointer, \
sizeof
(*(pointer)), description)
/*
Same as _Py_ANNOTATE_BENIGN_RACE(address, description), but applies to
the memory range [address, address+size).
*/
#
define
_Py_ANNOTATE_BENIGN_RACE_SIZED
(
address, size, description
) \
AnnotateBenignRaceSized
(__FILE__, __LINE__, address, size, description)
/*
Request the analysis tool to ignore all reads in the current thread
until _Py_ANNOTATE_IGNORE_READS_END is called.
Useful to ignore intentional racey reads, while still checking
other reads and all writes.
See also _Py_ANNOTATE_UNPROTECTED_READ.
*/
#
define
_Py_ANNOTATE_IGNORE_READS_BEGIN
() \
AnnotateIgnoreReadsBegin
(__FILE__, __LINE__)
/*
Stop ignoring reads.
*/
#
define
_Py_ANNOTATE_IGNORE_READS_END
() \
AnnotateIgnoreReadsEnd
(__FILE__, __LINE__)
/*
Similar to _Py_ANNOTATE_IGNORE_READS_BEGIN, but ignore writes.
*/
#
define
_Py_ANNOTATE_IGNORE_WRITES_BEGIN
() \
AnnotateIgnoreWritesBegin
(__FILE__, __LINE__)
/*
Stop ignoring writes.
*/
#
define
_Py_ANNOTATE_IGNORE_WRITES_END
() \
AnnotateIgnoreWritesEnd
(__FILE__, __LINE__)
/*
Start ignoring all memory accesses (reads and writes).
*/
#
define
_Py_ANNOTATE_IGNORE_READS_AND_WRITES_BEGIN
() \
do
{\
_Py_ANNOTATE_IGNORE_READS_BEGIN
();\
_Py_ANNOTATE_IGNORE_WRITES_BEGIN
();\
}
while
(
0
)\
/*
Stop ignoring all memory accesses.
*/
#
define
_Py_ANNOTATE_IGNORE_READS_AND_WRITES_END
() \
do
{\
_Py_ANNOTATE_IGNORE_WRITES_END
();\
_Py_ANNOTATE_IGNORE_READS_END
();\
}
while
(
0
)\
/*
Similar to _Py_ANNOTATE_IGNORE_READS_BEGIN, but ignore synchronization events:
RWLOCK* and CONDVAR*.
*/
#
define
_Py_ANNOTATE_IGNORE_SYNC_BEGIN
() \
AnnotateIgnoreSyncBegin
(__FILE__, __LINE__)
/*
Stop ignoring sync events.
*/
#
define
_Py_ANNOTATE_IGNORE_SYNC_END
() \
AnnotateIgnoreSyncEnd
(__FILE__, __LINE__)
/*
Enable (enable!=0) or disable (enable==0) race detection for all threads.
This annotation could be useful if you want to skip expensive race analysis
during some period of program execution, e.g. during initialization.
*/
#
define
_Py_ANNOTATE_ENABLE_RACE_DETECTION
(
enable
) \
AnnotateEnableRaceDetection
(__FILE__, __LINE__, enable)
/*
-------------------------------------------------------------
Annotations useful for debugging.
*/
/*
Request to trace every access to "address".
*/
#
define
_Py_ANNOTATE_TRACE_MEMORY
(
address
) \
AnnotateTraceMemory
(__FILE__, __LINE__, address)
/*
Report the current thread name to a race detector.
*/
#
define
_Py_ANNOTATE_THREAD_NAME
(
name
) \
AnnotateThreadName
(__FILE__, __LINE__, name)
/*
-------------------------------------------------------------
Annotations useful when implementing locks. They are not
normally needed by modules that merely use locks.
The "lock" argument is a pointer to the lock object.
*/
/*
Report that a lock has been created at address "lock".
*/
#
define
_Py_ANNOTATE_RWLOCK_CREATE
(
lock
) \
AnnotateRWLockCreate
(__FILE__, __LINE__, lock)
/*
Report that the lock at address "lock" is about to be destroyed.
*/
#
define
_Py_ANNOTATE_RWLOCK_DESTROY
(
lock
) \
AnnotateRWLockDestroy
(__FILE__, __LINE__, lock)
/*
Report that the lock at address "lock" has been acquired.
is_w=1 for writer lock, is_w=0 for reader lock.
*/
#
define
_Py_ANNOTATE_RWLOCK_ACQUIRED
(
lock, is_w
) \
AnnotateRWLockAcquired
(__FILE__, __LINE__, lock, is_w)
/*
Report that the lock at address "lock" is about to be released.
*/
#
define
_Py_ANNOTATE_RWLOCK_RELEASED
(
lock, is_w
) \
AnnotateRWLockReleased
(__FILE__, __LINE__, lock, is_w)
/*
-------------------------------------------------------------
Annotations useful when implementing barriers. They are not
normally needed by modules that merely use barriers.
The "barrier" argument is a pointer to the barrier object.
*/
/*
Report that the "barrier" has been initialized with initial "count".
If 'reinitialization_allowed' is true, initialization is allowed to happen
multiple times w/o calling barrier_destroy()
*/
#
define
_Py_ANNOTATE_BARRIER_INIT
(
barrier, count, reinitialization_allowed
) \
AnnotateBarrierInit
(__FILE__, __LINE__, barrier, count, \
reinitialization_allowed)
/*
Report that we are about to enter barrier_wait("barrier").
*/
#
define
_Py_ANNOTATE_BARRIER_WAIT_BEFORE
(
barrier
) \
AnnotateBarrierWaitBefore
(__FILE__, __LINE__, barrier)
/*
Report that we just exited barrier_wait("barrier").
*/
#
define
_Py_ANNOTATE_BARRIER_WAIT_AFTER
(
barrier
) \
AnnotateBarrierWaitAfter
(__FILE__, __LINE__, barrier)
/*
Report that the "barrier" has been destroyed.
*/
#
define
_Py_ANNOTATE_BARRIER_DESTROY
(
barrier
) \
AnnotateBarrierDestroy
(__FILE__, __LINE__, barrier)
/*
-------------------------------------------------------------
Annotations useful for testing race detectors.
*/
/*
Report that we expect a race on the variable at "address".
Use only in unit tests for a race detector.
*/
#
define
_Py_ANNOTATE_EXPECT_RACE
(
address, description
) \
AnnotateExpectRace
(__FILE__, __LINE__, address, description)
/*
A no-op. Insert where you like to test the interceptors.
*/
#
define
_Py_ANNOTATE_NO_OP
(
arg
) \
AnnotateNoOp
(__FILE__, __LINE__, arg)
/*
Force the race detector to flush its state. The actual effect depends on
* the implementation of the detector.
*/
#
define
_Py_ANNOTATE_FLUSH_STATE
() \
AnnotateFlushState
(__FILE__, __LINE__)
#
else
/*
DYNAMIC_ANNOTATIONS_ENABLED == 0
*/
#
define
_Py_ANNOTATE_RWLOCK_CREATE
(
lock
)
/*
empty
*/
#
define
_Py_ANNOTATE_RWLOCK_DESTROY
(
lock
)
/*
empty
*/
#
define
_Py_ANNOTATE_RWLOCK_ACQUIRED
(
lock, is_w
)
/*
empty
*/
#
define
_Py_ANNOTATE_RWLOCK_RELEASED
(
lock, is_w
)
/*
empty
*/
#
define
_Py_ANNOTATE_BARRIER_INIT
(
barrier, count, reinitialization_allowed
)
/*
*/
#
define
_Py_ANNOTATE_BARRIER_WAIT_BEFORE
(
barrier
)
/*
empty
*/
#
define
_Py_ANNOTATE_BARRIER_WAIT_AFTER
(
barrier
)
/*
empty
*/
#
define
_Py_ANNOTATE_BARRIER_DESTROY
(
barrier
)
/*
empty
*/
#
define
_Py_ANNOTATE_CONDVAR_LOCK_WAIT
(
cv, lock
)
/*
empty
*/
#
define
_Py_ANNOTATE_CONDVAR_WAIT
(
cv
)
/*
empty
*/
#
define
_Py_ANNOTATE_CONDVAR_SIGNAL
(
cv
)
/*
empty
*/
#
define
_Py_ANNOTATE_CONDVAR_SIGNAL_ALL
(
cv
)
/*
empty
*/
#
define
_Py_ANNOTATE_HAPPENS_BEFORE
(
obj
)
/*
empty
*/
#
define
_Py_ANNOTATE_HAPPENS_AFTER
(
obj
)
/*
empty
*/
#
define
_Py_ANNOTATE_PUBLISH_MEMORY_RANGE
(
address, size
)
/*
empty
*/
#
define
_Py_ANNOTATE_UNPUBLISH_MEMORY_RANGE
(
address, size
)
/*
empty
*/
#
define
_Py_ANNOTATE_SWAP_MEMORY_RANGE
(
address, size
)
/*
empty
*/
#
define
_Py_ANNOTATE_PCQ_CREATE
(
pcq
)
/*
empty
*/
#
define
_Py_ANNOTATE_PCQ_DESTROY
(
pcq
)
/*
empty
*/
#
define
_Py_ANNOTATE_PCQ_PUT
(
pcq
)
/*
empty
*/
#
define
_Py_ANNOTATE_PCQ_GET
(
pcq
)
/*
empty
*/
#
define
_Py_ANNOTATE_NEW_MEMORY
(
address, size
)
/*
empty
*/
#
define
_Py_ANNOTATE_EXPECT_RACE
(
address, description
)
/*
empty
*/
#
define
_Py_ANNOTATE_BENIGN_RACE
(
address, description
)
/*
empty
*/
#
define
_Py_ANNOTATE_BENIGN_RACE_SIZED
(
address, size, description
)
/*
empty
*/
#
define
_Py_ANNOTATE_PURE_HAPPENS_BEFORE_MUTEX
(
mu
)
/*
empty
*/
#
define
_Py_ANNOTATE_MUTEX_IS_USED_AS_CONDVAR
(
mu
)
/*
empty
*/
#
define
_Py_ANNOTATE_TRACE_MEMORY
(
arg
)
/*
empty
*/
#
define
_Py_ANNOTATE_THREAD_NAME
(
name
)
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_READS_BEGIN
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_READS_END
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_WRITES_BEGIN
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_WRITES_END
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_READS_AND_WRITES_BEGIN
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_READS_AND_WRITES_END
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_SYNC_BEGIN
()
/*
empty
*/
#
define
_Py_ANNOTATE_IGNORE_SYNC_END
()
/*
empty
*/
#
define
_Py_ANNOTATE_ENABLE_RACE_DETECTION
(
enable
)
/*
empty
*/
#
define
_Py_ANNOTATE_NO_OP
(
arg
)
/*
empty
*/
#
define
_Py_ANNOTATE_FLUSH_STATE
()
/*
empty
*/
#
endif
/*
DYNAMIC_ANNOTATIONS_ENABLED
*/
/*
Use the macros above rather than using these functions directly.
*/
#
ifdef
__cplusplus
extern
"
C
"
{
#endif
void
AnnotateRWLockCreate
(
const
char
*file,
int
line,
const
volatile
void
*lock);
void
AnnotateRWLockDestroy
(
const
char
*file,
int
line,
const
volatile
void
*lock);
void
AnnotateRWLockAcquired
(
const
char
*file,
int
line,
const
volatile
void
*lock,
long
is_w);
void
AnnotateRWLockReleased
(
const
char
*file,
int
line,
const
volatile
void
*lock,
long
is_w);
void
AnnotateBarrierInit
(
const
char
*file,
int
line,
const
volatile
void
*barrier,
long
count,
long
reinitialization_allowed);
void
AnnotateBarrierWaitBefore
(
const
char
*file,
int
line,
const
volatile
void
*barrier);
void
AnnotateBarrierWaitAfter
(
const
char
*file,
int
line,
const
volatile
void
*barrier);
void
AnnotateBarrierDestroy
(
const
char
*file,
int
line,
const
volatile
void
*barrier);
void
AnnotateCondVarWait
(
const
char
*file,
int
line,
const
volatile
void
*cv,
const
volatile
void
*lock);
void
AnnotateCondVarSignal
(
const
char
*file,
int
line,
const
volatile
void
*cv);
void
AnnotateCondVarSignalAll
(
const
char
*file,
int
line,
const
volatile
void
*cv);
void
AnnotatePublishMemoryRange
(
const
char
*file,
int
line,
const
volatile
void
*address,
long
size);
void
AnnotateUnpublishMemoryRange
(
const
char
*file,
int
line,
const
volatile
void
*address,
long
size);
void
AnnotatePCQCreate
(
const
char
*file,
int
line,
const
volatile
void
*pcq);
void
AnnotatePCQDestroy
(
const
char
*file,
int
line,
const
volatile
void
*pcq);
void
AnnotatePCQPut
(
const
char
*file,
int
line,
const
volatile
void
*pcq);
void
AnnotatePCQGet
(
const
char
*file,
int
line,
const
volatile
void
*pcq);
void
AnnotateNewMemory
(
const
char
*file,
int
line,
const
volatile
void
*address,
long
size);
void
AnnotateExpectRace
(
const
char
*file,
int
line,
const
volatile
void
*address,
const
char
*description);
void
AnnotateBenignRace
(
const
char
*file,
int
line,
const
volatile
void
*address,
const
char
*description);
void
AnnotateBenignRaceSized
(
const
char
*file,
int
line,
const
volatile
void
*address,
long
size,
const
char
*description);
void
AnnotateMutexIsUsedAsCondVar
(
const
char
*file,
int
line,
const
volatile
void
*mu);
void
AnnotateTraceMemory
(
const
char
*file,
int
line,
const
volatile
void
*arg);
void
AnnotateThreadName
(
const
char
*file,
int
line,
const
char
*name);
void
AnnotateIgnoreReadsBegin
(
const
char
*file,
int
line);
void
AnnotateIgnoreReadsEnd
(
const
char
*file,
int
line);
void
AnnotateIgnoreWritesBegin
(
const
char
*file,
int
line);
void
AnnotateIgnoreWritesEnd
(
const
char
*file,
int
line);
void
AnnotateEnableRaceDetection
(
const
char
*file,
int
line,
int
enable);
void
AnnotateNoOp
(
const
char
*file,
int
line,
const
volatile
void
*arg);
void
AnnotateFlushState
(
const
char
*file,
int
line);
/*
Return non-zero value if running under valgrind.
If "valgrind.h" is included into dynamic_annotations.c,
the regular valgrind mechanism will be used.
See http://valgrind.org/docs/manual/manual-core-adv.html about
RUNNING_ON_VALGRIND and other valgrind "client requests".
The file "valgrind.h" may be obtained by doing
svn co svn://svn.valgrind.org/valgrind/trunk/include
If for some reason you can't use "valgrind.h" or want to fake valgrind,
there are two ways to make this function return non-zero:
- Use environment variable: export RUNNING_ON_VALGRIND=1
- Make your tool intercept the function RunningOnValgrind() and
change its return value.
*/
int
RunningOnValgrind
(
void
);
#
ifdef
__cplusplus
}
#
endif
#
if
DYNAMIC_ANNOTATIONS_ENABLED != 0 && defined(__cplusplus)
/*
_Py_ANNOTATE_UNPROTECTED_READ is the preferred way to annotate racey reads.
Instead of doing
_Py_ANNOTATE_IGNORE_READS_BEGIN();
... = x;
_Py_ANNOTATE_IGNORE_READS_END();
one can use
... = _Py_ANNOTATE_UNPROTECTED_READ(x);
*/
template
<
class
T
>
inline
T
_Py_ANNOTATE_UNPROTECTED_READ
(
const
volatile
T &x) {
_Py_ANNOTATE_IGNORE_READS_BEGIN
();
T res = x;
_Py_ANNOTATE_IGNORE_READS_END
();
return
res;
}
/*
Apply _Py_ANNOTATE_BENIGN_RACE_SIZED to a static variable.
*/
#
define
_Py_ANNOTATE_BENIGN_RACE_STATIC
(
static_var, description
) \
namespace
{ \
class
static_var
## _annotator { \
public:
\
static_var ## _annotator() { \
_Py_ANNOTATE_BENIGN_RACE_SIZED
(&static_var, \
sizeof
(static_var), \
# static_var
"
:
"
description); \
} \
}; \
static
static_var ## _annotator the ## static_var ## _annotator;\
}
#
else
/*
DYNAMIC_ANNOTATIONS_ENABLED == 0
*/
#
define
_Py_ANNOTATE_UNPROTECTED_READ
(
x
) (x)
#
define
_Py_ANNOTATE_BENIGN_RACE_STATIC
(
static_var, description
)
/*
empty
*/
#
endif
/*
DYNAMIC_ANNOTATIONS_ENABLED
*/
#endif
/*
__DYNAMIC_ANNOTATIONS_H__
*/
Back
|
FazBrowse Home
|
New Git URL