Referência de linha de comando ML e ML64

Monta e vincula um ou mais arquivos de origem de linguagem de assembly. As opções de linha de comando diferenciam maiúsculas de minúsculas.

Para obter mais informações sobre ml64.exe, confira MASM para x64 (ml64.exe).

Sintaxe

ML [options] filename [ [options] filename]

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

Parâmetros

options
As opções listadas na seguinte tabela:

Opção	Ação
/AT	Habilita o suporte a modelos de minimemória. Habilita mensagens de erro para construções de código que violam os requisitos de arquivos de formato .com. Essa opção não é equivalente à .MODEL TINY diretiva. Não disponível no ml64.exe.
/Bl filename	Seleciona um vinculador alternativo em filename.
/c	Apenas monta. Não faz nenhuma vinculação.
/coff	Gera um tipo de formato COFF do módulo de objeto. Necessário para o desenvolvimento de linguagem assembly do Win32. Não disponível no ml64.exe.
/Cp	Preserva o caso de todos os identificadores de usuário.
/Cu	Mapeia todos os identificadores para maiúsculas (padrão). Não disponível no ml64.exe.
/Cx	Preserva maiúsculas e minúsculas em símbolos públicos e externos.
/Dsymbol⟦=value⟧	Define uma macro de texto com o nome symbol fornecido. Se value estiver ausente, ficará em branco. Vários tokens separados por espaços devem ser colocados entre aspas.
/EP	Gera uma listagem de origem pré-processada (enviada para STDOUT). Consulte /Sf.
/ERRORREPORTNONEQUEUESEND | PROMPT | | [ ]	Preterido. O relatório de erros é controlado por configurações do WER (Relatório de Erros do Windows).
/F hexnum	Define o tamanho da pilha como hexnum bytes (o mesmo que /link /STACK:<number>). O valor deve ser expresso na notação hexadecimal. Deve haver um espaço entre /F e hexnum.
/Fe filename	Nomeia o arquivo executável.
/Fl⟦filename⟧	Gera uma listagem de código montada. Confira /Sf.
/Fm⟦filename⟧	Cria um arquivo de mapa do vinculador.
/Fo filename	Nomeia um arquivo de objeto. Para obter mais informações, consulte Comentários.
/FPi	Gera correções do emulador para aritmética de ponto flutuante (somente linguagem mista). Não disponível no ml64.exe.
/Fr⟦filename⟧	Gera um arquivo .sbr do navegador de origem.
/FR⟦filename⟧	Gera um formato estendido de um arquivo .sbr do navegador de origem.
/Gc	Especifica o uso de convenções de estilo FORTRAN ou Pascal para chamadas e nomes de função. Mesmo que OPTION LANGUAGE:PASCAL. Não disponível no ml64.exe.
/Gd	Especifica o uso de convenções de estilo C para chamadas e nomes de função. Mesmo que OPTION LANGUAGE:C. Não disponível no ml64.exe.
/Gz	Especifica o uso de convenções __stdcall para chamadas e nomes de função. Mesmo que OPTION LANGUAGE:STDCALL. Não disponível no ml64.exe.
/H number	Restringe nomes externos a caracteres number significativos. O padrão é 31 caracteres. Não disponível no ml64.exe.
/help	Exibe um resumo da sintaxe e das opções da linha de comando ML.
/I pathname	Define o caminho para incluir o arquivo. É permitido no máximo 10 opções /I.
/nologo	Suprime mensagens para assembly bem-sucedido.
/omf	Gera o tipo de módulo de objeto OMF (formato de arquivo de módulo de objeto). /omf implica /c. O ML.exe não dá suporte à vinculação de objetos OMF. Não disponível no ml64.exe.
/Sa	Ativa a listagem de todas as informações disponíveis.
/safeseh	Marca o arquivo de objeto: ele não contém manipuladores de exceção ou contém manipuladores de exceção que são todos declarados com .SAFESEH. Não disponível no ml64.exe.
/Sf	Adiciona a listagem de primeira passagem ao arquivo de listagem.
/Sl width	Define a largura da linha da listagem de origem em caracteres por linha como width. O intervalo é de 60 a 255 ou 0. O padrão é 0. O mesmo que PAGE width.
/Sn	Desativa a tabela de símbolos quando uma listagem é produzida.
/Sp length	Define o tamanho da página da listagem de origem em linhas por página como length. O intervalo é de 10 a 255 ou 0. O padrão é 0. O mesmo que PAGE length.
/Ss text	Especifica o texto para a listagem de origem. O mesmo que o texto SUBTITLE.
/St text	Especifica o título para a listagem de origem. O mesmo que o texto TITLE.
/Sx	Ativa falsas condicionais na listagem.
/Ta filename	Monta o arquivo de origem cujo nome não termina com a extensão .asm.
/w	Mesmo que /W0 /WX.
/W level	Define o nível de aviso, em que level = 0, 1, 2 ou 3.
/WX	Se os avisos forem gerados, retornará um código de erro.
/X	Ignorar o caminho do ambiente INCLUDE.
/Zd	Gera informação de número da linha no arquivo de objeto.
/Zf	Torna todos os símbolos públicos.
/ZH:MD5	Use MD5 para soma de verificação em informações de depuração.
/ZH:SHA_256	Use SHA256 para soma de verificação em informações de depuração (padrão no Visual Studio 2022 versão 17.0 e posterior).
/Zi	Gera informações do CodeView no arquivo-objeto.
/Zm	Habilita a opção M510 para compatibilidade máxima com o MASM 5.1. Não disponível no ml64.exe.
/Zp⟦alignment⟧	Empacota estruturas no limite de bytes especificado. Pode alignment ser 1, 2, 4, 8 ou 16.
/Zs	Executa apenas uma verificação de sintaxe.
/?	Exibe um resumo da sintaxe e das opções da linha de comando ML.

filename
O nome do arquivo.

link_options
As opções de link. Para obter mais informações, confira Opções do vinculador.

Comentários

Algumas opções de linha de comando para ML e ML64 diferenciam posicionamento. Por exemplo, como ML e ML64 podem aceitar várias opções /c, todas as opções /Fo correspondentes devem ser especificadas antes de /c. O seguinte exemplo de linha de comando ilustra uma especificação de arquivo-objeto para cada especificação de arquivo do assembly:

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

Variáveis de ambiente

Variável	Descrição
INCLUDE	Especifica o caminho de pesquisa para incluir arquivos.
ML	Especifica as opções de linha de comando padrão.
TMP	Especifica o caminho para arquivos temporários.

Confira também

Mensagens de erro de ML
Referência do Microsoft Macro Assembler