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 V3.80 make 命令的大部分公共选项。 rafmake 命令还提供附加选项。

提示: 您可以合并不带参数的选项,例如 –rNi
表 2. 选项描述
选项 描述
–f makefile 将 makefile 用作输入文件。如果您省略此选项,rafmake 命令将在当前工作目录中查找名为 makefile 和 Makefile(以该顺序)的输入文件。可以指定多个 –f makefile 参数对。将有效并置多个输入文件。
–u (无条件)重新构建所有指定的目标及其所有依赖性,无论是否需要重新构建。(另请参阅 –U。)
–k 如果当前条目上的工作失败,请将其放弃,但是在不依赖于该条目的其他目标上继续处理。
–i 忽略命令返回的错误代码。
–n (不执行)从需要重新构建的目标的 makefile 列出命令行(包括以 at 符号 (@) 开头的命令行),但是不运行这些命令行。异常:始终运行包含字符串 $(MAKE) 的命令。
–s (静默)在运行命令行之前请勿将其列出。
–e 环境变量覆盖 makefile 文件中的宏分配。(但是,命令行或构建选项规范中的=分配将覆盖环境变量。)
–r (无规则)请勿使用 buildcatalyst-home-dir/etc/builtin.mk 文件(Linux 和 Solaris)或 buildcatalyst-home-dir\etc\builtin.mk 文件 (Windows) 中的内置规则。与 –c 选项一起使用时,–r 选项也禁止读取特定于平台的启动文件。请参阅 –c 选项以了解更多信息。
–v (详细)比缺省输出方式稍微更详细些。
–w (工作目录)在运行 makefile 之前和之后打印包含工作目录的消息。
–d (调试)相当详细,并包含构建期间 rafmake 命令读取的环境变量的列表。仅在调试 makefile 时使用此选项。
–p (打印)列出所有目标描述和所有宏定义,包括特定于目标的宏定义和隐式规则。请勿运行任何对象。
–q

(查询)评估 makefile 目标,但是为运行构建脚本。rafmake 命令返回以下响应之一:

  • 如果目标为最新,那么返回 0
  • 如果需要重新构建任何目标,那么返回 1
–U 仅无条件地构建目的目标。请勿构建子目标。如果没有在命令行上指定任何目标,那么缺省目标为目的。(–u 选项无条件地构建目的目标和构建依赖性。)
–N 禁用用于读取一个或多个构建选项规范 (BOS) 文件的缺省过程。
–J num 启用并行构建能力。并行目标重新构建的最大数量设置为整数 num。 如果 num=0,那么禁用并行构建。(这等价于不指定 –J 选项。)或者,您可以将 num 指定为 RAFMAKE_CONC 环境变量的值。
–B bldhost-file bldhost-file 文件用作并行构建的构建主机文件。如果没有指定 –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 命令。

仅在 Linux 和 Solaris 系统上,compat-mode 变量还可以具有以下值之一。–c 选项独立于 Linux 和 Solaris 平台。但是,一些方式尝试读取特定于系统的文件;如果这些文件不存在,那么命令失败。

sun
模拟 SunOS 系统提供的标准 make(1) 命令。
aix
模拟 IBM AIX® 系统提供的标准 make(1) 命令。
–C dir 更改目录。rafmake 命令切换到 dir 目录,然后启动构建。
–A BOS-file

指定在缺省读取的 BOS 文件后立即读取的 BOS 文件。多次使用该选项来指定多个 BOS 文件。

–N 与该选项一起使用时,rafmake 读取指定的 BOS 文件,而不是缺省的 BOS 文件。

或者,您可以指定 BOS 文件路径名的冒号分隔的列表(Linux 和 Solaris)或者此类路径名的分号分隔的列表作为环境变量 RAFMAKE_OPTS_SPECS 的值。

–ver/sion 打印关于 rafmake 命令的版本信息。
–VerAll 打印关于 rafmake 命令以及 rafmake 命令使用的库(Linux 和 Solaris)或 DLL (Windows) 的版本信息。

反馈