instrumentation.h revision fa82427c68b09f4aedbee319dc71579afbfc66f5
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 20761600567d73b23324ae0251e871c15d6849ffd8Elliott Hughes#include "base/macros.h" 2162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers#include "locks.h" 222dd0e2cea360bc9206eb88ecc40d259e796c239dIan Rogers 232dd0e2cea360bc9206eb88ecc40d259e796c239dIan Rogers#include <stdint.h> 2462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers#include <list> 25725a957985171d712d5c048cc3d00ff14968784bjeffhao 26725a957985171d712d5c048cc3d00ff14968784bjeffhaonamespace art { 272dd0e2cea360bc9206eb88ecc40d259e796c239dIan Rogersnamespace mirror { 28ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class ArtMethod; 29ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Class; 30ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Object; 31ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom class Throwable; 3262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers} // namespace mirror 3362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersunion JValue; 34725a957985171d712d5c048cc3d00ff14968784bjeffhaoclass Thread; 3562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersclass ThrowLocation; 36725a957985171d712d5c048cc3d00ff14968784bjeffhao 3762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersnamespace instrumentation { 38725a957985171d712d5c048cc3d00ff14968784bjeffhao 3962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersconst bool kVerboseInstrumentation = false; 4062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 41ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz// Interpreter handler tables. 42ee1997a3b83334985e757f369c09e111b121661bSebastien Hertzenum InterpreterHandlerTable { 43ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kMainHandlerTable = 0, // Main handler table: no suspend check, no instrumentation. 44ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kAlternativeHandlerTable = 1, // Alternative handler table: suspend check and/or instrumentation 45ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz // enabled. 46ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz kNumHandlerTables 47ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz}; 48ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 4962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// Instrumentation event listener API. Registered listeners will get the appropriate call back for 5062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// the events they are listening for. The call backs supply the thread, method and dex_pc the event 5162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// occurred upon. The thread may or may not be Thread::Current(). 5262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersstruct InstrumentationListener { 5362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers InstrumentationListener() {} 5462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual ~InstrumentationListener() {} 5562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 5662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is entered. 5762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void MethodEntered(Thread* thread, mirror::Object* this_object, 58ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, 5962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint32_t dex_pc) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 6062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 6162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is exited. 6262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // TODO: its likely passing the return value would be useful, however, we may need to get and 6362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // parse the shorty to determine what kind of register holds the result. 6462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void MethodExited(Thread* thread, mirror::Object* this_object, 65ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc, 6662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const JValue& return_value) 6762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 6862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 6962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when a method is popped due to an exception throw. A method will either cause a 7062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // MethodExited call-back or a MethodUnwind call-back when its activation is removed. 71ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom virtual void MethodUnwind(Thread* thread, const mirror::ArtMethod* method, 7262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint32_t dex_pc) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 7362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 7462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back for when the dex pc moves in a method. 7562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void DexPcMoved(Thread* thread, mirror::Object* this_object, 76ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t new_dex_pc) 7762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 7862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 7962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call-back when an exception is caught. 8062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers virtual void ExceptionCaught(Thread* thread, const ThrowLocation& throw_location, 81ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom mirror::ArtMethod* catch_method, uint32_t catch_dex_pc, 8262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers mirror::Throwable* exception_object) 8362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0; 84725a957985171d712d5c048cc3d00ff14968784bjeffhao}; 85725a957985171d712d5c048cc3d00ff14968784bjeffhao 8662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// Instrumentation is a catch-all for when extra information is required from the runtime. The 8762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// typical use for instrumentation is for profiling and debugging. Instrumentation may add stubs 8862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// to method entry and exit, it may also force execution to be switched to the interpreter and 8962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// trigger deoptimization. 90725a957985171d712d5c048cc3d00ff14968784bjeffhaoclass Instrumentation { 91725a957985171d712d5c048cc3d00ff14968784bjeffhao public: 9262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers enum InstrumentationEvent { 9362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers kMethodEntered = 1, 9462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers kMethodExited = 2, 9562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers kMethodUnwind = 4, 9662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers kDexPcMoved = 8, 9762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers kExceptionCaught = 16 9862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers }; 9962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 10062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers Instrumentation() : 10162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers instrumentation_stubs_installed_(false), entry_exit_stubs_installed_(false), 10262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers interpreter_stubs_installed_(false), 10362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers interpret_only_(false), forced_interpret_only_(false), 10462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers have_method_entry_listeners_(false), have_method_exit_listeners_(false), 10562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers have_method_unwind_listeners_(false), have_dex_pc_listeners_(false), 106ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz have_exception_caught_listeners_(false), 107fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers interpreter_handler_table_(kMainHandlerTable), 108fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers quick_alloc_entry_points_instrumentation_counter_(0) {} 10962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 11062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Add a listener to be notified of the masked together sent of instrumentation events. This 11162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // suspend the runtime to install stubs. You are expected to hold the mutator lock as a proxy 11262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // for saying you should have suspended all threads (installing stubs while threads are running 11362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // will break). 11462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void AddListener(InstrumentationListener* listener, uint32_t events) 11562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 11662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 11762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 11862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Removes a listener possibly removing instrumentation stubs. 11962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void RemoveListener(InstrumentationListener* listener, uint32_t events) 12062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 12162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 12262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 123ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz InterpreterHandlerTable GetInterpreterHandlerTable() const { 124ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz return interpreter_handler_table_; 125ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 126ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 127fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers void InstrumentQuickAllocEntryPoints() LOCKS_EXCLUDED(Locks::thread_list_lock_); 128fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers void UninstrumentQuickAllocEntryPoints() LOCKS_EXCLUDED(Locks::thread_list_lock_); 129fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers 13062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Update the code of a method respecting any installed stubs. 131ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom void UpdateMethodsCode(mirror::ArtMethod* method, const void* code) const; 13262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 13362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Get the quick code for the given method. More efficient than asking the class linker as it 13462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // will short-cut to GetCode if instrumentation and static method resolution stubs aren't 13562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // installed. 136ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const void* GetQuickCodeFor(const mirror::ArtMethod* method) const 13762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 13862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 13962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void ForceInterpretOnly() { 14062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers interpret_only_ = true; 14162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers forced_interpret_only_ = true; 14262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 14362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 144ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Called by ArtMethod::Invoke to determine dispatch mechanism. 14562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool InterpretOnly() const { 14662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers return interpret_only_; 14762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 14862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 14962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool ShouldPortableCodeDeoptimize() const { 15062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers return instrumentation_stubs_installed_; 15162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 15262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 15362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool AreExitStubsInstalled() const { 15462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers return instrumentation_stubs_installed_; 15562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 15662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 15774109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz bool HasMethodEntryListeners() const { 15874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_method_entry_listeners_; 15974109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 16074109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 16174109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz bool HasMethodExitListeners() const { 16274109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_method_exit_listeners_; 16374109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 16474109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 16574109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz bool HasDexPcListeners() const { 16674109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz return have_dex_pc_listeners_; 16774109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz } 16874109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz 169ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz bool IsActive() const { 170ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz return have_dex_pc_listeners_ || have_method_entry_listeners_ || have_method_exit_listeners_ || 171ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz have_exception_caught_listeners_ || have_method_unwind_listeners_; 172ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 173ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 17462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been entered. A dex PC is provided as we may install 17562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // listeners into executing code and get method enter events for methods already on the stack. 17662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodEnterEvent(Thread* thread, mirror::Object* this_object, 177ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc) const 17862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 17974109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasMethodEntryListeners())) { 18062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers MethodEnterEventImpl(thread, this_object, method, dex_pc); 18162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 18262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 18362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 18462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been exited. 18562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodExitEvent(Thread* thread, mirror::Object* this_object, 186ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc, 18762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const JValue& return_value) const 18862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 18974109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasMethodExitListeners())) { 19062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers MethodExitEventImpl(thread, this_object, method, dex_pc, return_value); 19162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 19262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 19362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 19462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that a method has been exited due to an exception. 19562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodUnwindEvent(Thread* thread, mirror::Object* this_object, 196ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc) const 19762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 19862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 19962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that the dex pc has moved (only supported by the interpreter). 20062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void DexPcMovedEvent(Thread* thread, mirror::Object* this_object, 201ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc) const 20262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 20374109f6683096de494b1457fa6d5b0ac33b4c98cSebastien Hertz if (UNLIKELY(HasDexPcListeners())) { 20462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers DexPcMovedEventImpl(thread, this_object, method, dex_pc); 20562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 20662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 207725a957985171d712d5c048cc3d00ff14968784bjeffhao 20862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Inform listeners that an exception was caught. 20962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void ExceptionCaughtEvent(Thread* thread, const ThrowLocation& throw_location, 210ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom mirror::ArtMethod* catch_method, uint32_t catch_dex_pc, 211947ff080753c786a74f1cd7aeb09f717bb7074bdSebastien Hertz mirror::Throwable* exception_object) const 21262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 213725a957985171d712d5c048cc3d00ff14968784bjeffhao 21462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Called when an instrumented method is entered. The intended link register (lr) is saved so 21562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // that returning causes a branch to the method exit stub. Generates method enter events. 21662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void PushInstrumentationStackFrame(Thread* self, mirror::Object* this_object, 217ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom mirror::ArtMethod* method, uintptr_t lr, 2189a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao bool interpreter_entry) 21962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 220725a957985171d712d5c048cc3d00ff14968784bjeffhao 22162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Called when an instrumented method is exited. Removes the pushed instrumentation frame 22262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // returning the intended link register. Generates method exit events. 22362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint64_t PopInstrumentationStackFrame(Thread* self, uintptr_t* return_pc, uint64_t gpr_result, 22462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint64_t fpr_result) 22562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 226725a957985171d712d5c048cc3d00ff14968784bjeffhao 22762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Pops an instrumentation frame from the current thread and generate an unwind event. 22862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void PopMethodForUnwind(Thread* self, bool is_deoptimization) const 22962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 23062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 23162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Call back for configure stubs. 23262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool InstallStubsForClass(mirror::Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 233725a957985171d712d5c048cc3d00ff14968784bjeffhao 234725a957985171d712d5c048cc3d00ff14968784bjeffhao private: 23562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Does the job of installing or removing instrumentation code within methods. 23662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void ConfigureStubs(bool require_entry_exit_stubs, bool require_interpreter) 23762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers EXCLUSIVE_LOCKS_REQUIRED(Locks::mutator_lock_) 23862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers LOCKS_EXCLUDED(Locks::thread_list_lock_, Locks::classlinker_classes_lock_); 23962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 240ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz void UpdateInterpreterHandlerTable() { 241ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz interpreter_handler_table_ = IsActive() ? kAlternativeHandlerTable : kMainHandlerTable; 242ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz } 243ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 24462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodEnterEventImpl(Thread* thread, mirror::Object* this_object, 245ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc) const 24662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 24762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void MethodExitEventImpl(Thread* thread, mirror::Object* this_object, 248ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, 24962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers uint32_t dex_pc, const JValue& return_value) const 25062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 25162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers void DexPcMovedEventImpl(Thread* thread, mirror::Object* this_object, 252ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom const mirror::ArtMethod* method, uint32_t dex_pc) const 25362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 25462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 255ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ so that it calls instrumentation/interpreter code? 25662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool instrumentation_stubs_installed_; 25762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 258ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ to reference the enter/exit stubs? 25962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool entry_exit_stubs_installed_; 26062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 261ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom // Have we hijacked ArtMethod::code_ to reference the enter interpreter stub? 26262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool interpreter_stubs_installed_; 26362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 26462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we need the fidelity of events that we only get from running within the interpreter? 26562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool interpret_only_; 266725a957985171d712d5c048cc3d00ff14968784bjeffhao 26762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Did the runtime request we only run in the interpreter? ie -Xint mode. 26862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool forced_interpret_only_; 269725a957985171d712d5c048cc3d00ff14968784bjeffhao 27062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method entry events? Short-cut to avoid taking the 27162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 27262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool have_method_entry_listeners_; 27362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 27462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method exit events? Short-cut to avoid taking the 27562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 27662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool have_method_exit_listeners_; 27762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 27862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for method unwind events? Short-cut to avoid taking the 27962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 28062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool have_method_unwind_listeners_; 28162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 28262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any listeners for dex move events? Short-cut to avoid taking the 28362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // instrumentation_lock_. 28462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool have_dex_pc_listeners_; 28562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 28662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // Do we have any exception caught listeners? Short-cut to avoid taking the instrumentation_lock_. 28762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers bool have_exception_caught_listeners_; 28862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 28962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers // The event listeners, written to with the mutator_lock_ exclusively held. 29062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_entry_listeners_ GUARDED_BY(Locks::mutator_lock_); 29162d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_exit_listeners_ GUARDED_BY(Locks::mutator_lock_); 29262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> method_unwind_listeners_ GUARDED_BY(Locks::mutator_lock_); 29362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> dex_pc_listeners_ GUARDED_BY(Locks::mutator_lock_); 29462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::list<InstrumentationListener*> exception_caught_listeners_ GUARDED_BY(Locks::mutator_lock_); 295725a957985171d712d5c048cc3d00ff14968784bjeffhao 296fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // Current interpreter handler table. This is updated each time the thread state flags are 297fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // modified. 298ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz InterpreterHandlerTable interpreter_handler_table_; 299ee1997a3b83334985e757f369c09e111b121661bSebastien Hertz 300fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // Greater than 0 if quick alloc entry points instrumented. 301fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers // TODO: The access and changes to this is racy and should be guarded by a lock. 302fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers size_t quick_alloc_entry_points_instrumentation_counter_; 303fa82427c68b09f4aedbee319dc71579afbfc66f5Ian Rogers 304725a957985171d712d5c048cc3d00ff14968784bjeffhao DISALLOW_COPY_AND_ASSIGN(Instrumentation); 305725a957985171d712d5c048cc3d00ff14968784bjeffhao}; 306725a957985171d712d5c048cc3d00ff14968784bjeffhao 30762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers// An element in the instrumentation side stack maintained in art::Thread. 30862d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogersstruct InstrumentationStackFrame { 309ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom InstrumentationStackFrame(mirror::Object* this_object, mirror::ArtMethod* method, 3109a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao uintptr_t return_pc, size_t frame_id, bool interpreter_entry) 3119a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao : this_object_(this_object), method_(method), return_pc_(return_pc), frame_id_(frame_id), 3129a916d3c0d0574d106c764e737c67b52988d6139Jeff Hao interpreter_entry_(interpreter_entry) { 31362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers } 31462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 31562d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers std::string Dump() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 31662d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 31762d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers mirror::Object* this_object_; 318ea46f950e7a51585db293cd7f047de190a482414Brian Carlstrom mirror::ArtMethod* method_; 31962d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const uintptr_t return_pc_; 32062d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers const size_t frame_id_; 32165d15d985a27be01e1d64f473af0e9d8eb19051dJeff Hao const bool interpreter_entry_; 32262d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers}; 32362d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers 32462d6c772205b8859f0ebf7ad105402ec4c3e2e01Ian Rogers} // namespace instrumentation 325725a957985171d712d5c048cc3d00ff14968784bjeffhao} // namespace art 326725a957985171d712d5c048cc3d00ff14968784bjeffhao 327fc0e3219edc9a5bf81b166e82fd5db2796eb6a0dBrian Carlstrom#endif // ART_RUNTIME_INSTRUMENTATION_H_ 328