Informations de référence sur la ligne de commande de l’assembleur ARM
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.
armasm
[options] source_file object_file
armasm
[options] source_file
armasm64
[options] source_file object_file
armasm64
[options] source_file
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 ).-errors
filename
-e
filename
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 de contrôle 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 une somme de contrôle 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 pourNtContinue
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.-i
dir[;
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 (;
).-ignore
warning_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.-list
list_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.-machine
machine
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. -
THUMB : 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
.
-
ARM : définit le type d’ordinateur sur
-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.-o
object_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.-predefine
directive
-pd
directive
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.-via
filename
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 -o
et qu’aucune option n’est .obj
spécifiée, l’assembleur ajoute le nom de base de source_file pour créer le fichier objet.
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
Messages de diagnostic arm Assembleur
Directives de l’assembleur ARM