NMAKE Options
The latest version of this topic can be found at NMAKE Options.
NMAKE options are described in the following table. Options are preceded by either a slash (/) or a dash (–) and are not case sensitive. Use !CMDSWITCHES to change option settings in a makefile or in Tools.ini.
| Option | Purpose |
|---|---|
| /A | Forces build of all evaluated targets, even if not out-of-date with respect to dependents. Does not force build of unrelated targets. |
| /B | Forces build even if timestamps are equal. Recommended only for very fast systems (resolution of two seconds or less). |
| /C | Suppresses default output, including nonfatal NMAKE errors or warnings, timestamps, and NMAKE copyright message. Suppresses warnings issued by /K. |
| /D | Displays timestamps of each evaluated target and dependent and a message when a target does not exist. Useful with /P for debugging a makefile. Use !CMDSWITCHES to set or clear /D for part of a makefile. |
| /E | Causes environment variables to override makefile macro definitions. |
| /ERRORREPORT[NONE | PROMPT | QUEUE | SEND ] | If nmake.exe fails at runtime, you can use /ERRORREPORT to send information to Microsoft about these internal errors. For more information about /ERRORREPORT, see /errorReport (Report Internal Compiler Errors). |
/F filename |
Specifies filename as a makefile. Spaces or tabs can precede filename. Specify /F once for each makefile. To supply a makefile from standard input, specify a dash (–) for filename, and end keyboard input with either F6 or CTRL+Z. |
| /G | Displays the makefiles included with the !INCLUDE directive. See Makefile Preprocessing Directives for more information. |
| /HELP, /? | Displays a brief summary of NMAKE command-line syntax. |
| /I | Ignores exit codes from all commands. To set or clear /I for part of a makefile, use !CMDSWITCHES. To ignore exit codes for part of a makefile, use a dash (–) 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 halts 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 calls. Useful for debugging makefiles and checking timestamps. To set or clear /N for part of a makefile, use !CMDSWITCHES. |
| /NOLOGO | Suppresses the NMAKE copyright message. |
| /P | Displays information (macro definitions, inference rules, targets, .SUFFIXES list) to standard output, and then runs the build. If no makefile or command-line target exists, it displays information only. Use with /D to debug a makefile. |
| /Q | Checks timestamps of targets; 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. Preprocessing commands are executed. Useful when running NMAKE 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 display of executed commands. To suppress display in part of a makefile, use the @ command modifier or .SILENT. To set or clear /S for part of a makefile, use !CMDSWITCHES. |
| /T | Updates timestamps of command-line targets (or first makefile target) and executes preprocessing commands but does not run the build. |
| /U | Must be used in conjunction with /N. Dumps inline NMAKE files so that the /N output can be used as a batch file. |
/X filename |
Sends NMAKE error output to filename instead of standard error. Spaces or tabs can precede filename. To send error output to standard output, specify a dash (–) for filename. Does not affect output from commands to standard error. |
| /Y | Disables batch-mode inference rules. When this option is selected, all batch-mode inference rules are treated as regular inference rules. |