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.
Ativar fuzzers em dispositivos AAOS
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um teste de fuzz é amplamente adotado por desenvolvedores C++ para encontrar bugs relacionados à segurança.
Esta página descreve as categorias de fuzzers do AAOS (Android Automotive OS) e
como executá-las em dispositivos de destino específicos do AAOS.
Fuzzers do AAOS
Crie fuzzers em destinos do AAOS da mesma forma que você faria em uma plataforma
Android. Consulte as instruções de criação e configuração de fuzzing na página Fuzzing com
libFuzzer
.
No entanto, o caminho de execução do alvo de fuzz no AAOS é diferente do caminho em
dispositivos de smartphone Android. Portanto, é necessário executar fuzzers específicos em dispositivos
AAOS para garantir que não haja problemas de segurança.
Os fuzzers específicos do AAOS são divididos nas seguintes categorias:
Consulte a tabela a seguir para conferir uma lista de fuzzers específicos do AAOS:
Fuzzers de EVS |
Fuzzers do Computepipe |
Outros fuzzers |
evs_halcamera_fuzzer |
computepipe _semantic_manager_fuzzer |
sbcdecoder_fuzzer |
evs_virtual_camera_fuzzer |
computepipe _pixel_mem_handle_fuzzer |
|
evs_haldisplay_fuzzer |
computepipe _pixel_stream_manager_fuzzer |
|
evs_enumerator_fuzzer |
grpc_graph_fuzzer |
|
|
local _prebuild_graph_fuzzer |
|
Compilar um fuzzer do AAOS
Recomendamos o uso de um dispositivo HWASan para executar
fuzzers. No entanto, quando não estiver usando um dispositivo HWASAN, siga estas etapas para compilar
e atualizar uma imagem HWASAN localmente:
Execute os comandos abaixo para compilar o build hwasan
e fazer o flash do build
no sistema do carro.
source build/envsetup.sh
lunch <car target>
SANITIZE_TARGET=hwaddress m
fastboot flashall # this will automatically flash the local built image to device
Compilar o fuzzer para o gerenciador de EVS:
mmma packages/services/Car/cpp/evs/manager/1.1/test/fuzzer/
Executar um fuzzer do AAOS
Depois de configurar, siga estas etapas para executar um fuzzer:
Execute os comandos abaixo para preparar a sincronização de fuzzers com o sistema AAOS:
adb root;
adb remount;
adb reboot;
adb root;
adb remount
Se você não tiver uma pasta chamada /data/fuzzer no dispositivo, crie uma.
Acesse o local em que você fez o download e descompactou o build e, a partir daí, execute o
comando abaixo para enviar o fuzzer ao dispositivo.
adb sync data
Para enviar o teste no dispositivo, execute o seguinte:
adb push testcase /data/fuzzer/testcase
Execute o fuzzer com o seguinte comando:
adb shell /data/fuzzer/evs_fuzzer /data/fuzzer/testcase
Verifique a saída.
Uma execução bem-sucedida gera uma saída semelhante ao exemplo a seguir:
INFO: Seed: 1902496153
INFO: Loaded 4 modules (31463 inline 8-bit counters): 15646 [0x7afd3ddb80, 0x7afd3e189e), 15784 [0x7afd7fbbf0, 0x7afd7ff998), 27 [0x7afd618328, 0x7afd618343), 6 [0x63e95aece8, 0x63e95aecee),
INFO: Loaded 4 PC tables (31463 PCs): 15646 [0x7afd3e18a0,0x7afd41ea80), 15784 [0x7afd7ff998,0x7afd83d418), 27 [0x7afd618348,0x7afd6184f8), 6 [0x63e95aecf0,0x63e95aed50),
INFO: 0 files found in /data/fuzz/bot/inputs/fuzzer-testcases-disk/temp-671/new
INFO: 54 files found in /data/fuzz/bot/inputs/data-bundles/android_auto_libcrypto_utils_fuzzer
INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 1048576 bytes
INFO: seed corpus: files: 54 min: 1b max: 4194301b total: 6336542b rss: 28Mb
#55 INITED cov: 71 ft: 94 corp: 6/1032Kb exec/s: 0 rss: 33Mb
#79 REDUCE cov: 71 ft: 94 corp: 6/1019Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 1036131/1036131 MS: 4 CMP-ChangeASCIIInt-CopyPart-EraseBytes- DE: "\x00\x00\x00\x00"-
#83 REDUCE cov: 71 ft: 94 corp: 6/686Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 694616/694616 MS: 4 ChangeASCIIInt-ChangeASCIIInt-ChangeBinInt-CrossOver-
#104 REDUCE cov: 71 ft: 94 corp: 6/591Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 597426/597426 MS: 1 EraseBytes-
#192 REDUCE cov: 71 ft: 94 corp: 6/499Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 503742/503742 MS: 3 PersAutoDict-ChangeByte-EraseBytes- DE: "\x00\x00\x00\x00"-
#219 REDUCE cov: 71 ft: 94 corp: 6/292Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 290962/290962 MS: 2 CopyPart-EraseBytes-
#241 REDUCE cov: 71 ft: 94 corp: 6/226Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 223787/223787 MS: 2 CopyPart-EraseBytes-
#269 REDUCE cov: 71 ft: 94 corp: 6/152Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 148467/148467 MS: 3 InsertRepeatedBytes-PersAutoDict-EraseBytes- DE: "\x00\x00\x00\x00"-
#300 REDUCE cov: 71 ft: 94 corp: 6/83Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 77320/77320 MS: 1 EraseBytes-
#393 REDUCE cov: 71 ft: 94 cor`p: 6/80Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 73802/73802 MS: 3 InsertRepeatedBytes-P
Uma falha ou uma execução com falha gera uma saída semelhante ao exemplo
a seguir:
HWAddressSanitizer: tag-mismatch on address 0x0075e8a643d0 at pc
0x0075e8a5d988 WRITE of size 8 at 0x0075e8a643d0 tags: 5c/00 (ptr/mem) in
thread T0 #0 0x75e8a5d984 (/system/lib64/libnetd_client.so+0x3984) #1
0x75da484788 (/data/fuzzer/lib/libc.so+0x49788) #2 0x75da52dae8
……
00000075e8a5d988 SUMMARY: HWAddressSanitizer: tag-mismatch
(/system/lib64/libnetd_client.so+0x3984)
Consulte o site do CVE para informações sobre as vulnerabilidades de segurança
detectadas.
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-06-26 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-06-26 UTC."],[],[],null,["# Enable fuzzers on AAOS devices\n\nA fuzz test is widely adopted by C++ developers to find security-related bugs.\nThis page describes the categories of AAOS (Android Automotive OS) fuzzers and\nhow to run them on AAOS-specific target devices.\n\nExisting AAOS fuzzers\n---------------------\n\nCreate fuzzers on AAOS targets the same way that you would on an Android\nPlatform. See fuzzing setup and build instructions on the [Fuzzing with\n`libFuzzer`](/docs/security/test/libfuzzer) page.\n\nHowever, the execution path of the fuzz target on AAOS is different from that on\nAndroid phone devices. Hence, it is necessary to run specific fuzzers on AAOS\ndevices to ensure that there are no security issues.\n\nAAOS specific fuzzers are divided into the following categories:\n\n- External View System (EVS) fuzzers: to fuzz the external camera management\n system. See [sample code for EVS\n fuzzers](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/services/Car/cpp/evs/manager/1.1/test/fuzzer/)\n for more details.\n\n- Computepipe fuzzers: to fuzz machine learning computepipe systems. See\n [sample code for Computepipe fuzzers](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/services/Car/cpp/computepipe/tests/fuzz/)\n for more details.\n\n- Other fuzzers: to fuzz AAOS libraries. See [sample code for the sbcdecoder\n fuzzer](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/system/embdrv/sbc/decoder/sbcdecoder_fuzzer.c?q=sbcdecoder_fuzzer.c)\n for more details.\n\nSee the following table for a list of AAOS specific fuzzers:\n\n| EVS fuzzers | Computepipe fuzzers | Other fuzzers |\n|-----------------------------|--------------------------------------------|---------------------|\n| `evs_halcamera_fuzzer` | `computepipe _semantic_manager_fuzzer` | `sbcdecoder_fuzzer` |\n| `evs_virtual_camera_fuzzer` | `computepipe _pixel_mem_handle_fuzzer` | |\n| `evs_haldisplay_fuzzer` | `computepipe _pixel_stream_manager_fuzzer` | |\n| `evs_enumerator_fuzzer` | `grpc_graph_fuzzer` | |\n| | `local _prebuild_graph_fuzzer` | |\n\nCompile an AAOS fuzzer\n----------------------\n\nWe recommend using a [HWASAN](/docs/security/test/hwasan) device for running\nfuzzers. However, when not using a HWASAN device, follow these steps to compile\nand flash a HWASAN image locally:\n\n1. Run the following commands to compile the `hwasan` build and flash the build\n to the car system.\n\n source build/envsetup.sh\n lunch \u003ccar target\u003e\n SANITIZE_TARGET=hwaddress m\n fastboot flashall # this will automatically flash the local built image to device\n\n2. Compile the fuzzer for EVS manager:\n\n mmma packages/services/Car/cpp/evs/manager/1.1/test/fuzzer/\n\nRun an AAOS fuzzer\n------------------\n\nOnce configured, follow these steps to run a fuzzer:\n\n1. Run the following commands to prepare syncing fuzzers to the AAOS system:\n\n adb root;\n adb remount;\n adb reboot;\n adb root;\n adb remount\n\n2. If you don't have a folder named /data/fuzzer on your device, create one.\n\n3. Go to where you downloaded and unzipped the build, and from there, run the\n following command to push the fuzzer on the device.\n\n adb sync data\n\n4. To push the testcase on the device, run the following:\n\n adb push testcase /data/fuzzer/testcase\n\n5. Run the fuzzer with the following command:\n\n adb shell /data/fuzzer/evs_fuzzer /data/fuzzer/testcase\n\n6. Verify the output.\n\n A successful run generates output similar to the following example: \n\n INFO: Seed: 1902496153\n INFO: Loaded 4 modules (31463 inline 8-bit counters): 15646 [0x7afd3ddb80, 0x7afd3e189e), 15784 [0x7afd7fbbf0, 0x7afd7ff998), 27 [0x7afd618328, 0x7afd618343), 6 [0x63e95aece8, 0x63e95aecee),\n INFO: Loaded 4 PC tables (31463 PCs): 15646 [0x7afd3e18a0,0x7afd41ea80), 15784 [0x7afd7ff998,0x7afd83d418), 27 [0x7afd618348,0x7afd6184f8), 6 [0x63e95aecf0,0x63e95aed50),\n INFO: 0 files found in /data/fuzz/bot/inputs/fuzzer-testcases-disk/temp-671/new\n INFO: 54 files found in /data/fuzz/bot/inputs/data-bundles/android_auto_libcrypto_utils_fuzzer\n INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 1048576 bytes\n INFO: seed corpus: files: 54 min: 1b max: 4194301b total: 6336542b rss: 28Mb\n #55 INITED cov: 71 ft: 94 corp: 6/1032Kb exec/s: 0 rss: 33Mb\n #79 REDUCE cov: 71 ft: 94 corp: 6/1019Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 1036131/1036131 MS: 4 CMP-ChangeASCIIInt-CopyPart-EraseBytes- DE: \"\\x00\\x00\\x00\\x00\"-\n #83 REDUCE cov: 71 ft: 94 corp: 6/686Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 694616/694616 MS: 4 ChangeASCIIInt-ChangeASCIIInt-ChangeBinInt-CrossOver-\n #104 REDUCE cov: 71 ft: 94 corp: 6/591Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 597426/597426 MS: 1 EraseBytes-\n #192 REDUCE cov: 71 ft: 94 corp: 6/499Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 503742/503742 MS: 3 PersAutoDict-ChangeByte-EraseBytes- DE: \"\\x00\\x00\\x00\\x00\"-\n #219 REDUCE cov: 71 ft: 94 corp: 6/292Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 290962/290962 MS: 2 CopyPart-EraseBytes-\n #241 REDUCE cov: 71 ft: 94 corp: 6/226Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 223787/223787 MS: 2 CopyPart-EraseBytes-\n #269 REDUCE cov: 71 ft: 94 corp: 6/152Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 148467/148467 MS: 3 InsertRepeatedBytes-PersAutoDict-EraseBytes- DE: \"\\x00\\x00\\x00\\x00\"-\n #300 REDUCE cov: 71 ft: 94 corp: 6/83Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 77320/77320 MS: 1 EraseBytes-\n #393 REDUCE cov: 71 ft: 94 cor`p: 6/80Kb lim: 1048576 exec/s: 0 rss: 33Mb L: 73802/73802 MS: 3 InsertRepeatedBytes-P\n\n A crash or a failed run generates an output similar to the following\n example: \n\n HWAddressSanitizer: tag-mismatch on address 0x0075e8a643d0 at pc\n 0x0075e8a5d988 WRITE of size 8 at 0x0075e8a643d0 tags: 5c/00 (ptr/mem) in\n thread T0 #0 0x75e8a5d984 (/system/lib64/libnetd_client.so+0x3984) #1\n 0x75da484788 (/data/fuzzer/lib/libc.so+0x49788) #2 0x75da52dae8\n ......\n 00000075e8a5d988 SUMMARY: HWAddressSanitizer: tag-mismatch\n (/system/lib64/libnetd_client.so+0x3984)\n\nSee the [CVE](https://cve.mitre.org/) site for information on detected security\nvulnerabilities."]]