This documentation is archived and is not being maintained.

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