Uruchomienie NMAKE

Składnia

NMAKE [opcja ...] [makra ...] [cele ...] [@plik-polecenia ...]

Uwagi

NMAKE kompiluje tylko określone elementy docelowe lub, gdy żaden z nich nie jest określony, pierwszy element docelowy w pliku make. Pierwszy element docelowy pliku make może być pseudotargetem , który tworzy inne obiekty docelowe. Narzędzie NMAKE używa plików make określonych w elemencie /F, lub jeśli /F nie zostanie określony, plik makefile w bieżącym katalogu. Jeśli nie określono pliku make, używa reguł wnioskowania do kompilowania obiektów docelowych wiersza polecenia.

Plik tekstowy pliku polecenia (lub plik odpowiedzi) zawiera dane wejściowe wiersza polecenia. Inne dane wejściowe mogą poprzedzać plik @command-file lub postępować zgodnie z nim. Dozwolona jest ścieżka. W pliku polecenia podziały wierszy są traktowane jako spacje. Ujęć definicje makr w cudzysłowach, jeśli zawierają spacje.

Opcje NMAKE

Opcje NMAKE zostały opisane w poniższej tabeli. Opcje są poprzedzone ukośnikiem (/) lub kreską (-) i nie są uwzględniane wielkości liter. Użyj !CMDSWITCHES polecenia , aby zmienić ustawienia opcji w pliku make lub w Tools.inipliku .

