ML 和 ML64 命令行参考

汇编和链接一个或多个汇编语言源文件。 命令行选项区分大小写。

有关 ml64.exe 的详细信息,请参阅适用于 x64 的 MASM (ml64.exe)

语法

ML [options] filename [ [options] filename]

ML64 [options] filename [ [options] filename] ...[/link link_options]

参数

options
选项在下表中列出:

选项 操作
/AT 启用微型内存模型支持。 为违反 .com 格式文件要求的代码构造启用错误消息。 此选项不等效于.MODELTINY指令。
在 ml64.exe 中不可用。
/Bl filename filename 中选择备用链接器。
/c 仅进行汇编。 不进行链接。
/coff 生成对象模块的通用对象文件格式 (COFF) 类型。 Win32 汇编语言开发所需。
在 ml64.exe 中不可用。
/Cp 保留所有用户标识符的大小写。
/Cu 将所有标识符都映射为大写(默认)。
在 ml64.exe 中不可用。
/Cx 保留公共符号和外部符号中的大小写。
/Dsymbol⟦=value 定义具有给定名称 symbol 的文本宏。 如果 value 缺失,则为空。 用空格分隔的多个标记必须用引号引起来。
/EP 生成预处理源列表(发送到 STDOUT)。 请参阅 /Sf
/ERRORREPORT[ NONESEND | | PROMPT | QUEUE] 已弃用。 错误报告由 Windows 错误报告 (WER) 设置控制。
/F hexnum 将堆栈大小设置为 hexnum 字节(与 /link /STACK:<number> 相同)。 值必须以十六进制表示法表示。 在 /Fhexnum 之间必须留一个空格。
/Fe filename 命名可执行文件。
/Flfilename⟦⟧ 生成汇编代码列表。 请参阅 /Sf
/Fmfilename⟦⟧ 创建链接器映射文件。
/Fo filename 为对象文件命名。 有关更多信息,请参见备注
/FPi 为浮点算术生成仿真器修复(仅限混合语言)。
在 ml64.exe 中不可用。
/Frfilename⟦⟧ 生成源浏览器 .sbr 文件。
/FRfilename⟦⟧ 生成源浏览器 .sbr 文件的扩展形式。
/Gc 指定对函数调用和名称使用 FORTRAN 或 Pascal 样式约定。 与 OPTION LANGUAGE:PASCAL 相同。
在 ml64.exe 中不可用。
/Gd 指定对函数调用和名称使用 C 样式约定。 与 OPTION LANGUAGE:C 相同。
在 ml64.exe 中不可用。
/Gz 指定对函数调用和名称使用 __stdcall 约定。 与 OPTION LANGUAGE:STDCALL 相同。
在 ml64.exe 中不可用。
/H number 将外部名称限制为 number 个重要字符。 默认为 31 个字符。
在 ml64.exe 中不可用。
/help 显示 ML 命令行语法和选项的摘要。
/I pathname 设置 include 文件的路径。 最多允许 10 个 /I 选项。
/nologo 禁止显示成功进行汇编的消息。
/omf 生成对象模块文件格式 (OMF) 类型的对象模块。 /omf 意味着 /c。 ML.exe 不支持链接 OMF 对象。
在 ml64.exe 中不可用。
/quiet 禁止显示“汇编”消息。 在 Visual Studio 17.6 及更高版本中可用。
/Sa 启用列出所有可用信息的功能。
/safeseh 标记对象文件:它不包含任何异常处理程序,或者它包含全都使用 .SAFESEH 进行声明的异常处理程序。
在 ml64.exe 中不可用。
/Sf 将第一遍列表添加到列表文件。
/Sl width 在每行字符数中将源列表的行宽设置为 width。 范围为 60-255 或 0。 默认为 0。 与 PAGE width.
/Sn 生成列表时禁用符号表。
/Sp length 在每页行数中将源列表的页面长度设置为 length。 范围为 10-255 或 0。 默认为 0。 与 PAGE length.
/Ss text 指定源列表的文本。 与 SUBTITLE 文本相同。
/St text 指定源列表的标题。 与 TITLE 文本相同。
/Sx 在列表中启用 false 条件。
/Ta filename 汇编其名称不以 .asm 扩展名结尾的源文件。
/w /W0 /WX 相同。
/W level 设置警告级别,其中 level = 0、1、2 或 3。
/WX 如果生成警告,则返回错误代码。
/X 忽略 INCLUDE 环境路径。
/Zd 生成对象文件中的行号信息。
/Zf 将所有符号公开。
/ZH:MD5 在调试信息中将 MD5 用于校验和。
/ZH:SHA_256 在调试信息中将 SHA256 用于校验和(Visual Studio 2022 版本 17.0 及更高版本中的默认设置)。
/Zi 在对象文件中生成 CodeView 信息。
/Zm 启用 M510 选项以尽量与 MASM 5.1 兼容。
在 ml64.exe 中不可用。
/Zpalignment⟦⟧ 打包指定字节边界上的结构。 alignment 可以是 1、2、4、8 或 16。
/Zs 仅执行语法检查。
/? 显示 ML 命令行语法和选项的摘要。

filename
文件的名称。

link_options
链接选项。 有关详细信息,请参阅链接器选项

备注

ML 和 ML64 的一些命令行选项跟放置相关。 例如,由于 ML 和 ML64 可以接受多个 /c 选项,因此必须在 /c 之前指定任何相应的 /Fo 选项。 以下命令行示例演示每个程序集文件规范的对象文件规范:

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

环境变量

变量 说明
INCLUDE 指定 include 文件的搜索路径。
ML 指定默认命令行选项。
TMP 指定临时文件的路径。

另请参阅

ML 错误消息
Microsoft 宏汇编程序参考