Communitygithub.com

SamuelChien/mega-skills-collection

AddressSanitizer détecte les erreurs mémoire lors du fuzzing. Utilisez-le lors du fuzzing de code C/C++ pour trouver les dépassements de tampon et les erreurs use-after-free.

Qu'est-ce que mega-skills-collection ?

AddressSanitizer (ASan) est un outil de détection d'erreurs mémoire largement adopté, utilisé intensivement lors des tests logiciels, en particulier le fuzzing. Il aide à identifier les bugs de corruption mémoire qui pourraient autrement passer inaperçus, tels que les dépassements de tampon, les erreurs use-after-free, les doubles libérations et les fuites mémoire. ASan instrumente le code au moment de la compilation pour suivre les allocations et accès mémoire, détectant les opérations illégales à l'exécution avec un ralentissement d'environ 2 à 4 fois. Il est compatible avec les principaux plateformes de fuzzing comme libFuzzer, AFL++, cargo-fuzz (Rust) et honggfuzz, et peut être combiné avec d'autres sanitizers comme UndefinedBehaviorSanitizer pour une détection complète des bugs. Bien que très efficace pour le fuzzing et les tests en C/C++ et code Rust non sécurisé, ASan ne doit pas être utilisé en production car il peut réduire la sécurité et a une prise en charge limitée sur Windows et macOS.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/address-sanitizer

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

AddressSanitizer (ASan)

AddressSanitizer (ASan) est un outil de détection d'erreurs mémoire largement adopté, utilisé intensivement lors des tests logiciels, en particulier le fuzzing. Il permet de détecter des bugs de corruption mémoire qui pourraient autrement passer inaperçus, tels que les dépassements de tampon, les erreurs use-after-free et autres violations de sécurité mémoire.

Aperçu

ASan est une pratique standard en fuzzing en raison de son efficacité à identifier les vulnérabilités mémoire. Il instrumente le code au moment de la compilation pour suivre les allocations et accès mémoire, détectant les opérations illégales à l'exécution.

Concepts clés

ConceptDescription
InstrumentationASan ajoute des vérifications à l'exécution sur les opérations mémoire pendant la compilation
Mémoire fantôme (Shadow Memory)Mappe 20 To de mémoire virtuelle pour suivre l'état des allocations
Coût en performancesRalentissement d'environ 2 à 4 fois par rapport au code non instrumenté
Périmètre de détectionTrouve les dépassements de tampon, use-after-free, double libération et fuites mémoire

Quand appliquer

Appliquez cette technique lorsque :

  • Vous fuzzez du code C/C++ à la recherche de vulnérabilités de sécurité mémoire
  • Vous testez du code Rust avec des blocs unsafe
  • Vous déboguez des plantages liés à une corruption mémoire
  • Vous exécutez des tests unitaires où des erreurs mémoire sont suspectées

