Informations de référence sur la ligne de commande de l’assembleur ARM

  • Article

Les assembleurs Microsoft ARM, armasm et armasm64 prennent en charge plusieurs options de ligne de commande. Par défaut, armasm assemble le langage d’assembly ARMv7 Thumb dans l’implémentation Microsoft du Common Object File Format (COFF). L’assembleur armasm64 crée du code objet COFF pour les cibles ARM64 et ARM64EC. L’éditeur de liens peut lier des objets de code COFF produits par l’assembleur ARM et le compilateur C/C++. Il peut lier soit avec les bibliothèques d’objets créées par le bibliothécaire.

Syntaxe

armasm[options] source_file object_file
armasm [options] source_file

armasm64[options] source_file object_file
armasm64 [options] source_file

Paramètres

options
Combinaison de zéro ou plusieurs des options suivantes :

  • -16
    Disponible uniquement dans armasm. Assemblez la source sous forme d’instructions de pouce 16 bits. Cette option est celle par défaut.

  • -32
    Disponible uniquement dans armasm. Assemblez la source sous forme d’instructions ARM 32 bits.

  • -coff_thumb2_only
    Disponible uniquement dans armasm. Autorisez uniquement le code Thumb-2.

  • -errorReport:option
    Cette fonction est déconseillée. Dans Windows Vista et versions ultérieures, le rapport d’erreurs est contrôlé par les paramètres de rapport d’erreurs Windows (WER ).

  • -errorsnom_fichier
    -enom_fichier
    Redirigez les messages d’erreur et d’avertissement vers le nom de fichier. Par défaut, ces messages sont envoyés à stdout.

  • -funcOverride:function_name
    Disponible uniquement dans armasm64. Émettre la prise en charge de substitution de fonction pour function_name.

  • -g
    Générez des informations de débogage.

  • -gh:SHA1
    Utilisez l’algorithme de hachage de chiffrement SHA-1 pour générer une somme case activée de chaque fichier source dans les informations de débogage. Substitue -gh:SHA256.

  • -gh:SHA256
    Utilisez l’algorithme de hachage de chiffrement SHA-256 pour générer un case activée sum de chaque fichier source dans les informations de débogage. Cette option est activée par défaut dans Visual Studio 2022 version 17.0 et versions ultérieures.

  • -guard:ehcont[-]
    Générez une liste triée des adresses virtuelles relatives (RVA) de toutes les cibles de continuation de gestion des exceptions valides pour un binaire. Il est utilisé au moment de l’exécution pour NtContinue la validation du pointeur d’instruction.SetThreadContext Par défaut, -guard:ehcont est désactivé et doit être activé explicitement. Pour désactiver explicitement cette option, utilisez -guard:ehcont-. Cette option est disponible dans Visual Studio 2019 version 16.7 et ultérieures. La fonctionnalité est prise en charge pour les processus 64 bits sur un système d’exploitation 64 bits.

  • -help
    -h
    Imprimez le message d’aide de ligne de commande.

  • -idir[;dir]
    Ajoutez un ou plusieurs répertoires spécifiés au chemin d’accès de recherche include. Séparez les répertoires à l’aide d’un point-virgule (;).

  • -ignorewarning_number
    Désactivez le numéro d’avertissement spécifié. Pour connaître les valeurs possibles, consultez les messages de diagnostic de l’assembleur ARM.

  • -listlist_file
    Créez une liste détaillée du langage d’assembly généré pour list_file. Le paramètre list_file est facultatif. S’il est omis .lst , l’assembleur ajoute le nom de base de source_file pour créer le fichier de référencement.

  • -machineMachine
    Spécifiez le type d’ordinateur à définir dans l’en-tête PE. Dans armasm, les valeurs possibles pour l’ordinateur sont les suivantes :

    • ARM : définit le type d’ordinateur sur IMAGE_FILE_MACHINE_ARMNT. Cette option est celle par défaut.
    • THU Mo : définit le type d’ordinateur sur IMAGE_FILE_MACHINE_THUMB.

    Dans armasm64, les valeurs possibles sont les suivantes :

    • ARM64 : définit le type d’ordinateur sur IMAGE_FILE_MACHINE_ARM64. Cette option est celle par défaut.
    • ARM64EC : définit le type d’ordinateur sur IMAGE_FILE_MACHINE_ARM64EC.

  • -noesc
    -noe
    Ignorer les caractères spéciaux de style C, tels que \n ou \t.

  • -nologo
    Supprimez la bannière de copyright.

  • -nowarn
    -now
    Désactivez tous les messages d’avertissement.

  • -oobject_file
    Spécifiez le nom du fichier objet (sortie). L’option -o est facultative . Vous pouvez à la place spécifier un nom de fichier objet comme dernier élément de la ligne de commande.

  • -oldit
    Disponible uniquement dans armasm. Générez des blocs informatiques de style ARMv7. Par défaut, les blocs informatiques compatibles ARMv8 sont générés.

  • -predefineDirective
    -pdDirective
    Spécifiez une directive SETA, SETL ou SET pour prédéfinir un symbole.
    Exemple : armasm.exe -predefine "COUNT SETA 150" source.asm
    Pour plus d’informations, consultez le Guide de référence du compilateur ARM.

  • -sourcelink:sourcelink_filename
    sourcelink_filename spécifie un fichier de configuration au format JSON qui contient un mappage simple des chemins d’accès de fichiers locaux aux URL des fichiers sources à afficher dans le débogueur. Pour plus d’informations sur le format de ce fichier, consultez Schéma JSON du lien source. Source Link est un système indépendant de contrôle de code source et de langage pour fournir le débogage source pour les fichiers binaires. Source Link est pris en charge pour les fichiers binaires natifs à partir de Visual Studio 2017 version 15.8. Pour obtenir une vue d’ensemble du lien source, consultez Lien source. Pour plus d’informations sur l’utilisation du lien source dans vos projets et sur la génération du fichier SourceLink dans le cadre de votre projet, consultez Utilisation du lien source.

  • -vianom_fichier
    Lit les arguments de ligne de commande supplémentaires à partir du nom de fichier.

source_file
Nom du fichier source.

object_file
Le dernier élément de la ligne de commande peut spécifier le nom du fichier objet (sortie). S’il est omis .obj et qu’aucune option n’est -o spécifiée, l’assembleur ajoute le nom de base de source_file pour créer le fichier objet.

Notes

L’exemple suivant montre comment utiliser armasm dans un scénario classique. Tout d’abord, utilisez armasm pour générer un fichier source de langage d’assembly (.asm) dans un fichier objet (.obj). Ensuite, utilisez le compilateur C de ligne de commande CL pour compiler un fichier source (.c) et spécifiez également l’option éditeur de liens pour lier le fichier objet ARM.

armasm -o myasmcode.obj myasmcode.asm 
cl myccode.c /link myasmcode.obj

Voir aussi

Messages de diagnostic arm Assembleur
Directives de l’assembleur ARM