stack.h 1.96 KB
Newer Older
1 2 3 4
// Copyright 2020 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

5 6
#ifndef V8_HEAP_BASE_STACK_H_
#define V8_HEAP_BASE_STACK_H_
7 8 9

#include "src/base/macros.h"

10 11
namespace heap {
namespace base {
12 13 14 15 16 17 18 19 20 21 22 23

class StackVisitor {
 public:
  virtual void VisitPointer(const void* address) = 0;
};

// Abstraction over the stack. Supports handling of:
// - native stack;
// - ASAN/MSAN;
// - SafeStack: https://releases.llvm.org/10.0.0/tools/clang/docs/SafeStack.html
class V8_EXPORT_PRIVATE Stack final {
 public:
24 25 26 27
  explicit Stack(const void* stack_start = nullptr);

  // Sets the start of the stack.
  void SetStackStart(const void* stack_start);
28 29 30 31

  // Returns true if |slot| is part of the stack and false otherwise.
  bool IsOnStack(void* slot) const;

32 33 34
  // Word-aligned iteration of the stack. Callee-saved registers are pushed to
  // the stack before iterating pointers. Slot values are passed on to
  // `visitor`.
35 36
  void IteratePointers(StackVisitor* visitor) const;

37 38 39 40 41 42 43 44 45
  // Word-aligned iteration of the stack, starting at `stack_end`. Slot values
  // are passed on to `visitor`. This is intended to be used with verifiers that
  // only visit a subset of the stack of IteratePointers().
  //
  // **Ignores:**
  // - Callee-saved registers.
  // - SafeStack.
  void IteratePointersUnsafe(StackVisitor* visitor, uintptr_t stack_end) const;

46 47
  // Returns the start of the stack.
  const void* stack_start() const { return stack_start_; }
48

49 50 51 52 53 54
  // Get the current stack pointer for the stack, on which local variables are
  // stored. In case the safe-stack is enabled (-fsanitize=safe-stack), this
  // will return the stack pointer for the unsafe-stack. Otherwise, the function
  // returns the stack pointer for the native stack.
  static const void* GetCurrentStackPointerForLocalVariables();

55
 private:
56 57 58
  const void* stack_start_;
};

59 60
}  // namespace base
}  // namespace heap
61

62
#endif  // V8_HEAP_BASE_STACK_H_