/* * Copyright (c) 2020, Itamar S. * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include "BreakpointCallback.h" #include #include #include #include #include #include namespace HackStudio { class Debugger { public: static Debugger& the(); enum class HasControlPassedToUser { No, Yes, }; static void initialize( ByteString source_root, Function on_stop_callback, Function on_continue_callback, Function on_exit_callback, Function on_initialization_progress); static bool is_initialized(); [[nodiscard]] bool change_breakpoint(ByteString const& file, size_t line, BreakpointChange change_type); bool set_execution_position(ByteString const& file, size_t line); void set_executable_path(ByteString const& path) { m_executable_path = path; } void set_source_root(ByteString const& source_root) { m_source_root = source_root; } void set_pid_to_attach(pid_t pid) { m_pid_to_attach = pid; } Debug::DebugSession* session() { return m_debug_session.ptr(); } void stop(); // Thread entry point static intptr_t start_static(); pthread_mutex_t* continue_mutex() { return &m_ui_action_mutex; } pthread_cond_t* continue_cond() { return &m_ui_action_cond; } enum class DebuggerAction { Continue, SourceSingleStep, SourceStepOut, SourceStepOver, Exit, }; void set_requested_debugger_action(DebuggerAction); void reset_breakpoints() { m_breakpoints.clear(); } void set_child_setup_callback(Function()> callback) { m_child_setup_callback = move(callback); } void stop_debuggee(); private: class DebuggingState { public: enum State { Normal, // Continue normally until we hit a breakpoint / program terminates SingleStepping, SteppingOut, SteppingOver, }; State get() const { return m_state; } void set_normal(); void set_single_stepping(Debug::DebugInfo::SourcePosition original_source_position); void set_stepping_out() { m_state = State::SteppingOut; } void set_stepping_over() { m_state = State::SteppingOver; } bool should_stop_single_stepping(Debug::DebugInfo::SourcePosition const& current_source_position) const; void clear_temporary_breakpoints(); void add_temporary_breakpoint(FlatPtr address); Vector const& temporary_breakpoints() const { return m_addresses_of_temporary_breakpoints; } private: State m_state { Normal }; Optional m_original_source_position; // The source position at which we started the current single step Vector m_addresses_of_temporary_breakpoints; }; explicit Debugger( ByteString source_root, Function on_stop_callback, Function on_continue_callback, Function on_exit_callback, Function on_initialization_progress); Debug::DebugInfo::SourcePosition create_source_position(ByteString const& file, size_t line); void start(); int debugger_loop(Debug::DebugSession::DesiredInitialDebugeeState); void remove_temporary_breakpoints(); void do_step_out(PtraceRegisters const&); void do_step_over(PtraceRegisters const&); void insert_temporary_breakpoint(FlatPtr address); void insert_temporary_breakpoint_at_return_address(PtraceRegisters const&); struct CreateDebugSessionResult { NonnullOwnPtr session; Debug::DebugSession::DesiredInitialDebugeeState initial_state { Debug::DebugSession::Stopped }; }; CreateDebugSessionResult create_debug_session(); OwnPtr m_debug_session; ByteString m_source_root; DebuggingState m_state; pthread_mutex_t m_ui_action_mutex {}; pthread_cond_t m_ui_action_cond {}; DebuggerAction m_requested_debugger_action { DebuggerAction::Continue }; Vector m_breakpoints; ByteString m_executable_path; Optional m_pid_to_attach; Function m_on_stopped_callback; Function m_on_continue_callback; Function m_on_exit_callback; Function()> m_child_setup_callback; Function m_on_initialization_progress; }; }