| Index: src/base/debug/stack_trace.h
|
| diff --git a/src/base/debug/stack_trace.h b/src/base/debug/stack_trace.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..e938ef28689173365db7227a750939b07bb0d9b2
|
| --- /dev/null
|
| +++ b/src/base/debug/stack_trace.h
|
| @@ -0,0 +1,96 @@
|
| +// Copyright (c) 2012 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.
|
| +
|
| +// Slightly adapted for inclusion in V8.
|
| +// Copyright 2016 the V8 project authors. All rights reserved.
|
| +
|
| +#ifndef V8_BASE_DEBUG_STACK_TRACE_H_
|
| +#define V8_BASE_DEBUG_STACK_TRACE_H_
|
| +
|
| +#include <stddef.h>
|
| +
|
| +#include <iosfwd>
|
| +#include <string>
|
| +
|
| +#include "src/base/build_config.h"
|
| +
|
| +#if V8_OS_POSIX
|
| +#include <unistd.h>
|
| +#endif
|
| +
|
| +#if V8_OS_WIN
|
| +struct _EXCEPTION_POINTERS;
|
| +struct _CONTEXT;
|
| +#endif
|
| +
|
| +namespace v8 {
|
| +namespace base {
|
| +namespace debug {
|
| +
|
| +// Enables stack dump to console output on exception and signals.
|
| +// When enabled, the process will quit immediately. This is meant to be used in
|
| +// tests only!
|
| +bool EnableInProcessStackDumping();
|
| +void DisableSignalStackDump();
|
| +
|
| +// A stacktrace can be helpful in debugging. For example, you can include a
|
| +// stacktrace member in a object (probably around #ifndef NDEBUG) so that you
|
| +// can later see where the given object was created from.
|
| +class StackTrace {
|
| + public:
|
| + // Creates a stacktrace from the current location.
|
| + StackTrace();
|
| +
|
| + // Creates a stacktrace from an existing array of instruction
|
| + // pointers (such as returned by Addresses()). |count| will be
|
| + // trimmed to |kMaxTraces|.
|
| + StackTrace(const void* const* trace, size_t count);
|
| +
|
| +#if V8_OS_WIN
|
| + // Creates a stacktrace for an exception.
|
| + // Note: this function will throw an import not found (StackWalk64) exception
|
| + // on system without dbghelp 5.1.
|
| + explicit StackTrace(_EXCEPTION_POINTERS* exception_pointers);
|
| + explicit StackTrace(const _CONTEXT* context);
|
| +#endif
|
| +
|
| + // Copying and assignment are allowed with the default functions.
|
| +
|
| + ~StackTrace();
|
| +
|
| + // Gets an array of instruction pointer values. |*count| will be set to the
|
| + // number of elements in the returned array.
|
| + const void* const* Addresses(size_t* count) const;
|
| +
|
| + // Prints the stack trace to stderr.
|
| + void Print() const;
|
| +
|
| + // Resolves backtrace to symbols and write to stream.
|
| + void OutputToStream(std::ostream* os) const;
|
| +
|
| + // Resolves backtrace to symbols and returns as string.
|
| + std::string ToString() const;
|
| +
|
| + private:
|
| +#if V8_OS_WIN
|
| + void InitTrace(const _CONTEXT* context_record);
|
| +#endif
|
| +
|
| + // From http://msdn.microsoft.com/en-us/library/bb204633.aspx,
|
| + // the sum of FramesToSkip and FramesToCapture must be less than 63,
|
| + // so set it to 62. Even if on POSIX it could be a larger value, it usually
|
| + // doesn't give much more information.
|
| + static const int kMaxTraces = 62;
|
| +
|
| + void* trace_[kMaxTraces];
|
| +
|
| + // The number of valid frames in |trace_|.
|
| + size_t count_;
|
| +};
|
| +
|
| +} // namespace debug
|
| +} // namespace base
|
| +} // namespace v8
|
| +
|
| +#endif // V8_BASE_DEBUG_STACK_TRACE_H_
|
|
|