Executando o NMAKE

Sintaxe

NMAKE [opção ...] [macros ...] [metas ...] [@arquivo de comando ...]

Observações

O NMAKE deve ser executado em uma janela do Prompt de Comando do Desenvolvedor. Uma janela do Prompt de Comando do Desenvolvedor tem as variáveis de ambiente definidas para as ferramentas, bibliotecas e incluem caminhos de arquivo necessários para criar na linha de comando. Para obter detalhes sobre como abrir uma janela do Prompt de Comando do Desenvolvedor, consulte Usar o conjunto de ferramentas MSVC da linha de comando.

O NMAKE cria apenas destinos especificados ou, quando nenhum é especificado, o primeiro destino no makefile. O primeiro destino makefile pode ser um pseudotarget que cria outros destinos. NMAKE usa makefiles especificados com /F, ou, se /F não for especificado, o arquivo Makefile no diretório atual. Se nenhum makefile for especificado, ele usará regras de inferência para criar destinos de linha de comando.

O arquivo de texto do arquivo de comando (ou arquivo de resposta) contém entrada de linha de comando. Outras entradas podem preceder ou seguir @command-file. Um caminho é permitido. No arquivo de comando, as quebras de linha são tratadas como espaços. Coloque as definições de macro entre aspas se elas contiverem espaços.

Opções NMAKE

As opções NMAKE são descritas na tabela a seguir. As opções são precedidas por uma barra (/) ou um traço (-) e não diferenciam maiúsculas de minúsculas. Use !CMDSWITCHES para alterar as configurações de opção em um makefile ou em Tools.ini.

Opção	Propósito
/A	As forças são construídas a partir de todos os alvos avaliados, mesmo que não estejam desatualizados em comparação com os dependentes. Não força construções de alvos não relacionados.
/B	As forças são construídas mesmo que os carimbos de data/hora sejam iguais. Recomendado apenas para sistemas rápidos (resolução de dois segundos ou menos).
/C	Suprime a saída padrão, incluindo erros ou avisos NMAKE não fatais, carimbos de data/hora e mensagem de direitos autorais NMAKE. Suprime os avisos emitidos pela /K.
/D	Exibe carimbos de data/hora de cada destino avaliado e dependente e uma mensagem quando um destino não existe. Útil com /P para depurar um makefile. Use !CMDSWITCHES para definir ou limpar /D parte de um makefile.
/E	Faz com que as variáveis de ambiente substituam as definições de macro do makefile.
/ERRORREPORT NONE | PROMPT | QUEUE | SEND[ ]	Preterido. Relatórios de controle de configurações do Relatório de Erros do Windows (WER).
/F nome do arquivo	Especifica o nome do arquivo como um makefile. Espaços ou guias podem preceder o nome do arquivo. Especifique /F uma vez para cada makefile. Para fornecer um makefile a partir da entrada padrão, especifique um traço (-) para o nome do arquivo e finalize a entrada do teclado com F6 ou CTRL+Z.
/G	Exibe os makefiles incluídos com a !INCLUDE diretiva. Para obter mais informações, consulte Diretivas de pré-processamento de makefile.
/HELP, /?	Exibe um breve resumo da sintaxe da linha de comando NMAKE.
/I	Ignora os códigos de saída de todos os comandos. Para definir ou limpar /I parte de um makefile, use !CMDSWITCHES. Para ignorar os códigos de saída de parte de um makefile, use um modificador de comando dash (-) ou .IGNORE. Substitui se ambos forem especificados /K .
/K	Continua criando dependências não relacionadas, se um comando retornar um erro. Também emite um aviso e retorna um código de saída de 1. Por padrão, o NMAKE para se algum comando retornar um código de saída diferente de zero. Os avisos de são suprimidos /K por /C; /I substitui se ambos forem especificados /K .
/N	Exibe mas não executa comandos; Os comandos de pré-processamento são executados. Não exibe comandos em chamadas NMAKE recursivas. Útil para depurar makefiles e verificar carimbos de data/hora. Para definir ou limpar /N parte de um makefile, use !CMDSWITCHES.
/NOLOGO	Suprime a mensagem de direitos autorais NMAKE.
/P	Exibe informações (definições de macro, regras de inferência, destinos, .SUFFIXES lista) para a saída padrão e, em seguida, executa a compilação. Se nenhum makefile ou destino de linha de comando existir, ele exibirá apenas informações. Use com /D para depurar um makefile.
/Q	Verifica carimbos de data/hora de metas; não executa a compilação. Retorna um código de saída zero se todos os destinos estiverem atualizados e um código de saída diferente de zero se algum destino estiver desatualizado. Os comandos de pré-processamento são executados. Útil ao executar NMAKE a partir de um arquivo em lotes.
/R	Limpa a .SUFFIXES lista e ignora regras de inferência e macros definidas no Tools.ini arquivo ou predefinidas.
/S	Suprime a exibição de comandos executados. Para suprimir a exibição em parte de um makefile, use o modificador de @ comando ou .SILENT. Para definir ou limpar /S parte de um makefile, use !CMDSWITCHES.
/T	Atualiza carimbos de data/hora de destinos de linha de comando (ou primeiro destino makefile) e executa comandos de pré-processamento, mas não executa a compilação.
/U	Deve ser usado em conjunto com /N. Despeja arquivos NMAKE embutidos para que a /N saída possa ser usada como um arquivo em lotes.
/X nome do arquivo	Envia a saída de erro NMAKE para o nome do arquivo em vez do erro padrão. Espaços ou guias podem preceder o nome do arquivo. Para enviar a saída de erro para a saída padrão, especifique um traço (-) para o nome do arquivo. Não afeta a saída dos comandos para o erro padrão.
/Y	Desabilita as regras de inferência em modo de lote. Quando essa opção é selecionada, todas as regras de inferência em modo de lote são tratadas como regras de inferência regulares.

Tools.ini e NMAKE

O NMAKE lê antes de Tools.ini ler makefiles, a menos que /R seja usado. Ele procura Tools.ini primeiro no diretório atual e, em seguida, no diretório especificado pela variável de ambiente INIT. A seção para configurações NMAKE no arquivo de inicialização começa com [NMAKE] e pode conter qualquer informação makefile. Especifique um comentário em uma linha separada que comece com um sinal numérico (#).

Códigos de saída do NMAKE

NMAKE retorna os seguintes códigos de saída:

Código	Significado
0	Nenhum erro (possivelmente um aviso)
1	Compilação incompleta (emitida apenas quando /K é usada)
2	Erro de programa, possivelmente causado por um destes problemas: - Um erro de sintaxe no makefile - Um erro ou código de saída de um comando - Uma interrupção por parte do utilizador
4	Erro do sistema — falta de memória
255	O destino não está atualizado (emitido apenas quando /Q é usado)

Ver também

Referência NMAKE