Referenční dokumentace pro použití nástroje ML a ML64 na příkazovém řádku
Sestavuje a propojuje jeden nebo více zdrojových souborů jazyka sestavení. Možnosti příkazového řádku rozlišují malá a velká písmena.
Další informace o ml64.exe najdete v masm pro platformu x64 (ml64.exe).
Syntaxe
ML
[options
]filename
[ [options
]filename
]
ML64
[options
]filename
[ [options
]filename
] ... [ ]/link
link_options
Parametry
options
Možnosti uvedené v následující tabulce:
Možnost | Akce |
---|---|
/AT |
Umožňuje podporu malých modelů paměti. Umožňuje chybové zprávy pro konstrukty kódu, které porušují požadavky na .com soubory formátu. Tato možnost neodpovídá direktivě .MODEL TINY .Není k dispozici v ml64.exe. |
/Bl filename |
Vybere alternativní linker v souboru filename . |
/c |
Sestavte pouze. Nepropojí se. |
/coff |
Generuje společný typ formátu souboru objektu (COFF). Požadováno pro vývoj jazyka sestavení Win32. Není k dispozici v ml64.exe. |
/Cp |
Zachovává malá a velká písmena všech identifikátorů uživatelů. |
/Cu |
Mapuje všechny identifikátory na velká písmena (výchozí). Není k dispozici v ml64.exe. |
/Cx |
Zachovává malá a velká písmena ve veřejných a externích symbolech. |
/D symbol ⟦=value ⟧ |
Definuje textové makro s daným názvem symbol . Pokud value chybí, je prázdná. Více tokenů oddělených mezerami musí být uzavřeno v uvozovkách. |
/EP |
Vygeneruje předzpracovaný zdrojový výpis (odeslán na STDOUT ). Viz třída /Sf . |
/ERRORREPORT [ ] NONE | PROMPT | QUEUE | SEND |
Zastaralé Zasílání zpráv o chybách se řídí nastavením Zasílání zpráv o chybách systému Windows (WER). |
/F hexnum |
Nastaví velikost zásobníku na hexnum bajty (stejné jako /link /STACK:<number> ). Hodnota musí být vyjádřena v šestnáctkovém zápisu. Mezi /F a hexnum . |
/Fe filename |
Pojmenuje spustitelný soubor. |
/Fl filename ⟦⟧ |
Vygeneruje sestavený výpis kódu. Viz /Sf. |
/Fm filename ⟦⟧ |
Vytvoří soubor mapování linkeru. |
/Fo filename |
Pojmenuje soubor objektu. Další informace naleznete v tématu Poznámky. |
/FPi |
Generuje opravy emulátoru pro aritmetické aritmetické operace s plovoucí desetinou čárkou (pouze smíšený jazyk). Není k dispozici v ml64.exe. |
/Fr filename ⟦⟧ |
Vygeneruje zdrojový soubor prohlížeče .sbr . |
/FR filename ⟦⟧ |
Vygeneruje rozšířenou formu zdrojového souboru prohlížeče .sbr . |
/Gc |
Určuje použití konvencí stylu FORTRAN nebo Pascal pro volání a názvy funkcí. Stejné jako OPTION LANGUAGE:PASCAL .Není k dispozici v ml64.exe. |
/Gd |
Určuje použití konvencí stylu jazyka C pro volání a názvy funkcí. Stejné jako OPTION LANGUAGE:C .Není k dispozici v ml64.exe. |
/Gz |
Určuje použití __stdcall konvencí pro volání a názvy funkcí. Stejné jako OPTION LANGUAGE:STDCALL .Není k dispozici v ml64.exe. |
/H number |
Omezuje externí názvy na number významné znaky. Výchozí hodnota je 31 znaků.Není k dispozici v ml64.exe. |
/help |
Zobrazí souhrn syntaxe a možností příkazového řádku ML. |
/I pathname |
Nastaví cestu pro soubor zahrnutí. Je povoleno maximálně 10 /I možností. |
/nologo |
Potlačí zprávy pro úspěšné sestavení. |
/omf |
Generuje typ objektového modulu formátu souboru (OMF). /omf implikuje /c . ML.exe nepodporuje propojení objektů OMF.Není k dispozici v ml64.exe. |
/quiet |
Potlačí zprávu Sestavení. K dispozici v sadě Visual Studio 17.6 a novějších verzích. |
/Sa |
Zapne výpis všech dostupných informací. |
/safeseh |
Označí soubor objektu: buď neobsahuje žádné obslužné rutiny výjimek, nebo obsahuje obslužné rutiny výjimek, které jsou deklarovány pomocí .SAFESEH .Není k dispozici v ml64.exe. |
/Sf |
Přidá první výpis výpisu do souboru výpisu. |
/Sl width |
Nastaví šířku řádku zdrojového výpisu v znaménku na řádek na width . Rozsah je 60–255 nebo 0. Výchozí hodnota je 0. Stejné jako PAGE width . |
/Sn |
Vypne tabulku symbolů při vytváření výpisu. |
/Sp length |
Nastaví délku stránky zdrojového výpisu v řádcích na stránku na length hodnotu . Rozsah je 10–255 nebo 0. Výchozí hodnota je 0. Stejné jako PAGE length . |
/Ss text |
Určuje text pro výpis zdroje. Stejné jako SUBTITLE text. |
/St text |
Určuje název pro výpis zdroje. Stejné jako TITLE text. |
/Sx |
Zapne v výpisu podmínky false. |
/Ta filename |
Sestaví zdrojový soubor, jehož název nekončí příponou .asm . |
/w |
Stejné jako /W0 /WX . |
/W level |
Nastaví úroveň upozornění, kde level = 0, 1, 2 nebo 3. |
/WX |
Pokud se vygenerují upozornění, vrátí kód chyby. |
/X |
Ignorovat INCLUDE cestu prostředí. |
/Zd |
Vygeneruje informace o čísle řádku v souboru objektu. |
/Zf |
Zpřístupňuje všechny symboly. |
/ZH:MD5 |
Pro kontrolní součet v informacích o ladění použijte MD5. |
/ZH:SHA_256 |
Pro kontrolní součet v informacích o ladění použijte SHA256 (výchozí nastavení v sadě Visual Studio 2022 verze 17.0 a novější). |
/Zi |
Generuje informace CodeView v souboru objektu. |
/Zm |
Povolí možnost maximální kompatibility M510 s MASM 5.1.Není k dispozici v ml64.exe. |
/Zp alignment ⟦⟧ |
Zabalí struktury na určené hranici bajtů. Může alignment to být 1, 2, 4, 8 nebo 16. |
/Zs |
Provede pouze kontrolu syntaxe. |
/? |
Zobrazí souhrn syntaxe a možností příkazového řádku ML. |
filename
Název souboru.
link_options
Možnosti propojení. Další informace najdete v tématu Možnosti linkeru.
Poznámky
Některé možnosti příkazového řádku ml a ML64 jsou citlivé na umístění. Například proto, že ML a ML64 mohou přijmout několik /c
možností, musí být všechny odpovídající /Fo
možnosti zadány před /c
. Následující příklad příkazového řádku znázorňuje specifikaci souboru objektu pro každou specifikaci souboru sestavení:
ml.exe /Fo a1.obj /c a.asm /Fo b1.obj /c b.asm
Proměnné prostředí
Proměnná | Popis |
---|---|
INCLUDE |
Určuje cestu hledání pro zahrnuté soubory. |
ML |
Určuje výchozí možnosti příkazového řádku. |
TMP |
Určuje cestu pro dočasné soubory. |
Viz také
Chybové zprávy ML
Referenční dokumentace nástroje Microsoft Macro Assembler