blob: 8fe9bcae69dca364e67ae254072cd644cabd94b1 [file] [log] [blame]
Kostya Serebryany60ebb1942012-02-13 22:50:51 +00001//===-- ThreadSanitizer.cpp - race detector -------------------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This file is a part of ThreadSanitizer, a race detector.
11//
12// The tool is under development, for the details about previous versions see
13// http://code.google.com/p/data-race-test
14//
15// The instrumentation phase is quite simple:
16// - Insert calls to run-time library before every memory access.
17// - Optimizations may apply to avoid instrumenting some of the accesses.
18// - Insert calls at function entry/exit.
19// The rest is handled by the run-time library.
20//===----------------------------------------------------------------------===//
21
Chandler Carruthd04a8d42012-12-03 16:50:05 +000022#include "llvm/Transforms/Instrumentation.h"
Chandler Carruthd04a8d42012-12-03 16:50:05 +000023#include "llvm/ADT/SmallSet.h"
24#include "llvm/ADT/SmallString.h"
25#include "llvm/ADT/SmallVector.h"
26#include "llvm/ADT/Statistic.h"
27#include "llvm/ADT/StringExtras.h"
Chandler Carruth0b8c9a82013-01-02 11:36:10 +000028#include "llvm/IR/DataLayout.h"
29#include "llvm/IR/Function.h"
30#include "llvm/IR/IRBuilder.h"
Kostya Serebryanyf4644812013-03-28 11:21:13 +000031#include "llvm/IR/IntrinsicInst.h"
Chandler Carruth0b8c9a82013-01-02 11:36:10 +000032#include "llvm/IR/Intrinsics.h"
33#include "llvm/IR/LLVMContext.h"
34#include "llvm/IR/Metadata.h"
35#include "llvm/IR/Module.h"
36#include "llvm/IR/Type.h"
Kostya Serebryany6e590e32012-03-14 23:33:24 +000037#include "llvm/Support/CommandLine.h"
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000038#include "llvm/Support/Debug.h"
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000039#include "llvm/Support/MathExtras.h"
Kostya Serebryany52eb69922012-03-26 17:35:03 +000040#include "llvm/Support/raw_ostream.h"
Kostya Serebryanye5079222012-04-27 07:31:53 +000041#include "llvm/Transforms/Utils/BasicBlockUtils.h"
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000042#include "llvm/Transforms/Utils/ModuleUtils.h"
Peter Collingbourne405515d2013-07-09 22:02:49 +000043#include "llvm/Transforms/Utils/SpecialCaseList.h"
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000044
45using namespace llvm;
46
Stephen Hinesdce4a402014-05-29 02:49:00 -070047#define DEBUG_TYPE "tsan"
48
Alexey Samsonovf045df12012-12-28 09:30:44 +000049static cl::opt<std::string> ClBlacklistFile("tsan-blacklist",
Kostya Serebryany6e590e32012-03-14 23:33:24 +000050 cl::desc("Blacklist file"), cl::Hidden);
Kostya Serebryany41d876c2012-10-04 05:28:50 +000051static cl::opt<bool> ClInstrumentMemoryAccesses(
52 "tsan-instrument-memory-accesses", cl::init(true),
53 cl::desc("Instrument memory accesses"), cl::Hidden);
54static cl::opt<bool> ClInstrumentFuncEntryExit(
55 "tsan-instrument-func-entry-exit", cl::init(true),
56 cl::desc("Instrument function entry and exit"), cl::Hidden);
57static cl::opt<bool> ClInstrumentAtomics(
58 "tsan-instrument-atomics", cl::init(true),
59 cl::desc("Instrument atomics"), cl::Hidden);
Kostya Serebryanyf4644812013-03-28 11:21:13 +000060static cl::opt<bool> ClInstrumentMemIntrinsics(
61 "tsan-instrument-memintrinsics", cl::init(true),
62 cl::desc("Instrument memintrinsics (memset/memcpy/memmove)"), cl::Hidden);
Kostya Serebryany6e590e32012-03-14 23:33:24 +000063
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +000064STATISTIC(NumInstrumentedReads, "Number of instrumented reads");
65STATISTIC(NumInstrumentedWrites, "Number of instrumented writes");
Alexey Samsonov1dfe9b52012-08-30 13:47:13 +000066STATISTIC(NumOmittedReadsBeforeWrite,
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +000067 "Number of reads ignored due to following writes");
68STATISTIC(NumAccessesWithBadSize, "Number of accesses with bad size");
69STATISTIC(NumInstrumentedVtableWrites, "Number of vtable ptr writes");
Dmitry Vyukovab78ac12013-03-22 08:51:22 +000070STATISTIC(NumInstrumentedVtableReads, "Number of vtable ptr reads");
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +000071STATISTIC(NumOmittedReadsFromConstantGlobals,
72 "Number of reads from constant globals");
73STATISTIC(NumOmittedReadsFromVtable, "Number of vtable reads");
Kostya Serebryany2076af02012-04-10 18:18:56 +000074
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000075namespace {
Kostya Serebryany2076af02012-04-10 18:18:56 +000076
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000077/// ThreadSanitizer: instrument the code in module to find races.
78struct ThreadSanitizer : public FunctionPass {
Alexey Samsonovf045df12012-12-28 09:30:44 +000079 ThreadSanitizer(StringRef BlacklistFile = StringRef())
80 : FunctionPass(ID),
Stephen Hinesdce4a402014-05-29 02:49:00 -070081 DL(nullptr),
Alexey Samsonovf045df12012-12-28 09:30:44 +000082 BlacklistFile(BlacklistFile.empty() ? ClBlacklistFile
83 : BlacklistFile) { }
Stephen Hines36b56882014-04-23 16:57:46 -070084 const char *getPassName() const override;
85 bool runOnFunction(Function &F) override;
86 bool doInitialization(Module &M) override;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +000087 static char ID; // Pass identification, replacement for typeid.
88
89 private:
Kostya Serebryany8b390ff2012-11-29 09:54:21 +000090 void initializeCallbacks(Module &M);
Kostya Serebryanye5079222012-04-27 07:31:53 +000091 bool instrumentLoadOrStore(Instruction *I);
92 bool instrumentAtomic(Instruction *I);
Kostya Serebryanyf4644812013-03-28 11:21:13 +000093 bool instrumentMemIntrinsic(Instruction *I);
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +000094 void chooseInstructionsToInstrument(SmallVectorImpl<Instruction*> &Local,
95 SmallVectorImpl<Instruction*> &All);
Kostya Serebryanycff60c12012-04-10 22:29:17 +000096 bool addrPointsToConstantData(Value *Addr);
Kostya Serebryanye5079222012-04-27 07:31:53 +000097 int getMemoryAccessFuncIndex(Value *Addr);
Kostya Serebryany2076af02012-04-10 18:18:56 +000098
Stephen Hines36b56882014-04-23 16:57:46 -070099 const DataLayout *DL;
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000100 Type *IntptrTy;
Alexey Samsonovf045df12012-12-28 09:30:44 +0000101 SmallString<64> BlacklistFile;
Stephen Hines36b56882014-04-23 16:57:46 -0700102 std::unique_ptr<SpecialCaseList> BL;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000103 IntegerType *OrdTy;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000104 // Callbacks to run-time library are computed in doInitialization.
Kostya Serebryanye5079222012-04-27 07:31:53 +0000105 Function *TsanFuncEntry;
106 Function *TsanFuncExit;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000107 // Accesses sizes are powers of two: 1, 2, 4, 8, 16.
Kostya Serebryany3eccaa62012-02-14 00:52:07 +0000108 static const size_t kNumberOfAccessSizes = 5;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000109 Function *TsanRead[kNumberOfAccessSizes];
110 Function *TsanWrite[kNumberOfAccessSizes];
111 Function *TsanAtomicLoad[kNumberOfAccessSizes];
112 Function *TsanAtomicStore[kNumberOfAccessSizes];
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000113 Function *TsanAtomicRMW[AtomicRMWInst::LAST_BINOP + 1][kNumberOfAccessSizes];
114 Function *TsanAtomicCAS[kNumberOfAccessSizes];
115 Function *TsanAtomicThreadFence;
116 Function *TsanAtomicSignalFence;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000117 Function *TsanVptrUpdate;
Dmitry Vyukovab78ac12013-03-22 08:51:22 +0000118 Function *TsanVptrLoad;
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000119 Function *MemmoveFn, *MemcpyFn, *MemsetFn;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000120};
121} // namespace
122
123char ThreadSanitizer::ID = 0;
124INITIALIZE_PASS(ThreadSanitizer, "tsan",
125 "ThreadSanitizer: detects data races.",
126 false, false)
127
Kostya Serebryanye5079222012-04-27 07:31:53 +0000128const char *ThreadSanitizer::getPassName() const {
129 return "ThreadSanitizer";
130}
131
Alexey Samsonovf045df12012-12-28 09:30:44 +0000132FunctionPass *llvm::createThreadSanitizerPass(StringRef BlacklistFile) {
133 return new ThreadSanitizer(BlacklistFile);
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000134}
135
Kostya Serebryanye5079222012-04-27 07:31:53 +0000136static Function *checkInterfaceFunction(Constant *FuncOrBitcast) {
137 if (Function *F = dyn_cast<Function>(FuncOrBitcast))
138 return F;
139 FuncOrBitcast->dump();
140 report_fatal_error("ThreadSanitizer interface function redefined");
141}
142
Kostya Serebryany8b390ff2012-11-29 09:54:21 +0000143void ThreadSanitizer::initializeCallbacks(Module &M) {
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000144 IRBuilder<> IRB(M.getContext());
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000145 // Initialize the callbacks.
Kostya Serebryanye5079222012-04-27 07:31:53 +0000146 TsanFuncEntry = checkInterfaceFunction(M.getOrInsertFunction(
147 "__tsan_func_entry", IRB.getVoidTy(), IRB.getInt8PtrTy(), NULL));
148 TsanFuncExit = checkInterfaceFunction(M.getOrInsertFunction(
149 "__tsan_func_exit", IRB.getVoidTy(), NULL));
150 OrdTy = IRB.getInt32Ty();
Kostya Serebryany3eccaa62012-02-14 00:52:07 +0000151 for (size_t i = 0; i < kNumberOfAccessSizes; ++i) {
Kostya Serebryanye5079222012-04-27 07:31:53 +0000152 const size_t ByteSize = 1 << i;
153 const size_t BitSize = ByteSize * 8;
154 SmallString<32> ReadName("__tsan_read" + itostr(ByteSize));
155 TsanRead[i] = checkInterfaceFunction(M.getOrInsertFunction(
156 ReadName, IRB.getVoidTy(), IRB.getInt8PtrTy(), NULL));
157
158 SmallString<32> WriteName("__tsan_write" + itostr(ByteSize));
159 TsanWrite[i] = checkInterfaceFunction(M.getOrInsertFunction(
160 WriteName, IRB.getVoidTy(), IRB.getInt8PtrTy(), NULL));
161
162 Type *Ty = Type::getIntNTy(M.getContext(), BitSize);
163 Type *PtrTy = Ty->getPointerTo();
164 SmallString<32> AtomicLoadName("__tsan_atomic" + itostr(BitSize) +
165 "_load");
166 TsanAtomicLoad[i] = checkInterfaceFunction(M.getOrInsertFunction(
167 AtomicLoadName, Ty, PtrTy, OrdTy, NULL));
168
169 SmallString<32> AtomicStoreName("__tsan_atomic" + itostr(BitSize) +
170 "_store");
171 TsanAtomicStore[i] = checkInterfaceFunction(M.getOrInsertFunction(
172 AtomicStoreName, IRB.getVoidTy(), PtrTy, Ty, OrdTy,
173 NULL));
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000174
175 for (int op = AtomicRMWInst::FIRST_BINOP;
176 op <= AtomicRMWInst::LAST_BINOP; ++op) {
Stephen Hinesdce4a402014-05-29 02:49:00 -0700177 TsanAtomicRMW[op][i] = nullptr;
178 const char *NamePart = nullptr;
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000179 if (op == AtomicRMWInst::Xchg)
180 NamePart = "_exchange";
181 else if (op == AtomicRMWInst::Add)
182 NamePart = "_fetch_add";
183 else if (op == AtomicRMWInst::Sub)
184 NamePart = "_fetch_sub";
185 else if (op == AtomicRMWInst::And)
186 NamePart = "_fetch_and";
187 else if (op == AtomicRMWInst::Or)
188 NamePart = "_fetch_or";
189 else if (op == AtomicRMWInst::Xor)
190 NamePart = "_fetch_xor";
Dmitry Vyukovb10675e2012-11-27 08:09:25 +0000191 else if (op == AtomicRMWInst::Nand)
192 NamePart = "_fetch_nand";
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000193 else
194 continue;
195 SmallString<32> RMWName("__tsan_atomic" + itostr(BitSize) + NamePart);
196 TsanAtomicRMW[op][i] = checkInterfaceFunction(M.getOrInsertFunction(
197 RMWName, Ty, PtrTy, Ty, OrdTy, NULL));
198 }
199
200 SmallString<32> AtomicCASName("__tsan_atomic" + itostr(BitSize) +
201 "_compare_exchange_val");
202 TsanAtomicCAS[i] = checkInterfaceFunction(M.getOrInsertFunction(
Dmitry Vyukov6702e532012-11-26 11:36:19 +0000203 AtomicCASName, Ty, PtrTy, Ty, Ty, OrdTy, OrdTy, NULL));
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000204 }
Kostya Serebryanye5079222012-04-27 07:31:53 +0000205 TsanVptrUpdate = checkInterfaceFunction(M.getOrInsertFunction(
206 "__tsan_vptr_update", IRB.getVoidTy(), IRB.getInt8PtrTy(),
207 IRB.getInt8PtrTy(), NULL));
Dmitry Vyukovab78ac12013-03-22 08:51:22 +0000208 TsanVptrLoad = checkInterfaceFunction(M.getOrInsertFunction(
209 "__tsan_vptr_read", IRB.getVoidTy(), IRB.getInt8PtrTy(), NULL));
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000210 TsanAtomicThreadFence = checkInterfaceFunction(M.getOrInsertFunction(
211 "__tsan_atomic_thread_fence", IRB.getVoidTy(), OrdTy, NULL));
212 TsanAtomicSignalFence = checkInterfaceFunction(M.getOrInsertFunction(
213 "__tsan_atomic_signal_fence", IRB.getVoidTy(), OrdTy, NULL));
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000214
215 MemmoveFn = checkInterfaceFunction(M.getOrInsertFunction(
216 "memmove", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(),
217 IRB.getInt8PtrTy(), IntptrTy, NULL));
218 MemcpyFn = checkInterfaceFunction(M.getOrInsertFunction(
219 "memcpy", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(), IRB.getInt8PtrTy(),
220 IntptrTy, NULL));
221 MemsetFn = checkInterfaceFunction(M.getOrInsertFunction(
222 "memset", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(), IRB.getInt32Ty(),
223 IntptrTy, NULL));
Kostya Serebryany8b390ff2012-11-29 09:54:21 +0000224}
225
226bool ThreadSanitizer::doInitialization(Module &M) {
Stephen Hines36b56882014-04-23 16:57:46 -0700227 DataLayoutPass *DLP = getAnalysisIfAvailable<DataLayoutPass>();
228 if (!DLP)
Stephen Hinesdce4a402014-05-29 02:49:00 -0700229 report_fatal_error("data layout missing");
Stephen Hines36b56882014-04-23 16:57:46 -0700230 DL = &DLP->getDataLayout();
Alexey Samsonove39e1312013-08-12 11:46:09 +0000231 BL.reset(SpecialCaseList::createOrDie(BlacklistFile));
Kostya Serebryany8b390ff2012-11-29 09:54:21 +0000232
233 // Always insert a call to __tsan_init into the module's CTORs.
234 IRBuilder<> IRB(M.getContext());
Stephen Hines36b56882014-04-23 16:57:46 -0700235 IntptrTy = IRB.getIntPtrTy(DL);
Kostya Serebryany8b390ff2012-11-29 09:54:21 +0000236 Value *TsanInit = M.getOrInsertFunction("__tsan_init",
237 IRB.getVoidTy(), NULL);
238 appendToGlobalCtors(M, cast<Function>(TsanInit), 0);
239
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000240 return true;
241}
242
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000243static bool isVtableAccess(Instruction *I) {
Manman Ren0b3d3922013-09-06 22:47:05 +0000244 if (MDNode *Tag = I->getMetadata(LLVMContext::MD_tbaa))
245 return Tag->isTBAAVtableAccess();
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000246 return false;
247}
248
249bool ThreadSanitizer::addrPointsToConstantData(Value *Addr) {
250 // If this is a GEP, just analyze its pointer operand.
251 if (GetElementPtrInst *GEP = dyn_cast<GetElementPtrInst>(Addr))
252 Addr = GEP->getPointerOperand();
253
254 if (GlobalVariable *GV = dyn_cast<GlobalVariable>(Addr)) {
255 if (GV->isConstant()) {
256 // Reads from constant globals can not race with any writes.
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +0000257 NumOmittedReadsFromConstantGlobals++;
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000258 return true;
259 }
Alexey Samsonov1dfe9b52012-08-30 13:47:13 +0000260 } else if (LoadInst *L = dyn_cast<LoadInst>(Addr)) {
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000261 if (isVtableAccess(L)) {
262 // Reads from a vtable pointer can not race with any writes.
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +0000263 NumOmittedReadsFromVtable++;
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000264 return true;
265 }
266 }
267 return false;
268}
269
Kostya Serebryany2076af02012-04-10 18:18:56 +0000270// Instrumenting some of the accesses may be proven redundant.
271// Currently handled:
272// - read-before-write (within same BB, no calls between)
273//
274// We do not handle some of the patterns that should not survive
275// after the classic compiler optimizations.
276// E.g. two reads from the same temp should be eliminated by CSE,
277// two writes should be eliminated by DSE, etc.
278//
279// 'Local' is a vector of insns within the same BB (no calls between).
280// 'All' is a vector of insns that will be instrumented.
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000281void ThreadSanitizer::chooseInstructionsToInstrument(
Kostya Serebryany2076af02012-04-10 18:18:56 +0000282 SmallVectorImpl<Instruction*> &Local,
283 SmallVectorImpl<Instruction*> &All) {
284 SmallSet<Value*, 8> WriteTargets;
285 // Iterate from the end.
286 for (SmallVectorImpl<Instruction*>::reverse_iterator It = Local.rbegin(),
287 E = Local.rend(); It != E; ++It) {
288 Instruction *I = *It;
289 if (StoreInst *Store = dyn_cast<StoreInst>(I)) {
290 WriteTargets.insert(Store->getPointerOperand());
291 } else {
292 LoadInst *Load = cast<LoadInst>(I);
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000293 Value *Addr = Load->getPointerOperand();
294 if (WriteTargets.count(Addr)) {
Kostya Serebryany2076af02012-04-10 18:18:56 +0000295 // We will write to this temp, so no reason to analyze the read.
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +0000296 NumOmittedReadsBeforeWrite++;
Kostya Serebryany2076af02012-04-10 18:18:56 +0000297 continue;
298 }
Kostya Serebryanycff60c12012-04-10 22:29:17 +0000299 if (addrPointsToConstantData(Addr)) {
300 // Addr points to some constant data -- it can not race with any writes.
301 continue;
302 }
Kostya Serebryany2076af02012-04-10 18:18:56 +0000303 }
304 All.push_back(I);
305 }
306 Local.clear();
307}
308
Kostya Serebryanye5079222012-04-27 07:31:53 +0000309static bool isAtomic(Instruction *I) {
310 if (LoadInst *LI = dyn_cast<LoadInst>(I))
311 return LI->isAtomic() && LI->getSynchScope() == CrossThread;
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000312 if (StoreInst *SI = dyn_cast<StoreInst>(I))
Kostya Serebryanye5079222012-04-27 07:31:53 +0000313 return SI->isAtomic() && SI->getSynchScope() == CrossThread;
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000314 if (isa<AtomicRMWInst>(I))
Kostya Serebryanye5079222012-04-27 07:31:53 +0000315 return true;
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000316 if (isa<AtomicCmpXchgInst>(I))
Kostya Serebryanye5079222012-04-27 07:31:53 +0000317 return true;
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000318 if (isa<FenceInst>(I))
319 return true;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000320 return false;
321}
322
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000323bool ThreadSanitizer::runOnFunction(Function &F) {
Stephen Hines36b56882014-04-23 16:57:46 -0700324 if (!DL) return false;
Kostya Serebryany6e590e32012-03-14 23:33:24 +0000325 if (BL->isIn(F)) return false;
Kostya Serebryany8b390ff2012-11-29 09:54:21 +0000326 initializeCallbacks(*F.getParent());
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000327 SmallVector<Instruction*, 8> RetVec;
Kostya Serebryany2076af02012-04-10 18:18:56 +0000328 SmallVector<Instruction*, 8> AllLoadsAndStores;
329 SmallVector<Instruction*, 8> LocalLoadsAndStores;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000330 SmallVector<Instruction*, 8> AtomicAccesses;
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000331 SmallVector<Instruction*, 8> MemIntrinCalls;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000332 bool Res = false;
333 bool HasCalls = false;
334
335 // Traverse all instructions, collect loads/stores/returns, check for calls.
336 for (Function::iterator FI = F.begin(), FE = F.end();
337 FI != FE; ++FI) {
338 BasicBlock &BB = *FI;
339 for (BasicBlock::iterator BI = BB.begin(), BE = BB.end();
340 BI != BE; ++BI) {
Kostya Serebryanye5079222012-04-27 07:31:53 +0000341 if (isAtomic(BI))
342 AtomicAccesses.push_back(BI);
343 else if (isa<LoadInst>(BI) || isa<StoreInst>(BI))
Kostya Serebryany2076af02012-04-10 18:18:56 +0000344 LocalLoadsAndStores.push_back(BI);
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000345 else if (isa<ReturnInst>(BI))
346 RetVec.push_back(BI);
Kostya Serebryany2076af02012-04-10 18:18:56 +0000347 else if (isa<CallInst>(BI) || isa<InvokeInst>(BI)) {
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000348 if (isa<MemIntrinsic>(BI))
349 MemIntrinCalls.push_back(BI);
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000350 HasCalls = true;
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000351 chooseInstructionsToInstrument(LocalLoadsAndStores, AllLoadsAndStores);
Kostya Serebryany2076af02012-04-10 18:18:56 +0000352 }
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000353 }
Kostya Serebryany37cb9ac2012-05-02 13:12:19 +0000354 chooseInstructionsToInstrument(LocalLoadsAndStores, AllLoadsAndStores);
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000355 }
356
357 // We have collected all loads and stores.
358 // FIXME: many of these accesses do not need to be checked for races
359 // (e.g. variables that do not escape, etc).
360
361 // Instrument memory accesses.
Dmitry Vyukov4ef19992013-10-17 07:20:06 +0000362 if (ClInstrumentMemoryAccesses && F.hasFnAttribute(Attribute::SanitizeThread))
Kostya Serebryany41d876c2012-10-04 05:28:50 +0000363 for (size_t i = 0, n = AllLoadsAndStores.size(); i < n; ++i) {
364 Res |= instrumentLoadOrStore(AllLoadsAndStores[i]);
365 }
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000366
Kostya Serebryanye5079222012-04-27 07:31:53 +0000367 // Instrument atomic memory accesses.
Kostya Serebryany41d876c2012-10-04 05:28:50 +0000368 if (ClInstrumentAtomics)
369 for (size_t i = 0, n = AtomicAccesses.size(); i < n; ++i) {
370 Res |= instrumentAtomic(AtomicAccesses[i]);
371 }
Kostya Serebryanye5079222012-04-27 07:31:53 +0000372
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000373 if (ClInstrumentMemIntrinsics)
374 for (size_t i = 0, n = MemIntrinCalls.size(); i < n; ++i) {
375 Res |= instrumentMemIntrinsic(MemIntrinCalls[i]);
376 }
377
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000378 // Instrument function entry/exit points if there were instrumented accesses.
Kostya Serebryany41d876c2012-10-04 05:28:50 +0000379 if ((Res || HasCalls) && ClInstrumentFuncEntryExit) {
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000380 IRBuilder<> IRB(F.getEntryBlock().getFirstNonPHI());
381 Value *ReturnAddress = IRB.CreateCall(
382 Intrinsic::getDeclaration(F.getParent(), Intrinsic::returnaddress),
383 IRB.getInt32(0));
384 IRB.CreateCall(TsanFuncEntry, ReturnAddress);
385 for (size_t i = 0, n = RetVec.size(); i < n; ++i) {
386 IRBuilder<> IRBRet(RetVec[i]);
387 IRBRet.CreateCall(TsanFuncExit);
388 }
Kostya Serebryany52eb69922012-03-26 17:35:03 +0000389 Res = true;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000390 }
391 return Res;
392}
393
394bool ThreadSanitizer::instrumentLoadOrStore(Instruction *I) {
395 IRBuilder<> IRB(I);
396 bool IsWrite = isa<StoreInst>(*I);
397 Value *Addr = IsWrite
398 ? cast<StoreInst>(I)->getPointerOperand()
399 : cast<LoadInst>(I)->getPointerOperand();
Kostya Serebryanye5079222012-04-27 07:31:53 +0000400 int Idx = getMemoryAccessFuncIndex(Addr);
401 if (Idx < 0)
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000402 return false;
Kostya Serebryany52eb69922012-03-26 17:35:03 +0000403 if (IsWrite && isVtableAccess(I)) {
Kostya Serebryany4a002ab2012-07-05 09:07:31 +0000404 DEBUG(dbgs() << " VPTR : " << *I << "\n");
Kostya Serebryany52eb69922012-03-26 17:35:03 +0000405 Value *StoredValue = cast<StoreInst>(I)->getValueOperand();
Stephen Hines36b56882014-04-23 16:57:46 -0700406 // StoredValue may be a vector type if we are storing several vptrs at once.
407 // In this case, just take the first element of the vector since this is
408 // enough to find vptr races.
409 if (isa<VectorType>(StoredValue->getType()))
410 StoredValue = IRB.CreateExtractElement(
411 StoredValue, ConstantInt::get(IRB.getInt32Ty(), 0));
412 if (StoredValue->getType()->isIntegerTy())
Kostya Serebryany4a002ab2012-07-05 09:07:31 +0000413 StoredValue = IRB.CreateIntToPtr(StoredValue, IRB.getInt8PtrTy());
414 // Call TsanVptrUpdate.
Kostya Serebryany52eb69922012-03-26 17:35:03 +0000415 IRB.CreateCall2(TsanVptrUpdate,
416 IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()),
417 IRB.CreatePointerCast(StoredValue, IRB.getInt8PtrTy()));
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +0000418 NumInstrumentedVtableWrites++;
Kostya Serebryany52eb69922012-03-26 17:35:03 +0000419 return true;
420 }
Dmitry Vyukovab78ac12013-03-22 08:51:22 +0000421 if (!IsWrite && isVtableAccess(I)) {
422 IRB.CreateCall(TsanVptrLoad,
423 IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()));
424 NumInstrumentedVtableReads++;
425 return true;
426 }
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000427 Value *OnAccessFunc = IsWrite ? TsanWrite[Idx] : TsanRead[Idx];
428 IRB.CreateCall(OnAccessFunc, IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()));
Kostya Serebryany2d5fdf82012-04-23 08:44:59 +0000429 if (IsWrite) NumInstrumentedWrites++;
430 else NumInstrumentedReads++;
Kostya Serebryany60ebb1942012-02-13 22:50:51 +0000431 return true;
432}
Kostya Serebryanye5079222012-04-27 07:31:53 +0000433
434static ConstantInt *createOrdering(IRBuilder<> *IRB, AtomicOrdering ord) {
435 uint32_t v = 0;
436 switch (ord) {
437 case NotAtomic: assert(false);
438 case Unordered: // Fall-through.
Dmitry Vyukovc2e9ca12012-11-09 14:12:16 +0000439 case Monotonic: v = 0; break;
Dmitry Vyukov9a33f9f2012-11-26 14:55:26 +0000440 // case Consume: v = 1; break; // Not specified yet.
Dmitry Vyukovc2e9ca12012-11-09 14:12:16 +0000441 case Acquire: v = 2; break;
442 case Release: v = 3; break;
443 case AcquireRelease: v = 4; break;
444 case SequentiallyConsistent: v = 5; break;
Kostya Serebryanye5079222012-04-27 07:31:53 +0000445 }
Dmitry Vyukovc2e9ca12012-11-09 14:12:16 +0000446 return IRB->getInt32(v);
Kostya Serebryanye5079222012-04-27 07:31:53 +0000447}
448
Kostya Serebryanyf4644812013-03-28 11:21:13 +0000449// If a memset intrinsic gets inlined by the code gen, we will miss races on it.
450// So, we either need to ensure the intrinsic is not inlined, or instrument it.
451// We do not instrument memset/memmove/memcpy intrinsics (too complicated),
452// instead we simply replace them with regular function calls, which are then
453// intercepted by the run-time.
454// Since tsan is running after everyone else, the calls should not be
455// replaced back with intrinsics. If that becomes wrong at some point,
456// we will need to call e.g. __tsan_memset to avoid the intrinsics.
457bool ThreadSanitizer::instrumentMemIntrinsic(Instruction *I) {
458 IRBuilder<> IRB(I);
459 if (MemSetInst *M = dyn_cast<MemSetInst>(I)) {
460 IRB.CreateCall3(MemsetFn,
461 IRB.CreatePointerCast(M->getArgOperand(0), IRB.getInt8PtrTy()),
462 IRB.CreateIntCast(M->getArgOperand(1), IRB.getInt32Ty(), false),
463 IRB.CreateIntCast(M->getArgOperand(2), IntptrTy, false));
464 I->eraseFromParent();
465 } else if (MemTransferInst *M = dyn_cast<MemTransferInst>(I)) {
466 IRB.CreateCall3(isa<MemCpyInst>(M) ? MemcpyFn : MemmoveFn,
467 IRB.CreatePointerCast(M->getArgOperand(0), IRB.getInt8PtrTy()),
468 IRB.CreatePointerCast(M->getArgOperand(1), IRB.getInt8PtrTy()),
469 IRB.CreateIntCast(M->getArgOperand(2), IntptrTy, false));
470 I->eraseFromParent();
471 }
472 return false;
473}
474
Dmitry Vyukov6702e532012-11-26 11:36:19 +0000475// Both llvm and ThreadSanitizer atomic operations are based on C++11/C1x
Stephen Hines36b56882014-04-23 16:57:46 -0700476// standards. For background see C++11 standard. A slightly older, publicly
Dmitry Vyukov6702e532012-11-26 11:36:19 +0000477// available draft of the standard (not entirely up-to-date, but close enough
478// for casual browsing) is available here:
Matt Beaumont-Gay70af9092012-11-26 16:27:22 +0000479// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2011/n3242.pdf
Dmitry Vyukov6702e532012-11-26 11:36:19 +0000480// The following page contains more background information:
481// http://www.hpl.hp.com/personal/Hans_Boehm/c++mm/
482
Kostya Serebryanye5079222012-04-27 07:31:53 +0000483bool ThreadSanitizer::instrumentAtomic(Instruction *I) {
484 IRBuilder<> IRB(I);
485 if (LoadInst *LI = dyn_cast<LoadInst>(I)) {
486 Value *Addr = LI->getPointerOperand();
487 int Idx = getMemoryAccessFuncIndex(Addr);
488 if (Idx < 0)
489 return false;
490 const size_t ByteSize = 1 << Idx;
491 const size_t BitSize = ByteSize * 8;
492 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
Micah Villmowb8bce922012-10-24 17:25:11 +0000493 Type *PtrTy = Ty->getPointerTo();
Kostya Serebryanye5079222012-04-27 07:31:53 +0000494 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
495 createOrdering(&IRB, LI->getOrdering())};
496 CallInst *C = CallInst::Create(TsanAtomicLoad[Idx],
497 ArrayRef<Value*>(Args));
498 ReplaceInstWithInst(I, C);
499
500 } else if (StoreInst *SI = dyn_cast<StoreInst>(I)) {
501 Value *Addr = SI->getPointerOperand();
502 int Idx = getMemoryAccessFuncIndex(Addr);
503 if (Idx < 0)
504 return false;
505 const size_t ByteSize = 1 << Idx;
506 const size_t BitSize = ByteSize * 8;
507 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
Micah Villmowb8bce922012-10-24 17:25:11 +0000508 Type *PtrTy = Ty->getPointerTo();
Kostya Serebryanye5079222012-04-27 07:31:53 +0000509 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
510 IRB.CreateIntCast(SI->getValueOperand(), Ty, false),
511 createOrdering(&IRB, SI->getOrdering())};
512 CallInst *C = CallInst::Create(TsanAtomicStore[Idx],
513 ArrayRef<Value*>(Args));
514 ReplaceInstWithInst(I, C);
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000515 } else if (AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(I)) {
516 Value *Addr = RMWI->getPointerOperand();
517 int Idx = getMemoryAccessFuncIndex(Addr);
518 if (Idx < 0)
519 return false;
520 Function *F = TsanAtomicRMW[RMWI->getOperation()][Idx];
Stephen Hinesdce4a402014-05-29 02:49:00 -0700521 if (!F)
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000522 return false;
523 const size_t ByteSize = 1 << Idx;
524 const size_t BitSize = ByteSize * 8;
525 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
526 Type *PtrTy = Ty->getPointerTo();
527 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
528 IRB.CreateIntCast(RMWI->getValOperand(), Ty, false),
529 createOrdering(&IRB, RMWI->getOrdering())};
530 CallInst *C = CallInst::Create(F, ArrayRef<Value*>(Args));
531 ReplaceInstWithInst(I, C);
532 } else if (AtomicCmpXchgInst *CASI = dyn_cast<AtomicCmpXchgInst>(I)) {
533 Value *Addr = CASI->getPointerOperand();
534 int Idx = getMemoryAccessFuncIndex(Addr);
535 if (Idx < 0)
536 return false;
537 const size_t ByteSize = 1 << Idx;
538 const size_t BitSize = ByteSize * 8;
539 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
540 Type *PtrTy = Ty->getPointerTo();
541 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
542 IRB.CreateIntCast(CASI->getCompareOperand(), Ty, false),
543 IRB.CreateIntCast(CASI->getNewValOperand(), Ty, false),
Stephen Hines36b56882014-04-23 16:57:46 -0700544 createOrdering(&IRB, CASI->getSuccessOrdering()),
545 createOrdering(&IRB, CASI->getFailureOrdering())};
Dmitry Vyukov9f8a90b2012-11-09 12:55:36 +0000546 CallInst *C = CallInst::Create(TsanAtomicCAS[Idx], ArrayRef<Value*>(Args));
547 ReplaceInstWithInst(I, C);
548 } else if (FenceInst *FI = dyn_cast<FenceInst>(I)) {
549 Value *Args[] = {createOrdering(&IRB, FI->getOrdering())};
550 Function *F = FI->getSynchScope() == SingleThread ?
551 TsanAtomicSignalFence : TsanAtomicThreadFence;
552 CallInst *C = CallInst::Create(F, ArrayRef<Value*>(Args));
553 ReplaceInstWithInst(I, C);
Kostya Serebryanye5079222012-04-27 07:31:53 +0000554 }
555 return true;
556}
557
558int ThreadSanitizer::getMemoryAccessFuncIndex(Value *Addr) {
559 Type *OrigPtrTy = Addr->getType();
560 Type *OrigTy = cast<PointerType>(OrigPtrTy)->getElementType();
561 assert(OrigTy->isSized());
Stephen Hines36b56882014-04-23 16:57:46 -0700562 uint32_t TypeSize = DL->getTypeStoreSizeInBits(OrigTy);
Kostya Serebryanye5079222012-04-27 07:31:53 +0000563 if (TypeSize != 8 && TypeSize != 16 &&
564 TypeSize != 32 && TypeSize != 64 && TypeSize != 128) {
565 NumAccessesWithBadSize++;
566 // Ignore all unusual sizes.
567 return -1;
568 }
Michael J. Spencerc6af2432013-05-24 22:23:49 +0000569 size_t Idx = countTrailingZeros(TypeSize / 8);
Kostya Serebryanye5079222012-04-27 07:31:53 +0000570 assert(Idx < kNumberOfAccessSizes);
571 return Idx;
572}