ML- och ML64-kommandoradsreferens

Monterar och länkar en eller flera källfiler för sammansättningsspråk. Kommandoradsalternativen är skiftlägeskänsliga.

Mer information om ml64.exefinns i MASM för x64 (ml64.exe).

Syntax

ML [options] filename [ [options] filename]

ML64 [options] filename [ [options] filename] ... [/linklink_options]

Parameters

options
Alternativen i följande tabell:

Alternativ Action
/AT Aktiverar stöd för tiny-memory-model. Aktiverar felmeddelanden för kodkonstruktioner som strider mot kraven för .com formatfiler. Det här alternativet motsvarar .MODELTINY inte direktivet.
Inte tillgängligt i ml64.exe.
/Bl filename Väljer en alternativ länkare i filename.
/c Monterar endast. Länkar inte.
/coff Genererar en COFF-typ (Common Object File Format) av objektmodulen. Krävs för utveckling av win32-sammansättningsspråk.
Inte tillgängligt i ml64.exe.
/Cp Bevarar skiftläge för alla användaridentifierare.
/Cu Mappar alla identifierare till versaler (standard).
Inte tillgängligt i ml64.exe.
/Cx Bevarar skiftläge i offentliga och externa symboler.
/D symbol⟦=value Definierar ett textmakro med det angivna namnet symbol. Om value saknas är det tomt. Flera token avgränsade med blanksteg måste omges av citattecken.
/EP Genererar en förbearbetad källlista (skickas till STDOUT). Se även /Sf.
/ERRORREPORT[ NONESEND | | PROMPT | QUEUE] Deprecated. Felrapportering styrs av Windows felrapportering (WER) inställningar.
/F hexnum Anger stackstorlek till hexnum byte (samma som /link /STACK:<number>). Värdet måste uttryckas i hexadecimal notation. Det måste finnas ett blanksteg mellan /F och hexnum.
/Fe filename Namnger den körbara filen.
/Fl filename⟦⟧ Genererar en sammanställd kodlista. Se /Sf.
/Fm filename⟦⟧ Skapar en länkmappningsfil.
/Fo filename Namnger en objektfil. Mer information finns i Kommentarer.
/FPi Genererar korrigeringar av emulatorn för flyttalsaritmetik (endast blandat språk).
Inte tillgängligt i ml64.exe.
/Fr filename⟦⟧ Genererar en källwebbläsarefil .sbr .
/FR filename⟦⟧ Genererar en utökad form av en källwebbläsarefil .sbr .
/Gc Anger användning av FORTRAN- eller Pascal-stilkonventioner för funktionsanrop och namn. Samma som OPTION LANGUAGE:PASCAL.
Inte tillgängligt i ml64.exe.
/Gd Anger användning av C-stilkonventioner för funktionsanrop och namn. Samma som OPTION LANGUAGE:C.
Inte tillgängligt i ml64.exe.
/Gz Anger användning av __stdcall konventioner för funktionsanrop och namn. Samma som OPTION LANGUAGE:STDCALL.
Inte tillgängligt i ml64.exe.
/H number Begränsar externa namn till number betydande tecken. Standardvärdet är 31 tecken.
Inte tillgängligt i ml64.exe.
/help Visar en sammanfattning av ML-kommandoradssyntax och alternativ.
/I pathname Anger sökväg för inkluderad fil. Högst 10 /I alternativ tillåts.
/nologo Undertrycker meddelanden för lyckad sammansättning.
/omf Genererar objektmodulens filformat (OMF) typ av objektmodul. /omf antyder /c. ML.exe stöder inte länkning av OMF-objekt.
Inte tillgängligt i ml64.exe.
/quiet Undertrycker meddelandet "Montering". Finns i Visual Studio 17.6 och senare.
/Sa Aktiverar en lista över all tillgänglig information.
/safeseh Markerar objektfilen: antingen innehåller den inga undantagshanterare eller så innehåller den undantagshanterare som alla deklareras med .SAFESEH.
Inte tillgängligt i ml64.exe.
/Sf Lägger till first-pass-listan i listfilen.
/Sl width Anger radbredden för källlistan i tecken per rad till width. Intervallet är 60-255 eller 0. Standardvärdet är 0. Samma som PAGEwidth.
/Sn Inaktiverar symboltabellen när en lista skapas.
/Sp length Anger sidlängden för källlistan i rader per sida till length. Intervallet är 10-255 eller 0. Standardvärdet är 0. Samma som PAGElength.
/Ss text Anger text för källlistan. Samma som SUBTITLE text.
/St text Anger rubrik för källlistan. Samma som TITLE text.
/Sx Aktiverar falska villkor i listan.
/Ta filename Monterar källfilen vars namn inte slutar med .asm tillägget.
/unwindv3 Aktiverar stöd för experimentell avspolning av version 3 avspolningsdirektiv. När det anges måste V3-avspolningsdirektiv visas innan deras associerade instruktion (omvänd V1-beteende), epiloginspelning via .BEGINEPILOG/.ENDEPILOG krävs och det fördefinierade makrot @UnwindVersion returnerar .3 Mer information finns i MASM för x64 (ml64.exe).
Endast tillgängligt i ml64.exe.
/w Samma som /W0 /WX.
/W level Anger varningsnivån, där level = 0, 1, 2 eller 3.
/WX Om varningar genereras returnerar en felkod.
/X Ignorera INCLUDE miljösökvägen.
/Zd Genererar radnummerinformation i objektfilen.
/Zf Gör alla symboler offentliga.
/ZH:MD5 Använd MD5 för kontrollsumma i felsökningsinformation.
/ZH:SHA_256 Använd SHA256 för kontrollsumma i felsökningsinformation (standard i Visual Studio 2022 version 17.0 och senare).
/Zi Genererar CodeView-information i objektfilen.
/Zm Aktiverar M510 alternativet för maximal kompatibilitet med MASM 5.1.
Inte tillgängligt i ml64.exe.
/Zp alignment⟦⟧ Packar strukturer på den angivna bytegränsen. alignment Kan vara 1, 2, 4, 8 eller 16.
/Zs Utför endast en syntaxkontroll.
/? Visar en sammanfattning av ML-kommandoradssyntax och alternativ.

filename
Namnet på filen.

link_options
Länkalternativen. Mer information finns i Alternativ för Linker.

Anmärkningar

Vissa kommandoradsalternativ för ML och ML64 är placeringskänsliga. Eftersom ML och ML64 till exempel kan acceptera flera /c alternativ måste motsvarande /Fo alternativ anges före /c. Följande kommandoradsexempel illustrerar en objektfilspecifikation för varje sammansättningsfilspecifikation:

ml.exe /Fo a1.obj /c a.asm /Fo b1.obj /c b.asm

Miljövariabler

Variable Description
INCLUDE Anger sökvägen för inkluderingsfiler.
ML Anger standardalternativ för kommandoraden.
TMP Anger sökvägen för temporära filer.

Se även

ML-felmeddelanden
Referens för Microsoft Macro Assembler