| 1 |
# simpleprofile |
| 2 |
|
| 3 |
simpleprofile is a JVMTI agent that lets one get simple JSON profiles with JVMTI |
| 4 |
|
| 5 |
# Usage |
| 6 |
### Build |
| 7 |
> `m libsimpleprofile` # or 'm libsimpleprofiled' with debugging checks enabled |
| 8 |
|
| 9 |
For binaries with NDK shared libraries only. |
| 10 |
> `m libsimpleprofiled` # or `m libsimpleprofileds` with debugging checks enabled. |
| 11 |
|
| 12 |
The libraries will be built for 32-bit, 64-bit, host and target. Below examples |
| 13 |
assume you want to use the 64-bit version. |
| 14 |
|
| 15 |
### Command Line |
| 16 |
|
| 17 |
The agent is loaded using -agentpath like normal. It takes arguments in the |
| 18 |
following format: |
| 19 |
> `file-output[,dump_on_shutdown][,dump_on_main_stop]` |
| 20 |
|
| 21 |
|
| 22 |
#### ART |
| 23 |
> `art -Xplugin:$ANDROID_HOST_OUT/lib64/libopenjdkjvmti.so '-agentpath:libsimpleprofiled.so=/proc/self/fd/2,dump_on_main_stop' -cp tmp/java/helloworld.dex -Xint helloworld` |
| 24 |
|
| 25 |
* `-Xplugin` and `-agentpath` need to be used, otherwise the agent will fail during init. |
| 26 |
* If using `libartd.so`, make sure to use the debug version of jvmti. |
| 27 |
|
| 28 |
#### Device |
| 29 |
``` |
| 30 |
% adb root |
| 31 |
% adb shell setenforce 0 |
| 32 |
% adb push $OUT/system/lib64/libsimpleprofileds.so /data/local/tmp/libsimpleprofileds.so |
| 33 |
% adb shell |
| 34 |
blueline:/data/data/com.google.android.apps.maps # cp /data/local/tmp/libsimpleprofileds.so . |
| 35 |
blueline:/data/data/com.google.android.apps.maps # ps -A | grep maps |
| 36 |
u0_a178 9143 927 15691440 190132 SyS_epoll_wait 0 S com.google.android.apps.maps |
| 37 |
blueline:/data/data/com.google.android.apps.maps # cmd activity attach-agent com.google.android.apps.maps $PWD/libsimpleprofileds.so=$PWD/maps.json |
| 38 |
blueline:/data/data/com.google.android.apps.maps # # Do things on the app. |
| 39 |
blueline:/data/data/com.google.android.apps.maps # kill -3 9143 |
| 40 |
blueline:/data/data/com.google.android.apps.maps # wc -l maps.json |
| 41 |
17901 maps.json |
| 42 |
blueline:/data/data/com.google.android.apps.maps # ^D |
| 43 |
% adb pull /data/data/com.google.android.apps.maps/maps.json |
| 44 |
``` |
| 45 |
|
| 46 |
#### RI |
| 47 |
> `java '-agentpath:libsimpleprofiled.so=/proc/self/fd/2,dump_on_main_stop' -cp tmp/helloworld/classes helloworld` |
| 48 |
|
| 49 |
### Output |
| 50 |
A normal run will look something like this: |
| 51 |
|
| 52 |
% ./test/run-test --64 --host --dev --with-agent $ANDROID_HOST_OUT/lib64/libsimpleprofiled.so=dump_on_main_stop,/proc/self/fd/1 001-HelloWorld |
| 53 |
<normal output removed> |
| 54 |
Hello, world! |
| 55 |
... |
| 56 |
{"class_name":"Ljava/util/HashMap$KeySet;","method_name":"iterator","method_descriptor":"()Ljava/util/Iterator;","count":6}, |
| 57 |
{"class_name":"Ljava/util/HashMap$KeyIterator;","method_name":"<init>","method_descriptor":"(Ljava/util/HashMap;)V","count":6}, |
| 58 |
{"class_name":"Ljava/util/HashMap$HashIterator;","method_name":"<init>","method_descriptor":"(Ljava/util/HashMap;)V","count":6}, |
| 59 |
{"class_name":"Ljava/lang/String;","method_name":"equals","method_descriptor":"(Ljava/lang/Object;)Z","count":128}, |
| 60 |
{"class_name":"Ljava/util/Collections$UnmodifiableCollection$1;","method_name":"next","method_descriptor":"()Ljava/lang/Object;","count":38}, |
| 61 |
{"class_name":"Ljava/util/HashMap$KeyIterator;","method_name":"next","method_descriptor":"()Ljava/lang/Object;","count":38}, |
| 62 |
{"class_name":"Lsun/misc/Cleaner;","method_name":"add","method_descriptor":"(Lsun/misc/Cleaner;)Lsun/misc/Cleaner;","count":1}, |
| 63 |
... |