Source code for libdebug.architectures.stack_unwinding_manager

#
# This file is part of libdebug Python library (https://github.com/libdebug/libdebug).
# Copyright (c) 2023-2024 Gabriele Digregorio, Roberto Alessandro Bertolini. All rights reserved.
# Licensed under the MIT license. See LICENSE file in the project root for details.
#

from __future__ import annotations

from abc import ABC, abstractmethod
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from libdebug.state.thread_context import ThreadContext



[docs]
class StackUnwindingManager(ABC):
    """An architecture-independent interface for stack unwinding."""


[docs]
    @abstractmethod
    def unwind(self: StackUnwindingManager, target: ThreadContext) -> list:
        """Unwind the stack of the target process."""



[docs]
    @abstractmethod
    def get_return_address(self: StackUnwindingManager, target: ThreadContext) -> int:
        """Get the return address of the current function."""