ML 和 ML64 命令行参考

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

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

语法

ML [options] filename [ [options] filename]

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

parameters

options
下表中列出的选项:

选项 操作
/AT 启用小型内存模型支持。 启用违反格式化文件要求 .com 的代码构造的错误消息。 此选项与指令不等效 .MODELTINY
在 ml64.exe 中不可用。
/Bl filename 选择中 filename 的备用链接器。
/c 仅装配。 没有链接。
/coff (COFF) 对象模块类型生成通用对象文件格式。 Win32 汇编语言开发所必需的。
在 ml64.exe 中不可用。
/Cp 保留所有用户标识符的大小写。
/Cu 地图所有标识符 (默认) 的大写。
在 ml64.exe 中不可用。
/Cx 保留公共和 extern 符号中的大小写。
/Dsymbol⟦ = value 定义具有给定名称 symbol 的文本宏。 如果 value 缺失,则为空。 用空格分隔的多个标记必须用引号引起来。
/EP 生成一个预处理的源列表 (发送到 STDOUT) 。 请参阅 /Sf
/ERRORREPORT [ NONE | PROMPT | QUEUE | SEND ] 已弃用。 错误报告由Windows 错误报告 (WER) 设置控制。
/F hexnum 将堆栈大小设置为 hexnum (与) 相同 /link /STACK:<number> 的字节。 该值必须用十六进制表示法表示。 在和 hexnum 之间 /F 必须有空格。
/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 设置包含文件的路径。 最多允许 10 /I 个选项。
/nologo 禁止成功的程序集的消息。
/omf (OMF) 对象模块类型生成对象模块文件格式。 /omf 意味着 /c。 ML.exe 不支持链接 OMF 对象。
在 ml64.exe 中不可用。
/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 扩展名结尾的源文件。
/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。
/Zs 仅执行语法检查。
/? 显示 ML 命令行语法和选项的摘要。

filename
文件的名称。

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

备注

一些用于 ML 和 ml64.exe 的命令行选项是位置相关的。 例如,因为 ML 和 ml64.exe 可以接受多个 /c 选项,所以必须在之前 /c 指定任何相应 /Fo 的选项。 以下命令行示例说明了每个程序集文件规范的对象文件规范:

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

环境变量

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

另请参阅

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