instrumentation.h revision e401d146407d61eeb99f8d6176b2ac13c4df1e33
1725a957985171d712d5c048cc3d00ff14968784bjeffhao/* 2725a957985171d712d5c048cc3d00ff14968784bjeffhao * Copyright (C) 2011 The Android Open Source Project 3725a957985171d712d5c048cc3d00ff14968784bjeffhao * 4725a957985171d712d5c048cc3d00ff14968784bjeffhao * Licensed under the Apache License, Version 2.0 (the "License"); 5725a957985171d712d5c048cc3d00ff14968784bjeffhao * you may not use this file except in compliance with the License. 6725a957985171d712d5c048cc3d00ff14968784bjeffhao * You may obtain a copy of the License at 7725a957985171d712d5c048cc3d00ff14968784bjeffhao * 8725a957985171d712d5c048cc3d00ff14968784bjeffhao * http://www.apache.org/licenses/LICENSE-2.0 9725a957985171d712d5c048cc3d00ff14968784bjeffhao * 10725a957985171d712d5c048cc3d00ff14968784bjeffhao * Unless required by applicable law or agreed to in writing, software 11725a957985171d712d5c048cc3d00ff14968784bjeffhao * distributed under the License is distributed on an "AS IS" BASIS, 12725a957985171d712d5c048cc3d00ff14968784bjeffhao * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13725a957985171d712d5c048cc3d00ff14968784bjeffhao * See the License for the specific language governing permissions and 14725a957985171d712d5c048cc3d00ff14968784bjeffhao * limitations under the License. 15725a957985171d712d5c048cc3d00ff14968784bjeffhao */ 16725a957985171d712d5c048cc3d00ff14968784bjeffhao 17fc0e3219edc9a5bf81b166e82fd5db2796eb6a0dBrian Carlstrom#ifndef ART_RUNTIME_INSTRUMENTATION_H_ 18fc0e3219edc9a5bf81b166e82fd5db2796eb6a0dBrian Carlstrom#define ART_RUNTIME_INSTRUMENTATION_H_ 19725a957985171d712d5c048cc3d00ff14968784bjeffhao 20576ca0cd692c0b6ae70e776de91015b8ff000a08Ian Rogers#include <stdint.h> 21576ca0cd692c0b6ae70e776de91015b8ff000a08Ian Rogers#include <list> 22e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier#include <unordered_set> 23576ca0cd692c0b6ae70e776de91015b8ff000a08Ian Rogers 24d582fa4ea62083a7598dded5b82dc2198b3daac7Ian Rogers#include "arch/instruction_set.h" 25761600567d73b23324ae0251e871c15d6849ffd8Elliott Hughes#include "base/macros.h" 26719d1a33f6569864f529e5a3fff59e7bca97aad0Ian Rogers#include "base/mutex.h" 2794f7b49578b6aaa80de8ffed230648d601393905Hiroshi Yamauchi#include "gc_root.h" 280462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz#include "safe_map.h" 292dd0e2cea360bc9206eb88ecc40d259e796c239dIan Rogers 30725a957985171d712d5c048cc3d00ff14968784bjeffhaonamespace art { 312dd0e2cea360bc9206eb88ecc40d259e796c239dIan Rogersnamespace mirror { 32ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Class; 33ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Object; 34ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Throwable; 3562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers} // namespace mirror 36c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartierclass ArtField; 37e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartierclass ArtMethod; 3862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersunion JValue; 39725a957985171d712d5c048cc3d00ff14968784bjeffhaoclass Thread; 40725a957985171d712d5c048cc3d00ff14968784bjeffhao 4162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersnamespace instrumentation { 42725a957985171d712d5c048cc3d00ff14968784bjeffhao 43ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz// Interpreter handler tables. 44ee1997a3b83334985e757f369c09e111b121661bSebastien Hertzenum InterpreterHandlerTable { 45ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kMainHandlerTable = 0, // Main handler table: no suspend check, no instrumentation. 46ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kAlternativeHandlerTable = 1, // Alternative handler table: suspend check and/or instrumentation 47ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz // enabled. 48ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kNumHandlerTables 49ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz}; 50ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 5140da286d3207d88ed8ff3f5caac4873874603428Andreas Gampe// Do we want to deoptimize for method entry and exit listeners or just try to intercept 5240da286d3207d88ed8ff3f5caac4873874603428Andreas Gampe// invocations? Deoptimization forces all code to run in the interpreter and considerably hurts the 5340da286d3207d88ed8ff3f5caac4873874603428Andreas Gampe// application's performance. 5440da286d3207d88ed8ff3f5caac4873874603428Andreas Gampestatic constexpr bool kDeoptimizeForAccurateMethodEntryExitListeners = true; 5540da286d3207d88ed8ff3f5caac4873874603428Andreas Gampe 5662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// Instrumentation event listener API. Registered listeners will get the appropriate call back for 5762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// the events they are listening for. The call backs supply the thread, method and dex_pc the event 5862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// occurred upon. The thread may or may not be Thread::Current(). 5962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersstruct InstrumentationListener { 6062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers InstrumentationListener() {} 6162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual ~InstrumentationListener() {} 6262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 6362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is entered. 6462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void MethodEntered(Thread* thread, mirror::Object* this_object, 65e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, 6662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint32_t dex_pc) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 6762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 6862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is exited. 6962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void MethodExited(Thread* thread, mirror::Object* this_object, 70e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 7162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const JValue& return_value) 7262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 7362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 7462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is popped due to an exception throw. A method will either cause a 7562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // MethodExited call-back or a MethodUnwind call-back when its activation is removed. 7651db44a194bafc3810a41164a8b39614f10e79dfSebastien Hertz virtual void MethodUnwind(Thread* thread, mirror::Object* this_object, 77e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) 7851db44a194bafc3810a41164a8b39614f10e79dfSebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 7962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 8062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when the dex pc moves in a method. 8162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void DexPcMoved(Thread* thread, mirror::Object* this_object, 82e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t new_dex_pc) 8362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 8462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 853f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Call-back for when we read from a field. 86e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier virtual void FieldRead(Thread* thread, mirror::Object* this_object, ArtMethod* method, 87c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier uint32_t dex_pc, ArtField* field) = 0; 883f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 893f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Call-back for when we write into a field. 90e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier virtual void FieldWritten(Thread* thread, mirror::Object* this_object, ArtMethod* method, 91c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier uint32_t dex_pc, ArtField* field, const JValue& field_value) = 0; 923f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 9362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back when an exception is caught. 9414691c5e786e8c2c5734f687e4c96217340771beNicolas Geoffray virtual void ExceptionCaught(Thread* thread, mirror::Throwable* exception_object) 9562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 96e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier 97e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier // Call-back for when we get a backward branch. 98e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier virtual void BackwardBranch(Thread* thread, ArtMethod* method, int32_t dex_pc_offset) 99e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 100725a957985171d712d5c048cc3d00ff14968784bjeffhao}; 101725a957985171d712d5c048cc3d00ff14968784bjeffhao 10262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// Instrumentation is a catch-all for when extra information is required from the runtime. The 10362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// typical use for instrumentation is for profiling and debugging. Instrumentation may add stubs 10462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// to method entry and exit, it may also force execution to be switched to the interpreter and 10562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// trigger deoptimization. 106725a957985171d712d5c048cc3d00ff14968784bjeffhaoclass Instrumentation { 107725a957985171d712d5c048cc3d00ff14968784bjeffhao public: 10862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers enum InstrumentationEvent { 109e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kMethodEntered = 0x1, 110e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kMethodExited = 0x2, 111e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kMethodUnwind = 0x4, 112e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kDexPcMoved = 0x8, 113e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kFieldRead = 0x10, 114e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kFieldWritten = 0x20, 115e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kExceptionCaught = 0x40, 116e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier kBackwardBranch = 0x80, 11762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers }; 11862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 1190462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz enum class InstrumentationLevel { 1200462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz kInstrumentNothing, // execute without instrumentation 1210462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz kInstrumentWithInstrumentationStubs, // execute with instrumentation entry/exit stubs 1220462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz kInstrumentWithInterpreter // execute with interpreter 1230462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz }; 1240462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz 1253b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier Instrumentation(); 12662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 12762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Add a listener to be notified of the masked together sent of instrumentation events. This 12862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // suspend the runtime to install stubs. You are expected to hold the mutator lock as a proxy 12962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // for saying you should have suspended all threads (installing stubs while threads are running 13062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // will break). 13162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void AddListener(InstrumentationListener* listener, uint32_t events) 13262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 13362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 13462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 13562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Removes a listener possibly removing instrumentation stubs. 13662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void RemoveListener(InstrumentationListener* listener, uint32_t events) 13762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 13862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 13962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 140138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // Deoptimization. 141a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz void EnableDeoptimization() 142a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 1433b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier LOCKS_EXCLUDED(deoptimized_methods_lock_); 1440462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void DisableDeoptimization(const char* key) 145a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 1464d25df3f76f864b7629ac8c0046d46997f293d8dSebastien Hertz LOCKS_EXCLUDED(deoptimized_methods_lock_); 147a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz bool AreAllMethodsDeoptimized() const { 148a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz return interpreter_stubs_installed_; 149a76a6d4cb3dedec909bd927f20bc0ab23198a337Sebastien Hertz } 15011d40c250ec86c784cf76b8c31e1cf9285d555dcSebastien Hertz bool ShouldNotifyMethodEnterExitEvents() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 151138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 152138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // Executes everything with interpreter. 1530462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void DeoptimizeEverything(const char* key) 154138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 155138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 156138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 157138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // Executes everything with compiled code (or interpreter if there is no code). 1580462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void UndeoptimizeEverything(const char* key) 159138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 160138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 161138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 162138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // Deoptimize a method by forcing its execution with the interpreter. Nevertheless, a static 163138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // method (except a class initializer) set to the resolution trampoline will be deoptimized only 164138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // once its declaring class is initialized. 165e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void Deoptimize(ArtMethod* method) 1663b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier LOCKS_EXCLUDED(Locks::thread_list_lock_, deoptimized_methods_lock_) 167138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_); 168138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 169138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // Undeoptimze the method by restoring its entrypoints. Nevertheless, a static method 170138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // (except a class initializer) set to the resolution trampoline will be updated only once its 171138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // declaring class is initialized. 172e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void Undeoptimize(ArtMethod* method) 1734d25df3f76f864b7629ac8c0046d46997f293d8dSebastien Hertz LOCKS_EXCLUDED(Locks::thread_list_lock_, deoptimized_methods_lock_) 174138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_); 175138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 1760462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // Indicates whether the method has been deoptimized so it is executed with the interpreter. 177e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier bool IsDeoptimized(ArtMethod* method) 178799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi LOCKS_EXCLUDED(deoptimized_methods_lock_) 179799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 180138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 1810462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // Enable method tracing by installing instrumentation entry/exit stubs or interpreter. 1820462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void EnableMethodTracing(const char* key, 1830462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz bool needs_interpreter = kDeoptimizeForAccurateMethodEntryExitListeners) 184138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 185138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 186138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 1870462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // Disable method tracing by uninstalling instrumentation entry/exit stubs or interpreter. 1880462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void DisableMethodTracing(const char* key) 189138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 190138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 191138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 192ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz InterpreterHandlerTable GetInterpreterHandlerTable() const 193ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 194ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz return interpreter_handler_table_; 195ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 196ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 1979ef78b59da51080882e47505896b420977fd79aeMathieu Chartier void InstrumentQuickAllocEntryPoints() LOCKS_EXCLUDED(Locks::instrument_entrypoints_lock_); 1989ef78b59da51080882e47505896b420977fd79aeMathieu Chartier void UninstrumentQuickAllocEntryPoints() LOCKS_EXCLUDED(Locks::instrument_entrypoints_lock_); 1999ef78b59da51080882e47505896b420977fd79aeMathieu Chartier void InstrumentQuickAllocEntryPointsLocked() 2009ef78b59da51080882e47505896b420977fd79aeMathieu Chartier EXCLUSIVE_LOCKS_REQUIRED(Locks::instrument_entrypoints_lock_) 20169dbec6d9d55eeb2867949c2791d01dc9aa916c8Jeff Hao LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::runtime_shutdown_lock_); 2029ef78b59da51080882e47505896b420977fd79aeMathieu Chartier void UninstrumentQuickAllocEntryPointsLocked() 2039ef78b59da51080882e47505896b420977fd79aeMathieu Chartier EXCLUSIVE_LOCKS_REQUIRED(Locks::instrument_entrypoints_lock_) 20469dbec6d9d55eeb2867949c2791d01dc9aa916c8Jeff Hao LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::runtime_shutdown_lock_); 205d889178ec78930538d9d6a66c3df9ee9afaffbb4Mathieu Chartier void ResetQuickAllocEntryPoints() EXCLUSIVE_LOCKS_REQUIRED(Locks::runtime_shutdown_lock_); 206fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers 20762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Update the code of a method respecting any installed stubs. 208e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void UpdateMethodsCode(ArtMethod* method, const void* quick_code) 209138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 21062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 21162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Get the quick code for the given method. More efficient than asking the class linker as it 21262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // will short-cut to GetCode if instrumentation and static method resolution stubs aren't 21362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // installed. 214e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier const void* GetQuickCodeFor(ArtMethod* method, size_t pointer_size) const 21562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 21662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 21762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void ForceInterpretOnly() { 21862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers interpret_only_ = true; 21962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers forced_interpret_only_ = true; 22062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 22162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 222ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Called by ArtMethod::Invoke to determine dispatch mechanism. 22362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool InterpretOnly() const { 22462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers return interpret_only_; 22562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 22662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 227563b47cc142e477da244539b1d63070425e7fd78Hiroshi Yamauchi bool IsForcedInterpretOnly() const { 228563b47cc142e477da244539b1d63070425e7fd78Hiroshi Yamauchi return forced_interpret_only_; 229563b47cc142e477da244539b1d63070425e7fd78Hiroshi Yamauchi } 230563b47cc142e477da244539b1d63070425e7fd78Hiroshi Yamauchi 23162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool AreExitStubsInstalled() const { 23262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers return instrumentation_stubs_installed_; 23362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 23462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 235ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasMethodEntryListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 23674109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_method_entry_listeners_; 23774109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 23874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 239ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasMethodExitListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 24074109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_method_exit_listeners_; 24174109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 24274109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 2430462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz bool HasMethodUnwindListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 2440462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz return have_method_unwind_listeners_; 2450462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz } 2460462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz 247ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasDexPcListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 24874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_dex_pc_listeners_; 24974109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 25074109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 251ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasFieldReadListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 2523f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz return have_field_read_listeners_; 2533f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 2543f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 255ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasFieldWriteListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 2563f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz return have_field_write_listeners_; 2573f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 2583f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 259ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool HasExceptionCaughtListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 2609f1020305292a21fd14a402b189c765a125226abSebastien Hertz return have_exception_caught_listeners_; 2619f1020305292a21fd14a402b189c765a125226abSebastien Hertz } 2629f1020305292a21fd14a402b189c765a125226abSebastien Hertz 263e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier bool HasBackwardBranchListeners() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 264e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier return have_backward_branch_listeners_; 265e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier } 266e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier 267ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool IsActive() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 268ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz return have_dex_pc_listeners_ || have_method_entry_listeners_ || have_method_exit_listeners_ || 26942cd43fa593e8f0427eb0ec158bef08814a6180bSebastien Hertz have_field_read_listeners_ || have_field_write_listeners_ || 270ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz have_exception_caught_listeners_ || have_method_unwind_listeners_; 271ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 272ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 27362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been entered. A dex PC is provided as we may install 27462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // listeners into executing code and get method enter events for methods already on the stack. 27562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodEnterEvent(Thread* thread, mirror::Object* this_object, 276e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) const 27762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 27874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasMethodEntryListeners())) { 27962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers MethodEnterEventImpl(thread, this_object, method, dex_pc); 28062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 28162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 28262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 28362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been exited. 28462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodExitEvent(Thread* thread, mirror::Object* this_object, 285e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 28662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const JValue& return_value) const 28762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 28874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasMethodExitListeners())) { 28962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers MethodExitEventImpl(thread, this_object, method, dex_pc, return_value); 29062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 29162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 29262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 29362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been exited due to an exception. 29462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodUnwindEvent(Thread* thread, mirror::Object* this_object, 295e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) const 29662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 29762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 29862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that the dex pc has moved (only supported by the interpreter). 29962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void DexPcMovedEvent(Thread* thread, mirror::Object* this_object, 300e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) const 30162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 30274109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasDexPcListeners())) { 30362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers DexPcMovedEventImpl(thread, this_object, method, dex_pc); 30462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 30562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 306725a957985171d712d5c048cc3d00ff14968784bjeffhao 307e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier // Inform listeners that a backward branch has been taken (only supported by the interpreter). 308e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void BackwardBranch(Thread* thread, ArtMethod* method, int32_t offset) const 309e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 310e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier if (UNLIKELY(HasBackwardBranchListeners())) { 311e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier BackwardBranchImpl(thread, method, offset); 312e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier } 313e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier } 314e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier 3153f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Inform listeners that we read a field (only supported by the interpreter). 3163f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz void FieldReadEvent(Thread* thread, mirror::Object* this_object, 317e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 318c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier ArtField* field) const 3193f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 3203f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz if (UNLIKELY(HasFieldReadListeners())) { 3213f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz FieldReadEventImpl(thread, this_object, method, dex_pc, field); 3223f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 3233f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 3243f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 3253f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Inform listeners that we write a field (only supported by the interpreter). 3263f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz void FieldWriteEvent(Thread* thread, mirror::Object* this_object, 327e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 328c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier ArtField* field, const JValue& field_value) const 3293f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 3303f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz if (UNLIKELY(HasFieldWriteListeners())) { 3313f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz FieldWriteEventImpl(thread, this_object, method, dex_pc, field, field_value); 3323f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 3333f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz } 3343f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 33562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that an exception was caught. 33614691c5e786e8c2c5734f687e4c96217340771beNicolas Geoffray void ExceptionCaughtEvent(Thread* thread, mirror::Throwable* exception_object) const 33762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 338725a957985171d712d5c048cc3d00ff14968784bjeffhao 33962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Called when an instrumented method is entered. The intended link register (lr) is saved so 34062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // that returning causes a branch to the method exit stub. Generates method enter events. 34162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void PushInstrumentationStackFrame(Thread* self, mirror::Object* this_object, 342e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uintptr_t lr, 3439a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao bool interpreter_entry) 34462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 345725a957985171d712d5c048cc3d00ff14968784bjeffhao 34662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Called when an instrumented method is exited. Removes the pushed instrumentation frame 34762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // returning the intended link register. Generates method exit events. 348d58342caa97108ba413bad467c285c0377f138f5Andreas Gampe TwoWordReturn PopInstrumentationStackFrame(Thread* self, uintptr_t* return_pc, 349d58342caa97108ba413bad467c285c0377f138f5Andreas Gampe uint64_t gpr_result, uint64_t fpr_result) 35062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 351725a957985171d712d5c048cc3d00ff14968784bjeffhao 35262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Pops an instrumentation frame from the current thread and generate an unwind event. 35362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void PopMethodForUnwind(Thread* self, bool is_deoptimization) const 35462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 35562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 35662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call back for configure stubs. 357a10aa3789544cf62a2d362c032ea8d9532b47b39Sebastien Hertz void InstallStubsForClass(mirror::Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 358725a957985171d712d5c048cc3d00ff14968784bjeffhao 359e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void InstallStubsForMethod(ArtMethod* method) 360138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 361138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 362725a957985171d712d5c048cc3d00ff14968784bjeffhao private: 3630462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz InstrumentationLevel GetCurrentInstrumentationLevel() const; 3640462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz 36562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Does the job of installing or removing instrumentation code within methods. 3660462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // In order to support multiple clients using instrumentation at the same time, 3670462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // the caller must pass a unique key (a string) identifying it so we remind which 3680462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // instrumentation level it needs. Therefore the current instrumentation level 3690462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // becomes the highest instrumentation level required by a client. 3700462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz void ConfigureStubs(const char* key, InstrumentationLevel desired_instrumentation_level) 37162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 3723b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_, 3733b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier deoptimized_methods_lock_); 37462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 375ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz void UpdateInterpreterHandlerTable() EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) { 376ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz interpreter_handler_table_ = IsActive() ? kAlternativeHandlerTable : kMainHandlerTable; 377ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 378ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 379661974a5561e5ccdfbac8cb5d8df8b7e6f3483b8Mathieu Chartier // No thread safety analysis to get around SetQuickAllocEntryPointsInstrumented requiring 380661974a5561e5ccdfbac8cb5d8df8b7e6f3483b8Mathieu Chartier // exclusive access to mutator lock which you can't get if the runtime isn't started. 3819ef78b59da51080882e47505896b420977fd79aeMathieu Chartier void SetEntrypointsInstrumented(bool instrumented) NO_THREAD_SAFETY_ANALYSIS; 382661974a5561e5ccdfbac8cb5d8df8b7e6f3483b8Mathieu Chartier 38362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodEnterEventImpl(Thread* thread, mirror::Object* this_object, 384e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) const 38562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 38662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodExitEventImpl(Thread* thread, mirror::Object* this_object, 387e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, 38862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint32_t dex_pc, const JValue& return_value) const 38962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 39062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void DexPcMovedEventImpl(Thread* thread, mirror::Object* this_object, 391e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc) const 39262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 393e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier void BackwardBranchImpl(Thread* thread, ArtMethod* method, int32_t offset) const 394e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 3953f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz void FieldReadEventImpl(Thread* thread, mirror::Object* this_object, 396e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 397c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier ArtField* field) const 3983f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 3993f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz void FieldWriteEventImpl(Thread* thread, mirror::Object* this_object, 400e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method, uint32_t dex_pc, 401c785344b87221f5e4e6473e5b762e4e61fe65dcfMathieu Chartier ArtField* field, const JValue& field_value) const 4023f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 40362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 404799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi // Read barrier-aware utility functions for accessing deoptimized_methods_ 405e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier bool AddDeoptimizedMethod(ArtMethod* method) 406799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) 407799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi EXCLUSIVE_LOCKS_REQUIRED(deoptimized_methods_lock_); 408e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier bool IsDeoptimizedMethod(ArtMethod* method) 409e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_, deoptimized_methods_lock_); 410e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier bool RemoveDeoptimizedMethod(ArtMethod* method) 411799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) 412799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi EXCLUSIVE_LOCKS_REQUIRED(deoptimized_methods_lock_); 413e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* BeginDeoptimizedMethod() 414e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_, deoptimized_methods_lock_); 415799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi bool IsDeoptimizedMethodsEmpty() const 416e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier SHARED_LOCKS_REQUIRED(Locks::mutator_lock_, deoptimized_methods_lock_); 417799eb3a5555254427db269921042419bc30d4d86Hiroshi Yamauchi 418ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ so that it calls instrumentation/interpreter code? 41962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool instrumentation_stubs_installed_; 42062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 421ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ to reference the enter/exit stubs? 42262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool entry_exit_stubs_installed_; 42362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 424ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ to reference the enter interpreter stub? 42562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool interpreter_stubs_installed_; 42662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 42762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we need the fidelity of events that we only get from running within the interpreter? 42862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool interpret_only_; 429725a957985171d712d5c048cc3d00ff14968784bjeffhao 43062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Did the runtime request we only run in the interpreter? ie -Xint mode. 43162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool forced_interpret_only_; 432725a957985171d712d5c048cc3d00ff14968784bjeffhao 43362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method entry events? Short-cut to avoid taking the 43462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 435ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_method_entry_listeners_ GUARDED_BY(Locks::mutator_lock_); 43662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 43762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method exit events? Short-cut to avoid taking the 43862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 439ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_method_exit_listeners_ GUARDED_BY(Locks::mutator_lock_); 44062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 44162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method unwind events? Short-cut to avoid taking the 44262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 443ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_method_unwind_listeners_ GUARDED_BY(Locks::mutator_lock_); 44462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 44562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for dex move events? Short-cut to avoid taking the 44662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 447ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_dex_pc_listeners_ GUARDED_BY(Locks::mutator_lock_); 44862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 4493f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Do we have any listeners for field read events? Short-cut to avoid taking the 4503f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // instrumentation_lock_. 451ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_field_read_listeners_ GUARDED_BY(Locks::mutator_lock_); 4523f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 4533f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // Do we have any listeners for field write events? Short-cut to avoid taking the 4543f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz // instrumentation_lock_. 455ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_field_write_listeners_ GUARDED_BY(Locks::mutator_lock_); 4563f52eafe5577b8489f90dc8ed5981b3455206147Sebastien Hertz 45762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any exception caught listeners? Short-cut to avoid taking the instrumentation_lock_. 458ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz bool have_exception_caught_listeners_ GUARDED_BY(Locks::mutator_lock_); 45962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 460e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier // Do we have any backward branch listeners? Short-cut to avoid taking the instrumentation_lock_. 461e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier bool have_backward_branch_listeners_ GUARDED_BY(Locks::mutator_lock_); 462e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier 4630462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // Contains the instrumentation level required by each client of the instrumentation identified 4640462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz // by a string key. 4650462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz typedef SafeMap<const char*, InstrumentationLevel> InstrumentationLevelTable; 4660462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz InstrumentationLevelTable requested_instrumentation_levels_ GUARDED_BY(Locks::mutator_lock_); 4670462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz 46862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // The event listeners, written to with the mutator_lock_ exclusively held. 46962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_entry_listeners_ GUARDED_BY(Locks::mutator_lock_); 47062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_exit_listeners_ GUARDED_BY(Locks::mutator_lock_); 47162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_unwind_listeners_ GUARDED_BY(Locks::mutator_lock_); 472e5f13e57ff8fa36342beb33830b3ec5942a61ccaMathieu Chartier std::list<InstrumentationListener*> backward_branch_listeners_ GUARDED_BY(Locks::mutator_lock_); 473ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi std::shared_ptr<std::list<InstrumentationListener*>> dex_pc_listeners_ 474ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi GUARDED_BY(Locks::mutator_lock_); 475ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi std::shared_ptr<std::list<InstrumentationListener*>> field_read_listeners_ 476ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi GUARDED_BY(Locks::mutator_lock_); 477ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi std::shared_ptr<std::list<InstrumentationListener*>> field_write_listeners_ 478ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi GUARDED_BY(Locks::mutator_lock_); 479ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi std::shared_ptr<std::list<InstrumentationListener*>> exception_caught_listeners_ 480ca1d06cfa2f2b8d2be4390644e126cb68cdbb5baDaniel Mihalyi GUARDED_BY(Locks::mutator_lock_); 481725a957985171d712d5c048cc3d00ff14968784bjeffhao 482138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // The set of methods being deoptimized (by the debugger) which must be executed with interpreter 483138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz // only. 4843b05e9ba874449dbff65b01b8781001f7d93eea6Mathieu Chartier mutable ReaderWriterMutex deoptimized_methods_lock_ DEFAULT_MUTEX_ACQUIRED_AFTER; 485e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier std::unordered_set<ArtMethod*> deoptimized_methods_ GUARDED_BY(deoptimized_methods_lock_); 48611d40c250ec86c784cf76b8c31e1cf9285d555dcSebastien Hertz bool deoptimization_enabled_; 487138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz 488fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // Current interpreter handler table. This is updated each time the thread state flags are 489fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // modified. 490ed2be1725fb79075892b1a9103487c9d9a95b350Sebastien Hertz InterpreterHandlerTable interpreter_handler_table_ GUARDED_BY(Locks::mutator_lock_); 491ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 492fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // Greater than 0 if quick alloc entry points instrumented. 4939ef78b59da51080882e47505896b420977fd79aeMathieu Chartier size_t quick_alloc_entry_points_instrumentation_counter_ 4949ef78b59da51080882e47505896b420977fd79aeMathieu Chartier GUARDED_BY(Locks::instrument_entrypoints_lock_); 495fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers 4960462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz friend class InstrumentationTest; // For GetCurrentInstrumentationLevel and ConfigureStubs. 4970462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertz 498725a957985171d712d5c048cc3d00ff14968784bjeffhao DISALLOW_COPY_AND_ASSIGN(Instrumentation); 499725a957985171d712d5c048cc3d00ff14968784bjeffhao}; 5006a3c1fcb4ba42ad4d5d142c17a3712a6ddd3866fIan Rogersstd::ostream& operator<<(std::ostream& os, const Instrumentation::InstrumentationEvent& rhs); 5010462c4c87c39db6cfcd338f323844738109ac3c9Sebastien Hertzstd::ostream& operator<<(std::ostream& os, const Instrumentation::InstrumentationLevel& rhs); 502725a957985171d712d5c048cc3d00ff14968784bjeffhao 50362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// An element in the instrumentation side stack maintained in art::Thread. 50462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersstruct InstrumentationStackFrame { 505e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier InstrumentationStackFrame(mirror::Object* this_object, ArtMethod* method, 5069a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao uintptr_t return_pc, size_t frame_id, bool interpreter_entry) 5079a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao : this_object_(this_object), method_(method), return_pc_(return_pc), frame_id_(frame_id), 5089a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao interpreter_entry_(interpreter_entry) { 50962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 51062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 51162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::string Dump() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 51262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 51362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers mirror::Object* this_object_; 514e401d146407d61eeb99f8d6176b2ac13c4df1e33Mathieu Chartier ArtMethod* method_; 515138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz uintptr_t return_pc_; 516138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz size_t frame_id_; 517138dbfc3336e379d74d157086f69a0fbe830089bSebastien Hertz bool interpreter_entry_; 51862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers}; 51962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 52062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers} // namespace instrumentation 521725a957985171d712d5c048cc3d00ff14968784bjeffhao} // namespace art 522725a957985171d712d5c048cc3d00ff14968784bjeffhao 523fc0e3219edc9a5bf81b166e82fd5db2796eb6a0dBrian Carlstrom#endif // ART_RUNTIME_INSTRUMENTATION_H_ 524