aboutsummaryrefslogtreecommitdiff
path: root/externals/breakpad/src/google_breakpad/processor/stack_frame.h
diff options
context:
space:
mode:
authorcrueter <crueter@eden-emu.dev>2025-08-04 04:50:14 +0200
committercrueter <crueter@eden-emu.dev>2025-08-04 04:50:14 +0200
commit51b170b470ed587f99a7c2a773e4464687f0d07a (patch)
tree4c03c510cfb17a5f5d6233df490d78f06dcfa7f7 /externals/breakpad/src/google_breakpad/processor/stack_frame.h
parent04e5e6453875ffa5c79cdb421a29bc19985b1049 (diff)
[cmake] refactor: Use CPM over submodules (#143)
Transfers the majority of submodules and large externals to CPM, using source archives rather than full Git clones. Not only does this save massive amounts of clone and configure time, but dependencies are grabbed on-demand rather than being required by default. Additionally, CPM will (generally) automatically search for system dependencies, though certain dependencies have options to control this. Testing shows gains ranging from 5x to 10x in terms of overall clone/configure time. Reviewed-on: https://git.eden-emu.dev/eden-emu/eden/pulls/143 Reviewed-by: CamilleLaVey <camillelavey99@gmail.com>
Diffstat (limited to 'externals/breakpad/src/google_breakpad/processor/stack_frame.h')
-rw-r--r--externals/breakpad/src/google_breakpad/processor/stack_frame.h158
1 files changed, 0 insertions, 158 deletions
diff --git a/externals/breakpad/src/google_breakpad/processor/stack_frame.h b/externals/breakpad/src/google_breakpad/processor/stack_frame.h
deleted file mode 100644
index eebe06e6a3..0000000000
--- a/externals/breakpad/src/google_breakpad/processor/stack_frame.h
+++ /dev/null
@@ -1,158 +0,0 @@
-// Copyright 2006 Google LLC
-//
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions are
-// met:
-//
-// * Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-// * Redistributions in binary form must reproduce the above
-// copyright notice, this list of conditions and the following disclaimer
-// in the documentation and/or other materials provided with the
-// distribution.
-// * Neither the name of Google LLC nor the names of its
-// contributors may be used to endorse or promote products derived from
-// this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-#ifndef GOOGLE_BREAKPAD_PROCESSOR_STACK_FRAME_H__
-#define GOOGLE_BREAKPAD_PROCESSOR_STACK_FRAME_H__
-
-#include <string>
-
-#include "common/using_std_string.h"
-#include "google_breakpad/common/breakpad_types.h"
-
-namespace google_breakpad {
-
-class CodeModule;
-
-struct StackFrame {
- // Indicates how well the instruction pointer derived during
- // stack walking is trusted. Since the stack walker can resort to
- // stack scanning, it can wind up with dubious frames.
- // In rough order of "trust metric".
- enum FrameTrust {
- FRAME_TRUST_NONE, // Unknown
- FRAME_TRUST_SCAN, // Scanned the stack, found this
- FRAME_TRUST_CFI_SCAN, // Found while scanning stack using call frame info
- FRAME_TRUST_FP, // Derived from frame pointer
- FRAME_TRUST_CFI, // Derived from call frame info
- // Explicitly provided by some external stack walker.
- FRAME_TRUST_PREWALKED,
- FRAME_TRUST_CONTEXT, // Given as instruction pointer in a context
- FRAME_TRUST_INLINE, // Found by inline records in symbol files.
- // Derived from leaf function by simulating a return.
- FRAME_TRUST_LEAF,
- };
-
- StackFrame()
- : instruction(),
- module(NULL),
- function_name(),
- function_base(),
- source_file_name(),
- source_line(0),
- source_line_base(),
- trust(FRAME_TRUST_NONE),
- is_multiple(false) {}
- virtual ~StackFrame() {}
-
- // Return a string describing how this stack frame was found
- // by the stackwalker.
- string trust_description() const {
- switch (trust) {
- case StackFrame::FRAME_TRUST_CONTEXT:
- return "given as instruction pointer in context";
- case StackFrame::FRAME_TRUST_PREWALKED:
- return "recovered by external stack walker";
- case StackFrame::FRAME_TRUST_CFI:
- return "call frame info";
- case StackFrame::FRAME_TRUST_CFI_SCAN:
- return "call frame info with scanning";
- case StackFrame::FRAME_TRUST_FP:
- return "previous frame's frame pointer";
- case StackFrame::FRAME_TRUST_SCAN:
- return "stack scanning";
- case StackFrame::FRAME_TRUST_INLINE:
- return "inline record";
- case StackFrame::FRAME_TRUST_LEAF:
- return "simulating a return from leaf function";
- default:
- return "unknown";
- }
- }
-
- // Return the actual return address, as saved on the stack or in a
- // register. See the comments for 'instruction', below, for details.
- virtual uint64_t ReturnAddress() const { return instruction; }
-
- // The program counter location as an absolute virtual address.
- //
- // - For the innermost called frame in a stack, this will be an exact
- // program counter or instruction pointer value.
- //
- // - For all other frames, this address is within the instruction that
- // caused execution to branch to this frame's callee (although it may
- // not point to the exact beginning of that instruction). This ensures
- // that, when we look up the source code location for this frame, we
- // get the source location of the call, not of the point at which
- // control will resume when the call returns, which may be on the next
- // line. (If the compiler knows the callee never returns, it may even
- // place the call instruction at the very end of the caller's machine
- // code, such that the "return address" (which will never be used)
- // immediately after the call instruction is in an entirely different
- // function, perhaps even from a different source file.)
- //
- // On some architectures, the return address as saved on the stack or in
- // a register is fine for looking up the point of the call. On others, it
- // requires adjustment. ReturnAddress returns the address as saved by the
- // machine.
- uint64_t instruction;
-
- // The module in which the instruction resides.
- const CodeModule *module;
-
- // The function name, may be omitted if debug symbols are not available.
- string function_name;
-
- // The start address of the function, may be omitted if debug symbols
- // are not available.
- uint64_t function_base;
-
- // The source file name, may be omitted if debug symbols are not available.
- string source_file_name;
-
- // The (1-based) source line number, may be omitted if debug symbols are
- // not available.
- int source_line;
-
- // The start address of the source line, may be omitted if debug symbols
- // are not available.
- uint64_t source_line_base;
-
- // Amount of trust the stack walker has in the instruction pointer
- // of this frame.
- FrameTrust trust;
-
- // True if the frame corresponds to multiple functions, for example as the
- // result of identical code folding by the linker. In that case the function
- // name, filename, etc. information above represents the state of an arbitrary
- // one of these functions.
- bool is_multiple;
-};
-
-} // namespace google_breakpad
-
-#endif // GOOGLE_BREAKPAD_PROCESSOR_STACK_FRAME_H__