Sdílet prostřednictvím


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 naleznete v MASM pro x64 (ml64.exe).

Syntaxe

ML [options] filename [ [options] filename]

ML64 [options] filename [ [options] filename] ... [/linklink_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ě .MODELTINY .
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 Mapy 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.
/Dsymbol⟦=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.
/Flfilename⟦⟧ Vygeneruje sestavený výpis kódu. Viz /Sf.
/Fmfilename⟦⟧ 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.
/Frfilename⟦⟧ Vygeneruje zdrojový soubor prohlížeče .sbr .
/FRfilename⟦⟧ 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.
/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 PAGEwidth.
/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 lengthhodnotu . Rozsah je 10–255 nebo 0. Výchozí hodnota je 0. Stejné jako PAGElength.
/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.
/Zpalignment⟦⟧ 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