Build Catalyst 環境變數

Build Catalyst 支援數個環境變數以簡化使用情形。

在下列區段中,將變數依作業系統分組:

Linux、Solaris 和 Microsoft Windows 共同的環境變數

RAFMAKE_CONC
設定 rafmake 建置中的並發層次。這項變數的值和 -J 選項 相同。若您在使用 rafmake 指令時指定 -J 選項,則會置換此項變數的設定。
RAFMAKE_COMPAT
指定 rafmake 指令相容模式。這項變數的值和 -c 選項 相同。若您在使用 rafmake 指令時指定 -c 選項,則會置換 此項變數的設定。

預設值:無

RAFMAKE_MAKEFLAGS
rafmake 指令選項的指定,提供替代方案或增補機制。RAFMAKE_MAKEFLAGS 環境 變數可以包含用於指令行選項的相同字串或索引鍵字母,除非選項帶有無效參數。如果發生 衝突,您在 rafmake 指令行指定的選項會置換此環境變數的設定。

預設值:無

RAFMAKE_OPTS_SPECS
提供以冒號(Linux 和 Solaris)或分號 (Windows) 區隔的路徑名稱清單,每個路徑均 指定 rafmake 指令所讀取的建置選項規格 (BOS) 檔案。您可以使用這個變數,取代在具有一個以上 -A 選項的 rafmake 指令行指定 BOS 檔案。

預設值:Undefined

RAFMAKE_SHELL_FLAGS
指定要傳遞至執行建置 Script 指令之 Subshell 程式的 rafmake 指令選項。

預設值:

  • Linux 和 Solaris:-e
  • Windows:None
RAFMAKE_SHELL_REQUIRED
強迫 rafmake 指令在您以 SHELL 巨集指定的 Shell 程式中執行建置 Script。如果 要使 rafmake 指令在 Shell 程式中執行建置 Script,請將這個變數設為 TRUE。如果要配置 rafmake 指令以直接執行建置 Script,請取消設定變數。

預設值:rafmake 指令直接執行建置 Script

RAFMAKE_VERBOSITY
指定 rafmake 指令訊息日誌記錄層次,如下所示:
1
等於指令行上的 -v(詳細)
2
等於指令行上的 -d(除錯)
0 或 undefined
等於標準訊息日誌記錄層次

如果您也在指令行上指定 -v-d,會以較高的值為準。

預設值:0

MAKEFLAGS

列出一個以上要傳遞至 make 指令的旗標。rafmake 指令會在啟動時,讀取 MAKEFLAGS 環境變數的內容。接著指令會修正變數,納入從指令行傳遞而來、且非 Build Catalyst 特定的旗標。Build Catalyst 特定的旗標 會透通 RAFMAKE_MAKEFLAGS 環境變數,如果 rafmake 指令在 MAKEFLAGS 變數中偵測到這些旗標,會將它們移至 RAFMAKE_MAKEFLAGS 變數。

透通 MAKEFLAGS 變數的旗標包含:-I-p-N-w-e-r-i-k-n-q-s

透通 RAFMAKE_MAKEFLAGS 變數的旗標包含:-A-B-N-v-c-U-M-u-d

預設值:無

僅適用於 Linux 和 Solaris 的環境變數

RAFMAKE_BLD_HOSTS
指定一個以上可供 rafmake 指令建立目標的建置主機。

預設值:Undefined

RAFMAKE_HOST_TYPE

決定在平行建置期間,所要使用的建置 hosts 檔名稱(-J 選項):您起始目錄中的 .bldhost.$RAFMAKE_HOST_TYPE。(您可以檢查密碼資料庫以決定起始目錄為何。)

在指令行指定 -B 選項會置換此項變數的設定。

C Shell 使用者:在 .cshrc 檔案中,而非 .login 檔案中設定此項變數。平行建置設施會呼叫遠端 Shell,而此 Shell 並不會讀取 .login 檔。

您也可以將 RAFMAKE_HOST_TYPE 編碼為 make 巨集。

預設值:無

僅適用於 Windows 的環境變數

RAFMAKE_NO_ESC_PATT_CHARS
rafmake 指令的 GNU 相容模式中置換跳出字元 (\)。例如,rafmake 和 GNU make 指令都假設 \% 字串指示文字字元 %。這兩個指令並不將這項規則視為 型樣規則。如果要避免 rafmake 指令使用跳出字元來指示文字字元,請將這個環境變數設為任何非空值。
RAFMAKE_PNAME_SEP
rafmake 指令所建構的路徑名稱設定路徑名稱分隔字元。這個變數可以在 make 檔、BOS 檔、指令行上設定,或是設為環境變數。

預設值:這個變數如果沒有設定,或是設為正斜線 (/) 或反斜線 (\) 以外的任何值,則 rafmake 指令會以反斜線 (\) 作為路徑名稱分隔字元。


意見