HWAddress Sanitizer

HWAddress Sanitizer

注意：本文档介绍了如何在 HWAddress Sanitizer 下运行使用 NDK 构建的 Android 应用。如需了解如何对 Android 平台组件使用 HWAddress Sanitizer，请参阅 AOSP 文档。

从 NDK r21 和 Android 10（API 级别 29）开始，Android NDK 支持 HWAddress Sanitizer（也称为 HWASan）。HWASan 仅适用于 64 位 Arm 设备。

HWASan 是一款类似于 ASan 的内存错误检测工具。与传统的 ASan 相比，HWASan 具有如下特征：

• 类似的 CPU 开销（约为 2 倍）
• 类似的代码大小开销 (40 - 50%)
• 更小的 RAM 开销 (10% - 35%)

HWASan 能检测到 ASan 所能检测到的同一系列错误：

• 堆栈和堆缓冲区上溢/下溢
• 释放之后的堆使用情况
• 超出范围的堆栈使用情况
• 重复释放/错误释放

此外，HWASan 还可以检测：

• 返回之后的堆栈使用情况

设置

HWASan 应用需要 Android 的 HWASan build 才能运行。您可以将预构建的 HWASan 映像刷写到支持的 Pixel 手机上。在 ci.android.com 上可以找到这些 build，您可以在其中点击所需的确切 build（方格），以获取 Flash Build 链接。您需要知道您手机的代号。

改为直接访问 flash.android.com 会使操作更简单，因为该流程会首先检测您的设备，且仅显示您可以使用的 build。下面的图片说明了此工具中的设置流程。

在设备上启用开发者模式，然后使用 USB 线将其连接到计算机。点击 Add new device，从对话框中选择您的设备，然后点击 Connect。

您的设备连接后，您需要点击它来配置 build。在 Select a build ID 框中，选择 aosp-master-with-phones-throttled 分支以自动为您连接的设备选择正确的映像。

点击 Install 以刷写您的设备。

如需详细了解必要的设置，请参阅 Android 刷写工具文档。或者，您也可以查看 AOSP 文档，了解如何从源代码构建 HWASan 映像。

构建

要使用 HWAddress Sanitizer 构建应用的原生 (JNI) 代码，请执行以下操作：

ndk-buildCMake

在您的 Application.mk 文件中：

APP_STL := c++_shared # Or system, or none, but not c++_static.
APP_CFLAGS := -fsanitize=hwaddress -fno-omit-frame-pointer
APP_LDFLAGS := -fsanitize=hwaddress

注意：必须提供共享库 STL，因为 STL 中的 new 和 delete 运算符的实现通常是在没有框架指针的情况下构建的。HWASan 可提供自己的实现，但如果 STL 是以静态方式链接到应用，您将无法使用此实现。

运行

在 HWASan 构建的 Android 映像上照常运行应用。当检测到内存错误时，应用将因 SIGABRT 而崩溃，并向 logcat 输出详细消息。您可以在 /data/tombstones 下的文件中找到该消息的副本，内容如下：

ERROR: HWAddressSanitizer: tag-mismatch on address 0x0042a0826510 at pc 0x007b24d90a0c
WRITE of size 1 at 0x0042a0826510 tags: 32/3d (ptr/mem) in thread T0
    #0 0x7b24d90a08  (/data/app/com.example.hellohwasan-eRpO2UhYylZaW0P_E0z7vA==/lib/arm64/libnative-lib.so+0x2a08)
    #1 0x7b8f1e4ccc  (/apex/com.android.art/lib64/libart.so+0x198ccc)
    #2 0x7b8f1db364  (/apex/com.android.art/lib64/libart.so+0x18f364)
    #3 0x7b8f2ad8d4  (/apex/com.android.art/lib64/libart.so+0x2618d4)

0x0042a0826510 is located 0 bytes to the right of 16-byte region [0x0042a0826500,0x0042a0826510)
allocated here:
    #0 0x7b92a322bc  (/apex/com.android.runtime/lib64/bionic/libclang_rt.hwasan-aarch64-android.so+0x212bc)
    #1 0x7b24d909e0  (/data/app/com.example.hellohwasan-eRpO2UhYylZaW0P_E0z7vA==/lib/arm64/libnative-lib.so+0x29e0)
    #2 0x7b8f1e4ccc  (/apex/com.android.art/lib64/libart.so+0x198ccc)

消息后面可能还跟着其他调试信息，例如应用中的活动线程列表、临近内存分配的标记、CPU 寄存器值等。

如需详细了解 HWASan 错误消息，请参阅了解 HWASan 报告。