Awesome
frida-watchpoint-tutorial
A great feature called setHardwareWatchpoint was introduced in Frida version 16.5.0. This makes it easy to determine where memory is being read from or written to.
I will explore how to use this feature through a sample Unreal Engine v4.27.2 game.<br> Readers can download it from the release section.<br> Since I made the Unreal game myself and already know the logic, I will skip the SDK dump and analysis. I recommend that readers try dumping and analyzing the game logic themselves.
To save the readers' time, I recommend reading the final section and then immediately attaching the script to test it.<br> The first three sections are more like trial and error before writing the final section.
- Android Unreal Engine Tutorial
- What about iOS?
- Finding a thread
- Are you sure you really can't set the watchpoint on all threads?
Android Unreal Engine Tutorial
EndlessRunner is a game where you collect coins while running.
Let’s run the game and attach a Frida script.
frida -UF -l script.js
As the game progresses, you will see the following logs:
The number of coins is stored at 0x74cf563e30.
[Galaxy S10::EndlessRunner ]->
[*] AddCoin() is called, class instance is 0x74cf563b20
[*] TotalCoins are stored at class instance + 0x310
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
74cf563e30 01 00 00 00 00 00 00 00 40 72 56 cf 74 00 00 00 ........@rV.t...
[*] AddCoin() is called, class instance is 0x74cf563b20
[*] TotalCoins are stored at class instance + 0x310
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
74cf563e30 02 00 00 00 00 00 00 00 40 72 56 cf 74 00 00 00 ........@rV.t...
[*] AddCoin() is called, class instance is 0x74cf563b20
[*] TotalCoins are stored at class instance + 0x310
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
74cf563e30 03 00 00 00 00 00 00 00 40 72 56 cf 74 00 00 00 ........@rV.t...
Where is memory 0x74cf563e30 being written to?
Let’s set a watchpoint.
[!] Which thread should we set the watchpoint on?<br>
In setHardwareWatchpoint example, a watchpoint is set on Process.enumerateThreads()[0]
.
In an Unreal Engine game, this is the main thread, but you will find that setting the watchpoint here doesn’t yield any results.
If you take a closer look at the thread names, you’ll notice a thread called GameThread
. This is where the watchpoint needs to be set.
If you’re unsure which thread to set the watchpoint on, you can try setting it on all threads. The game may crash, but you’ll be able to obtain the thread name.
In this case, the installWatchpoint function in the script would be modified as follows:
function installWatchpoint(addr, size, conditions) {
_addr = addr;
_size = size;
_conditions = conditions;
threads = Process.enumerateThreads();
for (const thread of threads) {
Process.setExceptionHandler(e => {
console.log(`\n[!] ${e.context.pc} tried to "${_conditions}" at ${_addr} (${thread.id} ${thread.name})`);
if (['breakpoint', 'single-step'].includes(e.type)) {
thread.unsetHardwareWatchpoint(0);
unsetWatchPoint = true;
return true;
}
return false;
});
thread.setHardwareWatchpoint(0, addr, size, conditions);
console.log(`[*] HardwareWatchpoint set at ${addr} (${thread.id} ${thread.name})`);
}
}
Once you set a watchpoint at 0x74cf563e30 and progress in the game, the script will print out where memory 0x74cf563e30 is being accessed and written to.
Memory at 0x74cf563e30 is being accessed and written to at 0x751ae5a47c, so let’s examine the instruction at that location.
It stores the value of w9
at x0 + 310
.
So, before the value is stored at x0 + 310
, if we change the value of w9
, we can increase the number of coins.
Before hooking the registers at 0x751ae5a47c, let’s unset the watchpoint and detach the interceptor to avoid unexpected crashes.
Now, let’s hook at 0x751ae5a47c and add +100 to the value of the x9
register at the onEnter point.
Success!<br>
What about iOS?
The method is the same for Android.
However, finding the thread to set the watchpoint on is a bit more troublesome compared to Android.
This is because, when you print the thread names, no meaningful thread names are shown.
Also, if you set a watchpoint on all threads and observe, incorrect information is displayed.
In the picture below, it appears that the com.apple.CoreMotion.MotionThread
is writing to memory.
However, when you set the watchpoint only on com.apple.CoreMotion.MotionThread
and run the game, you don't get any results.
Perhaps the best method is to set the watchpoint on each thread one by one and check.
Since no meaningful thread names are visible, could it be one of the undefined threads?
Bingo!
Finding a thread
Readers who have read up to this point may have some questions.
"Aha, so I just need to find the right thread and set the watchpoint! But what if there are more than 100 threads? In that case, do I need to check each one manually?"
Indeed, setting a watchpoint on each thread one by one to check is impractical.
Upon reflection, the memory write operation I’m interested in is likely being performed by a game function.
So, if I hook a game function and get the thread ID when that function is called, that thread is probably the game thread.
I know for sure that the AddCoin
function is called each time a coin is obtained in the EndlessRunner game.
Based on this, let's rewrite the script.
const base = Module.findBaseAddress('libUE4.so');
const addCoin = base.add(0x69a4450);
let targetThread = null;
Interceptor.attach(addCoin, {
onEnter: function(args) {
this.instance = args[0];
console.log(`\n[*] AddCoin() is called, class instance is ${args[0]}`);
targetThread = Process.enumerateThreads().filter(t => t.id === Process.getCurrentThreadId())[0];
console.log(`\n[*] target thread found: ${targetThread.id} ${targetThread.name}`);
},
onLeave: function(ret) {
console.log(`[*] TotalCoins are stored at class instance + 0x310`);
console.log(hexdump(ptr(this.instance).add(0x310), {length: 16}));
}
})
let unsetWatchPoint = false;
let _addr, _size, _conditions;
let threads = null;
function installWatchpoint(addr, size, conditions) {
if (targetThread === null) {
console.log(`\n[!] Need to find a target thread first`);
return;
}
_addr = addr;
_size = size;
_conditions = conditions;
threads = [];
threads.push(targetThread);
for (const thread of threads) {
Process.setExceptionHandler(e => {
console.log(`\n[!] ${e.context.pc} tried to "${_conditions}" at ${_addr}`);
if (['breakpoint', 'single-step'].includes(e.type)) {
thread.unsetHardwareWatchpoint(0);
unsetWatchPoint = true;
return true;
}
return false;
});
thread.setHardwareWatchpoint(0, addr, size, conditions);
console.log(`[*] HardwareWatchpoint set at ${addr} (${thread.id} ${thread.name})`);
}
}
function reInstallWatchPoint() {
for (const thread of threads) {
thread.setHardwareWatchpoint(0, _addr, _size, _conditions);
}
}
var int = setInterval(() => {
if (unsetWatchPoint) {
reInstallWatchPoint();
unsetWatchPoint = false;
}
}, 0);
Here are the results:
But what if you don’t know which game function is being called at all?
In that case, you need to find a commonly called game function within the game.
In Unreal Engine games, a function called operator==(FNameEntryId, EName)
is called repeatedly within the game.
This function is used to find the GName
object. If you're curious, you can refer to frida-ue4dump wiki.
Here’s the script for that case:
let targetThread = null;
const _Zeq12FNameEntryId5EName = Module.findExportByName('libUE4.so', "_Zeq12FNameEntryId5EName");
Interceptor.attach(_Zeq12FNameEntryId5EName, {
onEnter: function(args) {
targetThread = Process.enumerateThreads().filter(t => t.id === Process.getCurrentThreadId())[0];
console.log(`\n[*] target thread found: ${targetThread.id} ${targetThread.name}`);
Interceptor.detachAll();
},
})
let unsetWatchPoint = false;
let _addr, _size, _conditions;
let threads = null;
function installWatchpoint(addr, size, conditions) {
if (targetThread === null) {
console.log(`\n[!] Need to find a target thread first`);
return;
}
_addr = addr;
_size = size;
_conditions = conditions;
threads = [];
threads.push(targetThread);
for (const thread of threads) {
Process.setExceptionHandler(e => {
console.log(`\n[!] ${e.context.pc} tried to "${_conditions}" at ${_addr}`);
if (['breakpoint', 'single-step'].includes(e.type)) {
thread.unsetHardwareWatchpoint(0);
unsetWatchPoint = true;
return true;
}
return false;
});
thread.setHardwareWatchpoint(0, addr, size, conditions);
console.log(`[*] HardwareWatchpoint set at ${addr} (${thread.id} ${thread.name})`);
}
}
function reInstallWatchPoint() {
for (const thread of threads) {
thread.setHardwareWatchpoint(0, _addr, _size, _conditions);
}
}
var int = setInterval(() => {
if (unsetWatchPoint) {
reInstallWatchPoint();
unsetWatchPoint = false;
}
}, 0);
Are you sure you really cant set the watchpoint on all threads
The tutorials above were written to find the correct thread for setting the watchpoint, as setting a watchpoint on all threads was thought to cause the game to freeze or crash due to overload.
However, could it be that the script for setting the watchpoint on all threads was poorly written, causing the game to freeze or crash?
Let's take a closer look at that script.
function installWatchpoint(addr, size, conditions) {
_addr = addr;
_size = size;
_conditions = conditions;
threads = Process.enumerateThreads();
for (const thread of threads) {
Process.setExceptionHandler(e => {
console.log(`\n[!] ${e.context.pc} tried to "${_conditions}" at ${_addr} (${thread.id} ${thread.name})`);
if (['breakpoint', 'single-step'].includes(e.type)) {
thread.unsetHardwareWatchpoint(0);
unsetWatchPoint = true;
return true;
}
return false;
});
thread.setHardwareWatchpoint(0, addr, size, conditions);
console.log(`[*] HardwareWatchpoint set at ${addr} (${thread.id} ${thread.name})`);
}
}
Oh no... putting Process.setExceptionHandler
inside the for loop...
The thread where the breakpoint exception occurred is not being properly unset.
After modifying the script as follows and running the game, it turned out that setting the watchpoint on all threads did not cause the game to freeze or crash.
function installWatchpoint(addr, size, conditions) {
_addr = addr;
_size = size;
_conditions = conditions;
threads = Process.enumerateThreads();
Process.setExceptionHandler(e => {
if (['breakpoint', 'single-step'].includes(e.type)) {
console.log(`\n[!] ${e.context.pc} tried to "${_conditions}" at ${_addr}`);
for (const thread of threads) {
if (thread.id === Process.getCurrentThreadId()) {
thread.unsetHardwareWatchpoint(0);
unsetWatchPoint = true;
return true;
}
}
}
return false;
});
for (const thread of threads) {
try {
thread.setHardwareWatchpoint(0, addr, size, conditions);
console.log(`[*] HardwareWatchpoint set at ${addr} (${thread.id} ${thread.name})`);
} catch (error) {}
}
}
Try attaching the script to the game and testing it.
frida -UF -l script_set_watchpoint_all_threads.js
Contact
- Channel: https://t.me/hackcatml1
- Chat: https://t.me/hackcatmlchat