NMAKE の実行
構文
NMAKE[option ...] [macros ...] [targets ...] [@command-file ...]
解説
NMAKE を使用すると、指定された "ターゲット" のみがビルドされます。何も指定されていない場合は、メイクファイル内の最初のターゲットがビルドされます。 最初のメイクファイル ターゲットは、他のターゲットをビルドする pseudotarget にすることができます。 NMAKE では、/F で指定されたメイクファイルを使用します。/F が指定されていない場合は、現在のディレクトリにあるメイクファイル ファイルを使用します。 メイクファイルが指定されていない場合は、推論規則を使用してコマンドラインの "ターゲット" が作成されます。
command-file テキスト ファイル (または応答ファイル) には、コマンドライン入力が含まれています。 その他の入力は、@command-file の前または後に置くことができます。 パスは許可されています。 command-file では、改行はスペースとして扱われます。 マクロ定義にスペースが含まれている場合は、引用符で囲みます。
NMAKE のオプション
NMAKE のオプションの説明を次の表に示します。 オプションの前にはスラッシュ (/) またはダッシュ (-) が付いており、大文字と小文字は区別されません。 メイクファイルまたは Tools.ini でオプション設定を変更するには、!CMDSWITCHES を使用します。
| オプション | 目的 |
|---|---|
/A |
従属部分と比較して古くなっていない場合でも、評価されたすべてのターゲットのビルドを強制的に実行します。 関連のないターゲットのビルドを強制しません。 |
/B |
タイムスタンプが等しい場合でもビルドを強制的に実行します。 高速なシステム (解像度が 2 秒以下) に対してのみ推奨されます。 |
/C |
致命的でない NMAKE のエラーや警告、タイムスタンプ、NMAKE の著作権メッセージなどの既定の出力が表示されなくなります。 /K によって発行された警告が表示されなくなります。 |
/D |
ターゲットが存在しないときは、評価対象の各ターゲットと従属部分のタイムスタンプと、メッセージを表示します。 /P でメイクファイルのデバッグに役立ちます。 メイクファイルの一部の /D を設定またはクリアするには、!CMDSWITCHES を使用します。 |
/E |
環境変数によってメイクファイルのマクロ定義がオーバーライドされます。 |
| 削除されました。 Windows エラー報告 (WER) の設定によってレポートが制御されます。 | |
/F filename |
filename をメイクファイルとして指定します。 filename の前にスペースまたはタブが付く場合があります。 各メイクファイルに /F を 1 回指定します。 標準入力からメイクファイルを指定するには、filename にダッシュ (-) を指定し、F6 キーまたは CTRL+Z キーのいずれかを押してキーボード入力を終了します。 |
/G |
!INCLUDE ディレクティブに含まれるメイクファイルを表示します。 詳細については、「メイクファイルのプリプロセス ディレクティブ」を参照してください。 |
| $ | NMAKE コマンド ライン構文の簡単な説明を表示します。 |
/I |
すべてのコマンドの終了コードを無視します。 メイクファイルの一部の /I を設定またはクリアするには、!CMDSWITCHES を使用します。 メイクファイルの一部の終了コードを無視するには、ダッシュ (-) コマンド修飾子または .IGNORE を使用します。 両方が指定されている場合は、/K をオーバーライドします。 |
/K |
コマンドでエラーが返された場合、関連のない依存関係の作成を続行します。 また、警告を発行し、1 の終了コードを返します。 既定では、コマンドから 0 以外の終了コードが返されると、NMAKE は停止します。 /K からの警告は /C によって表示されなくなります。両方が指定されている場合は、/I が /K をオーバーライドします。 |
/N |
コマンドは表示されますが、実行されません。プリプロセス コマンドは実行されます。 再帰的な NMAKE 呼び出しでコマンドは表示されません。 メイクファイルのデバッグとタイムスタンプのチェックに便利です。 メイクファイルの一部の /N を設定またはクリアするには、!CMDSWITCHES を使用します。 |
/NOLOGO |
NMAKE の著作権メッセージが表示されなくなります。 |
/P |
情報 (マクロの定義、推論規則、ターゲット、.SUFFIXES リスト) を標準出力に表示してから、ビルドを実行します。 メイクファイルもコマンドライン ターゲットも存在しない場合は、情報のみが表示されます。 メイクファイルをデバッグするには、/D と共に使用します。 |
/Q |
ターゲットのタイムスタンプをチェックします。ビルドは実行しません。 すべてのターゲットが最新の場合はゼロの終了コードを返し、ターゲットが古い場合はゼロ以外の終了コードを返します。 プリプロセス コマンドが実行されます。 バッチ ファイルから NMAKE を実行するときに便利です。 |
/R |
.SUFFIXES リストをクリアし、Tools.ini ファイルで定義されている、または事前に定義されている推論規則とマクロを無視します。 |
/S |
実行されたコマンドが表示されなくなります。 メイクファイルの一部で表示されないようにするには、@ コマンド修飾子または .SILENT を使用します。 メイクファイルの一部の /S を設定またはクリアするには、!CMDSWITCHES を使用します。 |
/T |
コマンドライン ターゲット (または最初のメイクファイル ターゲット) のタイムスタンプを更新し、プリプロセス コマンドを実行しますが、ビルドは実行しません。 |
/U |
/N と組み合わせて使用する必要があります。 /N の出力をバッチ ファイルとして使用できるように、NMAKE のインライン ファイルをダンプします。 |
/X filename |
filename に標準エラーの代わりに NMAKE のエラー出力を送信します。 filename の前にスペースまたはタブが付く場合があります。 標準出力にエラー出力を送信するには、filename にダッシュ (-) を指定します。 コマンドから標準エラーへの出力には影響しません。 |
/Y |
バッチモード推論規則を無効にします。 このオプションが選択されると、すべてのバッチ モード推論規則が通常の推論規則として扱われます。 |
Tools.ini と NMAKE
/R が使用されない限り、NMAKE ではメイクファイルを読み取る前に Tools.ini を読み取ります。 現在のディレクトリで最初に Tools.ini を検索し、次に INIT 環境変数で指定されたディレクトリで検索します。 初期化ファイルの NMAKE 設定のセクションは [NMAKE] で始まり、任意のメイクファイル情報を含めることができます。 シャープ記号 (#) で始まる別の行にコメントを指定します。
NMAKE で返される終了コード
NMAKE で次の終了コードが返されます。
| コード | 意味 |
|---|---|
| 0 | エラーなし (警告の可能性あり) |
| 1 | 不完全なビルド (/K が使用されている場合にのみ発行される) |
| 2 | プログラム エラー。次のいずれかの問題が原因で発生する可能性があります。 - メイクファイルの構文エラー - コマンドからのエラーまたは終了コード - ユーザーによる中断 |
| 4 | システム エラー - メモリ不足 |
| 255 | ターゲットが最新でない (/Q が使用されている場合にのみ発行される) |