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 指令會以反斜線 (\) 作為路徑名稱分隔字元。