Ignorez cette technique lorsque :

  • Vous exécutez du code en production (ASan peut réduire la sécurité)
  • La plateforme est Windows ou macOS (prise en charge limitée d'ASan)
  • Le surcoût en performance est inacceptable pour votre cas d'utilisation
  • Vous fuzzez des langages purs et sécurisés sans FFI (par exemple, Go pur, Java pur)

Référence rapide

TâcheCommande/Modèle
Activer ASan (Clang/GCC)-fsanitize=address
Activer la verbositéASAN_OPTIONS=verbosity=1
Désactiver la détection de fuitesASAN_OPTIONS=detect_leaks=0
Forcer l'abandon sur erreurASAN_OPTIONS=abort_on_error=1
Options multiplesASAN_OPTIONS=verbosity=1:abort_on_error=1

Guide pas à pas

Étape 1 : Compiler avec ASan

Compilez et liez votre code avec l'option -fsanitize=address :

clang -fsanitize=address -g -o mon_programme mon_programme.c

L'option -g est recommandée pour obtenir de meilleures traces de pile lorsqu'ASan détecte des erreurs.

Étape 2 : Configurer les options ASan

Définissez la variable d'environnement ASAN_OPTIONS pour configurer le comportement d'ASan :

export ASAN_OPTIONS=verbosity=1:abort_on_error=1:detect_leaks=0

Étape 3 : Exécuter votre programme

Exécutez le binaire instrumenté par ASan. Lorsque des erreurs mémoire sont détectées, ASan imprime des rapports détaillés :

./mon_programme

Étape 4 : Ajuster les limites mémoire du fuzzer

ASan nécessite environ 20 To de mémoire virtuelle. Désactivez les restrictions mémoire du fuzzer :

  • libFuzzer : -rss_limit_mb=0
  • AFL++ : -m none

Modèles courants

Modèle : Intégration ASan de base

Cas d'utilisation : Configuration standard de fuzzing avec ASan

Avant :

clang -o cible_fuzz cible_fuzz.c
./cible_fuzz

Après :

clang -fsanitize=address -g -o cible_fuzz cible_fuzz.c
ASAN_OPTIONS=verbosity=1:abort_on_error=1 ./cible_fuzz

Modèle : ASan avec tests unitaires

Cas d'utilisation : Activer ASan pour une suite de tests unitaires

Avant :

gcc -o suite_tests suite_tests.c -lcheck
./suite_tests

Après :

gcc -fsanitize=address -g -o suite_tests suite_tests.c -lcheck
ASAN_OPTIONS=detect_leaks=1 ./suite_tests

Utilisation avancée

Astuces

AstucePourquoi cela aide
Utiliser l'option -gFournit des traces de pile détaillées pour le débogage
Définir verbosity=1Confirme qu'ASan est activé avant le démarrage du programme
Désactiver les fuites pendant le fuzzingLa détection de fuites ne provoque pas de plantages immédiats et encombre la sortie
Activer abort_on_error=1Certains fuzzers nécessitent abort() au lieu de _exit()

Comprendre les rapports ASan

Lorsqu'ASan détecte une erreur mémoire, il imprime un rapport détaillé comprenant :

  • Type d'erreur : Dépassement de tampon, use-after-free, etc.
  • Trace de pile : Où l'erreur s'est produite
  • Traces d'allocation/libération : Où la mémoire a été allouée/libérée
  • Carte mémoire : État de la mémoire fantôme autour de l'erreur

Exemple de rapport ASan :

==12345==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x60300000eff4 at pc 0x00000048e6a3
READ of size 4 at 0x60300000eff4 thread T0
    #0 0x48e6a2 in main /path/to/file.c:42

Combiner les sanitizers

ASan peut être combiné avec d'autres sanitizers pour une détection complète :

clang -fsanitize=address,undefined -g -o cible_fuzz cible_fuzz.c

Considérations spécifiques à la plateforme

Linux : Prise en charge complète d'ASan avec les meilleures performances macOS : Prise en charge limitée, certaines fonctionnalités peuvent ne pas fonctionner Windows : Prise en charge expérimentale, déconseillée pour le fuzzing en production

Anti-patrons

Anti-patronProblèmeApproche correcte
Utiliser ASan en productionPeut rendre les applications moins sécuriséesUtiliser ASan uniquement pour les tests
Ne pas désactiver les limites mémoireLe fuzzer peut tuer le processus à cause des 20 To de mémoire virtuelleDéfinir -rss_limit_mb=0 ou -m none
Ignorer les rapports de fuitesLes fuites mémoire indiquent des problèmes de gestion des ressourcesExaminer les rapports de fuites à la fin de la campagne de fuzzing

Conseils spécifiques aux outils

libFuzzer

Compilez avec le fuzzer et le sanitizer d'adresse :

clang++ -fsanitize=fuzzer,address -g harness.cc -o fuzz

Exécutez avec RSS illimité :

./fuzz -rss_limit_mb=0

Conseils d'intégration :

  • Combinez toujours -fsanitize=fuzzer avec -fsanitize=address
  • Utilisez -g pour des traces de pile détaillées dans les rapports de plantage
  • Envisagez ASAN_OPTIONS=abort_on_error=1 pour une meilleure gestion des plantages

Voir : libFuzzer : AddressSanitizer

AFL++

Utilisez la variable d'environnement AFL_USE_ASAN :

AFL_USE_ASAN=1 afl-clang-fast++ -g harness.cc -o fuzz

Exécutez avec mémoire illimitée :

afl-fuzz -m none -i dossier_entree -o dossier_sortie ./fuzz

Conseils d'intégration :

  • AFL_USE_ASAN=1 ajoute automatiquement les bons indicateurs de compilation
  • Utilisez -m none pour désactiver la limite mémoire d'AFL++
  • Envisagez AFL_MAP_SIZE pour les programmes avec de grandes cartes de couverture

Voir : AFL++ : AddressSanitizer

cargo-fuzz (Rust)

Utilisez l'option --sanitizer=address :

cargo fuzz run cible_fuzz --sanitizer=address

Ou configurez dans fuzz/Cargo.toml :

[profile.release]
opt-level = 3
debug = true

Conseils d'intégration :

  • ASan est utile pour fuzzer du code Rust non sécurisé ou des interfaces FFI
  • Le code Rust sécurisé peut ne pas en bénéficier autant (le compilateur empêche déjà de nombreuses erreurs)
  • Concentrez-vous sur les blocs unsafe, les pointeurs bruts et les liaisons de bibliothèques C

Voir : cargo-fuzz : AddressSanitizer

honggfuzz

Compilez avec ASan et liez avec honggfuzz :

honggfuzz -i dossier_entree -o dossier_sortie -- ./cible_fuzz_asan

Compilez la cible :

hfuzz-clang -fsanitize=address -g cible.c -o cible_fuzz_asan

Conseils d'intégration :

  • honggfuzz fonctionne bien avec ASan par défaut
  • Utilisez le mode piloté par rétroaction pour une meilleure couverture avec les sanitizers
  • Surveillez l'utilisation mémoire, car ASan augmente l'empreinte mémoire

Dépannage

ProblèmeCauseSolution
Le fuzzer tue le processus immédiatementLimite mémoire trop basse pour les 20 To de mémoire virtuelle d'ASanUtilisez -rss_limit_mb=0 (libFuzzer) ou -m none (AFL++)
"ASan runtime not initialized"Ordre de liaison incorrect ou runtime manquantAssurez-vous que -fsanitize=address est utilisé à la fois en compilation et en liaison
Les rapports de fuites encombrent la sortieLeakSanitizer activé par défautDéfinissez ASAN_OPTIONS=detect_leaks=0
Mauvaise performance (>4x de ralentissement)Mode débogage ou build non optimiséCompilez avec -O2 ou -O3 en plus de -fsanitize=address
ASan ne détecte pas les bugs évidentsBinaire non instrumentéVérifiez avec ASAN_OPTIONS=verbosity=1 qu'ASan imprime les informations de démarrage
Faux positifsConflits d'intercepteursConsultez la FAQ ASan pour les problèmes connus avec des bibliothèques spécifiques

Compétences associées

Outils utilisant cette technique

CompétenceComment cela s'applique
libfuzzerCompilez avec -fsanitize=fuzzer,address pour un fuzzing intégré avec détection d'erreurs mémoire
aflppUtilisez la variable d'environnement AFL_USE_ASAN=1 lors de la compilation
cargo-fuzzUtilisez l'option --sanitizer=address pour activer ASan pour les cibles de fuzzing Rust
honggfuzzCompilez la cible avec -fsanitize=address pour un fuzzing instrumenté par ASan

Techniques associées

CompétenceRelation
undefined-behavior-sanitizerSouvent utilisé ensemble avec ASan pour une détection complète des bugs (comportement indéfini + erreurs mémoire)
fuzz-harness-writingLes harnais doivent être conçus pour gérer les plantages détectés par ASan et éviter les faux positifs
coverage-analysisLe fuzzing guidé par la couverture aide à déclencher les chemins de code où ASan peut détecter des erreurs mémoire

Ressources

Ressources externes clés

AddressSanitizer sur Google Sanitizers Wiki

La documentation officielle d'ASan couvre :

  • Algorithme et détails d'implémentation
  • Liste complète des types d'erreurs détectés
  • Caractéristiques de performance et surcharge
  • Comportement spécifique à la plateforme
  • Limitations connues et incompatibilités

SanitizerCommonFlags

Indicateurs de configuration communs partagés par tous les sanitizers :

  • verbosity : Contrôle du niveau de sortie de diagnostic
  • log_path : Redirection de la sortie du sanitizer vers des fichiers
  • symbolize : Activation/désactivation de la résolution des symboles dans les rapports
  • external_symbolizer_path : Utilisation d'un symboliseur personnalisé

AddressSanitizerFlags

Options de configuration spécifiques à ASan :

  • detect_leaks : Contrôle de la détection des fuites mémoire
  • abort_on_error : Appel de abort() vs _exit() sur erreur
  • detect_stack_use_after_return : Détection des bugs use-after-return sur la pile
  • check_initialization_order : Recherche des bugs d'ordre d'initialisation

FAQ AddressSanitizer

Pièges courants et solutions :

  • Problèmes d'ordre de liaison
  • Conflits avec d'autres outils
  • Problèmes spécifiques à la plateforme
  • Conseils d'optimisation des performances

Documentation Clang AddressSanitizer

Conseils spécifiques à Clang :

  • Indicateurs et options de compilation
  • Interaction avec d'autres fonctionnalités de Clang
  • Plateformes et architectures prises en charge

Options d'instrumentation GCC

Documentation ASan spécifique à GCC :

  • Indicateurs et comportement spécifiques à GCC
  • Différences par rapport à l'implémentation Clang
  • Prise en charge des plateformes dans GCC

AddressSanitizer : A Fast Address Sanity Checker (Article USENIX)

Article de recherche original avec des détails techniques :

  • Algorithme de mémoire fantôme
  • Exigences en mémoire virtuelle (historiquement 16 To, maintenant ~20 To)
  • Références de performance
  • Décisions de conception et compromis

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills associés