A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Usar o strace
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O strace permite conferir as chamadas do sistema que um
processo faz e o que elas retornam.
Criar strace
Para criar o strace, execute o seguinte:
mmma -j6 external/strace
Anexar a um processo em execução
O caso de uso mais simples e comum do strace é anexá-lo a um processo
em execução, o que pode ser feito com:
adb shell strace -f -p PID
A flag -f instrui o strace a se conectar a todas as linhas de execução no
processo, além de novas linhas de execução geradas mais tarde.
Um processo típico faz muitas chamadas de sistema. Por isso, é recomendável consultar a
página de manual do strace
para saber como coletar apenas os dados de seu interesse.
Usar em um app
Para usar o strace em um app:
- Configure o dispositivo para executar o strace. É necessário ter acesso root, desativar o SELinux e reiniciar
o ambiente de execução para remover o filtro seccomp, que impede a execução do strace:
adb root
adb shell setenforce 0
adb shell stop
adb shell start
- Configure um diretório gravável globalmente para registros de strace, porque o strace será executado no
UID do app:
adb shell mkdir -m 777 /data/local/tmp/strace
- Escolha o processo a ser rastreado e inicie-o:
adb shell setprop wrap.com.android.calendar '"logwrapper strace -f -o /data/local/tmp/strace/strace.com.android.calendar.txt"'
- Inicie o processo normalmente.
Usar no zigoto
Para usar o strace no zigoto, corrija a linha init.rc relevante
do zigoto (requer 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/bin/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
Receber registros de strace durante a inicialização do Android
Para receber registros de strace durante a inicialização do Android, faça as seguintes mudanças:
- Como o nome do processo muda de
zygote para
strace, o serviço pode não ser iniciado devido à falta de
SELinux file_context para strace. A solução é
adicionar uma nova linha para strace em system/sepolicy/private/file_contexts
e copiar o contexto do arquivo original. Exemplo:
/dev/socket/zygote u:object_r:zygote_socket:s0
+ /system/bin/strace u:object_r:zygote_socket:s0
- Adicione o parâmetro do kernel ou do bootconfig e inicialize o dispositivo no modo permissivo do SELinux. Para fazer isso, adicione
androidboot.selinux=permissive a
BOARD_KERNEL_CMDLINE ou a BOARD_BOOTCONFIG no Android
12 com a versão 5.10 ou mais recente do kernel.
Essa variável se torna somente leitura em build/core/Makefile, mas está sempre
disponível em /device/*/BoardConfig.
Exemplo para o dispositivo Pixel (Sailfish) em
/device/google/marlin/sailfish/BoardConfig.mk:
- BOARD_KERNEL_CMDLINE := .... androidboot.hardware=sailfish ...
+BOARD_KERNEL_CMDLINE := .... androidboot.hardware=sailfish ... androidboot.selinux=permissive
Depois de fazer a mudança, crie e transmita a imagem de inicialização, e o dispositivo será inicializado
no modo permissivo.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Use strace\n\n[Strace](https://strace.io) enables you to see the system calls a\nprocess makes and what those system calls return.\n\nBuild strace\n------------\n\nTo build strace, run the following: \n\n```\nmmma -j6 external/strace\n```\n\nAttach to a running process\n---------------------------\n\nThe simplest and most common use case for strace is to attach it to a running\nprocess, which you can do with: \n\n```\nadb shell strace -f -p PID\n```\n\nThe `-f` flag tells strace to attach to all the threads in the\nprocess, plus any new threads spawned later.\n\nA typical process makes a lot of system calls, so you'll want to review the\n[strace man page](http://man7.org/linux/man-pages/man1/strace.1.html)\nto learn how to collect only data you're actually interested in.\n\nUse on an app\n-------------\n\nTo use strace on an app:\n\n1. Set up the device so that you can run strace. You need to be root, disable SELinux, and restart the runtime to remove the seccomp filter that will otherwise prevent strace from running: \n\n adb root\n adb shell setenforce 0\n adb shell stop\n adb shell start\n\n2. Set up a world-writable directory for strace logs, because strace will be running under the app's uid: \n\n adb shell mkdir -m 777 /data/local/tmp/strace\n\n3. Choose the process to trace and launch it: \n\n ```\n adb shell setprop wrap.com.android.calendar '\"logwrapper strace -f -o /data/local/tmp/strace/strace.com.android.calendar.txt\"'\n ```\n4. Launch the process normally.\n\nUse on the zygote\n-----------------\n\nTo use strace on the zygote, fix the relevant `init.rc` zygote\nline (requires `adb shell setenforce 0`): \n\n cd system/core/\n patch -p1 \u003c\u003cEOF\n --- a/rootdir/init.zygote32.rc\n +++ b/rootdir/init.zygote32.rc\n @@ -1,4 +1,4 @@\n -service zygote /system/bin/app_process -Xzygote /system/bin --zygote --start-system-server\n +service zygote /system/bin/strace -o /data/local/tmp/zygote.strace /system/bin/app_process -Xzygote /system/bin --zygote --start-system-server\n class main\n socket zygote stream 660 root system\n onrestart write /sys/android_power/request_state wake\n EOF\n\nGet strace logs during Android boot\n-----------------------------------\n\nTo get strace logs during Android boot, make the following changes:\n\n- Since the process name changes from `zygote` to `strace`, the given service may fail to start due to the missing SELinux `file_context` for `strace`. The solution is to add a new line for strace in `system/sepolicy/private/file_contexts` and copy the original file context over. Example: \n\n ```\n /dev/socket/zygote u:object_r:zygote_socket:s0\n + /system/bin/strace u:object_r:zygote_socket:s0\n ```\n- Add kernel or bootconfig parameter, then boot the device in SELinux permissive mode. You can do this by adding `androidboot.selinux=permissive`to `BOARD_KERNEL_CMDLINE`, or to `BOARD_BOOTCONFIG` in Android 12 with kernel version 5.10 or greater. (This variable becomes read-only in `build/core/Makefile` but is always available under `/device/*/BoardConfig`.) \n\n Example for the Pixel (sailfish) device in `/device/google/marlin/sailfish/BoardConfig.mk`: \n\n ```\n - BOARD_KERNEL_CMDLINE := .... androidboot.hardware=sailfish ...\n +BOARD_KERNEL_CMDLINE := .... androidboot.hardware=sailfish ... androidboot.selinux=permissive\n ```\n After making the change, build and flash the boot image and the device will boot in permissive mode."]]
