ML Command-Line Reference
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

ML Command-Line Reference

Assembles and links one or more assembly-language source files. The command-line options are case sensitive.

ML [[options]] filename [[ [[options]]  filename]]
[[/link linkoptions]]


The options listed in the following table.
Option Action
/AT Enables tiny-memory-model support. Enables error messages for code constructs that violate the requirements for .com format files. Note that this is not equivalent to the .MODEL TINY directive.
/Bl filename Selects an alternate linker.
/c Assembles only. Does not link.
/coff Generates common object file format (COFF) type of object module. Generally required for Win32 assembly language development.
/Cp Preserves case of all user identifiers.
/Cu Maps all identifiers to upper case (default).
/Cx Preserves case in public and extern symbols.
/Dsymbol[[=value]] Defines a text macro with the given name. If value is missing, it is blank. Multiple tokens separated by spaces must be enclosed in quotation marks.
/EP Generates a preprocessed source listing (sent to STDOUT). See /Sf.
/Fhexnum Sets stack size to hexnum bytes (this is the same as /link /STACK:number). The value must be expressed in hexadecimal notation. There must be a space between /F and hexnum.
/Fefilename Names the executable file.
/Fl[[filename]] Generates an assembled code listing. See /Sf.
/Fm[[filename]] Creates a linker map file.
/Fofilename Names an object file.
/FPi Generates emulator fix-ups for floating-point arithmetic (mixed language only).
/Fr[[filename]] Generates a source browser .sbr file.
/FR[[filename]] Generates an extended form of a source browser .sbr file.
/Gc Specifies use of FORTRAN- or Pascal-style function calling and naming conventions. Same as OPTION LANGUAGE:PASCAL.
/Gd Specifies use of C-style function calling and naming conventions. Same as OPTION LANGUAGE:C.
/H number Restricts external names to number significant characters. The default is 31 characters.
/help Calls QuickHelp for help on ML.
/I pathname Sets path for include file. A maximum of 10 /I options is allowed.
/nologo Suppresses messages for successful assembly.
/omf Generates object module file format (OMF) type of object module.
/Sa Turns on listing of all available information.
/safeseh Marks the object as either containing no exception handlers or containing exception handlers that are all declared with .SAFESEH.
/Sc Adds instruction timings to listing file.
/Sf Adds first-pass listing to listing file.
/Sg Turns on listing of assembly-generated code.
/Sl width Sets the line width of source listing in characters per line. Range is 60 to 255 or 0. Default is 0. Same as PAGE width.
/Sn Turns off symbol table when producing a listing.
/Sp length Sets the page length of source listing in lines per page. Range is 10 to 255 or 0. Default is 0. Same as PAGE length.
/Ss text Specifies text for source listing. Same as SUBTITLE text.
/St text Specifies title for source listing. Same as TITLE text.
/Sx Turns on false conditionals in listing.
/Ta filename Assembles source file whose name does not end with the .asm extension.
/w Same as /W0.
/Wlevel Sets the warning level, where level = 0, 1, 2, or 3.
/WX Returns an error code if warnings are generated.
/Zd Generates line-number information in object file.
/Zf Makes all symbols public.
/Zi Generates CodeView information in object file.
/Zm Enables M510 option for maximum compatibility with MASM 5.1.
/Zp[[alignment]] Packs structures on the specified byte boundary. The alignment can be 1, 2, or 4.
/Zs Performs a syntax check only.
/? Displays a summary of ML command-line syntax.
The name of the file.
The compiler link options.

Environment Variables

Variable Description
INCLUDE Specifies search path for include files.
ML Specifies default command-line options.
TMP Specifies path for temporary files.

See Also

ML Error Messages | Microsoft Macro Assembler Reference

© 2015 Microsoft