Strace enables you to see the system calls a process makes and what those system calls return. A typical process makes a lot of system calls, so you'll want to review the strace man page to learn how to collect only data you're actually interested in.

Building strace

To build strace, run the following:

mmma -j6 external/strace

Attaching to a running process

The simplest and most common use case for strace is to attach it to a running process, which you can do with:

adb shell strace -f -p PID

The -f flag tells strace to attach to all the threads in the process, plus any new threads spawned later.

Using on an application

To use strace on an application:

  1. Set up a directory for strace logs:
    adb shell setenforce 0
    adb shell mkdir /data/local/tmp/strace
    adb shell chmod 777 /data/local/tmp/strace
    
  2. Choose the process to trace before launching it:
    adb shell setprop wrap.com.google.android.browser "logwrapper strace -f -o /data/local/tmp/strace/strace.com.google.android.browser.txt"
    
  3. Launch the process normally.

Using on the zygote

To use strace on the zygote, fix the relevant init.rc zygote line (requires adb shell setenforce 0):

cd system/core/
patch -p1 <<EOF
--- a/rootdir/init.zygote32.rc
+++ b/rootdir/init.zygote32.rc
@@ -1,4 +1,4 @@
-service zygote /system/bin/app_process -Xzygote /system/bin --zygote --start-system-server
+service zygote /system/xbin/strace -o /data/local/tmp/zygote.strace /system/bin/app_process -Xzygote /system/bin --zygote --start-system-server
     class main
     socket zygote stream 660 root system
     onrestart write /sys/android_power/request_state wake
EOF

Getting strace logs during Android boot

To get strace logs during Android boot, make the following changes: