| // Copyright 2019 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #ifndef BASE_PROFILER_NATIVE_UNWINDER_ANDROID_H_ |
| #define BASE_PROFILER_NATIVE_UNWINDER_ANDROID_H_ |
| |
| #include <memory> |
| #include <vector> |
| |
| #include "base/memory/raw_ptr.h" |
| #include "base/profiler/unwinder.h" |
| #include "third_party/libunwindstack/src/libunwindstack/include/unwindstack/Maps.h" |
| #include "third_party/libunwindstack/src/libunwindstack/include/unwindstack/Memory.h" |
| |
| namespace base { |
| |
| // Implementation of unwindstack::Memory that restricts memory access to a stack |
| // buffer, used by NativeUnwinderAndroid. While unwinding, only memory accesses |
| // within the stack should be performed to restore registers. |
| class UnwindStackMemoryAndroid : public unwindstack::Memory { |
| public: |
| UnwindStackMemoryAndroid(uintptr_t stack_ptr, uintptr_t stack_top); |
| ~UnwindStackMemoryAndroid() override; |
| |
| size_t Read(uint64_t addr, void* dst, size_t size) override; |
| |
| private: |
| const uintptr_t stack_ptr_; |
| const uintptr_t stack_top_; |
| }; |
| |
| // Native unwinder implementation for Android, using libunwindstack. |
| class NativeUnwinderAndroid : public Unwinder, |
| public ModuleCache::AuxiliaryModuleProvider { |
| public: |
| // Creates maps object from /proc/self/maps for use by NativeUnwinderAndroid. |
| // Since this is an expensive call, the maps object should be re-used across |
| // all profiles in a process. |
| static std::unique_ptr<unwindstack::Maps> CreateMaps(); |
| static std::unique_ptr<unwindstack::Memory> CreateProcessMemory(); |
| |
| // |memory_regions_map| and |process_memory| must outlive this unwinder. |
| // |exclude_module_with_base_address| is used to exclude a specific module and |
| // let another unwinder take control. TryUnwind() will exit with |
| // UNRECOGNIZED_FRAME and CanUnwindFrom() will return false when a frame is |
| // encountered in that module. |
| NativeUnwinderAndroid(unwindstack::Maps* memory_regions_map, |
| unwindstack::Memory* process_memory, |
| uintptr_t exclude_module_with_base_address); |
| ~NativeUnwinderAndroid() override; |
| |
| NativeUnwinderAndroid(const NativeUnwinderAndroid&) = delete; |
| NativeUnwinderAndroid& operator=(const NativeUnwinderAndroid&) = delete; |
| |
| // Unwinder |
| void InitializeModules() override; |
| bool CanUnwindFrom(const Frame& current_frame) const override; |
| UnwindResult TryUnwind(RegisterContext* thread_context, |
| uintptr_t stack_top, |
| std::vector<Frame>* stack) const override; |
| |
| // ModuleCache::AuxiliaryModuleProvider |
| std::unique_ptr<const ModuleCache::Module> TryCreateModuleForAddress( |
| uintptr_t address) override; |
| |
| private: |
| void EmitDexFrame(uintptr_t dex_pc, |
| std::vector<Frame>* stack) const; |
| |
| const raw_ptr<unwindstack::Maps> memory_regions_map_; |
| const raw_ptr<unwindstack::Memory> process_memory_; |
| const uintptr_t exclude_module_with_base_address_; |
| }; |
| |
| } // namespace base |
| |
| #endif // BASE_PROFILER_NATIVE_UNWINDER_ANDROID_H_ |