1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/***
(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>
#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
{
#ifdef __APPLE__
typedef caddr_t CAddr;
#else
typedef char* CAddr;
#endif
/// \brief Debugger engine interface class in C++
/// \author Amlal El Mahrouss
class IDebuggerEngine final
{
public:
explicit IDebuggerEngine() = default;
~IDebuggerEngine() = default;
public:
IDebuggerEngine& operator=(const IDebuggerEngine&) = default;
IDebuggerEngine(const IDebuggerEngine&) = default;
public:
void Attach(pid_t pid)
{
if (ptrace(PTRACE_ATTACH, pid, nullptr, 0) == -1)
{
perror("dbg: Attach");
return;
}
this->m_pid = pid;
waitpid(m_pid, nullptr, 0);
std::cout << "[+] Attached to process: " << m_pid << std::endl;
}
void SetBreakpoint(CAddr addr)
{
uintptr_t original_data = ptrace(PTRACE_PEEKTEXT, m_pid, addr, 0);
if (original_data == -1)
{
perror("dbg: Peek");
return;
}
uintptr_t data_with_int3 = (original_data & ~0xFF) | 0xCC; // Insert INT3 (0xCC)
if (ptrace(PTRACE_POKETEXT, m_pid, addr, data_with_int3) == -1)
{
perror("dbg: Poke");
return;
}
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, 0) == -1)
{
perror("dbg: Cont");
return;
}
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, 0) == -1)
{
perror("dbg: Detach");
return;
}
std::cout << "[-] Detached from process: " << m_pid << std::endl;
}
std::unordered_map<uintptr_t, uintptr_t>& Breakpoints()
{
return m_breakpoints;
}
private:
pid_t m_pid;
std::unordered_map<uintptr_t, uintptr_t> m_breakpoints;
};
} // namespace LibDebugger
|