rafmake 公用程式參照

Build Catalyst 的介面是名為 rafmakemake 公用程式。此介面具有多種可控制其行為的選項。

指令的語法視作業系統而定,如下列表格所示。

表 1. 各作業系統的選項
作業系統 選項
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 指令也提供其他選項。

提示: 您可以結合不帶引數的選項,例如,-rNi
表 2. 選項說明
選項 說明
-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 指令傳回下列其中一個回應:

  • 0,如果目標是最新的
  • 1,如果有需要重建的任何目標
-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 變數設為下列其中一個值:

gnu

模擬「免費軟體基金會」的 Gnu make 程式。要定義內建的 make 規則時,rafmake 指令會讀取gnubuiltin.mk,而非 builtin.mk

這個模式是預設的相容模式。

std
在啟用 IBM Rational® ClearCase® clearmake 指令相容模式的情況下,執行 rafmake 指令。

compat-mode 變數也可以具有下列其中一個值(僅適用於 Linux 和 Solaris 系統)。-c 選項可在不同的 Linux 和 Solaris 平台上執行。然而,有些模式會嘗試讀取系統特定的檔案;如果這些檔案不存在,則指令會失敗。

sun
模擬 SunOS 系統提供的標準 make(1) 指令。
aix
模擬 IBM AIX® 系統提供的標準 make(1) 指令。
-C dir 變更目錄。rafmake 指令會在啟動建置前,變更至 dir 目錄。
-A BOS-file

指定在依預設讀取的 BOS 檔案之後,接著立即要讀取的 BOS 檔案。您可以多次使用這個選項,指定多個 BOS 檔案。

如果您對這個選項使用 -Nrafmake 會讀取指定的 BOS 檔,而非預設的 BOS 檔。

或者,您也可以針對 BOS 檔案路徑名稱,指定以冒號區隔的清單(適用於 Linux 和 Solaris)或是以分號區隔的清單,作為環境變數 RAFMAKE_OPTS_SPECS 的值。

-ver/sion 列印 rafmake 指令的版本資訊。
-VerAll 列印 rafmake 指令以及 rafmake 指令所使用之程式庫 (Linux 和 Solaris)或 DLL (Windows) 的版本資訊。

意見