Merge "Document using libmemunreachable on an app"

am: 60fab88ecc

Change-Id: Ie19a3980fc0f75150af75a713d96b74c0e9d5dd1
This commit is contained in:
Colin Cross 2018-05-17 19:33:40 -07:00 committed by android-build-merger
commit fe7aa8f7b1
1 changed files with 21 additions and 0 deletions

View File

@ -12,6 +12,27 @@ In the default (zero-overhead) mode, the returned data on leaks is limited to th
Usage
-------
### In Android apps ###
libmemunreachble is loaded by zygote and can be triggered with `dumpsys -t 600 meminfo --unreachable [process]`.
To enable malloc\_debug backtraces on allocations for a single app process on a userdebug device, use:
```
adb root
adb shell setprop libc.debug.malloc.program app_process
adb shell setprop wrap.[process] "\$\@"
adb shell setprop libc.debug.malloc.options backtrace=4
```
Kill and restart the app, trigger the leak, and then run `dumpsys -t 600 meminfo --unreachable [process]`.
To disable malloc\_debug:
```
adb shell setprop libc.debug.malloc.options "''"
adb shell setprop libc.debug.malloc.program "''"
adb shell setprop wrap.[process] "''"
```
### C interface ###
#### `bool LogUnreachableMemory(bool log_contents, size_t limit)` ####