ML 和 ML64 命令行参考

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

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

Syntax

ML [options] filename [ [options] filename]

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

参数

options
下表中列出的选项:

选项 Action
/AT 启用 tiny-memory-model 支持。 为违反格式化文件要求 .com 的代码构造启用错误消息。 此选项不等效于 .MODELTINY 指令。
在 ml64.exe中不可用。
/Bl filename 在 . 中选择 filename备用链接器。
/c 仅程序集。 不链接。
/coff 生成对象模块的常见对象文件格式 (COFF) 类型。 Win32 程序集语言开发所必需的。
在 ml64.exe中不可用。
/Cp 保留所有用户标识符的事例。
/Cu 将所有标识符映射到大写(默认值)。
在 ml64.exe中不可用。
/Cx 保留公共符号和外部符号中的大小写。
/D symbol⟦=value 定义具有给定名称 symbol的文本宏。 如果 value 缺少,则为空。 用空格分隔的多个标记必须用引号括起来。
/EP 生成预处理的源列表(已发送到 STDOUT)。 请参阅 /Sf
/ERRORREPORT[ NONESEND | | PROMPT | QUEUE] 已弃用。 错误报告由 Windows 错误报告 (WER)设置控制。
/F hexnum 将堆栈大小设置为 hexnum 字节(与 /link /STACK:<number>字节相同)。 该值必须以十六进制表示法表示。 之间必须有一个空格/Fhexnum
/Fe filename 命名可执行文件。
/Fl filename⟦⟧ 生成程序集代码列表。 请参阅 /Sf
/Fm filename⟦⟧ 创建链接器映射文件。
/Fo filename 为对象文件命名。 有关详细信息,请参阅备注
/FPi 为浮点算术(仅混合语言)生成仿真器修复。
在 ml64.exe中不可用。
/Fr filename⟦⟧ 生成源浏览器 .sbr 文件。
/FR filename⟦⟧ 生成源浏览器 .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 设置包含文件的路径。 最多允许 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。 与 PAGEwidth.
/Sn 生成列表时关闭符号表。
/Sp length 将每页行中的源列表的页面长度设置为 length。 范围为 10-255 或 0。 默认值为 0。 与 PAGElength.
/Ss text 指定源列表的文本。 与 SUBTITLE 文本相同。
/St text 指定源列表的标题。 与 TITLE 文本相同。
/Sx 在列表中启用 false 条件。
/Ta filename 汇编名称不以扩展名结尾的 .asm 源文件。
/unwindv3 启用实验性展开版本 3 展开指令支持。 指定后,V3 展开指令必须出现在关联的指令(V1 行为的反向)、尾声录制.ENDEPILOG.BEGINEPILOG/之前,并且预定义的宏@UnwindVersion3返回。 有关详细信息,请参阅 适用于 x64(ml64.exe)的 MASM
仅在 ml64.exe中可用。
/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中不可用。
/Zp alignment⟦⟧ 打包指定字节边界上的结构。 可以是 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

环境变量

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

另请参阅

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