blob: d7cb47890e84455cea0c3fafafc67d80ef4dcca4 [file] [log] [blame]
Kostya Serebryanye2a0e412012-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
Dmitry Vyukov2e8d82e2015-02-12 09:55:28 +000022#include "llvm/Analysis/CaptureTracking.h"
23#include "llvm/Analysis/ValueTracking.h"
Chandler Carruthed0881b2012-12-03 16:50:05 +000024#include "llvm/Transforms/Instrumentation.h"
Chandler Carruthed0881b2012-12-03 16:50:05 +000025#include "llvm/ADT/SmallSet.h"
26#include "llvm/ADT/SmallString.h"
27#include "llvm/ADT/SmallVector.h"
28#include "llvm/ADT/Statistic.h"
29#include "llvm/ADT/StringExtras.h"
Chandler Carruth9fb823b2013-01-02 11:36:10 +000030#include "llvm/IR/DataLayout.h"
31#include "llvm/IR/Function.h"
32#include "llvm/IR/IRBuilder.h"
Kostya Serebryany463aa812013-03-28 11:21:13 +000033#include "llvm/IR/IntrinsicInst.h"
Chandler Carruth9fb823b2013-01-02 11:36:10 +000034#include "llvm/IR/Intrinsics.h"
35#include "llvm/IR/LLVMContext.h"
36#include "llvm/IR/Metadata.h"
37#include "llvm/IR/Module.h"
38#include "llvm/IR/Type.h"
Kostya Serebryanyabad0022012-03-14 23:33:24 +000039#include "llvm/Support/CommandLine.h"
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000040#include "llvm/Support/Debug.h"
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000041#include "llvm/Support/MathExtras.h"
Kostya Serebryany6f8a7762012-03-26 17:35:03 +000042#include "llvm/Support/raw_ostream.h"
Kostya Serebryanya1259772012-04-27 07:31:53 +000043#include "llvm/Transforms/Utils/BasicBlockUtils.h"
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000044#include "llvm/Transforms/Utils/ModuleUtils.h"
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000045
46using namespace llvm;
47
Chandler Carruth964daaa2014-04-22 02:55:47 +000048#define DEBUG_TYPE "tsan"
49
Kostya Serebryanyd23b18f2012-10-04 05:28:50 +000050static cl::opt<bool> ClInstrumentMemoryAccesses(
51 "tsan-instrument-memory-accesses", cl::init(true),
52 cl::desc("Instrument memory accesses"), cl::Hidden);
53static cl::opt<bool> ClInstrumentFuncEntryExit(
54 "tsan-instrument-func-entry-exit", cl::init(true),
55 cl::desc("Instrument function entry and exit"), cl::Hidden);
56static cl::opt<bool> ClInstrumentAtomics(
57 "tsan-instrument-atomics", cl::init(true),
58 cl::desc("Instrument atomics"), cl::Hidden);
Kostya Serebryany463aa812013-03-28 11:21:13 +000059static cl::opt<bool> ClInstrumentMemIntrinsics(
60 "tsan-instrument-memintrinsics", cl::init(true),
61 cl::desc("Instrument memintrinsics (memset/memcpy/memmove)"), cl::Hidden);
Kostya Serebryanyabad0022012-03-14 23:33:24 +000062
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +000063STATISTIC(NumInstrumentedReads, "Number of instrumented reads");
64STATISTIC(NumInstrumentedWrites, "Number of instrumented writes");
Alexey Samsonovf54e3aa2012-08-30 13:47:13 +000065STATISTIC(NumOmittedReadsBeforeWrite,
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +000066 "Number of reads ignored due to following writes");
67STATISTIC(NumAccessesWithBadSize, "Number of accesses with bad size");
68STATISTIC(NumInstrumentedVtableWrites, "Number of vtable ptr writes");
Dmitry Vyukov55e63ef2013-03-22 08:51:22 +000069STATISTIC(NumInstrumentedVtableReads, "Number of vtable ptr reads");
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +000070STATISTIC(NumOmittedReadsFromConstantGlobals,
71 "Number of reads from constant globals");
72STATISTIC(NumOmittedReadsFromVtable, "Number of vtable reads");
Dmitry Vyukov2e8d82e2015-02-12 09:55:28 +000073STATISTIC(NumOmittedNonCaptured, "Number of accesses ignored due to capturing");
Kostya Serebryanybf2de802012-04-10 18:18:56 +000074
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000075namespace {
Kostya Serebryanybf2de802012-04-10 18:18:56 +000076
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000077/// ThreadSanitizer: instrument the code in module to find races.
78struct ThreadSanitizer : public FunctionPass {
Mehdi Aminia28d91d2015-03-10 02:37:25 +000079 ThreadSanitizer() : FunctionPass(ID) {}
Craig Topper3e4c6972014-03-05 09:10:37 +000080 const char *getPassName() const override;
81 bool runOnFunction(Function &F) override;
82 bool doInitialization(Module &M) override;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000083 static char ID; // Pass identification, replacement for typeid.
84
85 private:
Kostya Serebryany4b929da2012-11-29 09:54:21 +000086 void initializeCallbacks(Module &M);
Mehdi Aminia28d91d2015-03-10 02:37:25 +000087 bool instrumentLoadOrStore(Instruction *I, const DataLayout &DL);
88 bool instrumentAtomic(Instruction *I, const DataLayout &DL);
Kostya Serebryany463aa812013-03-28 11:21:13 +000089 bool instrumentMemIntrinsic(Instruction *I);
Mehdi Aminia28d91d2015-03-10 02:37:25 +000090 void chooseInstructionsToInstrument(SmallVectorImpl<Instruction *> &Local,
91 SmallVectorImpl<Instruction *> &All,
92 const DataLayout &DL);
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +000093 bool addrPointsToConstantData(Value *Addr);
Mehdi Aminia28d91d2015-03-10 02:37:25 +000094 int getMemoryAccessFuncIndex(Value *Addr, const DataLayout &DL);
Kostya Serebryanybf2de802012-04-10 18:18:56 +000095
Kostya Serebryany463aa812013-03-28 11:21:13 +000096 Type *IntptrTy;
Kostya Serebryanya1259772012-04-27 07:31:53 +000097 IntegerType *OrdTy;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +000098 // Callbacks to run-time library are computed in doInitialization.
Kostya Serebryanya1259772012-04-27 07:31:53 +000099 Function *TsanFuncEntry;
100 Function *TsanFuncExit;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000101 // Accesses sizes are powers of two: 1, 2, 4, 8, 16.
Kostya Serebryanya8531ee2012-02-14 00:52:07 +0000102 static const size_t kNumberOfAccessSizes = 5;
Kostya Serebryanya1259772012-04-27 07:31:53 +0000103 Function *TsanRead[kNumberOfAccessSizes];
104 Function *TsanWrite[kNumberOfAccessSizes];
Dmitry Vyukov91ffdec2015-01-27 20:19:17 +0000105 Function *TsanUnalignedRead[kNumberOfAccessSizes];
106 Function *TsanUnalignedWrite[kNumberOfAccessSizes];
Kostya Serebryanya1259772012-04-27 07:31:53 +0000107 Function *TsanAtomicLoad[kNumberOfAccessSizes];
108 Function *TsanAtomicStore[kNumberOfAccessSizes];
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000109 Function *TsanAtomicRMW[AtomicRMWInst::LAST_BINOP + 1][kNumberOfAccessSizes];
110 Function *TsanAtomicCAS[kNumberOfAccessSizes];
111 Function *TsanAtomicThreadFence;
112 Function *TsanAtomicSignalFence;
Kostya Serebryanya1259772012-04-27 07:31:53 +0000113 Function *TsanVptrUpdate;
Dmitry Vyukov55e63ef2013-03-22 08:51:22 +0000114 Function *TsanVptrLoad;
Kostya Serebryany463aa812013-03-28 11:21:13 +0000115 Function *MemmoveFn, *MemcpyFn, *MemsetFn;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000116};
117} // namespace
118
119char ThreadSanitizer::ID = 0;
120INITIALIZE_PASS(ThreadSanitizer, "tsan",
121 "ThreadSanitizer: detects data races.",
122 false, false)
123
Kostya Serebryanya1259772012-04-27 07:31:53 +0000124const char *ThreadSanitizer::getPassName() const {
125 return "ThreadSanitizer";
126}
127
Alexey Samsonov6d8bab82014-06-02 18:08:27 +0000128FunctionPass *llvm::createThreadSanitizerPass() {
129 return new ThreadSanitizer();
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000130}
131
Kostya Serebryanya1259772012-04-27 07:31:53 +0000132static Function *checkInterfaceFunction(Constant *FuncOrBitcast) {
133 if (Function *F = dyn_cast<Function>(FuncOrBitcast))
134 return F;
135 FuncOrBitcast->dump();
136 report_fatal_error("ThreadSanitizer interface function redefined");
137}
138
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000139void ThreadSanitizer::initializeCallbacks(Module &M) {
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000140 IRBuilder<> IRB(M.getContext());
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000141 // Initialize the callbacks.
Kostya Serebryanya1259772012-04-27 07:31:53 +0000142 TsanFuncEntry = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000143 "__tsan_func_entry", IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
Kostya Serebryanya1259772012-04-27 07:31:53 +0000144 TsanFuncExit = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000145 "__tsan_func_exit", IRB.getVoidTy(), nullptr));
Kostya Serebryanya1259772012-04-27 07:31:53 +0000146 OrdTy = IRB.getInt32Ty();
Kostya Serebryanya8531ee2012-02-14 00:52:07 +0000147 for (size_t i = 0; i < kNumberOfAccessSizes; ++i) {
Kostya Serebryanya1259772012-04-27 07:31:53 +0000148 const size_t ByteSize = 1 << i;
149 const size_t BitSize = ByteSize * 8;
150 SmallString<32> ReadName("__tsan_read" + itostr(ByteSize));
151 TsanRead[i] = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000152 ReadName, IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
Kostya Serebryanya1259772012-04-27 07:31:53 +0000153
154 SmallString<32> WriteName("__tsan_write" + itostr(ByteSize));
155 TsanWrite[i] = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000156 WriteName, IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
Kostya Serebryanya1259772012-04-27 07:31:53 +0000157
Dmitry Vyukov91ffdec2015-01-27 20:19:17 +0000158 SmallString<64> UnalignedReadName("__tsan_unaligned_read" +
159 itostr(ByteSize));
160 TsanUnalignedRead[i] = checkInterfaceFunction(M.getOrInsertFunction(
161 UnalignedReadName, IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
162
163 SmallString<64> UnalignedWriteName("__tsan_unaligned_write" +
164 itostr(ByteSize));
165 TsanUnalignedWrite[i] = checkInterfaceFunction(M.getOrInsertFunction(
166 UnalignedWriteName, IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
167
Kostya Serebryanya1259772012-04-27 07:31:53 +0000168 Type *Ty = Type::getIntNTy(M.getContext(), BitSize);
169 Type *PtrTy = Ty->getPointerTo();
170 SmallString<32> AtomicLoadName("__tsan_atomic" + itostr(BitSize) +
171 "_load");
172 TsanAtomicLoad[i] = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000173 AtomicLoadName, Ty, PtrTy, OrdTy, nullptr));
Kostya Serebryanya1259772012-04-27 07:31:53 +0000174
175 SmallString<32> AtomicStoreName("__tsan_atomic" + itostr(BitSize) +
176 "_store");
177 TsanAtomicStore[i] = checkInterfaceFunction(M.getOrInsertFunction(
178 AtomicStoreName, IRB.getVoidTy(), PtrTy, Ty, OrdTy,
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000179 nullptr));
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000180
181 for (int op = AtomicRMWInst::FIRST_BINOP;
182 op <= AtomicRMWInst::LAST_BINOP; ++op) {
Craig Topperf40110f2014-04-25 05:29:35 +0000183 TsanAtomicRMW[op][i] = nullptr;
184 const char *NamePart = nullptr;
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000185 if (op == AtomicRMWInst::Xchg)
186 NamePart = "_exchange";
187 else if (op == AtomicRMWInst::Add)
188 NamePart = "_fetch_add";
189 else if (op == AtomicRMWInst::Sub)
190 NamePart = "_fetch_sub";
191 else if (op == AtomicRMWInst::And)
192 NamePart = "_fetch_and";
193 else if (op == AtomicRMWInst::Or)
194 NamePart = "_fetch_or";
195 else if (op == AtomicRMWInst::Xor)
196 NamePart = "_fetch_xor";
Dmitry Vyukova878e742012-11-27 08:09:25 +0000197 else if (op == AtomicRMWInst::Nand)
198 NamePart = "_fetch_nand";
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000199 else
200 continue;
201 SmallString<32> RMWName("__tsan_atomic" + itostr(BitSize) + NamePart);
202 TsanAtomicRMW[op][i] = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000203 RMWName, Ty, PtrTy, Ty, OrdTy, nullptr));
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000204 }
205
206 SmallString<32> AtomicCASName("__tsan_atomic" + itostr(BitSize) +
207 "_compare_exchange_val");
208 TsanAtomicCAS[i] = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000209 AtomicCASName, Ty, PtrTy, Ty, Ty, OrdTy, OrdTy, nullptr));
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000210 }
Kostya Serebryanya1259772012-04-27 07:31:53 +0000211 TsanVptrUpdate = checkInterfaceFunction(M.getOrInsertFunction(
212 "__tsan_vptr_update", IRB.getVoidTy(), IRB.getInt8PtrTy(),
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000213 IRB.getInt8PtrTy(), nullptr));
Dmitry Vyukov55e63ef2013-03-22 08:51:22 +0000214 TsanVptrLoad = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000215 "__tsan_vptr_read", IRB.getVoidTy(), IRB.getInt8PtrTy(), nullptr));
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000216 TsanAtomicThreadFence = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000217 "__tsan_atomic_thread_fence", IRB.getVoidTy(), OrdTy, nullptr));
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000218 TsanAtomicSignalFence = checkInterfaceFunction(M.getOrInsertFunction(
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000219 "__tsan_atomic_signal_fence", IRB.getVoidTy(), OrdTy, nullptr));
Kostya Serebryany463aa812013-03-28 11:21:13 +0000220
221 MemmoveFn = checkInterfaceFunction(M.getOrInsertFunction(
222 "memmove", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(),
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000223 IRB.getInt8PtrTy(), IntptrTy, nullptr));
Kostya Serebryany463aa812013-03-28 11:21:13 +0000224 MemcpyFn = checkInterfaceFunction(M.getOrInsertFunction(
225 "memcpy", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(), IRB.getInt8PtrTy(),
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000226 IntptrTy, nullptr));
Kostya Serebryany463aa812013-03-28 11:21:13 +0000227 MemsetFn = checkInterfaceFunction(M.getOrInsertFunction(
228 "memset", IRB.getInt8PtrTy(), IRB.getInt8PtrTy(), IRB.getInt32Ty(),
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000229 IntptrTy, nullptr));
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000230}
231
232bool ThreadSanitizer::doInitialization(Module &M) {
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000233 const DataLayout &DL = M.getDataLayout();
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000234
235 // Always insert a call to __tsan_init into the module's CTORs.
236 IRBuilder<> IRB(M.getContext());
Rafael Espindola37dc9e12014-02-21 00:06:31 +0000237 IntptrTy = IRB.getIntPtrTy(DL);
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000238 Value *TsanInit = M.getOrInsertFunction("__tsan_init",
Reid Kleckner971c3ea2014-11-13 22:55:19 +0000239 IRB.getVoidTy(), nullptr);
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000240 appendToGlobalCtors(M, cast<Function>(TsanInit), 0);
241
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000242 return true;
243}
244
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000245static bool isVtableAccess(Instruction *I) {
Duncan P. N. Exon Smithde36e802014-11-11 21:30:22 +0000246 if (MDNode *Tag = I->getMetadata(LLVMContext::MD_tbaa))
Manman Rend8c68b12013-09-06 22:47:05 +0000247 return Tag->isTBAAVtableAccess();
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000248 return false;
249}
250
251bool ThreadSanitizer::addrPointsToConstantData(Value *Addr) {
252 // If this is a GEP, just analyze its pointer operand.
253 if (GetElementPtrInst *GEP = dyn_cast<GetElementPtrInst>(Addr))
254 Addr = GEP->getPointerOperand();
255
256 if (GlobalVariable *GV = dyn_cast<GlobalVariable>(Addr)) {
257 if (GV->isConstant()) {
258 // Reads from constant globals can not race with any writes.
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +0000259 NumOmittedReadsFromConstantGlobals++;
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000260 return true;
261 }
Alexey Samsonovf54e3aa2012-08-30 13:47:13 +0000262 } else if (LoadInst *L = dyn_cast<LoadInst>(Addr)) {
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000263 if (isVtableAccess(L)) {
264 // Reads from a vtable pointer can not race with any writes.
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +0000265 NumOmittedReadsFromVtable++;
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000266 return true;
267 }
268 }
269 return false;
270}
271
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000272// Instrumenting some of the accesses may be proven redundant.
273// Currently handled:
274// - read-before-write (within same BB, no calls between)
Dmitry Vyukov2e8d82e2015-02-12 09:55:28 +0000275// - not captured variables
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000276//
277// We do not handle some of the patterns that should not survive
278// after the classic compiler optimizations.
279// E.g. two reads from the same temp should be eliminated by CSE,
280// two writes should be eliminated by DSE, etc.
281//
282// 'Local' is a vector of insns within the same BB (no calls between).
283// 'All' is a vector of insns that will be instrumented.
Kostya Serebryanyae7188d2012-05-02 13:12:19 +0000284void ThreadSanitizer::chooseInstructionsToInstrument(
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000285 SmallVectorImpl<Instruction *> &Local, SmallVectorImpl<Instruction *> &All,
286 const DataLayout &DL) {
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000287 SmallSet<Value*, 8> WriteTargets;
288 // Iterate from the end.
289 for (SmallVectorImpl<Instruction*>::reverse_iterator It = Local.rbegin(),
290 E = Local.rend(); It != E; ++It) {
291 Instruction *I = *It;
292 if (StoreInst *Store = dyn_cast<StoreInst>(I)) {
293 WriteTargets.insert(Store->getPointerOperand());
294 } else {
295 LoadInst *Load = cast<LoadInst>(I);
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000296 Value *Addr = Load->getPointerOperand();
297 if (WriteTargets.count(Addr)) {
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000298 // We will write to this temp, so no reason to analyze the read.
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +0000299 NumOmittedReadsBeforeWrite++;
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000300 continue;
301 }
Kostya Serebryany5ba61ac2012-04-10 22:29:17 +0000302 if (addrPointsToConstantData(Addr)) {
303 // Addr points to some constant data -- it can not race with any writes.
304 continue;
305 }
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000306 }
Dmitry Vyukov2e8d82e2015-02-12 09:55:28 +0000307 Value *Addr = isa<StoreInst>(*I)
308 ? cast<StoreInst>(I)->getPointerOperand()
309 : cast<LoadInst>(I)->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000310 if (isa<AllocaInst>(GetUnderlyingObject(Addr, DL)) &&
Dmitry Vyukov2e8d82e2015-02-12 09:55:28 +0000311 !PointerMayBeCaptured(Addr, true, true)) {
312 // The variable is addressable but not captured, so it cannot be
313 // referenced from a different thread and participate in a data race
314 // (see llvm/Analysis/CaptureTracking.h for details).
315 NumOmittedNonCaptured++;
316 continue;
317 }
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000318 All.push_back(I);
319 }
320 Local.clear();
321}
322
Kostya Serebryanya1259772012-04-27 07:31:53 +0000323static bool isAtomic(Instruction *I) {
324 if (LoadInst *LI = dyn_cast<LoadInst>(I))
325 return LI->isAtomic() && LI->getSynchScope() == CrossThread;
Kostya Serebryanyae7188d2012-05-02 13:12:19 +0000326 if (StoreInst *SI = dyn_cast<StoreInst>(I))
Kostya Serebryanya1259772012-04-27 07:31:53 +0000327 return SI->isAtomic() && SI->getSynchScope() == CrossThread;
Kostya Serebryanyae7188d2012-05-02 13:12:19 +0000328 if (isa<AtomicRMWInst>(I))
Kostya Serebryanya1259772012-04-27 07:31:53 +0000329 return true;
Kostya Serebryanyae7188d2012-05-02 13:12:19 +0000330 if (isa<AtomicCmpXchgInst>(I))
Kostya Serebryanya1259772012-04-27 07:31:53 +0000331 return true;
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000332 if (isa<FenceInst>(I))
333 return true;
Kostya Serebryanya1259772012-04-27 07:31:53 +0000334 return false;
335}
336
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000337bool ThreadSanitizer::runOnFunction(Function &F) {
Kostya Serebryany4b929da2012-11-29 09:54:21 +0000338 initializeCallbacks(*F.getParent());
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000339 SmallVector<Instruction*, 8> RetVec;
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000340 SmallVector<Instruction*, 8> AllLoadsAndStores;
341 SmallVector<Instruction*, 8> LocalLoadsAndStores;
Kostya Serebryanya1259772012-04-27 07:31:53 +0000342 SmallVector<Instruction*, 8> AtomicAccesses;
Kostya Serebryany463aa812013-03-28 11:21:13 +0000343 SmallVector<Instruction*, 8> MemIntrinCalls;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000344 bool Res = false;
345 bool HasCalls = false;
Alexey Samsonov6d8bab82014-06-02 18:08:27 +0000346 bool SanitizeFunction = F.hasFnAttribute(Attribute::SanitizeThread);
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000347 const DataLayout &DL = F.getParent()->getDataLayout();
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000348
349 // Traverse all instructions, collect loads/stores/returns, check for calls.
Alexey Samsonova02e6642014-05-29 18:40:48 +0000350 for (auto &BB : F) {
351 for (auto &Inst : BB) {
352 if (isAtomic(&Inst))
353 AtomicAccesses.push_back(&Inst);
354 else if (isa<LoadInst>(Inst) || isa<StoreInst>(Inst))
355 LocalLoadsAndStores.push_back(&Inst);
356 else if (isa<ReturnInst>(Inst))
357 RetVec.push_back(&Inst);
358 else if (isa<CallInst>(Inst) || isa<InvokeInst>(Inst)) {
359 if (isa<MemIntrinsic>(Inst))
360 MemIntrinCalls.push_back(&Inst);
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000361 HasCalls = true;
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000362 chooseInstructionsToInstrument(LocalLoadsAndStores, AllLoadsAndStores,
363 DL);
Kostya Serebryanybf2de802012-04-10 18:18:56 +0000364 }
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000365 }
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000366 chooseInstructionsToInstrument(LocalLoadsAndStores, AllLoadsAndStores, DL);
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000367 }
368
369 // We have collected all loads and stores.
370 // FIXME: many of these accesses do not need to be checked for races
371 // (e.g. variables that do not escape, etc).
372
Alexey Samsonovd3828b82014-05-31 00:11:37 +0000373 // Instrument memory accesses only if we want to report bugs in the function.
374 if (ClInstrumentMemoryAccesses && SanitizeFunction)
Alexey Samsonova02e6642014-05-29 18:40:48 +0000375 for (auto Inst : AllLoadsAndStores) {
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000376 Res |= instrumentLoadOrStore(Inst, DL);
Kostya Serebryanyd23b18f2012-10-04 05:28:50 +0000377 }
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000378
Alexey Samsonovd3828b82014-05-31 00:11:37 +0000379 // Instrument atomic memory accesses in any case (they can be used to
380 // implement synchronization).
Kostya Serebryanyd23b18f2012-10-04 05:28:50 +0000381 if (ClInstrumentAtomics)
Alexey Samsonova02e6642014-05-29 18:40:48 +0000382 for (auto Inst : AtomicAccesses) {
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000383 Res |= instrumentAtomic(Inst, DL);
Kostya Serebryanyd23b18f2012-10-04 05:28:50 +0000384 }
Kostya Serebryanya1259772012-04-27 07:31:53 +0000385
Alexey Samsonovd3828b82014-05-31 00:11:37 +0000386 if (ClInstrumentMemIntrinsics && SanitizeFunction)
Alexey Samsonova02e6642014-05-29 18:40:48 +0000387 for (auto Inst : MemIntrinCalls) {
388 Res |= instrumentMemIntrinsic(Inst);
Kostya Serebryany463aa812013-03-28 11:21:13 +0000389 }
390
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000391 // Instrument function entry/exit points if there were instrumented accesses.
Kostya Serebryanyd23b18f2012-10-04 05:28:50 +0000392 if ((Res || HasCalls) && ClInstrumentFuncEntryExit) {
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000393 IRBuilder<> IRB(F.getEntryBlock().getFirstNonPHI());
394 Value *ReturnAddress = IRB.CreateCall(
395 Intrinsic::getDeclaration(F.getParent(), Intrinsic::returnaddress),
396 IRB.getInt32(0));
397 IRB.CreateCall(TsanFuncEntry, ReturnAddress);
Alexey Samsonova02e6642014-05-29 18:40:48 +0000398 for (auto RetInst : RetVec) {
399 IRBuilder<> IRBRet(RetInst);
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000400 IRBRet.CreateCall(TsanFuncExit);
401 }
Kostya Serebryany6f8a7762012-03-26 17:35:03 +0000402 Res = true;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000403 }
404 return Res;
405}
406
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000407bool ThreadSanitizer::instrumentLoadOrStore(Instruction *I,
408 const DataLayout &DL) {
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000409 IRBuilder<> IRB(I);
410 bool IsWrite = isa<StoreInst>(*I);
411 Value *Addr = IsWrite
412 ? cast<StoreInst>(I)->getPointerOperand()
413 : cast<LoadInst>(I)->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000414 int Idx = getMemoryAccessFuncIndex(Addr, DL);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000415 if (Idx < 0)
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000416 return false;
Kostya Serebryany6f8a7762012-03-26 17:35:03 +0000417 if (IsWrite && isVtableAccess(I)) {
Kostya Serebryanye36ae682012-07-05 09:07:31 +0000418 DEBUG(dbgs() << " VPTR : " << *I << "\n");
Kostya Serebryany6f8a7762012-03-26 17:35:03 +0000419 Value *StoredValue = cast<StoreInst>(I)->getValueOperand();
Kostya Serebryany08b9cf52013-12-02 08:07:15 +0000420 // StoredValue may be a vector type if we are storing several vptrs at once.
421 // In this case, just take the first element of the vector since this is
422 // enough to find vptr races.
423 if (isa<VectorType>(StoredValue->getType()))
424 StoredValue = IRB.CreateExtractElement(
425 StoredValue, ConstantInt::get(IRB.getInt32Ty(), 0));
Kostya Serebryany2460c3f2013-12-05 15:03:02 +0000426 if (StoredValue->getType()->isIntegerTy())
427 StoredValue = IRB.CreateIntToPtr(StoredValue, IRB.getInt8PtrTy());
Kostya Serebryanye36ae682012-07-05 09:07:31 +0000428 // Call TsanVptrUpdate.
Kostya Serebryany6f8a7762012-03-26 17:35:03 +0000429 IRB.CreateCall2(TsanVptrUpdate,
430 IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()),
Kostya Serebryany2460c3f2013-12-05 15:03:02 +0000431 IRB.CreatePointerCast(StoredValue, IRB.getInt8PtrTy()));
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +0000432 NumInstrumentedVtableWrites++;
Kostya Serebryany6f8a7762012-03-26 17:35:03 +0000433 return true;
434 }
Dmitry Vyukov55e63ef2013-03-22 08:51:22 +0000435 if (!IsWrite && isVtableAccess(I)) {
436 IRB.CreateCall(TsanVptrLoad,
437 IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()));
438 NumInstrumentedVtableReads++;
439 return true;
440 }
Dmitry Vyukov91ffdec2015-01-27 20:19:17 +0000441 const unsigned Alignment = IsWrite
442 ? cast<StoreInst>(I)->getAlignment()
443 : cast<LoadInst>(I)->getAlignment();
444 Type *OrigTy = cast<PointerType>(Addr->getType())->getElementType();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000445 const uint32_t TypeSize = DL.getTypeStoreSizeInBits(OrigTy);
Dmitry Vyukov91ffdec2015-01-27 20:19:17 +0000446 Value *OnAccessFunc = nullptr;
447 if (Alignment == 0 || Alignment >= 8 || (Alignment % (TypeSize / 8)) == 0)
448 OnAccessFunc = IsWrite ? TsanWrite[Idx] : TsanRead[Idx];
449 else
450 OnAccessFunc = IsWrite ? TsanUnalignedWrite[Idx] : TsanUnalignedRead[Idx];
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000451 IRB.CreateCall(OnAccessFunc, IRB.CreatePointerCast(Addr, IRB.getInt8PtrTy()));
Kostya Serebryany5a4b7a22012-04-23 08:44:59 +0000452 if (IsWrite) NumInstrumentedWrites++;
453 else NumInstrumentedReads++;
Kostya Serebryanye2a0e412012-02-13 22:50:51 +0000454 return true;
455}
Kostya Serebryanya1259772012-04-27 07:31:53 +0000456
457static ConstantInt *createOrdering(IRBuilder<> *IRB, AtomicOrdering ord) {
458 uint32_t v = 0;
459 switch (ord) {
Craig Topperd3c02f12015-01-05 10:15:49 +0000460 case NotAtomic: llvm_unreachable("unexpected atomic ordering!");
Kostya Serebryanya1259772012-04-27 07:31:53 +0000461 case Unordered: // Fall-through.
Dmitry Vyukov0044e382012-11-09 14:12:16 +0000462 case Monotonic: v = 0; break;
Dmitry Vyukov93e67b62012-11-26 14:55:26 +0000463 // case Consume: v = 1; break; // Not specified yet.
Dmitry Vyukov0044e382012-11-09 14:12:16 +0000464 case Acquire: v = 2; break;
465 case Release: v = 3; break;
466 case AcquireRelease: v = 4; break;
467 case SequentiallyConsistent: v = 5; break;
Kostya Serebryanya1259772012-04-27 07:31:53 +0000468 }
Dmitry Vyukov0044e382012-11-09 14:12:16 +0000469 return IRB->getInt32(v);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000470}
471
Kostya Serebryany463aa812013-03-28 11:21:13 +0000472// If a memset intrinsic gets inlined by the code gen, we will miss races on it.
473// So, we either need to ensure the intrinsic is not inlined, or instrument it.
474// We do not instrument memset/memmove/memcpy intrinsics (too complicated),
475// instead we simply replace them with regular function calls, which are then
476// intercepted by the run-time.
477// Since tsan is running after everyone else, the calls should not be
478// replaced back with intrinsics. If that becomes wrong at some point,
479// we will need to call e.g. __tsan_memset to avoid the intrinsics.
480bool ThreadSanitizer::instrumentMemIntrinsic(Instruction *I) {
481 IRBuilder<> IRB(I);
482 if (MemSetInst *M = dyn_cast<MemSetInst>(I)) {
483 IRB.CreateCall3(MemsetFn,
484 IRB.CreatePointerCast(M->getArgOperand(0), IRB.getInt8PtrTy()),
485 IRB.CreateIntCast(M->getArgOperand(1), IRB.getInt32Ty(), false),
486 IRB.CreateIntCast(M->getArgOperand(2), IntptrTy, false));
487 I->eraseFromParent();
488 } else if (MemTransferInst *M = dyn_cast<MemTransferInst>(I)) {
489 IRB.CreateCall3(isa<MemCpyInst>(M) ? MemcpyFn : MemmoveFn,
490 IRB.CreatePointerCast(M->getArgOperand(0), IRB.getInt8PtrTy()),
491 IRB.CreatePointerCast(M->getArgOperand(1), IRB.getInt8PtrTy()),
492 IRB.CreateIntCast(M->getArgOperand(2), IntptrTy, false));
493 I->eraseFromParent();
494 }
495 return false;
496}
497
Dmitry Vyukov12b5cb92012-11-26 11:36:19 +0000498// Both llvm and ThreadSanitizer atomic operations are based on C++11/C1x
Alp Tokercb402912014-01-24 17:20:08 +0000499// standards. For background see C++11 standard. A slightly older, publicly
Dmitry Vyukov12b5cb92012-11-26 11:36:19 +0000500// available draft of the standard (not entirely up-to-date, but close enough
501// for casual browsing) is available here:
Matt Beaumont-Gay000a3952012-11-26 16:27:22 +0000502// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2011/n3242.pdf
Dmitry Vyukov12b5cb92012-11-26 11:36:19 +0000503// The following page contains more background information:
504// http://www.hpl.hp.com/personal/Hans_Boehm/c++mm/
505
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000506bool ThreadSanitizer::instrumentAtomic(Instruction *I, const DataLayout &DL) {
Kostya Serebryanya1259772012-04-27 07:31:53 +0000507 IRBuilder<> IRB(I);
508 if (LoadInst *LI = dyn_cast<LoadInst>(I)) {
509 Value *Addr = LI->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000510 int Idx = getMemoryAccessFuncIndex(Addr, DL);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000511 if (Idx < 0)
512 return false;
513 const size_t ByteSize = 1 << Idx;
514 const size_t BitSize = ByteSize * 8;
515 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
Micah Villmow51e72462012-10-24 17:25:11 +0000516 Type *PtrTy = Ty->getPointerTo();
Kostya Serebryanya1259772012-04-27 07:31:53 +0000517 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
518 createOrdering(&IRB, LI->getOrdering())};
Craig Toppere1d12942014-08-27 05:25:25 +0000519 CallInst *C = CallInst::Create(TsanAtomicLoad[Idx], Args);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000520 ReplaceInstWithInst(I, C);
521
522 } else if (StoreInst *SI = dyn_cast<StoreInst>(I)) {
523 Value *Addr = SI->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000524 int Idx = getMemoryAccessFuncIndex(Addr, DL);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000525 if (Idx < 0)
526 return false;
527 const size_t ByteSize = 1 << Idx;
528 const size_t BitSize = ByteSize * 8;
529 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
Micah Villmow51e72462012-10-24 17:25:11 +0000530 Type *PtrTy = Ty->getPointerTo();
Kostya Serebryanya1259772012-04-27 07:31:53 +0000531 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
532 IRB.CreateIntCast(SI->getValueOperand(), Ty, false),
533 createOrdering(&IRB, SI->getOrdering())};
Craig Toppere1d12942014-08-27 05:25:25 +0000534 CallInst *C = CallInst::Create(TsanAtomicStore[Idx], Args);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000535 ReplaceInstWithInst(I, C);
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000536 } else if (AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(I)) {
537 Value *Addr = RMWI->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000538 int Idx = getMemoryAccessFuncIndex(Addr, DL);
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000539 if (Idx < 0)
540 return false;
541 Function *F = TsanAtomicRMW[RMWI->getOperation()][Idx];
Craig Topperf40110f2014-04-25 05:29:35 +0000542 if (!F)
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000543 return false;
544 const size_t ByteSize = 1 << Idx;
545 const size_t BitSize = ByteSize * 8;
546 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
547 Type *PtrTy = Ty->getPointerTo();
548 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
549 IRB.CreateIntCast(RMWI->getValOperand(), Ty, false),
550 createOrdering(&IRB, RMWI->getOrdering())};
Craig Toppere1d12942014-08-27 05:25:25 +0000551 CallInst *C = CallInst::Create(F, Args);
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000552 ReplaceInstWithInst(I, C);
553 } else if (AtomicCmpXchgInst *CASI = dyn_cast<AtomicCmpXchgInst>(I)) {
554 Value *Addr = CASI->getPointerOperand();
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000555 int Idx = getMemoryAccessFuncIndex(Addr, DL);
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000556 if (Idx < 0)
557 return false;
558 const size_t ByteSize = 1 << Idx;
559 const size_t BitSize = ByteSize * 8;
560 Type *Ty = Type::getIntNTy(IRB.getContext(), BitSize);
561 Type *PtrTy = Ty->getPointerTo();
562 Value *Args[] = {IRB.CreatePointerCast(Addr, PtrTy),
563 IRB.CreateIntCast(CASI->getCompareOperand(), Ty, false),
564 IRB.CreateIntCast(CASI->getNewValOperand(), Ty, false),
Tim Northovere94a5182014-03-11 10:48:52 +0000565 createOrdering(&IRB, CASI->getSuccessOrdering()),
566 createOrdering(&IRB, CASI->getFailureOrdering())};
Tim Northover420a2162014-06-13 14:24:07 +0000567 CallInst *C = IRB.CreateCall(TsanAtomicCAS[Idx], Args);
568 Value *Success = IRB.CreateICmpEQ(C, CASI->getCompareOperand());
569
570 Value *Res = IRB.CreateInsertValue(UndefValue::get(CASI->getType()), C, 0);
571 Res = IRB.CreateInsertValue(Res, Success, 1);
572
573 I->replaceAllUsesWith(Res);
574 I->eraseFromParent();
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000575 } else if (FenceInst *FI = dyn_cast<FenceInst>(I)) {
576 Value *Args[] = {createOrdering(&IRB, FI->getOrdering())};
577 Function *F = FI->getSynchScope() == SingleThread ?
578 TsanAtomicSignalFence : TsanAtomicThreadFence;
Craig Toppere1d12942014-08-27 05:25:25 +0000579 CallInst *C = CallInst::Create(F, Args);
Dmitry Vyukov92b9e1d2012-11-09 12:55:36 +0000580 ReplaceInstWithInst(I, C);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000581 }
582 return true;
583}
584
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000585int ThreadSanitizer::getMemoryAccessFuncIndex(Value *Addr,
586 const DataLayout &DL) {
Kostya Serebryanya1259772012-04-27 07:31:53 +0000587 Type *OrigPtrTy = Addr->getType();
588 Type *OrigTy = cast<PointerType>(OrigPtrTy)->getElementType();
589 assert(OrigTy->isSized());
Mehdi Aminia28d91d2015-03-10 02:37:25 +0000590 uint32_t TypeSize = DL.getTypeStoreSizeInBits(OrigTy);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000591 if (TypeSize != 8 && TypeSize != 16 &&
592 TypeSize != 32 && TypeSize != 64 && TypeSize != 128) {
593 NumAccessesWithBadSize++;
594 // Ignore all unusual sizes.
595 return -1;
596 }
Michael J. Spencerdf1ecbd72013-05-24 22:23:49 +0000597 size_t Idx = countTrailingZeros(TypeSize / 8);
Kostya Serebryanya1259772012-04-27 07:31:53 +0000598 assert(Idx < kNumberOfAccessSizes);
599 return Idx;
600}