MH
A memory editor for iOS/macOS with JavaScript support
Requirement
- macOS
- Xcode
- Jailbroken iDevice if you want to try iOS versions
- linenoise for interactive cli tool
- duktape for JavaScript support
- python2 + PyYAML (required by duktape)
- realpath
- cmake
- wget
Build & Run
Prepare
brew install coreutils cmake wget
sudo easy_install install pip
sudo pip install PyYAML$ git clone https://github.com/sskaje/mh.git
$ cd mh
# prepare linenoise
$ git submodule update --init --recursive
# prepare iPhoneOS SDKs
$ bash tools/download_sdks.sh
# Prepare duktape
$ bash tools/duktape_prepare.shBuild
# Build for macOS
$ bash build/build-osx.sh
# Build for ARMv7 iDevices
$ bash build/build-ios-armv7.sh
# Build for ARMv7s iDevices
$ bash build/build-ios-armv7s.sh
# Build for ARM64 iDevices, iOS 10.2
$ bash build/build-ios-armv64.sh
# Build for deb package for all iOS device
$ bash build/build-ios-deb.sh
Run
$ sudo ./mh_cliFor iOS 11.x by Electra, binary must locates /bin/mh_cli
Read more: Run HelloWorld on Jailbroken iOS 11
Documentation
Interactive CLI Command
# mh_cli -h
MH: A Scriptable Memory Editor v0.2.0
Author: sskaje
Command Description
process-list Print process list
open PID Open a task
close Close current task
search-hex HEX Search HEX bytes, like search-hex 1a2b3c4d
update-search-hex HEX Search HEX from previous result
search-string STR Search string, like search-string hello
update-search-string STR Search string from previous result
memory-read ADDRESS SIZE Read memory data at ADDRESS, both ADDRESS and SIZE are in HEX
memory-write ADDRESS STR Write data to ADDRESS, ADDRESS in HEX, STR in BYTES
memory-write-hex ADDRESS HEX Write hex data to ADDRESS, both ADDRESS and HEXSTR are in HEX
result Print result list, last round by default
script-run path/to/file.js Run script file
dyld Print dyld info
vm-region Print mach_vm_region()
bytes2hex STR Bytes to hex string
hex2bytes HEX Hex string to bytes
float2hex FLOAT Float number to hex
double2hex DOUBLE Double number to hex
int2hex INTEGER Integer to hex
clear Clear screen
help Print this message
Example:
$ mh_cli
MH[nil] > process-list
...
Process count=415
MH[nil] > open 379
Current PID=379
MH[379] > search-string 0ABCDEFGHIJKLMN0
Found 3 result(s).
MH[379] > result
...
update search @address:000000008516f810
[2] 0x0000000085100000-0x0000000085200000 size=0x7ffe00000020 offset=0000000000000000, rw-/rwx, MALLOC_TINY
000000008516f810 30 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 30 0ABCDEFGHIJKLMN0
000000008516f820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
MH[379] > memory-write 000000008516f810 "Hi, MH"
0000000000000000 48 69 2c 20 4d 48 Hi, MH
Write memory: addr=000000008516f810, size=0x6
MH[379] > result
...
[2] 0x0000000085100000-0x0000000085200000 size=0x7ffe00000020 offset=0000000000000000, rw-/rwx, MALLOC_TINY
000000008516f810 48 69 2c 20 4d 48 46 47 48 49 4a 4b 4c 4d 4e 30 Hi, MHFGHIJKLMN0
000000008516f820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 04 00 ................
MH[379] > memory-write-hex 000000008516f818 AFBDEECC3231
0000000000000000 af bd ee cc 32 31 ....21
Write memory: addr=000000008516f818, size=0x6
MH[379] > result
...
[2] 0x0000000085100000-0x0000000085200000 size=0x7ffe00000020 offset=0000000000000000, rw-/rwx, MALLOC_TINY
000000008516f810 48 69 2c 20 4d 48 46 47 af bd ee cc 32 31 4e 30 Hi, MHFG....21N0
000000008516f820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 04 00 ................
Non-interactive Script Host
mh_script path/to/script.js [args [...]]
You can use mh_script for non-interactive scenario.
But a script written for mh_cli cannot be used by mh_script, because they are using different context scopes.
More specifically, you can use MH class from mh_cli, but you can't use #^mh_(search|result|memory)_# functions from mh_script.
Other mach/dyld related methods are not introduced to MH class, only open()/close(), I'm finding a way to get forked pids, so that forked children can be open in script easily.
JavaScript API
See doc/define.js
Example:
Known issues
License
MH is available under the MIT license. See the LICENSE file for more info.
if you're using mh for iOS 11 jailbroken by Electra: