自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
在 AAOS 设备上启用模糊测试工具
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
C++ 开发者广泛采用模糊测试来查找与安全相关的 bug。本文将介绍 AAOS(Android Automotive OS)模糊测试工具的类别,以及如何在 AAOS 特定的目标设备上运行这些模糊测试工具。
现有 AAOS 模糊测试工具
在 AAOS 目标设备上创建模糊测试工具,创建方式与在 Android 平台上创建模糊测试工具相同。请参阅通过 libFuzzer
进行模糊测试页面上的模糊测试设置和构建说明。
不过,AAOS 上的模糊测试目标执行路径与 Android 手机设备上的执行路径不同。 因此,有必要在 AAOS 设备上运行专用模糊测试工具来确保没有安全问题。
AAOS 专用模糊测试工具分为以下几个类别:
如需查看 AAOS 专用模糊测试工具的列表,请参阅下表:
EVS 模糊测试工具 |
Computepipe 模糊测试工具 |
其他模糊测试工具 |
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 |
|
编译 AAOS 模糊测试工具
建议使用 HWASAN 设备运行模糊测试工具。不过,如果使用的不是 HWASAN 设备,请按照以下步骤在本地编译和刷写 HWASAN 映像:
运行以下命令以编译 hwasan
build 并将该 build 刷写到车载系统。
source build/envsetup.sh
lunch <car target>
SANITIZE_TARGET=hwaddress m
fastboot flashall # this will automatically flash the local built image to device
为 EVS 管理器编译模糊测试工具:
mmma packages/services/Car/cpp/evs/manager/1.1/test/fuzzer/
运行 AAOS 模糊测试工具
配置完成后,请按照以下步骤运行模糊测试工具:
运行以下命令,准备将模糊测试工具同步到 AAOS 系统:
adb root;
adb remount;
adb reboot;
adb root;
adb remount
如果您的设备上没有名为 /data/fuzzer 的文件夹,请创建一个。
转到您下载并解压缩相关 build 的位置,然后在该位置运行以下命令,以在设备上推送模糊测试工具。
adb sync data
如需在设备上推送测试用例,请运行以下命令:
adb push testcase /data/fuzzer/testcase
使用以下命令运行模糊测试工具:
adb shell /data/fuzzer/evs_fuzzer /data/fuzzer/testcase
验证输出。
运行成功会生成类似于以下示例的输出:
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
崩溃或运行失败会生成类似于以下示例的输出:
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)
如需了解检测到的安全漏洞的相关信息,请参阅 CVE 网站。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-26。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-03-26。"],[],[],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."]]