Spuštění příkazu NMAKE
Syntaxe
NMAKE[možnost ...] [makra ...] [cíle ...] [@command-file ...]
Poznámky
Nástroj NMAKE sestaví pouze zadané cíle , nebo pokud není zadán žádný, první cíl v souboru pravidel. První cíl souboru pravidel může být pseudotarget , který vytváří další cíle. Nástroj NMAKE používá makefile zadané v /Fadresáři nebo pokud /F není zadaný, soubor makefile v aktuálním adresáři. Pokud není zadaný žádný soubor pravidel, používá pravidla odvození k sestavení cílů příkazového řádku.
Textový soubor příkazového souboru (nebo soubor odpovědi) obsahuje vstup příkazového řádku. Jiný vstup může předcházet nebo sledovat @command-file. Je povolená cesta. V příkazovém souboru se konce řádků považují za mezery. Definice maker uzavřete do uvozovek, pokud obsahují mezery.
NMAKE – možnosti
Možnosti nástroje NMAKE jsou popsány v následující tabulce. Před možnostmi se používá lomítko (/) nebo pomlčka (-) a nerozlišují se malá a velká písmena. Slouží !CMDSWITCHES ke změně nastavení možností v souboru pravidel nebo v Tools.inisouboru .
| Možnost | Účel |
|---|---|
/A |
Vynutí sestavení všech vyhodnocených cílů, i když není aktuální ve srovnání se závislými. Nevynucuje sestavení nesouvisejících cílů. |
/B |
Vynutí sestavení i v případě, že jsou časová razítka rovna. Doporučeno pouze pro rychlé systémy (rozlišení dvou sekund nebo méně). |
/C |
Potlačí výchozí výstup, včetně chyb nebo upozornění nástroje NMAKE, časových razítek a zpráv o autorských právech nástroje NMAKE. Potlačí upozornění vystavená příkazem /K. |
/D |
Zobrazí časové razítka každého vyhodnoceného cíle a závislého objektu a zprávu, pokud cíl neexistuje. Užitečné při /P ladění souboru pravidel. Slouží !CMDSWITCHES k nastavení nebo vymazání /D pro část souboru pravidel. |
/E |
Způsobí, že proměnné prostředí přepíší definice maker v souboru pravidel. |
/ERRORREPORT[ ] NONE | PROMPT | QUEUE | SEND |
Zastaralé sestavy ovládacích prvků nastavení Zasílání zpráv o chybách systému Windows (WER). |
/Fjméno souboru |
Určuje název souboru jako soubor pravidel. Názvy názvů mohou předcházet mezery nebo tabulátory. Zadejte /F jednou pro každý soubor pravidel. Pokud chcete zadat soubor pravidel ze standardního vstupu, zadejte pro název souboru pomlčku (-) a ukončete vstup klávesnice pomocí kláves F6 nebo CTRL+Z. |
/G |
Zobrazí soubory pravidel, které jsou součástí direktivy !INCLUDE . Další informace naleznete v tématu Direktivy předběžného zpracování souboru pravidel. |
/HELP, /? |
Zobrazí stručný souhrn syntaxe příkazového řádku NMAKE. |
/I |
Ignoruje ukončovací kódy ze všech příkazů. Chcete-li nastavit nebo vymazat /I pro část souboru pravidel, použijte !CMDSWITCHES. Chcete-li ignorovat ukončovací kódy pro část souboru pravidel, použijte modifikátor příkazu pomlčky nebo-.IGNORE . Přepíše, pokud jsou zadány /K oba. |
/K |
Pokračuje v sestavování nesouvisejících závislostí, pokud příkaz vrátí chybu. Také vydá upozornění a vrátí ukončovací kód 1. Ve výchozím nastavení se NMAKE zastaví, pokud některý příkaz vrátí nenulový ukončovací kód. Upozornění jsou /K potlačena /C/I ; přepsání, pokud jsou zadány /K oba. |
/N |
Zobrazí, ale nespustí příkazy; Příkazy předběžného zpracování se spustí. Nezobrazuje příkazy v rekurzivních voláních NMAKE. Užitečné pro ladění souborů pravidel a kontroly časových razítek. Chcete-li nastavit nebo vymazat /N pro část souboru pravidel, použijte !CMDSWITCHES. |
/NOLOGO |
Potlačí zprávu NMAKE o autorských právech. |
/P |
Zobrazí informace (definice maker, pravidla odvození, cíle, .SUFFIXES seznam) do standardního výstupu a pak spustí sestavení. Pokud neexistuje žádný soubor pravidel nebo cíl příkazového řádku, zobrazí pouze informace. /D Slouží k ladění souboru pravidel. |
/Q |
Kontroluje časové razítka cílů; nespustí sestavení. Vrátí nulový ukončovací kód, pokud jsou všechny cíle aktuální, a nenulový ukončovací kód, pokud je některý cíl zastaralý. Spouští se příkazy předběžného zpracování. Užitečné při spouštění nástroje NMAKE z dávkového souboru. |
/R |
Vymaže .SUFFIXES seznam a ignoruje pravidla odvozování a makra definovaná v Tools.ini souboru nebo předdefinovaná. |
/S |
Potlačí zobrazení spouštěných příkazů. Chcete-li potlačit zobrazení v části souboru pravidel, použijte @ modifikátor příkazu nebo .SILENT. Chcete-li nastavit nebo vymazat /S pro část souboru pravidel, použijte !CMDSWITCHES. |
/T |
Aktualizuje časové razítka cílů příkazového řádku (nebo prvního cíle souboru pravidel) a spouští příkazy předběžného zpracování, ale nespustí sestavení. |
/U |
Musí být použita ve spojení s /N. Vypíše vložené soubory NMAKE, aby /N se výstup mohl použít jako dávkový soubor. |
/Xjméno souboru |
Místo standardní chyby odešle výstup chyby NMAKE do názvu souboru . Názvy názvů mohou předcházet mezery nebo tabulátory. Pokud chcete odeslat výstup chyby do standardního výstupu, zadejte pomlčku (-) pro název souboru. Nemá vliv na výstup z příkazů na standardní chybu. |
/Y |
Zakáže pravidla odvozování dávkového režimu. Při výběru této možnosti se všechna pravidla odvozování v dávkovém režimu považují za běžná pravidla odvozování. |
Tools.ini a příkaz NMAKE
Nástroj NMAKE čte Tools.ini před čtením souborů pravidel, pokud /R se nepoužívá. Nejprve vyhledá Tools.ini v aktuálním adresáři a potom v adresáři určeném proměnnou prostředí INIT. Oddíl nastavení nástroje NMAKE v inicializačním souboru začíná [NMAKE] a může obsahovat jakékoli informace o souboru pravidel. Zadejte komentář na samostatném řádku začínajícím znaménkem čísla (#).
Kódy ukončení příkazu NMAKE
NMAKE vrátí následující ukončovací kódy:
| Kód | Význam |
|---|---|
| 0 | Žádná chyba (pravděpodobně upozornění) |
| 0 | Nekompletní sestavení (vydané pouze při /K použití) |
| 2 | Chyba programu, pravděpodobně způsobená jedním z těchto problémů: – Chyba syntaxe v souboru pravidel – Chyba nebo ukončení kódu z příkazu - Přerušení uživatelem |
| 4 | Systémová chyba – nedostatek paměti |
| 255 | Cíl není aktuální (vystaven pouze při /Q použití) |