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 文件。
缺省值:未定义
- RAFMAKE_SHELL_FLAGS
- 指定 rafmake 命令选项来传递到运行构建脚本命令的子 shell 程序。
缺省值:
- Linux 和 Solaris:–e
- Windows:无
- RAFMAKE_SHELL_REQUIRED
- 强制执行 rafmake 命令以在通过 SHELL 宏指定的 shell 程序中运行构建脚本。要使 rafmake 命令在 shell 程序中运行构建脚本,请将此变量设置为 TRUE。
要配置 rafmake 命令来直接运行构建脚本,请将变量取消设置。
缺省值:rafmake 命令直接运行构建脚本
- RAFMAKE_VERBOSITY
- 以如下方式指定 rafmake 命令消息记录级别:
- 1
- 在命令行上等价于 –v(详细)
- 2
- 在命令行上等价于 –d(调试)
- 0 或未定义
- 等价于标准消息记录级别
如果在命令行上也指定 –v 或 –d,那么以较大值为准。
缺省值:0
- MAKEFLAGS
列出要传递到 make 命令的一个或多个标志。
rafmake 命令在启动时读取 MAKEFLAGS 环境变量的内容。然后该命令修补变量以包含在命令行上传递的未特定于 Build Catalyst 的标志。通过 RAFMAKE_MAKEFLAGS 环境变量传递特定于 Build Catalyst 的标志,如果 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 命令可以构建目标的一个和多个构建主机。
缺省值:未定义
- RAFMAKE_HOST_TYPE
确定并行构建期间要使用的构建主机文件的名称(–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 命令构造的路径名设置路径名分隔符。该变量可以设置在 makefile 中、在 BOS 文件中、在命令行上或设置为环境变量。
缺省值:如果该变量未设置或者设置为正斜杠 (/) 或反斜杠 (\) 以外的任何值,那么 rafmake 命令将反斜杠 (\) 用作路径名分隔符。