Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Nmake tool (Nmake.exe) is a 32-bit tool that you use to build projects based on commands contained in a .mak file.
The following example shows the syntax for Nmake.exe.
NMAKE [option] [macros] [targets] [@CommandFile]
Nmake.exe builds only specified targets or, if none are specified, the first target in the .mak file. The first .mak file target can be a pseudotarget that builds other targets. Nmake.exe uses .mak files specified with /F; if /F is not specified, it uses the .mak file in the current directory. If no .mak file is specified, Nmake.exe uses inference rules to build command-line targets.
The CommandFile text file contains command-line input. Other input can precede or follow @CommandFile. A path is permitted. In CommandFile, line breaks are treated as spaces. Enclose macro definitions in quotation marks (" ") if they contain spaces.
Nmake.exe options are preceded by either a slash mark (/) or a hyphen (-) and are not case-sensitive. Use !CMDSWITCHES to change option settings in a .mak file or in Tools.ini.
The following table shows available Nmake.exe options.
| Option | Description |
|---|---|
| /A | Forces a build of all evaluated targets, even if the targets are not out-of-date with respect to dependents. Does not force a build of unrelated targets. |
| /B | Forces a build even if the time stamps are equal. Recommended only for very fast systems with a resolution of two seconds or less. |
| /C | Suppresses default output, including nonfatal Nmake.exe errors or warnings, time stamps, and the Nmake.exe copyright message. Suppresses warnings issued by /K. |
| /D | Displays the time stamps of each evaluated target and dependent and a message when a target does not exist. Useful with /P for debugging a .mak file. Use !CMDSWITCHES to set or clear /D for part of a .mak file. |
| /E | Causes environment variables to override .mak file macro definitions. |
| /Ffilename | Specifies filename as a .mak file. Spaces or tabs can precede filename. Specify /F once for each .mak file. To supply a .mak file from standard input, specify a hyphen (-) for filename. To end keyboard input, press F6 or CTRL+Z. |
| /HELP, /? | Displays a brief summary of Nmake.exe command-line syntax. |
| /I | Ignores exit codes from all commands. To set or clear /I for part of a .mak file, use !CMDSWITCHES. To ignore exit codes for part of a .mak file, use a hyphen (-) command modifier or .IGNORE. Overrides /K if both are specified. |
| /K | Continues building unrelated dependencies, if a command returns an error. Also issues a warning and returns an exit code of 1. By default, Nmake.exe stops if any command returns a nonzero exit code. Warnings from /K are suppressed by /C. /I overrides /K if both are specified. |
| /N | Displays, but does not execute, commands. Preprocessing commands are executed. Does not display commands in recursive Nmake.exe calls. Useful for debugging .mak files and checking time stamps. To set or clear /N for part of a .mak file, use !CMDSWITCHES. |
| /NOLOGO | Suppresses the Nmake.exe copyright message. |
| /P | Displays information, such as macro definitions, inference rules, targets, and .SUFFIXES list, to standard output, and then runs the build. If no .mak file or command-line target exists, it displays information only. Use with /D to debug a .mak file. |
| /Q | Checks the time stamps of targets, but does not run the build. Returns a zero exit code if all targets are up-to-date and a nonzero exit code if any target is not up-to-date. Preprocessing commands are executed. Useful when running Nmake.exe from a batch file. |
| /R | Clears the .SUFFIXES list and ignores inference rules and macros that are defined in the Tools.ini file or that are predefined. |
| /S | Suppresses the display of executed commands. To suppress the display in part of a .mak file, use the @ command modifier or .SILENT. To set or clear /S for part of a .mak file, use !CMDSWITCHES. |
| /T | Updates the time stamps of command-line targets, or the first .mak file target, and executes preprocessing commands, but does not run the build. |
| /U | Must be used in conjunction with /N. Dumps inline Nmake.exe files so that the /N output can be used as a batch file. |
| /X | Sends Nmake.exe error output to filename instead of to a standard error output. Spaces or tabs can precede filename. To send standard error output, specify a hyphen (-) for filename. Does not affect output from commands to standard error output. |
| /Y | Disables batch-mode inference rules. When this option is selected, all batch-mode inference rules are treated as regular inference rules. |
Nmake.exe reads Tools.ini before it reads .mak files, unless /R is used. It looks for Tools.ini first in the current directory and then in the directory specified by the INIT environment variable. The section for Nmake.exe settings in the initialization file begins with [NMAKE] and can contain any .mak file information. Specify a comment on a separate line beginning with a number sign (#).
The following table shows Nmake.exe exit codes.
| Exit code | Description |
|---|---|
| 0 | No error, but possibly a warning. |
| 1 | Incomplete build. This code is issued only when /K is used. |
| 2 | Program error, possibly due to one of the following problems:
|
| 4 | System error indicating that that the system is out of memory. |
| 255 | Target is not up-to-date. This error is issued only when /Q is used. |
Build Phases | Build Tool | Sysgen Tool | Makefile File
Last updated on Friday, October 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.