Az NMAKE futtatása

Szemantika

NMAKE [opció ...] [makrók ...] [célpontok ...] [@parancsfájl ...]

Megjegyzések

Az NMAKE-nek a fejlesztői parancssori ablakban kell futnia. A Fejlesztői parancssor ablak tartalmazza a parancssorban történő felépítéshez szükséges eszközökhöz, könyvtárakhoz beállított környezeti változókat, és tartalmazza a fájlelérési utakat. A fejlesztői parancssori ablakok megnyitásával kapcsolatos részletekért lásd: Az MSVC-eszközkészlet használata a parancssorból.

Az NMAKE csak a megadott célokat hozza létre, vagy ha nincs megadva, akkor a makefile első célját. Az első makefile cél lehet egy pszeudocél, amely más célokat épít. Az NMAKE az aktuális könyvtárban található Makefile fájllal megadott /Fmakefile-okat használja, vagy ha /F nincs megadva, akkor azt. Ha nincs megadva makefile, következtetési szabályokat használ a parancssori célok létrehozásához.

A parancsfájl szövegfájlja (vagy válaszfájlja) parancssori bemenetet tartalmaz. Más bemenet megelőzheti vagy követheti @command-file. Az útvonal megengedett. A parancsfájlban a sortöréseket szóközökként kezeli a rendszer. A makródefiníciókat idézőjelek közé kell tenni, ha szóközöket tartalmaznak.

NMAKE opciók

Az NMAKE beállításait az alábbi táblázat ismerteti. A beállításokat perjel (/) vagy kötőjel (-) előzi meg, és nem különbözteti meg a kis- és nagybetűket. A beállítási !CMDSWITCHES beállítások módosítására használható egy makefile-ban vagy a .Tools.ini

