jcs.org
Serenity Operating System
1/*
2 * Copyright (c) 2021, Itamar S. <itamar8910@gmail.com>
3 * Copyright (c) 2022, the SerenityOS developers.
4 *
5 * SPDX-License-Identifier: BSD-2-Clause
6 */
7
8#pragma once
9
10#include "LoadedLibrary.h"
11#include <AK/Types.h>
12#include <sys/arch/regs.h>
13
14namespace Debug {
15
16class ProcessInspector {
17public:
18 virtual ~ProcessInspector() = default;
19 virtual bool poke(FlatPtr address, FlatPtr data) = 0;
20 virtual Optional<FlatPtr> peek(FlatPtr address) const = 0;
21 virtual PtraceRegisters get_registers() const = 0;
22 virtual void set_registers(PtraceRegisters const&) = 0;
23 virtual void for_each_loaded_library(Function<IterationDecision(LoadedLibrary const&)>) const = 0;
24
25 LoadedLibrary const* library_at(FlatPtr address) const;
26 struct SymbolicationResult {
27 DeprecatedString library_name;
28 DeprecatedString symbol;
29 };
30 Optional<SymbolicationResult> symbolicate(FlatPtr address) const;
31 Optional<DebugInfo::SourcePositionAndAddress> get_address_from_source_position(DeprecatedString const& file, size_t line) const;
32 Optional<DebugInfo::SourcePosition> get_source_position(FlatPtr address) const;
33
34protected:
35 ProcessInspector() = default;
36};
37
38};