rule DEPENDS ( targets1 * : targets2 * )

构建直接依赖关系：使每个 targets1 依赖于每个 targets2。通常，如果 targets2 本身被重建或比 targets1 更新，则将重建 targets1。

rule INCLUDES ( targets1 * : targets2 * )

构建兄弟依赖关系：使依赖于任何 targets1 的任何目标也依赖于每个 targets2。这反映了当一个源文件包含另一个文件时出现的依赖关系：从源文件构建的对象既依赖于原始源文件，也依赖于包含的源文件，但这两个源文件并不相互依赖。例如

DEPENDS foo.o : foo.c ;
INCLUDES foo.c : foo.h ;

在此示例中，“foo.o” 依赖于 “foo.c” 和 “foo.h”。

rule ALWAYS ( targets * )

导致无论 targets 是否是最新的，都要重建它们（它们仍然必须在依赖关系图中）。这用于 clean 和 uninstall 目标，因为它们没有依赖关系，否则将永远不会出现需要构建的情况。最好将其应用于也是 NOTFILE 目标的目标，但它也可以用于强制更新实际文件。

rule LEAVES ( targets * )

使每个 targets 只依赖于其叶源，而不依赖于任何中间目标。这使得它不受其依赖关系更新的影响，因为“叶”依赖关系是那些没有自身依赖关系且没有更新操作的依赖关系。这允许仅当原始源文件更改时才更新目标。

rule NOCARE ( targets * )

当 b2 遇到无法找到且没有更新动作的 目标 时，会忽略它们。通常情况下，b2 会发出警告，然后跳过依赖这些缺失目标的其他目标。Jambase 中的 HdrRule 使用 NOCARE 来处理头文件扫描期间找到的头文件名，以告知 b2 包含的文件可能不存在。例如，如果 #include 位于 #ifdef 内，那么包含的文件可能实际上并不存在。

rule NOTFILE ( targets * )

将 目标 标记为伪目标而不是真实文件。不会检查时间戳，因此只有在目标的依赖项被更新，或者目标也被标记为 ALWAYS 时，才会执行此目标上的动作。默认的 b2 目标 "all" 是一个伪目标。在 Jambase 中，NOTFILE 用于定义一些额外的方便的伪目标。

rule NOUPDATE ( targets * )

导致忽略 目标 的时间戳。这有两个影响：首先，一旦创建目标，它将永远不会被更新；其次，手动更新目标不会导致其他目标被更新。例如，在 Jambase 中，此规则由 MkDir 规则应用于目录，因为 MkDir 只关心目标目录是否存在，而不关心它上次更新的时间。

rule TEMPORARY ( targets * )

将 目标 标记为临时文件，允许在其他依赖它们的目標更新后删除它们。如果 TEMPORARY 目标丢失，b2 会使用目标父目录的时间戳。 Jambase 使用 TEMPORARY 来标记在构建后被归档到库中的目标文件，以便在归档后可以删除它们。

rule FAIL_EXPECTED ( targets * )

为了处理预期构建动作会失败的目标（例如，在测试断言或编译时类型检查是否正常工作时），Boost Jam 以与 NOCARE 等规则类似的方式提供了 FAIL_EXPECTED 规则。在目标更新期间，对 FAIL_EXPECTED 的参数的构建动作的返回值会被反转：如果它失败，依赖目标的构建将继续进行，就好像它成功了。如果它成功，依赖目标将被跳过。

rule RMOLD ( targets * )

B2 会删除构建这些目标的规则失败时磁盘上可能存在的任何目标文件。但是，默认情况下，不会删除依赖项构建失败的目标。RMOLD 规则会导致如果它的任何参数的依赖项构建失败，则删除它的参数。

rule ISFILE ( targets * )

ISFILE 将目标标记为必须是文件。这改变了 b2 搜索目标的方式，使其忽略对不是文件的系统项（如目录）的匹配。这使得可以避免 #include "exception" 匹配，如果碰巧在头文件搜索路径中有一个名为 exception 的目录。

rule ECHO ( args * )

将消息 args 输出到标准输出。

rule EXIT ( message * : result-value ? )

将 message 输出到标准输出，然后以失败状态退出，如果未提供 result-value，否则它将以给定的 result-value 退出。

"Echo"，"echo"，"Exit" 和 "exit" 被接受为 ECHO 和 EXIT 的别名，因为很难判断这些是内置规则，而不是语言的一部分，就像 "include"。

GLOB 规则执行文件名通配。

rule GLOB ( directories * : patterns * : downcase-opt ? )

使用与 switch 语句中的模式相同的通配符。它通过在 "[ ]" 内作为规则调用的参数来调用。例如：" FILES = [ GLOB dir1 dir2 : *.c *.h ]" 将 FILES 设置为 dir1 和 dir2 中的 C 源代码和头文件的列表。生成的 文件名为完整路径名，包括目录，但模式仅应用于不包含目录的文件名。

如果提供了 downcase-opt，则在与模式匹配之前，文件名将被转换为全小写；可以使用它来使用小写模式进行不区分大小写的匹配。如果操作系统提供了路径，则返回的路径仍然可能混合大小写。在 Windows NT 和 Cygwin 上，文件名在匹配之前总是被转换为小写。