Lehetőség	Cél
/A	Az erők minden értékelt célpontból épülnek fel, még akkor is, ha nem elavultak az eltartottakhoz képest. Nem kényszeríti a nem kapcsolódó célok összeállítását.
/B	Az erők akkor is növekednek, ha az időbélyegek egyenlőek. Csak gyors rendszerekhez ajánlott (legfeljebb két másodperces felbontás).
/C	Letiltja az alapértelmezett kimenetet, beleértve a nem végzetes NMAKE hibákat vagy figyelmeztetéseket, az időbélyegeket és az NMAKE szerzői jogi üzenetét. Letiltja a ./K
/D	Megjeleníti az egyes kiértékelt és függő célok időbélyegeit, valamint egy üzenetet, ha nem létezik cél. Hasznos /P a makefile hibakereséséhez. A makefile egy részének beállítására vagy törlésére !CMDSWITCHES használható/D.
/E	A környezeti változók felülbírálják a makefile makródefiníciókat.
/ERRORREPORT[ NONE | PROMPT | QUEUE | SEND]	Elavult vagy megszüntetett. A Windows hibajelentés (WER) beállításai vezérlik a jelentéskészítést.
/F fájlnév	A fájlnevet makefile-ként adja meg. A szóközök vagy tabulátorok megelőzhetik a fájlnevet. Adjon meg /F egyszer minden makefile-hoz. Ha szabványos bemenetből szeretne makefájlt adni, adjon meg egy kötőjelet (-) a fájlnévhez, és fejezze be a billentyűzetbevitelt az F6 vagy a CTRL+Z billentyűkombinációval.
/G	Megjeleníti az !INCLUDE irányelvhez mellékelt makefile-okat. További információ: Makefile előfeldolgozási irányelvek.
/HELP, /?	Megjeleníti az NMAKE parancssori szintaxisának rövid összefoglalását.
/I	Figyelmen kívül hagyja az összes parancs kilépési kódjait. A makefile egy részének beállításához vagy törléséhez /I használja a .!CMDSWITCHES Ha figyelmen kívül szeretné hagyni a makefile egy részének kilépési kódjait, használja a kötőjel (-) parancsmódosítót vagy a .IGNORE. Felülbírálások /K , ha mindkettő meg van adva.
/K	Folytatja a nem kapcsolódó függőségek kiépítését, ha egy parancs hibát ad vissza. Figyelmeztetést is kiad, és 1-es kilépési kódot ad vissza. Alapértelmezés szerint az NMAKE leáll, ha bármelyik parancs nem nulla kilépési kódot ad vissza. A figyelmeztetéseket /K a /C; /I felülbírálja, /K ha mindkettő meg van adva.
/N	Megjeleníti, de nem hajtja végre a parancsokat; előfeldolgozási parancsok végrehajtása megtörténik. Nem jeleníti meg a parancsokat a rekurzív NMAKE-hívásokban. Hasznos a makefile-ok hibakereséséhez és az időbélyegek ellenőrzéséhez. A makefile egy részének beállításához vagy törléséhez /N használja a .!CMDSWITCHES
/NOLOGO	Letiltja az NMAKE szerzői jogi üzenetét.
/P	Információkat (makródefiníciókat, következtetési szabályokat, célokat, .SUFFIXES listát) jelenít meg a szabványos kimeneten, majd futtatja a buildet. Ha nincs makefile vagy parancssori cél, akkor csak az információkat jeleníti meg. Használja a with /D segítségével egy make file hibakereséséhez.
/Q	Ellenőrzi a célpontok időbélyegét; nem futtatja a buildet. Nulla kilépési kódot ad vissza, ha az összes cél naprakész, és egy nem nulla kilépési kódot, ha valamelyik cél elavult. Az előfeldolgozási parancsok végrehajtása megtörténik. Hasznos, ha az NMAKE-t kötegfájlból futtatja.
/R	Törli a .SUFFIXES listát, és figyelmen kívül hagyja a Tools.ini fájlban definiált vagy előre definiált következtetési szabályokat és makrókat.
/S	Letiltja a végrehajtott parancsok megjelenítését. A makefile egy részének megjelenítésének letiltásához használja a parancsmódosítót vagy a @.SILENT. A makefile egy részének beállításához vagy törléséhez /S használja a .!CMDSWITCHES
/T	Frissíti a parancssori célok (vagy az első makefile-cél) időbélyegeit, és végrehajtja az előfeldolgozási parancsokat, de nem futtatja a buildet.
/U	A készülékkel /Negyütt kell használni. Beágyazott NMAKE-fájlokat ír ki, hogy a /N kimenet kötegfájlként használható legyen.
/X fájlnév	Az NMAKE hibakimenetet a fájlnévre küldi a standard hiba helyett. A szóközök vagy tabulátorok megelőzhetik a fájlnevet. Ha hibakimenetet szeretne küldeni a szabványos kimenetre, adjon meg egy kötőjelet (-) a fájlnévhez. Nem befolyásolja a parancsok kimenetét a standard hibára.
/Y	Letiltja a kötegelt módú következtetési szabályokat. Ha ez a beállítás be van jelölve, a rendszer az összes kötegelt módú következtetési szabályt normál következtetési szabályként kezeli.

Tools.ini és NMAKE

Az NMAKE beolvassa Tools.ini a makefile-ok olvasását, hacsak nem /R használják. Először az aktuális könyvtárban, majd az INIT környezeti változó által megadott könyvtárban keres.Tools.ini Az inicializálási fájl NMAKE beállításainak szakasza a következővel [NMAKE] kezdődik, és bármilyen makefile információt tartalmazhat. Adjon meg egy megjegyzést egy számjellel ()# kezdődő külön sorhoz.

Kilépési kódok az NMAKE-ből

Az NMAKE a következő kilépési kódokat adja vissza:

Kód	Értelmezés
0	Nincs hiba (esetleg figyelmeztetés)
1	Hiányos build (csak használat esetén /K adják ki)
2	Programhiba, amelyet valószínűleg az alábbi problémák egyike okoz: - Szintaktikai hiba a makefile-ban - Hiba vagy kilépési kód egy parancsból - A felhasználó megszakítása
4	Rendszerhiba – elfogyott a memória
255	A cél nem naprakész (csak használat esetén /Q van kiadva)

Lásd még

NMAKE referencia