Build Catalyst 的介面是名為 rafmake 的 make 公用程式。此介面具有多種可控制其行為的選項。
指令的語法視作業系統而定,如下列表格所示。
作業系統 | 選項 |
---|---|
Linux 和 Solaris(建置目標。) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –B bldhost-file ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ] |
Windows(建置目標。) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ] |
全部(顯示 rafmake 公用程式的版本資訊。) | rafmake { -ver/sion | -VerAll } |
rafmake 指令支援 GNU 3.80 版 make 指令大部分的一般選項。rafmake 指令也提供其他選項。
選項 | 說明 |
---|---|
-f makefile | 將 make 檔當作輸入檔使用。如果您省略這個選項,rafmake 指令會在現行工作目錄中,尋找名為 makefile 和 Makefile(依此順序)的輸入檔。您可以指定 1 個以上的 -f makefile 引數配對。多個輸入檔是有效連接的。 |
-u | (無條件)重建所有指定的目標和其所有相依關係,不論是否需要重建它們。(另請參閱 -U。) |
-k | 現行項目上的工作如果失敗了,就予以放棄,但繼續執行其他不依賴該項目的目標。 |
-i | 忽略指令傳回的錯誤代碼。 |
-n | (不執行)針對需要重建的目標,列出其 make 檔中的指令行,包含開頭為 at 符號 (@) 的 指令行,但不加以執行。異常狀況:包含字串 $(MAKE) 的指令一律會執行。 |
-s | (無聲自動)不在執行指令行前先列示出來。 |
-e | 環境變數置換 makefile 檔中的巨集指定。(然而,指令行或建置選項規格中的 macro=value 指定會置換環境變數。) |
-r | (沒有規則)不使用 buildcatalyst-home-dir/etc/builtin.mk 檔(Linux 和 Solaris)或是buildcatalyst-home-dir\etc\builtin.mk 檔 (Windows) 中的內建規則。和 -c 選項一起使用時,-r 選項也會停用平台特定啟動檔案的讀取。如需相關資訊,請參閱 -c 選項。 |
-v | (詳細)比預設的輸出模式略為詳細。 |
-w | (工作目錄)列印包含執行 make 檔之前及之後的工作目錄的訊息。 |
-d | (除錯)相當詳細,並包含 rafmake 指令在建置期間所讀取的環境變數的清單。只有在為 Make 檔進行除錯時,才使用這個選項。 |
-p | (列印)列出全部的目標說明及巨集定義,包含目標特定的巨集定義及隱含的規則。不執行任何指令。 |
-q | (查詢)對 make 檔目標求值,但不執行建置 Script。rafmake 指令傳回下列其中一個回應:
|
-U | 僅無條件地重建主要目標 (goal target)。不建置子目標。如果您未在指令行指定任何目標,則預設目標就是主要目標。(-u 選項會無條件地建置主要目標和建置相依關係。) |
-N | 停用讀取一或多個建置選項規格 (BOS) 檔的預設程序。 |
-J num | 啟用平行建置功能。同時發生的目標重建數目上限設為整數 num。如果 num=0,平行建置就會停用。(這等於不指定 -J 選項。)或者,您可以將 num 指定為 RAFMAKE_CONC 環境變數的值。 |
-B bldhost-file | 將 bldhost-file 檔當作平行建置的建置 hosts 檔使用。如果您不指定 -B 選項,rafmake 指令會使用您起始目錄中的 .bldhost.$RAFMAKE_HOST_TYPE 檔。當您使用 -B 選項時,必須也使用 -J 選項或是設定 RAFMAKE_CONC 環境變數。 |
-c compat-mode | (相容性)以相容模式呼叫 rafmake 指令。 (或者,您可以使用 RAFMAKE_COMPAT 環境 變數來指定相容模式。) 您可以將 compat-mode 變數設為下列其中一個值:
compat-mode 變數也可以具有下列其中一個值(僅適用於 Linux 和 Solaris 系統)。-c 選項可在不同的 Linux 和 Solaris 平台上執行。然而,有些模式會嘗試讀取系統特定的檔案;如果這些檔案不存在,則指令會失敗。
|
-C dir | 變更目錄。rafmake 指令會在啟動建置前,變更至 dir 目錄。 |
-A BOS-file | 指定在依預設讀取的 BOS 檔案之後,接著立即要讀取的 BOS 檔案。您可以多次使用這個選項,指定多個 BOS 檔案。 如果您對這個選項使用 -N,rafmake 會讀取指定的 BOS 檔,而非預設的 BOS 檔。 或者,您也可以針對 BOS 檔案路徑名稱,指定以冒號區隔的清單(適用於 Linux 和 Solaris)或是以分號區隔的清單,作為環境變數 RAFMAKE_OPTS_SPECS 的值。 |
-ver/sion | 列印 rafmake 指令的版本資訊。 |
-VerAll | 列印 rafmake 指令以及 rafmake 指令所使用之程式庫 (Linux 和 Solaris)或 DLL (Windows) 的版本資訊。 |