MATCH 规则执行模式匹配。

rule MATCH ( regexps + : list * )

将 egrep(1) 风格的正则表达式 regexps 与 list 中的字符串进行匹配。结果是对 list 中的每个字符串以及 regexps 中的每个正则表达式的每个匹配的 () 子表达式列表。

rule BACKTRACE ( )

返回一个四元组列表：filename line module rulename...，描述调用堆栈的每个较浅的级别。此规则可用于从 Jam 规则生成有用的诊断消息。

rule UPDATE ( targets * )

经典的 jam 将命令行中任何非选项元素视为要更新的目标名称。这阻止了对命令行进行更复杂的处理。现在已重新启用此功能，但对 UPDATE 规则进行了额外更改，以允许灵活地更改要更新的目标列表。UPDATE 规则有两个影响

如果未使用 UPDATE 规则指定任何目标，则不会更新任何目标。为了以更实用的方式支持更改更新列表，该规则还会返回以前在更新列表中的目标。这使得可以像这样添加目标

local previous-updates = [ UPDATE ] ;
UPDATE $(previous-updates) a-new-target ;

rule W32_GETREG ( path : data ? )

仅针对 win32 平台定义。它读取 Windows 的注册表。'path' 是信息的存储位置，'data' 是我们要获取的值的名称。如果省略 'data'，则将返回 'path' 的默认值。'path' 值必须符合 MS 密钥路径格式，并且必须以预定义的根密钥之一作为前缀。像往常一样，

不支持其他预定义的根密钥。

目前支持的数据类型：'REG_DWORD'，'REG_SZ'，'REG_EXPAND_SZ'，'REG_MULTI_SZ'。带有 'REG_DWORD' 类型的數據将被转换为字符串，'REG_MULTI_SZ' 将被转换为字符串列表，而对于带有 'REG_EXPAND_SZ' 类型的數據，其中的环境变量将被其定义的值替换。带有 'REG_SZ' 类型的數據和其他不支持的类型将被放入字符串中，而不会进行修改。如果无法接收数据的价值，它只返回一个空列表。例如，

local PSDK-location =
  [ W32_GETREG HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\MicrosoftSDK\\Directories : "Install Dir" ] ;

rule W32_GETREGNAMES ( path : result-type )

仅针对 win32 平台定义。它读取 Windows 的注册表。'path' 是信息的存储位置，'result-type' 是 'subkeys' 或 'values' 之一。有关 'path' 格式和约束的更多信息，请参阅 W32_GETREG。

根据 'result-type'，该规则返回以下内容之一

如果 'result-type' 无法识别，或请求的数据无法检索，则该规则返回一个空列表。示例

local key = "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths" ;
local subkeys = [ W32_GETREGNAMES "$(key)" : subkeys ] ;
for local subkey in $(subkeys)
{
    local values = [ W32_GETREGNAMES "$(key)\\$(subkey)" : values ] ;
    for local value in $(values)
    {
        local data = [ W32_GETREG "$(key)\\$(subkey)" : "$(value)" ] ;
        ECHO "Registry path: " $(key)\\$(subkey) ":" $(value) "=" $(data) ;
    }
}

rule SHELL ( command : * )

SHELL 执行 command，然后返回 command 的标准输出。 SHELL 仅在 C 库中具有 popen() 函数的平台上工作。在没有工作 popen() 函数的平台上， SHELL 被实现为无操作。 SHELL 在 Unix、MacOS X 和大多数 Windows 编译器上工作。 SHELL 在 Windows 下的 Metrowerks 编译器上是无操作。有一组允许的选项作为附加参数

由于 Perforce/Jambase 定义了一个隐藏内置规则的 SHELL 规则，因此在这种情况下，COMMAND 可以用作 SHELL 的别名。

rule MD5 ( string )

MD5 计算作为参数传递的字符串的 MD5 哈希值并将其返回。

rule SPLIT_BY_CHARACTERS ( string : delimiters )

SPLIT_BY_CHARACTERS 将指定的 字符串 在 分隔符 中存在的任何分隔符字符处进行拆分，并返回结果列表。

rule PRECIOUS ( targets * )

PRECIOUS 规则指定，即使更新该目标的命令失败，也应该保留作为参数传递的每个目标。

rule PAD ( string : width )

如果 字符串 的长度小于 宽度 个字符，则在右侧使用空格字符对其进行填充，并返回结果。否则，返回 字符串 而不进行修改。

rule FILE_OPEN ( filename : mode )

FILE_OPEN 规则打开指定的 文件并返回文件描述符。 模式 参数可以是 "w" 或 "r"。请注意，目前只有 UPDATE_NOW 规则可以使用结果文件描述符号。

rule UPDATE_NOW ( targets * : log ? : ignore-minus-n ? )

UPDATE_NOW 导致指定的 目标立即更新。如果更新成功，则返回非空字符串。如果存在 日志 参数，则指定将构建的所有输出重定向到的 文件的描述符。如果指定了 忽略-n 参数，即使在命令行上指定了 -n 参数，也会更新目标。