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

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

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

Синтаксис

ML[options] filename [ [options] ] filename

ML64 [options] filename [ [options] filename] ... [/linklink_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[ ] 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. Эквивалентно PAGEwidth.
/Sn	Выключает таблицу символов при создании списка.
/Sp length	Задает длину страницы исходного описания в строках на страницу length. Диапазон равен 10–255 или 0. Значение по умолчанию — 0. Эквивалентно PAGElength.
/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 для проверка sum в сведениях об отладке.
/ZH:SHA_256	Используйте SHA256 для проверка sum в сведениях об отладке (по умолчанию в 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	Указывает путь для временных файлов.

См. также

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