Computer Laboratory

Caller.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012-2013 Jonathan Anderson
3  * All rights reserved.
4  *
5  * This software was developed by SRI International and the University of
6  * Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237)
7  * ("CTSRD"), as part of the DARPA CRASH research programme.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in the
16  * documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  */
30 
31 #ifndef TESLA_CALLER_INSTRUMENTATION_H
32 #define TESLA_CALLER_INSTRUMENTATION_H
33 
34 #include "tesla.pb.h"
35 
36 #include "Instrumenter.h"
37 #include "Instrumentation.h"
38 
39 #include "llvm/ADT/StringMap.h"
40 #include "llvm/ADT/StringRef.h"
41 #include "llvm/Pass.h"
42 
43 namespace llvm {
44  class Function;
45  class Instruction;
46  class LLVMContext;
47  class Module;
48 }
49 
50 namespace tesla {
51 
52 class CallerInstrumentation;
53 class Manifest;
54 
56 class FnCallerInstrumenter : public Instrumenter, public llvm::FunctionPass {
57 public:
58  static char ID;
59  FnCallerInstrumenter(const Manifest& M, bool SuppressDI)
60  : Instrumenter(M, SuppressDI), FunctionPass(ID) {}
62 
63  const char* getPassName() const {
64  return "TESLA function instrumenter (caller-side)";
65  }
66 
67  virtual bool doInitialization(llvm::Module &M);
68  virtual bool runOnFunction(llvm::Function &Fn);
69  virtual bool runOnBasicBlock(llvm::BasicBlock &Block);
70 
71 private:
72  CallerInstrumentation* GetOrCreateInstr(llvm::Module&, llvm::Function*,
74 
75  llvm::StringMap<CallerInstrumentation*> Calls;
76  llvm::StringMap<CallerInstrumentation*> Returns;
77 };
78 
79 
80 
83  : public FnInstrumentation, public InstInstrumentation
84 {
85 public:
87  static CallerInstrumentation* Build(llvm::Module&, llvm::Function *Target,
89  bool SuppressDebugInstr);
90 
91  // InstInstrumentation implementation:
92  bool Instrument(llvm::Instruction&);
93 
94 private:
96  CallerInstrumentation(llvm::Module& M, llvm::Function *Target,
97  llvm::Function *Instr, FunctionEvent::Direction Dir)
98  : FnInstrumentation(M, Target, Instr, Dir)
99  {
100  }
101 };
102 
103 }
104 
105 #endif /* !TESLA_CALLER_INSTRUMENTATION_H */
106