ADD: LibDebugger C++ library and improved `dbg` tool.

ADD: New manual files `dbg` and `ld64`

Signed-off-by: Amlal <amlal.elmahrouss@icloud.com>

2 files changed, 10 insertions, 108 deletions

diff --git a/tools/dbg.cc b/tools/dbg.cc
index ded2dbd..a6f739a 100644
--- a/tools/dbg.cc
+++ b/tools/dbg.cc
@@ -2,118 +2,20 @@
 	(C) 2025 Amlal El Mahrouss
  */
 
-#include <iostream>
-#include <unordered_map>
-
-#include <sys/ptrace.h>
-#include <sys/types.h>
-#include <sys/wait.h>
-#include <sys/user.h>
-#include <unistd.h>
-#include <stdint.h>
-
-namespace LibDebugger
-{
-	/// \brief Debug IDebugger class in C++
-	/// \author Amlal El Mahrouss
-	class IDebugger final
-	{
-	public:
-		IDebugger()	 = default;
-		~IDebugger() = default;
-
-		IDebugger& operator=(const IDebugger&) = default;
-		IDebugger(const IDebugger&)			   = default;
-
-	public:
-		void Attach(pid_t pid)
-		{
-			this->m_pid = pid;
-
-			if (ptrace(PTRACE_ATTACH, this->m_pid, nullptr, nullptr) == -1)
-			{
-				perror("dbg: Attach");
-				exit(1);
-			}
-
-			waitpid(m_pid, nullptr, 0);
-			
-			std::cout << "[+] Attached to process: " << m_pid << std::endl;
-		}
-
-		void SetBreakpoint(void* addr)
-		{
-			long original_data = ptrace(PTRACE_PEEKTEXT, m_pid, addr, nullptr);
-			if (original_data == -1)
-			{
-				perror("dbg: Peek");
-				exit(1);
-			}
-
-			long data_with_int3 = (original_data & ~0xFF) | 0xCC; // Insert INT3 (0xCC)
-			if (ptrace(PTRACE_POKETEXT, m_pid, addr, data_with_int3) == -1)
-			{
-				perror("dbg: Poke");
-				exit(1);
-			}
-
-			std::cout << "[+] Breakpoint set at: " << addr << std::endl;
-
-			m_breakpoints[reinterpret_cast<uintptr_t>(addr)] = original_data; // Store original data
-		}
-
-		void ContinueExecution()
-		{
-			if (ptrace(PTRACE_CONT, m_pid, nullptr, nullptr) == -1)
-			{
-				perror("dbg: Cont");
-				exit(1);
-			}
-
-			int status;
-			waitpid(m_pid, &status, 0);
-
-			if (WIFSTOPPED(status) && WSTOPSIG(status) == SIGTRAP)
-			{
-				std::cout << "[!] Breakpoint hit." << std::endl;
-			}
-		}
-
-		void Detach()
-		{
-			if (ptrace(PTRACE_DETACH, m_pid, nullptr, nullptr) == -1)
-			{
-				perror("dbg: Detach");
-				exit(1);
-			}
-
-			std::cout << "[-] Detached from process: " << m_pid << std::endl;
-		}
-
-		std::unordered_map<uintptr_t, long>& Breakpoints()
-		{
-			return m_breakpoints;
-		}
-
-	private:
-		pid_t								m_pid;
-		std::unordered_map<uintptr_t, long> m_breakpoints;
-	};
-} // namespace LibDebugger
+#include <LibDebugger/Debugger.h>
 
 int main(int argc, char* argv[])
 {
-	if (!argv[1])
+	LibDebugger::IDebugger debugger;
+	pid_t				   pid = 0L;
+
+	if (argc >= 3 && std::string(argv[1]) == "-p" &&
+		argv[2] != nullptr)
 	{
-		std::cout << "[?] Enter a PID to attach on.\n";
-		return EXIT_FAILURE;
+		pid = std::stoi(argv[2]);
+		debugger.Attach(pid);
 	}
 
-	pid_t pid = std::stoi(argv[1]);
-
-	LibDebugger::IDebugger debugger;
-	debugger.Attach(pid);
-
 	while (true)
 	{
 		std::string cmd;
@@ -133,7 +35,7 @@ int main(int argc, char* argv[])
 
 			std::getline(std::cin, cmd);
 			pid = std::stoi(cmd.c_str());
-      
+
 			debugger.Attach(pid);
 		}
 
diff --git a/tools/dbg.sh b/tools/dbg.sh
index 8624b93..6689d13 100755
--- a/tools/dbg.sh
+++ b/tools/dbg.sh
@@ -1,2 +1,2 @@
 #!/bin/sh
-g++ dbg.cc -o dbg
+g++ dbg.cc -std=c++20 -I../dev -o dbg