Compartilhar via

Referência de linha de comando ML e ML64

  • Artigo

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.
/quiet Suprime a mensagem 'Montando'. 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 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