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 文件。

缺省值:未定义

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 命令将反斜杠 (\) 用作路径名分隔符。


反馈