1 //===- JITEventListener.h - Exposes events from JIT compilation -*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the JITEventListener interface, which lets users get
11 // callbacks when significant events happen during the JIT compilation process.
13 //===----------------------------------------------------------------------===//
15 #ifndef LLVM_EXECUTIONENGINE_JITEVENTLISTENER_H
16 #define LLVM_EXECUTIONENGINE_JITEVENTLISTENER_H
18 #include "llvm/Config/llvm-config.h"
19 #include "llvm/IR/DebugLoc.h"
20 #include "llvm/Support/DataTypes.h"
25 class MachineFunction;
26 class OProfileWrapper;
27 class IntelJITEventsWrapper;
30 /// JITEvent_EmittedFunctionDetails - Helper struct for containing information
31 /// about a generated machine code function.
32 struct JITEvent_EmittedFunctionDetails {
34 /// The address at which the current line changes.
37 /// The new location information. These can be translated to DebugLocTuples
38 /// using MF->getDebugLocTuple().
42 /// The machine function the struct contains information for.
43 const MachineFunction *MF;
45 /// The list of line boundary information, sorted by address.
46 std::vector<LineStart> LineStarts;
49 /// JITEventListener - Abstract interface for use by the JIT to notify clients
50 /// about significant events during compilation. For example, to notify
51 /// profilers and debuggers that need to know where functions have been emitted.
53 /// The default implementation of each method does nothing.
54 class JITEventListener {
56 typedef JITEvent_EmittedFunctionDetails EmittedFunctionDetails;
60 virtual ~JITEventListener();
62 /// NotifyFreeingMachineCode - Called from freeMachineCodeForFunction(), after
63 /// the global mapping is removed, but before the machine code is returned to
66 /// OldPtr is the address of the machine code and will be the same as the Code
67 /// parameter to a previous NotifyFunctionEmitted call. The Function passed
68 /// to NotifyFunctionEmitted may have been destroyed by the time of the
69 /// matching NotifyFreeingMachineCode call.
70 virtual void NotifyFreeingMachineCode(void *) {}
72 /// NotifyObjectEmitted - Called after an object has been successfully
73 /// emitted to memory. NotifyFunctionEmitted will not be called for
74 /// individual functions in the object.
76 /// ELF-specific information
77 /// The ObjectImage contains the generated object image
78 /// with section headers updated to reflect the address at which sections
79 /// were loaded and with relocations performed in-place on debug sections.
80 virtual void NotifyObjectEmitted(const ObjectImage &Obj) {}
82 /// NotifyFreeingObject - Called just before the memory associated with
83 /// a previously emitted object is released.
84 virtual void NotifyFreeingObject(const ObjectImage &Obj) {}
86 #if LLVM_USE_INTEL_JITEVENTS
87 // Construct an IntelJITEventListener
88 static JITEventListener *createIntelJITEventListener();
90 // Construct an IntelJITEventListener with a test Intel JIT API implementation
91 static JITEventListener *createIntelJITEventListener(
92 IntelJITEventsWrapper* AlternativeImpl);
94 static JITEventListener *createIntelJITEventListener() { return nullptr; }
96 static JITEventListener *createIntelJITEventListener(
97 IntelJITEventsWrapper* AlternativeImpl) {
100 #endif // USE_INTEL_JITEVENTS
102 #if LLVM_USE_OPROFILE
103 // Construct an OProfileJITEventListener
104 static JITEventListener *createOProfileJITEventListener();
106 // Construct an OProfileJITEventListener with a test opagent implementation
107 static JITEventListener *createOProfileJITEventListener(
108 OProfileWrapper* AlternativeImpl);
111 static JITEventListener *createOProfileJITEventListener() { return nullptr; }
113 static JITEventListener *createOProfileJITEventListener(
114 OProfileWrapper* AlternativeImpl) {
117 #endif // USE_OPROFILE
121 } // end namespace llvm.
123 #endif // defined LLVM_EXECUTIONENGINE_JITEVENTLISTENER_H