feat(debugger): Better design for LibDebugger, and a patch for the POSIX

CLI.

Signed-off-by: Amlal El Mahrouss <amlal@nekernel.org>

1 files changed, 106 insertions, 0 deletions

diff --git a/dev/LibDebugger/POSIXContract.h b/dev/LibDebugger/POSIXContract.h
new file mode 100644
index 0000000..5a8ae48
--- /dev/null
+++ b/dev/LibDebugger/POSIXContract.h
@@ -0,0 +1,106 @@
+/***
+	(C) 2025 Amlal El Mahrouss
+ */
+
+#pragma once
+
+#ifdef _WIN32
+#error Windows doesn't have a POSIX subsystem, please combine with windows instead.
+#endif
+
+#include <LibDebugger/DebuggerContract.h>
+
+#include <sys/ptrace.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <sys/user.h>
+#include <unistd.h>
+#include <stdint.h>
+
+#ifdef __APPLE__
+#define PTRACE_ATTACH	PT_ATTACHEXC
+#define PTRACE_DETACH	PT_DETACH
+#define PTRACE_POKETEXT PT_WRITE_I
+#define PTRACE_CONT		PT_CONTINUE
+#define PTRACE_PEEKTEXT PT_READ_I
+#endif
+
+namespace LibDebugger::POSIX
+{
+	/// \brief POSIXDebuggerContract engine interface class in C++
+	/// \author Amlal El Mahrouss
+	class POSIXDebuggerContract final : public DebuggerContract
+	{
+	public:
+		explicit POSIXDebuggerContract()  = default;
+		~POSIXDebuggerContract() override = default;
+
+	public:
+		POSIXDebuggerContract& operator=(const POSIXDebuggerContract&) = default;
+		POSIXDebuggerContract(const POSIXDebuggerContract&)			 = default;
+
+	public:
+		bool Attach(ProcessID pid) noexcept override
+		{
+			if (ptrace(PTRACE_ATTACH, pid, nullptr, 0) == -1)
+			{
+				return false;
+			}
+
+			this->m_pid = pid;
+
+			waitpid(m_pid, nullptr, 0);
+
+			return true;
+		}
+
+		bool Break(CAddress addr) noexcept override
+		{
+			uintptr_t original_data = ptrace(PTRACE_PEEKTEXT, m_pid, addr, 0);
+
+			if (original_data == -1)
+			{
+				return false;
+			}
+
+			constexpr uint8_t kInt3x86 = 0xCC;
+
+			uintptr_t data_with_int3 = (original_data & ~0xFF) | kInt3x86; // Insert INT3 (0xCC)
+
+			if (ptrace(PTRACE_POKETEXT, m_pid, addr, data_with_int3) == -1)
+			{
+				return false;
+			}
+
+			m_breakpoints[reinterpret_cast<uintptr_t>(addr)] = original_data; // Store original data
+
+			return true;
+		}
+
+		bool Continue() noexcept override
+		{
+			if (ptrace(PTRACE_CONT, m_pid, nullptr, 0) == -1)
+			{
+				return false;
+			}
+
+			int status;
+			waitpid(m_pid, &status, 0);
+
+			return WIFSTOPPED(status) && WSTOPSIG(status) == SIGTRAP;
+		}
+
+		bool Detach() noexcept override
+		{
+			if (ptrace(PTRACE_DETACH, m_pid, nullptr, 0) == -1)
+			{
+				return false;
+			}
+
+			return true;
+		}
+
+	private:
+		pid_t									 m_pid;
+	};
+} // namespace LibDebugger::POSIX