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
|
/*
This file is part of drd, a thread error detector.
Copyright (C) 2006-2015 Bart Van Assche <bvanassche@acm.org>.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307, USA.
The GNU General Public License is contained in the file COPYING.
*/
#ifndef __DRD_ERROR_H
#define __DRD_ERROR_H
#include "pub_drd_bitmap.h" // BmAccessTypeT
#include "drd_thread.h" // DrdThreadId
#include "pub_tool_basics.h" // SizeT
#include "pub_tool_debuginfo.h" // SegInfo
#include "pub_tool_errormgr.h" // ExeContext
/* DRD error types. */
typedef enum {
#define STR_DataRaceErr "ConflictingAccess"
DataRaceErr = 1,
#define STR_MutexErr "MutexErr"
MutexErr = 2,
#define STR_CondErr "CondErr"
CondErr = 3,
#define STR_CondDestrErr "CondDestrErr"
CondDestrErr = 4,
#define STR_CondRaceErr "CondRaceErr"
CondRaceErr = 5,
#define STR_CondWaitErr "CondWaitErr"
CondWaitErr = 6,
#define STR_SemaphoreErr "SemaphoreErr"
SemaphoreErr = 7,
#define STR_BarrierErr "BarrierErr"
BarrierErr = 8,
#define STR_RwlockErr "RwlockErr"
RwlockErr = 9,
#define STR_HoldtimeErr "HoldtimeErr"
HoldtimeErr = 10,
#define STR_GenericErr "GenericErr"
GenericErr = 11,
#define STR_InvalidThreadId "InvalidThreadId"
InvalidThreadId = 12,
#define STR_UnimpHgClReq "UnimpHgClReq"
UnimpHgClReq = 13,
#define STR_UnimpDrdClReq "UnimpDrdClReq"
UnimpDrdClReq = 14,
} DrdErrorKind;
/* The classification of a faulting address. */
typedef
enum {
//Undescribed, // as-yet unclassified
eStack,
eUnknown, // classification yielded nothing useful
//Freed,
eMallocd,
eSegment, // in a segment (as defined in pub_tool_debuginfo.h)
//UserG, // in a user-defined block
//Mempool, // in a mempool
//Register, // in a register; for Param errors only
}
AddrKind;
/* Records info about a faulting address. */
typedef
struct { // Used by:
AddrKind akind; // ALL
SizeT size; // ALL
PtrdiffT rwoffset; // ALL
ExeContext* lastchange; // Mallocd
DrdThreadId stack_tid; // Stack
DebugInfo* debuginfo; // Segment
HChar name[256]; // Segment
HChar descr[256]; // Segment
} AddrInfo;
/*
* NOTE: the first member of each error info structure MUST be the thread ID
* in which the error has been observed.
*/
typedef struct {
DrdThreadId tid; // Thread ID of the running thread.
Addr addr; // Conflicting address in current thread.
SizeT size; // Size in bytes of conflicting operation.
BmAccessTypeT access_type; // Access type: load or store.
} DataRaceErrInfo;
typedef struct {
DrdThreadId tid;
Addr mutex;
Int recursion_count;
DrdThreadId owner;
} MutexErrInfo;
typedef struct {
DrdThreadId tid;
Addr cond;
} CondErrInfo;
typedef struct {
DrdThreadId tid;
Addr cond;
Addr mutex;
DrdThreadId owner;
} CondDestrErrInfo;
typedef struct {
DrdThreadId tid;
Addr cond;
Addr mutex;
} CondRaceErrInfo;
typedef struct {
DrdThreadId tid;
Addr cond;
Addr mutex1;
Addr mutex2;
} CondWaitErrInfo;
typedef struct {
DrdThreadId tid;
Addr semaphore;
} SemaphoreErrInfo;
typedef struct {
DrdThreadId tid;
Addr barrier;
DrdThreadId other_tid;
ExeContext* other_context;
} BarrierErrInfo;
typedef struct {
DrdThreadId tid;
Addr rwlock;
} RwlockErrInfo;
typedef struct {
DrdThreadId tid;
Addr synchronization_object;
ExeContext* acquired_at;
UInt hold_time_ms;
UInt threshold_ms;
} HoldtimeErrInfo;
typedef struct {
DrdThreadId tid;
Addr addr;
} GenericErrInfo;
typedef struct {
DrdThreadId tid;
ULong ptid;
} InvalidThreadIdInfo;
typedef struct {
DrdThreadId tid;
HChar* descr;
} UnimpClReqInfo;
void DRD_(set_show_conflicting_segments)(const Bool scs);
void DRD_(register_error_handlers)(void);
void DRD_(trace_msg)(const HChar* format, ...) PRINTF_CHECK(1, 2);
void DRD_(trace_msg_w_bt)(const HChar* format, ...) PRINTF_CHECK(1, 2);
#endif /* __DRD_ERROR_H */
|
