Справочник по командной строке ML и ML64

Собирает и связывает один или несколько исходных файлов на языке сборки. Параметры командной строки чувствительны к регистру.

Дополнительные сведения о ml64.exe см. в статье MASM для x64 (ml64.exe).

Синтаксис

ML[options] filename [ [options] ] filename

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

Параметры

options
Параметры, перечисленные в следующей таблице:

Вариант	Действие
/AT	Включает поддержку модели крошечной памяти. Включает сообщения об ошибках для конструкций кода, которые нарушают требования к .com файлам форматирования. Этот параметр не эквивалентен директиве .MODEL TINY . Недоступно в ml64.exe.
/Bl filename	Выбирает альтернативный компоновщик в filename.
/c	Выполняет сборку только. Не связывается.
/coff	Создает общий тип формата файлов объектов (COFF) модуля объекта. Требуется для разработки языка сборки Win32. Недоступно в ml64.exe.
/Cp	Сохраняет регистр всех идентификаторов пользователей.
/Cu	Сопоставляет все идентификаторы с верхним регистром (по умолчанию). Недоступно в ml64.exe.
/Cx	Сохраняет регистр в открытых и внешних символах.
/Dsymbol⟦=value⟧	Определяет текстовый макрос с заданным именем symbol. Если value отсутствует, это пусто. Несколько маркеров, разделенных пробелами, должны быть заключены в кавычки.
/EP	Создает предварительно обработанное перечисление источника (отправлено в STDOUT). См. раздел /Sf.
/ERRORREPORT[ ] NONE | PROMPT | QUEUE | SEND	Устарело. Отчеты об ошибках управляются параметрами отчеты об ошибках Windows (WER).
/F hexnum	Задает размер стека в hexnum байты (то же самое, что /link /STACK:<number>и ). Значение должно быть выражено в шестнадцатеричной нотации. Должно быть пространство между /F и hexnum.
/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	Отображает сводку синтаксиса командной строки машинного обучения и параметров.
/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. То же самое, что PAGE widthи .
/Sn	Выключает таблицу символов при создании списка.
/Sp length	Задает длину страницы исходного описания в строках на страницу length. Диапазон равен 10–255 или 0. Значение по умолчанию — 0. То же самое, что PAGE lengthи .
/Ss text	Задает текст для перечисления источника. То же самое, что SUBTITLE и текст.
/St text	Задает заголовок для исходного описания. То же самое, что TITLE и текст.
/Sx	Включает ложные условные условия в списке.
/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	Выполняет только проверку синтаксиса.
/?	Отображает сводку синтаксиса командной строки машинного обучения и параметров.

filename
Имя файла.

link_options
Параметры ссылки. Дополнительные сведения см. в разделе Параметры компоновщика.

Замечания

Некоторые параметры командной строки для ML и ML64 чувствительны к размещению. Например, так как ML и ML64 могут принимать несколько /c вариантов, все соответствующие /Fo параметры необходимо указать перед /c. В следующем примере командной строки показана спецификация файла объекта для каждой спецификации файла сборки:

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

Переменные среды

«Переменная»	Description
INCLUDE	Указывает путь поиска для включения файлов.
ML	Задает параметры командной строки по умолчанию.
TMP	Указывает путь для временных файлов.

См. также

Сообщения об ошибках машинного обучения
Справочник по сборщику макросов Майкрософт