Informations de référence sur la ligne de commande ML et ML64
Assemble et lie un ou plusieurs fichiers sources en langage assembly. Les options de ligne de commande respectent la casse.
Pour plus d’informations sur ml64.exe, consultez MASM pour x64 (ml64.exe).
Syntaxe
ML
[options
]filename
[ [options
] ]filename
ML64
[options
]filename
[ [options
]filename
] ... [/link
link_options
]
Paramètres
options
Les options répertoriées dans le tableau suivant :
Option | Action |
---|---|
/AT |
Active la prise en charge de tiny-memory-model. Active les messages d’erreur pour les constructions de code qui ne respectent pas les conditions requises pour .com les fichiers de format. Cette option n’est pas équivalente à la .MODEL TINY directive.Non disponible dans ml64.exe. |
/Bl filename |
Sélectionne un autre éditeur de liens dans filename . |
/c |
Assemble uniquement. Ne lie pas. |
/coff |
Génère le type COFF (Common Object File Format) du module objet. Obligatoire pour le développement du langage d’assembly Win32. Non disponible dans ml64.exe. |
/Cp |
Conserve le cas de tous les identificateurs utilisateur. |
/Cu |
Mappe tous les identificateurs en majuscules (valeur par défaut). Non disponible dans ml64.exe. |
/Cx |
Conserve la casse dans les symboles publics et externs. |
/D symbol ⟦=value ⟧ |
Définit une macro de texte portant le nom symbol donné. S’il value est manquant, il est vide. Plusieurs jetons séparés par des espaces doivent être placés entre guillemets. |
/EP |
Génère une liste source prétraite (envoyée à STDOUT ). Consultez l’article /Sf . |
/ERRORREPORT [ NONE SEND | | PROMPT | QUEUE ] |
Déconseillé. Le rapport d’erreurs est contrôlé par les paramètres de rapport d’erreurs Windows (WER ). |
/F hexnum |
Définit la taille de la pile sur hexnum octets (identique à /link /STACK:<number> ). La valeur doit être exprimée en notation hexadécimale. Il doit y avoir un espace entre /F et hexnum . |
/Fe filename |
Nomme le fichier exécutable. |
/Fl filename ⟦⟧ |
Génère une liste de codes assemblée. Voir /Sf. |
/Fm filename ⟦⟧ |
Crée un fichier de mappage de l’éditeur de liens. |
/Fo filename |
Nomme un fichier objet. Pour plus d’informations, consultez Notes. |
/FPi |
Génère des correctifs d’émulateur pour l’arithmétique à virgule flottante (langage mixte uniquement). Non disponible dans ml64.exe. |
/Fr filename ⟦⟧ |
Génère un fichier de navigateur .sbr source. |
/FR filename ⟦⟧ |
Génère une forme étendue d’un fichier de navigateur .sbr source. |
/Gc |
Spécifie l’utilisation des conventions de style FORTRAN ou Pascal pour les appels de fonction et les noms. Comme pour OPTION LANGUAGE:PASCAL .Non disponible dans ml64.exe. |
/Gd |
Spécifie l’utilisation des conventions de style C pour les appels de fonction et les noms. Comme pour OPTION LANGUAGE:C .Non disponible dans ml64.exe. |
/Gz |
Spécifie l’utilisation de __stdcall conventions pour les appels de fonction et les noms. Comme pour OPTION LANGUAGE:STDCALL .Non disponible dans ml64.exe. |
/H number |
Limite les noms externes aux number caractères significatifs. La valeur par défaut est de 31 caractères.Non disponible dans ml64.exe. |
/help |
Affiche un résumé de la syntaxe et des options de ligne de commande ML. |
/I pathname |
Définit le chemin d’accès pour le fichier include. Un maximum de 10 /I options est autorisé. |
/nologo |
Supprime les messages pour l’assembly réussi. |
/omf |
Génère le type de fichier de fichier de module objet (OMF) du module objet. /omf implique /c . ML.exe ne prend pas en charge la liaison d’objets OMF.Non disponible dans ml64.exe. |
/quiet |
Supprime le message « Assembler ». Disponible dans Visual Studio 17.6 et versions ultérieures. |
/Sa |
Active la liste de toutes les informations disponibles. |
/safeseh |
Marque le fichier objet : il ne contient aucun gestionnaire d’exceptions, ou contient des gestionnaires d’exceptions qui sont tous déclarés avec .SAFESEH .Non disponible dans ml64.exe. |
/Sf |
Ajoute la liste de première passe au fichier de référencement. |
/Sl width |
Définit la largeur de ligne de la liste source en caractères par ligne sur width . La plage est comprise entre 60 et 255 ou 0. La valeur par défaut est 0. Identique à PAGE width . |
/Sn |
Désactive la table de symboles lorsqu’une description est générée. |
/Sp length |
Définit la longueur de la page de la liste source dans les lignes par page length sur . La plage est comprise entre 10 et 255 ou 0. La valeur par défaut est 0. Identique à PAGE length . |
/Ss text |
Spécifie le texte de la liste source. Identique au SUBTITLE texte. |
/St text |
Spécifie le titre de la liste source. Identique au TITLE texte. |
/Sx |
Active les faux conditionnels dans la liste. |
/Ta filename |
Assemble le fichier source dont le nom ne se termine pas par l’extension .asm . |
/w |
Comme pour /W0 /WX . |
/W level |
Définit le niveau d’avertissement, où level = 0, 1, 2 ou 3. |
/WX |
Si des avertissements sont générés, retourne un code d’erreur. |
/X |
Ignorez le INCLUDE chemin d’accès de l’environnement. |
/Zd |
Génère des informations de numéro de ligne dans le fichier objet. |
/Zf |
Rend tous les symboles publics. |
/ZH:MD5 |
Utilisez MD5 pour la somme de contrôle dans les informations de débogage. |
/ZH:SHA_256 |
Utilisez SHA256 pour la somme de contrôle dans les informations de débogage (valeur par défaut dans Visual Studio 2022 version 17.0 et ultérieure). |
/Zi |
Génère des informations CodeView dans le fichier objet. |
/Zm |
Active l’option M510 pour une compatibilité maximale avec MASM 5.1.Non disponible dans ml64.exe. |
/Zp alignment ⟦⟧ |
Packs des structures sur la limite d’octets spécifiée. Il alignment peut s’agir de 1, 2, 4, 8 ou 16. |
/Zs |
Effectue une vérification de syntaxe uniquement. |
/? |
Affiche un résumé de la syntaxe et des options de ligne de commande ML. |
filename
Le nom du fichier.
link_options
Options de lien. Pour plus d’informations, consultez Options de l’éditeur de liens.
Notes
Certaines options de ligne de commande pour ML et ML64 respectent le positionnement. Par exemple, étant donné que ML et ML64 peuvent accepter plusieurs /c
options, toutes les options correspondantes /Fo
doivent être spécifiées avant /c
. L’exemple de ligne de commande suivant illustre une spécification de fichier objet pour chaque spécification de fichier d’assembly :
ml.exe /Fo a1.obj /c a.asm /Fo b1.obj /c b.asm
Variables d'environnement
Variable | Description |
---|---|
INCLUDE |
Spécifie le chemin de recherche des fichiers include. |
ML |
Spécifie les options de ligne de commande par défaut. |
TMP |
Spécifie le chemin d’accès des fichiers temporaires. |
Voir aussi
Messages d’erreur ML
Informations de référence sur l’assembleur de macros Microsoft