Opcja Cel
/A Wymusza tworzenie wszystkich ocenianych celów, nawet jeśli nie są nieaktualne w porównaniu z zależnościami. Nie wymusza kompilacji niepowiązanych celów.
/B Wymusza kompilację, nawet jeśli znaczniki czasu są równe. Zalecane tylko w przypadku szybkich systemów (rozdzielczość dwóch sekund lub mniej).
/C Pomija domyślne dane wyjściowe, w tym niekrytyczne błędy NMAKE lub ostrzeżenia, znaczniki czasu i komunikat praw autorskich NMAKE. Pomija ostrzeżenia wydane przez /Kprogram .
/D Wyświetla znaczniki czasu każdej ocenianej wartości docelowej i zależnej oraz komunikat, gdy obiekt docelowy nie istnieje. Przydatne w /P przypadku debugowania pliku make. Użyj !CMDSWITCHES polecenia , aby ustawić lub wyczyścić /D część pliku make.
/E Powoduje zastąpienie definicji makr pliku makefile przez zmienne środowiskowe.
/ERRORREPORT [ NONE | PROMPT | QUEUE | SEND ] Przestarzałe. Raportowanie błędów systemu Windows (WER) — raportowanie kontrolek ustawień.
/FPod nazwą Określa nazwę pliku jako plik make. Spacje lub karty mogą poprzedzać nazwę pliku. Określ /F raz dla każdego pliku make. Aby podać plik make z standardowych danych wejściowych, określ kreskę (-) dla nazwy pliku i końcowe wejście klawiatury za pomocą klawiszy F6 lub CTRL+Z.
/G Wyświetla pliki makefile dołączone do !INCLUDE dyrektywy . Aby uzyskać więcej informacji, zobacz Makefile preprocessing dyrektywy.
/HELP, /? Przedstawia krótkie podsumowanie składni wiersza polecenia NMAKE.
/I Ignoruje kody zakończenia ze wszystkich poleceń. Aby ustawić lub wyczyścić /I część pliku make, użyj polecenia !CMDSWITCHES. Aby zignorować kody zakończenia dla części pliku make, użyj modyfikatora poleceń kreski (-) lub .IGNORE. Przesłonięcia /K , jeśli określono oba te ustawienia.
/K Kontynuuje tworzenie niepowiązanych zależności, jeśli polecenie zwraca błąd. Ponadto wyświetla ostrzeżenie i zwraca kod zakończenia 1. Domyślnie NMAKE zatrzymuje się, jeśli jakiekolwiek polecenie zwraca kod zakończenia niezerowy. Ostrzeżenia z /K funkcji są pomijane przez /Cparametr ; /I przesłonięcia /K , jeśli określono oba te elementy.
/N Wyświetla, ale nie wykonuje poleceń; Wykonywane są polecenia przetwarzania wstępnego. Nie wyświetla poleceń w cyklicznych wywołaniach NMAKE. Przydatne do debugowania plików makefile i sprawdzania sygnatur czasowych. Aby ustawić lub wyczyścić /N część pliku make, użyj polecenia !CMDSWITCHES.
/NOLOGO Pomija komunikat O prawach autorskich NMAKE.
/P Wyświetla informacje (definicje makr, reguły wnioskowania, obiekty docelowe, .SUFFIXES listę) do standardowych danych wyjściowych, a następnie uruchamia kompilację. Jeśli nie istnieje element docelowy pliku make lub wiersza polecenia, wyświetla tylko informacje. Użyj polecenia , /D aby debugować plik make.
/Q Sprawdza znaczniki czasu obiektów docelowych; nie uruchamia kompilacji. Zwraca kod zakończenia zero, jeśli wszystkie obiekty docelowe są aktualne, a kod zakończenia niezerowy, jeśli jakikolwiek element docelowy jest nieaktualny. Wykonywane są polecenia przetwarzania wstępnego. Przydatne podczas uruchamiania narzędzia NMAKE z pliku wsadowego.
/R Czyści .SUFFIXES listę i ignoruje reguły wnioskowania i makra zdefiniowane w Tools.ini pliku lub które są wstępnie zdefiniowane.
/S Pomija wyświetlanie wykonanych poleceń. Aby pominąć wyświetlanie w części pliku make, użyj @ modyfikatora poleceń lub .SILENT. Aby ustawić lub wyczyścić /S część pliku make, użyj polecenia !CMDSWITCHES.
/T Aktualizacje sygnatury czasowe obiektów docelowych wiersza polecenia (lub pierwszego elementu docelowego pliku makefile) i wykonuje polecenia przetwarzania wstępnego, ale nie uruchamia kompilacji.
/U Należy używać w połączeniu z /N. Zrzuty wbudowanych plików NMAKE, /N dzięki czemu dane wyjściowe mogą być używane jako plik wsadowy.
/XPod nazwą Wysyła dane wyjściowe błędu NMAKE do nazwy pliku zamiast błędu standardowego. Spacje lub karty mogą poprzedzać nazwę pliku. Aby wysłać dane wyjściowe błędu do standardowych danych wyjściowych, określ kreskę (-) dla nazwy pliku. Nie ma wpływu na dane wyjściowe poleceń do standardowego błędu.
/Y Wyłącza reguły wnioskowania w trybie wsadowym. Po wybraniu tej opcji wszystkie reguły wnioskowania w trybie wsadowym są traktowane jako zwykłe reguły wnioskowania.

Tools.ini i NMAKE

Program NMAKE odczytuje Tools.ini przed odczytaniem plików make, chyba że /R jest używany. Szuka Tools.ini najpierw w bieżącym katalogu, a następnie w katalogu określonym przez zmienną środowiskową INIT. Sekcja ustawień NMAKE w pliku inicjowania rozpoczyna się od [NMAKE] i może zawierać dowolne informacje o pliku makefile. Określ komentarz w osobnym wierszu rozpoczynającym się od znaku numeru (#).

Kody zakończenia z NMAKE

NMAKE zwraca następujące kody zakończenia:

Kod Znaczenie
0 Brak błędu (ewentualnie ostrzeżenie)
1 Niekompletna kompilacja (wystawiona tylko wtedy, gdy /K jest używana)
2 Błąd programu, prawdopodobnie spowodowany jednym z następujących problemów:
- Błąd składni w pliku makefile
— Błąd lub kod zakończenia polecenia
— Przerwa w działaniu użytkownika
4 Błąd systemowy — brak pamięci
255 Element docelowy nie jest aktualny (wystawiony tylko wtedy, gdy /Q jest używany)

Zobacz też

NMAKE — dokumentacja