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. |