summaryrefslogtreecommitdiffstats
path: root/chromium/base/profiler/thread_delegate.h
diff options
context:
space:
mode:
authorAllan Sandfeld Jensen <allan.jensen@qt.io>2019-05-24 11:40:17 +0200
committerAllan Sandfeld Jensen <allan.jensen@qt.io>2019-05-24 12:42:11 +0000
commit5d87695f37678f96492b258bbab36486c59866b4 (patch)
treebe9783bbaf04fb930c4d74ca9c00b5e7954c8bc6 /chromium/base/profiler/thread_delegate.h
parent6c11fb357ec39bf087b8b632e2b1e375aef1b38b (diff)
BASELINE: Update Chromium to 75.0.3770.56
Change-Id: I86d2007fd27a45d5797eee06f4c9369b8b50ac4f Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
Diffstat (limited to 'chromium/base/profiler/thread_delegate.h')
-rw-r--r--chromium/base/profiler/thread_delegate.h72
1 files changed, 72 insertions, 0 deletions
diff --git a/chromium/base/profiler/thread_delegate.h b/chromium/base/profiler/thread_delegate.h
new file mode 100644
index 00000000000..d0f0f028405
--- /dev/null
+++ b/chromium/base/profiler/thread_delegate.h
@@ -0,0 +1,72 @@
+// 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_THREAD_DELEGATE_H_
+#define BASE_PROFILER_THREAD_DELEGATE_H_
+
+#include <vector>
+
+#include "base/base_export.h"
+#include "base/profiler/frame.h"
+#include "base/profiler/register_context.h"
+
+namespace base {
+
+// Platform-specific thread and stack manipulation delegate, for use by the
+// platform-independent stack copying/walking implementation in
+// StackSamplerImpl.
+//
+// IMPORTANT NOTE: Most methods in this interface are invoked while the target
+// thread is suspended so must not do any allocation from the heap, including
+// indirectly via use of DCHECK/CHECK or other logging statements. Otherwise the
+// implementation can deadlock on heap locks acquired by the target thread
+// before it was suspended. These functions are commented with "NO HEAP
+// ALLOCATIONS".
+class BASE_EXPORT ThreadDelegate {
+ public:
+ // Implementations of this interface should suspend the thread for the
+ // object's lifetime. NO HEAP ALLOCATIONS between the time the thread is
+ // suspended and resumed.
+ class BASE_EXPORT ScopedSuspendThread {
+ public:
+ ScopedSuspendThread() = default;
+ virtual ~ScopedSuspendThread() = default;
+
+ ScopedSuspendThread(const ScopedSuspendThread&) = delete;
+ ScopedSuspendThread& operator=(const ScopedSuspendThread&) = delete;
+
+ virtual bool WasSuccessful() const = 0;
+ };
+
+ ThreadDelegate() = default;
+ virtual ~ThreadDelegate() = default;
+
+ ThreadDelegate(const ThreadDelegate&) = delete;
+ ThreadDelegate& operator=(const ThreadDelegate&) = delete;
+
+ // Creates an object that holds the thread suspended for its lifetime.
+ virtual std::unique_ptr<ScopedSuspendThread> CreateScopedSuspendThread() = 0;
+
+ // Gets the register context for the thread.
+ // NO HEAP ALLOCATIONS.
+ virtual bool GetThreadContext(RegisterContext* thread_context) = 0;
+
+ // Gets the base address of the thread's stack.
+ virtual uintptr_t GetStackBaseAddress() const = 0;
+
+ // Returns true if the thread's stack can be copied, where the bottom address
+ // of the thread is at |stack_pointer|.
+ // NO HEAP ALLOCATIONS.
+ virtual bool CanCopyStack(uintptr_t stack_pointer) = 0;
+
+ // Returns a list of registers that should be rewritten to point into the
+ // stack copy, if they originally pointed into the original stack.
+ // May heap allocate.
+ virtual std::vector<uintptr_t*> GetRegistersToRewrite(
+ RegisterContext* thread_context) = 0;
+};
+
+} // namespace base
+
+#endif // BASE_PROFILER_THREAD_DELEGATE_H_