Source code for libdebug.ptrace.ptrace_register_holder

#
# This file is part of libdebug Python library (https://github.com/libdebug/libdebug).
# Copyright (c) 2023-2024 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 dataclasses import dataclass
from typing import TYPE_CHECKING

from libdebug.data.register_holder import RegisterHolder

if TYPE_CHECKING:
    from libdebug.state.thread_context import ThreadContext



[docs]
@dataclass
class PtraceRegisterHolder(RegisterHolder):
    """An abstract class that holds the state of the registers of a process, providing setters and getters for them.

    Intended for use with the Ptrace debugging backend.
    """

    register_file: object
    """The register file of the target process, as returned by ptrace."""


[docs]
    def poll(self: PtraceRegisterHolder, target: ThreadContext) -> None:
        """Poll the register values from the specified target."""
        raise NotImplementedError("Do not call this method.")



[docs]
    def flush(self: PtraceRegisterHolder, source: ThreadContext) -> None:
        """Flush the register values from the specified source."""
        raise NotImplementedError("Do not call this method.")