HWAddress Sanitizer

Remarque : Ce document couvre l'exécution d'applications Android créées avec le NDK sous HWAddress Sanitizer. Pour en savoir plus sur l'utilisation de HWAddress Sanitizer sur les composants de la plate-forme Android, consultez la documentation AOSP.

Le NDK Android est compatible avec HWAddress Sanitizer, également appelé HWASan, à partir du NDK r21 et d'Android 10 (niveau d'API 29). HWASan n'est disponible que sur les appareils Arm 64 bits.

Important : HWAsan est l'un des nombreux outils disponibles pour le débogage et l'atténuation des erreurs de mémoire. Consultez Débogage et atténuation des erreurs de mémoire pour une présentation de tous les outils.

HWASan est un outil de détection des erreurs de mémoire semblable à ASan. Comparé à la version classique d'ASan, HWASan offre les avantages suivants :

• Surcharge processeur similaire (environ 2 fois)
• Surcharge de la taille du code similaire (40–50 %)
• Surcharge RAM beaucoup plus faible (10 à 35 %)

HWASan détecte le même ensemble de bugs qu'ASan :

• Débordement positif/négatif de la pile ou du tampon de tas de mémoire
• Bugs "use-after-free" au niveau des tas de mémoire
• Utilisation de la pile en dehors du champ d'application
• Bugs de type "double free" ou "wild free"

En outre, HWASan détecte également les utilisations suivantes :

• Utilisation de la pile après le retour

Application exemple

Une application exemple indique comment configurer une variante de compilation pour HWASan.

Créer

Important : Veillez à utiliser un NDK à jour pour compiler votre code.

Pour compiler le code natif (JNI) de votre application avec HWAddress Sanitizer, procédez comme suit :

ndk-build

Dans votre fichier 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

CMake

Dans le fichier build.gradle de votre module :

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                # Can also use system or none as ANDROID_STL, but not c++_static.
                arguments "-DANDROID_STL=c++_shared"
            }
        }
    }
}

Pour chaque cible de votre fichier CMakeLists.txt :

target_compile_options(${TARGET} PUBLIC -fsanitize=hwaddress -fno-omit-frame-pointer)
target_link_options(${TARGET} PUBLIC -fsanitize=hwaddress)

Avec NDK 27 ou version ultérieure, vous pouvez également utiliser les éléments suivants dans votre build.gradle sans avoir à modifier le fichier CMakeLists.txt:

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                arguments "-DANDROID_SANITIZE=hwaddress"
            }
        }
    }
}

Cela ne fonctionnera pas lorsque vous utiliserez ANDROID_USE_LEGACY_TOOLCHAIN_FILE=false.

Remarque : Une STL de bibliothèque partagée est requise, car les implémentations des opérateurs new et delete dans cette STL sont généralement créées sans pointeur de frame. HWASan apporte sa propre implémentation, mais elle ne peut pas être utilisée si la STL est associée de manière statique à l'application.

Android 14 ou version ultérieure : ajouter wrap.sh

Si vous utilisez Android 14 ou une version ultérieure, vous pouvez utiliser un script encapsulé pour exécuter votre application débogable sur n'importe quel appareil Android. Vous pouvez ignorer cette étape si vous avez choisi de suivre les étapes indiquées. dans les instructions de configuration.

Lisez les instructions d'empaquetage d'un script wrap.sh afin d'ajouter le script wrap.sh suivant pour arm64-v8a.

#!/system/bin/sh
LD_HWASAN=1 exec "$@"

Exécuter

Si votre version d'Android est antérieure à la version 14 ou si vous n'avez pas ajouté de fichier wrap.sh , suivez les instructions de configuration avant d'exécuter votre application.

Exécutez l'application comme d'habitude. Lorsqu'une erreur de mémoire est détectée, une application plante avec SIGABRT et imprime un message détaillé dans logcat. Une copie du message peut se trouve dans un fichier sous /data/tombstones et se présente comme suit:

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)

Le message peut être suivi d'informations de débogage supplémentaires, telles que la liste des threads en direct dans l'application, les balises d'allocations de mémoire à proximité et les valeurs d'enregistrement du processeur.

Pour en savoir plus sur les messages d'erreur HWASan, consultez Comprendre les rapports HWASan.

Créer des exécutables de ligne de commande

Important :Assurez-vous d'utiliser le NDK le plus récent. Cette opération échouera pour le NDK antérieures à la version r26b.

Vous pouvez créer et exécuter des exécutables instrumentés avec HWASan sur Android 14 et plus récentes. Vous pouvez utiliser la même configuration que celle décrite dans Compiler pour ndk-build ou CMake pour vos exécutables. Transférer les exécutables sur un appareil exécutant Android 14 ou une version ultérieure et l'exécuter normalement à l'aide du shell.

Si vous utilisez libc++, assurez-vous d'utiliser la STL partagée et transférez-la vers l'appareil et définissez LD_LIBRARY_PATH sur le répertoire qui le contient lorsque l'exécution du binaire.

Si vous n'utilisez pas Gradle, consultez la documentation du NDK pour savoir comment effectuer une compilation à partir de la ligne de commande avec CMake, ndk-build.

Android 13 ou version antérieure : configuration

Si votre appareil est équipé d'Android 14 ou version ultérieure, vous pouvez ignorer cette étape et suivre les instructions d'utilisation de wrap.sh dans la section Compiler ci-dessous. Vous pouvez également suivre cette section et ignorer les instructions d'utilisation de wrapper.sh ci-dessous.

Pour les versions antérieures à Android 14, les applications HWASan nécessitent l'exécution d'un build HWASan Android. Vous pouvez flasher des images HWASan prédéfinies sur les appareils Pixel compatibles. Les builds sont disponibles sur ci.android.com, où vous pouvez cliquer sur le carré correspondant au build exact que vous souhaitez afin d'obtenir un lien Flash Build (Flasher un build). Pour cela, vous devez connaître le nom de code de votre téléphone.

Il peut être plus simple d'accéder directement à flash.android.com, car ce flux commence par détecter votre appareil et vous montre uniquement les versions que vous pouvez utiliser. Les images suivantes illustrent le processus de configuration de cet outil.

Activez le mode développeur sur votre appareil et connectez-le à votre ordinateur à l'aide d'un câble USB. Cliquez sur Ajouter un appareil, sélectionnez votre appareil dans la boîte de dialogue, puis cliquez sur Connecter.

Une fois votre appareil connecté, cliquez dessus pour configurer le build. Dans la zone Sélectionner un ID de build, sélectionnez la branche aosp-master-with-phones-throttled pour choisir automatiquement l'image adaptée à l'appareil que vous avez connecté.

Cliquez sur Installer pour flasher l'appareil.

Pour en savoir plus sur la configuration nécessaire, consultez la documentation d'Android Flash Tool. Vous pouvez également consulter la documentation AOSP pour découvrir comment créer une image HWASan à partir de la source.