Referência de linha de comando ML e ML64

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

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

Syntax

ML[options] filename [ [options] ] filename

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

Parâmetros

options
As opções listadas na tabela a seguir:

Opção Ação
/AT Habilita o suporte a modelos de memória minúscula. Habilita mensagens de erro para constructos de código que violam os requisitos para .com arquivos de formato. Essa opção não é equivalente à .MODELTINY diretiva.
Não disponível no ml64.exe.
/Bl filename Seleciona um vinculador alternativo em filename.
/c Somente montagens. Não faz nenhuma vinculação.
/coff Gera o tipo coff (formato de arquivo de objeto) comum do módulo de objeto. Necessário para o desenvolvimento de linguagem do assembly 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 e minúsculas (padrão).
Não disponível no ml64.exe.
/Cx Preserva maiúsculas e minúsculas em símbolos públicos e extern.
/D symbol⟦=value⟧ Define uma macro de texto com o nome symbolfornecido. Se value estiver faltando, estará 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.
/ERRORREPORT[ NONE | PROMPT | QUEUE | SEND] Preterido. O relatório de erros é controlado por configurações de Windows Relatório de Erros (WER).
/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. Consulte /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 idioma misto).
Não disponível no ml64.exe.
/Fr filename⟦⟧ Gera um arquivo do navegador .sbr de origem.
/FR filename⟦⟧ Gera uma forma estendida de um arquivo de navegador .sbr de origem.
/Gc Especifica o uso de convenções de estilo FORTRAN ou Pascal para chamadas e nomes de função. 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. O mesmo que OPTION LANGUAGE:C.
Não disponível no ml64.exe.
/Gz Especifica o uso de convenções para chamadas e nomes de __stdcall função. O mesmo que OPTION LANGUAGE:STDCALL.
Não disponível no ml64.exe.
/H number Restringe nomes externos a number caracteres 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. No máximo 10 /I opções são permitidas.
/nologo Suprime mensagens para assembly bem-sucedido.
/omf Gera o tipo OMF (formato de arquivo do módulo de objeto) do módulo de objeto. /omf /cimplica . ML.exe não dá suporte à vinculação de objetos OMF.
Não disponível no ml64.exe.
/quiet Suprime a mensagem 'Assembling'. Disponível no Visual Studio 17.6 e posterior.
/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 PAGEwidth.
/Sn Desativa a tabela de símbolos quando uma listagem é produzida.
/Sp length Define o comprimento 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 PAGElength.
/Ss text Especifica o texto para listagem de origem. O mesmo que o SUBTITLE texto.
/St text Especifica o título da listagem de origem. O mesmo que o TITLE texto.
/Sx Ativa as falsas condicionais na listagem.
/Ta filename Monta o arquivo de origem cujo nome não termina com a .asm extensão.
/unwindv3 Habilita o suporte experimental de diretiva de desenrolamento da Versão 3. Quando especificadas, as diretivas de desenrolamento V3 devem aparecer antes da instrução associada (o inverso do comportamento V1), a gravação de epílogo por meio .BEGINEPILOG/.ENDEPILOG é necessária e a macro @UnwindVersion predefinida retorna.3 Para obter mais informações, consulte MASM para x64 (ml64.exe).
Disponível apenas em ml64.exe.
/w O 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 INCLUDE o caminho do ambiente.
/Zd Gera informações de número de 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 versão 17.0 e posterior de 2022).
/ZH:SHA384 Use SHA384 para obter soma de verificação nas informações de depuração. 18.6.0
/ZH:SHA512 Use SHA512 para soma de verificação em informações de depuração. 18.6.0
/Zi Gera informações do CodeView no arquivo de objeto.
/Zm Habilita a M510 opção de 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.

18.6.0 Essa opção está disponível a partir de Visual Studio versão 18.6.0 e MSVC 14.51 de 2026.

filename
O nome do arquivo.

link_options
As opções de link. Para obter mais informações, consulte as opções do Vinculador.

Observações

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

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

Variáveis de ambiente

Variable 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.

Consulte também

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

  • Last updated on